autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/automation/FileWatcher.js

@@ -88,13 +88,11 @@ export class FileWatcher {
     quiet;
     specPath;
     /**
-     * @param {string} specPath  boxspec.json 绝对路径
-     * @param {string} projectRoot 项目根目录
-     * @param {object} [opts]
-     * @param {boolean} [opts.quiet=false]
-     * @param {string[]} [opts.exts] 可选扩展名列表
-     * @param {string} [opts.pathPrefix] 可选路径前缀过滤
-     * @param {Function} [opts.onEvent] 可选事件回调
+     * @param specPath boxspec.json 绝对路径
+     * @param projectRoot 项目根目录
+     * @param [opts.exts] 可选扩展名列表
+     * @param [opts.pathPrefix] 可选路径前缀过滤
+     * @param [opts.onEvent] 可选事件回调
      */
     constructor(specPath, projectRoot, opts = {}) {
         this.specPath = specPath;
@@ -108,9 +106,7 @@ export class FileWatcher {
         this._timeoutLink = undefined;
         this._timeoutHead = undefined;
     }
-    /**
-     * 启动文件监听
-     */
+    /** 启动文件监听 */
     start() {
         const watchRoot = this.projectRoot;
         const filePattern = this.exts
@@ -149,9 +145,7 @@ export class FileWatcher {
         });
         return this._watcher;
     }
-    /**
-     * 停止监听，释放所有资源
-     */
+    /** 停止监听，释放所有资源 */
     async stop() {
         if (this._watcher) {
             // 移除所有事件监听器，避免泄漏
@@ -247,9 +241,7 @@ export class FileWatcher {
         }
     }
     /* ────────── 工具方法（供 handlers 通过 watcher 引用调用） ────────── */
-    /**
-     * 追加候选项（通过 ServiceContainer 或 HTTP API）
-     */
+    /** 追加候选项（通过 ServiceContainer 或 HTTP API） */
     async _appendCandidates(items, source) {
         // 过滤空 title / 空 code 的无效条目
         const validItems = items.filter((item) => {
@@ -324,13 +316,11 @@ export class FileWatcher {
         // 两条路径都失败 → 抛出原始错误
         throw serviceError || new Error('候选提交失败：ServiceContainer 和 HTTP 均不可用');
     }
-    /**
-     * 为候选解析头文件
-     */
+    /** 为候选解析头文件 */
     async _resolveHeadersIfNeeded(item, relativePath, text) {
         if (relativePath && (!item.headers || !item.headers.length)) {
             try {
-                const HeaderResolver = await import('../../infrastructure/paths/HeaderResolver.js');
+                const HeaderResolver = await import('../../platform/ios/xcode/HeaderResolver.js');
                 const resolved = await HeaderResolver.resolveHeadersForText(this.projectRoot, relativePath, text);
                 if (resolved?.headers && resolved.headers.length > 0) {
                     item.headers = resolved.headers;
@@ -343,27 +333,19 @@ export class FileWatcher {
             }
         }
     }
-    /**
-     * 打开 Dashboard 页面
-     */
+    /** 打开 Dashboard 页面 */
     _openDashboard(path) {
         const base = process.env.ASD_DASHBOARD_URL || 'http://localhost:3000';
         const url = `${base}${path}`;
-        import('../../infrastructure/external/OpenBrowser.js')
+        import('../../platform/OpenBrowser.js')
             .then(({ openBrowserReuseTab }) => openBrowserReuseTab(url, base))
             .catch(() => { });
     }
-    /**
-     * macOS 通知
-     */
+    /** macOS 通知 */
     _notify(msg) {
-        import('../../infrastructure/external/NativeUi.js')
-            .then((NU) => NU.notify(msg))
-            .catch(() => { });
+        import('../../platform/NativeUi.js').then((NU) => NU.notify(msg)).catch(() => { });
     }
-    /**
-     * 防抖
-     */
+    /** 防抖 */
     _debounce(key, fn) {
         if (this._debounceTimers.has(key)) {
             clearTimeout(this._debounceTimers.get(key));
@@ -382,4 +364,3 @@ export class FileWatcher {
     }
 }
 export default FileWatcher;
-//# sourceMappingURL=FileWatcher.js.map

package/dist/lib/service/automation/TriggerResolver.d.ts

@@ -6,8 +6,7 @@ export declare class TriggerResolver {
     #private;
     /**
      * 规范化触发器
-     * @param {object|string} trigger
-     * @returns {{ type: string, name?: string, params?: object, raw: unknown }}
+     * @returns }
      */
     resolve(trigger: string | Record<string, unknown>): {
         type: string;
@@ -35,4 +34,3 @@ export declare class TriggerResolver {
         params?: undefined;
     };
 }
-//# sourceMappingURL=TriggerResolver.d.ts.map

package/dist/lib/service/automation/TriggerResolver.js

@@ -5,8 +5,7 @@
 export class TriggerResolver {
     /**
      * 规范化触发器
-     * @param {object|string} trigger
-     * @returns {{ type: string, name?: string, params?: object, raw: unknown }}
+     * @returns }
      */
     resolve(trigger) {
         if (typeof trigger === 'string') {
@@ -61,4 +60,3 @@ export class TriggerResolver {
         return map[name] || 'directive';
     }
 }
-//# sourceMappingURL=TriggerResolver.js.map

package/dist/lib/service/automation/handlers/AlinkHandler.d.ts

@@ -4,8 +4,4 @@
  * 解析编辑器中的 alink 触发行，提取 completionKey，
  * 通过数据库查找匹配的 Recipe，打开 Dashboard 详情页。
  */
-/**
- * @param {string} alinkLine
- */
 export declare function handleAlink(alinkLine: string): Promise<void>;
-//# sourceMappingURL=AlinkHandler.d.ts.map

package/dist/lib/service/automation/handlers/AlinkHandler.js

@@ -7,9 +7,6 @@
 import { and, eq } from 'drizzle-orm';
 import { getServiceContainer } from '#inject/ServiceContainer.js';
 import { knowledgeEntries } from '../../../infrastructure/database/drizzle/schema.js';
-/**
- * @param {string} alinkLine
- */
 export async function handleAlink(alinkLine) {
     const { TRIGGER_SYMBOL } = await import('../../../infrastructure/config/TriggerSymbol.js');
     let completionKey = null;
@@ -81,4 +78,3 @@ export async function handleAlink(alinkLine) {
         }
     }
 }
-//# sourceMappingURL=AlinkHandler.js.map

package/dist/lib/service/automation/handlers/CreateHandler.d.ts

@@ -4,14 +4,8 @@
  */
 /**
  * 处理 // as:c 指令
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} relativePath
- * @param {string} createOption 'c' | 'f' | undefined
+ * @param createOption 'c' | 'f' | undefined
  */
 export declare function handleCreate(watcher: import('../FileWatcher.js').FileWatcher, fullPath: string, relativePath: string, createOption: string | null): Promise<void>;
-/**
- * 查找 // as:c 的行号 (1-based)
- */
+/** 查找 // as:c 的行号 (1-based) */
 export declare function findCreateLineNumber(content: string): number;
-//# sourceMappingURL=CreateHandler.d.ts.map

package/dist/lib/service/automation/handlers/CreateHandler.js

@@ -8,14 +8,11 @@ import { LanguageService } from '#shared/LanguageService.js';
 import { REGEX } from '../DirectiveDetector.js';
 /**
  * 处理 // as:c 指令
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} relativePath
- * @param {string} createOption 'c' | 'f' | undefined
+ * @param createOption 'c' | 'f' | undefined
  */
 export async function handleCreate(watcher, fullPath, relativePath, createOption) {
     const XA = await import('../../../platform/ios/xcode/XcodeAutomation.js');
-    const CM = await import('../../../infrastructure/external/ClipboardManager.js');
+    const CM = await import('../../../platform/ClipboardManager.js');
     // 1. 读剪贴板（仅 -c 模式）
     let textToExtract = '';
     if (createOption === 'c') {
@@ -63,9 +60,7 @@ export async function handleCreate(watcher, fullPath, relativePath, createOption
         watcher._openDashboard(`/?action=create&path=${encodeURIComponent(relativePath)}&source=clipboard`);
     }
 }
-/**
- * 静默创建候选（从剪贴板文本解析 Recipe 并提交）
- */
+/** 静默创建候选（从剪贴板文本解析 Recipe 并提交） */
 async function silentCreateCandidate(watcher, text, relativePath) {
     const { RecipeParser } = await import('../../recipe/RecipeParser.js');
     const parser = new RecipeParser();
@@ -156,9 +151,7 @@ async function silentCreateCandidate(watcher, text, relativePath) {
     await watcher._appendCandidates([item], 'watch-create');
     watcher._notify(`已创建候选「${title}」，请在 Candidates 页审核`);
 }
-/**
- * 查找 // as:c 的行号 (1-based)
- */
+/** 查找 // as:c 的行号 (1-based) */
 export function findCreateLineNumber(content) {
     if (!content) {
         return -1;
@@ -175,4 +168,3 @@ export function findCreateLineNumber(content) {
 function _sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-//# sourceMappingURL=CreateHandler.js.map

package/dist/lib/service/automation/handlers/GuardHandler.d.ts

@@ -9,10 +9,9 @@
  *   // as:a <keyword> — 检查当前文件 + 搜索相关规范
  */
 /**
- * @param {import('../FileWatcher.js').default} watcher  FileWatcher 实例
- * @param {string} fullPath  当前文件绝对路径
- * @param {string} code      当前文件内容
- * @param {string} guardLine 触发行原文
+ * @param watcher FileWatcher 实例
+ * @param fullPath 当前文件绝对路径
+ * @param code 当前文件内容
+ * @param guardLine 触发行原文
  */
 export declare function handleGuard(watcher: import('../FileWatcher.js').FileWatcher, fullPath: string, code: string, guardLine: string): Promise<void>;
-//# sourceMappingURL=GuardHandler.d.ts.map

package/dist/lib/service/automation/handlers/GuardHandler.js

@@ -15,9 +15,7 @@ import { LanguageService } from '#shared/LanguageService.js';
 const SCOPE_KEYWORDS = new Set(['file', 'target', 'project', 'all']);
 /** 支持审计的源文件扩展名 — 委托给 LanguageService */
 const SOURCE_EXTS = LanguageService.sourceExts;
-/**
- * 递归收集目录下所有源文件路径
- */
+/** 递归收集目录下所有源文件路径 */
 async function collectSourceFiles(dir) {
     const { readdir } = await import('node:fs/promises');
     const files = [];
@@ -63,10 +61,10 @@ async function collectSourceFiles(dir) {
     return files;
 }
 /**
- * @param {import('../FileWatcher.js').default} watcher  FileWatcher 实例
- * @param {string} fullPath  当前文件绝对路径
- * @param {string} code      当前文件内容
- * @param {string} guardLine 触发行原文
+ * @param watcher FileWatcher 实例
+ * @param fullPath 当前文件绝对路径
+ * @param code 当前文件内容
+ * @param guardLine 触发行原文
  */
 export async function handleGuard(watcher, fullPath, code, guardLine) {
     const rest = guardLine.replace(/^\/\/\s*as:(?:audit|a|lint|l|guard|g)\s*/, '').trim();
@@ -180,9 +178,7 @@ export async function handleGuard(watcher, fullPath, code, guardLine) {
         console.warn(`  ⚠️ Guard 检查失败: ${err.message}`);
     }
 }
-/**
- * 检查单个文件并打印结果
- */
+/** 检查单个文件并打印结果 */
 function _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, scope = 'file') {
     const language = detectLanguage(fullPath);
     const violations = engine.checkCode(code, language, { scope });
@@ -220,4 +216,3 @@ function _auditSingleFile(watcher, engine, fullPath, code, detectLanguage, scope
         /* ignored */
     });
 }
-//# sourceMappingURL=GuardHandler.js.map

package/dist/lib/service/automation/handlers/HeaderHandler.d.ts

@@ -1,12 +1,2 @@
-/**
- * HeaderHandler — 处理 // as:include / // as:import 指令
- */
-/**
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} headerLine
- * @param {string[]} importArray
- * @param {boolean} isSwift
- */
+/** HeaderHandler — 处理 // as:include / // as:import 指令 */
 export declare function handleHeader(watcher: import('../FileWatcher.js').FileWatcher, fullPath: string, headerLine: string, importArray: string[], isSwift: boolean): Promise<void>;
-//# sourceMappingURL=HeaderHandler.d.ts.map

package/dist/lib/service/automation/handlers/HeaderHandler.js

@@ -1,18 +1,9 @@
-/**
- * HeaderHandler — 处理 // as:include / // as:import 指令
- */
+/** HeaderHandler — 处理 // as:include / // as:import 指令 */
 import { readFileSync } from 'node:fs';
 import { basename } from 'node:path';
-/**
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} headerLine
- * @param {string[]} importArray
- * @param {boolean} isSwift
- */
 export async function handleHeader(watcher, fullPath, headerLine, importArray, isSwift) {
     try {
-        const HeaderResolver = await import('../../../infrastructure/paths/HeaderResolver.js');
+        const HeaderResolver = await import('../../../platform/ios/xcode/HeaderResolver.js');
         const parsed = HeaderResolver.parseImportLine(headerLine);
         if (!parsed) {
             return;
@@ -39,4 +30,3 @@ export async function handleHeader(watcher, fullPath, headerLine, importArray, i
         }
     }
 }
-//# sourceMappingURL=HeaderHandler.js.map

package/dist/lib/service/automation/handlers/SearchHandler.d.ts

@@ -1,16 +1,6 @@
-/**
- * SearchHandler — 处理 // as:s 指令
- */
-/**
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} relativePath
- * @param {string} searchLine
- */
+/** SearchHandler — 处理 // as:s 指令 */
 export declare function handleSearch(watcher: import('../FileWatcher.js').FileWatcher, fullPath: string, relativePath: string, searchLine: string): Promise<void>;
-/**
- * 将搜索结果标准化为 NativeUI 可展示格式
- */
+/** 将搜索结果标准化为 NativeUI 可展示格式 */
 export declare function normalizeSearchResults(results: unknown): {
     title: string;
     code: string;
@@ -19,4 +9,3 @@ export declare function normalizeSearchResults(results: unknown): {
     moduleName: string | null;
     trigger: string;
 }[];
-//# sourceMappingURL=SearchHandler.d.ts.map

package/dist/lib/service/automation/handlers/SearchHandler.js

@@ -1,13 +1,5 @@
-/**
- * SearchHandler — 处理 // as:s 指令
- */
+/** SearchHandler — 处理 // as:s 指令 */
 import Logger from '#infra/logging/Logger.js';
-/**
- * @param {import('../FileWatcher.js').FileWatcher} watcher
- * @param {string} fullPath
- * @param {string} relativePath
- * @param {string} searchLine
- */
 export async function handleSearch(watcher, fullPath, relativePath, searchLine) {
     const query = searchLine.replace(/^\/\/\s*(?:autosnippet|as):(?:search|s)\s*/, '').trim();
     if (!query) {
@@ -63,7 +55,7 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
         return;
     }
     // NativeUI 交互选择
-    const NU = await import('../../../infrastructure/external/NativeUi.js');
+    const NU = await import('../../../platform/NativeUi.js');
     const selectedIndex = NU.showCombinedWindow(items, query);
     if (selectedIndex < 0 || selectedIndex >= items.length) {
         return;
@@ -72,7 +64,7 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
     // 如果 selected 没有 moduleName，尝试从当前文件路径推断
     if (!selected.moduleName && selected.headers && selected.headers.length > 0) {
         try {
-            const HeaderResolver = await import('../../../infrastructure/paths/HeaderResolver.js');
+            const HeaderResolver = await import('../../../platform/ios/xcode/HeaderResolver.js');
             const resolved = await HeaderResolver.resolveHeadersForText(watcher.projectRoot, relativePath, (await import('node:fs')).readFileSync(fullPath, 'utf8'));
             if (resolved?.moduleName) {
                 selected.moduleName = resolved.moduleName;
@@ -86,9 +78,7 @@ export async function handleSearch(watcher, fullPath, relativePath, searchLine)
     const { insertCodeToXcode } = await import('../../../platform/ios/xcode/XcodeIntegration.js');
     await insertCodeToXcode(watcher, fullPath, selected, searchLine);
 }
-/**
- * 将搜索结果标准化为 NativeUI 可展示格式
- */
+/** 将搜索结果标准化为 NativeUI 可展示格式 */
 export function normalizeSearchResults(results) {
     if (!results) {
         return [];
@@ -244,8 +234,8 @@ function _separateImportsFromCode(code) {
  * 支持 ```lang\n...\n``` 格式，提取多个代码块并用空行分隔。
  * 如果没有找到代码块，返回空字符串。
  *
- * @param {string} md - Markdown 文本
- * @returns {string} 提取出的纯代码，或空字符串
+ * @param md Markdown 文本
+ * @returns 提取出的纯代码，或空字符串
  */
 function _extractCodeFromMarkdown(md) {
     if (!md) {
@@ -267,8 +257,8 @@ function _extractCodeFromMarkdown(md) {
  *
  * 用于在无法提取代码时，从 markdown 生成 explanation 文本。
  *
- * @param {string} md - Markdown 文本
- * @returns {string} 纯文本
+ * @param md Markdown 文本
+ * @returns 纯文本
  */
 function _stripMarkdownFormatting(md) {
     if (!md) {
@@ -286,4 +276,3 @@ function _stripMarkdownFormatting(md) {
         .replace(/\n{3,}/g, '\n\n') // 压缩多余空行
         .trim();
 }
-//# sourceMappingURL=SearchHandler.js.map

package/dist/lib/{shared → service/bootstrap}/BootstrapEventEmitter.d.ts

@@ -8,52 +8,49 @@
  */
 export declare class BootstrapEventEmitter {
     #private;
-    /**
-     * @param {object} container - DI Container
-     */
+    /** @param container DI Container */
     constructor(container: {
         get?: (name: string) => unknown;
     });
     /**
      * 推送维度完成事件
      *
-     * @param {string} dimId 维度 ID
-     * @param {object} data 事件数据
-     * @param {string} [data.type] - 'skill' | 'candidate' | 'dual'
-     * @param {number} [data.extracted] 提取的候选数量
-     * @param {string} [data.source] - 'internal-agent' | 'external-agent'
-     * @param {boolean} [data.skillCreated] 是否生成了 Skill
-     * @param {number} [data.recipesBound] 关联的 recipe 数量
+     * @param dimId 维度 ID
+     * @param data 事件数据
+     * @param [data.type] 'skill' | 'candidate' | 'dual'
+     * @param [data.extracted] 提取的候选数量
+     * @param [data.source] 'internal-agent' | 'external-agent'
+     * @param [data.skillCreated] 是否生成了 Skill
+     * @param [data.recipesBound] 关联的 recipe 数量
      */
     emitDimensionComplete(dimId: string, data?: Record<string, unknown>): void;
     /**
      * 推送全部维度完成事件
      *
-     * @param {string} sessionId 会话 ID
-     * @param {number} totalDimensions 总维度数
-     * @param {string} [source] 来源标识
+     * @param sessionId 会话 ID
+     * @param totalDimensions 总维度数
+     * @param [source] 来源标识
      */
     emitAllComplete(sessionId: string, totalDimensions: number, source?: string): void;
     /**
      * 推送维度开始填充事件
      *
-     * @param {string} dimId 维度 ID
+     * @param dimId 维度 ID
      */
     emitDimensionStart(dimId: string): void;
     /**
      * 推送维度失败事件
      *
-     * @param {string} dimId 维度 ID
-     * @param {Error} error 错误对象
+     * @param dimId 维度 ID
+     * @param error 错误对象
      */
     emitDimensionFailed(dimId: string, error: Error | string): void;
     /**
      * 推送进度事件
      *
-     * @param {string} event 事件名
-     * @param {object} data 事件数据
+     * @param event 事件名
+     * @param data 事件数据
      */
     emitProgress(event: string, data?: Record<string, unknown>): void;
 }
 export default BootstrapEventEmitter;
-//# sourceMappingURL=BootstrapEventEmitter.d.ts.map

package/dist/lib/{shared → service/bootstrap}/BootstrapEventEmitter.js

@@ -11,9 +11,7 @@ export class BootstrapEventEmitter {
     #eventBus;
     /** @type {object|null} BootstrapTaskManager 实例 */
     #taskManager;
-    /**
-     * @param {object} container - DI Container
-     */
+    /** @param container DI Container */
     constructor(container) {
         this.#eventBus = null;
         this.#taskManager = null;
@@ -33,13 +31,13 @@ export class BootstrapEventEmitter {
     /**
      * 推送维度完成事件
      *
-     * @param {string} dimId 维度 ID
-     * @param {object} data 事件数据
-     * @param {string} [data.type] - 'skill' | 'candidate' | 'dual'
-     * @param {number} [data.extracted] 提取的候选数量
-     * @param {string} [data.source] - 'internal-agent' | 'external-agent'
-     * @param {boolean} [data.skillCreated] 是否生成了 Skill
-     * @param {number} [data.recipesBound] 关联的 recipe 数量
+     * @param dimId 维度 ID
+     * @param data 事件数据
+     * @param [data.type] 'skill' | 'candidate' | 'dual'
+     * @param [data.extracted] 提取的候选数量
+     * @param [data.source] 'internal-agent' | 'external-agent'
+     * @param [data.skillCreated] 是否生成了 Skill
+     * @param [data.recipesBound] 关联的 recipe 数量
      */
     emitDimensionComplete(dimId, data = {}) {
         // TaskManager 标记
@@ -63,9 +61,9 @@ export class BootstrapEventEmitter {
     /**
      * 推送全部维度完成事件
      *
-     * @param {string} sessionId 会话 ID
-     * @param {number} totalDimensions 总维度数
-     * @param {string} [source] 来源标识
+     * @param sessionId 会话 ID
+     * @param totalDimensions 总维度数
+     * @param [source] 来源标识
      */
     emitAllComplete(sessionId, totalDimensions, source = 'unknown') {
         try {
@@ -82,7 +80,7 @@ export class BootstrapEventEmitter {
     /**
      * 推送维度开始填充事件
      *
-     * @param {string} dimId 维度 ID
+     * @param dimId 维度 ID
      */
     emitDimensionStart(dimId) {
         try {
@@ -95,8 +93,8 @@ export class BootstrapEventEmitter {
     /**
      * 推送维度失败事件
      *
-     * @param {string} dimId 维度 ID
-     * @param {Error} error 错误对象
+     * @param dimId 维度 ID
+     * @param error 错误对象
      */
     emitDimensionFailed(dimId, error) {
         try {
@@ -118,8 +116,8 @@ export class BootstrapEventEmitter {
     /**
      * 推送进度事件
      *
-     * @param {string} event 事件名
-     * @param {object} data 事件数据
+     * @param event 事件名
+     * @param data 事件数据
      */
     emitProgress(event, data = {}) {
         try {
@@ -137,4 +135,3 @@ export class BootstrapEventEmitter {
     }
 }
 export default BootstrapEventEmitter;
-//# sourceMappingURL=BootstrapEventEmitter.js.map

package/dist/lib/service/bootstrap/BootstrapTaskManager.d.ts

@@ -51,9 +51,7 @@ export declare const TaskStatus: Readonly<{
     COMPLETED: "completed";
     FAILED: "failed";
 }>;
-/**
- * 单个 Bootstrap 会话（一次冷启动的全部上下文）
- */
+/** 单个 Bootstrap 会话（一次冷启动的全部上下文） */
 declare class BootstrapSession {
     completedAt: number | null;
     id: string;
@@ -105,7 +103,6 @@ export declare class BootstrapTaskManager {
      * 如果上一个会话仍在运行，自动 abort 后再创建新会话（防止重复触发产出重复 Candidate）。
      *
      * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
-     * @returns {BootstrapSession}
      */
     startSession(taskDefs: TaskDef[]): BootstrapSession;
     /**
@@ -114,7 +111,7 @@ export declare class BootstrapTaskManager {
      * 将所有未完成的任务标记为 failed，并将 session 标记为 aborted。
      * 异步填充函数通过 `isSessionValid(sessionId)` 检测到 session 已变更后自动退出。
      *
-     * @param {string} [reason='Aborted by user']
+     * @param [reason='Aborted by user']
      */
     abortSession(reason?: string): void;
     /**
@@ -122,28 +119,18 @@ export declare class BootstrapTaskManager {
      *
      * 用于异步填充函数在每次循环迭代前检测：如果 session 已被新请求覆盖，
      * 则当前异步填充应立即停止，避免产出重复内容。
-     *
-     * @param {string} sessionId
-     * @returns {boolean}
      */
     isSessionValid(sessionId: string): boolean;
-    /**
-     * 标记单个任务开始填充
-     */
+    /** 标记单个任务开始填充 */
     markTaskFilling(taskId: string): void;
     /**
      * 标记单个任务完成
-     * @param {string} taskId
-     * @param {object} result 填充结果摘要 { created, items, ... }
+     * @param result 填充结果摘要 { created, items, ... }
      */
     markTaskCompleted(taskId: string, result?: Record<string, unknown>): void;
-    /**
-     * 标记单个任务失败
-     */
+    /** 标记单个任务失败 */
     markTaskFailed(taskId: string, error: unknown): void;
-    /**
-     * 获取当前 session 状态（供 HTTP 轮询）
-     */
+    /** 获取当前 session 状态（供 HTTP 轮询） */
     getSessionStatus(): {
         id: string;
         status: string;
@@ -170,9 +157,7 @@ export declare class BootstrapTaskManager {
         status: string;
         message: string;
     };
-    /**
-     * 是否有正在进行的 bootstrap
-     */
+    /** 是否有正在进行的 bootstrap */
     get isRunning(): boolean;
     /**
      * 向 EventBus + Socket.io 发射任意进度事件
@@ -180,10 +165,9 @@ export declare class BootstrapTaskManager {
      * 用途：不走 bootstrap session 模型的长操作（如 AI 润色）也能复用
      * 同一套 EventBus + RealtimeService 双通道推送。
      *
-     * @param {string} eventName 事件名（如 'refine:started'）
-     * @param {object} data      事件负载
+     * @param eventName 事件名（如 'refine:started'）
+     * @param data 事件负载
      */
     emitProgress(eventName: string, data: unknown): void;
 }
 export {};
-//# sourceMappingURL=BootstrapTaskManager.d.ts.map