soloforge 1.1.42 → 1.1.44

package/dist/context/knowledge/chinese_semantic_priority.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Chinese Semantic Priority — 知识层模块。
+ *
+ * 职责边界：
+ * - 负责：ZH_FIRST_DOMAINS 等 知识层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：管线知识阶段、知识注入
+ * 调用谁：knowledge_template_contracts、language_policy
+ *
+ * 数据流：项目文件 → 知识提取 → 结构化数据 → 注入管线
+ * 持久化：无持久化（纯计算/内存态）
+ */
+import type { LanguagePolicy } from "./knowledge_template_contracts.js";
+import type { LanguagePolicyConfig, SemanticPollutionFinding } from "./language_policy.js";
+export type { LanguagePolicyConfig, SemanticPollutionFinding };
+/** 必须中文优先的内容领域 */
+export declare const ZH_FIRST_DOMAINS: readonly ["business_semantics", "acceptance_criteria", "review_findings", "governance_contracts", "user_feedback"];
+/** 不强制中文化的内容领域 */
+export declare const PRESERVE_DOMAINS: readonly ["code_identifiers", "logs_and_errors", "api_docs", "commit_messages"];
+/** 语义检查结果 */
+export interface SemanticCheckResult {
+    domain: string;
+    passed: boolean;
+    policy: LanguagePolicy;
+    expected_language: "zh" | "en" | "preserve";
+    actual_language: "zh" | "en" | "mixed";
+    message_zh: string;
+}
+/** 语义优先评估结果 */
+export interface SemanticPriorityEvaluation {
+    compliant: boolean;
+    checks: SemanticCheckResult[];
+    pollution_findings: SemanticPollutionFinding[];
+    total_domains: number;
+    passing_domains: number;
+}
+/**
+ * 评估内容是否遵守中文语义优先策略。
+ * 硬规则：
+ * - zh_first 域内容必须中文优先
+ * - code_native 域不得翻译
+ * - source_preserving 域保持原文
+ * - en_allowed 域允许英文
+ */
+export declare function evaluateSemanticPriority(config: LanguagePolicyConfig, contents: Array<{
+    domain: string;
+    content: string;
+    id: string;
+}>): SemanticPriorityEvaluation;
+/**
+ * 验证中文项目不被英文模板污染。
+ * 硬规则：zh_first 项目的知识条目不得被英文模板默认值覆盖。
+ */
+export declare function validateZhProjectProtection(config: LanguagePolicyConfig, templateContent: string, targetDomain: string): {
+    protected: boolean;
+    reason?: string;
+};
+/**
+ * 验证英文项目可配置 en_allowed。
+ */
+export declare function validateEnProjectOverride(config: LanguagePolicyConfig): {
+    valid: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=chinese_semantic_priority.d.ts.map

package/dist/context/knowledge/chinese_semantic_priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chinese_semantic_priority.d.ts","sourceRoot":"","sources":["../../../src/context/knowledge/chinese_semantic_priority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,CAAC;AAI/D,kBAAkB;AAClB,eAAO,MAAM,gBAAgB,oHAMnB,CAAC;AAEX,kBAAkB;AAClB,eAAO,MAAM,gBAAgB,iFAKnB,CAAC;AAIX,aAAa;AACb,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,iBAAiB,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,CAAC;IAC5C,eAAe,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAe;AACf,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,kBAAkB,EAAE,wBAAwB,EAAE,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAID;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/D,0BAA0B,CA0C5B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAC5B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBzC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAKrC"}

package/dist/context/knowledge/chinese_semantic_priority.js

@@ -0,0 +1,157 @@
+/**
+ * Chinese Semantic Priority — 知识层模块。
+ *
+ * 职责边界：
+ * - 负责：ZH_FIRST_DOMAINS 等 知识层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：管线知识阶段、知识注入
+ * 调用谁：knowledge_template_contracts、language_policy
+ *
+ * 数据流：项目文件 → 知识提取 → 结构化数据 → 注入管线
+ * 持久化：无持久化（纯计算/内存态）
+ */
+// ── 中文优先范围 ──
+/** 必须中文优先的内容领域 */
+export const ZH_FIRST_DOMAINS = [
+    "business_semantics",
+    "acceptance_criteria",
+    "review_findings",
+    "governance_contracts",
+    "user_feedback",
+];
+/** 不强制中文化的内容领域 */
+export const PRESERVE_DOMAINS = [
+    "code_identifiers",
+    "logs_and_errors",
+    "api_docs",
+    "commit_messages",
+];
+// ── 核心函数 ──
+/**
+ * 评估内容是否遵守中文语义优先策略。
+ * 硬规则：
+ * - zh_first 域内容必须中文优先
+ * - code_native 域不得翻译
+ * - source_preserving 域保持原文
+ * - en_allowed 域允许英文
+ */
+export function evaluateSemanticPriority(config, contents) {
+    const checks = [];
+    const pollutionFindings = [];
+    for (const item of contents) {
+        const domainPolicy = getDomainPolicy(config, item.domain);
+        const expectedLang = getExpectedLanguage(domainPolicy);
+        const actualLang = detectLanguage(item.content);
+        const passed = checkLanguageCompliance(expectedLang, actualLang, domainPolicy);
+        checks.push({
+            domain: item.domain,
+            passed,
+            policy: domainPolicy,
+            expected_language: expectedLang,
+            actual_language: actualLang,
+            message_zh: passed
+                ? `${item.domain} 语义策略合规`
+                : `${item.domain} 语义策略违规：期望 ${expectedLang}，实际 ${actualLang}`,
+        });
+        if (!passed && expectedLang === "zh" && actualLang === "en") {
+            pollutionFindings.push({
+                id: `pollution-${item.id}`,
+                entry_id: item.id,
+                status: "polluted",
+                detected_language: actualLang,
+                expected_language: expectedLang,
+                message: `中文优先域 ${item.domain} 被英文内容污染: ${item.id}`,
+                remediation: "恢复中文语义或配置 en_allowed 策略",
+            });
+        }
+    }
+    const passingCount = checks.filter((c) => c.passed).length;
+    return {
+        compliant: checks.every((c) => c.passed),
+        checks,
+        pollution_findings: pollutionFindings,
+        total_domains: checks.length,
+        passing_domains: passingCount,
+    };
+}
+/**
+ * 验证中文项目不被英文模板污染。
+ * 硬规则：zh_first 项目的知识条目不得被英文模板默认值覆盖。
+ */
+export function validateZhProjectProtection(config, templateContent, targetDomain) {
+    if (config.default !== "zh_first") {
+        return { protected: true };
+    }
+    const domainPolicy = getDomainPolicy(config, targetDomain);
+    if (domainPolicy === "en_allowed" || domainPolicy === "code_native" || domainPolicy === "source_preserving") {
+        return { protected: true };
+    }
+    // zh_first 域检查模板是否英文
+    const templateLang = detectLanguage(templateContent);
+    if (templateLang === "en") {
+        return {
+            protected: false,
+            reason: `中文项目（zh_first）的 ${targetDomain} 域不得被英文模板污染`,
+        };
+    }
+    return { protected: true };
+}
+/**
+ * 验证英文项目可配置 en_allowed。
+ */
+export function validateEnProjectOverride(config) {
+    if (config.default === "en_first" || config.default === "source_preserving") {
+        return { valid: true };
+    }
+    return { valid: true };
+}
+// ── 辅助函数 ──
+function getDomainPolicy(config, domain) {
+    const domainMap = {
+        business_semantics: config.business_semantics,
+        acceptance_criteria: config.acceptance_criteria,
+        review_findings: config.review_findings,
+        governance_contracts: config.governance_contracts,
+        user_feedback: config.user_feedback,
+        code_comments: config.code_comments,
+        api_docs: config.api_docs,
+        commit_messages: config.commit_messages,
+        logs_and_errors: config.logs_and_errors,
+        code_identifiers: config.code_identifiers,
+    };
+    return domainMap[domain] ?? config.business_semantics;
+}
+function getExpectedLanguage(policy) {
+    switch (policy) {
+        case "zh_first": return "zh";
+        case "en_allowed": return "en";
+        case "source_preserving":
+        case "code_native": return "preserve";
+        default: return "zh";
+    }
+}
+function detectLanguage(content) {
+    if (!content || content.length === 0)
+        return "en";
+    const chineseChars = (content.match(/[一-鿿]/g) ?? []).length;
+    const englishWords = (content.match(/[a-zA-Z]+/g) ?? []).length;
+    const total = chineseChars + englishWords;
+    if (total === 0)
+        return "en";
+    if (chineseChars / total > 0.6)
+        return "zh";
+    if (englishWords / total > 0.7)
+        return "en";
+    return "mixed";
+}
+function checkLanguageCompliance(expected, actual, _policy) {
+    if (expected === "preserve")
+        return true;
+    if (expected === "zh")
+        return actual === "zh" || actual === "mixed";
+    if (expected === "en")
+        return true;
+    return true;
+}
+//# sourceMappingURL=chinese_semantic_priority.js.map

package/dist/context/knowledge/chinese_semantic_priority.js.map

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

package/dist/context/knowledge/conflict_detector.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Conflict Detector — 知识配置层模块。
+ *
+ * 职责边界：
+ * - 负责：detectConflicts 等 知识配置层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：上层模块按需调用
+ * 调用谁：index、logger、helpers
+ *
+ * 数据流：输入 → detectConflicts 处理 → 输出
+ * 持久化：无持久化（纯计算/内存态）
+ */
+import type { KnowledgeEntry } from "../../types/index.js";
+/**
+ * 检测知识条目之间的冲突。
+ * @description 先保留旧的 type:when 重复检查，再按语义主题检测同一规则域中的互斥取值。
+ * @param entries - 待检测的知识条目列表
+ * @returns 包含冲突信息的数组，每项包含冲突的条目和冲突类型
+ */
+export declare function detectConflicts(entries: KnowledgeEntry[]): Array<{
+    entry: KnowledgeEntry;
+    issue: string;
+}>;
+/**
+ * 检测元数据冲突 — scope 交叉但 products 互斥的条目对。
+ * @description 遍历所有活跃条目，检查是否存在两个条目：
+ *              1. scope 有交集（任一条目的 scope 包含另一条的任意 scope 值）
+ *              2. products 互斥（双方 products 列表无交集且均非 "*"）
+ *              此类组合意味着：在交集 scope 下，不同产品会获得矛盾的知识指导。
+ * @param entries - 待检测的知识条目列表
+ * @returns 包含元数据冲突信息的数组
+ */
+export declare function detectMetadataConflicts(entries: KnowledgeEntry[]): Array<{
+    entry: KnowledgeEntry;
+    conflicting_entry: KnowledgeEntry;
+    issue: string;
+}>;
+//# sourceMappingURL=conflict_detector.d.ts.map

package/dist/context/knowledge/conflict_detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict_detector.d.ts","sourceRoot":"","sources":["../../../src/context/knowledge/conflict_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AA0E3D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA0C1G;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,iBAAiB,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwErJ"}

package/dist/context/knowledge/conflict_detector.js

@@ -0,0 +1,205 @@
+/**
+ * Conflict Detector — 知识配置层模块。
+ *
+ * 职责边界：
+ * - 负责：detectConflicts 等 知识配置层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：上层模块按需调用
+ * 调用谁：index、logger、helpers
+ *
+ * 数据流：输入 → detectConflicts 处理 → 输出
+ * 持久化：无持久化（纯计算/内存态）
+ */
+import { debug } from "../../shared/logger.js";
+import { safeMatchIndex } from "../../shared/helpers.js";
+const SEMANTIC_CONFLICT_RULES = [
+    {
+        group: "api_response_format",
+        topic_patterns: [/api|接口|响应|response/i],
+        values: [
+            { value: "ApiResponse", positive_patterns: [/统一(?:响应|返回)[^。\n]{0,24}\bApiResponse\b/i, /(?:必须|统一|采用|使用|标准为)[^。\n]{0,16}\bApiResponse\b/i] },
+            { value: "Result", positive_patterns: [/统一(?:响应|返回)[^。\n]{0,24}\bResult\b/i, /(?:必须|统一|采用|使用|标准为)[^。\n]{0,16}\bResult\b/i] },
+            { value: "ResponseEntity", positive_patterns: [/统一(?:响应|返回)[^。\n]{0,24}\bResponseEntity\b/i, /(?:必须|统一|采用|使用|标准为)[^。\n]{0,16}\bResponseEntity\b/i] },
+        ],
+    },
+    {
+        group: "pagination_format",
+        topic_patterns: [/分页|pagination|page/i],
+        values: [
+            { value: "page_size", positive_patterns: [/分页(?:参数|请求|接口)[^。\n]{0,32}(?:统一|采用|使用|标准为)[^。\n]{0,24}(?:pageSize|page_size|page\/size|page\s*\+\s*size)/i] },
+            { value: "limit_offset", positive_patterns: [/分页(?:参数|请求|接口)[^。\n]{0,32}(?:统一|采用|使用|标准为)[^。\n]{0,24}(?:limit\/offset|limit\s*\+\s*offset)/i] },
+        ],
+    },
+    {
+        group: "logging_correlation_field",
+        topic_patterns: [/日志|log|trace|request/i],
+        values: [
+            { value: "trace_id", positive_patterns: [/(?:日志|链路|请求)(?:字段|ID)?[^。\n]{0,24}(?:统一|采用|使用|标准为)[^。\n]{0,16}(?:traceId|trace_id)/i] },
+            { value: "request_id", positive_patterns: [/(?:日志|链路|请求)(?:字段|ID)?[^。\n]{0,24}(?:统一|采用|使用|标准为)[^。\n]{0,16}(?:requestId|request_id)/i] },
+        ],
+    },
+    {
+        group: "database_naming",
+        topic_patterns: [/数据库|表名|字段|database|table|column/i],
+        values: [
+            { value: "snake_case", positive_patterns: [/(?:数据库|表名|字段|table|column)[^。\n]{0,24}(?:统一|采用|使用|标准为)[^。\n]{0,16}(?:snake_case|下划线)/i] },
+            { value: "camelCase", positive_patterns: [/(?:数据库|表名|字段|table|column)[^。\n]{0,24}(?:统一|采用|使用|标准为)[^。\n]{0,16}(?:camelCase|驼峰)/i] },
+        ],
+    },
+    {
+        group: "permission_model",
+        topic_patterns: [/权限|permission|auth|租户/i],
+        values: [
+            { value: "rbac", positive_patterns: [/(?:权限|授权|permission|auth)[^。\n]{0,24}(?:统一|采用|使用|标准为)[^。\n]{0,16}(?:RBAC|角色)/i] },
+            { value: "abac", positive_patterns: [/(?:权限|授权|permission|auth)[^。\n]{0,24}(?:统一|采用|使用|标准为)[^。\n]{0,16}(?:ABAC|属性)/i] },
+        ],
+    },
+];
+function inferSemanticDecision(entry) {
+    const topicText = `${entry.name} ${entry.type} ${entry.triggers?.join(" ") ?? ""} ${entry.scope.join(" ")} ${entry.products.join(" ")} ${entry.tech_stack ?? ""}`;
+    const bodyText = `${topicText} ${entry.body ?? ""}`;
+    for (const rule of SEMANTIC_CONFLICT_RULES) {
+        if (!rule.topic_patterns.some((pattern) => pattern.test(topicText) || pattern.test(bodyText)))
+            continue;
+        const matched = rule.values.find((candidate) => {
+            for (const pattern of candidate.positive_patterns) {
+                for (const match of bodyText.matchAll(new RegExp(pattern.source, pattern.flags.includes("g") ? pattern.flags : `${pattern.flags}g`))) {
+                    const context = bodyText.slice(Math.max(0, safeMatchIndex(match) - 16), Math.min(bodyText.length, safeMatchIndex(match) + match[0].length + 16));
+                    if (/例如|如\s|比如|示例|不得|不要|禁止|不应|不能|避免/.test(context))
+                        continue;
+                    return true;
+                }
+            }
+            return false;
+        });
+        if (matched)
+            return { group: rule.group, value: matched.value };
+    }
+    return null;
+}
+/**
+ * 检测知识条目之间的冲突。
+ * @description 先保留旧的 type:when 重复检查，再按语义主题检测同一规则域中的互斥取值。
+ * @param entries - 待检测的知识条目列表
+ * @returns 包含冲突信息的数组，每项包含冲突的条目和冲突类型
+ */
+export function detectConflicts(entries) {
+    debug("冲突检测", "开始检测 — 条目数: " + entries.length);
+    const issues = [];
+    const activeEntries = entries.filter((e) => e.status === "active");
+    const whenMap = new Map();
+    for (const e of activeEntries) {
+        const triggerKey = e.triggers?.join(",") ?? "";
+        const key = `${e.type}:${triggerKey}`;
+        if (!whenMap.has(key))
+            whenMap.set(key, []);
+        whenMap.get(key).push(e);
+    }
+    for (const [, grouped] of whenMap) {
+        if (grouped.length > 1) {
+            for (const e of grouped) {
+                issues.push({ entry: e, issue: "conflict" });
+            }
+        }
+    }
+    const semanticMap = new Map();
+    for (const entry of activeEntries) {
+        const decision = inferSemanticDecision(entry);
+        if (!decision)
+            continue;
+        const grouped = semanticMap.get(decision.group) ?? [];
+        grouped.push({ entry, value: decision.value });
+        semanticMap.set(decision.group, grouped);
+    }
+    for (const [group, grouped] of semanticMap) {
+        const values = new Set(grouped.map((item) => item.value));
+        if (values.size <= 1)
+            continue;
+        for (const item of grouped) {
+            issues.push({
+                entry: item.entry,
+                issue: `semantic_conflict:${group}:${Array.from(values).join("/")}`,
+            });
+        }
+    }
+    return issues;
+}
+/**
+ * 检测元数据冲突 — scope 交叉但 products 互斥的条目对。
+ * @description 遍历所有活跃条目，检查是否存在两个条目：
+ *              1. scope 有交集（任一条目的 scope 包含另一条的任意 scope 值）
+ *              2. products 互斥（双方 products 列表无交集且均非 "*"）
+ *              此类组合意味着：在交集 scope 下，不同产品会获得矛盾的知识指导。
+ * @param entries - 待检测的知识条目列表
+ * @returns 包含元数据冲突信息的数组
+ */
+export function detectMetadataConflicts(entries) {
+    debug("元数据冲突检测", "开始检测 — 条目数: " + entries.length);
+    const issues = [];
+    const activeEntries = entries.filter((e) => e.status === "active");
+    for (let i = 0; i < activeEntries.length; i++) {
+        for (let j = i + 1; j < activeEntries.length; j++) {
+            const a = activeEntries[i];
+            const b = activeEntries[j];
+            // 跳过同一条目（ID 相同视为同一条目）
+            if (a.id === b.id)
+                continue;
+            // 检查 scope 交叉
+            const aScopeSet = new Set(a.scope.map((s) => s.toLowerCase()));
+            const bScopeSet = new Set(b.scope.map((s) => s.toLowerCase()));
+            let scopeOverlap = false;
+            // 正向检查：a 的 scope 是否命中 b 的 scope 或通配符
+            for (const s of aScopeSet) {
+                if (bScopeSet.has(s) || s === "shared" || s === "*") {
+                    scopeOverlap = true;
+                    break;
+                }
+            }
+            // 反向检查：b 的 scope 是否包含通配符（shared/* 全局适用于所有 scope）
+            if (!scopeOverlap) {
+                for (const s of bScopeSet) {
+                    if (s === "shared" || s === "*") {
+                        scopeOverlap = true;
+                        break;
+                    }
+                }
+            }
+            if (!scopeOverlap)
+                continue;
+            // 检查 products 互斥（无交集且均非 "*"）
+            const aProductsSet = new Set(a.products.map((p) => p.toLowerCase()));
+            const bProductsSet = new Set(b.products.map((p) => p.toLowerCase()));
+            // 任一为 "*" 表示适用于所有产品，不算互斥
+            if (aProductsSet.has("*") || bProductsSet.has("*"))
+                continue;
+            // 存在交集则不互斥
+            let hasProductIntersection = false;
+            for (const p of aProductsSet) {
+                if (bProductsSet.has(p)) {
+                    hasProductIntersection = true;
+                    break;
+                }
+            }
+            if (hasProductIntersection)
+                continue;
+            // scope 交叉且 products 互斥 → 元数据冲突
+            const overlapScopes = [...aScopeSet].filter((s) => bScopeSet.has(s) || s === "shared" || s === "*");
+            issues.push({
+                entry: a,
+                conflicting_entry: b,
+                issue: `metadata_conflict:scope_overlap=[${overlapScopes.join(",")}]:products_disjoint`,
+            });
+            issues.push({
+                entry: b,
+                conflicting_entry: a,
+                issue: `metadata_conflict:scope_overlap=[${overlapScopes.join(",")}]:products_disjoint`,
+            });
+        }
+    }
+    if (issues.length > 0) {
+        debug("元数据冲突检测", `发现 ${issues.length / 2} 对元数据冲突。`);
+    }
+    return issues;
+}
+//# sourceMappingURL=conflict_detector.js.map

package/dist/context/knowledge/conflict_detector.js.map

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

package/dist/context/knowledge/documentation_governance.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Documentation Governance — 知识层模块。
+ *
+ * 职责边界：
+ * - 负责：DocGovernanceFinding 等 知识层职责
+ * - 不负责：不属于本模块的职责由对应模块承担
+ *
+ * 被谁调用：管线知识阶段、知识注入
+ * 调用谁：knowledge_template_contracts
+ *
+ * 数据流：项目文件 → 知识提取 → 结构化数据 → 注入管线
+ * 持久化：读写本地文件（详见代码内路径）
+ */
+import type { DocumentationArtifactPolicy, DesignDocEligibility } from "./knowledge_template_contracts.js";
+/** 文档治理发现 */
+export interface DocGovernanceFinding {
+    id: string;
+    severity: "hard_fail" | "warning" | "info";
+    rule: string;
+    artifact_type: DocumentationArtifactPolicy["artifact"];
+    message_zh: string;
+    evidence_ref?: string;
+}
+export declare const BUILTIN_ARTIFACT_POLICIES: DocumentationArtifactPolicy[];
+/**
+ * 校验设计文档准入资格。
+ *
+ * 只有 "verified" 或 "design_doc_eligible" 状态可以写入正式设计文档。
+ * "proposed" 或 "accepted_in_memo" 状态不得进入正式设计文档（硬拒绝）。
+ * 必须提供证据引用。
+ */
+export declare function validateDesignDocEligibility(eligibility: DesignDocEligibility): {
+    allowed: boolean;
+    reason: string;
+};
+/**
+ * 检查文档内容合规性 — 扫描禁止内容模式。
+ *
+ * 对每个匹配的禁止模式生成一条发现。
+ * 如果传入自定义 forbiddenPatterns，以自定义列表为准；
+ * 否则使用内置制品策略中该 artifact 类型的禁止列表。
+ */
+export declare function checkDocContentCompliance(artifactType: DocumentationArtifactPolicy["artifact"], content: string, forbiddenPatterns?: string[]): DocGovernanceFinding[];
+/**
+ * 检查注册表与设计文档之间的状态冲突。
+ *
+ * 注册表为事实源：如果注册表中某策略为 advisory（建议级），
+ * 但设计文档中声称该策略为 enforced（强制级），则产生硬拒绝发现。
+ */
+export declare function checkRegistryDesignDocConflict(registryState: string, designDocState: string): DocGovernanceFinding | null;
+/**
+ * 检查备忘录决策停滞 — accepted_in_memo 状态超过阈值未推进。
+ *
+ * 这些决策在备忘录中被接受，但长期未推进到 verified 或 design_doc_eligible，
+ * 可能意味着遗忘或阻塞，需要提醒开发者关注。
+ */
+export declare function checkAcceptedMemoStaleness(eligibilities: DesignDocEligibility[], staleThresholdDays: number): DocGovernanceFinding[];
+//# sourceMappingURL=documentation_governance.d.ts.map

package/dist/context/knowledge/documentation_governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation_governance.d.ts","sourceRoot":"","sources":["../../../src/context/knowledge/documentation_governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,oBAAoB,EAErB,MAAM,mCAAmC,CAAC;AAI3C,aAAa;AACb,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,eAAO,MAAM,yBAAyB,EAAE,2BAA2B,EAyDlE,CAAC;AAiBF;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,oBAAoB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6CtC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,2BAA2B,CAAC,UAAU,CAAC,EACrD,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAC3B,oBAAoB,EAAE,CAuBxB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,oBAAoB,GAAG,IAAI,CAsC7B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,oBAAoB,EAAE,EACrC,kBAAkB,EAAE,MAAM,GACzB,oBAAoB,EAAE,CAwDxB"}