autosnippet 3.2.16 → 3.2.18

package/dist/lib/service/skills/FeedbackStore.d.ts

@@ -14,35 +14,22 @@ import type { RecommendationFeedback, RecommendationMetricsSnapshot, UserPrefere
 export declare class FeedbackStore {
     #private;
     constructor(projectRoot: string);
-    /**
-     * 记录一条反馈
-     */
+    /** 记录一条反馈 */
     record(feedback: RecommendationFeedback): Promise<void>;
     /**
      * 获取采纳率
      * @param source 可选 — 按推荐来源过滤
      */
     getAdoptionRate(source?: string): number;
-    /**
-     * 获取用户偏好向量 (基于历史反馈推导)
-     */
+    /** 获取用户偏好向量 (基于历史反馈推导) */
     getUserPreference(): UserPreference;
-    /**
-     * 特定类别的推荐是否被用户频繁忽略
-     */
+    /** 特定类别的推荐是否被用户频繁忽略 */
     isFrequentlyDismissed(category: string): boolean;
-    /**
-     * 获取推荐效果指标快照
-     */
+    /** 获取推荐效果指标快照 */
     getMetricsSnapshot(since?: Date): RecommendationMetricsSnapshot;
-    /**
-     * 获取指定推荐 ID 的反馈历史
-     */
+    /** 获取指定推荐 ID 的反馈历史 */
     getFeedbackFor(recommendationId: string): RecommendationFeedback[];
-    /**
-     * 全部反馈条数
-     */
+    /** 全部反馈条数 */
     get size(): number;
 }
 export default FeedbackStore;
-//# sourceMappingURL=FeedbackStore.d.ts.map

package/dist/lib/service/skills/FeedbackStore.js

@@ -30,9 +30,7 @@ export class FeedbackStore {
         this.#logger = Logger.getInstance();
     }
     // ─── 公共 API ──────────────────────────────────────────
-    /**
-     * 记录一条反馈
-     */
+    /** 记录一条反馈 */
     async record(feedback) {
         this.#ensureLoaded();
         const entry = {
@@ -74,9 +72,7 @@ export class FeedbackStore {
         }
         return adopted / total;
     }
-    /**
-     * 获取用户偏好向量 (基于历史反馈推导)
-     */
+    /** 获取用户偏好向量 (基于历史反馈推导) */
     getUserPreference() {
         this.#ensureLoaded();
         const categoryStats = new Map();
@@ -136,9 +132,7 @@ export class FeedbackStore {
             adoptionRate: this.getAdoptionRate(),
         };
     }
-    /**
-     * 特定类别的推荐是否被用户频繁忽略
-     */
+    /** 特定类别的推荐是否被用户频繁忽略 */
     isFrequentlyDismissed(category) {
         this.#ensureLoaded();
         const entries = this.#entries.filter((e) => e.category === category);
@@ -150,9 +144,7 @@ export class FeedbackStore {
         }
         return dismissed / total >= DISMISS_THRESHOLD;
     }
-    /**
-     * 获取推荐效果指标快照
-     */
+    /** 获取推荐效果指标快照 */
     getMetricsSnapshot(since) {
         this.#ensureLoaded();
         const sinceTs = since?.toISOString() ?? '1970-01-01T00:00:00.000Z';
@@ -196,24 +188,18 @@ export class FeedbackStore {
             since: sinceTs,
         };
     }
-    /**
-     * 获取指定推荐 ID 的反馈历史
-     */
+    /** 获取指定推荐 ID 的反馈历史 */
     getFeedbackFor(recommendationId) {
         this.#ensureLoaded();
         return this.#entries.filter((e) => e.recommendationId === recommendationId);
     }
-    /**
-     * 全部反馈条数
-     */
+    /** 全部反馈条数 */
     get size() {
         this.#ensureLoaded();
         return this.#entries.length;
     }
     // ─── 内部方法 ──────────────────────────────────────────
-    /**
-     * 惰性加载: 首次访问时从 JSONL 文件读取历史
-     */
+    /** 惰性加载: 首次访问时从 JSONL 文件读取历史 */
     #ensureLoaded() {
         if (this.#loaded) {
             return;
@@ -252,4 +238,3 @@ export class FeedbackStore {
     }
 }
 export default FeedbackStore;
-//# sourceMappingURL=FeedbackStore.js.map

package/dist/lib/service/skills/RecommendationMetrics.d.ts

@@ -24,37 +24,22 @@ interface MetricsCounters {
 export declare class RecommendationMetrics {
     #private;
     constructor(feedbackStore: FeedbackStore);
-    /**
-     * 记录推荐已展示 (dashboard/MCP 返回推荐列表时调用)
-     */
+    /** 记录推荐已展示 (dashboard/MCP 返回推荐列表时调用) */
     trackDisplayed(recommendations: ScoredRecommendation[]): void;
-    /**
-     * 记录推荐被采纳
-     */
+    /** 记录推荐被采纳 */
     trackAdopted(recommendationId: string, source?: string, category?: string): Promise<void>;
-    /**
-     * 记录推荐被忽略
-     */
+    /** 记录推荐被忽略 */
     trackDismissed(recommendationId: string, reason?: string, source?: string, category?: string): Promise<void>;
-    /**
-     * 记录推荐过期
-     */
+    /** 记录推荐过期 */
     trackExpired(recommendationId: string, source?: string): Promise<void>;
-    /**
-     * 获取当前会话的指标
-     */
+    /** 获取当前会话的指标 */
     getSessionMetrics(): MetricsCounters & {
         adoptionRate: number;
         ctr: number;
     };
-    /**
-     * 获取全局指标快照 (含持久化历史)
-     */
+    /** 获取全局指标快照 (含持久化历史) */
     getGlobalSnapshot(since?: Date): RecommendationMetricsSnapshot;
-    /**
-     * 获取指定来源的采纳率
-     */
+    /** 获取指定来源的采纳率 */
     getAdoptionRateBySource(source: string): number;
 }
 export default RecommendationMetrics;
-//# sourceMappingURL=RecommendationMetrics.d.ts.map

package/dist/lib/service/skills/RecommendationMetrics.js

@@ -29,9 +29,7 @@ export class RecommendationMetrics {
         this.#logger = Logger.getInstance();
     }
     // ─── 事件记录 ──────────────────────────────────────────
-    /**
-     * 记录推荐已展示 (dashboard/MCP 返回推荐列表时调用)
-     */
+    /** 记录推荐已展示 (dashboard/MCP 返回推荐列表时调用) */
     trackDisplayed(recommendations) {
         this.#session.displayed += recommendations.length;
         // 记录 viewed 事件到 FeedbackStore (展示即视为曝光)
@@ -51,9 +49,7 @@ export class RecommendationMetrics {
             });
         }
     }
-    /**
-     * 记录推荐被采纳
-     */
+    /** 记录推荐被采纳 */
     async trackAdopted(recommendationId, source, category) {
         this.#session.adopted++;
         await this.#feedbackStore.record({
@@ -64,9 +60,7 @@ export class RecommendationMetrics {
             category,
         });
     }
-    /**
-     * 记录推荐被忽略
-     */
+    /** 记录推荐被忽略 */
     async trackDismissed(recommendationId, reason, source, category) {
         this.#session.dismissed++;
         await this.#feedbackStore.record({
@@ -78,9 +72,7 @@ export class RecommendationMetrics {
             reason,
         });
     }
-    /**
-     * 记录推荐过期
-     */
+    /** 记录推荐过期 */
     async trackExpired(recommendationId, source) {
         this.#session.expired++;
         await this.#feedbackStore.record({
@@ -91,9 +83,7 @@ export class RecommendationMetrics {
         });
     }
     // ─── 查询 ──────────────────────────────────────────────
-    /**
-     * 获取当前会话的指标
-     */
+    /** 获取当前会话的指标 */
     getSessionMetrics() {
         const s = this.#session;
         const decisionTotal = s.adopted + s.dismissed;
@@ -103,18 +93,13 @@ export class RecommendationMetrics {
             ctr: s.displayed > 0 ? s.viewed / s.displayed : 0,
         };
     }
-    /**
-     * 获取全局指标快照 (含持久化历史)
-     */
+    /** 获取全局指标快照 (含持久化历史) */
     getGlobalSnapshot(since) {
         return this.#feedbackStore.getMetricsSnapshot(since);
     }
-    /**
-     * 获取指定来源的采纳率
-     */
+    /** 获取指定来源的采纳率 */
     getAdoptionRateBySource(source) {
         return this.#feedbackStore.getAdoptionRate(source);
     }
 }
 export default RecommendationMetrics;
-//# sourceMappingURL=RecommendationMetrics.js.map

package/dist/lib/service/skills/RecommendationPipeline.d.ts

@@ -22,13 +22,9 @@ export declare class RecommendationPipeline {
         feedbackStore?: FeedbackStore | null;
         skillHooks?: SkillHooks | null;
     });
-    /**
-     * 注册召回策略
-     */
+    /** 注册召回策略 */
     addStrategy(strategy: RecallStrategy): void;
-    /**
-     * 获取已注册策略列表
-     */
+    /** 获取已注册策略列表 */
     getStrategies(): ReadonlyArray<RecallStrategy>;
     /**
      * 执行推荐管线
@@ -40,4 +36,3 @@ export declare class RecommendationPipeline {
     recommend(context: RecommendationContext, topK?: number): Promise<ScoredRecommendation[]>;
 }
 export default RecommendationPipeline;
-//# sourceMappingURL=RecommendationPipeline.d.ts.map

package/dist/lib/service/skills/RecommendationPipeline.js

@@ -18,9 +18,7 @@ import Logger from '../../infrastructure/logging/Logger.js';
 const RECALL_TIMEOUT_MS = 15_000;
 /** 默认返回推荐数量 */
 const DEFAULT_TOP_K = 5;
-/**
- * 生成唯一推荐 ID (不依赖外部库)
- */
+/** 生成唯一推荐 ID (不依赖外部库) */
 function generateRecommendationId() {
     // crypto.randomUUID() — Node.js >=19 可用
     if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
@@ -40,16 +38,12 @@ export class RecommendationPipeline {
         this.#logger = Logger.getInstance();
     }
     // ─── 策略管理 ──────────────────────────────────────────
-    /**
-     * 注册召回策略
-     */
+    /** 注册召回策略 */
     addStrategy(strategy) {
         this.#strategies.push(strategy);
         this.#logger.debug(`RecommendationPipeline: strategy "${strategy.name}" registered`);
     }
-    /**
-     * 获取已注册策略列表
-     */
+    /** 获取已注册策略列表 */
     getStrategies() {
         return this.#strategies;
     }
@@ -232,4 +226,3 @@ export class RecommendationPipeline {
     }
 }
 export default RecommendationPipeline;
-//# sourceMappingURL=RecommendationPipeline.js.map

package/dist/lib/service/skills/RuleRecallStrategy.d.ts

@@ -13,4 +13,3 @@ export declare class RuleRecallStrategy implements RecallStrategy {
     isAvailable(_context: RecommendationContext): boolean;
 }
 export default RuleRecallStrategy;
-//# sourceMappingURL=RuleRecallStrategy.d.ts.map

package/dist/lib/service/skills/RuleRecallStrategy.js

@@ -34,4 +34,3 @@ export class RuleRecallStrategy {
     }
 }
 export default RuleRecallStrategy;
-//# sourceMappingURL=RuleRecallStrategy.js.map

package/dist/lib/service/skills/SignalCollector.d.ts

@@ -76,14 +76,13 @@ interface ContainerLike {
 export declare class SignalCollector {
     #private;
     /**
-     * @param {object} opts
-     * @param {string} opts.projectRoot  用户项目根目录
-     * @param {object} [opts.database]   - better-sqlite3 实例
-     * @param {object} [opts.agentFactory] - AgentFactory 实例
-     * @param {object} [opts.container]  - ServiceContainer 实例
-     * @param {string} [opts.mode]       - 'off' | 'suggest' | 'auto'
-     * @param {number} [opts.intervalMs] 初始收集间隔（毫秒），后续由 AI 动态调整
-     * @param {function} [opts.onSuggestions] 新建议回调 (suggestions[]) => void
+     * @param opts.projectRoot 用户项目根目录
+     * @param [opts.database] better-sqlite3 实例
+     * @param [opts.agentFactory] AgentFactory 实例
+     * @param [opts.container] ServiceContainer 实例
+     * @param [opts.mode] 'off' | 'suggest' | 'auto'
+     * @param [opts.intervalMs] 初始收集间隔（毫秒），后续由 AI 动态调整
+     * @param [opts.onSuggestions] 新建议回调 (suggestions[]) => void
      */
     constructor({ projectRoot, database, agentFactory, container, mode, intervalMs, onSuggestions, }: SignalCollectorOpts);
     start(): void;
@@ -92,8 +91,8 @@ export declare class SignalCollector {
      * 外部事件推送入口（由 FileWatcher / Guard / CLI 等调用）
      *
      * 事件会经过 EventAggregator 聚合后触发提前分析。
-     * @param {string} key 事件类型（如 'file_change', 'guard_violation', 'candidate_submit'）
-     * @param {object} event 事件数据
+     * @param key 事件类型（如 'file_change', 'guard_violation', 'candidate_submit'）
+     * @param event 事件数据
      */
     pushEvent(key: string, event: Record<string, unknown>): void;
     collect(): Promise<{
@@ -122,4 +121,3 @@ export declare class SignalCollector {
     resetPushed(): void;
 }
 export default SignalCollector;
-//# sourceMappingURL=SignalCollector.d.ts.map

package/dist/lib/service/skills/SignalCollector.js

@@ -63,14 +63,13 @@ export class SignalCollector {
     /** @type {EventAggregator} 信号聚类引擎 */
     #aggregator;
     /**
-     * @param {object} opts
-     * @param {string} opts.projectRoot  用户项目根目录
-     * @param {object} [opts.database]   - better-sqlite3 实例
-     * @param {object} [opts.agentFactory] - AgentFactory 实例
-     * @param {object} [opts.container]  - ServiceContainer 实例
-     * @param {string} [opts.mode]       - 'off' | 'suggest' | 'auto'
-     * @param {number} [opts.intervalMs] 初始收集间隔（毫秒），后续由 AI 动态调整
-     * @param {function} [opts.onSuggestions] 新建议回调 (suggestions[]) => void
+     * @param opts.projectRoot 用户项目根目录
+     * @param [opts.database] better-sqlite3 实例
+     * @param [opts.agentFactory] AgentFactory 实例
+     * @param [opts.container] ServiceContainer 实例
+     * @param [opts.mode] 'off' | 'suggest' | 'auto'
+     * @param [opts.intervalMs] 初始收集间隔（毫秒），后续由 AI 动态调整
+     * @param [opts.onSuggestions] 新建议回调 (suggestions[]) => void
      */
     constructor({ projectRoot, database = null, agentFactory = null, container = null, mode = 'auto', intervalMs = DEFAULT_INTERVAL_MS, onSuggestions = null, }) {
         this.#projectRoot = projectRoot;
@@ -130,8 +129,8 @@ export class SignalCollector {
      * 外部事件推送入口（由 FileWatcher / Guard / CLI 等调用）
      *
      * 事件会经过 EventAggregator 聚合后触发提前分析。
-     * @param {string} key 事件类型（如 'file_change', 'guard_violation', 'candidate_submit'）
-     * @param {object} event 事件数据
+     * @param key 事件类型（如 'file_change', 'guard_violation', 'candidate_submit'）
+     * @param event 事件数据
      */
     pushEvent(key, event) {
         if (this.#mode === 'off') {
@@ -198,7 +197,7 @@ export class SignalCollector {
             // 3. 调用 Agent 系统进行 AI 分析
             this.#logger.debug('[SignalCollector] invoking Agent for analysis...');
             const agent = this.#agentFactory.createChat({ lang: 'en' });
-            const { AgentMessage } = await import('../agent/AgentMessage.js');
+            const { AgentMessage } = await import('#agent/AgentMessage.js');
             const message = AgentMessage.internal(prompt, { source: 'signal_collector' });
             const result = await agent.execute(message);
             const reply = result?.reply ?? result?.text ?? '';
@@ -538,8 +537,8 @@ ${JSON.stringify(signals.codeChanges, null, 2)}
      *   1. AiProvider.extractJSON (支持 markdown 清理、截断修复、trailing comma 等)
      *   2. 最后一行 JSON 回退 (兼容 prompt 要求的 "最后一行输出 JSON" 格式)
      *
-     * @param {string} reply - AgentRuntime.execute() 的回复文本
-     * @returns {{ suggestions: Array, nextIntervalMinutes: number|null, summary: string }}
+     * @param reply AgentRuntime.execute() 的回复文本
+     * @returns }
      */
     #parseStructuredReply(reply) {
         const defaultResult = { suggestions: [], nextIntervalMinutes: null, summary: '' };
@@ -642,4 +641,3 @@ ${JSON.stringify(signals.codeChanges, null, 2)}
     }
 }
 export default SignalCollector;
-//# sourceMappingURL=SignalCollector.js.map

package/dist/lib/service/skills/SkillAdvisor.d.ts

@@ -33,9 +33,8 @@ interface SkillAdvisorOpts {
 export declare class SkillAdvisor {
     #private;
     /**
-     * @param {string} projectRoot 用户项目根目录
-     * @param {object} [opts]
-     * @param {object} [opts.database] - better-sqlite3 实例（可选）
+     * @param projectRoot 用户项目根目录
+     * @param [opts.database] better-sqlite3 实例（可选）
      */
     constructor(projectRoot: string, { database }?: SkillAdvisorOpts);
     /**
@@ -61,4 +60,3 @@ export declare class SkillAdvisor {
     };
 }
 export default SkillAdvisor;
-//# sourceMappingURL=SkillAdvisor.d.ts.map

package/dist/lib/service/skills/SkillAdvisor.js

@@ -21,9 +21,8 @@ export class SkillAdvisor {
     #projectRoot;
     #db;
     /**
-     * @param {string} projectRoot 用户项目根目录
-     * @param {object} [opts]
-     * @param {object} [opts.database] - better-sqlite3 实例（可选）
+     * @param projectRoot 用户项目根目录
+     * @param [opts.database] better-sqlite3 实例（可选）
      */
     constructor(projectRoot, { database } = {}) {
         this.#projectRoot = projectRoot;
@@ -305,9 +304,7 @@ export class SkillAdvisor {
     // ═══════════════════════════════════════════════════════
     //  辅助方法
     // ═══════════════════════════════════════════════════════
-    /**
-     * 列出已有的项目级 Skill 名称集合（避免重复推荐）
-     */
+    /** 列出已有的项目级 Skill 名称集合（避免重复推荐） */
     #listExistingProjectSkills() {
         const names = new Set();
         const dir = getProjectSkillsPath(this.#projectRoot);
@@ -324,9 +321,7 @@ export class SkillAdvisor {
         return names;
     }
 }
-/**
- * 字符串转 kebab-case（简化版）
- */
+/** 字符串转 kebab-case（简化版） */
 function _kebab(str) {
     return (str || 'unknown')
         .replace(/[^a-zA-Z0-9\s-]/g, '')
@@ -335,4 +330,3 @@ function _kebab(str) {
         .substring(0, 30);
 }
 export default SkillAdvisor;
-//# sourceMappingURL=SkillAdvisor.js.map

package/dist/lib/service/skills/SkillHooks.d.ts

@@ -29,9 +29,7 @@ export declare class SkillHooks {
             _projectRoot?: unknown;
         };
     }): Promise<void>;
-    /**
-     * 手动注册 handler (用于代码级注册，非 hooks.js)
-     */
+    /** 手动注册 handler (用于代码级注册，非 hooks.js) */
     tap(hookName: string, handler: (...args: unknown[]) => Promise<unknown> | unknown, options?: Partial<HookHandlerOptions>): void;
     /**
      * 触发钩子 — 根据 hook 定义的模式自动选择执行策略
@@ -43,22 +41,13 @@ export declare class SkillHooks {
      * - series 模式: 按优先级顺序串行执行，忽略返回值
      */
     run(hookName: string, ...args: unknown[]): Promise<unknown>;
-    /**
-     * 检查是否有任何钩子注册
-     */
+    /** 检查是否有任何钩子注册 */
     has(hookName: string): boolean;
-    /**
-     * 获取指定 hook 的 handler 数量
-     */
+    /** 获取指定 hook 的 handler 数量 */
     count(hookName: string): number;
-    /**
-     * 获取已注册的所有 hook 名称
-     */
+    /** 获取已注册的所有 hook 名称 */
     getRegisteredHooks(): string[];
-    /**
-     * 获取 Hook Registry 信息 (用于 Dashboard / 调试)
-     */
+    /** 获取 Hook Registry 信息 (用于 Dashboard / 调试) */
     static getHookRegistry(): ReadonlyArray<HookDefinition>;
 }
 export default SkillHooks;
-//# sourceMappingURL=SkillHooks.d.ts.map

package/dist/lib/service/skills/SkillHooks.js

@@ -66,9 +66,7 @@ function _getProjectSkillsDir(container) {
     const projectRoot = resolveProjectRoot(container);
     return getProjectSkillsPath(projectRoot);
 }
-/**
- * 带超时的 Promise 包装
- */
+/** 带超时的 Promise 包装 */
 function withTimeout(promise, ms, label) {
     if (ms <= 0) {
         return promise;
@@ -120,9 +118,7 @@ export class SkillHooks {
             this.logger.info(`SkillHooks: loaded ${totalHooks} hooks from ${loaded.size} skills`);
         }
     }
-    /**
-     * 手动注册 handler (用于代码级注册，非 hooks.js)
-     */
+    /** 手动注册 handler (用于代码级注册，非 hooks.js) */
     tap(hookName, handler, options) {
         if (!HOOK_NAMES.has(hookName)) {
             this.logger.warn(`SkillHooks.tap: unknown hook "${hookName}", registering dynamically`);
@@ -168,37 +164,27 @@ export class SkillHooks {
                 return this.#runBail(hookName, handlers, args);
         }
     }
-    /**
-     * 检查是否有任何钩子注册
-     */
+    /** 检查是否有任何钩子注册 */
     has(hookName) {
         const handlers = this.hooks.get(hookName);
         return handlers !== undefined && handlers.length > 0;
     }
-    /**
-     * 获取指定 hook 的 handler 数量
-     */
+    /** 获取指定 hook 的 handler 数量 */
     count(hookName) {
         return this.hooks.get(hookName)?.length ?? 0;
     }
-    /**
-     * 获取已注册的所有 hook 名称
-     */
+    /** 获取已注册的所有 hook 名称 */
     getRegisteredHooks() {
         return [...this.hooks.entries()]
             .filter(([, handlers]) => handlers.length > 0)
             .map(([name]) => name);
     }
-    /**
-     * 获取 Hook Registry 信息 (用于 Dashboard / 调试)
-     */
+    /** 获取 Hook Registry 信息 (用于 Dashboard / 调试) */
     static getHookRegistry() {
         return HOOK_REGISTRY;
     }
     // ─── 执行模式实现 ─────────────────────────────────────
-    /**
-     * Bail 模式: 串行执行，首个返回 truthy/{block:true} 的 handler 终止链
-     */
+    /** Bail 模式: 串行执行，首个返回 truthy/{block:true} 的 handler 终止链 */
     async #runBail(hookName, handlers, args) {
         let result;
         for (const h of handlers) {
@@ -221,9 +207,7 @@ export class SkillHooks {
         }
         return result;
     }
-    /**
-     * Waterfall 模式: 串行传值，前一个返回值替换 args[0]
-     */
+    /** Waterfall 模式: 串行传值，前一个返回值替换 args[0] */
     async #runWaterfall(hookName, handlers, args) {
         let current = args[0];
         const rest = args.slice(1);
@@ -245,9 +229,7 @@ export class SkillHooks {
         }
         return current;
     }
-    /**
-     * Parallel 模式: 所有 handler 并行执行 (fire-and-forget)
-     */
+    /** Parallel 模式: 所有 handler 并行执行 (fire-and-forget) */
     async #runParallel(hookName, handlers, args) {
         const results = await Promise.allSettled(handlers.map((h) => {
             const promise = Promise.resolve(h.fn(...args));
@@ -264,9 +246,7 @@ export class SkillHooks {
         }
         return undefined;
     }
-    /**
-     * Series 模式: 按优先级顺序串行执行，忽略返回值
-     */
+    /** Series 模式: 按优先级顺序串行执行，忽略返回值 */
     async #runSeries(hookName, handlers, args) {
         for (const h of handlers) {
             try {
@@ -359,4 +339,3 @@ export class SkillHooks {
     }
 }
 export default SkillHooks;
-//# sourceMappingURL=SkillHooks.js.map