@accelerator-mzq/forge 1.4.0

package/dist/cli/commands/update.js

@@ -0,0 +1,98 @@
+// forge update 子命令 — 重铺 skills/commands 到所有已配置的 harness
+// 不改 config.yaml,不重新检测,直接读现有 forge/config.yaml 的 harness 字段
+// 若 config.yaml 不存在或无 harness 字段,接受 --harness 参数覆盖
+import { Command } from 'commander';
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseConfig } from '../../core/parse/index.js';
+import { ClaudeAdapter, CodexAdapter, deployAtomic, filterByHash, } from '../../core/harness-adapters/index.js';
+import { loadAllSkills, loadAllCommands, loadAllSharedDocs } from '../../core/templates/index.js';
+export function buildUpdateCommand() {
+    return new Command('update')
+        .description('Re-deploy forge skills/commands for all configured harnesses')
+        .option('--harness <list>', 'comma-separated harness ids (claude,codex); overrides config.yaml', '')
+        .option('--force', '强制覆盖已被用户修改的 skill / command 文件(SHA256 hash 比对决定是否覆盖)')
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        const forgeDir = join(cwd, 'forge');
+        const configPath = join(forgeDir, 'config.yaml');
+        // 1. 检查 forge/config.yaml 是否存在(判断项目是否已 init)
+        if (!existsSync(configPath)) {
+            console.error('✗ forge/config.yaml not found — run "forge init" first');
+            process.exit(1);
+        }
+        // 2. 读取 config.yaml,获取已保存的 harness 列表
+        const configText = await readFile(configPath, 'utf8');
+        const config = parseConfig(configText);
+        // 3. 确定 harness 列表:优先 --harness 参数,其次 config.yaml harness 字段
+        let selectedIds;
+        if (opts.harness) {
+            // 命令行参数优先(方便 CI 场景)
+            selectedIds = opts.harness
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        else if (Array.isArray(config.harness) && config.harness.length > 0) {
+            // 读 config.yaml 里记录的 harness 列表
+            selectedIds = config.harness.map(String);
+        }
+        else {
+            console.error('✗ No harness configured in forge/config.yaml and no --harness option provided.\n' +
+                '  Run "forge init" or pass --harness=claude,codex to specify.');
+            process.exit(1);
+        }
+        console.log(`Updating forge for: ${selectedIds.join(', ')}`);
+        // 4. 实例化 adapters
+        const adapters = [];
+        for (const id of selectedIds) {
+            if (id === 'claude') {
+                adapters.push(new ClaudeAdapter());
+            }
+            else if (id === 'codex') {
+                adapters.push(new CodexAdapter());
+            }
+            else if (id === 'opencode') {
+                // opencode 是 v0.2 计划,暂跳过
+                console.warn('OpenCode is v0.2 — skipping');
+            }
+            else {
+                throw new Error(`Unknown harness id: ${id}`);
+            }
+        }
+        if (adapters.length === 0) {
+            console.error('✗ No valid adapters to deploy');
+            process.exit(1);
+        }
+        // 5. 加载真实 templates(Plan 4)+ plan-9b sharedDocs
+        const skills = await loadAllSkills();
+        const commands = await loadAllCommands();
+        const sharedDocs = await loadAllSharedDocs(); // v2 plan-9b Task 7b:加载 _shared/*.md
+        const input = {
+            projectRoot: cwd,
+            skills, // LoadedSkill[] 兼容 SkillSpec[]
+            commands, // LoadedCommand[] 兼容 CommandSpec[]
+            sharedDocs, // 共用 reference docs 铺到 _shared 子目录
+        };
+        const plans = await Promise.all(adapters.map((a) => a.plan(input)));
+        // 6. hash 比对过滤
+        const force = opts.force ?? false;
+        const { filteredPlans, skippedModified, unchanged, toWrite } = await filterByHash(cwd, plans, force);
+        if (skippedModified.length > 0) {
+            console.warn(`⚠ ${skippedModified.length} 个文件已被用户修改,跳过(加 --force 覆盖):`);
+            for (const f of skippedModified)
+                console.warn(`  - ${f.relPath}`);
+        }
+        if (toWrite.length === 0) {
+            console.log(`✓ 全部 ${unchanged.length} 个文件已是最新`);
+            return;
+        }
+        await deployAtomic(cwd, filteredPlans);
+        const modifiedPart = skippedModified.length > 0
+            ? `;${skippedModified.length} 个已修改(跳过,加 --force 覆盖)`
+            : '';
+        console.log(`✓ forge updated: ${toWrite.length} 写入;${unchanged.length} 未变${modifiedPart}`);
+    });
+}
+//# sourceMappingURL=update.js.map

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

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

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

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

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

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

package/dist/cli/commands/upgrade.js

@@ -0,0 +1,277 @@
+// v0.3 Plan 4 Task 4.3 — `forge upgrade` 命令
+// 5 阶段事务:SCAN → SHOW DIFF → ASK → STASH → VERIFY → COMMIT
+// 关键不变量:ASK 阶段前完全只读;forge/ 产物 100% 不动(只清理 harness adapter 产物)
+import { Command } from 'commander';
+import { mkdir, rm, rename, writeFile, readFile, readdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { ClaudeAdapter } from '../../core/harness-adapters/claude.js';
+import { CodexAdapter } from '../../core/harness-adapters/codex.js';
+import { sha256OfFile } from '../../core/harness-adapters/legacy-detector.js';
+const STASH_PREFIX = '.forge-upgrade-stash-';
+const STASH_VALIDITY_MS = 24 * 60 * 60 * 1000; // 24h
+export function buildUpgradeCommand() {
+    const cmd = new Command('upgrade')
+        .description('Scan and clean legacy v0.2 harness adapter artifacts (forge/ 产物 100% 不动)')
+        .option('--dry-run', 'SHOW DIFF only, do not stash')
+        .option('--recover', 'restore stashed legacy artifacts (24h validity)')
+        .option('--gc', 'delete expired stashes (>24h)')
+        // plan-9j v3 BLOCKER 1 新增:option 形态 resign-markers(对齐 spec line 1763 + master line 503)
+        .option('--resign-markers <changeId>', 'plan-9j Task 2:一次性升级 v0.4 change marker 到 v1.0 schema(简码映射 + resigned_by_tool_version 字段)')
+        .action(async (opts) => {
+        // v3 BLOCKER 1:option 形态 — opts.resignMarkers 而非 subcommand argument
+        // 先处理 v0.3 现有 --recover/--gc/legacy upgrade 路径(不动);若 opts.resignMarkers 非空,走新分支
+        if (opts.resignMarkers) {
+            // CI 模式检测(沿 9a ack propose 同模式)
+            if (process.env['CI'] === 'true') {
+                process.stderr.write('forge upgrade --resign-markers: CI mode 拒绝(set ack.allow_ci_mode=true to override)\n');
+                process.exit(2);
+            }
+            const forgeRoot = join(process.cwd(), 'forge');
+            const { resignChangeMarkers } = await import('../../core/upgrade/resign-markers.js');
+            // v7 BLOCKER 1:计算 forgeCliPath(dist/cli/index.js 真路径,沿 process.argv[1] 或 import.meta.url 推导)
+            // process.argv[1] 是当前运行的入口脚本(即 dist/cli/index.js;npx forge 时同);测试可 mock
+            // v9 round 2 修(plan-9j code quality reviewer I-3):空 forgeCliPath 显式抛错,避免后续 spawn ENOENT 误导
+            const forgeCliPath = process.argv[1];
+            if (!forgeCliPath) {
+                process.stderr.write('forge upgrade --resign-markers: forge CLI path unavailable (process.argv[1] is empty);请通过 node 或 npx 调用\n');
+                process.exit(2);
+            }
+            const results = await resignChangeMarkers(forgeRoot, opts.resignMarkers, forgeCliPath);
+            // 输出报告
+            let allResigned = true;
+            let anyNeedsCPropose = false;
+            for (const r of results) {
+                if (r.kind === 'needs-c-propose') {
+                    anyNeedsCPropose = true;
+                    allResigned = false;
+                    // C 简码需用户介入:输出到 stderr(测试断言 stderr 含 "C 简码")
+                    process.stderr.write(r.message + '\n');
+                    process.stderr.write('请运行 `forge ack confirm <changeId> <findingId>` 处理 C 简码 pending ack 后重跑 resign-markers\n');
+                }
+                else {
+                    console.log(r.message);
+                }
+                if (r.kind === 'failed')
+                    allResigned = false;
+            }
+            if (anyNeedsCPropose)
+                process.exit(1);
+            if (!allResigned)
+                process.exit(1);
+            if (results.every((r) => r.kind === 'skipped-already-v1')) {
+                console.log(`✓ ${opts.resignMarkers}: 全部 marker 已是 v1.0+,无需 resign`);
+            }
+            else {
+                console.log(`✓ ${opts.resignMarkers}: marker 已升级,resigned_by_tool_version=1.0.0 + legacy meta`);
+            }
+            process.exit(0);
+        }
+        // v3:option 形态分支结束;后续走 v0.3 legacy adapter 清理路径
+        const projectRoot = process.cwd();
+        if (opts.recover) {
+            await runRecover(projectRoot);
+            return;
+        }
+        if (opts.gc) {
+            await runGc(projectRoot);
+            return;
+        }
+        await runUpgrade(projectRoot, opts);
+    });
+    return cmd;
+}
+async function runUpgrade(projectRoot, opts) {
+    // 阶段 1:SCAN(纯只读)
+    const adapters = [new ClaudeAdapter(), new CodexAdapter()];
+    const allArtifacts = [];
+    for (const adapter of adapters) {
+        const a = await adapter.detectLegacyArtifacts(projectRoot);
+        allArtifacts.push(...a);
+    }
+    // 阶段 2:SHOW DIFF(只读)
+    console.log(`Scanning legacy artifacts in ${projectRoot}...`);
+    if (allArtifacts.length === 0) {
+        console.log('No legacy artifacts found. Project is clean.');
+        return;
+    }
+    console.log(`Found ${allArtifacts.length} legacy paths:`);
+    for (const a of allArtifacts) {
+        console.log(`  ${a.relPath} (sha256: ${a.sha256.slice(0, 8)}...)`);
+    }
+    console.log('');
+    console.log('Note: forge/ artifacts (drafts/changes/specs/config) WILL NOT be touched.');
+    if (opts.dryRun) {
+        console.log('Dry run only. Re-run without --dry-run to proceed.');
+        return;
+    }
+    // 阶段 3:ASK(等用户输入)
+    const rl = createInterface({ input: stdin, output: stdout });
+    const answer = (await rl.question('Delete these legacy artifacts? [y/N]: ')).trim().toLowerCase();
+    rl.close();
+    if (answer !== 'y') {
+        console.log('Cancelled. No files touched.');
+        return;
+    }
+    // 阶段 4:STASH
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const stashDir = join(projectRoot, `${STASH_PREFIX}${ts}`);
+    await mkdir(stashDir, { recursive: true });
+    const moved = [];
+    for (const a of allArtifacts) {
+        const srcAbs = join(projectRoot, a.relPath);
+        const dstAbs = join(stashDir, a.relPath);
+        await mkdir(dirname(dstAbs), { recursive: true });
+        try {
+            await rename(srcAbs, dstAbs);
+            moved.push({ relPath: a.relPath, sha256: a.sha256 });
+        }
+        catch (err) {
+            // 反向 mv 已 stash 的回原位
+            console.error(`STASH failed at ${a.relPath}: ${err.message}\nReverting...`);
+            for (const m of moved) {
+                try {
+                    await rename(join(stashDir, m.relPath), join(projectRoot, m.relPath));
+                }
+                catch {
+                    /* best effort */
+                }
+            }
+            await rm(stashDir, { recursive: true, force: true });
+            process.exit(1);
+        }
+    }
+    // 写 manifest
+    const manifest = { ts, projectRoot, artifacts: moved };
+    await writeFile(join(stashDir, '.manifest.json'), JSON.stringify(manifest, null, 2), 'utf8');
+    // 阶段 5:VERIFY(读 stash 验 hash 与 SCAN 一致)
+    for (const m of moved) {
+        const stashedAbs = join(stashDir, m.relPath);
+        const stashedSha = await sha256OfFile(stashedAbs);
+        if (stashedSha !== m.sha256) {
+            console.error(`VERIFY failed at ${m.relPath}: hash mismatch\nReverting...`);
+            for (const x of moved) {
+                try {
+                    await rename(join(stashDir, x.relPath), join(projectRoot, x.relPath));
+                }
+                catch {
+                    /* best effort */
+                }
+            }
+            await rm(stashDir, { recursive: true, force: true });
+            process.exit(1);
+        }
+    }
+    // 阶段 6:COMMIT(默认不删 stash 24h)
+    console.log('');
+    console.log(`✓ Stashed ${moved.length} legacy artifacts to ${stashDir}`);
+    console.log('  --recover: restore (24h validity)');
+    console.log('  --gc: delete expired stashes (>24h)');
+    console.log('');
+    console.log('Next: install forge plugin (Tier 1 Claude Code):');
+    console.log('  /plugin marketplace add Accelerator-mzq/forge');
+    console.log('  /plugin install forge@accelerator-mzq-forge');
+    console.log('  /reload-plugins');
+    console.log('');
+    console.log('OpenCode/Codex install: see docs/opencode-install.md / codex-install.md');
+}
+async function runRecover(projectRoot) {
+    const stashDirs = await findStashes(projectRoot);
+    if (stashDirs.length === 0) {
+        console.log('No stash to recover.');
+        return;
+    }
+    // 取最新(按 ts 排序,最大 = 最新)
+    stashDirs.sort();
+    const latestStash = stashDirs[stashDirs.length - 1];
+    const stashAbs = join(projectRoot, latestStash);
+    // 读 manifest
+    const manifestPath = join(stashAbs, '.manifest.json');
+    if (!existsSync(manifestPath)) {
+        console.error(`Stash 缺 manifest.json: ${latestStash}`);
+        process.exit(1);
+    }
+    const manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
+    // 验 24h 有效期
+    const tsParsed = parseStashTs(manifest.ts);
+    if (tsParsed === null) {
+        console.error(`Stash ts 不可解析: ${manifest.ts}`);
+        process.exit(1);
+    }
+    const ageMs = Date.now() - tsParsed.getTime();
+    if (ageMs > STASH_VALIDITY_MS) {
+        console.error(`Stash 已过期(${(ageMs / (60 * 60 * 1000)).toFixed(1)}h > 24h),建议跑 --gc 清理`);
+        process.exit(1);
+    }
+    // rename 回原位 + 验 hash
+    for (const a of manifest.artifacts) {
+        const stashedAbs = join(stashAbs, a.relPath);
+        const stashedSha = await sha256OfFile(stashedAbs);
+        if (stashedSha !== a.sha256) {
+            console.error(`Stash 文件被外部修改 (${a.relPath}),hash mismatch,拒绝 recover`);
+            process.exit(1);
+        }
+        const dstAbs = join(projectRoot, a.relPath);
+        await mkdir(dirname(dstAbs), { recursive: true });
+        await rename(stashedAbs, dstAbs);
+    }
+    // 删 stash 目录
+    await rm(stashAbs, { recursive: true, force: true });
+    console.log(`✓ Recovered ${manifest.artifacts.length} artifacts from ${latestStash}`);
+    console.log('Stash 已删除。');
+}
+async function runGc(projectRoot) {
+    const stashDirs = await findStashes(projectRoot);
+    if (stashDirs.length === 0) {
+        console.log('No stash to gc.');
+        return;
+    }
+    let deleted = 0;
+    for (const stashName of stashDirs) {
+        const manifestPath = join(projectRoot, stashName, '.manifest.json');
+        if (!existsSync(manifestPath))
+            continue;
+        let manifest;
+        try {
+            manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        const tsParsed = parseStashTs(manifest.ts);
+        if (tsParsed === null)
+            continue;
+        const ageMs = Date.now() - tsParsed.getTime();
+        if (ageMs > STASH_VALIDITY_MS) {
+            await rm(join(projectRoot, stashName), { recursive: true, force: true });
+            deleted++;
+            console.log(`✓ gc: ${stashName}`);
+        }
+    }
+    console.log(`Deleted ${deleted} expired stashes.`);
+}
+/** 找 projectRoot 下所有 .forge-upgrade-stash-* 目录(按名称返回) */
+async function findStashes(projectRoot) {
+    let entries;
+    try {
+        entries = await readdir(projectRoot);
+    }
+    catch {
+        return [];
+    }
+    return entries.filter((n) => n.startsWith(STASH_PREFIX));
+}
+/** 把 ts 字符串(`2026-05-09T12-34-56-789Z`)解析为 Date */
+function parseStashTs(ts) {
+    // 反 ISO:`2026-05-09T12-34-56-789Z` → `2026-05-09T12:34:56.789Z`
+    const match = ts.match(/^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z$/);
+    if (!match)
+        return null;
+    const [, date, h, m, s, ms] = match;
+    const iso = `${date}T${h}:${m}:${s}.${ms}Z`;
+    const d = new Date(iso);
+    return isNaN(d.getTime()) ? null : d;
+}
+//# sourceMappingURL=upgrade.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,oBAAoB,IAAI,OAAO,CAiE9C"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,66 @@
+// forge validate 子命令 — 验证 change 目录
+// v2 B2 修订:exit 0/1/2 三档(沿 master §3.12.3 freeze)
+// exit 0 = 全 PASS;exit 1 = CRITICAL findings 存在;exit 2 = fs/config 错
+// plan-9g Task 5.4:加 --verify-process flag(单独跑 process_evidence 子检)
+import { Command } from 'commander';
+import { join } from 'node:path';
+import { validateChange } from '../../core/validate/index.js';
+import { crossCuttingFenceCheck } from '../../core/archive/fence.js';
+export function buildValidateCommand() {
+    return new Command('validate')
+        .argument('<changeId>', 'change directory id (e.g., add-login)')
+        .description('Validate a change directory')
+        .option('--verify-process', 'plan-9g:单独跑 process_evidence 子检(14 不变量 fence;不跑其他 validate 步骤)')
+        .action(async (changeId, opts) => {
+        // 构建 change 目录路径: <cwd>/forge/changes/<changeId>
+        const changeDir = join(process.cwd(), 'forge', 'changes', changeId);
+        // --verify-process:仅跑 crossCuttingFenceCheck process_evidence 子检
+        if (opts.verifyProcess) {
+            let fenceResult;
+            try {
+                fenceResult = await crossCuttingFenceCheck(changeDir);
+            }
+            catch (err) {
+                console.error(`✗ process_evidence fence error: ${err instanceof Error ? err.message : String(err)}`);
+                process.exit(2);
+            }
+            if (fenceResult.ok) {
+                console.log(`✓ ${changeId}: process_evidence fence PASS (14 invariants)`);
+                process.exit(0);
+            }
+            console.error(`✗ ${changeId}: process_evidence fence FAIL`);
+            for (const r of fenceResult.results) {
+                if (!r.ok)
+                    console.error(`  - ${r.invariant}: ${r.reason}`);
+            }
+            process.exit(1);
+        }
+        const result = await validateChange(changeDir);
+        if (result.valid) {
+            // 验证成功 → stdout + exit 0
+            console.log(`✓ ${changeId}: valid`);
+            // v4 D-3 修订:打印 warnings(stub 提示等),让 CI 用户看到 not_implemented 信号
+            for (const w of result.warnings) {
+                const prefix = w.message.startsWith('[stub]') ? '⚠' : 'ℹ';
+                console.warn(`  ${prefix} [${w.artifact}] ${w.message}`);
+            }
+            process.exit(0);
+        }
+        // v2 B2 修订:exit 1 if any CRITICAL,否则 exit 2(fs/config 类错)
+        const hasCritical = result.errors.some((e) => e.severity === 'CRITICAL');
+        const exitCode = hasCritical ? 1 : 2;
+        console.error(`✗ ${changeId}: ${result.errors.length} errors`);
+        for (const e of result.errors) {
+            // 输出加 severity prefix + finding_hash suffix
+            const sevPrefix = e.severity ? `[${e.severity}] ` : '';
+            const hashSuffix = e.finding_hash ? ` (finding_hash=${e.finding_hash.slice(0, 8)}...)` : '';
+            console.error(`  - ${sevPrefix}[${e.artifact}] ${e.field ?? ''}: ${e.message}${e.file ? ` (${e.file}${e.line ? `:${e.line}` : ''})` : ''}${hashSuffix}`);
+        }
+        // v4 D-3:invalid 也输出 warnings
+        for (const w of result.warnings) {
+            console.warn(`  ⚠ [${w.artifact}] ${w.message}`);
+        }
+        process.exit(exitCode);
+    });
+}
+//# sourceMappingURL=validate.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// forge CLI 入口 — Plan 3 起填实
+import { Command } from 'commander';
+import { FORGE_VERSION } from '../index.js';
+import { buildConfigCommand } from './commands/config.js';
+import { buildValidateCommand } from './commands/validate.js';
+import { buildInitCommand } from './commands/init.js';
+import { buildUpdateCommand } from './commands/update.js';
+import { buildArchiveCommand } from './commands/archive.js';
+import { buildLegacyBridgeCommand } from './commands/legacy-bridge.js';
+import { buildUpgradeCommand } from './commands/upgrade.js';
+import { buildMigrateCommand } from './commands/migrate.js';
+import { buildAckCommand } from './commands/ack.js';
+import { buildEvidenceCommand } from './commands/evidence.js';
+import { buildScopeCommand } from './commands/scope.js';
+import { buildFindingCommand } from './commands/finding.js';
+import { buildPreflightCommand } from './commands/preflight.js';
+import { buildStageExtensionsCommand } from './commands/stage-extensions.js';
+import { buildBacklogCommand } from './commands/backlog.js';
+import { buildMonitorCommand } from './commands/monitor.js';
+import { maybeRecordCliExit } from '../core/monitor/exit-handler.js';
+// 创建主命令
+const program = new Command();
+program
+    .name('forge')
+    .description('OpenSpec × superpowers fusion: spec-driven CLI with multi-harness adapters')
+    .version(FORGE_VERSION);
+// 注册 config 子命令
+program.addCommand(buildConfigCommand());
+// 注册 validate 子命令
+program.addCommand(buildValidateCommand());
+// 注册 init 子命令
+program.addCommand(buildInitCommand());
+// 注册 update 子命令(Task 17)
+program.addCommand(buildUpdateCommand());
+// 注册 archive 子命令(Task 17)
+program.addCommand(buildArchiveCommand());
+// 注册 legacy-bridge 子命令(Plan 7 Phase A 骨架)
+program.addCommand(buildLegacyBridgeCommand());
+// 注册 upgrade 子命令(v0.3 Plan 4 — v0.2→v0.3 legacy 清理)
+program.addCommand(buildUpgradeCommand());
+// 注册 migrate 子命令(v0.4 — 搬运 OpenSpec / superpowers 项目仓库)
+program.addCommand(buildMigrateCommand());
+// 注册 ack 子命令(plan-9a Task 3 — 两步 user 确认协议)
+program.addCommand(buildAckCommand());
+// 注册 evidence 子命令(plan-9a Task 5 — evidence helper 记录框架)
+program.addCommand(buildEvidenceCommand());
+// 注册 scope 子命令(plan-9b Task 5 — scope aggregator)
+program.addCommand(buildScopeCommand());
+// 注册 finding 子命令(plan-9d Task 4 — finding hash helper)
+program.addCommand(buildFindingCommand());
+// 注册 preflight 子命令组(plan-9h §2.8.3 C — main/master 分支保护)
+program.addCommand(buildPreflightCommand());
+// 注册 stage-extensions 子命令组(plan-stage-extensions Task 5 — runner CLI)
+program.addCommand(buildStageExtensionsCommand());
+// 注册 backlog 子命令(plan-backlog-registry)
+program.addCommand(buildBacklogCommand());
+// 注册 monitor 子命令组(plan-workflow-monitor)
+program.addCommand(buildMonitorCommand());
+// workflow-monitor:唯一的 CLI 侧埋点(spec §4)。config 守卫确保关闭时零行为。
+process.on('exit', (code) => {
+    maybeRecordCliExit(process.cwd(), process.argv.slice(2), code);
+});
+// 解析命令行参数,遇到错误时打印并退出
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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