@leo-alvarenga/pi-todo-list 0.2.0 → 0.4.0

package/README.md

@@ -12,9 +12,13 @@ The agent manages tasks with a `todo` tool while you watch them live in a panel
 - **Live TUI panel** above the input editor — `Todos (done/total)` header,
   status glyphs (`○` pending, `◐` in-progress, `✓` completed), blocked-task
   hints, and a hardcoded row budget with a `+N more` summary line.
-- **Toggle with `Ctrl+Shift+T`** — collapsed shows just the header.
+- **Toggle with `Alt+T`** — collapsed shows just the header.
 - **`/todos` command** — prints the full list grouped by status straight to
   the terminal transcript.
+- **Batch operations** — `todo add` accepts a `texts` array to add many at
+  once, and `todo remove` accepts an `ids` array to remove many at once.
+- **`todo_complete_all` tool** — marks every todo completed and clears the
+  list in one call, telling you how many items were completed.
 - **Session-isolated state** — each session has its own list; it survives
   `/reload` and context compaction with no external files, because state is
   replayed from the session branch (tool results + custom entries), never
@@ -25,7 +29,7 @@ The agent manages tasks with a `todo` tool while you watch them live in a panel
 ## Install
 
 ```bash
-pi install ./packages/pi-todo-list
+pi install npm:@leo-alvarenga/pi-todo-list
 ```
 
 or add the local path / npm spec to your project `.pi/settings.json`, then
@@ -33,7 +37,7 @@ run `/reload`.
 
 ## Usage
 
-Tell the agent: *"track these tasks as todos: …"*, or use the tool directly:
+Tell the agent: _"track these tasks as todos: …"_, or use the tool directly:
 
 - `todo add` with `text`
 - `todo update` with `id` and optional `status` / `text` / `blockedBy`
@@ -43,22 +47,10 @@ Run `/todos` yourself at any time to see the full grouped list.
 
 ## Keybinding
 
-`Ctrl+Shift+T` toggles the panel. If your terminal intercepts that chord
+`Alt+T` toggles the panel. If your terminal intercepts that chord
 (e.g. GNOME Terminal opens a new tab), pick a free one and change
 `PANEL_TOGGLE_CHORD` in `src/constants.ts`.
 
-## Development
-
-```bash
-pnpm --filter @leo-alvarenga/pi-todo-list typecheck
-pnpm --filter @leo-alvarenga/pi-todo-list test
-```
-
-To release a new version, bump `version` in `package.json`, then push a tag
-(`git tag pi-todo-list@0.1.0 && git push origin pi-todo-list@0.1.0`). The
-`.github/workflows/publish-pi-todo-list.yml` workflow publishes to npm
-(requires the `NPM_TOKEN` repository secret).
-
 ## License
 
-MIT — see [LICENSE](LICENSE). Copyright (c) 2026 Leonardo A. Alvarenga.
+MIT — see [LICENSE](LICENSE). Copyright (c) 2026 Leonardo A. Alvarenga.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leo-alvarenga/pi-todo-list",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Session-aware todo list overlay for Pi: todo tool, /todos command, and a live TUI panel",
   "license": "MIT",
   "repository": "github.com/leo-alvarenga/pi-mono",

package/src/core.ts

@@ -168,6 +168,44 @@ function clear(): ActionResult {
   };
 }
 
+function addMany(state: TodoState, texts: string[]): ActionResult {
+  const cleaned = texts.map(cleanText);
+  if (cleaned.some((t) => !t)) return { ok: false, error: "text required for add" };
+  if (cleaned.some((t) => t && t.length > MAX_TEXT_LENGTH)) return textError();
+
+  let nextId = state.nextId;
+  const added: Todo[] = cleaned.map((t) => ({
+    text: t as string,
+    blockedBy: [],
+    id: nextId++,
+    status: "pending",
+  }));
+
+  return {
+    ok: true,
+    text: `Added ${added.length} todos: ${added.map((t) => `#${t.id}`).join(", ")}`,
+    state: { todos: [...state.todos, ...added], nextId },
+  };
+}
+
+function removeMany(state: TodoState, ids: number[]): ActionResult {
+  const missing = ids.filter((id) => !state.todos.some((t) => t.id === id));
+  if (missing.length > 0) {
+    return { ok: false, error: `todos not found: #${missing.join(", #")}` };
+  }
+
+  const gone = new Set(ids);
+  const todos = state.todos
+    .filter((t) => !gone.has(t.id))
+    .map((t) => ({ ...t, blockedBy: t.blockedBy.filter((b) => !gone.has(b)) }));
+
+  return {
+    ok: true,
+    text: `Removed ${ids.length} todos`,
+    state: { todos, nextId: state.nextId },
+  };
+}
+
 /**
  * Apply a tool action against a copy of the state.
  * Returns the new state only when validation passes; the caller commits it.
@@ -176,7 +214,9 @@ export function applyAction(
   state: TodoState,
   params: {
     id?: number;
+    ids?: number[];
     text?: string;
+    texts?: string[];
     action: TodoAction;
     status?: TodoStatus;
     blockedBy?: number[];
@@ -184,6 +224,7 @@ export function applyAction(
 ): ActionResult {
   switch (params.action) {
     case "add":
+      if (params.texts !== undefined && params.texts.length > 0) return addMany(state, params.texts);
       return add(state, params.text ?? "");
 
     case "update":
@@ -194,6 +235,7 @@ export function applyAction(
       return update(state, params.id, params);
 
     case "remove":
+      if (params.ids !== undefined && params.ids.length > 0) return removeMany(state, params.ids);
       if (params.id === undefined) {
         return { ok: false, error: "id required for remove" };
       }

package/src/index.ts

@@ -3,7 +3,7 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { registerTodosCommand } from "./command";
 import { STATE_ENTRY, WIDGET_KEY } from "./constants";
 import { TodoStore } from "./state";
-import { registerTodoTool } from "./tool";
+import { registerTodoTool, registerTodoCompleteAllTool } from "./tool";
 import { registerTodoWidget, refreshWidget } from "./widget";
 
 export default function (pi: ExtensionAPI): void {
@@ -13,6 +13,7 @@ export default function (pi: ExtensionAPI): void {
   );
 
   registerTodoTool(pi, store);
+  registerTodoCompleteAllTool(pi, store);
   registerTodosCommand(pi, store);
   registerTodoWidget(pi, store);
 

package/src/tool.ts

@@ -6,12 +6,14 @@ import { Type } from "typebox";
 import { STATUSES } from "./constants";
 import { applyAction } from "./core";
 import type { TodoStore } from "./state";
-import type { TodoDetails } from "./types";
+import type { TodoDetails, TodoState } from "./types";
 
 const TodoParams = Type.Object({
   action: StringEnum(["add", "update", "remove", "list", "clear"] as const),
   text: Type.Optional(Type.String({ description: "Task text (required for add; optional for update)" })),
-  id: Type.Optional(Type.Number({ description: "Task id (required for update/remove)" })),
+  texts: Type.Optional(Type.Array(Type.String(), { description: "Task texts; add all at once (optional; used with action=add)" })),
+  id: Type.Optional(Type.Number({ description: "Task id (required for remove; alternative to ids)" })),
+  ids: Type.Optional(Type.Array(Type.Number(), { description: "Task ids; remove all at once (optional; used with action=remove)" })),
   status: Type.Optional(StringEnum([...STATUSES] as const)),
   blockedBy: Type.Optional(Type.Array(Type.Number(), { description: "Task ids this task depends on" })),
 });
@@ -22,7 +24,14 @@ export function registerTodoTool(pi: ExtensionAPI, store: TodoStore): void {
     label: "Todo",
     parameters: TodoParams,
     description:
-      "Manage the session todo list. Actions: add (text), update (id, optional status/text/blockedBy), remove (id), list, clear",
+      "Manage the session todo list. Actions: add (text or texts), update (id, optional status/text/blockedBy), remove (id or ids), list, clear",
+    promptSnippet: "Manage the session todo list: add/update/remove/list/clear tasks",
+    promptGuidelines: [
+      "Always track the work using the todo tools.",
+      "Record each item the user wants tracked with todo add.",
+      "Keep todos current: todo update to completed as you finish items, todo remove for dropped ones.",
+      "When the user says 'complete everything' / 'done with all', use todo_complete_all instead of looping todo update.",
+    ],
 
     async execute(toolCallId, params, _signal, _onUpdate, ctx) {
       const current = store.getState(ctx);
@@ -63,4 +72,40 @@ export function registerTodoTool(pi: ExtensionAPI, store: TodoStore): void {
       return new Text(theme.fg("success", "✓ ") + theme.fg("muted", msg), 0, 0);
     },
   });
+}
+
+export function registerTodoCompleteAllTool(pi: ExtensionAPI, store: TodoStore): void {
+  pi.registerTool({
+    name: "todo_complete_all",
+    label: "Complete All Todos",
+    parameters: Type.Object({}),
+    description:
+      "Mark every todo as completed and clear the list in one shot. The result tells the user how many items were completed.",
+    promptSnippet:
+      "When the user says 'complete everything' / 'done with all', use todo_complete_all instead of looping todo update.",
+
+    async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
+      const current = store.getState(ctx);
+      const n = current.todos.length;
+      const cleared: TodoState = { todos: [], nextId: 1 };
+      store.commit(ctx, cleared);
+      return {
+        content: [{ type: "text", text: `All ${n} todos completed and cleared` }],
+        details: { action: "clear", todos: [], nextId: 1 } satisfies TodoDetails,
+      };
+    },
+
+    renderCall(_args, theme) {
+      return new Text(theme.fg("toolTitle", theme.bold("todo_complete_all")), 0, 0);
+    },
+
+    renderResult(result, _options, theme) {
+      const text = result.content[0];
+      return new Text(
+        theme.fg("success", "✓ ") + theme.fg("muted", text?.type === "text" ? text.text : ""),
+        0,
+        0,
+      );
+    },
+  });
 }