autosnippet 3.3.7 → 3.3.8

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

@@ -19,6 +19,8 @@
  *   0-19:   死亡 → 跳过确认直接 deprecated
  */
 var _a;
+import { and, like, sql } from 'drizzle-orm';
+import { auditLogs } from '../../infrastructure/database/drizzle/schema.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 /* ────────────────────── Helpers ────────────────────── */
 /**
@@ -49,21 +51,27 @@ const SCORE_WEIGHTS = {
 };
 /* ────────────────────── Class ────────────────────── */
 export class DecayDetector {
-    #db;
+    #knowledgeRepo;
+    #edgeRepo;
+    #sourceRefRepo;
+    #drizzle;
     #signalBus;
     #logger = Logger.getInstance();
-    constructor(db, options = {}) {
-        this.#db = db;
+    constructor(knowledgeRepo, options = {}) {
+        this.#knowledgeRepo = knowledgeRepo;
+        this.#edgeRepo = options.knowledgeEdgeRepo ?? null;
+        this.#sourceRefRepo = options.sourceRefRepo ?? null;
+        this.#drizzle = options.drizzle ?? null;
         this.#signalBus = options.signalBus ?? null;
     }
     /**
      * 扫描所有 active 条目的衰退状态
      */
-    scanAll() {
-        const recipes = this.#loadActiveRecipes();
+    async scanAll() {
+        const recipes = await this.#loadActiveRecipes();
         const results = [];
         for (const recipe of recipes) {
-            const result = this.evaluate(recipe);
+            const result = await this.evaluate(recipe);
             results.push(result);
         }
         // 发射衰退信号
@@ -87,7 +95,7 @@ export class DecayDetector {
     /**
      * 评估单条 Recipe 的衰退状态
      */
-    evaluate(recipe) {
+    async evaluate(recipe) {
         const stats = _a.#parseStats(recipe.stats);
         const signals = [];
         const now = Date.now();
@@ -127,7 +135,7 @@ export class DecayDetector {
             });
         }
         // 策略 3: 符号漂移（由 ReverseGuard 提供，此处从 DB 查 drift 标记）
-        if (this.#hasSymbolDrift(recipe.id)) {
+        if (await this.#hasSymbolDrift(recipe.id)) {
             signals.push({
                 recipeId: recipe.id,
                 strategy: 'symbol_drift',
@@ -135,7 +143,7 @@ export class DecayDetector {
             });
         }
         // 策略 3b: 来源引用失效（由 SourceRefReconciler 填充 recipe_source_refs）
-        const staleRefCount = this.#getStaleSourceRefCount(recipe.id);
+        const staleRefCount = await this.#getStaleSourceRefCount(recipe.id);
         if (staleRefCount > 0) {
             signals.push({
                 recipeId: recipe.id,
@@ -144,7 +152,7 @@ export class DecayDetector {
             });
         }
         // 策略 4: 被取代（有 deprecated_by 关系指向更新版本）
-        if (this.#isSuperseded(recipe.id)) {
+        if (await this.#isSuperseded(recipe.id)) {
             signals.push({
                 recipeId: recipe.id,
                 strategy: 'superseded',
@@ -152,7 +160,7 @@ export class DecayDetector {
             });
         }
         // 计算 decayScore（staleRatio 影响 quality 维度）
-        const staleRatio = this.#getSourceRefStaleRatio(recipe.id);
+        const staleRatio = await 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 +
@@ -171,23 +179,24 @@ export class DecayDetector {
         };
     }
     /* ── Internal ── */
-    #loadActiveRecipes() {
+    async #loadActiveRecipes() {
         try {
-            const rows = this.#db
-                .prepare(`SELECT id, title, lifecycle, stats, quality, createdAt
-         FROM knowledge_entries
-         WHERE lifecycle = 'active'`)
-                .all();
-            return rows.map((r) => {
-                const qualityObj = _a.#parseQuality(r.quality);
+            const entries = await this.#knowledgeRepo.findAllByLifecycles(['active']);
+            return entries.map((e) => {
+                const qualityObj = typeof e.quality === 'object'
+                    ? {
+                        grade: e.quality.grade ?? null,
+                        score: e.quality.overall ?? null,
+                    }
+                    : _a.#parseQuality(null);
                 return {
-                    id: r.id,
-                    title: r.title,
-                    lifecycle: r.lifecycle,
-                    stats: r.stats ?? null,
+                    id: e.id,
+                    title: e.title,
+                    lifecycle: e.lifecycle,
+                    stats: typeof e.stats === 'object' ? JSON.stringify(e.stats) : null,
                     quality_grade: qualityObj.grade,
                     quality_score: qualityObj.score,
-                    created_at: r.createdAt !== undefined ? Number(r.createdAt) : null,
+                    created_at: e.createdAt ?? null,
                 };
             });
         }
@@ -240,61 +249,58 @@ export class DecayDetector {
         const authority = Math.min(1, authorityRaw / 100);
         return { freshness, usage, quality, authority };
     }
-    #hasSymbolDrift(recipeId) {
+    async #hasSymbolDrift(recipeId) {
         try {
-            // 查找 audit_logs 中 ReverseGuard 为此 recipe 发过 drift 信号
-            const row = this.#db
-                .prepare(`SELECT 1 FROM audit_logs
-         WHERE action LIKE '%ReverseGuard%'
-           AND json_extract(details, '$.target') = ?
-         LIMIT 1`)
-                .get(recipeId);
+            if (!this.#drizzle) {
+                return false;
+            }
+            const row = this.#drizzle
+                .select({ id: auditLogs.id })
+                .from(auditLogs)
+                .where(and(like(auditLogs.action, '%ReverseGuard%'), sql `json_extract(${auditLogs.operationData}, '$.target') = ${recipeId}`))
+                .limit(1)
+                .get();
             return !!row;
         }
         catch {
             return false;
         }
     }
-    #getStaleSourceRefCount(recipeId) {
+    async #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;
+            if (!this.#sourceRefRepo) {
+                return 0;
+            }
+            const refs = this.#sourceRefRepo.findByRecipeId(recipeId);
+            return refs.filter((r) => r.status === 'stale').length;
         }
         catch {
-            // recipe_source_refs 表可能不存在
             return 0;
         }
     }
-    /** stale / total 比率（0-1），无 ref 时返回 0（无惩罚） */
-    #getSourceRefStaleRatio(recipeId) {
+    async #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) {
+            if (!this.#sourceRefRepo) {
                 return 0;
             }
-            return row.stale / row.total;
+            const refs = this.#sourceRefRepo.findByRecipeId(recipeId);
+            if (refs.length === 0) {
+                return 0;
+            }
+            const stale = refs.filter((r) => r.status === 'stale').length;
+            return stale / refs.length;
         }
         catch {
             return 0;
         }
     }
-    #isSuperseded(recipeId) {
+    async #isSuperseded(recipeId) {
         try {
-            const row = this.#db
-                .prepare(`SELECT 1 FROM knowledge_edges
-         WHERE source_id = ? AND relation_type = 'deprecated_by'
-         LIMIT 1`)
-                .get(recipeId);
-            return !!row;
+            if (!this.#edgeRepo) {
+                return false;
+            }
+            const edges = await this.#edgeRepo.findByRelation(recipeId, 'recipe', 'deprecated_by');
+            return edges.length > 0;
         }
         catch {
             return false;

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

@@ -9,12 +9,7 @@
  */
 import type { ReportStore } from '../../infrastructure/report/ReportStore.js';
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
-interface DatabaseLike {
-    prepare(sql: string): {
-        all(...params: unknown[]): Record<string, unknown>[];
-        get(...params: unknown[]): Record<string, unknown> | undefined;
-    };
-}
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
 export type EnhancementType = 'missing_code_example' | 'low_adoption' | 'low_authority' | 'deprecated_reference';
 export interface EnhancementSuggestion {
     recipeId: string;
@@ -26,13 +21,12 @@ export interface EnhancementSuggestion {
 }
 export declare class EnhancementSuggester {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, options?: {
         signalBus?: SignalBus;
         reportStore?: ReportStore;
     });
     /**
      * 运行全部 4 种增强策略
      */
-    analyzeAll(): EnhancementSuggestion[];
+    analyzeAll(): Promise<EnhancementSuggestion[]>;
 }
-export {};

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

@@ -7,6 +7,7 @@
  *   ③ 同类知识中 authority 偏低 → 建议补充 whenClause
  *   ④ 关联 Recipe 已 deprecated → 建议检查引用是否过时
  */
+import { Lifecycle, PUBLISHED_LIFECYCLES } from '../../domain/knowledge/Lifecycle.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 /* ────────────────────── Constants ────────────────────── */
 const GUARD_HIT_THRESHOLD = 5;
@@ -14,24 +15,25 @@ const SEARCH_HIT_THRESHOLD = 10;
 const LOW_AUTHORITY_PERCENTILE = 0.25;
 /* ────────────────────── Class ────────────────────── */
 export class EnhancementSuggester {
-    #db;
+    #knowledgeRepo;
     #signalBus;
     #reportStore;
     #logger = Logger.getInstance();
-    constructor(db, options = {}) {
-        this.#db = db;
+    constructor(knowledgeRepo, options = {}) {
+        this.#knowledgeRepo = knowledgeRepo;
         this.#signalBus = options.signalBus ?? null;
         this.#reportStore = options.reportStore ?? null;
     }
     /**
      * 运行全部 4 种增强策略
      */
-    analyzeAll() {
+    async analyzeAll() {
+        const entries = await this.#knowledgeRepo.findAllByLifecycles(PUBLISHED_LIFECYCLES);
         const suggestions = [
-            ...this.#checkMissingCodeExamples(),
-            ...this.#checkLowAdoption(),
-            ...this.#checkLowAuthority(),
-            ...this.#checkDeprecatedReferences(),
+            ...this.#checkMissingCodeExamples(entries),
+            ...this.#checkLowAdoption(entries),
+            ...this.#checkLowAuthority(entries),
+            ...(await this.#checkDeprecatedReferences(entries)),
         ];
         if (this.#reportStore && suggestions.length > 0) {
             void this.#reportStore.write({
@@ -49,30 +51,20 @@ export class EnhancementSuggester {
         return suggestions;
     }
     /* ── Strategy ①: Guard 频繁命中但无 coreCode ── */
-    #checkMissingCodeExamples() {
-        const rows = this.#db
-            .prepare(`SELECT id, title, coreCode, stats
-       FROM knowledge_entries
-       WHERE lifecycle IN ('active', 'staging') AND kind = 'rule'`)
-            .all();
+    #checkMissingCodeExamples(entries) {
+        const rules = entries.filter((e) => e.kind === 'rule');
         const suggestions = [];
-        for (const row of rows) {
-            const hasCode = row.coreCode && row.coreCode.trim().length > 10;
+        for (const entry of rules) {
+            const hasCode = entry.coreCode && entry.coreCode.trim().length > 10;
             if (hasCode) {
                 continue;
             }
-            let stats = {};
-            try {
-                stats = JSON.parse(row.stats || '{}');
-            }
-            catch {
-                continue;
-            }
+            const stats = (entry.stats ?? {});
             const guardHits = stats.guardHits || 0;
             if (guardHits >= GUARD_HIT_THRESHOLD) {
                 suggestions.push({
-                    recipeId: row.id,
-                    title: row.title,
+                    recipeId: entry.id,
+                    title: entry.title,
                     type: 'missing_code_example',
                     description: `Guard 已命中 ${guardHits} 次但无代码示例，建议补充 coreCode 帮助开发者理解正确用法`,
                     priority: guardHits >= GUARD_HIT_THRESHOLD * 3 ? 'high' : 'medium',
@@ -83,27 +75,16 @@ export class EnhancementSuggester {
         return suggestions;
     }
     /* ── Strategy ②: Search 高频命中但 adoptions=0 ── */
-    #checkLowAdoption() {
-        const rows = this.#db
-            .prepare(`SELECT id, title, stats
-       FROM knowledge_entries
-       WHERE lifecycle IN ('active', 'staging')`)
-            .all();
+    #checkLowAdoption(entries) {
         const suggestions = [];
-        for (const row of rows) {
-            let stats = {};
-            try {
-                stats = JSON.parse(row.stats || '{}');
-            }
-            catch {
-                continue;
-            }
+        for (const entry of entries) {
+            const stats = (entry.stats ?? {});
             const searchHits = stats.searchHits || 0;
             const adoptions = stats.adoptions || 0;
             if (searchHits >= SEARCH_HIT_THRESHOLD && adoptions === 0) {
                 suggestions.push({
-                    recipeId: row.id,
-                    title: row.title,
+                    recipeId: entry.id,
+                    title: entry.title,
                     type: 'low_adoption',
                     description: `搜索命中 ${searchHits} 次但采纳为 0，建议改善 usageGuide 或 whenClause 使知识更具可操作性`,
                     priority: searchHits >= SEARCH_HIT_THRESHOLD * 3 ? 'high' : 'medium',
@@ -114,28 +95,16 @@ export class EnhancementSuggester {
         return suggestions;
     }
     /* ── Strategy ③: 同类知识中 authority 偏低 ── */
-    #checkLowAuthority() {
-        const rows = this.#db
-            .prepare(`SELECT id, title, category, stats
-       FROM knowledge_entries
-       WHERE lifecycle IN ('active', 'staging')`)
-            .all();
-        // 按 category 分组计算 authority 分位
+    #checkLowAuthority(entries) {
         const byCategory = new Map();
-        for (const row of rows) {
-            let stats = {};
-            try {
-                stats = JSON.parse(row.stats || '{}');
-            }
-            catch {
-                continue;
-            }
+        for (const entry of entries) {
+            const stats = (entry.stats ?? {});
             const authority = stats.authority || 0;
-            const cat = row.category || 'general';
+            const cat = entry.category || 'general';
             if (!byCategory.has(cat)) {
                 byCategory.set(cat, []);
             }
-            byCategory.get(cat).push({ id: row.id, title: row.title, authority });
+            byCategory.get(cat)?.push({ id: entry.id, title: entry.title, authority });
         }
         const suggestions = [];
         for (const [category, entries] of byCategory) {
@@ -163,22 +132,10 @@ export class EnhancementSuggester {
         return suggestions;
     }
     /* ── Strategy ④: 关联 Recipe 已 deprecated ── */
-    #checkDeprecatedReferences() {
-        const rows = this.#db
-            .prepare(`SELECT id, title, relations
-       FROM knowledge_entries
-       WHERE lifecycle IN ('active', 'staging')`)
-            .all();
+    async #checkDeprecatedReferences(entries) {
         const suggestions = [];
-        for (const row of rows) {
-            let relations = {};
-            try {
-                relations = JSON.parse(row.relations || '{}');
-            }
-            catch {
-                continue;
-            }
-            // 检查 related, depends_on 等关系桶中的 ID
+        for (const entry of entries) {
+            const relations = (entry.relations ?? {});
             const relatedIds = [];
             for (const [bucket, ids] of Object.entries(relations)) {
                 if (bucket === 'deprecated_by') {
@@ -192,19 +149,18 @@ export class EnhancementSuggester {
                 continue;
             }
             // 批量检查关联条目的 lifecycle
-            const placeholders = relatedIds.map(() => '?').join(',');
-            const deprecated = this.#db
-                .prepare(`SELECT id, title FROM knowledge_entries WHERE id IN (${placeholders}) AND lifecycle = 'deprecated'`)
-                .all(...relatedIds);
-            for (const dep of deprecated) {
-                suggestions.push({
-                    recipeId: row.id,
-                    title: row.title,
-                    type: 'deprecated_reference',
-                    description: `引用了已废弃的 Recipe "${dep.title}" (${dep.id})，建议检查引用是否过时`,
-                    priority: 'high',
-                    evidence: [`referenced: ${dep.id}`, `referenced_title: ${dep.title}`],
-                });
+            for (const relId of relatedIds) {
+                const relEntry = await this.#knowledgeRepo.findById(relId);
+                if (relEntry && relEntry.lifecycle === Lifecycle.DEPRECATED) {
+                    suggestions.push({
+                        recipeId: entry.id,
+                        title: entry.title,
+                        type: 'deprecated_reference',
+                        description: `引用了已废弃的 Recipe "${relEntry.title}" (${relEntry.id})，建议检查引用是否过时`,
+                        priority: 'high',
+                        evidence: [`referenced: ${relEntry.id}`, `referenced_title: ${relEntry.title}`],
+                    });
+                }
             }
         }
         return suggestions;

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

@@ -68,17 +68,17 @@ export declare class KnowledgeMetabolism {
     /**
      * 执行完整治理周期
      */
-    runFullCycle(): MetabolismReport;
+    runFullCycle(): Promise<MetabolismReport>;
     /**
      * 只执行衰退扫描
      */
-    checkDecay(): DecayScoreResult[];
+    checkDecay(): Promise<DecayScoreResult[]>;
     /**
      * 只执行矛盾检测
      */
-    checkContradictions(): ContradictionResult[];
+    checkContradictions(): Promise<ContradictionResult[]>;
     /**
      * 只执行冗余分析
      */
-    checkRedundancy(): RedundancyResult[];
+    checkRedundancy(): Promise<RedundancyResult[]>;
 }