soloforge 1.2.19 → 1.3.0

package/dist/engine/knowledge_consumption_snapshot.js

@@ -0,0 +1,113 @@
+/**
+ * Knowledge Consumption Snapshot — 问题五十七核心机制之三。
+ *
+ * 追踪知识资产在 prompt 构建过程中的消费路径：
+ * - 哪些资产被索引
+ * - 哪些资产被注入 prompt
+ * - 哪些资产被过滤及原因
+ * - 哪些资产被降级及原因
+ * - 冲突裁决结果
+ */
+// ── 核心函数 ──
+/**
+ * 创建知识消费快照。
+ */
+export function createKnowledgeConsumptionSnapshot(params) {
+    return {
+        build_id: params.build_id,
+        route: params.route,
+        indexed_assets: params.indexed_assets,
+        injected_assets: params.injected_assets,
+        filtered_assets: params.filtered_assets ?? [],
+        degraded_assets: params.degraded_assets ?? [],
+        conflict_resolutions: params.conflict_resolutions ?? [],
+        generated_at: new Date().toISOString(),
+        total_indexed: params.indexed_assets.length,
+        total_injected: params.injected_assets.length,
+        total_filtered: params.filtered_assets?.length ?? 0,
+        total_degraded: params.degraded_assets?.length ?? 0,
+    };
+}
+/**
+ * 验证消费快照的完整性。
+ * 必须包含 indexed/injected/filtered/degraded/conflict_resolutions 五个维度。
+ */
+export function validateConsumptionSnapshot(snapshot) {
+    const issues = [];
+    if (!snapshot.build_id)
+        issues.push("快照缺少 build_id");
+    if (!snapshot.route)
+        issues.push("快照缺少 route");
+    if (snapshot.indexed_assets.length === 0)
+        issues.push("无索引资产 — 知识索引构建可能失败");
+    if (snapshot.total_indexed === 0 && snapshot.total_injected === 0) {
+        issues.push("索引和注入均为空 — 知识系统可能未正常工作");
+    }
+    // 检查 filtered 是否有合法原因
+    for (const fa of snapshot.filtered_assets) {
+        if (!fa.reason) {
+            issues.push(`过滤资产 ${fa.asset_id} 缺少过滤原因`);
+        }
+    }
+    // 检查 degraded 是否有合法原因
+    for (const da of snapshot.degraded_assets) {
+        if (!da.reason) {
+            issues.push(`降级资产 ${da.asset_id} 缺少降级原因`);
+        }
+    }
+    // 检查 conflict_resolutions
+    for (const cr of snapshot.conflict_resolutions) {
+        if (!cr.reason) {
+            issues.push(`冲突裁决 winner=${cr.winner} 缺少原因`);
+        }
+    }
+    return {
+        passed: issues.length === 0,
+        issues,
+        snapshot,
+    };
+}
+/**
+ * 生成消费快照摘要文本。
+ */
+export function summarizeConsumptionSnapshot(snapshot) {
+    const parts = [];
+    parts.push(`知识消费快照: 索引 ${snapshot.total_indexed} 个, 注入 ${snapshot.total_injected} 个`);
+    if (snapshot.total_filtered > 0) {
+        parts.push(`过滤 ${snapshot.total_filtered} 个: ${snapshot.filtered_assets.map((f) => f.asset_id).join(", ")}`);
+    }
+    if (snapshot.total_degraded > 0) {
+        parts.push(`降级 ${snapshot.total_degraded} 个: ${snapshot.degraded_assets.map((d) => d.asset_id).join(", ")}`);
+    }
+    if (snapshot.conflict_resolutions.length > 0) {
+        parts.push(`冲突裁决 ${snapshot.conflict_resolutions.length} 项`);
+    }
+    return parts.join("; ");
+}
+/**
+ * 检查消费链路是否可追踪 — route/expander/verifier/adapter prompt 是否消费了标准字段。
+ */
+export function verifyConsumptionPaths(params) {
+    const requiredByComponent = {
+        "intent router": ["routes", "primary_triggers", "negative_triggers", "specificity"],
+        expander: ["authority", "priority", "required_evidence", "asset_kind"],
+        verifier: ["hard_blocks", "required_evidence", "fallback", "lifecycle_status"],
+        "adapter prompt": ["中文语义", "模板变量", "输出格式", "消费快照摘要"],
+        "sync migration": ["version", "schema", "hash", "user_modified", "migration_note"],
+    };
+    const missing = [];
+    for (const [component, required] of Object.entries(requiredByComponent)) {
+        const consumed = component === "intent router" ? params.intent_router_consumes
+            : component === "expander" ? params.expander_consumes
+                : component === "verifier" ? params.verifier_consumes
+                    : component === "adapter prompt" ? params.adapter_prompt_consumes
+                        : params.sync_migration_consumes;
+        for (const field of required) {
+            if (!consumed || !consumed.includes(field)) {
+                missing.push(`${component} 未消费必需字段: ${field}`);
+            }
+        }
+    }
+    return { passed: missing.length === 0, missing };
+}
+//# sourceMappingURL=knowledge_consumption_snapshot.js.map

package/dist/engine/knowledge_consumption_snapshot.js.map

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

package/dist/engine/knowledge_evolution.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 知识演进引擎 — 问题十四 (Evidence-based Knowledge Promotion)。
+ *
+ * 基于证据的知识晋级评估，包含候选信任分级、证据验证、
+ * 漂移分类和 AI 推理写入限制。
+ */
+import type { KnowledgeLifecycleStatus, KnowledgeSovereignty, KnowledgeEvidence, KnowledgePromotionReport, KnowledgeCandidateSource } from "./knowledge_template_contracts.js";
+/** 知识候选 — 等待晋级评估的知识条目 */
+export interface KnowledgeCandidate {
+    id: string;
+    source: KnowledgeCandidateSource;
+    scope: string;
+    product: string;
+    proposed_status: KnowledgeLifecycleStatus;
+    proposed_sovereignty: KnowledgeSovereignty;
+    evidence_ids: string[];
+    created_at: string;
+    drift_classified?: "knowledge_outdated" | "code_debt" | "ambiguous";
+}
+/** 漂移报告 */
+export interface DriftReport {
+    id: string;
+    entry_id: string;
+    classification: "knowledge_outdated" | "code_debt" | "ambiguous";
+    description_zh: string;
+    requires_human: boolean;
+}
+/**
+ * 评估知识候选来源的信任级别。
+ * 不同来源有不同的信任上限，决定该来源产生的知识能晋升到的最高状态。
+ *
+ * - senior_practice: 高信任，允许晋级到 pending_review（快速审查路径）
+ * - failure_analysis: 低信任，仅允许 draft（单次失败不足以产生高信任知识）
+ * - drift_detection: 低信任，必须生成漂移报告，不可直接修改 active/core 知识
+ * - repeated_success: 中信任，允许晋级到 pending_review
+ * - user_instruction: 中信任，允许晋级到 pending_review（active 仍需确认）
+ * - ai_inference: 低信任，仅允许 draft/quarantine，永远不可 active/core
+ */
+export declare function evaluateCandidateTrust(source: KnowledgeCandidateSource): {
+    trust_level: "high" | "medium" | "low";
+    allowed_max_status: KnowledgeLifecycleStatus;
+};
+/**
+ * 验证知识候选的证据是否充分。
+ *
+ * 规则：
+ * - 至少需要 1 条证据
+ * - 证据置信度必须 >= 0.5
+ * - core 主权必须有 user_confirmed 或 review_approved 类型的证据
+ * - 来源信任度必须足够支撑目标状态
+ */
+export declare function validatePromotionEvidence(candidate: KnowledgeCandidate, evidences: KnowledgeEvidence[]): {
+    sufficient: boolean;
+    missing: string[];
+};
+/**
+ * 创建知识晋级报告。
+ * 整合候选信息、证据和人工审批结果，生成标准晋级报告。
+ */
+export declare function createPromotionReport(candidate: KnowledgeCandidate, from_status: KnowledgeLifecycleStatus, from_sovereignty: KnowledgeSovereignty, evidences: KnowledgeEvidence[], human_approved_by?: string): KnowledgePromotionReport;
+/**
+ * 分类知识漂移。
+ * 对比知识内容和代码内容，判断漂移类型。
+ *
+ * - knowledge_outdated: 知识描述与当前代码行为不一致
+ * - code_debt: 代码未按已有知识规范执行
+ * - ambiguous: 无法确定是知识过时还是代码偏差
+ */
+export declare function classifyDrift(entry_id: string, knowledgeContent: string, codeContent: string): DriftReport;
+/**
+ * 验证 AI 推理写入权限。
+ * 硬规则：AI 推理只能创建 draft/quarantine 级别的知识，不能写入 core 或 active。
+ *
+ * - ai_inference 不可写入 sovereignty=core
+ * - ai_inference 不可设置 status=active
+ * - ai_inference 只能创建 draft/quarantine
+ */
+export declare function validateAiInferenceWrite(source: KnowledgeCandidateSource, target_sovereignty: KnowledgeSovereignty, target_status: KnowledgeLifecycleStatus): {
+    allowed: boolean;
+    reason: string;
+};
+//# sourceMappingURL=knowledge_evolution.d.ts.map

package/dist/engine/knowledge_evolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_evolution.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_evolution.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EAEzB,MAAM,mCAAmC,CAAC;AAK3C,yBAAyB;AACzB,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,wBAAwB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,wBAAwB,CAAC;IAC1C,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,oBAAoB,GAAG,WAAW,GAAG,WAAW,CAAC;CACrE;AAED,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,oBAAoB,GAAG,WAAW,GAAG,WAAW,CAAC;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAoCD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,wBAAwB,GAC/B;IAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAAC,kBAAkB,EAAE,wBAAwB,CAAA;CAAE,CAM1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,iBAAiB,EAAE,GAC7B;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAgD5C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,kBAAkB,EAC7B,WAAW,EAAE,wBAAwB,EACrC,gBAAgB,EAAE,oBAAoB,EACtC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,iBAAiB,CAAC,EAAE,MAAM,GACzB,wBAAwB,CAuC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,WAAW,CA8Cb;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,EAChC,kBAAkB,EAAE,oBAAoB,EACxC,aAAa,EAAE,wBAAwB,GACtC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkCtC"}

package/dist/engine/knowledge_evolution.js

@@ -0,0 +1,272 @@
+/**
+ * 知识演进引擎 — 问题十四 (Evidence-based Knowledge Promotion)。
+ *
+ * 基于证据的知识晋级评估，包含候选信任分级、证据验证、
+ * 漂移分类和 AI 推理写入限制。
+ */
+import { evaluatePromotion } from "./knowledge_lifecycle.js";
+// ── 来源信任级别映射 ──
+const SOURCE_TRUST_CONFIG = {
+    senior_practice: {
+        trust_level: "high",
+        allowed_max_status: "pending_review",
+    },
+    failure_analysis: {
+        trust_level: "low",
+        allowed_max_status: "draft",
+    },
+    drift_detection: {
+        trust_level: "low",
+        allowed_max_status: "draft",
+    },
+    repeated_success: {
+        trust_level: "medium",
+        allowed_max_status: "pending_review",
+    },
+    user_instruction: {
+        trust_level: "medium",
+        allowed_max_status: "pending_review",
+    },
+    ai_inference: {
+        trust_level: "low",
+        allowed_max_status: "draft",
+    },
+};
+// ── 核心函数 ──
+/**
+ * 评估知识候选来源的信任级别。
+ * 不同来源有不同的信任上限，决定该来源产生的知识能晋升到的最高状态。
+ *
+ * - senior_practice: 高信任，允许晋级到 pending_review（快速审查路径）
+ * - failure_analysis: 低信任，仅允许 draft（单次失败不足以产生高信任知识）
+ * - drift_detection: 低信任，必须生成漂移报告，不可直接修改 active/core 知识
+ * - repeated_success: 中信任，允许晋级到 pending_review
+ * - user_instruction: 中信任，允许晋级到 pending_review（active 仍需确认）
+ * - ai_inference: 低信任，仅允许 draft/quarantine，永远不可 active/core
+ */
+export function evaluateCandidateTrust(source) {
+    const config = SOURCE_TRUST_CONFIG[source];
+    return {
+        trust_level: config.trust_level,
+        allowed_max_status: config.allowed_max_status,
+    };
+}
+/**
+ * 验证知识候选的证据是否充分。
+ *
+ * 规则：
+ * - 至少需要 1 条证据
+ * - 证据置信度必须 >= 0.5
+ * - core 主权必须有 user_confirmed 或 review_approved 类型的证据
+ * - 来源信任度必须足够支撑目标状态
+ */
+export function validatePromotionEvidence(candidate, evidences) {
+    const missing = [];
+    // 检查 1: 至少需要 1 条证据
+    if (evidences.length === 0) {
+        missing.push("至少需要 1 条晋级证据");
+    }
+    // 检查 2: 证据置信度必须 >= 0.5
+    const lowConfidenceEvidence = evidences.filter((e) => e.confidence < 0.5);
+    if (lowConfidenceEvidence.length > 0) {
+        missing.push(`${lowConfidenceEvidence.length} 条证据置信度低于 0.5: ${lowConfidenceEvidence.map((e) => e.id).join(", ")}`);
+    }
+    // 检查 3: core 主权必须有 user_confirmed 或 review_approved 证据
+    if (candidate.proposed_sovereignty === "core") {
+        const hasHumanApproval = evidences.some((e) => e.source_type === "user_confirmed" || e.source_type === "review_approved");
+        if (!hasHumanApproval) {
+            missing.push("core 主权晋级必须包含 user_confirmed 或 review_approved 类型的证据");
+        }
+    }
+    // 检查 4: 来源信任度是否足够
+    const trust = evaluateCandidateTrust(candidate.source);
+    const statusHierarchy = [
+        "draft",
+        "quarantine",
+        "pending_review",
+        "active",
+        "deprecated",
+    ];
+    const candidateIndex = statusHierarchy.indexOf(candidate.proposed_status);
+    const maxIndex = statusHierarchy.indexOf(trust.allowed_max_status);
+    if (candidateIndex > maxIndex) {
+        missing.push(`来源 ${candidate.source} 信任不足，允许的最高状态为 ${trust.allowed_max_status}，目标状态为 ${candidate.proposed_status}`);
+    }
+    return {
+        sufficient: missing.length === 0,
+        missing,
+    };
+}
+/**
+ * 创建知识晋级报告。
+ * 整合候选信息、证据和人工审批结果，生成标准晋级报告。
+ */
+export function createPromotionReport(candidate, from_status, from_sovereignty, evidences, human_approved_by) {
+    // 构造晋级请求，复用 knowledge_lifecycle 的评估逻辑
+    const promotionRequest = {
+        entry_id: candidate.id,
+        from_status,
+        to_status: candidate.proposed_status,
+        from_sovereignty,
+        to_sovereignty: candidate.proposed_sovereignty,
+        evidence_ids: candidate.evidence_ids,
+        requested_by: mapSourceToRequester(candidate.source),
+    };
+    const result = evaluatePromotion(promotionRequest);
+    // 确定晋级状态
+    let promotion_status;
+    if (!result.allowed) {
+        promotion_status = "rejected";
+    }
+    else if (human_approved_by) {
+        promotion_status = "human_reviewed";
+    }
+    else if (evidences.length > 0) {
+        promotion_status = "evidence_gathered";
+    }
+    else {
+        promotion_status = "pending";
+    }
+    return {
+        entry_id: candidate.id,
+        from_status,
+        to_status: candidate.proposed_status,
+        from_sovereignty,
+        to_sovereignty: candidate.proposed_sovereignty,
+        evidence_ids: candidate.evidence_ids,
+        conflicts_checked: true,
+        product_scope_checked: true,
+        human_approved_by,
+        rollback_path: `${from_status}:${from_sovereignty}`,
+        promotion_status,
+    };
+}
+/**
+ * 分类知识漂移。
+ * 对比知识内容和代码内容，判断漂移类型。
+ *
+ * - knowledge_outdated: 知识描述与当前代码行为不一致
+ * - code_debt: 代码未按已有知识规范执行
+ * - ambiguous: 无法确定是知识过时还是代码偏差
+ */
+export function classifyDrift(entry_id, knowledgeContent, codeContent) {
+    // 提取关键标识：通过简单启发式比较内容差异
+    const knowledgeLines = knowledgeContent.split("\n").filter((l) => l.trim().length > 0);
+    const codeLines = codeContent.split("\n").filter((l) => l.trim().length > 0);
+    // 计算知识中引用的路径/模式在代码中的覆盖率
+    const knowledgePatterns = extractPatterns(knowledgeContent);
+    const codePatterns = extractPatterns(codeContent);
+    const matchedPatterns = knowledgePatterns.filter((p) => codePatterns.some((cp) => cp.includes(p) || p.includes(cp)));
+    const coverageRatio = knowledgePatterns.length > 0
+        ? matchedPatterns.length / knowledgePatterns.length
+        : 0;
+    let classification;
+    let description_zh;
+    let requires_human;
+    if (coverageRatio < 0.3) {
+        // 知识中的大部分模式在代码中找不到 — 知识过时
+        classification = "knowledge_outdated";
+        description_zh = `知识条目 ${entry_id} 与当前代码严重不一致（覆盖率 ${Math.round(coverageRatio * 100)}%），知识内容可能已过时`;
+        requires_human = true;
+    }
+    else if (coverageRatio > 0.7) {
+        // 代码中大部分模式在知识中存在 — 但仍有漂移，可能是代码偏差
+        classification = "code_debt";
+        description_zh = `知识条目 ${entry_id} 与代码基本一致（覆盖率 ${Math.round(coverageRatio * 100)}%），但存在代码未遵循知识规范的偏差`;
+        requires_human = false;
+    }
+    else {
+        // 覆盖率在中间 — 无法确定
+        classification = "ambiguous";
+        description_zh = `知识条目 ${entry_id} 与代码部分一致（覆盖率 ${Math.round(coverageRatio * 100)}%），无法确定是知识过时还是代码偏差，需人工裁决`;
+        requires_human = true;
+    }
+    return {
+        id: `drift-${entry_id}-${Date.now()}`,
+        entry_id,
+        classification,
+        description_zh,
+        requires_human,
+    };
+}
+/**
+ * 验证 AI 推理写入权限。
+ * 硬规则：AI 推理只能创建 draft/quarantine 级别的知识，不能写入 core 或 active。
+ *
+ * - ai_inference 不可写入 sovereignty=core
+ * - ai_inference 不可设置 status=active
+ * - ai_inference 只能创建 draft/quarantine
+ */
+export function validateAiInferenceWrite(source, target_sovereignty, target_status) {
+    // 仅对 ai_inference 来源执行硬性限制
+    if (source !== "ai_inference") {
+        return { allowed: true, reason: "非 AI 推理来源，不受此限制" };
+    }
+    // 规则 1: ai_inference 不可写入 sovereignty=core
+    if (target_sovereignty === "core") {
+        return {
+            allowed: false,
+            reason: "AI 推理不可将知识主权设为 core，core 知识只能由人工或高信任来源创建",
+        };
+    }
+    // 规则 2: ai_inference 不可设置 status=active
+    if (target_status === "active") {
+        return {
+            allowed: false,
+            reason: "AI 推理不可将知识状态设为 active，active 需要人工确认或充分证据晋级",
+        };
+    }
+    // 规则 3: ai_inference 只能创建 draft/quarantine
+    if (target_status !== "draft" && target_status !== "quarantine") {
+        return {
+            allowed: false,
+            reason: `AI 推理只能创建 draft/quarantine 状态的知识，目标状态 ${target_status} 不在允许范围内`,
+        };
+    }
+    return {
+        allowed: true,
+        reason: "AI 推理写入权限验证通过：sovereignty=normal, status=draft/quarantine",
+    };
+}
+// ── 内部辅助函数 ──
+/** 将候选来源映射为晋级请求的 requester 类型 */
+function mapSourceToRequester(source) {
+    switch (source) {
+        case "senior_practice":
+        case "repeated_success":
+        case "user_instruction":
+            return "human";
+        case "failure_analysis":
+        case "drift_detection":
+            return "drift_detection";
+        case "ai_inference":
+            return "ai_inference";
+    }
+}
+/**
+ * 从文本中提取关键模式（路径引用、函数名、类型名）。
+ * 简单启发式提取，用于漂移检测的内容对比。
+ */
+function extractPatterns(content) {
+    const patterns = new Set();
+    // 提取路径引用 (xxx/yyy 形式)
+    const pathMatches = content.match(/[\w./-]+\/[\w./-]+/g);
+    if (pathMatches) {
+        for (const p of pathMatches) {
+            if (p.length >= 4) {
+                patterns.add(p);
+            }
+        }
+    }
+    // 提取驼峰/蛇形标识符 (至少 4 个字符的单词级标识符)
+    const identMatches = content.match(/\b[a-zA-Z_][\w]{3,}\b/g);
+    if (identMatches) {
+        for (const id of identMatches) {
+            if (id.length >= 5) {
+                patterns.add(id);
+            }
+        }
+    }
+    return [...patterns];
+}
+//# sourceMappingURL=knowledge_evolution.js.map

package/dist/engine/knowledge_evolution.js.map

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

package/dist/engine/knowledge_lifecycle.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 知识生命周期管理 — 问题七 (Knowledge Lifecycle)。
+ *
+ * 管理知识条目的生命周期状态、主权和健康检查。
+ * - knowledge_lifecycle_status 使用规范字段名（draft/quarantine/active/pending_review/deprecated）
+ * - sovereignty 使用 normal / core（与问题正文和 Batch 1 一致）
+ * - staged 不再作为生命周期主状态，改为 knowledge_write_stage
+ * - core 不再作为生命周期状态，改为 sovereignty=core
+ */
+import type { KnowledgeLifecycleStatus, KnowledgeSovereignty, KnowledgeWriteStage, KnowledgeHealthFinding, KnowledgeEvidence } from "./knowledge_template_contracts.js";
+export type { KnowledgeLifecycleStatus, KnowledgeSovereignty, KnowledgeWriteStage };
+/** 知识条目 — 使用 knowledge_lifecycle_status，不使用泛称 state/status */
+export interface KnowledgeLifecycleEntry {
+    /** 条目 ID */
+    id: string;
+    /** 知识生命周期状态 — 使用 knowledge_lifecycle_status */
+    knowledge_lifecycle_status: KnowledgeLifecycleStatus;
+    /** 知识主权 — sovereignty: normal / core */
+    sovereignty: KnowledgeSovereignty;
+    /** 写入阶段 — staged / committed */
+    knowledge_write_stage: KnowledgeWriteStage;
+    /** 创建时间戳 */
+    created_at: string;
+    /** 最后更新时间戳 */
+    updated_at: string;
+    /** 内容摘要 */
+    content_summary?: string;
+    /** 来源路径 */
+    source_path?: string;
+}
+/** 晋级请求 */
+export interface PromotionRequest {
+    entry_id: string;
+    from_status: KnowledgeLifecycleStatus;
+    to_status: KnowledgeLifecycleStatus;
+    from_sovereignty: KnowledgeSovereignty;
+    to_sovereignty: KnowledgeSovereignty;
+    evidence_ids: string[];
+    requested_by: "ai_inference" | "drift_detection" | "human" | "sync_mechanism" | "user_instruction";
+}
+/** 晋级判定结果 */
+export interface PromotionResult {
+    allowed: boolean;
+    reason: string;
+    blocked_by?: string;
+    requires_human: boolean;
+}
+/**
+ * 评估知识晋级请求。
+ * 硬规则：
+ * - AI inference 不得直接晋级到 active/core
+ * - core 知识变更必须人工确认
+ * - draft/quarantine 不得自动晋级 active/core
+ * - 无 evidence 不得晋级
+ */
+export declare function evaluatePromotion(request: PromotionRequest): PromotionResult;
+/**
+ * 判断知识条目是否可注入。
+ * 硬规则：
+ * - active 可注入
+ * - draft/quarantine/deprecated 不注入
+ * - pending_review 默认不注入，advisory 例外
+ * - core + active 可注入
+ * - core + pending_review 不自动降级
+ */
+export declare function isInjectable(status: KnowledgeLifecycleStatus, sovereignty: KnowledgeSovereignty, advisory?: boolean): {
+    injectable: boolean;
+    reason: string;
+};
+/**
+ * 知识健康检查 — 覆盖 8 类 category。
+ */
+export declare function checkKnowledgeHealth(entries: KnowledgeLifecycleEntry[], evidenceMap: Map<string, KnowledgeEvidence[]>): KnowledgeHealthFinding[];
+/**
+ * 列出所有知识条目（空实现，实际由上层 knowledge loader 提供）。
+ */
+export declare function listKnowledgeEntries(): KnowledgeLifecycleEntry[];
+/**
+ * 从旧路径推断 sovereignty。
+ * patterns/core/ 下的旧知识默认推断为 sovereignty=core。
+ */
+export declare function inferSovereigntyFromPath(sourcePath: string): KnowledgeSovereignty;
+//# sourceMappingURL=knowledge_lifecycle.d.ts.map

package/dist/engine/knowledge_lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_lifecycle.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAI3C,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;AAEpF,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,0BAA0B,EAAE,wBAAwB,CAAC;IACrD,wCAAwC;IACxC,WAAW,EAAE,oBAAoB,CAAC;IAClC,gCAAgC;IAChC,qBAAqB,EAAE,mBAAmB,CAAC;IAC3C,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,wBAAwB,CAAC;IACtC,SAAS,EAAE,wBAAwB,CAAC;IACpC,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,cAAc,GAAG,iBAAiB,GAAG,OAAO,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;CACpG;AAED,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AA2BD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA6G5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,wBAAwB,EAChC,WAAW,EAAE,oBAAoB,EACjC,QAAQ,CAAC,EAAE,OAAO,GACjB;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA4BzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,EAAE,EAClC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,GAC5C,sBAAsB,EAAE,CAwE1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,uBAAuB,EAAE,CAEhE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAKjF"}