@accelerator-mzq/forge 1.4.0

package/dist/core/schema/types.js

@@ -0,0 +1,51 @@
+// spec-driven schema 类型定义 — 对应 forge/config.yaml + 默认 schema
+/**
+ * 默认 light_threshold(P3 修复;调用方 fallback 用)。
+ * 详见 spec §2.3 + Plan 2 Task 2.2。
+ */
+export const DEFAULT_LIGHT_THRESHOLD = 200;
+/** model_tiers 缺失时的恒等默认(resolveModelTiers fallback 用) */
+export const DEFAULT_MODEL_TIERS = {
+    haiku: 'haiku',
+    sonnet: 'sonnet',
+    opus: 'opus',
+};
+/**
+ * 默认 process_verification 配置(plan-9g §6;调用方 fallback 用)
+ * brainstorm spec §6 锁定四档默认值
+ */
+export const DEFAULT_PROCESS_VERIFICATION = {
+    mode: 'full',
+    sample_ratio: 0.3,
+    test_timeout_per_task: 300, // 秒
+    max_parallel_reruns: 2,
+};
+/** 默认 test.reporter(plan-9g §6) */
+export const DEFAULT_TEST_REPORTER = 'junit';
+/** 默认 ack.allow_ci_mode(plan-9g §6;false 防 CI 静默降级) */
+export const DEFAULT_ACK_ALLOW_CI_MODE = false;
+/**
+ * 默认 protected branches(plan-9h §2.8.3 C;调用方 fallback 用)。
+ * 详见 design v3 §2.8.3 C line 1432-1438。
+ */
+export const DEFAULT_PROTECTED_BRANCHES = ['main', 'master', 'develop', 'trunk'];
+/**
+ * 默认 spec-driven schema 的 artifact 列表(决定哪些文件构成一个 change)。
+ */
+export const DEFAULT_ARTIFACTS = ['proposal', 'specs', 'design', 'tasks'];
+/**
+ * code_paths.exclude 的默认值(不可关闭,与用户声明合并使用)。
+ * 详见 spec §3.4 hash 计算规则。
+ */
+export const DEFAULT_CODE_EXCLUDE = [
+    'forge/**',
+    '**/*.md',
+    '**/.verify-passed',
+    '**/.review-passed',
+    '**/.verify-failed',
+    '**/.review-failed',
+    '**/.evidence/**',
+];
+// §3.12.1 Interface Freeze 共享字段 single source of truth — 后续 sub-plan reference 此处
+export * from '../schemas/severity.js';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/schema/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AA0I7D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,yDAAyD;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAA6D;IAC3F,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,IAAI,EAAE,MAAe;IACrB,YAAY,EAAE,GAAG;IACjB,qBAAqB,EAAE,GAAG,EAAE,IAAI;IAChC,mBAAmB,EAAE,CAAC;CACvB,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAgB,CAAC;AAEtD,uDAAuD;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGnF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,UAAU;IACV,SAAS;IACT,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;CACT,CAAC;AAEX,kFAAkF;AAClF,cAAc,wBAAwB,CAAC"}

package/dist/core/schema/writing-plans-config.d.ts

@@ -0,0 +1,11 @@
+import type { ForgeConfig } from './types.js';
+/**
+ * 验证并 sanitize writing_plans.light_threshold。
+ * 永远返回合法 number(用 default fallback,不抛错 — 配置层 graceful degradation)。
+ *
+ * @param config — forge/config.yaml 解析结果(可缺 writing_plans 段)
+ * @param warn — 注入 console.warn 用于测试 / 自定义 logger;默认 console.warn
+ * @returns 合法的 light_threshold(默认 200,范围 [50, 2000])
+ */
+export declare function validateWritingPlansConfig(config: ForgeConfig | undefined, warn?: (msg: string) => void): number;
+//# sourceMappingURL=writing-plans-config.d.ts.map

package/dist/core/schema/writing-plans-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-plans-config.d.ts","sourceRoot":"","sources":["../../../src/core/schema/writing-plans-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAiC,GACvD,MAAM,CAkCR"}

package/dist/core/schema/writing-plans-config.js

@@ -0,0 +1,40 @@
+// v0.3 P3 修复(spec §2.3 + Plan 2 Task 2.2):
+// writing-plans skill 的 scale-aware mode 配置 validation。
+// 规则:
+//   - 缺失字段 → 返回默认 200
+//   - 非整数 / 范围外 [50, 2000] → stderr warn + fallback 200
+//   - 合法值 → 直接返回
+import { DEFAULT_LIGHT_THRESHOLD } from './types.js';
+/**
+ * 验证并 sanitize writing_plans.light_threshold。
+ * 永远返回合法 number(用 default fallback,不抛错 — 配置层 graceful degradation)。
+ *
+ * @param config — forge/config.yaml 解析结果(可缺 writing_plans 段)
+ * @param warn — 注入 console.warn 用于测试 / 自定义 logger;默认 console.warn
+ * @returns 合法的 light_threshold(默认 200,范围 [50, 2000])
+ */
+export function validateWritingPlansConfig(config, warn = (msg) => console.warn(msg)) {
+    const raw = config?.writing_plans?.light_threshold;
+    // 缺失 → 默认
+    if (raw === undefined || raw === null) {
+        return DEFAULT_LIGHT_THRESHOLD;
+    }
+    // 非数字 → warn + fallback
+    if (typeof raw !== 'number' || Number.isNaN(raw)) {
+        warn(`forge config: writing_plans.light_threshold must be a number, got ${typeof raw}; falling back to ${DEFAULT_LIGHT_THRESHOLD}`);
+        return DEFAULT_LIGHT_THRESHOLD;
+    }
+    // 非整数 → warn + fallback
+    if (!Number.isInteger(raw)) {
+        warn(`forge config: writing_plans.light_threshold must be integer, got ${raw}; falling back to ${DEFAULT_LIGHT_THRESHOLD}`);
+        return DEFAULT_LIGHT_THRESHOLD;
+    }
+    // 范围 [50, 2000] → 否则 warn + fallback
+    if (raw < 50 || raw > 2000) {
+        warn(`forge config: writing_plans.light_threshold out of range [50, 2000], got ${raw}; falling back to ${DEFAULT_LIGHT_THRESHOLD}`);
+        return DEFAULT_LIGHT_THRESHOLD;
+    }
+    // 合法值
+    return raw;
+}
+//# sourceMappingURL=writing-plans-config.js.map

package/dist/core/schema/writing-plans-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writing-plans-config.js","sourceRoot":"","sources":["../../../src/core/schema/writing-plans-config.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,wDAAwD;AACxD,MAAM;AACN,sBAAsB;AACtB,wDAAwD;AACxD,iBAAiB;AAGjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA+B,EAC/B,OAA8B,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;IAExD,MAAM,GAAG,GAAG,MAAM,EAAE,aAAa,EAAE,eAAe,CAAC;IAEnD,UAAU;IACV,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACtC,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,CACF,qEAAqE,OAAO,GAAG,qBAAqB,uBAAuB,EAAE,CAC9H,CAAC;QACF,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CACF,oEAAoE,GAAG,qBAAqB,uBAAuB,EAAE,CACtH,CAAC;QACF,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,qCAAqC;IACrC,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QAC3B,IAAI,CACF,4EAA4E,GAAG,qBAAqB,uBAAuB,EAAE,CAC9H,CAAC;QACF,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,MAAM;IACN,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/schemas/archive-summary.d.ts

@@ -0,0 +1,131 @@
+import type { Severity } from './severity.js';
+/** archive_summary 顶级 schema(9 业务字段 + 1 schema identifier,沿 master §3.12.1bis + v2 BLOCKER 2 注脚) */
+export interface ArchiveSummary {
+    /**
+     * YAML schema identifier(v2 BLOCKER 2:不算 master §3.12.1bis 9 业务字段;
+     * 沿 forge marker schema 同约定 — 每个 YAML 产物都有 schema literal 标识)
+     */
+    schema: 'forge-archive-summary/v1';
+    /** semver(沿 forge 自身版本号叙事 §1.4,9e1 写 '1.0.0') */
+    version: string;
+    /** ISO 8601 UTC */
+    archived_at: string;
+    /** change id(非空) */
+    change_id: string;
+    /** verify-passed 摘要(含 verified_invariants 列表;9d verify 三维度填) */
+    verify_passed: VerifyPassedRef;
+    /** review-passed 摘要(含 reviewers 列表) */
+    review_passed: ReviewPassedRef;
+    /** process_evidence 14 不变量 pass/fail/legacy 分布;9e1 仅 placeholder,9e2 接 9g 真实统计 */
+    process_evidence_summary: ProcessEvidenceSummary;
+    /** 单 change archive 的不可变 handoff 记录 — 三类聚合(沿 design §2.4.3)。
+     *  注:跨 change backlog 注册表见 forge/backlog/,由 plan-backlog-registry 独立扫 scope YAML 生成,不消费本字段。 */
+    handoff_to_backlog: HandoffEntry[];
+    /** 给用户回顾用 — verify/review 中 WARNING + acked 的引用 */
+    acked_warnings: AckedWarningRef[];
+    /** SUGGESTION + resolved=false 的引用(handoff 子集,但单独列出方便 §2.4.4 输出按类分段) */
+    pending_suggestions: SuggestionRef[];
+}
+/** verify-passed 摘要 */
+export interface VerifyPassedRef {
+    /** 已验证的不变量(9d 三维度 / 9g 13 不变量;9e1 至少含 'hash-match' / 'evidence-complete') */
+    verified_invariants: string[];
+}
+/** review-passed 摘要 */
+export interface ReviewPassedRef {
+    /** reviewer 列表(actor 值;'ai-agent' / 'human-override' / 具体用户名) */
+    reviewers: string[];
+}
+/**
+ * process_evidence_summary — 14 不变量分布(9g/9e2 真实填,9e1 仅 placeholder)
+ *
+ * placeholder=true 表示本字段是 9e1 占位,9e2 实施时改为真实统计:
+ *   - placeholder: false
+ *   - invariants_passed: number(经 mapper 优先级筛选后仍为 status='pass' 的 invariant 数)
+ *   - invariants_with_warning: number(经 mapper 优先级筛选后仍为 status='warning' 的 invariant 数)
+ *   - invariants_failed: number(v1.0 永远 = 0,fence.ok=false 时 archive 直接 exit 1,summary 不写入)
+ *   - legacy_exempt: number(legacy marker 豁免数 — verify || review 任一为 legacy 即触发,沿 §3.4.4.1)
+ *
+ * **精度损失说明(v1.0 接受)**:legacy 路径下被豁免的 invariant 即使产 WARNING 也优先标 'legacy-skip'
+ * 不计入 invariants_with_warning;特别是 review-only legacy + verify-side WARNING 副作用
+ * (沿 brainstorm spec §4.3 边界场景 + §7 遗留 #8);WARNING 实际信息仍走 acked_warnings(freeze-time)
+ * 或 stderr(rerun-time)双路径不丢,仅 summary 中 invariants_with_warning 计数偏低;
+ * v1.1+ side-aware mapper 修复。
+ *
+ * **sum 不变式**:invariants_passed + invariants_with_warning + invariants_failed + legacy_exempt
+ *               === FENCE_INVARIANT_NAMES.length(14)
+ */
+export interface ProcessEvidenceSummary {
+    /** true = 9e1 占位;false = 9e2 真实统计 */
+    placeholder: boolean;
+    /** placeholder=true 时填说明 */
+    note?: string;
+    /** placeholder=false 时填具体数;9e2 接 9g */
+    invariants_passed?: number;
+    /** placeholder=false 时填具体数;9e2 v2 codex 一轮 MAJOR 修订新增字段;legacy 路径下被豁免 invariant 的 WARNING 不计入(精度损失,见上述说明) */
+    invariants_with_warning?: number;
+    /** placeholder=false 时填具体数;v1.0 永远 = 0(fence.ok=false 时 archive exit 1,summary 不写入) */
+    invariants_failed?: number;
+    /** placeholder=false 时填具体数;verify || review 任一为 legacy 时该 invariant 在 §3.4.4.1 豁免表内被跳 */
+    legacy_exempt?: number;
+}
+/** handoff_to_backlog 一项 — 三类 source 聚合(沿 design §2.4.3) */
+export interface HandoffEntry {
+    /** 来源类别 */
+    source: 'verify_findings' | 'review_outcomes' | 'pause_decisions' | 'scope_entries';
+    /** 来源 id(verify_findings.id 数字 / pause_decisions.id 数字 / review_outcomes 索引数字 / scope_entries.id 字符串) */
+    id: number | string;
+    /** 三级 severity(scope_entries 来源时可能为 null,沿 design §2.4.3 字面) */
+    severity?: Severity | null;
+    /** verify/review 来源时的 dimension 字段(沿 9d VerifyFinding) */
+    dimension?: string;
+    /** verify/review 来源时的 check_type 字段(沿 9d VerifyFinding) */
+    check_type?: string;
+    /** 证据定位字符串(沿 9a EVIDENCE_FORMATS) */
+    evidence?: string;
+    /** 建议(可选) */
+    recommendation?: string;
+    /** pause_decisions 来源时的 chosen_option(应固定 = 3 才进 handoff) */
+    chosen_option?: 3;
+    /** pause_decisions 来源时的 target_artifact */
+    target_artifact?: string;
+    /** pause_decisions 来源时的 target_anchor */
+    target_anchor?: string;
+    /** pause_decisions 来源时的 issue_summary */
+    issue_summary?: string;
+    /** scope_entries 来源时的 category(沿 9b ScopeCategory) */
+    category?: 'out-of-scope' | 'non-goal' | 'future-work';
+    /** scope_entries 来源时的 reason */
+    reason?: string;
+}
+/** acked_warnings 一项 — verify_findings / review_outcomes 中 WARNING + acked 的引用 */
+export interface AckedWarningRef {
+    source: 'verify_findings' | 'review_outcomes';
+    id: number;
+    dimension?: string;
+    check_type?: string;
+    evidence?: string;
+    acked_by: string;
+    acked_at: string;
+    rationale?: string;
+}
+/** pending_suggestions 一项 — SUGGESTION + resolved=false 的引用(handoff_to_backlog 子集) */
+export interface SuggestionRef {
+    source: 'verify_findings' | 'review_outcomes';
+    id: number;
+    dimension?: string;
+    check_type?: string;
+    evidence?: string;
+    recommendation?: string;
+}
+/** 9e1 当前 version 常量 */
+export declare const ARCHIVE_SUMMARY_VERSION = "1.0.0";
+/** 9e1 placeholder process_evidence_summary(9e2 接 9g 替换) */
+export declare const PLACEHOLDER_PROCESS_EVIDENCE_SUMMARY: ProcessEvidenceSummary;
+/** ISO 8601 UTC 校验正则(沿 marker-schema.ts:20 同形式) */
+export declare const ARCHIVE_SUMMARY_ISO_8601_RE: RegExp;
+/** semver 弱校验(major.minor.patch[-prerelease][+build]) */
+export declare const SEMVER_RE: RegExp;
+/** 类型守卫:对象具备 ArchiveSummary 顶级字段(运行时浅校验) */
+export declare function looksLikeArchiveSummary(v: unknown): v is ArchiveSummary;
+//# sourceMappingURL=archive-summary.d.ts.map

package/dist/core/schemas/archive-summary.d.ts.map

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

package/dist/core/schemas/archive-summary.js

@@ -0,0 +1,31 @@
+// src/core/schemas/archive-summary.ts — plan-9e1 Task 1
+// §3.12.1bis Interface Freeze:archive_summary 9 业务字段冻结 + 1 schema identifier
+// 沿 design §2.4.3 YAML 字面格式 + master §3.12.1bis 字段表
+//
+// v2 BLOCKER 2 修订:`schema` literal 字段是 YAML schema identifier(沿所有 forge marker
+//   schema 同约定:forge-verify/v1, forge-review/v1, forge-scope-entries/v1,
+//   forge-ack-log/v1 都有),**不算 master §3.12.1bis 9 业务字段**。
+//   master 9 字段冻结指 version / archived_at / change_id / verify_passed / review_passed /
+//   process_evidence_summary / handoff_to_backlog / acked_warnings / pending_suggestions。
+//   字段名沿 master(`acked_warnings`)而非 design line 662 字面(`acknowledged_warnings`)。
+//
+// 后续 sub-plan(9e2 接 process_evidence_summary / v1.1 backlog index)reference 此处,不重定义
+/** 9e1 当前 version 常量 */
+export const ARCHIVE_SUMMARY_VERSION = '1.0.0';
+/** 9e1 placeholder process_evidence_summary(9e2 接 9g 替换) */
+export const PLACEHOLDER_PROCESS_EVIDENCE_SUMMARY = {
+    placeholder: true,
+    note: 'process_evidence 14 不变量统计待 9g + 9e2 实施',
+};
+/** ISO 8601 UTC 校验正则(沿 marker-schema.ts:20 同形式) */
+export const ARCHIVE_SUMMARY_ISO_8601_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
+/** semver 弱校验(major.minor.patch[-prerelease][+build]) */
+export const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[\w.-]+)?(?:\+[\w.-]+)?$/;
+/** 类型守卫:对象具备 ArchiveSummary 顶级字段(运行时浅校验) */
+export function looksLikeArchiveSummary(v) {
+    if (!v || typeof v !== 'object')
+        return false;
+    const o = v;
+    return o.schema === 'forge-archive-summary/v1';
+}
+//# sourceMappingURL=archive-summary.js.map

package/dist/core/schemas/archive-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-summary.js","sourceRoot":"","sources":["../../../src/core/schemas/archive-summary.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,+EAA+E;AAC/E,yEAAyE;AACzE,0DAA0D;AAC1D,uFAAuF;AACvF,0FAA0F;AAC1F,iFAAiF;AACjF,EAAE;AACF,oFAAoF;AAkIpF,wBAAwB;AACxB,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oCAAoC,GAA2B;IAC1E,WAAW,EAAE,IAAI;IACjB,IAAI,EAAE,wCAAwC;CAC/C,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,wCAAwC,CAAC;AAEpF,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAEtE,4CAA4C;AAC5C,MAAM,UAAU,uBAAuB,CAAC,CAAU;IAChD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CAAC,CAAC,MAAM,KAAK,0BAA0B,CAAC;AACjD,CAAC"}

package/dist/core/schemas/process-evidence.d.ts

@@ -0,0 +1,156 @@
+/** ProcessEvidence 顶级 schema(沿 design §2.7.2 字段表) */
+export interface ProcessEvidence {
+    /** YAML schema identifier(沿 forge marker schema 同约定) */
+    schema: 'forge-process-evidence/v1';
+    /** 模式:full(默认重跑全部)| sample(抽样)| hash-only(仅 hash 校验,等同 v0.4 弱 fence) */
+    process_verification_mode: 'full' | 'sample' | 'hash-only';
+    /** mode != full 时必填 — ack-log 含对应 ack-mode 条目;CI 模式拒签 mode != full(沿 §2.7.4 B) */
+    process_verification_mode_acked_by: string | null;
+    /** ISO 8601 UTC */
+    process_verification_mode_acked_at: string | null;
+    /** 环境三因子(MAJOR #23 — 重跑前 env 一致校验,不一致 → WARNING) */
+    env_hash: EnvHash;
+    /** TDD RED→GREEN 事件序列(每 task 一条;沿 §2.7.2 + 不变量 1-6 + 11) */
+    tdd_event_chain: TddEventChain[];
+    /** verify 命令每次跑都 append(沿 §2.7.6 helper append-only;不变量 7) */
+    verify_invocations: VerifyInvocation[];
+    /** subagent 二段 review 痕迹(不变量 8) */
+    subagent_review_chain: SubagentReviewChain[];
+}
+/** 环境三因子哈希(MAJOR #23) */
+export interface EnvHash {
+    /** sha256(pnpm-lock.yaml 或 package-lock.json) */
+    lockfile_hash: string;
+    /** semver,e.g. "20.10.0" */
+    node_version: string;
+    /** "win32" | "darwin" | "linux"(沿 Node os.platform()) */
+    os_platform: 'win32' | 'darwin' | 'linux';
+}
+/** TDD 单 task RED→GREEN 事件链(每 task 一条) */
+export interface TddEventChain {
+    /** task 引用(沿 tasks.md 锚点) */
+    task_ref: string;
+    /** RED 阶段记录(tdd_exemption 非空时可省) */
+    red_commit: RedCommitRecord | null;
+    /** GREEN 阶段记录(必填) */
+    green_commit: GreenCommitRecord;
+    /** light mode trivial change 免 RED 的 ack 引用(沿 §2.7.2 MAJOR #37;不变量 11) */
+    tdd_exemption: TddExemption | null;
+    /** tdd_exemption 非空时必填 — ack-log 中对应 user ack 的 acked_by */
+    tdd_exemption_acked_by: string | null;
+}
+/**
+ * RED commit 记录(brainstorm v6 修订,Codex 一轮 M-1 修复)
+ * 字段名严格沿 master spec §2.7.2 行 1115/1116 字面 — red_commit 节点下的 log/hash 字段
+ * 是 red_log_path / red_log_hash 而非通用 log_path / log_hash
+ */
+export interface RedCommitRecord {
+    /** git sha(40 hex) */
+    sha: string;
+    /** ISO 8601 UTC */
+    timestamp: string;
+    /** RED plain log 路径(forge/changes/<id>/.evidence/ 相对路径;沿 master spec 行 1115) */
+    red_log_path: string;
+    /** sha256(red log content);沿 master spec 行 1116 */
+    red_log_hash: string;
+    /** 进程 exit code — RED 必 != 0(MAJOR #19,不变量 3) */
+    exit_code: number;
+    /** 结构化 reporter 报告路径(JUnit XML / TAP / Vitest JSON;MAJOR #20) */
+    runner_report_path: string;
+    /** sha256(reporter content) */
+    runner_report_hash: string;
+    /** RED 阶段必填:绑定具体失败的 test(MAJOR #24;不变量 5) */
+    expected_failures: ExpectedFailure[];
+}
+/**
+ * GREEN commit 记录(brainstorm v6 修订,Codex 一轮 M-1 修复)
+ * 字段名沿 master spec §2.7.2 行 1127/1128 字面 — green_commit 节点下用 green_log_path/hash
+ * 注:无 expected_failures 字段(schema 层禁止 GREEN 含)
+ */
+export interface GreenCommitRecord {
+    /** git sha(40 hex) */
+    sha: string;
+    /** ISO 8601 UTC */
+    timestamp: string;
+    /** GREEN plain log 路径;沿 master spec 行 1127 */
+    green_log_path: string;
+    /** sha256(green log content);沿 master spec 行 1128 */
+    green_log_hash: string;
+    /** 进程 exit code — GREEN 必 == 0(MAJOR #19,不变量 4) */
+    exit_code: number;
+    /** 结构化 reporter 报告路径 */
+    runner_report_path: string;
+    /** sha256(reporter content) */
+    runner_report_hash: string;
+}
+/** RED 阶段期望失败的 test(MAJOR #24) */
+export interface ExpectedFailure {
+    /** 相对 repo 根 */
+    test_file: string;
+    /** 测试名(对应 reporter 中的 test 标识) */
+    test_name: string;
+    /** 失败类型 */
+    failure_type: 'assertion' | 'timeout' | 'error' | 'not-implemented';
+}
+/** light mode trivial change 免 RED(沿 §2.7.2 MAJOR #37) */
+export interface TddExemption {
+    /** 沿 config.yaml#writing_plans.light_threshold 触发(默认 200 行) */
+    reason: 'light-mode-trivial';
+    /** 变更行数 */
+    loc_delta: number;
+}
+/** verify 命令单次调用记录(沿 §2.7.6 helper append-only) */
+export interface VerifyInvocation {
+    /** ISO 8601 UTC */
+    invoked_at: string;
+    /** 涉及的 task(MAJOR #22:list,支持 per-task / change-level) */
+    task_refs: string[];
+    /** per-task = subagent 实施完单 task 立即跑;change-level = 主代理统一跑 */
+    verify_scope: 'per-task' | 'change-level';
+    /** pass | fail | skip */
+    result: 'pass' | 'fail' | 'skip';
+    /** 进程 exit code */
+    exit_code: number;
+    /** plain log 路径 */
+    log_path: string;
+    log_hash: string;
+    /** 结构化 reporter 报告路径 */
+    runner_report_path: string;
+    runner_report_hash: string;
+}
+/** subagent 二段 review 链(沿 §2.7.2 + 不变量 8) */
+export interface SubagentReviewChain {
+    task_ref: string;
+    /** subagent 实施的 commit */
+    implementer_commit: string;
+    /** spec 维度 review 多次迭代(每次都 append) */
+    spec_reviewer_iterations: ReviewIteration[];
+    /** quality 维度 review 多次迭代 */
+    quality_reviewer_iterations: ReviewIteration[];
+    /** 主代理 check-off 时间(ISO 8601 UTC) */
+    main_agent_check_off_at: string;
+}
+/** 单次 reviewer 迭代 */
+export interface ReviewIteration {
+    /** reviewer subagent 跑完时的 commit sha */
+    reviewer_commit: string;
+    /** needs-fix 走下一轮;approved 终态 */
+    outcome: 'needs-fix' | 'approved';
+    /** review 笔记 log 路径(forge/changes/<id>/.evidence/ 相对) */
+    notes_log_path: string;
+}
+/**
+ * ProcessVerificationConfig:forge/config.yaml#process_verification 字段类型
+ * validateProcessVerificationConfig 校验阈值,见 src/core/schema/process-verification-config.ts
+ */
+export interface ProcessVerificationConfig {
+    /** 默认 'full' */
+    mode: 'full' | 'sample' | 'hash-only';
+    /** sample 模式抽样比例(0..1,默认 0.3) */
+    sample_ratio: number;
+    /** 单 task 重跑超时秒(默认 300) */
+    test_timeout_per_task: number;
+    /** 并发 worktree 上限(默认 2) */
+    max_parallel_reruns: number;
+}
+//# sourceMappingURL=process-evidence.d.ts.map

package/dist/core/schemas/process-evidence.d.ts.map

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

package/dist/core/schemas/process-evidence.js

@@ -0,0 +1,12 @@
+// src/core/schemas/process-evidence.ts — plan-9g Task 1
+// §2.7.2 forge-process-evidence/v1 schema:14 不变量字段 + 五源 cross-check(brainstorm v16)
+// 沿 archive-summary.ts 模式:schema literal + 手写 interface + JSDoc
+//
+// 关键设计(brainstorm spec §4):
+//   - RedCommitRecord / GreenCommitRecord 拆两 interface(Codex 一轮 M-1)
+//   - 字段名严格沿 master spec §2.7.2 行 1115/1116 / 1127/1128 字面
+//     (red_log_path / red_log_hash / green_log_path / green_log_hash;
+//      runner_report_path / runner_report_hash 通用)
+//   - GreenCommitRecord 无 expected_failures 字段(schema 层禁止 GREEN 含)
+export {};
+//# sourceMappingURL=process-evidence.js.map

package/dist/core/schemas/process-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-evidence.js","sourceRoot":"","sources":["../../../src/core/schemas/process-evidence.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,oFAAoF;AACpF,gEAAgE;AAChE,EAAE;AACF,4BAA4B;AAC5B,qEAAqE;AACrE,2DAA2D;AAC3D,sEAAsE;AACtE,mDAAmD;AACnD,mEAAmE"}

package/dist/core/schemas/scope-entries.d.ts

@@ -0,0 +1,68 @@
+/** 三段 category 枚举(沿 design §2.6.2) */
+export type ScopeCategory = 'out-of-scope' | 'non-goal' | 'future-work';
+export declare const SCOPE_CATEGORY_VALUES: readonly ScopeCategory[];
+export declare function isScopeCategory(v: unknown): v is ScopeCategory;
+/** 状态转移五枚举(沿 design §2.6.4) */
+export type ScopeStatus = 'active' | 'inherited' | 'superseded' | 'completed' | 'obsolete';
+export declare const SCOPE_STATUS_VALUES: readonly ScopeStatus[];
+export declare function isScopeStatus(v: unknown): v is ScopeStatus;
+/** 三段 anchor ID(沿 design §2.6.3,§3.12.2 路径冻结) */
+export type ScopeAnchorId = 'forge-oos' | 'forge-non-goals' | 'forge-future-work';
+export declare const SCOPE_ANCHOR_IDS: readonly ScopeAnchorId[];
+export declare function isScopeAnchorId(v: unknown): v is ScopeAnchorId;
+/** anchor ID → category 默认映射(propose 阶段补全 entry.category 用) */
+export declare const ANCHOR_TO_CATEGORY: Record<ScopeAnchorId, ScopeCategory>;
+/** triggered_by 来源(沿 design §2.6.3 字段语义) */
+export interface TriggeredByRef {
+    source: 'pause_decisions' | 'explore_capture' | 'review_outcomes';
+    id: string | number;
+}
+/** 优先级(沿 design §2.6.3,可空) */
+export type ScopePriority = 'critical' | 'high' | 'medium' | 'low' | null;
+/** Scope entry 8 字段(沿 design §2.6.3 字段语义详) */
+export interface ScopeEntry {
+    /** kebab-case 稳定 ID,跨 change 唯一 */
+    id: string;
+    /** 三段分类 */
+    category: ScopeCategory;
+    /** 1-2 句概括 */
+    description: string;
+    /** 必填论证 — 为什么不做 / 为什么反目标 / 为什么是未来工作 */
+    reason: string;
+    /** 优先级(null = 暂未排序) */
+    priority: ScopePriority;
+    /** 状态(沿 §2.6.4 状态转移) */
+    status: ScopeStatus;
+    /** 来源引用(从 §2.1 pause_decisions / §2.5 explore capture / review_outcomes 转入)*/
+    triggered_by: TriggeredByRef | null;
+    /** 关联其他 change id */
+    related_change: string | null;
+}
+/**
+ * 合法的 superseding new_status —— 仅这 4 个值参与扣减(spec §9c 守卫)。
+ * aggregator(扣减守卫)与 backlog/render(invalid-new-status 判定)共用此集合,
+ * 避免两处各自维护副本漂移。
+ */
+export declare const VALID_SUPERSEDING_NEW_STATUS: Set<string>;
+/** SupersedingRef 4 字段(沿 design §2.6.4 forward-reference) */
+export interface SupersedingRef {
+    /** 历史 entry 所在 archived change id */
+    source_change: string;
+    /** 历史 entry 的 id */
+    entry_id: string;
+    /** 新状态(本 change 给出的状态变更) */
+    new_status: ScopeStatus;
+    /** 论证(为什么把状态改成 new_status) */
+    rationale: string;
+}
+/** scope-entries 顶级 schema(§3.12.1bis 锁死) */
+export interface ScopeEntriesBlock {
+    schema: 'forge-scope-entries/v1';
+    /** 每段一个 anchor */
+    anchor_id: ScopeAnchorId;
+    /** 本段 entries */
+    entries: ScopeEntry[];
+    /** 可选 forward-reference */
+    superseding_entries?: SupersedingRef[];
+}
+//# sourceMappingURL=scope-entries.d.ts.map

package/dist/core/schemas/scope-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-entries.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/scope-entries.ts"],"names":[],"mappings":"AAIA,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,aAAa,CAAC;AACxE,eAAO,MAAM,qBAAqB,EAAE,SAAS,aAAa,EAIhD,CAAC;AAEX,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D;AAED,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAC3F,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAM5C,CAAC;AAEX,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAE1D;AAED,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAClF,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAI3C,CAAC;AAEX,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D;AAED,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAInE,CAAC;AAEF,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;IAClE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB;AAED,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;AAE1E,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,wBAAwB;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,qBAAqB;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,aAKvC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,UAAU,EAAE,WAAW,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,wBAAwB,CAAC;IACjC,kBAAkB;IAClB,SAAS,EAAE,aAAa,CAAC;IACzB,iBAAiB;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,2BAA2B;IAC3B,mBAAmB,CAAC,EAAE,cAAc,EAAE,CAAC;CACxC"}

package/dist/core/schemas/scope-entries.js

@@ -0,0 +1,47 @@
+// src/core/schemas/scope-entries.ts
+// §3.12.1bis Interface Freeze 共享 schema(plan-9b)
+// 后续 sub-plan(9e2 / 9f / 9d / receiving-code-review) reference 此处,不重定义
+export const SCOPE_CATEGORY_VALUES = [
+    'out-of-scope',
+    'non-goal',
+    'future-work',
+];
+export function isScopeCategory(v) {
+    return typeof v === 'string' && SCOPE_CATEGORY_VALUES.includes(v);
+}
+export const SCOPE_STATUS_VALUES = [
+    'active',
+    'inherited',
+    'superseded',
+    'completed',
+    'obsolete',
+];
+export function isScopeStatus(v) {
+    return typeof v === 'string' && SCOPE_STATUS_VALUES.includes(v);
+}
+export const SCOPE_ANCHOR_IDS = [
+    'forge-oos',
+    'forge-non-goals',
+    'forge-future-work',
+];
+export function isScopeAnchorId(v) {
+    return typeof v === 'string' && SCOPE_ANCHOR_IDS.includes(v);
+}
+/** anchor ID → category 默认映射(propose 阶段补全 entry.category 用) */
+export const ANCHOR_TO_CATEGORY = {
+    'forge-oos': 'out-of-scope',
+    'forge-non-goals': 'non-goal',
+    'forge-future-work': 'future-work',
+};
+/**
+ * 合法的 superseding new_status —— 仅这 4 个值参与扣减(spec §9c 守卫)。
+ * aggregator(扣减守卫)与 backlog/render(invalid-new-status 判定)共用此集合,
+ * 避免两处各自维护副本漂移。
+ */
+export const VALID_SUPERSEDING_NEW_STATUS = new Set([
+    'superseded',
+    'obsolete',
+    'completed',
+    'inherited',
+]);
+//# sourceMappingURL=scope-entries.js.map

package/dist/core/schemas/scope-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-entries.js","sourceRoot":"","sources":["../../../src/core/schemas/scope-entries.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,iDAAiD;AACjD,uEAAuE;AAIvE,MAAM,CAAC,MAAM,qBAAqB,GAA6B;IAC7D,cAAc;IACd,UAAU;IACV,aAAa;CACL,CAAC;AAEX,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,qBAA2C,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC;AAID,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,WAAW;IACX,UAAU;CACF,CAAC;AAEX,MAAM,UAAU,aAAa,CAAC,CAAU;IACtC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,mBAAyC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAID,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,WAAW;IACX,iBAAiB;IACjB,mBAAmB;CACX,CAAC;AAEX,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAyC;IACtE,WAAW,EAAE,cAAc;IAC3B,iBAAiB,EAAE,UAAU;IAC7B,mBAAmB,EAAE,aAAa;CACnC,CAAC;AA+BF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC;IAClD,YAAY;IACZ,UAAU;IACV,WAAW;IACX,WAAW;CACZ,CAAC,CAAC"}