@accelerator-mzq/forge 1.4.0

package/dist/core/schemas/severity.d.ts

@@ -0,0 +1,58 @@
+/** 三级分级(沿 design §2.3.2) */
+export type Severity = 'CRITICAL' | 'WARNING' | 'SUGGESTION';
+export declare const SEVERITY_VALUES: readonly Severity[];
+export declare function isSeverity(v: unknown): v is Severity;
+/** candidate_type 6 类(沿 design §2.3.3 A,9a 立 enum,9g/9j/9d 各自实现具体验证算法) */
+export type CandidateType = 'test_failure' | 'hash_mismatch' | 'evidence_missing' | 'coverage_gap' | 'api_contract' | 'manual_claim';
+export declare const CANDIDATE_TYPE_VALUES: readonly CandidateType[];
+export declare function isCandidateType(v: unknown): v is CandidateType;
+/** evidence 5 类格式(沿 design §2.3.3 D)— prefix 形式 */
+export declare const EVIDENCE_FORMATS: readonly ["file:line", "artifact:section", "change-level", "command-output", "tests:scenario"];
+export type EvidenceFormat = (typeof EVIDENCE_FORMATS)[number];
+/**
+ * Finding hash payload 字段集 — 8 个稳定字段(沿 design §2.3.6)
+ * 注意:resolved / ack 字段不在本接口内(它们不进 hash payload)
+ *
+ * plan-9b v3 B1 修订:移除 validate_run_id
+ * 原因:validate_run_id 是每次调用的瞬态 crypto.randomUUID(),
+ * 若进入 hash payload 则 finding_hash 每次 validate 都变化,
+ * 破坏 finding 去重与持久 ack 的设计意图。
+ * validate_run_id 改为 Finding-level optional metadata(不入 hash)。
+ */
+export interface FindingHashPayload {
+    content_hash: string;
+    git_head: string;
+    /**
+     * dimension enum:plan-9d 三维度 + plan-9g 新增 process_evidence(brainstorm v10 Codex 六轮 M-1)
+     * 'process_evidence' 用于 plan-9g freeze-time WARNING(不变量 7/10)写入 marker.verify_findings;
+     * sub-enum 'invariant-7-verify-count' | 'invariant-10-env-drift' 用 check_type 字段
+     */
+    dimension: 'completeness' | 'correctness' | 'coherence' | 'process_evidence';
+    check_type: string;
+    severity: Severity;
+    automated: boolean;
+    evidence: string;
+    recommendation: string;
+}
+/**
+ * 完整 Finding 字段(含 ack / resolved / candidate 等可变字段)
+ * 用于 marker schema reference,不进 hash payload
+ */
+export interface Finding extends FindingHashPayload {
+    id: number;
+    resolved: boolean;
+    finding_hash: string;
+    /** 瞬态元数据 — 本次 validate 调用 ID;不进 hash payload(v3 B1 修订) */
+    validate_run_id?: string;
+    severity_candidate?: 'CRITICAL';
+    candidate_type?: CandidateType;
+    severity_candidate_rejected?: boolean;
+    candidate_rejected_reason?: string;
+    severity_acked_by?: string;
+    severity_acked_at?: string;
+    downgraded_from?: Severity;
+    downgraded_to?: Severity;
+    downgrade_acked_by?: string;
+    downgrade_rationale?: string;
+}
+//# sourceMappingURL=severity.d.ts.map

package/dist/core/schemas/severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/severity.ts"],"names":[],"mappings":"AAGA,4BAA4B;AAC5B,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAC7D,eAAO,MAAM,eAAe,EAAE,SAAS,QAAQ,EAAmD,CAAC;AAEnG,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAEpD;AAED,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,cAAc,CAAC;AACnB,eAAO,MAAM,qBAAqB,EAAE,SAAS,aAAa,EAOhD,CAAC;AAEX,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D;AAED,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,gGAMnB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,kBAAkB,CAAC;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAQ,SAAQ,kBAAkB;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,UAAU,CAAC;IAChC,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,QAAQ,CAAC;IAC3B,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/core/schemas/severity.js

@@ -0,0 +1,26 @@
+// severity.ts:§3.12.1 Interface Freeze 共享字段 single source of truth
+// 后续 sub-plan(9c/9d/9e/9g/9j 等)reference 此处,不重定义
+export const SEVERITY_VALUES = ['CRITICAL', 'WARNING', 'SUGGESTION'];
+export function isSeverity(v) {
+    return typeof v === 'string' && SEVERITY_VALUES.includes(v);
+}
+export const CANDIDATE_TYPE_VALUES = [
+    'test_failure',
+    'hash_mismatch',
+    'evidence_missing',
+    'coverage_gap',
+    'api_contract',
+    'manual_claim',
+];
+export function isCandidateType(v) {
+    return typeof v === 'string' && CANDIDATE_TYPE_VALUES.includes(v);
+}
+/** evidence 5 类格式(沿 design §2.3.3 D)— prefix 形式 */
+export const EVIDENCE_FORMATS = [
+    'file:line',
+    'artifact:section',
+    'change-level',
+    'command-output',
+    'tests:scenario',
+];
+//# sourceMappingURL=severity.js.map

package/dist/core/schemas/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../../../src/core/schemas/severity.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,iDAAiD;AAIjD,MAAM,CAAC,MAAM,eAAe,GAAwB,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC;AAEnG,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrF,CAAC;AAUD,MAAM,CAAC,MAAM,qBAAqB,GAA6B;IAC7D,cAAc;IACd,eAAe;IACf,kBAAkB;IAClB,cAAc;IACd,cAAc;IACd,cAAc;CACN,CAAC;AAEX,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,qBAA2C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,kBAAkB;IAClB,cAAc;IACd,gBAAgB;IAChB,gBAAgB;CACR,CAAC"}

package/dist/core/scope/aggregator.d.ts

@@ -0,0 +1,49 @@
+import { type ScopeEntry } from '../schemas/scope-entries.js';
+/** 含来源 change id 的 entry(供 propose 选单显示) */
+export interface AggregatedScopeEntry extends ScopeEntry {
+    /** 来源 archived change id(目录名) */
+    source_change: string;
+}
+/** 一条 superseding 明细 —— 供 backlog tombstone + render 层派生 warning(spec §3.2) */
+export interface SupersedingDetail {
+    /** 被认领的历史 entry 所在 archived change(目录名) */
+    source_change: string;
+    /** 被认领的 entry id */
+    entry_id: string;
+    /** YAML 原始字串,未 cast;合法性在 render 层判(∈ 4 枚举) */
+    new_status: string;
+    /** 认领论证 */
+    rationale: string;
+    /** 写下这条 SupersedingRef 的 archived change(认领者,目录名) */
+    superseded_in_change: string;
+    /** 认领者目录名日期前缀 YYYY-MM-DD;无可解析前缀 → 'unknown' */
+    superseded_at: string;
+    /** 原 entry 快照;null = 悬空引用 */
+    registry_entry_snapshot: ScopeEntry | null;
+}
+/** 被 skip 的 archived scope 块 —— aggregator 唯一产出的「原始异常」(spec §3.2) */
+export interface SkippedBlock {
+    /** archived change 目录名 */
+    change: string;
+    /** proposal.md | design.md */
+    file: string;
+    reason: 'yaml-parse-error' | 'schema-mismatch';
+}
+export interface AggregatorResult {
+    /** 存活 active(已扣 superseding) */
+    entries: AggregatedScopeEntry[];
+    /** superseding 明细(plan-backlog-registry) */
+    superseding: SupersedingDetail[];
+    /** 坏块结构化列表(plan-backlog-registry) */
+    skipped: SkippedBlock[];
+}
+/**
+ * 扫 forgeRoot/changes/archive/<id>/{proposal,design}.md 内 anchor 三段的 fenced YAML 块,
+ * 收集 status=active 的 entries,扣已被合法 superseding_entries 走的;
+ * 同时保留 superseding 明细与坏块列表。
+ *
+ * @param forgeRoot 项目内 forge/ 根目录的绝对路径
+ * @throws Error 当 forgeRoot/changes/archive/ 不存在时(让 CLI exit 2)
+ */
+export declare function scanArchivedFollowups(forgeRoot: string): Promise<AggregatorResult>;
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/core/scope/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../../src/core/scope/aggregator.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,6BAA6B,CAAC;AAErC,4CAA4C;AAC5C,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,uBAAuB,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5C;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,4CAA4C;IAC5C,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,qCAAqC;IACrC,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAcD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsHxF"}

package/dist/core/scope/aggregator.js

@@ -0,0 +1,141 @@
+// src/core/scope/aggregator.ts
+// plan-9b Task 5 — 扫 archived YAML 块 + 聚合 active entries + 扣 superseding_entries
+// plan-backlog-registry Task 1 — 扩展:保留 superseding 明细 + skipped 坏块 + new_status 守卫
+import { readFile, readdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { parseMarkdown } from '../parse/markdown.js';
+import { parseFencedYamlBlocks, FencedYamlParseError } from '../parse/fenced-yaml.js';
+import { SCOPE_ANCHOR_IDS, VALID_SUPERSEDING_NEW_STATUS, } from '../schemas/scope-entries.js';
+const CATEGORY_ORDER = {
+    'future-work': 0,
+    'out-of-scope': 1,
+    'non-goal': 2,
+};
+/** 从 archived 目录名取日期前缀;无 YYYY-MM-DD 前缀 → 'unknown' */
+function dirnameDate(changeId) {
+    const m = /^(\d{4}-\d{2}-\d{2})-/.exec(changeId);
+    return m ? m[1] : 'unknown';
+}
+/**
+ * 扫 forgeRoot/changes/archive/<id>/{proposal,design}.md 内 anchor 三段的 fenced YAML 块,
+ * 收集 status=active 的 entries,扣已被合法 superseding_entries 走的;
+ * 同时保留 superseding 明细与坏块列表。
+ *
+ * @param forgeRoot 项目内 forge/ 根目录的绝对路径
+ * @throws Error 当 forgeRoot/changes/archive/ 不存在时(让 CLI exit 2)
+ */
+export async function scanArchivedFollowups(forgeRoot) {
+    const archiveRoot = join(forgeRoot, 'changes', 'archive');
+    if (!existsSync(archiveRoot)) {
+        throw new Error(`archive 目录不存在(ENOENT): ${archiveRoot}`);
+    }
+    const archDirs = await readdir(archiveRoot, { withFileTypes: true });
+    const collected = [];
+    const skipped = [];
+    const rawSuperseding = [];
+    const superseded = new Set(); // key: `${source_change}::${entry_id}`
+    for (const ent of archDirs) {
+        if (!ent.isDirectory())
+            continue;
+        const changeId = ent.name;
+        const changeDir = join(archiveRoot, changeId);
+        for (const fname of ['proposal.md', 'design.md']) {
+            const path = join(changeDir, fname);
+            if (!existsSync(path))
+                continue;
+            const text = await readFile(path, 'utf8');
+            const md = parseMarkdown(text);
+            for (const sec of md.sections) {
+                if (!sec.anchor || !SCOPE_ANCHOR_IDS.includes(sec.anchor)) {
+                    continue;
+                }
+                let blocks;
+                try {
+                    blocks = parseFencedYamlBlocks(sec.body);
+                }
+                catch (err) {
+                    if (err instanceof FencedYamlParseError) {
+                        skipped.push({ change: changeId, file: fname, reason: 'yaml-parse-error' });
+                        continue;
+                    }
+                    throw err;
+                }
+                for (const block of blocks) {
+                    // plan-backlog-registry Codex LOW-1:非对象块(null/标量)按 schema-mismatch,避免 b.schema 抛 TypeError
+                    if (typeof block !== 'object' || block === null) {
+                        skipped.push({ change: changeId, file: fname, reason: 'schema-mismatch' });
+                        continue;
+                    }
+                    const b = block;
+                    if (b.schema !== 'forge-scope-entries/v1') {
+                        skipped.push({ change: changeId, file: fname, reason: 'schema-mismatch' });
+                        continue;
+                    }
+                    for (const e of b.entries ?? []) {
+                        if (e.status === 'active') {
+                            collected.push({ ...e, source_change: changeId });
+                        }
+                    }
+                    for (const sup of b.superseding_entries ?? []) {
+                        rawSuperseding.push({
+                            source_change: sup.source_change,
+                            entry_id: sup.entry_id,
+                            new_status: String(sup.new_status),
+                            rationale: String(sup.rationale ?? ''),
+                            superseded_in_change: changeId,
+                            superseded_at: dirnameDate(changeId),
+                        });
+                        // §9c 守卫:只有合法 new_status 才扣减
+                        if (VALID_SUPERSEDING_NEW_STATUS.has(String(sup.new_status))) {
+                            superseded.add(`${sup.source_change}::${sup.entry_id}`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // 回填 snapshot:从内存中已扫的 entries 解析(不重读文件)
+    const byKey = new Map();
+    for (const e of collected)
+        byKey.set(`${e.source_change}::${e.id}`, e);
+    const superseding = rawSuperseding.map((s) => ({
+        ...s,
+        registry_entry_snapshot: byKey.get(`${s.source_change}::${s.entry_id}`) ?? null,
+    }));
+    const filtered = collected.filter((e) => !superseded.has(`${e.source_change}::${e.id}`));
+    filtered.sort((a, b) => {
+        const cmp = CATEGORY_ORDER[a.category] - CATEGORY_ORDER[b.category];
+        if (cmp !== 0)
+            return cmp;
+        if (a.source_change !== b.source_change) {
+            return a.source_change < b.source_change ? -1 : 1;
+        }
+        return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+    });
+    // 对 superseding 排序:保证 archived.md tombstone 顺序跨平台确定、--check 不误报
+    // 排序键:source_change → entry_id → superseded_in_change 字典序
+    superseding.sort((a, b) => {
+        if (a.source_change !== b.source_change) {
+            return a.source_change < b.source_change ? -1 : 1;
+        }
+        if (a.entry_id !== b.entry_id) {
+            return a.entry_id < b.entry_id ? -1 : 1;
+        }
+        return a.superseded_in_change < b.superseded_in_change
+            ? -1
+            : a.superseded_in_change > b.superseded_in_change
+                ? 1
+                : 0;
+    });
+    // 对 skipped 排序:保证 active.md Warnings 顺序跨平台确定、--check 不误报
+    // 排序键:change → file 字典序
+    skipped.sort((a, b) => {
+        if (a.change !== b.change) {
+            return a.change < b.change ? -1 : 1;
+        }
+        return a.file < b.file ? -1 : a.file > b.file ? 1 : 0;
+    });
+    return { entries: filtered, superseding, skipped };
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/core/scope/aggregator.js.map

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

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

@@ -0,0 +1,2 @@
+export * from './aggregator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/scope/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/core/scope/index.js

@@ -0,0 +1,2 @@
+export * from './aggregator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/scope/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/core/specs-sync/apply.d.ts

@@ -0,0 +1,8 @@
+import type { SpecDelta } from './deltas.js';
+/**
+ * 将 deltas 逐个应用到 currentSpecsDir。
+ * create/replace:写入文件(自动创建父目录)。
+ * delete:v0.2 待实现,当前直接抛出错误。
+ */
+export declare function applyDeltas(currentSpecsDir: string, deltas: SpecDelta[]): Promise<void>;
+//# sourceMappingURL=apply.d.ts.map

package/dist/core/specs-sync/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/core/specs-sync/apply.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7F"}

package/dist/core/specs-sync/apply.js

@@ -0,0 +1,26 @@
+// 应用 deltas 到 forge/specs/
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+/**
+ * 将 deltas 逐个应用到 currentSpecsDir。
+ * create/replace:写入文件(自动创建父目录)。
+ * delete:v0.2 待实现,当前直接抛出错误。
+ */
+export async function applyDeltas(currentSpecsDir, deltas) {
+    for (const d of deltas) {
+        const path = join(currentSpecsDir, `${d.name}.md`);
+        if (d.operation === 'create' || d.operation === 'replace') {
+            // content 为 null 时跳过(防御性处理)
+            if (d.content === null)
+                continue;
+            // 确保目标目录存在
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, d.content, 'utf8');
+        }
+        else if (d.operation === 'delete') {
+            // v0.2 实现
+            throw new Error(`delete operation not yet implemented (v0.2)`);
+        }
+    }
+}
+//# sourceMappingURL=apply.js.map

package/dist/core/specs-sync/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/core/specs-sync/apply.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,eAAuB,EAAE,MAAmB;IAC5E,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC1D,4BAA4B;YAC5B,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;gBAAE,SAAS;YACjC,WAAW;YACX,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,CAAC,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACpC,UAAU;YACV,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/specs-sync/deltas.d.ts

@@ -0,0 +1,15 @@
+export interface SpecDelta {
+    /** spec 名(不含 .md) */
+    name: string;
+    /** create / replace / delete */
+    operation: 'create' | 'replace' | 'delete';
+    /** 内容(delete 时为 null) */
+    content: string | null;
+}
+/**
+ * 读 changeDir/specs/ 下所有 .md,与 currentSpecsDir 下已有的对比,产出 deltas。
+ * 当前实现:简单替换(若 already exists → replace,否则 create)。
+ * delete 语义未实现(留 v0.2)。
+ */
+export declare function readDeltas(changeSpecsDir: string, currentSpecsDir: string): Promise<SpecDelta[]>;
+//# sourceMappingURL=deltas.d.ts.map

package/dist/core/specs-sync/deltas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.d.ts","sourceRoot":"","sources":["../../../src/core/specs-sync/deltas.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,yBAAyB;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiBtB"}

package/dist/core/specs-sync/deltas.js

@@ -0,0 +1,27 @@
+// specs-sync deltas 解析 — change/<id>/specs/ 下的 md 是要应用到 forge/specs/ 的"增量"
+// 当前模型:每个 md 文件代表"应替换 forge/specs/<name>"。未来可加"删除"语义(用空文件或 frontmatter 标记)。
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * 读 changeDir/specs/ 下所有 .md,与 currentSpecsDir 下已有的对比,产出 deltas。
+ * 当前实现:简单替换(若 already exists → replace,否则 create)。
+ * delete 语义未实现(留 v0.2)。
+ */
+export async function readDeltas(changeSpecsDir, currentSpecsDir) {
+    // 读取 change specs 目录下所有文件,目录不存在时返回空数组
+    const newEntries = await readdir(changeSpecsDir).catch(() => []);
+    // 读取当前 forge specs 目录,构建已有文件集合
+    const existing = new Set(await readdir(currentSpecsDir).catch(() => []));
+    const deltas = [];
+    for (const name of newEntries) {
+        // 只处理 .md 文件
+        if (!name.endsWith('.md'))
+            continue;
+        const content = await readFile(join(changeSpecsDir, name), 'utf8');
+        // 根据是否已存在决定操作类型
+        const op = existing.has(name) ? 'replace' : 'create';
+        deltas.push({ name: name.replace(/\.md$/, ''), operation: op, content });
+    }
+    return deltas;
+}
+//# sourceMappingURL=deltas.js.map

package/dist/core/specs-sync/deltas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.js","sourceRoot":"","sources":["../../../src/core/specs-sync/deltas.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAE5E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,cAAsB,EACtB,eAAuB;IAEvB,sCAAsC;IACtC,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACjE,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,aAAa;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,gBAAgB;QAChB,MAAM,EAAE,GAA2B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/specs-sync/index.d.ts

@@ -0,0 +1,3 @@
+export * from './deltas.js';
+export * from './apply.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/specs-sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/specs-sync/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/core/specs-sync/index.js

@@ -0,0 +1,4 @@
+// specs-sync 模块公共 API 导出(internal-only,由 archive 命令调用)
+export * from './deltas.js';
+export * from './apply.js';
+//# sourceMappingURL=index.js.map

package/dist/core/specs-sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/specs-sync/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/core/stage-extensions/convergence-judge.d.ts

@@ -0,0 +1,35 @@
+import type { ConvergenceConfig } from '../schema/types.js';
+import type { CodexReviewOutput, ForgeFinding, SeverityMap } from './types.js';
+/**
+ * 收敛判断结果。
+ * blockFindings = BLOCKER/MAJOR(经 confidence 过滤后);runner 据此判断是否收敛。
+ */
+export interface ConvergenceResult {
+    /** codex session thread id;首轮或 codex 未返回时为 null */
+    threadId: string | null;
+    /** codex 的原始 verdict */
+    verdict: 'approve' | 'needs-attention';
+    /** 需阻塞 merge 的 findings(BLOCKER + MAJOR,经 confidence 过滤) */
+    blockFindings: ForgeFinding[];
+    /** 可忽略的 findings(MINOR + NIT,经 confidence 过滤) */
+    ignoreFindings: ForgeFinding[];
+    /** 因置信度不足被丢弃的 finding 数量 */
+    droppedByConfidence: number;
+    /** 是否因 approve + 无 block findings 而短路(跳过 block 逻辑) */
+    shortCircuited: boolean;
+}
+/**
+ * 判断单轮 codex review 输出的收敛结果。
+ *
+ * 步骤:
+ * 1. 按 confidence_threshold 过滤 findings
+ * 2. 用 severity_map 做 codex → forge 4 级映射
+ * 3. 按 block_severity 分入 blockFindings / ignoreFindings
+ * 4. 检查是否满足 verdict_approve_short_circuit 条件
+ *
+ * @param output       codex review 完整输出
+ * @param config       收敛配置(来自 NormalizedStageExtensionEntry.convergence)
+ * @param severityMap  severity 映射表
+ */
+export declare function judgeConvergence(output: CodexReviewOutput, config: ConvergenceConfig, severityMap: SeverityMap): ConvergenceResult;
+//# sourceMappingURL=convergence-judge.d.ts.map

package/dist/core/stage-extensions/convergence-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convergence-judge.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/convergence-judge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG/E;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wBAAwB;IACxB,OAAO,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACvC,4DAA4D;IAC5D,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,iDAAiD;IACjD,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,4BAA4B;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,WAAW,GACvB,iBAAiB,CA8BnB"}

package/dist/core/stage-extensions/convergence-judge.js

@@ -0,0 +1,47 @@
+// convergence-judge.ts — 收敛判断核心逻辑
+// plan-stage-extensions Task 2.2
+// 根据 CodexReviewOutput + ConvergenceConfig 输出 ConvergenceResult;
+// 不判断是否已收敛 — runner 通过 blockFindings.length === 0 自行决策
+import { mapCodexToForge } from './severity-mapper.js';
+/**
+ * 判断单轮 codex review 输出的收敛结果。
+ *
+ * 步骤:
+ * 1. 按 confidence_threshold 过滤 findings
+ * 2. 用 severity_map 做 codex → forge 4 级映射
+ * 3. 按 block_severity 分入 blockFindings / ignoreFindings
+ * 4. 检查是否满足 verdict_approve_short_circuit 条件
+ *
+ * @param output       codex review 完整输出
+ * @param config       收敛配置(来自 NormalizedStageExtensionEntry.convergence)
+ * @param severityMap  severity 映射表
+ */
+export function judgeConvergence(output, config, severityMap) {
+    // 1. 按置信度过滤 findings
+    const filtered = output.findings.filter((f) => f.confidence >= config.confidence_threshold);
+    const block = [];
+    const ignore = [];
+    const droppedByConfidence = output.findings.length - filtered.length;
+    // 2. 映射 severity 并分桶
+    for (const f of filtered) {
+        const forgeSeverity = mapCodexToForge(f.severity, severityMap);
+        const ff = { ...f, forge_severity: forgeSeverity };
+        if (config.block_severity.includes(forgeSeverity)) {
+            block.push(ff);
+        }
+        else {
+            ignore.push(ff);
+        }
+    }
+    // 3. 检查是否满足短路条件:approve 且无 block findings
+    const shortCircuited = config.verdict_approve_short_circuit && output.verdict === 'approve' && block.length === 0;
+    return {
+        threadId: output.thread_id ?? null,
+        verdict: output.verdict,
+        blockFindings: block,
+        ignoreFindings: ignore,
+        droppedByConfidence,
+        shortCircuited,
+    };
+}
+//# sourceMappingURL=convergence-judge.js.map

package/dist/core/stage-extensions/convergence-judge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convergence-judge.js","sourceRoot":"","sources":["../../../src/core/stage-extensions/convergence-judge.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,iCAAiC;AACjC,iEAAiE;AACjE,uDAAuD;AAIvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAqBvD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAyB,EACzB,MAAyB,EACzB,WAAwB;IAExB,qBAAqB;IACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,mBAAmB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAErE,qBAAqB;IACrB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC/D,MAAM,EAAE,GAAiB,EAAE,GAAG,CAAC,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;QACjE,IAAI,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,cAAc,GAClB,MAAM,CAAC,6BAA6B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IAE7F,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,MAAM;QACtB,mBAAmB;QACnB,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/core/stage-extensions/index.d.ts

@@ -0,0 +1,13 @@
+export type { SeverityMap, CodexFinding, CodexReviewOutput, ForgeFinding } from './types.js';
+export { mapCodexToForge, mapForgeToForgeTier } from './severity-mapper.js';
+export type { ConvergenceResult } from './convergence-judge.js';
+export { judgeConvergence } from './convergence-judge.js';
+export type { ThreadMapEntry } from './thread-map.js';
+export { ThreadMap } from './thread-map.js';
+export type { TrendAdvice } from './trend-analyzer.js';
+export { analyzeTrend } from './trend-analyzer.js';
+export type { WatchResult } from './output-watcher.js';
+export { OutputWatcher, watchProcess } from './output-watcher.js';
+export type { RoundOutcome } from './state-machine.js';
+export { isFailureOutcome } from './state-machine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/stage-extensions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/index.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7F,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/stage-extensions/index.js

@@ -0,0 +1,11 @@
+// index.ts — stage-extensions 模块公开 API 统一导出
+// plan-stage-extensions Task 2
+// 从 6 个子模块 + types.ts 重新导出所有公开类型/函数/类
+// ── severity-mapper ─────────────────────────────────────────────────────────
+export { mapCodexToForge, mapForgeToForgeTier } from './severity-mapper.js';
+export { judgeConvergence } from './convergence-judge.js';
+export { ThreadMap } from './thread-map.js';
+export { analyzeTrend } from './trend-analyzer.js';
+export { OutputWatcher, watchProcess } from './output-watcher.js';
+export { isFailureOutcome } from './state-machine.js';
+//# sourceMappingURL=index.js.map

package/dist/core/stage-extensions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/stage-extensions/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,+BAA+B;AAC/B,sCAAsC;AAKtC,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAI5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}