@oisin-ee/pi-todo 0.2.0 → 0.3.0

package/README.md

@@ -27,9 +27,20 @@ and the list stays as it was.
 
 ## State
 
-Each change is saved as a `todo-state` entry on the session branch. There is no other state. So a resumed session,
-a `/tree` move, and calls made from inside codemode all see the list of the current branch. A widget shows the list
-while it has tasks, and `/todos` prints it.
+Each task change is saved as a `todo-state` entry on the session branch. A resumed session, a `/tree` move,
+and calls made from inside codemode all see the list of the current branch.
+
+## Widget
+
+The widget shows only in-progress tasks by default. Active tasks use the theme accent and bold text.
+Long task names wrap to the terminal width. An empty list has no widget.
+
+Press **Alt+T** to expand Upcoming, Done, and Dropped sections beneath the active task. Press **Alt+T** again to collapse them.
+`/todos` also toggles these sections. `/todos list` prints the full list.
+
+Expansion stays open through task updates. Session changes and `/tree` navigation collapse it. Expansion does not change saved tasks.
+When no task is active, a short status and the shortcut hint remain visible.
+Outside the terminal UI, `/todos` prints the list instead.
 
 ## Reminder
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oisin-ee/pi-todo",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A todo tool for pi with a Rust core: one active task, state on the session branch.",
   "keywords": [
     "pi-extension",
@@ -21,11 +21,13 @@
   "devDependencies": {
     "@earendil-works/pi-ai": "1.3.0",
     "@earendil-works/pi-coding-agent": "1.3.0",
+    "@earendil-works/pi-tui": "1.3.0",
     "typebox": "1.3.27"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },
   "pi": {

package/src/generated/todo_core.d.ts

@@ -24,6 +24,14 @@ export interface Request {
     task: string | undefined;
 }
 
+/**
+ * One row before terminal wrapping and theme application.
+ */
+export interface WidgetRow {
+    kind: WidgetKind;
+    text: string;
+}
+
 /**
  * One task, addressed by its exact content.
  */
@@ -37,6 +45,11 @@ export interface Task {
  */
 export type ReminderFact = { kind: "user" } | { kind: "snapshot"; list: TodoList } | { kind: "reminder" };
 
+/**
+ * Semantic styling for a terminal row.
+ */
+export type WidgetKind = "heading" | "active" | "upcoming" | "done" | "dropped" | "summary";
+
 /**
  * Supported model-facing operations.
  */
@@ -102,13 +115,13 @@ export function parse(snapshot: unknown): TodoList;
 export function view(list: TodoList): string;
 
 /**
- * The widget lines for `list`, or `undefined` for an empty list.
+ * Human-facing rows for `list`, or `undefined` for an empty list.
  *
  * # Errors
  *
  * Throws when `list` is not a valid todo list.
  */
-export function widget(list: TodoList): string[] | undefined;
+export function widget(list: TodoList, expanded: boolean): WidgetRow[] | undefined;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
@@ -119,7 +132,7 @@ export interface InitOutput {
     readonly init: (a: number, b: number, c: number) => void;
     readonly parse: (a: number, b: number) => void;
     readonly view: (a: number, b: number) => void;
-    readonly widget: (a: number, b: number) => void;
+    readonly widget: (a: number, b: number, c: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/src/generated/todo_core.js

@@ -149,18 +149,19 @@ export function view(list) {
 }
 
 /**
- * The widget lines for `list`, or `undefined` for an empty list.
+ * Human-facing rows for `list`, or `undefined` for an empty list.
  *
  * # Errors
  *
  * Throws when `list` is not a valid todo list.
  * @param {TodoList} list
- * @returns {string[] | undefined}
+ * @param {boolean} expanded
+ * @returns {WidgetRow[] | undefined}
  */
-export function widget(list) {
+export function widget(list, expanded) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.widget(retptr, addBorrowedObject(list));
+        wasm.widget(retptr, addBorrowedObject(list), expanded);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);

package/src/generated/todo_core_bg.wasm.d.ts

@@ -6,7 +6,7 @@ export const completion_reminder: (a: number, b: number) => void;
 export const init: (a: number, b: number, c: number) => void;
 export const parse: (a: number, b: number) => void;
 export const view: (a: number, b: number) => void;
-export const widget: (a: number, b: number) => void;
+export const widget: (a: number, b: number, c: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;

package/src/index.ts

@@ -1,11 +1,16 @@
-import { ownsTodo, replay, settle, show, start } from "./lifecycle.ts";
+import { ownsTodo, settle, show } from "./lifecycle.ts";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { StringEnum } from "@earendil-works/pi-ai";
+import { TODO_SHORTCUT } from "./widget.ts";
+import { TodoPresentation } from "./presentation.ts";
 import { Type } from "typebox";
 import { runTodo } from "./tool.ts";
 
 type TodoAPI = Readonly<
-  Pick<ExtensionAPI, "appendEntry" | "getAllTools" | "on" | "registerCommand" | "registerTool">
+  Pick<
+    ExtensionAPI,
+    "appendEntry" | "getAllTools" | "on" | "registerCommand" | "registerShortcut" | "registerTool"
+  >
 >;
 
 const items = Type.Immutable(
@@ -27,6 +32,13 @@ const items = Type.Immutable(
  * @param {TodoAPI} pi The extension API methods used here.
  */
 export default function piTodo(pi: TodoAPI): void {
+  const presentation = new TodoPresentation();
+  pi.registerShortcut(TODO_SHORTCUT, {
+    description: "Expand or collapse upcoming and done todos.",
+    handler(ctx) {
+      presentation.toggle(pi, ctx);
+    },
+  });
   pi.registerTool({
     description:
       "Keep the session todo list. Tasks are addressed by their exact content. One task is active; the next open task starts when it closes.",
@@ -37,7 +49,7 @@ export default function piTodo(pi: TodoAPI): void {
         },
         branch: () => ctx.sessionManager.getBranch(),
       });
-      replay(ctx);
+      presentation.refresh(ctx);
       return result;
     },
     executionMode: "sequential",
@@ -46,18 +58,24 @@ export default function piTodo(pi: TodoAPI): void {
     parameters,
   });
   pi.on("session_start", (_event, ctx) => {
-    start(pi, ctx);
+    presentation.start(pi, ctx);
   });
   pi.on("session_tree", (_event, ctx) => {
     if (ownsTodo(pi)) {
-      replay(ctx);
+      presentation.reset(ctx);
     }
   });
   pi.on("agent_before_settle", (event, ctx) => settle(pi, event, ctx));
   pi.registerCommand("todos", {
-    description: "Show the todo list on this session branch.",
-    async handler(_args, ctx) {
-      show(ctx);
+    description: "Toggle todo details; /todos list prints the full branch list.",
+    async handler(args, ctx) {
+      if (ownsTodo(pi)) {
+        if (args.trim() === "list" || ctx.mode !== "tui") {
+          show(ctx);
+        } else {
+          presentation.toggle(pi, ctx);
+        }
+      }
     },
   });
 }

package/src/lifecycle.ts

@@ -1,15 +1,19 @@
 import type {
   BoundaryResult,
+  ExtensionContext,
   ExtensionUIContext,
   SessionBoundaryDraft,
   SessionEntry,
+  Theme,
 } from "@earendil-works/pi-coding-agent";
 import { REMINDER_ENTRY, reminder } from "./reminder.ts";
 import { parse, view, widget } from "./wasm.ts";
+import { TodoWidget } from "./widget.ts";
 import { isOwnSource } from "./source.ts";
 import { latestSnapshot } from "./state.ts";
 
 interface TodoContext {
+  readonly mode: ExtensionContext["mode"];
   readonly sessionManager: { readonly getBranch: () => readonly SessionEntry[] };
   readonly ui: Readonly<Pick<ExtensionUIContext, "notify" | "setWidget">>;
 }
@@ -36,10 +40,21 @@ const ownsTodo = (pi: TodoHost): boolean =>
   /**
    * Renders the selected branch snapshot, and removes the widget when the list is empty.
    * @param {TodoContext} ctx Branch and UI methods.
+   * @param {boolean} expanded Whether to reveal secondary task groups.
    */
-  replay = (ctx: TodoContext): void => {
-    const list = parse(latestSnapshot(ctx.sessionManager.getBranch()));
-    ctx.ui.setWidget("pi-todo", widget(list));
+  replay = (ctx: TodoContext, expanded = false): void => {
+    if (ctx.mode !== "tui") {
+      return;
+    }
+    const list = parse(latestSnapshot(ctx.sessionManager.getBranch())),
+      rows = widget(list, expanded);
+    ctx.ui.setWidget(
+      "pi-todo",
+      rows === undefined
+        ? undefined
+        : (_tui: unknown, theme: Readonly<Pick<Theme, "fg" | "bold">>): TodoWidget =>
+            new TodoWidget(rows, expanded, theme),
+    );
   },
   /**
    * Applies the completion decision at pi's final actionable boundary.

package/src/presentation.ts

@@ -0,0 +1,48 @@
+import type { TodoContext, TodoHost } from "./lifecycle.ts";
+import { ownsTodo, replay, start } from "./lifecycle.ts";
+
+/** Owns transient expansion for one extension instance, never task state. */
+class TodoPresentation {
+  #expanded = false;
+
+  /**
+   * Replays current branch tasks without changing expansion.
+   * @param {TodoContext} ctx Current branch and UI.
+   */
+  public refresh(ctx: TodoContext): void {
+    replay(ctx, this.#expanded);
+  }
+
+  /**
+   * Collapses when the session starts or the selected branch changes.
+   * @param {TodoContext} ctx Current branch and UI.
+   */
+  public reset(ctx: TodoContext): void {
+    this.#expanded = false;
+    this.refresh(ctx);
+  }
+
+  /**
+   * Starts collapsed, or leaves another todo owner untouched.
+   * @param {TodoHost} pi Registered tool metadata.
+   * @param {TodoContext} ctx Current branch and UI.
+   */
+  public start(pi: TodoHost, ctx: TodoContext): void {
+    this.#expanded = false;
+    start(pi, ctx);
+  }
+
+  /**
+   * Reveals or hides secondary groups without writing session state.
+   * @param {TodoHost} pi Registered tool metadata.
+   * @param {TodoContext} ctx Current branch and UI.
+   */
+  public toggle(pi: TodoHost, ctx: TodoContext): void {
+    if (ownsTodo(pi)) {
+      this.#expanded = !this.#expanded;
+      this.refresh(ctx);
+    }
+  }
+}
+
+export { TodoPresentation };

package/src/wasm.ts

@@ -28,4 +28,6 @@ export type {
   Status,
   Task,
   TodoList,
+  WidgetKind,
+  WidgetRow,
 } from "./generated/todo_core.js";

package/src/widget.ts

@@ -0,0 +1,57 @@
+import { Text, truncateToWidth } from "@earendil-works/pi-tui";
+import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
+import type { WidgetKind, WidgetRow } from "./wasm.ts";
+
+const TODO_SHORTCUT = "alt+t",
+  horizontalPadding = 1,
+  verticalPadding = 0,
+  colors: Readonly<Record<WidgetKind, ThemeColor>> = {
+    active: "accent",
+    done: "success",
+    dropped: "dim",
+    heading: "muted",
+    summary: "muted",
+    upcoming: "text",
+  };
+
+/** The presentation-only component; task state stays on the session branch. */
+class TodoWidget extends Text {
+  readonly #rows: readonly Readonly<WidgetRow>[];
+  readonly #expanded: boolean;
+  readonly #theme: Readonly<Pick<Theme, "fg" | "bold">>;
+
+  /**
+   * Retains unstyled rows so each render uses the current theme.
+   * @param {readonly Readonly<WidgetRow>[]} rows Rust-owned status groups.
+   * @param {boolean} expanded Whether secondary groups are visible.
+   * @param {Readonly<Pick<Theme, "fg" | "bold">>} theme Pi theme helpers.
+   */
+  public constructor(
+    rows: readonly Readonly<WidgetRow>[],
+    expanded: boolean,
+    theme: Readonly<Pick<Theme, "fg" | "bold">>,
+  ) {
+    super("", horizontalPadding, verticalPadding);
+    this.#rows = rows;
+    this.#expanded = expanded;
+    this.#theme = theme;
+  }
+
+  /**
+   * Wraps all task text with Pi's native terminal component.
+   * @param {number} width Available terminal columns.
+   * @returns {string[]} Width-bounded, themed terminal lines.
+   */
+  public override render(width: number): string[] {
+    const lines = this.#rows.map((row) => {
+        const text = this.#theme.fg(colors[row.kind], row.text);
+        return row.kind === "active" ? this.#theme.bold(text) : text;
+      }),
+      action = this.#expanded ? "collapse" : "upcoming / done";
+    lines.push(this.#theme.fg("dim", `Alt+T · ${action}`));
+    this.setText(lines.join("\n"));
+    return super.render(width).map((line) => truncateToWidth(line, width));
+  }
+}
+
+export { TODO_SHORTCUT, TodoWidget };