autosnippet 3.2.15 → 3.2.16

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

@@ -1,14 +1,15 @@
 /**
- * SkillHooks — Skill 生命周期钩子管理器
+ * SkillHooks — Skill 生命周期钩子管理器 (v2)
  *
  * 每个 Skill 目录可以包含一个 hooks.js 文件，导出生命周期回调。
- * SkillHooks 在启动时扫描并注册所有钩子，在特定事件发生时按序调用。
+ * SkillHooks 在启动时扫描并注册所有钩子，在特定事件发生时按模式调用。
  *
- * 支持的钩子:
- *   - onCandidateSubmit(candidate, ctx) → { block?: boolean, reason?: string }
- *   - onRecipeCreated(recipe, ctx) → void
- *   - onGuardCheck(violation, ctx) → violation (可修改)
- *   - onBootstrapComplete(stats, ctx) → void
+ * v2 升级:
+ *   - 扩展到 16+ 钩子，覆盖知识/Guard/Skill/搜索/推荐/Bootstrap/信号全生命周期
+ *   - 4 种执行模式: series / parallel / waterfall / bail
+ *   - Handler 支持 priority、timeout、name 元数据
+ *   - 完全向后兼容旧版 hooks.js (直接导出函数)
+ *   - 新格式支持: export default { hooks: { onXxx: { handler, priority, timeout } } }
  *
  * 加载顺序: 内置 skills/ → 项目级 AutoSnippet/skills/（同名覆盖）
  */
@@ -18,6 +19,45 @@ import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { getProjectSkillsPath } from '../../infrastructure/config/Paths.js';
 import Logger from '../../infrastructure/logging/Logger.js';
 import { SKILLS_DIR } from '../../shared/package-root.js';
+// ═══════════════════════════════════════════════════════
+//  Hook Registry — 声明所有支持的钩子及其执行模式
+// ═══════════════════════════════════════════════════════
+const HOOK_REGISTRY = [
+    // ── 知识生命周期 ──
+    { name: 'onKnowledgeSubmit', mode: 'bail', description: '知识提交前拦截' },
+    { name: 'onKnowledgeCreated', mode: 'parallel', description: '知识创建后通知' },
+    { name: 'onKnowledgeUpdated', mode: 'parallel', description: '知识更新后通知' },
+    { name: 'onKnowledgeExpired', mode: 'parallel', description: '知识过期/废弃后通知' },
+    // ── Guard ──
+    { name: 'onGuardCheck', mode: 'waterfall', description: 'Guard 检查，可修改违规结果' },
+    { name: 'onGuardViolation', mode: 'parallel', description: 'Guard 违规后通知' },
+    // ── Skill 生命周期 ──
+    { name: 'onSkillLoad', mode: 'series', description: 'Skill 被加载时' },
+    { name: 'onSkillCreated', mode: 'parallel', description: 'Skill 创建后' },
+    { name: 'onSkillExpired', mode: 'parallel', description: 'Skill 过期/删除后' },
+    // ── 搜索 ──
+    { name: 'onSearch', mode: 'waterfall', description: '搜索结果后处理（可修改排序）' },
+    { name: 'onSearchMiss', mode: 'parallel', description: '搜索无结果时' },
+    // ── 推荐 ──
+    { name: 'onRecommendation', mode: 'waterfall', description: '推荐结果后处理（可过滤/排序）' },
+    { name: 'onRecommendFeedback', mode: 'parallel', description: '推荐反馈事件' },
+    // ── Bootstrap ──
+    { name: 'onBootstrapStart', mode: 'series', description: '冷启动开始前' },
+    { name: 'onBootstrapComplete', mode: 'parallel', description: '冷启动完成后' },
+    // ── 信号 ──
+    { name: 'onSignalCollected', mode: 'parallel', description: '新信号收集完成' },
+    // ── 向后兼容 (旧名映射) ──
+    { name: 'onCandidateSubmit', mode: 'bail', description: '(compat) 同 onKnowledgeSubmit' },
+    { name: 'onRecipeCreated', mode: 'parallel', description: '(compat) Recipe 创建后通知' },
+];
+/** hookName → HookDefinition 快速查表 */
+const HOOK_DEF_MAP = new Map(HOOK_REGISTRY.map((d) => [d.name, d]));
+/** 所有合法 hook 名称集合 */
+const HOOK_NAMES = new Set(HOOK_REGISTRY.map((d) => d.name));
+/** 默认 handler 超时 (ms) */
+const DEFAULT_HANDLER_TIMEOUT = 10_000;
+/** 默认 handler 优先级 */
+const DEFAULT_HANDLER_PRIORITY = 100;
 /**
  * 获取项目级 Skills 目录（运行时动态解析）
  * 路径: {projectRoot}/AutoSnippet/skills/
@@ -26,33 +66,54 @@ function _getProjectSkillsDir(container) {
     const projectRoot = resolveProjectRoot(container);
     return getProjectSkillsPath(projectRoot);
 }
-const HOOK_NAMES = ['onCandidateSubmit', 'onRecipeCreated', 'onGuardCheck', 'onBootstrapComplete'];
+/**
+ * 带超时的 Promise 包装
+ */
+function withTimeout(promise, ms, label) {
+    if (ms <= 0) {
+        return promise;
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Hook handler "${label}" timed out after ${ms}ms`));
+        }, ms);
+        promise.then((v) => {
+            clearTimeout(timer);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(timer);
+            reject(e);
+        });
+    });
+}
+// ═══════════════════════════════════════════════════════
+//  SkillHooks 主类
+// ═══════════════════════════════════════════════════════
 export class SkillHooks {
     hooks;
     logger;
     constructor() {
         this.logger = Logger.getInstance();
-        /** @type {Map<string, Function[]>} hookName → [handler, ...] */
-        this.hooks = new Map(HOOK_NAMES.map((n) => [n, []]));
+        this.hooks = new Map([...HOOK_NAMES].map((n) => [n, []]));
     }
+    // ─── 公共 API ──────────────────────────────────────────
     /**
      * 扫描 skills 目录，加载所有 hooks.js
      * 项目级 hooks 覆盖同名内置 hooks
      */
     async load(container) {
-        const loaded = new Map(); // skillName → hooks module
+        const loaded = new Map();
         // 1. 内置 skills
         await this.#loadFromDir(SKILLS_DIR, loaded);
         // 2. 项目级 skills（覆盖同名）
         await this.#loadFromDir(_getProjectSkillsDir(container), loaded);
         // 3. 注册所有钩子
         for (const [skillName, mod] of loaded) {
-            for (const hookName of HOOK_NAMES) {
-                if (typeof mod[hookName] === 'function') {
-                    this.hooks.get(hookName).push(mod[hookName]);
-                    this.logger.debug(`SkillHook registered: ${skillName}.${hookName}`);
-                }
-            }
+            this.#registerModule(skillName, mod);
+        }
+        // 4. 按优先级排序所有 hook 列表
+        for (const handlers of this.hooks.values()) {
+            handlers.sort((a, b) => a.priority - b.priority);
         }
         const totalHooks = [...this.hooks.values()].reduce((s, a) => s + a.length, 0);
         if (totalHooks > 0) {
@@ -60,22 +121,91 @@ export class SkillHooks {
         }
     }
     /**
-     * 触发钩子 — 按注册顺序调用
+     * 手动注册 handler (用于代码级注册，非 hooks.js)
+     */
+    tap(hookName, handler, options) {
+        if (!HOOK_NAMES.has(hookName)) {
+            this.logger.warn(`SkillHooks.tap: unknown hook "${hookName}", registering dynamically`);
+            this.hooks.set(hookName, []);
+        }
+        const registered = {
+            fn: handler,
+            name: options?.name ?? 'anonymous',
+            priority: options?.priority ?? DEFAULT_HANDLER_PRIORITY,
+            timeout: options?.timeout ?? DEFAULT_HANDLER_TIMEOUT,
+        };
+        const handlers = this.hooks.get(hookName);
+        handlers.push(registered);
+        // 保持优先级排序
+        handlers.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * 触发钩子 — 根据 hook 定义的模式自动选择执行策略
      *
-     * @param {string} hookName
-     * @param  {...any} args
-     * @returns {Promise<any>} 最后一个返回值（用于 blocking hooks 如 onCandidateSubmit）
+     * 向后兼容: 旧版 run() 签名不变，行为维持一致。
+     * - bail 模式: 首个返回 { block: true } 的 handler 立即终止
+     * - waterfall 模式: 前一个 handler 的返回值传给下一个
+     * - parallel 模式: 所有 handler 并行执行 (fire-and-forget)
+     * - series 模式: 按优先级顺序串行执行，忽略返回值
      */
     async run(hookName, ...args) {
         const handlers = this.hooks.get(hookName);
         if (!handlers || handlers.length === 0) {
             return undefined;
         }
+        const def = HOOK_DEF_MAP.get(hookName);
+        const mode = def?.mode ?? 'bail'; // 未知 hook 默认 bail (兼容旧行为)
+        switch (mode) {
+            case 'bail':
+                return this.#runBail(hookName, handlers, args);
+            case 'waterfall':
+                return this.#runWaterfall(hookName, handlers, args);
+            case 'parallel':
+                return this.#runParallel(hookName, handlers, args);
+            case 'series':
+                return this.#runSeries(hookName, handlers, args);
+            default:
+                return this.#runBail(hookName, handlers, args);
+        }
+    }
+    /**
+     * 检查是否有任何钩子注册
+     */
+    has(hookName) {
+        const handlers = this.hooks.get(hookName);
+        return handlers !== undefined && handlers.length > 0;
+    }
+    /**
+     * 获取指定 hook 的 handler 数量
+     */
+    count(hookName) {
+        return this.hooks.get(hookName)?.length ?? 0;
+    }
+    /**
+     * 获取已注册的所有 hook 名称
+     */
+    getRegisteredHooks() {
+        return [...this.hooks.entries()]
+            .filter(([, handlers]) => handlers.length > 0)
+            .map(([name]) => name);
+    }
+    /**
+     * 获取 Hook Registry 信息 (用于 Dashboard / 调试)
+     */
+    static getHookRegistry() {
+        return HOOK_REGISTRY;
+    }
+    // ─── 执行模式实现 ─────────────────────────────────────
+    /**
+     * Bail 模式: 串行执行，首个返回 truthy/{block:true} 的 handler 终止链
+     */
+    async #runBail(hookName, handlers, args) {
         let result;
-        for (const handler of handlers) {
+        for (const h of handlers) {
             try {
-                result = await handler(...args);
-                // 如果是 blocking hook 且返回 block=true，立即中断
+                const promise = Promise.resolve(h.fn(...args));
+                result = await withTimeout(promise, h.timeout, h.name);
+                // block 短路
                 if (result &&
                     typeof result === 'object' &&
                     'block' in result &&
@@ -84,7 +214,7 @@ export class SkillHooks {
                 }
             }
             catch (err) {
-                this.logger.warn(`SkillHook error in ${hookName}`, {
+                this.logger.warn(`SkillHook error in ${hookName} (handler: ${h.name})`, {
                     error: err instanceof Error ? err.message : String(err),
                 });
             }
@@ -92,13 +222,114 @@ export class SkillHooks {
         return result;
     }
     /**
-     * 检查是否有任何钩子注册
+     * Waterfall 模式: 串行传值，前一个返回值替换 args[0]
      */
-    has(hookName) {
-        const handlers = this.hooks.get(hookName);
-        return handlers && handlers.length > 0;
+    async #runWaterfall(hookName, handlers, args) {
+        let current = args[0];
+        const rest = args.slice(1);
+        for (const h of handlers) {
+            try {
+                const promise = Promise.resolve(h.fn(current, ...rest));
+                const result = await withTimeout(promise, h.timeout, h.name);
+                // 只有返回了有效值才替换
+                if (result !== undefined && result !== null) {
+                    current = result;
+                }
+            }
+            catch (err) {
+                this.logger.warn(`SkillHook waterfall error in ${hookName} (handler: ${h.name})`, {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                // waterfall 模式下出错继续传递当前值
+            }
+        }
+        return current;
+    }
+    /**
+     * 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));
+            return withTimeout(promise, h.timeout, h.name);
+        }));
+        // 记录失败但不阻塞
+        for (let i = 0; i < results.length; i++) {
+            const r = results[i];
+            if (r.status === 'rejected') {
+                this.logger.warn(`SkillHook parallel error in ${hookName} (handler: ${handlers[i].name})`, {
+                    error: r.reason instanceof Error ? r.reason.message : String(r.reason),
+                });
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Series 模式: 按优先级顺序串行执行，忽略返回值
+     */
+    async #runSeries(hookName, handlers, args) {
+        for (const h of handlers) {
+            try {
+                const promise = Promise.resolve(h.fn(...args));
+                await withTimeout(promise, h.timeout, h.name);
+            }
+            catch (err) {
+                this.logger.warn(`SkillHook series error in ${hookName} (handler: ${h.name})`, {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return undefined;
+    }
+    // ─── 模块注册 ─────────────────────────────────────────
+    /**
+     * 注册一个 skill 模块的钩子 — 支持新旧两种格式
+     *
+     * 旧格式 (v1):
+     *   export function onGuardCheck(violation, ctx) { ... }
+     *
+     * 新格式 (v2):
+     *   export default { hooks: { onGuardCheck: { handler, priority, timeout } } }
+     */
+    #registerModule(skillName, mod) {
+        // 尝试新格式: mod.hooks 是一个对象
+        const hooksObj = mod.hooks;
+        if (hooksObj && typeof hooksObj === 'object') {
+            for (const [hookName, config] of Object.entries(hooksObj)) {
+                if (!this.hooks.has(hookName)) {
+                    this.logger.warn(`SkillHooks: ${skillName} exports unknown hook "${hookName}", skipping`);
+                    continue;
+                }
+                if (typeof config === 'function') {
+                    // 新格式但直接是函数: { hooks: { onXxx: fn } }
+                    this.#addHandler(hookName, config, skillName);
+                }
+                else if (config && typeof config === 'object' && 'handler' in config) {
+                    // 新格式含元数据: { hooks: { onXxx: { handler, priority, timeout } } }
+                    const cfg = config;
+                    this.#addHandler(hookName, cfg.handler, skillName, cfg.priority, cfg.timeout);
+                }
+            }
+            return;
+        }
+        // 旧格式: module 顶层直接导出函数
+        for (const hookName of HOOK_NAMES) {
+            if (typeof mod[hookName] === 'function') {
+                this.#addHandler(hookName, mod[hookName], skillName);
+            }
+        }
+    }
+    #addHandler(hookName, fn, skillName, priority, timeout) {
+        const handler = {
+            fn,
+            name: `${skillName}.${hookName}`,
+            priority: priority ?? DEFAULT_HANDLER_PRIORITY,
+            timeout: timeout ?? DEFAULT_HANDLER_TIMEOUT,
+        };
+        this.hooks.get(hookName).push(handler);
+        this.logger.debug(`SkillHook registered: ${handler.name} (priority=${handler.priority})`);
     }
-    // ─── Internal ──────────────────────────────────────────
+    // ─── 目录扫描 ─────────────────────────────────────────
     async #loadFromDir(dir, loaded) {
         let dirs;
         try {

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

@@ -1 +1 @@
-{"version":3,"file":"SkillHooks.js","sourceRoot":"","sources":["../../../../lib/service/skills/SkillHooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,MAAM,MAAM,wCAAwC,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D;;;GAGG;AACH,SAAS,oBAAoB,CAAC,SAAuD;IACnF,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC;AAInG,MAAM,OAAO,UAAU;IACrB,KAAK,CAA6B;IAClC,MAAM,CAAwC;IAC9C;QACE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,gEAAgE;QAChE,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAwB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,SAAuD;QAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,2BAA2B;QAErD,eAAe;QACf,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAE5C,sBAAsB;QACtB,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAEjE,YAAY;QACZ,KAAK,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;YACtC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAClC,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;oBACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC9E,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,UAAU,eAAe,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,GAAG,IAAe;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,MAAe,CAAC;QACpB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;gBAChC,wCAAwC;gBACxC,IACE,MAAM;oBACN,OAAO,MAAM,KAAK,QAAQ;oBAC1B,OAAO,IAAI,MAAM;oBAChB,MAAkC,CAAC,KAAK,EACzC,CAAC;oBACD,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,QAAQ,EAAE,EAAE;oBACjD,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,QAAgB;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,0DAA0D;IAE1D,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,MAAgD;QAC9E,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,EAAE;iBACN,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBACzC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;iBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,QAAQ;QAClB,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;gBACpC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,IAAI,WAAW,EAAE;oBAC9D,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"SkillHooks.js","sourceRoot":"","sources":["../../../../lib/service/skills/SkillHooks.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,210 @@
+/**
+ * Skill 推荐系统 — 统一类型定义
+ *
+ * 覆盖: SignalProvider / RecommendationPipeline / FeedbackStore / SkillHooks
+ */
+/**
+ * Hook 执行模式 — 受 Webpack Tapable 启发，简化为 4 种核心语义
+ */
+export type HookMode = 
+/** 串行执行，所有 handler 按优先级顺序执行，忽略返回值 */
+'series'
+/** 并行执行，所有 handler Promise.allSettled (fire-and-forget) */
+ | 'parallel'
+/** 串行传值，前一个 handler 的返回值作为下一个的第一个参数 */
+ | 'waterfall'
+/** 串行短路，首个返回 truthy 值（含 {block:true}）的 handler 终止链 */
+ | 'bail';
+/**
+ * Hook 定义
+ */
+export interface HookDefinition {
+    name: string;
+    mode: HookMode;
+    description: string;
+}
+/**
+ * Handler 注册选项
+ */
+export interface HookHandlerOptions {
+    /** handler 名称 (用于日志和调试) */
+    name: string;
+    /** 执行优先级 (越小越先，默认 100) */
+    priority?: number;
+    /** 超时 (ms)，超时自动跳过，默认 10000 */
+    timeout?: number;
+}
+/**
+ * 已注册的 Handler 内部表示
+ */
+export interface RegisteredHandler {
+    fn: (...args: unknown[]) => Promise<unknown> | unknown;
+    name: string;
+    priority: number;
+    timeout: number;
+}
+/**
+ * 标准化信号对象
+ */
+export interface Signal {
+    id: string;
+    provider: string;
+    type: string;
+    timestamp: Date;
+    data: Record<string, unknown>;
+    /** 信号强度 0-1 */
+    strength: number;
+    /** 可选的去重 key */
+    dedupeKey?: string;
+}
+/**
+ * 信号收集上下文
+ */
+export interface SignalContext {
+    projectRoot: string;
+    database?: unknown;
+    container?: unknown;
+}
+/**
+ * 统一信号提供者接口
+ */
+export interface SignalProvider {
+    /** 提供者唯一名称 */
+    readonly name: string;
+    /** 信号类别 */
+    readonly category: 'behavior' | 'quality' | 'context' | 'external';
+    /** 优先级 (越小越先执行) */
+    readonly priority: number;
+    /**
+     * 收集信号 — 增量模式
+     * @param since 上次收集的时间戳 (null = 首次)
+     * @param context 全局上下文
+     * @returns 标准化信号对象数组
+     */
+    collect(since: Date | null, context: SignalContext): Promise<Signal[]>;
+    /** 信号提供者是否可用 */
+    isAvailable(context: SignalContext): boolean;
+}
+/**
+ * 推荐候选
+ */
+export interface RecommendationCandidate {
+    /** 推荐的 Skill 名称 */
+    name: string;
+    /** 一句话描述 */
+    description: string;
+    /** 推荐理由 */
+    rationale: string;
+    /** 推荐来源策略 */
+    source: string;
+    /** 优先级 */
+    priority: 'high' | 'medium' | 'low';
+    /** 原始信号数据 */
+    signals: Record<string, unknown>;
+    /** 推荐内容草稿 (可选) */
+    body?: string;
+}
+/**
+ * 带分数的推荐结果
+ */
+export interface ScoredRecommendation extends RecommendationCandidate {
+    /** 综合得分 0-1 */
+    score: number;
+    /** 各信号分项得分 */
+    signalScores?: Record<string, number>;
+    /** 唯一推荐 ID (用于反馈追踪) */
+    recommendationId: string;
+    /** 推荐生成时间 */
+    generatedAt: string;
+}
+/**
+ * 推荐管线上下文
+ */
+export interface RecommendationContext {
+    projectRoot: string;
+    database?: unknown;
+    container?: unknown;
+    agentFactory?: unknown;
+    /** 已有的项目级 Skill 名称集合 (用于去重) */
+    existingSkills?: Set<string>;
+    /** 用户偏好 (来自 FeedbackStore) */
+    userPreference?: UserPreference;
+    /** AI Provider 是否可用 */
+    aiAvailable?: boolean;
+}
+/**
+ * 召回策略接口
+ */
+export interface RecallStrategy {
+    readonly name: string;
+    /** 召回方法类型 */
+    readonly type: 'rule' | 'ai' | 'vector' | 'popularity';
+    /**
+     * 召回候选列表
+     */
+    recall(context: RecommendationContext): Promise<RecommendationCandidate[]>;
+    /** 策略是否可用 (例如 AI 策略需要 aiProvider) */
+    isAvailable(context: RecommendationContext): boolean;
+}
+/**
+ * 推荐反馈动作
+ */
+export type FeedbackAction = 
+/** 用户采纳推荐并创建了 Skill */
+'adopted'
+/** 用户主动关闭/忽略推荐 */
+ | 'dismissed'
+/** 推荐过期未处理 */
+ | 'expired'
+/** 用户查看了推荐详情 */
+ | 'viewed'
+/** 用户采纳但修改了内容 */
+ | 'modified';
+/**
+ * 推荐反馈记录
+ */
+export interface RecommendationFeedback {
+    recommendationId: string;
+    action: FeedbackAction;
+    timestamp: string;
+    /** 推荐来源策略 */
+    source?: string;
+    /** 推荐类别 */
+    category?: string;
+    /** 用户反馈原因 */
+    reason?: string;
+}
+/**
+ * 用户偏好 (从反馈历史中推导)
+ */
+export interface UserPreference {
+    preferredCategories: string[];
+    avoidedCategories: string[];
+    preferredSources: string[];
+    /** 总体采纳率 */
+    adoptionRate: number;
+}
+/**
+ * 推荐效果指标
+ */
+export interface RecommendationMetricsSnapshot {
+    /** 总推荐数 */
+    totalRecommendations: number;
+    /** 总展示数 */
+    totalViewed: number;
+    /** 总采纳数 */
+    totalAdopted: number;
+    /** 总忽略数 */
+    totalDismissed: number;
+    /** 总过期数 */
+    totalExpired: number;
+    /** 采纳率 */
+    adoptionRate: number;
+    /** 查看率 */
+    viewRate: number;
+    /** 按来源分组的采纳率 */
+    adoptionRateBySource: Record<string, number>;
+    /** 统计时间范围 */
+    since: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/service/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../lib/service/skills/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+/**
+ * Skill 推荐系统 — 统一类型定义
+ *
+ * 覆盖: SignalProvider / RecommendationPipeline / FeedbackStore / SkillHooks
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/service/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../lib/service/skills/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.2.15",
+  "version": "3.2.16",
   "description": "Extract code patterns into a knowledge base for AI coding assistants",
   "type": "module",
   "main": "dist/lib/bootstrap.js",
@@ -20,6 +20,10 @@
       "asd-dev": "./lib/service/*",
       "default": "./dist/lib/service/*"
     },
+    "#agent/*": {
+      "asd-dev": "./lib/agent/*",
+      "default": "./dist/lib/agent/*"
+    },
     "#domain/*": {
       "asd-dev": "./lib/domain/*",
       "default": "./dist/lib/domain/*"