autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/snippet/codecs/VSCodeCodec.js

@@ -34,16 +34,14 @@ export class VSCodeCodec extends SnippetCodec {
     get fileExtension() {
         return '.code-snippets';
     }
-    /**
-     * 单个 SnippetSpec → JSON 字符串
-     */
+    /** 单个 SnippetSpec → JSON 字符串 */
     generate(spec) {
         const entry = this.#specToEntry(spec);
         return JSON.stringify({ [spec.title || spec.identifier]: entry }, null, 2);
     }
     /**
      * VSCode: 所有 snippets 合并为单个 JSON bundle 文件
-     * @returns {string} JSON 字符串
+     * @returns JSON 字符串
      */
     generateBundle(specs) {
         const bundle = {};
@@ -53,9 +51,7 @@ export class VSCodeCodec extends SnippetCodec {
         }
         return `${JSON.stringify(bundle, null, 2)}\n`;
     }
-    /**
-     * VSCode snippets 安装目录 = 项目级 .vscode/
-     */
+    /** VSCode snippets 安装目录 = 项目级 .vscode/ */
     getInstallDir(projectRoot) {
         return join(projectRoot, '.vscode');
     }
@@ -65,9 +61,7 @@ export class VSCodeCodec extends SnippetCodec {
     getBundleFilename() {
         return BUNDLE_FILENAME;
     }
-    /**
-     * @private SnippetSpec → VSCode snippet entry
-     */
+    /** @private SnippetSpec → VSCode snippet entry */
     #specToEntry(spec) {
         const code = Array.isArray(spec.code) ? spec.code.join('\n') : spec.code || '';
         // 自动将 Xcode 占位符转为 VSCode 格式
@@ -86,4 +80,3 @@ export class VSCodeCodec extends SnippetCodec {
         return entry;
     }
 }
-//# sourceMappingURL=VSCodeCodec.js.map

package/dist/lib/service/task/TaskGraphService.d.ts

@@ -27,20 +27,13 @@ export declare class TaskGraphService {
     logger: ReturnType<typeof Logger.getInstance>;
     readyEngine: import('./TaskReadyEngine.js').TaskReadyEngine;
     repo: import('../../repository/task/TaskRepository.impl.js').TaskRepositoryImpl;
-    /**
-     * @param {import('../../repository/task/TaskRepository.impl.js').TaskRepositoryImpl} repository
-     * @param {import('./TaskReadyEngine.js').TaskReadyEngine} readyEngine
-     * @param {import('./TaskKnowledgeBridge.js').TaskKnowledgeBridge} [knowledgeBridge]
-     * @param {object} [auditLogger]
-     * @param {import('../../domain/task/TaskIdGenerator.js').TaskIdGenerator} idGenerator
-     */
     constructor(repository: import('../../repository/task/TaskRepository.impl.js').TaskRepositoryImpl, readyEngine: import('./TaskReadyEngine.js').TaskReadyEngine, knowledgeBridge: import('./TaskKnowledgeBridge.js').TaskKnowledgeBridge | null, auditLogger: {
         log: (taskId: string, eventType: string, oldValue: string | null, newValue: string | null) => void;
     } | null, idGenerator: import('../../domain/task/TaskIdGenerator.js').TaskIdGenerator);
     /**
      * 创建任务
-     * @param {object} data - { title, description, design, acceptance, priority, taskType, parentId }
-     * @returns {Promise<{ task: Task, isDuplicate: boolean }>}
+     * @param data { title, description, design, acceptance, priority, taskType, parentId }
+     * @returns >}
      */
     create(data: {
         title?: string;
@@ -58,9 +51,7 @@ export declare class TaskGraphService {
      * 批量拆解 Epic
      * 一次性创建多个子任务 + 依赖关系，减少 Agent 的 MCP 调用次数
      *
-     * @param {string} epicId
-     * @param {Array<object>} subtasks - [{ title, description, priority, taskType, blockedByIndex }]
-     * @returns {Promise<Task[]>}
+     * @param subtasks [{ title, description, priority, taskType, blockedByIndex }]
      */
     decompose(epicId: string, subtasks: Array<Record<string, unknown>>): Promise<Task[]>;
     /**
@@ -69,19 +60,14 @@ export declare class TaskGraphService {
      * P5: claim-time 知识刷新 — 编码开始时注入最新知识上下文，
      * 减少 Agent 额外 MCP 调用。
      *
-     * @param {string} id
-     * @param {string} [assignee='agent']
-     * @param {KnowledgeEnrichOptions} [knowledgeOptions] - 上下文信号
-     * @returns {Promise<Task>}
+     * @param [knowledgeOptions] 上下文信号
      */
     claim(id: string, assignee?: string, knowledgeOptions?: KnowledgeEnrichOptions): Promise<Task>;
     /**
      * 关闭任务
      * 返回因此解除阻塞的新就绪任务列表
      *
-     * @param {string} id
-     * @param {string} [reason='Completed']
-     * @returns {Promise<{ task: Task, newlyReady: string[] }>}
+     * @returns >}
      */
     close(id: string, reason?: string): Promise<{
         task: Task | null;
@@ -90,45 +76,23 @@ export declare class TaskGraphService {
     /**
      * 标记任务失败
      * 释放认领、递增失败计数、回退到 open
-     *
-     * @param {string} id
-     * @param {string} reason
-     * @returns {Promise<Task>}
      */
     fail(id: string, reason: string): Promise<Task | null>;
-    /**
-     * 推迟任务
-     * @param {string} id
-     * @param {string} [reason='']
-     * @returns {Promise<Task>}
-     */
+    /** 推迟任务 */
     defer(id: string, reason?: string): Promise<Task | null>;
-    /**
-     * 上报进度（长任务的中间状态更新）
-     * @param {string} id
-     * @param {string} note
-     * @returns {Promise<Task>}
-     */
+    /** 上报进度（长任务的中间状态更新） */
     progress(id: string, note: string): Promise<Task | null>;
-    /**
-     * 添加依赖
-     * @param {string} taskId
-     * @param {string} dependsOnId
-     * @param {string} [depType='blocks']
-     */
+    /** 添加依赖 */
     addDependency(taskId: string, dependsOnId: string, depType?: string): Promise<void>;
     /**
      * 获取就绪任务 + 知识上下文
-     * @param {object} [options] - { limit, withKnowledge, userQuery, activeFile, language }
-     * @returns {Promise<Task[]>}
+     * @param [options] { limit, withKnowledge, userQuery, activeFile, language }
      */
     ready(options?: {
         limit?: number;
         withKnowledge?: boolean;
     } & KnowledgeEnrichOptions): Promise<Task[]>;
-    /**
-     * 获取被阻塞的任务
-     */
+    /** 获取被阻塞的任务 */
     blocked(): Promise<{
         blockedBy: string[];
         knowledgeContext?: Record<string, unknown> | undefined;
@@ -153,22 +117,15 @@ export declare class TaskGraphService {
         lastFailReason?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[]>;
-    /**
-     * 获取单个任务详情
-     * @param {string} id
-     * @returns {Promise<Task|null>}
-     */
+    /** 获取单个任务详情 */
     show(id: string): Promise<Task | null>;
     /**
      * 列表查询
-     * @param {object} filters - { status, taskType, assignee, parentId }
-     * @param {object} options - { limit }
-     * @returns {Promise<Task[]>}
+     * @param filters { status, taskType, assignee, parentId }
+     * @param options { limit }
      */
     list(filters?: Record<string, unknown>, options?: {}): Promise<(Task | null)[]>;
-    /**
-     * 依赖树
-     */
+    /** 依赖树 */
     depTree(taskId: string): Promise<{
         depth: unknown;
         knowledgeContext?: Record<string, unknown> | undefined;
@@ -193,9 +150,7 @@ export declare class TaskGraphService {
         lastFailReason?: string | undefined;
         metadata?: Record<string, unknown> | undefined;
     }[]>;
-    /**
-     * 统计信息
-     */
+    /** 统计信息 */
     stats(): Promise<{
         total: number;
         open: number;
@@ -213,8 +168,8 @@ export declare class TaskGraphService {
      * P1: 新增 userQuery / activeFile / language 参数，
      *     知识注入从「基于历史任务」升级为「基于历史任务 + 当前用户意图」。
      *
-     * @param {object} [options] - { withKnowledge, userQuery, activeFile, language }
-     * @returns {Promise<{ inProgress: Task[], ready: Task[], stats: object }>}
+     * @param [options] { withKnowledge, userQuery, activeFile, language }
+     * @returns >}
      */
     prime(options?: {
         limit?: number;
@@ -222,8 +177,8 @@ export declare class TaskGraphService {
     } & KnowledgeEnrichOptions): Promise<Record<string, unknown>>;
     /**
      * 记录决策 — 直接以 pinned 状态创建，避免 open→pinned 的幽灵窗口（C1）
-     * @param {object} params - { title, description, rationale, tags, relatedTaskId }
-     * @returns {Promise<{ task: Task, isDuplicate: boolean }>}
+     * @param params { title, description, rationale, tags, relatedTaskId }
+     * @returns >}
      */
     recordDecision({ title, description, rationale, tags, relatedTaskId, }: {
         title: string;
@@ -237,8 +192,8 @@ export declare class TaskGraphService {
     }>;
     /**
      * 修订决策 — 原子事务：创建新决策 + 关闭旧决策 + 建立 supersedes 链（C2+C7）
-     * @param {object} params - { oldDecisionId, title, description, rationale, reason }
-     * @returns {Promise<{ newDecision: Task, oldDecisionId: string }>}
+     * @param params { oldDecisionId, title, description, rationale, reason }
+     * @returns >}
      */
     reviseDecision({ oldDecisionId, title, description, rationale, reason, }: {
         oldDecisionId: string;
@@ -250,12 +205,7 @@ export declare class TaskGraphService {
         newDecision: Task;
         oldDecisionId: string;
     }>;
-    /**
-     * 取消固定决策
-     * @param {string} id
-     * @param {string} [reason='']
-     * @returns {Promise<Task>}
-     */
+    /** 取消固定决策 */
     unpinDecision(id: string, reason?: string): Promise<Task | null>;
     /**
      * P2: 获取决策过期阈值（秒）
@@ -269,10 +219,7 @@ export declare class TaskGraphService {
      * @private
      */
     _checkNewlyUnblocked(closedTaskId: string): string[];
-    /**
-     * @private
-     */
+    /** @private */
     _logEvent(taskId: string, eventType: string, oldValue: string | null, newValue: string | null): void;
 }
 export default TaskGraphService;
-//# sourceMappingURL=TaskGraphService.d.ts.map

package/dist/lib/service/task/TaskGraphService.js

@@ -25,13 +25,6 @@ export class TaskGraphService {
     logger;
     readyEngine;
     repo;
-    /**
-     * @param {import('../../repository/task/TaskRepository.impl.js').TaskRepositoryImpl} repository
-     * @param {import('./TaskReadyEngine.js').TaskReadyEngine} readyEngine
-     * @param {import('./TaskKnowledgeBridge.js').TaskKnowledgeBridge} [knowledgeBridge]
-     * @param {object} [auditLogger]
-     * @param {import('../../domain/task/TaskIdGenerator.js').TaskIdGenerator} idGenerator
-     */
     constructor(repository, readyEngine, knowledgeBridge, auditLogger, idGenerator) {
         this.repo = repository;
         this.readyEngine = readyEngine;
@@ -43,8 +36,8 @@ export class TaskGraphService {
     // ═══ 创建 ═══════════════════════════════════════════
     /**
      * 创建任务
-     * @param {object} data - { title, description, design, acceptance, priority, taskType, parentId }
-     * @returns {Promise<{ task: Task, isDuplicate: boolean }>}
+     * @param data { title, description, design, acceptance, priority, taskType, parentId }
+     * @returns >}
      */
     async create(data) {
         const task = new Task(data);
@@ -78,9 +71,7 @@ export class TaskGraphService {
      * 批量拆解 Epic
      * 一次性创建多个子任务 + 依赖关系，减少 Agent 的 MCP 调用次数
      *
-     * @param {string} epicId
-     * @param {Array<object>} subtasks - [{ title, description, priority, taskType, blockedByIndex }]
-     * @returns {Promise<Task[]>}
+     * @param subtasks [{ title, description, priority, taskType, blockedByIndex }]
      */
     async decompose(epicId, subtasks) {
         const epic = this.repo.findById(epicId);
@@ -142,10 +133,7 @@ export class TaskGraphService {
      * P5: claim-time 知识刷新 — 编码开始时注入最新知识上下文，
      * 减少 Agent 额外 MCP 调用。
      *
-     * @param {string} id
-     * @param {string} [assignee='agent']
-     * @param {KnowledgeEnrichOptions} [knowledgeOptions] - 上下文信号
-     * @returns {Promise<Task>}
+     * @param [knowledgeOptions] 上下文信号
      */
     async claim(id, assignee = 'agent', knowledgeOptions) {
         const task = this.repo.findById(id);
@@ -184,9 +172,7 @@ export class TaskGraphService {
      * 关闭任务
      * 返回因此解除阻塞的新就绪任务列表
      *
-     * @param {string} id
-     * @param {string} [reason='Completed']
-     * @returns {Promise<{ task: Task, newlyReady: string[] }>}
+     * @returns >}
      */
     async close(id, reason = 'Completed') {
         const task = this.repo.findById(id);
@@ -209,10 +195,6 @@ export class TaskGraphService {
     /**
      * 标记任务失败
      * 释放认领、递增失败计数、回退到 open
-     *
-     * @param {string} id
-     * @param {string} reason
-     * @returns {Promise<Task>}
      */
     async fail(id, reason) {
         const task = this.repo.findById(id);
@@ -230,12 +212,7 @@ export class TaskGraphService {
         this._logEvent(id, 'failed', 'in_progress', reason);
         return saved;
     }
-    /**
-     * 推迟任务
-     * @param {string} id
-     * @param {string} [reason='']
-     * @returns {Promise<Task>}
-     */
+    /** 推迟任务 */
     async defer(id, reason = '') {
         const task = this.repo.findById(id);
         if (!task) {
@@ -251,12 +228,7 @@ export class TaskGraphService {
         this._logEvent(id, 'deferred', oldStatus, reason);
         return saved;
     }
-    /**
-     * 上报进度（长任务的中间状态更新）
-     * @param {string} id
-     * @param {string} note
-     * @returns {Promise<Task>}
-     */
+    /** 上报进度（长任务的中间状态更新） */
     async progress(id, note) {
         const task = this.repo.findById(id);
         if (!task) {
@@ -273,12 +245,7 @@ export class TaskGraphService {
         return saved;
     }
     // ═══ 依赖管理 ═══════════════════════════════════════
-    /**
-     * 添加依赖
-     * @param {string} taskId
-     * @param {string} dependsOnId
-     * @param {string} [depType='blocks']
-     */
+    /** 添加依赖 */
     async addDependency(taskId, dependsOnId, depType = 'blocks') {
         if (taskId === dependsOnId) {
             throw new Error('Self-dependency is not allowed');
@@ -299,8 +266,7 @@ export class TaskGraphService {
     // ═══ 查询操作 ═══════════════════════════════════════
     /**
      * 获取就绪任务 + 知识上下文
-     * @param {object} [options] - { limit, withKnowledge, userQuery, activeFile, language }
-     * @returns {Promise<Task[]>}
+     * @param [options] { limit, withKnowledge, userQuery, activeFile, language }
      */
     async ready(options = {}) {
         const tasks = this.readyEngine.getReadyWork(options);
@@ -314,38 +280,27 @@ export class TaskGraphService {
         }
         return tasks;
     }
-    /**
-     * 获取被阻塞的任务
-     */
+    /** 获取被阻塞的任务 */
     async blocked() {
         return this.readyEngine.getBlockedWork();
     }
-    /**
-     * 获取单个任务详情
-     * @param {string} id
-     * @returns {Promise<Task|null>}
-     */
+    /** 获取单个任务详情 */
     async show(id) {
         return this.repo.findById(id);
     }
     /**
      * 列表查询
-     * @param {object} filters - { status, taskType, assignee, parentId }
-     * @param {object} options - { limit }
-     * @returns {Promise<Task[]>}
+     * @param filters { status, taskType, assignee, parentId }
+     * @param options { limit }
      */
     async list(filters = {}, options = {}) {
         return this.repo.findAll(filters, options);
     }
-    /**
-     * 依赖树
-     */
+    /** 依赖树 */
     async depTree(taskId) {
         return this.readyEngine.getDependencyTree(taskId);
     }
-    /**
-     * 统计信息
-     */
+    /** 统计信息 */
     async stats() {
         return this.repo.getStatistics();
     }
@@ -358,8 +313,8 @@ export class TaskGraphService {
      * P1: 新增 userQuery / activeFile / language 参数，
      *     知识注入从「基于历史任务」升级为「基于历史任务 + 当前用户意图」。
      *
-     * @param {object} [options] - { withKnowledge, userQuery, activeFile, language }
-     * @returns {Promise<{ inProgress: Task[], ready: Task[], stats: object }>}
+     * @param [options] { withKnowledge, userQuery, activeFile, language }
+     * @returns >}
      */
     async prime(options = {}) {
         const inProgress = this.repo
@@ -457,8 +412,8 @@ export class TaskGraphService {
     // ═══ 决策管理 ═══════════════════════════════════════
     /**
      * 记录决策 — 直接以 pinned 状态创建，避免 open→pinned 的幽灵窗口（C1）
-     * @param {object} params - { title, description, rationale, tags, relatedTaskId }
-     * @returns {Promise<{ task: Task, isDuplicate: boolean }>}
+     * @param params { title, description, rationale, tags, relatedTaskId }
+     * @returns >}
      */
     async recordDecision({ title, description, rationale, tags, relatedTaskId, }) {
         if (!title) {
@@ -514,8 +469,8 @@ export class TaskGraphService {
     }
     /**
      * 修订决策 — 原子事务：创建新决策 + 关闭旧决策 + 建立 supersedes 链（C2+C7）
-     * @param {object} params - { oldDecisionId, title, description, rationale, reason }
-     * @returns {Promise<{ newDecision: Task, oldDecisionId: string }>}
+     * @param params { oldDecisionId, title, description, rationale, reason }
+     * @returns >}
      */
     async reviseDecision({ oldDecisionId, title, description, rationale, reason, }) {
         // 事务前验证
@@ -564,12 +519,7 @@ export class TaskGraphService {
         this._logEvent(newDecision.id, 'supersedes', null, oldDecisionId);
         return { newDecision, oldDecisionId };
     }
-    /**
-     * 取消固定决策
-     * @param {string} id
-     * @param {string} [reason='']
-     * @returns {Promise<Task>}
-     */
+    /** 取消固定决策 */
     async unpinDecision(id, reason = '') {
         const task = this.repo.findById(id);
         if (!task) {
@@ -637,9 +587,7 @@ export class TaskGraphService {
         }
         return newlyReady;
     }
-    /**
-     * @private
-     */
+    /** @private */
     _logEvent(taskId, eventType, oldValue, newValue) {
         try {
             this.repo.logEvent(taskId, eventType, oldValue, newValue);
@@ -650,4 +598,3 @@ export class TaskGraphService {
     }
 }
 export default TaskGraphService;
-//# sourceMappingURL=TaskGraphService.js.map

package/dist/lib/service/task/TaskKnowledgeBridge.d.ts

@@ -30,9 +30,6 @@ export declare class TaskKnowledgeBridge {
     logger: ReturnType<typeof Logger.getInstance>;
     /** 任务级知识缓存 (taskId → CacheEntry) */
     private _cache;
-    /**
-     * @param {import('../../service/search/SearchEngine.js').SearchEngine} searchEngine
-     */
     constructor(searchEngine: {
         search: (query: string, options: Record<string, unknown>) => Promise<Record<string, unknown>>;
     });
@@ -115,4 +112,3 @@ export declare class TaskKnowledgeBridge {
     clearCache(): void;
 }
 export default TaskKnowledgeBridge;
-//# sourceMappingURL=TaskKnowledgeBridge.d.ts.map

package/dist/lib/service/task/TaskKnowledgeBridge.js

@@ -42,9 +42,6 @@ export class TaskKnowledgeBridge {
     logger;
     /** 任务级知识缓存 (taskId → CacheEntry) */
     _cache = new Map();
-    /**
-     * @param {import('../../service/search/SearchEngine.js').SearchEngine} searchEngine
-     */
     constructor(searchEngine) {
         this._search = searchEngine;
         this.logger = Logger.getInstance();
@@ -307,4 +304,3 @@ export class TaskKnowledgeBridge {
     }
 }
 export default TaskKnowledgeBridge;
-//# sourceMappingURL=TaskKnowledgeBridge.js.map

package/dist/lib/service/task/TaskReadyEngine.d.ts

@@ -13,9 +13,7 @@ export declare class TaskReadyEngine {
     _db: import('better-sqlite3').Database;
     _depTreeStmt: ReturnType<import('better-sqlite3').Database['prepare']>;
     _readyStmt: ReturnType<import('better-sqlite3').Database['prepare']>;
-    /**
-     * @param {import('better-sqlite3').Database} db - raw SQLite handle
-     */
+    /** @param db raw SQLite handle */
     constructor(db: import('better-sqlite3').Database);
     /** @private */
     _prepareStatements(): void;
@@ -23,17 +21,13 @@ export declare class TaskReadyEngine {
      * 获取就绪任务（核心方法）
      *
      * 就绪 = status='open' 且无未完成的阻塞型依赖（传递性检测）
-     *
-     * @param {object} [options]
-     * @param {number} [options.limit=10]
-     * @returns {Task[]}
      */
     getReadyWork(options?: {
         limit?: number;
     }): Task[];
     /**
      * 获取被阻塞的任务列表
-     * @returns {Array<Object>} 带 blocked_by 字段的任务列表
+     * @returns 带 blocked_by 字段的任务列表
      */
     getBlockedWork(): {
         blockedBy: string[];
@@ -61,8 +55,7 @@ export declare class TaskReadyEngine {
     }[];
     /**
      * 获取依赖树
-     * @param {string} taskId
-     * @returns {Array<Object>} 带 depth 的任务列表
+     * @returns 带 depth 的任务列表
      */
     getDependencyTree(taskId: string): {
         depth: unknown;
@@ -90,4 +83,3 @@ export declare class TaskReadyEngine {
     }[];
 }
 export default TaskReadyEngine;
-//# sourceMappingURL=TaskReadyEngine.d.ts.map

package/dist/lib/service/task/TaskReadyEngine.js

@@ -13,9 +13,7 @@ export class TaskReadyEngine {
     _db;
     _depTreeStmt;
     _readyStmt;
-    /**
-     * @param {import('better-sqlite3').Database} db - raw SQLite handle
-     */
+    /** @param db raw SQLite handle */
     constructor(db) {
         this._db = db;
         this._prepareStatements();
@@ -86,10 +84,6 @@ export class TaskReadyEngine {
      * 获取就绪任务（核心方法）
      *
      * 就绪 = status='open' 且无未完成的阻塞型依赖（传递性检测）
-     *
-     * @param {object} [options]
-     * @param {number} [options.limit=10]
-     * @returns {Task[]}
      */
     getReadyWork(options = {}) {
         const limit = Math.max(1, Math.min(options.limit || 10, 200));
@@ -98,7 +92,7 @@ export class TaskReadyEngine {
     }
     /**
      * 获取被阻塞的任务列表
-     * @returns {Array<Object>} 带 blocked_by 字段的任务列表
+     * @returns 带 blocked_by 字段的任务列表
      */
     getBlockedWork() {
         const rows = this._blockedStmt.all();
@@ -109,8 +103,7 @@ export class TaskReadyEngine {
     }
     /**
      * 获取依赖树
-     * @param {string} taskId
-     * @returns {Array<Object>} 带 depth 的任务列表
+     * @returns 带 depth 的任务列表
      */
     getDependencyTree(taskId) {
         const rows = this._depTreeStmt.all(taskId);
@@ -121,4 +114,3 @@ export class TaskReadyEngine {
     }
 }
 export default TaskReadyEngine;
-//# sourceMappingURL=TaskReadyEngine.js.map

package/dist/lib/service/vector/ContextualEnricher.d.ts

@@ -50,13 +50,8 @@ export declare class ContextualEnricher {
      * @returns 带上下文前缀的 chunks
      */
     enrichChunks(document: DocumentInfo, chunks: ChunkData[]): Promise<ChunkData[]>;
-    /**
-     * 清除缓存
-     */
+    /** 清除缓存 */
     clearCache(): void;
-    /**
-     * 当前缓存大小
-     */
+    /** 当前缓存大小 */
     get cacheSize(): number;
 }
-//# sourceMappingURL=ContextualEnricher.d.ts.map

package/dist/lib/service/vector/ContextualEnricher.js

@@ -82,15 +82,11 @@ export class ContextualEnricher {
         }
         return enriched;
     }
-    /**
-     * 清除缓存
-     */
+    /** 清除缓存 */
     clearCache() {
         this.#cache.clear();
     }
-    /**
-     * 当前缓存大小
-     */
+    /** 当前缓存大小 */
     get cacheSize() {
         return this.#cache.size;
     }
@@ -147,4 +143,3 @@ export class ContextualEnricher {
             .replace(/"/g, '"');
     }
 }
-//# sourceMappingURL=ContextualEnricher.js.map

package/dist/lib/service/vector/SyncCoordinator.d.ts

@@ -25,13 +25,9 @@ export interface SyncCoordinatorConfig {
 export declare class SyncCoordinator {
     #private;
     constructor(config: SyncCoordinatorConfig);
-    /**
-     * 绑定 EventBus，开始监听知识变更事件
-     */
+    /** 绑定 EventBus，开始监听知识变更事件 */
     bindEventBus(eventBus: EventBus): void;
-    /**
-     * 手动触发立即刷入（用于测试或 shutdown 前确保数据落盘）
-     */
+    /** 手动触发立即刷入（用于测试或 shutdown 前确保数据落盘） */
     flush(): Promise<void>;
     /**
      * 启动对账: 比较 DB knowledge_entries 与向量索引，修复不一致
@@ -55,9 +51,6 @@ export declare class SyncCoordinator {
         missingSynced: number;
         errors: string[];
     }>;
-    /**
-     * 销毁: 清理定时器和事件监听
-     */
+    /** 销毁: 清理定时器和事件监听 */
     destroy(): void;
 }
-//# sourceMappingURL=SyncCoordinator.d.ts.map