@coralai/sps-cli 0.49.16 → 0.50.0

package/dist/infra/filesystem.js

@@ -0,0 +1,247 @@
+/**
+ * @module        infra/filesystem
+ * @description   FileSystem port —— 文件系统抽象 + 真/内存实现
+ *
+ * @layer         infra
+ *
+ * Service 层不直接 import fs；通过这个端口操作。
+ * 目的：
+ *   1. 可单测（InMemoryFileSystem 零 IO）
+ *   2. 原子写 / 目录扫描等操作有统一 API，不再各处写 writeFileSync + rename
+ *   3. 未来想换成云端 KV 或远程存储，port 抽象让上层无感
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname } from 'node:path';
+// ─── 真文件系统 ────────────────────────────────────────────────────
+export class NodeFileSystem {
+    exists(path) {
+        return existsSync(path);
+    }
+    stat(path) {
+        try {
+            const s = statSync(path);
+            return {
+                size: s.size,
+                mtimeMs: s.mtimeMs,
+                isDirectory: s.isDirectory(),
+                isFile: s.isFile(),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    readFile(path) {
+        return readFileSync(path, 'utf-8');
+    }
+    writeFileAtomic(path, content) {
+        const tmp = `${path}.tmp`;
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(tmp, content);
+        renameSync(tmp, path);
+    }
+    writeFile(path, content) {
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(path, content);
+    }
+    readDir(path) {
+        const entries = readdirSync(path, { withFileTypes: true });
+        return entries.map((e) => ({
+            name: e.name,
+            isDirectory: e.isDirectory(),
+            isFile: e.isFile(),
+        }));
+    }
+    mkdir(path, opts = {}) {
+        mkdirSync(path, { recursive: opts.recursive ?? false });
+    }
+    unlink(path) {
+        unlinkSync(path);
+    }
+    rm(path, opts = {}) {
+        rmSync(path, { recursive: opts.recursive ?? false, force: opts.force ?? false });
+    }
+    rename(from, to) {
+        renameSync(from, to);
+    }
+}
+/**
+ * 简版内存 FS —— 支持 absolute path 的读写/扫描/删除。
+ * 用于 Service 层单测：构造场景快、清理干净、不依赖 tmp 目录。
+ * 不追求和 POSIX 100% 语义一致，够测试用即可。
+ */
+export class InMemoryFileSystem {
+    root;
+    counter = 0;
+    nowFn;
+    /**
+     * @param opts.nowFn 自定义"写入时的 mtime 生成器"。默认用 Date.now()（和 Node FS 语义一致）。
+     *                   测试想要精确控制 mtime 可以传 FakeClock 的 now 方法。
+     */
+    constructor(opts = {}) {
+        this.nowFn = opts.nowFn ?? (() => Date.now());
+        this.root = { kind: 'dir', mtimeMs: this.nowFn(), children: new Map() };
+    }
+    tick() {
+        // 递增计数避免同毫秒下两次 write 得到相同 mtimeMs（测试偶有）
+        this.counter += 1;
+        return this.nowFn() + (this.counter % 1000) * 0.001;
+    }
+    walk(path, createDirs) {
+        const parts = path.split('/').filter(Boolean);
+        let node = this.root;
+        for (let i = 0; i < parts.length; i++) {
+            if (node.kind !== 'dir' || !node.children)
+                return null;
+            const name = parts[i];
+            let child = node.children.get(name);
+            if (!child) {
+                if (!createDirs)
+                    return null;
+                if (i === parts.length - 1)
+                    return null;
+                child = { kind: 'dir', mtimeMs: this.tick(), children: new Map() };
+                node.children.set(name, child);
+            }
+            node = child;
+        }
+        return node;
+    }
+    /**
+     * 找到 path 的父目录节点 + basename；父不存在时按 createDirs 决定是否补齐。
+     * 返回 null 仅当 path 为空。
+     */
+    walkParent(path, createDirs = false) {
+        const parts = path.split('/').filter(Boolean);
+        if (parts.length === 0)
+            return null;
+        const name = parts[parts.length - 1];
+        const parentParts = parts.slice(0, -1);
+        let node = this.root;
+        for (const p of parentParts) {
+            if (!node.children)
+                node.children = new Map();
+            let next = node.children.get(p);
+            if (!next) {
+                if (!createDirs)
+                    return null;
+                next = { kind: 'dir', mtimeMs: this.tick(), children: new Map() };
+                node.children.set(p, next);
+            }
+            if (next.kind !== 'dir')
+                return null;
+            node = next;
+        }
+        return { parent: node, name };
+    }
+    exists(path) {
+        return this.walk(path, false) !== null;
+    }
+    stat(path) {
+        const n = this.walk(path, false);
+        if (!n)
+            return null;
+        return {
+            size: n.kind === 'file' ? (n.content?.length ?? 0) : 0,
+            mtimeMs: n.mtimeMs,
+            isDirectory: n.kind === 'dir',
+            isFile: n.kind === 'file',
+        };
+    }
+    readFile(path) {
+        const n = this.walk(path, false);
+        if (!n || n.kind !== 'file' || n.content === undefined) {
+            throw new Error(`ENOENT: no such file, ${path}`);
+        }
+        return n.content;
+    }
+    writeFileAtomic(path, content) {
+        this.writeFile(path, content);
+    }
+    writeFile(path, content) {
+        const info = this.walkParent(path, true);
+        if (!info)
+            throw new Error(`invalid path: ${path}`);
+        if (!info.parent.children)
+            info.parent.children = new Map();
+        info.parent.children.set(info.name, { kind: 'file', content, mtimeMs: this.tick() });
+    }
+    readDir(path) {
+        const n = this.walk(path, false);
+        if (!n || n.kind !== 'dir' || !n.children) {
+            throw new Error(`ENOENT: not a directory, ${path}`);
+        }
+        return [...n.children.entries()].map(([name, e]) => ({
+            name,
+            isDirectory: e.kind === 'dir',
+            isFile: e.kind === 'file',
+        }));
+    }
+    mkdir(path, opts = {}) {
+        const parts = path.split('/').filter(Boolean);
+        let node = this.root;
+        for (let i = 0; i < parts.length; i++) {
+            if (!node.children)
+                node.children = new Map();
+            const name = parts[i];
+            const child = node.children.get(name);
+            if (child) {
+                if (child.kind !== 'dir')
+                    throw new Error(`exists but not a dir: ${name}`);
+                node = child;
+                continue;
+            }
+            if (!opts.recursive && i !== parts.length - 1) {
+                throw new Error(`ENOENT: parent does not exist: ${parts.slice(0, i).join('/')}`);
+            }
+            const fresh = { kind: 'dir', mtimeMs: this.tick(), children: new Map() };
+            node.children.set(name, fresh);
+            node = fresh;
+        }
+    }
+    unlink(path) {
+        const info = this.walkParent(path);
+        if (!info || !info.parent.children || !info.parent.children.has(info.name)) {
+            throw new Error(`ENOENT: no such file, ${path}`);
+        }
+        const e = info.parent.children.get(info.name);
+        if (e.kind !== 'file')
+            throw new Error(`is a directory: ${path}`);
+        info.parent.children.delete(info.name);
+    }
+    rm(path, opts = {}) {
+        const info = this.walkParent(path);
+        if (!info || !info.parent.children || !info.parent.children.has(info.name)) {
+            if (opts.force)
+                return;
+            throw new Error(`ENOENT: no such entry, ${path}`);
+        }
+        const e = info.parent.children.get(info.name);
+        if (e.kind === 'dir' && !opts.recursive) {
+            throw new Error(`EISDIR: directory not empty, ${path}`);
+        }
+        info.parent.children.delete(info.name);
+    }
+    rename(from, to) {
+        const src = this.walkParent(from);
+        if (!src || !src.parent.children || !src.parent.children.has(src.name)) {
+            throw new Error(`ENOENT: source not found, ${from}`);
+        }
+        const e = src.parent.children.get(src.name);
+        src.parent.children.delete(src.name);
+        this.writeEntryAt(to, e);
+    }
+    writeEntryAt(path, entry) {
+        const info = this.walkParent(path, true);
+        if (!info)
+            throw new Error(`invalid path: ${path}`);
+        if (!info.parent.children)
+            info.parent.children = new Map();
+        info.parent.children.set(info.name, entry);
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/infra/filesystem.js.map

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

package/dist/infra/spawn.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @module        infra/spawn
+ * @description   ProcessSpawner port —— 只用于启动 supervisor（长跑 sps tick 进程）
+ *
+ * @layer         infra
+ *
+ * 注意：Console 层禁止用 spawn 执行同步 CLI 操作（如 card add / worker launch）。
+ * 这些都应走 Service 层直接调 Domain。只有 pipeline supervisor 这种长跑 + detach
+ * 的进程才合法用 spawn。
+ */
+import { type ChildProcess } from 'node:child_process';
+export interface SupervisorSpawnOptions {
+    /** supervisor 要带的参数，如 ['tick', '<project>'] */
+    args: string[];
+    /** 输出重定向目标文件 */
+    logPath: string;
+    /** 工作目录，可选 */
+    cwd?: string;
+}
+export interface CliSyncOptions {
+    args: string[];
+    cwd?: string;
+    timeoutMs?: number;
+}
+export interface CliSyncResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface ProcessSpawner {
+    /**
+     * 启动一个 detached supervisor 进程，父退出后子继续跑。
+     * 返回 ChildProcess 句柄（调用方可以 kill，但不 await）。
+     */
+    spawnSupervisor(opts: SupervisorSpawnOptions): ChildProcess;
+    /**
+     * 同步 spawn sps 子命令（短任务）—— 用于 executor glue。
+     * Console 路由禁止直接用，必须经过 service → executor → spawner 这条路径。
+     */
+    runCliSync(opts: CliSyncOptions): Promise<CliSyncResult>;
+}
+export declare class NodeProcessSpawner implements ProcessSpawner {
+    spawnSupervisor(opts: SupervisorSpawnOptions): ChildProcess;
+    runCliSync(opts: CliSyncOptions): Promise<CliSyncResult>;
+}
+export interface FakeSpawnCall {
+    args: string[];
+    logPath: string;
+    cwd?: string;
+}
+/**
+ * 不真 spawn，仅记录调用。用于 Service 层单测验证 "PipelineService.start
+ * 的确调用了 supervisor"。
+ */
+export declare class FakeProcessSpawner implements ProcessSpawner {
+    calls: FakeSpawnCall[];
+    syncCalls: Array<{
+        args: string[];
+        cwd?: string;
+    }>;
+    /** 测试可以预设每次 runCliSync 的响应；缺省返 { exitCode: 0, stdout:'', stderr:'' } */
+    nextSyncResult: CliSyncResult | null;
+    private _pid;
+    runCliSync(opts: CliSyncOptions): Promise<CliSyncResult>;
+    spawnSupervisor(opts: SupervisorSpawnOptions): ChildProcess;
+}
+//# sourceMappingURL=spawn.d.ts.map

package/dist/infra/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/infra/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAK9D,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gBAAgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,YAAY,CAAC;IAE5D;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1D;AAqBD,qBAAa,kBAAmB,YAAW,cAAc;IACvD,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,YAAY;IAc3D,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA4BzD;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAChD,KAAK,EAAE,aAAa,EAAE,CAAM;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAC/D,wEAAwE;IACjE,cAAc,EAAE,aAAa,GAAG,IAAI,CAAQ;IACnD,OAAO,CAAC,IAAI,CAAU;IAEhB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAK9D,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,YAAY;CAsB5D"}

package/dist/infra/spawn.js

@@ -0,0 +1,116 @@
+/**
+ * @module        infra/spawn
+ * @description   ProcessSpawner port —— 只用于启动 supervisor（长跑 sps tick 进程）
+ *
+ * @layer         infra
+ *
+ * 注意：Console 层禁止用 spawn 执行同步 CLI 操作（如 card add / worker launch）。
+ * 这些都应走 Service 层直接调 Domain。只有 pipeline supervisor 这种长跑 + detach
+ * 的进程才合法用 spawn。
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, openSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * 定位 CLI 主入口 —— 优先用运行时的 process.argv[1]（就是当前 sps 可执行文件），
+ * 测试环境兜底到源码路径。
+ */
+function cliEntry() {
+    return { node: process.argv[0] ?? 'node', entry: process.argv[1] ?? defaultEntry() };
+}
+function defaultEntry() {
+    // infra/spawn.ts → src/ → workflow-cli/ → main.ts (源码模式) 或 dist/main.js（编译）
+    const here = fileURLToPath(import.meta.url);
+    // 源码：.../src/infra/spawn.ts → .../src/main.ts
+    const srcSibling = resolve(dirname(here), '..', 'main.ts');
+    if (existsSync(srcSibling))
+        return srcSibling;
+    // 编译：.../dist/infra/spawn.js → .../dist/main.js
+    const distSibling = resolve(dirname(here), '..', 'main.js');
+    return distSibling;
+}
+export class NodeProcessSpawner {
+    spawnSupervisor(opts) {
+        const { node, entry } = cliEntry();
+        const logDir = dirname(opts.logPath);
+        if (!existsSync(logDir))
+            mkdirSync(logDir, { recursive: true });
+        const logFd = openSync(opts.logPath, 'a');
+        const child = spawn(node, [entry, ...opts.args], {
+            cwd: opts.cwd,
+            detached: true,
+            stdio: ['ignore', logFd, logFd],
+        });
+        child.unref();
+        return child;
+    }
+    runCliSync(opts) {
+        const { node, entry } = cliEntry();
+        return new Promise((resolvePromise) => {
+            const child = spawn(node, [entry, ...opts.args], {
+                cwd: opts.cwd,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (d) => {
+                stdout += d.toString();
+            });
+            child.stderr?.on('data', (d) => {
+                stderr += d.toString();
+            });
+            const timer = opts.timeoutMs
+                ? setTimeout(() => child.kill('SIGTERM'), opts.timeoutMs)
+                : null;
+            child.on('close', (code) => {
+                if (timer)
+                    clearTimeout(timer);
+                resolvePromise({ exitCode: code, stdout, stderr });
+            });
+            child.on('error', (err) => {
+                if (timer)
+                    clearTimeout(timer);
+                resolvePromise({ exitCode: -1, stdout, stderr: stderr + String(err) });
+            });
+        });
+    }
+}
+/**
+ * 不真 spawn，仅记录调用。用于 Service 层单测验证 "PipelineService.start
+ * 的确调用了 supervisor"。
+ */
+export class FakeProcessSpawner {
+    calls = [];
+    syncCalls = [];
+    /** 测试可以预设每次 runCliSync 的响应；缺省返 { exitCode: 0, stdout:'', stderr:'' } */
+    nextSyncResult = null;
+    _pid = 100000;
+    async runCliSync(opts) {
+        this.syncCalls.push({ args: opts.args, cwd: opts.cwd });
+        return this.nextSyncResult ?? { exitCode: 0, stdout: '', stderr: '' };
+    }
+    spawnSupervisor(opts) {
+        this.calls.push({ args: opts.args, logPath: opts.logPath, cwd: opts.cwd });
+        // 返回一个 stub 足够满足 ChildProcess 接口用到的字段
+        const pid = this._pid++;
+        const stub = {
+            pid,
+            unref() { },
+            kill() {
+                return true;
+            },
+            on() {
+                return stub;
+            },
+            once() {
+                return stub;
+            },
+            removeListener() {
+                return stub;
+            },
+        };
+        return stub;
+    }
+}
+//# sourceMappingURL=spawn.js.map

package/dist/infra/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/infra/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAqCzC;;;GAGG;AACH,SAAS,QAAQ;IACf,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,YAAY;IACnB,4EAA4E;IAC5E,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,8CAA8C;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3D,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9C,gDAAgD;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5D,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,OAAO,kBAAkB;IAC7B,eAAe,CAAC,IAA4B;QAC1C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;SAChC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU,CAAC,IAAoB;QAC7B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC/C,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACrC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACrC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS;gBAC1B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;gBACzD,CAAC,CAAC,IAAI,CAAC;YACT,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAUD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACtB,KAAK,GAAoB,EAAE,CAAC;IAC5B,SAAS,GAA4C,EAAE,CAAC;IAC/D,wEAAwE;IACjE,cAAc,GAAyB,IAAI,CAAC;IAC3C,IAAI,GAAG,MAAM,CAAC;IAEtB,KAAK,CAAC,UAAU,CAAC,IAAoB;QACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IAED,eAAe,CAAC,IAA4B;QAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3E,sCAAsC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG;YACX,GAAG;YACH,KAAK,KAAI,CAAC;YACV,IAAI;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,EAAE;gBACA,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,cAAc;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC;SACyB,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/infra/sseBus.d.ts

@@ -0,0 +1,36 @@
+import type { DomainEvent, DomainEventBus } from '../shared/domainEvents.js';
+export interface SseBusEvent {
+    /** 单调递增 ID（SSE 需要） */
+    readonly id: number;
+    /** SSE event 字段值 = DomainEvent.type */
+    readonly event: string;
+    /** 原始领域事件 */
+    readonly data: DomainEvent;
+    /** 发布时的 wall-clock ts（ms） */
+    readonly ts: number;
+}
+export interface SseEventBusOptions {
+    /** 历史窗口大小 —— 超过丢最早的。默认 1000。 */
+    maxHistory?: number;
+}
+export declare class SseEventBus implements DomainEventBus {
+    private lastEventId;
+    private history;
+    private readonly maxHistory;
+    private readonly emitter;
+    constructor(opts?: SseEventBusOptions);
+    emit(event: DomainEvent): void;
+    subscribe(handler: (event: DomainEvent) => void): () => void;
+    /**
+     * SSE route 订阅的原始接口 —— 给需要 id / event 字段的 route 用。
+     * 订阅器内抛异常会冒泡（调用方 try/catch 或接受 EventEmitter 行为）。
+     */
+    subscribeRaw(handler: (record: SseBusEvent) => void): () => void;
+    /** SSE 断线重连用：返回 lastEventId 之后的历史 */
+    since(lastEventId: number): SseBusEvent[];
+    /** 测试 / close 时清空 */
+    clearHistory(): void;
+    /** 当前最大 id，测试用 */
+    currentId(): number;
+}
+//# sourceMappingURL=sseBus.d.ts.map

package/dist/infra/sseBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseBus.d.ts","sourceRoot":"","sources":["../../src/infra/sseBus.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,aAAa;IACb,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,IAAI,GAAE,kBAAuB;IAMzC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAQ9B,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAc5D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAOhE,qCAAqC;IACrC,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE;IAIzC,qBAAqB;IACrB,YAAY,IAAI,IAAI;IAKpB,kBAAkB;IAClB,SAAS,IAAI,MAAM;CAGpB"}

package/dist/infra/sseBus.js

@@ -0,0 +1,72 @@
+/**
+ * @module        infra/sseBus
+ * @description   DomainEventBus 的 SSE 实现 —— Console 专用
+ *
+ * @layer         infra
+ *
+ * 相比 InMemoryEventBus，本实现多了：
+ *   - lastEventId 自增（SSE 协议要求）
+ *   - 有限历史（Last-Event-ID 断线重连补偿）
+ *   - 心跳由上层 route 自己管，本 bus 只管事件分发和历史
+ *
+ * 相当于把原 console-server/sse/eventBus.ts 重新抽象成 DomainEventBus port 的实现。
+ */
+import { EventEmitter } from 'node:events';
+export class SseEventBus {
+    lastEventId = 0;
+    history = [];
+    maxHistory;
+    // 内部 EventEmitter 仅分发 record —— 不暴露，避免和 DomainEventBus.emit 签名冲突
+    emitter;
+    constructor(opts = {}) {
+        this.emitter = new EventEmitter();
+        this.emitter.setMaxListeners(0); // SSE 连接多，不要警告
+        this.maxHistory = opts.maxHistory ?? 1000;
+    }
+    emit(event) {
+        const id = ++this.lastEventId;
+        const record = { id, event: event.type, data: event, ts: Date.now() };
+        this.history.push(record);
+        if (this.history.length > this.maxHistory)
+            this.history.shift();
+        this.emitter.emit('*', record);
+    }
+    subscribe(handler) {
+        const wrapped = (record) => {
+            try {
+                handler(record.data);
+            }
+            catch (err) {
+                console.warn('[SseEventBus] handler threw:', err);
+            }
+        };
+        this.emitter.on('*', wrapped);
+        return () => {
+            this.emitter.off('*', wrapped);
+        };
+    }
+    /**
+     * SSE route 订阅的原始接口 —— 给需要 id / event 字段的 route 用。
+     * 订阅器内抛异常会冒泡（调用方 try/catch 或接受 EventEmitter 行为）。
+     */
+    subscribeRaw(handler) {
+        this.emitter.on('*', handler);
+        return () => {
+            this.emitter.off('*', handler);
+        };
+    }
+    /** SSE 断线重连用：返回 lastEventId 之后的历史 */
+    since(lastEventId) {
+        return this.history.filter((r) => r.id > lastEventId);
+    }
+    /** 测试 / close 时清空 */
+    clearHistory() {
+        this.history = [];
+        this.lastEventId = 0;
+    }
+    /** 当前最大 id，测试用 */
+    currentId() {
+        return this.lastEventId;
+    }
+}
+//# sourceMappingURL=sseBus.js.map

package/dist/infra/sseBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseBus.js","sourceRoot":"","sources":["../../src/infra/sseBus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmB3C,MAAM,OAAO,WAAW;IACd,WAAW,GAAG,CAAC,CAAC;IAChB,OAAO,GAAkB,EAAE,CAAC;IACnB,UAAU,CAAS;IACpC,iEAAiE;IAChD,OAAO,CAAe;IAEvC,YAAY,OAA2B,EAAE;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;QAChD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,KAAkB;QACrB,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC;QAC9B,MAAM,MAAM,GAAgB,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,OAAqC;QAC7C,MAAM,OAAO,GAAG,CAAC,MAAmB,EAAQ,EAAE;YAC5C,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAsC;QACjD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,WAAmB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;IACxD,CAAC;IAED,qBAAqB;IACrB,YAAY;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,kBAAkB;IAClB,SAAS;QACP,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/interfaces/ACPClient.d.ts

@@ -13,8 +13,8 @@
  * @layer         interface
  * @boundedContext agent-control-protocol
  */
-import type { AccumulatorEvent, AccumulatorListener } from '../providers/adapters/acp-session-accumulator.js';
 import type { ACPRunStatus, ACPSessionStatus, ACPTool } from '../models/acp.js';
+import type { AccumulatorEvent, AccumulatorListener } from '../providers/adapters/acp-session-accumulator.js';
 export type { AccumulatorEvent, AccumulatorListener };
 export interface McpServerConfig {
     name: string;

package/dist/interfaces/ACPClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ACPClient.d.ts","sourceRoot":"","sources":["../../src/interfaces/ACPClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAC9G,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhF,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B;8FAC0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1E,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAAC;CAC3E"}
+{"version":3,"file":"ACPClient.d.ts","sourceRoot":"","sources":["../../src/interfaces/ACPClient.ts"],"names":[],"mappings":"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"}

package/dist/main.js

@@ -51,8 +51,8 @@ import { executeCardAdd } from './commands/cardAdd.js';
 import { executeCardDashboard } from './commands/cardDashboard.js';
 import { executeCardMarkComplete } from './commands/cardMarkComplete.js';
 import { executeCardMarkStarted } from './commands/cardMarkStarted.js';
-import { executeHook } from './commands/hookCommand.js';
 import { executeDoctor } from './commands/doctor.js';
+import { executeHook } from './commands/hookCommand.js';
 import { executeLogs } from './commands/logs.js';
 import { executeMonitorTick } from './commands/monitorTick.js';
 import { executePipelineTick } from './commands/pipelineTick.js';