@agentic-coding-framework/orchestrator-core 0.1.2 → 0.3.0

package/dist/__tests__/state.test.js

@@ -0,0 +1,161 @@
+"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)("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

@@ -0,0 +1,50 @@
+/**
+ * auto.ts — Unified entry point for OpenClaw integration
+ *
+ * Classifies a raw user message into an action (query, dispatch, approve, etc.)
+ * using keyword-based matching (zero LLM tokens), then routes to the appropriate
+ * orchestrator function.
+ *
+ * OpenClaw only needs to call:
+ *   orchestrator auto <project-root> "<user message>"
+ *
+ * and gets back a JSON result with an `action` field telling it what happened.
+ */
+type Intent = {
+    type: "query";
+} | {
+    type: "approve";
+    note?: string;
+} | {
+    type: "reject";
+    reason: string;
+    note?: string;
+} | {
+    type: "start_story";
+    storyId: string;
+} | {
+    type: "continue";
+} | {
+    type: "detect";
+} | {
+    type: "list";
+} | {
+    type: "custom";
+    instruction: string;
+};
+/**
+ * Classify a raw user message into an intent.
+ * Pure keyword/regex matching — zero LLM tokens.
+ *
+ * Priority order matters: more specific patterns are checked first.
+ */
+export declare function classify(message: string): Intent;
+/**
+ * Unified orchestrator entry point.
+ *
+ * Takes a project root and a raw user message, classifies the intent,
+ * and routes to the appropriate function. Returns a JSON-serializable result.
+ */
+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;AAiBH,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,CAkCzB"}

package/dist/auto.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * auto.ts — Unified entry point for OpenClaw integration
+ *
+ * Classifies a raw user message into an action (query, dispatch, approve, etc.)
+ * using keyword-based matching (zero LLM tokens), then routes to the appropriate
+ * orchestrator function.
+ *
+ * OpenClaw only needs to call:
+ *   orchestrator auto <project-root> "<user message>"
+ *
+ * and gets back a JSON result with an `action` field telling it what happened.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classify = classify;
+exports.auto = auto;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const dispatch_1 = require("./dispatch");
+// ─── Classifier ──────────────────────────────────────────────────────────────
+/**
+ * Classify a raw user message into an intent.
+ * Pure keyword/regex matching — zero LLM tokens.
+ *
+ * Priority order matters: more specific patterns are checked first.
+ */
+function classify(message) {
+    const msg = message.trim();
+    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;
+        return { type: "approve", note };
+    }
+    // ── Reject ──
+    if (/^(reject|退回|不行|rejected)/i.test(msg)) {
+        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);
+    if (storyMatch) {
+        return { type: "start_story", storyId: storyMatch[1] };
+    }
+    // ── List projects ──
+    if (/列出|list.*project|所有專案|all\s*projects/i.test(lower)) {
+        return { type: "list" };
+    }
+    // ── Detect framework ──
+    if (/framework|有沒有用|adoption|detect/i.test(lower)) {
+        return { type: "detect" };
+    }
+    // ── Query (information requests — no code changes) ──
+    if (isQuery(lower)) {
+        return { type: "query" };
+    }
+    // ── Continue / Dispatch ──
+    if (/^(繼續|continue|dispatch|next|下一步|run|執行|go|proceed)\s*$/i.test(msg)) {
+        return { type: "continue" };
+    }
+    // ── Fallback: Custom task ──
+    return { type: "custom", instruction: msg };
+}
+/** 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/,
+    ];
+    return queryPatterns.some((p) => p.test(lower));
+}
+/** Extract reject reason from the rest of the message */
+function extractRejectReason(rest) {
+    const reasonMap = {
+        clarification: "needs_clarification",
+        "需要說明": "needs_clarification",
+        "不清楚": "needs_clarification",
+        constitution: "constitution_violation",
+        "架構違反": "constitution_violation",
+        scope: "scope_warning",
+        "範圍": "scope_warning",
+        nfr: "nfr_missing",
+        timeout: "test_timeout",
+        "超時": "test_timeout",
+    };
+    for (const [keyword, reason] of Object.entries(reasonMap)) {
+        if (rest.toLowerCase().includes(keyword)) {
+            const note = rest.replace(new RegExp(keyword, "i"), "").trim() || undefined;
+            return { reason, note };
+        }
+    }
+    // Default reason
+    return { reason: "needs_clarification", note: rest || undefined };
+}
+// ─── Main Entry Point ───────────────────────────────────────────────────────
+/**
+ * Unified orchestrator entry point.
+ *
+ * Takes a project root and a raw user message, classifies the intent,
+ * and routes to the appropriate function. Returns a JSON-serializable result.
+ */
+function auto(projectRoot, message) {
+    const intent = classify(message);
+    try {
+        switch (intent.type) {
+            case "query":
+                return handleQuery(projectRoot);
+            case "approve":
+                return handleApprove(projectRoot, intent.note);
+            case "reject":
+                return handleReject(projectRoot, intent.reason, intent.note);
+            case "start_story":
+                return handleStartStory(projectRoot, intent.storyId);
+            case "continue":
+                return handleDispatch(projectRoot);
+            case "detect":
+                return {
+                    action: "detected",
+                    framework: (0, dispatch_1.detectFramework)(projectRoot),
+                };
+            case "list":
+                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),
+        };
+    }
+}
+// ─── Intent Handlers ────────────────────────────────────────────────────────
+function handleQuery(projectRoot) {
+    const data = (0, dispatch_1.queryProjectStatus)(projectRoot);
+    let memory;
+    let handoff;
+    const memoryPath = (0, path_1.join)(projectRoot, "PROJECT_MEMORY.md");
+    if ((0, fs_1.existsSync)(memoryPath)) {
+        memory = (0, fs_1.readFileSync)(memoryPath, "utf-8").slice(0, 2000);
+    }
+    const handoffPath = (0, path_1.join)(projectRoot, ".ai", "HANDOFF.md");
+    if ((0, fs_1.existsSync)(handoffPath)) {
+        handoff = (0, fs_1.readFileSync)(handoffPath, "utf-8").slice(0, 2000);
+    }
+    return { action: "query", data, memory, handoff };
+}
+function handleApprove(projectRoot, note) {
+    try {
+        (0, dispatch_1.approveReview)(projectRoot, note);
+        return { action: "approved", note };
+    }
+    catch (err) {
+        return { action: "error", message: err.message };
+    }
+}
+function handleReject(projectRoot, reason, note) {
+    try {
+        (0, dispatch_1.rejectReview)(projectRoot, reason, note);
+        return { action: "rejected", reason, note };
+    }
+    catch (err) {
+        return { action: "error", message: err.message };
+    }
+}
+function handleStartStory(projectRoot, storyId) {
+    (0, dispatch_1.startStory)(projectRoot, storyId);
+    return wrapDispatchResult((0, dispatch_1.dispatch)(projectRoot));
+}
+function handleDispatch(projectRoot) {
+    return wrapDispatchResult((0, dispatch_1.dispatch)(projectRoot));
+}
+function handleCustom(projectRoot, instruction) {
+    const agentTeams = /agent.?teams?|平行|多\s*agent|agents/i.test(instruction);
+    (0, dispatch_1.startCustom)(projectRoot, instruction, { agentTeams });
+    return wrapDispatchResult((0, dispatch_1.dispatch)(projectRoot));
+}
+/** Convert DispatchResult to AutoResult */
+function wrapDispatchResult(result) {
+    switch (result.type) {
+        case "dispatched":
+            return {
+                action: "dispatched",
+                step: result.step,
+                attempt: result.attempt,
+                prompt: result.prompt,
+                fw_lv: result.fw_lv,
+            };
+        case "done":
+            return {
+                action: "done",
+                story: result.story,
+                summary: result.summary,
+            };
+        case "needs_human":
+            return {
+                action: "needs_human",
+                step: result.step,
+                message: result.message,
+            };
+        case "blocked":
+            return {
+                action: "blocked",
+                step: result.step,
+                reason: result.reason,
+            };
+        case "already_running":
+            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,
+            };
+    }
+}
+//# 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"}