@mingyuxu/core 0.1.0

package/dist/orchestrator.js.map

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

package/dist/reconcile.d.ts

@@ -0,0 +1,5 @@
+/** 每相位的最低期望产物（相对 workspace/<scenario>/）——宣称之外的硬底线。 */
+export declare const PHASE_MINIMUM: Record<string, string[]>;
+/** 返回缺失清单（空 = 对账通过）。 */
+export declare function reconcile(sessionHome: string, phase: string, claimed: string[]): string[];
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":"AAQA,sDAAsD;AACtD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAMlD,CAAC;AAEF,wBAAwB;AACxB,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAUzF"}

package/dist/reconcile.js

@@ -0,0 +1,28 @@
+/**
+ * 磁盘对账（I3）—— 完成以盘上产物为准，不信 agent 宣称。
+ * 相位推进前：宣称产物 ∪ 该相位最低期望，逐一核对文件系统。差集非空 = 幽灵完成，打回。
+ * 从 Python reconcile.py 忠实移植。
+ */
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** 每相位的最低期望产物（相对 workspace/<scenario>/）——宣称之外的硬底线。 */
+export const PHASE_MINIMUM = {
+    analyze: ["build/targets.json"],
+    observe: ["build/targets.json", "build/observations.json"],
+    propose: ["build/specs.json", "build/proposals.json"],
+    test: ["build/test_report.json"],
+    freeze: ["pack/pack.json", "pack/freeze_manifest.json"],
+};
+/** 返回缺失清单（空 = 对账通过）。 */
+export function reconcile(sessionHome, phase, claimed) {
+    const expected = [...new Set([...claimed, ...(PHASE_MINIMUM[phase] ?? [])])];
+    const missing = [];
+    for (const rel of expected) {
+        const p = join(sessionHome, rel);
+        if (!existsSync(p) || (statSync(p).isFile() && statSync(p).size === 0)) {
+            missing.push(rel);
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/reconcile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.js","sourceRoot":"","sources":["../src/reconcile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAA6B;IACrD,OAAO,EAAE,CAAC,oBAAoB,CAAC;IAC/B,OAAO,EAAE,CAAC,oBAAoB,EAAE,yBAAyB,CAAC;IAC1D,OAAO,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;IACrD,IAAI,EAAE,CAAC,wBAAwB,CAAC;IAChC,MAAM,EAAE,CAAC,gBAAgB,EAAE,2BAA2B,CAAC;CACxD,CAAC;AAEF,wBAAwB;AACxB,MAAM,UAAU,SAAS,CAAC,WAAmB,EAAE,KAAa,EAAE,OAAiB;IAC7E,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/sandbox.d.ts

@@ -0,0 +1,14 @@
+export declare class SandboxViolation extends Error {
+    constructor(message: string);
+}
+export declare class Sandbox {
+    readonly root: string;
+    constructor(root: string);
+    private resolvePath;
+    contains(path: string): boolean;
+    /** 校验写路径在界内，返回解析后绝对路径；越界抛 SandboxViolation。 */
+    checkWrite(path: string): string;
+    /** 沙箱内安全写：先过 checkWrite，再建目录写入。 */
+    safeWrite(path: string, data: string): void;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAOA,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAC5B;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM;IAIxB,OAAO,CAAC,WAAW;IAInB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK/B,+CAA+C;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAMhC,mCAAmC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAK5C"}

package/dist/sandbox.js

@@ -0,0 +1,36 @@
+/**
+ * 沙箱边界护栏（宪法 §3.5）—— L1 目录沙箱：所有写限制在 build workdir 内，越界 fail-closed。
+ * 纯代码、确定性、可测；不调 LLM。从 Python core/sandbox.py 移植。
+ */
+import { writeFileSync, mkdirSync } from "node:fs";
+import { resolve, dirname, relative, isAbsolute } from "node:path";
+export class SandboxViolation extends Error {
+    constructor(message) { super(message); this.name = "SandboxViolation"; }
+}
+export class Sandbox {
+    root;
+    constructor(root) {
+        this.root = resolve(root); // 文本规范化（处理 ..）；不 realpath，避免符号链接不对称
+    }
+    resolvePath(path) {
+        return isAbsolute(path) ? resolve(path) : resolve(this.root, path);
+    }
+    contains(path) {
+        const rel = relative(this.root, this.resolvePath(path));
+        return !rel.startsWith("..") && !isAbsolute(rel);
+    }
+    /** 校验写路径在界内，返回解析后绝对路径；越界抛 SandboxViolation。 */
+    checkWrite(path) {
+        const resolved = this.resolvePath(path);
+        if (!this.contains(resolved))
+            throw new SandboxViolation(`写越界：${resolved} 不在沙箱 ${this.root} 内`);
+        return resolved;
+    }
+    /** 沙箱内安全写：先过 checkWrite，再建目录写入。 */
+    safeWrite(path, data) {
+        const p = this.checkWrite(path);
+        mkdirSync(dirname(p), { recursive: true });
+        writeFileSync(p, data, "utf-8");
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEnE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAC;CACjF;AAED,MAAM,OAAO,OAAO;IACT,IAAI,CAAS;IACtB,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAc,oCAAoC;IAC9E,CAAC;IAEO,WAAW,CAAC,IAAY;QAC9B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,IAAY;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,gBAAgB,CAAC,OAAO,QAAQ,SAAS,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAChG,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mCAAmC;IACnC,SAAS,CAAC,IAAY,EAAE,IAAY;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/session.d.ts

@@ -0,0 +1,43 @@
+export declare const PHASES: readonly ["analyze", "observe", "propose", "test", "freeze"];
+export declare const TERMINAL = "frozen";
+export declare const IDENTITY: string;
+export interface SessionData {
+    scenarioKey: string;
+    goal: string;
+    taskType?: string;
+    phase?: string;
+    inputs?: Record<string, string>;
+    artifacts?: Record<string, string[]>;
+    approved?: boolean;
+    winner?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    lastProgressAt?: number;
+    ledgerSnapshot?: Record<string, unknown>;
+}
+export declare class Session {
+    scenarioKey: string;
+    goal: string;
+    taskType: string;
+    phase: string;
+    inputs: Record<string, string>;
+    artifacts: Record<string, string[]>;
+    approved: boolean;
+    winner: string;
+    createdAt: number;
+    updatedAt: number;
+    lastProgressAt: number;
+    ledgerSnapshot: Record<string, unknown>;
+    constructor(d: SessionData);
+    pinHeader(): string;
+    nextPhase(): string;
+    recordArtifact(rel: string, ts?: number): void;
+    home(workspace: string): string;
+    save(workspace: string, ts?: number): string;
+    toJSON(): SessionData;
+    static load(workspace: string, scenarioKey: string): Session;
+    event(workspace: string, kind: string, payload?: Record<string, unknown>, ts?: number): void;
+    transcriptAppend(workspace: string, role: string, text: string, ts?: number): void;
+    transcriptTail(workspace: string, n?: number): Array<Record<string, unknown>>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM,8DAA+D,CAAC;AACnF,eAAO,MAAM,QAAQ,WAAW,CAAC;AAEjC,eAAO,MAAM,QAAQ,QAGoB,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAID,qBAAa,OAAO;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE5B,CAAC,EAAE,WAAW;IAe1B,SAAS,IAAI,MAAM;IASnB,SAAS,IAAI,MAAM;IAKnB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,MAAc,GAAG,IAAI;IAMrD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI/B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,GAAE,MAAc,GAAG,MAAM;IASnD,MAAM,IAAI,WAAW;IAUrB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAM5D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,EAAE,GAAE,MAAc,GAAG,IAAI;IAOvG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,MAAc,GAAG,IAAI;IAOzF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAM1E"}

package/dist/session.js

@@ -0,0 +1,104 @@
+/**
+ * 会话持久化 —— every conversation is a durable workflow（I1/I3 地基）。
+ * Session 是 build 的盘上状态：goal pin、兼容生命周期、产物清单、审批标记 + 对话账。
+ * 从 Python memory.py 忠实移植（file_lock 简化为进程内同步写）。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+export const PHASES = ["analyze", "observe", "propose", "test", "freeze"];
+export const TERMINAL = "frozen";
+export const IDENTITY = "你是 vet，造核查生产线的领域 agent。红线：判定必有证据（无据→needs_review，不猜）；" +
+    "可写代码但须沙箱+探针门+人工审阅后冻结；冻结须自评达标+grounding+人工 approve（无权自批）；" +
+    "完成以磁盘对账为准；judge≠doer。完整规格见 AGENTS.md。";
+const now = () => Date.now() / 1000;
+export class Session {
+    scenarioKey;
+    goal;
+    taskType;
+    phase;
+    inputs;
+    artifacts;
+    approved;
+    winner;
+    createdAt;
+    updatedAt;
+    lastProgressAt;
+    ledgerSnapshot;
+    constructor(d) {
+        this.scenarioKey = d.scenarioKey;
+        this.goal = d.goal;
+        this.taskType = d.taskType ?? "predicate";
+        this.phase = d.phase ?? "analyze";
+        this.inputs = d.inputs ?? {};
+        this.artifacts = d.artifacts ?? {};
+        this.approved = d.approved ?? false;
+        this.winner = d.winner ?? "";
+        this.createdAt = d.createdAt ?? 0;
+        this.updatedAt = d.updatedAt ?? 0;
+        this.lastProgressAt = d.lastProgressAt ?? 0;
+        this.ledgerSnapshot = d.ledgerSnapshot ?? {};
+    }
+    pinHeader() {
+        return (`${IDENTITY}\n` +
+            `[长程目标] ${this.goal}\n` +
+            `[场景] ${this.scenarioKey} · 任务类型 ${this.taskType}\n` +
+            `[兼容生命周期] ${this.phase}（Commander 的真实路径见 agent-plan.json）`);
+    }
+    nextPhase() {
+        if (this.phase === PHASES[PHASES.length - 1])
+            return TERMINAL;
+        return PHASES[PHASES.indexOf(this.phase) + 1];
+    }
+    recordArtifact(rel, ts = now()) {
+        (this.artifacts[this.phase] ??= []);
+        if (!this.artifacts[this.phase].includes(rel))
+            this.artifacts[this.phase].push(rel);
+        this.lastProgressAt = ts;
+    }
+    home(workspace) {
+        return join(workspace, this.scenarioKey);
+    }
+    save(workspace, ts = now()) {
+        this.updatedAt = ts;
+        const dir = join(this.home(workspace), ".session");
+        mkdirSync(dir, { recursive: true });
+        const path = join(dir, "state.json");
+        writeFileSync(path, JSON.stringify(this.toJSON(), null, 2), "utf-8");
+        return path;
+    }
+    toJSON() {
+        return {
+            scenarioKey: this.scenarioKey, goal: this.goal, taskType: this.taskType,
+            phase: this.phase, inputs: this.inputs, artifacts: this.artifacts,
+            approved: this.approved, winner: this.winner, createdAt: this.createdAt,
+            updatedAt: this.updatedAt, lastProgressAt: this.lastProgressAt,
+            ledgerSnapshot: this.ledgerSnapshot,
+        };
+    }
+    static load(workspace, scenarioKey) {
+        const path = join(workspace, scenarioKey, ".session", "state.json");
+        if (!existsSync(path))
+            throw new Error(`没有可恢复的会话: ${path}`);
+        return new Session(JSON.parse(readFileSync(path, "utf-8")));
+    }
+    event(workspace, kind, payload = {}, ts = now()) {
+        const dir = join(this.home(workspace), ".session");
+        mkdirSync(dir, { recursive: true });
+        const row = { ts, phase: this.phase, kind, ...payload };
+        appendFileSync(join(dir, "events.jsonl"), JSON.stringify(row) + "\n", "utf-8");
+    }
+    transcriptAppend(workspace, role, text, ts = now()) {
+        const dir = join(this.home(workspace), ".session");
+        mkdirSync(dir, { recursive: true });
+        const row = { ts, phase: this.phase, role, text };
+        appendFileSync(join(dir, "transcript.jsonl"), JSON.stringify(row) + "\n", "utf-8");
+    }
+    transcriptTail(workspace, n = 20) {
+        const path = join(this.home(workspace), ".session", "transcript.jsonl");
+        if (!existsSync(path))
+            return [];
+        const rows = readFileSync(path, "utf-8").split("\n").filter((l) => l.trim()).map((l) => JSON.parse(l));
+        return rows.slice(-n);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/subagents/dispatch.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 委派契约、subagent 生命周期（I4/I5/I6）—— 从 Python subagents/dispatch.py 移植。
+ * typed brief 取代散文委派：目标 + 输入清单 + 输出 schema + 预算，发出前过完整性 lint。
+ * subagent = 独立子进程 + 独立目录；kill 协作式（先落 STOP 文件，超时才 terminate）。
+ * spawn 跑一个 node worker 脚本（TS 无 python -m，改传 worker 脚本绝对路径，分层单向仍成立）。
+ */
+import { type ChildProcess } from "node:child_process";
+export interface TypedBrief {
+    goal: string;
+    inputs: string[];
+    output_schema: Record<string, unknown>;
+    budget: Record<string, number>;
+    items_declared?: number | null;
+}
+/** 完整性 lint：结构缺项 + 数量对账。返回错误清单（空 = 通过）。 */
+export declare function lintBrief(b: TypedBrief): string[];
+export interface SubagentHandle {
+    dir: string;
+    proc: ChildProcess;
+    exited: {
+        code: number | null;
+    };
+}
+/** 独立目录 + 独立进程启动 subagent；brief 发出前强制 lint（I5）。 */
+export declare function spawnSubagent(parentDir: string, task: string, args: Record<string, unknown>, brief: TypedBrief, opts: {
+    env?: NodeJS.ProcessEnv;
+    workerScript: string;
+}): SubagentHandle;
+export declare function pollSubagent(h: SubagentHandle): string;
+/** 等待完成并返回 result.json；超时先协作式 kill 再抛。 */
+export declare function waitSubagent(h: SubagentHandle, timeoutSeconds: number, pollMs?: number): Promise<Record<string, unknown>>;
+/** 协作式 kill：落 STOP 文件 → 宽限期 → 超时 terminate。 */
+export declare function killSubagent(h: SubagentHandle, graceSeconds?: number): Promise<void>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/subagents/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/subagents/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,CAQjD;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CACjC;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAgBxL;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAGtD;AAID,0CAA0C;AAC1C,wBAAsB,YAAY,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAa5H;AAED,+CAA+C;AAC/C,wBAAsB,YAAY,CAAC,CAAC,EAAE,cAAc,EAAE,YAAY,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrF"}

package/dist/subagents/dispatch.js

@@ -0,0 +1,80 @@
+/**
+ * 委派契约、subagent 生命周期（I4/I5/I6）—— 从 Python subagents/dispatch.py 移植。
+ * typed brief 取代散文委派：目标 + 输入清单 + 输出 schema + 预算，发出前过完整性 lint。
+ * subagent = 独立子进程 + 独立目录；kill 协作式（先落 STOP 文件，超时才 terminate）。
+ * spawn 跑一个 node worker 脚本（TS 无 python -m，改传 worker 脚本绝对路径，分层单向仍成立）。
+ */
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync, openSync, closeSync } from "node:fs";
+import { join } from "node:path";
+/** 完整性 lint：结构缺项 + 数量对账。返回错误清单（空 = 通过）。 */
+export function lintBrief(b) {
+    const e = [];
+    if (!b.goal?.trim())
+        e.push("brief.goal 为空");
+    if (!b.inputs?.length)
+        e.push("brief.inputs 为空——委派必须带输入清单");
+    if (!b.output_schema || !Object.keys(b.output_schema).length)
+        e.push("brief.output_schema 为空——没有输出契约的委派不可验收");
+    if (!b.budget || !Object.keys(b.budget).length)
+        e.push("brief.budget 为空——无预算的委派违反 I11");
+    if (b.items_declared != null && b.items_declared !== b.inputs.length)
+        e.push(`数量对账失败：宣称 ${b.items_declared} 项，实际枚举 ${b.inputs.length} 项`);
+    return e;
+}
+/** 独立目录 + 独立进程启动 subagent；brief 发出前强制 lint（I5）。 */
+export function spawnSubagent(parentDir, task, args, brief, opts) {
+    const errors = lintBrief(brief);
+    if (errors.length)
+        throw new Error("brief lint 不通过，拒绝委派：\n  - " + errors.join("\n  - "));
+    const dir0 = join(parentDir, "subagents");
+    mkdirSync(dir0, { recursive: true });
+    const index = readdirSync(dir0).filter((n) => statSync(join(dir0, n)).isDirectory()).length + 1;
+    const workDir = join(dir0, `${task}-${String(index).padStart(3, "0")}`);
+    mkdirSync(workDir);
+    writeFileSync(join(workDir, "brief.json"), JSON.stringify(brief, null, 2), "utf-8");
+    writeFileSync(join(workDir, "task.json"), JSON.stringify({ task, args }, null, 2), "utf-8");
+    writeFileSync(join(workDir, "status.json"), '{"status": "running"}', "utf-8");
+    const logFd = openSync(join(workDir, "stdout.log"), "w");
+    const proc = spawn("node", [opts.workerScript, workDir], { stdio: ["ignore", logFd, logFd], env: opts.env ?? process.env });
+    const exited = { code: null };
+    proc.on("exit", (code) => { exited.code = code ?? 0; closeSync(logFd); });
+    return { dir: workDir, proc, exited };
+}
+export function pollSubagent(h) {
+    try {
+        return JSON.parse(readFileSync(join(h.dir, "status.json"), "utf-8")).status;
+    }
+    catch {
+        return "unknown";
+    }
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** 等待完成并返回 result.json；超时先协作式 kill 再抛。 */
+export async function waitSubagent(h, timeoutSeconds, pollMs = 200) {
+    const deadline = Date.now() + timeoutSeconds * 1000;
+    while (Date.now() < deadline) {
+        if (h.exited.code !== null) {
+            const status = pollSubagent(h);
+            const resultPath = join(h.dir, "result.json");
+            if (status === "done" && existsSync(resultPath))
+                return JSON.parse(readFileSync(resultPath, "utf-8"));
+            throw new Error(`subagent 失败（status=${status}）：见 ${h.dir}/stdout.log`);
+        }
+        await sleep(pollMs);
+    }
+    await killSubagent(h);
+    throw new Error(`subagent 超时（>${timeoutSeconds}s），已 kill：${h.dir}`);
+}
+/** 协作式 kill：落 STOP 文件 → 宽限期 → 超时 terminate。 */
+export async function killSubagent(h, graceSeconds = 5) {
+    writeFileSync(join(h.dir, "STOP"), "", "utf-8");
+    const deadline = Date.now() + graceSeconds * 1000;
+    while (Date.now() < deadline) {
+        if (h.exited.code !== null)
+            return;
+        await sleep(100);
+    }
+    h.proc.kill("SIGTERM");
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/subagents/dispatch.js.map

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

package/dist/task-graph.d.ts

@@ -0,0 +1,32 @@
+/** 动态任务图：表达依赖、就绪条件和 Goal Patch，不把 Agent 退化成阶段游标。 */
+export type TaskNodeStatus = "pending" | "running" | "done" | "blocked" | "stale";
+export interface TaskNode {
+    id: string;
+    text: string;
+    status: TaskNodeStatus;
+    dependsOn: string[];
+    evidence?: string;
+    acceptanceRefs?: string[];
+}
+export interface TaskGraph {
+    version: 2;
+    goal: string;
+    status: "planning" | "running" | "waiting_user" | "evaluating" | "complete" | "blocked" | "paused";
+    rationale?: string;
+    nodes: TaskNode[];
+    updatedAt: string;
+}
+export interface GoalPatch {
+    reason: string;
+    goal?: string;
+    add?: TaskNode[];
+    update?: Array<Partial<TaskNode> & {
+        id: string;
+    }>;
+    remove?: string[];
+    invalidate?: string[];
+}
+export declare function validateTaskGraph(graph: TaskGraph): string[];
+export declare function readyTasks(graph: TaskGraph): TaskNode[];
+export declare function applyGoalPatch(graph: TaskGraph, patch: GoalPatch, at?: string): TaskGraph;
+//# sourceMappingURL=task-graph.d.ts.map

package/dist/task-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-graph.d.ts","sourceRoot":"","sources":["../src/task-graph.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAuB5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,CAGvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,SAA2B,GAAG,SAAS,CAwB3G"}

package/dist/task-graph.js

@@ -0,0 +1,77 @@
+export function validateTaskGraph(graph) {
+    const issues = [];
+    const ids = new Set();
+    for (const node of graph.nodes) {
+        if (!node.id)
+            issues.push("任务节点缺 id");
+        if (ids.has(node.id))
+            issues.push(`任务节点重复：${node.id}`);
+        ids.add(node.id);
+    }
+    for (const node of graph.nodes)
+        for (const dep of node.dependsOn) {
+            if (!ids.has(dep))
+                issues.push(`${node.id} 依赖不存在的节点 ${dep}`);
+            if (dep === node.id)
+                issues.push(`${node.id} 不能依赖自身`);
+        }
+    const visiting = new Set(), visited = new Set();
+    const byId = new Map(graph.nodes.map((node) => [node.id, node]));
+    const visit = (id) => {
+        if (visiting.has(id)) {
+            issues.push(`任务图存在环：${id}`);
+            return;
+        }
+        if (visited.has(id))
+            return;
+        visiting.add(id);
+        for (const dep of byId.get(id)?.dependsOn ?? [])
+            if (byId.has(dep))
+                visit(dep);
+        visiting.delete(id);
+        visited.add(id);
+    };
+    for (const id of ids)
+        visit(id);
+    return [...new Set(issues)];
+}
+export function readyTasks(graph) {
+    const byId = new Map(graph.nodes.map((node) => [node.id, node]));
+    return graph.nodes.filter((node) => node.status === "pending" && node.dependsOn.every((id) => byId.get(id)?.status === "done"));
+}
+export function applyGoalPatch(graph, patch, at = new Date().toISOString()) {
+    const map = new Map(graph.nodes.map((node) => [node.id, { ...node, dependsOn: [...node.dependsOn] }]));
+    for (const id of patch.remove ?? [])
+        map.delete(id);
+    for (const change of patch.update ?? []) {
+        const prior = map.get(change.id);
+        if (!prior)
+            throw new Error(`Goal Patch 要更新的任务不存在：${change.id}`);
+        map.set(change.id, { ...prior, ...change, dependsOn: change.dependsOn ? [...change.dependsOn] : prior.dependsOn });
+    }
+    for (const node of patch.add ?? []) {
+        if (map.has(node.id))
+            throw new Error(`Goal Patch 新增任务已存在：${node.id}`);
+        map.set(node.id, { ...node, dependsOn: [...node.dependsOn] });
+    }
+    const reverse = new Map();
+    for (const node of map.values())
+        for (const dep of node.dependsOn)
+            reverse.set(dep, [...(reverse.get(dep) ?? []), node.id]);
+    const stale = [...(patch.invalidate ?? [])];
+    for (let i = 0; i < stale.length; i++)
+        for (const child of reverse.get(stale[i]) ?? [])
+            if (!stale.includes(child))
+                stale.push(child);
+    for (const id of stale) {
+        const node = map.get(id);
+        if (node && node.status !== "blocked")
+            map.set(id, { ...node, status: "stale", evidence: undefined });
+    }
+    const next = { ...graph, goal: patch.goal ?? graph.goal, nodes: [...map.values()], rationale: patch.reason, status: "running", updatedAt: at };
+    const issues = validateTaskGraph(next);
+    if (issues.length)
+        throw new Error(`Goal Patch 产生非法任务图：${issues.join("；")}`);
+    return next;
+}
+//# sourceMappingURL=task-graph.js.map

package/dist/task-graph.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 工具层（1.4）—— agent 能动手，但只有该动的手。
+ * 工具 = 白名单内的具名可调用。调不在白名单里的工具直接 ToolDenied。
+ * 每次调用记一条工具账（名称/耗时/成败）。从 Python whitelist.py 忠实移植。
+ */
+export declare class ToolDenied extends Error {
+    constructor(message: string);
+}
+export type ToolFn = (args: Record<string, unknown>) => unknown | Promise<unknown>;
+export type ToolLog = (record: Record<string, unknown>) => void;
+export declare class ToolRegistry {
+    private whitelist;
+    private impl;
+    private logFn?;
+    private now;
+    constructor(whitelist: Iterable<string>, opts?: {
+        logFn?: ToolLog;
+        now?: () => number;
+    });
+    register(name: string, fn: ToolFn): void;
+    names(): string[];
+    call(name: string, args?: Record<string, unknown>): unknown;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AACnF,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEhE,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,KAAK,CAAC,CAAU;IACxB,OAAO,CAAC,GAAG,CAAe;gBAEd,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAM3F,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxC,KAAK,IAAI,MAAM,EAAE;IAIjB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO;CAwBhE"}

package/dist/tools.js

@@ -0,0 +1,54 @@
+/**
+ * 工具层（1.4）—— agent 能动手，但只有该动的手。
+ * 工具 = 白名单内的具名可调用。调不在白名单里的工具直接 ToolDenied。
+ * 每次调用记一条工具账（名称/耗时/成败）。从 Python whitelist.py 忠实移植。
+ */
+export class ToolDenied extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ToolDenied";
+    }
+}
+export class ToolRegistry {
+    whitelist;
+    impl = new Map();
+    logFn;
+    now;
+    constructor(whitelist, opts = {}) {
+        this.whitelist = new Set(whitelist);
+        this.logFn = opts.logFn;
+        this.now = opts.now ?? (() => Date.now() / 1000);
+    }
+    register(name, fn) {
+        this.impl.set(name, fn);
+    }
+    names() {
+        return [...this.impl.keys()].sort();
+    }
+    call(name, args = {}) {
+        if (!this.whitelist.has(name)) {
+            throw new ToolDenied(`工具 ${name} 不在白名单（${[...this.whitelist].sort().join(", ")}）——扩权需改白名单并评审`);
+        }
+        const fn = this.impl.get(name);
+        if (!fn)
+            throw new Error(`工具 ${name} 未注册实现`);
+        const start = this.now();
+        const record = { tool: name, ts: start };
+        try {
+            const result = fn(args);
+            record.ok = true;
+            record.ms = Math.round((this.now() - start) * 1000);
+            return result;
+        }
+        catch (e) {
+            record.ok = false;
+            record.ms = Math.round((this.now() - start) * 1000);
+            record.error = `${e.name}: ${e.message}`;
+            throw e;
+        }
+        finally {
+            this.logFn?.(record);
+        }
+    }
+}
+//# sourceMappingURL=tools.js.map