autosnippet 3.3.4 → 3.3.5

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

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,

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

@@ -0,0 +1,62 @@
+/**
+ * ProposalExecutor — 到期自动执行引擎
+ *
+ * 核心职责：
+ *   1. 扫描所有 observing 状态的 Proposal，检查是否到期
+ *   2. 到期 → 收集观察期表现数据 → 评估执行判据
+ *   3. 通过 → 执行操作（merge/deprecate/enhance/...）
+ *   4. 不通过 → 拒绝 Proposal，Recipe 恢复原状态
+ *
+ * 触发时机：UiStartupTasks Stage 5
+ *
+ * 安全边界：
+ *   - Agent 只做分析，ProposalExecutor 做执行
+ *   - merge/enhance 执行后 Recipe → staging（走正常路径）
+ *   - contradiction/reorganize 始终等开发者确认（不自动执行）
+ *   - 到期无判据 → expired
+ */
+import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
+import type { ProposalRepository, ProposalType } from '../../repository/evolution/ProposalRepository.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 interface ProposalExecutionResult {
+    executed: {
+        id: string;
+        type: ProposalType;
+        targetRecipeId: string;
+    }[];
+    rejected: {
+        id: string;
+        type: ProposalType;
+        reason: string;
+    }[];
+    expired: {
+        id: string;
+        type: ProposalType;
+    }[];
+    skipped: {
+        id: string;
+        type: ProposalType;
+        reason: string;
+    }[];
+}
+export declare class ProposalExecutor {
+    #private;
+    constructor(db: DatabaseLike, repo: ProposalRepository, options?: {
+        signalBus?: SignalBus;
+    });
+    /**
+     * 定期调用（UiStartupTasks Stage 5）
+     *
+     * 扫描所有到期 Proposal → 评估 → 执行/拒绝/过期
+     */
+    checkAndExecute(): ProposalExecutionResult;
+}
+export {};