@zhushanwen/pi-todo 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,45 @@
+# todo
+
+轻量级 AI 任务清单 — 三态（pending / in_progress / completed），支持 session 持久化、状态栏、批量操作。
+
+## 功能
+
+- **三态任务**：`pending` → `in_progress` → `completed`
+- **批量操作**：add / update / delete / clear
+- **Session 持久化**：任务状态保存在 session entries 中，重启后恢复
+- **状态栏**：底部显示任务进度（如 `2/5 done`）
+- **自动清理**：所有任务完成后自动清空
+
+## 安装
+
+```bash
+# symlink 方式（开发推荐）
+ln -s /path/to/xyz-pi-extensions-workspace/main/packages/todo \
+      ~/.pi/agent/extensions/todo
+
+# npm 方式（正式）
+pi install npm:@zhushanwen/pi-todo
+```
+
+## 使用
+
+AI 可调用 `todo` 工具：
+
+| Action | 说明 |
+|--------|------|
+| `list` | 查看所有 todo |
+| `add` | 批量添加 todo |
+| `update` | 更新 todo（状态/文本） |
+| `delete` | 批量删除 |
+| `clear` | 清空所有 |
+
+用户命令：`/todos` 交互式面板。
+
+## 文件结构
+
+```
+todo/
+├── index.ts
+└── src/
+    └── index.ts    # 入口 — 工具、命令、事件、状态栏
+```

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@zhushanwen/pi-todo",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "AI-driven todo list for Pi — stateful task management with session persistence and /todos command.",
+  "type": "module",
   "main": "src/index.ts",
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
   "keywords": [
-    "pi",
+    "pi-package",
     "extension",
     "todo",
     "task",

package/src/index.ts

@@ -10,9 +10,9 @@
  */
 
 import { StringEnum } from "@mariozechner/pi-ai";
-import type { ExtensionAPI, ExtensionContext, Theme } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, Theme } from "@mariozechner/pi-coding-agent";
 import { matchesKey, Text, truncateToWidth } from "@mariozechner/pi-tui";
-import { Type } from "typebox";
+	import { Type, type Static } from "typebox";
 
 // ── 数据模型 ─────────────────────────────────────────
 
@@ -603,22 +603,22 @@ export default function (pi: ExtensionAPI) {
 		}
 	};
 
-	pi.on("session_start", async (_event, ctx) => {
+	pi.on("session_start", async (_event: any, ctx: ExtensionContext) => {
 		reconstructState(ctx);
 		refreshDisplay(ctx);
 	});
-	pi.on("session_tree", async (_event, ctx) => {
+	pi.on("session_tree", async (_event: any, ctx: ExtensionContext) => {
 		reconstructState(ctx);
 		refreshDisplay(ctx);
 	});
 
 	// v3: 追踪用户消息轮数
-	pi.on("agent_start", async (_event, _ctx) => {
+	pi.on("agent_start", async (_event: any, _ctx: ExtensionContext) => {
 		userMessageCount++;
 	});
 
 	// v3: 自动清空与提醒检查
-	pi.on("before_agent_start", async (_event, ctx) => {
+	pi.on("before_agent_start", async (_event: any, ctx: ExtensionContext) => {
 		try {
 			// 1. 自动清空：全部完成后经过 2 轮用户消息
 			if (allCompletedAtCount !== null && userMessageCount - allCompletedAtCount >= AUTO_CLEAR_DELAY_ROUNDS) {
@@ -700,8 +700,8 @@ export default function (pi: ExtensionAPI) {
 		],
 		parameters: TodoParams,
 
-		async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
-			const result = await executeTodoAction(params, ctx);
+		async execute(_toolCallId: string, params: Static<typeof TodoParams>, _signal: AbortSignal | undefined, _onUpdate: any, ctx: ExtensionContext) {
+			const result = await executeTodoAction(params as any, ctx);
 			// Append input params to error results for debugging
 			const details = result.details as { error?: string } | undefined;
 			if (details?.error) {
@@ -714,7 +714,7 @@ export default function (pi: ExtensionAPI) {
 			return result;
 		},
 
-		renderCall(args, theme, _context) {
+		renderCall(args: any, theme: Theme, _context?: any) {
 			let text = theme.fg("toolTitle", theme.bold("todo ")) + theme.fg("muted", args.action);
 			if (args.texts && args.texts.length > 0) text += ` ${theme.fg("dim", `(${args.texts.length} items)`)}`;
 			if (args.ids && args.ids.length > 0) text += ` ${theme.fg("accent", `#${args.ids.join(", #")}`)}`;
@@ -724,20 +724,20 @@ export default function (pi: ExtensionAPI) {
 			return new Text(text, 0, 0);
 		},
 
-		renderResult(result, options, theme, _context) {
+		renderResult(result: any, options: any, theme: Theme, _context?: any) {
 			return renderTodoResult(result, options, theme);
 		},
 	});
 
 	pi.registerCommand("todos", {
 		description: "\u67e5\u770b\u5f53\u524d\u5206\u652f\u7684\u6240\u6709 todo",
-		handler: async (_args, ctx) => {
+		handler: async (_args: string | undefined, ctx: ExtensionCommandContext) => {
 			if (!ctx.hasUI) {
 				ctx.ui.notify("/todos \u9700\u8981\u4ea4\u4e92\u6a21\u5f0f", "error");
 				return;
 			}
 
-			await ctx.ui.custom<void>((_tui, theme, _kb, done) => {
+			await ctx.ui.custom((_tui: any, theme: Theme, _kb: any, done: () => void) => {
 				return new TodoListComponent(todos, theme, () => done());
 			});
 		},