strikethroo 3.0.1 → 3.1.0

package/README.md

@@ -3,8 +3,6 @@
 [![npm version](https://img.shields.io/npm/v/strikethroo.svg)](https://www.npmjs.com/package/strikethroo)
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
-![Dashboard](./docs/img/dashboard.svg)
-
 **Strikethroo: extensible AI-powered plan and task management with customizable workflows and structured development processes.**
 
 Transform complex AI prompts into organized, executable workflows through customizable hooks, templates, and progressive refinement. Works seamlessly within your existing AI subscriptions for Claude Code, Gemini CLI, and Open Code.
@@ -25,13 +23,30 @@ The skills give your assistant the planning, decomposition, and execution workfl
 
 The CLI's `init` emits the shared workspace plus harness-specific agents (e.g., `.claude/agents/` for Claude). Other harnesses rely entirely on the installed skills.
 
+## 🌐 Serve the Workspace
+
+Run a local web app over an initialized `.ai/strikethroo/` workspace:
+
+```bash
+npx strikethroo serve
+```
+
+`serve` boots a dependency-light Node server that hosts the prebuilt single-page app as static files, exposes a read-only JSON API over the workspace model, and streams a coalesced `changed` event over Server-Sent Events whenever the workspace mutates on disk. Run it from inside an initialized workspace; if none is found it prints guidance to run `init` and exits without binding.
+
+The viewer is read-only **except for one permitted mutation: the archive action.** A plan whose tasks are all complete (derived state `done`) shows an **Archive** control; confirming it issues `POST /api/plans/:id/archive`, which moves that plan's directory from `plans/` to `archive/`. It is strictly a directory move — no files are deleted or edited, and only `done` plans are accepted. This is the manual escape hatch for plans that are done but not yet archived; it does **not** replace the automatic archival the `st-execute-blueprint` skill performs on successful completion.
+
+Flags:
+
+- `--port <n>` — port to bind (default `4317`).
+- `--no-open` — do not open the browser on start.
+- `--workspace <path>` — override workspace root discovery.
+
 ## ✨ Key Benefits
 
 - **🔧 Fully Customizable**: Tailor hooks, templates, and workflows to your project's specific needs
 - **🎯 Extensible Architecture**: Add custom validation gates, quality checks, and workflow patterns
 - **📋 Structured Workflows**: Three-phase progressive refinement with validation gates
 - **🔄 Plan Mode Integration**: Enhance existing AI assistant features with structured task management
-- **📊 Plan Inspection & Management**: View progress, archive completed work, and manage plans via CLI
 - **💰 Works Within Subscriptions**: No additional API keys or costs required
 
 ## 📖 Documentation
@@ -60,8 +75,8 @@ The `st-full-workflow` skill handles plan creation, task generation, and bluepri
 2. **🔍 Refine the plan** → "Refine plan 1" (`st-refine-plan` skill — useful when a second assistant should red-team the plan)
 3. **📋 Generate tasks** → "Generate tasks for plan 1" (`st-generate-tasks` skill)
 4. **🚀 Execute blueprint** → "Execute the blueprint for plan 1" (`st-execute-blueprint` skill)
-5. **📊 Monitor progress** → `npx strikethroo status`
-6. **🗂️ Manage plans** → `npx strikethroo plan show 1`
+
+Progress is driven by the Agent Skills workflow: the `st-execute-blueprint` skill runs the phases, archives the plan automatically on completion, and you can inspect plan and task files directly under `.ai/strikethroo/plans/` (completed plans move to `.ai/strikethroo/archive/`).
 
 ## 🤖 Supported Harnesses
 

package/dist/cli.js

@@ -9,8 +9,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const index_1 = require("./index");
-const status_1 = require("./status");
-const plan_1 = require("./plan");
+const root_1 = require("./serve/root");
+const server_1 = require("./serve/server");
 const program = new commander_1.Command();
 program.name('strikethroo').version('0.1.0').description('AI-powered task management CLI tool');
 program
@@ -37,140 +37,31 @@ program
     }
 });
 program
-    .command('status')
-    .description('Display dashboard with plans and task statistics')
-    .action(async () => {
+    .command('serve')
+    .description('Serve the workspace as a local web app (static SPA, JSON API, SSE change stream)')
+    .option('--port <n>', 'port to bind', '4317')
+    .option('--no-open', 'do not open the browser on start')
+    .option('--workspace <path>', 'override workspace root discovery')
+    .action(async (opts) => {
     try {
-        const result = await (0, status_1.status)();
-        if (result.success) {
-            process.exit(0);
-        }
-        else {
-            if (result.message) {
-                console.error(result.message);
-            }
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        console.error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
-    }
-});
-// Create parent plan command for help organization
-const planCommand = program
-    .command('plan')
-    .description('Display and manage plans. Use `plan <id>` as shorthand for `plan show <id>`.');
-// Plan show subcommand
-planCommand
-    .command('show <plan-id>')
-    .description('Display plan metadata, progress, and executive summary')
-    .action(async (planId) => {
-    try {
-        const planIdNum = parseInt(planId, 10);
-        if (isNaN(planIdNum)) {
-            console.error(`Invalid plan ID: ${planId}. Must be a number.`);
-            process.exit(1);
-        }
-        const result = await (0, plan_1.showPlan)(planIdNum);
-        if (result.success) {
-            process.exit(0);
-        }
-        else {
-            if (result.message) {
-                console.error(result.message);
-            }
+        const resolved = (0, root_1.resolveWorkspaceRoot)({ workspace: opts.workspace });
+        if ((0, root_1.isResolveError)(resolved)) {
+            console.error(resolved.error);
             process.exit(1);
         }
+        const handle = await (0, server_1.startServer)({
+            root: resolved.root,
+            port: Number(opts.port),
+            open: opts.open,
+            assetsDir: (0, server_1.defaultAssetsDir)(),
+        });
+        console.log(`Serving ${handle.url}`);
     }
     catch (error) {
-        console.error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+        console.error(`Failed to start serve: ${error instanceof Error ? error.message : String(error)}`);
         process.exit(1);
     }
 });
-// Plan archive subcommand
-planCommand
-    .command('archive <plan-id>')
-    .description('Move a plan from active to archive directory')
-    .action(async (planId) => {
-    try {
-        const planIdNum = parseInt(planId, 10);
-        if (isNaN(planIdNum)) {
-            console.error(`Invalid plan ID: ${planId}. Must be a number.`);
-            process.exit(1);
-        }
-        const result = await (0, plan_1.archivePlan)(planIdNum);
-        if (result.success) {
-            process.exit(0);
-        }
-        else {
-            if (result.message) {
-                console.error(result.message);
-            }
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        console.error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
-    }
-});
-// Plan delete subcommand
-planCommand
-    .command('delete <plan-id>')
-    .description('Permanently delete a plan and all its tasks')
-    .action(async (planId) => {
-    try {
-        const planIdNum = parseInt(planId, 10);
-        if (isNaN(planIdNum)) {
-            console.error(`Invalid plan ID: ${planId}. Must be a number.`);
-            process.exit(1);
-        }
-        const result = await (0, plan_1.deletePlan)(planIdNum);
-        if (result.success) {
-            process.exit(0);
-        }
-        else {
-            if (result.message) {
-                console.error(result.message);
-            }
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        console.error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
-    }
-});
-// Backward compatibility: plan <id> as shorthand for plan show <id>
-planCommand
-    .argument('[plan-id]', 'Plan ID to display (shorthand for show subcommand)')
-    .action(async (planId) => {
-    // Only handle if planId is provided and no subcommand was matched
-    if (planId) {
-        try {
-            const planIdNum = parseInt(planId, 10);
-            if (isNaN(planIdNum)) {
-                console.error(`Invalid plan ID: ${planId}. Must be a number.`);
-                process.exit(1);
-            }
-            const result = await (0, plan_1.showPlan)(planIdNum);
-            if (result.success) {
-                process.exit(0);
-            }
-            else {
-                if (result.message) {
-                    console.error(result.message);
-                }
-                process.exit(1);
-            }
-        }
-        catch (error) {
-            console.error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
-            process.exit(1);
-        }
-    }
-});
 // Error handling for unknown commands
 program.on('command:*', async (operands) => {
     console.error(`Unknown command: ${operands[0]}`);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA;;;;;GAKG;;AAEH,yCAAoC;AACpC,mCAA+B;AAE/B,uCAAoE;AACpE,2CAA+D;AAE/D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;AAEhG,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,sCAAsC,CAAC;KACnD,cAAc,CACb,qBAAqB,EACrB,6FAA6F,CAC9F;KACA,MAAM,CACL,gCAAgC,EAChC,uEAAuE,CACxE;KACA,MAAM,CAAC,SAAS,EAAE,6CAA6C,CAAC;KAChE,MAAM,CAAC,KAAK,EAAE,OAAoB,EAAE,EAAE;IACrC,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,MAAM,GAAG,MAAM,IAAA,YAAI,EAAC,OAAO,CAAC,CAAC;QAEnC,6CAA6C;QAC7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,kFAAkF,CAAC;KAC/F,MAAM,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC;KAC5C,MAAM,CAAC,WAAW,EAAE,kCAAkC,CAAC;KACvD,MAAM,CAAC,oBAAoB,EAAE,mCAAmC,CAAC;KACjE,MAAM,CAAC,KAAK,EAAE,IAAyD,EAAE,EAAE;IAC1E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAA,2BAAoB,EAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACrE,IAAI,IAAA,qBAAc,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAW,EAAC;YAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAA,yBAAgB,GAAE;SAC9B,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,sCAAsC;AACtC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;IACvC,OAAO,CAAC,KAAK,CAAC,oBAAoB,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,+BAA+B;AAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,sCAAsC;AACtC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/serve/archive.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Archive operation for `npx strikethroo serve`.
+ *
+ * The serve web app is a read-only viewer over `.ai/strikethroo/` with exactly
+ * one sanctioned mutation: moving a plan that has reached the derived `done`
+ * state from `plans/NN--slug/` to `archive/NN--slug/`. This module is that
+ * mutation's authoritative guard — a single, HTTP-free function the route
+ * handler and the tests both call.
+ *
+ * It validates three preconditions, in order — the plan exists, currently lives
+ * under `plans/` (not already archived), and is `done` per the derived state in
+ * `workspace-model.ts` — then performs a single atomic `fs.rename` of the whole
+ * plan directory. It never deletes files, never edits file contents, and never
+ * falls back to a non-atomic copy-then-delete. Expected precondition failures
+ * are returned as a typed result, not thrown; only an unexpected filesystem
+ * error surfaces as the `fs-error` variant. Node built-ins only.
+ */
+import { PlanDetail } from './workspace-model';
+/**
+ * Outcome of an {@link archivePlan} call. A discriminated union mirroring the
+ * serve layer's existing result convention (see `self-review.ts`): callers map
+ * `reason` to HTTP status codes without re-deriving anything.
+ */
+export type ArchiveResult = {
+    ok: true;
+    plan: PlanDetail;
+} | {
+    ok: false;
+    reason: 'not-found' | 'already-archived' | 'not-done' | 'destination-exists' | 'fs-error';
+    message: string;
+};
+/**
+ * Validates the archive preconditions for plan `planId` under `root` (the
+ * absolute `.ai/strikethroo` directory) and, if they pass, atomically renames
+ * its directory from `plans/` into `archive/`, returning the refreshed model.
+ *
+ * On any precondition failure it performs zero filesystem changes and returns a
+ * typed failure with an actionable message. The only write it performs beyond
+ * the rename is creating the `archive/` directory if it does not yet exist,
+ * which is required for the rename's destination parent to resolve.
+ */
+export declare const archivePlan: (root: string, planId: number) => Promise<ArchiveResult>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/serve/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/serve/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAiB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC9B;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,WAAW,GAAG,kBAAkB,GAAG,UAAU,GAAG,oBAAoB,GAAG,UAAU,CAAC;IAC1F,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAU,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,aAAa,CA6DrF,CAAC"}

package/dist/serve/archive.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Archive operation for `npx strikethroo serve`.
+ *
+ * The serve web app is a read-only viewer over `.ai/strikethroo/` with exactly
+ * one sanctioned mutation: moving a plan that has reached the derived `done`
+ * state from `plans/NN--slug/` to `archive/NN--slug/`. This module is that
+ * mutation's authoritative guard — a single, HTTP-free function the route
+ * handler and the tests both call.
+ *
+ * It validates three preconditions, in order — the plan exists, currently lives
+ * under `plans/` (not already archived), and is `done` per the derived state in
+ * `workspace-model.ts` — then performs a single atomic `fs.rename` of the whole
+ * plan directory. It never deletes files, never edits file contents, and never
+ * falls back to a non-atomic copy-then-delete. Expected precondition failures
+ * are returned as a typed result, not thrown; only an unexpected filesystem
+ * error surfaces as the `fs-error` variant. Node built-ins only.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archivePlan = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const workspace_model_1 = require("./workspace-model");
+/**
+ * Validates the archive preconditions for plan `planId` under `root` (the
+ * absolute `.ai/strikethroo` directory) and, if they pass, atomically renames
+ * its directory from `plans/` into `archive/`, returning the refreshed model.
+ *
+ * On any precondition failure it performs zero filesystem changes and returns a
+ * typed failure with an actionable message. The only write it performs beyond
+ * the rename is creating the `archive/` directory if it does not yet exist,
+ * which is required for the rename's destination parent to resolve.
+ */
+const archivePlan = async (root, planId) => {
+    const detail = (0, workspace_model_1.getPlanDetail)(root, planId);
+    if (!detail) {
+        return {
+            ok: false,
+            reason: 'not-found',
+            message: `Plan ${planId} was not found.`,
+        };
+    }
+    if (detail.archived) {
+        return {
+            ok: false,
+            reason: 'already-archived',
+            message: `Plan ${planId} is already archived.`,
+        };
+    }
+    if (detail.state !== 'done') {
+        return {
+            ok: false,
+            reason: 'not-done',
+            message: `Plan ${planId} is not in the done state and cannot be archived.`,
+        };
+    }
+    const src = detail.dir;
+    const dest = path.join(root, 'archive', detail.name);
+    if (fs.existsSync(dest)) {
+        return {
+            ok: false,
+            reason: 'destination-exists',
+            message: `Plan ${planId} cannot be archived: a directory already exists at its archive location.`,
+        };
+    }
+    try {
+        // The destination's parent (`archive/`) must exist for the rename to land.
+        // Creating it is benign and never touches plan contents.
+        await fs.promises.mkdir(path.join(root, 'archive'), { recursive: true });
+        await fs.promises.rename(src, dest);
+    }
+    catch {
+        return {
+            ok: false,
+            reason: 'fs-error',
+            message: `Plan ${planId} could not be archived due to a filesystem error.`,
+        };
+    }
+    // Re-resolve so the returned model reflects the new archive/ location.
+    const moved = (0, workspace_model_1.getPlanDetail)(root, planId);
+    if (!moved) {
+        return {
+            ok: false,
+            reason: 'fs-error',
+            message: `Plan ${planId} was moved but could not be re-read.`,
+        };
+    }
+    return { ok: true, plan: moved };
+};
+exports.archivePlan = archivePlan;
+//# sourceMappingURL=archive.js.map

package/dist/serve/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/serve/archive.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,uDAA8D;AAe9D;;;;;;;;;GASG;AACI,MAAM,WAAW,GAAG,KAAK,EAAE,IAAY,EAAE,MAAc,EAA0B,EAAE;IACxF,MAAM,MAAM,GAAG,IAAA,+BAAa,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,QAAQ,MAAM,iBAAiB;SACzC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,kBAAkB;YAC1B,OAAO,EAAE,QAAQ,MAAM,uBAAuB;SAC/C,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,QAAQ,MAAM,mDAAmD;SAC3E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,oBAAoB;YAC5B,OAAO,EAAE,QAAQ,MAAM,0EAA0E;SAClG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,2EAA2E;QAC3E,yDAAyD;QACzD,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,QAAQ,MAAM,mDAAmD;SAC3E,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,MAAM,KAAK,GAAG,IAAA,+BAAa,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,QAAQ,MAAM,sCAAsC;SAC9D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC,CAAC;AA7DW,QAAA,WAAW,eA6DtB"}

package/dist/serve/derivation.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Per-plan derivation layer for the serve data layer.
+ *
+ * Scans a plan directory's `tasks/*.md` into structured task records, computes
+ * the derived plan lifecycle state (`drafted` -> `ready` -> `doing` -> `done`)
+ * with done/total counts, and resolves execution phases (from a blueprint
+ * document when present, otherwise inferred from task `group` + `dependencies`).
+ *
+ * Everything is synchronous and read-only: file reads only, no watches, no
+ * network, no writes.
+ */
+import { type MarkdownSection } from './markdown';
+/** A single task parsed from a plan's `tasks/` directory. */
+export interface Task {
+    id: number | undefined;
+    /** Task title (first `# ` heading), falling back to the filename. */
+    name: string;
+    group: string | undefined;
+    dependencies: number[];
+    status: string | undefined;
+    skills: string[];
+    /** Source filename (basename). */
+    file: string;
+    /** Raw markdown body after frontmatter. */
+    body: string;
+    /** Ordered named `##` sections of the body (via `sectionBody`, mirrors
+     * `PlanDetail.sections`). Additive to `body`, which is retained. */
+    sections: MarkdownSection[];
+}
+/** Derived lifecycle state of a plan. */
+export type PlanState = 'drafted' | 'ready' | 'doing' | 'done';
+/** Derived state plus done/total counts. */
+export interface DerivedState {
+    state: PlanState;
+    done: number;
+    total: number;
+}
+/** An execution phase: an ordered group of task ids that run together. */
+export interface Phase {
+    /** 1-based phase index. */
+    index: number;
+    /** Optional descriptive name (from a blueprint doc). */
+    name?: string;
+    /** Task ids scheduled in this phase. */
+    taskIds: number[];
+    /** True when the phase holds more than one task. */
+    parallel: boolean;
+}
+/** Reads a plan directory's `tasks/*.md` into structured records. Missing dir -> []. */
+export declare const scanTasks: (planDir: string) => Task[];
+/**
+ * Computes the derived plan state and counts. Never throws on unknown statuses.
+ *
+ * - empty list -> `drafted`
+ * - tasks present, none started or done -> `ready`
+ * - all done -> `done`
+ * - otherwise -> `doing`
+ */
+export declare const deriveState: (tasks: Task[]) => DerivedState;
+/**
+ * Parses phases from an "## Execution Blueprint" section if the plan body
+ * contains one. Returns undefined when no blueprint section is present.
+ */
+export declare const parseBlueprintPhases: (planBody: string) => Phase[] | undefined;
+/**
+ * Infers phases from tasks by grouping on satisfied dependencies. Tasks whose
+ * dependencies are all already emitted (or absent from the task set) form a
+ * phase; dependents fall into later phases. Best-effort and cycle-safe: if no
+ * progress is made, the remaining tasks are emitted as a final phase rather
+ * than looping forever. Never throws.
+ */
+export declare const inferPhases: (tasks: Task[]) => Phase[];
+/**
+ * Resolves a plan's phases: parses a blueprint document's phase list when the
+ * plan body contains one, otherwise infers phases from task dependencies.
+ */
+export declare const resolvePhases: (planBody: string, tasks: Task[]) => Phase[];
+//# sourceMappingURL=derivation.d.ts.map

package/dist/serve/derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derivation.d.ts","sourceRoot":"","sources":["../../src/serve/derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAEpB,6DAA6D;AAC7D,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb;wEACoE;IACpE,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE/D,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,KAAK;IACpB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD,wFAAwF;AACxF,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,IAAI,EAuC/C,CAAC;AASF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,IAAI,EAAE,KAAG,YA4B3C,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,KAAK,EAAE,GAAG,SA6CjE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,IAAI,EAAE,KAAG,KAAK,EA0BhD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,IAAI,EAAE,KAAG,KAAK,EAIpE,CAAC"}