autosnippet 3.2.15 → 3.2.17

package/dist/lib/service/snippet/SnippetFactory.js

@@ -12,50 +12,36 @@
  */
 export class SnippetFactory {
     _recipeRepo;
-    /** @type {Map<string, import('./codecs/SnippetCodec.js').SnippetCodec>} */
     #codecs = new Map();
-    /**
-     * @param {object} [knowledgeRepository] - KnowledgeRepositoryImpl（可选）
-     */
+    /** @param [knowledgeRepository] KnowledgeRepositoryImpl（可选） */
     constructor(knowledgeRepository) {
         this._recipeRepo = knowledgeRepository || null;
     }
     // ─────────────── Codec 注册 ───────────────
-    /**
-     * 注册一个 IDE codec
-     * @param {import('./codecs/SnippetCodec.js').SnippetCodec} codec
-     */
+    /** 注册一个 IDE codec */
     registerCodec(codec) {
         this.#codecs.set(codec.id, codec);
     }
     /**
      * 获取已注册的 codec
-     * @param {string} target - 'xcode' | 'vscode'
-     * @returns {import('./codecs/SnippetCodec.js').SnippetCodec|undefined}
+     * @param target 'xcode' | 'vscode'
      */
     getCodec(target) {
         return this.#codecs.get(target);
     }
-    /**
-     * 获取所有已注册 codec 的 ID 列表
-     * @returns {string[]}
-     */
+    /** 获取所有已注册 codec 的 ID 列表 */
     getRegisteredTargets() {
         return [...this.#codecs.keys()];
     }
     // ─────────────── 依赖注入 ───────────────
-    /**
-     * 运行时注入 knowledgeRepository（用于延迟绑定场景）
-     */
+    /** 运行时注入 knowledgeRepository（用于延迟绑定场景） */
     setKnowledgeRepository(repo) {
         this._recipeRepo = repo;
     }
     // ─────────────── Recipe → Snippet 查询 ───────────────
     /**
      * 从 Recipe 列表实时生成 Snippet 列表
-     * @param {object} [filters] - { language, category, keyword }
-     * @param {object} [pagination]
-     * @returns {Promise<Array>}
+     * @param [filters] { language, category, keyword }
      */
     async listSnippets(filters = {}, pagination = { page: 1, pageSize: 50 }) {
         if (!this._recipeRepo) {
@@ -78,9 +64,7 @@ export class SnippetFactory {
         const recipes = result?.data || result?.items || [];
         return recipes.map((r) => this.fromRecipe(r));
     }
-    /**
-     * 从单个 Recipe ID 实时生成 Snippet
-     */
+    /** 从单个 Recipe ID 实时生成 Snippet */
     async getSnippet(recipeId) {
         if (!this._recipeRepo) {
             return null;
@@ -94,9 +78,8 @@ export class SnippetFactory {
     // ─────────────── Codec 委托生成 ───────────────
     /**
      * 使用指定 codec 从 spec 生成 IDE 格式内容
-     * @param {object} spec - SnippetSpec
-     * @param {string} [target='xcode'] - codec ID
-     * @returns {string}
+     * @param spec SnippetSpec
+     * @param [target='xcode'] codec ID
      */
     generate(spec, target = 'xcode') {
         const codec = this.#resolveCodec(target);
@@ -104,9 +87,7 @@ export class SnippetFactory {
     }
     /**
      * 批量生成 (委托 codec)
-     * @param {Array} recipes
-     * @param {string} [target='xcode']
-     * @returns {Array<{ filename: string, content: string, spec: object }> | { filename: string, content: string, specs: object[] }}
+     * @returns > | { filename: string, content: string, specs: object[] }}
      */
     generateBatch(recipes, target = 'xcode') {
         const codec = this.#resolveCodec(target);
@@ -130,8 +111,8 @@ export class SnippetFactory {
     // ─────────────── Recipe → SnippetSpec ───────────────
     /**
      * 从 Recipe/Candidate 生成 IDE 无关的 snippet spec
-     * @param {object} recipe - { id, title, trigger, code, description, language }
-     * @returns {object} - SnippetSpec
+     * @param recipe { id, title, trigger, code, description, language }
+     * @returns SnippetSpec
      */
     fromRecipe(recipe) {
         return {
@@ -144,10 +125,6 @@ export class SnippetFactory {
         };
     }
     // ─────────────── Private ───────────────
-    /**
-     * @param {string} target
-     * @returns {import('./codecs/SnippetCodec.js').SnippetCodec}
-     */
     #resolveCodec(target) {
         const codec = this.#codecs.get(target);
         if (!codec) {
@@ -166,4 +143,3 @@ export class SnippetFactory {
             .slice(0, 50);
     }
 }
-//# sourceMappingURL=SnippetFactory.js.map

package/dist/lib/service/snippet/SnippetInstaller.d.ts

@@ -27,10 +27,8 @@ interface InstallerOptions {
 export declare class SnippetInstaller {
     #private;
     /**
-     * @param {object} options
-     * @param {import('./codecs/SnippetCodec.js').SnippetCodec} options.codec - IDE codec
-     * @param {import('./SnippetFactory.js').SnippetFactory} [options.snippetFactory]
-     * @param {string} [options.snippetsDir] 覆盖 codec 默认目录
+     * @param options.codec IDE codec
+     * @param [options.snippetsDir] 覆盖 codec 默认目录
      */
     constructor(options?: InstallerOptions);
     /** codec ID ('xcode' | 'vscode') */
@@ -41,9 +39,9 @@ export declare class SnippetInstaller {
     setCodec(codec: SnippetCodec): void;
     /**
      * 安装单个 snippet spec
-     * @param {object} spec - SnippetSpec
-     * @param {string} [projectRoot] - VSCode 需要 projectRoot 确定 .vscode/ 路径
-     * @returns {{ success: boolean, path: string, message: string }}
+     * @param spec SnippetSpec
+     * @param [projectRoot] VSCode 需要 projectRoot 确定 .vscode/ 路径
+     * @returns }
      */
     install(spec: SnippetSpec, projectRoot?: string): {
         success: boolean;
@@ -52,9 +50,7 @@ export declare class SnippetInstaller {
     };
     /**
      * 从 Recipe 批量安装
-     * @param {Array} recipes
-     * @param {string} [projectRoot]
-     * @returns {{ success: boolean, count: number, successCount: number, errorCount: number, details: Array }}
+     * @returns }
      */
     installFromRecipes(recipes: RecipeLike[], projectRoot?: string): {
         success: boolean;
@@ -69,8 +65,7 @@ export declare class SnippetInstaller {
     };
     /**
      * 列出已安装的 AutoSnippet 管理的 snippet
-     * @param {string} [projectRoot]
-     * @returns {Array<{ filename: string, path: string }>}
+     * @returns >}
      */
     listInstalled(projectRoot?: string): {
         filename: string;
@@ -78,9 +73,7 @@ export declare class SnippetInstaller {
     }[];
     /**
      * 卸载指定 snippet
-     * @param {string} identifier
-     * @param {string} [projectRoot]
-     * @returns {{ success: boolean, message: string }}
+     * @returns }
      */
     uninstall(identifier: string, projectRoot?: string): {
         success: boolean;
@@ -88,8 +81,7 @@ export declare class SnippetInstaller {
     };
     /**
      * 清除所有 AutoSnippet 管理的 snippet
-     * @param {string} [projectRoot]
-     * @returns {{ success: boolean, removed: number }}
+     * @returns }
      */
     cleanAll(projectRoot?: string): {
         success: boolean;
@@ -97,4 +89,3 @@ export declare class SnippetInstaller {
     };
 }
 export {};
-//# sourceMappingURL=SnippetInstaller.d.ts.map

package/dist/lib/service/snippet/SnippetInstaller.js

@@ -14,10 +14,8 @@ export class SnippetInstaller {
     #snippetFactory;
     #snippetsDirOverride;
     /**
-     * @param {object} options
-     * @param {import('./codecs/SnippetCodec.js').SnippetCodec} options.codec - IDE codec
-     * @param {import('./SnippetFactory.js').SnippetFactory} [options.snippetFactory]
-     * @param {string} [options.snippetsDir] 覆盖 codec 默认目录
+     * @param options.codec IDE codec
+     * @param [options.snippetsDir] 覆盖 codec 默认目录
      */
     constructor(options = {}) {
         this.#codec = options.codec || null;
@@ -41,9 +39,9 @@ export class SnippetInstaller {
     // ─────────────── 安装 ───────────────
     /**
      * 安装单个 snippet spec
-     * @param {object} spec - SnippetSpec
-     * @param {string} [projectRoot] - VSCode 需要 projectRoot 确定 .vscode/ 路径
-     * @returns {{ success: boolean, path: string, message: string }}
+     * @param spec SnippetSpec
+     * @param [projectRoot] VSCode 需要 projectRoot 确定 .vscode/ 路径
+     * @returns }
      */
     install(spec, projectRoot) {
         this.#assertCodec();
@@ -70,9 +68,7 @@ export class SnippetInstaller {
     }
     /**
      * 从 Recipe 批量安装
-     * @param {Array} recipes
-     * @param {string} [projectRoot]
-     * @returns {{ success: boolean, count: number, successCount: number, errorCount: number, details: Array }}
+     * @returns }
      */
     installFromRecipes(recipes, projectRoot) {
         this.#assertCodec();
@@ -106,8 +102,7 @@ export class SnippetInstaller {
     // ─────────────── 查询 ───────────────
     /**
      * 列出已安装的 AutoSnippet 管理的 snippet
-     * @param {string} [projectRoot]
-     * @returns {Array<{ filename: string, path: string }>}
+     * @returns >}
      */
     listInstalled(projectRoot) {
         const dir = this.#resolveDir(projectRoot);
@@ -141,9 +136,7 @@ export class SnippetInstaller {
     // ─────────────── 卸载 ───────────────
     /**
      * 卸载指定 snippet
-     * @param {string} identifier
-     * @param {string} [projectRoot]
-     * @returns {{ success: boolean, message: string }}
+     * @returns }
      */
     uninstall(identifier, projectRoot) {
         const dir = this.#resolveDir(projectRoot);
@@ -164,8 +157,7 @@ export class SnippetInstaller {
     }
     /**
      * 清除所有 AutoSnippet 管理的 snippet
-     * @param {string} [projectRoot]
-     * @returns {{ success: boolean, removed: number }}
+     * @returns }
      */
     cleanAll(projectRoot) {
         const dir = this.#resolveDir(projectRoot);
@@ -215,9 +207,7 @@ export class SnippetInstaller {
             mkdirSync(dir, { recursive: true });
         }
     }
-    /**
-     * VSCode bundle: 将单个 spec 追加/更新到 bundle JSON
-     */
+    /** VSCode bundle: 将单个 spec 追加/更新到 bundle JSON */
     #installToBundle(spec, dir, bundleFilename) {
         const bundlePath = join(dir, bundleFilename);
         let bundle = {};
@@ -236,9 +226,7 @@ export class SnippetInstaller {
         writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
         return { success: true, path: bundlePath, message: `Installed: ${key}` };
     }
-    /**
-     * VSCode bundle: 一次性写入完整 bundle
-     */
+    /** VSCode bundle: 一次性写入完整 bundle */
     #installBundleFromSpecs(specs, dir, bundleFilename, totalCount) {
         try {
             const content = this.#codec.generateBundle(specs);
@@ -263,9 +251,7 @@ export class SnippetInstaller {
             };
         }
     }
-    /**
-     * VSCode bundle: 从 JSON 中移除一个 snippet
-     */
+    /** VSCode bundle: 从 JSON 中移除一个 snippet */
     #removeFromBundle(identifier, dir, bundleFilename) {
         const bundlePath = join(dir, bundleFilename);
         if (!existsSync(bundlePath)) {
@@ -288,4 +274,3 @@ export class SnippetInstaller {
         }
     }
 }
-//# sourceMappingURL=SnippetInstaller.js.map

package/dist/lib/service/snippet/codecs/SnippetCodec.d.ts

@@ -19,43 +19,26 @@ export interface SnippetSpec {
     [key: string]: unknown;
 }
 export declare class SnippetCodec {
-    /** @returns {string} codec 标识 ('xcode' | 'vscode') */
+    /** @returns codec 标识 ('xcode' | 'vscode') */
     get id(): string;
     /** 输出文件的扩展名 ('.codesnippet' | '.code-snippets') */
     get fileExtension(): string;
-    /**
-     * 单个 SnippetSpec → IDE 格式字符串
-     * @param {object} spec
-     * @returns {string}
-     */
+    /** 单个 SnippetSpec → IDE 格式字符串 */
     generate(spec: SnippetSpec): string;
     /**
      * 批量 specs → IDE 格式输出
      *   Xcode:  返回 Array<{ filename, content }>（每个 snippet 一个文件）
      *   VSCode: 返回 string（单个 JSON bundle 文件内容）
-     * @param {object[]} specs
-     * @returns {string | Array<{ filename: string, content: string }>}
+     * @returns >}
      */
     generateBundle(specs: SnippetSpec[]): string | Array<{
         filename: string;
         content: string;
     }>;
-    /**
-     * 目标 snippet 安装目录路径
-     * @param {string} [projectRoot]
-     * @returns {string}
-     */
+    /** 目标 snippet 安装目录路径 */
     getInstallDir(projectRoot?: string): string;
-    /**
-     * AutoSnippet 语言标识 → IDE 语言标识映射
-     * @param {string} lang
-     * @returns {string}
-     */
+    /** AutoSnippet 语言标识 → IDE 语言标识映射 */
     mapLanguage(lang: string): string;
-    /**
-     * 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file)
-     * @returns {string|null}
-     */
+    /** 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file) */
     getBundleFilename(): string | null;
 }
-//# sourceMappingURL=SnippetCodec.d.ts.map

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

@@ -1,5 +1,5 @@
 export class SnippetCodec {
-    /** @returns {string} codec 标识 ('xcode' | 'vscode') */
+    /** @returns codec 标识 ('xcode' | 'vscode') */
     get id() {
         throw new Error('SnippetCodec.id is abstract');
     }
@@ -7,11 +7,7 @@ export class SnippetCodec {
     get fileExtension() {
         throw new Error('SnippetCodec.fileExtension is abstract');
     }
-    /**
-     * 单个 SnippetSpec → IDE 格式字符串
-     * @param {object} spec
-     * @returns {string}
-     */
+    /** 单个 SnippetSpec → IDE 格式字符串 */
     generate(spec) {
         throw new Error('SnippetCodec.generate() is abstract');
     }
@@ -19,34 +15,21 @@ export class SnippetCodec {
      * 批量 specs → IDE 格式输出
      *   Xcode:  返回 Array<{ filename, content }>（每个 snippet 一个文件）
      *   VSCode: 返回 string（单个 JSON bundle 文件内容）
-     * @param {object[]} specs
-     * @returns {string | Array<{ filename: string, content: string }>}
+     * @returns >}
      */
     generateBundle(specs) {
         throw new Error('SnippetCodec.generateBundle() is abstract');
     }
-    /**
-     * 目标 snippet 安装目录路径
-     * @param {string} [projectRoot]
-     * @returns {string}
-     */
+    /** 目标 snippet 安装目录路径 */
     getInstallDir(projectRoot) {
         throw new Error('SnippetCodec.getInstallDir() is abstract');
     }
-    /**
-     * AutoSnippet 语言标识 → IDE 语言标识映射
-     * @param {string} lang
-     * @returns {string}
-     */
+    /** AutoSnippet 语言标识 → IDE 语言标识映射 */
     mapLanguage(lang) {
         throw new Error('SnippetCodec.mapLanguage() is abstract');
     }
-    /**
-     * 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file)
-     * @returns {string|null}
-     */
+    /** 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file) */
     getBundleFilename() {
         return null;
     }
 }
-//# sourceMappingURL=SnippetCodec.js.map

package/dist/lib/service/snippet/codecs/VSCodeCodec.d.ts

@@ -13,20 +13,15 @@ export declare class VSCodeCodec extends SnippetCodec {
     #private;
     get id(): string;
     get fileExtension(): string;
-    /**
-     * 单个 SnippetSpec → JSON 字符串
-     */
+    /** 单个 SnippetSpec → JSON 字符串 */
     generate(spec: SnippetSpec): string;
     /**
      * VSCode: 所有 snippets 合并为单个 JSON bundle 文件
-     * @returns {string} JSON 字符串
+     * @returns JSON 字符串
      */
     generateBundle(specs: SnippetSpec[]): string;
-    /**
-     * VSCode snippets 安装目录 = 项目级 .vscode/
-     */
+    /** VSCode snippets 安装目录 = 项目级 .vscode/ */
     getInstallDir(projectRoot: string): string;
     mapLanguage(lang: string): string;
     getBundleFilename(): string;
 }
-//# sourceMappingURL=VSCodeCodec.d.ts.map

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