@accelerator-mzq/forge 1.4.0

package/dist/core/monitor/trace-store.d.ts

@@ -0,0 +1,39 @@
+import type { TraceEvent, CliExitRecord } from './types.js';
+/** forge/.monitor/ 目录(spec §5) */
+export declare function monitorDir(projectRoot: string): string;
+/** 某 change 的 trace.jsonl 路径 */
+export declare function traceFilePath(projectRoot: string, changeId: string): string;
+/** 项目级 cli-exits.jsonl 路径 */
+export declare function cliExitsPath(projectRoot: string): string;
+/** 追加一条 trace 事件;写入前先建目录(spec §4 G-10) */
+export declare function appendTraceEvent(projectRoot: string, event: TraceEvent): void;
+/** 读某 change 的 trace;逐行解析,坏行跳过并计数 */
+export declare function readTrace(projectRoot: string, changeId: string): {
+    events: TraceEvent[];
+    corruptLines: number;
+};
+/**
+ * 返回本项目的 _session-<uuid> change-id —— pre-change(brainstorm/explore)事件的桶。
+ * 首次调用生成 uuid 并持久化到 forge/.monitor/.session-id,后续读回同一 id。
+ *
+ * 已知 v1 限制:`.session-id` 一经生成即长期存活(不随会话/工作流运行轮转),
+ * 故多个工作流运行的 pre-change 事件会累积在同一 _session 桶 —— report 合并时
+ * 会带入跨 run 的 pre-change 噪声。spec §2.4/§3.2 接受此 best-effort 行为。
+ * TOCTOU:existsSync + readFileSync 间(及并发 writeFileSync)有竞争窗口;
+ * 单进程 CLI 场景可接受(对齐 readTrace / ack-log.ts 惯例)。
+ */
+export declare function sessionChangeId(projectRoot: string): string;
+/**
+ * 读所有 _session-* 桶的 trace 事件并合并(spec §2.4/§3.2:report 渲染时并入 pre-change 事件)。
+ * 正常情况下只有一个 _session-<uuid> 桶;glob 多桶是防御性写法(.session-id 写失败偶发多桶)。
+ */
+export declare function readSessionTrace(projectRoot: string): TraceEvent[];
+/** 追加一条 CLI exit 记录;写入前先建目录 */
+export declare function recordCliExit(projectRoot: string, record: CliExitRecord): void;
+/**
+ * 读项目级 cli-exits.jsonl;坏行静默跳过且不计数。
+ * 与 readTrace 返回 corruptLines 的不对称是有意设计:trace 坏行会进健康报告(spec §11),
+ * 故 readTrace 暴露 corruptLines;cli-exits 仅作 exit code 旁证、不进健康裁决,坏行不暴露计数。
+ */
+export declare function readCliExits(projectRoot: string): CliExitRecord[];
+//# sourceMappingURL=trace-store.d.ts.map

package/dist/core/monitor/trace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-store.d.ts","sourceRoot":"","sources":["../../../src/core/monitor/trace-store.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAI7E;AAGD,qCAAqC;AACrC,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAchD;AAOD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkB3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE,CAelE;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAI9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAajE"}

package/dist/core/monitor/trace-store.js

@@ -0,0 +1,130 @@
+// src/core/monitor/trace-store.ts — append-only JSONL trace 存储(spec §3.2 / §5)
+import { existsSync, mkdirSync, appendFileSync, readFileSync, writeFileSync, readdirSync, } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/** forge/.monitor/ 目录(spec §5) */
+export function monitorDir(projectRoot) {
+    return join(projectRoot, 'forge', '.monitor');
+}
+/** 某 change 的 trace.jsonl 路径 */
+export function traceFilePath(projectRoot, changeId) {
+    return join(monitorDir(projectRoot), changeId, 'trace.jsonl');
+}
+/** 项目级 cli-exits.jsonl 路径 */
+export function cliExitsPath(projectRoot) {
+    return join(monitorDir(projectRoot), 'cli-exits.jsonl');
+}
+/** 追加一条 trace 事件;写入前先建目录(spec §4 G-10) */
+export function appendTraceEvent(projectRoot, event) {
+    const file = traceFilePath(projectRoot, event.change_id);
+    mkdirSync(dirname(file), { recursive: true });
+    appendFileSync(file, JSON.stringify(event) + '\n', 'utf8');
+}
+// existsSync + readFileSync 间有 TOCTOU 窗口;单进程 CLI 场景可接受(对齐 ack-log.ts 惯例)
+/** 读某 change 的 trace;逐行解析,坏行跳过并计数 */
+export function readTrace(projectRoot, changeId) {
+    const file = traceFilePath(projectRoot, changeId);
+    if (!existsSync(file))
+        return { events: [], corruptLines: 0 };
+    const events = [];
+    let corruptLines = 0;
+    for (const line of readFileSync(file, 'utf8').split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            events.push(JSON.parse(line));
+        }
+        catch {
+            corruptLines++;
+        }
+    }
+    return { events, corruptLines };
+}
+/** session-id 持久化文件路径 */
+function sessionIdFile(projectRoot) {
+    return join(monitorDir(projectRoot), '.session-id');
+}
+/**
+ * 返回本项目的 _session-<uuid> change-id —— pre-change(brainstorm/explore)事件的桶。
+ * 首次调用生成 uuid 并持久化到 forge/.monitor/.session-id,后续读回同一 id。
+ *
+ * 已知 v1 限制:`.session-id` 一经生成即长期存活(不随会话/工作流运行轮转),
+ * 故多个工作流运行的 pre-change 事件会累积在同一 _session 桶 —— report 合并时
+ * 会带入跨 run 的 pre-change 噪声。spec §2.4/§3.2 接受此 best-effort 行为。
+ * TOCTOU:existsSync + readFileSync 间(及并发 writeFileSync)有竞争窗口;
+ * 单进程 CLI 场景可接受(对齐 readTrace / ack-log.ts 惯例)。
+ */
+export function sessionChangeId(projectRoot) {
+    const file = sessionIdFile(projectRoot);
+    try {
+        if (existsSync(file)) {
+            const id = readFileSync(file, 'utf8').trim();
+            if (id.startsWith('_session-'))
+                return id;
+        }
+    }
+    catch {
+        /* 读失败 → 落到生成新 id */
+    }
+    const id = `_session-${randomUUID()}`;
+    try {
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, id, 'utf8');
+    }
+    catch {
+        /* 写失败也返回 id —— record 仍能写 trace,只是下次又生成新 id */
+    }
+    return id;
+}
+/**
+ * 读所有 _session-* 桶的 trace 事件并合并(spec §2.4/§3.2:report 渲染时并入 pre-change 事件)。
+ * 正常情况下只有一个 _session-<uuid> 桶;glob 多桶是防御性写法(.session-id 写失败偶发多桶)。
+ */
+export function readSessionTrace(projectRoot) {
+    const dir = monitorDir(projectRoot);
+    if (!existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of entries) {
+        if (!name.startsWith('_session-'))
+            continue;
+        out.push(...readTrace(projectRoot, name).events);
+    }
+    return out;
+}
+/** 追加一条 CLI exit 记录;写入前先建目录 */
+export function recordCliExit(projectRoot, record) {
+    const file = cliExitsPath(projectRoot);
+    mkdirSync(dirname(file), { recursive: true });
+    appendFileSync(file, JSON.stringify(record) + '\n', 'utf8');
+}
+/**
+ * 读项目级 cli-exits.jsonl;坏行静默跳过且不计数。
+ * 与 readTrace 返回 corruptLines 的不对称是有意设计:trace 坏行会进健康报告(spec §11),
+ * 故 readTrace 暴露 corruptLines;cli-exits 仅作 exit code 旁证、不进健康裁决,坏行不暴露计数。
+ */
+export function readCliExits(projectRoot) {
+    const file = cliExitsPath(projectRoot);
+    if (!existsSync(file))
+        return [];
+    const out = [];
+    for (const line of readFileSync(file, 'utf8').split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            /* 坏行跳过 */
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=trace-store.js.map

package/dist/core/monitor/trace-store.js.map

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

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

@@ -0,0 +1,63 @@
+/** 所有受监控的工作阶段(运行时数组;MonitorStage 类型由它派生 —— 单一数据源) */
+export declare const MONITOR_STAGES: readonly ["brainstorm", "propose", "apply", "review", "verify", "archive", "explore", "ack-confirm", "upgrade", "codex-adversarial", "unknown"];
+/** 受监控的工作阶段;主流程 6 步 + explore 可进三方对比,forge 专属命令仅 CLI 层 */
+export type MonitorStage = (typeof MONITOR_STAGES)[number];
+/** 可与 OpenSpec/superpowers 三方对比的阶段(spec §1.3:forge 专属命令不进对比) */
+export declare const COMPARABLE_STAGES: readonly ["brainstorm", "propose", "apply", "review", "verify", "archive", "explore"];
+/** trace 事件的层:cli = CLI 产物/exit 观察;ai = AI 主代理上报 */
+export type TraceLayer = 'cli' | 'ai';
+/** trace.jsonl 里的一条事件(spec §3.2) */
+export interface TraceEvent {
+    ts: string;
+    schema: 'forge-monitor-trace/v1';
+    change_id: string;
+    stage: MonitorStage;
+    layer: TraceLayer;
+    event: string;
+    data: Record<string, unknown>;
+}
+/** cli-exits.jsonl 里的一条记录(spec §4 约束 6) */
+export interface CliExitRecord {
+    ts: string;
+    command: string[];
+    cwd: string;
+    exit_code: number;
+}
+/** 差异映射表里的一个对比场景(spec §6.2) */
+export interface DivergenceScenario {
+    stage: MonitorStage;
+    scenario_id: string;
+    desc: string;
+    openspec: string;
+    superpowers: string;
+    forge: string;
+    rationale: string;
+    regression_signal: string;
+}
+/** 差异映射表(spec §6.1;数据以 TS const 形式存在,非独立 yaml) */
+export interface DivergenceMap {
+    meta: {
+        schema: 'forge-monitor-divergence-map/v1';
+        synced_against: {
+            openspec: string;
+            superpowers: string;
+        };
+        synced_at: string;
+    };
+    scenarios: DivergenceScenario[];
+}
+/** 健康裁决等级(spec §10) */
+export type VerdictLevel = 'ok' | 'regression' | 'anomaly';
+/** 健康裁决里的一条命中项 */
+export interface VerdictItem {
+    kind: 'regression' | 'anomaly';
+    stage: MonitorStage;
+    detail: string;
+    evidence: string;
+}
+/** 单次健康检查的完整裁决结果(spec §10) */
+export interface HealthVerdict {
+    level: VerdictLevel;
+    items: VerdictItem[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/monitor/types.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,eAAO,MAAM,cAAc,iJAYjB,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,uFAQc,CAAC;AAE7C,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC;AAEtC,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,MAAM,EAAE,iCAAiC,CAAC;QAC1C,cAAc,EAAE;YACd,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED,uBAAuB;AACvB,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,YAAY,GAAG,SAAS,CAAC;AAE3D,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB"}

package/dist/core/monitor/types.js

@@ -0,0 +1,26 @@
+// src/core/monitor/types.ts — workflow-monitor 全模块共享类型(spec §3.2 / §6 / §10)
+/** 所有受监控的工作阶段(运行时数组;MonitorStage 类型由它派生 —— 单一数据源) */
+export const MONITOR_STAGES = [
+    'brainstorm',
+    'propose',
+    'apply',
+    'review',
+    'verify',
+    'archive',
+    'explore',
+    'ack-confirm',
+    'upgrade',
+    'codex-adversarial',
+    'unknown',
+];
+/** 可与 OpenSpec/superpowers 三方对比的阶段(spec §1.3:forge 专属命令不进对比) */
+export const COMPARABLE_STAGES = [
+    'brainstorm',
+    'propose',
+    'apply',
+    'review',
+    'verify',
+    'archive',
+    'explore',
+];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/monitor/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY;IACZ,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT,aAAa;IACb,SAAS;IACT,mBAAmB;IACnB,SAAS;CACD,CAAC;AAKX,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,YAAY;IACZ,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;CACiC,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { Section } from './markdown.js';
+/** parseDesign 函数的返回结构 */
+export interface ParsedDesign {
+    /** design 标题(来自 h1) */
+    title: string;
+    /** h2 及以下所有章节(不含 h1 标题章节) */
+    sections: Section[];
+}
+/**
+ * 解析 design.md 文本。
+ * 只抽 title(h1)和所有 h2+ 章节，不强制特定段名。
+ */
+export declare function parseDesign(text: string): ParsedDesign;
+//# sourceMappingURL=design.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../../../src/core/parse/design.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAWtD"}

package/dist/core/parse/design.js

@@ -0,0 +1,17 @@
+// design.md 解析器 — 通用结构(title + sections),不强制具体段名
+import { parseMarkdown } from './markdown.js';
+/**
+ * 解析 design.md 文本。
+ * 只抽 title(h1)和所有 h2+ 章节，不强制特定段名。
+ */
+export function parseDesign(text) {
+    const md = parseMarkdown(text);
+    // 找 h1 作为标题
+    const titleSection = md.sections.find((s) => s.level === 1);
+    return {
+        title: titleSection?.heading ?? '',
+        // 过滤出 h2 及以下章节
+        sections: md.sections.filter((s) => s.level >= 2),
+    };
+}
+//# sourceMappingURL=design.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design.js","sourceRoot":"","sources":["../../../src/core/parse/design.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAW9C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAE/B,YAAY;IACZ,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IAE5D,OAAO;QACL,KAAK,EAAE,YAAY,EAAE,OAAO,IAAI,EAAE;QAClC,eAAe;QACf,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;KAClD,CAAC;AACJ,CAAC"}

package/dist/core/parse/fenced-yaml.d.ts

@@ -0,0 +1,18 @@
+/** fenced YAML 块解析失败(语法错或位置不可定位) */
+export declare class FencedYamlParseError extends Error {
+    readonly blockIndex: number;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, blockIndex: number, // 0-based,markdown 内 yaml 块序号
+    cause?: unknown | undefined);
+}
+/**
+ * 从 markdown 文本抽所有 ```yaml ... ``` block 并 YAML.parse。
+ * - 仅匹配 ```yaml(显式 lang,大小写不敏感),忽略 ``` 或 ```ts 等
+ * - 按出现顺序返回
+ * - 任一块 YAML 解析失败 → 抛 FencedYamlParseError 含 blockIndex
+ *
+ * 注:被 Task 3 content_hash 调用时,即使整体 YAML 解析失败,段的剔除逻辑也得继续工作(因为 hash 算的是字面 markdown 不依赖 YAML 内容)。
+ * 故 Task 3 调用方应自己 wrap try/catch,YAML 错误下回退到"段存在 → 仍剔除"。
+ */
+export declare function parseFencedYamlBlocks(text: string): unknown[];
+//# sourceMappingURL=fenced-yaml.d.ts.map

package/dist/core/parse/fenced-yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fenced-yaml.d.ts","sourceRoot":"","sources":["../../../src/core/parse/fenced-yaml.ts"],"names":[],"mappings":"AAMA,oCAAoC;AACpC,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,UAAU,EAAE,MAAM;aACT,KAAK,CAAC,EAAE,OAAO;gBAFxC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAAE,8BAA8B;IACzC,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAiB7D"}

package/dist/core/parse/fenced-yaml.js

@@ -0,0 +1,45 @@
+// src/core/parse/fenced-yaml.ts
+// 从 markdown 文本抽所有 ```yaml ... ``` block 并 YAML.parse;
+// plan-9b Task 2 — 被 Task 3(content_hash 排除)/ Task 4(validate)/ Task 5(scope aggregator)复用
+import { parse as parseYaml, YAMLParseError } from 'yaml';
+/** fenced YAML 块解析失败(语法错或位置不可定位) */
+export class FencedYamlParseError extends Error {
+    blockIndex;
+    cause;
+    constructor(message, blockIndex, // 0-based,markdown 内 yaml 块序号
+    cause) {
+        super(message);
+        this.blockIndex = blockIndex;
+        this.cause = cause;
+        this.name = 'FencedYamlParseError';
+    }
+}
+/**
+ * 从 markdown 文本抽所有 ```yaml ... ``` block 并 YAML.parse。
+ * - 仅匹配 ```yaml(显式 lang,大小写不敏感),忽略 ``` 或 ```ts 等
+ * - 按出现顺序返回
+ * - 任一块 YAML 解析失败 → 抛 FencedYamlParseError 含 blockIndex
+ *
+ * 注:被 Task 3 content_hash 调用时,即使整体 YAML 解析失败,段的剔除逻辑也得继续工作(因为 hash 算的是字面 markdown 不依赖 YAML 内容)。
+ * 故 Task 3 调用方应自己 wrap try/catch,YAML 错误下回退到"段存在 → 仍剔除"。
+ */
+export function parseFencedYamlBlocks(text) {
+    const blocks = [];
+    // 匹配 ```yaml ... ``` (非贪婪,跨行);lang 仅接 yaml,大小写不敏感
+    const re = /```yaml\s*\n([\s\S]*?)\n?```/gi;
+    let idx = 0;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const raw = m[1] ?? '';
+        try {
+            blocks.push(parseYaml(raw));
+        }
+        catch (err) {
+            const detail = err instanceof YAMLParseError ? err.message : String(err);
+            throw new FencedYamlParseError(`fenced yaml block #${idx} parse error: ${detail}`, idx, err);
+        }
+        idx++;
+    }
+    return blocks;
+}
+//# sourceMappingURL=fenced-yaml.js.map

package/dist/core/parse/fenced-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fenced-yaml.js","sourceRoot":"","sources":["../../../src/core/parse/fenced-yaml.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uDAAuD;AACvD,2FAA2F;AAE3F,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE1D,oCAAoC;AACpC,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG3B;IACS;IAH3B,YACE,OAAe,EACC,UAAkB,EAAE,8BAA8B;IACzC,KAAe;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QACT,UAAK,GAAL,KAAK,CAAU;QAGxC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,kDAAkD;IAClD,MAAM,EAAE,GAAG,gCAAgC,CAAC;IAC5C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzE,MAAM,IAAI,oBAAoB,CAAC,sBAAsB,GAAG,iBAAiB,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/F,CAAC;QACD,GAAG,EAAE,CAAC;IACR,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,7 @@
+export * from './markdown.js';
+export * from './yaml.js';
+export * from './proposal.js';
+export * from './design.js';
+export * from './specs.js';
+export * from './tasks.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/parse/index.js

@@ -0,0 +1,8 @@
+// src/core/parse/index.ts — 统一导出所有解析器
+export * from './markdown.js';
+export * from './yaml.js';
+export * from './proposal.js';
+export * from './design.js';
+export * from './specs.js';
+export * from './tasks.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/parse/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,30 @@
+/** parseMarkdown 函数的返回结构 */
+export interface ParsedMarkdown {
+    /** YAML frontmatter 解析结果(无则空对象) */
+    frontmatter: Record<string, unknown>;
+    /** 原始正文(去掉 frontmatter) */
+    body: string;
+    /** 按 ATX heading(`#`)切分的章节 */
+    sections: Section[];
+}
+/** 一个 heading 章节 */
+export interface Section {
+    /** 标题级别(1-6) */
+    level: number;
+    /** 标题文本(不含 `#` 和空格) */
+    heading: string;
+    /** 标题后缀 anchor ID(可选,形如 `{#forge-oos}`) — 被 Task 3/4/5 复用用于剔除/校验/聚合 */
+    anchor?: string;
+    /** 该章节正文(到下一个同级或更高级 heading 之前) */
+    body: string;
+    /** 起始行号(1-indexed,heading 行) */
+    startLine: number;
+    /** 结束行号(下一个 heading 行 - 1,或文件末尾) */
+    endLine: number;
+}
+/**
+ * 解析 markdown 文本。
+ * 支持 YAML frontmatter(`---` 包裹)+ ATX heading(`# / ##`)分章节。
+ */
+export declare function parseMarkdown(text: string): ParsedMarkdown;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/core/parse/markdown.ts"],"names":[],"mappings":"AAIA,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,oBAAoB;AACpB,MAAM,WAAW,OAAO;IACtB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAU1D"}

package/dist/core/parse/markdown.js

@@ -0,0 +1,66 @@
+// markdown 解析器 — 抽 frontmatter 和按 heading 切 section
+import matter from 'gray-matter';
+/**
+ * 解析 markdown 文本。
+ * 支持 YAML frontmatter(`---` 包裹)+ ATX heading(`# / ##`)分章节。
+ */
+export function parseMarkdown(text) {
+    // gray-matter 自动处理 frontmatter
+    const parsed = matter(text);
+    const frontmatter = (parsed.data ?? {});
+    const body = parsed.content;
+    // 按 heading 切分正文
+    const sections = extractSections(body);
+    return { frontmatter, body, sections };
+}
+/**
+ * 把 markdown 正文按 ATX heading 切成章节。
+ * 每遇到新 heading 就关闭当前 section，开启新 section。
+ * 自动识别 heading 后缀 `{#xxx}` 作为 anchor ID。
+ */
+function extractSections(body) {
+    const lines = body.split('\n');
+    const sections = [];
+    let current = null;
+    const buffer = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        // 匹配 ATX heading：1-6 个 # 后接空格和标题文本
+        const headingMatch = line.match(/^(#{1,6})\s+(.+?)(?:\s*)$/);
+        if (headingMatch) {
+            // 关闭当前 section，把缓冲区内容写入 body
+            if (current) {
+                current.body = buffer.join('\n');
+                current.endLine = i; // 当前行是新 heading，所以 endLine 是上一行索引
+                sections.push(current);
+                buffer.length = 0;
+            }
+            // 提取原始 heading 文本
+            const rawHeading = headingMatch[2] ?? '';
+            // 匹配 anchor `{#xxx}` 后缀(charset 仅 ASCII alphanum + `_` + `-`;
+            // v2 codex MINOR 修订:不是 CommonMark heading-id 兼容;forge 只用三个固定 ASCII anchor
+            // (forge-oos / forge-non-goals / forge-future-work),严格 charset 是有意为之 — 阻止"用 unicode 绕过 fence"攻击)
+            const anchorMatch = rawHeading.match(/^(.*?)\s*\{#([A-Za-z0-9_-]+)\}\s*$/);
+            // 开始新 section
+            current = {
+                level: headingMatch[1]?.length ?? 1,
+                heading: anchorMatch ? (anchorMatch[1]?.trim() ?? '') : rawHeading.trim(),
+                anchor: anchorMatch ? anchorMatch[2] : undefined,
+                body: '',
+                startLine: i + 1, // 1-indexed
+                endLine: lines.length, // 默认到文件末尾
+            };
+        }
+        else if (current) {
+            // 当前行属于 current section 的正文
+            buffer.push(line);
+        }
+    }
+    // 关闭最后一个 section
+    if (current) {
+        current.body = buffer.join('\n');
+        sections.push(current);
+    }
+    return sections;
+}
+//# sourceMappingURL=markdown.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/core/parse/markdown.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,MAAM,MAAM,aAAa,CAAC;AA4BjC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,+BAA+B;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC;IAE5B,iBAAiB;IACjB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,mCAAmC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAE7D,IAAI,YAAY,EAAE,CAAC;YACjB,6BAA6B;YAC7B,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,kCAAkC;gBACvD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;YACpB,CAAC;YACD,kBAAkB;YAClB,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,8DAA8D;YAC9D,0EAA0E;YAC1E,iGAAiG;YACjG,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YAC3E,cAAc;YACd,OAAO,GAAG;gBACR,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC;gBACnC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE;gBACzE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;gBAChD,IAAI,EAAE,EAAE;gBACR,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY;gBAC9B,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;aAClC,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,4BAA4B;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,18 @@
+/** parseProposal 函数的返回结构 */
+export interface ParsedProposal {
+    /** proposal 标题(来自 h1) */
+    title: string;
+    /** Why 章节正文 */
+    why: string;
+    /** What 章节正文 */
+    what: string;
+    /** Scope 章节正文(可选，无则 undefined) */
+    scope?: string;
+}
+/**
+ * 解析 proposal.md 文本。
+ * 期望结构:`# <Title>` + `## Why` + `## What` + 可选 `## Scope`。
+ * 缺 title / why / what 不报错(留给 validate 阶段)。
+ */
+export declare function parseProposal(text: string): ParsedProposal;
+//# sourceMappingURL=proposal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../../../src/core/parse/proposal.ts"],"names":[],"mappings":"AAIA,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmB1D"}

package/dist/core/parse/proposal.js

@@ -0,0 +1,22 @@
+// proposal.md 解析器 — 抽 title / why / what / scope
+import { parseMarkdown } from './markdown.js';
+/**
+ * 解析 proposal.md 文本。
+ * 期望结构:`# <Title>` + `## Why` + `## What` + 可选 `## Scope`。
+ * 缺 title / why / what 不报错(留给 validate 阶段)。
+ */
+export function parseProposal(text) {
+    const md = parseMarkdown(text);
+    // 从 sections 中找 h1 作为标题
+    const titleSection = md.sections.find((s) => s.level === 1);
+    const title = titleSection?.heading ?? '';
+    // 按 heading 名称（不区分大小写）查找章节正文
+    const findBody = (heading) => md.sections.find((s) => s.heading.toLowerCase() === heading.toLowerCase())?.body.trim() ?? '';
+    const why = findBody('Why');
+    const what = findBody('What');
+    // Scope 章节可选：找到时返回正文，找不到时返回 undefined
+    const scopeSection = md.sections.find((s) => s.heading.toLowerCase() === 'scope');
+    const scope = scopeSection?.body.trim();
+    return { title, why, what, scope };
+}
+//# sourceMappingURL=proposal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../../../src/core/parse/proposal.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAc9C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAE/B,wBAAwB;IACxB,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,YAAY,EAAE,OAAO,IAAI,EAAE,CAAC;IAE1C,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,EAAE,CACnC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAEhG,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,sCAAsC;IACtC,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAExC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,25 @@
+/** parseSpec 函数的返回结构 */
+export interface ParsedSpec {
+    /** 规格文档标题（H1） */
+    title: string;
+    /** 所有 scenario 列表 */
+    scenarios: Scenario[];
+}
+/** 单个 Scenario 结构 */
+export interface Scenario {
+    /** 从 "## Scenario: <id>" 标题抽出的 id */
+    id: string;
+    /** Given 子句正文(去 **Given** 前缀) */
+    given: string[];
+    /** When 子句 */
+    when: string[];
+    /** Then + And 子句(都归入 then) */
+    then: string[];
+    /** 该 scenario 的原始 markdown body */
+    rawBody: string;
+}
+/**
+ * 解析 specs markdown 文件，抽取标题和 Given/When/Then scenario 列表。
+ */
+export declare function parseSpec(text: string): ParsedSpec;
+//# sourceMappingURL=specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../src/core/parse/specs.ts"],"names":[],"mappings":"AAIA,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,qBAAqB;AACrB,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAqDlD"}