autosnippet 3.3.3 → 3.3.5

package/dist/lib/repository/evolution/ProposalRepository.js

@@ -0,0 +1,255 @@
+/**
+ * ProposalRepository — evolution_proposals 表 CRUD
+ *
+ * 操作 evolution_proposals 表，存储进化提案（merge/supersede/enhance/deprecate/
+ * reorganize/contradiction/correction）。
+ *
+ * 设计要求：
+ *   - 去重：同 target + 同 type 不允许多个 observing 状态的 Proposal
+ *   - Rate Limit：同一 target 不允许同时存在多个相同类型的 observing Proposal
+ *   - JSON 字段（evidence/related_recipe_ids）序列化/反序列化
+ */
+import { randomBytes } from 'node:crypto';
+/* ────────────────────── Constants ────────────────────── */
+/** 默认观察窗口：7 天 */
+const DEFAULT_OBSERVATION_WINDOW = 7 * 24 * 60 * 60 * 1000;
+/** 各 Proposal 类型的默认观察窗口（ms） */
+const OBSERVATION_WINDOWS = {
+    enhance: 48 * 60 * 60 * 1000, // 48h
+    correction: 24 * 60 * 60 * 1000, // 24h
+    merge: 72 * 60 * 60 * 1000, // 72h
+    supersede: 72 * 60 * 60 * 1000, // 72h
+    deprecate: 7 * 24 * 60 * 60 * 1000, // 7d
+    contradiction: 7 * 24 * 60 * 60 * 1000, // 7d
+    reorganize: 7 * 24 * 60 * 60 * 1000, // 7d
+};
+/** 自动进入观察状态的置信度阈值 */
+const AUTO_OBSERVE_THRESHOLDS = {
+    enhance: 0.7,
+    correction: 0.7,
+    merge: 0.75,
+    supersede: 0.8,
+    deprecate: 0.0, // decayScore ≤ 40 即可
+    contradiction: Infinity, // 需开发者确认
+    reorganize: Infinity, // 需开发者确认
+};
+/* ────────────────────── Class ────────────────────── */
+export class ProposalRepository {
+    #db;
+    constructor(db) {
+        this.#db = db;
+    }
+    /* ═══════════════════ Create ═══════════════════ */
+    /**
+     * 创建 Proposal 并写入 DB。
+     *
+     * - 自动生成 ID（ep-{timestamp}-{random}）
+     * - 自动设定 expiresAt（按 type 默认窗口）
+     * - 自动判断 status（低风险 + 高置信度 → observing，否则 pending）
+     * - 去重：同 target + 同 type 已有 pending/observing 时拒绝创建
+     */
+    create(input) {
+        const now = Date.now();
+        // 去重检查
+        if (this.#hasDuplicate(input.targetRecipeId, input.type)) {
+            return null;
+        }
+        const id = ProposalRepository.#generateId(now);
+        const expiresAt = input.expiresAt ?? now + (OBSERVATION_WINDOWS[input.type] ?? DEFAULT_OBSERVATION_WINDOW);
+        const status = input.status ?? this.#resolveInitialStatus(input.type, input.confidence);
+        const record = {
+            id,
+            type: input.type,
+            targetRecipeId: input.targetRecipeId,
+            relatedRecipeIds: input.relatedRecipeIds ?? [],
+            confidence: input.confidence,
+            source: input.source,
+            description: input.description,
+            evidence: input.evidence ?? [],
+            status,
+            proposedAt: now,
+            expiresAt,
+            resolvedAt: null,
+            resolvedBy: null,
+            resolution: null,
+        };
+        this.#db
+            .prepare(`INSERT INTO evolution_proposals
+         (id, type, target_recipe_id, related_recipe_ids, confidence, source, description, evidence, status, proposed_at, expires_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(record.id, record.type, record.targetRecipeId, JSON.stringify(record.relatedRecipeIds), record.confidence, record.source, record.description, JSON.stringify(record.evidence), record.status, record.proposedAt, record.expiresAt);
+        return record;
+    }
+    /* ═══════════════════ Read ═══════════════════ */
+    /** 按 ID 查询 */
+    findById(id) {
+        const row = this.#db.prepare(`SELECT * FROM evolution_proposals WHERE id = ?`).get(id);
+        return row ? ProposalRepository.#mapRow(row) : null;
+    }
+    /** 按条件查询 */
+    find(filter = {}) {
+        const conditions = [];
+        const params = [];
+        if (filter.status) {
+            if (Array.isArray(filter.status)) {
+                const placeholders = filter.status.map(() => '?').join(', ');
+                conditions.push(`status IN (${placeholders})`);
+                params.push(...filter.status);
+            }
+            else {
+                conditions.push('status = ?');
+                params.push(filter.status);
+            }
+        }
+        if (filter.type) {
+            conditions.push('type = ?');
+            params.push(filter.type);
+        }
+        if (filter.targetRecipeId) {
+            conditions.push('target_recipe_id = ?');
+            params.push(filter.targetRecipeId);
+        }
+        if (filter.source) {
+            conditions.push('source = ?');
+            params.push(filter.source);
+        }
+        if (filter.expiredBefore) {
+            conditions.push('expires_at <= ?');
+            params.push(filter.expiredBefore);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const rows = this.#db
+            .prepare(`SELECT * FROM evolution_proposals ${where} ORDER BY proposed_at DESC`)
+            .all(...params);
+        return rows.map(ProposalRepository.#mapRow);
+    }
+    /** 查询已到期的 observing 状态 Proposal */
+    findExpiredObserving() {
+        return this.find({
+            status: 'observing',
+            expiredBefore: Date.now(),
+        });
+    }
+    /** 查询所有未完成的 Proposal（pending + observing） */
+    findActive() {
+        return this.find({
+            status: ['pending', 'observing'],
+        });
+    }
+    /** 按 target Recipe ID 查询活跃 Proposal */
+    findByTarget(targetRecipeId) {
+        return this.find({
+            targetRecipeId,
+            status: ['pending', 'observing'],
+        });
+    }
+    /* ═══════════════════ Update ═══════════════════ */
+    /** 将 Proposal 状态转为 observing */
+    startObserving(id) {
+        const now = Date.now();
+        const proposal = this.findById(id);
+        if (!proposal || proposal.status !== 'pending') {
+            return false;
+        }
+        const expiresAt = now + (OBSERVATION_WINDOWS[proposal.type] ?? DEFAULT_OBSERVATION_WINDOW);
+        const result = this.#db
+            .prepare(`UPDATE evolution_proposals SET status = 'observing', expires_at = ? WHERE id = ? AND status = 'pending'`)
+            .run(expiresAt, id);
+        return result.changes > 0;
+    }
+    /** 标记 Proposal 为已执行 */
+    markExecuted(id, resolution, resolvedBy = 'auto') {
+        const result = this.#db
+            .prepare(`UPDATE evolution_proposals SET status = 'executed', resolved_at = ?, resolved_by = ?, resolution = ? WHERE id = ? AND status = 'observing'`)
+            .run(Date.now(), resolvedBy, resolution, id);
+        return result.changes > 0;
+    }
+    /** 标记 Proposal 为已拒绝 */
+    markRejected(id, resolution, resolvedBy = 'auto') {
+        const result = this.#db
+            .prepare(`UPDATE evolution_proposals SET status = 'rejected', resolved_at = ?, resolved_by = ?, resolution = ? WHERE id = ? AND status IN ('pending', 'observing')`)
+            .run(Date.now(), resolvedBy, resolution, id);
+        return result.changes > 0;
+    }
+    /** 标记 Proposal 为过期 */
+    markExpired(id) {
+        const result = this.#db
+            .prepare(`UPDATE evolution_proposals SET status = 'expired', resolved_at = ? WHERE id = ? AND status IN ('pending', 'observing')`)
+            .run(Date.now(), id);
+        return result.changes > 0;
+    }
+    /** 更新 evidence（用于追加观察期指标快照） */
+    updateEvidence(id, evidence) {
+        const result = this.#db
+            .prepare(`UPDATE evolution_proposals SET evidence = ? WHERE id = ?`)
+            .run(JSON.stringify(evidence), id);
+        return result.changes > 0;
+    }
+    /* ═══════════════════ Stats ═══════════════════ */
+    /** 统计各状态的 Proposal 数量 */
+    stats() {
+        const rows = this.#db
+            .prepare(`SELECT status, COUNT(*) as count FROM evolution_proposals GROUP BY status`)
+            .all();
+        const result = {
+            pending: 0,
+            observing: 0,
+            executed: 0,
+            rejected: 0,
+            expired: 0,
+        };
+        for (const row of rows) {
+            result[row.status] = row.count;
+        }
+        return result;
+    }
+    /* ═══════════════════ Private ═══════════════════ */
+    /** 去重检查：同 target + 同 type 是否已有 pending/observing Proposal */
+    #hasDuplicate(targetRecipeId, type) {
+        const row = this.#db
+            .prepare(`SELECT 1 FROM evolution_proposals WHERE target_recipe_id = ? AND type = ? AND status IN ('pending', 'observing') LIMIT 1`)
+            .get(targetRecipeId, type);
+        return row !== undefined;
+    }
+    /** 根据 type + confidence 判断初始状态 */
+    #resolveInitialStatus(type, confidence) {
+        const threshold = AUTO_OBSERVE_THRESHOLDS[type];
+        return confidence >= threshold ? 'observing' : 'pending';
+    }
+    /** 生成 Proposal ID */
+    static #generateId(timestamp) {
+        const rand = randomBytes(4).toString('hex');
+        return `ep-${timestamp}-${rand}`;
+    }
+    /** DB 行 → ProposalRecord */
+    static #mapRow(row) {
+        return {
+            id: row.id,
+            type: row.type,
+            targetRecipeId: row.target_recipe_id,
+            relatedRecipeIds: safeJsonParse(row.related_recipe_ids, []),
+            confidence: row.confidence,
+            source: row.source,
+            description: row.description,
+            evidence: safeJsonParse(row.evidence, []),
+            status: row.status,
+            proposedAt: row.proposed_at,
+            expiresAt: row.expires_at,
+            resolvedAt: row.resolved_at ?? null,
+            resolvedBy: row.resolved_by ?? null,
+            resolution: row.resolution ?? null,
+        };
+    }
+}
+/* ────────────────────── Util ────────────────────── */
+function safeJsonParse(json, fallback) {
+    if (!json) {
+        return fallback;
+    }
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return fallback;
+    }
+}

package/dist/lib/service/bootstrap/UiStartupTasks.d.ts

@@ -2,10 +2,12 @@
  * UiStartupTasks — asd ui 启动后异步后台刷新任务
  *
  * 在 Dashboard 启动后异步执行，不阻塞 UI:
- *   1. syncAll:          .md → DB 全量同步 + sourceRefs 对账
- *   2. staging promote:  到期 staging → active 晋升
- *   3. vector reconcile: 向量对账（best-effort）
- *   4. refreshIndex:     BM25 增量刷新
+ *   1. syncAll:               .md → DB 全量同步 + sourceRefs 对账
+ *   2. staging promote:       到期 staging → active 晋升
+ *   3. vector reconcile:      向量对账（best-effort）
+ *   4. refreshIndex:          BM25 增量刷新
+ *   5. proposalCheck:         到期 Proposal 检查 + 自动执行/拒绝
+ *   6. metabolismCycle:       知识新陈代谢（矛盾/冗余/衰退扫描 → 新 Proposal）
  */
 interface UiStartupContext {
     projectRoot: string;
@@ -34,6 +36,17 @@ export interface UiStartupReport {
         missing: number;
     };
     indexRefresh?: boolean;
+    proposalCheck?: {
+        executed: number;
+        rejected: number;
+        expired: number;
+    };
+    metabolismCycle?: {
+        proposalCount: number;
+        contradictions: number;
+        redundancies: number;
+        decaying: number;
+    };
     durationMs: number;
     errors: string[];
 }

package/dist/lib/service/bootstrap/UiStartupTasks.js

@@ -2,10 +2,12 @@
  * UiStartupTasks — asd ui 启动后异步后台刷新任务
  *
  * 在 Dashboard 启动后异步执行，不阻塞 UI:
- *   1. syncAll:          .md → DB 全量同步 + sourceRefs 对账
- *   2. staging promote:  到期 staging → active 晋升
- *   3. vector reconcile: 向量对账（best-effort）
- *   4. refreshIndex:     BM25 增量刷新
+ *   1. syncAll:               .md → DB 全量同步 + sourceRefs 对账
+ *   2. staging promote:       到期 staging → active 晋升
+ *   3. vector reconcile:      向量对账（best-effort）
+ *   4. refreshIndex:          BM25 增量刷新
+ *   5. proposalCheck:         到期 Proposal 检查 + 自动执行/拒绝
+ *   6. metabolismCycle:       知识新陈代谢（矛盾/冗余/衰退扫描 → 新 Proposal）
  */
 import Logger from '../../infrastructure/logging/Logger.js';
 const logger = Logger.getInstance();
@@ -20,7 +22,11 @@ export async function runUiStartupTasks(ctx) {
     // ── Stage 1: syncAll (.md → DB + sourceRefs reconcile) ──
     try {
         const { KnowledgeSyncService } = await import('../../cli/KnowledgeSyncService.js');
-        const syncService = new KnowledgeSyncService(ctx.projectRoot);
+        const { SourceRefReconciler } = await import('../../service/knowledge/SourceRefReconciler.js');
+        const sourceRefReconciler = ctx.container.singletons.sourceRefReconciler;
+        const syncService = new KnowledgeSyncService(ctx.projectRoot, {
+            sourceRefReconciler: sourceRefReconciler || undefined,
+        });
         const db = ctx.container.get('database');
         const rawDb = db.getDb();
         const syncReport = await syncService.syncAll(rawDb, { skipViolations: true });
@@ -93,6 +99,48 @@ export async function runUiStartupTasks(ctx) {
         report.errors.push(msg);
         logger.warn(`[UiStartupTasks] ${msg}`);
     }
+    // ── Stage 5: ProposalExecutor — 到期 Proposal 检查 + 自动执行 ──
+    try {
+        if (ctx.container.services.proposalExecutor) {
+            const executor = ctx.container.get('proposalExecutor');
+            const result = executor.checkAndExecute();
+            report.proposalCheck = {
+                executed: result.executed.length,
+                rejected: result.rejected.length,
+                expired: result.expired.length,
+            };
+            const total = result.executed.length + result.rejected.length + result.expired.length;
+            if (total > 0) {
+                logger.info(`[UiStartupTasks] Stage 5: proposal check — executed=${result.executed.length}, rejected=${result.rejected.length}, expired=${result.expired.length}`);
+            }
+        }
+    }
+    catch (err) {
+        const msg = `proposal check failed: ${err.message}`;
+        report.errors.push(msg);
+        logger.warn(`[UiStartupTasks] ${msg}`);
+    }
+    // ── Stage 6: KnowledgeMetabolism — 知识新陈代谢扫描 ──
+    try {
+        if (ctx.container.services.knowledgeMetabolism) {
+            const metabolism = ctx.container.get('knowledgeMetabolism');
+            const result = metabolism.runFullCycle();
+            report.metabolismCycle = {
+                proposalCount: result.summary.proposalCount,
+                contradictions: result.summary.contradictionCount,
+                redundancies: result.summary.redundancyCount,
+                decaying: result.summary.decayingCount,
+            };
+            if (result.summary.proposalCount > 0) {
+                logger.info(`[UiStartupTasks] Stage 6: metabolism cycle — ${result.summary.proposalCount} proposals generated`);
+            }
+        }
+    }
+    catch (err) {
+        const msg = `metabolism cycle failed: ${err.message}`;
+        report.errors.push(msg);
+        logger.warn(`[UiStartupTasks] ${msg}`);
+    }
     report.durationMs = Date.now() - start;
     logger.info(`[UiStartupTasks] All tasks completed in ${report.durationMs}ms`, {
         errors: report.errors.length,

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;
     });
     /**
      * 执行完整治理周期