@accelerator-mzq/forge 1.4.0

package/dist/core/schema/process-verification-config.js

@@ -0,0 +1,74 @@
+// src/core/schema/process-verification-config.ts — plan-9g Task 1.2
+// v1.0 process_verification 配置 validation(沿 validateWritingPlansConfig 模式)
+//
+// 规则(brainstorm spec §6.1):
+//   - 缺失字段 → 返回默认值(DEFAULT_PROCESS_VERIFICATION)
+//   - 类型错 / 范围外 → stderr warn + fallback 默认
+//   - 合法值 → 直接返回
+import { DEFAULT_PROCESS_VERIFICATION } from './types.js';
+/**
+ * 验证并 sanitize process_verification 配置。
+ * 永远返回合法值(用 default fallback,不抛错 — 配置层 graceful degradation)。
+ *
+ * @param config — forge/config.yaml 解析结果(可缺 process_verification 段)
+ * @param warn — 注入 console.warn 用于测试 / 自定义 logger
+ * @returns 合法的 SanitizedProcessVerificationConfig
+ */
+export function validateProcessVerificationConfig(config, warn = (msg) => console.warn(msg)) {
+    const raw = config?.process_verification;
+    // 缺失 → 全默认
+    if (!raw) {
+        return { ...DEFAULT_PROCESS_VERIFICATION };
+    }
+    // mode 校验
+    let mode = DEFAULT_PROCESS_VERIFICATION.mode;
+    if (raw.mode !== undefined && raw.mode !== null) {
+        if (raw.mode === 'full' || raw.mode === 'sample' || raw.mode === 'hash-only') {
+            mode = raw.mode;
+        }
+        else {
+            warn(`forge config: process_verification.mode must be 'full'|'sample'|'hash-only', got ${JSON.stringify(raw.mode)}; falling back to ${DEFAULT_PROCESS_VERIFICATION.mode}`);
+        }
+    }
+    // sample_ratio 校验(0..1)
+    let sample_ratio = DEFAULT_PROCESS_VERIFICATION.sample_ratio;
+    if (raw.sample_ratio !== undefined && raw.sample_ratio !== null) {
+        if (typeof raw.sample_ratio === 'number' &&
+            !Number.isNaN(raw.sample_ratio) &&
+            raw.sample_ratio >= 0 &&
+            raw.sample_ratio <= 1) {
+            sample_ratio = raw.sample_ratio;
+        }
+        else {
+            warn(`forge config: process_verification.sample_ratio must be number in [0,1], got ${JSON.stringify(raw.sample_ratio)}; falling back to ${DEFAULT_PROCESS_VERIFICATION.sample_ratio}`);
+        }
+    }
+    // test_timeout_per_task 校验([10, 3600] 秒)
+    let test_timeout_per_task = DEFAULT_PROCESS_VERIFICATION.test_timeout_per_task;
+    if (raw.test_timeout_per_task !== undefined && raw.test_timeout_per_task !== null) {
+        if (typeof raw.test_timeout_per_task === 'number' &&
+            Number.isInteger(raw.test_timeout_per_task) &&
+            raw.test_timeout_per_task >= 10 &&
+            raw.test_timeout_per_task <= 3600) {
+            test_timeout_per_task = raw.test_timeout_per_task;
+        }
+        else {
+            warn(`forge config: process_verification.test_timeout_per_task must be integer in [10, 3600], got ${JSON.stringify(raw.test_timeout_per_task)}; falling back to ${DEFAULT_PROCESS_VERIFICATION.test_timeout_per_task}`);
+        }
+    }
+    // max_parallel_reruns 校验([1, 8])
+    let max_parallel_reruns = DEFAULT_PROCESS_VERIFICATION.max_parallel_reruns;
+    if (raw.max_parallel_reruns !== undefined && raw.max_parallel_reruns !== null) {
+        if (typeof raw.max_parallel_reruns === 'number' &&
+            Number.isInteger(raw.max_parallel_reruns) &&
+            raw.max_parallel_reruns >= 1 &&
+            raw.max_parallel_reruns <= 8) {
+            max_parallel_reruns = raw.max_parallel_reruns;
+        }
+        else {
+            warn(`forge config: process_verification.max_parallel_reruns must be integer in [1, 8], got ${JSON.stringify(raw.max_parallel_reruns)}; falling back to ${DEFAULT_PROCESS_VERIFICATION.max_parallel_reruns}`);
+        }
+    }
+    return { mode, sample_ratio, test_timeout_per_task, max_parallel_reruns };
+}
+//# sourceMappingURL=process-verification-config.js.map

package/dist/core/schema/process-verification-config.js.map

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

package/dist/core/schema/stage-extensions-config.d.ts

@@ -0,0 +1,28 @@
+import type { StageExtensionsDefaults, NormalizedStageExtensionsConfig } from './types.js';
+/**
+ * 内置 stage extensions 默认值;用户 defaults 段通过 deep-merge 覆盖。
+ * 所有字段均为合法值,作为 normalization 基础。
+ */
+export declare const STAGE_EXTENSIONS_DEFAULTS: StageExtensionsDefaults;
+/**
+ * stage_extensions 配置校验失败时抛出。
+ * 继承 Error,调用方可用 instanceof ConfigValidationError 判断。
+ */
+export declare class ConfigValidationError extends Error {
+    /** 出错的字段路径(如 'stage_extensions.brainstorming[0].convergence.max_rounds') */
+    readonly field: string;
+    constructor(message: string, 
+    /** 出错的字段路径(如 'stage_extensions.brainstorming[0].convergence.max_rounds') */
+    field: string);
+}
+/**
+ * 验证并 normalize stage_extensions 配置。
+ * 严格模式:非法值 throw ConfigValidationError(不 fallback)。
+ * 缺失字段从内置 STAGE_EXTENSIONS_DEFAULTS deep-merge 填充。
+ *
+ * @param raw  forge/config.yaml 解析后的 stage_extensions 段(unknown 类型)
+ * @returns    完整 NormalizedStageExtensionsConfig
+ * @throws     ConfigValidationError  校验失败时
+ */
+export declare function validateStageExtensionsConfig(raw: unknown): NormalizedStageExtensionsConfig;
+//# sourceMappingURL=stage-extensions-config.d.ts.map

package/dist/core/schema/stage-extensions-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-extensions-config.d.ts","sourceRoot":"","sources":["../../../src/core/schema/stage-extensions-config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,uBAAuB,EAEvB,+BAA+B,EAGhC,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,uBAuCvC,CAAC;AAIF;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAG5C,4EAA4E;aAC5D,KAAK,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM;IACf,4EAA4E;IAC5D,KAAK,EAAE,MAAM;CAKhC;AA8KD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,+BAA+B,CAyD3F"}

package/dist/core/schema/stage-extensions-config.js

@@ -0,0 +1,228 @@
+// src/core/schema/stage-extensions-config.ts — plan-stage-extensions Task 1.3
+// stage_extensions 配置 validation + normalization。
+//
+// 规则:
+//   - 缺失字段 → deep-merge 内置 STAGE_EXTENSIONS_DEFAULTS
+//   - 非法值(范围/类型违规) → throw ConfigValidationError(严格模式,不 fallback)
+//   - 合法值 → 返回完整 NormalizedStageExtensionsConfig
+// ─── 内置默认值 ─────────────────────────────────────────────────────────────
+/**
+ * 内置 stage extensions 默认值;用户 defaults 段通过 deep-merge 覆盖。
+ * 所有字段均为合法值,作为 normalization 基础。
+ */
+export const STAGE_EXTENSIONS_DEFAULTS = {
+    // mode 预留给 v2 async 模式(plan 决策 Q5);v1 仅 'sync',不进 NormalizedStageExtensionsConfig
+    mode: 'sync',
+    // 轮询间隔(秒)
+    poll_interval_sec: 300,
+    // zombie 任务阈值(秒):超过后视为悬挂进程
+    zombie_threshold_sec: 300,
+    // 单次 extension 超时(秒)
+    timeout_sec: 900,
+    // 最大重试次数
+    max_retries: 1,
+    convergence: {
+        max_rounds: 10,
+        max_rounds_on_exceed: 'ask',
+        // 默认阻塞 BLOCKER + MAJOR
+        block_severity: ['BLOCKER', 'MAJOR'],
+        // 默认忽略 MINOR + NIT
+        ignore_severity: ['MINOR', 'NIT'],
+        // 通过信心阈值
+        confidence_threshold: 0.7,
+        // APPROVE verdict 时直接短路
+        verdict_approve_short_circuit: true,
+    },
+    severity_map: {
+        critical: 'BLOCKER',
+        high: 'MAJOR',
+        medium: 'MINOR',
+        low: 'NIT',
+    },
+    severity_map_to_forge: {
+        BLOCKER: 'critical',
+        MAJOR: 'critical',
+        MINOR: 'warning',
+        NIT: 'suggestion',
+    },
+    user_interaction: {
+        block_unconverged: 'auto_fix_recommended',
+        max_rounds_exceed: 'give_up_recommended',
+    },
+};
+// ─── 错误类 ──────────────────────────────────────────────────────────────────
+/**
+ * stage_extensions 配置校验失败时抛出。
+ * 继承 Error,调用方可用 instanceof ConfigValidationError 判断。
+ */
+export class ConfigValidationError extends Error {
+    field;
+    constructor(message, 
+    /** 出错的字段路径(如 'stage_extensions.brainstorming[0].convergence.max_rounds') */
+    field) {
+        super(`forge config validation: ${field}: ${message}`);
+        this.field = field;
+        this.name = 'ConfigValidationError';
+    }
+}
+// ─── 合法 severity 列表 ───────────────────────────────────────────────────────
+const VALID_SEVERITIES = ['BLOCKER', 'MAJOR', 'MINOR', 'NIT'];
+/** 检查数组中每个值是否均为合法 severity */
+function isValidSeverityArray(arr) {
+    return Array.isArray(arr) && arr.every((v) => VALID_SEVERITIES.includes(v));
+}
+/**
+ * I-2:剔除对象中值为 undefined 的 key。
+ * 防止用户配置里的显式 undefined(如 `{ timeout_sec: undefined }`)在 spread merge
+ * 时覆盖掉合法默认值,导致 required 字段实际变 undefined。
+ */
+function stripUndefined(obj) {
+    const out = {};
+    for (const key of Object.keys(obj)) {
+        if (obj[key] !== undefined) {
+            out[key] = obj[key];
+        }
+    }
+    return out;
+}
+// ─── 单 entry 校验 + normalization ───────────────────────────────────────────
+/**
+ * 对单个 StageExtensionEntry 做校验并 deep-merge defaults,返回 NormalizedStageExtensionEntry。
+ * 非法值 → 抛 ConfigValidationError。
+ *
+ * @param entry  用户输入的 entry
+ * @param defaults  已 merge 过 user defaults 的有效 defaults
+ * @param path  错误路径前缀(如 'stage_extensions.brainstorming[0]')
+ */
+function normalizeEntry(entry, defaults, path) {
+    // command 必须为非空字符串
+    if (typeof entry.command !== 'string' || entry.command.trim() === '') {
+        throw new ConfigValidationError('command must be a non-empty string', `${path}.command`);
+    }
+    // 合并数值字段(entry 未设则取 defaults)
+    const timeout_sec = entry.timeout_sec ?? defaults.timeout_sec;
+    const poll_interval_sec = entry.poll_interval_sec ?? defaults.poll_interval_sec;
+    const zombie_threshold_sec = entry.zombie_threshold_sec ?? defaults.zombie_threshold_sec;
+    const max_retries = entry.max_retries ?? defaults.max_retries;
+    // ── 校验数值范围(merge 后再校验,防止 defaults 本身非法) ──
+    if (!Number.isFinite(timeout_sec) || timeout_sec < 60 || timeout_sec > 3600) {
+        throw new ConfigValidationError(`timeout_sec must be in [60, 3600], got ${timeout_sec}`, `${path}.timeout_sec`);
+    }
+    // I-1:poll_interval_sec 范围校验 [10, 3600]
+    if (!Number.isFinite(poll_interval_sec) || poll_interval_sec < 10 || poll_interval_sec > 3600) {
+        throw new ConfigValidationError(`poll_interval_sec must be in [10, 3600], got ${poll_interval_sec}`, `${path}.poll_interval_sec`);
+    }
+    // I-1:zombie_threshold_sec 范围校验 [10, 3600]
+    if (!Number.isFinite(zombie_threshold_sec) ||
+        zombie_threshold_sec < 10 ||
+        zombie_threshold_sec > 3600) {
+        throw new ConfigValidationError(`zombie_threshold_sec must be in [10, 3600], got ${zombie_threshold_sec}`, `${path}.zombie_threshold_sec`);
+    }
+    if (!Number.isFinite(max_retries) ||
+        !Number.isInteger(max_retries) ||
+        max_retries < 0 ||
+        max_retries > 10) {
+        throw new ConfigValidationError(`max_retries must be integer in [0, 10], got ${max_retries}`, `${path}.max_retries`);
+    }
+    // ── convergence deep-merge:entry.convergence 覆盖 defaults.convergence ──
+    const effectiveConvergence = {
+        ...defaults.convergence,
+        ...entry.convergence,
+    };
+    // 校验 convergence 字段
+    const cvgPath = `${path}.convergence`;
+    if (!Number.isFinite(effectiveConvergence.max_rounds) ||
+        !Number.isInteger(effectiveConvergence.max_rounds) ||
+        effectiveConvergence.max_rounds < 1 ||
+        effectiveConvergence.max_rounds > 100) {
+        throw new ConfigValidationError(`max_rounds must be integer in [1, 100], got ${effectiveConvergence.max_rounds}`, `${cvgPath}.max_rounds`);
+    }
+    if (!Number.isFinite(effectiveConvergence.confidence_threshold) ||
+        effectiveConvergence.confidence_threshold < 0 ||
+        effectiveConvergence.confidence_threshold > 1) {
+        throw new ConfigValidationError(`confidence_threshold must be in [0, 1], got ${effectiveConvergence.confidence_threshold}`, `${cvgPath}.confidence_threshold`);
+    }
+    if (!isValidSeverityArray(effectiveConvergence.block_severity)) {
+        throw new ConfigValidationError(`block_severity must be array of BLOCKER|MAJOR|MINOR|NIT, got ${JSON.stringify(effectiveConvergence.block_severity)}`, `${cvgPath}.block_severity`);
+    }
+    if (!isValidSeverityArray(effectiveConvergence.ignore_severity)) {
+        throw new ConfigValidationError(`ignore_severity must be array of BLOCKER|MAJOR|MINOR|NIT, got ${JSON.stringify(effectiveConvergence.ignore_severity)}`, `${cvgPath}.ignore_severity`);
+    }
+    // I-3:max_rounds_on_exceed 必须为 'ask' | 'force_end'
+    if (effectiveConvergence.max_rounds_on_exceed !== 'ask' &&
+        effectiveConvergence.max_rounds_on_exceed !== 'force_end') {
+        throw new ConfigValidationError(`max_rounds_on_exceed must be 'ask' or 'force_end', got ${JSON.stringify(effectiveConvergence.max_rounds_on_exceed)}`, `${cvgPath}.max_rounds_on_exceed`);
+    }
+    // I-3:verdict_approve_short_circuit 必须为 boolean
+    if (typeof effectiveConvergence.verdict_approve_short_circuit !== 'boolean') {
+        throw new ConfigValidationError(`verdict_approve_short_circuit must be a boolean, got ${JSON.stringify(effectiveConvergence.verdict_approve_short_circuit)}`, `${cvgPath}.verdict_approve_short_circuit`);
+    }
+    return {
+        name: entry.name,
+        enabled: entry.enabled,
+        command: entry.command,
+        ...(entry.build_prompt !== undefined ? { build_prompt: entry.build_prompt } : {}),
+        output: entry.output,
+        timeout_sec,
+        poll_interval_sec,
+        zombie_threshold_sec,
+        max_retries,
+        convergence: effectiveConvergence,
+    };
+}
+// ─── 主 validator ─────────────────────────────────────────────────────────────
+/**
+ * 验证并 normalize stage_extensions 配置。
+ * 严格模式:非法值 throw ConfigValidationError(不 fallback)。
+ * 缺失字段从内置 STAGE_EXTENSIONS_DEFAULTS deep-merge 填充。
+ *
+ * @param raw  forge/config.yaml 解析后的 stage_extensions 段(unknown 类型)
+ * @returns    完整 NormalizedStageExtensionsConfig
+ * @throws     ConfigValidationError  校验失败时
+ */
+export function validateStageExtensionsConfig(raw) {
+    // C-1:narrow unknown — 必须是非 null 非数组的对象才视为配置,否则视为空配置
+    const config = raw !== null && typeof raw === 'object' && !Array.isArray(raw)
+        ? raw
+        : {};
+    // ── step 1: deep-merge user defaults over built-in defaults ──
+    const userDefaults = config.defaults ?? {};
+    const mergedDefaults = {
+        ...STAGE_EXTENSIONS_DEFAULTS,
+        // I-2:剔除值为 undefined 的 key,防止显式 undefined 覆盖合法默认值
+        ...stripUndefined(userDefaults),
+        // convergence 需单独 deep-merge
+        convergence: {
+            ...STAGE_EXTENSIONS_DEFAULTS.convergence,
+            ...stripUndefined(userDefaults.convergence ?? {}),
+        },
+        // severity_map deep-merge
+        severity_map: {
+            ...STAGE_EXTENSIONS_DEFAULTS.severity_map,
+            ...stripUndefined(userDefaults.severity_map ?? {}),
+        },
+        // severity_map_to_forge deep-merge
+        severity_map_to_forge: {
+            ...STAGE_EXTENSIONS_DEFAULTS.severity_map_to_forge,
+            ...stripUndefined(userDefaults.severity_map_to_forge ?? {}),
+        },
+        // user_interaction deep-merge
+        user_interaction: {
+            ...STAGE_EXTENSIONS_DEFAULTS.user_interaction,
+            ...stripUndefined(userDefaults.user_interaction ?? {}),
+        },
+    };
+    // ── step 2: 对每个 stage 数组 normalize entries ──
+    const normalizeStage = (entries, stageName) => (entries ?? []).map((entry, idx) => normalizeEntry(entry, mergedDefaults, `stage_extensions.${stageName}[${idx}]`));
+    return {
+        severity_map: mergedDefaults.severity_map,
+        severity_map_to_forge: mergedDefaults.severity_map_to_forge,
+        user_interaction: mergedDefaults.user_interaction,
+        brainstorming: normalizeStage(config.brainstorming, 'brainstorming'),
+        propose: normalizeStage(config.propose, 'propose'),
+        apply_critical_plan_review: normalizeStage(config.apply_critical_plan_review, 'apply_critical_plan_review'),
+        review: normalizeStage(config.review, 'review'),
+        verify: normalizeStage(config.verify, 'verify'),
+    };
+}
+//# sourceMappingURL=stage-extensions-config.js.map

package/dist/core/schema/stage-extensions-config.js.map

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

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

@@ -0,0 +1,262 @@
+/** 三个 model tier 标签 / 合法模型值 */
+export type ModelTier = 'haiku' | 'sonnet' | 'opus';
+/**
+ * forge/config.yaml 的解析结果类型。
+ * 详见 spec §2.2.1。
+ */
+export interface ForgeConfig {
+    schema: string;
+    context?: string;
+    rules?: {
+        proposal?: string[];
+        specs?: string[];
+        design?: string[];
+        tasks?: string[];
+    };
+    code_paths?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    /**
+     * v0.2 brownfield onboarding 全局策略(brownfield design §2.7 / 决策 #19/#22)。
+     * 缺失或全字段缺失时,brownfield 工具拒绝运行;archive 内的 sync-check graceful skip。
+     *
+     * **运行时默认值**:本 interface 是纯类型定义,parseConfig 透传不补默认值;
+     * 调用方应以 `??` fallback(如 `config.legacy_bridge?.allow_llm_calls ?? false`)。
+     */
+    legacy_bridge?: {
+        /** 决策 #22:opt-in LLM 调用;缺失时调用方应视为 false */
+        allow_llm_calls?: boolean;
+        /** 决策 #19:enforce_sync,critical 未 resolve 时 archive preflight 阻塞;缺失视为 false */
+        enforce_sync?: boolean;
+        /** 决策 #18:跨 anchor 不一致是否走 mtime 自动决策;缺失视为 false(默认入 diff) */
+        auto_resolve_cross_anchor?: boolean;
+        /** 决策 #21:复写产物许可;缺失时调用方应 fallback 为 'derived-from-source' */
+        regen_license?: string;
+        /**
+         * 决策 #22 预留:LLM provider。v0.2 仅 'anthropic';
+         * v0.3 加 'openai' 等时改为 union(`'anthropic' | 'openai' | ...`)。
+         * 现 literal 类型让 v0.2 用户得到 IDE 补全;v0.3 spec 定稿后该字段会扩 union。
+         */
+        provider?: 'anthropic';
+    };
+    /**
+     * v0.3 P3 修复(spec §2.3 + Plan 2):writing-plans skill 的 scale-aware mode 配置。
+     * trivial change 走 light mode(1-2 task,跳 RED/GREEN/REFACTOR),避免 v0.2 P3 的
+     * "trivial change → 1378 行 tasks.md" 过度生成(Plan 0b.1 实测确认)。
+     */
+    writing_plans?: {
+        /**
+         * trivial change 阈值:proposal.md 行数 < light_threshold → light mode。
+         * 默认 200(由 validateWritingPlansConfig fallback);允许范围 [50, 2000]。
+         * 50 太小会误判普通 change 为 trivial;2000 失去 light mode 意义。
+         * 调用方应以 `??` 取默认值或调 validateWritingPlansConfig 拿 sanitized 值。
+         */
+        light_threshold?: number;
+    };
+    /**
+     * v1.0 process_verification(plan-9g §2.7 — 14 不变量 + worktree 重跑配置)
+     * 缺失时调用方应以 `??` fallback 取 DEFAULT_PROCESS_VERIFICATION 值
+     * 或调 validateProcessVerificationConfig 拿 sanitized 完整值
+     */
+    process_verification?: {
+        /** 默认 'full'(沿 §2.7.4 B);mode != full 必须 CLI ack 写 marker */
+        mode?: 'full' | 'sample' | 'hash-only';
+        /** sample 模式抽样比例 [0..1],默认 0.3 */
+        sample_ratio?: number;
+        /** 单 task 重跑 timeout 秒(默认 300;full 模式触发 → CRITICAL,沿 §2.7.4 D) */
+        test_timeout_per_task?: number;
+        /** 并发 worktree 上限(默认 2;Windows 磁盘空间约束更紧) */
+        max_parallel_reruns?: number;
+    };
+    /**
+     * v1.0 test reporter(plan-9g §2.7.4 C — 解析结构化测试报告)
+     * 缺失时调用方应以 `??` fallback 'junit'
+     */
+    test?: {
+        /** 默认 'junit';reporter 类型决定 parseReporter 走哪个分支 */
+        reporter?: 'junit' | 'tap' | 'vitest-json';
+        /** 单 task 测试命令(用于 worktree 重跑;沿 commands/verify.md:29) */
+        test_command?: string;
+    };
+    /**
+     * v1.0 ack CLI 安全开关(plan-9g §2.7.4 B — CI 模式拒绝 ack 防静默降级)
+     * 缺失时调用方应以 `??` fallback false(更安全)
+     */
+    ack?: {
+        /** false(默认):检测 CI=true 时 `forge ack propose` 拒绝触发 */
+        allow_ci_mode?: boolean;
+    };
+    /**
+     * v1.0 protected branches(plan-9h §2.8.3 C — main/master 分支保护)
+     * 缺失时调用方应以 `??` fallback `DEFAULT_PROTECTED_BRANCHES`;
+     * 空数组等价于禁用分支保护(不推荐,沿 design §2.8.3 C line 1438)。
+     *
+     * 由 `forge preflight branch-check` CLI helper 读取(沿 spec §2.8.5 第 3 项)。
+     * 用户项目 `forge/config.yaml` 设置形如:
+     *   protected_branches:
+     *     - main
+     *     - master
+     *     - develop
+     *     - trunk
+     */
+    protected_branches?: string[];
+    /**
+     * plan-stage-extensions Task 1 — stage 扩展点配置。
+     * 缺失时调用方应以空对象 fallback 或调 validateStageExtensionsConfig 拿完整 normalized 值。
+     */
+    stage_extensions?: StageExtensionsConfig;
+    /**
+     * workflow-monitor 开关(spec §3.1)。
+     * 缺失或 `enabled` 缺失时,调用方一律视为 false(监控关闭)。
+     * 读取走 monitor/config.ts#isMonitorEnabled;写入走 setMonitorEnabled。
+     */
+    monitor?: {
+        enabled?: boolean;
+    };
+    /**
+     * model tier 标签 → 实际派发模型的重映射(详见 model-tiers-config.ts)。
+     * 只有 haiku / sonnet 两个可重映射键;opus 是 design MANDATORY tier,不设键、恒派 opus。
+     * 缺失 / 缺键 = 该 tier 恒等。
+     */
+    model_tiers?: {
+        haiku?: ModelTier;
+        sonnet?: ModelTier;
+    };
+}
+/**
+ * 默认 light_threshold(P3 修复;调用方 fallback 用)。
+ * 详见 spec §2.3 + Plan 2 Task 2.2。
+ */
+export declare const DEFAULT_LIGHT_THRESHOLD = 200;
+/** model_tiers 缺失时的恒等默认(resolveModelTiers fallback 用) */
+export declare const DEFAULT_MODEL_TIERS: {
+    haiku: ModelTier;
+    sonnet: ModelTier;
+    opus: ModelTier;
+};
+/**
+ * 默认 process_verification 配置(plan-9g §6;调用方 fallback 用)
+ * brainstorm spec §6 锁定四档默认值
+ */
+export declare const DEFAULT_PROCESS_VERIFICATION: {
+    mode: "full";
+    sample_ratio: number;
+    test_timeout_per_task: number;
+    max_parallel_reruns: number;
+};
+/** 默认 test.reporter(plan-9g §6) */
+export declare const DEFAULT_TEST_REPORTER: "junit";
+/** 默认 ack.allow_ci_mode(plan-9g §6;false 防 CI 静默降级) */
+export declare 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 declare const DEFAULT_PROTECTED_BRANCHES: readonly ["main", "master", "develop", "trunk"];
+/**
+ * 默认 spec-driven schema 的 artifact 列表(决定哪些文件构成一个 change)。
+ */
+export declare const DEFAULT_ARTIFACTS: readonly ["proposal", "specs", "design", "tasks"];
+export type ArtifactKind = (typeof DEFAULT_ARTIFACTS)[number];
+/**
+ * code_paths.exclude 的默认值(不可关闭,与用户声明合并使用)。
+ * 详见 spec §3.4 hash 计算规则。
+ */
+export declare const DEFAULT_CODE_EXCLUDE: readonly ["forge/**", "**/*.md", "**/.verify-passed", "**/.review-passed", "**/.verify-failed", "**/.review-failed", "**/.evidence/**"];
+export * from '../schemas/severity.js';
+/** 单个 stage extension 条目(用户配置层;可选字段由 validator 填充) */
+export interface StageExtensionEntry {
+    name: string;
+    enabled: boolean;
+    command: string;
+    /** codex review 模式可不传 prompt */
+    build_prompt?: string;
+    output: string;
+    timeout_sec?: number;
+    poll_interval_sec?: number;
+    zombie_threshold_sec?: number;
+    max_retries?: number;
+    /** 用户可局部覆盖 convergence;缺省字段由 defaults 填充 */
+    convergence?: Partial<ConvergenceConfig>;
+}
+/** convergence 收敛策略(完整配置;Partial 版本用于用户输入) */
+export interface ConvergenceConfig {
+    /** 最多收敛轮次 [1, 100] */
+    max_rounds: number;
+    /** 轮次上限时行为 */
+    max_rounds_on_exceed: 'ask' | 'force_end';
+    /** 阻塞 merge 的 severity 列表 */
+    block_severity: Array<'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT'>;
+    /** 忽略不计入收敛的 severity 列表 */
+    ignore_severity: Array<'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT'>;
+    /** 通过信心阈值 [0, 1] */
+    confidence_threshold: number;
+    /** verdict=APPROVE 时直接短路跳出收敛循环 */
+    verdict_approve_short_circuit: boolean;
+}
+/** stage_extensions.defaults 用户配置层(所有字段可选) */
+export interface StageExtensionsDefaults {
+    /** 运行模式;v1 仅 'sync','background' 预留给 v2 async 模式(plan 决策 Q5) */
+    mode: 'background' | 'sync';
+    poll_interval_sec: number;
+    zombie_threshold_sec: number;
+    timeout_sec: number;
+    max_retries: number;
+    convergence: ConvergenceConfig;
+    /** codex severity → forge severity 映射(codex → 内部) */
+    severity_map: {
+        critical: 'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT';
+        high: 'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT';
+        medium: 'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT';
+        low: 'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT';
+    };
+    /** forge severity → forge finding 级别映射(内部 → CLI 输出) */
+    severity_map_to_forge: {
+        BLOCKER: 'critical' | 'warning' | 'suggestion';
+        MAJOR: 'critical' | 'warning' | 'suggestion';
+        MINOR: 'critical' | 'warning' | 'suggestion';
+        NIT: 'critical' | 'warning' | 'suggestion';
+    };
+    /** 用户交互策略(未收敛 / 超轮次时推荐动作) */
+    user_interaction: {
+        block_unconverged: 'auto_fix_recommended' | 'manual_fix_recommended' | 'give_up_recommended';
+        max_rounds_exceed: 'give_up_recommended' | 'continue_recommended' | 'accept_recommended';
+    };
+}
+/** stage_extensions 顶层用户配置(forge/config.yaml#stage_extensions) */
+export interface StageExtensionsConfig {
+    defaults?: Partial<StageExtensionsDefaults>;
+    brainstorming?: StageExtensionEntry[];
+    propose?: StageExtensionEntry[];
+    apply_critical_plan_review?: StageExtensionEntry[];
+    review?: StageExtensionEntry[];
+    verify?: StageExtensionEntry[];
+}
+/** normalized entry:所有数值字段已填充,convergence 为完整 ConvergenceConfig */
+export interface NormalizedStageExtensionEntry {
+    name: string;
+    enabled: boolean;
+    command: string;
+    /** codex review 模式仍可无 prompt */
+    build_prompt?: string;
+    output: string;
+    timeout_sec: number;
+    poll_interval_sec: number;
+    zombie_threshold_sec: number;
+    max_retries: number;
+    /** 完整 convergence(deep-merge defaults + entry.convergence) */
+    convergence: ConvergenceConfig;
+}
+/** normalized 顶层配置:所有 stage 数组已填充(缺省 []) */
+export interface NormalizedStageExtensionsConfig {
+    severity_map: StageExtensionsDefaults['severity_map'];
+    severity_map_to_forge: StageExtensionsDefaults['severity_map_to_forge'];
+    user_interaction: StageExtensionsDefaults['user_interaction'];
+    brainstorming: NormalizedStageExtensionEntry[];
+    propose: NormalizedStageExtensionEntry[];
+    apply_critical_plan_review: NormalizedStageExtensionEntry[];
+    review: NormalizedStageExtensionEntry[];
+    verify: NormalizedStageExtensionEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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