autosnippet 3.3.7 → 3.3.8

package/dist/lib/service/quality/QualityScorer.d.ts

@@ -1,16 +1,38 @@
 /**
- * QualityScorer — Recipe 质量评分器
- * 5 个维度: completeness(0.35) + format(0.25) + codeQuality(0.25) + metadata(0.15) + engagement(0)
- * 每个维度评分 0-1，加权求和
+ * QualityScorer v2 — Recipe 质量评分器
+ *
+ * 面向知识管理场景重新设计，采用渐进式评分（非二元判断），
+ * 充分利用 KnowledgeEntry 所有可用字段。
+ *
+ * 5 维度加权:
+ * - completeness  (0.25): 结构完整性 — 核心字段齐全度
+ * - contentDepth  (0.30): 内容深度   — markdown 丰富度、推理、溯源
+ * - deliveryReady (0.20): 交付就绪   — trigger/language/tags/category
+ * - actionability (0.15): 可操作性   — coreCode、do/dont/when 质量
+ * - provenance    (0.10): 溯源可信   — confidence、sources、authority
+ *
+ * 设计参考:
+ * - RAG Triad (TruLens): Relevance + Groundedness + Answer Relevance
+ * - RAGAS: Context Precision + Faithfulness + Factual Correctness
+ * - SonarQube: 多维度渐进评级，非二元判断
  */
-interface RecipeInput {
+export interface RecipeInput {
     title?: string;
     trigger?: string;
-    code?: string;
+    description?: string;
     language?: string;
     category?: string;
-    summary?: string;
+    doClause?: string;
+    dontClause?: string;
+    whenClause?: string;
+    coreCode?: string;
     usageGuide?: string;
+    contentMarkdown?: string;
+    contentRationale?: string;
+    reasoningWhyStandard?: string;
+    reasoningSources?: string[];
+    reasoningConfidence?: number;
+    source?: string;
     headers?: string[];
     tags?: string[];
     views?: number;
@@ -18,25 +40,23 @@ interface RecipeInput {
     rating?: number;
     [key: string]: unknown;
 }
-interface QualityScorerOptions {
-    weights?: Record<string, number>;
-}
 export declare class QualityScorer {
     #private;
-    constructor(options?: QualityScorerOptions);
+    constructor(options?: {
+        weights?: Record<string, number>;
+    });
     /**
      * 计算综合质量分
-     * @param recipe Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
-     * @returns }
+     * @returns { score: 0-1, dimensions: Record<string,number>, grade: A-F }
      */
     score(recipe: RecipeInput): {
         score: number;
         dimensions: {
             completeness: number;
-            format: number;
-            codeQuality: number;
-            metadata: number;
-            engagement: number;
+            contentDepth: number;
+            deliveryReady: number;
+            actionability: number;
+            provenance: number;
         };
         grade: string;
     };
@@ -45,21 +65,20 @@ export declare class QualityScorer {
         score: number;
         dimensions: {
             completeness: number;
-            format: number;
-            codeQuality: number;
-            metadata: number;
-            engagement: number;
+            contentDepth: number;
+            deliveryReady: number;
+            actionability: number;
+            provenance: number;
         };
         grade: string;
         recipe: RecipeInput;
     }[];
     /** 获取维度权重 */
     getWeights(): {
-        completeness: 0.3;
-        format: 0.25;
-        codeQuality: 0.25;
-        metadata: 0.1;
-        engagement: 0.1;
+        completeness: 0.25;
+        contentDepth: 0.3;
+        deliveryReady: 0.2;
+        actionability: 0.15;
+        provenance: 0.1;
     };
 }
-export {};

package/dist/lib/service/quality/QualityScorer.js

@@ -1,10 +1,43 @@
 /**
- * QualityScorer — Recipe 质量评分器
- * 5 个维度: completeness(0.35) + format(0.25) + codeQuality(0.25) + metadata(0.15) + engagement(0)
- * 每个维度评分 0-1，加权求和
+ * QualityScorer v2 — Recipe 质量评分器
+ *
+ * 面向知识管理场景重新设计，采用渐进式评分（非二元判断），
+ * 充分利用 KnowledgeEntry 所有可用字段。
+ *
+ * 5 维度加权:
+ * - completeness  (0.25): 结构完整性 — 核心字段齐全度
+ * - contentDepth  (0.30): 内容深度   — markdown 丰富度、推理、溯源
+ * - deliveryReady (0.20): 交付就绪   — trigger/language/tags/category
+ * - actionability (0.15): 可操作性   — coreCode、do/dont/when 质量
+ * - provenance    (0.10): 溯源可信   — confidence、sources、authority
+ *
+ * 设计参考:
+ * - RAG Triad (TruLens): Relevance + Groundedness + Answer Relevance
+ * - RAGAS: Context Precision + Faithfulness + Factual Correctness
+ * - SonarQube: 多维度渐进评级，非二元判断
  */
-import { CODE_LENGTH, QUALITY_GRADES, QUALITY_WEIGHTS } from '../../shared/constants.js';
+import { QUALITY_GRADES, QUALITY_WEIGHTS } from '../../shared/constants.js';
+import { LanguageProfiles } from '../../shared/LanguageProfiles.js';
 const DEFAULT_WEIGHTS = QUALITY_WEIGHTS;
+// ─── 渐进式评分辅助函数 ─────────────────────────────────
+/** 文本长度渐进评分: 低于 minLen 给 20% 基础分，minLen→optimalLen 线性增长到满分 */
+function textScore(text, minLen, optimalLen, weight) {
+    if (!text?.trim()) {
+        return 0;
+    }
+    const len = text.trim().length;
+    if (len < minLen) {
+        return weight * 0.2;
+    }
+    if (len <= optimalLen) {
+        return weight * (0.5 + 0.5 * (len / optimalLen));
+    }
+    return weight;
+}
+/** 存在性检查: 有值给满分 */
+function presenceScore(value, weight) {
+    return value?.trim() ? weight : 0;
+}
 export class QualityScorer {
     #weights;
     constructor(options = {}) {
@@ -12,16 +45,15 @@ export class QualityScorer {
     }
     /**
      * 计算综合质量分
-     * @param recipe Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
-     * @returns }
+     * @returns { score: 0-1, dimensions: Record<string,number>, grade: A-F }
      */
     score(recipe) {
         const dimensions = {
             completeness: this.#scoreCompleteness(recipe),
-            format: this.#scoreFormat(recipe),
-            codeQuality: this.#scoreCodeQuality(recipe),
-            metadata: this.#scoreMetadata(recipe),
-            engagement: this.#scoreEngagement(recipe),
+            contentDepth: this.#scoreContentDepth(recipe),
+            deliveryReady: this.#scoreDeliveryReady(recipe),
+            actionability: this.#scoreActionability(recipe),
+            provenance: this.#scoreProvenance(recipe),
         };
         let totalScore = 0;
         for (const [dim, weight] of Object.entries(this.#weights)) {
@@ -44,108 +76,150 @@ export class QualityScorer {
         return { ...this.#weights };
     }
     // ─── 维度评分 ─────────────────────────────────────────
-    /** 完整性: title(0.25) + trigger(0.25) + code(0.3) + usageGuide(0.2) */
+    /**
+     * 结构完整性 (0-1)
+     * 渐进式检查核心字段齐全度
+     */
     #scoreCompleteness(r) {
         let s = 0;
-        if (r.title?.trim()) {
-            s += 0.25;
-        }
-        if (r.trigger?.trim()) {
-            s += 0.25;
+        s += textScore(r.title, 3, 40, 0.15);
+        s += presenceScore(r.trigger, 0.15);
+        s += textScore(r.description, 10, 60, 0.15);
+        s += textScore(r.doClause, 10, 50, 0.15);
+        s += textScore(r.whenClause, 10, 50, 0.15);
+        s += textScore(r.coreCode, 10, 200, 0.15);
+        s += presenceScore(r.dontClause, 0.1);
+        return Math.min(1, s);
+    }
+    /**
+     * 内容深度 (0-1)
+     * markdown 丰富度 + 结构化标记 + 设计原理 + 来源引用
+     */
+    #scoreContentDepth(r) {
+        let s = 0;
+        const md = r.contentMarkdown || r.usageGuide || '';
+        // markdown 内容长度 (最优 200-800 字符)
+        s += textScore(md || undefined, 50, 800, 0.3);
+        // 结构化标记: 标题 / 代码块 / 列表
+        if (md) {
+            if (/^#{1,4}\s/m.test(md)) {
+                s += 0.08;
+            }
+            if (/```[\s\S]*?```|`[^`]+`/.test(md)) {
+                s += 0.08;
+            }
+            if (/^[\s]*[-*+]\s/m.test(md)) {
+                s += 0.04;
+            }
         }
-        if (r.code && r.code.trim().length > 5) {
-            s += 0.3;
+        // rationale: 设计原理
+        s += textScore(r.contentRationale, 10, 100, 0.15);
+        // reasoning.whyStandard
+        s += textScore(r.reasoningWhyStandard, 10, 100, 0.15);
+        // reasoning.sources 来源文件
+        if (r.reasoningSources && r.reasoningSources.length > 0) {
+            s += Math.min(0.1, r.reasoningSources.length * 0.03);
         }
-        if (r.usageGuide?.trim()) {
-            s += 0.2;
+        // usageGuide（如果与 markdown 不同则额外加分）
+        if (r.usageGuide && r.usageGuide !== md) {
+            s += textScore(r.usageGuide, 20, 200, 0.1);
         }
-        return s;
+        return Math.min(1, s);
     }
-    /** 格式: trigger 格式(0.5) + language 合法性(0.5) */
-    #scoreFormat(r) {
+    /**
+     * 交付就绪度 (0-1)
+     * trigger 格式 + language 合法性 + 分类 + 标签
+     */
+    #scoreDeliveryReady(r) {
         let s = 0;
+        // trigger 格式
         if (r.trigger) {
-            if (/^[a-zA-Z0-9_\-:.]+$/.test(r.trigger) &&
-                r.trigger.length >= 2 &&
-                r.trigger.length <= 64) {
-                s += 0.5;
-            }
-            else if (r.trigger.length >= 2) {
-                s += 0.25;
-            }
+            const valid = /^[a-zA-Z0-9_\-:.@]+$/.test(r.trigger) && r.trigger.length >= 2 && r.trigger.length <= 80;
+            s += valid ? 0.25 : r.trigger.length >= 2 ? 0.15 : 0;
         }
+        // language 合法性
         if (r.language) {
-            const valid = new Set([
-                'swift',
-                'objective-c',
-                'objc',
-                'javascript',
-                'typescript',
-                'python',
-                'c',
-                'cpp',
-                'shell',
-                'markdown',
-            ]);
-            s += valid.has(r.language.toLowerCase()) ? 0.5 : 0.25;
-        }
-        return s;
-    }
-    /** 代码质量: 长度适中(0.3) + 无 TODO(0.2) + 有注释(0.3) + 有错误处理(0.2) */
-    #scoreCodeQuality(r) {
-        if (!r.code) {
-            return 0;
+            s += LanguageProfiles.validCodeLanguages.has(r.language.toLowerCase()) ? 0.25 : 0.1;
+        }
+        // category
+        s += presenceScore(r.category, 0.2);
+        // tags 丰富度
+        if (r.tags && r.tags.length > 0) {
+            s += Math.min(0.15, r.tags.length * 0.04);
         }
+        // headers (语言相关导入声明)
+        if (r.headers && r.headers.length > 0) {
+            s += Math.min(0.15, r.headers.length * 0.05);
+        }
+        return Math.min(1, s);
+    }
+    /**
+     * 可操作性 (0-1)
+     * AI agent 能否基于此知识有效行动
+     */
+    #scoreActionability(r) {
         let s = 0;
-        const code = r.code;
-        // 长度适中
-        if (code.length >= CODE_LENGTH.MIN && code.length <= CODE_LENGTH.MAX) {
+        const code = r.coreCode || '';
+        const md = r.contentMarkdown || r.usageGuide || '';
+        // 具体代码示例
+        const codeLen = code.trim().length;
+        if (codeLen >= 30 && codeLen <= 500) {
             s += 0.3;
         }
-        else if (code.length > CODE_LENGTH.MAX) {
-            s += 0.15;
+        else if (codeLen >= 10) {
+            s += 0.2;
         }
-        // 无 TODO/FIXME/HACK
-        if (!/\b(TODO|FIXME|HACK|XXX)\b/.test(code)) {
+        else if (/```[\s\S]{10,}?```/.test(md)) {
             s += 0.2;
         }
-        // 有注释
-        if (/\/\/|\/\*|#\s/.test(code)) {
-            s += 0.3;
+        // doClause 具体度
+        if (r.doClause) {
+            const len = r.doClause.trim().length;
+            s += len >= 15 && len <= 200 ? 0.25 : len >= 5 ? 0.1 : 0;
         }
-        // 有错误处理
-        if (/try|catch|throw|guard|if\s+let|do\s*\{|\.catch/.test(code)) {
+        // 正反约束（do + don't → 引导更精确）
+        if (r.doClause?.trim() && r.dontClause?.trim()) {
             s += 0.2;
         }
-        return s;
+        else if (r.doClause?.trim()) {
+            s += 0.1;
+        }
+        // whenClause 具体度
+        if (r.whenClause) {
+            const len = r.whenClause.trim().length;
+            s += len >= 15 ? 0.25 : len >= 5 ? 0.1 : 0;
+        }
+        return Math.min(1, s);
     }
-    /** 元数据: category(0.35) + tags/headers(0.35) + summary(0.3) */
-    #scoreMetadata(r) {
+    /**
+     * 溯源可信度 (0-1)
+     * 知识的可追溯性和可信度
+     */
+    #scoreProvenance(r) {
         let s = 0;
-        if (r.category?.trim()) {
-            s += 0.35;
+        // AI confidence (0-1 → 0-0.30)
+        if (r.reasoningConfidence != null && r.reasoningConfidence > 0) {
+            s += r.reasoningConfidence * 0.3;
         }
-        if ((r.tags && r.tags.length > 0) || (r.headers && r.headers.length > 0)) {
-            s += 0.35;
+        // 来源文件引用
+        if (r.reasoningSources && r.reasoningSources.length > 0) {
+            s += Math.min(0.3, r.reasoningSources.length * 0.1);
         }
-        if (r.summary?.trim()) {
-            s += 0.3;
+        // 来源类型 (manual > mcp > bootstrap)
+        if (r.source === 'manual') {
+            s += 0.2;
         }
-        return s;
-    }
-    /** 互动: views(0.3) + clicks(0.3) + rating(0.4) */
-    #scoreEngagement(r) {
-        let s = 0;
-        if (r.views && r.views > 0) {
-            s += Math.min(0.3, (r.views / 100) * 0.3);
+        else if (r.source === 'mcp') {
+            s += 0.15;
         }
-        if (r.clicks && r.clicks > 0) {
-            s += Math.min(0.3, (r.clicks / 50) * 0.3);
+        else if (r.source === 'bootstrap' || r.source === 'cursor-scan') {
+            s += 0.1;
         }
+        // usage authority (0-5 → 0-0.20)
         if (r.rating && r.rating > 0) {
-            s += (r.rating / 5) * 0.4;
+            s += (r.rating / 5) * 0.2;
         }
-        return s;
+        return Math.min(1, s);
     }
     /** 分数转等级 */
     #toGrade(score) {

package/dist/lib/service/search/SearchEngine.d.ts

@@ -18,6 +18,7 @@ export { tokenize } from './tokenizer.js';
  * 整合召回评分 + 关键词 + 可选 AI 增强
  */
 export declare class SearchEngine {
+    #private;
     _cache: Map<string, {
         data: SearchResponse;
         time: number;

package/dist/lib/service/search/SearchEngine.js

@@ -5,6 +5,7 @@
  * 从 V1 SearchServiceV2 迁移，适配 V2 架构
  */
 import Logger from '../../infrastructure/logging/Logger.js';
+import { RawDbKnowledgeAdapter, RawDbSourceRefAdapter, unwrapSearchDb, } from '../../repository/search/SearchRepoAdapter.js';
 import { CoarseRanker } from './CoarseRanker.js';
 import { contextBoost } from './contextBoost.js';
 import { FieldWeightedScorer } from './FieldWeightedScorer.js';
@@ -32,12 +33,19 @@ export class SearchEngine {
     aiProvider;
     db;
     hybridRetriever;
+    #knowledgeRepo;
+    #sourceRefRepo;
     logger;
     scorer;
     vectorService;
     vectorStore;
     constructor(db, options = {}) {
-        this.db = (typeof db?.getDb === 'function' ? db.getDb() : db);
+        this.db = unwrapSearchDb(db);
+        const opts = options;
+        this.#knowledgeRepo =
+            opts.knowledgeRepo ?? new RawDbKnowledgeAdapter(this.db);
+        this.#sourceRefRepo =
+            opts.sourceRefRepo ?? new RawDbSourceRefAdapter(this.db);
         this.logger = Logger.getInstance();
         this.aiProvider = options.aiProvider || null;
         this.vectorStore = options.vectorStore || null;
@@ -62,13 +70,8 @@ export class SearchEngine {
         try {
             let entries = [];
             try {
-                entries = this.db
-                    .prepare(`SELECT id, title, description, language, category, knowledgeType, kind,
-                  content, lifecycle, tags, trigger, difficulty, quality, stats,
-                  updatedAt, createdAt
-           FROM knowledge_entries WHERE lifecycle != 'deprecated'`)
-                    .all();
-                entries = entries.map((e) => ({
+                const rawEntries = this.#knowledgeRepo.findNonDeprecatedSync();
+                entries = rawEntries.map((e) => ({
                     ...e,
                     status: e.lifecycle,
                 }));
@@ -316,12 +319,12 @@ export class SearchEngine {
             try {
                 let rows = [];
                 try {
-                    rows = this.db
-                        .prepare(`SELECT id, title, description, language, category, knowledgeType, kind, lifecycle as status, content, trigger, headers, moduleName, 'knowledge' as type
-             FROM knowledge_entries
-             WHERE lifecycle != 'deprecated' AND (title LIKE ? ESCAPE '\\' OR description LIKE ? ESCAPE '\\' OR trigger LIKE ? ESCAPE '\\' OR content LIKE ? ESCAPE '\\')
-             LIMIT ?`)
-                        .all(pattern, pattern, pattern, pattern, limit);
+                    const rawRows = this.#knowledgeRepo.keywordSearchSync(pattern, limit);
+                    rows = rawRows.map((r) => ({
+                        ...r,
+                        status: r.lifecycle ?? r.status,
+                        type: 'knowledge',
+                    }));
                 }
                 catch {
                     /* table may not exist */
@@ -549,15 +552,9 @@ export class SearchEngine {
         }
         try {
             const ids = items.map((it) => it.id);
-            const placeholders = ids.map(() => '?').join(',');
             let rows = [];
             try {
-                rows = this.db
-                    .prepare(`SELECT id, content, description, trigger, headers, moduleName,
-                  tags, language, category, updatedAt, createdAt, quality, stats, difficulty,
-                  whenClause, doClause
-           FROM knowledge_entries WHERE id IN (${placeholders})`)
-                    .all(...ids);
+                rows = this.#knowledgeRepo.findByIdsDetailSync(ids);
             }
             catch {
                 /* table may not exist */
@@ -642,23 +639,26 @@ export class SearchEngine {
             if (ids.length === 0) {
                 return;
             }
-            const placeholders = ids.map(() => '?').join(',');
-            const refsRows = this.db
-                .prepare(`SELECT recipe_id, source_path, status, new_path
-           FROM recipe_source_refs
-           WHERE recipe_id IN (${placeholders}) AND status != 'stale'`)
-                .all(...ids);
+            let refsRows;
+            refsRows = this.#sourceRefRepo.findActiveByRecipeIds(ids);
             this.logger.debug('recipe_source_refs query', {
                 idCount: ids.length,
                 rowCount: refsRows.length,
             });
             const refsMap = new Map();
             for (const row of refsRows) {
-                const refPath = row.status === 'renamed' && row.new_path ? row.new_path : row.source_path;
-                if (!refsMap.has(row.recipe_id)) {
-                    refsMap.set(row.recipe_id, []);
+                const recipeId = row.recipeId ??
+                    row.recipe_id;
+                const sourcePath = row.sourcePath ??
+                    row.source_path;
+                const status = row.status;
+                const newPath = row.newPath ??
+                    row.new_path;
+                const refPath = status === 'renamed' && newPath ? newPath : sourcePath;
+                if (!refsMap.has(recipeId)) {
+                    refsMap.set(recipeId, []);
                 }
-                refsMap.get(row.recipe_id)?.push(refPath);
+                refsMap.get(recipeId)?.push(refPath);
             }
             for (const item of items) {
                 const refs = refsMap.get(item.id);
@@ -692,12 +692,7 @@ export class SearchEngine {
         this._cache.clear();
         try {
             // 查找自上次索引后更新的条目
-            const changed = this.db
-                .prepare(`SELECT id, title, description, language, category, knowledgeType, kind,
-                  content, lifecycle, tags, trigger, difficulty, quality, stats,
-                  updatedAt, createdAt
-           FROM knowledge_entries WHERE updatedAt > ?`)
-                .all(this._lastIndexTime);
+            const changed = this.#knowledgeRepo.findUpdatedSinceSync(this._lastIndexTime);
             let added = 0;
             let removed = 0;
             for (const r of changed) {

package/dist/lib/service/signal/HitRecorder.js

@@ -11,6 +11,7 @@
  *
  * @module service/signal/HitRecorder
  */
+import { unwrapRawDb } from '../../repository/search/SearchRepoAdapter.js';
 /** 事件类型 → Stats JSON 字段 映射 */
 const EVENT_TO_STATS_FIELD = {
     guardHit: 'guardHits',
@@ -39,10 +40,7 @@ export class HitRecorder {
     #totalFlushed = 0;
     constructor(bus, db, config = {}) {
         this.#bus = bus;
-        this.#db =
-            'getDb' in db && typeof db.getDb === 'function'
-                ? db.getDb()
-                : db;
+        this.#db = unwrapRawDb(db);
         this.#flushIntervalMs = config.flushIntervalMs ?? 30_000;
         this.#maxBufferSize = config.maxBufferSize ?? 100;
     }
@@ -123,7 +121,9 @@ export class HitRecorder {
         let flushed = 0;
         const now = Math.floor(Date.now() / 1000);
         try {
-            const stmt = this.#db.prepare(`UPDATE knowledge_entries
+            const stmt = this.#db.prepare(
+            // @escape-hatch(permanent) — json_set() not expressible in Drizzle
+            `UPDATE knowledge_entries
          SET stats = json_set(
                COALESCE(stats, '{}'),
                '$.' || ?,

package/dist/lib/service/skills/RuleRecallStrategy.js

@@ -10,11 +10,15 @@ export class RuleRecallStrategy {
     name = 'rule';
     type = 'rule';
     async recall(context) {
-        const db = context.database;
+        const ct = context.container;
+        const knowledgeRepo = (ct?.get?.('knowledgeRepository') ||
+            null);
+        const auditRepo = (ct?.get?.('auditRepository') || null);
         const advisor = new SkillAdvisor(context.projectRoot, {
-            database: db,
+            knowledgeRepo,
+            auditRepo,
         });
-        const result = advisor.suggest();
+        const result = await advisor.suggest();
         // 过滤已有 Skill
         const existingSet = context.existingSkills ?? new Set();
         return result.suggestions

package/dist/lib/service/skills/SignalCollector.d.ts

@@ -36,9 +36,12 @@
  * 生命周期：
  *   new SignalCollector(opts) → instance.start() → ... → instance.stop()
  */
+import type { AuditRepositoryImpl } from '../../repository/audit/AuditRepository.js';
+import type { KnowledgeRepositoryImpl } from '../../repository/knowledge/KnowledgeRepository.impl.js';
 interface SignalCollectorOpts {
     projectRoot: string;
-    database?: DatabaseLike | null;
+    knowledgeRepo?: KnowledgeRepositoryImpl | null;
+    auditRepo?: AuditRepositoryImpl | null;
     agentFactory?: AgentFactoryLike | null;
     container?: ContainerLike | null;
     signalBus?: import('../../infrastructure/signal/SignalBus.js').SignalBus | null;
@@ -46,12 +49,6 @@ interface SignalCollectorOpts {
     intervalMs?: number;
     onSuggestions?: ((suggestions: Record<string, unknown>[]) => void) | null;
 }
-interface DatabaseLike {
-    prepare(sql: string): {
-        all(...args: unknown[]): Record<string, unknown>[];
-        get(...args: unknown[]): Record<string, unknown> | undefined;
-    };
-}
 interface AgentResult {
     reply?: string;
     text?: string;
@@ -87,7 +84,7 @@ export declare class SignalCollector {
      * @param [opts.intervalMs] 初始收集间隔（毫秒），后续由 AI 动态调整
      * @param [opts.onSuggestions] 新建议回调 (suggestions[]) => void
      */
-    constructor({ projectRoot, database, agentFactory, container, signalBus, mode, intervalMs, onSuggestions, }: SignalCollectorOpts);
+    constructor({ projectRoot, knowledgeRepo, auditRepo, agentFactory, container, signalBus, mode, intervalMs, onSuggestions, }: SignalCollectorOpts);
     start(): void;
     stop(): void;
     /**