soloforge 1.1.37 → 1.1.40

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

@@ -1,232 +0,0 @@
-/**
- * Configuration Precedence Contract — Governance & Reporting
- *
- * 治理校验、中文解释、冲突报告、CLI 写入守卫。
- */
-import { PRECEDENCE_RULES, STALE_RULES } from "./constants.js";
-import { debug } from "../../core/logger.js";
-import { getPrecedenceRank, isCClassField, mapEvidenceSource, sourceLabel, lifetimeLabel, } from "./resolution.js";
-import { hashValue } from "./evidence.js";
-import { PRECEDENCE_ORDER } from "./constants.js";
-// ── 查询函数 (委托 constants) ──
-/** 列出所有配置优先级规则
- * @returns 优先级规则数组
- */
-export function listPrecedenceRules() {
-    return PRECEDENCE_RULES;
-}
-/** 列出所有配置过期检测规则
- * @returns 过期规则数组
- */
-export function listStaleRules() {
-    return STALE_RULES;
-}
-// ── CLI 参数写入守卫 ──
-/** 判断来源是否可安全写入配置（非 CLI/MCP 临时参数）
- * @param source - 配置来源
- * @returns 是否可安全写入
- */
-export function isCliWriteSafe(source) {
-    return source !== "cli_flag" && source !== "mcp_param";
-}
-// ── 中文解释 ──
-/** 生成配置字段解析结果的中文解释
- * @param report - 配置解析报告
- * @returns 格式化的中文解释文本
- */
-export function explainField(report) {
-    const lines = [];
-    const sel = report.selected;
-    lines.push(`字段: ${report.field_path}`);
-    lines.push(`当前值: ${JSON.stringify(sel.value)}`);
-    lines.push(`来源: ${sourceLabel(sel.source)} (优先级 ${getPrecedenceRank(sel.source) + 1}/${PRECEDENCE_ORDER.length})`);
-    lines.push(`生命周期: ${lifetimeLabel(report.lifetime)}`);
-    lines.push(`置信度: ${sel.confidence}`);
-    if (sel.evidence_ref) {
-        lines.push(`证据: ${sel.evidence_ref}`);
-    }
-    if (report.candidates.length > 1) {
-        lines.push(`其他候选:`);
-        for (let i = 1; i < report.candidates.length; i++) {
-            const c = report.candidates[i];
-            lines.push(`  - ${sourceLabel(c.source)}: ${JSON.stringify(c.value)} (未被采用: ${notSelectedReason(report, c)})`);
-        }
-    }
-    if (report.overridden_by_guard) {
-        lines.push(`⚠️ 被上位约束 ${report.overridden_by_guard} 阻止`);
-    }
-    if (report.conflicts.length > 0) {
-        lines.push(`冲突:`);
-        for (const c of report.conflicts) {
-            lines.push(`  - ${sourceLabel(c.source_a)} vs ${sourceLabel(c.source_b)}: ${c.reason}`);
-            if (c.requires_human) {
-                lines.push(`    需要人工确认`);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-function notSelectedReason(report, candidate) {
-    const selectedRank = getPrecedenceRank(report.selected.source);
-    const candidateRank = getPrecedenceRank(candidate.source);
-    if (candidateRank > selectedRank) {
-        return `优先级低于 ${sourceLabel(report.selected.source)}`;
-    }
-    return "值相同，无冲突";
-}
-// ── 治理校验 ──
-/** 执行配置优先级治理校验
- * @param reports - 配置解析报告列表
- * @param entries - 配置证据条目列表
- * @returns 治理发现列表
- */
-export function validateConfigPrecedence(reports, entries) {
-    debug("配置优先级", "开始治理校验，共 %d 个报告", reports.length);
-    const findings = [];
-    // 规则 1: CLI flag 不静默写入 config
-    for (const e of entries) {
-        if (e.source === "cli_flag" || e.source === "mcp_param") {
-            if (e.lifetime === "project_persistent") {
-                findings.push({
-                    severity: "hard_fail",
-                    rule: "gc-cli-no-persist",
-                    field_path: e.field_path,
-                    message: `CLI/MCP 参数 (${e.source}) 不应持久化到 config — ${e.field_path}`,
-                });
-            }
-        }
-    }
-    // 规则 2: fingerprint 不覆盖 confirmed_config
-    for (const r of reports) {
-        if (r.selected.source === "fingerprint") {
-            const hasConfirmed = r.candidates.some((c) => c.source === "confirmed_config");
-            if (hasConfirmed) {
-                findings.push({
-                    severity: "hard_fail",
-                    rule: "gc-fingerprint-no-override",
-                    field_path: r.field_path,
-                    message: `fingerprint 不应覆盖 confirmed_config — ${r.field_path}`,
-                });
-            }
-        }
-    }
-    // 规则 3: product_profile 不覆盖 config
-    for (const r of reports) {
-        if (r.selected.source === "product_profile") {
-            const hasConfirmed = r.candidates.some((c) => c.source === "confirmed_config");
-            if (hasConfirmed) {
-                findings.push({
-                    severity: "hard_fail",
-                    rule: "gc-profile-no-override",
-                    field_path: r.field_path,
-                    message: `product_profile 不应覆盖 confirmed_config — ${r.field_path}`,
-                });
-            }
-        }
-    }
-    // 规则 4: knowledge_default 不覆盖 config
-    for (const r of reports) {
-        if (r.selected.source === "knowledge_default") {
-            const hasConfig = r.candidates.some((c) => c.source === "confirmed_config" || c.source === "project_policy");
-            if (hasConfig) {
-                findings.push({
-                    severity: "hard_fail",
-                    rule: "gc-knowledge-no-override",
-                    field_path: r.field_path,
-                    message: `knowledge_default 不应覆盖 config — ${r.field_path}`,
-                });
-            }
-        }
-    }
-    // 规则 5: C 类字段不得自动写入 — only confirmed_config (from user_declared/confirmed) allowed
-    for (const e of entries) {
-        if (isCClassField(e.field_path)) {
-            const canonical = mapEvidenceSource(e.source);
-            if (canonical !== "confirmed_config") {
-                findings.push({
-                    severity: "hard_fail",
-                    rule: "gc-c-class-no-auto",
-                    field_path: e.field_path,
-                    message: `C 类字段 ${e.field_path} 不得自动写入 (当前来源: ${e.source})`,
-                });
-            }
-        }
-    }
-    // 规则 6: guard 不可被配置绕过 — check that guard-blocked fields stay blocked
-    for (const r of reports) {
-        if (r.overridden_by_guard) {
-            findings.push({
-                severity: "advisory",
-                rule: "gc-guard-block",
-                field_path: r.field_path,
-                message: `字段 ${r.field_path} 被上位约束 ${r.overridden_by_guard} 保护`,
-            });
-        }
-    }
-    // 规则 7: conflict 必须被报告 (advisory)
-    for (const r of reports) {
-        if (r.conflicts.length > 0) {
-            const configFpConflict = r.conflicts.find((c) => c.source_a === "confirmed_config" && c.source_b === "fingerprint");
-            if (configFpConflict) {
-                findings.push({
-                    severity: "advisory",
-                    rule: "gc-conflict-report",
-                    field_path: r.field_path,
-                    message: `字段 ${r.field_path} 存在 confirmed_config 与 fingerprint 冲突，已自动处理`,
-                });
-            }
-        }
-    }
-    // 规则 9: value_hash 不匹配 — 证据条目的 hash 必须与解析值一致
-    for (const r of reports) {
-        const entry = entries.find((e) => e.field_path === r.field_path);
-        if (entry) {
-            const computed = hashValue(r.selected.value);
-            if (entry.value_hash !== computed) {
-                findings.push({
-                    severity: "hard_fail",
-                    rule: "gc-evidence-hash-mismatch",
-                    field_path: r.field_path,
-                    message: `字段 ${r.field_path} evidence value_hash 不匹配 (entry=${entry.value_hash}, computed=${computed}) — evidence 可能过期`,
-                });
-            }
-        }
-    }
-    // 规则 10: blueprint 与 fingerprint/confirmed_config 不一致 (advisory)
-    for (const r of reports) {
-        const blueprintCandidate = r.candidates.find((c) => c.source === "blueprint");
-        if (!blueprintCandidate)
-            continue;
-        const higherCandidate = r.candidates.find((c) => c.source === "fingerprint" || c.source === "confirmed_config");
-        if (!higherCandidate)
-            continue;
-        if (JSON.stringify(blueprintCandidate.value) !== JSON.stringify(higherCandidate.value)) {
-            findings.push({
-                severity: "advisory",
-                rule: "gc-blueprint-mismatch",
-                field_path: r.field_path,
-                message: `字段 ${r.field_path} blueprint (${JSON.stringify(blueprintCandidate.value)}) 与 ${higherCandidate.source} (${JSON.stringify(higherCandidate.value)}) 不一致 — blueprint 可能需要更新`,
-            });
-        }
-    }
-    // 规则 8: 每个 resolved 字段应有 evidence
-    for (const r of reports) {
-        const hasEntry = entries.some((e) => e.field_path === r.field_path);
-        if (!hasEntry) {
-            findings.push({
-                severity: "advisory",
-                rule: "gc-evidence-required",
-                field_path: r.field_path,
-                message: `字段 ${r.field_path} 已解析但缺少 ConfigEvidenceEntry`,
-            });
-        }
-    }
-    if (findings.length > 0) {
-        const hardFails = findings.filter(f => f.severity === "hard_fail");
-        if (hardFails.length > 0) {
-            debug("配置优先级", "治理校验发现 %d 个 hard_fail", hardFails.length);
-        }
-    }
-    return findings;
-}
-//# sourceMappingURL=governance.js.map

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

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

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

@@ -1,21 +0,0 @@
-/**
- * Configuration Precedence Contract — Re-exports
- *
- * 所有导出均通过此文件重导出，保持与原始 config_precedence_contract.ts
- * 完全相同的公开 API。
- */
-export type { ConfigSource, EvidenceMetadataSource, ConfigLifetime, OverrideDecision, ConfigValueEvidence, ConfigConflict, ConfigResolutionReport, ConfigEvidenceEntry, ConfigPrecedenceRule, ConfigPrecedenceGovernanceFinding, UpperBoundGuard, StaleRule, GuardCheckResult, ConfigFieldResolution, FieldCandidates, LegacyFieldSources, ResolveProjectConfigOptions, ResolveProjectConfigResult, } from "./types.js";
-export type { FieldClass } from "./field_class.js";
-export { UPPER_BOUND_GUARDS } from "./types.js";
-export { C_CLASS_FIELDS } from "./constants.js";
-export { getPrecedenceRank, getSourceLifetime, isHigherPriority } from "./resolution.js";
-export { listPrecedenceRules, listStaleRules } from "./governance.js";
-export { resolveConfigField, resolveAllFields, checkGuardOverride, detectStaleConfig, resolveConfigFromSources, } from "./resolution.js";
-export { isCClassField, getConfigFieldClass, canAutoWriteField } from "./resolution.js";
-export { mapEvidenceSource } from "./resolution.js";
-export { createConfigValueEvidence, createConfigEvidenceEntry, hashValue } from "./evidence.js";
-export { buildConflictReport } from "./resolution.js";
-export { explainField, isCliWriteSafe } from "./governance.js";
-export { validateConfigPrecedence } from "./governance.js";
-export { resolveCurrentProjectConfigReports } from "./project_config.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,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,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGhG,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -1,28 +0,0 @@
-/**
- * Configuration Precedence Contract — Re-exports
- *
- * 所有导出均通过此文件重导出，保持与原始 config_precedence_contract.ts
- * 完全相同的公开 API。
- */
-// ── 常量 ──
-export { UPPER_BOUND_GUARDS } from "./types.js";
-export { C_CLASS_FIELDS } from "./constants.js";
-// ── 查询函数 ──
-export { getPrecedenceRank, getSourceLifetime, isHigherPriority } from "./resolution.js";
-export { listPrecedenceRules, listStaleRules } from "./governance.js";
-// ── 解析 ──
-export { resolveConfigField, resolveAllFields, checkGuardOverride, detectStaleConfig, resolveConfigFromSources, } from "./resolution.js";
-// ── 字段分类 ──
-export { isCClassField, getConfigFieldClass, canAutoWriteField } from "./resolution.js";
-// ── 证据来源映射 ──
-export { mapEvidenceSource } from "./resolution.js";
-// ── 证据工厂 ──
-export { createConfigValueEvidence, createConfigEvidenceEntry, hashValue } from "./evidence.js";
-// ── 报告 & 解释 ──
-export { buildConflictReport } from "./resolution.js";
-export { explainField, isCliWriteSafe } from "./governance.js";
-// ── 治理校验 ──
-export { validateConfigPrecedence } from "./governance.js";
-// ── 项目配置解析 ──
-export { resolveCurrentProjectConfigReports } from "./project_config.js";
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtE,WAAW;AACX,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExF,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,aAAa;AACb,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhG,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/D,aAAa;AACb,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,eAAe;AACf,OAAO,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -1,20 +0,0 @@
-/**
- * Configuration Precedence Contract — Project Config Resolution
- *
- * 共享项目级配置解析：读取 config.yaml、指纹、证据条目，
- * 汇集所有候选来源并逐字段解析。
- */
-import type { ResolveProjectConfigOptions, ResolveProjectConfigResult } from "./types.js";
-/**
- * 共享函数，解析当前项目配置。
- * 读取 config.yaml、实时指纹、证据条目，并接受所有候选来源。
- * expand()、配置解析/解释、校验、状态、治理都必须复用此函数 — 不可重复逻辑。
- *
- * 证据条目不是候选值 — 仅用于校验：
- * 检查来源/生命周期合规性和 value_hash 匹配。
- *
- * product_profile: fingerprint 候选仅来自确定性产品证据
- * (package.json soloforge.product_profile)，不使用技术形态推断。
- */
-export declare function resolveCurrentProjectConfigReports(projectPath: string, options?: ResolveProjectConfigOptions): Promise<ResolveProjectConfigResult>;
-//# sourceMappingURL=project_config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"project_config.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/project_config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAEV,2BAA2B,EAC3B,0BAA0B,EAE3B,MAAM,YAAY,CAAC;AAOpB;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,0BAA0B,CAAC,CA4HrC"}

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

@@ -1,210 +0,0 @@
-/**
- * Configuration Precedence Contract — Project Config Resolution
- *
- * 共享项目级配置解析：读取 config.yaml、指纹、证据条目，
- * 汇集所有候选来源并逐字段解析。
- */
-import nodePath from "node:path";
-import nodeFs from "node:fs";
-import YAML from "yaml";
-import { DEFAULT_CONFIG_FIELDS } from "./constants.js";
-import { debug } from "../../core/logger.js";
-import { safeJsonParse } from "../../core/helpers.js";
-import { resolveConfigFromSources } from "./resolution.js";
-import { createConfigValueEvidence } from "./evidence.js";
-/**
- * 共享函数，解析当前项目配置。
- * 读取 config.yaml、实时指纹、证据条目，并接受所有候选来源。
- * expand()、配置解析/解释、校验、状态、治理都必须复用此函数 — 不可重复逻辑。
- *
- * 证据条目不是候选值 — 仅用于校验：
- * 检查来源/生命周期合规性和 value_hash 匹配。
- *
- * product_profile: fingerprint 候选仅来自确定性产品证据
- * (package.json soloforge.product_profile)，不使用技术形态推断。
- */
-export async function resolveCurrentProjectConfigReports(projectPath, options) {
-    debug("配置优先级", "开始解析项目配置");
-    // 动态导入: 使用拼接路径避免 madge 静态分析解析字符串字面量（消除误报循环依赖）
-    const { resolveProjectConfig } = await import("../../../knowledge/loa" + "der.js");
-    const { detectFingerprint } = await import("../zero_config_i" + "nit.js");
-    const { loadConfigEvidenceEntries } = await import("../../../bin/config_comma" + "nds.js");
-    const { config } = await resolveProjectConfig(projectPath);
-    let fp = null;
-    try {
-        fp = await detectFingerprint(projectPath);
-    }
-    catch (e) {
-        debug("配置优先级", "项目指纹检测失败 —", e);
-    }
-    // 证据条目仅用于校验 — 不作为候选值
-    const entries = loadConfigEvidenceEntries(projectPath);
-    const fields = options?.fields ?? DEFAULT_CONFIG_FIELDS;
-    const fieldCandidates = {};
-    for (const fieldPath of fields) {
-        const candidates = [];
-        // 1. user_task 覆盖 (最高优先级)
-        if (options?.user_task_overrides?.[fieldPath] !== undefined) {
-            candidates.push(createConfigValueEvidence(fieldPath, options.user_task_overrides[fieldPath], "user_task", 1.0, "user intent"));
-        }
-        // 2. cli_flag 覆盖
-        if (options?.cli_overrides?.[fieldPath] !== undefined) {
-            candidates.push(createConfigValueEvidence(fieldPath, options.cli_overrides[fieldPath], "cli_flag", 1.0, "cli flag"));
-        }
-        // 3. mcp_param 覆盖
-        if (options?.mcp_overrides?.[fieldPath] !== undefined) {
-            candidates.push(createConfigValueEvidence(fieldPath, options.mcp_overrides[fieldPath], "mcp_param", 1.0, "mcp param"));
-        }
-        // 4. confirmed_config 来自 config.yaml
-        const configVal = getConfigFieldValue(config, fieldPath);
-        if (configVal !== undefined) {
-            candidates.push(createConfigValueEvidence(fieldPath, configVal, "confirmed_config", 0.9, "config.yaml"));
-        }
-        // 5. project_policy — 从 .soloforge/policy.yaml 加载 (如存在)
-        const policyVal = loadProjectPolicyField(projectPath, fieldPath);
-        if (policyVal !== undefined) {
-            candidates.push(createConfigValueEvidence(fieldPath, policyVal, "project_policy", 0.85, "policy.yaml"));
-        }
-        // 6. fingerprint — 不用于 product_profile (不进行技术形态推断)
-        if (fp && fieldPath !== "product_profile") {
-            const fpVal = getFingerprintFieldValue(fp, fieldPath);
-            if (fpVal !== undefined) {
-                candidates.push(createConfigValueEvidence(fieldPath, fpVal, "fingerprint", 0.8, "file detection"));
-            }
-        }
-        // product_profile: 仅使用 package.json soloforge.product_profile 的确定性证据
-        if (fp && fieldPath === "product_profile") {
-            const productEvidence = detectProductEvidenceFromFingerprint(fp);
-            if (productEvidence !== null) {
-                candidates.push(createConfigValueEvidence(fieldPath, productEvidence.value, "fingerprint", 0.8, productEvidence.evidence[0]));
-            }
-        }
-        // 7. blueprint — 从 .soloforge/blueprint.yaml 加载 (如存在)
-        const blueprintVal = loadBlueprintField(projectPath, fieldPath);
-        if (blueprintVal !== undefined) {
-            candidates.push(createConfigValueEvidence(fieldPath, blueprintVal, "blueprint", 0.6, "blueprint"));
-        }
-        // 8. product_profile 作为默认值 — 仅在其他候选均未提供值时使用
-        // (product_profile 来自知识文件，非技术形态)
-        if (fieldPath === "product_profile" && candidates.length === 0) {
-            const profileDefault = loadProductProfileDefault(projectPath);
-            if (profileDefault !== undefined) {
-                candidates.push(createConfigValueEvidence(fieldPath, profileDefault, "product_profile", 0.4, "product profile default"));
-            }
-        }
-        // 9. knowledge_default (知识库默认)
-        const knowledgeDefault = loadKnowledgeDefault(projectPath, fieldPath);
-        if (knowledgeDefault !== undefined && candidates.length === 0) {
-            candidates.push(createConfigValueEvidence(fieldPath, knowledgeDefault, "knowledge_default", 0.3, "knowledge default"));
-        }
-        // 10. global_default — 硬编码回退值
-        const globalDefault = getGlobalDefault(fieldPath);
-        if (globalDefault !== undefined && candidates.length === 0) {
-            candidates.push(createConfigValueEvidence(fieldPath, globalDefault, "global_default", 0.1, "global default"));
-        }
-        fieldCandidates[fieldPath] = candidates;
-    }
-    const { resolutions, reports, warnings } = resolveConfigFromSources(fieldCandidates);
-    if (warnings.length > 0) {
-        debug("配置优先级", "发现 %d 个配置警告", warnings.length);
-    }
-    debug("配置优先级", "解析完成，共 %d 个字段", resolutions.length);
-    return { reports, resolutions, warnings, entries };
-}
-// ── 来源加载辅助函数 ──
-function loadProjectPolicyField(projectPath, fieldPath) {
-    const policyPath = nodePath.join(projectPath, ".soloforge", "policy.yaml");
-    try {
-        const raw = nodeFs.readFileSync(policyPath, "utf-8");
-        const parsed = YAML.parse(raw);
-        return getConfigFieldValue(parsed ?? {}, fieldPath);
-    }
-    catch {
-        return undefined;
-    }
-}
-function loadBlueprintField(projectPath, fieldPath) {
-    const blueprintPath = nodePath.join(projectPath, ".soloforge", "blueprint.yaml");
-    try {
-        const raw = nodeFs.readFileSync(blueprintPath, "utf-8");
-        const parsed = YAML.parse(raw);
-        return getConfigFieldValue(parsed ?? {}, fieldPath);
-    }
-    catch {
-        return undefined;
-    }
-}
-function loadProductProfileDefault(projectPath) {
-    const profileDir = nodePath.join(projectPath, ".soloforge", "knowledge", "product_profiles");
-    try {
-        const files = nodeFs.readdirSync(profileDir).filter(f => f.endsWith(".md") || f.endsWith(".yaml"));
-        if (files.length > 0)
-            return files[0].replace(/.(md|yaml)$/, "");
-    }
-    catch {
-        debug("project_config", "读取产品画像目录失败，跳过");
-    }
-    return undefined;
-}
-function loadKnowledgeDefault(projectPath, fieldPath) {
-    const defaultsPath = nodePath.join(projectPath, ".soloforge", "knowledge", "defaults.yaml");
-    try {
-        const raw = nodeFs.readFileSync(defaultsPath, "utf-8");
-        const parsed = YAML.parse(raw);
-        if (parsed && typeof parsed === "object")
-            return getConfigFieldValue(parsed, fieldPath);
-    }
-    catch {
-        debug("project_config", "读取默认配置失败，跳过");
-    }
-    return undefined;
-}
-function getGlobalDefault(fieldPath) {
-    const defaults = {
-        "product_profile": "default",
-    };
-    return defaults[fieldPath];
-}
-function getConfigFieldValue(obj, fieldPath) {
-    const parts = fieldPath.split(".");
-    let current = obj;
-    for (const p of parts) {
-        if (!current || typeof current !== "object")
-            return undefined;
-        current = current[p];
-    }
-    return current;
-}
-function getFingerprintFieldValue(fp, fieldPath) {
-    switch (fieldPath) {
-        case "tech_stack.backend.framework":
-            return fp.backend?.framework || undefined;
-        case "tech_stack.frontend.framework":
-            return fp.frontend?.framework || undefined;
-        default:
-            return undefined;
-    }
-}
-function detectProductEvidenceFromFingerprint(fp) {
-    // 委托给 zero_config_init 的 detectProductEvidence
-    // 由于该函数未导出，此处复制其逻辑：
-    // 仅 package.json soloforge.product_profile 作为确定性证据
-    if (!fp.project_root)
-        return null;
-    const pkgPath = nodePath.join(fp.project_root, "package.json");
-    try {
-        const raw = nodeFs.readFileSync(pkgPath, "utf-8");
-        const data = safeJsonParse(raw);
-        if (data?.soloforge && typeof data.soloforge.product_profile === "string") {
-            const val = data.soloforge.product_profile;
-            if (val.length > 0) {
-                return { value: val, evidence: ["package.json soloforge.product_profile"] };
-            }
-        }
-    }
-    catch {
-        debug("project_config", "读取 package.json 产品画像失败，跳过");
-    }
-    return null;
-}
-//# sourceMappingURL=project_config.js.map

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

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

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

@@ -1,93 +0,0 @@
-/**
- * Configuration Precedence Contract — Resolution
- *
- * 配置字段解析、上位约束执行、过期检测、字段分类、证据来源映射。
- */
-import type { FieldClass } from "./field_class.js";
-import type { ConfigSource, ConfigLifetime, ConfigValueEvidence, ConfigResolutionReport, UpperBoundGuard, ConfigFieldResolution, FieldCandidates, LegacyFieldSources, GuardCheckResult } from "./types.js";
-/** 列出所有配置优先级规则 — 导入自 constants，通过 index 重导出 */
-/** 获取配置来源的优先级排名（数值越小优先级越高）
- * @param source - 配置来源
- * @returns 优先级排名索引
- */
-export declare function getPrecedenceRank(source: ConfigSource): number;
-/** 获取配置来源的生命周期
- * @param source - 配置来源
- * @returns 生命周期类型
- */
-export declare function getSourceLifetime(source: ConfigSource): ConfigLifetime;
-/** 判断来源 a 的优先级是否高于来源 b
- * @param a - 配置来源 a
- * @param b - 配置来源 b
- * @returns a 是否优先级更高
- */
-export declare function isHigherPriority(a: ConfigSource, b: ConfigSource): boolean;
-/** 解析单个配置字段 — 按优先级排序候选值并检测冲突
- * @param fieldPath - 字段路径
- * @param candidates - 候选值列表
- * @returns 配置解析报告
- */
-export declare function resolveConfigField(fieldPath: string, candidates: ConfigValueEvidence[]): ConfigResolutionReport;
-/** 解析所有配置字段
- * @param fieldCandidates - 字段路径到候选值列表的映射
- * @returns 所有字段的解析报告数组
- */
-export declare function resolveAllFields(fieldCandidates: Record<string, ConfigValueEvidence[]>): ConfigResolutionReport[];
-/** 检查上位约束是否阻止该配置
- * @param report - 配置解析报告
- * @param guardId - 上位约束 ID
- * @returns 约束检查结果
- */
-export declare function checkGuardOverride(report: ConfigResolutionReport, guardId: UpperBoundGuard): GuardCheckResult;
-/** 检测配置是否过期 — 比较确认值与指纹值是否一致
- * @param confirmedValue - 已确认的配置值
- * @param fingerprintValue - 当前指纹值
- * @returns 是否过期及警告信息
- */
-export declare function detectStaleConfig(confirmedValue: ConfigValueEvidence, fingerprintValue: ConfigValueEvidence): {
-    isStale: boolean;
-    warning: string;
-};
-/** 判断字段是否为 C 类字段
- * @param fieldPath - 字段路径
- * @returns 是否为 C 类字段
- */
-export declare function isCClassField(fieldPath: string): boolean;
-/** 获取配置字段的分类（C 类或 B 类）
- * @param fieldPath - 字段路径
- * @param explicitClass - 显式指定的分类（可选）
- * @returns 字段分类
- */
-export declare function getConfigFieldClass(fieldPath: string, explicitClass?: FieldClass): FieldClass;
-/** 判断字段是否允许自动写入
- * @param fieldPath - 字段路径
- * @param fieldClass - 字段分类
- * @param source - 配置来源
- * @returns 是否允许及原因
- */
-export declare function canAutoWriteField(fieldPath: string, fieldClass: FieldClass, source: ConfigSource | string): {
-    allowed: boolean;
-    reason: string;
-};
-/** 将证据元数据来源映射为规范配置来源
- * @param source - 原始来源标识
- * @returns 规范配置来源
- */
-export declare function mapEvidenceSource(source: string): ConfigSource;
-/** 从候选来源解析所有配置字段，支持新旧两种格式和冲突检测
- * @param fields - 字段候选值映射（FieldCandidates 新格式或 LegacyFieldSources 旧格式）
- * @returns 解析结果、解析报告和警告信息
- */
-export declare function resolveConfigFromSources(fields: FieldCandidates | Record<string, LegacyFieldSources>): {
-    resolutions: ConfigFieldResolution[];
-    reports: ConfigResolutionReport[];
-    warnings: string[];
-};
-export declare function sourceLabel(source: ConfigSource): string;
-export declare function lifetimeLabel(lifetime: ConfigLifetime): string;
-/** 生成配置冲突的中文报告
- * @param report - 配置解析报告
- * @returns 格式化的冲突报告文本
- */
-export declare function buildConflictReport(report: ConfigResolutionReport): string;
-//# sourceMappingURL=resolution.d.ts.map