Skip to content

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

TypeScript

docs(odd): add rose design, in-app login, and profile specs

Alan Buscaglia4a99a95eefa5
diff --git a/docs/deploy-vps.md b/docs/deploy-vps.md
index 5b76d7a..85c6970 100644
--- a/docs/deploy-vps.md
+++ b/docs/deploy-vps.md
@@ -21,7 +21,7 @@ browser ──HTTPS──▶ Apache (cPanel) or Caddy ──▶ 127.0.0.1:4317
└─ engram serve (memory)
```
-The image (`Dockerfile`) installs `gentle-pi` (it provides `gentle-shell`), builds Engram, and builds the web UI. The `dot-home` volume keeps conversations, memory, the access key, and the agent login across restarts.
+The image (`Dockerfile`) installs `gentle-pi` (it provides `gentle-shell`) and the matching `pi`, builds Engram, and builds the web UI. On its first start the container installs the assistant's companion packages, which takes about 15 seconds and needs internet access. The `dot-home` volume keeps conversations, memory, the access key, and the agent login across restarts.
## Steps
@@ -112,6 +112,7 @@ Never run `docker compose down -v`: `-v` deletes the volume with your conversati
|---|---|
| The page says the link is not valid | Wrong or old access key. Read it with `docker compose exec gentle-dot cat /home/dot/.gentle-dot/token`. |
| The page loads but never connects | The proxy does not forward WebSockets (enable `mod_proxy_wstunnel`), or `DOT_DOMAIN` does not match the address you opened, so the Origin check refuses it. |
+| You want no usage metrics | The companion packages send anonymous usage metrics by default. Opt out with `docker compose exec gentle-dot gentle-ai telemetry disable`. |
| "The assistant is restarting" stays on | The agent cannot start; check `docker compose logs gentle-dot` for a missing model key or login. |
## Video outline (about 2 minutes)
diff --git a/odd/tasks/gentle-dot.md b/odd/tasks/gentle-dot.md
index 50b910d..619f860 100644
--- a/odd/tasks/gentle-dot.md
+++ b/odd/tasks/gentle-dot.md
@@ -39,11 +39,11 @@ Branch: `feat/gentle-dot` · Delivery strategy: `single-pr` (user choice, L7; fo
| T1 | S3, S6 | inline | done | `605b6c2` typecheck, lint, 2 tests green | Scaffold the pnpm workspace (`packages/protocol`, `packages/daemon`, `packages/ui`, `apps/desktop` placeholder), TypeScript strict, Vitest, lint, README |
| T2 | S3, S5 | inline | done | `c199fef` RED (missing modules) → GREEN 14 daemon tests, 3 consecutive runs | Agent supervisor: spawn, strict JSONL framing, id correlation, fake agent for tests, restart with backoff, reopen last session |
| T3 | S2, S6 | inline | done | `64e25fb` RED (missing daemon) → GREEN 39 tests; `node packages/daemon/src/cli.ts` smoke: health OK, token 0600 | Gateway: HTTP static + `/health`, WebSocket protocol v1, token + Origin checks, Pi RPC mapping (design §4) |
-| T4 | S4 | inline | pending | — | White-label: verify `--append-system-prompt` passthrough, `identity.md`, event sanitizer, tool-kind mapping, error neutralization |
-| T5 | S2 | inline (writer only if parallel with T7) | pending | — | Web UI: chat, streaming Markdown, activity rows, conversations, composer with Stop/steer, visual tokens |
-| T6 | S2, S4, S5 | inline | pending | — | Ask cards (select/confirm/input/editor with timeout), toasts, interrupted-run Continue prompt, reconnect with `seq` gap recovery |
-| T7 | S1 | inline (writer only if parallel with T5) | pending | — | Tauri 2 app: tray menu, floating Dot window, expand panel, `⌥ Space` shortcut, daemon spawn/attach, position persistence, launch at login |
-| T8 | S7 | inline | pending | — | `Dockerfile`, `compose.yaml`, `docs/deploy-vps.md`, security checklist, video step list |
+| T4 | S4 | inline | done | `194721d` RED (missing module) → GREEN 57 tests; `pnpm test:real` 2/2 | White-label: verify `--append-system-prompt` passthrough, `identity.md`, event sanitizer, tool-kind mapping, error neutralization |
+| T5 | S2 | inline (parallel with delegated T7) | done | `f871c01`, fix `4ca84d3` (3 visual defects, RED → GREEN) | Web UI: chat, streaming Markdown, activity rows, conversations, composer with Stop/steer, visual tokens |
+| T6 | S2, S4, S5 | inline | done | `f871c01`, e2e `dc425c0` + `5b466a8`: Playwright 7/7 | Ask cards (select/confirm/input/editor with timeout), toasts, interrupted-run Continue prompt, reconnect with `seq` gap recovery |
+| T7 | S1 | delegated writer (parallel units T5/T6 and T7, disjoint surfaces) | in progress | — | Tauri 2 app: tray menu, floating Dot window, expand panel, `⌥ Space` shortcut, daemon spawn/attach, position persistence, launch at login |
+| T8 | S7 | inline | done | `ee74148` docker build OK, container smoke: health idle, companion setup 3/3 | `Dockerfile`, `compose.yaml`, `docs/deploy-vps.md`, security checklist, video step list |
| T9 | S1–S6 | delegated verifier (high risk: process supervision, auth) | pending | — | Full verification: unit, integration, Playwright, `@real-agent`, `tauri build` + launch, manual macOS checklist with observed results |
Environment notes: Node v24.14.1 and pnpm are present. `cargo` is on PATH but `rustc` is not, so T7 must first install or repair the Rust toolchain (rustup) and asks before installing. Xcode is present.
@@ -60,4 +60,6 @@ Environment notes: Node v24.14.1 and pnpm are present. `cargo` is on PATH but `r
- **L8 (2026-10-08, evidence):** Rust stable 1.99.0 installed via rustup (Homebrew); the nix `cargo` precedes it on PATH, so Tauri commands prepend `/opt/homebrew/opt/rustup/bin`. Toolchain versions: TypeScript 7, Vitest 5, Biome 2, pnpm 11.5. T2 risk tier: medium (process supervision covered by integration tests with a fake agent; the fake delays `crash` exit because macOS pipes are asynchronous).
- **L9 (2026-10-08, T3 evidence):** 18 gateway tests cover the token (4401), protocol (4400), Origin (403), seq numbering, streaming, broadcast, requestId dedupe, tool activity, asks and late joiners, conversations and history, id traversal refusal, malformed frames, interruption after restart, static UI with traversal block, and health. Exception: `parseClientMessage` was written before its unit test (the test passed on first run). Design §4 updated: `send` while busy steers, plus `user_message`, `ask_resolved`, `conversations`, `interrupted` payloads. Risk tier: high (auth on a local socket); independent verification in T9.
- **L10 (2026-10-08, T4 evidence):** the launcher forwards unknown args to Pi (`runtime/gentle-shell-launcher.mjs:153,971`), so `--append-system-prompt` works; the S4 assumption holds. `pnpm test:real` (opt-in through `GENTLE_DOT_REAL_AGENT=1` so ordinary runs cost no model calls) passed 2/2. Answer: "I’m Gentle Dot, a personal assistant that lives on your desktop and in your browser. I can work with your files, run tasks, remember things across conversations, and bring in focused helpers when needed." No hidden names appeared in any UI-bound message. Info toasts are hidden as harness chatter.
-- **Next step:** T5.
+- **L11 (2026-10-08, T5/T6 evidence):** Route: T5/T6 inline and T7 delegated in parallel (Writer trigger (a): disjoint surfaces `packages/ui` and `apps/desktop/src-tauri`, contract fixed first in design §9). RED observed for components, client, and Dot (missing modules); exception: the store reducer was written before its tests ran (tests passed on the first run). Screenshots exposed 3 defects that the tests missed: lost user line breaks, start/end activity ids split, and a title stuck at "New conversation"; each got a RED test, then a fix (`4ca84d3`). Totals: vitest 88 passed + 2 opt-in skipped; Playwright 7/7 (chat, ask card, conversations, interruption + Continue, reload, rejected key, missing key).
+- **L12 (2026-10-08, T8 evidence):** HostGator cPanel/WHM Apache owns ports 80/443, so the default compose binds `127.0.0.1:${DOT_PORT}` behind an Apache include (`docker/apache-gentle-dot.conf`, Basic Auth + WebSocket proxy), and Caddy is an opt-in profile for a VPS without a web server. The safety policy blocked creating `.env.example`; the variables are documented in `docs/deploy-vps.md` step 3 instead. Image fixes found by the smoke run: `gentle-pi` installs its gentle-ai binary as root with mode 0700 (chown to `dot`), and companion setup needs `curl` plus `pi` on PATH (pinned to gentle-pi's bundled version). Final smoke: health `idle`, companion packages installed, verification 3 passed. A chat inside the container was not run because it needs a model key.
+- **Next step:** integrate T7, then run T9.