soloforge 1.1.2 → 1.1.30

package/dist/engine/config/config_auto_repair.js

@@ -0,0 +1,254 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { createConfigEvidenceEntry } from "./config_precedence_contract.js";
+const EVIDENCE_FIELD_PATHS = [
+    "name",
+    "tech_stack.backend",
+    "tech_stack.frontend",
+    "build_commands.backend",
+    "build_commands.frontend",
+    "product_profile",
+    "repos",
+    "scope.backend",
+    "scope.frontend",
+];
+function cloneConfig(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return {};
+    return structuredClone(raw);
+}
+function getField(config, fieldPath) {
+    let current = config;
+    for (const part of fieldPath.split(".")) {
+        if (!current || typeof current !== "object")
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function setField(config, fieldPath, value) {
+    const parts = fieldPath.split(".");
+    let current = config;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!current[part] || typeof current[part] !== "object")
+            current[part] = {};
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+function normalizeStringField(config, fieldPath, issues) {
+    const value = getField(config, fieldPath);
+    if (typeof value === "number" || typeof value === "boolean") {
+        const nextValue = String(value);
+        setField(config, fieldPath, nextValue);
+        issues.push({
+            kind: "schema_type",
+            field_path: fieldPath,
+            message_zh: `${fieldPath} 是机械类型错误，已转为字符串`,
+            before: value,
+            after: nextValue,
+        });
+    }
+}
+function normalizeStringArrayField(config, fieldPath, issues) {
+    const value = getField(config, fieldPath);
+    if (typeof value === "string") {
+        const nextValue = value.trim() ? [value] : [];
+        setField(config, fieldPath, nextValue);
+        issues.push({
+            kind: "schema_type",
+            field_path: fieldPath,
+            message_zh: `${fieldPath} 是机械类型错误，已转为数组`,
+            before: value,
+            after: nextValue,
+        });
+    }
+}
+function normalizeRepoScopes(config, issues) {
+    const repos = config.repos;
+    if (!Array.isArray(repos))
+        return;
+    repos.forEach((repo, index) => {
+        if (repo && typeof repo === "object" && typeof repo.scope === "string") {
+            const before = repo.scope;
+            repo.scope = before.trim() ? [before] : [];
+            issues.push({
+                kind: "schema_type",
+                field_path: `repos.${index}.scope`,
+                message_zh: `repos.${index}.scope 是机械类型错误，已转为数组`,
+                before,
+                after: repo.scope,
+            });
+        }
+    });
+}
+function normalizeMechanicalTypes(raw) {
+    const config = cloneConfig(raw);
+    const issues = [];
+    normalizeStringField(config, "tech_stack.backend.version", issues);
+    normalizeStringField(config, "tech_stack.frontend.version", issues);
+    normalizeStringArrayField(config, "scope.backend", issues);
+    normalizeStringArrayField(config, "scope.frontend", issues);
+    normalizeRepoScopes(config, issues);
+    return { config, issues };
+}
+function hashValue(value) {
+    return crypto.createHash("sha256").update(JSON.stringify(value)).digest("hex").slice(0, 16);
+}
+function buildEvidencePayload(projectPath, config) {
+    const now = new Date().toISOString();
+    const fields = {};
+    const entries = [];
+    for (const fieldPath of EVIDENCE_FIELD_PATHS) {
+        const value = getField(config, fieldPath);
+        if (value === undefined)
+            continue;
+        fields[fieldPath] = {
+            value,
+            confidence: "high",
+            confidence_source: "confirmed",
+            evidence: ["config repair"],
+        };
+        entries.push(createConfigEvidenceEntry(fieldPath, value, "confirmed_config", {
+            confidence: 1.0,
+            evidence_refs: ["config repair"],
+            confirmed_by: process.env.USER || "cli",
+        }));
+    }
+    return {
+        schema_version: 2,
+        generated_at: now,
+        updated_at: now,
+        mode: "repair",
+        project_root: projectPath,
+        fields,
+        entries,
+    };
+}
+function evidenceIssues(projectPath, configPath, evidencePath, config) {
+    const issues = [];
+    if (!fs.existsSync(evidencePath)) {
+        issues.push({
+            kind: "evidence_missing",
+            field_path: "config.evidence.json",
+            message_zh: "config.evidence.json 缺失，可根据当前 config.yaml 自动重签",
+        });
+        return issues;
+    }
+    try {
+        const configStat = fs.statSync(configPath);
+        const evidenceStat = fs.statSync(evidencePath);
+        if (configStat.mtimeMs > evidenceStat.mtimeMs) {
+            issues.push({
+                kind: "evidence_stale",
+                field_path: "config.evidence.json",
+                message_zh: "config.evidence.json 已过期，可根据当前 config.yaml 自动重签",
+            });
+        }
+    }
+    catch { }
+    try {
+        const raw = JSON.parse(fs.readFileSync(evidencePath, "utf-8"));
+        const fields = raw.fields ?? {};
+        for (const [fieldPath, field] of Object.entries(fields)) {
+            const actual = getField(config, fieldPath);
+            if (actual !== undefined && JSON.stringify(field.value) !== JSON.stringify(actual)) {
+                issues.push({
+                    kind: "evidence_mismatch",
+                    field_path: fieldPath,
+                    message_zh: `${fieldPath} 的 evidence 值与 config.yaml 不一致，可自动重签`,
+                    before: field.value,
+                    after: actual,
+                });
+            }
+        }
+    }
+    catch {
+        issues.push({
+            kind: "evidence_mismatch",
+            field_path: "config.evidence.json",
+            message_zh: "config.evidence.json 无法解析，可根据当前 config.yaml 自动重签",
+        });
+    }
+    return issues;
+}
+export function analyzeConfigRepair(projectPath) {
+    const configPath = path.join(projectPath, ".soloforge", "config.yaml");
+    const evidencePath = path.join(projectPath, ".soloforge", "config.evidence.json");
+    if (!fs.existsSync(configPath)) {
+        return {
+            project_path: projectPath,
+            config_path: configPath,
+            evidence_path: evidencePath,
+            config_exists: false,
+            parse_error: null,
+            issues: [],
+            normalized_config: null,
+            needs_repair: false,
+            auto_resolvable: false,
+        };
+    }
+    let parsed;
+    try {
+        parsed = YAML.parse(fs.readFileSync(configPath, "utf-8")) ?? {};
+    }
+    catch (error) {
+        return {
+            project_path: projectPath,
+            config_path: configPath,
+            evidence_path: evidencePath,
+            config_exists: true,
+            parse_error: error instanceof Error ? error.message : String(error),
+            issues: [],
+            normalized_config: null,
+            needs_repair: false,
+            auto_resolvable: false,
+        };
+    }
+    const normalized = normalizeMechanicalTypes(parsed);
+    const issues = [
+        ...normalized.issues,
+        ...evidenceIssues(projectPath, configPath, evidencePath, normalized.config),
+    ];
+    return {
+        project_path: projectPath,
+        config_path: configPath,
+        evidence_path: evidencePath,
+        config_exists: true,
+        parse_error: null,
+        issues,
+        normalized_config: normalized.config,
+        needs_repair: issues.length > 0,
+        auto_resolvable: issues.length > 0 && issues.every((issue) => issue.kind === "schema_type" || issue.kind === "evidence_missing" || issue.kind === "evidence_stale" || issue.kind === "evidence_mismatch"),
+    };
+}
+function backupFile(filePath, backupDir) {
+    if (!fs.existsSync(filePath))
+        return null;
+    fs.mkdirSync(backupDir, { recursive: true });
+    const stamp = new Date().toISOString().replace(/[-:TZ.]/g, "").slice(0, 14);
+    const backupPath = path.join(backupDir, `${path.basename(filePath)}.${stamp}.bak`);
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+export function repairProjectConfig(projectPath, options = {}) {
+    const analysis = analyzeConfigRepair(projectPath);
+    const backupPaths = [];
+    if (!analysis.config_exists || analysis.parse_error || !analysis.normalized_config || !analysis.needs_repair || options.dry_run) {
+        return { ...analysis, dry_run: !!options.dry_run, changed: false, backup_paths: backupPaths };
+    }
+    const backupDir = path.join(projectPath, ".soloforge", "config-backups");
+    const configBackup = backupFile(analysis.config_path, backupDir);
+    const evidenceBackup = backupFile(analysis.evidence_path, backupDir);
+    if (configBackup)
+        backupPaths.push(configBackup);
+    if (evidenceBackup)
+        backupPaths.push(evidenceBackup);
+    fs.writeFileSync(analysis.config_path, YAML.stringify(analysis.normalized_config), "utf-8");
+    fs.writeFileSync(analysis.evidence_path, JSON.stringify(buildEvidencePayload(projectPath, analysis.normalized_config), null, 2), "utf-8");
+    return { ...analysis, dry_run: false, changed: true, backup_paths: backupPaths };
+}
+//# sourceMappingURL=config_auto_repair.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Configuration Precedence Contract — Constants
+ *
+ * 优先级顺序、规则、过期规则、字段分类等常量。
+ */
+import type { ConfigSource, ConfigLifetime, ConfigPrecedenceRule, StaleRule } from "./types.js";
+export declare const PRECEDENCE_ORDER: ConfigSource[];
+/** 证据元数据来源 — 映射到规范解析来源 */
+export declare const EVIDENCE_SOURCE_MAP: Record<string, ConfigSource>;
+export declare const SOURCE_LIFETIME: Record<ConfigSource, ConfigLifetime>;
+export declare const PRECEDENCE_RULES: ConfigPrecedenceRule[];
+export declare const STALE_RULES: StaleRule[];
+/** C 类字段列表 — 仅允许人工确认写入，永不自动写入 */
+export declare const C_CLASS_FIELDS: string[];
+export declare const DEFAULT_CONFIG_FIELDS: string[];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIhG,eAAO,MAAM,gBAAgB,EAAE,YAAY,EAW1C,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAI5D,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CAWhE,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,EAiFlD,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,SAAS,EAsBlC,CAAC;AAIF,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,MAAM,EAalC,CAAC;AAIF,eAAO,MAAM,qBAAqB,UAIjC,CAAC"}

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

@@ -0,0 +1,166 @@
+/**
+ * Configuration Precedence Contract — Constants
+ *
+ * 优先级顺序、规则、过期规则、字段分类等常量。
+ */
+// ── 优先级顺序 (索引=排名, 数值越小优先级越高) ──
+export const PRECEDENCE_ORDER = [
+    "user_task",
+    "cli_flag",
+    "mcp_param",
+    "confirmed_config",
+    "project_policy",
+    "fingerprint",
+    "blueprint",
+    "product_profile",
+    "knowledge_default",
+    "global_default",
+];
+/** 证据元数据来源 — 映射到规范解析来源 */
+export const EVIDENCE_SOURCE_MAP = {
+    user_declared: "confirmed_config",
+    confirmed: "confirmed_config",
+    detected: "fingerprint",
+};
+export const SOURCE_LIFETIME = {
+    user_task: "task",
+    cli_flag: "single_invocation",
+    mcp_param: "single_invocation",
+    confirmed_config: "project_persistent",
+    project_policy: "project_persistent",
+    fingerprint: "task",
+    blueprint: "project_persistent",
+    product_profile: "global",
+    knowledge_default: "global",
+    global_default: "global",
+};
+// ── 优先级规则 ──
+export const PRECEDENCE_RULES = [
+    {
+        id: "pr-01",
+        higher_source: "user_task",
+        lower_source: "confirmed_config",
+        description: "用户本次指令优先于持久配置，但只在本次任务生效",
+        override_behavior: "selected",
+        requires_report: true,
+    },
+    {
+        id: "pr-02",
+        higher_source: "cli_flag",
+        lower_source: "confirmed_config",
+        description: "CLI 参数可临时覆盖 config，但不写入 config",
+        override_behavior: "selected",
+        requires_report: true,
+    },
+    {
+        id: "pr-03",
+        higher_source: "confirmed_config",
+        lower_source: "fingerprint",
+        description: "confirmed_config 优先于 fingerprint",
+        override_behavior: "overridden",
+        requires_report: true,
+    },
+    {
+        id: "pr-04",
+        higher_source: "confirmed_config",
+        lower_source: "product_profile",
+        description: "product_profile 只能补充默认，不覆盖用户确认配置",
+        override_behavior: "overridden",
+        requires_report: false,
+    },
+    {
+        id: "pr-05",
+        higher_source: "confirmed_config",
+        lower_source: "knowledge_default",
+        description: "knowledge_default 不能覆盖 config",
+        override_behavior: "overridden",
+        requires_report: false,
+    },
+    {
+        id: "pr-06",
+        higher_source: "fingerprint",
+        lower_source: "blueprint",
+        description: "fingerprint 优先于 blueprint，真实项目指纹出现后重新评估",
+        override_behavior: "overridden",
+        requires_report: true,
+    },
+    {
+        id: "pr-07",
+        higher_source: "fingerprint",
+        lower_source: "product_profile",
+        description: "fingerprint 优先于 product_profile 默认",
+        override_behavior: "overridden",
+        requires_report: false,
+    },
+    {
+        id: "pr-08",
+        higher_source: "fingerprint",
+        lower_source: "knowledge_default",
+        description: "fingerprint 优先于 knowledge_default",
+        override_behavior: "overridden",
+        requires_report: false,
+    },
+    {
+        id: "pr-09",
+        higher_source: "product_profile",
+        lower_source: "knowledge_default",
+        description: "product_profile 优先于 knowledge_default",
+        override_behavior: "overridden",
+        requires_report: false,
+    },
+    {
+        id: "pr-10",
+        higher_source: "knowledge_default",
+        lower_source: "global_default",
+        description: "knowledge_default 优先于 global_default",
+        override_behavior: "overridden",
+        requires_report: false,
+    },
+];
+// ── 过期/冲突规则 ──
+export const STALE_RULES = [
+    {
+        id: "stale-01",
+        trigger: "config_vs_fingerprint_mismatch",
+        severity: "warning",
+        description: "confirmed_config 与 fingerprint 冲突",
+        action: "不自动覆盖 confirmed_config，产生 stale/conflict report",
+    },
+    {
+        id: "stale-02",
+        trigger: "fingerprint_drift",
+        severity: "warning",
+        description: "fingerprint 发生变化（如 React→Vue），config 仍是旧值",
+        action: "产生 stale warning，不自动覆盖",
+    },
+    {
+        id: "stale-03",
+        trigger: "config_vs_blueprint_mismatch",
+        severity: "warning",
+        description: "blueprint 在空项目初期有效，真实项目指纹出现后应重新评估",
+        action: "提示重新评估，blueprint 降为 advisory",
+    },
+];
+// ── 字段分类写入规则 ──
+/** C 类字段列表 — 仅允许人工确认写入，永不自动写入 */
+export const C_CLASS_FIELDS = [
+    "product_mapping",
+    "delivery.auto_push",
+    "delivery.auto_pr",
+    "delivery.deploy",
+    "secrets",
+    "accounts",
+    "production_database",
+    "destructive_command_policy",
+    "external_integrations",
+    "compliance_policy",
+    "privacy_policy",
+    "core_knowledge_sovereignty",
+];
+// ── 默认配置字段 ──
+export const DEFAULT_CONFIG_FIELDS = [
+    "product_profile",
+    "tech_stack.backend.framework",
+    "tech_stack.frontend.framework",
+];
+//# sourceMappingURL=constants.js.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * Configuration Precedence Contract — Evidence Factory
+ *
+ * 证据工厂函数：创建配置值证据、配置证据条目、值哈希。
+ */
+import type { ConfigSource, ConfigValueEvidence, ConfigEvidenceEntry } from "./types.js";
+/** 创建配置值证据
+ * @param fieldPath - 字段路径
+ * @param value - 配置值
+ * @param source - 配置来源
+ * @param confidence - 置信度
+ * @param evidenceRef - 证据引用（可选）
+ * @returns 配置值证据
+ */
+export declare function createConfigValueEvidence(fieldPath: string, value: unknown, source: ConfigSource, confidence: number, evidenceRef?: string): ConfigValueEvidence;
+/** 创建配置证据条目
+ * @param fieldPath - 字段路径
+ * @param value - 配置值
+ * @param source - 配置来源
+ * @param options - 可选参数
+ * @param options.confidence - 置信度（可选，默认 1.0）
+ * @param options.evidence_refs - 证据引用列表（可选）
+ * @param options.confirmed_by - 确认者（可选）
+ * @param options.expires_at - 过期时间（可选）
+ * @returns 配置证据条目
+ */
+export declare function createConfigEvidenceEntry(fieldPath: string, value: unknown, source: ConfigSource, options?: {
+    confidence?: number;
+    evidence_refs?: string[];
+    confirmed_by?: string;
+    expires_at?: string;
+}): ConfigEvidenceEntry;
+/** 计算值的简易哈希
+ * @param value - 待哈希的值
+ * @returns 十六进制哈希字符串
+ */
+export declare function hashValue(value: unknown): string;
+//# sourceMappingURL=evidence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAKpB;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,mBAAmB,CASrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,mBAAmB,CAYrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGhD"}

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

@@ -0,0 +1,59 @@
+/**
+ * Configuration Precedence Contract — Evidence Factory
+ *
+ * 证据工厂函数：创建配置值证据、配置证据条目、值哈希。
+ */
+import crypto from "node:crypto";
+import { SOURCE_LIFETIME } from "./constants.js";
+// ── 证据工厂 ──
+/** 创建配置值证据
+ * @param fieldPath - 字段路径
+ * @param value - 配置值
+ * @param source - 配置来源
+ * @param confidence - 置信度
+ * @param evidenceRef - 证据引用（可选）
+ * @returns 配置值证据
+ */
+export function createConfigValueEvidence(fieldPath, value, source, confidence, evidenceRef) {
+    return {
+        field_path: fieldPath,
+        value,
+        source,
+        confidence,
+        evidence_ref: evidenceRef,
+        updated_at: new Date().toISOString(),
+    };
+}
+/** 创建配置证据条目
+ * @param fieldPath - 字段路径
+ * @param value - 配置值
+ * @param source - 配置来源
+ * @param options - 可选参数
+ * @param options.confidence - 置信度（可选，默认 1.0）
+ * @param options.evidence_refs - 证据引用列表（可选）
+ * @param options.confirmed_by - 确认者（可选）
+ * @param options.expires_at - 过期时间（可选）
+ * @returns 配置证据条目
+ */
+export function createConfigEvidenceEntry(fieldPath, value, source, options) {
+    return {
+        field_path: fieldPath,
+        value_hash: hashValue(value),
+        source,
+        confidence: options?.confidence ?? 1.0,
+        evidence_refs: options?.evidence_refs ?? [],
+        confirmed_by: options?.confirmed_by,
+        lifetime: SOURCE_LIFETIME[source],
+        collected_at: new Date().toISOString(),
+        expires_at: options?.expires_at,
+    };
+}
+/** 计算值的简易哈希
+ * @param value - 待哈希的值
+ * @returns 十六进制哈希字符串
+ */
+export function hashValue(value) {
+    const str = JSON.stringify(value);
+    return crypto.createHash("sha256").update(str).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=evidence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/evidence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAMjC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,aAAa;AAEb;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,KAAc,EACd,MAAoB,EACpB,UAAkB,EAClB,WAAoB;IAEpB,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,KAAK;QACL,MAAM;QACN,UAAU;QACV,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAiB,EACjB,KAAc,EACd,MAAoB,EACpB,OAKC;IAED,OAAO;QACL,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC;QAC5B,MAAM;QACN,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,GAAG;QACtC,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,EAAE;QAC3C,YAAY,EAAE,OAAO,EAAE,YAAY;QACnC,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC;QACjC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC5E,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Configuration Precedence Contract — Governance & Reporting
+ *
+ * 治理校验、中文解释、冲突报告、CLI 写入守卫。
+ */
+import type { ConfigSource, ConfigResolutionReport, ConfigEvidenceEntry, ConfigPrecedenceGovernanceFinding } from "./types.js";
+/** 列出所有配置优先级规则
+ * @returns 优先级规则数组
+ */
+export declare function listPrecedenceRules(): import("./types.js").ConfigPrecedenceRule[];
+/** 列出所有配置过期检测规则
+ * @returns 过期规则数组
+ */
+export declare function listStaleRules(): import("./types.js").StaleRule[];
+/** 判断来源是否可安全写入配置（非 CLI/MCP 临时参数）
+ * @param source - 配置来源
+ * @returns 是否可安全写入
+ */
+export declare function isCliWriteSafe(source: ConfigSource): boolean;
+/** 生成配置字段解析结果的中文解释
+ * @param report - 配置解析报告
+ * @returns 格式化的中文解释文本
+ */
+export declare function explainField(report: ConfigResolutionReport): string;
+/** 执行配置优先级治理校验
+ * @param reports - 配置解析报告列表
+ * @param entries - 配置证据条目列表
+ * @returns 治理发现列表
+ */
+export declare function validateConfigPrecedence(reports: ConfigResolutionReport[], entries: ConfigEvidenceEntry[]): ConfigPrecedenceGovernanceFinding[];
+//# sourceMappingURL=governance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.d.ts","sourceRoot":"","sources":["../../../../src/engine/config/config_precedence_contract/governance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EAEZ,sBAAsB,EACtB,mBAAmB,EACnB,iCAAiC,EAClC,MAAM,YAAY,CAAC;AAepB;;GAEG;AACH,wBAAgB,mBAAmB,gDAElC;AAED;;GAEG;AACH,wBAAgB,cAAc,qCAE7B;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE5D;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAqCnE;AAaD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,iCAAiC,EAAE,CAmKrC"}