@xynogen/pix-todo 0.1.8 → 0.1.10

package/README.md

@@ -6,6 +6,22 @@ Pi tool — durable execution checklist (`todo`).
 
 Registers the `todo` tool, which gives the agent a persistent task checklist that survives context compaction and session restore. The checklist is seeded by the model via the `set` action and tracks items through four statuses: `pending` (○), `in_progress` (◐), `done` (●), and `blocked` (⊘). State is persisted via Pi's `appendEntry("todo-state")` so the agent can recover its position after long runs or compaction events. The agent calls `todo(action:"list")` to resume where it left off. Actions: `list`, `set`, `add`, `update`, `clear`.
 
+## Auto-collapse
+
+The checklist card auto-collapses after a configurable delay (default 10 seconds, previously hardcoded). The delay and the per-tool toggle are read from `~/.pi/agent/pix.json`:
+
+```jsonc
+{
+  "collapse": {
+    "enabled": true,
+    "delayMs": 10000,
+    "tools": { "todo": true }
+  }
+}
+```
+
+Set `collapse.tools.todo: false` to keep the checklist always expanded. See `@xynogen/pix-data/collapse` for the full API.
+
 ## Install
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-todo",
-	"version": "0.1.8",
+	"version": "0.1.10",
 	"description": "Pi tool — durable execution checklist (todo)",
 	"type": "module",
 	"main": "src/index.ts",

package/src/todo.test.ts

@@ -504,6 +504,7 @@ describe("todo actions", () => {
 // ─── Persistence ────────────────────────────────────────────────────────────
 
 describe("persistence", () => {
+	type AppendCall = { type: string; data: unknown };
 	test("set persists todos", async () => {
 		const host = makeHost();
 		registerTodo(host.pi);
@@ -515,8 +516,9 @@ describe("persistence", () => {
 		host.appendCalls.length = 0;
 		await run(host.execute, { action: "set", items: "alpha\nbravo" });
 		expect(host.appendCalls.length).toBe(1);
-		expect(host.appendCalls[0].type).toBe("todo-state");
-		const data = host.appendCalls[0].data as {
+		const ac0 = host.appendCalls[0] as AppendCall;
+		expect(ac0.type).toBe("todo-state");
+		const data = ac0.data as {
 			todos: Array<{ id: number; text: string; status: string }>;
 			nextTodoId: number;
 		};
@@ -564,7 +566,7 @@ describe("persistence", () => {
 		host.appendCalls.length = 0;
 		await run(host.execute, { action: "clear" });
 		expect(host.appendCalls.length).toBe(1);
-		const data = host.appendCalls[0].data as {
+		const data = (host.appendCalls[0] as AppendCall).data as {
 			todos: Array<unknown>;
 			nextTodoId: number;
 		};

package/src/todo.ts

@@ -9,14 +9,66 @@
  * checklist is seeded by the model via the tool's `set` action.
  */
 
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 
 import { once } from "./once.ts";
 
-/** Seconds before a todo card collapses to a one-line dim summary. */
-const COLLAPSE_AFTER_SEC = 10;
+// ── Collapse config from ~/.pi/agent/pix.json ────────────────────────────────
+
+interface CollapseConf {
+	enabled: boolean;
+	delaySec: number;
+	tools: Record<string, boolean | undefined>;
+}
+
+const DEFAULT_COLLAPSE: CollapseConf = {
+	enabled: true,
+	delaySec: 10,
+	tools: {},
+};
+
+function readCollapseConfig(): CollapseConf {
+	try {
+		const home = process.env.HOME ?? "";
+		if (!home) return DEFAULT_COLLAPSE;
+		const p = join(home, ".pi/agent", "pix.json");
+		if (!existsSync(p)) return DEFAULT_COLLAPSE;
+		const raw = JSON.parse(readFileSync(p, "utf-8")) as Record<string, unknown>;
+		const c = raw?.collapse as Record<string, unknown> | undefined;
+		if (!c || typeof c !== "object") return DEFAULT_COLLAPSE;
+		return {
+			enabled: typeof c.enabled === "boolean" ? c.enabled : true,
+			delaySec:
+				typeof c.delaySec === "number" && c.delaySec > 0 ? c.delaySec : 10,
+			tools:
+				c.tools && typeof c.tools === "object"
+					? (c.tools as Record<string, boolean | undefined>)
+					: {},
+		};
+	} catch {
+		return DEFAULT_COLLAPSE;
+	}
+}
+
+let collapseConf: CollapseConf | null = null;
+function getCollapseConfig(): CollapseConf {
+	if (!collapseConf) collapseConf = readCollapseConfig();
+	return collapseConf;
+}
+
+function shouldCollapseTodo(): boolean {
+	const c = getCollapseConfig();
+	const perTool = c.tools.todo;
+	return typeof perTool === "boolean" ? perTool : c.enabled;
+}
+
+function collapseDelayMs(): number {
+	return getCollapseConfig().delaySec * 1000;
+}
 
 export type TodoStatus = "pending" | "in_progress" | "done" | "blocked";
 
@@ -161,11 +213,12 @@ export default function registerTodo(pi: ExtensionAPI): void {
 				};
 				if (!state.snapshot) state.snapshot = todos.map((t) => ({ ...t }));
 				// Start the collapse timer once per row; invalidate() triggers rerender.
-				if (!state.collapsed && !state.timer) {
+				// Config-driven: reads from ~/.pi/agent/pix.json collapse section.
+				if (shouldCollapseTodo() && !state.collapsed && !state.timer) {
 					state.timer = setTimeout(() => {
 						state.collapsed = true;
 						context.invalidate();
-					}, COLLAPSE_AFTER_SEC * 1000);
+					}, collapseDelayMs());
 				}
 				const render = state.collapsed
 					? renderTodoSummaryLine