@accelerator-mzq/forge 1.4.0

package/dist/core/legacy-bridge/sync-check.js

@@ -0,0 +1,198 @@
+// sync-check 核心 — Plan 7 Phase C
+// 决策 #5/#18/#19/#22:5 档判定 + graceful skip + opt-in skip + cross-anchor 默认入 diff
+import { redact } from './redact.js';
+import { checkAnchorHash } from './hash-anchor.js';
+import { decideCrossRole } from './conflict.js';
+import { normalizeDiffsFromLlm } from './diff-report.js';
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+/** 找本次 change 影响的 anchor(模块匹配) */
+export function findAffectedAnchors(anchors, affectedModules) {
+    if (affectedModules.length === 0)
+        return [];
+    return anchors.anchors.filter((a) => {
+        if (!a.modules || a.modules.length === 0)
+            return false;
+        return a.modules.some((m) => affectedModules.includes(m));
+    });
+}
+/** 拼 LLM prompt(对单 anchor 判 5 档差异) */
+function buildSyncCheckPrompt(anchor, anchorTextMasked, changeContext) {
+    return `你是一名 brownfield sync 审计员。请判断"本次 change"是否要求更新对应"老文档锚点"。
+
+# 本次 change 上下文
+${changeContext}
+
+# 老文档锚点(role=${anchor.role}, path=${anchor.path})
+${anchorTextMasked}
+
+# 输出要求
+按 5 档严重度(critical / major / minor / style / info)输出 0 或多条 diff(JSON 数组,严格)。
+- critical:合规 / 安全 / 业务硬约束变化
+- major:行为接口变更
+- minor:文字描述需更新
+- style:格式 / 排版小调整
+- info:背景信息(无需更新但可参考)
+
+如果**没有**任何更新需要 → 输出空数组 \`[]\`。
+
+# 输出格式(必须严格遵守)
+仅输出 JSON 数组,每项含字段:
+\`\`\`
+[
+  { "severity": "critical|major|minor|style|info", "section": "§4.5", "description": "..." }
+]
+\`\`\`
+不要任何 preamble、不要 markdown code fence。`;
+}
+/** 跑单 anchor 的 sync-check(给 LLM 判 5 档) */
+export async function syncCheckAnchor(client, anchor, anchorText, changeContext, redactRules) {
+    const masked = redact(anchorText, redactRules).redactedText;
+    const prompt = buildSyncCheckPrompt(anchor, masked, changeContext);
+    // P7-07 修复:LLM 调用前数据传输声明(spec §1.1.1 line 40)
+    console.log(`→ sending ${Buffer.byteLength(prompt, 'utf8')} bytes to Anthropic API (provider=anthropic, region: auto, model=${DEFAULT_MODEL})`);
+    const result = await client.messages.create({
+        model: DEFAULT_MODEL,
+        max_tokens: 2048,
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const text = extractText(result);
+    return parseLlmDiffJson(text, anchor);
+}
+/** 解析 LLM 返回的 diff JSON 数组 */
+export function parseLlmDiffJson(text, anchor) {
+    const trimmed = text.trim();
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        // 解析失败 → 返回 1 条 info(说明 LLM 输出非 JSON,但不阻塞)
+        return [
+            {
+                severity: 'info',
+                anchor_path: anchor.path,
+                description: `LLM 输出非合法 JSON,无法判定差异:${trimmed.slice(0, 200)}`,
+            },
+        ];
+    }
+    if (!Array.isArray(parsed)) {
+        return [
+            {
+                severity: 'info',
+                anchor_path: anchor.path,
+                description: `LLM 输出非数组:${trimmed.slice(0, 200)}`,
+            },
+        ];
+    }
+    return parsed.map((item) => {
+        const o = item;
+        return {
+            severity: o.severity,
+            section: o.section,
+            description: o.description,
+            anchor_path: anchor.path,
+        };
+    });
+}
+/** 跑全 change 的 sync-check */
+export async function runSyncCheck(client, input, readAnchorText, 
+/** P7-05 修复:可选索引 entries 用于预过滤(spec §3.2 line 388) */
+indexEntries) {
+    let affected = findAffectedAnchors(input.anchors, input.affectedModules);
+    const allDiffs = [];
+    const redactRules = input.anchors.redact ?? [];
+    /** P7-10 修复:汇总缺失锚点路径,部分降级不阻塞其余处理(spec §4.1 line 498) */
+    const missingAnchors = [];
+    // P7-05 修复:索引摘要先快速过滤(spec §3.2)。
+    // 若提供 indexEntries,LLM 用摘要打分 → 仅"高分"摘要的 anchor 才打开原文。
+    // 这里用简化策略:摘要含 changeContext 任一关键词的 anchor 视为高分;
+    // indexEntries 缺失时,跳过过滤(全量打开,保留向后兼容)。
+    if (indexEntries && indexEntries.length > 0) {
+        const keywords = extractKeywords(input.changeContext);
+        const filtered = affected.filter((a) => {
+            const entry = indexEntries.find((e) => e.path === a.path);
+            if (!entry)
+                return true; // 无摘要 → 默认打开(保守)
+            return keywords.some((k) => entry.summary.includes(k));
+        });
+        if (filtered.length > 0)
+            affected = filtered;
+    }
+    for (const anchor of affected) {
+        // P7-10 修复:单 anchor try/catch,缺失文件不阻塞其他 anchor
+        let text;
+        try {
+            text = await readAnchorText(anchor.path);
+        }
+        catch (err) {
+            missingAnchors.push(anchor.path);
+            console.warn(`⚠ anchor ${anchor.path} 读取失败:${err.message};跳过该项继续`);
+            continue;
+        }
+        const partial = await syncCheckAnchor(client, anchor, text, input.changeContext, redactRules);
+        const normalized = normalizeDiffsFromLlm(partial);
+        for (const d of normalized) {
+            allDiffs.push({
+                ...d,
+                anchor_path: anchor.path,
+            });
+        }
+    }
+    // hash 检测(spec §3.2 / §4.3 不变量)
+    const hashChecks = await Promise.all(affected.map(async (anchor) => ({
+        anchor,
+        state: (await checkAnchorHash(anchor)).state,
+    })));
+    // 跨 anchor 冲突(决策 #18 修订):仅当多个 affected 同时 critical/major 时才考虑配对
+    const crossInput = {
+        mtimeOf: input.mtimeOf,
+        autoResolve: input.autoResolveCrossAnchor,
+    };
+    const crossAnchorConflicts = [];
+    // 简化策略:对 affected 中跨 role 的 anchor 配对 by role(LLM 已经判过单 anchor 差异)
+    // 这里仅在 affected.length >= 2 且至少 2 个 role 不同时,加 1 条 cross_anchor_conflicts(default major)
+    const distinctRoles = new Set(affected.map((a) => a.role));
+    if (distinctRoles.size >= 2) {
+        const decision = decideCrossRole(affected, crossInput);
+        if (decision.kind === 'enter-diff') {
+            crossAnchorConflicts.push({
+                id: allDiffs.length + 1,
+                severity: 'major',
+                anchor_path: affected.map((a) => a.path).join(' vs '),
+                description: `本次 change 跨 ${decision.conflictingRoles.join(' / ')} 多个 role,默认入 diff 让用户审(决策 #18 修订)`,
+                status: 'pending',
+            });
+        }
+    }
+    // 重新分配 id(全局唯一)
+    let counter = 0;
+    for (const d of allDiffs) {
+        counter += 1;
+        d.id = counter;
+    }
+    for (const d of crossAnchorConflicts) {
+        counter += 1;
+        d.id = counter;
+    }
+    const syncState = {
+        schema: 'forge-legacy-sync/v1',
+        change_id: input.changeId,
+        generated_at: new Date().toISOString(),
+        diffs: allDiffs,
+        cross_anchor_conflicts: crossAnchorConflicts.length > 0 ? crossAnchorConflicts : undefined,
+    };
+    return { syncState, hashChecks, missingAnchors };
+}
+/** P7-05 辅助:从 changeContext 抽简化关键词(用于索引召回过滤) */
+function extractKeywords(text) {
+    // 取所有中文连续段(2+ 字)+ 英文标识符(3+ 字符)作关键词候选
+    const cn = text.match(/[一-龥]{2,}/g) ?? [];
+    const en = text.match(/[A-Za-z][A-Za-z0-9_-]{2,}/g) ?? [];
+    // 去重 + 长度限制(避免 entry.summary.includes 全 hit)
+    return Array.from(new Set([...cn, ...en])).slice(0, 30);
+}
+function extractText(result) {
+    const block = result.content.find((b) => b.type === 'text');
+    return block?.text ?? '';
+}
+//# sourceMappingURL=sync-check.js.map

package/dist/core/legacy-bridge/sync-check.js.map

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

package/dist/core/legacy-bridge/types.d.ts

@@ -0,0 +1,114 @@
+/** 老锚点的角色(决策 #9 用户显式声明 + LLM 推测草稿) */
+export type LegacyAnchorRole = 'requirements' | 'high-level-design' | 'low-level-design' | 'system-tests' | 'acceptance-report' | 'rationale' | 'glossary';
+/** 单个老锚点配置项(legacy-anchors.yaml#anchors[] 数组项) */
+export interface LegacyAnchor {
+    /** 角色(决策 #9) */
+    role: LegacyAnchorRole;
+    /** 文件路径(支持 glob) */
+    path: string;
+    /** 当前权威版(决策 #10);同 role 多版本只 1 项可为 true */
+    authoritative: boolean;
+    /** Excel 文件可选指明 sheet(测试用例常见) */
+    sheet?: string;
+    /** 文件版本号(可选,用户填) */
+    version?: string;
+    /** 模块边界(用于 sync-check 反查影响) */
+    modules?: string[];
+    /** SHA256 hash(由 regenerate / sync-check 写入,用于过期检测) */
+    hash?: string;
+    /** 上次复写时间(ISO) */
+    last_regenerated?: string;
+    /** 上次 sync-check 时间(ISO) */
+    last_sync_at?: string;
+    /** 决策 #20 redact 配置(可选,若缺则用默认 12 类规则) */
+    redact?: RedactRule[];
+    /** §4.5 GDPR:此文件含客户数据,启用 LLM 时额外 ack(决策 #22) */
+    contains_customer_data?: boolean;
+}
+/** legacy-anchors.yaml 顶层结构 */
+export interface LegacyAnchorsFile {
+    schema: 'forge-legacy-anchor/v1';
+    anchors: LegacyAnchor[];
+    /** 全局 redact 规则(与每 anchor 的 redact 合并) */
+    redact?: RedactRule[];
+}
+/** redact 规则(决策 #20) */
+export type RedactRule = {
+    regex: string;
+    name?: string;
+} | {
+    literal: string;
+    name?: string;
+};
+/** 5 档差异严重度(决策 #5) */
+export type DiffSeverity = 'critical' | 'major' | 'minor' | 'style' | 'info';
+/** sync-state YAML 中的单条 diff 项 */
+export interface SyncStateDiff {
+    /** 数字 id(在 yaml 内唯一) */
+    id: number;
+    /** 差异严重度(决策 #5) */
+    severity: DiffSeverity;
+    /** 受影响的 anchor 路径 */
+    anchor_path: string;
+    /** 哪段需要更新(章节锚) */
+    section?: string;
+    /** 描述本次差异 */
+    description: string;
+    /** 用户处理状态(决策 #19) */
+    status: 'pending' | 'resolved-by-doc-update' | 'false-positive' | 'skipped';
+    /** 用户填的理由(false-positive / skipped 时) */
+    reason?: string;
+}
+/** sync-state YAML 顶层结构 */
+export interface SyncStateFile {
+    schema: 'forge-legacy-sync/v1';
+    change_id: string;
+    generated_at: string;
+    diffs: SyncStateDiff[];
+    /** 跨 anchor 冲突默认入 diff(决策 #18 修订);auto_resolve_cross_anchor=true 时此字段为空 */
+    cross_anchor_conflicts?: SyncStateDiff[];
+}
+/** llm-ack.yaml 顶层结构(决策 #22) */
+export interface LlmAckFile {
+    schema: 'forge-llm-ack/v1';
+    acknowledged_at: string;
+    /** 用户当时的 forge/config.yaml#legacy_bridge 段 hash;若 config 改了,要求重新 ack */
+    config_hash: string;
+    /** §4.5 GDPR:用户 ack 已处理含客户数据的 anchor(决策 #22) */
+    customer_data_acknowledged?: boolean;
+}
+/** key fact:scenario YAML 标注的关键事实(决策 #16 分层抽样) */
+export interface KeyFact {
+    text: string;
+    section: string;
+    /** critical 必抽必保留(分层抽样,§5.1) */
+    critical: boolean;
+}
+/** 复写质量结果(spec §5.1 + §4.3 不变量) */
+export interface QualityResult {
+    /** 总体保真率(critical + non-critical) */
+    total_rate: number;
+    /** critical 子集保真率(必须 1.0) */
+    critical_rate: number;
+    /** 各章节保真率(防"统计骗术") */
+    per_section_rates: Record<string, number>;
+    /** 丢失的 critical(致命) */
+    lost_critical: KeyFact[];
+    /** 丢失的 non-critical */
+    lost_non_critical: KeyFact[];
+    /** 抽样未覆盖的章节(警告) */
+    uncovered_sections: string[];
+    /**
+     * 是否过 critical 100% + total >= threshold(默认 0.9,见 spec §5.1 + 决策 #16);
+     * threshold 由调用方(quality-judge.ts)传入,此字段由其计算后写入。
+     */
+    passed: boolean;
+}
+/** regen-quality.yaml 顶层(写到 forge/docs/regenerated/<role>.partial.yaml,失败时) */
+export interface RegenQualityFile {
+    schema: 'forge-regen-quality/v1';
+    role: LegacyAnchorRole;
+    generated_at: string;
+    result: QualityResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/legacy-bridge/types.d.ts.map

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

package/dist/core/legacy-bridge/types.js

@@ -0,0 +1,4 @@
+// brownfield onboarding 全模块共享类型 — Plan 7
+// 对应 spec §2 架构 + §3 数据流 + §4.3 不变量 + §5.1 quality-judge schema
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/legacy-bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/legacy-bridge/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,gEAAgE"}

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

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

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

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

package/dist/core/markers/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './parse.js';
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/markers/parse.d.ts

@@ -0,0 +1,12 @@
+import type { AnyMarker } from './types.js';
+export declare class MarkerParseError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * 解析任一 marker YAML。
+ * 不验证字段值合法性,只返回 unknown shape 的对象。
+ * 调用方应紧接着用 validateMarkerSchema(...)。
+ */
+export declare function parseMarker(text: string): AnyMarker;
+//# sourceMappingURL=parse.d.ts.map

package/dist/core/markers/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/core/markers/parse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,gBAAiB,SAAQ,KAAK;aAId,KAAK,CAAC,EAAE,OAAO;gBAFxC,OAAO,EAAE,MAAM,EAEU,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAWnD"}

package/dist/core/markers/parse.js

@@ -0,0 +1,31 @@
+// Marker YAML 解析器 — 只负责"语法解析",不验证字段值(那是 marker-schema.ts 的事)
+import { parse as parseYAML } from 'yaml';
+export class MarkerParseError extends Error {
+    cause;
+    constructor(message, 
+    // override 覆盖 Error 基类的 cause 属性(TS 4.3+)
+    cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'MarkerParseError';
+    }
+}
+/**
+ * 解析任一 marker YAML。
+ * 不验证字段值合法性,只返回 unknown shape 的对象。
+ * 调用方应紧接着用 validateMarkerSchema(...)。
+ */
+export function parseMarker(text) {
+    let parsed;
+    try {
+        parsed = parseYAML(text);
+    }
+    catch (err) {
+        throw new MarkerParseError('YAML parse failed', err);
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new MarkerParseError('marker must be a YAML mapping');
+    }
+    return parsed;
+}
+//# sourceMappingURL=parse.js.map

package/dist/core/markers/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/core/markers/parse.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAId;IAH3B,YACE,OAAe;IACf,0CAA0C;IACjB,KAAe;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFU,UAAK,GAAL,KAAK,CAAU;QAGxC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,gBAAgB,CAAC,+BAA+B,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAmB,CAAC;AAC7B,CAAC"}

package/dist/core/markers/types.d.ts

@@ -0,0 +1,142 @@
+import type { Finding } from '../schemas/severity.js';
+import type { Severity } from '../schemas/severity.js';
+import type { ProcessEvidence } from '../schemas/process-evidence.js';
+export interface VerifyMarker {
+    schema: 'forge-verify/v1';
+    verified_at: string;
+    verified_by: 'ai-agent' | 'human-override';
+    tasks_hash: string;
+    content_hash: string;
+    evidence: EvidenceItem[];
+    verify_findings?: VerifyFinding[];
+    pause_decisions?: PauseDecision[];
+    created_by_tool_version?: string;
+    resigned_by_tool_version?: string;
+    /** v1.0 process_evidence 完整结构(沿 design §2.7.2);老 marker 缺等价 undefined */
+    process_evidence?: ProcessEvidence;
+    /** freeze 时 staging.yaml 三数组 JCS canonicalize hash 快照(archive fence cross-check 用) */
+    process_evidence_staging_hash?: string;
+    /** freeze 时全 JSONL ack-log.jsonl 末行 canonicalize hash 快照(挡"改最后一行"攻击) */
+    ack_log_tail_hash?: string;
+    /** freeze 时全 JSONL ack-log.jsonl 行数固化(挡"重写整链 + 链内自洽"攻击,brainstorm SUG1) */
+    ack_log_entry_count?: number;
+}
+/**
+ * VerifyFinding — verify 阶段产出的 finding 项
+ * Reference 9a Finding 接口(沿 §3.12.1 Finding 字段冻结)
+ * plan-9d v2 m-1 修订:改 extends Finding 而非裸 alias,留 verify-only optional 字段扩展位
+ * (例如未来加 requirement_id?: string 显式关联 spec 章节,不打破现有接口)
+ * **不允许 require 新字段** — 沿 superset additive 原则
+ */
+export interface VerifyFinding extends Finding {
+}
+/**
+ * chosen_option — Fluid Pause 用户决策选项(沿 design §2.1.4 / §2.1.5)
+ * 1 = 扩 scope(更新 proposal `## What Changes`,subagent 重派)
+ * 2 = 加 task(主代理 append 新 task 到 tasks.md,subagent 重派)
+ * 3 = 转 out-of-scope(写到 proposal `## Out of Scope` / design `## Future Work` YAML 块,subagent 跳过 issue 继续)
+ * 4 = Other(用户提供自由文本描述,必须配 other_rationale + other_acked_by)
+ */
+export type ChosenOption = 1 | 2 | 3 | 4;
+/**
+ * PauseDecision — apply 阶段 Fluid Pause Decision Point 主代理记录的决策项
+ * 沿 design §2.1.5 marker schema
+ * superset additive:四 marker 均可选 pause_decisions?,缺等价 []
+ *
+ * v2 codex MINOR 10 修订:本 interface 的 nullable 字段(severity_acked_by/_at /
+ *   non_blocking_rationale / other_rationale / other_acked_by)统一用 `string | null`,
+ *   **与 9a `Finding.severity_acked_by?: string` 不同**。
+ *   - 设计理由:design §2.1.5 line 256-257 YAML 示例字面用 `other_rationale: null` /
+ *     `other_acked_by: null`,marker YAML 中字段必须存在(值或填或 null),不允许"字段缺失"。
+ *   - 9a Finding 是另一回事:Finding 字段缺失等价默认值,9a 实施沿 optional 模式。
+ *   - 两 interface 独立,本 PauseDecision 沿 design YAML 字面格式。
+ */
+export interface PauseDecision {
+    /** 同一 marker 内唯一(数字 id,沿 9a Finding id 模式) */
+    id: number;
+    /** pause 触发时刻(ISO 8601 UTC) */
+    paused_at: string;
+    /** 关联的 task(tasks.md#task-N 格式;subagent 报 DONE_WITH_CONCERNS / BLOCKED / DESIGN_ISSUE_FOUND 时所在 task) */
+    task_ref: string;
+    /** subagent 报告的 issue 一句概括 */
+    issue_summary: string;
+    /** 主代理初判(CRITICAL → 不应进 pause,本 enum 校验 + fence 重定向) */
+    severity: Severity;
+    /** WARNING 必须有,SUGGESTION 允许空(沿 design §2.1.5 fence 校验) */
+    severity_acked_by: string | null;
+    severity_acked_at: string | null;
+    /** 1 | 2 | 3 | 4 — 用户在 AskUserQuestion 选择 */
+    chosen_option: ChosenOption;
+    /** option=1 → 'proposal.md';option=2 → 'tasks.md';option=3 → 'proposal.md' | 'design.md' */
+    target_artifact: string;
+    /** option=1 → '## What Changes';option=2 → 新 task 行;option=3 → '## Out of Scope' | '## Future Work' */
+    target_anchor: string;
+    /** option=3 必填(沿 design §2.1.5 fence 校验);其他选项填 null */
+    non_blocking_rationale: string | null;
+    /** option=4 必填(用户提供自由文本) */
+    other_rationale: string | null;
+    /** option=4 必填(用户在 marker 之外某处确认 — fence 仅校验非空,不校验来源)  */
+    other_acked_by: string | null;
+}
+export interface EvidenceItem {
+    scenario_id: string;
+    test_command: string;
+    test_file: string;
+    log_path: string;
+    log_hash: string;
+    pass: boolean;
+}
+export interface ReviewMarker {
+    schema: 'forge-review/v1';
+    reviewed_at: string;
+    reviewed_by: 'ai-agent' | 'human-override';
+    tasks_hash: string;
+    content_hash: string;
+    git: GitInfo;
+    review_outcomes: ReviewOutcome[];
+    pause_decisions?: PauseDecision[];
+    created_by_tool_version?: string;
+    resigned_by_tool_version?: string;
+    process_evidence?: ProcessEvidence;
+    process_evidence_staging_hash?: string;
+    ack_log_tail_hash?: string;
+    ack_log_entry_count?: number;
+}
+export interface GitInfo {
+    is_git_repo: boolean;
+    head?: string;
+    diff_hash?: string;
+    diff_pathspec?: {
+        include: string[];
+        exclude: string[];
+    };
+}
+export interface ReviewOutcome {
+    severity: 'S' | 'C' | 'L' | 'CRITICAL' | 'WARNING' | 'SUGGESTION';
+    accepted: boolean;
+    resolved: boolean;
+    task_ref?: string;
+    rationale?: string;
+}
+export interface VerifyFailedMarker {
+    schema: 'forge-verify-failed/v1';
+    failed_at: string;
+    reasons: string[];
+    fake_completions: string[];
+    appended_tasks: string[];
+    verify_findings?: VerifyFinding[];
+    pause_decisions?: PauseDecision[];
+    created_by_tool_version?: string;
+    resigned_by_tool_version?: string;
+}
+export interface ReviewFailedMarker {
+    schema: 'forge-review-failed/v1';
+    failed_at: string;
+    unresolved_outcomes: ReviewOutcome[];
+    appended_tasks: string[];
+    pause_decisions?: PauseDecision[];
+    created_by_tool_version?: string;
+    resigned_by_tool_version?: string;
+}
+export type AnyMarker = VerifyMarker | ReviewMarker | VerifyFailedMarker | ReviewFailedMarker;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/markers/types.d.ts.map

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

package/dist/core/markers/types.js

@@ -0,0 +1,3 @@
+// Marker YAML 类型 — spec §3.4
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/markers/types.js.map

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

package/dist/core/migrate/ack.d.ts

@@ -0,0 +1,13 @@
+export interface MigrateAckInput {
+    source: 'openspec' | 'superpowers';
+    estimatedCostUsd: number;
+}
+export declare function renderMigratePrompt(input: MigrateAckInput): string;
+export declare function ackFilePath(forgeRoot: string, ts: string): string;
+export declare function writeMigrateAck(forgeRoot: string, ts: string, input: MigrateAckInput): Promise<void>;
+export interface CheckAckResult {
+    ok: boolean;
+    reason?: 'ack-missing' | 'ack-corrupt';
+}
+export declare function checkMigrateAck(forgeRoot: string, ts: string): Promise<CheckAckResult>;
+//# sourceMappingURL=ack.d.ts.map

package/dist/core/migrate/ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/ack.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAmBlE;AAWD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjE;AAGD,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;CACxC;AAGD,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAa5F"}

package/dist/core/migrate/ack.js

@@ -0,0 +1,62 @@
+// src/core/migrate/ack.ts
+// migrate 专属 ack — Plan 8e Task 5.1
+// Spec §2.8 步骤 4 + §5.1 不复用 legacy-bridge(brownfield 路径 + 文案)
+import { writeFile, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { stringify, parse } from 'yaml';
+// 渲染交互 prompt:列数据传输内容 + 预估成本 + 提供商
+export function renderMigratePrompt(input) {
+    const { source, estimatedCostUsd } = input;
+    const sourceDesc = source === 'openspec'
+        ? 'openspec/specs/changes/explorations/ 下的 markdown 文档'
+        : 'docs/superpowers/{specs,plans}/ 下的 design.md + plan.md';
+    return `
+✗ forge migrate --regenerate 需要发送数据到 Anthropic API。
+
+数据传输内容(${source} source):
+- ${sourceDesc}
+- redact 规则会先 mask 敏感信息(token / API key / IP / email);自定义 --redact-rules 可附加
+
+预估成本:$${estimatedCostUsd.toFixed(2)} USD
+提供商:Anthropic Claude API
+
+确认继续 → 输入 ack token(下一行 prompt 提示):
+`.trim();
+}
+// ack 文件路径(forge/.forge-ack/migrate-<ts>.yaml)
+export function ackFilePath(forgeRoot, ts) {
+    return join(forgeRoot, '.forge-ack', `migrate-${ts}.yaml`);
+}
+// 写 ack 文件(0o600 防泄漏)
+export async function writeMigrateAck(forgeRoot, ts, input) {
+    const data = {
+        schema: 'forge-migrate-ack/v1',
+        ts,
+        source: input.source,
+        estimated_cost_usd: input.estimatedCostUsd,
+        acknowledged_at: new Date().toISOString(),
+    };
+    await writeFile(ackFilePath(forgeRoot, ts), stringify(data), {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+}
+// 检查 ack 文件存在且 schema 正确
+export async function checkMigrateAck(forgeRoot, ts) {
+    const path = ackFilePath(forgeRoot, ts);
+    if (!existsSync(path))
+        return { ok: false, reason: 'ack-missing' };
+    try {
+        const raw = await readFile(path, 'utf8');
+        const ack = parse(raw);
+        if (!ack || ack.schema !== 'forge-migrate-ack/v1') {
+            return { ok: false, reason: 'ack-corrupt' };
+        }
+        return { ok: true };
+    }
+    catch {
+        return { ok: false, reason: 'ack-corrupt' };
+    }
+}
+//# sourceMappingURL=ack.js.map