autosnippet 3.3.6 → 3.3.8

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[]>;
 }

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

@@ -24,6 +24,7 @@ export class KnowledgeMetabolism {
     #logger = Logger.getInstance();
     #pendingTriggers = [];
     #debounceTimer = null;
+    #running = false;
     constructor(options) {
         this.#contradictionDetector = options.contradictionDetector;
         this.#redundancyAnalyzer = options.redundancyAnalyzer;
@@ -40,13 +41,17 @@ export class KnowledgeMetabolism {
         }
     }
     #scheduleMetabolism() {
+        // 当前正在执行周期时，忽略信号（防止自身产出的信号导致无限循环）
+        if (this.#running) {
+            return;
+        }
         if (this.#debounceTimer) {
             return;
         }
         this.#debounceTimer = setTimeout(() => {
             this.#debounceTimer = null;
-            if (this.#pendingTriggers.length > 0) {
-                this.runFullCycle();
+            if (this.#pendingTriggers.length > 0 && !this.#running) {
+                void this.runFullCycle();
                 this.#pendingTriggers = [];
             }
         }, 30_000);
@@ -54,95 +59,121 @@ export class KnowledgeMetabolism {
     /**
      * 执行完整治理周期
      */
-    runFullCycle() {
-        this.#logger.info('KnowledgeMetabolism: starting full governance cycle');
-        // 1. 衰退检测
-        const decayResults = this.#decayDetector.scanAll();
-        // 2. 矛盾检测
-        const contradictions = this.#contradictionDetector.detectAll();
-        // 3. 冗余分析
-        const redundancies = this.#redundancyAnalyzer.analyzeAll();
-        // 4. 生成进化提案
-        const proposals = [
-            ...this.#proposalsFromContradictions(contradictions),
-            ...this.#proposalsFromRedundancies(redundancies),
-            ...this.#proposalsFromDecay(decayResults),
-        ];
-        // 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++;
+    async runFullCycle() {
+        if (this.#running) {
+            this.#logger.warn('KnowledgeMetabolism: cycle already in progress, skipping');
+            return {
+                contradictions: [],
+                redundancies: [],
+                decayResults: [],
+                proposals: [],
+                summary: {
+                    totalScanned: 0,
+                    contradictionCount: 0,
+                    redundancyCount: 0,
+                    decayingCount: 0,
+                    proposalCount: 0,
+                },
+            };
+        }
+        this.#running = true;
+        // 清除执行期间积累的信号，避免周期结束后立刻再次触发
+        this.#pendingTriggers = [];
+        try {
+            this.#logger.info('KnowledgeMetabolism: starting full governance cycle');
+            // 1. 衰退检测
+            const decayResults = await this.#decayDetector.scanAll();
+            // 2. 矛盾检测
+            const contradictions = await this.#contradictionDetector.detectAll();
+            // 3. 冗余分析
+            const redundancies = await this.#redundancyAnalyzer.analyzeAll();
+            // 4. 生成进化提案
+            const proposals = [
+                ...this.#proposalsFromContradictions(contradictions),
+                ...this.#proposalsFromRedundancies(redundancies),
+                ...this.#proposalsFromDecay(decayResults),
+            ];
+            // 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',
-                type: 'metabolism_cycle',
-                producer: 'KnowledgeMetabolism',
-                data: {
-                    proposalCount: proposals.length,
-                    persistedCount,
+            // 6. 写入治理报告（降级：同时写 ReportStore）
+            if (this.#reportStore && proposals.length > 0) {
+                void this.#reportStore.write({
+                    category: 'governance',
+                    type: 'metabolism_cycle',
+                    producer: 'KnowledgeMetabolism',
+                    data: {
+                        proposalCount: proposals.length,
+                        persistedCount,
+                        contradictionCount: contradictions.length,
+                        redundancyCount: redundancies.length,
+                        decayingCount: decayResults.filter((d) => d.level !== 'healthy' && d.level !== 'watch')
+                            .length,
+                    },
+                    timestamp: Date.now(),
+                });
+            }
+            const report = {
+                contradictions,
+                redundancies,
+                decayResults,
+                proposals,
+                summary: {
+                    totalScanned: decayResults.length,
                     contradictionCount: contradictions.length,
                     redundancyCount: redundancies.length,
                     decayingCount: decayResults.filter((d) => d.level !== 'healthy' && d.level !== 'watch')
                         .length,
+                    proposalCount: proposals.length,
                 },
-                timestamp: Date.now(),
-            });
+            };
+            this.#logger.info(`KnowledgeMetabolism: cycle complete — ${report.summary.proposalCount} proposals generated`);
+            return report;
+        }
+        finally {
+            this.#running = false;
+            // 清除周期期间积累的信号，防止自身产出的信号立即触发下一轮
+            this.#pendingTriggers = [];
         }
-        const report = {
-            contradictions,
-            redundancies,
-            decayResults,
-            proposals,
-            summary: {
-                totalScanned: decayResults.length,
-                contradictionCount: contradictions.length,
-                redundancyCount: redundancies.length,
-                decayingCount: decayResults.filter((d) => d.level !== 'healthy' && d.level !== 'watch')
-                    .length,
-                proposalCount: proposals.length,
-            },
-        };
-        this.#logger.info(`KnowledgeMetabolism: cycle complete — ${report.summary.proposalCount} proposals generated`);
-        return report;
     }
     /**
      * 只执行衰退扫描
      */
-    checkDecay() {
-        return this.#decayDetector.scanAll();
+    async checkDecay() {
+        return await this.#decayDetector.scanAll();
     }
     /**
      * 只执行矛盾检测
      */
-    checkContradictions() {
-        return this.#contradictionDetector.detectAll();
+    async checkContradictions() {
+        return await this.#contradictionDetector.detectAll();
     }
     /**
      * 只执行冗余分析
      */
-    checkRedundancy() {
-        return this.#redundancyAnalyzer.analyzeAll();
+    async checkRedundancy() {
+        return await this.#redundancyAnalyzer.analyzeAll();
     }
     /* ── Proposal Generation ── */
     #proposalsFromContradictions(results) {

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

@@ -17,17 +17,10 @@
  */
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
 import type { ProposalRepository, ProposalType } from '../../repository/evolution/ProposalRepository.js';
+import type { KnowledgeEdgeRepositoryImpl } from '../../repository/knowledge/KnowledgeEdgeRepository.js';
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
 import type { ContentPatcher } from './ContentPatcher.js';
 import type { RecipeLifecycleSupervisor } from './RecipeLifecycleSupervisor.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;
@@ -51,16 +44,16 @@ export interface ProposalExecutionResult {
 }
 export declare class ProposalExecutor {
     #private;
-    constructor(db: DatabaseLike, repo: ProposalRepository, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, repo: ProposalRepository, options?: {
         signalBus?: SignalBus;
         contentPatcher?: ContentPatcher;
         supervisor?: RecipeLifecycleSupervisor;
+        knowledgeEdgeRepo?: KnowledgeEdgeRepositoryImpl;
     });
     /**
      * 定期调用（UiStartupTasks Stage 5）
      *
      * 扫描所有到期 Proposal → 评估 → 执行/拒绝/过期
      */
-    checkAndExecute(): ProposalExecutionResult;
+    checkAndExecute(): Promise<ProposalExecutionResult>;
 }
-export {};