@ian-pascoe/pi-todo 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ian-pascoe/pi-todo",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "private": false,
   "description": "Minimal session-native Todo List for Pi agents.",
   "keywords": [

package/skills/pi-todo/SKILL.md

@@ -2,6 +2,7 @@
 name: pi-todo
 description: Diagnose Pi Todo when its tool, restored Todo List, model context, clear command, transcript rendering, or widget is missing or incorrect.
 license: MIT
+disable-model-invocation: true
 ---
 
 # Pi Todo

package/src/pi-todo-extension.ts

@@ -13,8 +13,10 @@ import {
   type TodoStateSnapshot,
   type TodoStatus,
   type TodoTask,
+  TodoOperationError,
   type TodoToolDetails,
 } from "./todo-list.js";
+import { TROUBLESHOOTING_HINT } from "./troubleshooting-skill.js";
 
 const TODO_STATE_ENTRY_TYPE = "pi-todo-state";
 const JOURNAL_FAULT = Symbol.for("@ian-pascoe/pi-todo/journal-fault");
@@ -161,7 +163,15 @@ export default function piTodoExtension(pi: ExtensionAPI): void {
     executionMode: "sequential",
     async execute(_toolCallId, params, signal, _onUpdate, context) {
       signal?.throwIfAborted();
-      const result = runTodoAction(params, context);
+      let result: ReturnType<typeof runTodoAction>;
+      try {
+        result = runTodoAction(params, context);
+      } catch (cause) {
+        // Task-operation errors are model-fixable input errors; anything else is a journal failure.
+        if (cause instanceof TodoOperationError) throw cause;
+        const message = cause instanceof Error ? cause.message : String(cause);
+        throw new Error(`${message}\n\n${TROUBLESHOOTING_HINT}`, { cause });
+      }
       return {
         content: [{ type: "text", text: result.message }],
         details: result.details,

package/src/troubleshooting-skill.ts

@@ -0,0 +1,9 @@
+import { fileURLToPath } from "node:url";
+
+/** Absolute path of this package's user-invoked troubleshooting Skill. */
+export const TROUBLESHOOTING_SKILL_PATH = fileURLToPath(
+  new URL("../skills/pi-todo/SKILL.md", import.meta.url),
+);
+
+/** Model-facing pointer appended to failures this package's Skill diagnoses. */
+export const TROUBLESHOOTING_HINT = `For diagnosis, read the pi-todo troubleshooting Skill at ${TROUBLESHOOTING_SKILL_PATH}.`;