toolcraft 0.0.20 → 0.0.21

package/README.md

@@ -59,12 +59,12 @@ export const greet = defineCommand({
   description: "Say hello",
   params: S.Object({
     name: S.String({ description: "Who to greet" }),
-    loud: S.Optional(S.Boolean({ default: false })),
+    loud: S.Optional(S.Boolean({ default: false }))
   }),
   handler: async ({ params }) => {
     const message = `Hello, ${params.name}`;
     return { message: params.loud ? message.toUpperCase() : message };
-  },
+  }
 });
 ```
 
@@ -75,7 +75,7 @@ import { greet } from "./commands/greet.js";
 
 export const root = defineGroup({
   name: "mytool",
-  children: [greet],
+  children: [greet]
 });
 ```
 
@@ -178,6 +178,8 @@ The same `root` flows into all three. No duplication.
 
 **Tree**: the `root` group is a `defineGroup` whose children are commands and sub-groups. Any depth. CLI flags, MCP tool names, and SDK methods are derived from the path.
 
+**CLI help**: group help lists visible child commands with their parameter tokens inline. Required options appear as `--name <type>`, optional options and defaults appear in brackets like `[--limit <number>]`, and positional parameters render as positional tokens like `<name>` or `[name]` depending on whether they are required. Command-specific `--help` still shows the detailed parameter table.
+
 ## Secrets
 
 Declare env-backed secrets on a command or group. Toolcraft reads `process.env` at command-run time and passes the values to the handler:
@@ -188,12 +190,12 @@ const deploy = defineCommand({
   params: S.Object({ service: S.String() }),
   secrets: {
     apiKey: { env: "DEPLOY_API_KEY", description: "Required for /deploy endpoint" },
-    debugToken: { env: "DEPLOY_DEBUG", optional: true },
+    debugToken: { env: "DEPLOY_DEBUG", optional: true }
   },
   handler: async ({ params, secrets }) => {
     // secrets.apiKey: string
     // secrets.debugToken: string | undefined
-  },
+  }
 });
 ```
 
@@ -205,13 +207,14 @@ Required secrets that aren't set produce a `UserError` with the env var name and
 defineCommand({
   // ...
   requires: {
-    auth: true,                    // fails if POE_API_KEY (or runner-specified env) is missing
-    apiVersion: ">=1.2.0",         // fails if runner reports older apiVersion
-    check: async (ctx) => ({       // arbitrary async gate
+    auth: true, // fails if POE_API_KEY (or runner-specified env) is missing
+    apiVersion: ">=1.2.0", // fails if runner reports older apiVersion
+    check: async (ctx) => ({
+      // arbitrary async gate
       ok: ctx.fs.exists(".lock") === false,
-      message: ".lock present, refusing to run",
-    }),
-  },
+      message: ".lock present, refusing to run"
+    })
+  }
 });
 ```
 
@@ -239,7 +242,7 @@ defineCommand<Services>({
   handler: async ({ params, db, logger }) => {
     logger.info("running");
     return db.query(params.id);
-  },
+  }
 });
 ```
 
@@ -257,8 +260,8 @@ defineCommand({
     rich: (result, { renderTable }) =>
       console.log(renderTable({ rows: result.rows, columns: ["id"] })),
     markdown: (result) => `Found ${result.rows.length} rows`,
-    json: (result) => result,
-  },
+    json: (result) => result
+  }
 });
 ```
 
@@ -273,13 +276,13 @@ defineGroup({
   name: "github",
   mcp: {
     transport: "stdio",
-    command: "github-mcp-server",
+    command: "github-mcp-server"
   },
   tools: ["create_issue", "list_issues"],
   rename: {
-    create_issue: "issues.create",
+    create_issue: "issues.create"
   },
-  children: [],
+  children: []
 });
 ```
 
@@ -301,21 +304,21 @@ defineGroup({
   name: "deploy",
   humanInLoop: {
     mode: "async",
-    message: ({ commandPath, params }) => `Run ${commandPath} for ${params.target}?`,
+    message: ({ commandPath, params }) => `Run ${commandPath} for ${params.target}?`
   },
   children: [
     defineCommand({
       name: "prod",
       params: S.Object({ target: S.String() }),
-      handler: async ({ params }) => ({ target: params.target }),
+      handler: async ({ params }) => ({ target: params.target })
     }),
     defineCommand({
       name: "preview",
       params: S.Object({ target: S.String() }),
-      humanInLoop: null,                    // opt out
-      handler: async ({ params }) => ({ target: params.target }),
-    }),
-  ],
+      humanInLoop: null, // opt out
+      handler: async ({ params }) => ({ target: params.target })
+    })
+  ]
 });
 ```
 
@@ -329,7 +332,7 @@ Wire the same `humanInLoop` options into every entrypoint:
 ```ts
 const humanInLoop = {
   provider: slackApprovalProvider({ channel: "#deploys", client }),
-  taskList: { dir: ".toolcraft/approvals.yaml", format: "yaml-file" as const },
+  taskList: { dir: ".toolcraft/approvals.yaml", format: "yaml-file" as const }
 };
 
 await runCLI(root, { humanInLoop });
@@ -354,7 +357,11 @@ Async results must be JSON-serializable; non-serializable returns mark the appro
 A minimal Slack-style provider:
 
 ```ts
-import type { ApprovalRequest, ApprovalResult, HumanInLoopProvider } from "@poe-code/agent-human-in-loop";
+import type {
+  ApprovalRequest,
+  ApprovalResult,
+  HumanInLoopProvider
+} from "@poe-code/agent-human-in-loop";
 
 export function slackApprovalProvider(opts: {
   channel: string;
@@ -380,14 +387,18 @@ export function slackApprovalProvider(opts: {
       }
 
       return { outcome: "declined" };
-    },
+    }
   };
 }
 ```
 
 ## Errors
 
-Throw `UserError` for expected, user-facing failures. The CLI prints the message without a stack trace and sets exit code 1; MCP and SDK surface the message as the error body. Any other thrown error is treated as unexpected and shows a stack with `--debug`.
+Throw `UserError` for expected, user-facing failures. The CLI prints the message without a stack trace and sets exit code 1; MCP and SDK surface the message as the error body. Usage mistakes include a pointer to the relevant command help. Any other thrown error is treated as unexpected and shows a trimmed stack with `--debug`; use `--debug=raw` to include framework and runtime frames.
+
+HTTP-style errors with request/response context print the request, status, and a response-body snippet by default. `--verbose` or `--debug` prints headers and the full request/response bodies, with authorization headers redacted.
+
+Enable structured error reports with `errorReports: true`, `errorReports: { dir }`, or `TOOLCRAFT_ERROR_REPORTS=1`. Reports are written under `.toolcraft/errors` by default, include argv, parsed params, resolved secret presence, structured error fields, stack/cause chains, and HTTP transcripts, and redact declared secrets plus parameter names that look sensitive.
 
 ## Migrating from a folder of scripts
 
@@ -405,6 +416,7 @@ If you have an existing MCP server you want to keep running, use the MCP proxy:
 ## Environment variables
 
 - `TOOLCRAFT_MCP_REFRESH` — MCP proxy cache refresh (`unset` = use cache, `1`/`true` = refresh all, comma-separated names = refresh those).
+- `TOOLCRAFT_ERROR_REPORTS=1` — enables structured error report files for CLI, MCP, and SDK surfaces that wire `errorReports`.
 - Per-command `secrets` declarations name additional env vars. They are read at command run time and passed to the handler.
 
 ## API reference
@@ -444,19 +456,20 @@ If you have an existing MCP server you want to keep running, use the MCP proxy:
 - `presets?: boolean` — enables `--preset <path>` for loading parameter defaults from JSON files.
 - `apiVersion?: string` — for `requires.apiVersion`.
 - `humanInLoop?: HumanInLoopRuntimeOptions`
+- `errorReports?: boolean | { dir?: string }`
 - `projectRoot?: string` — root used for MCP proxy cache files (`.toolcraft/mcp/*.json`).
 
 ### `createSDK(root, options)`
 
 - `casing?: "camel"` — generated SDK member style.
-- `services?` / `humanInLoop?` / `apiVersion?`
+- `services?` / `humanInLoop?` / `apiVersion?` / `errorReports?`
 - `projectRoot?: string` — root used for MCP proxy cache files (`.toolcraft/mcp/*.json`).
 
 ### `createMCPServer(root, options)` / `runMCP(root, options)`
 
 - `name: string`
 - `version: string`
-- `services?` / `humanInLoop?` / `apiVersion?`
+- `services?` / `humanInLoop?` / `apiVersion?` / `errorReports?`
 - `projectRoot?: string` — root used for MCP proxy cache files (`.toolcraft/mcp/*.json`).
 - `tools?: string[]` — allowlist of MCP tool names or group prefixes. Tool names are `__`-joined snake_case path segments (`root__bot__create`); a prefix like `root__bot` includes every descendant tool.
 - `omitRootToolNamePrefix?: boolean` — defaults to `false`. Set to `true` to omit the root group name from single-root MCP tool names (`bot__create`).
@@ -468,7 +481,7 @@ If you have an existing MCP server you want to keep running, use the MCP proxy:
 type HumanInLoopRuntimeOptions = {
   provider?: HumanInLoopProvider;
   taskList?: TaskList | { dir: string; format: "markdown-dir" | "yaml-file" };
-  listName?: string;       // defaults to "approvals"
+  listName?: string; // defaults to "approvals"
   binPath?: { execPath: string; entryArgs: readonly string[] };
 };
 ```

package/dist/sdk.d.ts

@@ -64,6 +64,7 @@ export interface CreateSDKOptions<TServices extends object = Record<string, unkn
     services?: TServices;
     casing?: "camel";
     humanInLoop?: HumanInLoopRuntimeOptions;
+    apiVersion?: string;
     projectRoot?: string;
     errorReports?: ErrorReportsOption;
 }
@@ -72,4 +73,5 @@ export declare function createSDK<TRootInfo, TServices extends object = Record<s
 }, options?: CreateSDKOptions<TServices>): TRootInfo extends {
     children: infer TChildren extends readonly unknown[];
 } ? SDKChildrenShape<TChildren, undefined, undefined> : EmptyRecord;
+export declare function createSDK<TServices extends object = Record<string, unknown>>(root: Group<TServices>, options?: CreateSDKOptions<TServices>): Record<string, unknown>;
 export {};

package/dist/sdk.js

@@ -269,7 +269,9 @@ function createResolvedSDK(root, options = {}) {
                             return undefined;
                         }
                     };
-                    await assertCommandRequirements(node, { ...baseContext, params: undefined });
+                    await assertCommandRequirements(node, { ...baseContext, params: undefined }, {
+                        apiVersion: options.apiVersion
+                    });
                     const paramsSchema = filterSchemaForScope(node.params, "sdk");
                     if (paramsSchema === undefined || paramsSchema.kind !== "object") {
                         throw new ToolcraftBugError(`command "${node.name}" must define an object params schema for SDK.`);

package/node_modules/@poe-code/agent-defs/dist/agents/claude-code.js

@@ -5,6 +5,7 @@ export const claudeCodeAgent = {
     summary: "Configure Claude Code to route through Poe.",
     aliases: ["claude"],
     binaryName: "claude",
+    apiShapes: ["anthropic-messages"],
     configPath: "~/.claude/settings.json",
     branding: {
         colors: {

package/node_modules/@poe-code/agent-defs/dist/agents/codex.js

@@ -4,6 +4,7 @@ export const codexAgent = {
     label: "Codex",
     summary: "Configure Codex to use Poe as the model provider.",
     binaryName: "codex",
+    apiShapes: ["openai-responses"],
     configPath: "~/.codex/config.toml",
     branding: {
         colors: {

package/node_modules/@poe-code/agent-defs/dist/agents/gemini-cli.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from "../types.js";
+export declare const geminiCliAgent: AgentDefinition;

package/node_modules/@poe-code/agent-defs/dist/agents/gemini-cli.js

@@ -0,0 +1,16 @@
+export const geminiCliAgent = {
+    id: "gemini-cli",
+    name: "gemini-cli",
+    aliases: ["gemini"],
+    label: "Gemini CLI",
+    summary: "Configure Google's Gemini CLI to use a compatible Google generations API.",
+    binaryName: "gemini",
+    configPath: "~/.gemini/settings.json",
+    apiShapes: ["google-generations"],
+    branding: {
+        colors: {
+            dark: "#8AB4F8",
+            light: "#1A73E8"
+        }
+    }
+};

package/node_modules/@poe-code/agent-defs/dist/agents/goose.js

@@ -4,6 +4,7 @@ export const gooseAgent = {
     label: "Goose",
     summary: "Block's open-source AI agent with ACP support.",
     binaryName: "goose",
+    apiShapes: ["openai-chat-completions"],
     configPath: "~/.config/goose/config.yaml",
     branding: {
         colors: {

package/node_modules/@poe-code/agent-defs/dist/agents/index.d.ts

@@ -1,6 +1,7 @@
 export { claudeCodeAgent } from "./claude-code.js";
 export { claudeDesktopAgent } from "./claude-desktop.js";
 export { codexAgent } from "./codex.js";
+export { geminiCliAgent } from "./gemini-cli.js";
 export { openCodeAgent } from "./opencode.js";
 export { kimiAgent } from "./kimi.js";
 export { gooseAgent } from "./goose.js";

package/node_modules/@poe-code/agent-defs/dist/agents/index.js

@@ -1,6 +1,7 @@
 export { claudeCodeAgent } from "./claude-code.js";
 export { claudeDesktopAgent } from "./claude-desktop.js";
 export { codexAgent } from "./codex.js";
+export { geminiCliAgent } from "./gemini-cli.js";
 export { openCodeAgent } from "./opencode.js";
 export { kimiAgent } from "./kimi.js";
 export { gooseAgent } from "./goose.js";

package/node_modules/@poe-code/agent-defs/dist/agents/kimi.js

@@ -5,6 +5,7 @@ export const kimiAgent = {
     summary: "Configure Kimi CLI to use Poe API",
     aliases: ["kimi-cli"],
     binaryName: "kimi",
+    apiShapes: ["openai-chat-completions"],
     configPath: "~/.kimi/config.toml",
     branding: {
         colors: {

package/node_modules/@poe-code/agent-defs/dist/agents/opencode.js

@@ -4,6 +4,7 @@ export const openCodeAgent = {
     label: "OpenCode CLI",
     summary: "Configure OpenCode CLI to use the Poe API.",
     binaryName: "opencode",
+    apiShapes: ["openai-chat-completions"],
     configPath: "~/.config/opencode/config.json",
     branding: {
         colors: {

package/node_modules/@poe-code/agent-defs/dist/agents/poe-agent.js

@@ -3,6 +3,7 @@ export const poeAgentAgent = {
     name: "poe-agent",
     label: "Poe Agent",
     summary: "Run one-shot prompts with the built-in Poe agent runtime.",
+    apiShapes: ["openai-responses", "openai-chat-completions"],
     configPath: "~/.poe-code/config.json",
     branding: {
         colors: {

package/node_modules/@poe-code/agent-defs/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { AgentDefinition } from "./types.js";
+export type { AgentDefinition, ApiShapeId } from "./types.js";
 export type { AgentSpecifier } from "./specifier.js";
-export { claudeCodeAgent, claudeDesktopAgent, codexAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
+export { claudeCodeAgent, claudeDesktopAgent, codexAgent, geminiCliAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
 export { allAgents, resolveAgentId } from "./registry.js";
 export { parseAgentSpecifier, formatAgentSpecifier, normalizeAgentId } from "./specifier.js";

package/node_modules/@poe-code/agent-defs/dist/index.js

@@ -1,3 +1,3 @@
-export { claudeCodeAgent, claudeDesktopAgent, codexAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
+export { claudeCodeAgent, claudeDesktopAgent, codexAgent, geminiCliAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
 export { allAgents, resolveAgentId } from "./registry.js";
 export { parseAgentSpecifier, formatAgentSpecifier, normalizeAgentId } from "./specifier.js";

package/node_modules/@poe-code/agent-defs/dist/registry.js

@@ -1,8 +1,9 @@
-import { claudeCodeAgent, claudeDesktopAgent, codexAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
+import { claudeCodeAgent, claudeDesktopAgent, codexAgent, geminiCliAgent, openCodeAgent, kimiAgent, gooseAgent, poeAgentAgent } from "./agents/index.js";
 export const allAgents = [
     claudeCodeAgent,
     claudeDesktopAgent,
     codexAgent,
+    geminiCliAgent,
     openCodeAgent,
     kimiAgent,
     gooseAgent,

package/node_modules/@poe-code/agent-defs/dist/types.d.ts

@@ -1,3 +1,4 @@
+export type ApiShapeId = "openai-chat-completions" | "openai-responses" | "anthropic-messages" | "google-generations";
 export interface AgentDefinition {
     id: string;
     name: string;
@@ -6,6 +7,7 @@ export interface AgentDefinition {
     aliases?: string[];
     /** Binary name for CLI agents. Optional for GUI-only apps like Claude Desktop. */
     binaryName?: string;
+    readonly apiShapes?: readonly ApiShapeId[];
     configPath: string;
     branding: {
         colors: {

package/node_modules/@poe-code/design-system/dist/components/browser.d.ts

@@ -0,0 +1,15 @@
+interface BrowserProcess {
+    once(event: "error", listener: (error: Error) => void): this;
+    once(event: "spawn", listener: () => void): this;
+    unref(): void;
+}
+type SpawnBrowserProcess = (command: string, args: string[], options: {
+    detached: true;
+    stdio: "ignore";
+}) => BrowserProcess;
+export interface OpenExternalOptions {
+    platform?: NodeJS.Platform;
+    spawnProcess?: SpawnBrowserProcess;
+}
+export declare function openExternal(url: string, options?: OpenExternalOptions): Promise<void>;
+export {};

package/node_modules/@poe-code/design-system/dist/components/browser.js

@@ -0,0 +1,26 @@
+import { spawn } from "node:child_process";
+import process from "node:process";
+export async function openExternal(url, options = {}) {
+    const parsed = new URL(url);
+    const { command, args } = browserCommand(parsed.href, options.platform ?? process.platform);
+    await launchBrowser(command, args, options.spawnProcess ?? spawn);
+}
+function browserCommand(url, platform) {
+    if (platform === "darwin") {
+        return { command: "open", args: [url] };
+    }
+    if (platform === "win32") {
+        return { command: "cmd", args: ["/c", "start", "", url] };
+    }
+    return { command: "xdg-open", args: [url] };
+}
+function launchBrowser(command, args, spawnProcess) {
+    return new Promise((resolve, reject) => {
+        const child = spawnProcess(command, args, { detached: true, stdio: "ignore" });
+        child.once("error", reject);
+        child.once("spawn", () => {
+            child.unref();
+            resolve();
+        });
+    });
+}

package/node_modules/@poe-code/design-system/dist/explorer/index.d.ts

@@ -4,5 +4,5 @@ export { createInitialState } from "./state.js";
 export { resolveBindings } from "./keymap.js";
 export type { Effect, ExplorerEvent } from "./events.js";
 export type { BindingTarget, ExplorerBindingDefaults, ExplorerBuiltinCommand, ResolvedBindings } from "./keymap.js";
-export type { Action, ActionContext, Detail, DetailCtx, DetailItem, Dirty, ExplorerConfig, ExplorerLayoutMode, ExplorerSize, ExplorerState, Row, Tone } from "./state.js";
+export type { Action, ActionContext, Detail, DetailCtx, DetailItem, Dirty, ExplorerConfig, ExplorerLayoutMode, ExplorerSize, ExplorerState, ReorderContext, Row, Tone } from "./state.js";
 export declare function singleDetail<R>(fn: (row: Row, ctx: DetailCtx) => string | Promise<string>): Detail<R>;

package/node_modules/@poe-code/design-system/dist/explorer/keymap.js

@@ -19,8 +19,8 @@ const builtinBindings = {
     detailScrollUp: ["Ctrl+b"],
     extendSelectionUp: ["Shift+up"],
     extendSelectionDown: ["Shift+down"],
-    reorderUp: ["Ctrl+up", "K"],
-    reorderDown: ["Ctrl+down", "J"]
+    reorderUp: ["Shift+up", "K"],
+    reorderDown: ["Shift+down", "J"]
 };
 const baseBuiltinCommands = [
     "quit",
@@ -49,7 +49,10 @@ const reservedActionIds = new Set(["quit"]);
 export function resolveBindings(config, defaults = {}) {
     const commands = config.reorder === undefined
         ? baseBuiltinCommands
-        : [...baseBuiltinCommands, ...reorderCommands];
+        : [
+            ...baseBuiltinCommands.filter((command) => command !== "extendSelectionUp" && command !== "extendSelectionDown"),
+            ...reorderCommands
+        ];
     const commandBindings = new Map();
     const flatBindings = new Map();
     const targetKeys = new Map();

package/node_modules/@poe-code/design-system/dist/explorer/render/footer.js

@@ -13,6 +13,12 @@ export function renderFooter(state, screen, layout) {
         if (x >= rect.x + rect.width) {
             break;
         }
+        if (hint.bracketed === false) {
+            const text = `${hint.key} ${hint.label}`;
+            screen.put(x, y, text, hint.running ? styles.muted : {});
+            x += text.length + 2;
+            continue;
+        }
         screen.put(x, y, `[${hint.key}]`, hint.running ? styles.muted : styles.accent);
         x += hint.key.length + 2;
         screen.put(x, y, ` ${hint.label}`, hint.running ? styles.muted : {});
@@ -37,9 +43,17 @@ function footerHints(state) {
     }
     hints.push({ key: "?", label: "help", running: false });
     hints.push({ key: "Ctrl+P", label: "palette", running: false });
+    if (hasShiftReorderBindings(state)) {
+        hints.push({ key: "⇧↑↓", label: "reorder (within state)", running: false, bracketed: false });
+    }
     hints.push({ key: "q", label: "quit", running: false });
     return hints;
 }
+function hasShiftReorderBindings(state) {
+    const up = state.bindings.keysByTarget.get("builtin:reorderUp") ?? [];
+    const down = state.bindings.keysByTarget.get("builtin:reorderDown") ?? [];
+    return up.includes("Shift+up") && down.includes("Shift+down");
+}
 function actionKey(entry, fallback) {
     const key = entry.action?.key;
     if (Array.isArray(key)) {

package/node_modules/@poe-code/design-system/dist/explorer/runtime.js

@@ -36,7 +36,7 @@ class ExplorerRuntime {
         });
         this.runtimeHandles = {
             refresh: async () => {
-                await this.refreshRows();
+                await this.refreshRowsFromSource();
             },
             suspendAnd: async (fn) => this.suspendAnd(fn),
             toast: (msg, tone) => {
@@ -54,7 +54,7 @@ class ExplorerRuntime {
             try {
                 this.startTerminal();
                 this.render();
-                this.refreshRows().catch((error) => {
+                this.loadRows().catch((error) => {
                     this.fail(error);
                 });
             }
@@ -76,10 +76,14 @@ class ExplorerRuntime {
             this.dispatch({ type: "resize", cols: size.cols, rows: size.rows });
         });
     }
-    async refreshRows() {
+    async loadRows() {
         const rows = await this.config.rows();
         this.dispatch({ type: "rowsLoaded", rows });
     }
+    async refreshRowsFromSource() {
+        await this.config.refresh?.();
+        await this.loadRows();
+    }
     dispatch(event) {
         if (this.stopped) {
             return;
@@ -128,7 +132,10 @@ class ExplorerRuntime {
     }
     async persistOrder(orderedIds, previousRows) {
         try {
-            await this.config.reorder?.onReorder(orderedIds);
+            await this.config.reorder?.onReorder(orderedIds, {
+                refresh: this.runtimeHandles.refresh,
+                toast: this.runtimeHandles.toast
+            });
         }
         catch (error) {
             this.showToast(error instanceof Error ? error.message : "Could not persist order", "error");

package/node_modules/@poe-code/design-system/dist/explorer/state.d.ts

@@ -51,13 +51,18 @@ export interface ActionContext<R> {
     confirm: (prompt: string) => Promise<boolean>;
     exit: (after?: () => void | Promise<void>) => void;
 }
+export interface ReorderContext {
+    refresh: () => Promise<void>;
+    toast: (msg: string, tone?: Tone) => void;
+}
 export interface ExplorerConfig<R> {
     title: string;
     rows: () => Promise<Row[]>;
+    refresh?: () => Promise<void>;
     detail: Detail<R>;
     actions: Action<R>[];
     reorder?: {
-        onReorder: (orderedIds: string[]) => void | Promise<void>;
+        onReorder: (orderedIds: string[], ctx?: ReorderContext) => void | Promise<void>;
     };
     multiSelect?: boolean;
     keybindOverrides?: Record<string, string | string[]>;

package/node_modules/@poe-code/design-system/dist/index.d.ts

@@ -19,13 +19,14 @@ export { renderTable } from "./components/table.js";
 export type { TableColumn, RenderTableOptions } from "./components/table.js";
 export { renderTemplate } from "./components/template.js";
 export type { RenderTemplateOptions, TemplateEscape } from "./components/template.js";
+export { openExternal } from "./components/browser.js";
 export * as acp from "./acp/index.js";
 export * as dashboard from "./dashboard/index.js";
 export { createDashboard, shouldUseInteractiveDashboard } from "./dashboard/index.js";
 export type { Dashboard, DashboardOptions } from "./dashboard/index.js";
 export * as explorer from "./explorer/index.js";
 export { runExplorer, singleDetail } from "./explorer/index.js";
-export type { Row, DetailItem, Detail, DetailCtx, Action, ActionContext, ExplorerConfig, Tone, } from "./explorer/index.js";
+export type { Row, DetailItem, Detail, DetailCtx, Action, ActionContext, ExplorerConfig, ReorderContext, Tone, } from "./explorer/index.js";
 export * as prompts from "./prompts/index.js";
 export { intro, introPlain, outro, note, select, multiselect, text as promptText, confirm, confirmOrCancel, password, spinner, withSpinner, isCancel, cancel, log, PromptCancelledError } from "./prompts/index.js";
 export type { SelectOptions, MultiselectOptions, TextOptions, ConfirmOptions, PasswordOptions, SpinnerOptions, WithSpinnerOptions } from "./prompts/index.js";

package/node_modules/@poe-code/design-system/dist/index.js

@@ -15,6 +15,7 @@ export { formatCommandNotFound } from "./components/command-errors.js";
 export { formatCommandNotFoundPanel } from "./components/command-errors.js";
 export { renderTable } from "./components/table.js";
 export { renderTemplate } from "./components/template.js";
+export { openExternal } from "./components/browser.js";
 // ACP rendering
 export * as acp from "./acp/index.js";
 // Dashboard

package/node_modules/@poe-code/task-list/README.md

@@ -6,11 +6,11 @@ Multi-list task manager with pluggable storage backends.
 
 `@poe-code/task-list` exposes one API over these backends:
 
-| Backend | Storage |
-| --- | --- |
-| `markdown-dir` | One Markdown file per task, organized into subdirectories per list. |
-| `yaml-file` | One YAML document with a top-level `lists:` mapping. |
-| `gh-issues` | GitHub Issues in one repository, ordered and state-tracked through a GitHub Project v2 Status field. |
+| Backend        | Storage                                                                                              |
+| -------------- | ---------------------------------------------------------------------------------------------------- |
+| `markdown-dir` | One Markdown file per task, organized into subdirectories per list.                                  |
+| `yaml-file`    | One YAML document with a top-level `lists:` mapping.                                                 |
+| `gh-issues`    | GitHub Issues in one repository, ordered and state-tracked through a GitHub Project v2 Status field. |
 
 The task lifecycle is `draft -> planned -> in-progress -> done -> archived`. `archived` is terminal.
 
@@ -18,13 +18,13 @@ The task lifecycle is `draft -> planned -> in-progress -> done -> archived`. `ar
 
 - `openTaskList(options)`: opens a task store and returns a `TaskList`
 - `TaskList`: top-level interface for listing lists, querying all tasks, and resolving qualified IDs
-- `Tasks`: per-list interface for create, update, `fire`, `canFire`, `events`, delete, and list operations
+- `Tasks`: per-list interface for create, update, `fire`, `canFire`, `events`, delete, `move`, `reorder`, and list operations
 - `Task`: normalized task record with `list`, `id`, `qualifiedId`, `name`, `state`, `description`, and `metadata`
 - `TaskState`: `"draft" | "planned" | "in-progress" | "done" | "archived"`
 - `TaskDefaults`: default `metadata` applied when creating new tasks
 - `StateMachineDef` / `EventDef`: exported types for custom task lifecycle definitions passed via `openTaskList({ stateMachine })`
 - `defaultStateMachine`: exported default lifecycle with `plan`, `start`, `complete`, and `archive` events
-- Error classes: `TaskNotFoundError`, `TaskAlreadyExistsError`, `InvalidTransitionError`, `MalformedTaskError`
+- Error classes: `TaskNotFoundError`, `TaskAlreadyExistsError`, `InvalidTransitionError`, `MalformedTaskError`, `OrderMismatchError`, `AnchorNotFoundError`
 
 ## State Machines
 
@@ -48,21 +48,23 @@ Pass a custom machine with `openTaskList({ stateMachine })`. If omitted, the pac
 
 ## Options
 
-| Option | Type | Default | Behavior |
-| --- | --- | --- | --- |
-| `type` | `"markdown-dir" \| "yaml-file" \| "gh-issues"` | required | Selects the backend implementation. |
-| `path` | `string` | required | Root directory for `markdown-dir` or YAML file path for `yaml-file`. |
-| `defaults` | `TaskDefaults` | `{ metadata: {} }` | Seeds omitted metadata on new tasks only. New tasks always start at the configured state machine's initial state. |
-| `create` | `boolean` | `false` | Creates missing storage for the selected backend when enabled. |
-| `lockStaleMs` | `number` | `30_000` | Stale threshold passed to backend file locking. |
-| `lockRetries` | `number` | `20` | Retry count passed to backend file locking. |
-| `fs` | `TaskListFs` | `node:fs/promises` adapter | Injectable filesystem, primarily for tests. |
-| `stateMachine` | `StateMachineDef` | `defaultStateMachine` | Overrides the task lifecycle used by `create`, `fire`, `canFire`, and `events`. |
+| Option            | Type                                           | Default                    | Behavior                                                                                                          |
+| ----------------- | ---------------------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `type`            | `"markdown-dir" \| "yaml-file" \| "gh-issues"` | required                   | Selects the backend implementation.                                                                               |
+| `path`            | `string`                                       | required                   | Root directory for `markdown-dir` or YAML file path for `yaml-file`.                                              |
+| `defaults`        | `TaskDefaults`                                 | `{ metadata: {} }`         | Seeds omitted metadata on new tasks only. New tasks always start at the configured state machine's initial state. |
+| `create`          | `boolean`                                      | `false`                    | Creates missing storage for the selected backend when enabled.                                                    |
+| `singleList`      | `string`                                       | unset                      | `markdown-dir` only. Treats `path` as one list with this name instead of one subdirectory per list.               |
+| `frontmatterMode` | `"strict" \| "passthrough"`                    | `"strict"`                 | `markdown-dir` only. `passthrough` preserves non-task frontmatter and allows files without a frontmatter block.   |
+| `lockStaleMs`     | `number`                                       | `30_000`                   | Stale threshold passed to backend file locking.                                                                   |
+| `lockRetries`     | `number`                                       | `20`                       | Retry count passed to backend file locking.                                                                       |
+| `fs`              | `TaskListFs`                                   | `node:fs/promises` adapter | Injectable filesystem, primarily for tests.                                                                       |
+| `stateMachine`    | `StateMachineDef`                              | `defaultStateMachine`      | Overrides the task lifecycle used by `create`, `fire`, `canFire`, and `events`.                                   |
 
 ## Env vars
 
-| Env var | Behavior |
-| --- | --- |
+| Env var   | Behavior                                                        |
+| --------- | --------------------------------------------------------------- |
 | `GH_HOST` | Defers to gh CLI's host configuration; set GH_HOST to override. |
 
 ## Usage
@@ -88,6 +90,21 @@ await planning.create({
 await planning.fire("ship-readme", "plan");
 ```
 
+By default, `markdown-dir` stores tasks as `<path>/<list>/<nn-id>.md`. Set `singleList` to treat the root directory as one list, which is how plan folders such as `docs/plans` are exposed through the task API:
+
+```ts
+const plans = await openTaskList({
+  type: "markdown-dir",
+  path: "/repo/docs/plans",
+  singleList: "plans",
+  frontmatterMode: "passthrough"
+});
+
+await plans.list("plans").reorder(["api-shape-providers", "memory"]);
+```
+
+`frontmatterMode: "strict"` expects full task frontmatter (`kind`, `version`, `name`, `state`, and related task fields). `frontmatterMode: "passthrough"` keeps unrelated frontmatter keys as task metadata and writes back only the task-owned fields (`name`, `description`, `state`), so existing plan metadata is preserved.
+
 ### `yaml-file`
 
 ```ts
@@ -225,14 +242,14 @@ poe-code tasks sync <list> --workflow ./WORKFLOW.md --repo octo-org/octo-repo --
 
 `<list>` and `--project` both use `<owner>/<number>` project syntax. `--workflow` defaults to `./WORKFLOW.md`. `--repo` overrides the task repository from workflow frontmatter. `--states` overrides the required state list from workflow frontmatter. `--json` prints the report object as JSON. `--yes` confirms non-interactive sync; it is only used by `poe-code tasks sync`.
 
-| Option | Commands | Behavior |
-| --- | --- | --- |
-| `--workflow <path>` | `verify`, `sync` | Workflow file path. Defaults to `./WORKFLOW.md`. |
-| `--repo <owner/name>` | `verify`, `sync` | GitHub repository owner/name. |
+| Option                     | Commands         | Behavior                                            |
+| -------------------------- | ---------------- | --------------------------------------------------- |
+| `--workflow <path>`        | `verify`, `sync` | Workflow file path. Defaults to `./WORKFLOW.md`.    |
+| `--repo <owner/name>`      | `verify`, `sync` | GitHub repository owner/name.                       |
 | `--project <owner/number>` | `verify`, `sync` | GitHub Project v2 owner/number. Overrides `<list>`. |
-| `--states <csv>` | `verify`, `sync` | Required task state names. |
-| `--json` | `verify`, `sync` | Prints the report as JSON. |
-| `--yes` | `sync` | Confirms non-interactive provisioning. |
+| `--states <csv>`           | `verify`, `sync` | Required task state names.                          |
+| `--json`                   | `verify`, `sync` | Prints the report as JSON.                          |
+| `--yes`                    | `sync`           | Confirms non-interactive provisioning.              |
 
 The `Status` field name and option names are matched case-sensitively. The field must be named `Status`, and required option names must match exactly. For example, `status` is treated as a missing field, and `Done` is treated as missing when the required state is `done`.
 

package/node_modules/@poe-code/task-list/dist/backends/gh-issues.js

@@ -159,6 +159,15 @@ const UPDATE_ISSUE_MUTATION = `mutation UpdateIssue($input: UpdateIssueInput!) {
     }
   }
 }`;
+const ADD_COMMENT_MUTATION = `mutation AddComment($input: AddCommentInput!) {
+  addComment(input: $input) {
+    commentEdge {
+      node {
+        id
+      }
+    }
+  }
+}`;
 const UPDATE_PROJECT_ITEM_POSITION_MUTATION = `mutation UpdateProjectItemPosition($input: UpdateProjectV2ItemPositionInput!) {
   updateProjectV2ItemPosition(input: $input) {
     clientMutationId
@@ -329,6 +338,14 @@ function createTasksView(name, session, context) {
             await updateProjectItemStatus(projectItemId, event, session, context);
             return fetchIssueTask(id, name, session, context);
         },
+        async comment(id, body) {
+            await context.client.graphql(ADD_COMMENT_MUTATION, {
+                input: {
+                    subjectId: await resolveIssueId(id, name, context),
+                    body
+                }
+            });
+        },
         async canFire(id, event) {
             return findEvent(session.stateMachine, id, event) !== undefined;
         },
@@ -587,7 +604,7 @@ function mapIssueToTask(options) {
     return {
         list: options.listName,
         id,
-        qualifiedId: `${options.listName}/${id}`,
+        qualifiedId: `${options.listName}#${id}`,
         name: options.issue.title,
         description: options.issue.body ?? "",
         state: options.statusName ?? options.initialState,
@@ -639,7 +656,7 @@ function singleListError(listName) {
     return new Error(`gh-issues backend has a single list ${listName}`);
 }
 function parseQualifiedId(qualifiedId, listName) {
-    const prefix = `${listName}/`;
+    const prefix = `${listName}#`;
     if (!qualifiedId.startsWith(prefix) || qualifiedId.length === prefix.length) {
         throw new Error(`Invalid qualified task id "${qualifiedId}".`);
     }

package/node_modules/@poe-code/task-list/dist/backends/markdown-dir.js

@@ -180,7 +180,7 @@ function metadataFromFrontmatter(frontmatter, mode) {
     }
     return metadata;
 }
-function createTask(list, id, frontmatter, body, mode) {
+function createTask(list, id, frontmatter, body, mode, sourcePath) {
     return {
         list,
         id,
@@ -188,7 +188,8 @@ function createTask(list, id, frontmatter, body, mode) {
         name: frontmatter.name,
         state: frontmatter.state,
         description: body,
-        metadata: metadataFromFrontmatter(frontmatter, mode)
+        metadata: metadataFromFrontmatter(frontmatter, mode),
+        ...(sourcePath !== undefined && { sourcePath: path.resolve(sourcePath) })
     };
 }
 function serializeTaskDocument(frontmatter, description) {
@@ -223,7 +224,7 @@ async function readTaskFile(fs, list, id, filePath, validStates, initialState, m
         return {
             path: filePath,
             frontmatter,
-            task: createTask(list, id, frontmatter, document.body, mode)
+            task: createTask(list, id, frontmatter, document.body, mode, filePath)
         };
     }
     const parsedFilename = parseActiveFilename(path.basename(filePath));
@@ -238,7 +239,7 @@ async function readTaskFile(fs, list, id, filePath, validStates, initialState, m
     return {
         path: filePath,
         frontmatter,
-        task: createTask(list, id, effectiveFrontmatter, document.body, mode)
+        task: createTask(list, id, effectiveFrontmatter, document.body, mode, filePath)
     };
 }
 async function findActiveTaskFilename(fs, listDirectoryPath, id) {
@@ -613,7 +614,7 @@ function createTasksView(deps, layout, list) {
                 const frontmatter = createdFrontmatter(deps.defaults, input, stateMachine.initial, deps.frontmatterMode);
                 const description = input.description ?? "";
                 await writeAtomically(deps.fs, targetPath, serializeTaskDocument(frontmatter, description));
-                return createTask(list, input.id, frontmatter, description, deps.frontmatterMode);
+                return createTask(list, input.id, frontmatter, description, deps.frontmatterMode, targetPath);
             });
         },
         async update(id, patch) {
@@ -623,7 +624,7 @@ function createTasksView(deps, layout, list) {
                 const nextFrontmatter = updatedFrontmatter(existing.frontmatter, existing.task, patch, deps.frontmatterMode);
                 const description = patch.description ?? existing.task.description;
                 await writeAtomically(deps.fs, existing.path, serializeTaskDocument(nextFrontmatter, description));
-                return createTask(list, id, nextFrontmatter, description, deps.frontmatterMode);
+                return createTask(list, id, nextFrontmatter, description, deps.frontmatterMode, existing.path);
             });
         },
         async fire(id, eventName, opts) {
@@ -641,7 +642,6 @@ function createTasksView(deps, layout, list) {
                 }
                 await event.onExit?.(existing.task);
                 const nextFrontmatter = firedFrontmatter(existing.frontmatter, existing.task, event.to, deps.frontmatterMode, opts?.metadataPatch);
-                const nextTask = createTask(list, id, nextFrontmatter, existing.task.description, deps.frontmatterMode);
                 const serializedTask = serializeTaskDocument(nextFrontmatter, existing.task.description);
                 if (event.to === "archived") {
                     const targetPath = archivedTaskPath(deps.path, layout, list, id);
@@ -652,10 +652,12 @@ function createTasksView(deps, layout, list) {
                     await writeAtomically(deps.fs, existing.path, serializedTask);
                     await deps.fs.mkdir(archiveDirectoryPath(deps.path, layout, list), { recursive: true });
                     await deps.fs.rename(existing.path, targetPath);
+                    const nextTask = createTask(list, id, nextFrontmatter, existing.task.description, deps.frontmatterMode, targetPath);
                     await event.onEnter?.(nextTask);
                     return nextTask;
                 }
                 await writeAtomically(deps.fs, existing.path, serializedTask);
+                const nextTask = createTask(list, id, nextFrontmatter, existing.task.description, deps.frontmatterMode, existing.path);
                 await event.onEnter?.(nextTask);
                 return nextTask;
             };
@@ -695,7 +697,7 @@ function createTasksView(deps, layout, list) {
         async move(id, anchor) {
             validateTaskId(id);
             return withListLock(async () => {
-                const { entries, tasks } = await readActiveTasks();
+                const { entries } = await readActiveTasks();
                 const fromIndex = entries.findIndex((entry) => entry.id === id);
                 if (fromIndex < 0) {
                     throw new TaskNotFoundError(`Task "${list}/${id}" not found.`);
@@ -716,7 +718,7 @@ function createTasksView(deps, layout, list) {
                 }
                 ordered.splice(insertIndex, 0, id);
                 await rewriteMovedPrefix(id, ordered);
-                return tasks.get(id).task;
+                return (await getTaskFile(id)).task;
             });
         },
         async reorder(ids) {
@@ -724,7 +726,7 @@ function createTasksView(deps, layout, list) {
                 validateTaskId(id);
             }
             return withListLock(async () => {
-                const { entries, tasks } = await readActiveTasks();
+                const { entries } = await readActiveTasks();
                 const currentIds = entries.map((entry) => entry.id);
                 const currentSet = new Set(currentIds);
                 const inputSet = new Set(ids);
@@ -734,7 +736,7 @@ function createTasksView(deps, layout, list) {
                     throw new OrderMismatchError({ missing, extra });
                 }
                 await rewriteListPrefixes(ids);
-                return ids.map((id) => tasks.get(id).task);
+                return Promise.all(ids.map(async (id) => (await getTaskFile(id)).task));
             });
         }
     };

package/node_modules/@poe-code/task-list/dist/backends/yaml-file.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 import { acquireFileLock } from "@poe-code/file-lock";
 import { isMap, parseDocument } from "yaml";
 import storeSchema from "../schema/store.schema.json" with { type: "json" };
@@ -61,7 +62,7 @@ function metadataFromTaskRecord(taskRecord) {
     }
     return metadata;
 }
-function createTask(list, id, taskRecord) {
+function createTask(list, id, taskRecord, sourcePath) {
     return {
         list,
         id,
@@ -69,7 +70,8 @@ function createTask(list, id, taskRecord) {
         name: taskRecord.name,
         state: taskRecord.state,
         description: descriptionFromTaskRecord(taskRecord),
-        metadata: metadataFromTaskRecord(taskRecord)
+        metadata: metadataFromTaskRecord(taskRecord),
+        ...(sourcePath !== undefined && { sourcePath: path.resolve(sourcePath) })
     };
 }
 function matchesFilter(task, filter) {
@@ -347,7 +349,7 @@ function createTasksView(deps, list) {
         }
         const entries = Object.entries(listRecord)
             .map(([id, taskRecord]) => ({
-            task: createTask(list, id, taskRecord),
+            task: createTask(list, id, taskRecord, deps.path),
             raw: taskRecord
         }))
             .filter(({ task }) => matchesFilter(task, filter));
@@ -374,7 +376,7 @@ function createTasksView(deps, list) {
         async get(id) {
             validateTaskId(id);
             const { store } = await readStore(deps.fs, deps.path, validStates);
-            return createTask(list, id, getTaskOrThrow(store, list, id));
+            return createTask(list, id, getTaskOrThrow(store, list, id), deps.path);
         },
         async create(input) {
             assertCreateDoesNotSetState(input);
@@ -388,7 +390,7 @@ function createTasksView(deps, list) {
                 const taskRecord = createTaskRecord(deps.defaults, input, stateMachine.initial);
                 document.setIn(["lists", list, input.id], taskRecord);
                 await writeAtomically(deps.fs, deps.path, serializeDocument(document));
-                return createTask(list, input.id, taskRecord);
+                return createTask(list, input.id, taskRecord, deps.path);
             });
         },
         async update(id, patch) {
@@ -410,7 +412,7 @@ function createTasksView(deps, list) {
                     }
                 }
                 await writeAtomically(deps.fs, deps.path, serializeDocument(document));
-                return createTask(list, id, nextTaskRecord);
+                return createTask(list, id, nextTaskRecord, deps.path);
             });
         },
         async fire(id, eventName, opts) {
@@ -418,7 +420,7 @@ function createTasksView(deps, list) {
             return withStoreLock(deps, async () => {
                 const { document, store } = await readStore(deps.fs, deps.path, validStates);
                 const existing = getTaskOrThrow(store, list, id);
-                const task = createTask(list, id, existing);
+                const task = createTask(list, id, existing, deps.path);
                 const event = assertFireableTaskEvent(task, eventName);
                 const guardResult = event.guard?.(task) ?? true;
                 if (guardResult !== true) {
@@ -438,7 +440,7 @@ function createTasksView(deps, list) {
                     }
                 }
                 await writeAtomically(deps.fs, deps.path, serializeDocument(document));
-                const nextTask = createTask(list, id, nextTaskRecord);
+                const nextTask = createTask(list, id, nextTaskRecord, deps.path);
                 await event.onEnter?.(nextTask);
                 return nextTask;
             });
@@ -446,7 +448,7 @@ function createTasksView(deps, list) {
         async canFire(id, eventName) {
             validateTaskId(id);
             const { store } = await readStore(deps.fs, deps.path, validStates);
-            const task = createTask(list, id, getTaskOrThrow(store, list, id));
+            const task = createTask(list, id, getTaskOrThrow(store, list, id), deps.path);
             const event = findEvent(stateMachine, task.state, eventName);
             if (event === undefined) {
                 return false;
@@ -456,7 +458,7 @@ function createTasksView(deps, list) {
         async events(id) {
             validateTaskId(id);
             const { store } = await readStore(deps.fs, deps.path, validStates);
-            const task = createTask(list, id, getTaskOrThrow(store, list, id));
+            const task = createTask(list, id, getTaskOrThrow(store, list, id), deps.path);
             return eventsFromState(stateMachine, task.state);
         },
         async delete(id) {
@@ -497,7 +499,7 @@ function createTasksView(deps, list) {
                 }
                 listNode.items.splice(insertIndex, 0, movedPair);
                 await writeAtomically(deps.fs, deps.path, serializeDocument(document));
-                return createTask(list, id, taskRecord);
+                return createTask(list, id, taskRecord, deps.path);
             });
         },
         async reorder(ids) {
@@ -531,7 +533,7 @@ function createTasksView(deps, list) {
                 });
                 listNode.items.splice(0, listNode.items.length, ...orderedActive, ...archivedPairs);
                 await writeAtomically(deps.fs, deps.path, serializeDocument(document));
-                const tasks = ids.map((id) => createTask(list, id, getTaskOrThrow(store, list, id)));
+                const tasks = ids.map((id) => createTask(list, id, getTaskOrThrow(store, list, id), deps.path));
                 return tasks;
             });
         }
@@ -559,7 +561,7 @@ export async function yamlFileBackend(deps) {
                 continue;
             const entries = Object.entries(listRecord)
                 .map(([id, taskRecord]) => ({
-                task: createTask(listName, id, taskRecord),
+                task: createTask(listName, id, taskRecord, deps.path),
                 raw: taskRecord
             }))
                 .filter(({ task }) => matchesFilter(task, filter));
@@ -578,7 +580,7 @@ export async function yamlFileBackend(deps) {
             const { document, store } = await readStore(deps.fs, deps.path, validStates);
             const taskRecord = getTaskOrThrow(store, sourceListName, id);
             if (sourceListName === targetListName) {
-                return createTask(targetListName, id, taskRecord);
+                return createTask(targetListName, id, taskRecord, deps.path);
             }
             if (getTaskRecord(store, targetListName, id)) {
                 throw new TaskAlreadyExistsError(`Task "${targetListName}/${id}" already exists.`);
@@ -586,7 +588,7 @@ export async function yamlFileBackend(deps) {
             document.deleteIn(["lists", sourceListName, id]);
             document.setIn(["lists", targetListName, id], taskRecord);
             await writeAtomically(deps.fs, deps.path, serializeDocument(document));
-            return createTask(targetListName, id, taskRecord);
+            return createTask(targetListName, id, taskRecord, deps.path);
         });
     };
     return {

package/node_modules/@poe-code/task-list/dist/types.d.ts

@@ -8,6 +8,7 @@ export interface Task {
     state: string;
     description: string;
     metadata: Record<string, unknown>;
+    sourcePath?: string;
 }
 export interface TaskCreate {
     id?: string;
@@ -45,6 +46,7 @@ export interface Tasks {
     create(input: TaskCreate): Promise<Task>;
     update(id: string, patch: TaskUpdate): Promise<Task>;
     fire(id: string, event: string, opts?: TaskFireOptions): Promise<Task>;
+    comment?(id: string, body: string): Promise<void>;
     canFire(id: string, event: string): Promise<boolean>;
     events(id: string): Promise<readonly string[]>;
     delete(id: string): Promise<void>;

package/node_modules/auth-store/dist/provider-store.js

@@ -20,9 +20,11 @@ export class MigratingSecretStore {
         return legacyValue;
     }
     async set(value) {
-        return this.store.set(value);
+        await this.store.set(value);
+        await this.legacyStore?.set(value);
     }
     async delete() {
-        return this.store.delete();
+        await this.store.delete();
+        await this.legacyStore?.delete();
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.20",
+  "version": "0.0.21",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -50,7 +50,7 @@
     "jsonc-parser": "^3.3.1",
     "smol-toml": "^1.3.0",
     "tiny-stdio-mcp-server": "^0.1.0",
-    "toolcraft-schema": "^0.0.20",
+    "toolcraft-schema": "^0.0.21",
     "yaml": "^2.8.2"
   },
   "files": [