autosnippet 3.2.16 → 3.2.17

package/dist/lib/{service/agent → agent}/tools/composite.js

@@ -8,9 +8,9 @@
  * ──  plan_task          元工具: 任务规划
  * ──  review_my_output   元工具: 自我质量审查
  */
-import { getInternalAgentRequiredFields, getSystemInjectedFields } from '#shared/FieldSpec.js';
-import { UnifiedValidator } from '#shared/UnifiedValidator.js';
-import { findSimilarRecipes } from '../../candidate/SimilarityService.js';
+import { getInternalAgentRequiredFields, getSystemInjectedFields, } from '#domain/knowledge/FieldSpec.js';
+import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
+import { findSimilarRecipes } from '#service/candidate/SimilarityService.js';
 import { checkDimensionType, DIMENSION_DISPLAY_GROUP, } from './_shared.js';
 // ────────────────────────────────────────────────────────────
 // 34. analyze_code — 组合工具 (Guard + Recipe 搜索)
@@ -519,4 +519,3 @@ export const reviewMyOutput = {
         };
     },
 };
-//# sourceMappingURL=composite.js.map

package/dist/lib/{service/agent → agent}/tools/guard.d.ts

@@ -122,4 +122,3 @@ export declare const queryViolations: {
     };
     handler: (params: QueryViolationsParams, ctx: ToolHandlerContext) => Promise<any>;
 };
-//# sourceMappingURL=guard.d.ts.map

package/dist/lib/{service/agent → agent}/tools/guard.js

@@ -122,4 +122,3 @@ export const queryViolations = {
         return store.list({}, { page: 1, limit });
     },
 };
-//# sourceMappingURL=guard.js.map

package/dist/lib/{service/agent → agent}/tools/index.d.ts

@@ -36,7 +36,7 @@ export declare const ALL_TOOLS: ({
         needsEnrichment: number;
         needsRecipeFields: number;
         fullyComplete: number;
-        entries: import("../../../external/mcp/handlers/types.js").EnrichResultEntry[];
+        entries: import("../../external/mcp/handlers/types.js").EnrichResultEntry[];
         hint: string;
     } | {
         success: boolean;
@@ -47,7 +47,7 @@ export declare const ALL_TOOLS: ({
             needsEnrichment: number;
             needsRecipeFields: number;
             fullyComplete: number;
-            entries: import("../../../external/mcp/handlers/types.js").EnrichResultEntry[];
+            entries: import("../../external/mcp/handlers/types.js").EnrichResultEntry[];
             hint: string;
         } | null;
         meta: {
@@ -818,7 +818,7 @@ export declare const ALL_TOOLS: ({
         required: never[];
     };
     handler: (_params: Record<string, never>, ctx: import("./_shared.js").ToolHandlerContext) => Promise<{
-        suggestions: import("../../skills/SkillAdvisor.js").SkillSuggestion[];
+        suggestions: import("../../service/skills/SkillAdvisor.js").SkillSuggestion[];
         existingProjectSkills: unknown[];
         analysisContext: Record<string, unknown>;
         hint: string;
@@ -1900,4 +1900,3 @@ export declare const ALL_TOOLS: ({
     handler: (params: import("./system-interaction.js").GetEnvironmentInfoParams, ctx: import("./_shared.js").ToolHandlerContext) => Promise<import("./system-interaction.js").EnvironmentInfo>;
 })[];
 export default ALL_TOOLS;
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/{service/agent → agent}/tools/index.js

@@ -134,4 +134,3 @@ export const ALL_TOOLS = [
     collectScanRecipe,
 ];
 export default ALL_TOOLS;
-//# sourceMappingURL=index.js.map

package/dist/lib/{service/agent → agent}/tools/infrastructure.d.ts

@@ -153,7 +153,7 @@ export declare const suggestSkills: {
         required: never[];
     };
     handler: (_params: Record<string, never>, ctx: ToolHandlerContext) => Promise<{
-        suggestions: import("../../skills/SkillAdvisor.js").SkillSuggestion[];
+        suggestions: import("#service/skills/SkillAdvisor.js").SkillSuggestion[];
         existingProjectSkills: unknown[];
         analysisContext: Record<string, unknown>;
         hint: string;
@@ -195,4 +195,3 @@ export declare const bootstrapKnowledgeTool: {
         skipAsyncFill?: boolean;
     }, ctx: ToolHandlerContext) => Promise<any>;
 };
-//# sourceMappingURL=infrastructure.d.ts.map

package/dist/lib/{service/agent → agent}/tools/infrastructure.js

@@ -152,7 +152,7 @@ export const createSkillTool = {
         required: ['name', 'description', 'content'],
     },
     handler: async (params, ctx) => {
-        const { createSkill } = await import('../../../external/mcp/handlers/skill.js');
+        const { createSkill } = await import('#external/mcp/handlers/skill.js');
         // 根据 Agent 的 source 推断 createdBy
         const createdBy = ctx?.source === 'system' ? 'system-ai' : 'user-ai';
         const raw = createSkill(null, { ...params, createdBy });
@@ -176,7 +176,7 @@ export const suggestSkills = {
         required: [],
     },
     handler: async (_params, ctx) => {
-        const { SkillAdvisor } = await import('../../skills/SkillAdvisor.js');
+        const { SkillAdvisor } = await import('#service/skills/SkillAdvisor.js');
         const database = ctx?.container?.get?.('database') || null;
         const projectRoot = ctx?.projectRoot || process.cwd();
         const advisor = new SkillAdvisor(projectRoot, { database });
@@ -206,7 +206,7 @@ export const bootstrapKnowledgeTool = {
         },
     },
     handler: async (params, ctx) => {
-        const { bootstrapKnowledge } = await import('../../../external/mcp/handlers/bootstrap-internal.js');
+        const { bootstrapKnowledge } = await import('#external/mcp/handlers/bootstrap-internal.js');
         const logger = Logger.getInstance();
         const result = await bootstrapKnowledge({ container: ctx.container, logger }, {
             maxFiles: params.maxFiles || 500,
@@ -220,4 +220,3 @@ export const bootstrapKnowledgeTool = {
         return parsed?.data || parsed;
     },
 };
-//# sourceMappingURL=infrastructure.js.map

package/dist/lib/{service/agent → agent}/tools/knowledge-graph.d.ts

@@ -88,4 +88,3 @@ export declare const addGraphEdge: {
     };
     handler: (params: Record<string, unknown>, ctx: ToolHandlerContext) => Promise<any>;
 };
-//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/lib/{service/agent → agent}/tools/knowledge-graph.js

@@ -7,7 +7,7 @@
  * 注意: discover_relations 已删除。
  * 关系发现由 Agent LLM 直接推理完成，利用通用工具（search_knowledge, query_code_graph 等）。
  */
-import { findSimilarRecipes } from '../../candidate/SimilarityService.js';
+import { findSimilarRecipes } from '#service/candidate/SimilarityService.js';
 // ────────────────────────────────────────────────────────────
 // 10. check_duplicate
 // ────────────────────────────────────────────────────────────
@@ -94,4 +94,3 @@ export const addGraphEdge = {
         return kgService.addEdge(params.fromId, params.fromType, params.toId, params.toType, params.relation, { weight: params.weight || 1.0, source: 'manual' });
     },
 };
-//# sourceMappingURL=knowledge-graph.js.map

package/dist/lib/{service/agent → agent}/tools/lifecycle.d.ts

@@ -379,4 +379,3 @@ export declare const getFeedbackStats: {
         topN?: number;
     }, ctx: ToolHandlerContext) => Promise<Record<string, unknown>>;
 };
-//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lib/{service/agent → agent}/tools/lifecycle.js

@@ -13,8 +13,8 @@
  * 24.  validate_candidate   候选校验
  * 25.  get_feedback_stats   反馈统计
  */
-import { getInternalAgentRequiredFields, getSystemInjectedFields } from '#shared/FieldSpec.js';
-import { UnifiedValidator } from '#shared/UnifiedValidator.js';
+import { getInternalAgentRequiredFields, getSystemInjectedFields, } from '#domain/knowledge/FieldSpec.js';
+import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
 import { checkDimensionType, DIMENSION_DISPLAY_GROUP } from './_shared.js';
 // ────────────────────────────────────────────────────────────
 // 16. submit_knowledge
@@ -450,4 +450,3 @@ export const getFeedbackStats = {
         return result;
     },
 };
-//# sourceMappingURL=lifecycle.js.map

package/dist/lib/{service/agent → agent}/tools/project-access.d.ts

@@ -389,4 +389,3 @@ export declare const semanticSearchCode: {
     }>;
 };
 export {};
-//# sourceMappingURL=project-access.d.ts.map

package/dist/lib/{service/agent → agent}/tools/project-access.js

@@ -820,4 +820,3 @@ export const semanticSearchCode = {
         }
     },
 };
-//# sourceMappingURL=project-access.js.map

package/dist/lib/{service/agent → agent}/tools/query.d.ts

@@ -173,4 +173,3 @@ export declare const getRelatedRecipes: {
         relation?: string;
     }, ctx: ToolHandlerContext) => Promise<any>;
 };
-//# sourceMappingURL=query.d.ts.map

package/dist/lib/{service/agent → agent}/tools/query.js

@@ -250,4 +250,3 @@ export const getRelatedRecipes = {
         return { recipeId, ...edges };
     },
 };
-//# sourceMappingURL=query.js.map

package/dist/lib/{service/agent → agent}/tools/scan-recipe.d.ts

@@ -183,4 +183,3 @@ export declare const collectScanRecipe: {
     }>;
 };
 export default collectScanRecipe;
-//# sourceMappingURL=scan-recipe.d.ts.map

package/dist/lib/{service/agent → agent}/tools/scan-recipe.js

@@ -192,4 +192,3 @@ export const collectScanRecipe = {
     },
 };
 export default collectScanRecipe;
-//# sourceMappingURL=scan-recipe.js.map

package/dist/lib/{service/agent → agent}/tools/system-interaction.d.ts

@@ -151,4 +151,3 @@ export declare const getEnvironmentInfo: {
     handler: (params: GetEnvironmentInfoParams, ctx: ToolHandlerContext) => Promise<EnvironmentInfo>;
 };
 export {};
-//# sourceMappingURL=system-interaction.d.ts.map

package/dist/lib/{service/agent → agent}/tools/system-interaction.js

@@ -73,9 +73,7 @@ const MAX_OUTPUT_LENGTH = 16_000;
 /** 文件写入最大尺寸 (bytes) */
 const MAX_WRITE_SIZE = 512 * 1024;
 // ─── 内部工具函数 ────────────────────────────────────
-/**
- * 硬编码黑名单检查 — 工具层兜底, 无论是否有 SafetyPolicy 都生效
- */
+/** 硬编码黑名单检查 — 工具层兜底, 无论是否有 SafetyPolicy 都生效 */
 function _isHardBlacklisted(command) {
     for (const pattern of HARDCODED_BLACKLIST) {
         if (pattern.test(command)) {
@@ -84,25 +82,19 @@ function _isHardBlacklisted(command) {
     }
     return false;
 }
-/**
- * 无 SafetyPolicy 时的白名单兜底
- */
+/** 无 SafetyPolicy 时的白名单兜底 */
 function _isFallbackSafe(command) {
     const trimmed = command.trim();
     return FALLBACK_SAFE_PREFIXES.some((prefix) => trimmed.startsWith(prefix));
 }
-/**
- * 截断过长输出
- */
+/** 截断过长输出 */
 function _truncate(text, max = MAX_OUTPUT_LENGTH) {
     if (!text || text.length <= max) {
         return text;
     }
     return `${text.slice(0, max)}\n\n... [输出已截断, 共 ${text.length} 字符]`;
 }
-/**
- * 获取 projectRoot — 优先从 context 获取, 兜底用 cwd
- */
+/** 获取 projectRoot — 优先从 context 获取, 兜底用 cwd */
 function _getProjectRoot(ctx) {
     return ctx.projectRoot || ctx.container?.get?.('projectRoot') || process.cwd();
 }
@@ -454,4 +446,3 @@ export const getEnvironmentInfo = {
         return info;
     },
 };
-//# sourceMappingURL=system-interaction.js.map

package/dist/lib/bootstrap.d.ts

@@ -8,9 +8,7 @@ import ConfigLoader from './infrastructure/config/ConfigLoader.js';
 import DatabaseConnection from './infrastructure/database/DatabaseConnection.js';
 import Logger from './infrastructure/logging/Logger.js';
 import { SkillHooks } from './service/skills/SkillHooks.js';
-/**
- * Bootstrap - 应用程序启动器
- */
+/** Bootstrap - 应用程序启动器 */
 /** Bootstrap 初始化选项 */
 interface BootstrapOptions {
     configPath?: string;
@@ -39,54 +37,31 @@ export declare class Bootstrap {
     /**
      * 配置 PathGuard 路径安全守卫
      * 必须在任何文件写操作前调用
-     * @param {string} projectRoot 用户项目的绝对路径
-     * @param {string} [knowledgeBaseDir] 知识库目录名（如 'AutoSnippet'）
+     * @param projectRoot 用户项目的绝对路径
+     * @param [knowledgeBaseDir] 知识库目录名（如 'AutoSnippet'）
      */
     static configurePathGuard(projectRoot: string, knowledgeBaseDir?: string): void;
-    /**
-     * 初始化应用程序
-     */
+    /** 初始化应用程序 */
     initialize(): Promise<BootstrapComponents>;
-    /**
-     * 加载 .env 文件（dotenv），不覆盖已有环境变量
-     */
+    /** 加载 .env 文件（dotenv），不覆盖已有环境变量 */
     loadDotEnv(): Promise<void>;
-    /**
-     * 加载配置
-     */
+    /** 加载配置 */
     loadConfig(): Promise<void>;
-    /**
-     * 初始化日志系统
-     */
+    /** 初始化日志系统 */
     initializeLogger(): Promise<void>;
-    /**
-     * 初始化数据库
-     */
+    /** 初始化数据库 */
     initializeDatabase(): Promise<void>;
-    /**
-     * 加载宪法
-     */
+    /** 加载宪法 */
     loadConstitution(): Promise<void>;
-    /**
-     * 初始化核心组件
-     */
+    /** 初始化核心组件 */
     initializeCoreComponents(): Promise<void>;
-    /**
-     * 初始化网关
-     */
+    /** 初始化网关 */
     initializeGateway(): Promise<void>;
-    /**
-     * 关闭应用程序
-     */
+    /** 关闭应用程序 */
     shutdown(): Promise<void>;
-    /**
-     * 获取组件
-     */
+    /** 获取组件 */
     getComponent(name: string): unknown;
-    /**
-     * 获取所有组件
-     */
+    /** 获取所有组件 */
     getAllComponents(): BootstrapComponents;
 }
 export default Bootstrap;
-//# sourceMappingURL=bootstrap.d.ts.map

package/dist/lib/bootstrap.js

@@ -22,8 +22,8 @@ export class Bootstrap {
     /**
      * 配置 PathGuard 路径安全守卫
      * 必须在任何文件写操作前调用
-     * @param {string} projectRoot 用户项目的绝对路径
-     * @param {string} [knowledgeBaseDir] 知识库目录名（如 'AutoSnippet'）
+     * @param projectRoot 用户项目的绝对路径
+     * @param [knowledgeBaseDir] 知识库目录名（如 'AutoSnippet'）
      */
     static configurePathGuard(projectRoot, knowledgeBaseDir) {
         if (!pathGuard.configured && projectRoot) {
@@ -34,9 +34,7 @@ export class Bootstrap {
             pathGuard.setKnowledgeBaseDir(knowledgeBaseDir);
         }
     }
-    /**
-     * 初始化应用程序
-     */
+    /** 初始化应用程序 */
     async initialize() {
         const startTime = Date.now();
         try {
@@ -72,9 +70,7 @@ export class Bootstrap {
             throw error;
         }
     }
-    /**
-     * 加载 .env 文件（dotenv），不覆盖已有环境变量
-     */
+    /** 加载 .env 文件（dotenv），不覆盖已有环境变量 */
     async loadDotEnv() {
         try {
             // 沿目录树向上查找 .env：cwd → AutoSnippet 包根 → 用户项目根
@@ -92,25 +88,19 @@ export class Bootstrap {
             // dotenv 可选依赖，加载失败不阻塞启动
         }
     }
-    /**
-     * 加载配置
-     */
+    /** 加载配置 */
     async loadConfig() {
         const env = this.options.env || process.env.NODE_ENV || 'development';
         ConfigLoader.load(env);
         this.components.config = ConfigLoader;
     }
-    /**
-     * 初始化日志系统
-     */
+    /** 初始化日志系统 */
     async initializeLogger() {
         const config = this.components.config.get('logging');
         const logger = Logger.getInstance(config);
         this.components.logger = logger;
     }
-    /**
-     * 初始化数据库
-     */
+    /** 初始化数据库 */
     async initializeDatabase() {
         const dbConfig = this.components.config.get('database');
         const db = new DatabaseConnection(dbConfig);
@@ -119,18 +109,14 @@ export class Bootstrap {
         this.components.db = db;
         this.components.logger.info('Database connected and migrated');
     }
-    /**
-     * 加载宪法
-     */
+    /** 加载宪法 */
     async loadConstitution() {
         const constitutionPath = path.join(CONFIG_DIR, 'constitution.yaml');
         const constitution = new Constitution(constitutionPath);
         this.components.constitution = constitution;
         this.components.logger.info('Constitution loaded', constitution.toJSON());
     }
-    /**
-     * 初始化核心组件
-     */
+    /** 初始化核心组件 */
     async initializeCoreComponents() {
         const { constitution, db, logger } = this.components;
         // Constitution Validator
@@ -153,9 +139,7 @@ export class Bootstrap {
         this.components.skillHooks = skillHooks;
         logger.info('Skill hooks loaded');
     }
-    /**
-     * 初始化网关
-     */
+    /** 初始化网关 */
     async initializeGateway() {
         const gatewayConfig = this.components.config.has('gateway')
             ? this.components.config.get('gateway')
@@ -171,9 +155,7 @@ export class Bootstrap {
         this.components.gateway = gateway;
         this.components.logger.info('Gateway initialized');
     }
-    /**
-     * 关闭应用程序
-     */
+    /** 关闭应用程序 */
     async shutdown() {
         this.components.logger?.info('AutoSnippet - Shutting down...');
         // 关闭数据库连接（WAL checkpoint → close）
@@ -190,18 +172,13 @@ export class Bootstrap {
         }
         this.components.logger?.info('AutoSnippet - Shutdown complete');
     }
-    /**
-     * 获取组件
-     */
+    /** 获取组件 */
     getComponent(name) {
         return this.components[name];
     }
-    /**
-     * 获取所有组件
-     */
+    /** 获取所有组件 */
     getAllComponents() {
         return this.components;
     }
 }
 export default Bootstrap;
-//# sourceMappingURL=bootstrap.js.map

package/dist/lib/cli/AiScanService.d.ts

@@ -19,9 +19,8 @@ export declare class AiScanService {
     logger: ReturnType<typeof Logger.getInstance>;
     projectRoot: string;
     /**
-     * @param {object} opts
-     * @param {object} opts.container   ServiceContainer 实例
-     * @param {string} opts.projectRoot 项目根目录
+     * @param opts.container ServiceContainer 实例
+     * @param opts.projectRoot 项目根目录
      */
     constructor({ container, projectRoot, }: {
         container: {
@@ -32,9 +31,9 @@ export declare class AiScanService {
     });
     /**
      * 扫描指定 Target（或全部 Target）的源文件并提取 Recipe，创建后直接发布
-     * @param {string|null} targetName  Target 名称；null 时扫描全部
-     * @param {object}      opts        { maxFiles, dryRun, concurrency }
-     * @returns {Promise<{ published: number, files: number, errors: string[] }>}
+     * @param targetName Target 名称；null 时扫描全部
+     * @param opts { maxFiles, dryRun, concurrency }
+     * @returns >}
      */
     scan(targetName: string | null, opts?: {
         maxFiles?: number;
@@ -45,28 +44,21 @@ export declare class AiScanService {
         errors: string[];
         skipped: number;
     }>;
-    /**
-     * 收集 Target 源文件
-     */
+    /** 收集 Target 源文件 */
     _collectFiles(targetName: string | null, maxFiles: number): Promise<{
         name: string;
         path: string;
         relativePath: string;
         targetName: string;
     }[]>;
-    /**
-     * 递归扫描目录（fallback）
-     */
+    /** 递归扫描目录（fallback） */
     _walkDir(dir: string, files: Array<{
         name: string;
         path: string;
         relativePath: string;
         targetName: string;
     }>, maxFiles: number, targetName: string): void;
-    /**
-     * 从文件名推断语言
-     */
+    /** 从文件名推断语言 */
     _inferLanguage(filename: string): string;
 }
 export default AiScanService;
-//# sourceMappingURL=AiScanService.d.ts.map

package/dist/lib/cli/AiScanService.js

@@ -17,9 +17,8 @@ export class AiScanService {
     logger;
     projectRoot;
     /**
-     * @param {object} opts
-     * @param {object} opts.container   ServiceContainer 实例
-     * @param {string} opts.projectRoot 项目根目录
+     * @param opts.container ServiceContainer 实例
+     * @param opts.projectRoot 项目根目录
      */
     constructor({ container, projectRoot, }) {
         this.container = container;
@@ -29,9 +28,9 @@ export class AiScanService {
     }
     /**
      * 扫描指定 Target（或全部 Target）的源文件并提取 Recipe，创建后直接发布
-     * @param {string|null} targetName  Target 名称；null 时扫描全部
-     * @param {object}      opts        { maxFiles, dryRun, concurrency }
-     * @returns {Promise<{ published: number, files: number, errors: string[] }>}
+     * @param targetName Target 名称；null 时扫描全部
+     * @param opts { maxFiles, dryRun, concurrency }
+     * @returns >}
      */
     async scan(targetName, opts = {}) {
         const { maxFiles = 200, dryRun = false } = opts;
@@ -118,9 +117,7 @@ export class AiScanService {
         }
         return report;
     }
-    /**
-     * 收集 Target 源文件
-     */
+    /** 收集 Target 源文件 */
     async _collectFiles(targetName, maxFiles) {
         const files = [];
         try {
@@ -188,9 +185,7 @@ export class AiScanService {
         }
         return files;
     }
-    /**
-     * 递归扫描目录（fallback）
-     */
+    /** 递归扫描目录（fallback） */
     _walkDir(dir, files, maxFiles, targetName) {
         if (files.length >= maxFiles) {
             return;
@@ -241,12 +236,9 @@ export class AiScanService {
             }
         }
     }
-    /**
-     * 从文件名推断语言
-     */
+    /** 从文件名推断语言 */
     _inferLanguage(filename) {
         return LanguageService.inferLang(filename);
     }
 }
 export default AiScanService;
-//# sourceMappingURL=AiScanService.js.map

package/dist/lib/cli/CliLogger.d.ts

@@ -38,4 +38,3 @@ declare class CliLogger {
 /** 全局单例 */
 export declare const cli: CliLogger;
 export default cli;
-//# sourceMappingURL=CliLogger.d.ts.map

package/dist/lib/cli/CliLogger.js

@@ -70,4 +70,3 @@ class CliLogger {
 /** 全局单例 */
 export const cli = new CliLogger();
 export default cli;
-//# sourceMappingURL=CliLogger.js.map

package/dist/lib/cli/KnowledgeSyncService.d.ts

@@ -19,21 +19,17 @@ export declare class KnowledgeSyncService {
     logger: ReturnType<typeof Logger.getInstance>;
     projectRoot: string;
     recipesDir: string;
-    /**
-     * @param {string} projectRoot
-     */
     constructor(projectRoot: string);
     /**
      * 执行增量同步：.md → DB（knowledge_entries 表）
      *
      * 同时扫描 candidates/ 和 recipes/ 两个目录。
      *
-     * @param {import('better-sqlite3').Database} db  better-sqlite3 原始句柄
-     * @param {Object}  [opts={}]
-     * @param {boolean} [opts.dryRun=false]        只报告不写入
-     * @param {boolean} [opts.force=false]         忽略 hash，强制覆盖
-     * @param {boolean} [opts.skipViolations=false] 跳过违规记录（setup 场景）
-     * @returns {{ synced: number, created: number, updated: number, violations: string[], orphaned: string[], skipped: number }}
+     * @param db better-sqlite3 原始句柄
+     * @param [opts.dryRun=false] 只报告不写入
+     * @param [opts.force=false] 忽略 hash，强制覆盖
+     * @param [opts.skipViolations=false] 跳过违规记录（setup 场景）
+     * @returns }
      */
     sync(db: {
         prepare: (sql: string) => {
@@ -55,9 +51,9 @@ export declare class KnowledgeSyncService {
     };
     /**
      * 递归收集指定目录下所有 .md 文件（跳过 _ 前缀模板）
-     * @param {string} dir    绝对目录路径
-     * @param {string} prefix 相对路径前缀 (e.g. 'AutoSnippet/candidates')
-     * @returns {{ absPath: string, relPath: string }[]}
+     * @param dir 绝对目录路径
+     * @param prefix 相对路径前缀 (e.g. 'AutoSnippet/candidates')
+     * @returns []}
      */
     _collectMdFiles(dir: string, prefix: string): {
         absPath: string;
@@ -113,9 +109,7 @@ export declare class KnowledgeSyncService {
         publishedBy: {} | null;
         contentHash: string;
     };
-    /**
-     * 准备 upsert 语句（INSERT ... ON CONFLICT DO UPDATE 全字段）
-     */
+    /** 准备 upsert 语句（INSERT ... ON CONFLICT DO UPDATE 全字段） */
     _prepareUpsert(db: {
         prepare: (sql: string) => {
             run: (...args: unknown[]) => void;
@@ -123,9 +117,7 @@ export declare class KnowledgeSyncService {
     }): {
         run: (...args: unknown[]) => void;
     };
-    /**
-     * 检查 entry 是否已存在于 DB
-     */
+    /** 检查 entry 是否已存在于 DB */
     _entryExists(db: {
         prepare: (sql: string) => {
             get: (...args: unknown[]) => unknown;
@@ -143,7 +135,7 @@ export declare class KnowledgeSyncService {
     }, entryId: string, filePath: string, expectedHash: string, actualHash: string): void;
     /**
      * 检测 DB 中存在但 .md 已删除的 Entry → 标记 deprecated
-     * @returns {string[]} 孤儿 entry id 列表
+     * @returns 孤儿 entry id 列表
      */
     _detectOrphans(db: {
         prepare: (sql: string) => {
@@ -153,4 +145,3 @@ export declare class KnowledgeSyncService {
     }, syncedIds: Set<string>, dryRun: boolean): string[];
 }
 export default KnowledgeSyncService;
-//# sourceMappingURL=KnowledgeSyncService.d.ts.map