@pi-orca/tasks 0.0.2-dev.20260413162335

package/README.md

@@ -0,0 +1,43 @@
+# pi-orca-tasks
+
+**Task Management**
+
+Version: 0.0.1 (Phase 0 - Stub)  
+License: MIT
+
+## Overview
+
+File-backed task DAG with locking, dependency validation, and state machine.
+
+**Status:** Phase 0 scaffold complete. Full implementation pending.
+
+## Installation
+
+```bash
+npm install pi-orca-tasks
+```
+
+## Usage
+
+This package is currently in stub mode. Tools and commands are registered but return "Not implemented yet" messages.
+
+## Development Status
+
+- [x] Package scaffold
+- [x] TypeScript configuration
+- [x] Tool registration (stub)
+- [x] Command registration (stub)
+- [x] Event emission (ready signal)
+- [ ] Full implementation (pending)
+
+## Dependencies
+
+- `pi-orca-core` — Shared types and utilities
+
+## Documentation
+
+See the [Pi Orca specification](../../docs/spec-v0.3.0.md) for the complete design.
+
+## License
+
+MIT License — see [LICENSE](../../LICENSE) for details.

package/dist/commands.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Slash command implementations for pi-orca-tasks.
+ * Spec: §3.10 — Slash Commands
+ */
+/**
+ * /task (no args) — return widget string for display
+ */
+export declare function cmdTaskToggle(projectSlug?: string): Promise<string>;
+/**
+ * /task list [status] — list tasks
+ */
+export declare function cmdTaskList(statusFilter?: string, projectSlug?: string): Promise<string>;
+/**
+ * /task stuck — scan for stuck tasks
+ */
+export declare function cmdTaskStuck(projectSlug?: string): Promise<string>;
+/**
+ * /task unlock <id> — force-release a stuck lock
+ */
+export declare function cmdTaskUnlock(taskId: string, projectSlug?: string): Promise<string>;
+/**
+ * /task deps <id> — show dependency graph for a task
+ */
+export declare function cmdTaskDeps(taskId: string, projectSlug?: string): Promise<string>;
+/**
+ * /task validate [id] — validate task files
+ */
+export declare function cmdTaskValidate(taskId?: string, projectSlug?: string): Promise<string>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B9F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDxE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOzF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDvF;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAmDjB"}

package/dist/commands.js

@@ -0,0 +1,213 @@
+/**
+ * Slash command implementations for pi-orca-tasks.
+ * Spec: §3.10 — Slash Commands
+ */
+import { listTasks, readTask, getTaskLockPath } from "./engine/crud.js";
+import { renderTaskWidget } from "./widget.js";
+import { readLock, isPidAlive, getOrcaTasksDir } from "@pi-orca/core";
+import { readdir } from "fs/promises";
+import { existsSync } from "fs";
+import { join } from "path";
+/**
+ * /task (no args) — return widget string for display
+ */
+export async function cmdTaskToggle(projectSlug) {
+    return renderTaskWidget(projectSlug);
+}
+/**
+ * /task list [status] — list tasks
+ */
+export async function cmdTaskList(statusFilter, projectSlug) {
+    const tasks = await listTasks({
+        status: statusFilter,
+        projectSlug,
+    });
+    if (tasks.length === 0) {
+        return statusFilter
+            ? `No tasks with status '${statusFilter}'.`
+            : "No tasks found. Use /task create <title> to create one.";
+    }
+    const STATUS_ICONS = {
+        completed: "✓",
+        in_progress: "◉",
+        pending: "○",
+        failed: "✗",
+        blocked: "⊘",
+        abandoned: "—",
+    };
+    const lines = tasks.map((t) => {
+        const icon = STATUS_ICONS[t.task.status] ?? "?";
+        const assignee = t.task.status === "in_progress" ? ` [${t.task.assignedTo?.slice(0, 8)}]` : "";
+        return `  ${icon} ${t.task.id}  ${t.task.title}${assignee}`;
+    });
+    return `Tasks (${tasks.length}):\n${lines.join("\n")}`;
+}
+/**
+ * /task stuck — scan for stuck tasks
+ */
+export async function cmdTaskStuck(projectSlug) {
+    const tasksDir = getOrcaTasksDir(projectSlug);
+    if (!existsSync(tasksDir)) {
+        return "No tasks directory found.";
+    }
+    let entries;
+    try {
+        entries = await readdir(tasksDir);
+    }
+    catch {
+        return "Could not read tasks directory.";
+    }
+    const lockFiles = entries.filter((e) => e.endsWith(".lock"));
+    if (lockFiles.length === 0) {
+        return "No locked tasks found.";
+    }
+    const stuck = [];
+    const alive = [];
+    for (const lockFile of lockFiles) {
+        const taskId = lockFile.replace(".lock", "");
+        const lockPath = join(tasksDir, lockFile);
+        const lockInfo = await readLock(lockPath);
+        if (!lockInfo) {
+            stuck.push(`${taskId} (unreadable lock file)`);
+            continue;
+        }
+        if (!isPidAlive(lockInfo.pid)) {
+            stuck.push(`${taskId} (PID ${lockInfo.pid} dead, locked by session ${lockInfo.sessionId})`);
+        }
+        else {
+            alive.push(`${taskId} (PID ${lockInfo.pid} alive, held by session ${lockInfo.sessionId})`);
+        }
+    }
+    const lines = [];
+    if (stuck.length > 0) {
+        lines.push(`⚠ Stuck tasks (${stuck.length}):`);
+        stuck.forEach((s) => lines.push(`  ${s}`));
+        lines.push("");
+        lines.push("Run /task unlock <id> to release a stuck lock.");
+    }
+    if (alive.length > 0) {
+        lines.push(`Active locks (${alive.length}):`);
+        alive.forEach((a) => lines.push(`  ${a}`));
+    }
+    if (lines.length === 0) {
+        return "No stuck tasks found.";
+    }
+    return lines.join("\n");
+}
+/**
+ * /task unlock <id> — force-release a stuck lock
+ */
+export async function cmdTaskUnlock(taskId, projectSlug) {
+    const { unlockTask } = await import("./engine/state-machine.js");
+    const result = await unlockTask(taskId, projectSlug);
+    if (result.success) {
+        return result.message ?? `Unlocked task ${taskId}`;
+    }
+    return `Error: ${result.error}`;
+}
+/**
+ * /task deps <id> — show dependency graph for a task
+ */
+export async function cmdTaskDeps(taskId, projectSlug) {
+    const taskFile = await readTask(taskId, projectSlug);
+    if (!taskFile) {
+        return `Task ${taskId} not found.`;
+    }
+    const STATUS_ICONS = {
+        completed: "✓",
+        in_progress: "◉",
+        pending: "○",
+        failed: "✗",
+        blocked: "⊘",
+        abandoned: "—",
+    };
+    const lines = [`${taskId}: ${taskFile.task.title} [${taskFile.task.status}]`];
+    if ((taskFile.task.dependencies ?? []).length > 0) {
+        lines.push("  Dependencies (must complete before this task):");
+        for (const depId of taskFile.task.dependencies) {
+            const dep = await readTask(depId, projectSlug);
+            if (dep) {
+                const icon = STATUS_ICONS[dep.task.status] ?? "?";
+                lines.push(`    ${icon} ${depId}: ${dep.task.title}`);
+            }
+            else {
+                lines.push(`    ? ${depId}: (not found)`);
+            }
+        }
+    }
+    else {
+        lines.push("  Dependencies: none");
+    }
+    if ((taskFile.task.dependents ?? []).length > 0) {
+        lines.push("  Dependents (tasks that depend on this one):");
+        for (const depId of taskFile.task.dependents) {
+            const dep = await readTask(depId, projectSlug);
+            if (dep) {
+                const icon = STATUS_ICONS[dep.task.status] ?? "?";
+                lines.push(`    ${icon} ${depId}: ${dep.task.title}`);
+            }
+            else {
+                lines.push(`    ? ${depId}: (not found)`);
+            }
+        }
+    }
+    else {
+        lines.push("  Dependents: none");
+    }
+    return lines.join("\n");
+}
+/**
+ * /task validate [id] — validate task files
+ */
+export async function cmdTaskValidate(taskId, projectSlug) {
+    const tasks = taskId
+        ? [await readTask(taskId, projectSlug)].filter(Boolean)
+        : await listTasks({ projectSlug });
+    const errors = [];
+    const warnings = [];
+    for (const t of tasks) {
+        if (!t)
+            continue;
+        const { task } = t;
+        if (!task.id)
+            errors.push(`${task.id ?? "?"}: missing id`);
+        if (!task.title)
+            errors.push(`${task.id}: missing title`);
+        if (!task.status)
+            errors.push(`${task.id}: missing status`);
+        if (!task.createdAt)
+            warnings.push(`${task.id}: missing createdAt`);
+        // Check deps exist
+        for (const dep of task.dependencies ?? []) {
+            const depFile = await readTask(dep, projectSlug);
+            if (!depFile) {
+                errors.push(`${task.id}: dependency ${dep} does not exist`);
+            }
+        }
+        // Check lock file consistency
+        const lockPath = getTaskLockPath(task.id, projectSlug);
+        const lockInfo = await readLock(lockPath);
+        if (lockInfo && task.status !== "in_progress") {
+            warnings.push(`${task.id}: has lock file but status is '${task.status}'`);
+        }
+        if (!lockInfo && task.status === "in_progress") {
+            warnings.push(`${task.id}: status is 'in_progress' but has no lock file`);
+        }
+    }
+    const lines = [];
+    if (errors.length === 0 && warnings.length === 0) {
+        lines.push(`✓ Validated ${tasks.length} task(s) — no issues found`);
+    }
+    else {
+        if (errors.length > 0) {
+            lines.push(`✗ Errors (${errors.length}):`);
+            errors.forEach((e) => lines.push(`  ${e}`));
+        }
+        if (warnings.length > 0) {
+            lines.push(`⚠ Warnings (${warnings.length}):`);
+            warnings.forEach((w) => lines.push(`  ${w}`));
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAoB;IACtD,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,YAAqB,EAAE,WAAoB;IAC3E,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC;QAC5B,MAAM,EAAE,YAAmB;QAC3B,WAAW;KACZ,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY;YACjB,CAAC,CAAC,yBAAyB,YAAY,IAAI;YAC3C,CAAC,CAAC,yDAAyD,CAAC;IAChE,CAAC;IAED,MAAM,YAAY,GAA2B;QAC3C,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,GAAG;QAChB,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;QAChD,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAoB;IACrD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,iCAAiC,CAAC;IAC3C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,wBAAwB,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yBAAyB,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,QAAQ,CAAC,GAAG,4BAA4B,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,QAAQ,CAAC,GAAG,2BAA2B,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,WAAoB;IACtE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,OAAO,IAAI,iBAAiB,MAAM,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,WAAoB;IACpE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,MAAM,aAAa,CAAC;IACrC,CAAC;IAED,MAAM,YAAY,GAA2B;QAC3C,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,GAAG;QAChB,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,MAAM,KAAK,GAAa,CAAC,GAAG,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAExF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC/D,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAC/C,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,eAAe,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAC/C,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,eAAe,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAe,EACf,WAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM;QAClB,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACvD,CAAC,CAAC,MAAM,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAErC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAEnB,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,cAAc,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAEpE,mBAAmB;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,kCAAkC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,gDAAgD,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,4BAA4B,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;YAC3C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;YAC/C,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/crud.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Task file CRUD operations.
+ * Spec: §3.3 — Task File Schema, §3.4 — Lock File Schema
+ */
+import { Task, TaskStatus, Labels } from "@pi-orca/core";
+export interface CreateTaskParams {
+    title: string;
+    description?: string;
+    dependencies?: string[];
+    labels?: Labels;
+    projectSlug?: string;
+}
+export interface UpdateTaskParams {
+    title?: string;
+    dependencies?: string[];
+    labels?: Labels;
+    projectSlug?: string;
+}
+export interface ListTasksFilter {
+    status?: TaskStatus | TaskStatus[];
+    labels?: Labels;
+    includeArchived?: boolean;
+    projectSlug?: string;
+}
+/**
+ * Task file with its path on disk.
+ */
+export interface TaskFile {
+    task: Task;
+    filePath: string;
+    body: string;
+}
+/**
+ * Generate the next sequential task ID.
+ */
+export declare function generateTaskId(tasksDir: string): Promise<string>;
+/**
+ * Get full path to a task file.
+ */
+export declare function getTaskFilePath(taskId: string, projectSlug?: string): string;
+/**
+ * Get full path to a task lock file.
+ */
+export declare function getTaskLockPath(taskId: string, projectSlug?: string): string;
+/**
+ * Create a new task file.
+ * Spec: §2.1.1
+ */
+export declare function createTask(params: CreateTaskParams): Promise<TaskFile>;
+/**
+ * Read a task file from disk.
+ * Spec: §2.1.2
+ */
+export declare function readTask(taskId: string, projectSlug?: string): Promise<TaskFile | null>;
+/**
+ * Write a task file to disk (replaces content).
+ */
+export declare function writeTask(taskFile: TaskFile): Promise<void>;
+/**
+ * Update task frontmatter fields.
+ * Spec: §2.1.3
+ */
+export declare function updateTask(taskId: string, patch: Partial<Task>, projectSlug?: string): Promise<TaskFile | null>;
+/**
+ * List tasks with optional filters.
+ * Spec: §2.1.4
+ */
+export declare function listTasks(filter?: ListTasksFilter): Promise<TaskFile[]>;
+/**
+ * Build dependency map from all task files.
+ * Returns { dependencies: task→deps[], dependents: task→dependents[] }
+ */
+export declare function buildDependencyMaps(projectSlug?: string): Promise<{
+    dependencies: Map<string, string[]>;
+    dependents: Map<string, string[]>;
+}>;
+/**
+ * Update reverse dependency (dependents) links when a task's dependencies change.
+ */
+export declare function syncDependentLinks(taskId: string, oldDeps: string[], newDeps: string[], projectSlug?: string): Promise<void>;
+//# sourceMappingURL=crud.d.ts.map

package/dist/engine/crud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud.d.ts","sourceRoot":"","sources":["../../src/engine/crud.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EACL,IAAI,EACJ,UAAU,EAQV,MAAM,EACP,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiC5E;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAO1B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAY1B;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoD7E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;IACT,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC,CAAC,CAmBD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/engine/crud.js

@@ -0,0 +1,214 @@
+/**
+ * Task file CRUD operations.
+ * Spec: §3.3 — Task File Schema, §3.4 — Lock File Schema
+ */
+import { readdir } from "fs/promises";
+import { existsSync } from "fs";
+import { join } from "path";
+import { parseFrontmatter, serializeFrontmatter, atomicWrite, ensureDir, readFileIfExists, matchLabels, getOrcaTasksDir, } from "@pi-orca/core";
+/**
+ * Generate the next sequential task ID.
+ */
+export async function generateTaskId(tasksDir) {
+    await ensureDir(tasksDir);
+    if (!existsSync(tasksDir)) {
+        return "task-001";
+    }
+    let entries;
+    try {
+        entries = await readdir(tasksDir);
+    }
+    catch {
+        return "task-001";
+    }
+    // Find highest existing task number
+    const taskNums = entries
+        .filter((e) => /^task-\d+\.md$/.test(e))
+        .map((e) => parseInt(e.replace("task-", "").replace(".md", ""), 10))
+        .filter((n) => !isNaN(n));
+    const max = taskNums.length > 0 ? Math.max(...taskNums) : 0;
+    return `task-${String(max + 1).padStart(3, "0")}`;
+}
+/**
+ * Get full path to a task file.
+ */
+export function getTaskFilePath(taskId, projectSlug) {
+    return join(getOrcaTasksDir(projectSlug), `${taskId}.md`);
+}
+/**
+ * Get full path to a task lock file.
+ */
+export function getTaskLockPath(taskId, projectSlug) {
+    return join(getOrcaTasksDir(projectSlug), `${taskId}.lock`);
+}
+/**
+ * Create a new task file.
+ * Spec: §2.1.1
+ */
+export async function createTask(params) {
+    const tasksDir = getOrcaTasksDir(params.projectSlug);
+    await ensureDir(tasksDir);
+    const taskId = await generateTaskId(tasksDir);
+    const now = new Date().toISOString();
+    const task = {
+        id: taskId,
+        title: params.title,
+        status: "pending",
+        createdAt: now,
+        updatedAt: now,
+        completedAt: "",
+        assignedTo: "",
+        assignedSessionPath: "",
+        dependencies: params.dependencies ?? [],
+        dependents: [],
+        blockedReason: "",
+        retryCount: 0,
+        labels: params.labels ?? {},
+        archivable: false,
+    };
+    const body = params.description
+        ? `## Description\n\n${params.description}\n`
+        : `## Description\n\n_No description provided._\n`;
+    const content = serializeFrontmatter(task, body);
+    const filePath = getTaskFilePath(taskId, params.projectSlug);
+    await atomicWrite(filePath, content);
+    return { task, filePath, body };
+}
+/**
+ * Read a task file from disk.
+ * Spec: §2.1.2
+ */
+export async function readTask(taskId, projectSlug) {
+    const filePath = getTaskFilePath(taskId, projectSlug);
+    const content = await readFileIfExists(filePath);
+    if (!content)
+        return null;
+    const { frontmatter, body } = parseFrontmatter(content);
+    return { task: frontmatter, filePath, body };
+}
+/**
+ * Write a task file to disk (replaces content).
+ */
+export async function writeTask(taskFile) {
+    const content = serializeFrontmatter(taskFile.task, taskFile.body);
+    await atomicWrite(taskFile.filePath, content);
+}
+/**
+ * Update task frontmatter fields.
+ * Spec: §2.1.3
+ */
+export async function updateTask(taskId, patch, projectSlug) {
+    const taskFile = await readTask(taskId, projectSlug);
+    if (!taskFile)
+        return null;
+    taskFile.task = {
+        ...taskFile.task,
+        ...patch,
+        updatedAt: new Date().toISOString(),
+    };
+    await writeTask(taskFile);
+    return taskFile;
+}
+/**
+ * List tasks with optional filters.
+ * Spec: §2.1.4
+ */
+export async function listTasks(filter) {
+    const tasksDir = getOrcaTasksDir(filter?.projectSlug);
+    await ensureDir(tasksDir);
+    let entries;
+    try {
+        entries = await readdir(tasksDir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of entries) {
+        // Skip archived, lock files, non-md files
+        if (!entry.endsWith(".md"))
+            continue;
+        if (entry.startsWith("archived"))
+            continue;
+        const filePath = join(tasksDir, entry);
+        const content = await readFileIfExists(filePath);
+        if (!content)
+            continue;
+        try {
+            const { frontmatter, body } = parseFrontmatter(content);
+            // Filter by status
+            if (filter?.status) {
+                const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+                if (!statuses.includes(frontmatter.status))
+                    continue;
+            }
+            // Filter by labels
+            if (filter?.labels && Object.keys(filter.labels).length > 0) {
+                if (!matchLabels(frontmatter.labels ?? {}, filter.labels))
+                    continue;
+            }
+            // Filter archived (unless includeArchived)
+            if (!filter?.includeArchived && frontmatter.archivable) {
+                // Still include — archivable just marks eligible for sweep
+                // Actually archivable=true items can still be listed; only skip if in archived/ folder
+            }
+            results.push({ task: frontmatter, filePath, body });
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    // Sort by task ID (e.g., task-001, task-002)
+    results.sort((a, b) => a.task.id.localeCompare(b.task.id));
+    return results;
+}
+/**
+ * Build dependency map from all task files.
+ * Returns { dependencies: task→deps[], dependents: task→dependents[] }
+ */
+export async function buildDependencyMaps(projectSlug) {
+    const tasks = await listTasks({ projectSlug });
+    const dependencies = new Map();
+    const dependents = new Map();
+    for (const { task } of tasks) {
+        dependencies.set(task.id, task.dependencies ?? []);
+        if (!dependents.has(task.id)) {
+            dependents.set(task.id, []);
+        }
+        for (const dep of task.dependencies ?? []) {
+            if (!dependents.has(dep)) {
+                dependents.set(dep, []);
+            }
+            dependents.get(dep).push(task.id);
+        }
+    }
+    return { dependencies, dependents };
+}
+/**
+ * Update reverse dependency (dependents) links when a task's dependencies change.
+ */
+export async function syncDependentLinks(taskId, oldDeps, newDeps, projectSlug) {
+    // Remove taskId from dependents of removed deps
+    const removed = oldDeps.filter((d) => !newDeps.includes(d));
+    const added = newDeps.filter((d) => !oldDeps.includes(d));
+    for (const depId of removed) {
+        const depFile = await readTask(depId, projectSlug);
+        if (depFile) {
+            depFile.task.dependents = (depFile.task.dependents ?? []).filter((id) => id !== taskId);
+            depFile.task.updatedAt = new Date().toISOString();
+            await writeTask(depFile);
+        }
+    }
+    for (const depId of added) {
+        const depFile = await readTask(depId, projectSlug);
+        if (depFile) {
+            const deps = depFile.task.dependents ?? [];
+            if (!deps.includes(taskId)) {
+                depFile.task.dependents = [...deps, taskId];
+                depFile.task.updatedAt = new Date().toISOString();
+                await writeTask(depFile);
+            }
+        }
+    }
+}
+//# sourceMappingURL=crud.js.map

package/dist/engine/crud.js.map

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

package/dist/engine/dag.d.ts

@@ -0,0 +1,30 @@
+/**
+ * DAG validation and cascading for tasks.
+ * Spec: §3.5 — Dependency Validation
+ */
+/**
+ * Validate that adding a dependency does not create a cycle.
+ * Returns cycle path string if cycle found, null if safe.
+ * Spec: §3.5 — Cycle Detection
+ */
+export declare function validateNoCycle(taskId: string, newDependency: string, projectSlug?: string): Promise<string | null>;
+/**
+ * Validate all new dependencies for a task do not create cycles.
+ * Returns error message if any cycle found, null if all safe.
+ */
+export declare function validateDependencies(taskId: string, newDependencies: string[], projectSlug?: string): Promise<string | null>;
+/**
+ * Cascade failure to all transitive dependents.
+ * When a task fails, all tasks that depend on it (directly or transitively)
+ * are blocked with blockedReason pointing to the root failed task.
+ * Spec: §3.5 — Failure Cascading
+ */
+export declare function cascadeFailure(failedTaskId: string, projectSlug?: string): Promise<void>;
+/**
+ * Re-evaluate and unblock dependents after a task's failure is resolved.
+ * When a failed task is retried and completes, all dependents whose
+ * blockedReason traced back to this task are re-evaluated.
+ * Spec: §3.5 — Unblock Cascading
+ */
+export declare function cascadeUnblock(resolvedTaskId: string, projectSlug?: string): Promise<void>;
+//# sourceMappingURL=dag.d.ts.map

package/dist/engine/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/engine/dag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAwCf"}