osdy-pi 1.6.1 → 1.8.0

package/README.md

@@ -6,8 +6,11 @@ Osdy Pi gives [Pi](https://github.com/earendil-works/pi) a themed, responsive te
 
 ## Release highlights
 
+The **1.8.0 release candidate** includes the changes below; npm publication is not yet confirmed.
+
 | Area | What ships |
 | --- | --- |
+| New themes (included starting in 1.8.0) | Gruvbox Dark, Nord, Rosé Pine base dark, and Daniela Cute bring the bundle to 18 themes. |
 | Message cards | Pi-native colored user cards without emojis and plain assistant Markdown preceded by a separate `🦝` transcript row. |
 | Header and mascot | A theme-aware `neon` header and selectable `bts` mascot, both responsive and persisted independently. |
 | Accounts | `/osdy-account` switches Codex profiles in place with atomic activation, rollback, bounded auth files, and process-safe locks. |
@@ -42,7 +45,7 @@ Osdy Pi gives [Pi](https://github.com/earendil-works/pi) a themed, responsive te
    pi
    ```
 
-Osdy Pi's own extension and all **14 themes** are bundled with this installation—do not install them separately. Launch through `osdy-pi` (or `npm run pi:dev`) to activate a valid Osdy default account into Pi's shared agent directory before Pi starts. With no default, Pi remains unmanaged; run `/osdy-account` to create a profile and establish a default. On session start, Osdy Pi restores its persisted enabled state when a UI is available and preserves your selected Pi theme. When disabled, it leaves Gentle Shell (or Pi's native UI) untouched.
+Osdy Pi's own extension and themes are bundled—do not install them separately. The **1.8.0 release candidate** bundles **18 themes**, including Gruvbox Dark, Nord, Rosé Pine base dark, and Daniela Cute starting in 1.8.0. Check your installed npm version; publication of 1.8.0 is not yet confirmed. Launch through `osdy-pi` (or `npm run pi:dev`) to activate a valid Osdy default account into Pi's shared agent directory before Pi starts. With no default, Pi remains unmanaged; run `/osdy-account` to create a profile and establish a default. On session start, Osdy Pi restores its persisted enabled state when a UI is available and preserves your selected Pi theme. When disabled, it leaves Gentle Shell (or Pi's native UI) untouched.
 
 ### Optional: isolated `osdy` command
 
@@ -132,13 +135,15 @@ The exclusions prevent Gentle's todo, questionnaire, and agents extensions from
 
 The model-facing `todo` tool supports `create`, `update`, `list`, `get`, `delete`, and `clear`. Tool results carry full task snapshots; Pi's current session branch is the TODO authority. Session switches and compaction replay the latest valid branch snapshot, rather than sharing one project-wide list. `/todos` opens a read-only, grouped modal (pending, in progress, completed) in interactive Pi; scroll with arrow or Page Up/Down keys and close with Esc or q. The refreshed modal adds a completed-task progress meter, theme-aware status groups and a scroll-position footer while keeping every task reachable. It is not an interactive Markdown editor. In non-terminal modes with UI support, it retains notification output. ODD's `odd/tasks/*.md` ledger and Engram are separate orchestration records: there is no automatic sync with these Pi TODOs.
 
-In interactive Pi, the persistent widget appears above the editor while visible tasks exist. By default it shows up to five task rows (excluding heading, overflow hint, and spacer), summarizes overflow, and keeps completed rows visible with crossed-out subjects on subsequent turns; expand tool output to view all rows. `ctrl+shift+t` collapses or expands the widget.
+In interactive Pi, the persistent widget appears above the editor while visible tasks exist. Its compact preview shows up to three task rows (excluding heading, overflow hint, and spacer), prioritizes unfinished tasks on overflow, and crosses out completed subjects. In fullscreen Pi, left-click the heading to expand or return to preview; wheel over the expanded widget to move one task at a time beneath the fixed heading. The final task can reach the first task row even in a short dock. A heading-only or hidden dock cannot display tasks; use `/todos` for the full keyboard-accessible list. Regular mode stays compact; Pi's tool-output expansion does not change this widget. `ctrl+shift+t` retains the separate fully collapsed view.
+
+Expansion and scroll position survive same-session refresh, tree navigation, and compaction, with offsets clamped as tasks change. Foreground session replacement and shutdown reset the view; background sessions do not affect it. Task data and `/todos` are unchanged.
 
 ### Try session TODO
 
-Use an installed 1.5.0-or-later package (or a checkout), ask the agent to track a task with `todo`, then run `/todos`. The widget shows up to five tasks by default; the modal shows the entire grouped list with arrow/Page Up/Down scrolling. If your `maxWidgetLines` configuration overrides the default, set it to `7` to show five task rows.
+Use this checkout (or a package containing the three-task preview), ask the agent to track a task with `todo`, then run `/todos`. The modal shows the entire grouped list with arrow/Page Up/Down scrolling. `maxWidgetLines: 7` permits five task rows in the expanded fullscreen widget; the preview remains capped at three. Smaller budgets also constrain the preview. Fullscreen widget mouse handling uses Pi's public 0.99.1 component APIs.
 
-**Verification to date (not complete):** Prior feature checks passed 187 extension tests, 60 script tests, typecheck, and lint. A disposable Pi TUI with seeded tasks showed the modal's progress meter, grouped rows, scroll footer, and close behavior. Authenticated RPC turns exercised all six `todo` actions, and an authenticated TUI smoke observed widget and `/todos` updates. An RPC lifecycle check observed an empty new session and the completed task on switching back. Compaction replay remains unverified because Pi returned “Nothing to compact (session too small).” Language switching in the authenticated TODO flow remains unverified (an isolated TUI with both extensions did switch English to Spanish). Visual strikethrough of completed rows in the authenticated TUI remains unverified. Launch under an installed Osdy account profile remains unverified. These checks do not establish full feature parity or validate a published npm artifact.
+**Verification to date (not complete):** The user confirmed fullscreen appearance and behavior via `pi:dev`. Automated PTY interaction passed 27 assertions, but fixture cleanup failed and the final task snapshot remains unverified; this was not a full end-to-end pass. Prior feature checks passed 187 extension tests, 60 script tests, typecheck, and lint. A disposable Pi TUI with seeded tasks showed the modal's progress meter, grouped rows, scroll footer, and close behavior. Authenticated RPC turns exercised all six `todo` actions, and an authenticated TUI smoke observed widget and `/todos` updates. An RPC lifecycle check observed an empty new session and the completed task on switching back. Compaction replay remains unverified because Pi returned “Nothing to compact (session too small).” Language switching in the authenticated TODO flow remains unverified (an isolated TUI with both extensions did switch English to Spanish). Visual strikethrough of completed rows in the authenticated TUI remains unverified. Launch under an installed Osdy account profile remains unverified. These checks do not establish full feature parity or validate a published npm artifact.
 
 ### TODO configuration and language
 
@@ -244,7 +249,7 @@ Before rename or removal, close this Pi process when it uses the target and **ma
 
 | Area | Included behavior |
 | --- | --- |
-| Themes | 14 built-in themes, including Osdy, Kanagawa, Dracula, Catppuccin, Matrix, and Lucent Orange palettes |
+| Themes | 18 built-in themes, including Osdy, Kanagawa, Dracula, Gruvbox, Nord, Rosé Pine, Daniela Cute, Catppuccin, Matrix, and Lucent Orange palettes |
 | Header and mascot | Independently selectable `osdy-theme`/`neon` headers and `current`/`bts` mascots |
 | Messages | Native colored user cards without emojis and plain assistant Markdown with a separate assistant `🦝` row |
 | Input | Responsive auto editor by default, with selectable simple Pi-native or extended framed modes |
@@ -258,6 +263,11 @@ Before rename or removal, close this Pi process when it uses the target and **ma
 
 ### Themes
 
+The bundle contains **18 themes**; Gruvbox Dark, Nord, Rosé Pine base dark, and Daniela Cute are included starting in **1.8.0**. To try the **1.8.0 release candidate** before npm publication is confirmed:
+
+1. Run `npm run pi:dev` from the 1.8.0 checkout, or `/reload` if that checkout is already loaded in Pi.
+2. Open `/settings` → **Theme** and select `osdy-pi-gruvbox-dark`, `osdy-pi-nord`, `osdy-pi-rose-pine`, `osdy-pi-daniela-cute`, or another name below.
+
 | Theme | Use |
 | --- | --- |
 | `osdy-pi-new` | Landing palette: cyan, violet, silver, and navy. |
@@ -268,6 +278,10 @@ Before rename or removal, close this Pi process when it uses the target and **ma
 | `osdy-pi-kanagawa-dragon` | Kanagawa Dragon dark palette. |
 | `osdy-pi-kanagawa-lotus` | Kanagawa Lotus light palette. |
 | `osdy-pi-dracula` | Dracula Classic dark palette. |
+| `osdy-pi-gruvbox-dark` | [Gruvbox](https://github.com/morhetz/gruvbox#palette) dark palette: warm, retro colors on the medium-contrast background. |
+| `osdy-pi-nord` | [Nord](https://www.nordtheme.com/docs/colors-and-palettes) dark palette: cool, restrained Polar Night, Snow Storm, Frost, and Aurora colors. |
+| `osdy-pi-rose-pine` | [Rosé Pine](https://rosepinetheme.com/palette/ingredients/) base dark palette: soft colors, not Moon or Dawn. |
+| `osdy-pi-daniela-cute` | Daniela Cute: navy panels/export page (`#0B1220`), blue cards (`#111F33`), borders (`#253A55`), blue accents (`#3584E4`), main text (`#D8E2EF`), secondary text (`#93A6BE`), and selection (`#193655`). Distinct status and syntax colors remain; the terminal background remains unchanged. |
 | `osdy-pi-catppuccin-latte` | Catppuccin Latte light palette. |
 | `osdy-pi-catppuccin-frappe` | Catppuccin Frappé dark palette. |
 | `osdy-pi-catppuccin-macchiato` | Catppuccin Macchiato dark palette. |

package/extensions/osdy-pi/runtime.test.ts

@@ -408,7 +408,8 @@ void test("every registered theme defines native user message colors", () => {
 		readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
 	) as { pi: { themes: string[] } };
 
-	assert.equal(manifest.pi.themes.length, 14);
+	assert.equal(manifest.pi.themes.length, 18);
+	assert.equal(new Set(manifest.pi.themes).size, 18, "theme registrations must be unique");
 	for (const themePath of manifest.pi.themes) {
 		const theme = JSON.parse(
 			readFileSync(
@@ -427,6 +428,29 @@ void test("every registered theme defines native user message colors", () => {
 	}
 });
 
+void test("new dark themes are explicitly registered with unique matching names", () => {
+	const manifest = JSON.parse(
+		readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
+	) as { pi: { themes: string[] } };
+	const names = manifest.pi.themes.map((path) => {
+		const theme = JSON.parse(readFileSync(new URL(`../../${path}`, import.meta.url), "utf8")) as { name: string };
+		assert.equal(path, `./themes/${theme.name}.json`);
+		return theme.name;
+	});
+	assert.equal(new Set(names).size, names.length, "theme names must be unique");
+	for (const name of ["osdy-pi-gruvbox-dark", "osdy-pi-nord", "osdy-pi-rose-pine", "osdy-pi-daniela-cute"]) {
+		assert.equal(manifest.pi.themes.filter((path) => path === `./themes/${name}.json`).length, 1);
+		assert.equal(names.filter((registered) => registered === name).length, 1);
+	}
+});
+
+void test("README documents all 18 themes including Daniela Cute", () => {
+	const readme = readFileSync(new URL("../../README.md", import.meta.url), "utf8");
+	assert.match(readme, /\*\*18 themes\*\*/);
+	assert.match(readme, /18 built-in themes/);
+	assert.match(readme, /\| `osdy-pi-daniela-cute` \| Daniela Cute/);
+});
+
 void test("Tokyo Night retains its approved native user card colors", () => {
 	const theme = JSON.parse(
 		readFileSync(

package/extensions/osdy-pi/todo-widget.test.ts

@@ -5,6 +5,7 @@ import test from "node:test";
 import { fileURLToPath } from "node:url";
 import ts from "typescript";
 import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
+import type { Component, TuiMouseEvent, TuiMode } from "@earendil-works/pi-tui";
 import type { TodoConfig } from "./todo-config.js";
 import type { TodoI18n } from "./todo-i18n.js";
 
@@ -25,11 +26,11 @@ registerHooks({
 const { registerTodoWidget } = await import("./todo-widget.js");
 const { createTodoSessionStore } = await import("./todo-session.js");
 const { applyTodo } = await import("./todo-domain.js");
-const { visibleWidth } = await import("@earendil-works/pi-tui");
+const { visibleWidth, Container } = await import("@earendil-works/pi-tui");
 const theme = { fg: (_color: string, text: string) => text, strikethrough: (text: string) => `~${text}~` };
 function harness(config: () => TodoConfig = () => ({}), i18n?: TodoI18n) {
  type Context = { hasUI: boolean; ui: typeof ui; sessionManager: { getSessionId(): string } };
- type Factory = (tui: { requestRender(force?: boolean): void }, theme: Theme) => { render(width: number): string[] };
+ type Factory = (tui: { mode: TuiMode; requestRender(force?: boolean): void }, theme: Theme) => Component;
  const handlers = new Map<string, ((event: { toolName?: string }, ctx: Context) => void)[]>();
  const shortcuts = new Map<string, (ctx: Context) => void>();
  const widgets: Array<{ key: string; factory: Factory | undefined; options: { placement: string } | undefined }> = [];
@@ -42,8 +43,27 @@ function harness(config: () => TodoConfig = () => ({}), i18n?: TodoI18n) {
  const emit = (name: string, context: Context, event: { toolName?: string } = {}) => { for (const handler of handlers.get(name) ?? []) handler(event, context); };
  const state = (id: string, tasks: { id: number; subject: string; status: "pending" | "in_progress" | "completed" | "deleted"; blockedBy?: number[]; activeForm?: string }[]) => store.set(id, { tasks, nextId: Math.max(1, ...tasks.map((t) => t.id + 1)) });
  const action = (id: string, kind: "create" | "clear", subject?: string) => store.set(id, applyTodo(store.get(id), kind, subject === undefined ? {} : { subject }).state);
- const lines = (width = 80): string[] => widgets.at(-1)?.factory?.({ requestRender(force?: boolean) { renders.push(force === true); } }, theme as Theme).render(width) ?? [];
- return { ui, widgets, renders, shortcuts, ctx, emit, state, action, lines };
+ const host = { mode: "fullscreen" as TuiMode, requestRender(force?: boolean) { renders.push(force === true); } };
+ let factory: Factory | undefined;
+ let component: Component | undefined;
+ const current = () => {
+  if (factory !== widgets.at(-1)?.factory) {
+   factory = widgets.at(-1)?.factory;
+   component = factory?.(host, theme as Theme);
+  }
+  return component;
+ };
+ const lines = (width = 80): string[] => current()?.render(width) ?? [];
+ const mouse = (change: Partial<TuiMouseEvent> = {}, clippedHeight?: number) => {
+  const child = current();
+  if (!child) return undefined;
+  const container = new Container(); container.addChild(child);
+  const rendered = container.render(80);
+  return container.handleMouse({ type: "click", button: "left", x: 0, y: 0,
+   screenX: 0, screenY: 0, width: 80, height: clippedHeight ?? rendered.length,
+   shift: false, alt: false, ctrl: false, ...change });
+ };
+ return { ui, host, widgets, renders, shortcuts, ctx, emit, state, action, lines, mouse, store };
 }
 const task = (id: number, status: "pending" | "in_progress" | "completed" | "deleted" = "pending", extra: { activeForm?: string; blockedBy?: number[] } = {}) => ({ id, status, subject: `Task ${id}`, ...extra });
 
@@ -102,24 +122,23 @@ void test("deleted tasks remain excluded while completed and pending tasks persi
  assert.deepEqual(h.lines(), []);
 });
 
-void test("default widget shows five task rows at the six-task boundary, with a truthful hint", () => {
+void test("default widget shows three task rows at the six-task boundary, with a truthful hint", () => {
  const h = harness(); const c = h.ctx("main"); h.emit("session_start", c);
  h.state("main", Array.from({ length: 6 }, (_, i) => task(i + 1)));
  h.emit("tool_execution_end", c, { toolName: "todo" });
- assert.deepEqual(h.lines(), ["● Todos (0/6)", ...Array.from({ length: 5 }, (_, i) => `├─ ○ Task ${i + 1}`), "└─ +1 more (1 pending)", ""]);
- h.ui.expanded = true;
- assert.equal(h.lines().length, 8);
- assert.equal(h.lines()[6], "└─ ○ Task 6");
+ assert.deepEqual(h.lines(), ["● Todos (0/6)", ...Array.from({ length: 3 }, (_, i) => `├─ ○ Task ${i + 1}`), "└─ +3 more (3 pending)", ""]);
+ h.ui.expanded = true; // Pi's tool expansion is not the widget's display preference.
+ assert.equal(h.lines().length, 6);
 });
 
-void test("five or fewer default task rows keep completed subjects struck through without overflow", () => {
+void test("three or fewer preview rows retain completed subjects and completed overflow counts", () => {
  const h = harness(); const c = h.ctx("main"); h.emit("session_start", c);
- h.state("main", [task(1, "completed"), ...Array.from({ length: 4 }, (_, i) => task(i + 2))]);
+ h.state("main", [task(1, "completed"), task(2), task(3)]);
  h.emit("tool_execution_end", c, { toolName: "todo" });
- assert.deepEqual(h.lines(), ["● Todos (1/5)", "├─ ✓ ~Task 1~", "├─ ○ Task 2", "├─ ○ Task 3", "├─ ○ Task 4", "└─ ○ Task 5", ""]);
+ assert.deepEqual(h.lines(), ["● Todos (1/3)", "├─ ✓ ~Task 1~", "├─ ○ Task 2", "└─ ○ Task 3", ""]);
  h.state("main", [task(1, "completed"), ...Array.from({ length: 5 }, (_, i) => task(i + 2, "completed"))]);
- assert.equal(h.lines().length, 8);
- assert.equal(h.lines().at(-2), "└─ +1 more (1 completed)");
+ assert.equal(h.lines().length, 6);
+ assert.equal(h.lines().at(-2), "└─ +3 more (3 completed)");
  assert.match(h.lines()[1] ?? "", /~Task 1~/);
 });
 
@@ -127,15 +146,16 @@ void test("default widget retains completed strikethrough when overflow contains
  const h = harness(); const c = h.ctx("main"); h.emit("session_start", c);
  h.state("main", [task(1, "completed"), ...Array.from({ length: 14 }, (_, i) => task(i + 2))]);
  h.emit("tool_execution_end", c, { toolName: "todo" });
- assert.deepEqual(h.lines(), ["● Todos (1/15)", ...Array.from({ length: 5 }, (_, i) => `├─ ○ Task ${i + 2}`), "└─ +10 more (1 completed, 9 pending)", ""]);
+ assert.deepEqual(h.lines(), ["● Todos (1/15)", ...Array.from({ length: 3 }, (_, i) => `├─ ○ Task ${i + 2}`), "└─ +12 more (1 completed, 11 pending)", ""]);
  h.ui.expanded = true;
- assert.equal(h.lines().length, 17);
+ assert.equal(h.lines().length, 6);
+ h.mouse();
  assert.equal(h.lines()[1], "├─ ✓ ~Task 1~");
 });
 
 void test("configured widget budget preserves small and boundary lists without hiding overflow", () => {
  for (const maxWidgetLines of [3, 7.5, 8]) {
-  const slots = Math.floor(maxWidgetLines - 2);
+  const slots = Math.min(3, Math.floor(maxWidgetLines - 2));
   const h = harness(() => ({ maxWidgetLines })); const c = h.ctx("main"); h.emit("session_start", c);
   h.state("main", Array.from({ length: slots }, (_, i) => task(i + 1)));
   h.emit("tool_execution_end", c, { toolName: "todo" });
@@ -147,12 +167,12 @@ void test("configured widget budget preserves small and boundary lists without h
  }
 });
 
-void test("overflow drops completed first and expands on Pi tool expansion", () => {
+void test("overflow drops completed first and ignores Pi tool expansion", () => {
  const h = harness(); const c = h.ctx("main"); h.emit("session_start", c);
  h.state("main", Array.from({ length: 15 }, (_, i) => task(i + 1, i % 3 === 0 ? "completed" : "pending")));
  h.emit("tool_execution_end", c, { toolName: "todo" });
- assert.equal(h.lines().length, 8); assert.match(h.lines()[6] ?? "", /\+10 more \(5 completed, 5 pending\)/);
- h.ui.expanded = true; assert.equal(h.lines().length, 17);
+ assert.equal(h.lines().length, 6); assert.match(h.lines()[4] ?? "", /\+12 more \(5 completed, 7 pending\)/);
+ h.ui.expanded = true; assert.equal(h.lines().length, 6);
 });
 
 void test("branch lifecycle retains completed rows and rebinds replacement UI safely", () => {
@@ -174,7 +194,7 @@ void test("overflow unfinished tail reports pending and hides completed first",
  const h = harness(); const c = h.ctx("main"); h.emit("session_start", c);
  h.state("main", [task(1, "completed"), ...Array.from({ length: 14 }, (_, i) => task(i + 2))]);
  h.emit("tool_execution_end", c, { toolName: "todo" });
- assert.match(h.lines()[6] ?? "", /\+10 more \(1 completed, 9 pending\)/);
+ assert.match(h.lines()[4] ?? "", /\+12 more \(1 completed, 11 pending\)/);
  assert.doesNotMatch(h.lines().join(" "), /Task 1(?!\d)/);
 });
 
@@ -185,7 +205,7 @@ void test("configured budget changes each render while key binds once and hint f
  h.emit("tool_execution_end", c, { toolName: "todo" });
  assert.equal(h.lines().length, 4);
  config = { maxWidgetLines: 8, collapseKey: "ctrl+g" };
- assert.equal(h.lines().length, 7);
+ assert.equal(h.lines().length, 6);
  assert.equal(h.shortcuts.has("ctrl+g"), false);
  h.shortcuts.get("alt+f5")?.(c);
  assert.match(h.lines()[1] ?? "", /ctrl\+g to expand/);
@@ -224,6 +244,84 @@ void test("widget reads live translations for heading, overflow, statuses and co
  assert.equal(h.lines()[1], "└─ ctrl+shift+t to expand");
 });
 
+void test("fullscreen header alone toggles bounded expansion; regular mode stays compact", () => {
+ const h = harness(); const c = h.ctx("main");
+ h.state("main", Array.from({ length: 8 }, (_, i) => task(i + 1)));
+ h.emit("session_start", c);
+ const original = structuredClone(h.store.get("main"));
+ assert.equal(h.mouse({ button: "right" }), undefined);
+ assert.equal(h.mouse({ y: 1 }), undefined);
+ assert.equal(h.mouse({ type: "press" }), undefined);
+ assert.equal(h.mouse({ type: "wheel", wheelDelta: 1 }), undefined);
+ h.host.mode = "regular";
+ assert.equal(h.mouse(), undefined);
+ assert.equal(h.lines().length, 6);
+ h.host.mode = "fullscreen";
+ assert.equal(h.mouse()?.handled, true);
+ assert.equal(h.lines().length, 8); // bounded to five tasks, not all eight
+ assert.equal(h.mouse()?.handled, true);
+ assert.equal(h.lines().length, 6);
+ assert.deepEqual(h.store.get("main"), original);
+});
+
+void test("real Container intrinsic-height dispatch reaches the last task with only one dock task row", () => {
+ const h = harness(); const c = h.ctx("main");
+ h.state("main", Array.from({ length: 9 }, (_, i) => task(i + 1)));
+ h.emit("session_start", c); h.mouse({}, 2);
+ const original = structuredClone(h.store.get("main"));
+ for (let id = 1; id <= 9; id++) {
+  const clippedDock = h.lines().slice(0, 2);
+  assert.equal(clippedDock[0], "● Todos (0/9)");
+  assert.match(clippedDock[1] ?? "", new RegExp(`Task ${id}$`));
+  const result = h.mouse({ type: "wheel", button: "none", y: 1, wheelDelta: 7 }, 2);
+  assert.equal(result?.handled, true);
+  assert.ok((result?.target.height ?? 0) > 2); // Container forwards intrinsic height
+ }
+ assert.match(h.lines()[1] ?? "", /Task 9$/);
+ assert.equal(h.mouse({ type: "wheel", wheelDelta: 0 }, 2)?.handled, true);
+ assert.equal(h.mouse({ type: "wheel", wheelDelta: Number.NaN }, 2)?.handled, true);
+ assert.match(h.lines()[1] ?? "", /Task 9$/);
+ assert.equal(h.mouse({ type: "wheel", wheelDelta: -3 }, 2)?.handled, true);
+ assert.match(h.lines()[1] ?? "", /Task 8$/);
+ h.host.mode = "regular";
+ assert.equal(h.mouse({ type: "wheel", wheelDelta: 1 }), undefined);
+ assert.equal(h.lines().length, 6);
+ h.host.mode = "fullscreen";
+ assert.match(h.lines()[1] ?? "", /Task 8$/);
+ assert.deepEqual(h.store.get("main"), original);
+});
+
+void test("expanded offsets survive refresh and tree, clamp on deletion and reset on replacement/shutdown", () => {
+ const h = harness(); const c = h.ctx("main");
+ h.state("main", Array.from({ length: 7 }, (_, i) => task(i + 1)));
+ h.emit("session_start", c); h.mouse();
+ for (let i = 0; i < 6; i++) h.mouse({ type: "wheel", wheelDelta: 1 });
+ h.renders.length = 0;
+ h.emit("tool_execution_end", c, { toolName: "todo" });
+ assert.deepEqual(h.renders, [false]);
+ assert.match(h.lines()[1] ?? "", /Task 7$/);
+ h.emit("session_tree", c); h.emit("session_compact", c);
+ assert.match(h.lines()[1] ?? "", /Task 7$/);
+ h.state("main", [task(1, "completed"), task(2, "deleted"), task(3, "in_progress")]);
+ h.emit("tool_execution_end", c, { toolName: "todo" });
+ assert.equal(h.lines()[0], "● Todos (1/2)");
+ assert.match(h.lines()[1] ?? "", /Task 3$/);
+ assert.match(h.lines().at(-2) ?? "", /\+1 more \(1 completed\)/);
+ h.shortcuts.get("ctrl+shift+t")?.(c);
+ assert.match(h.lines()[1] ?? "", /to expand/);
+ assert.equal(h.mouse({ type: "wheel", wheelDelta: 1 }), undefined);
+ h.shortcuts.get("ctrl+shift+t")?.(c);
+ assert.match(h.lines()[1] ?? "", /Task 3$/);
+ const next = h.ctx("next"); // same foreground UI denotes session replacement
+ h.state("next", Array.from({ length: 7 }, (_, i) => task(i + 1)));
+ h.emit("session_start", next);
+ assert.equal(h.lines().length, 6);
+ h.mouse(); assert.match(h.lines()[1] ?? "", /Task 1$/);
+ h.emit("session_shutdown", c); assert.notEqual(h.widgets.at(-1)?.factory, undefined);
+ h.emit("session_shutdown", next); assert.equal(h.widgets.at(-1)?.factory, undefined);
+ h.emit("session_start", next); assert.equal(h.lines().length, 6);
+});
+
 void test("headless and child sessions do not bind, refresh, collapse or dispose foreground", () => {
  const h = harness(); const main = h.ctx("main"), child = h.ctx("child", true, { ...h.ui });
  h.emit("session_start", h.ctx("headless", false)); h.state("headless", [task(1)]); h.emit("tool_execution_end", h.ctx("headless", false), { toolName: "todo" }); assert.equal(h.widgets.length, 0);

package/extensions/osdy-pi/todo-widget.ts

@@ -1,6 +1,6 @@
 // Widget behavior adapted independently from @juicesharp/rpiv-todo@2.11.0 (MIT); see root LICENSE.
 import type { ExtensionAPI, ExtensionContext, ExtensionUIContext, Theme } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, type TUI } from "@earendil-works/pi-tui";
+import { truncateToWidth, type TUI, type TuiMouseEvent, type TuiMouseEventResult } from "@earendil-works/pi-tui";
 import { COLLAPSE_KEY_OFF, getMaxWidgetLines, loadTodoConfig, resolveCollapseKey, type TodoConfig } from "./todo-config.js";
 import type { TodoTask } from "./todo-domain.js";
 import { todoI18n, type TodoI18n } from "./todo-i18n.js";
@@ -42,6 +42,9 @@ export function registerTodoWidget(pi: ExtensionAPI, store: Store, config: () =>
  let mounted = false;
  let tui: TUI | undefined;
  let collapsed = false;
+ let expanded = false;
+ let offset = 0;
+ const clampOffset = (length: number) => { offset = Math.max(0, Math.min(offset, length - 1)); };
  const visible = () => store.get(foreground ?? "").tasks.filter((task) => task.status !== "deleted");
  const render = (theme: Theme, width: number): string[] => {
   const tasks = visible();
@@ -55,8 +58,14 @@ export function registerTodoWidget(pi: ExtensionAPI, store: Store, config: () =>
    const hint = key === COLLAPSE_KEY_OFF ? i18n.t("overlay.collapsed", "collapsed") : i18n.t("overlay.expandHint", "{key} to expand").replace("{key}", key);
    return [heading, trunc(`${theme.fg("dim", "└─")} ${theme.fg("dim", hint)}`), ""];
   }
-  const expanded = ui?.getToolsExpanded?.() === true;
-  const { rows, completed, pending } = layout(tasks, expanded ? tasks.length + 1 : getMaxWidgetLines(config()) - 1);
+  clampOffset(tasks.length);
+  const slots = Math.max(1, Math.floor(getMaxWidgetLines(config()) - 2));
+  const viewport = expanded && tui?.mode === "fullscreen";
+  const rows = viewport ? tasks.slice(offset, offset + slots) : layout(tasks, Math.min(3, slots) + 1).rows;
+  const kept = new Set(rows);
+  const omitted = tasks.filter((task) => !kept.has(task));
+  const completed = omitted.filter((task) => task.status === "completed").length;
+  const pending = omitted.length - completed;
   const ids = tasks.some((task) => (task.blockedBy?.length ?? 0) > 0);
   const lines = [heading];
   for (const task of rows) {
@@ -72,14 +81,29 @@ export function registerTodoWidget(pi: ExtensionAPI, store: Store, config: () =>
   lines.push("");
   return lines;
  };
+ const handleMouse = (event: TuiMouseEvent): TuiMouseEventResult | undefined => {
+  if (tui?.mode !== "fullscreen" || !visible().length) return undefined;
+  if (event.type === "click" && event.button === "left" && event.y === 0) {
+   collapsed = false; expanded = !expanded; offset = 0;
+  } else if (event.type === "wheel" && expanded && !collapsed) {
+   // Container supplies intrinsic height, not the clipped dock height. Move one
+   // task per event, allowing the final task to reach the first row below heading.
+   const delta = event.wheelDelta ?? 0;
+   if (Number.isFinite(delta)) offset += Math.sign(delta);
+   clampOffset(visible().length);
+  } else return undefined;
+  tui.requestRender();
+  return { handled: true };
+ };
  const refresh = () => {
+  clampOffset(visible().length);
   if (!ui) return;
   if (!visible().length) {
    if (mounted) { ui.setWidget(KEY, undefined); mounted = false; tui = undefined; }
   } else if (!mounted) {
    ui.setWidget(KEY, (host, theme) => {
     tui = host;
-    return { render: (width: number) => render(ui?.theme ?? theme, width), invalidate() {} };
+    return { render: (width: number) => render(ui?.theme ?? theme, width), handleMouse, invalidate() {} };
    }, { placement: "aboveEditor" });
    mounted = true;
   } else tui?.requestRender();
@@ -89,7 +113,10 @@ export function registerTodoWidget(pi: ExtensionAPI, store: Store, config: () =>
  pi.on("session_start", (_event, ctx) => {
   if (!ctx.hasUI) return;
   const session = id(ctx);
-  if (foreground !== undefined && foreground !== session) return;
+  // A different session on another UI is a background child. The foreground
+  // UI reused for a new session is replacement; tree/compact keep preference.
+  if (foreground !== undefined && foreground !== session && ctx.ui !== ui) return;
+  if (foreground !== session) { collapsed = false; expanded = false; offset = 0; }
   if (ui && ui !== ctx.ui && mounted) ui.setWidget(KEY, undefined);
   if (ui !== ctx.ui) { mounted = false; tui = undefined; }
   foreground = session; ui = ctx.ui; refresh();
@@ -99,7 +126,7 @@ export function registerTodoWidget(pi: ExtensionAPI, store: Store, config: () =>
  pi.on("session_shutdown", (_event, ctx) => {
   if (!foregroundEvent(ctx)) return;
   if (mounted) ui?.setWidget(KEY, undefined);
-  mounted = false; tui = undefined; ui = undefined; foreground = undefined; collapsed = false;
+  mounted = false; tui = undefined; ui = undefined; foreground = undefined; collapsed = false; expanded = false; offset = 0;
  });
  pi.on("tool_execution_end", (event, ctx) => {
   if (event.toolName === "todo" && event.isError !== true && foregroundEvent(ctx)) refresh();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "osdy-pi",
-	"version": "1.6.1",
+	"version": "1.8.0",
 	"description": "Osdy Pi package: themes, header, and custom editor for Pi.",
 	"license": "MIT",
 	"type": "module",
@@ -41,6 +41,10 @@
 			"./themes/osdy-pi-kanagawa-dragon.json",
 			"./themes/osdy-pi-kanagawa-lotus.json",
 			"./themes/osdy-pi-dracula.json",
+			"./themes/osdy-pi-gruvbox-dark.json",
+			"./themes/osdy-pi-nord.json",
+			"./themes/osdy-pi-rose-pine.json",
+			"./themes/osdy-pi-daniela-cute.json",
 			"./themes/osdy-pi-catppuccin-latte.json",
 			"./themes/osdy-pi-catppuccin-frappe.json",
 			"./themes/osdy-pi-catppuccin-macchiato.json",
@@ -65,8 +69,8 @@
 		}
 	},
 	"devDependencies": {
-		"@earendil-works/pi-coding-agent": "^0.84.4",
-		"@earendil-works/pi-tui": "^0.84.4",
+		"@earendil-works/pi-coding-agent": "0.99.1",
+		"@earendil-works/pi-tui": "0.99.1",
 		"@eslint/js": "^9.39.1",
 		"@types/node": "^25.8.0",
 		"eslint": "^9.39.1",

package/themes/osdy-pi-daniela-cute.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "osdy-pi-daniela-cute",
+  "appearance": "dark",
+  "vars": {
+    "navy": "#0B1220",
+    "card": "#111F33",
+    "border": "#253A55",
+    "cobalt": "#3584E4",
+    "selection": "#193655",
+    "text": "#D8E2EF",
+    "muted": "#93A6BE",
+    "dim": "#7895BA",
+    "green": "#32D583",
+    "red": "#FF5364",
+    "yellow": "#FFC247",
+    "cyan": "#22D3EE",
+    "violet": "#A970FF",
+    "orange": "#FF963C",
+    "pink": "#F54DB8"
+  },
+  "colors": {
+    "accent": "cobalt",
+    "border": "border",
+    "borderAccent": "cobalt",
+    "borderMuted": "border",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "muted",
+    "dim": "dim",
+    "text": "text",
+    "thinkingText": "muted",
+    "selectedBg": "selection",
+    "scrollbarTrack": "card",
+    "scrollbarThumb": "cobalt",
+    "searchMatchBg": "yellow",
+    "searchMatchText": "navy",
+    "userMessageBg": "card",
+    "userMessageText": "text",
+    "customMessageBg": "card",
+    "customMessageText": "text",
+    "customMessageLabel": "cyan",
+    "toolPendingBg": "navy",
+    "toolSuccessBg": "navy",
+    "toolErrorBg": "navy",
+    "toolTitle": "cyan",
+    "toolOutput": "text",
+    "mdHeading": "cyan",
+    "mdLink": "cyan",
+    "mdLinkUrl": "muted",
+    "mdCode": "green",
+    "mdCodeBlock": "text",
+    "mdCodeBlockBorder": "border",
+    "mdQuote": "muted",
+    "mdQuoteBorder": "cobalt",
+    "mdHr": "border",
+    "mdListBullet": "orange",
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "muted",
+    "syntaxComment": "dim",
+    "syntaxKeyword": "violet",
+    "syntaxFunction": "cyan",
+    "syntaxVariable": "text",
+    "syntaxString": "green",
+    "syntaxNumber": "orange",
+    "syntaxType": "yellow",
+    "syntaxOperator": "pink",
+    "syntaxPunctuation": "muted",
+    "thinkingOff": "dim",
+    "thinkingMinimal": "cobalt",
+    "thinkingLow": "cyan",
+    "thinkingMedium": "green",
+    "thinkingHigh": "violet",
+    "thinkingXhigh": "orange",
+    "thinkingMax": "pink",
+    "bashMode": "green"
+  },
+  "export": {
+    "pageBg": "navy",
+    "cardBg": "card",
+    "infoBg": "navy"
+  }
+}

package/themes/osdy-pi-gruvbox-dark.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "osdy-pi-gruvbox-dark",
+  "appearance": "dark",
+  "vars": {
+    "bg0": "#282828",
+    "bg1": "#3c3836",
+    "bg2": "#504945",
+    "bg3": "#665c54",
+    "bg4": "#7c6f64",
+    "gray": "#928374",
+    "fg0": "#fbf1c7",
+    "fg1": "#ebdbb2",
+    "fg2": "#d5c4a1",
+    "fg3": "#bdae93",
+    "fg4": "#a89984",
+    "red": "#fb4934",
+    "green": "#b8bb26",
+    "yellow": "#fabd2f",
+    "blue": "#83a598",
+    "purple": "#d3869b",
+    "aqua": "#8ec07c",
+    "orange": "#fe8019"
+  },
+  "colors": {
+    "accent": "yellow",
+    "border": "gray",
+    "borderAccent": "orange",
+    "borderMuted": "bg2",
+    "success": "green",
+    "error": "red",
+    "warning": "yellow",
+    "muted": "fg4",
+    "dim": "gray",
+    "text": "fg1",
+    "thinkingText": "fg4",
+    "selectedBg": "bg2",
+    "scrollbarTrack": "bg1",
+    "scrollbarThumb": "gray",
+    "searchMatchBg": "yellow",
+    "searchMatchText": "bg0",
+    "userMessageBg": "bg1",
+    "userMessageText": "fg1",
+    "customMessageBg": "bg1",
+    "customMessageText": "fg1",
+    "customMessageLabel": "aqua",
+    "toolPendingBg": "bg0",
+    "toolSuccessBg": "bg1",
+    "toolErrorBg": "bg1",
+    "toolTitle": "yellow",
+    "toolOutput": "fg1",
+    "mdHeading": "yellow",
+    "mdLink": "blue",
+    "mdLinkUrl": "fg4",
+    "mdCode": "aqua",
+    "mdCodeBlock": "fg1",
+    "mdCodeBlockBorder": "gray",
+    "mdQuote": "fg3",
+    "mdQuoteBorder": "aqua",
+    "mdHr": "bg3",
+    "mdListBullet": "orange",
+    "toolDiffAdded": "green",
+    "toolDiffRemoved": "red",
+    "toolDiffContext": "fg3",
+    "syntaxComment": "gray",
+    "syntaxKeyword": "red",
+    "syntaxFunction": "green",
+    "syntaxVariable": "fg1",
+    "syntaxString": "green",
+    "syntaxNumber": "purple",
+    "syntaxType": "yellow",
+    "syntaxOperator": "orange",
+    "syntaxPunctuation": "fg1",
+    "thinkingOff": "gray",
+    "thinkingMinimal": "blue",
+    "thinkingLow": "aqua",
+    "thinkingMedium": "yellow",
+    "thinkingHigh": "orange",
+    "thinkingXhigh": "red",
+    "thinkingMax": "purple",
+    "bashMode": "green"
+  },
+  "export": {
+    "pageBg": "bg0",
+    "cardBg": "bg1",
+    "infoBg": "bg2"
+  }
+}

package/themes/osdy-pi-nord.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "osdy-pi-nord",
+  "appearance": "dark",
+  "vars": {
+    "nord0": "#2e3440",
+    "nord1": "#3b4252",
+    "nord2": "#434c5e",
+    "nord3": "#4c566a",
+    "nord4": "#d8dee9",
+    "nord5": "#e5e9f0",
+    "nord6": "#eceff4",
+    "nord7": "#8fbcbb",
+    "nord8": "#88c0d0",
+    "nord9": "#81a1c1",
+    "nord10": "#5e81ac",
+    "nord11": "#bf616a",
+    "nord12": "#d08770",
+    "nord13": "#ebcb8b",
+    "nord14": "#a3be8c",
+    "nord15": "#b48ead"
+  },
+  "colors": {
+    "accent": "nord8",
+    "border": "nord3",
+    "borderAccent": "nord9",
+    "borderMuted": "nord2",
+    "success": "nord14",
+    "error": "nord11",
+    "warning": "nord13",
+    "muted": "nord9",
+    "dim": "nord3",
+    "text": "nord4",
+    "thinkingText": "nord9",
+    "selectedBg": "nord2",
+    "scrollbarTrack": "nord1",
+    "scrollbarThumb": "nord9",
+    "searchMatchBg": "nord13",
+    "searchMatchText": "nord0",
+    "userMessageBg": "nord1",
+    "userMessageText": "nord6",
+    "customMessageBg": "nord1",
+    "customMessageText": "nord4",
+    "customMessageLabel": "nord7",
+    "toolPendingBg": "nord0",
+    "toolSuccessBg": "nord1",
+    "toolErrorBg": "nord1",
+    "toolTitle": "nord8",
+    "toolOutput": "nord4",
+    "mdHeading": "nord8",
+    "mdLink": "nord8",
+    "mdLinkUrl": "nord9",
+    "mdCode": "nord14",
+    "mdCodeBlock": "nord4",
+    "mdCodeBlockBorder": "nord3",
+    "mdQuote": "nord9",
+    "mdQuoteBorder": "nord7",
+    "mdHr": "nord3",
+    "mdListBullet": "nord9",
+    "toolDiffAdded": "nord14",
+    "toolDiffRemoved": "nord11",
+    "toolDiffContext": "nord4",
+    "syntaxComment": "nord3",
+    "syntaxKeyword": "nord9",
+    "syntaxFunction": "nord8",
+    "syntaxVariable": "nord4",
+    "syntaxString": "nord14",
+    "syntaxNumber": "nord15",
+    "syntaxType": "nord7",
+    "syntaxOperator": "nord9",
+    "syntaxPunctuation": "nord6",
+    "thinkingOff": "nord3",
+    "thinkingMinimal": "nord10",
+    "thinkingLow": "nord7",
+    "thinkingMedium": "nord13",
+    "thinkingHigh": "nord12",
+    "thinkingXhigh": "nord11",
+    "thinkingMax": "nord15",
+    "bashMode": "nord14"
+  },
+  "export": {
+    "pageBg": "nord0",
+    "cardBg": "nord1",
+    "infoBg": "nord2"
+  }
+}

package/themes/osdy-pi-rose-pine.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "osdy-pi-rose-pine",
+  "appearance": "dark",
+  "vars": {
+    "base": "#191724",
+    "surface": "#1f1d2e",
+    "overlay": "#26233a",
+    "muted": "#6e6a86",
+    "subtle": "#908caa",
+    "text": "#e0def4",
+    "love": "#eb6f92",
+    "gold": "#f6c177",
+    "rose": "#ebbcba",
+    "pine": "#31748f",
+    "foam": "#9ccfd8",
+    "iris": "#c4a7e7",
+    "highlightLow": "#21202e",
+    "highlightMed": "#403d52",
+    "highlightHigh": "#524f67"
+  },
+  "colors": {
+    "accent": "iris",
+    "border": "subtle",
+    "borderAccent": "rose",
+    "borderMuted": "highlightMed",
+    "success": "foam",
+    "error": "love",
+    "warning": "gold",
+    "muted": "subtle",
+    "dim": "muted",
+    "text": "text",
+    "thinkingText": "subtle",
+    "selectedBg": "highlightMed",
+    "scrollbarTrack": "highlightLow",
+    "scrollbarThumb": "highlightHigh",
+    "searchMatchBg": "gold",
+    "searchMatchText": "base",
+    "userMessageBg": "highlightMed",
+    "userMessageText": "text",
+    "customMessageBg": "surface",
+    "customMessageText": "text",
+    "customMessageLabel": "foam",
+    "toolPendingBg": "surface",
+    "toolSuccessBg": "overlay",
+    "toolErrorBg": "overlay",
+    "toolTitle": "iris",
+    "toolOutput": "text",
+    "mdHeading": "iris",
+    "mdLink": "foam",
+    "mdLinkUrl": "subtle",
+    "mdCode": "rose",
+    "mdCodeBlock": "text",
+    "mdCodeBlockBorder": "muted",
+    "mdQuote": "subtle",
+    "mdQuoteBorder": "pine",
+    "mdHr": "highlightMed",
+    "mdListBullet": "love",
+    "toolDiffAdded": "foam",
+    "toolDiffRemoved": "love",
+    "toolDiffContext": "subtle",
+    "syntaxComment": "muted",
+    "syntaxKeyword": "pine",
+    "syntaxFunction": "rose",
+    "syntaxVariable": "text",
+    "syntaxString": "gold",
+    "syntaxNumber": "iris",
+    "syntaxType": "foam",
+    "syntaxOperator": "subtle",
+    "syntaxPunctuation": "subtle",
+    "thinkingOff": "muted",
+    "thinkingMinimal": "pine",
+    "thinkingLow": "foam",
+    "thinkingMedium": "gold",
+    "thinkingHigh": "rose",
+    "thinkingXhigh": "love",
+    "thinkingMax": "iris",
+    "bashMode": "foam"
+  },
+  "export": {
+    "pageBg": "base",
+    "cardBg": "surface",
+    "infoBg": "overlay"
+  }
+}