autosnippet 3.2.15 → 3.2.17

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

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

@@ -32,9 +32,7 @@ export class SyncCoordinator {
         this.#debounceMs = config.debounceMs;
         this.#maxBatchSize = config.maxBatchSize ?? 20;
     }
-    /**
-     * 绑定 EventBus，开始监听知识变更事件
-     */
+    /** 绑定 EventBus，开始监听知识变更事件 */
     bindEventBus(eventBus) {
         this.#eventBus = eventBus;
         this.#boundHandler = (data) => {
@@ -54,9 +52,7 @@ export class SyncCoordinator {
         });
         this.#logger.info('[SyncCoordinator] Bound to EventBus');
     }
-    /**
-     * 手动触发立即刷入（用于测试或 shutdown 前确保数据落盘）
-     */
+    /** 手动触发立即刷入（用于测试或 shutdown 前确保数据落盘） */
     async flush() {
         if (this.#debounceTimer) {
             clearTimeout(this.#debounceTimer);
@@ -130,9 +126,7 @@ export class SyncCoordinator {
         }
         return result;
     }
-    /**
-     * 销毁: 清理定时器和事件监听
-     */
+    /** 销毁: 清理定时器和事件监听 */
     destroy() {
         if (this.#debounceTimer) {
             clearTimeout(this.#debounceTimer);
@@ -287,4 +281,3 @@ export class SyncCoordinator {
         return parts.join('\n\n') || change.entryId;
     }
 }
-//# sourceMappingURL=SyncCoordinator.js.map

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

@@ -63,9 +63,7 @@ export type ProgressFn = (info: ProgressInfo) => void;
 export declare class VectorService {
     #private;
     constructor(config: VectorServiceConfig);
-    /**
-     * 初始化: 绑定 EventBus 事件监听
-     */
+    /** 初始化: 绑定 EventBus 事件监听 */
     initialize(): Promise<void>;
     /**
      * 全量构建向量索引
@@ -84,9 +82,7 @@ export declare class VectorService {
     incrementalUpdate(changedFiles: string[], opts?: {
         onProgress?: ProgressFn;
     }): Promise<BuildResult>;
-    /**
-     * 清空向量索引
-     */
+    /** 清空向量索引 */
     clear(): Promise<void>;
     /**
      * 校验向量索引健康状态
@@ -127,9 +123,7 @@ export declare class VectorService {
         score: number;
         [key: string]: unknown;
     }>>;
-    /**
-     * 通过 ID 查找相似向量
-     */
+    /** 通过 ID 查找相似向量 */
     similarById(id: string, topK?: number): Promise<Array<{
         item: Record<string, unknown>;
         score: number;
@@ -144,22 +138,16 @@ export declare class VectorService {
         content: unknown;
         kind?: string;
     }): Promise<void>;
-    /**
-     * 从向量索引移除一个条目
-     */
+    /** 从向量索引移除一个条目 */
     removeEntry(entryId: string): Promise<void>;
-    /**
-     * 批量同步知识条目
-     */
+    /** 批量同步知识条目 */
     batchSync(entries: Array<{
         id: string;
         title: string;
         content: unknown;
         kind?: string;
     }>): Promise<SyncResult>;
-    /**
-     * 获取向量索引统计信息
-     */
+    /** 获取向量索引统计信息 */
     getStats(): Promise<VectorStats>;
     /**
      * 迁移维度: 清空索引并使用新的 EmbedProvider 重建
@@ -168,9 +156,6 @@ export declare class VectorService {
     migrateDimension(newProvider: EmbedProvider, opts?: {
         onProgress?: ProgressFn;
     }): Promise<BuildResult>;
-    /**
-     * 销毁: 清理 SyncCoordinator 的定时器和事件监听
-     */
+    /** 销毁: 清理 SyncCoordinator 的定时器和事件监听 */
     destroy(): void;
 }
-//# sourceMappingURL=VectorService.d.ts.map

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

@@ -37,9 +37,7 @@ export class VectorService {
         this.#syncDebounceMs = config.syncDebounceMs;
     }
     // ═══ Lifecycle ═══
-    /**
-     * 初始化: 绑定 EventBus 事件监听
-     */
+    /** 初始化: 绑定 EventBus 事件监听 */
     async initialize() {
         if (this.#initialized) {
             return;
@@ -128,9 +126,7 @@ export class VectorService {
             duration: Date.now() - start,
         };
     }
-    /**
-     * 清空向量索引
-     */
+    /** 清空向量索引 */
     async clear() {
         await this.#vectorStore.clear();
         this.#logger.info('[VectorService] Vector index cleared');
@@ -253,9 +249,7 @@ export class VectorService {
             return [];
         }
     }
-    /**
-     * 通过 ID 查找相似向量
-     */
+    /** 通过 ID 查找相似向量 */
     async similarById(id, topK = 10) {
         try {
             const existing = await this.#vectorStore.getById(id);
@@ -313,9 +307,7 @@ export class VectorService {
             });
         }
     }
-    /**
-     * 从向量索引移除一个条目
-     */
+    /** 从向量索引移除一个条目 */
     async removeEntry(entryId) {
         try {
             await this.#vectorStore.remove(`entry_${entryId}`);
@@ -327,9 +319,7 @@ export class VectorService {
             });
         }
     }
-    /**
-     * 批量同步知识条目
-     */
+    /** 批量同步知识条目 */
     async batchSync(entries) {
         const result = { added: 0, updated: 0, removed: 0, errors: [] };
         if (!this.#embedProvider || entries.length === 0) {
@@ -374,9 +364,7 @@ export class VectorService {
         return result;
     }
     // ═══ 维护 ═══
-    /**
-     * 获取向量索引统计信息
-     */
+    /** 获取向量索引统计信息 */
     async getStats() {
         const raw = await this.#vectorStore.getStats();
         const stats = raw;
@@ -415,9 +403,7 @@ export class VectorService {
         return result;
     }
     // ═══ 生命周期 ═══
-    /**
-     * 销毁: 清理 SyncCoordinator 的定时器和事件监听
-     */
+    /** 销毁: 清理 SyncCoordinator 的定时器和事件监听 */
     destroy() {
         if (this.#syncCoordinator) {
             this.#syncCoordinator.destroy();
@@ -426,9 +412,7 @@ export class VectorService {
         this.#initialized = false;
     }
     // ═══ Private ═══
-    /**
-     * 从知识条目中提取可嵌入的文本
-     */
+    /** 从知识条目中提取可嵌入的文本 */
     #extractText(entry) {
         const parts = [];
         if (entry.title) {
@@ -453,4 +437,3 @@ export class VectorService {
         return parts.join('\n\n');
     }
 }
-//# sourceMappingURL=VectorService.js.map