@accelerator-mzq/forge 1.4.0

package/dist/core/harness-adapters/codex.js

@@ -0,0 +1,60 @@
+// Codex adapter — 铺到 .agents/skills/forge-<name>/SKILL.md
+// 关键:Phase 0.5 spike 实测 Codex 用 .agents/(共享 Claude Agent SDK 约定),不是 .codex/
+// v0.3 Plan 4:加 LegacyDetector 实现(forge upgrade 用)
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { detectLegacySkills, detectLegacyCommands } from './legacy-detector.js';
+export class CodexAdapter {
+    id = 'codex';
+    async detect(projectRoot) {
+        const target = join(projectRoot, '.agents');
+        try {
+            await stat(target);
+            return { id: this.id, detected: true, detectedAt: '.agents' };
+        }
+        catch {
+            return { id: this.id, detected: false };
+        }
+    }
+    async plan(input) {
+        const files = [];
+        for (const skill of input.skills) {
+            files.push({
+                relPath: `.agents/skills/forge-${skill.name}/SKILL.md`,
+                content: skill.content,
+            });
+        }
+        // Codex 暂不需要 commands(spike 阶段只验 skills 自动注入即可触发 brainstorming)
+        // commands 模板在 Plan 4 完整 v0.1 时再决定是否需要(可能用 plugin manifest 形式)
+        if (input.commands.length > 0) {
+            // forge v0.1 先把 commands 写到 .agents/commands/forge/<name>.md(对称 Claude 路径)
+            // v0.2 视 Codex 实际行为调整
+            for (const cmd of input.commands) {
+                files.push({
+                    relPath: `.agents/commands/forge/${cmd.name}.md`,
+                    content: cmd.content,
+                });
+            }
+        }
+        // v2 plan-9b Task 7b:共用 reference docs 铺到 codex 对应 _shared 容器
+        // 路径沿 .agents/skills/forge-<name>/ 约定,_shared 作为伪 skill 容器
+        for (const doc of input.sharedDocs ?? []) {
+            files.push({
+                relPath: `.agents/skills/forge-_shared/${doc.name}.md`,
+                content: doc.content,
+            });
+        }
+        return { files };
+    }
+    /**
+     * v0.3 Plan 4 — 扫 `.agents/skills/forge-{name}/SKILL.md` + `.agents/commands/forge/{name}.md`
+     * legacy v0.2 codex adapter 产物,供 `forge upgrade` 5 阶段事务使用。
+     * 注意:Codex 实际写到 `.agents/`(共享 Agent SDK 约定),不是 `.codex/`。
+     */
+    async detectLegacyArtifacts(projectRoot) {
+        const skills = await detectLegacySkills(projectRoot, '.agents');
+        const commands = await detectLegacyCommands(projectRoot, '.agents');
+        return [...skills, ...commands];
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/core/harness-adapters/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/codex.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,4EAA4E;AAC5E,mDAAmD;AAEnD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,OAAO,YAAY;IACd,EAAE,GAAG,OAAgB,CAAC;IAE/B,KAAK,CAAC,MAAM,CAAC,WAAmB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC3B,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,wBAAwB,KAAK,CAAC,IAAI,WAAW;gBACtD,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;QACD,gEAAgE;QAChE,+DAA+D;QAC/D,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,2EAA2E;YAC3E,sBAAsB;YACtB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC;oBACT,OAAO,EAAE,0BAA0B,GAAG,CAAC,IAAI,KAAK;oBAChD,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,8DAA8D;QAC9D,2DAA2D;QAC3D,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,gCAAgC,GAAG,CAAC,IAAI,KAAK;gBACtD,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QAC7C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/core/harness-adapters/detector.d.ts

@@ -0,0 +1,15 @@
+import type { HarnessId, HarnessDetection } from './types.js';
+/**
+ * 检测单个 harness
+ * @param projectRoot 项目根目录
+ * @param id harness 标识(claude/codex/opencode)
+ * @returns 检测结果(是否已安装 + 检测到的路径)
+ */
+export declare function detect(projectRoot: string, id: HarnessId): Promise<HarnessDetection>;
+/**
+ * 检测所有 harness
+ * @param projectRoot 项目根目录
+ * @returns 三个 harness 的检测结果数组
+ */
+export declare function detectAll(projectRoot: string): Promise<HarnessDetection[]>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/core/harness-adapters/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/detector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmB9D;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAS1F;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAGhF"}

package/dist/core/harness-adapters/detector.js

@@ -0,0 +1,45 @@
+// harness 检测 — 看项目里是否有 .claude/ / .agents/ / .opencode/
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+// 各 harness 的检测路径(基于 Phase 0.5 spike 实测)
+const DETECTION_PATHS = {
+    claude: ['.claude'], // Claude Code 配置目录
+    codex: ['.agents'], // 共享 Claude Agent SDK 约定(不是 .codex/)
+    opencode: ['.opencode', 'AGENTS.md'], // .opencode/ 或 AGENTS.md marker
+};
+/** 检查路径是否存在 */
+async function pathExists(p) {
+    try {
+        await stat(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检测单个 harness
+ * @param projectRoot 项目根目录
+ * @param id harness 标识(claude/codex/opencode)
+ * @returns 检测结果(是否已安装 + 检测到的路径)
+ */
+export async function detect(projectRoot, id) {
+    const candidates = DETECTION_PATHS[id];
+    for (const rel of candidates) {
+        const abs = join(projectRoot, rel);
+        if (await pathExists(abs)) {
+            return { id, detected: true, detectedAt: rel };
+        }
+    }
+    return { id, detected: false };
+}
+/**
+ * 检测所有 harness
+ * @param projectRoot 项目根目录
+ * @returns 三个 harness 的检测结果数组
+ */
+export async function detectAll(projectRoot) {
+    const ids = ['claude', 'codex', 'opencode'];
+    return Promise.all(ids.map((id) => detect(projectRoot, id)));
+}
+//# sourceMappingURL=detector.js.map

package/dist/core/harness-adapters/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/detector.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,yCAAyC;AACzC,MAAM,eAAe,GAAgC;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,mBAAmB;IACxC,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,qCAAqC;IACzD,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,gCAAgC;CACvE,CAAC;AAEF,eAAe;AACf,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,WAAmB,EAAE,EAAa;IAC7D,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB;IACjD,MAAM,GAAG,GAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACzD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/core/harness-adapters/hash-compare.d.ts

@@ -0,0 +1,21 @@
+import type { DeployPlan, PlannedFile } from './interface.js';
+export interface HashCompareResult {
+    /** 真正会传给 deployAtomic 的 plans(只含要写的文件) */
+    filteredPlans: DeployPlan[];
+    /** 已存在且被改但未 --force → 跳过 + 警告用户 */
+    skippedModified: PlannedFile[];
+    /** 已存在且 hash 与 shipped 相同 → no-op */
+    unchanged: PlannedFile[];
+    /** 实际要写(新增 + force 覆盖) */
+    toWrite: PlannedFile[];
+}
+/**
+ * 按 SHA256 hash 比对决定每个 PlannedFile 的处置。
+ *
+ * - 目标不存在 → toWrite
+ * - 目标存在且 sha256(existing) == sha256(shipped) → unchanged(no-op)
+ * - 目标存在且 hash 不同 + force=false → skippedModified(警告)
+ * - 目标存在且 hash 不同 + force=true → toWrite(覆盖)
+ */
+export declare function filterByHash(projectRoot: string, plans: DeployPlan[], force: boolean): Promise<HashCompareResult>;
+//# sourceMappingURL=hash-compare.d.ts.map

package/dist/core/harness-adapters/hash-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-compare.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/hash-compare.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B,mCAAmC;IACnC,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,qCAAqC;IACrC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,0BAA0B;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,iBAAiB,CAAC,CA+B5B"}

package/dist/core/harness-adapters/hash-compare.js

@@ -0,0 +1,49 @@
+// hash 比对 — 决定 deployAtomic 实际要写哪些文件
+// spec §4.2 已存在 + 用户改动场景的 --force 覆盖语义
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+/**
+ * 按 SHA256 hash 比对决定每个 PlannedFile 的处置。
+ *
+ * - 目标不存在 → toWrite
+ * - 目标存在且 sha256(existing) == sha256(shipped) → unchanged(no-op)
+ * - 目标存在且 hash 不同 + force=false → skippedModified(警告)
+ * - 目标存在且 hash 不同 + force=true → toWrite(覆盖)
+ */
+export async function filterByHash(projectRoot, plans, force) {
+    const skippedModified = [];
+    const unchanged = [];
+    const toWrite = [];
+    for (const plan of plans) {
+        for (const f of plan.files) {
+            // 注意:existsSync + readFile 存在 TOCTOU 窗口,单进程 CLI 场景可接受
+            const targetAbs = join(projectRoot, f.relPath);
+            if (!existsSync(targetAbs)) {
+                toWrite.push(f);
+                continue;
+            }
+            const existing = await readFile(targetAbs, 'utf8');
+            if (sha256(existing) === sha256(f.content)) {
+                unchanged.push(f);
+            }
+            else if (force) {
+                toWrite.push(f);
+            }
+            else {
+                skippedModified.push(f);
+            }
+        }
+    }
+    // 重新组装 plans:每个 plan 仅含 toWrite 中的文件
+    const toWriteSet = new Set(toWrite);
+    const filteredPlans = plans.map((plan) => ({
+        files: plan.files.filter((f) => toWriteSet.has(f)),
+    }));
+    return { filteredPlans, skippedModified, unchanged, toWrite };
+}
+function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+//# sourceMappingURL=hash-compare.js.map

package/dist/core/harness-adapters/hash-compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-compare.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/hash-compare.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,uCAAuC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,KAAmB,EACnB,KAAc;IAEd,MAAM,eAAe,GAAkB,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,sDAAsD;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3C,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;iBAAM,IAAI,KAAK,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,aAAa,GAAiB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACnD,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC"}

package/dist/core/harness-adapters/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './interface.js';
+export * from './detector.js';
+export * from './transaction.js';
+export * from './claude.js';
+export * from './codex.js';
+export { filterByHash, type HashCompareResult } from './hash-compare.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/harness-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/harness-adapters/index.js

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './interface.js';
+export * from './detector.js';
+export * from './transaction.js';
+export * from './claude.js';
+export * from './codex.js';
+export { filterByHash } from './hash-compare.js';
+//# sourceMappingURL=index.js.map

package/dist/core/harness-adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC"}

package/dist/core/harness-adapters/interface.d.ts

@@ -0,0 +1,52 @@
+import type { HarnessId, DeployInput, HarnessDetection } from './types.js';
+export interface HarnessAdapter {
+    /** harness 标识 */
+    readonly id: HarnessId;
+    /**
+     * 检测当前 projectRoot 下是否有该 harness 的痕迹(已装/启用)。
+     * 用于 `forge init` 时给用户看 default 选项。
+     */
+    detect(projectRoot: string): Promise<HarnessDetection>;
+    /**
+     * 计算该 adapter 部署后的目标文件列表(相对 projectRoot 的路径 + 内容)。
+     * 这是"纯函数"步骤 — 不写 fs。
+     * Plan 3 transaction 用这个结果做 Stage 阶段的预生成。
+     */
+    plan(input: DeployInput): Promise<DeployPlan>;
+}
+/** plan() 输出:目标文件清单 */
+export interface DeployPlan {
+    files: PlannedFile[];
+}
+export interface PlannedFile {
+    /** 相对 projectRoot 的路径(POSIX 风格) */
+    relPath: string;
+    /** 文件内容 */
+    content: string;
+}
+/**
+ * v0.3 Plan 4 — Legacy adapter 产物探测(`forge upgrade` 用)
+ * v0.2 forge init 写到项目级 `.claude/skills/forge-{name}/SKILL.md` + `.claude/commands/forge/{name}.md`
+ * v0.3 plugin 路径不再用项目级 — 这些 legacy 产物需要扫出来 + 询问后清理(`forge upgrade`)
+ *
+ * spec §3.2 数据流 5 阶段事务化(SCAN → SHOW DIFF → ASK → STASH → VERIFY → COMMIT)。
+ */
+export interface LegacyArtifact {
+    /** 相对 projectRoot 的路径(POSIX 风格) */
+    relPath: string;
+    /** 文件内容 sha256(用于 SHOW DIFF + STASH 后 VERIFY hash 一致) */
+    sha256: string;
+    /** 文件类型 */
+    type: 'skill' | 'command';
+}
+export interface LegacyDetector {
+    /**
+     * 扫 projectRoot 内 v0.2 adapter 写过的 legacy 路径。
+     * 返回所有可清理产物清单 + sha256(纯只读,5 阶段事务的 SCAN 阶段)。
+     *
+     * @param projectRoot — 用户项目根目录
+     * @returns LegacyArtifact 数组,空数组表示项目没 legacy adapter 产物
+     */
+    detectLegacyArtifacts(projectRoot: string): Promise<LegacyArtifact[]>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/core/harness-adapters/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,iBAAiB;IACjB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAEvB;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEvD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/C;AAED,uBAAuB;AACvB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE"}

package/dist/core/harness-adapters/interface.js

@@ -0,0 +1,3 @@
+// HarnessAdapter — 每个 harness 一个实现 — spec §2.1
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/core/harness-adapters/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/interface.ts"],"names":[],"mappings":"AAAA,+CAA+C"}

package/dist/core/harness-adapters/legacy-detector.d.ts

@@ -0,0 +1,14 @@
+import type { LegacyArtifact } from './interface.js';
+/** sha256 of file content(hex string) */
+export declare function sha256OfFile(absPath: string): Promise<string>;
+/**
+ * 扫 `<projectRoot>/<skillsParent>/skills/forge-{name}/SKILL.md` 形态的 legacy skill 产物。
+ * Claude:`skillsParent = '.claude'`;Codex:`skillsParent = '.agents'`。
+ */
+export declare function detectLegacySkills(projectRoot: string, skillsParent: string): Promise<LegacyArtifact[]>;
+/**
+ * 扫 `<projectRoot>/<commandsParent>/commands/forge/*.md` 形态的 legacy command 产物。
+ * Claude:`commandsParent = '.claude'`;Codex:`commandsParent = '.agents'`。
+ */
+export declare function detectLegacyCommands(projectRoot: string, commandsParent: string): Promise<LegacyArtifact[]>;
+//# sourceMappingURL=legacy-detector.d.ts.map

package/dist/core/harness-adapters/legacy-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-detector.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/legacy-detector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,yCAAyC;AACzC,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CA+B3B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CA8B3B"}

package/dist/core/harness-adapters/legacy-detector.js

@@ -0,0 +1,83 @@
+// Plan 4 Task 4.2 — LegacyDetector 共享 helper(scan + sha256)
+// 由 ClaudeAdapter + CodexAdapter 复用。
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+/** sha256 of file content(hex string) */
+export async function sha256OfFile(absPath) {
+    const content = await readFile(absPath);
+    return createHash('sha256').update(content).digest('hex');
+}
+/**
+ * 扫 `<projectRoot>/<skillsParent>/skills/forge-{name}/SKILL.md` 形态的 legacy skill 产物。
+ * Claude:`skillsParent = '.claude'`;Codex:`skillsParent = '.agents'`。
+ */
+export async function detectLegacySkills(projectRoot, skillsParent) {
+    const artifacts = [];
+    const skillsDir = join(projectRoot, skillsParent, 'skills');
+    if (!existsSync(skillsDir))
+        return artifacts;
+    let entries;
+    try {
+        entries = await readdir(skillsDir);
+    }
+    catch {
+        return artifacts;
+    }
+    for (const name of entries) {
+        if (!name.startsWith('forge-'))
+            continue;
+        const skillFile = join(skillsDir, name, 'SKILL.md');
+        try {
+            await stat(skillFile);
+            const relPath = `${skillsParent}/skills/${name}/SKILL.md`;
+            artifacts.push({
+                // POSIX-style:确保 Windows 反斜杠不混入
+                relPath: relPath.split('\\').join('/'),
+                sha256: await sha256OfFile(skillFile),
+                type: 'skill',
+            });
+        }
+        catch {
+            // 单文件缺失,跳
+        }
+    }
+    return artifacts;
+}
+/**
+ * 扫 `<projectRoot>/<commandsParent>/commands/forge/*.md` 形态的 legacy command 产物。
+ * Claude:`commandsParent = '.claude'`;Codex:`commandsParent = '.agents'`。
+ */
+export async function detectLegacyCommands(projectRoot, commandsParent) {
+    const artifacts = [];
+    const cmdsDir = join(projectRoot, commandsParent, 'commands', 'forge');
+    if (!existsSync(cmdsDir))
+        return artifacts;
+    let entries;
+    try {
+        entries = await readdir(cmdsDir);
+    }
+    catch {
+        return artifacts;
+    }
+    for (const name of entries) {
+        if (!name.endsWith('.md'))
+            continue;
+        const cmdFile = join(cmdsDir, name);
+        try {
+            await stat(cmdFile);
+            const relPath = `${commandsParent}/commands/forge/${name}`;
+            artifacts.push({
+                relPath: relPath.split('\\').join('/'),
+                sha256: await sha256OfFile(cmdFile),
+                type: 'command',
+            });
+        }
+        catch {
+            // 跳
+        }
+    }
+    return artifacts;
+}
+//# sourceMappingURL=legacy-detector.js.map

package/dist/core/harness-adapters/legacy-detector.js.map

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

package/dist/core/harness-adapters/transaction.d.ts

@@ -0,0 +1,12 @@
+import type { DeployPlan } from './interface.js';
+/**
+ * 部署多个 plan 到 projectRoot,使用 Stage→Backup→Commit 三阶段原子化(spec §4.2)。
+ *
+ * 1. **Stage**:把所有 plan 的文件先写到 forge/.cache/staging-<pid>/ 镜像目录
+ * 2. **Backup**:对每个目标位置(若已存在),备份到 forge/.cache/backup-<pid>/
+ * 3. **Commit**:逐个目标 rm 旧 + rename staging → 目标
+ *    - 任一失败 → 反向回滚:已 rename 的 adapter 从 backup 恢复
+ *    - 反向回滚也失败 → abort,退出码 3,人工介入
+ */
+export declare function deployAtomic(projectRoot: string, plans: DeployPlan[]): Promise<void>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/core/harness-adapters/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/transaction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF1F"}

package/dist/core/harness-adapters/transaction.js

@@ -0,0 +1,113 @@
+// adapter 三阶段原子化部署 — spec §4.2
+import { mkdir, writeFile, rename, rm, cp } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+/**
+ * 部署多个 plan 到 projectRoot,使用 Stage→Backup→Commit 三阶段原子化(spec §4.2)。
+ *
+ * 1. **Stage**:把所有 plan 的文件先写到 forge/.cache/staging-<pid>/ 镜像目录
+ * 2. **Backup**:对每个目标位置(若已存在),备份到 forge/.cache/backup-<pid>/
+ * 3. **Commit**:逐个目标 rm 旧 + rename staging → 目标
+ *    - 任一失败 → 反向回滚:已 rename 的 adapter 从 backup 恢复
+ *    - 反向回滚也失败 → abort,退出码 3,人工介入
+ */
+export async function deployAtomic(projectRoot, plans) {
+    const pid = process.pid;
+    const cacheDir = join(projectRoot, 'forge', '.cache');
+    const stagingDir = join(cacheDir, `staging-${pid}`);
+    const backupDir = join(cacheDir, `backup-${pid}`);
+    // 确保 cache 父目录存在
+    await mkdir(cacheDir, { recursive: true });
+    // 收集所有计划文件
+    const allFiles = plans.flatMap((p) => p.files);
+    // 阶段 1:Stage
+    try {
+        for (const f of allFiles) {
+            const stagedAbs = join(stagingDir, f.relPath);
+            await mkdir(dirname(stagedAbs), { recursive: true });
+            await writeFile(stagedAbs, f.content, 'utf8');
+        }
+    }
+    catch (err) {
+        await rm(stagingDir, { recursive: true, force: true });
+        throw new Error(`Stage failed: ${err.message}`);
+    }
+    // 阶段 2:Backup(对每个**顶层目标目录**备份,而不是对每个文件)
+    // 收集 plan 目标 top-level dirs(如 .claude/skills/forge-using-forge/)
+    const targetDirs = collectTargetDirs(allFiles);
+    try {
+        for (const targetRel of targetDirs) {
+            const targetAbs = join(projectRoot, targetRel);
+            if (existsSync(targetAbs)) {
+                const backupAbs = join(backupDir, targetRel);
+                await mkdir(dirname(backupAbs), { recursive: true });
+                await cp(targetAbs, backupAbs, { recursive: true });
+            }
+        }
+    }
+    catch (err) {
+        await rm(stagingDir, { recursive: true, force: true });
+        await rm(backupDir, { recursive: true, force: true });
+        throw new Error(`Backup failed: ${err.message}`);
+    }
+    // 阶段 3:Commit(逐文件 rename)
+    const committed = [];
+    try {
+        for (const f of allFiles) {
+            const stagedAbs = join(stagingDir, f.relPath);
+            const targetAbs = join(projectRoot, f.relPath);
+            await mkdir(dirname(targetAbs), { recursive: true });
+            // 已存在则先删
+            if (existsSync(targetAbs)) {
+                await rm(targetAbs, { force: true });
+            }
+            await rename(stagedAbs, targetAbs);
+            committed.push(f.relPath);
+        }
+        // 全部成功 → 清理
+        await rm(stagingDir, { recursive: true, force: true });
+        await rm(backupDir, { recursive: true, force: true });
+    }
+    catch (err) {
+        // 反向回滚(P2.4 修复:用 rolledBack flag 防止 throw 被 inner catch 误捕获)
+        let rolledBack = false;
+        try {
+            for (const rel of committed) {
+                const targetAbs = join(projectRoot, rel);
+                const backupAbs = join(backupDir, rel);
+                if (existsSync(targetAbs))
+                    await rm(targetAbs, { force: true });
+                if (existsSync(backupAbs))
+                    await cp(backupAbs, targetAbs, { recursive: true });
+            }
+            await rm(stagingDir, { recursive: true, force: true });
+            await rm(backupDir, { recursive: true, force: true });
+            rolledBack = true;
+        }
+        catch (rollbackErr) {
+            // 回滚也失败
+            throw new Error(`Commit failed AND rollback failed: ${err.message} / ${rollbackErr.message}\n` +
+                `请手动清理 ${stagingDir} 和 ${backupDir},然后从 backup 恢复目标位置`);
+        }
+        // 回滚成功 → 在 inner try 外面 throw,避免被 inner catch 误捕获
+        if (rolledBack) {
+            throw new Error(`Commit failed and rolled back: ${err.message}`);
+        }
+    }
+}
+/** 收集"被该 plan 影响的顶层目标目录"用于 backup */
+function collectTargetDirs(files) {
+    const dirs = new Set();
+    for (const f of files) {
+        // 取 relPath 的第二层目录(如 .claude/skills/),adapter 实际部署都是这个层级
+        const parts = f.relPath.split('/');
+        if (parts.length >= 2) {
+            dirs.add(parts.slice(0, 2).join('/'));
+        }
+        else {
+            dirs.add(parts[0] ?? '');
+        }
+    }
+    return Array.from(dirs).filter(Boolean);
+}
+//# sourceMappingURL=transaction.js.map

package/dist/core/harness-adapters/transaction.js.map

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

package/dist/core/harness-adapters/types.d.ts

@@ -0,0 +1,45 @@
+/** 受支持的 harness 标识 */
+export type HarnessId = 'claude' | 'codex' | 'opencode';
+/** harness 检测结果 — 项目里这个 harness 是否装了 */
+export interface HarnessDetection {
+    id: HarnessId;
+    detected: boolean;
+    /** 检测到的标志路径(如 `.claude/`、`AGENTS.md`) */
+    detectedAt?: string;
+}
+/**
+ * skill 文件描述 — adapter 要铺什么内容
+ * Plan 4 之前 templates 是占位,这里只关心结构
+ */
+export interface SkillSpec {
+    /** skill 名(如 'using-forge', 'forge-brainstorming') */
+    name: string;
+    /** SKILL.md 内容 */
+    content: string;
+}
+/** slash 命令模板描述 */
+export interface CommandSpec {
+    /** 命令名(如 'brainstorm', 'propose') — 完整命令是 `/forge:<name>` */
+    name: string;
+    /** 命令模板 markdown 内容 */
+    content: string;
+}
+/** 共用 skill reference doc(plan-9b §2.6.8;被多 skill cross-ref) */
+export interface SharedDocSpec {
+    /** doc 名(如 'scope-category-guidance');完整文件名是 `<name>.md` */
+    name: string;
+    /** markdown 内容 */
+    content: string;
+}
+/** adapter 部署任务输入 */
+export interface DeployInput {
+    /** 项目根目录 */
+    projectRoot: string;
+    /** 要铺的 skill 列表 */
+    skills: SkillSpec[];
+    /** 要铺的命令列表 */
+    commands: CommandSpec[];
+    /** v2 plan-9b 新增:共用 skill reference docs(铺到 _shared 子目录) */
+    sharedDocs?: SharedDocSpec[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/harness-adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/types.ts"],"names":[],"mappings":"AAEA,sBAAsB;AACtB,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAExD,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,SAAS,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mBAAmB;AACnB,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAqB;AACrB,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,cAAc;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAC9B"}

package/dist/core/harness-adapters/types.js

@@ -0,0 +1,3 @@
+// Harness adapter 共用类型 — spec §2.1 + Phase 0.5 spike 结果
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/harness-adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/types.ts"],"names":[],"mappings":"AAAA,wDAAwD"}

package/dist/core/hash/content.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 计算 content_hash(spec §3.4)。
+ * 规则:
+ * 1. 收集 [proposal.md, design.md, specs/**\/*.md(递归), tasks.md]
+ * 2. 用 POSIX 风格 path 排序(无论 OS,跨平台一致)
+ * 3. 每个文件用同款规范化(LF + 去尾空白)
+ * 4. 拼接 `<path>\0<normalized_content>\0` 各文件 → SHA256
+ */
+export declare function computeContentHash(changeDir: string): Promise<string>;
+//# sourceMappingURL=content.d.ts.map

package/dist/core/hash/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/core/hash/content.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD3E"}