@accelerator-mzq/forge 1.4.0

package/dist/cli/commands/migrate.js

@@ -0,0 +1,34 @@
+// src/cli/commands/migrate.ts
+// forge migrate <source> 子命令 — Plan 8a Task 1.7
+// 对应 spec §1.4 CLI 形态(8 个选项)+ §3.3 LockHeldError 友好 catch
+import { Command } from 'commander';
+import { runMigrate } from '../../core/migrate/index.js';
+export function buildMigrateCommand() {
+    return new Command('migrate')
+        .description('搬运已有 OpenSpec / superpowers 项目仓库到 forge 工作目录')
+        .argument('<source>', "源类型:'openspec' 或 'superpowers'(必填,不自动猜)")
+        .option('--no-regenerate', '不调 LLM 补缺件;失败件标 [needs-fix],不阻塞 cp')
+        .option('--dry-run', '只扫描 + 出 plan + 输出报告,不写 forge/')
+        .option('--force', '冲突时旧目标 mv 到 forge/.forge-trash/<ts>/(留 24h 兜底)再覆盖')
+        .option('--archive-list <file>', '显式指定哪些 slug 进 archive,跳过自动推测')
+        .option('--no-interactive', '跳过 active/archive 交互确认表,全用推测默认值')
+        .option('--redact-rules <file>', '--regenerate 时附加自定义 redact 规则')
+        .action(async (source, opts) => {
+        // 校验 source argument:仅接受 'openspec' 或 'superpowers'
+        if (source !== 'openspec' && source !== 'superpowers') {
+            console.error(`error: <source> must be 'openspec' or 'superpowers', got '${source}'`);
+            process.exit(2);
+        }
+        const exitCode = await runMigrate({
+            source: source,
+            noRegenerate: opts.regenerate === false,
+            dryRun: opts.dryRun ?? false,
+            force: opts.force ?? false,
+            archiveList: opts.archiveList,
+            noInteractive: opts.interactive === false,
+            redactRules: opts.redactRules,
+        });
+        process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/cli/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/cli/commands/migrate.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,gDAAgD;AAChD,0DAA0D;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAGzD,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,8CAA8C,CAAC;SAC3D,QAAQ,CAAC,UAAU,EAAE,yCAAyC,CAAC;SAC/D,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;SAC/D,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC;SACpD,MAAM,CAAC,SAAS,EAAE,mDAAmD,CAAC;SACtE,MAAM,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;SAC/D,MAAM,CAAC,kBAAkB,EAAE,iCAAiC,CAAC;SAC7D,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,CAAC;SAChE,MAAM,CACL,KAAK,EACH,MAAc,EACd,IAOC,EACD,EAAE;QACF,oDAAoD;QACpD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;YACtD,OAAO,CAAC,KAAK,CAAC,6DAA6D,MAAM,GAAG,CAAC,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC;YAChC,MAAM,EAAE,MAAkB;YAC1B,YAAY,EAAE,IAAI,CAAC,UAAU,KAAK,KAAK;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,WAAW,KAAK,KAAK;YACzC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CACF,CAAC;AACN,CAAC"}

package/dist/cli/commands/monitor.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildMonitorCommand(): Command;
+//# sourceMappingURL=monitor.d.ts.map

package/dist/cli/commands/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/monitor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,wBAAgB,mBAAmB,IAAI,OAAO,CA4G7C"}

package/dist/cli/commands/monitor.js

@@ -0,0 +1,113 @@
+// src/cli/commands/monitor.ts — forge monitor 子命令组(spec §7)
+import { Command } from 'commander';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { isMonitorEnabled, setMonitorEnabled } from '../../core/monitor/config.js';
+import { readTrace, appendTraceEvent, readCliExits, monitorDir, sessionChangeId, readSessionTrace, } from '../../core/monitor/trace-store.js';
+import { MONITOR_STAGES } from '../../core/monitor/types.js';
+import { observeArtifacts } from '../../core/monitor/artifact-observer.js';
+import { renderReport } from '../../core/monitor/report-renderer.js';
+// 构建 monitor 子命令
+export function buildMonitorCommand() {
+    const cmd = new Command('monitor').description('workflow-monitor:观察并报告 forge 工作流');
+    cmd
+        .command('enable')
+        .description('开启 workflow-monitor(写 config.yaml#monitor.enabled)')
+        .action(() => {
+        // 在当前工作目录启用 monitor
+        setMonitorEnabled(process.cwd(), true);
+        console.log('✓ workflow-monitor 已开启 —— AI trace 层下次会话生效,CLI 层下次 forge 调用生效');
+    });
+    cmd
+        .command('disable')
+        .description('关闭 workflow-monitor')
+        .action(() => {
+        // 在当前工作目录禁用 monitor
+        setMonitorEnabled(process.cwd(), false);
+        console.log('✓ workflow-monitor 已关闭');
+    });
+    cmd
+        .command('status')
+        .description('查看开关状态 + 活动 change 的 trace 摘要')
+        .option('--change <id>', '指定 change-id')
+        .action((opts) => {
+        // 查询当前工作目录的 monitor 状态
+        const root = process.cwd();
+        console.log(`workflow-monitor: ${isMonitorEnabled(root) ? '已开启' : '已关闭'}`);
+        if (opts.change) {
+            // 读取指定 change 的 trace 摘要
+            const { events, corruptLines } = readTrace(root, opts.change);
+            console.log(`change ${opts.change}: ${events.length} 条 trace 事件,${corruptLines} 行损坏`);
+        }
+    });
+    cmd
+        .command('record')
+        .description('记录一条 AI 层 trace 事件(由 workflow-monitor 注入内容指示 AI 调用)')
+        .requiredOption('--stage <stage>', '工作阶段')
+        .requiredOption('--event <event>', '事件类型(stage_enter|decision|hardening_step|stage_exit)')
+        .option('--change <id>', 'change-id')
+        .option('--json <payload>', 'data 负载(JSON)', '{}')
+        .action((opts) => {
+        // 硬约束(spec §7):永远 exit 0;关闭时静默 no-op。
+        try {
+            const root = process.cwd();
+            if (!isMonitorEnabled(root))
+                return; // 静默 no-op
+            // 未传 --change 时自动落 _session-<uuid> 桶(spec §2.4:pre-change brainstorm/explore 事件)
+            const changeId = opts.change ?? sessionChangeId(root);
+            let data;
+            let event = opts.event; // JSON 解析失败或 stage 非法时降级为 'record_error'
+            try {
+                data = JSON.parse(opts.json);
+            }
+            catch (err) {
+                // 坏输入降级为 record_error,不报错退出
+                event = 'record_error';
+                data = { original_event: opts.event, error: err.message };
+            }
+            // stage 合法性校验 —— 无效 stage 同样降级为 record_error(与坏 JSON 对称,spec §7「坏输入」)
+            if (event !== 'record_error' &&
+                !MONITOR_STAGES.includes(opts.stage)) {
+                event = 'record_error';
+                data = { original_event: opts.event, error: `invalid stage: ${opts.stage}` };
+            }
+            const traceEvent = {
+                ts: new Date().toISOString(),
+                schema: 'forge-monitor-trace/v1',
+                change_id: changeId,
+                stage: opts.stage,
+                layer: 'ai',
+                event,
+                data,
+            };
+            appendTraceEvent(root, traceEvent);
+        }
+        catch {
+            // 永不破坏工作流 —— 吞掉一切异常
+        }
+    });
+    cmd
+        .command('report')
+        .description('渲染某 change 的监控报告(markdown)')
+        .requiredOption('--change <id>', 'change-id')
+        .option('--out <path>', '报告输出路径(默认 forge/.monitor/<change>/report.md)')
+        .action((opts) => {
+        // query 命令 —— 出错允许 non-zero exit(spec §7:与 record 不同,report 不强制 exit 0,故不包 try/catch)
+        const root = process.cwd();
+        // AI trace 事件 + CLI 产物回扫事件 + _session 桶 pre-change 事件合并(spec §2.4/§3.2)
+        const aiEvents = readTrace(root, opts.change).events;
+        const sessionEvents = readSessionTrace(root); // spec §2.4/§3.2:并入 pre-change _session 桶事件
+        const cliEvents = observeArtifacts(root, opts.change);
+        // 三源 change_id 不同,sort 合并不去重(同一事件不会重复;附录原始 trace 忠实呈现)
+        const all = [...cliEvents, ...aiEvents, ...sessionEvents].sort((a, b) => a.ts.localeCompare(b.ts));
+        const cliExits = readCliExits(root);
+        const md = renderReport(opts.change, all, cliExits);
+        const outPath = opts.out ?? join(monitorDir(root), opts.change, 'report.md');
+        mkdirSync(dirname(outPath), { recursive: true });
+        writeFileSync(outPath, md, 'utf8');
+        console.log(md);
+        console.error(`报告已写入 ${outPath}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=monitor.js.map

package/dist/cli/commands/monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.js","sourceRoot":"","sources":["../../../src/cli/commands/monitor.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAsC,MAAM,6BAA6B,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE,iBAAiB;AACjB,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,kCAAkC,CAAC,CAAC;IAEnF,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,GAAG,EAAE;QACX,oBAAoB;QACpB,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,qBAAqB,CAAC;SAClC,MAAM,CAAC,GAAG,EAAE;QACX,oBAAoB;QACpB,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,CAAC,IAAyB,EAAE,EAAE;QACpC,uBAAuB;QACvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,qBAAqB,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,yBAAyB;YACzB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,eAAe,YAAY,MAAM,CAAC,CAAC;QACxF,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qDAAqD,CAAC;SAClE,cAAc,CAAC,iBAAiB,EAAE,MAAM,CAAC;SACzC,cAAc,CAAC,iBAAiB,EAAE,sDAAsD,CAAC;SACzF,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC;SACpC,MAAM,CAAC,kBAAkB,EAAE,eAAe,EAAE,IAAI,CAAC;SACjD,MAAM,CAAC,CAAC,IAAqE,EAAE,EAAE;QAChF,sCAAsC;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,WAAW;YAChD,iFAAiF;YACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;YACtD,IAAI,IAA6B,CAAC;YAClC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,yCAAyC;YACjE,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAA4B,CAAC;YAC1D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,4BAA4B;gBAC5B,KAAK,GAAG,cAAc,CAAC;gBACvB,IAAI,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;YACvE,CAAC;YACD,sEAAsE;YACtE,IACE,KAAK,KAAK,cAAc;gBACxB,CAAE,cAAoC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAC3D,CAAC;gBACD,KAAK,GAAG,cAAc,CAAC;gBACvB,IAAI,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAC/E,CAAC;YACD,MAAM,UAAU,GAAe;gBAC7B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC5B,MAAM,EAAE,wBAAwB;gBAChC,SAAS,EAAE,QAAQ;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAqB;gBACjC,KAAK,EAAE,IAAI;gBACX,KAAK;gBACL,IAAI;aACL,CAAC;YACF,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,4BAA4B,CAAC;SACzC,cAAc,CAAC,eAAe,EAAE,WAAW,CAAC;SAC5C,MAAM,CAAC,cAAc,EAAE,8CAA8C,CAAC;SACtE,MAAM,CAAC,CAAC,IAAsC,EAAE,EAAE;QACjD,sFAAsF;QACtF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC3B,wEAAwE;QACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QACrD,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,4CAA4C;QAC1F,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,uDAAuD;QACvD,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtE,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CACzB,CAAC;QACF,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7E,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/commands/preflight.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * 构建 `forge preflight` 子命令组(沿 spec §2.8.5 第 3 项)。
+ * 当前含一个子命令 `branch-check`;后续 v1.1+ 可扩(git clean check / evidence fresh check 等)。
+ */
+export declare function buildPreflightCommand(): Command;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/cli/commands/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/preflight.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAyD/C"}

package/dist/cli/commands/preflight.js

@@ -0,0 +1,63 @@
+// src/cli/commands/preflight.ts — plan-9h Task 1 / plan-v1.1 P-9 refactor
+// 实施前置 check 子命令组(首个 preflight 命令组,commander 嵌套 addCommand)
+// 沿 spec §2.8.3 C 实施码 + spec §2.8.5 第 3 项 CLI helper 设计
+// plan-v1.1 P-9:git 探测 helper(isGitRepo / getCurrentBranch)抽出到 src/core/git/utils.ts
+// (plan-9h Q8 YAGNI 因 2+ 复用点解锁 — preflight.ts + migrate/index.ts:65-72)
+import { Command } from 'commander';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseConfig } from '../../core/parse/yaml.js';
+import { DEFAULT_PROTECTED_BRANCHES } from '../../core/schema/types.js';
+import { isGitRepo, getCurrentBranch } from '../../core/git/utils.js';
+/**
+ * 构建 `forge preflight` 子命令组(沿 spec §2.8.5 第 3 项)。
+ * 当前含一个子命令 `branch-check`;后续 v1.1+ 可扩(git clean check / evidence fresh check 等)。
+ */
+export function buildPreflightCommand() {
+    const cmd = new Command('preflight').description('实施前置 check(分支保护等;plan-9h §2.8)');
+    cmd
+        .command('branch-check [changeId]')
+        .description('check current branch vs protected_branches config(沿 design §2.8.3 C)')
+        .option('--allow-protected-branch', '显式覆盖保护(stderr 留 warning,exit 0)')
+        .action((changeId, opts) => {
+        const cwd = process.cwd();
+        // 非 git 项目:graceful skip(沿 v0.4 降级模式 + design §2.8.3 C line 1443)
+        if (!isGitRepo(cwd)) {
+            return; // exit 0
+        }
+        // 读 protected_branches:优先 forge/config.yaml,缺失 fallback DEFAULT_PROTECTED_BRANCHES
+        const configPath = join(cwd, 'forge', 'config.yaml');
+        let protectedBranches = DEFAULT_PROTECTED_BRANCHES;
+        if (existsSync(configPath)) {
+            try {
+                const config = parseConfig(readFileSync(configPath, 'utf-8'));
+                if (Array.isArray(config.protected_branches)) {
+                    protectedBranches = config.protected_branches;
+                }
+            }
+            catch (err) {
+                // parse 失败 → 视为 config 错误,exit 2(沿 §3.12.3 freeze)
+                console.error(`forge preflight: 解析 forge/config.yaml 失败: ${err.message}`);
+                process.exit(2);
+            }
+        }
+        const currentBranch = getCurrentBranch(cwd);
+        // 非保护分支 → 通过
+        if (!protectedBranches.includes(currentBranch)) {
+            return; // exit 0
+        }
+        // 在保护分支:有 --allow-protected-branch flag → exit 0 + stderr warning
+        if (opts.allowProtectedBranch) {
+            console.error(`forge preflight: 当前分支 '${currentBranch}' 是保护分支,` +
+                `用户传 --allow-protected-branch 显式覆盖。build/CI 风险自负。`);
+            return; // exit 0
+        }
+        // 默认拒签 → exit 2 + stderr 具体建议
+        const suggestedBranch = changeId ? `feature/${changeId}` : `feature/<your-change-id>`;
+        console.error(`forge preflight: 当前分支 '${currentBranch}' 是保护分支,拒绝在保护分支实施。\n` +
+            `建议: git checkout -b ${suggestedBranch},或加 --allow-protected-branch 覆盖`);
+        process.exit(2);
+    });
+    return cmd;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/cli/commands/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../src/cli/commands/preflight.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4DAA4D;AAC5D,wDAAwD;AACxD,qFAAqF;AACrF,wEAAwE;AAExE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC;IAEnF,GAAG;SACA,OAAO,CAAC,yBAAyB,CAAC;SAClC,WAAW,CAAC,sEAAsE,CAAC;SACnF,MAAM,CAAC,0BAA0B,EAAE,iCAAiC,CAAC;SACrE,MAAM,CAAC,CAAC,QAA4B,EAAE,IAAwC,EAAE,EAAE;QACjF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE1B,kEAAkE;QAClE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,SAAS;QACnB,CAAC;QAED,mFAAmF;QACnF,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACrD,IAAI,iBAAiB,GAAsB,0BAA0B,CAAC;QACtE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC;oBAC7C,iBAAiB,GAAG,MAAM,CAAC,kBAAkB,CAAC;gBAChD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,mDAAmD;gBACnD,OAAO,CAAC,KAAK,CAAC,6CAA8C,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAE5C,aAAa;QACb,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,SAAS;QACnB,CAAC;QAED,kEAAkE;QAClE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CACX,0BAA0B,aAAa,UAAU;gBAC/C,kDAAkD,CACrD,CAAC;YACF,OAAO,CAAC,SAAS;QACnB,CAAC;QAED,8BAA8B;QAC9B,MAAM,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC,CAAC,0BAA0B,CAAC;QACtF,OAAO,CAAC,KAAK,CACX,0BAA0B,aAAa,sBAAsB;YAC3D,uBAAuB,eAAe,iCAAiC,CAC1E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/commands/scope.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildScopeCommand(): Command;
+//# sourceMappingURL=scope.d.ts.map

package/dist/cli/commands/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scope.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,iBAAiB,IAAI,OAAO,CA8B3C"}

package/dist/cli/commands/scope.js

@@ -0,0 +1,32 @@
+// src/cli/commands/scope.ts
+// plan-9b Task 5 — forge scope <sub>
+import { Command } from 'commander';
+import { join } from 'node:path';
+import { scanArchivedFollowups } from '../../core/scope/index.js';
+export function buildScopeCommand() {
+    const scope = new Command('scope').description('out-of-scope / future-work / non-goal 跨 change 工具');
+    scope
+        .command('scan-archived-followups')
+        .description('扫 archived YAML 块输出 active entries(JSON)')
+        .argument('<changeId>', '新 change 的 id(供日志显示,不参与扫描)')
+        .action(async (_changeId) => {
+        try {
+            const forgeRoot = join(process.cwd(), 'forge');
+            const result = await scanArchivedFollowups(forgeRoot);
+            // stdout 输出完整 JSON(供下游解析)
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+            // 坏块逐条写 stderr,格式含 "skipping yaml block" 供测试/日志搜索
+            for (const s of result.skipped) {
+                process.stderr.write(`⚠ scope-aggregator: skipping yaml block in ${s.change}/${s.file} (${s.reason})\n`);
+            }
+            process.exit(0);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`✗ scope scan-archived-followups failed: ${msg}\n`);
+            process.exit(2);
+        }
+    });
+    return scope;
+}
+//# sourceMappingURL=scope.js.map

package/dist/cli/commands/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/cli/commands/scope.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,qCAAqC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAC5C,mDAAmD,CACpD,CAAC;IAEF,KAAK;SACF,OAAO,CAAC,yBAAyB,CAAC;SAClC,WAAW,CAAC,0CAA0C,CAAC;SACvD,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,SAAS,CAAC,CAAC;YACtD,0BAA0B;YAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC7D,kDAAkD;YAClD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8CAA8C,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CACnF,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,GAAG,IAAI,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/commands/stage-extensions.d.ts

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import type { ChildProcess } from 'node:child_process';
+import type { RoundOutcome, SeverityMap } from '../../core/stage-extensions/index.js';
+import type { ConvergenceConfig } from '../../core/schema/types.js';
+/** runOneRound 所有输入参数 */
+export interface RunOneRoundParams {
+    command: string;
+    promptFile: string | null;
+    threadId: string | null;
+    /** change ID(用于 ${CHANGE_ID} 模板变量替换;M-1 fix:此前硬编码空串) */
+    changeId: string;
+    outputFile: string;
+    spawnStartMs: number;
+    poll_interval_sec: number;
+    zombie_threshold_sec: number;
+    timeout_sec: number;
+    convergenceConfig: ConvergenceConfig;
+    severityMap: SeverityMap;
+}
+/**
+ * 执行单轮 codex review:spawn + watch + parse + judge。
+ * 导出供 F-6/F-7 直接调用测试(绕过 schema 校验的 timeout 下限限制)。
+ */
+export declare function runOneRound(params: RunOneRoundParams): Promise<RoundOutcome>;
+/**
+ * 终结 zombie/timeout 轮次进程。
+ * v4/v5 逻辑:
+ * 0. M-3 fix:进程已自然退出 → 直接 return(避免白等 6s + 减少 SIGKILL warning 噪声)
+ * 1. 入口先订阅 close 事件(避免错过)
+ * 2. 先 proc.kill(SIGTERM)
+ * 3. jobId 非 null → best-effort cancelCodexJob(5s 上限)
+ * 4. 等 SIGTERM close(3s);超时 → SIGKILL → 再次等 close(3s)
+ * 导出供 T-1 直接调用测试。
+ *
+ * @param cancelJob  远程 cancel 实现;默认用模块内 no-op stub。
+ *   仅作可注入接缝供 T-1 测试 cancelCodexJob reject 吞错路径 —— 生产调用
+ *   `terminateRound(proc, jobId)` 不传此参,默认行为完全不变。
+ */
+export declare function terminateRound(proc: ChildProcess, jobId: string | null, cancelJob?: (jobId: string) => Promise<void>): Promise<void>;
+/**
+ * 构建 `forge stage-extensions` 子命令组。
+ * 沿现有 buildXxxCommand() 模式注册 commander 子命令。
+ */
+export declare function buildStageExtensionsCommand(): Command;
+//# sourceMappingURL=stage-extensions.d.ts.map

package/dist/cli/commands/stage-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-extensions.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/stage-extensions.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASvD,OAAO,KAAK,EACV,YAAY,EAEZ,WAAW,EAGZ,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAiBpC,yBAAyB;AACzB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,WAAW,EAAE,WAAW,CAAC;CAC1B;AA+SD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2ElF;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,SAAS,GAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAkB,GAC3D,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAwKD;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CA8DrD"}