autosnippet 3.3.4 → 3.3.6

package/dist/lib/service/evolution/ContentPatcher.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ContentPatcher — Proposal suggestedChanges 消费引擎
+ *
+ * 核心职责：
+ *   1. 从 Proposal.evidence 提取 suggestedChanges
+ *   2. 解析为结构化 Patch（JSON 或降级为纯文本）
+ *   3. 创建 Recipe 内容快照（before）
+ *   4. 应用 patch 到 Recipe 字段
+ *   5. 创建快照（after）
+ *   6. 持久化更新
+ *
+ * 安全边界：
+ *   - 只修改 Patch 指定的字段，不擅自变更其他内容
+ *   - suggestedChanges 缺失或格式不合规时降级跳过（不阻塞状态转移）
+ *   - 所有变更在 before/after 快照中可追溯
+ *
+ * @module service/evolution/ContentPatcher
+ */
+import type { ContentPatchResult } from '../../types/evolution.js';
+interface DatabaseLike {
+    prepare(sql: string): {
+        all(...params: unknown[]): Record<string, unknown>[];
+        get(...params: unknown[]): Record<string, unknown> | undefined;
+        run(...params: unknown[]): {
+            changes: number;
+        };
+    };
+}
+export declare class ContentPatcher {
+    #private;
+    constructor(db: DatabaseLike);
+    /**
+     * 从 Proposal evidence 提取 suggestedChanges 并应用到 Recipe
+     *
+     * @returns ContentPatchResult — success: 是否成功应用了至少一个 patch
+     */
+    applyProposal(proposal: {
+        id: string;
+        type: string;
+        targetRecipeId: string;
+        evidence: Record<string, unknown>[];
+    }, patchSource?: 'agent-suggestion' | 'correction' | 'merge'): ContentPatchResult;
+}
+export {};

package/dist/lib/service/evolution/ContentPatcher.js

@@ -0,0 +1,310 @@
+/**
+ * ContentPatcher — Proposal suggestedChanges 消费引擎
+ *
+ * 核心职责：
+ *   1. 从 Proposal.evidence 提取 suggestedChanges
+ *   2. 解析为结构化 Patch（JSON 或降级为纯文本）
+ *   3. 创建 Recipe 内容快照（before）
+ *   4. 应用 patch 到 Recipe 字段
+ *   5. 创建快照（after）
+ *   6. 持久化更新
+ *
+ * 安全边界：
+ *   - 只修改 Patch 指定的字段，不擅自变更其他内容
+ *   - suggestedChanges 缺失或格式不合规时降级跳过（不阻塞状态转移）
+ *   - 所有变更在 before/after 快照中可追溯
+ *
+ * @module service/evolution/ContentPatcher
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+/* ────────────────────── Patchable Fields ────────────────────── */
+/** 允许 patch 的顶层字段白名单 */
+const PATCHABLE_FIELDS = new Set([
+    'coreCode',
+    'doClause',
+    'dontClause',
+    'whenClause',
+    'content.markdown',
+    'content.rationale',
+    'sourceRefs',
+    'headers',
+]);
+/* ────────────────────── Class ────────────────────── */
+export class ContentPatcher {
+    #db;
+    #logger = Logger.getInstance();
+    constructor(db) {
+        this.#db = db;
+    }
+    /**
+     * 从 Proposal evidence 提取 suggestedChanges 并应用到 Recipe
+     *
+     * @returns ContentPatchResult — success: 是否成功应用了至少一个 patch
+     */
+    applyProposal(proposal, patchSource = 'agent-suggestion') {
+        const recipeId = proposal.targetRecipeId;
+        // 1. 获取 Recipe 当前内容
+        const recipe = this.#getRecipe(recipeId);
+        if (!recipe) {
+            return this.#skipResult(recipeId, patchSource, 'Recipe not found');
+        }
+        // 2. 提取 suggestedChanges
+        const rawChanges = this.#extractSuggestedChanges(proposal.evidence);
+        if (!rawChanges) {
+            return this.#skipResult(recipeId, patchSource, 'No suggestedChanges in proposal evidence');
+        }
+        // 3. 解析为结构化 Patch
+        const patch = this.#parsePatch(rawChanges);
+        if (!patch || patch.changes.length === 0) {
+            return this.#skipResult(recipeId, patchSource, 'suggestedChanges could not be parsed or empty');
+        }
+        // 4. 创建 before 快照
+        const beforeSnapshot = this.#createSnapshot(recipe);
+        // 5. 应用 patch
+        const fieldsPatched = this.#applyPatch(recipe, patch.changes);
+        if (fieldsPatched.length === 0) {
+            return this.#skipResult(recipeId, patchSource, 'No valid fields to patch');
+        }
+        // 6. 持久化
+        this.#persistRecipe(recipe);
+        // 7. 创建 after 快照
+        const afterSnapshot = this.#createSnapshot(recipe);
+        this.#logger.info(`[ContentPatcher] Applied ${fieldsPatched.length} patches to recipe ${recipeId}: ${fieldsPatched.join(', ')}`);
+        return {
+            success: true,
+            recipeId,
+            fieldsPatched,
+            beforeSnapshot,
+            afterSnapshot,
+            patchSource,
+            skipped: false,
+        };
+    }
+    /* ═══════════════════ Extract ═══════════════════ */
+    #extractSuggestedChanges(evidence) {
+        for (const ev of evidence) {
+            const cast = ev;
+            if (cast.suggestedChanges &&
+                typeof cast.suggestedChanges === 'string' &&
+                cast.suggestedChanges.trim().length > 0) {
+                return cast.suggestedChanges;
+            }
+        }
+        return null;
+    }
+    /* ═══════════════════ Parse ═══════════════════ */
+    /**
+     * 解析 suggestedChanges — 优先 JSON，降级为纯文本全量替换
+     */
+    #parsePatch(raw) {
+        // 尝试 JSON 解析
+        const trimmed = raw.trim();
+        if (trimmed.startsWith('{')) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                if (parsed.changes && Array.isArray(parsed.changes)) {
+                    // JSON 有效但 changes 为空 → 视为无 patch
+                    if (parsed.changes.length === 0) {
+                        return null;
+                    }
+                    return {
+                        patchVersion: parsed.patchVersion ?? 1,
+                        changes: parsed.changes,
+                        reasoning: parsed.reasoning ?? '',
+                    };
+                }
+            }
+            catch {
+                // JSON 解析失败，降级到纯文本
+            }
+        }
+        // 降级：纯文本视为 content.markdown 全量替换（适用于旧格式 Agent 输出）
+        if (trimmed.length >= 20) {
+            return {
+                patchVersion: 1,
+                changes: [
+                    {
+                        field: 'content.markdown',
+                        action: 'replace',
+                        newValue: trimmed,
+                    },
+                ],
+                reasoning: 'Fallback: raw text treated as content.markdown replacement',
+            };
+        }
+        return null;
+    }
+    /* ═══════════════════ Apply ═══════════════════ */
+    #applyPatch(recipe, changes) {
+        const patched = [];
+        for (const change of changes) {
+            if (!PATCHABLE_FIELDS.has(change.field)) {
+                this.#logger.warn(`[ContentPatcher] Skipping non-patchable field: ${change.field}`);
+                continue;
+            }
+            const success = this.#applyOneChange(recipe, change);
+            if (success) {
+                patched.push(change.field);
+            }
+        }
+        return patched;
+    }
+    #applyOneChange(recipe, change) {
+        const { field, action } = change;
+        // content.* 嵌套字段
+        if (field.startsWith('content.')) {
+            return this.#applyContentChange(recipe, change);
+        }
+        // 顶层字段
+        if (field === 'sourceRefs' || field === 'headers') {
+            return this.#applyArrayChange(recipe, field, change);
+        }
+        // 简单字符串字段
+        const key = field;
+        if (action === 'replace' && change.newValue !== undefined) {
+            recipe[key] = change.newValue;
+            return true;
+        }
+        if (action === 'append' && change.newValue !== undefined) {
+            recipe[key] = `${recipe[key]}\n${change.newValue}`;
+            return true;
+        }
+        return false;
+    }
+    #applyContentChange(recipe, change) {
+        const contentObj = safeJsonParse(recipe.content, {});
+        const subField = change.field.split('.')[1]; // 'markdown' | 'rationale'
+        if (!subField) {
+            return false;
+        }
+        if (change.action === 'replace' && change.newValue !== undefined) {
+            contentObj[subField] = change.newValue;
+            recipe.content = JSON.stringify(contentObj);
+            return true;
+        }
+        if (change.action === 'replace-section' && change.section && change.newContent) {
+            const current = contentObj[subField] ?? '';
+            const updated = this.#replaceSection(current, change.section, change.newContent);
+            if (updated !== current) {
+                contentObj[subField] = updated;
+                recipe.content = JSON.stringify(contentObj);
+                return true;
+            }
+            return false;
+        }
+        if (change.action === 'append' && change.newValue !== undefined) {
+            const current = contentObj[subField] ?? '';
+            contentObj[subField] = `${current}\n${change.newValue}`;
+            recipe.content = JSON.stringify(contentObj);
+            return true;
+        }
+        return false;
+    }
+    #applyArrayChange(recipe, field, change) {
+        if (change.action === 'replace' && change.newValue !== undefined) {
+            try {
+                const newArr = JSON.parse(change.newValue);
+                if (Array.isArray(newArr)) {
+                    recipe[field] = JSON.stringify(newArr);
+                    return true;
+                }
+            }
+            catch {
+                // invalid JSON array
+            }
+            return false;
+        }
+        return false;
+    }
+    /**
+     * 替换 Markdown 中指定 section（基于标题行匹配）
+     */
+    #replaceSection(markdown, sectionTitle, newContent) {
+        const lines = markdown.split('\n');
+        const titleLine = lines.findIndex((line) => line.trim() === sectionTitle.trim());
+        if (titleLine === -1) {
+            // Section 不存在 → 追加
+            return `${markdown}\n\n${newContent}`;
+        }
+        // 找到 section 结尾（下一个同级或更高级标题）
+        const headingLevel = (sectionTitle.match(/^#+/) ?? [''])[0].length;
+        let endLine = lines.length;
+        for (let i = titleLine + 1; i < lines.length; i++) {
+            const match = lines[i].match(/^(#+)\s/);
+            if (match && match[1].length <= headingLevel) {
+                endLine = i;
+                break;
+            }
+        }
+        const before = lines.slice(0, titleLine);
+        const after = lines.slice(endLine);
+        return [...before, newContent, ...after].join('\n');
+    }
+    /* ═══════════════════ Snapshot ═══════════════════ */
+    #createSnapshot(recipe) {
+        const contentObj = safeJsonParse(recipe.content, {});
+        return {
+            coreCode: recipe.coreCode,
+            doClause: recipe.doClause,
+            dontClause: recipe.dontClause,
+            whenClause: recipe.whenClause,
+            content: {
+                markdown: contentObj.markdown ?? undefined,
+                rationale: contentObj.rationale ?? undefined,
+            },
+            sourceRefs: safeJsonParse(recipe.sourceRefs, []),
+            headers: safeJsonParse(recipe.headers, []),
+        };
+    }
+    /* ═══════════════════ DB ═══════════════════ */
+    #getRecipe(recipeId) {
+        const row = this.#db
+            .prepare(`SELECT id, title, coreCode, doClause, dontClause, whenClause, content, sourceRefs, headers
+         FROM knowledge_entries WHERE id = ?`)
+            .get(recipeId);
+        return row ?? null;
+    }
+    #persistRecipe(recipe) {
+        this.#db
+            .prepare(`UPDATE knowledge_entries
+         SET coreCode = ?, doClause = ?, dontClause = ?, whenClause = ?,
+             content = ?, sourceRefs = ?, headers = ?, updatedAt = ?
+         WHERE id = ?`)
+            .run(recipe.coreCode, recipe.doClause, recipe.dontClause, recipe.whenClause, recipe.content, recipe.sourceRefs, recipe.headers, Date.now(), recipe.id);
+    }
+    /* ═══════════════════ Helpers ═══════════════════ */
+    #skipResult(recipeId, patchSource, reason) {
+        this.#logger.info(`[ContentPatcher] Skipped for ${recipeId}: ${reason}`);
+        const emptySnapshot = {
+            coreCode: '',
+            doClause: '',
+            dontClause: '',
+            whenClause: '',
+            content: {},
+            sourceRefs: [],
+            headers: [],
+        };
+        return {
+            success: false,
+            recipeId,
+            fieldsPatched: [],
+            beforeSnapshot: emptySnapshot,
+            afterSnapshot: emptySnapshot,
+            patchSource,
+            skipped: true,
+            skipReason: reason,
+        };
+    }
+}
+/* ────────────────────── Util ────────────────────── */
+function safeJsonParse(json, fallback) {
+    if (!json) {
+        return fallback;
+    }
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return fallback;
+    }
+}

package/dist/lib/service/evolution/DecayDetector.d.ts

@@ -1,10 +1,11 @@
 /**
  * DecayDetector — 知识衰退检测 + 评分
  *
- * 5 种衰退检测策略（任一满足即触发 decaying 转换）：
+ * 6 种衰退检测策略（任一满足即触发 decaying 转换）：
  *   1. daysSinceLastHit > 90 — 90 天无使用
  *   2. ruleFalsePositiveRate > 0.4 && triggers > 10 — 规则已不准
  *   3. ReverseGuard: coreCode 引用的 API 符号已删除
+ *   3b. SourceRefReconciler: 来源文件路径失效（recipe_source_refs.status = stale）
  *   4. 同域新 Recipe 发布且 deprecated_by 关系指向它
  *   5. ContradictionDetector: 与更新的 Recipe 硬矛盾
  *
@@ -29,7 +30,7 @@ export interface DecaySignal {
     strategy: DecayStrategy;
     detail: string;
 }
-export type DecayStrategy = 'no_recent_usage' | 'high_false_positive' | 'symbol_drift' | 'superseded' | 'contradiction';
+export type DecayStrategy = 'no_recent_usage' | 'high_false_positive' | 'symbol_drift' | 'source_ref_stale' | 'superseded' | 'contradiction';
 export interface DecayScoreResult {
     recipeId: string;
     title: string;
@@ -52,7 +53,7 @@ interface RecipeForDecay {
     stats: string | null;
     quality_grade: string | null;
     quality_score: number | null;
-    created_at: string | null;
+    created_at: number | null;
 }
 export declare class DecayDetector {
     #private;

package/dist/lib/service/evolution/DecayDetector.js

@@ -1,10 +1,11 @@
 /**
  * DecayDetector — 知识衰退检测 + 评分
  *
- * 5 种衰退检测策略（任一满足即触发 decaying 转换）：
+ * 6 种衰退检测策略（任一满足即触发 decaying 转换）：
  *   1. daysSinceLastHit > 90 — 90 天无使用
  *   2. ruleFalsePositiveRate > 0.4 && triggers > 10 — 规则已不准
  *   3. ReverseGuard: coreCode 引用的 API 符号已删除
+ *   3b. SourceRefReconciler: 来源文件路径失效（recipe_source_refs.status = stale）
  *   4. 同域新 Recipe 发布且 deprecated_by 关系指向它
  *   5. ContradictionDetector: 与更新的 Recipe 硬矛盾
  *
@@ -17,7 +18,17 @@
  *   20-39:  严重 → Grace Period 缩短到 15d
  *   0-19:   死亡 → 跳过确认直接 deprecated
  */
+var _a;
 import Logger from '../../infrastructure/logging/Logger.js';
+/* ────────────────────── Helpers ────────────────────── */
+/**
+ * Normalize a timestamp to **milliseconds**.
+ * If the value looks like Unix seconds (< 1e12 ≈ year 2001 in ms), multiply by 1000.
+ * Otherwise assume it's already in ms and return as-is.
+ */
+function toMs(ts) {
+    return ts < 1e12 ? ts * 1000 : ts;
+}
 /* ────────────────────── Constants ────────────────────── */
 const DAY_MS = 24 * 60 * 60 * 1000;
 const GRACE_PERIOD_STANDARD = 30 * DAY_MS;
@@ -77,13 +88,13 @@ export class DecayDetector {
      * 评估单条 Recipe 的衰退状态
      */
     evaluate(recipe) {
-        const stats = DecayDetector.#parseStats(recipe.stats);
+        const stats = _a.#parseStats(recipe.stats);
         const signals = [];
         const now = Date.now();
         // 策略 1: 90 天无使用
         const lastHitAt = stats.lastHitAt ?? null;
         if (lastHitAt) {
-            const daysSince = (now - lastHitAt) / DAY_MS;
+            const daysSince = (now - toMs(lastHitAt)) / DAY_MS;
             if (daysSince > DECAY_THRESHOLDS.NO_USAGE_DAYS) {
                 signals.push({
                     recipeId: recipe.id,
@@ -93,8 +104,8 @@ export class DecayDetector {
             }
         }
         else {
-            // 无 lastHitAt，检查创建时间
-            const createdAt = recipe.created_at ? new Date(recipe.created_at).getTime() : now;
+            // 无 lastHitAt，检查创建时间（DB 可能存为秒或毫秒）
+            const createdAt = toMs(recipe.created_at ?? now);
             const daysSinceCreation = (now - createdAt) / DAY_MS;
             if (daysSinceCreation > DECAY_THRESHOLDS.NO_USAGE_DAYS) {
                 signals.push({
@@ -123,6 +134,15 @@ export class DecayDetector {
                 detail: 'ReverseGuard detected symbol drift in coreCode',
             });
         }
+        // 策略 3b: 来源引用失效（由 SourceRefReconciler 填充 recipe_source_refs）
+        const staleRefCount = this.#getStaleSourceRefCount(recipe.id);
+        if (staleRefCount > 0) {
+            signals.push({
+                recipeId: recipe.id,
+                strategy: 'source_ref_stale',
+                detail: `${staleRefCount} source reference(s) no longer exist on disk`,
+            });
+        }
         // 策略 4: 被取代（有 deprecated_by 关系指向更新版本）
         if (this.#isSuperseded(recipe.id)) {
             signals.push({
@@ -131,13 +151,14 @@ export class DecayDetector {
                 detail: 'Newer version exists via deprecated_by relation',
             });
         }
-        // 计算 decayScore
-        const dimensions = this.#computeScoreDimensions(stats, recipe);
+        // 计算 decayScore（staleRatio 影响 quality 维度）
+        const staleRatio = this.#getSourceRefStaleRatio(recipe.id);
+        const dimensions = this.#computeScoreDimensions(stats, recipe, { staleRatio });
         const decayScore = Math.round(dimensions.freshness * SCORE_WEIGHTS.freshness * 100 +
             dimensions.usage * SCORE_WEIGHTS.usage * 100 +
             dimensions.quality * SCORE_WEIGHTS.quality * 100 +
             dimensions.authority * SCORE_WEIGHTS.authority * 100);
-        const level = DecayDetector.#scoreToLevel(decayScore);
+        const level = _a.#scoreToLevel(decayScore);
         const suggestedGracePeriod = level === 'dead' ? 0 : level === 'severe' ? GRACE_PERIOD_SEVERE : GRACE_PERIOD_STANDARD;
         return {
             recipeId: recipe.id,
@@ -153,19 +174,22 @@ export class DecayDetector {
     #loadActiveRecipes() {
         try {
             const rows = this.#db
-                .prepare(`SELECT id, title, lifecycle, stats, quality_grade, quality_score, created_at
+                .prepare(`SELECT id, title, lifecycle, stats, quality, createdAt
          FROM knowledge_entries
          WHERE lifecycle = 'active'`)
                 .all();
-            return rows.map((r) => ({
-                id: r.id,
-                title: r.title,
-                lifecycle: r.lifecycle,
-                stats: r.stats ?? null,
-                quality_grade: r.quality_grade ?? null,
-                quality_score: r.quality_score !== undefined ? Number(r.quality_score) : null,
-                created_at: r.created_at ?? null,
-            }));
+            return rows.map((r) => {
+                const qualityObj = _a.#parseQuality(r.quality);
+                return {
+                    id: r.id,
+                    title: r.title,
+                    lifecycle: r.lifecycle,
+                    stats: r.stats ?? null,
+                    quality_grade: qualityObj.grade,
+                    quality_score: qualityObj.score,
+                    created_at: r.createdAt !== undefined ? Number(r.createdAt) : null,
+                };
+            });
         }
         catch {
             return [];
@@ -182,17 +206,35 @@ export class DecayDetector {
             return {};
         }
     }
-    #computeScoreDimensions(stats, recipe) {
+    static #parseQuality(qualityJson) {
+        if (!qualityJson) {
+            return { grade: null, score: null };
+        }
+        try {
+            const obj = JSON.parse(qualityJson);
+            return {
+                grade: typeof obj.grade === 'string' ? obj.grade : null,
+                score: typeof obj.overall === 'number' ? obj.overall : null,
+            };
+        }
+        catch {
+            return { grade: null, score: null };
+        }
+    }
+    #computeScoreDimensions(stats, recipe, context = {}) {
         const now = Date.now();
         // freshness: days since last hit → 0-1 (0 = 365+ days, 1 = today)
         const lastHit = stats.lastHitAt ?? 0;
-        const daysSinceHit = lastHit > 0 ? (now - lastHit) / DAY_MS : 365;
+        const daysSinceHit = lastHit > 0 ? (now - toMs(lastHit)) / DAY_MS : 365;
         const freshness = Math.max(0, 1 - daysSinceHit / 365);
         // usage: hitsLast90d 归一化 (0 = 0 hits, 1 = 50+ hits)
         const hitsLast90d = stats.hitsLast90d ?? 0;
         const usage = Math.min(1, hitsLast90d / 50);
-        // quality: qualityScore 直接使用
-        const quality = recipe.quality_score ?? 0.5;
+        // quality: qualityScore × sourceRef 健康度
+        // staleRatio 对 quality 打折，最多压低 30%（全部 stale → ×0.7）
+        const baseQuality = recipe.quality_score ?? 0.5;
+        const staleRatio = context.staleRatio ?? 0;
+        const quality = baseQuality * (1 - staleRatio * 0.3);
         // authority: from stats.authority 归一化 (0-100 → 0-1)
         const authorityRaw = stats.authority ?? 50;
         const authority = Math.min(1, authorityRaw / 100);
@@ -213,6 +255,38 @@ export class DecayDetector {
             return false;
         }
     }
+    #getStaleSourceRefCount(recipeId) {
+        try {
+            const row = this.#db
+                .prepare(`SELECT COUNT(*) AS cnt FROM recipe_source_refs
+         WHERE recipe_id = ? AND status = 'stale'`)
+                .get(recipeId);
+            return row?.cnt ?? 0;
+        }
+        catch {
+            // recipe_source_refs 表可能不存在
+            return 0;
+        }
+    }
+    /** stale / total 比率（0-1），无 ref 时返回 0（无惩罚） */
+    #getSourceRefStaleRatio(recipeId) {
+        try {
+            const row = this.#db
+                .prepare(`SELECT
+             SUM(CASE WHEN status = 'stale' THEN 1 ELSE 0 END) AS stale,
+             COUNT(*) AS total
+           FROM recipe_source_refs
+           WHERE recipe_id = ?`)
+                .get(recipeId);
+            if (!row || row.total === 0) {
+                return 0;
+            }
+            return row.stale / row.total;
+        }
+        catch {
+            return 0;
+        }
+    }
     #isSuperseded(recipeId) {
         try {
             const row = this.#db
@@ -242,3 +316,4 @@ export class DecayDetector {
         return 'dead';
     }
 }
+_a = DecayDetector;

package/dist/lib/service/evolution/KnowledgeMetabolism.d.ts

@@ -12,10 +12,11 @@
  */
 import type { ReportStore } from '../../infrastructure/report/ReportStore.js';
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
+import type { ProposalRepository } from '../../repository/evolution/ProposalRepository.js';
 import type { ContradictionDetector, ContradictionResult } from './ContradictionDetector.js';
 import type { DecayDetector, DecayScoreResult } from './DecayDetector.js';
 import type { RedundancyAnalyzer, RedundancyResult } from './RedundancyAnalyzer.js';
-export type ProposalType = 'merge' | 'enhance' | 'refine_guard' | 'split' | 'deprecate' | 'review';
+export type ProposalType = 'merge' | 'enhance' | 'deprecate' | 'contradiction' | 'correction';
 export interface EvolutionProposal {
     /** 进化提案类型 */
     type: ProposalType;
@@ -33,7 +34,7 @@ export interface EvolutionProposal {
     evidence: string[];
     /** 创建时间 */
     proposedAt: number;
-    /** 过期时间 (proposedAt + 7d) */
+    /** 过期时间 */
     expiresAt: number;
 }
 export interface MetabolismReport {
@@ -62,6 +63,7 @@ export declare class KnowledgeMetabolism {
         decayDetector: DecayDetector;
         signalBus?: SignalBus;
         reportStore?: ReportStore;
+        proposalRepository?: ProposalRepository;
     });
     /**
      * 执行完整治理周期

package/dist/lib/service/evolution/KnowledgeMetabolism.js

@@ -20,6 +20,7 @@ export class KnowledgeMetabolism {
     #decayDetector;
     #signalBus;
     #reportStore;
+    #proposalRepo;
     #logger = Logger.getInstance();
     #pendingTriggers = [];
     #debounceTimer = null;
@@ -29,6 +30,7 @@ export class KnowledgeMetabolism {
         this.#decayDetector = options.decayDetector;
         this.#signalBus = options.signalBus ?? null;
         this.#reportStore = options.reportStore ?? null;
+        this.#proposalRepo = options.proposalRepository ?? null;
         // Phase 2: 订阅告警型信号，触发代谢周期
         if (this.#signalBus) {
             this.#signalBus.subscribe('decay|quality|anomaly', (signal) => {
@@ -66,7 +68,31 @@ export class KnowledgeMetabolism {
             ...this.#proposalsFromRedundancies(redundancies),
             ...this.#proposalsFromDecay(decayResults),
         ];
-        // 5. 写入治理报告（降级：不再发射 Signal，改为 Report）
+        // 5. 持久化提案到 evolution_proposals 表
+        let persistedCount = 0;
+        if (this.#proposalRepo && proposals.length > 0) {
+            for (const p of proposals) {
+                const sourceMap = {
+                    contradiction: 'metabolism',
+                    redundancy: 'metabolism',
+                    decay: 'decay-scan',
+                    enhancement: 'metabolism',
+                };
+                const record = this.#proposalRepo.create({
+                    type: p.type,
+                    targetRecipeId: p.targetRecipeId,
+                    relatedRecipeIds: p.relatedRecipeIds,
+                    confidence: p.confidence,
+                    source: sourceMap[p.source] ?? 'metabolism',
+                    description: p.description,
+                    evidence: p.evidence.map((e) => ({ detail: e })),
+                });
+                if (record) {
+                    persistedCount++;
+                }
+            }
+        }
+        // 6. 写入治理报告（降级：同时写 ReportStore）
         if (this.#reportStore && proposals.length > 0) {
             void this.#reportStore.write({
                 category: 'governance',
@@ -74,6 +100,7 @@ export class KnowledgeMetabolism {
                 producer: 'KnowledgeMetabolism',
                 data: {
                     proposalCount: proposals.length,
+                    persistedCount,
                     contradictionCount: contradictions.length,
                     redundancyCount: redundancies.length,
                     decayingCount: decayResults.filter((d) => d.level !== 'healthy' && d.level !== 'watch')
@@ -121,7 +148,7 @@ export class KnowledgeMetabolism {
     #proposalsFromContradictions(results) {
         const now = Date.now();
         return results.map((r) => ({
-            type: r.type === 'hard' ? 'merge' : 'review',
+            type: r.type === 'hard' ? 'contradiction' : 'correction',
             targetRecipeId: r.recipeA,
             relatedRecipeIds: [r.recipeB],
             confidence: r.confidence,