autosnippet 3.3.7 → 3.3.8

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

@@ -11,11 +11,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>[];
-    };
-}
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
 export interface RedundancyResult {
     recipeA: string;
     recipeB: string;
@@ -37,14 +33,14 @@ interface RecipeForRedundancy {
 }
 export declare class RedundancyAnalyzer {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, options?: {
         signalBus?: SignalBus;
         reportStore?: ReportStore;
     });
     /**
      * 分析所有 active/staging 条目之间的冗余
      */
-    analyzeAll(): RedundancyResult[];
+    analyzeAll(): Promise<RedundancyResult[]>;
     /**
      * 分析两条 Recipe 的冗余度
      */

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

@@ -9,6 +9,7 @@
  *
  * 综合: weighted_sum(0.2*d1 + 0.3*d2 + 0.3*d3 + 0.2*d4) ≥ 0.65
  */
+import { CONSUMABLE_LIFECYCLES } from '../../domain/knowledge/Lifecycle.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { ContradictionDetector } from './ContradictionDetector.js';
 /* ────────────────────── Constants ────────────────────── */
@@ -16,20 +17,20 @@ const WEIGHTS = { title: 0.2, clause: 0.3, code: 0.3, guard: 0.2 };
 const REDUNDANCY_THRESHOLD = 0.65;
 /* ────────────────────── Class ────────────────────── */
 export class RedundancyAnalyzer {
-    #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;
     }
     /**
      * 分析所有 active/staging 条目之间的冗余
      */
-    analyzeAll() {
-        const recipes = this.#loadRecipes();
+    async analyzeAll() {
+        const recipes = await this.#loadRecipes();
         const results = [];
         for (let i = 0; i < recipes.length; i++) {
             for (let j = i + 1; j < recipes.length; j++) {
@@ -88,24 +89,16 @@ export class RedundancyAnalyzer {
         };
     }
     /* ── Internal ── */
-    #loadRecipes() {
+    async #loadRecipes() {
         try {
-            const rows = this.#db
-                .prepare(`SELECT id, title,
-                doClause,
-                dontClause,
-                json_extract(content, '$.pattern') AS guardPattern,
-                json_extract(content, '$.coreCode') AS coreCode
-         FROM knowledge_entries
-         WHERE lifecycle IN ('active', 'staging', 'evolving')`)
-                .all();
-            return rows.map((r) => ({
-                id: r.id,
-                title: r.title,
-                doClause: r.doClause ?? null,
-                dontClause: r.dontClause ?? null,
-                coreCode: r.coreCode ?? null,
-                guardPattern: r.guardPattern ?? null,
+            const entries = await this.#knowledgeRepo.findAllByLifecycles(CONSUMABLE_LIFECYCLES);
+            return entries.map((e) => ({
+                id: e.id,
+                title: e.title,
+                doClause: e.doClause || null,
+                dontClause: e.dontClause || null,
+                coreCode: e.coreCode || null,
+                guardPattern: e.content?.pattern || null,
             }));
         }
         catch {

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

@@ -12,15 +12,7 @@
  *   0.85-0.89 → 72h
  */
 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;
-        run(...params: unknown[]): {
-            changes: number;
-        };
-    };
-}
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
 export interface StagingEntry {
     id: string;
     title: string;
@@ -34,24 +26,23 @@ export interface StagingCheckResult {
 }
 export declare class StagingManager {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, options?: {
         signalBus?: SignalBus;
     });
     /**
      * 将条目推入 staging 状态并记录 deadline
      */
-    enterStaging(entryId: string, gracePeriodMs: number, confidence: number): boolean;
+    enterStaging(entryId: string, gracePeriodMs: number, confidence: number): Promise<boolean>;
     /**
      * 检查所有 staging 条目，执行自动发布或回滚
      */
-    checkAndPromote(): StagingCheckResult;
+    checkAndPromote(): Promise<StagingCheckResult>;
     /**
      * 回滚 staging 条目到 pending（Guard 检测到冲突时调用）
      */
-    rollback(entryId: string, reason: string): boolean;
+    rollback(entryId: string, reason: string): Promise<boolean>;
     /**
      * 获取所有 staging 条目及其状态
      */
-    listStaging(): StagingEntry[];
+    listStaging(): Promise<StagingEntry[]>;
 }
-export {};

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

@@ -15,22 +15,20 @@ import Logger from '../../infrastructure/logging/Logger.js';
 import { unixNow } from '../../shared/utils/common.js';
 /* ────────────────────── Class ────────────────────── */
 export class StagingManager {
-    #db;
+    #knowledgeRepo;
     #signalBus;
     #logger = Logger.getInstance();
-    constructor(db, options = {}) {
-        this.#db = db;
+    constructor(knowledgeRepo, options = {}) {
+        this.#knowledgeRepo = knowledgeRepo;
         this.#signalBus = options.signalBus ?? null;
     }
     /**
      * 将条目推入 staging 状态并记录 deadline
      */
-    enterStaging(entryId, gracePeriodMs, confidence) {
+    async enterStaging(entryId, gracePeriodMs, confidence) {
         const now = Date.now();
         const deadline = now + gracePeriodMs;
-        const entry = this.#db
-            .prepare(`SELECT id, title, lifecycle FROM knowledge_entries WHERE id = ?`)
-            .get(entryId);
+        const entry = await this.#knowledgeRepo.findById(entryId);
         if (!entry) {
             this.#logger.warn(`StagingManager: entry not found: ${entryId}`);
             return false;
@@ -39,24 +37,10 @@ export class StagingManager {
             this.#logger.warn(`StagingManager: entry ${entryId} is "${entry.lifecycle}", not pending`);
             return false;
         }
-        // 更新 lifecycle → staging，记录 deadline 到 stats JSON
-        const statsRaw = this.#db
-            .prepare(`SELECT stats FROM knowledge_entries WHERE id = ?`)
-            .get(entryId);
-        let stats = {};
-        try {
-            stats = JSON.parse(statsRaw?.stats || '{}');
-        }
-        catch {
-            stats = {};
-        }
-        stats.stagingDeadline = deadline;
-        stats.stagingConfidence = confidence;
-        stats.stagingEnteredAt = now;
-        this.#db
-            .prepare(`UPDATE knowledge_entries SET lifecycle = 'staging', stats = ?, updatedAt = ? WHERE id = ?`)
-            .run(JSON.stringify(stats), unixNow(), entryId);
-        // 发射信号
+        await this.#knowledgeRepo.update(entryId, {
+            lifecycle: 'staging',
+            stagingDeadline: deadline,
+        });
         if (this.#signalBus) {
             this.#signalBus.send('lifecycle', 'StagingManager.enter', confidence, {
                 target: entryId,
@@ -74,40 +58,27 @@ export class StagingManager {
     /**
      * 检查所有 staging 条目，执行自动发布或回滚
      */
-    checkAndPromote() {
+    async checkAndPromote() {
         const now = Date.now();
         const result = { promoted: [], rolledBack: [], waiting: [] };
-        const rows = this.#db
-            .prepare(`SELECT id, title, stats FROM knowledge_entries WHERE lifecycle = 'staging'`)
-            .all();
-        for (const row of rows) {
-            let stats = {};
-            try {
-                stats = JSON.parse(row.stats || '{}');
-            }
-            catch {
-                stats = {};
-            }
-            const deadline = stats.stagingDeadline || 0;
-            const confidence = stats.stagingConfidence || 0;
+        const entries = await this.#knowledgeRepo.findAllByLifecycles(['staging']);
+        for (const e of entries) {
+            const deadline = e.stagingDeadline || 0;
             const entry = {
-                id: row.id,
-                title: row.title,
+                id: e.id,
+                title: e.title,
                 stagingDeadline: deadline,
-                confidence,
+                confidence: 0,
             };
             if (deadline === 0) {
-                // 无 deadline 数据（旧数据兼容）→ 保持 waiting
                 result.waiting.push(entry);
                 continue;
             }
             if (now < deadline) {
-                // 未到期
                 result.waiting.push(entry);
                 continue;
             }
-            // 到期 → 自动发布
-            this.#promote(entry, stats, now);
+            await this.#promote(entry, now);
             result.promoted.push(entry);
         }
         if (result.promoted.length > 0) {
@@ -118,30 +89,15 @@ export class StagingManager {
     /**
      * 回滚 staging 条目到 pending（Guard 检测到冲突时调用）
      */
-    rollback(entryId, reason) {
-        const now = Date.now();
-        const entry = this.#db
-            .prepare(`SELECT id, title, lifecycle, stats FROM knowledge_entries WHERE id = ?`)
-            .get(entryId);
+    async rollback(entryId, reason) {
+        const entry = await this.#knowledgeRepo.findById(entryId);
         if (!entry || entry.lifecycle !== 'staging') {
             return false;
         }
-        let stats = {};
-        try {
-            stats = JSON.parse(entry.stats || '{}');
-        }
-        catch {
-            stats = {};
-        }
-        // 清除 staging 元数据
-        delete stats.stagingDeadline;
-        delete stats.stagingConfidence;
-        delete stats.stagingEnteredAt;
-        stats.lastRollbackReason = reason;
-        stats.lastRollbackAt = now;
-        this.#db
-            .prepare(`UPDATE knowledge_entries SET lifecycle = 'pending', stats = ?, updatedAt = ? WHERE id = ?`)
-            .run(JSON.stringify(stats), unixNow(), entryId);
+        await this.#knowledgeRepo.update(entryId, {
+            lifecycle: 'pending',
+            stagingDeadline: null,
+        });
         if (this.#signalBus) {
             this.#signalBus.send('lifecycle', 'StagingManager.rollback', 0.8, {
                 target: entryId,
@@ -158,37 +114,23 @@ export class StagingManager {
     /**
      * 获取所有 staging 条目及其状态
      */
-    listStaging() {
-        const rows = this.#db
-            .prepare(`SELECT id, title, stats FROM knowledge_entries WHERE lifecycle = 'staging'`)
-            .all();
-        return rows.map((row) => {
-            let stats = {};
-            try {
-                stats = JSON.parse(row.stats || '{}');
-            }
-            catch {
-                stats = {};
-            }
-            return {
-                id: row.id,
-                title: row.title,
-                stagingDeadline: stats.stagingDeadline || 0,
-                confidence: stats.stagingConfidence || 0,
-            };
-        });
+    async listStaging() {
+        const entries = await this.#knowledgeRepo.findAllByLifecycles(['staging']);
+        return entries.map((e) => ({
+            id: e.id,
+            title: e.title,
+            stagingDeadline: e.stagingDeadline || 0,
+            confidence: 0,
+        }));
     }
     /* ── Private ── */
-    #promote(entry, stats, now) {
-        // 清除 staging 元数据，记录发布信息
-        delete stats.stagingDeadline;
-        delete stats.stagingConfidence;
-        delete stats.stagingEnteredAt;
-        stats.autoPublishedAt = now;
+    async #promote(entry, now) {
         const nowS = unixNow();
-        this.#db
-            .prepare(`UPDATE knowledge_entries SET lifecycle = 'active', publishedAt = ?, stats = ?, updatedAt = ? WHERE id = ?`)
-            .run(nowS, JSON.stringify(stats), nowS, entry.id);
+        await this.#knowledgeRepo.update(entry.id, {
+            lifecycle: 'active',
+            publishedAt: nowS,
+            stagingDeadline: null,
+        });
         if (this.#signalBus) {
             this.#signalBus.send('lifecycle', 'StagingManager.promote', 1.0, {
                 target: entry.id,

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

@@ -40,5 +40,5 @@ export interface SupersedeResult {
  *
  * @returns SupersedeResult（成功）| null（ProposalRepo 不可用 / 旧 Recipe 不存在 / 去重拒绝）
  */
-export declare function createSupersedeProposal(container: MinimalContainer, input: SupersedeInput): SupersedeResult | null;
+export declare function createSupersedeProposal(container: MinimalContainer, input: SupersedeInput): Promise<SupersedeResult | null>;
 export {};

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

@@ -16,7 +16,7 @@
  *
  * @returns SupersedeResult（成功）| null（ProposalRepo 不可用 / 旧 Recipe 不存在 / 去重拒绝）
  */
-export function createSupersedeProposal(container, input) {
+export async function createSupersedeProposal(container, input) {
     const { oldRecipeId, newRecipeIds, source = 'ide-agent', confidence = 0.8 } = input;
     if (!oldRecipeId || newRecipeIds.length === 0) {
         return null;
@@ -33,7 +33,7 @@ export function createSupersedeProposal(container, input) {
         return null;
     }
     // 2. 验证旧 Recipe 存在
-    if (!verifyRecipeExists(container, oldRecipeId)) {
+    if (!(await verifyRecipeExists(container, oldRecipeId))) {
         return null;
     }
     // 3. 创建 supersede 提案（ProposalRepository 内部做去重检查）
@@ -65,15 +65,14 @@ export function createSupersedeProposal(container, input) {
     };
 }
 /* ────────────────────── Helpers ────────────────────── */
-function verifyRecipeExists(container, recipeId) {
+async function verifyRecipeExists(container, recipeId) {
     try {
-        const db = container.get('database');
-        if (!db) {
+        const knowledgeRepo = container.get('knowledgeRepository');
+        if (!knowledgeRepo) {
             return false;
         }
-        const rawDb = db.getDb();
-        const row = rawDb.prepare('SELECT id FROM knowledge_entries WHERE id = ?').get(recipeId);
-        return row !== undefined;
+        const entry = await knowledgeRepo.findById(recipeId);
+        return entry !== null;
     }
     catch {
         return false;

package/dist/lib/service/guard/CoverageAnalyzer.d.ts

@@ -4,12 +4,8 @@
  * 计算模块级 Rule 覆盖率，识别零覆盖和低覆盖模块。
  * 与 PanoramaService 协同：利用模块划分 + gaps 数据做精准评估。
  */
-interface DatabaseLike {
-    prepare(sql: string): {
-        all(...params: unknown[]): Record<string, unknown>[];
-        get(...params: unknown[]): Record<string, unknown> | undefined;
-    };
-}
+import type { GuardViolationRepositoryImpl } from '../../repository/guard/GuardViolationRepository.js';
+import type { KnowledgeRepositoryImpl } from '../../repository/knowledge/KnowledgeRepository.impl.js';
 interface RuleLearnerLike {
     getMetrics(ruleId: string): {
         precision: number;
@@ -42,7 +38,7 @@ export interface CoverageMatrix {
 }
 export declare class CoverageAnalyzer {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, guardViolationRepo: GuardViolationRepositoryImpl, options?: {
         ruleLearner?: RuleLearnerLike;
     });
     /**

package/dist/lib/service/guard/CoverageAnalyzer.js

@@ -10,11 +10,13 @@ import { LanguageService } from '../../shared/LanguageService.js';
 const LOW_COVERAGE_THRESHOLD = 50;
 /* ────────────────────── Class ────────────────────── */
 export class CoverageAnalyzer {
-    #db;
+    #knowledgeRepo;
+    #guardViolationRepo;
     #ruleLearner;
     #logger = Logger.getInstance();
-    constructor(db, options = {}) {
-        this.#db = db;
+    constructor(knowledgeRepo, guardViolationRepo, options = {}) {
+        this.#knowledgeRepo = knowledgeRepo;
+        this.#guardViolationRepo = guardViolationRepo;
         this.#ruleLearner = options.ruleLearner ?? null;
     }
     /**
@@ -93,9 +95,7 @@ export class CoverageAnalyzer {
     /* ── 内部 ── */
     #loadActiveRules() {
         try {
-            const rows = this.#db
-                .prepare(`SELECT id, language FROM knowledge_entries WHERE lifecycle = 'active' AND kind = 'rule'`)
-                .all();
+            const rows = this.#knowledgeRepo.findActiveRuleIdsSync();
             return rows.map((r) => ({
                 id: r.id,
                 languages: r.language
@@ -110,13 +110,11 @@ export class CoverageAnalyzer {
     #buildRuleFileMap() {
         const map = new Map();
         try {
-            const rows = this.#db
-                .prepare(`SELECT file_path, violations_json FROM guard_violations ORDER BY created_at DESC LIMIT 200`)
-                .all();
+            const rows = this.#guardViolationRepo.findRecentViolationsJson(200);
             for (const row of rows) {
                 try {
-                    const violations = JSON.parse(row.violations_json || '[]');
-                    const filePath = row.file_path;
+                    const violations = JSON.parse(row.violationsJson || '[]');
+                    const filePath = row.filePath;
                     for (const v of violations) {
                         if (!v.ruleId) {
                             continue;

package/dist/lib/service/guard/GuardCheckEngine.d.ts

@@ -7,6 +7,7 @@
 import * as AstAnalyzerModule from '../../core/AstAnalyzer.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import type { SignalBus } from '../../infrastructure/signal/SignalBus.js';
+import type { KnowledgeRepositoryImpl } from '../../repository/knowledge/KnowledgeRepository.impl.js';
 import type { GuardCapabilityReport, UncertainResult } from './UncertaintyCollector.js';
 import { UncertaintyCollector } from './UncertaintyCollector.js';
 /** Minimal DB interface for Guard engine */
@@ -80,6 +81,7 @@ interface GuardCheckEngineOptions {
     cacheTTL?: number;
     guardConfig?: GuardConfig;
     signalBus?: SignalBus;
+    knowledgeRepo?: KnowledgeRepositoryImpl;
 }
 interface ExternalRuleInput {
     ruleId: string;
@@ -110,6 +112,7 @@ interface AuditFilesInput {
 export { detectLanguage } from './GuardPatternUtils.js';
 /** GuardCheckEngine - 核心检查引擎 */
 export declare class GuardCheckEngine {
+    #private;
     _astRulesCache: GuardRule[] | null;
     _builtInRules: Record<string, BuiltInRule>;
     _cacheTTL: number;

package/dist/lib/service/guard/GuardCheckEngine.js

@@ -5,7 +5,9 @@
  * 支持: 正则模式匹配 + AST 语义规则 + code-level 检查 + 多维度审计
  */
 import * as AstAnalyzerModule from '../../core/AstAnalyzer.js';
+import { GUARD_LIFECYCLES } from '../../domain/knowledge/Lifecycle.js';
 import Logger from '../../infrastructure/logging/Logger.js';
+import { RawDbGuardAdapter, unwrapRawDb } from '../../repository/search/SearchRepoAdapter.js';
 import { LanguageService } from '../../shared/LanguageService.js';
 import { runCodeLevelChecks } from './GuardCodeChecks.js';
 import { runCrossFileChecks } from './GuardCrossFileChecks.js';
@@ -463,10 +465,17 @@ export class GuardCheckEngine {
     _lastBlindSpotSignalKey;
     _uncertaintyCollector;
     db;
+    #knowledgeRepo;
     logger;
     constructor(db, options = {}) {
-        this.db =
-            db && 'getDb' in db && typeof db.getDb === 'function' ? db.getDb() : db;
+        this.db = unwrapRawDb(db);
+        this.#knowledgeRepo =
+            options.knowledgeRepo ??
+                (this.db
+                    ? new RawDbGuardAdapter(this.db)
+                    : new RawDbGuardAdapter({
+                        prepare: () => ({ run: () => undefined, get: () => ({}), all: () => [] }),
+                    }));
         this.logger = Logger.getInstance();
         this._builtInRules = BUILT_IN_RULES;
         this._customRulesCache = null;
@@ -543,12 +552,7 @@ export class GuardCheckEngine {
             if (!this._customRulesCache || now - this._cacheTime > this._cacheTTL) {
                 let rows = [];
                 try {
-                    rows = this.db
-                        .prepare(`SELECT id, title, description, language, scope, constraints, lifecycle
-             FROM knowledge_entries
-             WHERE (kind = 'rule' OR knowledgeType = 'boundary-constraint')
-               AND lifecycle IN ('active', 'staging', 'evolving', 'decaying')`)
-                        .all();
+                    rows = this.#knowledgeRepo.findGuardRulesSync(GUARD_LIFECYCLES);
                 }
                 catch {
                     /* table may not exist */
@@ -1296,7 +1300,7 @@ export class GuardCheckEngine {
      * @param violations
      */
     trackGuardHits(violations) {
-        if (!violations?.length || !this.db) {
+        if (!violations?.length || !this.#knowledgeRepo) {
             return;
         }
         try {
@@ -1306,21 +1310,9 @@ export class GuardCheckEngine {
                 const count = hitMap.get(v.ruleId) || 0;
                 hitMap.set(v.ruleId, count + 1);
             }
-            let updateStmt;
-            try {
-                updateStmt = this.db.prepare(`UPDATE knowledge_entries
-           SET stats = json_set(COALESCE(stats, '{}'), '$.guardHits',
-                 COALESCE(json_extract(stats, '$.guardHits'), 0) + ?),
-               updatedAt = ?
-           WHERE id = ?`);
-            }
-            catch {
-                /* table may not exist */
-            }
-            const now = Math.floor(Date.now() / 1000);
             for (const [ruleId, count] of hitMap) {
                 try {
-                    updateStmt?.run(count, now, ruleId);
+                    this.#knowledgeRepo.incrementGuardHitsSync(ruleId, count);
                 }
                 catch {
                     /* 非 Recipe 规则（内置规则）忽略 */

package/dist/lib/service/guard/ReverseGuard.d.ts

@@ -12,12 +12,9 @@
  *   5. 匹配率骤降 → 代码模式正在迁移
  */
 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 { CodeEntityRepositoryImpl } from '../../repository/code/CodeEntityRepository.js';
+import type { KnowledgeRepositoryImpl } from '../../repository/knowledge/KnowledgeRepository.impl.js';
+import type { RecipeSourceRefRepositoryImpl } from '../../repository/sourceref/RecipeSourceRefRepository.js';
 export type DriftType = 'symbol_missing' | 'match_rate_drop' | 'api_deprecated' | 'zero_match' | 'source_ref_stale';
 export type DriftSeverity = 'high' | 'medium' | 'low';
 export interface PatternDriftSignal {
@@ -48,7 +45,7 @@ interface RecipeRow {
 }
 export declare class ReverseGuard {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, entityRepo: CodeEntityRepositoryImpl, sourceRefRepo: RecipeSourceRefRepositoryImpl, options?: {
         signalBus?: SignalBus;
     });
     /**