@agentic-coding-framework/orchestrator-core 0.2.0 → 0.3.1

package/dist/__tests__/state.test.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const state_1 = require("../state");
+(0, vitest_1.describe)("state", () => {
+    let tempDir;
+    (0, vitest_1.beforeEach)(() => {
+        tempDir = (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), "state-test-"));
+    });
+    (0, vitest_1.afterEach)(() => {
+        (0, fs_1.rmSync)(tempDir, { recursive: true, force: true });
+    });
+    (0, vitest_1.describe)("createInitialState", () => {
+        (0, vitest_1.it)("creates state with correct defaults", () => {
+            const state = (0, state_1.createInitialState)("my-app");
+            (0, vitest_1.expect)(state.project).toBe("my-app");
+            (0, vitest_1.expect)(state.step).toBe("bootstrap");
+            (0, vitest_1.expect)(state.attempt).toBe(1);
+            (0, vitest_1.expect)(state.status).toBe("pending");
+            (0, vitest_1.expect)(state.reason).toBeNull();
+            (0, vitest_1.expect)(state.story).toBeNull();
+        });
+    });
+    (0, vitest_1.describe)("validate", () => {
+        (0, vitest_1.it)("accepts valid state", () => {
+            const state = (0, state_1.createInitialState)("app");
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).not.toThrow();
+        });
+        (0, vitest_1.it)("rejects empty project", () => {
+            const state = (0, state_1.createInitialState)("");
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).toThrow("project is required");
+        });
+        (0, vitest_1.it)("rejects invalid step", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.step = "invalid";
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).toThrow("Invalid step");
+        });
+        (0, vitest_1.it)("rejects invalid status", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "banana";
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).toThrow("Invalid status");
+        });
+        (0, vitest_1.it)("rejects invalid reason (non-null)", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.reason = "bad_reason";
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).toThrow("Invalid reason");
+        });
+        (0, vitest_1.it)("accepts null reason", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.reason = null;
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).not.toThrow();
+        });
+        (0, vitest_1.it)("accepts valid reason", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.reason = "needs_clarification";
+            (0, vitest_1.expect)(() => (0, state_1.validate)(state)).not.toThrow();
+        });
+    });
+    (0, vitest_1.describe)("sanitize", () => {
+        (0, vitest_1.it)('auto-corrects "passing" → "pass"', () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "passing";
+            const warnings = (0, state_1.sanitize)(state);
+            (0, vitest_1.expect)(state.status).toBe("pass");
+            (0, vitest_1.expect)(warnings).toHaveLength(1);
+            (0, vitest_1.expect)(warnings[0]).toContain("passing");
+            (0, vitest_1.expect)(warnings[0]).toContain("pass");
+        });
+        (0, vitest_1.it)('auto-corrects "failed" → "failing"', () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "failed";
+            const warnings = (0, state_1.sanitize)(state);
+            (0, vitest_1.expect)(state.status).toBe("failing");
+            (0, vitest_1.expect)(warnings.length).toBeGreaterThanOrEqual(1);
+        });
+        (0, vitest_1.it)("clears reason when status is not failing", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "pass";
+            state.reason = "needs_clarification";
+            const warnings = (0, state_1.sanitize)(state);
+            (0, vitest_1.expect)(state.reason).toBeNull();
+            (0, vitest_1.expect)(warnings).toHaveLength(1);
+            (0, vitest_1.expect)(warnings[0]).toContain("Cleared reason");
+        });
+        (0, vitest_1.it)("clears invalid reason (long text) when status is failing", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "failing";
+            state.reason =
+                "This is a long summary of what happened during the task execution that should not be here";
+            const warnings = (0, state_1.sanitize)(state);
+            (0, vitest_1.expect)(state.reason).toBeNull();
+            (0, vitest_1.expect)(warnings).toHaveLength(1);
+            (0, vitest_1.expect)(warnings[0]).toContain("Cleared invalid reason");
+        });
+        (0, vitest_1.it)("preserves valid reason when status is failing", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "failing";
+            state.reason = "constitution_violation";
+            const warnings = (0, state_1.sanitize)(state);
+            (0, vitest_1.expect)(state.reason).toBe("constitution_violation");
+            (0, vitest_1.expect)(warnings).toHaveLength(0);
+        });
+        (0, vitest_1.it)("returns empty warnings for clean state", () => {
+            const state = (0, state_1.createInitialState)("app");
+            const warnings = (0, state_1.sanitize)(state);
+            (0, vitest_1.expect)(warnings).toHaveLength(0);
+        });
+        (0, vitest_1.it)("readState auto-corrects and persists fix", () => {
+            const state = (0, state_1.createInitialState)("app");
+            // Write a valid state first, then manually corrupt it
+            (0, state_1.writeState)(tempDir, state);
+            // Read the raw file path and write corrupted JSON
+            const { readFileSync, writeFileSync } = require("fs");
+            const { join } = require("path");
+            const path = join(tempDir, ".ai", "STATE.json");
+            const raw = JSON.parse(readFileSync(path, "utf-8"));
+            raw.status = "passing";
+            writeFileSync(path, JSON.stringify(raw, null, 2) + "\n", "utf-8");
+            // readState should auto-correct
+            const loaded = (0, state_1.readState)(tempDir);
+            (0, vitest_1.expect)(loaded.status).toBe("pass");
+            // Re-read raw file to verify it was persisted
+            const fixed = JSON.parse(readFileSync(path, "utf-8"));
+            (0, vitest_1.expect)(fixed.status).toBe("pass");
+        });
+    });
+    (0, vitest_1.describe)("read/write round-trip", () => {
+        (0, vitest_1.it)("writes and reads back identical state", () => {
+            const original = (0, state_1.createInitialState)("round-trip-app");
+            original.story = "US-001";
+            original.step = "impl";
+            original.attempt = 3;
+            original.status = "failing";
+            original.reason = "constitution_violation";
+            (0, state_1.writeState)(tempDir, original);
+            const loaded = (0, state_1.readState)(tempDir);
+            (0, vitest_1.expect)(loaded).toEqual(original);
+        });
+        (0, vitest_1.it)("creates .ai/ directory if missing", () => {
+            const state = (0, state_1.createInitialState)("new-project");
+            (0, state_1.writeState)(tempDir, state);
+            const loaded = (0, state_1.readState)(tempDir);
+            (0, vitest_1.expect)(loaded.project).toBe("new-project");
+        });
+        (0, vitest_1.it)("throws when reading non-existent STATE.json", () => {
+            (0, vitest_1.expect)(() => (0, state_1.readState)(tempDir)).toThrow("STATE.json not found");
+        });
+    });
+    (0, vitest_1.describe)("initState", () => {
+        (0, vitest_1.it)("creates new state file", () => {
+            const { created, state } = (0, state_1.initState)(tempDir, "init-app");
+            (0, vitest_1.expect)(created).toBe(true);
+            (0, vitest_1.expect)(state.project).toBe("init-app");
+        });
+        (0, vitest_1.it)("skips if already exists", () => {
+            (0, state_1.initState)(tempDir, "init-app");
+            const { created, state } = (0, state_1.initState)(tempDir, "different-name");
+            (0, vitest_1.expect)(created).toBe(false);
+            (0, vitest_1.expect)(state.project).toBe("init-app"); // original preserved
+        });
+    });
+    (0, vitest_1.describe)("isTimedOut", () => {
+        (0, vitest_1.it)("returns false when not running", () => {
+            const state = (0, state_1.createInitialState)("app");
+            (0, vitest_1.expect)((0, state_1.isTimedOut)(state)).toBe(false);
+        });
+        (0, vitest_1.it)("returns false when within timeout", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "running";
+            state.dispatched_at = new Date().toISOString();
+            state.timeout_min = 10;
+            (0, vitest_1.expect)((0, state_1.isTimedOut)(state)).toBe(false);
+        });
+        (0, vitest_1.it)("returns true when past timeout", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.status = "running";
+            state.dispatched_at = new Date(Date.now() - 15 * 60_000).toISOString();
+            state.timeout_min = 10;
+            (0, vitest_1.expect)((0, state_1.isTimedOut)(state)).toBe(true);
+        });
+    });
+    (0, vitest_1.describe)("isMaxedOut", () => {
+        (0, vitest_1.it)("returns true at max", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.attempt = 5;
+            state.max_attempts = 5;
+            (0, vitest_1.expect)((0, state_1.isMaxedOut)(state)).toBe(true);
+        });
+        (0, vitest_1.it)("returns false below max", () => {
+            const state = (0, state_1.createInitialState)("app");
+            state.attempt = 2;
+            state.max_attempts = 5;
+            (0, vitest_1.expect)((0, state_1.isMaxedOut)(state)).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)("markRunning", () => {
+        (0, vitest_1.it)("sets status and timestamp", () => {
+            const state = (0, state_1.createInitialState)("app");
+            const running = (0, state_1.markRunning)(state);
+            (0, vitest_1.expect)(running.status).toBe("running");
+            (0, vitest_1.expect)(running.dispatched_at).toBeTruthy();
+            (0, vitest_1.expect)(running.completed_at).toBeNull();
+            (0, vitest_1.expect)(running.reason).toBeNull();
+        });
+        (0, vitest_1.it)("does not mutate original", () => {
+            const state = (0, state_1.createInitialState)("app");
+            (0, state_1.markRunning)(state);
+            (0, vitest_1.expect)(state.status).toBe("pending");
+        });
+    });
+    (0, vitest_1.describe)("markCompleted", () => {
+        (0, vitest_1.it)("sets status and timestamp", () => {
+            const state = (0, state_1.markRunning)((0, state_1.createInitialState)("app"));
+            const done = (0, state_1.markCompleted)(state, "pass");
+            (0, vitest_1.expect)(done.status).toBe("pass");
+            (0, vitest_1.expect)(done.completed_at).toBeTruthy();
+        });
+        (0, vitest_1.it)("sets reason on failure", () => {
+            const state = (0, state_1.markRunning)((0, state_1.createInitialState)("app"));
+            const failed = (0, state_1.markCompleted)(state, "failing", "needs_clarification");
+            (0, vitest_1.expect)(failed.status).toBe("failing");
+            (0, vitest_1.expect)(failed.reason).toBe("needs_clarification");
+        });
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/__tests__/state.test.js.map

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

package/dist/auto.d.ts

@@ -10,56 +10,6 @@
  *
  * and gets back a JSON result with an `action` field telling it what happened.
  */
-import type { Reason } from "./state";
-import { type ProjectStatus, type FrameworkDetection, type ProjectEntry } from "./dispatch";
-export type AutoResult = {
-    action: "query";
-    data: ProjectStatus;
-    memory?: string;
-    handoff?: string;
-} | {
-    action: "dispatched";
-    step: string;
-    attempt: number;
-    prompt: string;
-    fw_lv: number;
-} | {
-    action: "done";
-    story: string;
-    summary: string;
-} | {
-    action: "needs_human";
-    step: string;
-    message: string;
-} | {
-    action: "blocked";
-    step: string;
-    reason: string;
-} | {
-    action: "already_running";
-    step: string;
-    elapsed_min: number;
-} | {
-    action: "timeout";
-    step: string;
-    elapsed_min: number;
-} | {
-    action: "approved";
-    note?: string;
-} | {
-    action: "rejected";
-    reason: string;
-    note?: string;
-} | {
-    action: "detected";
-    framework: FrameworkDetection;
-} | {
-    action: "listed";
-    projects: ProjectEntry[];
-} | {
-    action: "error";
-    message: string;
-};
 type Intent = {
     type: "query";
 } | {
@@ -67,7 +17,7 @@ type Intent = {
     note?: string;
 } | {
     type: "reject";
-    reason: Reason;
+    reason: string;
     note?: string;
 } | {
     type: "start_story";
@@ -94,12 +44,7 @@ export declare function classify(message: string): Intent;
  *
  * Takes a project root and a raw user message, classifies the intent,
  * and routes to the appropriate function. Returns a JSON-serializable result.
- *
- * Usage:
- *   orchestrator auto ./project "目前狀態如何"
- *   orchestrator auto ./project "繼續"
- *   orchestrator auto ./project "幫我 refactor auth module"
- *   orchestrator auto ./project "approve"
  */
-export declare function auto(projectRoot: string, message: string): AutoResult;
+export declare function auto(projectRoot: string, message: string): Record<string, unknown>;
 export {};
+//# sourceMappingURL=auto.d.ts.map

package/dist/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,KAAK,MAAM,GACP;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAI5C;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsDhD;AA6ED;;;;;GAKG;AACH,wBAAgB,IAAI,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8EzB"}

package/dist/auto.js

@@ -17,6 +17,8 @@ exports.auto = auto;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const dispatch_1 = require("./dispatch");
+const state_1 = require("./state");
+// ─── Classifier ──────────────────────────────────────────────────────────────
 /**
  * Classify a raw user message into an intent.
  * Pure keyword/regex matching — zero LLM tokens.
@@ -28,18 +30,20 @@ function classify(message) {
     const lower = msg.toLowerCase();
     // ── Approve ──
     if (/^(approve|核准|lgtm|通過|approved|ok\s*$)/i.test(msg)) {
-        const note = msg.replace(/^(approve|核准|lgtm|通過|approved|ok)\s*/i, "").trim() || undefined;
+        const note = msg.replace(/^(approve|核准|lgtm|通過|approved|ok)\s*/i, "").trim() ||
+            undefined;
         return { type: "approve", note };
     }
     // ── Reject ──
     if (/^(reject|退回|不行|rejected)/i.test(msg)) {
-        const rest = msg.replace(/^(reject|退回|不行|rejected)\s*/i, "").trim();
+        const rest = msg
+            .replace(/^(reject|退回|不行|rejected)\s*/i, "")
+            .trim();
         const { reason, note } = extractRejectReason(rest);
         return { type: "reject", reason, note };
     }
     // ── Start Story (must be before query — "start US-007" is not a query) ──
-    const storyMatch = msg.match(/(?:start\s*story|開始\s*story|開新\s*story|start)\s+(US-\d+)/i)
-        || msg.match(/^(US-\d+)/i);
+    const storyMatch = msg.match(/(?:start\s*story|開始\s*story|開新\s*story|start)\s+(US-\d+)/i) || msg.match(/^(US-\d+)/i);
     if (storyMatch) {
         return { type: "start_story", storyId: storyMatch[1] };
     }
@@ -65,15 +69,42 @@ function classify(message) {
 /** Check if the message is a read-only query */
 function isQuery(lower) {
     const queryPatterns = [
-        /狀態/, /status/, /什麼步驟/, /what\s*step/, /which\s*step/,
-        /測試/, /tests?/, /進度/, /progress/,
-        /還有什麼/, /what's\s*next/, /what\s*next/, /what's\s*left/,
-        /history/, /歷史/, /上次/, /last\s*(session|time)/,
-        /怎麼樣/, /how.*project/, /how.*going/,
-        /目前/, /current/, /看一下/, /看看/, /查一下/, /check\s*status/,
-        /哪個步驟/, /卡住/, /blocked/, /why.*block/,
-        /summary/, /摘要/, /report/, /報告/,
-        /打開/, /open\s*project/,
+        /狀態/,
+        /status/,
+        /什麼步驟/,
+        /what\s*step/,
+        /which\s*step/,
+        /測試/,
+        /tests?/,
+        /進度/,
+        /progress/,
+        /還有什麼/,
+        /what's\s*next/,
+        /what\s*next/,
+        /what's\s*left/,
+        /history/,
+        /歷史/,
+        /上次/,
+        /last\s*(session|time)/,
+        /怎麼樣/,
+        /how.*project/,
+        /how.*going/,
+        /目前/,
+        /current/,
+        /看一下/,
+        /看看/,
+        /查一下/,
+        /check\s*status/,
+        /哪個步驟/,
+        /卡住/,
+        /blocked/,
+        /why.*block/,
+        /summary/,
+        /摘要/,
+        /report/,
+        /報告/,
+        /打開/,
+        /open\s*project/,
     ];
     return queryPatterns.some((p) => p.test(lower));
 }
@@ -81,15 +112,15 @@ function isQuery(lower) {
 function extractRejectReason(rest) {
     const reasonMap = {
         clarification: "needs_clarification",
-        需要說明: "needs_clarification",
-        不清楚: "needs_clarification",
+        "需要說明": "needs_clarification",
+        "不清楚": "needs_clarification",
         constitution: "constitution_violation",
-        架構違反: "constitution_violation",
+        "架構違反": "constitution_violation",
         scope: "scope_warning",
-        範圍: "scope_warning",
+        "範圍": "scope_warning",
         nfr: "nfr_missing",
         timeout: "test_timeout",
-        超時: "test_timeout",
+        "超時": "test_timeout",
     };
     for (const [keyword, reason] of Object.entries(reasonMap)) {
         if (rest.toLowerCase().includes(keyword)) {
@@ -106,12 +137,6 @@ function extractRejectReason(rest) {
  *
  * Takes a project root and a raw user message, classifies the intent,
  * and routes to the appropriate function. Returns a JSON-serializable result.
- *
- * Usage:
- *   orchestrator auto ./project "目前狀態如何"
- *   orchestrator auto ./project "繼續"
- *   orchestrator auto ./project "幫我 refactor auth module"
- *   orchestrator auto ./project "approve"
  */
 function auto(projectRoot, message) {
     const intent = classify(message);
@@ -128,22 +153,67 @@ function auto(projectRoot, message) {
             case "continue":
                 return handleDispatch(projectRoot);
             case "detect":
-                return { action: "detected", framework: (0, dispatch_1.detectFramework)(projectRoot) };
+                return {
+                    action: "detected",
+                    framework: (0, dispatch_1.detectFramework)(projectRoot),
+                };
             case "list":
-                // Use projectRoot as workspace root for listing
-                return { action: "listed", projects: (0, dispatch_1.listProjects)(projectRoot) };
+                return {
+                    action: "listed",
+                    projects: (0, dispatch_1.listProjects)(projectRoot),
+                };
             case "custom":
                 return handleCustom(projectRoot, intent.instruction);
         }
     }
     catch (err) {
-        return { action: "error", message: err.message ?? String(err) };
+        const msg = err.message ?? String(err);
+        // Defense-in-depth: if validation failed due to corrupted STATE.json,
+        // attempt sanitize + retry once before giving up.
+        if (/Invalid (status|reason)/.test(msg) &&
+            (intent.type === "continue" ||
+                intent.type === "query" ||
+                intent.type === "approve")) {
+            try {
+                const state = (() => {
+                    const { readFileSync } = require("fs");
+                    const { join } = require("path");
+                    const raw = readFileSync(join(projectRoot, ".ai", "STATE.json"), "utf-8");
+                    return JSON.parse(raw);
+                })();
+                const warnings = (0, state_1.sanitize)(state);
+                if (warnings.length > 0) {
+                    (0, state_1.writeState)(projectRoot, state);
+                    // Retry the original intent
+                    switch (intent.type) {
+                        case "continue":
+                            return {
+                                ...wrapDispatchResult((0, dispatch_1.dispatch)(projectRoot)),
+                                _sanitized: warnings,
+                            };
+                        case "query":
+                            return { ...handleQuery(projectRoot), _sanitized: warnings };
+                        case "approve":
+                            return {
+                                ...handleApprove(projectRoot, intent.note),
+                                _sanitized: warnings,
+                            };
+                    }
+                }
+            }
+            catch {
+                // sanitize recovery also failed — fall through to original error
+            }
+        }
+        return {
+            action: "error",
+            message: msg,
+        };
     }
 }
 // ─── Intent Handlers ────────────────────────────────────────────────────────
 function handleQuery(projectRoot) {
     const data = (0, dispatch_1.queryProjectStatus)(projectRoot);
-    // Attach memory and handoff content if available
     let memory;
     let handoff;
     const memoryPath = (0, path_1.join)(projectRoot, "PROJECT_MEMORY.md");
@@ -182,7 +252,6 @@ function handleDispatch(projectRoot) {
     return wrapDispatchResult((0, dispatch_1.dispatch)(projectRoot));
 }
 function handleCustom(projectRoot, instruction) {
-    // Check if there's an agent-teams keyword
     const agentTeams = /agent.?teams?|平行|多\s*agent|agents/i.test(instruction);
     (0, dispatch_1.startCustom)(projectRoot, instruction, { agentTeams });
     return wrapDispatchResult((0, dispatch_1.dispatch)(projectRoot));
@@ -199,14 +268,35 @@ function wrapDispatchResult(result) {
                 fw_lv: result.fw_lv,
             };
         case "done":
-            return { action: "done", story: result.story, summary: result.summary };
+            return {
+                action: "done",
+                story: result.story,
+                summary: result.summary,
+            };
         case "needs_human":
-            return { action: "needs_human", step: result.step, message: result.message };
+            return {
+                action: "needs_human",
+                step: result.step,
+                message: result.message,
+            };
         case "blocked":
-            return { action: "blocked", step: result.step, reason: result.reason };
+            return {
+                action: "blocked",
+                step: result.step,
+                reason: result.reason,
+            };
         case "already_running":
-            return { action: "already_running", step: result.step, elapsed_min: result.elapsed_min };
+            return {
+                action: "already_running",
+                step: result.step,
+                elapsed_min: result.elapsed_min,
+            };
         case "timeout":
-            return { action: "timeout", step: result.step, elapsed_min: result.elapsed_min };
+            return {
+                action: "timeout",
+                step: result.step,
+                elapsed_min: result.elapsed_min,
+            };
     }
 }
+//# sourceMappingURL=auto.js.map

package/dist/auto.js.map

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

package/dist/cli.d.ts

@@ -7,9 +7,11 @@
  *   start-story <project-root> <story-id>       Begin a new User Story (micro-waterfall)
  *   start-custom <project-root> <instruction>   Begin a custom ad-hoc task
  *   dispatch <project-root>                     Dispatch next step (prints prompt)
+ *   peek <project-root>                         [FIX P1] Read-only dispatch preview
  *   apply-handoff <project-root>                Parse HANDOFF.md → update STATE
  *   approve <project-root> [note]               Approve review step
  *   reject <project-root> <reason> [note]       Reject review step
  *   status <project-root>                       Print current STATE.json
  */
 export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}