autosnippet 3.2.15 → 3.2.17

package/dist/lib/external/mcp/handlers/skill.js

@@ -61,9 +61,7 @@ function _parseSkillMeta(skillName, baseDir = SKILLS_DIR) {
         return { description: skillName, createdBy: null, createdAt: null };
     }
 }
-/**
- * Skill 适用场景映射 — 帮助 Agent 判断何时该加载哪个 Skill
- */
+/** Skill 适用场景映射 — 帮助 Agent 判断何时该加载哪个 Skill */
 const SKILL_USE_CASES = {
     'autosnippet-intent': '不确定该用哪个能力时，先加载此 Skill 做意图路由',
     'autosnippet-coldstart': '冷启动/初始化知识库时的完整 9 维度分析指南',
@@ -82,7 +80,7 @@ const SKILL_USE_CASES = {
 /**
  * 列出所有可用 Skills 及其摘要描述
  *
- * @returns {string} JSON envelope
+ * @returns JSON envelope
  */
 export function listSkills(ctx) {
     try {
@@ -164,9 +162,9 @@ export function listSkills(ctx) {
 /**
  * 加载指定 Skill 的完整文档内容
  *
- * @param {object} _ctx  MCP context（未使用，保持签名一致）
- * @param {object} args  { skillName: string, section?: string }
- * @returns {string} JSON envelope
+ * @param _ctx MCP context（未使用，保持签名一致）
+ * @param args { skillName: string, section?: string }
+ * @returns JSON envelope
  */
 export function loadSkill(ctx, args) {
     const { skillName, section } = args || {};
@@ -194,6 +192,18 @@ export function loadSkill(ctx, args) {
         }
         // 提取 createdBy/createdAt
         const meta = _parseSkillMeta(skillName, source === 'project' ? projectSkillsDir : SKILLS_DIR);
+        // ── SkillHooks: onSkillLoad (fire-and-forget) ──
+        try {
+            const skillHooks = ctx?.container?.get?.('skillHooks');
+            if (skillHooks?.has?.('onSkillLoad')) {
+                skillHooks.run('onSkillLoad', { skillName, source }).catch(() => {
+                    /* fire-and-forget */
+                });
+            }
+        }
+        catch {
+            /* skillHooks not available */
+        }
         return JSON.stringify({
             success: true,
             data: {
@@ -324,6 +334,20 @@ export function createSkill(ctx, args) {
     catch {
         /* silent */
     }
+    // ── SkillHooks: onSkillCreated (fire-and-forget) ──
+    try {
+        const skillHooks = ctx?.container?.get?.('skillHooks');
+        if (skillHooks?.has?.('onSkillCreated')) {
+            skillHooks
+                .run('onSkillCreated', { name, description, createdBy, path: skillPath })
+                .catch(() => {
+                /* fire-and-forget */
+            });
+        }
+    }
+    catch {
+        /* skillHooks not available */
+    }
     return JSON.stringify({
         success: true,
         data: {
@@ -339,7 +363,7 @@ export function createSkill(ctx, args) {
  * Regenerate .cursor/rules/autosnippet-skills.mdc 索引文件
  * 扫描所有项目级 Skills，生成摘要索引供 External Agent 被动发现
  *
- * @returns {{ success: boolean, path?: string, skillCount?: number, error?: string }}
+ * @returns }
  */
 function _regenerateEditorIndex(ctx) {
     try {
@@ -405,9 +429,9 @@ function _regenerateEditorIndex(ctx) {
  * 删除项目级 Skill — 移除 {projectRoot}/AutoSnippet/skills/<name>/ 整个目录
  * 内置 Skill 不可删除。删除后自动 regenerate 编辑器索引。
  *
- * @param {object} _ctx  MCP context
- * @param {object} args  { name: string }
- * @returns {string} JSON envelope
+ * @param _ctx MCP context
+ * @param args { name: string }
+ * @returns JSON envelope
  */
 export function deleteSkill(ctx, args) {
     const { name } = args || {};
@@ -465,6 +489,18 @@ export function deleteSkill(ctx, args) {
     }
     // ── regenerate 编辑器索引 ──
     const indexResult = _regenerateEditorIndex(ctx ?? undefined);
+    // ── SkillHooks: onSkillExpired (fire-and-forget) ──
+    try {
+        const skillHooks = ctx?.container?.get?.('skillHooks');
+        if (skillHooks?.has?.('onSkillExpired')) {
+            skillHooks.run('onSkillExpired', { name, reason: 'deleted' }).catch(() => {
+                /* fire-and-forget */
+            });
+        }
+    }
+    catch {
+        /* skillHooks not available */
+    }
     return JSON.stringify({
         success: true,
         data: {
@@ -577,11 +613,45 @@ export function updateSkill(ctx, args) {
  * 分析维度：Guard 违规模式、Memory 偏好积累、Recipe 分布缺口、候选积压
  * Agent 可根据推荐结果自行决定是否调用 createSkill 创建
  *
- * @param {object} ctx  MCP context（含 container）
- * @returns {Promise<string>} JSON envelope
+ * @param ctx MCP context（含 container）
+ * @returns JSON envelope
  */
 export async function suggestSkills(ctx) {
     try {
+        // ── 优先使用 RecommendationPipeline (统一推荐管线) ──
+        const pipeline = ctx?.container?.get?.('recommendationPipeline');
+        if (pipeline && typeof pipeline.recommend === 'function') {
+            const database = ctx?.container?.get?.('database');
+            const projectRoot = resolveProjectRoot(ctx?.container);
+            const existingSkills = _listExistingProjectSkillNames(ctx);
+            const recommendations = await pipeline.recommend({
+                projectRoot,
+                database: database?.getDb?.() || database || null,
+                container: ctx?.container,
+                existingSkills,
+            });
+            // 记录展示指标
+            try {
+                const metrics = ctx?.container?.get?.('recommendationMetrics');
+                if (metrics && typeof metrics.trackDisplayed === 'function') {
+                    metrics.trackDisplayed(recommendations);
+                }
+            }
+            catch {
+                /* metrics tracking is best-effort */
+            }
+            return JSON.stringify({
+                success: true,
+                data: {
+                    suggestions: recommendations,
+                    existingProjectSkills: [...existingSkills],
+                    hint: recommendations.length > 0
+                        ? `发现 ${recommendations.length} 个 Skill 创建建议（powered by RecommendationPipeline）。`
+                        : '当前项目使用模式暂无明确的 Skill 创建建议。',
+                },
+            });
+        }
+        // ── Fallback: 直接使用 SkillAdvisor ──
         const { SkillAdvisor } = await import('#service/skills/SkillAdvisor.js');
         const dbConn = ctx?.container?.get?.('database') || null;
         const database = dbConn?.getDb?.() || dbConn || null;
@@ -600,9 +670,23 @@ export async function suggestSkills(ctx) {
         });
     }
 }
-/**
- * 推荐相关 Skills（基于静态映射）
- */
+/** 获取已有的项目级 Skill 名称集合 */
+function _listExistingProjectSkillNames(ctx) {
+    const names = new Set();
+    try {
+        const dir = _getProjectSkillsDir(ctx ?? undefined);
+        for (const d of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (d.isDirectory()) {
+                names.add(d.name);
+            }
+        }
+    }
+    catch {
+        /* no project skills */
+    }
+    return names;
+}
+/** 推荐相关 Skills（基于静态映射） */
 function _getRelatedSkills(skillName) {
     const relations = {
         'autosnippet-coldstart': [
@@ -630,4 +714,79 @@ function _getRelatedSkills(skillName) {
     };
     return relations[skillName] || [];
 }
-//# sourceMappingURL=skill.js.map
+// ═══════════════════════════════════════════════════════
+//  推荐反馈
+// ═══════════════════════════════════════════════════════
+/**
+ * 记录推荐反馈
+ *
+ * operation: 'feedback'
+ * @param args.recommendationId  推荐 ID
+ * @param args.action           'adopted' | 'dismissed' | 'expired' | 'viewed' | 'modified'
+ * @param args.reason           可选 — 忽略原因
+ * @param args.source           可选 — 推荐来源
+ * @param args.category         可选 — 推荐类别
+ */
+export async function recordFeedback(ctx, args) {
+    try {
+        const validActions = ['adopted', 'dismissed', 'expired', 'viewed', 'modified'];
+        if (!args.recommendationId || !args.action) {
+            return JSON.stringify({
+                success: false,
+                error: { code: 'MISSING_PARAMS', message: 'recommendationId and action are required' },
+            });
+        }
+        if (!validActions.includes(args.action)) {
+            return JSON.stringify({
+                success: false,
+                error: {
+                    code: 'INVALID_ACTION',
+                    message: `action must be one of: ${validActions.join(', ')}`,
+                },
+            });
+        }
+        // 获取 FeedbackStore
+        const feedbackStore = ctx?.container?.get?.('feedbackStore');
+        if (!feedbackStore || typeof feedbackStore.record !== 'function') {
+            return JSON.stringify({
+                success: false,
+                error: { code: 'STORE_UNAVAILABLE', message: 'FeedbackStore not initialized' },
+            });
+        }
+        await feedbackStore.record({
+            recommendationId: args.recommendationId,
+            action: args.action,
+            timestamp: new Date().toISOString(),
+            source: args.source,
+            category: args.category,
+            reason: args.reason,
+        });
+        // 触发 SkillHooks: onRecommendFeedback
+        try {
+            const skillHooks = ctx?.container?.get?.('skillHooks');
+            if (skillHooks?.has?.('onRecommendFeedback')) {
+                await skillHooks.run('onRecommendFeedback', {
+                    recommendationId: args.recommendationId,
+                    action: args.action,
+                    reason: args.reason,
+                });
+            }
+        }
+        catch {
+            /* hook error is non-blocking */
+        }
+        return JSON.stringify({
+            success: true,
+            data: { recorded: true, recommendationId: args.recommendationId, action: args.action },
+        });
+    }
+    catch (err) {
+        return JSON.stringify({
+            success: false,
+            error: {
+                code: 'FEEDBACK_ERROR',
+                message: err instanceof Error ? err.message : String(err),
+            },
+        });
+    }
+}

package/dist/lib/external/mcp/handlers/structure.d.ts

@@ -186,4 +186,3 @@ export declare function graphStats(ctx: McpContext): Promise<{
     };
 }>;
 export {};
-//# sourceMappingURL=structure.d.ts.map

package/dist/lib/external/mcp/handlers/structure.js

@@ -328,9 +328,7 @@ export async function graphImpact(ctx, args) {
         meta: { tool: 'autosnippet_graph' },
     });
 }
-/**
- * 降级：从 knowledge_entries.relations 提取关系（不依赖 knowledge_edges 表）
- */
+/** 降级：从 knowledge_entries.relations 提取关系（不依赖 knowledge_edges 表） */
 async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
     try {
         const knowledgeService = ctx.container.get('knowledgeService');
@@ -397,9 +395,7 @@ async function _fallbackRelationsFromRecipe(ctx, nodeId, relation, direction) {
         return { outgoing: [], incoming: [] };
     }
 }
-/**
- * 降级：从 knowledge_entries.relations 反查受影响的条目
- */
+/** 降级：从 knowledge_entries.relations 反查受影响的条目 */
 async function _fallbackImpactFromRecipe(ctx, nodeId) {
     try {
         const knowledgeRepo = ctx.container.get('knowledgeRepository');
@@ -468,9 +464,7 @@ export async function graphPath(ctx, args) {
     }
     return envelope({ success: true, data: result, meta: { tool: 'autosnippet_graph' } });
 }
-/**
- * 降级路径查找：只能发现 1-hop 直接关系
- */
+/** 降级路径查找：只能发现 1-hop 直接关系 */
 async function _fallbackPathFromRecipe(ctx, fromId, toId) {
     try {
         const knowledgeService = ctx.container.get('knowledgeService');
@@ -593,4 +587,3 @@ export async function graphStats(ctx) {
     }
     return envelope({ success: true, data: stats, meta: { tool: 'autosnippet_graph' } });
 }
-//# sourceMappingURL=structure.js.map

package/dist/lib/external/mcp/handlers/system.d.ts

@@ -92,4 +92,3 @@ export declare function capabilities(): {
         tool?: string | undefined;
     };
 };
-//# sourceMappingURL=system.d.ts.map

package/dist/lib/external/mcp/handlers/system.js

@@ -257,4 +257,3 @@ export function capabilities() {
         meta: { tool: 'autosnippet_capabilities' },
     });
 }
-//# sourceMappingURL=system.js.map

package/dist/lib/external/mcp/handlers/task.d.ts

@@ -42,8 +42,8 @@ interface EnvelopeResult {
 }
 /**
  * 统一入口
- * @param {object} ctx - { container }
- * @param {object} args - { operation, ...params }
+ * @param ctx { container }
+ * @param args { operation, ...params }
  */
 export declare function taskHandler(ctx: McpContext, args: TaskArgs): Promise<{
     success: boolean;
@@ -58,4 +58,3 @@ export declare function taskHandler(ctx: McpContext, args: TaskArgs): Promise<{
     };
 } | EnvelopeResult>;
 export {};
-//# sourceMappingURL=task.d.ts.map

package/dist/lib/external/mcp/handlers/task.js

@@ -10,8 +10,8 @@
 import { envelope } from '../envelope.js';
 /**
  * 统一入口
- * @param {object} ctx - { container }
- * @param {object} args - { operation, ...params }
+ * @param ctx { container }
+ * @param args { operation, ...params }
  */
 export async function taskHandler(ctx, args) {
     const taskService = ctx.container.get('taskGraphService');
@@ -513,11 +513,7 @@ async function _listDecisions(svc) {
 // 飞书 WSClient 连接在 API Server 中，因此通知需 HTTP 中转。
 // ═══════════════════════════════════════════════════════════
 const PRIORITY_LABELS = ['P0 紧急', 'P1 高', 'P2 中', 'P3 低', 'P4 微'];
-/**
- * 通过 API Server 的 /api/v1/remote/notify 发送飞书通知
- * @param {string} text
- * @returns {Promise<boolean>}
- */
+/** 通过 API Server 的 /api/v1/remote/notify 发送飞书通知 */
 async function _sendLarkViaApi(text) {
     try {
         const port = process.env.PORT || 3000;
@@ -541,8 +537,7 @@ async function _sendLarkViaApi(text) {
 }
 /**
  * 通过 API Server 截取 IDE 窗口截图并发送到飞书
- * @param {string} [caption] 可选文字说明
- * @returns {Promise<boolean>}
+ * @param [caption] 可选文字说明
  */
 async function _sendScreenshotViaApi(caption = '') {
     try {
@@ -658,4 +653,3 @@ async function _notifyTaskProgress(operation, args, result) {
         await _sendScreenshotViaApi();
     }
 }
-//# sourceMappingURL=task.js.map

package/dist/lib/external/mcp/handlers/types.d.ts

@@ -322,4 +322,3 @@ export interface ByKindGroup {
     pattern: SlimSearchItem[];
     fact: SlimSearchItem[];
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/lib/external/mcp/handlers/types.js

@@ -3,4 +3,3 @@
  * Runtime-free — only interfaces and type aliases.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/lib/external/mcp/handlers/wiki-external.d.ts

@@ -29,8 +29,8 @@ interface WikiFinalizeArgs {
  * 复用 WikiGenerator 的数据收集和主题发现逻辑（Phase 1-5），
  * 但不撰写文章，只返回规划清单和每个主题的数据包。
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args - { language?: 'zh'|'en', sessionId?: string }
+ * @param ctx { container, logger, startedAt }
+ * @param args { language?: 'zh'|'en', sessionId?: string }
  */
 export declare function wikiPlan(ctx: McpContext, args: WikiPlanArgs): Promise<{
     success: boolean;
@@ -74,8 +74,8 @@ export declare function wikiPlan(ctx: McpContext, args: WikiPlanArgs): Promise<{
  *   3. 写入 meta.json
  *   4. 同步 Cursor 端文档（可选）
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args - { articlesWritten: string[] }
+ * @param ctx { container, logger, startedAt }
+ * @param args { articlesWritten: string[] }
  */
 export declare function wikiFinalize(ctx: McpContext, args: WikiFinalizeArgs): Promise<{
     success: boolean;
@@ -90,4 +90,3 @@ export declare function wikiFinalize(ctx: McpContext, args: WikiFinalizeArgs): P
     };
 }>;
 export {};
-//# sourceMappingURL=wiki-external.d.ts.map

package/dist/lib/external/mcp/handlers/wiki-external.js

@@ -40,8 +40,8 @@ function tryGet(container, name) {
  * 复用 WikiGenerator 的数据收集和主题发现逻辑（Phase 1-5），
  * 但不撰写文章，只返回规划清单和每个主题的数据包。
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args - { language?: 'zh'|'en', sessionId?: string }
+ * @param ctx { container, logger, startedAt }
+ * @param args { language?: 'zh'|'en', sessionId?: string }
  */
 export async function wikiPlan(ctx, args) {
     const t0 = Date.now();
@@ -220,8 +220,8 @@ export async function wikiPlan(ctx, args) {
  *   3. 写入 meta.json
  *   4. 同步 Cursor 端文档（可选）
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args - { articlesWritten: string[] }
+ * @param ctx { container, logger, startedAt }
+ * @param args { articlesWritten: string[] }
  */
 export async function wikiFinalize(ctx, args) {
     const t0 = Date.now();
@@ -370,9 +370,7 @@ function _ensureDir(dir) {
         fs.mkdirSync(dir, { recursive: true });
     }
 }
-/**
- * 为主题生成写作指南
- */
+/** 为主题生成写作指南 */
 function _buildWritingGuide(topic, isZh) {
     const guides = {
         overview: isZh
@@ -408,9 +406,7 @@ function _buildWritingGuide(topic, isZh) {
             ? '撰写详细的技术文档，结构清晰，内容准确。'
             : 'Write detailed technical documentation with clear structure and accurate content.'));
 }
-/**
- * 为主题构建数据包
- */
+/** 为主题构建数据包 */
 function _buildTopicDataBundle(topic, structuredData) {
     const { projectInfo, astInfo, moduleInfo, knowledgeInfo } = structuredData;
     const bundle = {};
@@ -542,9 +538,7 @@ function _buildTopicDataBundle(topic, structuredData) {
     }
     return bundle;
 }
-/**
- * 构建写作指导手册
- */
+/** 构建写作指导手册 */
 function _buildWritingGuidelines(isZh) {
     return {
         language: isZh ? 'zh' : 'en',
@@ -570,4 +564,3 @@ function _buildWritingGuidelines(isZh) {
             : 'Add a "## Related Documents" section at the end, linking to other wiki pages',
     };
 }
-//# sourceMappingURL=wiki-external.js.map

package/dist/lib/external/mcp/tools.d.ts

@@ -72,4 +72,3 @@ export declare const TOOLS: {
     description: string;
     inputSchema: import("./zodToMcpSchema.js").McpInputSchema;
 }[];
-//# sourceMappingURL=tools.d.ts.map

package/dist/lib/external/mcp/tools.js

@@ -238,4 +238,3 @@ export const TOOLS = [
         inputSchema: zodToMcpSchema(CheckDuplicateInput),
     },
 ];
-//# sourceMappingURL=tools.js.map

package/dist/lib/external/mcp/zodToMcpSchema.d.ts

@@ -29,4 +29,3 @@ export interface McpInputSchema {
  *   // → { type: 'object', properties: { query: { type: 'string', minLength: 1 }, ... }, required: ['query'] }
  */
 export declare function zodToMcpSchema(schema: z.ZodType): McpInputSchema;
-//# sourceMappingURL=zodToMcpSchema.d.ts.map

package/dist/lib/external/mcp/zodToMcpSchema.js

@@ -10,9 +10,7 @@
  * @module external/mcp/zodToMcpSchema
  */
 import { z } from 'zod';
-/**
- * 递归清理 JSON Schema 对象
- */
+/** 递归清理 JSON Schema 对象 */
 function cleanJsonSchema(obj) {
     const cleaned = { ...obj };
     // 移除顶层 $schema
@@ -81,4 +79,3 @@ export function zodToMcpSchema(schema) {
         ...cleaned,
     };
 }
-//# sourceMappingURL=zodToMcpSchema.js.map

package/dist/lib/http/HttpServer.d.ts

@@ -32,52 +32,31 @@ export declare class HttpServer {
     realtimeService: Record<string, unknown> | null;
     server: Server | null;
     constructor(config?: Partial<HttpServerConfig>);
-    /**
-     * 初始化服务器
-     */
+    /** 初始化服务器 */
     initialize(): Promise<void>;
-    /**
-     * 初始化服务（监控、缓存等）
-     */
+    /** 初始化服务（监控、缓存等） */
     initializeServices(): Promise<void>;
-    /**
-     * 设置中间件
-     */
+    /** 设置中间件 */
     setupMiddleware(): void;
-    /**
-     * 注册 Gateway Actions
-     */
+    /** 注册 Gateway Actions */
     registerGatewayActions(): void;
-    /**
-     * 设置路由
-     */
+    /** 设置路由 */
     setupRoutes(): void;
-    /**
-     * 设置错误处理
-     */
+    /** 设置错误处理 */
     setupErrorHandling(): void;
-    /**
-     * 启动服务器
-     */
+    /** 启动服务器 */
     start(): Promise<unknown>;
-    /**
-     * 停止服务器
-     */
+    /** 停止服务器 */
     stop(): Promise<void>;
-    /**
-     * 获取 Express 应用实例
-     */
+    /** 获取 Express 应用实例 */
     getApp(): express.Application;
     /**
      * 挂载 Dashboard 静态资源（生产模式：直接托管预构建产物）
      * 必须在 initialize() + start() 之后调用
-     * @param {string} distDir - dashboard/dist 目录的绝对路径
+     * @param distDir dashboard/dist 目录的绝对路径
      */
     mountDashboard(distDir: string): void;
-    /**
-     * 获取服务器实例
-     */
+    /** 获取服务器实例 */
     getServer(): Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse> | null;
 }
 export default HttpServer;
-//# sourceMappingURL=HttpServer.d.ts.map