@gamflaz/opencode-todolist 1.0.4 → 1.0.6

package/README.md

@@ -24,11 +24,27 @@ bun install
 bun run build
 ```
 
+Or add it directly through the OpenCode CLI:
+
+```bash
+opencode plugin add @gamflaz/opencode-todolist
+```
+
 OpenCode loads local plugins from the plugins directory, but it does not install
 their dependencies, so `bun install` is required before use.
 
 ## Tool: `manage_todo_list`
 
+#### Operation fields
+
+| Operation | Required fields                 | Optional fields                |
+| --------- | ------------------------------- | ------------------------------ |
+| `read`    | `operation`                     | None                           |
+| `write`   | `operation`, `todos`            | None; use `todos: []` to clear |
+| `update`  | `operation`, `id`, `status`     | `content`, `priority`, `note`  |
+
+For `update`, send `null` for `priority` or `note` to remove the existing value.
+
 ### Read
 
 ```json
@@ -77,6 +93,21 @@ Clear the current list:
 { "operation": "write", "todos": [] }
 ```
 
+### Fields
+
+#### Todo item fields
+
+| Field      | Type                              | Required        | Description                                                               |
+| ---------- | --------------------------------- | --------------- | ------------------------------------------------------------------------- |
+| `id`       | number                            | Yes             | Root: positive integer. Child: `<root>.<n>`, such as `1.1`.              |
+| `content`  | string                            | Yes             | Task summary.                                                             |
+| `status`   | enum                              | Yes             | `pending`, `in_progress`, `completed`, `cancelled`, or `error`.           |
+| `priority` | `high` \| `medium` \| `low`       | No              | Optional priority label.                                                  |
+| `note`     | string                            | No              | Technical context or evidence.                                            |
+| `children` | array of child items              | No, root only   | Up to 9 subtasks. Child items cannot contain more children.               |
+
+Root IDs must be unique. A child ID must start with its parent root ID.
+
 ### Update
 
 `update` changes one existing root or subtask. Send only the fields that change;
@@ -91,7 +122,7 @@ Clear the current list:
 }
 ```
 
-Field values:
+### Fields
 
 | Field      | Required | Notes                                                        |
 | ---------- | -------- | ------------------------------------------------------------ |
@@ -101,36 +132,6 @@ Field values:
 | `note`     | No       | Technical context or evidence. Pass `null` to remove.         |
 | `priority` | No       | `high`, `medium`, or `low`. Pass `null` to remove.            |
 
-## Rules
-
-1. **One root at a time, in order.** Root `2` cannot start while root `1` is
-   still open. Finish or cancel root `1` first.
-2. **One active subtask per root.** Starting a second `in_progress` subtask is
-   rejected until the first one finishes or is cancelled.
-3. **Forward-only progress.** `in_progress` never returns to `pending`, and
-   `completed` or `cancelled` items are locked.
-4. **Error exception.** A root that reports `error` may be fixed early, but only
-   that root and its own subtasks; every other root still waits its turn.
-5. **Evidence in `note`.** Record what was verified before marking an item
-   `completed`.
-
-Every response reports progress, the next step, and any status transitions, for
-example:
-
-```text
-Todos (2/4) updated. Next: 2 "Write tests". Continue immediately.
-```
-
-## TUI widget
-
-The widget sits above the session composer:
-
-- Collapsed view shows the progress count and the active item.
-- Expand it to see every task; long lists scroll.
-- `↻ Continue` asks the session to resume the next open item with a short
-  summary of what remains.
-- `✕` clears the list.
-
 ## Skills
 
 `skills/todolist` and `skills/continue-todolist` ship with the plugin and are

package/dist/icons/{capabilities.d.ts → image-capabilities.d.ts}

@@ -1,5 +1,5 @@
 import { type TerminalCapabilities } from "@opentui/core";
-/** Minimal capability view needed to decide between image and text icons. */
+/** Minimal image capability view needed to decide between image and text icons. */
 export type ImageCapabilitySnapshot = Pick<TerminalCapabilities, "kitty_graphics" | "sixel"> & Partial<Pick<TerminalCapabilities, "image_protocol" | "multiplexer">>;
 /**
  * Whether the terminal can render raster icons. Terminals without Kitty or

package/dist/icons/{convert.js → svg-icon.js}

@@ -11,7 +11,7 @@ import { usePlugin } from "@opencode/plugin/tui";
 import { rgbToHex } from "@opentui/core";
 import { Resvg } from "@resvg/resvg-js";
 import { createMemo, createSignal, onCleanup, Show } from "solid-js";
-import { supportsImageRendering } from "./capabilities";
+import { supportsImageRendering } from "./image-capabilities";
 export function SvgIcon(props) {
   const {
     source: _,

package/dist/icons/{icons.d.ts → svg-icons.d.ts}

@@ -1,3 +1,4 @@
+/** Inline SVG icons used by the TUI. */
 export declare const removeSvgIcon = "\n<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-mop-sparkles preview-icon\"><path d=\"M10 22a3 3 0 01-3-3\"/><path d=\"M10 22c2.761 0 5-1.79 5-4-4.42 0-4.08-5-8.5-5a4.501 4.501 0 000 9z\"/><path d=\"M10 3H8\"/><path d=\"M12.5 11.5 22 2\"/><path d=\"M20 13v4\"/><path d=\"M22 15h-4\"/><path d=\"M4 5v4\"/><path d=\"M6 7H2\"/><path d=\"m6.98 13.02 2.665-2.664a1.21 1.21 0 011.71 0l2.29 2.288a1.21 1.21 0 010 1.712l-2.088 2.087\"/><path d=\"M9 2v2\"/></svg>\n";
 export declare const arrowDownSvgIcon = "\n<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <path d=\"m6 9 6 6 6-6\"/>\n</svg>\n";
 export declare const arrowRightSvgIcon = "\n<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <path d=\"m9 18 6-6-6-6\"/>\n</svg>\n";

package/dist/icons/{icons.js → svg-icons.js}

@@ -1,3 +1,4 @@
+/** Inline SVG icons used by the TUI. */
 export const removeSvgIcon = `
 <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-mop-sparkles preview-icon"><path d="M10 22a3 3 0 01-3-3"/><path d="M10 22c2.761 0 5-1.79 5-4-4.42 0-4.08-5-8.5-5a4.501 4.501 0 000 9z"/><path d="M10 3H8"/><path d="M12.5 11.5 22 2"/><path d="M20 13v4"/><path d="M22 15h-4"/><path d="M4 5v4"/><path d="M6 7H2"/><path d="m6.98 13.02 2.665-2.664a1.21 1.21 0 011.71 0l2.29 2.288a1.21 1.21 0 010 1.712l-2.088 2.087"/><path d="M9 2v2"/></svg>
 `;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from "@opencode/plugin";
-import { type TodoRootItem } from "./schema/todo.schema";
+import { type TodoRootItem } from "./schemas/todo";
 export declare function formatReadOutput(todos: readonly TodoRootItem[]): string;
 export declare function formatTransitionLines(before: readonly TodoRootItem[], after: readonly TodoRootItem[]): string[];
 export declare function formatWriteOutput(todos: readonly TodoRootItem[], before?: readonly TodoRootItem[]): string;

package/dist/index.js

@@ -1,10 +1,10 @@
 import { Plugin } from "@opencode/plugin";
-import { TodoInputToolSchema, TodoOutputToolSchema, } from "./schema/todo.schema";
-import { registerTodoSkills } from "./skills/skill";
-import { readTodoData, readTodos, updateTodos } from "./store/store";
-import { buildTodoHint, consumeTodoHint, findNextTodo, findStuckParent, flattenLeaves, isAnyTodoActive, } from "./todo/hint";
-import { TodoTree } from "./todo/todo";
-import { updateTodoById } from "./todo/update";
+import { TodoInputToolSchema, TodoOutputToolSchema, } from "./schemas/todo";
+import { registerTodoSkills } from "./skills/loader";
+import { readTodoData, readTodos, updateTodos } from "./storage/todo-store";
+import { buildTodoHint, consumeTodoHint, findNextTodo, findStuckParent, flattenLeaves, isAnyTodoActive, } from "./todos/hint";
+import { TodoTree } from "./todos/todo-tree";
+import { updateTodoById } from "./todos/update";
 export function formatReadOutput(todos) {
     if (todos.length === 0)
         return "No todos recorded.";

package/dist/{schema/store.schema.d.ts → schemas/platform.d.ts}

@@ -1,4 +1,5 @@
 import z from "zod";
+/** Platform fields used to resolve the todo storage location. */
 export declare const PlatformContextSchema: z.ZodObject<{
     platform: z.ZodOptional<z.ZodEnum<{
         aix: "aix";

package/dist/{schema/store.schema.js → schemas/platform.js}

@@ -1,4 +1,5 @@
 import z from "zod";
+/** Platform fields used to resolve the todo storage location. */
 export const PlatformContextSchema = z.object({
     platform: z
         .enum([

package/dist/{schema/status.schema.d.ts → schemas/status.d.ts}

@@ -14,3 +14,5 @@ export declare const PrioritySchema: z.ZodEnum<{
 }>;
 export type Priority = z.infer<typeof PrioritySchema>;
 export declare const OPEN_STATUSES: readonly TodoStatus[];
+/** Human-readable labels used in the resume prompt. */
+export declare const StatusLabel: Record<TodoStatus, string>;

package/dist/{schema/status.schema.js → schemas/status.js}

@@ -12,3 +12,11 @@ export const OPEN_STATUSES = [
     "in_progress",
     "error",
 ];
+/** Human-readable labels used in the resume prompt. */
+export const StatusLabel = {
+    pending: "not started",
+    in_progress: "currently being worked on",
+    completed: "completed",
+    cancelled: "cancelled",
+    error: "needs fixing",
+};

package/dist/{schema/todo.schema.js → schemas/todo.js}

@@ -1,5 +1,5 @@
 import z from "zod";
-import { PrioritySchema, TodoStatusSchema } from "./status.schema";
+import { PrioritySchema, TodoStatusSchema } from "./status";
 // Child id format: <root_id>.<n> as a number -> 1.1, 2.3, etc.
 // Only a single decimal digit (1-9) is allowed, see the note below.
 const ChildIdSchema = z

package/dist/{store → storage}/errors.d.ts

@@ -1,3 +1,4 @@
+/** Error raised when persisted todo data cannot be read safely. */
 export declare class InvalidTodoDataError extends Error {
     constructor(message: string);
 }

package/dist/{store → storage}/errors.js

@@ -1,3 +1,4 @@
+/** Error raised when persisted todo data cannot be read safely. */
 export class InvalidTodoDataError extends Error {
     constructor(message) {
         super(message);

package/dist/{store/store.d.ts → storage/todo-store.d.ts}

@@ -1,4 +1,4 @@
-import { type TodoRootItem } from "../schema/todo.schema";
+import { type TodoRootItem } from "../schemas/todo";
 /**
  * Environment/OS context used to resolve storage locations. All fields are
  * optional so callers (and tests) can simulate any platform on any host.

package/dist/{store/store.js → storage/todo-store.js}

@@ -4,8 +4,8 @@ import { chmod, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises
 import { homedir, tmpdir } from "node:os";
 import { join, posix, win32 } from "node:path";
 import * as lockfile from "proper-lockfile";
-import { TodoRootItemSchema } from "../schema/todo.schema";
-import { TodoTree } from "../todo/todo";
+import { TodoRootItemSchema } from "../schemas/todo";
+import { TodoTree } from "../todos/todo-tree";
 import { InvalidTodoDataError } from "./errors";
 /**
  * Per-session todo persistence.

package/dist/{todo → todos}/display.d.ts

@@ -1,5 +1,5 @@
-import type { TodoStatus } from "../schema/status.schema";
-import type { TodoRootItem } from "../schema/todo.schema";
+import type { TodoStatus } from "../schemas/status";
+import type { TodoRootItem } from "../schemas/todo";
 export interface TodoDisplayItem {
     id: number;
     content: string;

package/dist/{todo → todos}/display.js

@@ -1,4 +1,4 @@
-import { TodoTree } from "./todo";
+import { TodoTree } from "./todo-tree";
 export function getStatusIcon(status) {
     switch (status) {
         case "completed":

package/dist/{todo → todos}/hint.d.ts

@@ -1,4 +1,4 @@
-import type { TodoChildern, TodoRootItem } from "../schema/todo.schema";
+import type { TodoChildern, TodoRootItem } from "../schemas/todo";
 export declare const DEFAULT_STALE_MS: number;
 export declare const CONTEXT_STALE_MS: number;
 export declare const TODO_HINT: string;

package/dist/{todo → todos}/hint.js

@@ -1,6 +1,6 @@
 import { readFileSync, renameSync, writeFileSync } from "node:fs";
-import { getHintMarkerPath, readTodoData, TodoStore } from "../store/store";
-import { TodoTree } from "./todo";
+import { getHintMarkerPath, readTodoData, TodoStore } from "../storage/todo-store";
+import { TodoTree } from "./todo-tree";
 export const DEFAULT_STALE_MS = 30 * 60 * 1000; // 30 minutes (prompt fallback)
 export const CONTEXT_STALE_MS = 6 * 60 * 60 * 1000; // 6 hours
 const UPCOMING_LIMIT = 3;

package/dist/{todo/todo.d.ts → todos/todo-tree.d.ts}

@@ -1,5 +1,5 @@
-import { type TodoStatus } from "../schema/status.schema.js";
-import type { TodoChildern, TodoRootItem } from "../schema/todo.schema";
+import { type TodoStatus } from "../schemas/status.js";
+import type { TodoChildern, TodoRootItem } from "../schemas/todo";
 export interface TodoProgress {
     completed: number;
     total: number;

package/dist/{todo/todo.js → todos/todo-tree.js}

@@ -1,4 +1,4 @@
-import { OPEN_STATUSES } from "../schema/status.schema.js";
+import { OPEN_STATUSES } from "../schemas/status.js";
 /**
  * A todo list (roots + children) with validation, statistics and rendering.
  *

package/dist/{todo → todos}/update.d.ts

@@ -1,5 +1,5 @@
-import type { Priority, TodoStatus } from "../schema/status.schema";
-import type { TodoRootItem, TodoUpdateInput } from "../schema/todo.schema";
+import type { Priority, TodoStatus } from "../schemas/status";
+import type { TodoRootItem, TodoUpdateInput } from "../schemas/todo";
 type UpdatableTodo = {
     content: string;
     status: TodoStatus;

package/dist/tui/layout.d.ts

@@ -0,0 +1,18 @@
+/** Rendered prefix of an error detail row. */
+export declare const ERROR_PREFIX = "\u21B3 error: ";
+/**
+ * Rendered width of a row: the indentation, the icon cell and the title.
+ *
+ * Rows must be sized explicitly, otherwise the scroll content never grows
+ * wider than the viewport and horizontal scrolling has nothing to move.
+ */
+export declare function RowWidth(row: {
+    id?: number;
+    content: string;
+    depth: number;
+}): number;
+/** Rendered width of an expanded error line under its row. */
+export declare function ErrorRowWidth(row: {
+    error: string;
+    depth: number;
+}): number;

package/dist/tui/layout.js

@@ -0,0 +1,22 @@
+import { TodoTree } from "../todos/todo-tree";
+/** Rendered prefix of an error detail row. */
+export const ERROR_PREFIX = "↳ error: ";
+/**
+ * Rendered width of a row: the indentation, the icon cell and the title.
+ *
+ * Rows must be sized explicitly, otherwise the scroll content never grows
+ * wider than the viewport and horizontal scrolling has nothing to move.
+ */
+export function RowWidth(row) {
+    const indent = row.depth > 0 ? 2 : 0;
+    const label = row.id !== undefined
+        ? `${TodoTree.formatIdPrefix(row.id, row.depth)}${row.content}`
+        : row.content;
+    // icon glyph + 1 space, then the title.
+    return indent + 1 + 1 + [...label].length;
+}
+/** Rendered width of an expanded error line under its row. */
+export function ErrorRowWidth(row) {
+    const indent = row.depth > 0 ? 4 : 2;
+    return indent + [...(ERROR_PREFIX + row.error)].length;
+}

package/dist/tui/text.d.ts

@@ -0,0 +1,2 @@
+/** Shorten prompt text without cutting the trailing ellipsis. */
+export declare function shorten(text: string, max: number): string;

package/dist/tui/text.js

@@ -0,0 +1,4 @@
+/** Shorten prompt text without cutting the trailing ellipsis. */
+export function shorten(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max - 3).trimEnd()}...`;
+}

package/dist/tui/todo-panel.d.ts

@@ -0,0 +1,77 @@
+import { Plugin } from "@opencode/plugin/tui";
+import { ColorInput, ScrollBoxRenderable } from "@opentui/core";
+import { TodoStatus } from "../schemas/status";
+/** How many open items the Continue prompt lists before collapsing the rest. */
+export declare const CONTINUE_PROMPT_MAX_ITEMS = 3;
+/** Per-field caps so one long note cannot flood the prompt. */
+export declare const CONTINUE_PROMPT_MAX_CONTENT = 60;
+export declare const CONTINUE_PROMPT_MAX_NOTE = 60;
+/**
+ * Maximum number of todo rows the panel shows before it starts scrolling.
+ * Keeping the panel compact protects the composer; scrolling guarantees no
+ * row is ever silently dropped.
+ */
+export declare const TODO_PANEL_MAX_ROWS = 8;
+export interface TodoListRow {
+    id: number;
+    content: string;
+    icon: string;
+    iconColor: ColorInput;
+    textColor: ColorInput;
+    depth: number;
+    status: TodoStatus;
+}
+/** A renderable line: either a task row or its on-demand error row. */
+export type TodoListEntry = {
+    kind: "row";
+    row: TodoListRow;
+} | {
+    kind: "error";
+    row: TodoListRow;
+};
+export interface FollowScrollInput {
+    currentTop: number;
+    activeIndex: number;
+    rowCount: number;
+    viewportHeight: number;
+}
+/**
+ * Flattens rows into renderable lines, inserting an error detail right below
+ * an expanded error row (click to toggle).
+ */
+export declare function TodoListEntries(rows: TodoListRow[], expandedIds: readonly number[]): TodoListEntry[];
+/**
+ * Follow the most advanced active row: the last `in_progress` entry is the
+ * task currently being executed. Error lines are skipped.
+ */
+export declare function FindActiveEntryIndex(entries: TodoListEntry[]): number;
+/**
+ * Scroll offset needed to reveal the active row, or `undefined` when nothing
+ * should move (no active row, already visible, or the list fits).
+ *
+ * Kept pure so the follow behaviour is testable without a live renderer.
+ */
+export declare function NextFollowScrollTop(input: FollowScrollInput): number | undefined;
+/**
+ * Presentational, context-free todo list.
+ *
+ * The panel is deliberately chrome-free: no indicator row, and the horizontal
+ * scrollbar stays hidden. Long titles never wrap — they are reached by
+ * scrolling left/right, and the vertical list scrolls when it exceeds
+ * `TODO_PANEL_MAX_ROWS`. When a row is `in_progress` the panel follows it.
+ *
+ * `activeIcon` is an accessor so the spinner updates only the icon text node
+ * instead of forcing every row object to be rebuilt on each animation frame.
+ */
+export declare function TodoList(props: {
+    rows: TodoListRow[];
+    expandedIds?: readonly number[];
+    scrollbarColor?: ColorInput;
+    activeIcon?: () => string;
+    onToggleRow?: (id: number) => void;
+    ref?: (el: ScrollBoxRenderable) => void;
+}): import("solid-js").JSX.Element;
+export declare function TodoProgress(props: {
+    context: Plugin.Context;
+    sessionID: string;
+}): import("solid-js").JSX.Element;