@mingyuxu/core 0.1.0

package/dist/goal-loop.js

@@ -0,0 +1,96 @@
+/**
+ * 目标驱动构建循环（v2 架构）—— 收敛条件不是「走完相位」，而是「自评达到标准」。
+ *   build-attempt（拆规则/定方案/出候选） → 自评 → 达标? → 未达标则反思迭代重评 → 达标→交人(HITL)→冻结
+ * 与旧 BuildLoop 的区别：停机看自评体系（agent.selfEvaluate 返回 met），未达标走 agent.reflect 反思。
+ * build-attempt 阶段复用 advanceOnePhase（reconcile/预算/错误归约不重造）；自评+反思是新的外层循环。
+ */
+import { BudgetExceeded, LLMError } from "@mingyuxu/ai";
+import { advanceOnePhase, AWAITING_APPROVAL, FROZEN, BUDGET_EXCEEDED, LLM_ERROR } from "./loop.js";
+import { TERMINAL } from "./session.js";
+export const STANDARD_NOT_MET = "standard_not_met"; // 反思到顶仍未达自评标准（交人裁决）
+export const NEEDS_HUMAN_EVAL = "needs_human_eval"; // 无评测体系可判达标 → 只能交人
+const BUILD_PHASES = ["analyze", "observe", "propose"];
+export class GoalLoop {
+    agent;
+    policy;
+    constructor(agent, policy) {
+        this.agent = agent;
+        this.policy = policy;
+    }
+    async run(session, _opts = {}) {
+        const ws = this.agent.workspace;
+        // ── 冻结再入：达标后 session.phase="freeze"，批准后来到这里执行冻结 ──
+        if (session.phase === TERMINAL)
+            return this.stop(session, FROZEN, 0);
+        if (session.phase === "freeze") {
+            if (!session.approved)
+                return this.stop(session, AWAITING_APPROVAL, 0);
+            try {
+                await this.agent.runPhase(session);
+            } // freeze()（机器门：桩审计/grounding + 需已批准）
+            catch (e) {
+                throw e;
+            } // 机器门拒绝上抛给 CLI 显示
+            session.phase = TERMINAL;
+            session.event(ws, "phase_advanced", { to: TERMINAL }, this.agent.now());
+            session.save(ws, this.agent.now());
+            return this.stop(session, FROZEN, 0);
+        }
+        // ── build attempt：推进到 test 边界（复用相位原语的 reconcile/错误归约）──
+        while (BUILD_PHASES.includes(session.phase)) {
+            const res = await advanceOnePhase(this.agent, session);
+            if (!res.ok)
+                return this.stop(session, res.reason, 0);
+        }
+        // ── 自评 → 反思 外层循环：达标才停 ──
+        const maxReflect = Number(this.policy.loop?.max_reflect_iterations ?? 3);
+        let iter = 0;
+        while (true) {
+            let ev;
+            try {
+                ev = await this.agent.selfEvaluate(session);
+            }
+            catch (e) {
+                if (e instanceof BudgetExceeded) {
+                    session.event(ws, "budget_exceeded", {}, this.agent.now());
+                    return this.stop(session, BUDGET_EXCEEDED, iter);
+                }
+                if (e instanceof LLMError) {
+                    session.event(ws, "llm_error", {}, this.agent.now());
+                    return this.stop(session, LLM_ERROR, iter);
+                }
+                throw e;
+            }
+            session.event(ws, "self_eval", { iter, met: ev.met, summary: ev.summary }, this.agent.now());
+            if (ev.met === true) { // 达标 → 交人（HITL）
+                session.phase = "freeze";
+                session.save(ws, this.agent.now());
+                return this.stop(session, AWAITING_APPROVAL, iter);
+            }
+            if (ev.met === null) { // 无评测体系可判 → 交人裁决
+                session.phase = "freeze";
+                session.save(ws, this.agent.now());
+                return this.stop(session, NEEDS_HUMAN_EVAL, iter);
+            }
+            if (iter >= maxReflect) { // 反思到顶仍不达标 → 交人
+                session.phase = "freeze";
+                session.save(ws, this.agent.now());
+                return this.stop(session, STANDARD_NOT_MET, iter);
+            }
+            iter += 1;
+            const rr = await this.agent.reflect(session); // 反思迭代：读 trace 归因 → 定向修改
+            session.event(ws, "reflect", { iter, revised: rr.revised, note: rr.note }, this.agent.now());
+            if (!rr.revised) { // 改无可改 → 别空转，交人
+                session.phase = "freeze";
+                session.save(ws, this.agent.now());
+                return this.stop(session, STANDARD_NOT_MET, iter);
+            }
+        }
+    }
+    stop(session, reason, iterations) {
+        session.save(this.agent.workspace, this.agent.now());
+        session.event(this.agent.workspace, "goal_loop_stopped", { reason }, this.agent.now());
+        return { stop: reason, phase: session.phase, iterations };
+    }
+}
+//# sourceMappingURL=goal-loop.js.map

package/dist/goal-loop.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,17 @@
+export declare const HOOK_POINTS: readonly ["pre_phase", "post_phase", "on_llm_call", "on_artifact", "on_stop", "on_heartbeat"];
+export type HookPoint = (typeof HOOK_POINTS)[number];
+export type HookFn = (payload: Record<string, unknown>) => void;
+export declare class HookBus {
+    private shellHooks;
+    private timeoutMs;
+    private handlers;
+    failures: {
+        point: string;
+        error: string;
+    }[];
+    constructor(shellHooks?: Record<string, string[]>, // {point: [命令...]}，payload 从 stdin 喂
+    timeoutMs?: number);
+    register(point: HookPoint, fn: HookFn): void;
+    emit(point: string, payload: Record<string, unknown>): void;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,WAAW,+FAEd,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEhE,qBAAa,OAAO;IAKhB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS;IALnB,OAAO,CAAC,QAAQ,CAAkC;IAClD,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;gBAGxC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM,EAAI,qCAAqC;IAClF,SAAS,SAAS;IAG5B,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAK5C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAW5D"}

package/dist/hooks.js

@@ -0,0 +1,44 @@
+/**
+ * hook 机制 —— 生命周期扩展点，观测/联动不侵入内核流程。
+ * 六点位：pre_phase / post_phase / on_llm_call / on_artifact / on_stop / on_heartbeat。
+ * hook 失败只记账不炸主流程。从 Python tracing/hooks.py 移植（python 回调面）。
+ */
+import { execFileSync } from "node:child_process";
+export const HOOK_POINTS = [
+    "pre_phase", "post_phase", "on_llm_call", "on_artifact", "on_stop", "on_heartbeat",
+];
+export class HookBus {
+    shellHooks;
+    timeoutMs;
+    handlers = new Map();
+    failures = [];
+    constructor(shellHooks = {}, // {point: [命令...]}，payload 从 stdin 喂
+    timeoutMs = 30_000) {
+        this.shellHooks = shellHooks;
+        this.timeoutMs = timeoutMs;
+    }
+    register(point, fn) {
+        if (!HOOK_POINTS.includes(point))
+            throw new Error(`未知 hook 点位: ${point}`);
+        (this.handlers.get(point) ?? this.handlers.set(point, []).get(point)).push(fn);
+    }
+    emit(point, payload) {
+        for (const fn of this.handlers.get(point) ?? []) {
+            try {
+                fn(payload);
+            }
+            catch (e) {
+                this.failures.push({ point, error: `${e.name}: ${e.message}` });
+            }
+        }
+        for (const cmd of this.shellHooks[point] ?? []) { // shell hook：payload JSON 从 stdin 传
+            try {
+                execFileSync("/bin/sh", ["-c", cmd], { input: JSON.stringify(payload), timeout: this.timeoutMs, env: { ...process.env, KC_HOOK_POINT: point } });
+            }
+            catch (e) {
+                this.failures.push({ point, error: `shell: ${e.message}` });
+            }
+        }
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc;CAC1E,CAAC;AAIX,MAAM,OAAO,OAAO;IAKR;IACA;IALF,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAClD,QAAQ,GAAuC,EAAE,CAAC;IAElD,YACU,aAAuC,EAAE,EAAI,qCAAqC;IAClF,YAAY,MAAM;QADlB,eAAU,GAAV,UAAU,CAA+B;QACzC,cAAS,GAAT,SAAS,CAAS;IACzB,CAAC;IAEJ,QAAQ,CAAC,KAAgB,EAAE,EAAU;QACnC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,OAAgC;QAClD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAkB,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7D,IAAI,CAAC;gBAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YACpB,OAAO,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAI,CAAW,CAAC,IAAI,KAAM,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAAC,CAAC;QACtG,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAK,oCAAoC;YACxF,IAAI,CAAC;gBACH,YAAY,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACnJ,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAW,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAAC,CAAC;QACzF,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @mingyuxu/core —— 通用 agent 运行时（对标 @earendil-works/pi-agent-core）。
+ * 不认识"核查"——只提供通用能力。领域（核查）作为扩展从 check 层插进来。依赖：只 @mingyuxu/ai。
+ */
+export { ToolRegistry, ToolDenied } from "./tools.js";
+export type { ToolFn, ToolLog } from "./tools.js";
+export { ExtensionRegistry, loadExtensions } from "./extensions.js";
+export type { Skill } from "./extensions.js";
+export { reconcile, PHASE_MINIMUM } from "./reconcile.js";
+export { Session, PHASES, TERMINAL, IDENTITY } from "./session.js";
+export type { SessionData } from "./session.js";
+export { HookBus, HOOK_POINTS } from "./hooks.js";
+export type { HookPoint, HookFn } from "./hooks.js";
+export { advanceOnePhase, BuildLoop, FROZEN, PHASE_CHECKPOINT, AWAITING_APPROVAL, RECONCILE_FAILED, BUDGET_EXCEEDED, STUCK, MAX_STEPS, LLM_ERROR, INTERRUPTED, } from "./loop.js";
+export type { Agent, StepResult, LoopResult } from "./loop.js";
+export { GoalLoop, STANDARD_NOT_MET, NEEDS_HUMAN_EVAL } from "./goal-loop.js";
+export type { GoalAgent, GoalResult } from "./goal-loop.js";
+export { Orchestrator, PLAYBOOK, ORCH_SYSTEM, mockDecide } from "./orchestrator.js";
+export type { OrchestratorAgent, Decision, DecideFn, Say } from "./orchestrator.js";
+export { Commander, COMMANDER_SYSTEM, mockCommanderDecide } from "./commander.js";
+export type { CommanderAgent, CommanderAction, CommanderDecision, CommanderDecide, CommanderEvent, CommanderResult, CommanderStep, CommanderStepStatus, CommanderOp, AgentPlan, Capability, CapabilityResult, PromotionState, } from "./commander.js";
+export { lintBrief, spawnSubagent, pollSubagent, waitSubagent, killSubagent } from "./subagents/dispatch.js";
+export type { TypedBrief, SubagentHandle } from "./subagents/dispatch.js";
+export { Sandbox, SandboxViolation } from "./sandbox.js";
+export { CodeAgent, CODE_AGENT_SYSTEM } from "./coding/agent.js";
+export type { CodeAgentOptions, CodeAgentEvent } from "./coding/agent.js";
+export { codingTools, defaultExec, READ_FILE, LIST_DIR, GLOB, GREP, WRITE_FILE, EDIT_FILE, BASH, ASK_MODEL, SPAWN_AGENT, } from "./coding/tools.js";
+export type { CodingTool, ToolContext, ApprovalGate, ExecFn } from "./coding/tools.js";
+export { WorkspaceManager } from "./workspace.js";
+export type { WorkspaceMeta, WorkspaceStatus, WorkspacePaths, WorkspaceEvent, CreateWorkspaceOptions, WorkspaceLease, } from "./workspace.js";
+export { validateTaskGraph, readyTasks, applyGoalPatch } from "./task-graph.js";
+export type { TaskGraph, TaskNode, TaskNodeStatus, GoalPatch } from "./task-graph.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,eAAe,EAAE,SAAS,EAC1B,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAC7D,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,GAC1D,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClF,YAAY,EACV,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EACnF,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAC3E,UAAU,EAAE,gBAAgB,EAAE,cAAc,GAC7C,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7G,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACL,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,GACrF,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EACV,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,sBAAsB,EACtF,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChF,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @mingyuxu/core —— 通用 agent 运行时（对标 @earendil-works/pi-agent-core）。
+ * 不认识"核查"——只提供通用能力。领域（核查）作为扩展从 check 层插进来。依赖：只 @mingyuxu/ai。
+ */
+export { ToolRegistry, ToolDenied } from "./tools.js";
+export { ExtensionRegistry, loadExtensions } from "./extensions.js";
+export { reconcile, PHASE_MINIMUM } from "./reconcile.js";
+export { Session, PHASES, TERMINAL, IDENTITY } from "./session.js";
+export { HookBus, HOOK_POINTS } from "./hooks.js";
+export { advanceOnePhase, BuildLoop, FROZEN, PHASE_CHECKPOINT, AWAITING_APPROVAL, RECONCILE_FAILED, BUDGET_EXCEEDED, STUCK, MAX_STEPS, LLM_ERROR, INTERRUPTED, } from "./loop.js";
+export { GoalLoop, STANDARD_NOT_MET, NEEDS_HUMAN_EVAL } from "./goal-loop.js";
+export { Orchestrator, PLAYBOOK, ORCH_SYSTEM, mockDecide } from "./orchestrator.js";
+export { Commander, COMMANDER_SYSTEM, mockCommanderDecide } from "./commander.js";
+export { lintBrief, spawnSubagent, pollSubagent, waitSubagent, killSubagent } from "./subagents/dispatch.js";
+export { Sandbox, SandboxViolation } from "./sandbox.js";
+export { CodeAgent, CODE_AGENT_SYSTEM } from "./coding/agent.js";
+export { codingTools, defaultExec, READ_FILE, LIST_DIR, GLOB, GREP, WRITE_FILE, EDIT_FILE, BASH, ASK_MODEL, SPAWN_AGENT, } from "./coding/tools.js";
+export { WorkspaceManager } from "./workspace.js";
+export { validateTaskGraph, readyTasks, applyGoalPatch } from "./task-graph.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,eAAe,EAAE,SAAS,EAC1B,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAC7D,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,GAC1D,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAMlF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE7G,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EACL,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,GACrF,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKlD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/loop.d.ts

@@ -0,0 +1,42 @@
+import { Session } from "./session.js";
+export declare const FROZEN = "frozen";
+export declare const PHASE_CHECKPOINT = "phase_checkpoint";
+export declare const AWAITING_APPROVAL = "awaiting_approval";
+export declare const RECONCILE_FAILED = "reconcile_failed";
+export declare const BUDGET_EXCEEDED = "budget_exceeded";
+export declare const STUCK = "stuck";
+export declare const MAX_STEPS = "max_steps";
+export declare const LLM_ERROR = "llm_error";
+export declare const INTERRUPTED = "interrupted";
+/** core 依赖的 agent 契约（check 提供具体实现）——分层单向：core 不认识核查。 */
+export interface Agent {
+    workspace: string;
+    now(): number;
+    runPhase(session: Session): void | Promise<void>;
+}
+export interface StepResult {
+    ok: boolean;
+    reason: string;
+    phase: string;
+    ran: boolean;
+    nextPhase?: string;
+    missing?: string[];
+}
+export declare function advanceOnePhase(agent: Agent, session: Session): Promise<StepResult>;
+export interface LoopResult {
+    stop: string;
+    phase: string;
+    steps: number;
+    missing?: string[];
+}
+/** 无人值守驱动器：沿相位推进；相位边界按 auto 决定停不停；freeze 永远等 approve。 */
+export declare class BuildLoop {
+    private agent;
+    private policy;
+    constructor(agent: Agent, policy: Record<string, any>);
+    run(session: Session, opts?: {
+        auto?: boolean;
+    }): Promise<LoopResult>;
+    private stop;
+}
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AAGjD,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,KAAK,UAAU,CAAC;AAC7B,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,wDAAwD;AACxD,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,IAAI,MAAM,CAAC;IACd,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BzF;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,yDAAyD;AACzD,qBAAa,SAAS;IAElB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;gBADN,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAG/B,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB/E,OAAO,CAAC,IAAI;CAKb"}

package/dist/loop.js

@@ -0,0 +1,86 @@
+/**
+ * 长时程推进循环 + 单相位原语（对标 pi-agent-core 的 agent-loop）。
+ * advanceOnePhase 是 BuildLoop 与 Orchestrator 共用的原语（单相位语义只一处实现）。
+ * 从 Python loop.py 忠实移植（BudgetExceeded/LLMError 归约为停止原因，不炸进程）。
+ */
+import { BudgetExceeded, LLMError } from "@mingyuxu/ai";
+import { reconcile } from "./reconcile.js";
+import { TERMINAL } from "./session.js";
+// 停止原因
+export const FROZEN = "frozen";
+export const PHASE_CHECKPOINT = "phase_checkpoint";
+export const AWAITING_APPROVAL = "awaiting_approval";
+export const RECONCILE_FAILED = "reconcile_failed";
+export const BUDGET_EXCEEDED = "budget_exceeded";
+export const STUCK = "stuck";
+export const MAX_STEPS = "max_steps";
+export const LLM_ERROR = "llm_error";
+export const INTERRUPTED = "interrupted";
+export async function advanceOnePhase(agent, session) {
+    const ws = agent.workspace;
+    const phase = session.phase;
+    const before = session.lastProgressAt;
+    try {
+        await agent.runPhase(session);
+    }
+    catch (e) {
+        if (e instanceof BudgetExceeded) {
+            session.event(ws, "budget_exceeded", { error: String(e) }, agent.now());
+            return { ok: false, reason: BUDGET_EXCEEDED, phase, ran: false };
+        }
+        if (e instanceof LLMError) { // 瞬时故障：落账可续跑，不炸进程
+            session.event(ws, "llm_error", { error: String(e) }, agent.now());
+            return { ok: false, reason: LLM_ERROR, phase, ran: false };
+        }
+        throw e; // 机器门拒绝（桩审计/grounding）等 → 上抛给调用方
+    }
+    const missing = reconcile(session.home(ws), phase, session.artifacts[phase] ?? []);
+    if (missing.length) {
+        session.event(ws, "ghost_completion", { missing }, agent.now());
+        session.save(ws, agent.now());
+        return { ok: false, reason: RECONCILE_FAILED, phase, ran: true, missing };
+    }
+    if (session.lastProgressAt <= before) {
+        return { ok: false, reason: STUCK, phase, ran: true };
+    }
+    session.phase = session.nextPhase();
+    session.event(ws, "phase_advanced", { to: session.phase }, agent.now());
+    session.save(ws, agent.now());
+    return { ok: true, reason: "", phase, ran: true, nextPhase: session.phase };
+}
+/** 无人值守驱动器：沿相位推进；相位边界按 auto 决定停不停；freeze 永远等 approve。 */
+export class BuildLoop {
+    agent;
+    policy;
+    constructor(agent, policy) {
+        this.agent = agent;
+        this.policy = policy;
+    }
+    async run(session, opts = {}) {
+        const auto = opts.auto ?? false;
+        const maxSteps = Number(this.policy.steps.builder_loop_max_steps);
+        let steps = 0;
+        while (session.phase !== TERMINAL) {
+            if (steps >= maxSteps)
+                return this.stop(session, MAX_STEPS, steps);
+            if (session.phase === "freeze" && !session.approved) {
+                return this.stop(session, AWAITING_APPROVAL, steps);
+            }
+            const res = await advanceOnePhase(this.agent, session);
+            if (res.ran)
+                steps += 1;
+            if (!res.ok)
+                return this.stop(session, res.reason, steps, res.missing);
+            if (!auto && session.phase !== TERMINAL) {
+                return this.stop(session, PHASE_CHECKPOINT, steps);
+            }
+        }
+        return this.stop(session, FROZEN, steps);
+    }
+    stop(session, reason, steps, missing) {
+        session.save(this.agent.workspace, this.agent.now());
+        session.event(this.agent.workspace, "loop_stopped", { reason }, this.agent.now());
+        return { stop: reason, phase: session.phase, steps, ...(missing ? { missing } : {}) };
+    }
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

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

package/dist/orchestrator.d.ts

@@ -0,0 +1,48 @@
+import { type ToolRegistry } from "./tools.js";
+import { type Agent } from "./loop.js";
+import { Session } from "./session.js";
+export declare const PLAYBOOK: Record<string, [string, string, string]>;
+export interface OrchestratorAgent extends Agent {
+    tools: ToolRegistry;
+    ledgerSummary(): Record<string, unknown>;
+    llm: {
+        mode: string;
+        completeJson(system: string, user: string): Promise<Record<string, unknown>>;
+    };
+}
+export interface Decision {
+    narration?: string;
+    action?: {
+        kind?: string;
+        text?: string;
+        tool?: string;
+        args?: Record<string, unknown>;
+    };
+}
+export type DecideFn = (session: Session, userMsg: string, obs: string | null) => Promise<Decision> | Decision;
+export type Say = (role: string, text: string) => void;
+export declare class Orchestrator {
+    private agent;
+    private maxSteps;
+    private tailN;
+    private decide;
+    private instructions;
+    constructor(agent: OrchestratorAgent, policy: Record<string, any>, // policy.orchestrator.{max_steps_per_turn,transcript_tail_n}
+    opts?: {
+        decideFn?: DecideFn;
+        instructions?: string;
+    });
+    turn(session: Session, userMsg: string, say?: Say): Promise<{
+        stop: string;
+        steps: number;
+    }>;
+    private doTool;
+    private doAdvance;
+    private gateReady;
+    private gateSummary;
+    private llmDecide;
+}
+export declare const ORCH_SYSTEM: string;
+/** mock 决策器：无模型也能走通闭环（确定性、可测）。 */
+export declare function mockDecide(_session: Session, userMsg: string, obs: string | null): Decision;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAmB,KAAK,KAAK,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AAEzD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAO7D,CAAC;AAEF,MAAM,WAAW,iBAAkB,SAAQ,KAAK;IAC9C,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;CACrG;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAC1F;AACD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAC/G,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvD,qBAAa,YAAY;IAQrB,OAAO,CAAC,KAAK;IAPf,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAW;IAEzB,OAAO,CAAC,YAAY,CAAS;gBAGnB,KAAK,EAAE,iBAAiB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAW,6DAA6D;IACnG,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAQrD,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,GAAc,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;YAuD9F,MAAM;YAaN,SAAS;IAavB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,WAAW;YAUL,SAAS;CAgBxB;AAED,eAAO,MAAM,WAAW,QAK0B,CAAC;AAEnD,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAuB3F"}

package/dist/orchestrator.js

@@ -0,0 +1,194 @@
+/**
+ * 意图层 Orchestrator —— 主 agent：narrate → 决策 → 观察 → 循环，直到交还用户。
+ * 决策五选一：reply / ask / tool / advance / propose_gate。失控三重顶：白名单+预算+步数。
+ * 从 Python orchestrator.py 移植。real 走 LLM 决策器、mock 走确定性关键词决策器（同一执行路径）。
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ToolDenied } from "./tools.js";
+import { BudgetExceeded } from "@mingyuxu/ai";
+import { advanceOnePhase } from "./loop.js";
+import { PHASES, TERMINAL } from "./session.js";
+export const PLAYBOOK = {
+    analyze: ["① 分析规则", "把规则拆成原子核查目标", "展示目标清单，请用户确认/删/改"],
+    observe: ["② 观察样本", "用样本修锚点 + researcher 查领域知识", "汇报锚点命中与领域发现"],
+    propose: ["③ 出方案", "多 proposer 出候选生产线", "展示候选对比，确认后才推进"],
+    test: ["④ 测试", "bake-off 打分 + refine 回改 + 对抗验证据", "展示排名/召回/评审页再谈冻结"],
+    freeze: ["⑤ 冻结", "晋升门（桩审计+grounding+人工批准）", "摊开门禁状态，等人工 approve"],
+    [TERMINAL]: ["已冻结", "生产线可直接调用", "kcagent run <场景> <文档>"],
+};
+export class Orchestrator {
+    agent;
+    maxSteps;
+    tailN;
+    decide;
+    instructions;
+    constructor(agent, policy, // policy.orchestrator.{max_steps_per_turn,transcript_tail_n}
+    opts = {}) {
+        this.agent = agent;
+        this.maxSteps = Number(policy.orchestrator?.max_steps_per_turn ?? 6);
+        this.tailN = Number(policy.orchestrator?.transcript_tail_n ?? 20);
+        this.instructions = opts.instructions ?? "";
+        this.decide = opts.decideFn ?? (this.agent.llm.mode === "real" ? this.llmDecide.bind(this) : mockDecide);
+    }
+    async turn(session, userMsg, say = () => { }) {
+        const ws = this.agent.workspace;
+        session.transcriptAppend(ws, "user", userMsg);
+        let obs = null;
+        for (let step = 0; step < this.maxSteps; step++) {
+            let decision;
+            try {
+                decision = await this.decide(session, userMsg, obs);
+            }
+            catch (e) {
+                say("agent", `（决策器不可用：${e.name}）`);
+                return { stop: "decider_error", steps: step };
+            }
+            const narration = (decision.narration ?? "").trim();
+            if (narration) {
+                say("think", narration);
+                session.transcriptAppend(ws, "think", narration);
+            }
+            const act = decision.action ?? {};
+            const kind = act.kind ?? "reply";
+            if (kind === "reply" || kind === "ask") {
+                const text = (act.text ?? "").trim() || "（无话可说）";
+                say("agent", text);
+                session.transcriptAppend(ws, "agent", text);
+                return { stop: kind, steps: step + 1 };
+            }
+            if (kind === "propose_gate") {
+                const [ready, why] = this.gateReady(session);
+                if (!ready) {
+                    obs = `晋升门未就绪：${why}。先把④测试补完（show_report 可看现状）。`;
+                    session.transcriptAppend(ws, "obs", obs);
+                    continue;
+                }
+                const summary = this.gateSummary(session);
+                say("agent", summary);
+                session.transcriptAppend(ws, "agent", summary);
+                return { stop: "gate_proposed", steps: step + 1 };
+            }
+            if (kind === "advance") {
+                obs = await this.doAdvance(session);
+                session.transcriptAppend(ws, "obs", obs);
+                continue;
+            }
+            if (kind === "tool") {
+                obs = await this.doTool(session, act);
+                session.transcriptAppend(ws, "obs", obs);
+                continue;
+            }
+            obs = `未知动作 kind=${kind}`;
+            session.transcriptAppend(ws, "obs", obs);
+        }
+        say("agent", "这一轮动作到顶了，先停下等你。（进度都在盘上）");
+        return { stop: "max_steps", steps: this.maxSteps };
+    }
+    async doTool(session, act) {
+        const name = act.tool ?? "";
+        try {
+            let out = this.agent.tools.call(name, { ...(act.args ?? {}), session });
+            if (out instanceof Promise)
+                out = await out; // 工具可异步（如 revise_targets 调 LLM）
+            return typeof out === "string" ? out : JSON.stringify(out).slice(0, 2000);
+        }
+        catch (e) {
+            if (e instanceof ToolDenied)
+                return `工具被拒（白名单）：${e.message}`;
+            if (e instanceof BudgetExceeded)
+                return `预算熔断：${e.message}`;
+            return `工具 ${name} 失败：${e.name}: ${e.message}`;
+        }
+    }
+    async doAdvance(session) {
+        if (session.phase === TERMINAL)
+            return "已经冻结完成，无相位可推进。";
+        if (session.phase === "freeze" && !session.approved) {
+            const [ready, why] = this.gateReady(session);
+            return "到晋升门了。" + (ready ? this.gateSummary(session) : `但门未就绪：${why}`);
+        }
+        const res = await advanceOnePhase(this.agent, session);
+        if (!res.ok)
+            return `相位 ${res.phase} 未推进：${res.reason}`;
+        const done = PLAYBOOK[res.phase]?.[0] ?? res.phase;
+        const next = PLAYBOOK[res.nextPhase]?.[0] ?? res.nextPhase;
+        return `✓ ${done} 完成，进入 ${next}。建议：${PLAYBOOK[res.phase]?.[2] ?? ""}`;
+    }
+    gateReady(session) {
+        const home = session.home(this.agent.workspace);
+        if (!["freeze", "test"].includes(session.phase))
+            return [false, `当前相位 ${session.phase}，还没走到测试/冻结`];
+        const report = join(home, "build", "test_report.json");
+        if (!existsSync(report))
+            return [false, "缺 build/test_report.json（④测试没跑）"];
+        const rep = JSON.parse(readFileSync(report, "utf-8"));
+        if (rep.ranking?.length && !existsSync(join(home, "build", "review.html"))) {
+            return [false, "缺 build/review.html（评审页没出）"];
+        }
+        return [true, ""];
+    }
+    gateSummary(session) {
+        let report = "";
+        try {
+            report = this.agent.tools.call("show_report", { session });
+        }
+        catch {
+            report = "（测试报告不可读）";
+        }
+        return ["———— 晋升门 ————", report, "", "批准冻结是人工专属动作：确认无误后输入 approve（我无权替你批）。"].join("\n");
+    }
+    async llmDecide(session, userMsg, obs) {
+        const ctx = {
+            phase: session.phase,
+            playbook: PLAYBOOK,
+            phases_order: PHASES,
+            artifacts: session.artifacts,
+            approved: session.approved,
+            tools: this.agent.tools.names(),
+            transcript_tail: session.transcriptTail(this.agent.workspace, this.tailN),
+            user_message: userMsg,
+            last_observation: obs ?? "",
+            budget: this.agent.ledgerSummary(),
+        };
+        const system = this.instructions ? `${this.instructions}\n\n${ORCH_SYSTEM}` : ORCH_SYSTEM;
+        return (await this.agent.llm.completeJson(system, JSON.stringify(ctx)));
+    }
+}
+export const ORCH_SYSTEM = "你是核查生产线构建的主 agent（意图层）。每轮输出一个 JSON 决策：" +
+    '{"narration":"先说你准备做什么、为什么","action":{"kind":"reply|ask|tool|advance|propose_gate",' +
+    '"text":"对用户说的话","tool":"工具名","args":{}}}。五步是默认计划不是铁轨，用户可改道；' +
+    "用户要删/改目标时调 revise_targets（args.drop=[编号] 或 args.feedback=调整要求）；" +
+    "propose_gate 前须有测试报告；冻结永远等人工 approve。只输出 JSON。";
+/** mock 决策器：无模型也能走通闭环（确定性、可测）。 */
+export function mockDecide(_session, userMsg, obs) {
+    if (obs !== null)
+        return { narration: "把刚才的结果交还给你。", action: { kind: "reply", text: obs } };
+    const has = (...kws) => kws.some((k) => userMsg.includes(k));
+    if (has("目标"))
+        return { narration: "你想看核查目标——调 show_targets。", action: { kind: "tool", tool: "show_targets" } };
+    if (has("方案", "候选", "skill"))
+        return { narration: "你想看候选生产线——调 show_specs。", action: { kind: "tool", tool: "show_specs" } };
+    if (has("报告", "评测", "测试", "结果"))
+        return { narration: "你想看评测结果——调 show_report。", action: { kind: "tool", tool: "show_report" } };
+    {
+        const dropM = userMsg.match(/删.*?(\d+)/g);
+        if (dropM) {
+            const nums = (userMsg.match(/\d+/g) ?? []).map(Number);
+            return { narration: `按你的要求删掉第 ${nums.join("、")} 个目标。`, action: { kind: "tool", tool: "revise_targets", args: { drop: nums } } };
+        }
+        if (has("改判据", "改目标", "修订", "只保留", "收紧", "放宽", "调整")) {
+            return { narration: "按你的调整要求修订目标清单。", action: { kind: "tool", tool: "revise_targets", args: { feedback: userMsg } } };
+        }
+    }
+    if (has("冻结", "批准", "上线", "固化"))
+        return { narration: "你想冻结——先过就绪门再摊开晋升门。", action: { kind: "propose_gate" } };
+    if (has("继续", "推进", "下一步", "开始"))
+        return { narration: "推进一个相位。", action: { kind: "advance" } };
+    const [title, what, review] = PLAYBOOK[_session.phase] ?? [_session.phase, "", ""];
+    return {
+        narration: "没匹配到明确意图，报个状态。",
+        action: { kind: "reply", text: `当前在 ${title}（${what}）。可以说：继续 / 看目标 / 看方案 / 看报告 / 冻结。建议：${review}` },
+    };
+}
+//# sourceMappingURL=orchestrator.js.map