autosnippet 3.3.7 → 3.3.8

package/dist/lib/service/bootstrap/bootstrap-event-types.d.ts

@@ -5,7 +5,6 @@
  * 通过 discriminated union（`type` 字段）实现编译期事件校验。
  *
  * @module service/bootstrap/bootstrap-event-types
- * @see docs/copilot/unified-project-snapshot-design.md §11.3 H6
  */
 export interface DimensionSkippedPayload {
     type: 'skipped';

package/dist/lib/service/bootstrap/bootstrap-event-types.js

@@ -5,6 +5,5 @@
  * 通过 discriminated union（`type` 字段）实现编译期事件校验。
  *
  * @module service/bootstrap/bootstrap-event-types
- * @see docs/copilot/unified-project-snapshot-design.md §11.3 H6
  */
 export {};

package/dist/lib/service/cleanup/CleanupService.js

@@ -25,6 +25,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { CANDIDATES_DIR } from '#infra/config/Defaults.js';
 import { getContextIndexPath, getProjectKnowledgePath, getProjectRecipesPath, getProjectSkillsPath, } from '#infra/config/Paths.js';
+import { CONSUMABLE_LIFECYCLES, lifecycleInSql } from '../../domain/knowledge/Lifecycle.js';
 // ── 常量 ────────────────────────────────────────────────────
 /** 垃圾桶根目录（相对于 .autosnippet/） */
 const TRASH_DIR = '.trash';
@@ -275,12 +276,15 @@ export class CleanupService {
             return { count: 0, entries: [], coverageByDimension: {} };
         }
         try {
+            const { sql: lcFilter, params: lcParams } = lifecycleInSql(CONSUMABLE_LIFECYCLES);
             const rows = this.#db
-                .prepare(`SELECT id, title, trigger, category, knowledgeType, doClause,
+                .prepare(
+            // @escape-hatch(permanent) — dynamic lifecycle filter + json_extract
+            `SELECT id, title, trigger, category, knowledgeType, doClause,
                   sourceFile, lifecycle, content, json_extract(reasoning, '$.sources') AS sourceRefsJson
            FROM knowledge_entries
-           WHERE lifecycle IN ('active', 'staging', 'evolving')`)
-                .all();
+           WHERE ${lcFilter}`)
+                .all(...lcParams);
             const entries = rows.map((r) => {
                 let parsedContent;
                 try {
@@ -430,7 +434,7 @@ export class CleanupService {
         const lines = [];
         for (const table of tablesToExport) {
             try {
-                const rows = this.#db.prepare(`SELECT * FROM ${table}`).all();
+                const rows = this.#db.prepare(`SELECT * FROM ${table}`).all(); // @escape-hatch(permanent) — dynamic table name for backup export
                 for (const row of rows) {
                     lines.push(JSON.stringify({ _table: table, ...row }));
                     totalRows++;

package/dist/lib/service/delivery/CursorDeliveryPipeline.js

@@ -18,6 +18,8 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
+import { RawDbCallGraphAdapter, } from '../../repository/delivery/DeliveryRepoAdapter.js';
+import { unwrapRawDb } from '../../repository/search/SearchRepoAdapter.js';
 import { DELIVERY_RANK, KNOWLEDGE_CONFIDENCE } from '../../shared/constants.js';
 import { DEFAULT_KNOWLEDGE_BASE_DIR } from '../../shared/ProjectMarkers.js';
 import { AgentInstructionsGenerator } from './AgentInstructionsGenerator.js';
@@ -313,20 +315,16 @@ export class CursorDeliveryPipeline {
             return null;
         }
         try {
-            const db = typeof this.database.getDb === 'function' ? this.database.getDb() : this.database;
+            const rawDb = unwrapRawDb(this.database);
+            const repo = new RawDbCallGraphAdapter(rawDb);
             // 查询调用边中的跨目录调用模式
-            const callEdges = db
-                .prepare(`SELECT from_id, to_id, metadata_json FROM knowledge_edges
-         WHERE relation = 'calls' AND metadata_json LIKE '%phase5%'`)
-                .all();
+            const callEdges = repo.findCallEdges();
             if (!callEdges || callEdges.length < 5) {
                 return null;
             }
             // 提取 caller/callee 对应的文件路径
             const entityFiles = new Map();
-            const entities = db
-                .prepare(`SELECT entity_id, file_path FROM code_entities WHERE entity_type = 'method'`)
-                .all();
+            const entities = repo.findMethodEntities();
             for (const e of entities) {
                 entityFiles.set(e.entity_id, e.file_path);
             }

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

@@ -14,11 +14,7 @@
  *   2. 语义域覆盖 — category + trigger 是否落在已有 Recipe 管辖范围
  *   3. 独立价值   — 内容长度、具体性、是否有独立 coreCode
  */
-interface DatabaseLike {
-    prepare(sql: string): {
-        all(...params: unknown[]): Record<string, unknown>[];
-    };
-}
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
 /** 提交候选的必要字段 */
 export interface CandidateForConsolidation {
     title: string;
@@ -92,14 +88,14 @@ export interface BatchConsolidationResult {
 }
 export declare class ConsolidationAdvisor {
     #private;
-    constructor(db: DatabaseLike);
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl);
     /**
      * 分析候选知识与现有知识库的关系，返回融合建议。
      *
      * @param candidate - 待提交的候选数据
      * @returns ConsolidationAdvice — 建议 + 理由 + 上下文
      */
-    analyze(candidate: CandidateForConsolidation): ConsolidationAdvice;
+    analyze(candidate: CandidateForConsolidation): Promise<ConsolidationAdvice>;
     /**
      * 批量分析候选知识与现有知识库的关系。
      *
@@ -109,6 +105,5 @@ export declare class ConsolidationAdvisor {
      * @param candidates - 待提交的候选数组
      * @returns BatchConsolidationResult — 每条分析 + 批次内重叠
      */
-    analyzeBatch(candidates: CandidateForConsolidation[]): BatchConsolidationResult;
+    analyzeBatch(candidates: CandidateForConsolidation[]): Promise<BatchConsolidationResult>;
 }
-export {};

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

@@ -15,6 +15,7 @@
  *   3. 独立价值   — 内容长度、具体性、是否有独立 coreCode
  */
 var _a;
+import { COUNTABLE_LIFECYCLES } from '../../domain/knowledge/Lifecycle.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { ContradictionDetector } from './ContradictionDetector.js';
 /* ────────────────────── Constants ────────────────────── */
@@ -29,10 +30,10 @@ const MAX_CANDIDATES_PER_ANALYSIS = 30;
 const WEIGHTS = { title: 0.2, clause: 0.3, code: 0.3, guard: 0.2 };
 /* ────────────────────── Class ────────────────────── */
 export class ConsolidationAdvisor {
-    #db;
+    #knowledgeRepo;
     #logger = Logger.getInstance();
-    constructor(db) {
-        this.#db = db;
+    constructor(knowledgeRepo) {
+        this.#knowledgeRepo = knowledgeRepo;
     }
     /**
      * 分析候选知识与现有知识库的关系，返回融合建议。
@@ -40,11 +41,11 @@ export class ConsolidationAdvisor {
      * @param candidate - 待提交的候选数据
      * @returns ConsolidationAdvice — 建议 + 理由 + 上下文
      */
-    analyze(candidate) {
+    async analyze(candidate) {
         // ── Step 1: 独立价值评估 ──
         const substanceScore = this.#assessSubstance(candidate);
         // ── Step 2: 加载同域 / 相关 Recipe ──
-        const related = this.#loadRelatedRecipes(candidate);
+        const related = await this.#loadRelatedRecipes(candidate);
         // ── Step 3: insufficient — 独立价值不足，交给 Agent 与开发者决定 ──
         if (substanceScore < MIN_SUBSTANCE_SCORE) {
             if (related.length > 0) {
@@ -188,12 +189,12 @@ export class ConsolidationAdvisor {
      * @param candidates - 待提交的候选数组
      * @returns BatchConsolidationResult — 每条分析 + 批次内重叠
      */
-    analyzeBatch(candidates) {
+    async analyzeBatch(candidates) {
         // 对每个候选独立分析（vs DB）
-        const items = candidates.map((c, index) => ({
-            index,
-            advice: this.analyze(c),
-        }));
+        const items = [];
+        for (let index = 0; index < candidates.length; index++) {
+            items.push({ index, advice: await this.analyze(candidates[index]) });
+        }
         // 检测批次内候选之间的相互重叠
         const internalOverlaps = [];
         for (let i = 0; i < candidates.length; i++) {
@@ -288,78 +289,41 @@ export class ConsolidationAdvisor {
         return msg;
     }
     /* ════════════════════ 相关 Recipe 加载 ════════════════════ */
-    #loadRelatedRecipes(candidate) {
+    async #loadRelatedRecipes(candidate) {
         try {
-            // 先按 category 精确匹配 + trigger 前缀匹配
             const category = candidate.category || '';
             const trigger = candidate.trigger || '';
             const triggerPrefix = trigger.startsWith('@')
                 ? trigger.slice(0, Math.max(3, trigger.indexOf('-', 1) > 0 ? trigger.indexOf('-', 1) : trigger.length))
                 : '';
-            let rows;
+            const toSummary = (e) => ({
+                id: e.id,
+                title: e.title,
+                doClause: e.doClause || null,
+                dontClause: e.dontClause || null,
+                coreCode: e.coreCode || null,
+                category: e.category || null,
+                trigger: e.trigger || null,
+                whenClause: e.whenClause || null,
+                guardPattern: e.content?.pattern || null,
+            });
             if (category) {
-                // 同 category 的 Recipe 是最有可能重叠的
-                rows = this.#db
-                    .prepare(`SELECT id, title,
-                    doClause,
-                    dontClause,
-                    json_extract(content, '$.coreCode') AS coreCode,
-                    category, trigger, whenClause,
-                    json_extract(content, '$.pattern') AS guardPattern
-             FROM knowledge_entries
-             WHERE lifecycle IN ('active', 'staging', 'evolving', 'pending')
-               AND category = ?
-             ORDER BY lifecycle DESC
-             LIMIT ?`)
-                    .all(category, MAX_CANDIDATES_PER_ANALYSIS);
-                // 如果同 category 不够，再加载 trigger 相关的
-                if (rows.length < 5 && triggerPrefix.length >= 3) {
-                    const extra = this.#db
-                        .prepare(`SELECT id, title,
-                      doClause,
-                      dontClause,
-                      json_extract(content, '$.coreCode') AS coreCode,
-                      category, trigger, whenClause,
-                      json_extract(content, '$.pattern') AS guardPattern
-               FROM knowledge_entries
-               WHERE lifecycle IN ('active', 'staging', 'evolving', 'pending')
-                 AND category != ?
-                 AND trigger LIKE ?
-               LIMIT ?`)
-                        .all(category, `${triggerPrefix}%`, MAX_CANDIDATES_PER_ANALYSIS - rows.length);
-                    const existingIds = new Set(rows.map((r) => r.id));
+                const entries = await this.#knowledgeRepo.findAllByLifecyclesAndCategory(COUNTABLE_LIFECYCLES, category, MAX_CANDIDATES_PER_ANALYSIS);
+                const results = entries.map(toSummary);
+                if (results.length < 5 && triggerPrefix.length >= 3) {
+                    const extra = await this.#knowledgeRepo.findByLifecyclesAndTriggerPrefix(COUNTABLE_LIFECYCLES, category, triggerPrefix, MAX_CANDIDATES_PER_ANALYSIS - results.length);
+                    const existingIds = new Set(results.map((r) => r.id));
                     for (const e of extra) {
-                        if (!existingIds.has(e.id)) {
-                            rows.push(e);
+                        const s = toSummary(e);
+                        if (!existingIds.has(s.id)) {
+                            results.push(s);
                         }
                     }
                 }
+                return results;
             }
-            else {
-                // 无 category 时按 title 关键词粗筛
-                rows = this.#db
-                    .prepare(`SELECT id, title,
-                    doClause,
-                    dontClause,
-                    json_extract(content, '$.coreCode') AS coreCode,
-                    category, trigger, whenClause,
-                    json_extract(content, '$.pattern') AS guardPattern
-             FROM knowledge_entries
-             WHERE lifecycle IN ('active', 'staging', 'evolving', 'pending')
-             LIMIT ?`)
-                    .all(MAX_CANDIDATES_PER_ANALYSIS);
-            }
-            return rows.map((r) => ({
-                id: r.id,
-                title: r.title,
-                doClause: r.doClause ?? null,
-                dontClause: r.dontClause ?? null,
-                coreCode: r.coreCode ?? null,
-                category: r.category ?? null,
-                trigger: r.trigger ?? null,
-                whenClause: r.whenClause ?? null,
-                guardPattern: r.guardPattern ?? null,
-            }));
+            const entries = await this.#knowledgeRepo.findAllByLifecycles(COUNTABLE_LIFECYCLES);
+            return entries.slice(0, MAX_CANDIDATES_PER_ANALYSIS).map(toSummary);
         }
         catch (err) {
             this.#logger.warn(`ConsolidationAdvisor: failed to load recipes: ${err instanceof Error ? err.message : String(err)}`);

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

@@ -16,19 +16,12 @@
  *
  * @module service/evolution/ContentPatcher
  */
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
+import type { RecipeSourceRefRepositoryImpl } from '../../repository/sourceref/RecipeSourceRefRepository.js';
 import type { ContentPatchResult } from '../../types/evolution.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 declare class ContentPatcher {
     #private;
-    constructor(db: DatabaseLike);
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, sourceRefRepo: RecipeSourceRefRepositoryImpl);
     /**
      * 从 Proposal evidence 提取 suggestedChanges 并应用到 Recipe
      *
@@ -39,6 +32,5 @@ export declare class ContentPatcher {
         type: string;
         targetRecipeId: string;
         evidence: Record<string, unknown>[];
-    }, patchSource?: 'agent-suggestion' | 'correction' | 'merge'): ContentPatchResult;
+    }, patchSource?: 'agent-suggestion' | 'correction' | 'merge'): Promise<ContentPatchResult>;
 }
-export {};

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

@@ -31,20 +31,22 @@ const PATCHABLE_FIELDS = new Set([
 ]);
 /* ────────────────────── Class ────────────────────── */
 export class ContentPatcher {
-    #db;
+    #knowledgeRepo;
+    #sourceRefRepo;
     #logger = Logger.getInstance();
-    constructor(db) {
-        this.#db = db;
+    constructor(knowledgeRepo, sourceRefRepo) {
+        this.#knowledgeRepo = knowledgeRepo;
+        this.#sourceRefRepo = sourceRefRepo;
     }
     /**
      * 从 Proposal evidence 提取 suggestedChanges 并应用到 Recipe
      *
      * @returns ContentPatchResult — success: 是否成功应用了至少一个 patch
      */
-    applyProposal(proposal, patchSource = 'agent-suggestion') {
+    async applyProposal(proposal, patchSource = 'agent-suggestion') {
         const recipeId = proposal.targetRecipeId;
         // 1. 获取 Recipe 当前内容
-        const recipe = this.#getRecipe(recipeId);
+        const recipe = await this.#getRecipe(recipeId);
         if (!recipe) {
             return this.#skipResult(recipeId, patchSource, 'Recipe not found');
         }
@@ -66,7 +68,7 @@ export class ContentPatcher {
             return this.#skipResult(recipeId, patchSource, 'No valid fields to patch');
         }
         // 6. 持久化
-        this.#persistRecipe(recipe);
+        await this.#persistRecipe(recipe);
         // 7. 创建 after 快照
         const afterSnapshot = this.#createSnapshot(recipe);
         this.#logger.info(`[ContentPatcher] Applied ${fieldsPatched.length} patches to recipe ${recipeId}: ${fieldsPatched.join(', ')}`);
@@ -257,20 +259,47 @@ export class ContentPatcher {
         };
     }
     /* ═══════════════════ DB ═══════════════════ */
-    #getRecipe(recipeId) {
-        const row = this.#db
-            .prepare(`SELECT id, title, coreCode, doClause, dontClause, whenClause, content, sourceRefs, headers
-         FROM knowledge_entries WHERE id = ?`)
-            .get(recipeId);
-        return row ?? null;
+    async #getRecipe(recipeId) {
+        const entry = await this.#knowledgeRepo.findById(recipeId);
+        if (!entry) {
+            return null;
+        }
+        // 从 recipe_source_refs 表读取关联的源引用路径
+        const refs = this.#sourceRefRepo.findByRecipeId(entry.id);
+        const sourcePaths = refs.map((r) => r.sourcePath);
+        return {
+            id: entry.id,
+            title: entry.title,
+            coreCode: entry.coreCode || '',
+            doClause: entry.doClause || '',
+            dontClause: entry.dontClause || '',
+            whenClause: entry.whenClause || '',
+            content: JSON.stringify(entry.content || {}),
+            sourceRefs: JSON.stringify(sourcePaths),
+            headers: JSON.stringify(entry.headers || []),
+        };
     }
-    #persistRecipe(recipe) {
-        this.#db
-            .prepare(`UPDATE knowledge_entries
-         SET coreCode = ?, doClause = ?, dontClause = ?, whenClause = ?,
-             content = ?, sourceRefs = ?, headers = ?, updatedAt = ?
-         WHERE id = ?`)
-            .run(recipe.coreCode, recipe.doClause, recipe.dontClause, recipe.whenClause, recipe.content, recipe.sourceRefs, recipe.headers, Date.now(), recipe.id);
+    async #persistRecipe(recipe) {
+        await this.#knowledgeRepo.update(recipe.id, {
+            coreCode: recipe.coreCode,
+            doClause: recipe.doClause,
+            dontClause: recipe.dontClause,
+            whenClause: recipe.whenClause,
+            content: safeJsonParse(recipe.content, {}),
+            headers: safeJsonParse(recipe.headers, []),
+        });
+        // 同步 sourceRefs 到 recipe_source_refs 表
+        const newPaths = safeJsonParse(recipe.sourceRefs, []);
+        const now = Math.floor(Date.now() / 1000);
+        this.#sourceRefRepo.deleteByRecipeId(recipe.id);
+        for (const sourcePath of newPaths) {
+            this.#sourceRefRepo.upsert({
+                recipeId: recipe.id,
+                sourcePath,
+                status: 'active',
+                verifiedAt: now,
+            });
+        }
     }
     /* ═══════════════════ Helpers ═══════════════════ */
     #skipResult(recipeId, patchSource, reason) {

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

@@ -13,11 +13,7 @@
  * 结果：硬矛盾 (confidence ≥ 0.8) / 软矛盾 (0.4-0.8)
  */
 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 ContradictionResult {
     recipeA: string;
     recipeB: string;
@@ -37,13 +33,13 @@ interface RecipeEntry {
 }
 export declare class ContradictionDetector {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, options?: {
         signalBus?: SignalBus;
     });
     /**
      * 检测所有 active/staging/evolving Recipe 之间的矛盾
      */
-    detectAll(): ContradictionResult[];
+    detectAll(): Promise<ContradictionResult[]>;
     /**
      * 检测两条 Recipe 是否矛盾
      */

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

@@ -13,6 +13,7 @@
  * 结果：硬矛盾 (confidence ≥ 0.8) / 软矛盾 (0.4-0.8)
  */
 var _a;
+import { CONSUMABLE_LIFECYCLES } from '../../domain/knowledge/Lifecycle.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 /* ────────────────────── Constants ────────────────────── */
 const NEGATION_PATTERNS_ZH = /不(再)?使用|禁止|废弃|移除|取消|停止|不要|不采用|弃用|淘汰/;
@@ -71,18 +72,18 @@ const STOP_WORDS = new Set([
 ]);
 /* ────────────────────── Class ────────────────────── */
 export class ContradictionDetector {
-    #db;
+    #knowledgeRepo;
     #signalBus;
     #logger = Logger.getInstance();
-    constructor(db, options = {}) {
-        this.#db = db;
+    constructor(knowledgeRepo, options = {}) {
+        this.#knowledgeRepo = knowledgeRepo;
         this.#signalBus = options.signalBus ?? null;
     }
     /**
      * 检测所有 active/staging/evolving Recipe 之间的矛盾
      */
-    detectAll() {
-        const recipes = this.#loadRecipes();
+    async detectAll() {
+        const recipes = await this.#loadRecipes();
         const results = [];
         for (let i = 0; i < recipes.length; i++) {
             for (let j = i + 1; j < recipes.length; j++) {
@@ -155,26 +156,18 @@ export class ContradictionDetector {
         };
     }
     /* ── Internal ── */
-    #loadRecipes() {
+    async #loadRecipes() {
         try {
-            const rows = this.#db
-                .prepare(`SELECT id, title, lifecycle, description,
-                json_extract(content, '$.markdown') AS content_markdown,
-                doClause,
-                dontClause,
-                json_extract(content, '$.pattern') AS guardPattern
-         FROM knowledge_entries
-         WHERE lifecycle IN ('active', 'staging', 'evolving')`)
-                .all();
-            return rows.map((r) => ({
-                id: r.id,
-                title: r.title,
-                lifecycle: r.lifecycle,
-                doClause: r.doClause ?? null,
-                dontClause: r.dontClause ?? null,
-                guardPattern: r.guardPattern ?? null,
-                description: r.description ?? null,
-                content_markdown: r.content_markdown ?? null,
+            const entries = await this.#knowledgeRepo.findAllByLifecycles(CONSUMABLE_LIFECYCLES);
+            return entries.map((e) => ({
+                id: e.id,
+                title: e.title,
+                lifecycle: e.lifecycle,
+                doClause: e.doClause || null,
+                dontClause: e.dontClause || null,
+                guardPattern: e.content?.pattern || null,
+                description: e.description || null,
+                content_markdown: e.content?.markdown || null,
             }));
         }
         catch {

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

@@ -18,13 +18,11 @@
  *   20-39:  严重 → Grace Period 缩短到 15d
  *   0-19:   死亡 → 跳过确认直接 deprecated
  */
+import type { DrizzleDB } from '../../infrastructure/database/drizzle/index.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 { KnowledgeEdgeRepositoryImpl } from '../../repository/knowledge/KnowledgeEdgeRepository.js';
+import type KnowledgeRepositoryImpl from '../../repository/knowledge/KnowledgeRepository.impl.js';
+import type { RecipeSourceRefRepositoryImpl } from '../../repository/sourceref/RecipeSourceRefRepository.js';
 export interface DecaySignal {
     recipeId: string;
     strategy: DecayStrategy;
@@ -57,16 +55,19 @@ interface RecipeForDecay {
 }
 export declare class DecayDetector {
     #private;
-    constructor(db: DatabaseLike, options?: {
+    constructor(knowledgeRepo: KnowledgeRepositoryImpl, options?: {
         signalBus?: SignalBus;
+        knowledgeEdgeRepo?: KnowledgeEdgeRepositoryImpl;
+        sourceRefRepo?: RecipeSourceRefRepositoryImpl;
+        drizzle?: DrizzleDB;
     });
     /**
      * 扫描所有 active 条目的衰退状态
      */
-    scanAll(): DecayScoreResult[];
+    scanAll(): Promise<DecayScoreResult[]>;
     /**
      * 评估单条 Recipe 的衰退状态
      */
-    evaluate(recipe: RecipeForDecay): DecayScoreResult;
+    evaluate(recipe: RecipeForDecay): Promise<DecayScoreResult>;
 }
 export {};