Skip to content

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

TypeScript

docs(odd): record T9 verification and the circle design change

Alan Buscagliaba446ca31d70
diff --git a/odd/tasks/gentle-dot.md b/odd/tasks/gentle-dot.md
index 6d6afcc..5ff004b 100644
--- a/odd/tasks/gentle-dot.md
+++ b/odd/tasks/gentle-dot.md
@@ -32,7 +32,8 @@ Branch: `feat/gentle-dot` · Delivery strategy: `single-pr` (user choice, L7; fo
- Checks: structural readback (done in T0).
- **S9 — The assistant is our rose, glowing.** User: "para el diseño, trata de utilizar nuestra rosa. ¿Bien? Estaría buenísimo que tenga animaciones, que tenga un glow, por ejemplo, como está trabajando, cosas así. pero un glow, ojo con lo que te voy a decir, la rosa misma, no el círculo donde está contenida, sino la rosa, que tenga un glow. Es más, podría ser como una línea que va recorriendo, que va teniendo un glow y que va recorriendo la rosa en sí, algo así." Earlier: "tendríamos que tener uno flotante también para Mac, cosa que si lo quieren tener en el escritorio, así dando vueltas mientras uno trabaja y le puedes hacer clic en cualquier lugar".
- - Acceptance: the floating Dot is the rose itself in a transparent window, with no circle or container. Its traced strokes glow, and per state a line of light travels along the rose (design sheet `docs/brand/rose-design.html`). The menu bar uses `rose-glyph.svg` as a template icon, and the app icon is the neon rose on a black squircle. Reduce motion is respected.
+ - Change (L24): user: "ponle un fondo negro y que sea un circulo". The floating Dot is now the glowing rose inside a black circle (the glow and the traveling light still belong to the rose strokes).
+ - Acceptance (superseded part struck by L24): ~~the floating Dot is the rose itself in a transparent window, with no circle or container~~. Its traced strokes glow, and per state a line of light travels along the rose (design sheet `docs/brand/rose-design.html`). The menu bar uses `rose-glyph.svg` as a template icon, and the app icon is the neon rose on a black squircle. Reduce motion is respected.
- Checks: UI tests for state classes; a screenshot review of every state; tray and app icons regenerated.
- **S10 — Sign in from the assistant itself.** User: "tenemos que tener la posibilidad de, desde lo que es el bot, poder hacer un login para las suscripciones y demás de que ya soporta API, bien, que ya soporta genteel Cell. Tenemos que tener esa capacidad. Eso es muy importante." "Puede ser alguna opción, hacer un barra login desde ahí mismo, etcétera. Te lo digo porque la idea es que esto es para las personas que no saben determinar eso, literal."
- Acceptance: from the panel or web UI, without a terminal, the user can sign in to every subscription provider and API key that Gentle Shell supports. That works both from a visible option and by typing `/login`, with plain-language guidance. Credentials stay where Gentle Shell keeps them and never pass through logs or the UI after entry.
@@ -64,6 +65,7 @@ Branch: `feat/gentle-dot` · Delivery strategy: `single-pr` (user choice, L7; fo
| T12 | S11 | explore (delegated) then delegated writer (context backstop; parallel with T10) | done | see L23; RED → GREEN per layer; parent re-ran 179 tests + typecheck | Profiles: list, create, edit, switch from the UI |
| T13 | S12 | inline | done | `43a512d` config + spawn tests; real smoke without gentle-shell on PATH: own home created, 42 providers, none configured | Bundle `gentle-pi`, own `--home` and profile store, first-run timeout, no PATH dependency |
| T14 | — (evaluation only, L21) | inline | pending | — | Linux port of the desktop app: per-platform window effects, tray icon, Wayland fallbacks, AppImage/deb bundles |
+| T15 | S6, S7, S11, S12, S9 | delegated writers (parallel: daemon/isolation vs. Dot circle) | in progress | — | One correction batch for verifier blockers B1–B4 and the S9 circle change, then a recheck limited to them |
| T9 | S1–S6, S9–S12 | 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.
@@ -93,4 +95,5 @@ Environment notes: Node v24.14.1 and pnpm are present. `cargo` is on PATH but `r
- **L21 (2026-10-08, user):** "Ve evaluando que tan fácil es portarlo para Linux y actualiza el todo". Read-only evaluation: the daemon, UI, protocol, auth, and Docker image are already platform-neutral (the container is Linux). The desktop shell has macOS-only points (`src/shell.rs`): HudWindow vibrancy (macOS/Windows only), the accessory activation policy (already `cfg(target_os = "macos")`), `icon_as_template`, `accept_first_mouse`, the `macos-private-api` feature/`macOSPrivateApi`, Info.plist `LSUIElement`, and `.cargo/config.toml` pinning `/usr/bin/cc`. Linux constraints: on Wayland, apps cannot position their own windows or reliably stay on top, and global shortcuts need the GlobalShortcuts portal, so edge snapping, the floating rose, and Alt+Space are X11-only; on GNOME the tray needs the AppIndicator extension; transparency needs a compositor. Estimate: X11 parity is small (about 1–2 days); Wayland needs fallbacks (a normal window instead of the free-floating rose, a tray-or-panel launcher, a shortcut set by the user in desktop settings). Recorded as T14, pending a go-ahead.
- **L22 (2026-10-08, T10 evidence):** The rose is an inline SVG built from the traced strokes: 178 static outline strokes, with light traveling along the 60 longest (at 64 px the shorter ones read as flicker). Finding: macOS system WebKit does not draw CSS `drop-shadow` on `<g>` inside inline SVG, so the rose is three stacked `<svg>` layers (base, light, sparkles), each with its own glow; verified with `qlmanage` system-WebKit renders. The Dot window is 64×84 with `initial_dot_position` using the real size. There are four tray template glyphs at 18/36 px (working is a static dashed variant, not two frames), plus a neon-rose squircle app icon and the favicon. Reduce motion hides the light layer and keeps a steady glow. Risks for T9: live animation in WKWebView is not yet observed, and the working tray glyph is subtle at 18 pt. The unused `icons/tray.png` was removed.
- **L23 (2026-10-08, T12 evidence):** The writer stalled once on a bash command and was resumed in its own session with timeouts on every long command. The daemon reimplements the `gentle-pi.agent_model_profiles` v1 store: atomic 0600 writes through one queue. Applying a profile writes the four files in order, restores all four on failure, never touches agent `.md` files, then sends `set_model` and `set_thinking_level` (deferred until `agent_settled` while busy). Models forward only provider, id, name, and reasoning (a gateway test asserts that `headers` never reach a client). The import is read-only, skips `active`, renames collisions to `-imported[-N]`, and reports missing sign-ins. Extras beyond the request: editing the active profile re-applies it, identical imports are skipped, and Delete is disabled for the active profile. `SettingsManager` was not used because it cannot delete `defaultThinkingLevel`; a `settings.json.lock` mkdir lock (stale after 10 s) mimics proper-lockfile. Verification: 179 tests passed (2 opt-in skipped), typecheck OK, biome OK, e2e 9/9 (the e2e test was written after the implementation, so no RED). Open for T9: `set_model` against the real engine, lock compatibility with proper-lockfile, and one flaky `supervisor.test.ts:54` (busy after settle), seen once in four runs.
-- **Next step:** T9 (full verification with an independent verifier, `@real-agent` tests, and launching the app); T14 when authorized.
+- **L24 (2026-10-08, T9 evidence and user feedback):** Independent verifier (scratch copy, temp HOME): runners all green (179 tests, typecheck, lint, e2e 9/9, cargo 34/34, `test:real` 2/2, supervisor ×10 = 10/10). Verdicts: pass S2, S3, S4, S5, S8, S10; not verifiable S1, S9; FAIL S6, S7, S11, S12. BLOCKERS: B1 the token printed by `cli.ts:21` lands in `~/.gentle-dot/daemon.log` (0644, dir 0755), readable by other local users. B2 the first run writes outside the instance (`~/.gentle-shell/config.json` provisioned mark, `~/.pi/agent/pi-pretty/fff/*.mdb` via a fixed `$HOME`, `~/.gentle-ai/state.json`, and `~/.gentle-ai/backups`). B3 with the default workspace `~`, the engine reads `~/.pi/gentle-ai/models.json` as project config and writes it into `<data>/agent/agents/*.md` frontmatter, and an applied profile that omits a role does not clear that frontmatter. B4 deploy-vps step 3 (`docker compose run … gentle-shell`) cannot work. Advisories: generic error with no account; a `busy` race in `supervisor.ts:118-123`; stale `ready.model` after `set_model`; `auth_logout` accepts any providerId; `auth_reply` has no owner check; symlinked session files are accepted; rollback leaves 0600; internal role ids in the payload; unpinned `engram@latest`; the token in `docker logs`. App launched on the user's Mac: CGWindowList shows the Dot window floating (layer 5) but at 59×76 and about 106 px from the edge, against a saved 64×84 at a 12 pt margin; screenshots are not possible (no screen-recording permission). User: menu bar icon and menu OK; clicking the rose or ⌥ Space opens the panel beside it; on the rose: "ponle un fondo negro y que sea un circulo".
+- **Next step:** T15 correction batch, then a recheck limited to B1–B4, the circle, and the window size; T14 when authorized.