autosnippet 3.2.16 → 3.2.18

package/dist/lib/platform/ios/xcode/XcodeImportResolver.js

@@ -67,10 +67,10 @@ export function parseHeaderString(header) {
  *   2. 从项目根目录递归查找（最多深度 6 层，优先 Sources/ 下）
  *   3. 找到后计算相对于当前文件目录的路径
  *
- * @param {string} headerName 头文件名 (如 "Foo.h")
- * @param {string} currentFilePath 当前正在编辑的文件绝对路径
- * @param {string} [projectRoot] 项目根目录
- * @returns {string|null} 相对路径 (如 "Foo.h" 或 "../SubDir/Foo.h")，null 表示未找到
+ * @param headerName 头文件名 (如 "Foo.h")
+ * @param currentFilePath 当前正在编辑的文件绝对路径
+ * @param [projectRoot] 项目根目录
+ * @returns 相对路径 (如 "Foo.h" 或 "../SubDir/Foo.h")，null 表示未找到
  */
 export function findHeaderRelativePath(headerName, currentFilePath, projectRoot) {
     if (!headerName || !currentFilePath) {
@@ -122,9 +122,7 @@ export function findHeaderRelativePath(headerName, currentFilePath, projectRoot)
         return null;
     }
 }
-/**
- * 递归查找文件（限最大深度）
- */
+/** 递归查找文件（限最大深度） */
 export function findFileRecursive(dir, fileName, maxDepth) {
     if (maxDepth <= 0) {
         return null;
@@ -170,14 +168,14 @@ export function findFileRecursive(dir, fileName, maxDepth) {
  *   ObjC 跨 target:  `#import <Module/Header.h>` (angle-bracket format)
  *   @import 格式保持原样
  *
- * @param {string} rawHeader  原始 header 字符串
- * @param {object} ctx        { currentTarget, headerModuleName, isSwift, fullPath, projectRoot }
+ * @param rawHeader 原始 header 字符串
+ * @param ctx { currentTarget, headerModuleName, isSwift, fullPath, projectRoot }
  *   - currentTarget:    当前文件所属的 target 名
  *   - headerModuleName: header 所属的 module/target 名（来自 recipe.moduleName 或推断）
  *   - isSwift:          目标文件是否是 Swift
  *   - fullPath:         当前编辑文件的绝对路径（用于计算同 target 相对路径）
  *   - projectRoot:      项目根目录（用于搜索头文件物理位置）
- * @returns {string} 格式化后的完整 import 行
+ * @returns 格式化后的完整 import 行
  */
 export function resolveHeaderFormat(rawHeader, ctx) {
     const { currentTarget, headerModuleName, isSwift, fullPath, projectRoot } = ctx;
@@ -236,9 +234,7 @@ export function resolveHeaderFormat(rawHeader, ctx) {
 // ═══════════════════════════════════════════════════════════════
 // 三级 import 去重
 // ═══════════════════════════════════════════════════════════════
-/**
- * 从文件中收集已有的 import 语句
- */
+/** 从文件中收集已有的 import 语句 */
 export function collectImportsFromFile(filePath, isSwift) {
     try {
         if (!existsSync(filePath)) {
@@ -266,9 +262,7 @@ export function collectImportsFromFile(filePath, isSwift) {
         return [];
     }
 }
-/**
- * 收集 .m 文件对应 .h 文件中的 imports（ObjC 接口/实现配对去重）
- */
+/** 收集 .m 文件对应 .h 文件中的 imports（ObjC 接口/实现配对去重） */
 export function collectImportsFromHeaderFile(sourcePath, importArray) {
     const dotIndex = sourcePath.lastIndexOf('.');
     if (dotIndex <= 0) {
@@ -299,9 +293,8 @@ export function collectImportsFromHeaderFile(sourcePath, importArray) {
  *   hasModule        模块级匹配（同模块不同头文件，或 @import）
  *   hasSimilarHeader 文件名 case-insensitive 匹配
  *
- * @param {string[]} importArray 已有的 import 行
- * @param {string}   headerLine 待插入的 import 行
- * @param {boolean}  isSwift
+ * @param importArray 已有的 import 行
+ * @param headerLine 待插入的 import 行
  */
 export function checkImportStatus(importArray, headerLine, isSwift) {
     const trimmed = headerLine.trim();
@@ -409,4 +402,3 @@ export function inferModulesFromHeaders(headers) {
     }
     return [...modules];
 }
-//# sourceMappingURL=XcodeImportResolver.js.map

package/dist/lib/platform/ios/xcode/XcodeIntegration.d.ts

@@ -59,11 +59,9 @@ interface SpmServiceLike {
  *   3. Xcode osascript 自动插入，失败则文件写入回退
  *   4. 附加 AutoSnippet 注释后缀
  *
- * @param {import('../../../service/automation/FileWatcher.js').FileWatcher} watcher
- * @param {string}   fullPath  目标文件绝对路径
- * @param {string[]} headers   待插入的 import 行数组
- * @param {object}   [opts]
- * @returns {Promise<{inserted: string[], skipped: string[], cancelled: boolean}>}
+ * @param fullPath 目标文件绝对路径
+ * @param headers 待插入的 import 行数组
+ * @returns >}
  */
 export declare function insertHeaders(watcher: FileWatcherLike | null, fullPath: string, headers: string[], opts?: InsertHeadersOpts): Promise<{
     inserted: string[];
@@ -82,17 +80,10 @@ export declare function insertHeaders(watcher: FileWatcherLike | null, fullPath:
  *   6. 计算偏移后的粘贴行号（computePasteLineNumber）
  *   7. Jump 到粘贴行 → 选中行内容 → Cmd+V 粘贴替换
  *   8. 任一步失败 → 降级到纯文件写入
- *
- * @param {import('../../../service/automation/FileWatcher.js').FileWatcher} watcher
  */
 export declare function insertCodeToXcode(watcher: FileWatcherLike | null, fullPath: string, selected: SelectedSnippet, triggerLine: string): Promise<void>;
-/**
- * 查找触发行的行号（1-based，-1 表示未找到）
- */
+/** 查找触发行的行号（1-based，-1 表示未找到） */
 export declare function findTriggerLineNumber(content: string, triggerLine: string): number;
-/**
- * 查找 import 语句的插入位置（0-based 行索引，在最后一个 import 之后）
- */
+/** 查找 import 语句的插入位置（0-based 行索引，在最后一个 import 之后） */
 export declare function findImportInsertLine(content: string, isSwift: boolean): number;
 export {};
-//# sourceMappingURL=XcodeIntegration.d.ts.map

package/dist/lib/platform/ios/xcode/XcodeIntegration.js

@@ -81,16 +81,14 @@ const _SYSTEM_FRAMEWORKS = new Set([
  *   3. Xcode osascript 自动插入，失败则文件写入回退
  *   4. 附加 AutoSnippet 注释后缀
  *
- * @param {import('../../../service/automation/FileWatcher.js').FileWatcher} watcher
- * @param {string}   fullPath  目标文件绝对路径
- * @param {string[]} headers   待插入的 import 行数组
- * @param {object}   [opts]
- * @returns {Promise<{inserted: string[], skipped: string[], cancelled: boolean}>}
+ * @param fullPath 目标文件绝对路径
+ * @param headers 待插入的 import 行数组
+ * @returns >}
  */
 export async function insertHeaders(watcher, fullPath, headers, opts = {}) {
     const XA = await import('./XcodeAutomation.js');
-    const CM = await import('../../../infrastructure/external/ClipboardManager.js');
-    const NU = (await import('../../../infrastructure/external/NativeUi.js'));
+    const CM = await import('../../ClipboardManager.js');
+    const NU = (await import('../../NativeUi.js'));
     const result = { inserted: [], skipped: [], cancelled: false };
     /** @type {Map<string, string>} 模块名 → 提示注释（'提示操作插入'按钮选择时记录） */
     const depWarnings = opts.depWarnings instanceof Map ? new Map(opts.depWarnings) : new Map();
@@ -256,13 +254,11 @@ export async function insertHeaders(watcher, fullPath, headers, opts = {}) {
  *   6. 计算偏移后的粘贴行号（computePasteLineNumber）
  *   7. Jump 到粘贴行 → 选中行内容 → Cmd+V 粘贴替换
  *   8. 任一步失败 → 降级到纯文件写入
- *
- * @param {import('../../../service/automation/FileWatcher.js').FileWatcher} watcher
  */
 export async function insertCodeToXcode(watcher, fullPath, selected, triggerLine) {
     const XA = await import('./XcodeAutomation.js');
-    const CM = await import('../../../infrastructure/external/ClipboardManager.js');
-    const NU = (await import('../../../infrastructure/external/NativeUi.js'));
+    const CM = await import('../../ClipboardManager.js');
+    const NU = (await import('../../NativeUi.js'));
     const code = selected.code || '';
     if (!code) {
         return;
@@ -557,9 +553,7 @@ function _generateInsertMarker(filePath, selected) {
 // ═══════════════════════════════════════════════════════════════
 // §15 工具函数
 // ═══════════════════════════════════════════════════════════════
-/**
- * 查找触发行的行号（1-based，-1 表示未找到）
- */
+/** 查找触发行的行号（1-based，-1 表示未找到） */
 export function findTriggerLineNumber(content, triggerLine) {
     if (!content || !triggerLine) {
         return -1;
@@ -573,9 +567,7 @@ export function findTriggerLineNumber(content, triggerLine) {
     }
     return -1;
 }
-/**
- * 查找 import 语句的插入位置（0-based 行索引，在最后一个 import 之后）
- */
+/** 查找 import 语句的插入位置（0-based 行索引，在最后一个 import 之后） */
 export function findImportInsertLine(content, isSwift) {
     const lines = content.split('\n');
     let lastImportLine = -1;
@@ -594,4 +586,3 @@ export function findImportInsertLine(content, isSwift) {
     }
     return lastImportLine >= 0 ? lastImportLine + 1 : 0;
 }
-//# sourceMappingURL=XcodeIntegration.js.map

package/dist/lib/platform/ios/xcode/XcodeWriteUtils.d.ts

@@ -9,9 +9,7 @@
  *   - 粘贴行号偏移计算
  */
 export declare function sleep(ms: number): Promise<unknown>;
-/**
- * 在 import 行末尾附加来源标记注释
- */
+/** 在 import 行末尾附加来源标记注释 */
 export declare function withAutoSnippetNote(importLine: string): string;
 /** 依赖检查结果 */
 interface EnsureResult {
@@ -59,8 +57,8 @@ interface DepReviewContext {
 /**
  * 公共依赖审查弹窗逻辑（insertHeaders 和 _preflightDeps 共享）
  *
- * @param {object} ctx - { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label }
- * @returns {{ blocked: boolean }}
+ * @param ctx { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label }
+ * @returns }
  */
 export declare function handleDepReview(ctx: DepReviewContext): {
     blocked: boolean;
@@ -70,11 +68,10 @@ export declare function handleDepReview(ctx: DepReviewContext): {
  *
  * 流程：保存剪贴板 → 写入 import 内容 → osascript 跳转+粘贴 → 恢复剪贴板
  *
- * @param {string} importLine  完整的 import 文本
- * @param {number} insertLine  1-based 行号
- * @param {object} XA          XcodeAutomation 模块
- * @param {object} CM          ClipboardManager 模块
- * @returns {boolean}
+ * @param importLine 完整的 import 文本
+ * @param insertLine 1-based 行号
+ * @param XA XcodeAutomation 模块
+ * @param CM ClipboardManager 模块
  */
 export declare function writeImportLineXcode(importLine: string, insertLine: number, XA: {
     isXcodeRunning(): boolean;
@@ -88,9 +85,7 @@ export declare function writeImportLineXcode(importLine: string, insertLine: num
  * Xcode 会因文件变更而自动 reload。
  */
 export declare function writeImportLineFile(filePath: string, importLine: string, isSwift: boolean): boolean;
-/**
- * 查找文件中最后一个 import 行的行号（1-based，0 表示无 import）
- */
+/** 查找文件中最后一个 import 行的行号（1-based，0 表示无 import） */
 export declare function getLastImportLine(filePath: string): number;
 /**
  * 计算代码粘贴行号
@@ -102,4 +97,3 @@ export declare function computePasteLineNumber(triggerLineNumber: number, header
     forceOffset?: boolean;
 }): number;
 export {};
-//# sourceMappingURL=XcodeWriteUtils.d.ts.map

package/dist/lib/platform/ios/xcode/XcodeWriteUtils.js

@@ -13,9 +13,7 @@ import { saveEventFilter } from './SaveEventFilter.js';
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-/**
- * 在 import 行末尾附加来源标记注释
- */
+/** 在 import 行末尾附加来源标记注释 */
 export function withAutoSnippetNote(importLine) {
     if (!importLine) {
         return importLine;
@@ -44,8 +42,8 @@ export function evaluateDepResult(ensureResult, from, to) {
 /**
  * 公共依赖审查弹窗逻辑（insertHeaders 和 _preflightDeps 共享）
  *
- * @param {object} ctx - { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label }
- * @returns {{ blocked: boolean }}
+ * @param ctx { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label }
+ * @returns }
  */
 export function handleDepReview(ctx) {
     const { spmService, currentTarget, mod, ensureResult, NU, depWarnings, label = '' } = ctx;
@@ -83,11 +81,10 @@ export function handleDepReview(ctx) {
  *
  * 流程：保存剪贴板 → 写入 import 内容 → osascript 跳转+粘贴 → 恢复剪贴板
  *
- * @param {string} importLine  完整的 import 文本
- * @param {number} insertLine  1-based 行号
- * @param {object} XA          XcodeAutomation 模块
- * @param {object} CM          ClipboardManager 模块
- * @returns {boolean}
+ * @param importLine 完整的 import 文本
+ * @param insertLine 1-based 行号
+ * @param XA XcodeAutomation 模块
+ * @param CM ClipboardManager 模块
  */
 export function writeImportLineXcode(importLine, insertLine, XA, CM) {
     if (!XA.isXcodeRunning()) {
@@ -147,9 +144,7 @@ export function writeImportLineFile(filePath, importLine, isSwift) {
 // ═══════════════════════════════════════════════════════════════
 // 粘贴行号偏移计算
 // ═══════════════════════════════════════════════════════════════
-/**
- * 查找文件中最后一个 import 行的行号（1-based，0 表示无 import）
- */
+/** 查找文件中最后一个 import 行的行号（1-based，0 表示无 import） */
 export function getLastImportLine(filePath) {
     try {
         if (!existsSync(filePath)) {
@@ -193,4 +188,3 @@ export function computePasteLineNumber(triggerLineNumber, headerInsertCount, fil
     }
     return triggerLineNumber;
 }
-//# sourceMappingURL=XcodeWriteUtils.js.map

package/dist/lib/repository/base/BaseRepository.d.ts

@@ -20,21 +20,13 @@ export declare class BaseRepository {
      * is not a real column in the table.
      */
     _assertSafeColumn(key: string): void;
-    /**
-     * 创建实体
-     */
+    /** 创建实体 */
     create(entity: unknown): Promise<unknown>;
-    /**
-     * 根据 ID 获取实体
-     */
+    /** 根据 ID 获取实体 */
     findById(id: string): Promise<unknown>;
-    /**
-     * 获取所有实体
-     */
+    /** 获取所有实体 */
     findAll(filters?: Record<string, unknown>): Promise<unknown[]>;
-    /**
-     * 分页查询
-     */
+    /** 分页查询 */
     findWithPagination(filters?: Record<string, unknown>, { page, pageSize }?: {
         page?: number | undefined;
         pageSize?: number | undefined;
@@ -47,26 +39,15 @@ export declare class BaseRepository {
             pages: number;
         };
     }>;
-    /**
-     * 更新实体
-     */
+    /** 更新实体 */
     update(id: string, updates: Record<string, unknown>): Promise<unknown>;
-    /**
-     * 删除实体
-     */
+    /** 删除实体 */
     delete(id: string): Promise<boolean>;
-    /**
-     * 计数
-     */
+    /** 计数 */
     count(filters?: Record<string, unknown>): Promise<number>;
-    /**
-     * 映射行数据到实体（由子类实现）
-     */
+    /** 映射行数据到实体（由子类实现） */
     _mapRowToEntity(row: unknown): unknown;
-    /**
-     * 映射实体到行数据（由子类实现）
-     */
+    /** 映射实体到行数据（由子类实现） */
     _mapEntityToRow(entity: unknown): unknown;
 }
 export default BaseRepository;
-//# sourceMappingURL=BaseRepository.d.ts.map

package/dist/lib/repository/base/BaseRepository.js

@@ -48,15 +48,11 @@ export class BaseRepository {
             throw new Error(`Unknown column "${key}" for table ${this.tableName}`);
         }
     }
-    /**
-     * 创建实体
-     */
+    /** 创建实体 */
     async create(entity) {
         throw new Error('create() must be implemented in subclass');
     }
-    /**
-     * 根据 ID 获取实体
-     */
+    /** 根据 ID 获取实体 */
     async findById(id) {
         try {
             const stmt = this.db.prepare(`
@@ -77,9 +73,7 @@ export class BaseRepository {
             throw error;
         }
     }
-    /**
-     * 获取所有实体
-     */
+    /** 获取所有实体 */
     async findAll(filters = {}) {
         try {
             let query = `SELECT * FROM ${this.tableName}`;
@@ -106,9 +100,7 @@ export class BaseRepository {
             throw error;
         }
     }
-    /**
-     * 分页查询
-     */
+    /** 分页查询 */
     async findWithPagination(filters = {}, { page = 1, pageSize = 20 } = {}) {
         try {
             const offset = (page - 1) * pageSize;
@@ -152,9 +144,7 @@ export class BaseRepository {
             throw error;
         }
     }
-    /**
-     * 更新实体
-     */
+    /** 更新实体 */
     async update(id, updates) {
         try {
             const updateKeys = Object.keys(updates);
@@ -181,9 +171,7 @@ export class BaseRepository {
             throw error;
         }
     }
-    /**
-     * 删除实体
-     */
+    /** 删除实体 */
     async delete(id) {
         try {
             const stmt = this.db.prepare(`
@@ -201,9 +189,7 @@ export class BaseRepository {
             throw error;
         }
     }
-    /**
-     * 计数
-     */
+    /** 计数 */
     async count(filters = {}) {
         try {
             let query = `SELECT COUNT(*) as count FROM ${this.tableName}`;
@@ -228,18 +214,13 @@ export class BaseRepository {
             throw error;
         }
     }
-    /**
-     * 映射行数据到实体（由子类实现）
-     */
+    /** 映射行数据到实体（由子类实现） */
     _mapRowToEntity(row) {
         throw new Error('_mapRowToEntity() must be implemented in subclass');
     }
-    /**
-     * 映射实体到行数据（由子类实现）
-     */
+    /** 映射实体到行数据（由子类实现） */
     _mapEntityToRow(entity) {
         throw new Error('_mapEntityToRow() must be implemented in subclass');
     }
 }
 export default BaseRepository;
-//# sourceMappingURL=BaseRepository.js.map

package/dist/lib/repository/knowledge/KnowledgeRepository.impl.d.ts

@@ -63,9 +63,7 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
             pages: number;
         };
     }>;
-    /**
-     * 根据生命周期状态查询
-     */
+    /** 根据生命周期状态查询 */
     findByLifecycle(lifecycle: string, pagination?: KnowledgePaginationOptions): Promise<{
         data: (KnowledgeEntry | null)[];
         pagination: {
@@ -75,9 +73,7 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
             pages: number;
         };
     }>;
-    /**
-     * 根据 kind 查询
-     */
+    /** 根据 kind 查询 */
     findByKind(kind: string, options?: KnowledgePaginationOptions & {
         lifecycle?: string;
     }): Promise<{
@@ -94,9 +90,7 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
      * ★ Drizzle 类型安全查询
      */
     findActiveRules(): Promise<(KnowledgeEntry | null)[]>;
-    /**
-     * 根据语言查询
-     */
+    /** 根据语言查询 */
     findByLanguage(language: string, pagination?: KnowledgePaginationOptions): Promise<{
         data: (KnowledgeEntry | null)[];
         pagination: {
@@ -106,9 +100,7 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
             pages: number;
         };
     }>;
-    /**
-     * 根据分类查询
-     */
+    /** 根据分类查询 */
     findByCategory(category: string, pagination?: KnowledgePaginationOptions): Promise<{
         data: (KnowledgeEntry | null)[];
         pagination: {
@@ -118,9 +110,7 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
             pages: number;
         };
     }>;
-    /**
-     * 搜索
-     */
+    /** 搜索 */
     search(keyword: string, pagination?: KnowledgePaginationOptions): Promise<{
         data: (KnowledgeEntry | null)[];
         pagination: {
@@ -130,21 +120,11 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
             pages: number;
         };
     }>;
-    /**
-     * 获取统计信息
-     */
+    /** 获取统计信息 */
     getStats(): Promise<unknown>;
-    /**
-     * DB Row → KnowledgeEntry (camelCase 列名 = 属性名，直传)
-     * @param {Object} row
-     * @returns {KnowledgeEntry}
-     */
+    /** DB Row → KnowledgeEntry (camelCase 列名 = 属性名，直传) */
     _rowToEntity(row: Record<string, unknown>): KnowledgeEntry | null;
-    /**
-     * KnowledgeEntry → DB Row (camelCase 列名 = 属性名，直传)
-     * @param {KnowledgeEntry} e
-     * @returns {Object}
-     */
+    /** KnowledgeEntry → DB Row (camelCase 列名 = 属性名，直传) */
     _entityToRow(e: KnowledgeEntry): {
         id: string;
         title: string;
@@ -197,4 +177,3 @@ export declare class KnowledgeRepositoryImpl extends BaseRepository {
     _mapRowToEntity(row: unknown): KnowledgeEntry | null;
 }
 export default KnowledgeRepositoryImpl;
-//# sourceMappingURL=KnowledgeRepository.impl.d.ts.map

package/dist/lib/repository/knowledge/KnowledgeRepository.impl.js

@@ -148,15 +148,11 @@ export class KnowledgeRepositoryImpl extends BaseRepository {
             pagination: { page, pageSize, total, pages: Math.ceil(total / pageSize) },
         };
     }
-    /**
-     * 根据生命周期状态查询
-     */
+    /** 根据生命周期状态查询 */
     async findByLifecycle(lifecycle, pagination = {}) {
         return this.findWithPagination({ lifecycle }, pagination);
     }
-    /**
-     * 根据 kind 查询
-     */
+    /** 根据 kind 查询 */
     async findByKind(kind, options = {}) {
         const { lifecycle, ...pagination } = options;
         const filters = { kind };
@@ -184,27 +180,19 @@ export class KnowledgeRepositoryImpl extends BaseRepository {
             throw error;
         }
     }
-    /**
-     * 根据语言查询
-     */
+    /** 根据语言查询 */
     async findByLanguage(language, pagination = {}) {
         return this.findWithPagination({ language }, pagination);
     }
-    /**
-     * 根据分类查询
-     */
+    /** 根据分类查询 */
     async findByCategory(category, pagination = {}) {
         return this.findWithPagination({ category }, pagination);
     }
-    /**
-     * 搜索
-     */
+    /** 搜索 */
     async search(keyword, pagination = {}) {
         return this.findWithPagination({ _search: keyword }, pagination);
     }
-    /**
-     * 获取统计信息
-     */
+    /** 获取统计信息 */
     async getStats() {
         try {
             return this.db
@@ -228,11 +216,7 @@ export class KnowledgeRepositoryImpl extends BaseRepository {
         }
     }
     /* ═══ 行 ↔ 实体 映射 ═══════════════════════════════ */
-    /**
-     * DB Row → KnowledgeEntry (camelCase 列名 = 属性名，直传)
-     * @param {Object} row
-     * @returns {KnowledgeEntry}
-     */
+    /** DB Row → KnowledgeEntry (camelCase 列名 = 属性名，直传) */
     _rowToEntity(row) {
         if (!row) {
             return null;
@@ -256,11 +240,7 @@ export class KnowledgeRepositoryImpl extends BaseRepository {
             includeHeaders: !!row.includeHeaders,
         });
     }
-    /**
-     * KnowledgeEntry → DB Row (camelCase 列名 = 属性名，直传)
-     * @param {KnowledgeEntry} e
-     * @returns {Object}
-     */
+    /** KnowledgeEntry → DB Row (camelCase 列名 = 属性名，直传) */
     _entityToRow(e) {
         const now = unixNow();
         return {
@@ -318,4 +298,3 @@ export class KnowledgeRepositoryImpl extends BaseRepository {
     }
 }
 export default KnowledgeRepositoryImpl;
-//# sourceMappingURL=KnowledgeRepository.impl.js.map

package/dist/lib/repository/remote/RemoteCommandRepository.d.ts

@@ -48,18 +48,14 @@ export interface StatusCounts {
 export declare class RemoteCommandRepository {
     #private;
     constructor(db: Database, drizzle?: DrizzleDB);
-    /**
-     * 写入新的远程指令到队列
-     */
+    /** 写入新的远程指令到队列 */
     enqueue(input: CreateCommandInput): void;
     /**
      * 认领一条 pending 指令（CAS: pending → running）
      * @returns 是否成功（0 changes = 已被认领或不存在）
      */
     claim(id: string): boolean;
-    /**
-     * 提交指令执行结果（running → completed/failed/...）
-     */
+    /** 提交指令执行结果（running → completed/failed/...） */
     complete(id: string, resultText: string, status?: string): void;
     /**
      * 批量取消所有 pending 指令（IDE 重连时 flush）
@@ -70,31 +66,19 @@ export declare class RemoteCommandRepository {
         command: string;
         createdAt: number;
     }>;
-    /**
-     * 获取最早的一条 pending 指令
-     */
+    /** 获取最早的一条 pending 指令 */
     findFirstPending(): RemoteCommandRow | null;
-    /**
-     * 根据 ID 获取指令
-     */
+    /** 根据 ID 获取指令 */
     findById(id: string): RemoteCommandRow | null;
-    /**
-     * 获取历史记录（按创建时间降序）
-     */
+    /** 获取历史记录（按创建时间降序） */
     getHistory(limit?: number): RemoteCommandRow[];
-    /**
-     * 获取各状态的指令计数（用于 /lark/status 诊断面板）
-     */
+    /** 获取各状态的指令计数（用于 /lark/status 诊断面板） */
     getStatusCounts(): StatusCounts;
-    /**
-     * 查找最近一次 claim 记录（用于 IDE 心跳检测）
-     */
+    /** 查找最近一次 claim 记录（用于 IDE 心跳检测） */
     findRecentClaim(): {
         claimedAt: number;
     } | null;
-    /**
-     * 查找最近有 chatId 的指令（用于恢复活跃会话）
-     */
+    /** 查找最近有 chatId 的指令（用于恢复活跃会话） */
     findRecentChatId(): string | null;
     /**
      * 清理超时的 pending 和 running 指令
@@ -103,13 +87,8 @@ export declare class RemoteCommandRepository {
      * @returns 清理的总条数
      */
     cleanupTimeouts(pendingTimeoutSec: number, runningTimeoutSec: number): number;
-    /**
-     * 持久化键值对到 remote_state
-     */
+    /** 持久化键值对到 remote_state */
     setState(key: string, value: string): void;
-    /**
-     * 从 remote_state 读取值
-     */
+    /** 从 remote_state 读取值 */
     getState(key: string): string | null;
 }
-//# sourceMappingURL=RemoteCommandRepository.d.ts.map