autosnippet 3.2.16 → 3.2.17

package/dist/lib/repository/remote/RemoteCommandRepository.js

@@ -41,9 +41,7 @@ export class RemoteCommandRepository {
     // ═══════════════════════════════════════════════════
     //  写入操作
     // ═══════════════════════════════════════════════════
-    /**
-     * 写入新的远程指令到队列
-     */
+    /** 写入新的远程指令到队列 */
     enqueue(input) {
         this.#drizzle
             .insert(remoteCommands)
@@ -72,9 +70,7 @@ export class RemoteCommandRepository {
             .run();
         return result.changes > 0;
     }
-    /**
-     * 提交指令执行结果（running → completed/failed/...）
-     */
+    /** 提交指令执行结果（running → completed/failed/...） */
     complete(id, resultText, status = 'completed') {
         this.#drizzle
             .update(remoteCommands)
@@ -121,9 +117,7 @@ export class RemoteCommandRepository {
     // ═══════════════════════════════════════════════════
     //  查询操作
     // ═══════════════════════════════════════════════════
-    /**
-     * 获取最早的一条 pending 指令
-     */
+    /** 获取最早的一条 pending 指令 */
     findFirstPending() {
         const rows = this.#drizzle
             .select()
@@ -134,9 +128,7 @@ export class RemoteCommandRepository {
             .all();
         return rows[0] ?? null;
     }
-    /**
-     * 根据 ID 获取指令
-     */
+    /** 根据 ID 获取指令 */
     findById(id) {
         const rows = this.#drizzle
             .select()
@@ -146,9 +138,7 @@ export class RemoteCommandRepository {
             .all();
         return rows[0] ?? null;
     }
-    /**
-     * 获取历史记录（按创建时间降序）
-     */
+    /** 获取历史记录（按创建时间降序） */
     getHistory(limit = 20) {
         return this.#drizzle
             .select()
@@ -157,9 +147,7 @@ export class RemoteCommandRepository {
             .limit(limit)
             .all();
     }
-    /**
-     * 获取各状态的指令计数（用于 /lark/status 诊断面板）
-     */
+    /** 获取各状态的指令计数（用于 /lark/status 诊断面板） */
     getStatusCounts() {
         const counts = { pending: 0, running: 0, completed: 0, timeout: 0 };
         for (const s of ['pending', 'running', 'completed', 'timeout']) {
@@ -168,9 +156,7 @@ export class RemoteCommandRepository {
         }
         return counts;
     }
-    /**
-     * 查找最近一次 claim 记录（用于 IDE 心跳检测）
-     */
+    /** 查找最近一次 claim 记录（用于 IDE 心跳检测） */
     findRecentClaim() {
         const rows = this.#drizzle
             .select({ claimedAt: remoteCommands.claimedAt })
@@ -182,9 +168,7 @@ export class RemoteCommandRepository {
         const row = rows[0];
         return row?.claimedAt != null ? { claimedAt: row.claimedAt } : null;
     }
-    /**
-     * 查找最近有 chatId 的指令（用于恢复活跃会话）
-     */
+    /** 查找最近有 chatId 的指令（用于恢复活跃会话） */
     findRecentChatId() {
         const rows = this.#drizzle
             .select({ chatId: remoteCommands.chatId })
@@ -213,9 +197,7 @@ export class RemoteCommandRepository {
     // ═══════════════════════════════════════════════════
     //  remote_state 键值存储
     // ═══════════════════════════════════════════════════
-    /**
-     * 持久化键值对到 remote_state
-     */
+    /** 持久化键值对到 remote_state */
     setState(key, value) {
         this.#drizzle
             .insert(remoteState)
@@ -226,9 +208,7 @@ export class RemoteCommandRepository {
         })
             .run();
     }
-    /**
-     * 从 remote_state 读取值
-     */
+    /** 从 remote_state 读取值 */
     getState(key) {
         const rows = this.#drizzle
             .select({ value: remoteState.value })
@@ -239,4 +219,3 @@ export class RemoteCommandRepository {
         return rows[0]?.value ?? null;
     }
 }
-//# sourceMappingURL=RemoteCommandRepository.js.map

package/dist/lib/repository/task/TaskRepository.impl.d.ts

@@ -63,9 +63,6 @@ export declare class TaskRepositoryImpl {
     _reachableStmt: Statement;
     db: Database;
     logger: WinstonLogger;
-    /**
-     * @param {import('../../infrastructure/database/DatabaseConnection.js').default} database
-     */
     constructor(database: DatabaseWrapper, drizzle?: DrizzleDB);
     /** @private 预编译复杂查询（仅保留 drizzle 无法表达的递归 CTE） */
     _prepareStatements(): void;
@@ -96,9 +93,8 @@ export declare class TaskRepositoryImpl {
     delete(id: string): boolean;
     /**
      * 列表查询
-     * @param {object} filters - { status, taskType, assignee, parentId }
-     * @param {object} options - { limit, offset, orderBy }
-     * @returns {Task[]}
+     * @param filters { status, taskType, assignee, parentId }
+     * @param options { limit, offset, orderBy }
      */
     findAll(filters?: TaskFilters, options?: TaskFindOptions): (Task | null)[];
     /**
@@ -126,18 +122,9 @@ export declare class TaskRepositoryImpl {
      * 保留 raw SQL — JOIN 查询
      */
     getBlockers(taskId: string): (Task | null)[];
-    /**
-     * 环检测：检查 fromId → toId 是否已有可达路径
-     * @param {string} fromId
-     * @param {string} toId
-     * @returns {boolean}
-     */
+    /** 环检测：检查 fromId → toId 是否已有可达路径 */
     hasReachablePath(fromId: string, toId: string): boolean;
-    /**
-     * 在事务中执行操作
-     * @param {Function} fn
-     * @returns {*}
-     */
+    /** 在事务中执行操作 */
     inTransaction<T>(fn: () => T): T;
     /**
      * 获取任务统计
@@ -156,11 +143,7 @@ export declare class TaskRepositoryImpl {
      * ★ Drizzle 类型安全 INSERT
      */
     logEvent(taskId: string, eventType: string, oldValue?: string | null, newValue?: string | null, comment?: string | null, actor?: string): void;
-    /**
-     * 实体 → DB 行 (camelCase → snake_case)
-     * @param {Task} task
-     * @returns {object}
-     */
+    /** 实体 → DB 行 (camelCase → snake_case) */
     _entityToRow(task: Task): {
         id: string;
         parentId: string | null;
@@ -186,4 +169,3 @@ export declare class TaskRepositoryImpl {
     };
 }
 export default TaskRepositoryImpl;
-//# sourceMappingURL=TaskRepository.impl.d.ts.map

package/dist/lib/repository/task/TaskRepository.impl.js

@@ -19,9 +19,6 @@ export class TaskRepositoryImpl {
     #drizzle;
     db;
     logger;
-    /**
-     * @param {import('../../infrastructure/database/DatabaseConnection.js').default} database
-     */
     constructor(database, drizzle) {
         this.db = database.getDb();
         this.logger = Logger.getInstance();
@@ -131,9 +128,8 @@ export class TaskRepositoryImpl {
     }
     /**
      * 列表查询
-     * @param {object} filters - { status, taskType, assignee, parentId }
-     * @param {object} options - { limit, offset, orderBy }
-     * @returns {Task[]}
+     * @param filters { status, taskType, assignee, parentId }
+     * @param options { limit, offset, orderBy }
      */
     findAll(filters = {}, options = {}) {
         const conditions = [];
@@ -231,22 +227,13 @@ export class TaskRepositoryImpl {
             .all(taskId);
         return rows.map((r) => Task.fromRow(r));
     }
-    /**
-     * 环检测：检查 fromId → toId 是否已有可达路径
-     * @param {string} fromId
-     * @param {string} toId
-     * @returns {boolean}
-     */
+    /** 环检测：检查 fromId → toId 是否已有可达路径 */
     hasReachablePath(fromId, toId) {
         const row = this._reachableStmt.get(fromId, toId);
         return !!row;
     }
     // ═══ 事务支持 ═══════════════════════════════════════
-    /**
-     * 在事务中执行操作
-     * @param {Function} fn
-     * @returns {*}
-     */
+    /** 在事务中执行操作 */
     inTransaction(fn) {
         const txn = this.db.transaction(fn);
         return txn();
@@ -298,11 +285,7 @@ export class TaskRepositoryImpl {
             .run();
     }
     // ═══ 私有方法 ═══════════════════════════════════════
-    /**
-     * 实体 → DB 行 (camelCase → snake_case)
-     * @param {Task} task
-     * @returns {object}
-     */
+    /** 实体 → DB 行 (camelCase → snake_case) */
     _entityToRow(task) {
         return {
             id: task.id,
@@ -340,11 +323,7 @@ const ALLOWED_ORDER_FIELDS = new Set([
     'closed_at',
 ]);
 const ALLOWED_DIRECTIONS = new Set(['ASC', 'DESC']);
-/**
- * orderBy 白名单校验，防止 SQL 注入
- * @param {string} [orderBy]
- * @returns {string}
- */
+/** orderBy 白名单校验，防止 SQL 注入 */
 function _sanitizeOrderBy(orderBy) {
     if (!orderBy) {
         return 'priority ASC, created_at ASC';
@@ -366,4 +345,3 @@ function _sanitizeOrderBy(orderBy) {
         .join(', ') || 'priority ASC, created_at ASC');
 }
 export default TaskRepositoryImpl;
-//# sourceMappingURL=TaskRepository.impl.js.map

package/dist/lib/repository/token/TokenUsageStore.d.ts

@@ -55,9 +55,7 @@ interface ReportData {
 }
 export declare class TokenUsageStore {
     #private;
-    /**
-     * @param {import('better-sqlite3').Database} db — raw better-sqlite3 instance
-     */
+    /** @param db — raw better-sqlite3 instance */
     constructor(db: import('better-sqlite3').Database, drizzle?: DrizzleDB);
     /**
      * 记录一次 AI 调用的 token 消耗
@@ -66,17 +64,17 @@ export declare class TokenUsageStore {
     record(record: TokenRecord): void;
     /**
      * 近 7 日按日聚合统计
-     * @returns {Array<{ date: string, input_tokens: number, output_tokens: number, total_tokens: number, call_count: number }>}
+     * @returns >}
      */
     getLast7DaysDaily(): DailyRow[];
     /**
      * 近 7 日按来源 (source) 聚合统计
-     * @returns {Array<{ source: string, input_tokens: number, output_tokens: number, total_tokens: number, call_count: number }>}
+     * @returns >}
      */
     getLast7DaysBySource(): BySourceRow[];
     /**
      * 近 7 日总计
-     * @returns {{ input_tokens: number, output_tokens: number, total_tokens: number, call_count: number, avg_per_call: number }}
+     * @returns }
      */
     getLast7DaysSummary(): SummaryRow & {
         avg_per_call: number;
@@ -88,4 +86,3 @@ export declare class TokenUsageStore {
     getLast7DaysReport(): ReportData;
 }
 export {};
-//# sourceMappingURL=TokenUsageStore.d.ts.map

package/dist/lib/repository/token/TokenUsageStore.js

@@ -23,9 +23,7 @@ export class TokenUsageStore {
     #summaryStmt;
     /** @type {{ data: object, expireAt: number } | null} */
     #reportCache = null;
-    /**
-     * @param {import('better-sqlite3').Database} db — raw better-sqlite3 instance
-     */
+    /** @param db — raw better-sqlite3 instance */
     constructor(db, drizzle) {
         this.#db = db;
         this.#drizzle = drizzle ?? getDrizzle();
@@ -113,7 +111,7 @@ export class TokenUsageStore {
     // ─── 查询 ─────────────────────────────────────────
     /**
      * 近 7 日按日聚合统计
-     * @returns {Array<{ date: string, input_tokens: number, output_tokens: number, total_tokens: number, call_count: number }>}
+     * @returns >}
      */
     getLast7DaysDaily() {
         const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
@@ -121,7 +119,7 @@ export class TokenUsageStore {
     }
     /**
      * 近 7 日按来源 (source) 聚合统计
-     * @returns {Array<{ source: string, input_tokens: number, output_tokens: number, total_tokens: number, call_count: number }>}
+     * @returns >}
      */
     getLast7DaysBySource() {
         const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
@@ -129,7 +127,7 @@ export class TokenUsageStore {
     }
     /**
      * 近 7 日总计
-     * @returns {{ input_tokens: number, output_tokens: number, total_tokens: number, call_count: number, avg_per_call: number }}
+     * @returns }
      */
     getLast7DaysSummary() {
         const sevenDaysAgo = Date.now() - 7 * 24 * 60 * 60 * 1000;
@@ -157,4 +155,3 @@ export class TokenUsageStore {
         return data;
     }
 }
-//# sourceMappingURL=TokenUsageStore.js.map

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

@@ -7,15 +7,14 @@ export declare class ActionPipeline {
     constructor();
     /**
      * 注册动作处理器
-     * @param {string} type 触发类型
-     * @param {function} handler - async (trigger, context) => result
+     * @param type 触发类型
+     * @param handler async (trigger, context) => result
      */
     register(type: string, handler: (trigger: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>): void;
     /**
      * 执行管线
      * @param {{ type: string, name?: string, params?: object }} trigger
-     * @param {object} context
-     * @returns {Promise<{ success: boolean, result?: unknown, error?: string }>}
+     * @returns >}
      */
     execute(trigger: {
         type: string;
@@ -30,9 +29,6 @@ export declare class ActionPipeline {
         error: string;
         result?: undefined;
     }>;
-    /**
-     * 获取已注册的动作类型
-     */
+    /** 获取已注册的动作类型 */
     getRegisteredTypes(): any[];
 }
-//# sourceMappingURL=ActionPipeline.d.ts.map

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

@@ -12,8 +12,8 @@ export class ActionPipeline {
     }
     /**
      * 注册动作处理器
-     * @param {string} type 触发类型
-     * @param {function} handler - async (trigger, context) => result
+     * @param type 触发类型
+     * @param handler async (trigger, context) => result
      */
     register(type, handler) {
         this.#actions.set(type, handler);
@@ -21,8 +21,7 @@ export class ActionPipeline {
     /**
      * 执行管线
      * @param {{ type: string, name?: string, params?: object }} trigger
-     * @param {object} context
-     * @returns {Promise<{ success: boolean, result?: unknown, error?: string }>}
+     * @returns >}
      */
     async execute(trigger, context) {
         const handler = this.#actions.get(trigger.type);
@@ -37,9 +36,7 @@ export class ActionPipeline {
         }
         return this.#runHandler(handler, trigger, context);
     }
-    /**
-     * 获取已注册的动作类型
-     */
+    /** 获取已注册的动作类型 */
     getRegisteredTypes() {
         return [...this.#actions.keys()];
     }
@@ -54,4 +51,3 @@ export class ActionPipeline {
         }
     }
 }
-//# sourceMappingURL=ActionPipeline.js.map

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

@@ -14,9 +14,9 @@ export declare class AutomationOrchestrator {
     });
     /**
      * 执行自动化流程
-     * @param {string|object} trigger 原始触发
-     * @param {object} context 原始上下文
-     * @returns {Promise<{ success: boolean, result?: unknown, error?: string, resolvedTrigger: object }>}
+     * @param trigger 原始触发
+     * @param context 原始上下文
+     * @returns >}
      */
     run(trigger: string | Record<string, unknown>, context?: Record<string, unknown>): Promise<{
         resolvedTrigger: {
@@ -77,17 +77,10 @@ export declare class AutomationOrchestrator {
         error: string;
         result?: undefined;
     }>;
-    /**
-     * 注册动作处理器
-     */
+    /** 注册动作处理器 */
     registerAction(type: string, handler: (trigger: Record<string, unknown>, context: Record<string, unknown>) => Promise<unknown>): void;
-    /**
-     * 获取执行历史
-     */
+    /** 获取执行历史 */
     getHistory(): Record<string, unknown>[];
-    /**
-     * 获取管线
-     */
+    /** 获取管线 */
     getPipeline(): ActionPipeline;
 }
-//# sourceMappingURL=AutomationOrchestrator.d.ts.map

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

@@ -21,9 +21,9 @@ export class AutomationOrchestrator {
     }
     /**
      * 执行自动化流程
-     * @param {string|object} trigger 原始触发
-     * @param {object} context 原始上下文
-     * @returns {Promise<{ success: boolean, result?: unknown, error?: string, resolvedTrigger: object }>}
+     * @param trigger 原始触发
+     * @param context 原始上下文
+     * @returns >}
      */
     async run(trigger, context = {}) {
         const resolvedTrigger = this.#triggerResolver.resolve(trigger);
@@ -42,23 +42,16 @@ export class AutomationOrchestrator {
         }
         return { ...pipelineResult, resolvedTrigger };
     }
-    /**
-     * 注册动作处理器
-     */
+    /** 注册动作处理器 */
     registerAction(type, handler) {
         this.#pipeline.register(type, handler);
     }
-    /**
-     * 获取执行历史
-     */
+    /** 获取执行历史 */
     getHistory() {
         return [...this.#history];
     }
-    /**
-     * 获取管线
-     */
+    /** 获取管线 */
     getPipeline() {
         return this.#pipeline;
     }
 }
-//# sourceMappingURL=AutomationOrchestrator.js.map

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

@@ -6,8 +6,8 @@ export declare class ContextCollector {
     #private;
     /**
      * 收集上下文
-     * @param {object} rawContext 原始上下文
-     * @returns {object} 规范化的上下文
+     * @param rawContext 原始上下文
+     * @returns 规范化的上下文
      */
     collect(rawContext?: Record<string, unknown>): {
         filePath: {} | null;
@@ -22,4 +22,3 @@ export declare class ContextCollector {
         };
     };
 }
-//# sourceMappingURL=ContextCollector.d.ts.map

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

@@ -6,8 +6,8 @@ import { LanguageService } from '../../shared/LanguageService.js';
 export class ContextCollector {
     /**
      * 收集上下文
-     * @param {object} rawContext 原始上下文
-     * @returns {object} 规范化的上下文
+     * @param rawContext 原始上下文
+     * @returns 规范化的上下文
      */
     collect(rawContext = {}) {
         return {
@@ -33,4 +33,3 @@ export class ContextCollector {
         return lang === 'unknown' ? null : lang;
     }
 }
-//# sourceMappingURL=ContextCollector.js.map

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

@@ -4,9 +4,7 @@
  * 检测 // as:c（创建）、// as:s（搜索）、// as:a（审计）等指令
  * V2 ESM 版本，对应 V1 DirectiveDetector.js
  */
-/**
- * 指令标记常量
- */
+/** 指令标记常量 */
 export declare const MARKS: {
     HEADER_INCLUDE: string;
     HEADER_IMPORT: string;
@@ -21,9 +19,7 @@ export declare const MARKS: {
     SEARCH_ALIAS: string;
     ALINK: string;
 };
-/**
- * 正则表达式
- */
+/** 正则表达式 */
 export declare const REGEX: {
     CREATE_LINE: RegExp;
     CREATE_REMOVE: RegExp;
@@ -36,8 +32,8 @@ export declare const REGEX: {
 /**
  * 检测文件内容中的所有触发指令
  *
- * @param {string} data 文件内容
- * @param {string} filename 文件名
+ * @param data 文件内容
+ * @param filename 文件名
  * @returns {{ importArray: string[], headerLine: string|null, alinkLine: string|null,
  *             createLine: string|null, createOption: string|null,
  *             guardLine: string|null, searchLine: string|null, isSwift: boolean, language: string }}
@@ -53,4 +49,3 @@ export declare function detectTriggers(data: string, filename: string): {
     isSwift: boolean;
     language: string;
 };
-//# sourceMappingURL=DirectiveDetector.d.ts.map

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

@@ -6,9 +6,7 @@
  */
 import { stripTriggerPrefix, TRIGGER_SYMBOL } from '../../infrastructure/config/TriggerSymbol.js';
 import { LanguageService } from '../../shared/LanguageService.js';
-/**
- * 指令标记常量
- */
+/** 指令标记常量 */
 export const MARKS = {
     HEADER_INCLUDE: '// autosnippet:include ',
     HEADER_IMPORT: '// autosnippet:import ',
@@ -23,9 +21,7 @@ export const MARKS = {
     SEARCH_ALIAS: '// as:s',
     ALINK: 'alink',
 };
-/**
- * 正则表达式
- */
+/** 正则表达式 */
 export const REGEX = {
     CREATE_LINE: /^\/\/\s*as:(?:create|c)(?:\s+(-[cf]))?\s*$/,
     CREATE_REMOVE: /^@?\s*\/\/\s*as:(?:create|c)(?:\s+-[cf])?\s*\r?\n?/gm,
@@ -35,19 +31,15 @@ export const REGEX = {
     IMPORT_SWIFT: /^import\s*\w+$/,
     SEARCH_MARK: /\/\/\s*(?:autosnippet|as):(?:search|s)(\s|$)/,
 };
-/**
- * 推断文件语言 —— 委托给 LanguageService
- * @param {string} filename
- * @returns {string}
- */
+/** 推断文件语言 —— 委托给 LanguageService */
 function _inferLanguage(filename) {
     return LanguageService.inferLang(filename);
 }
 /**
  * 检测文件内容中的所有触发指令
  *
- * @param {string} data 文件内容
- * @param {string} filename 文件名
+ * @param data 文件内容
+ * @param filename 文件名
  * @returns {{ importArray: string[], headerLine: string|null, alinkLine: string|null,
  *             createLine: string|null, createOption: string|null,
  *             guardLine: string|null, searchLine: string|null, isSwift: boolean, language: string }}
@@ -118,4 +110,3 @@ function _isSearchDirective(line) {
         line.startsWith(MARKS.SEARCH_LONG) ||
         line.startsWith(MARKS.SEARCH_ALIAS));
 }
-//# sourceMappingURL=DirectiveDetector.js.map

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

@@ -20,13 +20,11 @@ export declare class FileWatcher {
     quiet: boolean;
     specPath: string;
     /**
-     * @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: string, projectRoot: string, opts?: {
         quiet?: boolean;
@@ -34,35 +32,20 @@ export declare class FileWatcher {
         onEvent?: ((event: string, path: string) => void) | null;
         exts?: string[];
     });
-    /**
-     * 启动文件监听
-     */
+    /** 启动文件监听 */
     start(): import("chokidar").FSWatcher;
-    /**
-     * 停止监听，释放所有资源
-     */
+    /** 停止监听，释放所有资源 */
     stop(): Promise<void>;
     _processFile(fullPath: string, relativePath: string): Promise<void>;
-    /**
-     * 追加候选项（通过 ServiceContainer 或 HTTP API）
-     */
+    /** 追加候选项（通过 ServiceContainer 或 HTTP API） */
     _appendCandidates(items: Record<string, unknown>[], source: string): Promise<void>;
-    /**
-     * 为候选解析头文件
-     */
+    /** 为候选解析头文件 */
     _resolveHeadersIfNeeded(item: Record<string, unknown>, relativePath: string, text: string): Promise<void>;
-    /**
-     * 打开 Dashboard 页面
-     */
+    /** 打开 Dashboard 页面 */
     _openDashboard(path: string): void;
-    /**
-     * macOS 通知
-     */
+    /** macOS 通知 */
     _notify(msg: string): void;
-    /**
-     * 防抖
-     */
+    /** 防抖 */
     _debounce(key: string, fn: () => void): void;
 }
 export default FileWatcher;
-//# sourceMappingURL=FileWatcher.d.ts.map