@accelerator-mzq/forge 1.4.0

package/dist/core/backlog/index.js

@@ -0,0 +1,60 @@
+// src/core/backlog/index.ts
+// plan-backlog-registry — orchestration:聚合 → 渲染 → 写 forge/backlog/
+import { mkdir, writeFile, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { scanArchivedFollowups } from '../scope/aggregator.js';
+import { deriveWarningsAndTombstones, renderActiveMarkdown, renderArchivedMarkdown, countOpenBacklog, } from './render.js';
+export * from './render.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** README 模板路径(随 dist 一起发布 —— 由 scripts/copy-templates.mjs 拷到 dist,见 Step 5) */
+const README_TEMPLATE = join(__dirname, 'assets', 'backlog-readme.md');
+/** 聚合 + 渲染,返回两份 markdown(纯计算,不写盘) */
+export async function buildBacklog(forgeRoot) {
+    const agg = await scanArchivedFollowups(forgeRoot);
+    const { warnings, tombstones } = deriveWarningsAndTombstones(agg.superseding, agg.skipped);
+    const activeMd = renderActiveMarkdown(agg.entries, warnings);
+    const archivedMd = renderArchivedMarkdown(tombstones);
+    // 待办计数口径由 render.ts 的 countOpenBacklog 统一(避免与 renderActiveMarkdown 各写一份)
+    const openCount = countOpenBacklog(agg.entries);
+    return { openCount, warningCount: warnings.length, activeMd, archivedMd };
+}
+/** 聚合 + 渲染 + 写盘到 forge/backlog/(README 仅首写) */
+export async function generateBacklog(forgeRoot) {
+    const result = await buildBacklog(forgeRoot);
+    const dir = join(forgeRoot, 'backlog');
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, 'active.md'), result.activeMd, 'utf8');
+    await writeFile(join(dir, 'archived.md'), result.archivedMd, 'utf8');
+    const readmePath = join(dir, 'README.md');
+    if (!existsSync(readmePath)) {
+        await writeFile(readmePath, await readFile(README_TEMPLATE, 'utf8'), 'utf8');
+    }
+    return result;
+}
+/**
+ * 比对磁盘上的 forge/backlog/{active,archived}.md 与重生成结果。
+ * 返回陈旧文件名列表(空数组 = 一致)。供 `forge backlog --check`(CI staleness 守门,spec §7.2)。
+ */
+export async function checkBacklogStale(forgeRoot) {
+    const built = await buildBacklog(forgeRoot);
+    const dir = join(forgeRoot, 'backlog');
+    const stale = [];
+    for (const [name, fresh] of [
+        ['active.md', built.activeMd],
+        ['archived.md', built.archivedMd],
+    ]) {
+        let onDisk;
+        try {
+            onDisk = await readFile(join(dir, name), 'utf8');
+        }
+        catch {
+            onDisk = '';
+        }
+        if (onDisk !== fresh)
+            stale.push(name);
+    }
+    return stale;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/backlog/index.js.map

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

package/dist/core/backlog/render.d.ts

@@ -0,0 +1,51 @@
+import type { SupersedingDetail, SkippedBlock, AggregatedScopeEntry } from '../scope/aggregator.js';
+/** render 层呈现类型 —— 由 superseding[] / skipped[] 派生(spec §7.1) */
+export type BacklogWarning = {
+    kind: 'dangling-reference';
+    superseded_in_change: string;
+    source_change: string;
+    entry_id: string;
+} | {
+    kind: 'invalid-new-status';
+    superseded_in_change: string;
+    source_change: string;
+    entry_id: string;
+    raw: string;
+} | {
+    kind: 'duplicate-claim';
+    source_change: string;
+    entry_id: string;
+    claimants: {
+        superseded_in_change: string;
+        superseded_at: string;
+    }[];
+    winner_superseded_in_change: string;
+} | {
+    kind: 'malformed-dirname';
+    superseded_in_change: string;
+} | {
+    kind: 'skipped-block';
+    change: string;
+    file: string;
+    reason: string;
+};
+/**
+ * 从 aggregator 的 superseding[] / skipped[] 派生 warning 与 tombstone(spec §5 处理顺序 / §7.1)。
+ * 处理顺序:先剔 dangling(snapshot=null)与非法 new_status,再在剩余 valid claim 组内选 winner。
+ */
+export declare function deriveWarningsAndTombstones(superseding: SupersedingDetail[], skipped: SkippedBlock[]): {
+    warnings: BacklogWarning[];
+    tombstones: SupersedingDetail[];
+};
+/** 单条 BacklogWarning → 一行文本(spec §7.1 表) */
+export declare function renderWarningLine(w: BacklogWarning): string;
+/**
+ * 待办计数口径(spec §4):仅 future-work + out-of-scope 计入待办;non-goal 不计入。
+ * 由 renderActiveMarkdown 与 buildBacklog 共用,避免计数口径在两处各写一份导致漂移。
+ */
+export declare function countOpenBacklog(entries: AggregatedScopeEntry[]): number;
+/** 渲染 active.md(spec §4) */
+export declare function renderActiveMarkdown(entries: AggregatedScopeEntry[], warnings: BacklogWarning[]): string;
+/** 渲染 archived.md tombstone(spec §5);入参为 deriveWarningsAndTombstones 选出的 winner 列表 */
+export declare function renderArchivedMarkdown(tombstones: SupersedingDetail[]): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/backlog/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/core/backlog/render.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAIpG,gEAAgE;AAChE,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE;QAAE,oBAAoB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrE,2BAA2B,EAAE,MAAM,CAAC;CACrC,GACD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAiB5E;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,iBAAiB,EAAE,EAChC,OAAO,EAAE,YAAY,EAAE,GACtB;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAkEjE;AAED,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAe3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAGxE;AAmBD,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAAE,EAC/B,QAAQ,EAAE,cAAc,EAAE,GACzB,MAAM,CAoCR;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,MAAM,CA6B9E"}

package/dist/core/backlog/render.js

@@ -0,0 +1,196 @@
+// src/core/backlog/render.ts
+// plan-backlog-registry — 纯函数:聚合结果 → BacklogWarning[] + tombstone + markdown
+// 本文件 Task 2 放 warning/tombstone 派生;Task 3/4 续加 renderActive / renderArchived。
+import { VALID_SUPERSEDING_NEW_STATUS } from '../schemas/scope-entries.js';
+/** superseded_at 比较:有效 YYYY-MM-DD 按字典序;'unknown' 一律排最后(spec §5) */
+function compareSupersededAt(a, b) {
+    if (a === b)
+        return 0;
+    if (a === 'unknown')
+        return 1;
+    if (b === 'unknown')
+        return -1;
+    return a < b ? -1 : 1;
+}
+/** 两条 claim 选 winner:superseded_at 最早;并列按 superseded_in_change 字典序 */
+function earlier(a, b) {
+    const c = compareSupersededAt(a.superseded_at, b.superseded_at);
+    if (c !== 0)
+        return c < 0 ? a : b;
+    return a.superseded_in_change <= b.superseded_in_change ? a : b;
+}
+/**
+ * 从 aggregator 的 superseding[] / skipped[] 派生 warning 与 tombstone(spec §5 处理顺序 / §7.1)。
+ * 处理顺序:先剔 dangling(snapshot=null)与非法 new_status,再在剩余 valid claim 组内选 winner。
+ */
+export function deriveWarningsAndTombstones(superseding, skipped) {
+    const warnings = [];
+    const valid = [];
+    for (const s of superseding) {
+        if (s.registry_entry_snapshot === null) {
+            warnings.push({
+                kind: 'dangling-reference',
+                superseded_in_change: s.superseded_in_change,
+                source_change: s.source_change,
+                entry_id: s.entry_id,
+            });
+            continue;
+        }
+        if (!VALID_SUPERSEDING_NEW_STATUS.has(s.new_status)) {
+            warnings.push({
+                kind: 'invalid-new-status',
+                superseded_in_change: s.superseded_in_change,
+                source_change: s.source_change,
+                entry_id: s.entry_id,
+                raw: s.new_status,
+            });
+            continue;
+        }
+        valid.push(s);
+    }
+    // malformed-dirname:任何 superseding 明细目录名异常都报
+    for (const s of superseding) {
+        if (s.superseded_at === 'unknown') {
+            warnings.push({ kind: 'malformed-dirname', superseded_in_change: s.superseded_in_change });
+        }
+    }
+    // valid claim 按身份键分组
+    const groups = new Map();
+    for (const s of valid) {
+        const key = `${s.source_change}::${s.entry_id}`;
+        const g = groups.get(key);
+        if (g)
+            g.push(s);
+        else
+            groups.set(key, [s]);
+    }
+    const tombstones = [];
+    for (const g of groups.values()) {
+        const winner = g.reduce(earlier);
+        tombstones.push(winner);
+        if (g.length > 1) {
+            warnings.push({
+                kind: 'duplicate-claim',
+                source_change: winner.source_change,
+                entry_id: winner.entry_id,
+                claimants: g.map((s) => ({
+                    superseded_in_change: s.superseded_in_change,
+                    superseded_at: s.superseded_at,
+                })),
+                winner_superseded_in_change: winner.superseded_in_change,
+            });
+        }
+    }
+    for (const sk of skipped) {
+        warnings.push({ kind: 'skipped-block', change: sk.change, file: sk.file, reason: sk.reason });
+    }
+    return { warnings, tombstones };
+}
+/** 单条 BacklogWarning → 一行文本(spec §7.1 表) */
+export function renderWarningLine(w) {
+    switch (w.kind) {
+        case 'dangling-reference':
+            return `- [dangling] ${w.superseded_in_change} 认领的 ${w.source_change}::${w.entry_id} 不存在`;
+        case 'invalid-new-status':
+            return `- [invalid-status] ${w.superseded_in_change} 认领 ${w.source_change}::${w.entry_id} new_status=${w.raw}`;
+        case 'duplicate-claim': {
+            const cs = w.claimants.map((c) => `${c.superseded_in_change}:${c.superseded_at}`).join(' ');
+            return `- [duplicate] ${w.source_change}::${w.entry_id} claimants=${cs} winner=${w.winner_superseded_in_change}`;
+        }
+        case 'malformed-dirname':
+            return `- [malformed-dirname] ${w.superseded_in_change} 目录名无日期前缀,superseded_at=unknown`;
+        case 'skipped-block':
+            return `- [skipped] ${w.change}/${w.file}: ${w.reason}`;
+    }
+}
+/**
+ * 待办计数口径(spec §4):仅 future-work + out-of-scope 计入待办;non-goal 不计入。
+ * 由 renderActiveMarkdown 与 buildBacklog 共用,避免计数口径在两处各写一份导致漂移。
+ */
+export function countOpenBacklog(entries) {
+    return entries.filter((e) => e.category === 'future-work' || e.category === 'out-of-scope')
+        .length;
+}
+/** 单条 active entry → markdown 块 */
+function renderEntry(e) {
+    // triggered_by 格式化:有则 source#id,无则 (无)
+    const tb = e.triggered_by ? `${e.triggered_by.source}#${e.triggered_by.id}` : '(无)';
+    return [
+        `### \`${e.source_change}::${e.id}\``,
+        '',
+        `- **source change**: ${e.source_change}`,
+        `- **description**: ${e.description}`,
+        `- **reason**: ${e.reason}`,
+        `- **priority**: ${e.priority ?? '(未排序)'}`,
+        `- **related change**: ${e.related_change ?? '(无)'}`,
+        `- **triggered_by**: ${tb}`,
+        '',
+    ].join('\n');
+}
+/** 渲染 active.md(spec §4) */
+export function renderActiveMarkdown(entries, warnings) {
+    // 按 category 分组过滤
+    const byCat = (c) => entries.filter((e) => e.category === c);
+    const fw = byCat('future-work');
+    const oos = byCat('out-of-scope');
+    const ng = byCat('non-goal');
+    // 待办计数:Future Work + Out of Scope;Non-Goals 不计入(口径见 countOpenBacklog)
+    const openCount = countOpenBacklog(entries);
+    const lines = [];
+    lines.push('# Active Backlog');
+    lines.push('');
+    lines.push('> 生成产物 —— 由 `/forge:archive` 自动重生成,**勿手编**。Schema 见 README.md。');
+    lines.push(`> 待办计 ${openCount} 项(Future Work + Out of Scope;Non-Goals 不计入)。`);
+    lines.push('');
+    lines.push(`## Warnings (${warnings.length})`);
+    lines.push('');
+    // 无 warning 则输出 (无),否则每条一行
+    lines.push(warnings.length === 0 ? '(无)' : warnings.map(renderWarningLine).join('\n'));
+    lines.push('');
+    // 三段 category:Future Work / Out of Scope / Non-Goals
+    for (const [title, list] of [
+        [`## Future Work (${fw.length})`, fw],
+        [`## Out of Scope (${oos.length})`, oos],
+        [`## Non-Goals (${ng.length}) — 原则不做,不计入待办`, ng],
+    ]) {
+        lines.push(title);
+        lines.push('');
+        if (list.length === 0) {
+            lines.push('(无)');
+            lines.push('');
+        }
+        else {
+            for (const e of list)
+                lines.push(renderEntry(e));
+        }
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+/** 渲染 archived.md tombstone(spec §5);入参为 deriveWarningsAndTombstones 选出的 winner 列表 */
+export function renderArchivedMarkdown(tombstones) {
+    const lines = [];
+    lines.push('# Archived Backlog (Tombstones)');
+    lines.push('');
+    lines.push('> 生成产物 —— 由 `/forge:archive` 自动重生成。每条记录一个 backlog 项的退役。Schema 见 README.md。');
+    lines.push('> 异常(悬空认领 / 非法 new_status / 重复认领 / 跳过坏块 / 目录名异常)见 active.md `## Warnings`。');
+    lines.push('');
+    if (tombstones.length === 0) {
+        lines.push('(无)');
+        return lines.join('\n').trimEnd() + '\n';
+    }
+    for (const t of tombstones) {
+        // registry_entry_snapshot 一定非 null(deriveWarningsAndTombstones 已剔 dangling)
+        const snapshot = JSON.stringify(t.registry_entry_snapshot);
+        lines.push(`### \`${t.source_change}::${t.entry_id}\``);
+        lines.push('');
+        lines.push(`- **superseded_in_change**: ${t.superseded_in_change}`);
+        lines.push(`- **superseded_at**: ${t.superseded_at}`);
+        lines.push(`- **new_status**: ${t.new_status}`);
+        // rationale 字段对应 spec §5 tombstone 的 cancellation_reason 显示标签
+        lines.push(`- **cancellation_reason**: ${t.rationale}`);
+        lines.push(`- **registry_entry_snapshot**: ${snapshot}`);
+        lines.push('');
+    }
+    return lines.join('\n').trimEnd() + '\n';
+}
+//# sourceMappingURL=render.js.map

package/dist/core/backlog/render.js.map

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

package/dist/core/bootstrap/index.d.ts

@@ -0,0 +1,2 @@
+export declare const USING_FORGE_SKILL_NAME: "using-forge";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/bootstrap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/bootstrap/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,sBAAsB,EAAG,aAAsB,CAAC"}

package/dist/core/bootstrap/index.js

@@ -0,0 +1,5 @@
+// bootstrap 模块 — Plan 4
+// using-forge 是 bootstrap skill,真实文本由 templates/skills/using-forge.md 提供
+// 本模块仅暴露 skill 名常量,供 adapter 在调用 detect/plan 时引用
+export const USING_FORGE_SKILL_NAME = 'using-forge';
+//# sourceMappingURL=index.js.map

package/dist/core/bootstrap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/bootstrap/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,yEAAyE;AACzE,iDAAiD;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAsB,CAAC"}

package/dist/core/canonical-json.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 序列化为 JCS canonical JSON。
+ * - 字段按 lexicographic 排序
+ * - 字符串 UTF-8 + 标准 escape
+ * - 数值 IEEE 754 double + ECMA-262 数值字符串化
+ * - 拒绝 Date / undefined / function 等非 JSON 值
+ */
+export declare function canonicalize(value: unknown): string;
+/** 计算 JCS payload 的 SHA256 hex hash */
+export declare function canonicalHash(value: unknown): string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/core/canonical-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.d.ts","sourceRoot":"","sources":["../../src/core/canonical-json.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUnD;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/dist/core/canonical-json.js

@@ -0,0 +1,43 @@
+// canonical-json.ts:JCS(JSON Canonicalization Scheme,RFC 8785)序列化器
+// v1.0 所有 hash payload 序列化路径必须经过本模块,确保跨平台 / 跨版本字节序列一致。
+// 依赖 canonicalize npm 包(IETF RFC 8785 reference impl)。
+import canonicalizeImpl from 'canonicalize';
+import { createHash } from 'node:crypto';
+/**
+ * 序列化为 JCS canonical JSON。
+ * - 字段按 lexicographic 排序
+ * - 字符串 UTF-8 + 标准 escape
+ * - 数值 IEEE 754 double + ECMA-262 数值字符串化
+ * - 拒绝 Date / undefined / function 等非 JSON 值
+ */
+export function canonicalize(value) {
+    // canonicalize 包对非 JSON 值会返回 undefined,需手工拒绝
+    if (containsNonJsonValue(value)) {
+        throw new Error('canonicalize: input contains non-JSON value (Date / undefined / function)');
+    }
+    const result = canonicalizeImpl(value);
+    if (result === undefined) {
+        throw new Error('canonicalize: serialization returned undefined');
+    }
+    return result;
+}
+/** 计算 JCS payload 的 SHA256 hex hash */
+export function canonicalHash(value) {
+    const json = canonicalize(value);
+    return createHash('sha256').update(json, 'utf8').digest('hex');
+}
+function containsNonJsonValue(v) {
+    if (v === undefined)
+        return true;
+    if (typeof v === 'function')
+        return true;
+    if (v instanceof Date)
+        return true;
+    if (Array.isArray(v))
+        return v.some(containsNonJsonValue);
+    if (v && typeof v === 'object') {
+        return Object.values(v).some(containsNonJsonValue);
+    }
+    return false;
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/core/canonical-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-json.js","sourceRoot":"","sources":["../../src/core/canonical-json.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,uDAAuD;AACvD,uDAAuD;AAEvD,OAAO,gBAAgB,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,6CAA6C;IAC7C,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,oBAAoB,CAAC,CAAU;IACtC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,OAAO,CAAC,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/git/utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 探测 cwd 是否在 git repo 内(含 work tree 与 bare repo)。
+ * 沿 plan-9h preflight.ts inline 同模式(execFileSync + try/catch)。
+ *
+ * **语义注意(Codex review v1 #12 caveat)**:用 `git rev-parse --git-dir`,bare repo 也返 true。
+ * 若 caller 严格需要 work tree(排除 bare)→ 自行加 `git rev-parse --is-inside-work-tree` 二次校验;
+ * 留 plan-v2 评估是否在 helper 内升级严格语义(不在 plan-v1.1 P-9 scope — 是 refactor 不改语义)。
+ *
+ * @param cwd 工作目录绝对路径
+ * @returns true 若 cwd 在 git repo(含 bare)内;false 若非 git
+ */
+export declare function isGitRepo(cwd: string): boolean;
+/**
+ * 拿 cwd 当前分支名(`git rev-parse --abbrev-ref HEAD`)。
+ * 调用前应已 `isGitRepo(cwd) === true` 守卫,否则 throw。
+ *
+ * **语义注意(Codex review v1 #13 caveat)**:detached HEAD(checkout SHA / tag 状态)返字面 `'HEAD'` 字符串。
+ * 沿 plan-9h preflight.ts 现行行为:'HEAD' 不在 protected_branches 列表 → 不阻断实施(等价 caller 选择"detached HEAD 视为可实施")。
+ * 若 caller 需严格拒绝 detached HEAD → 判 `result === 'HEAD'` 走另路径;
+ * 留 plan-v2 评估是否在 helper 内 throw / 返 sentinel(不在 plan-v1.1 P-9 scope — 是 refactor 不改语义)。
+ *
+ * @param cwd 工作目录绝对路径(必须已 isGitRepo verified)
+ * @returns 当前分支名;detached HEAD 时返 'HEAD' 字面字符串
+ * @throws 若 cwd 非 git repo(未守卫 isGitRepo)或 git 命令失败
+ */
+export declare function getCurrentBranch(cwd: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/git/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/git/utils.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/core/git/utils.js

@@ -0,0 +1,53 @@
+// src/core/git/utils.ts — plan-v1.1 P-9
+// 共享 git helper(plan-9h Q8 决策抽出延后;v1.1 因 preflight.ts + migrate/index.ts 2+ 复用点解锁 YAGNI 限制)
+// 统一用 execFileSync(safer than execSync;不 spawn shell 避 quote injection)
+//
+// 语义沿 plan-9h inline 现行模式(不改语义只 refactor;严格化语义留 plan-v2):
+// - isGitRepo:`--git-dir` 探测(bare repo 也返 true;若 caller 需严格 work tree 用 `--is-inside-work-tree`)
+// - getCurrentBranch:detached HEAD 时返 'HEAD' 字面字符串(caller 应判断该 sentinel;preflight branch-protection 此时不命中保护列表 → 通过 — 与 plan-9h 现行行为一致)
+//
+// scope clarification(Step 1.1 grep verify 后):
+// - 本 utils.ts 仅抽 isGitRepo + getCurrentBranch(P-9 scope 内 2+ 复用点:preflight.ts + migrate/index.ts)
+// - ack.ts / evidence.ts / process-evidence-fence.ts 用 `git rev-parse HEAD` 拿 SHA(不同语义,getCommitHead candidate;不在 P-9 scope,留 plan-v2 评估)
+// - archive.ts 用 `git rev-parse --is-inside-work-tree`(严格 work tree;不同 API;不在 P-9 scope,留 plan-v2 评估是否合并到 isGitRepo strict 模式)
+import { execFileSync } from 'node:child_process';
+/**
+ * 探测 cwd 是否在 git repo 内(含 work tree 与 bare repo)。
+ * 沿 plan-9h preflight.ts inline 同模式(execFileSync + try/catch)。
+ *
+ * **语义注意(Codex review v1 #12 caveat)**:用 `git rev-parse --git-dir`,bare repo 也返 true。
+ * 若 caller 严格需要 work tree(排除 bare)→ 自行加 `git rev-parse --is-inside-work-tree` 二次校验;
+ * 留 plan-v2 评估是否在 helper 内升级严格语义(不在 plan-v1.1 P-9 scope — 是 refactor 不改语义)。
+ *
+ * @param cwd 工作目录绝对路径
+ * @returns true 若 cwd 在 git repo(含 bare)内;false 若非 git
+ */
+export function isGitRepo(cwd) {
+    try {
+        execFileSync('git', ['rev-parse', '--git-dir'], { cwd, stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 拿 cwd 当前分支名(`git rev-parse --abbrev-ref HEAD`)。
+ * 调用前应已 `isGitRepo(cwd) === true` 守卫,否则 throw。
+ *
+ * **语义注意(Codex review v1 #13 caveat)**:detached HEAD(checkout SHA / tag 状态)返字面 `'HEAD'` 字符串。
+ * 沿 plan-9h preflight.ts 现行行为:'HEAD' 不在 protected_branches 列表 → 不阻断实施(等价 caller 选择"detached HEAD 视为可实施")。
+ * 若 caller 需严格拒绝 detached HEAD → 判 `result === 'HEAD'` 走另路径;
+ * 留 plan-v2 评估是否在 helper 内 throw / 返 sentinel(不在 plan-v1.1 P-9 scope — 是 refactor 不改语义)。
+ *
+ * @param cwd 工作目录绝对路径(必须已 isGitRepo verified)
+ * @returns 当前分支名;detached HEAD 时返 'HEAD' 字面字符串
+ * @throws 若 cwd 非 git repo(未守卫 isGitRepo)或 git 命令失败
+ */
+export function getCurrentBranch(cwd) {
+    return execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+        cwd,
+        encoding: 'utf-8',
+    }).trim();
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/git/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/git/utils.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4FAA4F;AAC5F,wEAAwE;AACxE,EAAE;AACF,0DAA0D;AAC1D,iGAAiG;AACjG,uIAAuI;AACvI,EAAE;AACF,+CAA+C;AAC/C,mGAAmG;AACnG,0IAA0I;AAC1I,+HAA+H;AAE/H,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;QAChE,GAAG;QACH,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC,IAAI,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { HarnessAdapter, DeployPlan, LegacyDetector, LegacyArtifact } from './interface.js';
+import type { DeployInput, HarnessDetection } from './types.js';
+export declare class ClaudeAdapter implements HarnessAdapter, LegacyDetector {
+    readonly id: "claude";
+    detect(projectRoot: string): Promise<HarnessDetection>;
+    plan(input: DeployInput): Promise<DeployPlan>;
+    /**
+     * v0.3 Plan 4 — 扫 `.claude/skills/forge-{name}/SKILL.md` + `.claude/commands/forge/{name}.md`
+     * legacy v0.2 adapter 产物,供 `forge upgrade` 5 阶段事务使用。
+     */
+    detectLegacyArtifacts(projectRoot: string): Promise<LegacyArtifact[]>;
+}
+//# sourceMappingURL=claude.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/claude.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAEV,cAAc,EACd,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,qBAAa,aAAc,YAAW,cAAc,EAAE,cAAc;IAClE,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAE1B,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUtD,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBnD;;;OAGG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAK5E"}

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

@@ -0,0 +1,53 @@
+// Claude Code adapter — 铺到 .claude/skills/forge-<name>/SKILL.md 和 .claude/commands/forge/<name>.md
+// 路径基于 Phase 0.5 spike 实测(spike/claude-code/.claude/...)
+// 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 ClaudeAdapter {
+    id = 'claude';
+    async detect(projectRoot) {
+        const target = join(projectRoot, '.claude');
+        try {
+            await stat(target);
+            return { id: this.id, detected: true, detectedAt: '.claude' };
+        }
+        catch {
+            return { id: this.id, detected: false };
+        }
+    }
+    async plan(input) {
+        const files = [];
+        for (const skill of input.skills) {
+            files.push({
+                relPath: `.claude/skills/forge-${skill.name}/SKILL.md`,
+                content: skill.content,
+            });
+        }
+        for (const cmd of input.commands) {
+            files.push({
+                relPath: `.claude/commands/forge/${cmd.name}.md`,
+                content: cmd.content,
+            });
+        }
+        // v2 plan-9b Task 7b:共用 reference docs 铺到 forge-_shared/ "skill-like" 容器
+        // 命名约定:.claude/skills/forge-_shared/<name>.md(沿 forge-<name> 风格;_shared 是合法 skill name 字面)
+        for (const doc of input.sharedDocs ?? []) {
+            files.push({
+                relPath: `.claude/skills/forge-_shared/${doc.name}.md`,
+                content: doc.content,
+            });
+        }
+        return { files };
+    }
+    /**
+     * v0.3 Plan 4 — 扫 `.claude/skills/forge-{name}/SKILL.md` + `.claude/commands/forge/{name}.md`
+     * legacy v0.2 adapter 产物,供 `forge upgrade` 5 阶段事务使用。
+     */
+    async detectLegacyArtifacts(projectRoot) {
+        const skills = await detectLegacySkills(projectRoot, '.claude');
+        const commands = await detectLegacyCommands(projectRoot, '.claude');
+        return [...skills, ...commands];
+    }
+}
+//# sourceMappingURL=claude.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/core/harness-adapters/claude.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,yDAAyD;AACzD,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,aAAa;IACf,EAAE,GAAG,QAAiB,CAAC;IAEhC,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,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,0BAA0B,GAAG,CAAC,IAAI,KAAK;gBAChD,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;QACD,yEAAyE;QACzE,2FAA2F;QAC3F,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;;;OAGG;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/codex.d.ts

@@ -0,0 +1,14 @@
+import type { HarnessAdapter, DeployPlan, LegacyDetector, LegacyArtifact } from './interface.js';
+import type { DeployInput, HarnessDetection } from './types.js';
+export declare class CodexAdapter implements HarnessAdapter, LegacyDetector {
+    readonly id: "codex";
+    detect(projectRoot: string): Promise<HarnessDetection>;
+    plan(input: DeployInput): Promise<DeployPlan>;
+    /**
+     * 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/`。
+     */
+    detectLegacyArtifacts(projectRoot: string): Promise<LegacyArtifact[]>;
+}
+//# sourceMappingURL=codex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/core/harness-adapters/codex.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAEV,cAAc,EACd,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,qBAAa,YAAa,YAAW,cAAc,EAAE,cAAc;IACjE,QAAQ,CAAC,EAAE,EAAG,OAAO,CAAU;IAEzB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUtD,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA+BnD;;;;OAIG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAK5E"}