Skip to content

A personal assistant that lives on your desktop, remembers what matters, and can use your Mac for you.

TypeScript

docs(odd): plan the self-contained installers (S29.5, T28a-g)

Alan Buscaglia884baefcec8b
diff --git a/odd/tasks/gentle-dot.md b/odd/tasks/gentle-dot.md
index 9e5d140..6a901f1 100644
--- a/odd/tasks/gentle-dot.md
+++ b/odd/tasks/gentle-dot.md
@@ -104,7 +104,8 @@ Branch: `feat/gentle-dot` · Delivery strategy: `single-pr` (user choice, L7; fo
- **S29 — Installers (L79–L80).** User: "anda increible!! ahora lo unico que te falta... es hacerle un instalador a la app". Choices: "Solo para mí y gente de confianza"; "macOS y Linux".
- **S29.1 Self-contained.** The installed app runs on a clean machine with nothing preinstalled: it carries its own Node runtime, the compiled daemon, the bundled engine (gentle-pi) and its dependencies, and Engram; no build-machine path (today `build.rs:39-41`, `daemon.rs:30-36`) or user binary (`~/go/bin/engram`) is needed. Source builds keep working as today.
- - **S29.2 macOS.** A DMG for Apple Silicon, not notarized (trusted people open it with right-click → Open the first time; the docs say how). Signing keeps a stable identity across updates where possible so the Accessibility and Screen Recording grants survive updates (assumption to verify: a self-signed certificate keeps the TCC designated requirement stable, unlike ad-hoc signing).
+ - **S29.2 macOS.** A DMG for Apple Silicon, not notarized (on macOS 15 and later the first open goes through System Settings → Privacy & Security → "Open Anyway", since Apple removed the Control-click override, developer.apple.com/news/?id=saqachfa, Aug 2024; the docs say how). Signing keeps a stable identity across updates where possible so the Accessibility and Screen Recording grants survive updates (assumption to verify: a self-signed certificate keeps the TCC designated requirement stable, unlike ad-hoc signing).
+ - **S29.5 Runtime layout (L81, the contract between units).** The installed app carries `runtime/` as a Tauri resource: `runtime/node/` (official Node 24 distribution with `bin/node`, `bin/npm`, `bin/npx`), `runtime/bin/` (`engram`, a relocatable `pi` wrapper), `runtime/daemon/cli.mjs` (the daemon and protocol bundled; `gentle-pi`, `@earendil-works/*`, `ws` external) with `runtime/daemon/identity.md`, `runtime/daemon/extensions/approval-guard.ts`, and `runtime/daemon/node_modules/` (a flat install for the target platform), and `runtime/ui/` (the web UI). When `runtime/daemon/cli.mjs` exists, the app launches `runtime/node/bin/node runtime/daemon/cli.mjs` with `PATH=<runtime>/bin:<runtime>/node/bin:/usr/bin:/bin:/usr/sbin:/sbin` and `GENTLE_DOT_RUNTIME=<runtime>`; otherwise it keeps today's build-machine launch; `GENTLE_DOT_NODE` and `GENTLE_DOT_DAEMON_SCRIPT` still override. With `GENTLE_DOT_RUNTIME` set, the daemon serves `runtime/ui`, and resolves Engram as: `ENGRAM_BIN`, then an `engram` on the user's login PATH or in `~/go/bin`, `/opt/homebrew/bin`, `/usr/local/bin`, `~/.local/bin`, then `runtime/bin/engram`; `ENGRAM_DATA_DIR=~/.engram` and project `gentle-dot` stay.
- **S29.3 Linux.** Self-contained packages for Debian/Ubuntu (.deb) and Arch/Omarchy (a package or AppImage), replacing build-from-source for end users; the setup scripts stay for development.
- **S29.4 Docs and checks.** An install guide for both platforms, a smoke check that the installed app starts its daemon and engine on a clean user (temp HOME / container), and one command per platform that builds the installer.
- Out of scope (L80): notarization, a Developer ID, auto-updates, and public distribution; S25 stays the gate before any public release.
@@ -140,7 +141,14 @@ Branch: `feat/gentle-dot` · Delivery strategy: `single-pr` (user choice, L7; fo
| T25 | S26 | delegated writer (context backstop), parallel with the read-only T24 verifier; surface excludes computer/** | done (real Mac pending) | `8b274ed`; RED 30 compile errors + 8 UI failing → GREEN; parent re-ran cargo test 203, pnpm test 417 | Hide the rose; full-screen chat |
| T26 | S27 | — | dropped (L71) | — |
| T27 | S28 | delegated writer (context backstop), then independent verifier (high: owner/element resolution under S24.4) | done (verified, real Mac pending) | `f01dfdf`, A1 fix below; RED 51 compile errors + UI import → GREEN; 2 mutation checks; parent re-ran cargo test 217, pnpm test 426 | Pink glow while the agent interacts | Accessibility-first actions, keyboard to an app, cursor restore, pink glow |
-| T28 | S29 | explore (delegated, read-only) → plan → implement | in progress | — | Self-contained installers: macOS DMG, Linux .deb and Arch |
+| T28 | S29 | explore (delegated, read-only) → plan → implement | in progress | map done (L81) | Self-contained installers: macOS DMG, Linux .deb and Arch |
+| T28a | S29.1, S29.5 (app launch) | delegated writer, parallel with T28b (surface `apps/desktop/src-tauri/src/daemon.rs`) | in progress | — | Launch the bundled runtime when present |
+| T28b | S29.1, S29.5 (daemon) | delegated writer, parallel with T28a (surface `packages/daemon/**`) | in progress | — | Bundled daemon build, runtime-aware paths, Engram resolution, relocatable pi wrapper |
+| T28c | S29.1, S29.4 | after T28a/b | pending | — | `scripts/package/stage-runtime.mjs` per target; clean-HOME smoke, read-only tree smoke, size |
+| T28d | S29.2 | after T28c | pending | — | Tauri macOS resources + DMG + `pnpm package:mac`; launch from /Applications copy |
+| T28e | S29.2 | needs user consent (creates a signing identity in the login keychain) | pending | — | Self-signed identity; compare the designated requirement across two builds |
+| T28f | S29.3 | after T28c | pending | — | Linux .deb (arm64, amd64) and Arch PKGBUILD in containers; clean install smoke |
+| T28g | S29.4 | last | pending | — | docs/install.md; Hyprland snippets point at /usr/bin/gentle-dot |
| T22 | S18 (hardening, L47 B1/B2) | delegated writer | done (accepted with documented gaps, L52) | `8651bba`; parent re-ran 328 tests + typecheck | Option A: authoritative in-memory connector state with revert, credential reads blocked, path-independent bash checks, full approval preview, redirect manual, private Engram stop, onboarding overlap fix |
| T23 | S25 | explore → spec → implement (stage 2) | pending | — | Daemon-side MCP proxy with Keychain tokens |
| T9 | S1–S6, S9–S12 | delegated verifier (high risk: process supervision, auth) | done | L24 + L31 | Full verification: unit, integration, Playwright, `@real-agent`, `tauri build` + launch, manual macOS checklist with observed results |
@@ -229,4 +237,5 @@ Environment notes: Node v24.14.1 and pnpm are present. `cargo` is on PATH but `r
- **L78 (2026-10-08):** independent verifier on a2fbc65..f01dfdf: cargo test 217, clippy, pnpm test 426, typecheck, lint, 11/11 probes; owner resolution, element re-hit-test, marks, overlay/capabilities, and UI PASS; no blockers. A1 (an empty `type` marked a glow without input) fixed inline: RED → GREEN, cargo test 218, clippy clean. Advisories kept: A2 reduced motion read once at mount; A3 an unresponsive app under the overlay yields an empty AX chain (same as baseline for hung apps); A4 out-of-lock state reports can reorder grant/end (baseline); A5 `?surface=glow` on the web is a blank page. App rebuilt and restarted for the real-Mac round (permissions must be granted again after a rebuild).
- **L79 (2026-10-09, user):** "anda increible!! ahora lo unico que te falta... es hacerle un instalador a la app" (after a real-Mac run where Gentle Dot controlled Ghostty and typed into this session). The yolo mark became an amber rim (`28049af`, user: "y cambialo por mas integrado"). Checked: no codesigning identity ("0 valid identities found"); the app embeds build-machine Node, daemon script, and PATH; Engram is the user's own binary.
- **L80 (2026-10-09, user):** installer for "Solo para mí y gente de confianza", platforms "macOS y Linux". Recorded as S29/T28; read-only map launched.
-- **Next step:** the T28 map, then the installer plan; grant both permissions, take a screenshot (the Dot must be absent), click and type in a harmless app, a risky "Send" confirmation, ⌥⇧Esc panic, a blocked app (System Settings), and `screencapture -x /tmp/t.png` from the agent's bash must fail (R1); the community tester runs docs/linux-testing.md when the user shares it; T23/S25 before any public release.
+- **L81 (2026-10-09):** T28 map (explorer without web; parent re-checked): ship a full Node 24 distribution (first run does `npm install --prefix <agentDir>/npm`; Discord uses `npx`); SEA and bun compile do not fit (the daemon re-executes `process.execPath` with gentle-shell.mjs and the pi CLI; gentle-pi loads extensions/skills from disk via jiti); per-platform dependency installs (ffi-rs N-API, fff-bin, the `gentle-ai` Go binary from gentle-pi's postinstall with mode 0700); the pnpm `.bin/pi` shim is not relocatable; Engram ships as a fallback binary (MIT, goreleaser darwin/linux amd64/arm64). Verified on the web: macOS 15 removed the Control-click Gatekeeper override (developer.apple.com/news/?id=saqachfa); a persistent self-signed identity keeps TCC grants across updates while ad-hoc does not (github.com/duongductrong/Snapzy docs/SELF_SIGNED_CERT.md). Plan as T28a–T28g with the S29.5 layout as the contract; T28a and T28b launched in parallel. Risks: the engine writing into a read-only package tree, first-run network dependence, Engram version skew on ~/.engram, amd64 under emulation.
+- **Next step:** T28a/T28b, then T28c; grant both permissions, take a screenshot (the Dot must be absent), click and type in a harmless app, a risky "Send" confirmation, ⌥⇧Esc panic, a blocked app (System Settings), and `screencapture -x /tmp/t.png` from the agent's bash must fail (R1); the community tester runs docs/linux-testing.md when the user shares it; T23/S25 before any public release.