@pi-orca/tasks 0.0.2-dev.20260413162335

package/dist/index.js

@@ -0,0 +1,229 @@
+/**
+ * Pi Orca Tasks Extension
+ * File-backed task DAG with locking.
+ * Spec: §3 — pi-orca-tasks Extension
+ */
+import { executeTaskTool } from "./tool.js";
+import { renderTaskWidget } from "./widget.js";
+import { cmdTaskList, cmdTaskStuck, cmdTaskUnlock, cmdTaskDeps, cmdTaskValidate, } from "./commands.js";
+import { listTasks } from "./engine/crud.js";
+import { resolveCompletions } from "@pi-orca/core";
+export { executeTaskTool } from "./tool.js";
+export * from "./engine/index.js";
+export { renderTaskWidget } from "./widget.js";
+export * from "./commands.js";
+// ─── completion cache (updated on session_start) ─────────────────────────────
+let _cachedTaskIds = [];
+const TASK_STATUSES = ["pending", "in_progress", "completed", "failed", "blocked", "abandoned"];
+function buildTaskTree() {
+    return {
+        items: [
+            { value: "list", label: "list", description: "List tasks" },
+            { value: "create", label: "create", description: "Create a new task" },
+            { value: "stuck", label: "stuck", description: "Show stuck tasks" },
+            { value: "unlock", label: "unlock", description: "Force-release a task lock" },
+            { value: "deps", label: "deps", description: "Show task dependencies" },
+            { value: "validate", label: "validate", description: "Validate task files" },
+        ],
+        children: {
+            list: {
+                items: TASK_STATUSES.map((s) => ({ value: s, label: s })),
+            },
+            create: { freeform: true },
+            unlock: {
+                dynamicItems: () => _cachedTaskIds.map((t) => ({
+                    value: t.id,
+                    label: t.id,
+                    description: `${t.title} [${t.status}]`,
+                })),
+            },
+            deps: {
+                dynamicItems: () => _cachedTaskIds.map((t) => ({
+                    value: t.id,
+                    label: t.id,
+                    description: `${t.title} [${t.status}]`,
+                })),
+            },
+            validate: {
+                dynamicItems: () => _cachedTaskIds.map((t) => ({
+                    value: t.id,
+                    label: t.id,
+                    description: `${t.title} [${t.status}]`,
+                })),
+            },
+        },
+    };
+}
+let widgetVisible = false;
+export function register(pi) {
+    console.log("pi-orca-tasks: Registering extension");
+    // Register task tool with full implementation
+    pi.registerTool?.({
+        name: "task",
+        label: "Task Management",
+        description: "Manage file-backed tasks with dependencies. Actions: create, claim, complete, fail, abandon, list, unlock, update, retry, note, unclaim",
+        parameters: {
+            type: "object",
+            properties: {
+                action: {
+                    type: "string",
+                    enum: [
+                        "create",
+                        "claim",
+                        "complete",
+                        "fail",
+                        "abandon",
+                        "list",
+                        "unlock",
+                        "update",
+                        "retry",
+                        "note",
+                        "unclaim",
+                    ],
+                    description: "Action to perform",
+                },
+                taskId: { type: "string", description: "Task ID (required for most actions)" },
+                title: { type: "string", description: "Task title (required for create)" },
+                description: { type: "string", description: "Task description (for create)" },
+                dependencies: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Task IDs this task depends on",
+                },
+                labels: {
+                    type: "object",
+                    description: "Key-value labels for filtering",
+                },
+                status: { type: "string", description: "Status filter for list action" },
+                note: { type: "string", description: "Note content (required for fail, abandon, note actions)" },
+            },
+            required: ["action"],
+        },
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            const sessionId = ctx?.sessionId ?? process.env["PI_SESSION_ID"] ?? "default-session";
+            const sessionPath = ctx?.sessionPath ?? process.env["PI_SESSION_PATH"] ?? "";
+            const result = await executeTaskTool({
+                ...params,
+                sessionId,
+                sessionPath,
+            });
+            // Refresh widget after state changes
+            if (widgetVisible &&
+                ctx?.ui?.setWidget &&
+                ["create", "claim", "complete", "fail", "abandon", "unclaim", "retry", "unlock", "update"].includes(params.action)) {
+                const widgetContent = await renderTaskWidget();
+                ctx.ui.setWidget("pi-orca-tasks", widgetContent);
+            }
+            return result;
+        },
+    });
+    // Register slash commands
+    pi.registerCommand("task", {
+        description: "Manage tasks or toggle task widget",
+        getArgumentCompletions(prefix) {
+            return resolveCompletions(prefix, buildTaskTree());
+        },
+        handler: async (args, ctx) => {
+            const parts = args ? args.trim().split(/\s+/) : [];
+            const subcommand = parts[0];
+            if (!subcommand) {
+                // Toggle widget
+                widgetVisible = !widgetVisible;
+                if (widgetVisible) {
+                    const content = await renderTaskWidget();
+                    ctx.ui.setWidget("pi-orca-tasks", content);
+                    ctx.ui.notify("Task widget shown", "info");
+                }
+                else {
+                    ctx.ui.setWidget("pi-orca-tasks", undefined);
+                    ctx.ui.notify("Task widget hidden", "info");
+                }
+                return;
+            }
+            switch (subcommand.toLowerCase()) {
+                case "list": {
+                    const statusFilter = parts[1];
+                    const result = await cmdTaskList(statusFilter);
+                    ctx.ui.notify(result, "info");
+                    break;
+                }
+                case "create": {
+                    const title = parts.slice(1).join(" ");
+                    if (!title) {
+                        ctx.ui.notify("Usage: /task create <title>", "error");
+                        break;
+                    }
+                    const result = await executeTaskTool({
+                        action: "create",
+                        title,
+                        sessionId: ctx?.sessionManager?.getSessionFile?.() ?? "default-session",
+                        sessionPath: ctx?.sessionManager?.getSessionFile?.() ?? "",
+                    });
+                    if (result.success) {
+                        ctx.ui.notify(`Created task: ${result.task?.id} — ${title}`, "info");
+                    }
+                    else {
+                        ctx.ui.notify(`Error: ${result.error}`, "error");
+                    }
+                    break;
+                }
+                case "stuck": {
+                    const result = await cmdTaskStuck();
+                    ctx.ui.notify(result, "info");
+                    break;
+                }
+                case "unlock": {
+                    const taskId = parts[1];
+                    if (!taskId) {
+                        ctx.ui.notify("Usage: /task unlock <id>", "error");
+                        break;
+                    }
+                    const result = await cmdTaskUnlock(taskId);
+                    ctx.ui.notify(result, result.startsWith("Error") ? "error" : "info");
+                    break;
+                }
+                case "deps": {
+                    const taskId = parts[1];
+                    if (!taskId) {
+                        ctx.ui.notify("Usage: /task deps <id>", "error");
+                        break;
+                    }
+                    const result = await cmdTaskDeps(taskId);
+                    ctx.ui.notify(result, "info");
+                    break;
+                }
+                case "validate": {
+                    const taskId = parts[1];
+                    const result = await cmdTaskValidate(taskId);
+                    ctx.ui.notify(result, result.includes("Error") || result.includes("invalid") ? "warning" : "info");
+                    break;
+                }
+                default:
+                    ctx.ui.notify(`Unknown subcommand '${subcommand}'. Available: list, create, stuck, unlock, deps, validate`, "error");
+            }
+        },
+    });
+    // Populate caches and emit ready event on session_start
+    pi.on("session_start", async () => {
+        try {
+            const tasks = await listTasks({});
+            _cachedTaskIds = tasks.map((t) => ({
+                id: t.task.id,
+                title: t.task.title,
+                status: t.task.status,
+            }));
+        }
+        catch {
+            // Task directory may not exist yet — leave cache empty
+        }
+        pi.events?.emit("orca:tasks:ready", {});
+        console.log("pi-orca-tasks: Ready");
+    });
+    // Check for other extensions
+    pi.events?.on("orca:models:ready", () => {
+        console.log("pi-orca-tasks: pi-orca-models detected");
+    });
+    console.log("pi-orca-tasks: Registered");
+}
+export default register;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Task tool action dispatcher.
+ * Spec: §3.9 — Tool Schema
+ */
+export interface TaskToolParams {
+    action: "create" | "claim" | "complete" | "fail" | "abandon" | "list" | "unlock" | "update" | "retry" | "note" | "unclaim";
+    taskId?: string;
+    title?: string;
+    description?: string;
+    dependencies?: string[];
+    labels?: Record<string, string>;
+    status?: string;
+    note?: string;
+    sessionId?: string;
+    sessionPath?: string;
+    projectSlug?: string;
+}
+export declare function executeTaskTool(params: TaskToolParams): Promise<Record<string, unknown>>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,MAAM,WAAW,cAAc;IAC7B,MAAM,EACF,QAAQ,GACR,OAAO,GACP,UAAU,GACV,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6LlC"}

package/dist/tool.js

@@ -0,0 +1,188 @@
+/**
+ * Task tool action dispatcher.
+ * Spec: §3.9 — Tool Schema
+ */
+import { createTask, readTask, listTasks, updateTask as updateTaskCrud, syncDependentLinks, buildDependencyMaps, } from "./engine/crud.js";
+import { claimTask, completeTask, failTask, abandonTask, unclaimTask, retryTask, unlockTask, } from "./engine/state-machine.js";
+import { addNote } from "./engine/notes.js";
+import { validateDependencies } from "./engine/dag.js";
+export async function executeTaskTool(params) {
+    const sessionId = params.sessionId ?? process.env["PI_SESSION_ID"] ?? "default-session";
+    const sessionPath = params.sessionPath ?? process.env["PI_SESSION_PATH"] ?? "";
+    const projectSlug = params.projectSlug;
+    switch (params.action) {
+        case "create": {
+            if (!params.title) {
+                return { success: false, error: "The 'title' parameter is required for create action" };
+            }
+            // Validate dependencies exist and no cycles
+            if (params.dependencies && params.dependencies.length > 0) {
+                // Check each dep task exists
+                for (const dep of params.dependencies) {
+                    const depFile = await readTask(dep, projectSlug);
+                    if (!depFile) {
+                        return { success: false, error: `Dependency task ${dep} not found` };
+                    }
+                }
+                // We need a temporary fake ID to check for cycles (task doesn't exist yet)
+                // Use a deterministic placeholder
+                const tempId = `__new__`;
+                const { dependencies: depMap } = await buildDependencyMaps(projectSlug);
+                for (const dep of params.dependencies) {
+                    const { detectCycle } = await import("@pi-orca/core");
+                    const cycle = detectCycle(tempId, dep, depMap);
+                    if (cycle) {
+                        return { success: false, error: `Cycle detected: ${cycle.join(" → ")}` };
+                    }
+                }
+            }
+            const taskFile = await createTask({
+                title: params.title,
+                description: params.description,
+                dependencies: params.dependencies,
+                labels: params.labels,
+                projectSlug,
+            });
+            // Update reverse links
+            if (params.dependencies && params.dependencies.length > 0) {
+                await syncDependentLinks(taskFile.task.id, [], params.dependencies, projectSlug);
+            }
+            return { success: true, task: taskFile.task, message: `Created task ${taskFile.task.id}` };
+        }
+        case "claim": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for claim action" };
+            }
+            const result = await claimTask(params.taskId, sessionId, sessionPath, undefined, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return {
+                success: true,
+                task: result.task?.task,
+                body: result.task?.body,
+                claimContext: result.claimContext,
+                message: `Claimed task ${params.taskId}`,
+            };
+        }
+        case "complete": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for complete action" };
+            }
+            const result = await completeTask(params.taskId, sessionId, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, task: result.task?.task, message: `Completed task ${params.taskId}` };
+        }
+        case "fail": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for fail action" };
+            }
+            if (!params.note) {
+                return { success: false, error: "The 'note' parameter is required when failing a task" };
+            }
+            const result = await failTask(params.taskId, sessionId, params.note, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, task: result.task?.task, message: `Failed task ${params.taskId}` };
+        }
+        case "abandon": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for abandon action" };
+            }
+            if (!params.note) {
+                return { success: false, error: "The 'note' parameter is required when abandoning a task" };
+            }
+            const result = await abandonTask(params.taskId, sessionId, params.note, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, task: result.task?.task, message: `Abandoned task ${params.taskId}` };
+        }
+        case "unclaim": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for unclaim action" };
+            }
+            const result = await unclaimTask(params.taskId, sessionId, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, task: result.task?.task, message: `Unclaimed task ${params.taskId}` };
+        }
+        case "list": {
+            const statusFilter = params.status;
+            const tasks = await listTasks({
+                status: statusFilter,
+                labels: params.labels,
+                projectSlug,
+            });
+            return {
+                success: true,
+                tasks: tasks.map((t) => t.task),
+                count: tasks.length,
+            };
+        }
+        case "unlock": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for unlock action" };
+            }
+            const result = await unlockTask(params.taskId, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, task: result.task?.task, message: result.message ?? `Unlocked task ${params.taskId}` };
+        }
+        case "update": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for update action" };
+            }
+            const taskFile = await readTask(params.taskId, projectSlug);
+            if (!taskFile) {
+                return { success: false, error: `Task ${params.taskId} not found` };
+            }
+            const patch = {};
+            if (params.title !== undefined)
+                patch["title"] = params.title;
+            if (params.labels !== undefined)
+                patch["labels"] = params.labels;
+            if (params.dependencies !== undefined) {
+                // Validate new dependencies
+                const error = await validateDependencies(params.taskId, params.dependencies, projectSlug);
+                if (error)
+                    return { success: false, error };
+                const oldDeps = taskFile.task.dependencies ?? [];
+                patch["dependencies"] = params.dependencies;
+                const updated = await updateTaskCrud(params.taskId, patch, projectSlug);
+                if (!updated)
+                    return { success: false, error: `Failed to update task ${params.taskId}` };
+                // Sync reverse links
+                await syncDependentLinks(params.taskId, oldDeps, params.dependencies, projectSlug);
+                return { success: true, task: updated.task, message: `Updated task ${params.taskId}` };
+            }
+            const updated = await updateTaskCrud(params.taskId, patch, projectSlug);
+            if (!updated)
+                return { success: false, error: `Failed to update task ${params.taskId}` };
+            return { success: true, task: updated.task, message: `Updated task ${params.taskId}` };
+        }
+        case "retry": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for retry action" };
+            }
+            const result = await retryTask(params.taskId, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, task: result.task?.task, message: `Retried task ${params.taskId}` };
+        }
+        case "note": {
+            if (!params.taskId) {
+                return { success: false, error: "The 'taskId' parameter is required for note action" };
+            }
+            if (!params.note) {
+                return { success: false, error: "The 'note' parameter is required for note action" };
+            }
+            const result = await addNote(params.taskId, params.note, sessionId, projectSlug);
+            if (!result.success)
+                return { success: false, error: result.error };
+            return { success: true, message: `Added note to task ${params.taskId}` };
+        }
+        default:
+            return { success: false, error: `Unknown action: ${params.action}` };
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}

package/dist/widget.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Task widget renderer.
+ * Spec: §3.11 — Widget
+ */
+/**
+ * Render the task widget as a string.
+ * Spec: §3.11
+ */
+export declare function renderTaskWidget(projectSlug?: string): Promise<string>;
+//# sourceMappingURL=widget.d.ts.map

package/dist/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4CH;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5E"}

package/dist/widget.js

@@ -0,0 +1,59 @@
+/**
+ * Task widget renderer.
+ * Spec: §3.11 — Widget
+ */
+import { listTasks } from "./engine/crud.js";
+const STATUS_ICONS = {
+    completed: "✓",
+    in_progress: "◉",
+    pending: "○",
+    failed: "✗",
+    blocked: "⊘",
+    abandoned: "—",
+};
+function formatLabels(labels = {}) {
+    const entries = Object.entries(labels);
+    if (entries.length === 0)
+        return "";
+    return `[${entries.map(([, v]) => v).join(", ")}]`;
+}
+function formatTaskLine(task) {
+    const icon = STATUS_ICONS[task.status] ?? "?";
+    const assignee = task.status === "in_progress" && task.assignedTo
+        ? ` ← ${task.assignedTo.slice(0, 8)}`
+        : "";
+    const labels = formatLabels(task.labels);
+    const labelsStr = labels ? `  ${labels}` : "";
+    let suffix = "";
+    if (task.status === "failed") {
+        suffix = "     FAILED";
+    }
+    else if (task.status === "blocked") {
+        const reason = task.blockedReason?.replace("root cause: ", "") ?? "";
+        suffix = reason ? `     BLOCKED: ${reason}` : "     BLOCKED";
+    }
+    else if (task.status === "pending" && task.dependencies?.length) {
+        suffix = `     depends: ${task.dependencies.join(", ")}`;
+    }
+    const id = task.id.padEnd(10);
+    const title = task.title.length > 40 ? task.title.slice(0, 37) + "..." : task.title.padEnd(40);
+    return `  ${icon} ${id}  ${title}${assignee}${labelsStr}${suffix}`;
+}
+/**
+ * Render the task widget as a string.
+ * Spec: §3.11
+ */
+export async function renderTaskWidget(projectSlug) {
+    const tasks = await listTasks({ projectSlug });
+    const completed = tasks.filter((t) => t.task.status === "completed").length;
+    const total = tasks.length;
+    const lines = [
+        `📋 Tasks — ${completed}/${total} completed`,
+        ...tasks.map((t) => formatTaskLine(t.task)),
+    ];
+    if (total === 0) {
+        lines.push("  (no tasks — use /task create <title> to add one)");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pi-orca/tasks",
+  "version": "0.0.2-dev.20260413162335",
+  "description": "File-backed task DAG with locking",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "defaults"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-orca",
+    "pi-agent",
+    "pi-extension"
+  ],
+  "author": "Bindu / Ba",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bwavell/pi-orca.git",
+    "directory": "packages/pi-orca-tasks"
+  },
+  "dependencies": {
+    "@pi-orca/core": "0.0.2-dev.20260413162335"
+  }
+}