autosnippet 3.2.16 → 3.2.17

package/dist/lib/service/bootstrap/BootstrapTaskManager.js

@@ -25,9 +25,7 @@ export const TaskStatus = Object.freeze({
     COMPLETED: 'completed', // 填充完成
     FAILED: 'failed', // 填充失败
 });
-/**
- * 单个 Bootstrap 会话（一次冷启动的全部上下文）
- */
+/** 单个 Bootstrap 会话（一次冷启动的全部上下文） */
 class BootstrapSession {
     completedAt;
     id;
@@ -118,9 +116,7 @@ class BootstrapSession {
     }
 }
 export class BootstrapTaskManager {
-    /** @type {BootstrapSession|null} */
     #currentSession = null;
-    /** @type {import('../../infrastructure/event/EventBus.js').EventBus|null} */
     #eventBus = null;
     /** @type {Function|null} 获取 RealtimeService 的 getter（延迟获取，避免循环依赖） */
     #getRealtimeService = null;
@@ -137,7 +133,6 @@ export class BootstrapTaskManager {
      * 如果上一个会话仍在运行，自动 abort 后再创建新会话（防止重复触发产出重复 Candidate）。
      *
      * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
-     * @returns {BootstrapSession}
      */
     startSession(taskDefs) {
         // ── 并发锁：如果上一个 session 还在运行，先中止 ──
@@ -165,7 +160,7 @@ export class BootstrapTaskManager {
      * 将所有未完成的任务标记为 failed，并将 session 标记为 aborted。
      * 异步填充函数通过 `isSessionValid(sessionId)` 检测到 session 已变更后自动退出。
      *
-     * @param {string} [reason='Aborted by user']
+     * @param [reason='Aborted by user']
      */
     abortSession(reason = 'Aborted by user') {
         const session = this.#currentSession;
@@ -208,9 +203,6 @@ export class BootstrapTaskManager {
      *
      * 用于异步填充函数在每次循环迭代前检测：如果 session 已被新请求覆盖，
      * 则当前异步填充应立即停止，避免产出重复内容。
-     *
-     * @param {string} sessionId
-     * @returns {boolean}
      */
     isSessionValid(sessionId) {
         // Session 在 running 或 completed 状态都有效 — completed 表示维度填充完成，
@@ -220,9 +212,7 @@ export class BootstrapTaskManager {
                 this.#currentSession?.status === 'completed' ||
                 this.#currentSession?.status === 'completed_with_errors'));
     }
-    /**
-     * 标记单个任务开始填充
-     */
+    /** 标记单个任务开始填充 */
     markTaskFilling(taskId) {
         const session = this.#currentSession;
         if (!session) {
@@ -244,8 +234,7 @@ export class BootstrapTaskManager {
     }
     /**
      * 标记单个任务完成
-     * @param {string} taskId
-     * @param {object} result 填充结果摘要 { created, items, ... }
+     * @param result 填充结果摘要 { created, items, ... }
      */
     markTaskCompleted(taskId, result = {}) {
         const session = this.#currentSession;
@@ -276,9 +265,7 @@ export class BootstrapTaskManager {
             this.#finishSession();
         }
     }
-    /**
-     * 标记单个任务失败
-     */
+    /** 标记单个任务失败 */
     markTaskFailed(taskId, error) {
         const session = this.#currentSession;
         if (!session) {
@@ -308,18 +295,14 @@ export class BootstrapTaskManager {
     // ═══════════════════════════════════════════════════════════
     //  查询接口
     // ═══════════════════════════════════════════════════════════
-    /**
-     * 获取当前 session 状态（供 HTTP 轮询）
-     */
+    /** 获取当前 session 状态（供 HTTP 轮询） */
     getSessionStatus() {
         if (!this.#currentSession) {
             return { status: 'idle', message: 'No active bootstrap session' };
         }
         return this.#currentSession.toJSON();
     }
-    /**
-     * 是否有正在进行的 bootstrap
-     */
+    /** 是否有正在进行的 bootstrap */
     get isRunning() {
         return this.#currentSession?.status === 'running';
     }
@@ -332,8 +315,8 @@ export class BootstrapTaskManager {
      * 用途：不走 bootstrap session 模型的长操作（如 AI 润色）也能复用
      * 同一套 EventBus + RealtimeService 双通道推送。
      *
-     * @param {string} eventName 事件名（如 'refine:started'）
-     * @param {object} data      事件负载
+     * @param eventName 事件名（如 'refine:started'）
+     * @param data 事件负载
      */
     emitProgress(eventName, data) {
         this.#emit(eventName, data);
@@ -368,9 +351,7 @@ export class BootstrapTaskManager {
             })),
         });
     }
-    /**
-     * 发射事件到 EventBus + 推送到前端 Socket.io
-     */
+    /** 发射事件到 EventBus + 推送到前端 Socket.io */
     #emit(eventName, data) {
         // EventBus（供后端监听者使用）
         if (this.#eventBus) {
@@ -395,4 +376,3 @@ export class BootstrapTaskManager {
         }
     }
 }
-//# sourceMappingURL=BootstrapTaskManager.js.map

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

@@ -7,16 +7,16 @@
  *
  * ---
  * 使用方式：
- *   import { DimensionCopy } from '../shared/DimensionCopyRegistry.js';
+ *   import { DimensionCopy } from '../service/bootstrap/DimensionCopyRegistry.js';
  *   const copy = DimensionCopy.get('code-pattern', 'python');
  *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
  */
 export declare class DimensionCopy {
     /**
      * 获取指定维度在指定语言下的文案
-     * @param {string} dimId   维度 ID (如 'code-standard')
-     * @param {string} lang    主语言 ID (如 'python', 'typescript')
-     * @returns {{ label: string, guide: string } | null}
+     * @param dimId 维度 ID (如 'code-standard')
+     * @param lang 主语言 ID (如 'python', 'typescript')
+     * @returns | null}
      */
     static get(dimId: string, lang: string): {
         label: string;
@@ -26,8 +26,8 @@ export declare class DimensionCopy {
      * 批量为维度数组注入语言差异化文案（单语言版本）
      * 会直接修改维度对象的 label 和 guide 字段
      * @param {Array<{ id: string, label: string, guide: string }>} dimensions
-     * @param {string} lang 主语言
-     * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
+     * @param lang 主语言
+     * @returns >} 原数组引用
      */
     static apply(dimensions: Array<{
         id: string;
@@ -47,9 +47,9 @@ export declare class DimensionCopy {
      *   - 如果主语言和次要语言属于同一语言族，跳过（避免重复）
      *
      * @param {Array<{ id: string, label: string, guide: string }>} dimensions
-     * @param {string} primary 主语言 ID
-     * @param {string[]} secondary 次要语言 ID 列表
-     * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
+     * @param primary 主语言 ID
+     * @param secondary 次要语言 ID 列表
+     * @returns >} 原数组引用
      */
     static applyMulti(dimensions: Array<{
         id: string;
@@ -60,17 +60,9 @@ export declare class DimensionCopy {
         label: string;
         guide: string;
     }[];
-    /**
-     * 获取所有已有文案的维度 ID 列表
-     * @returns {string[]}
-     */
+    /** 获取所有已有文案的维度 ID 列表 */
     static registeredDimIds(): string[];
-    /**
-     * 获取某维度所有可用语言族
-     * @param {string} dimId
-     * @returns {string[]}
-     */
+    /** 获取某维度所有可用语言族 */
     static availableFamilies(dimId: string): string[];
 }
 export default DimensionCopy;
-//# sourceMappingURL=DimensionCopyRegistry.d.ts.map

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

@@ -7,7 +7,7 @@
  *
  * ---
  * 使用方式：
- *   import { DimensionCopy } from '../shared/DimensionCopyRegistry.js';
+ *   import { DimensionCopy } from '../service/bootstrap/DimensionCopyRegistry.js';
  *   const copy = DimensionCopy.get('code-pattern', 'python');
  *   // → { label: '设计模式与代码惯例', guide: '装饰器/描述器/上下文管理器/生成器/ABC 抽象基类/Mixin 模式' }
  */
@@ -16,8 +16,7 @@
 // ═══════════════════════════════════════════════════════════
 /**
  * 将具体语言归入语言族（用于文案选择 fallback）
- * @param {string} lang
- * @returns {string} 语言族 ID
+ * @returns 语言族 ID
  */
 function _langFamily(lang) {
     switch (lang) {
@@ -297,9 +296,9 @@ const COPY_REGISTRY = {
 export class DimensionCopy {
     /**
      * 获取指定维度在指定语言下的文案
-     * @param {string} dimId   维度 ID (如 'code-standard')
-     * @param {string} lang    主语言 ID (如 'python', 'typescript')
-     * @returns {{ label: string, guide: string } | null}
+     * @param dimId 维度 ID (如 'code-standard')
+     * @param lang 主语言 ID (如 'python', 'typescript')
+     * @returns | null}
      */
     static get(dimId, lang) {
         const entry = COPY_REGISTRY[dimId];
@@ -313,8 +312,8 @@ export class DimensionCopy {
      * 批量为维度数组注入语言差异化文案（单语言版本）
      * 会直接修改维度对象的 label 和 guide 字段
      * @param {Array<{ id: string, label: string, guide: string }>} dimensions
-     * @param {string} lang 主语言
-     * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
+     * @param lang 主语言
+     * @returns >} 原数组引用
      */
     static apply(dimensions, lang) {
         for (const dim of dimensions) {
@@ -335,9 +334,9 @@ export class DimensionCopy {
      *   - 如果主语言和次要语言属于同一语言族，跳过（避免重复）
      *
      * @param {Array<{ id: string, label: string, guide: string }>} dimensions
-     * @param {string} primary 主语言 ID
-     * @param {string[]} secondary 次要语言 ID 列表
-     * @returns {Array<{ id: string, label: string, guide: string }>} 原数组引用
+     * @param primary 主语言 ID
+     * @param secondary 次要语言 ID 列表
+     * @returns >} 原数组引用
      */
     static applyMulti(dimensions, primary, secondary = []) {
         if (!secondary || secondary.length === 0) {
@@ -378,18 +377,11 @@ export class DimensionCopy {
         }
         return dimensions;
     }
-    /**
-     * 获取所有已有文案的维度 ID 列表
-     * @returns {string[]}
-     */
+    /** 获取所有已有文案的维度 ID 列表 */
     static registeredDimIds() {
         return Object.keys(COPY_REGISTRY);
     }
-    /**
-     * 获取某维度所有可用语言族
-     * @param {string} dimId
-     * @returns {string[]}
-     */
+    /** 获取某维度所有可用语言族 */
     static availableFamilies(dimId) {
         const entry = COPY_REGISTRY[dimId];
         if (!entry) {
@@ -399,4 +391,3 @@ export class DimensionCopy {
     }
 }
 export default DimensionCopy;
-//# sourceMappingURL=DimensionCopyRegistry.js.map

package/dist/lib/service/candidate/CandidateAggregator.d.ts

@@ -17,9 +17,7 @@ interface AggregateOpts {
 /**
  * 对候选条目列表进行去重聚合
  *
- * @param {CandidateItem[]} items
- * @param {AggregateOpts} [opts]
- * @returns {{ items: CandidateItem[], duplicates: Array<{item: CandidateItem, duplicateOf: string}> }}
+ * @returns > }}
  */
 export declare function aggregateCandidates(items: CandidateItem[], opts?: AggregateOpts): {
     items: CandidateItem[];
@@ -29,4 +27,3 @@ export declare function aggregateCandidates(items: CandidateItem[], opts?: Aggre
     }[];
 };
 export {};
-//# sourceMappingURL=CandidateAggregator.d.ts.map

package/dist/lib/service/candidate/CandidateAggregator.js

@@ -12,9 +12,7 @@ const TITLE_SIMILARITY_THRESHOLD = 0.85;
 /**
  * 对候选条目列表进行去重聚合
  *
- * @param {CandidateItem[]} items
- * @param {AggregateOpts} [opts]
- * @returns {{ items: CandidateItem[], duplicates: Array<{item: CandidateItem, duplicateOf: string}> }}
+ * @returns > }}
  */
 export function aggregateCandidates(items, opts = {}) {
     if (!Array.isArray(items) || items.length === 0) {
@@ -41,4 +39,3 @@ export function aggregateCandidates(items, opts = {}) {
     }
     return { items: kept, duplicates };
 }
-//# sourceMappingURL=CandidateAggregator.js.map

package/dist/lib/service/candidate/SimilarityService.d.ts

@@ -15,10 +15,10 @@ interface SimilarityOpts {
 }
 /**
  * 在项目知识库中查找与候选相似的 Recipe
- * @param {string} projectRoot 项目根目录
- * @param {object} candidate - { title, summary, usageGuide, code }
- * @param {object} [opts] - { threshold: 0.7, topK: 5 }
- * @returns {Array<{file, title, similarity}>}
+ * @param projectRoot 项目根目录
+ * @param candidate { title, summary, usageGuide, code }
+ * @param [opts] { threshold: 0.7, topK: 5 }
+ * @returns >}
  */
 export declare function findSimilarRecipes(projectRoot: string, candidate: SimilarityCandidate, opts?: SimilarityOpts): {
     file: string;
@@ -29,4 +29,3 @@ declare const _default: {
     findSimilarRecipes: typeof findSimilarRecipes;
 };
 export default _default;
-//# sourceMappingURL=SimilarityService.d.ts.map

package/dist/lib/service/candidate/SimilarityService.js

@@ -2,9 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { getProjectRecipesPath } from '../../infrastructure/config/Paths.js';
 import { jaccardSimilarity, tokenizeForSimilarity } from '../../shared/similarity.js';
-/**
- * 计算候选与单个 Recipe 的综合相似度
- */
+/** 计算候选与单个 Recipe 的综合相似度 */
 function computeSimilarity(candidate, recipe) {
     const titleSim = jaccardSimilarity(tokenizeForSimilarity(candidate.title), tokenizeForSimilarity(recipe.title));
     const summarySim = jaccardSimilarity(tokenizeForSimilarity(candidate.summary || candidate.description || ''), tokenizeForSimilarity(recipe.summary || recipe.description || ''));
@@ -12,9 +10,7 @@ function computeSimilarity(candidate, recipe) {
     // 加权: title 30%, summary 30%, code 40%
     return titleSim * 0.3 + summarySim * 0.3 + codeSim * 0.4;
 }
-/**
- * 从磁盘读取所有 Recipe MD 文件并提取基本结构
- */
+/** 从磁盘读取所有 Recipe MD 文件并提取基本结构 */
 function loadRecipesFromDisk(recipesDir) {
     const recipes = [];
     if (!fs.existsSync(recipesDir)) {
@@ -54,10 +50,10 @@ function loadRecipesFromDisk(recipesDir) {
 }
 /**
  * 在项目知识库中查找与候选相似的 Recipe
- * @param {string} projectRoot 项目根目录
- * @param {object} candidate - { title, summary, usageGuide, code }
- * @param {object} [opts] - { threshold: 0.7, topK: 5 }
- * @returns {Array<{file, title, similarity}>}
+ * @param projectRoot 项目根目录
+ * @param candidate { title, summary, usageGuide, code }
+ * @param [opts] { threshold: 0.7, topK: 5 }
+ * @returns >}
  */
 export function findSimilarRecipes(projectRoot, candidate, opts = {}) {
     const threshold = opts.threshold ?? 0.7;
@@ -79,4 +75,3 @@ export function findSimilarRecipes(projectRoot, candidate, opts = {}) {
     return results.slice(0, topK);
 }
 export default { findSimilarRecipes };
-//# sourceMappingURL=SimilarityService.js.map

package/dist/lib/service/{cursor → delivery}/AgentInstructionsGenerator.d.ts

@@ -19,22 +19,16 @@ export declare class AgentInstructionsGenerator {
     };
     projectName: string;
     projectRoot: string;
-    /**
-     * @param {string} projectRoot
-     * @param {string} projectName
-     * @param {Object} [logger]
-     */
     constructor(projectRoot: string, projectName?: string, logger?: {
         info?: (...args: unknown[]) => void;
     });
     /**
      * 生成所有 Agent 指令文件
      *
-     * @param {Object} params
-     * @param {Array<Object>} params.rules - kind='rule' 的条目（已排序）
-     * @param {Array<Object>} params.patterns - kind='pattern' 的条目（已排序）
-     * @param {string[]} params.skills 可用 Skill 名称列表
-     * @returns {{ agents: Object, claude: Object, copilot: Object }}
+     * @param params.rules kind='rule' 的条目（已排序）
+     * @param params.patterns kind='pattern' 的条目（已排序）
+     * @param params.skills 可用 Skill 名称列表
+     * @returns }
      */
     generate({ rules, patterns, skills, }?: {
         rules?: KnowledgeEntryProps[];
@@ -77,9 +71,7 @@ export declare class AgentInstructionsGenerator {
         skillLines: string[];
         toolLines: string[];
     };
-    /**
-     * @private
-     */
+    /** @private */
     _writeAgentsMd(sections: {
         ruleLines: string[];
         patternRows: string[];
@@ -90,9 +82,7 @@ export declare class AgentInstructionsGenerator {
         tokensUsed: number;
         skipped: boolean;
     };
-    /**
-     * @private
-     */
+    /** @private */
     _writeClaudeMd(sections: {
         ruleLines: string[];
         patternRows: string[];
@@ -130,4 +120,3 @@ export declare class AgentInstructionsGenerator {
     _renderWorkflow(): string[];
 }
 export default AgentInstructionsGenerator;
-//# sourceMappingURL=AgentInstructionsGenerator.d.ts.map

package/dist/lib/service/{cursor → delivery}/AgentInstructionsGenerator.js

@@ -26,9 +26,7 @@ const AGENT_BUDGET = Object.freeze({
     MAX_SKILLS: 10,
     MAX_TOTAL_TOKENS: 3000,
 });
-/**
- * MCP 工具清单 — 精简版（跟随实际 MCP handler 注册名称）
- */
+/** MCP 工具清单 — 精简版（跟随实际 MCP handler 注册名称） */
 const MCP_TOOLS_SUMMARY = [
     {
         name: 'autosnippet_search',
@@ -63,11 +61,6 @@ export class AgentInstructionsGenerator {
     logger;
     projectName;
     projectRoot;
-    /**
-     * @param {string} projectRoot
-     * @param {string} projectName
-     * @param {Object} [logger]
-     */
     constructor(projectRoot, projectName = 'Project', logger = console) {
         this.projectRoot = projectRoot;
         this.projectName = projectName;
@@ -76,11 +69,10 @@ export class AgentInstructionsGenerator {
     /**
      * 生成所有 Agent 指令文件
      *
-     * @param {Object} params
-     * @param {Array<Object>} params.rules - kind='rule' 的条目（已排序）
-     * @param {Array<Object>} params.patterns - kind='pattern' 的条目（已排序）
-     * @param {string[]} params.skills 可用 Skill 名称列表
-     * @returns {{ agents: Object, claude: Object, copilot: Object }}
+     * @param params.rules kind='rule' 的条目（已排序）
+     * @param params.patterns kind='pattern' 的条目（已排序）
+     * @param params.skills 可用 Skill 名称列表
+     * @returns }
      */
     generate({ rules = [], patterns = [], skills = [], } = {}) {
         const startTime = Date.now();
@@ -165,9 +157,7 @@ export class AgentInstructionsGenerator {
         return { ruleLines, patternRows, skillLines, toolLines };
     }
     // ─── AGENTS.md ─────────────────────────────────────
-    /**
-     * @private
-     */
+    /** @private */
     _writeAgentsMd(sections) {
         const lines = [
             `# ${this.projectName} — Agent Instructions`,
@@ -218,9 +208,7 @@ export class AgentInstructionsGenerator {
         return { filePath, tokensUsed: estimateTokens(content), skipped: !result.written };
     }
     // ─── CLAUDE.md ─────────────────────────────────────
-    /**
-     * @private
-     */
+    /** @private */
     _writeClaudeMd(sections) {
         const lines = [
             `# ${this.projectName} — Claude Code Instructions`,
@@ -407,4 +395,3 @@ export class AgentInstructionsGenerator {
     }
 }
 export default AgentInstructionsGenerator;
-//# sourceMappingURL=AgentInstructionsGenerator.js.map

package/dist/lib/service/{cursor → delivery}/CursorDeliveryPipeline.d.ts

@@ -43,11 +43,10 @@ export declare class CursorDeliveryPipeline {
     skillsSyncer: SkillsSyncer;
     topicClassifier: TopicClassifier;
     /**
-     * @param {Object} options
-     * @param {Object} options.knowledgeService - KnowledgeService 实例
-     * @param {string} options.projectRoot 用户项目根目录
-     * @param {string} [options.projectName] 项目名称
-     * @param {Object} [options.logger] 日志器
+     * @param options.knowledgeService KnowledgeService 实例
+     * @param options.projectRoot 用户项目根目录
+     * @param [options.projectName] 项目名称
+     * @param [options.logger] 日志器
      */
     constructor({ knowledgeService, projectRoot, projectName, logger, database, }: {
         knowledgeService: {
@@ -67,7 +66,7 @@ export declare class CursorDeliveryPipeline {
     });
     /**
      * 完整交付流程 — 生成 6 通道消费物料
-     * @returns {Promise<{ channelA: Object, channelB: Object, channelC: Object, channelD: Object, channelF: Object, stats: Object }>}
+     * @returns >}
      */
     deliver(): Promise<{
         channelA: {
@@ -200,8 +199,8 @@ export declare class CursorDeliveryPipeline {
     };
     /**
      * Channel B 生成（patterns + facts）
-     * @param {Array} patterns - kind='pattern' 的知识条目
-     * @param {Array} [facts=[]] - kind='fact' 的知识条目
+     * @param patterns kind='pattern' 的知识条目
+     * @param [facts=[]] kind='fact' 的知识条目
      * @private
      */
     _generateChannelB(patterns: KnowledgeEntryProps[], facts?: KnowledgeEntryProps[]): {
@@ -219,7 +218,7 @@ export declare class CursorDeliveryPipeline {
      * Channel B+ — Call Graph Architecture Rules (Phase 5.2)
      * 从调用图拓扑分析架构分层，生成 architecture smart rule
      * @private
-     * @returns {{ insightsCount: number, tokensUsed: number, filePath: string }|null}
+     * @returns |null}
      */
     _generateCallGraphArchitectureRules(): {
         insightsCount: number;
@@ -286,7 +285,7 @@ export declare class CursorDeliveryPipeline {
     /**
      * 镜像 .cursor/ 交付物料到目标 IDE 目录（Qoder / Trae 等兼容 IDE）
      * 只复制 autosnippet- 前缀的文件/目录，不触碰用户自定义内容
-     * @param {string} targetDirName 目标目录名，如 '.qoder' 或 '.trae'
+     * @param targetDirName 目标目录名，如 '.qoder' 或 '.trae'
      * @private
      */
     _mirrorToIDE(targetDirName: string): void;
@@ -302,4 +301,3 @@ export declare class CursorDeliveryPipeline {
     _inferProjectName(projectRoot: string): string;
 }
 export default CursorDeliveryPipeline;
-//# sourceMappingURL=CursorDeliveryPipeline.d.ts.map

package/dist/lib/service/{cursor → delivery}/CursorDeliveryPipeline.js

@@ -38,11 +38,10 @@ export class CursorDeliveryPipeline {
     skillsSyncer;
     topicClassifier;
     /**
-     * @param {Object} options
-     * @param {Object} options.knowledgeService - KnowledgeService 实例
-     * @param {string} options.projectRoot 用户项目根目录
-     * @param {string} [options.projectName] 项目名称
-     * @param {Object} [options.logger] 日志器
+     * @param options.knowledgeService KnowledgeService 实例
+     * @param options.projectRoot 用户项目根目录
+     * @param [options.projectName] 项目名称
+     * @param [options.logger] 日志器
      */
     constructor({ knowledgeService, projectRoot, projectName, logger, database, }) {
         this.knowledgeService = knowledgeService;
@@ -59,7 +58,7 @@ export class CursorDeliveryPipeline {
     }
     /**
      * 完整交付流程 — 生成 6 通道消费物料
-     * @returns {Promise<{ channelA: Object, channelB: Object, channelC: Object, channelD: Object, channelF: Object, stats: Object }>}
+     * @returns >}
      */
     async deliver() {
         const startTime = Date.now();
@@ -249,8 +248,8 @@ export class CursorDeliveryPipeline {
     }
     /**
      * Channel B 生成（patterns + facts）
-     * @param {Array} patterns - kind='pattern' 的知识条目
-     * @param {Array} [facts=[]] - kind='fact' 的知识条目
+     * @param patterns kind='pattern' 的知识条目
+     * @param [facts=[]] kind='fact' 的知识条目
      * @private
      */
     _generateChannelB(patterns, facts = []) {
@@ -306,7 +305,7 @@ export class CursorDeliveryPipeline {
      * Channel B+ — Call Graph Architecture Rules (Phase 5.2)
      * 从调用图拓扑分析架构分层，生成 architecture smart rule
      * @private
-     * @returns {{ insightsCount: number, tokensUsed: number, filePath: string }|null}
+     * @returns |null}
      */
     _generateCallGraphArchitectureRules() {
         if (!this.database) {
@@ -607,7 +606,7 @@ export class CursorDeliveryPipeline {
     /**
      * 镜像 .cursor/ 交付物料到目标 IDE 目录（Qoder / Trae 等兼容 IDE）
      * 只复制 autosnippet- 前缀的文件/目录，不触碰用户自定义内容
-     * @param {string} targetDirName 目标目录名，如 '.qoder' 或 '.trae'
+     * @param targetDirName 目标目录名，如 '.qoder' 或 '.trae'
      * @private
      */
     _mirrorToIDE(targetDirName) {
@@ -675,4 +674,3 @@ export class CursorDeliveryPipeline {
     }
 }
 export default CursorDeliveryPipeline;
-//# sourceMappingURL=CursorDeliveryPipeline.js.map

package/dist/lib/service/{cursor → delivery}/FileProtection.d.ts

@@ -14,8 +14,8 @@
 /**
  * 检查文件是否可以被 AutoSnippet 安全写入
  *
- * @param {string} filePath 目标文件绝对路径
- * @returns {{ canWrite: boolean, reason: string }}
+ * @param filePath 目标文件绝对路径
+ * @returns }
  *   - canWrite: true  → 可以安全写入
  *   - canWrite: false → 文件存在且非 AutoSnippet 生成，不应覆盖
  */
@@ -26,12 +26,11 @@ export declare function checkWriteSafety(filePath: string): {
 /**
  * 安全写入文件 — 带保护机制
  *
- * @param {string} filePath 目标文件绝对路径
- * @param {string} content 文件内容
- * @param {Object} [options]
- * @param {boolean} [options.force=false] 强制覆盖（忽略保护）
- * @param {Object} [options.logger] 日志器
- * @returns {{ written: boolean, reason: string, filePath: string }}
+ * @param filePath 目标文件绝对路径
+ * @param content 文件内容
+ * @param [options.force=false] 强制覆盖（忽略保护）
+ * @param [options.logger] 日志器
+ * @returns }
  */
 export declare function safeWriteFile(filePath: string, content: string, options?: {
     force?: boolean;
@@ -46,12 +45,11 @@ export declare function safeWriteFile(filePath: string, content: string, options
 /**
  * 安全复制文件 — 带保护机制
  *
- * @param {string} srcPath 源文件路径
- * @param {string} destPath 目标文件路径
- * @param {Object} [options]
- * @param {boolean} [options.force=false] 强制覆盖
- * @param {Object} [options.logger] 日志器
- * @returns {{ written: boolean, reason: string, filePath: string }}
+ * @param srcPath 源文件路径
+ * @param destPath 目标文件路径
+ * @param [options.force=false] 强制覆盖
+ * @param [options.logger] 日志器
+ * @returns }
  */
 export declare function safeCopyFile(srcPath: string, destPath: string, options?: {
     force?: boolean;
@@ -63,4 +61,3 @@ export declare function safeCopyFile(srcPath: string, destPath: string, options?
     reason: string;
     filePath: string;
 };
-//# sourceMappingURL=FileProtection.d.ts.map