soloforge 1.1.2 → 1.1.31

package/dist/engine/config/config_precedence_contract/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/resolution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EAEtB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAYpB,+CAA+C;AAE/C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAE1E;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,mBAAmB,EAAE,GAChC,sBAAsB,CAwCxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC,GACrD,sBAAsB,EAAE,CAQ1B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,eAAe,GACvB,gBAAgB,CAYlB;AAkBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,mBAAmB,EACnC,gBAAgB,EAAE,mBAAmB,GACpC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAavC;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,UAAU,GAAG,UAAU,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,YAAY,GAAG,MAAM,GAC5B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAuBtC;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAE9D;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAC3D;IAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAAC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AA4ElG,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAcxD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAQ9D;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAqB1E"}

package/dist/engine/config/config_precedence_contract/resolution.js

@@ -0,0 +1,317 @@
+/**
+ * Configuration Precedence Contract — Resolution
+ *
+ * 配置字段解析、上位约束执行、过期检测、字段分类、证据来源映射。
+ */
+import { PRECEDENCE_ORDER, EVIDENCE_SOURCE_MAP, SOURCE_LIFETIME, C_CLASS_FIELDS, } from "./constants.js";
+import { debug } from "../../core/logger.js";
+import { createConfigValueEvidence } from "./evidence.js";
+// ── 查询函数 ──
+/** 列出所有配置优先级规则 — 导入自 constants，通过 index 重导出 */
+/** 获取配置来源的优先级排名（数值越小优先级越高）
+ * @param source - 配置来源
+ * @returns 优先级排名索引
+ */
+export function getPrecedenceRank(source) {
+    return PRECEDENCE_ORDER.indexOf(source);
+}
+/** 获取配置来源的生命周期
+ * @param source - 配置来源
+ * @returns 生命周期类型
+ */
+export function getSourceLifetime(source) {
+    return SOURCE_LIFETIME[source];
+}
+/** 判断来源 a 的优先级是否高于来源 b
+ * @param a - 配置来源 a
+ * @param b - 配置来源 b
+ * @returns a 是否优先级更高
+ */
+export function isHigherPriority(a, b) {
+    return getPrecedenceRank(a) < getPrecedenceRank(b);
+}
+// ── 解析 ──
+/** 解析单个配置字段 — 按优先级排序候选值并检测冲突
+ * @param fieldPath - 字段路径
+ * @param candidates - 候选值列表
+ * @returns 配置解析报告
+ */
+export function resolveConfigField(fieldPath, candidates) {
+    const sorted = [...candidates].sort((a, b) => getPrecedenceRank(a.source) - getPrecedenceRank(b.source));
+    if (sorted.length === 0) {
+        return {
+            field_path: fieldPath,
+            selected: { source: "global_default", value: undefined, confidence: 0, field_path: fieldPath, updated_at: new Date().toISOString() },
+            candidates: [],
+            conflicts: [],
+            lifetime: "global",
+        };
+    }
+    const selected = sorted[0];
+    const conflicts = [];
+    for (let i = 1; i < sorted.length; i++) {
+        const candidate = sorted[i];
+        if (JSON.stringify(candidate.value) !== JSON.stringify(selected.value)) {
+            conflicts.push({
+                source_a: selected.source,
+                source_b: candidate.source,
+                field_path: fieldPath,
+                reason: buildConflictReason(selected.source, candidate.source, fieldPath),
+                requires_human: candidate.source === "confirmed_config" && selected.source === "fingerprint"
+                    ? false
+                    : isHighStakesField(fieldPath),
+            });
+        }
+    }
+    return {
+        field_path: fieldPath,
+        selected,
+        candidates: sorted,
+        conflicts,
+        lifetime: SOURCE_LIFETIME[selected.source],
+    };
+}
+/** 解析所有配置字段
+ * @param fieldCandidates - 字段路径到候选值列表的映射
+ * @returns 所有字段的解析报告数组
+ */
+export function resolveAllFields(fieldCandidates) {
+    const reports = [];
+    for (const [fieldPath, candidates] of Object.entries(fieldCandidates)) {
+        if (candidates.length > 0) {
+            reports.push(resolveConfigField(fieldPath, candidates));
+        }
+    }
+    return reports;
+}
+// ── 上位约束执行 ──
+/** 检查上位约束是否阻止该配置
+ * @param report - 配置解析报告
+ * @param guardId - 上位约束 ID
+ * @returns 约束检查结果
+ */
+export function checkGuardOverride(report, guardId) {
+    if (isGuardProtectedField(report.field_path, guardId)) {
+        debug("配置优先级", "字段 %s 被上位约束 %s 阻止", report.field_path, guardId);
+        return {
+            blocked: true,
+            report: {
+                ...report,
+                overridden_by_guard: guardId,
+            },
+        };
+    }
+    return { blocked: false, report };
+}
+function isGuardProtectedField(fieldPath, guard) {
+    const GUARD_FIELDS = {
+        enforced_guard: ["*"],
+        privacy_secret_policy: ["delivery", "secrets", "accounts", "external_integrations"],
+        command_safety: ["destructive_command_policy", "verify_timeout"],
+        delivery_authorization: ["delivery.auto_push", "delivery.auto_pr", "delivery.deploy"],
+        data_sovereignty: ["core_knowledge", "compliance", "privacy_policy"],
+        destructive_action_gate: ["destructive_command_policy", "scope_exclusion"],
+    };
+    const protectedFields = GUARD_FIELDS[guard] ?? [];
+    if (protectedFields.includes("*"))
+        return true;
+    return protectedFields.some((f) => fieldPath.startsWith(f));
+}
+// ── 过期检测 ──
+/** 检测配置是否过期 — 比较确认值与指纹值是否一致
+ * @param confirmedValue - 已确认的配置值
+ * @param fingerprintValue - 当前指纹值
+ * @returns 是否过期及警告信息
+ */
+export function detectStaleConfig(confirmedValue, fingerprintValue) {
+    if (confirmedValue.source !== "confirmed_config")
+        return { isStale: false, warning: "" };
+    if (fingerprintValue.source !== "fingerprint")
+        return { isStale: false, warning: "" };
+    if (JSON.stringify(confirmedValue.value) !== JSON.stringify(fingerprintValue.value)) {
+        debug("配置优先级", "字段 %s 配置过期，确认值与指纹不一致", confirmedValue.field_path);
+        return {
+            isStale: true,
+            warning: `config_stale_warning: ${confirmedValue.field_path} 的确认值 (${JSON.stringify(confirmedValue.value)}) 与当前 fingerprint (${JSON.stringify(fingerprintValue.value)}) 不一致 — 建议重新确认`,
+        };
+    }
+    return { isStale: false, warning: "" };
+}
+// ── 字段分类写入规则 ──
+/** 判断字段是否为 C 类字段
+ * @param fieldPath - 字段路径
+ * @returns 是否为 C 类字段
+ */
+export function isCClassField(fieldPath) {
+    return C_CLASS_FIELDS.some(f => fieldPath.startsWith(f));
+}
+/** 获取配置字段的分类（C 类或 B 类）
+ * @param fieldPath - 字段路径
+ * @param explicitClass - 显式指定的分类（可选）
+ * @returns 字段分类
+ */
+export function getConfigFieldClass(fieldPath, explicitClass) {
+    if (explicitClass)
+        return explicitClass;
+    if (isCClassField(fieldPath))
+        return "C";
+    return "B";
+}
+/** 判断字段是否允许自动写入
+ * @param fieldPath - 字段路径
+ * @param fieldClass - 字段分类
+ * @param source - 配置来源
+ * @returns 是否允许及原因
+ */
+export function canAutoWriteField(fieldPath, fieldClass, source) {
+    const canonical = mapEvidenceSource(source);
+    // C 类: 永不自动写入 (only confirmed_config allowed)
+    if (fieldClass === "C" || isCClassField(fieldPath)) {
+        if (canonical !== "confirmed_config") {
+            return { allowed: false, reason: `C 类字段 ${fieldPath} 不得自动写入，必须 user_declared 或 confirmed` };
+        }
+    }
+    // B 类: 需要高置信 (confirmed_config or fingerprint)
+    if (fieldClass === "B") {
+        if (canonical !== "fingerprint" && canonical !== "confirmed_config") {
+            return { allowed: false, reason: `B 类字段 ${fieldPath} 需要高置信来源 (detected/user_declared/confirmed)` };
+        }
+    }
+    // CLI flag 不静默写入 config
+    if (source === "cli_flag" || source === "mcp_param") {
+        return { allowed: false, reason: "CLI/MCP 参数不静默写入 config，仅对本次 invocation/task 有效" };
+    }
+    return { allowed: true, reason: "" };
+}
+// ── 证据来源映射 ──
+/** 将证据元数据来源映射为规范配置来源
+ * @param source - 原始来源标识
+ * @returns 规范配置来源
+ */
+export function mapEvidenceSource(source) {
+    return EVIDENCE_SOURCE_MAP[source] ?? source;
+}
+export function resolveConfigFromSources(fields) {
+    const resolutions = [];
+    const reports = [];
+    const warnings = [];
+    for (const [fieldPath, rawSources] of Object.entries(fields)) {
+        let candidates;
+        // 检测旧格式与新 FieldCandidates 格式
+        if (Array.isArray(rawSources)) {
+            candidates = rawSources;
+        }
+        else {
+            // 旧格式: { config_value, fingerprint_value, user_override }
+            const sources = rawSources;
+            candidates = [];
+            if (sources.user_override !== undefined) {
+                candidates.push(createConfigValueEvidence(fieldPath, sources.user_override, "user_task", 1.0));
+            }
+            if (sources.config_value !== undefined) {
+                candidates.push(createConfigValueEvidence(fieldPath, sources.config_value, "confirmed_config", 0.9));
+            }
+            if (sources.fingerprint_value !== undefined) {
+                candidates.push(createConfigValueEvidence(fieldPath, sources.fingerprint_value, "fingerprint", 0.8));
+            }
+        }
+        if (candidates.length === 0)
+            continue;
+        const report = resolveConfigField(fieldPath, candidates);
+        reports.push(report);
+        const resolution = {
+            field_path: fieldPath,
+            resolved_value: report.selected.value,
+            source: report.selected.source,
+        };
+        // 检测过期: confirmed_config 与 fingerprint 不一致
+        const configEv = candidates.find(c => c.source === "confirmed_config");
+        const fpEv = candidates.find(c => c.source === "fingerprint");
+        if (configEv && fpEv) {
+            const stale = detectStaleConfig(configEv, fpEv);
+            if (stale.isStale) {
+                resolution.stale_warning = stale.warning;
+                warnings.push(stale.warning);
+            }
+        }
+        if (report.conflicts.length > 0) {
+            resolution.conflict_report = buildConflictReport(report);
+        }
+        resolutions.push(resolution);
+    }
+    return { resolutions, reports, warnings };
+}
+// ── 内部辅助 ──
+function buildConflictReason(higher, lower, fieldPath) {
+    return `${sourceLabel(higher)} 与 ${sourceLabel(lower)} 在字段 ${fieldPath} 上存在冲突`;
+}
+function isHighStakesField(fieldPath) {
+    const highStakes = [
+        "delivery", "scope", "product_profile", "secrets", "accounts",
+        "production_database", "destructive_command_policy", "compliance",
+    ];
+    return highStakes.some((f) => fieldPath.startsWith(f));
+}
+export function sourceLabel(source) {
+    const labels = {
+        user_task: "用户本次指令",
+        cli_flag: "CLI 参数",
+        mcp_param: "MCP 参数",
+        confirmed_config: "已确认配置 (config.yaml)",
+        project_policy: "项目策略",
+        fingerprint: "文件指纹探测",
+        blueprint: "项目蓝图",
+        product_profile: "产品画像默认",
+        knowledge_default: "知识库默认",
+        global_default: "全局默认",
+    };
+    return labels[source];
+}
+export function lifetimeLabel(lifetime) {
+    const labels = {
+        single_invocation: "单次调用",
+        task: "本次任务",
+        project_persistent: "项目持久",
+        global: "全局",
+    };
+    return labels[lifetime];
+}
+// ── 冲突报告构建 ──
+/** 生成配置冲突的中文报告
+ * @param report - 配置解析报告
+ * @returns 格式化的冲突报告文本
+ */
+export function buildConflictReport(report) {
+    const lines = [];
+    lines.push(`配置冲突报告: ${report.field_path}`);
+    lines.push(`当前采用: ${sourceLabel(report.selected.source)} = ${JSON.stringify(report.selected.value)}`);
+    lines.push(`生命周期: ${lifetimeLabel(report.lifetime)}`);
+    for (const c of report.conflicts) {
+        lines.push(`冲突: ${sourceLabel(c.source_a)} vs ${sourceLabel(c.source_b)}`);
+        lines.push(`  原因: ${c.reason}`);
+        if (c.requires_human) {
+            lines.push(`  ⚠️ 需要人工确认`);
+        }
+    }
+    if (report.overridden_by_guard) {
+        lines.push(`⚠️ 被上位约束 ${report.overridden_by_guard} 阻止`);
+    }
+    lines.push(`建议: ${buildResolutionAdvice(report)}`);
+    return lines.join("\n");
+}
+function buildResolutionAdvice(report) {
+    if (report.overridden_by_guard) {
+        return "上位约束生效，不可通过配置修改";
+    }
+    if (report.selected.source === "user_task") {
+        return "本次用户指令优先，仅对本次任务生效，不写入 config";
+    }
+    if (report.selected.source === "cli_flag" || report.selected.source === "mcp_param") {
+        return "CLI/MCP 参数仅对本次调用生效，不写入 config。如需持久化请使用 config confirm";
+    }
+    if (report.conflicts.some((c) => c.source_b === "fingerprint")) {
+        return "fingerprint 变化未自动覆盖 confirmed_config。如需更新请使用 soloforge init --interactive";
+    }
+    return "当前配置已正确解析";
+}
+//# sourceMappingURL=resolution.js.map

package/dist/engine/config/config_precedence_contract/resolution.js.map

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

package/dist/engine/config/config_precedence_contract/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Configuration Precedence Contract — Type Definitions
+ *
+ * 配置优先级、覆盖规则、冲突检测和治理检查的所有类型定义。
+ * ConfigSource / ConfigLifetime / ConfigValueEvidence / ConfigConflict / ConfigResolutionReport
+ * 已移至 types/pipeline.ts 消除循环依赖，此处通过 re-export 保持向后兼容。
+ */
+import type { ConfigSource, ConfigLifetime, ConfigValueEvidence, ConfigResolutionReport } from "../../../types/pipeline.js";
+export type { ConfigSource, ConfigLifetime, ConfigValueEvidence, ConfigConflict, ConfigResolutionReport, } from "../../../types/pipeline.js";
+/** 证据元数据来源 — 通过 mapEvidenceSource() 映射到规范来源 */
+export type EvidenceMetadataSource = "user_declared" | "confirmed" | "detected";
+export type OverrideDecision = "selected" | "overridden" | "blocked_by_guard" | "stale_warning" | "advisory_only";
+export interface ConfigEvidenceEntry {
+    field_path: string;
+    value_hash: string;
+    source: ConfigSource | EvidenceMetadataSource;
+    confidence: number;
+    evidence_refs: string[];
+    confirmed_by?: string;
+    lifetime: ConfigLifetime;
+    collected_at: string;
+    expires_at?: string;
+}
+export interface ConfigPrecedenceRule {
+    id: string;
+    higher_source: ConfigSource;
+    lower_source: ConfigSource;
+    description: string;
+    override_behavior: OverrideDecision;
+    requires_report: boolean;
+}
+export interface ConfigPrecedenceGovernanceFinding {
+    severity: "hard_fail" | "advisory";
+    rule: string;
+    field_path?: string;
+    message: string;
+}
+/** 上位约束列表 — 这些约束不可被任何配置覆盖 */
+export declare const UPPER_BOUND_GUARDS: readonly ["enforced_guard", "privacy_secret_policy", "contract_state", "command_safety", "delivery_authorization", "data_sovereignty", "destructive_action_gate", "human_sovereignty"];
+export type UpperBoundGuard = (typeof UPPER_BOUND_GUARDS)[number];
+export interface StaleRule {
+    id: string;
+    trigger: "config_vs_fingerprint_mismatch" | "config_vs_blueprint_mismatch" | "fingerprint_drift";
+    severity: "warning" | "hard_fail";
+    description: string;
+    action: string;
+}
+export interface GuardCheckResult {
+    blocked: boolean;
+    report: ConfigResolutionReport;
+}
+export interface ConfigFieldResolution {
+    field_path: string;
+    resolved_value: unknown;
+    source: ConfigSource;
+    stale_warning?: string;
+    conflict_report?: string;
+}
+/**
+ * 逐字段候选来源 — 支持所有 ConfigSource 类型。
+ * 每个键为字段路径，值为候选证据数组。
+ */
+export interface FieldCandidates {
+    [fieldPath: string]: ConfigValueEvidence[];
+}
+/**
+ * 旧版三来源简写 (向后兼容)。
+ */
+export interface LegacyFieldSources {
+    config_value: unknown;
+    fingerprint_value?: unknown;
+    user_override?: unknown;
+}
+export interface ResolveProjectConfigOptions {
+    /** 来自当前用户任务意图的逐字段覆盖 */
+    user_task_overrides?: Record<string, unknown>;
+    /** 来自 CLI 参数的逐字段覆盖 */
+    cli_overrides?: Record<string, unknown>;
+    /** 来自 MCP 参数的逐字段覆盖 */
+    mcp_overrides?: Record<string, unknown>;
+    /** 除默认集之外需要额外解析的字段 */
+    extra_fields?: string[];
+    /** 指定需要解析的字段 (默认为标准集) */
+    fields?: string[];
+}
+export interface ResolveProjectConfigResult {
+    reports: ConfigResolutionReport[];
+    resolutions: ConfigFieldResolution[];
+    warnings: string[];
+    entries: ConfigEvidenceEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/config/config_precedence_contract/types.d.ts.map

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

package/dist/engine/config/config_precedence_contract/types.js

@@ -0,0 +1,20 @@
+/**
+ * Configuration Precedence Contract — Type Definitions
+ *
+ * 配置优先级、覆盖规则、冲突检测和治理检查的所有类型定义。
+ * ConfigSource / ConfigLifetime / ConfigValueEvidence / ConfigConflict / ConfigResolutionReport
+ * 已移至 types/pipeline.ts 消除循环依赖，此处通过 re-export 保持向后兼容。
+ */
+// ── 上位约束 (不可被任何配置覆盖) ──
+/** 上位约束列表 — 这些约束不可被任何配置覆盖 */
+export const UPPER_BOUND_GUARDS = [
+    "enforced_guard",
+    "privacy_secret_policy",
+    "contract_state",
+    "command_safety",
+    "delivery_authorization",
+    "data_sovereignty",
+    "destructive_action_gate",
+    "human_sovereignty",
+];
+//# sourceMappingURL=types.js.map

package/dist/engine/config/config_precedence_contract/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH,yBAAyB;AAEzB,6BAA6B;AAC7B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB;IAChB,uBAAuB;IACvB,gBAAgB;IAChB,gBAAgB;IAChB,wBAAwB;IACxB,kBAAkB;IAClB,yBAAyB;IACzB,mBAAmB;CACX,CAAC"}

package/dist/engine/config/config_precedence_contract.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Configuration Precedence Contract — Facade
+ *
+ * 重导出所有模块，保持与原始单文件 API 完全兼容。
+ * 所有消费者仍然从 "./config_precedence_contract.js" 导入。
+ */
+import type { ResolveProjectConfigOptions, ResolveProjectConfigResult } from "./config_precedence_contract/types.js";
+export type { ConfigSource, EvidenceMetadataSource, ConfigLifetime, OverrideDecision, ConfigValueEvidence, ConfigConflict, ConfigResolutionReport, ConfigEvidenceEntry, ConfigPrecedenceRule, ConfigPrecedenceGovernanceFinding, UpperBoundGuard, StaleRule, GuardCheckResult, ConfigFieldResolution, FieldCandidates, LegacyFieldSources, ResolveProjectConfigOptions, ResolveProjectConfigResult, } from "./config_precedence_contract/types.js";
+export type { FieldClass } from "./config_precedence_contract/field_class.js";
+export { UPPER_BOUND_GUARDS } from "./config_precedence_contract/types.js";
+export { C_CLASS_FIELDS } from "./config_precedence_contract/constants.js";
+export { getPrecedenceRank, getSourceLifetime, isHigherPriority } from "./config_precedence_contract/resolution.js";
+export { listPrecedenceRules, listStaleRules } from "./config_precedence_contract/governance.js";
+export { resolveConfigField, resolveAllFields, checkGuardOverride, detectStaleConfig, resolveConfigFromSources, } from "./config_precedence_contract/resolution.js";
+export { isCClassField, getConfigFieldClass, canAutoWriteField } from "./config_precedence_contract/resolution.js";
+export { mapEvidenceSource } from "./config_precedence_contract/resolution.js";
+export { createConfigValueEvidence, createConfigEvidenceEntry, hashValue } from "./config_precedence_contract/evidence.js";
+export { buildConflictReport } from "./config_precedence_contract/resolution.js";
+export { explainField, isCliWriteSafe } from "./config_precedence_contract/governance.js";
+export { validateConfigPrecedence } from "./config_precedence_contract/governance.js";
+export declare function resolveCurrentProjectConfigReports(projectPath: string, options?: ResolveProjectConfigOptions): Promise<ResolveProjectConfigResult>;
+//# sourceMappingURL=config_precedence_contract.d.ts.map

package/dist/engine/config/config_precedence_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_precedence_contract.d.ts","sourceRoot":"","sources":["../../../src/engine/config/config_precedence_contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACrH,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAGjG,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,4CAA4C,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAGnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAG/E,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAG3H,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAG1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAKtF,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,0BAA0B,CAAC,CAIrC"}

package/dist/engine/config/config_precedence_contract.js

@@ -0,0 +1,34 @@
+/**
+ * Configuration Precedence Contract — Facade
+ *
+ * 重导出所有模块，保持与原始单文件 API 完全兼容。
+ * 所有消费者仍然从 "./config_precedence_contract.js" 导入。
+ */
+// ── 常量 ──
+export { UPPER_BOUND_GUARDS } from "./config_precedence_contract/types.js";
+export { C_CLASS_FIELDS } from "./config_precedence_contract/constants.js";
+// ── 查询函数 ──
+export { getPrecedenceRank, getSourceLifetime, isHigherPriority } from "./config_precedence_contract/resolution.js";
+export { listPrecedenceRules, listStaleRules } from "./config_precedence_contract/governance.js";
+// ── 解析 ──
+export { resolveConfigField, resolveAllFields, checkGuardOverride, detectStaleConfig, resolveConfigFromSources, } from "./config_precedence_contract/resolution.js";
+// ── 字段分类 ──
+export { isCClassField, getConfigFieldClass, canAutoWriteField } from "./config_precedence_contract/resolution.js";
+// ── 证据来源映射 ──
+export { mapEvidenceSource } from "./config_precedence_contract/resolution.js";
+// ── 证据工厂 ──
+export { createConfigValueEvidence, createConfigEvidenceEntry, hashValue } from "./config_precedence_contract/evidence.js";
+// ── 报告 & 解释 ──
+export { buildConflictReport } from "./config_precedence_contract/resolution.js";
+export { explainField, isCliWriteSafe } from "./config_precedence_contract/governance.js";
+// ── 治理校验 ──
+export { validateConfigPrecedence } from "./config_precedence_contract/governance.js";
+// ── 项目配置解析 ──
+// 使用动态导入包装器打破静态循环依赖（project_config.ts 依赖 zero_config_init.ts 回导到本模块）
+// 注意: 使用拼接路径避免 madge 静态分析解析动态导入字符串字面量
+export async function resolveCurrentProjectConfigReports(projectPath, options) {
+    const mod = "./config_precedence_contract/proj" + "ect_config.js";
+    const { resolveCurrentProjectConfigReports: resolve } = await import(mod);
+    return resolve(projectPath, options);
+}
+//# sourceMappingURL=config_precedence_contract.js.map

package/dist/engine/config/config_precedence_contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_precedence_contract.js","sourceRoot":"","sources":["../../../src/engine/config/config_precedence_contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAE3E,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjG,WAAW;AACX,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,4CAA4C,CAAC;AAEpD,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAEnH,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAE/E,aAAa;AACb,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAE3H,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE1F,aAAa;AACb,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAEtF,eAAe;AACf,qEAAqE;AACrE,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,WAAmB,EACnB,OAAqC;IAErC,MAAM,GAAG,GAAG,mCAAmC,GAAG,eAAe,CAAC;IAClE,MAAM,EAAE,kCAAkC,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/engine/config/config_write_boundary.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 配置落盘边界。
+ *
+ * 区分空项目、已有项目和运行时推断，防止自动推断结果在未确认时写入用户工程。
+ */
+export type ConfigWriteContextKind = "greenfield" | "existing_project" | "runtime_inference";
+export interface ConfigWriteContext {
+    kind: ConfigWriteContextKind;
+    project_path: string;
+    evidence: string[];
+    confirmed: boolean;
+}
+export interface ConfigWriteDecision {
+    allowed: boolean;
+    reason_zh: string;
+    requires_confirmation: boolean;
+}
+export interface WriteBoundaryViolation {
+    target_path: string;
+    reason_zh: string;
+}
+export declare function classifyConfigContext(projectDir: string, opts?: {
+    runtime_inference?: boolean;
+    confirmed?: boolean;
+}): ConfigWriteContext;
+export declare function isWriteAllowed(context: ConfigWriteContext, targetPath: string): ConfigWriteDecision;
+export declare function getWriteConfirmationPrompt(context: ConfigWriteContext, targetPath: string): string;
+export declare function validateWriteBoundary(context: ConfigWriteContext, writes: string[]): WriteBoundaryViolation[];
+//# sourceMappingURL=config_write_boundary.d.ts.map

package/dist/engine/config/config_write_boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_write_boundary.d.ts","sourceRoot":"","sources":["../../../src/engine/config/config_write_boundary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,CAYzI;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAsBnG;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIlG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAwB7G"}

package/dist/engine/config/config_write_boundary.js

@@ -0,0 +1,85 @@
+/**
+ * 配置落盘边界。
+ *
+ * 区分空项目、已有项目和运行时推断，防止自动推断结果在未确认时写入用户工程。
+ */
+import fs from "node:fs";
+import path from "node:path";
+const PROJECT_MARKERS = [
+    "package.json",
+    "pom.xml",
+    "build.gradle",
+    "settings.gradle",
+    "pyproject.toml",
+    "go.mod",
+    "Cargo.toml",
+    "src",
+];
+export function classifyConfigContext(projectDir, opts) {
+    if (opts?.runtime_inference) {
+        return { kind: "runtime_inference", project_path: projectDir, evidence: ["runtime_inference"], confirmed: opts.confirmed === true };
+    }
+    const evidence = PROJECT_MARKERS.filter((m) => fs.existsSync(path.join(projectDir, m)));
+    const hasSoloforgeState = fs.existsSync(path.join(projectDir, ".soloforge"))
+        || fs.existsSync(path.join(projectDir, ".mcp.json"))
+        || fs.existsSync(path.join(projectDir, "CLAUDE.md"));
+    if (evidence.length === 0 && !hasSoloforgeState) {
+        return { kind: "greenfield", project_path: projectDir, evidence: ["empty_project"], confirmed: opts?.confirmed === true };
+    }
+    return { kind: "existing_project", project_path: projectDir, evidence, confirmed: opts?.confirmed === true };
+}
+export function isWriteAllowed(context, targetPath) {
+    const normalized = targetPath.replace(/\\/g, "/");
+    const isSoloforgeManaged = normalized.includes(".soloforge/")
+        || normalized.endsWith(".mcp.json")
+        || normalized.endsWith("CLAUDE.md")
+        || normalized.includes(".claude/");
+    if (context.kind === "runtime_inference") {
+        return {
+            allowed: false,
+            reason_zh: "运行时推断结果不得自动落盘，请使用 init --auto 或明确确认后写入。",
+            requires_confirmation: true,
+        };
+    }
+    if (context.kind === "existing_project" && isSoloforgeManaged && !context.confirmed) {
+        return {
+            allowed: false,
+            reason_zh: "已有项目写入 SoloForge 管理文件需要用户确认。",
+            requires_confirmation: true,
+        };
+    }
+    return { allowed: true, reason_zh: "写入边界允许", requires_confirmation: false };
+}
+export function getWriteConfirmationPrompt(context, targetPath) {
+    const decision = isWriteAllowed(context, targetPath);
+    if (decision.allowed)
+        return "无需额外确认。";
+    return `即将向 ${context.kind} 项目写入 ${targetPath}。${decision.reason_zh}`;
+}
+export function validateWriteBoundary(context, writes) {
+    const violations = [];
+    for (const target of writes) {
+        const decision = isWriteAllowed(context, target);
+        if (!decision.allowed) {
+            violations.push({ target_path: target, reason_zh: decision.reason_zh });
+        }
+        // [DOC-3] 同步模板不得覆盖用户已修改资产
+        if (fs.existsSync(target)) {
+            try {
+                const stat = fs.statSync(target);
+                // 如果文件存在且有实质内容（>100 字节视为用户修改），且不是 SoloForge 管理文件，则标记警告
+                if (stat.size > 100 && !target.includes(".soloforge/")) {
+                    violations.push({
+                        target_path: target,
+                        reason_zh: `文件 ${path.basename(target)} 已存在且有内容（${stat.size} 字节），同步模板可能覆盖用户修改。请确认或备份后重试。`,
+                    });
+                }
+            }
+            catch {
+                // 文件无法读取则跳过检查
+            }
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=config_write_boundary.js.map