autosnippet 3.2.10 → 3.2.11

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

@@ -0,0 +1,265 @@
+/**
+ * MCP Handlers — 搜索类
+ * 4 个搜索函数（search / contextSearch / keywordSearch / semanticSearch）
+ * 已通过 consolidated.js 整合为统一 MCP 工具 autosnippet_search，
+ * 由 mode 参数（auto / keyword / bm25 / semantic / context）路由到对应处理函数。
+ *
+ * 设计原则：
+ * 1. 通过 container.get('searchEngine') 获取 singleton 实例（含 vectorStore + aiProvider）
+ * 2. 统一 responseTime、byKind 分组、kind 过滤
+ * 3. 投影原则：只交付 Agent 可操作的信号，去除内部排序信号
+ */
+import { envelope } from '../envelope.js';
+// ─── 工具函数 ────────────────────────────────────────────────
+/**
+ * 获取 SearchEngine singleton（带 vectorStore + aiProvider）
+ * 避免每次调用 new SearchEngine(db) —— 那样没有向量能力、每次重建索引
+ */
+function getSearchEngine(ctx) {
+    try {
+        return ctx.container.get('searchEngine');
+    }
+    catch {
+        // 降级：直接创建基础实例（无向量能力）
+        return null;
+    }
+}
+/**
+ * 降级创建 SearchEngine（仅在 container 无法提供时）
+ */
+async function getFallbackEngine(ctx) {
+    const { SearchEngine } = await import('#service/search/SearchEngine.js');
+    const db = ctx.container.get('database');
+    return new SearchEngine(db);
+}
+/**
+ * 根据 kind 参数过滤 items
+ */
+function filterByKind(items, kind) {
+    if (!kind || kind === 'all') {
+        return items;
+    }
+    return items.filter((it) => (it.kind || it.metadata?.kind || 'pattern') === kind);
+}
+/**
+ * 搜索结果投影 — 去除内部排序信号，只保留 Agent 可操作字段。
+ *
+ * 移除: type(=recipe, 冗余), status(已 filter), updatedAt, createdAt, difficulty,
+ *       tags, usageCount, authorityScore, qualityScore, headers, moduleName, content(巨大)
+ * 新增: actionHint (whenClause → doClause 一句话摘要)
+ */
+function _slimSearchItem(item) {
+    const doText = item.doClause || '';
+    const whenText = item.whenClause || '';
+    const actionHint = doText || whenText
+        ? `${whenText ? `${whenText} → ` : ''}${doText}`.replace(/ → $/, '')
+        : undefined;
+    return {
+        id: item.id,
+        title: item.title,
+        trigger: item.trigger || '',
+        kind: item.kind || 'pattern',
+        language: item.language || '',
+        score: item.score,
+        description: (item.description || '').slice(0, 120),
+        actionHint,
+    };
+}
+/**
+ * items → slim byKind 分组
+ */
+function _slimGroupByKind(items) {
+    const byKind = { rule: [], pattern: [], fact: [] };
+    for (const it of items) {
+        const kind = it.kind || 'pattern';
+        const bucket = byKind[kind] || byKind.pattern;
+        bucket.push(it);
+    }
+    return byKind;
+}
+// ─── 1. autosnippet_search — 统合搜索入口 ─────────────────────
+/**
+ * 智能统合搜索 —— 支持 auto/keyword/bm25/semantic 四种模式
+ *
+ * mode=auto（默认）时，同时执行 BM25 + semantic，融合去重取分数最高者。
+ * 支持 kind 过滤（rule/pattern/fact）和 byKind 自动分组。
+ */
+export async function search(ctx, args) {
+    const t0 = Date.now();
+    const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
+    const query = args.query;
+    const limit = args.limit || 10;
+    const kind = args.kind || args.type || 'all';
+    const mode = args.mode || 'auto';
+    // 统一调用 SearchEngine（auto 模式内置 BM25+semantic 融合去重 + Ranking Pipeline）
+    const result = await engine.search(query, {
+        mode,
+        limit: kind !== 'all' ? limit * 2 : limit,
+        rank: true,
+        groupByKind: true,
+    });
+    let items = result?.items || [];
+    const actualMode = result?.mode || mode;
+    // kind 过滤
+    items = filterByKind(items, kind);
+    items = items.slice(0, limit);
+    // Agent 投影：去除内部排序信号
+    const slimItems = items.map(_slimSearchItem);
+    const byKind = _slimGroupByKind(slimItems);
+    const elapsed = Date.now() - t0;
+    return envelope({
+        success: true,
+        data: {
+            query,
+            mode: actualMode,
+            kind: kind === 'all' ? undefined : kind,
+            totalResults: slimItems.length,
+            items: slimItems,
+            byKind,
+            kindCounts: {
+                rule: byKind.rule.length,
+                pattern: byKind.pattern.length,
+                fact: byKind.fact.length,
+            },
+        },
+        meta: { tool: 'autosnippet_search', responseTimeMs: elapsed },
+    });
+}
+// ─── 2. autosnippet_context_search — 智能上下文搜索 ────────────
+/**
+ * 智能上下文搜索 —— SearchEngine 内置 Ranking Pipeline
+ *
+ * 设计原则：MCP 调用方是外部 AI Agent，意图识别由 Agent 自行完成。
+ * 本工具聚焦数据检索：BM25 召回 + CoarseRanker + MultiSignalRanker + 上下文加成
+ *
+ * 特色：byKind 分组、个性化推荐、会话连续性
+ */
+export async function contextSearch(ctx, args) {
+    const t0 = Date.now();
+    const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
+    const limit = args.limit ?? 5;
+    const result = await engine.search(args.query, {
+        mode: 'bm25',
+        limit,
+        rank: true,
+        groupByKind: true,
+        context: {
+            intent: 'search',
+            language: args.language,
+            sessionHistory: args.sessionHistory || [],
+        },
+    });
+    const items = (result?.items || []).slice(0, limit);
+    const slimItems = items.map(_slimSearchItem);
+    const byKind = _slimGroupByKind(slimItems);
+    const elapsed = Date.now() - t0;
+    const source = result?.ranked ? 'search-engine+ranking' : 'search-engine';
+    return envelope({
+        success: true,
+        data: {
+            items: slimItems,
+            byKind,
+            metadata: {
+                responseTimeMs: elapsed,
+                totalResults: slimItems.length,
+                kindCounts: {
+                    rule: byKind.rule.length,
+                    pattern: byKind.pattern.length,
+                    fact: byKind.fact.length,
+                },
+            },
+        },
+        meta: { tool: 'autosnippet_context_search', source, responseTimeMs: elapsed },
+    });
+}
+// ─── 3. autosnippet_keyword_search — SQL LIKE 精确匹配 ─────────
+/**
+ * 纯关键词精确匹配 —— SQL LIKE 查询，适合已知函数名/类名/变量名。
+ * 与 search/semantic_search 的 BM25/向量搜索互补：
+ * - keyword_search 对精确字符串（ObjC 方法名、类名前缀）最快最准
+ * - search 对模糊查询更好（BM25 词频权重）
+ * - semantic_search 对自然语言意图最好（向量相似度）
+ */
+export async function keywordSearch(ctx, args) {
+    const t0 = Date.now();
+    const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
+    const query = args.query;
+    const limit = args.limit || 10;
+    const kind = args.kind || 'all';
+    const result = await engine.search(query, {
+        mode: 'keyword',
+        limit,
+        groupByKind: true,
+    });
+    let items = result?.items || [];
+    items = filterByKind(items, kind).slice(0, limit);
+    const slimItems = items.map(_slimSearchItem);
+    const byKind = _slimGroupByKind(slimItems);
+    const elapsed = Date.now() - t0;
+    return envelope({
+        success: true,
+        data: {
+            query,
+            mode: 'keyword',
+            kind: kind === 'all' ? undefined : kind,
+            totalResults: slimItems.length,
+            items: slimItems,
+            byKind,
+            kindCounts: {
+                rule: byKind.rule.length,
+                pattern: byKind.pattern.length,
+                fact: byKind.fact.length,
+            },
+        },
+        meta: { tool: 'autosnippet_keyword_search', responseTimeMs: elapsed },
+    });
+}
+// ─── 4. autosnippet_semantic_search — 向量语义搜索 ──────────────
+/**
+ * 向量语义搜索 —— 基于 embedding 的相似度检索。
+ * 通过 container singleton 的 SearchEngine（含 vectorStore + aiProvider）执行真正的向量搜索。
+ * 如果向量引擎不可用会自动降级到 BM25，并在 actualMode 标注。
+ *
+ * kind 过滤 + byKind 分组一致性。
+ */
+export async function semanticSearch(ctx, args) {
+    const t0 = Date.now();
+    const engine = getSearchEngine(ctx) || (await getFallbackEngine(ctx));
+    const query = args.query;
+    const limit = args.limit || 10;
+    const kind = args.kind || 'all';
+    const result = await engine.search(query, {
+        mode: 'semantic',
+        limit: limit * 2,
+        rank: true,
+        groupByKind: true,
+    });
+    let items = result?.items || [];
+    const actualMode = result?.mode || 'semantic';
+    items = filterByKind(items, kind).slice(0, limit);
+    const slimItems = items.map(_slimSearchItem);
+    const byKind = _slimGroupByKind(slimItems);
+    const elapsed = Date.now() - t0;
+    // 提示 AI Agent 当前实际模式
+    const degraded = actualMode !== 'semantic';
+    return envelope({
+        success: true,
+        data: {
+            query,
+            mode: actualMode,
+            kind: kind === 'all' ? undefined : kind,
+            degraded,
+            degradedReason: degraded ? 'vectorStore/aiProvider 不可用，已降级到 BM25' : undefined,
+            totalResults: slimItems.length,
+            items: slimItems,
+            byKind,
+            kindCounts: {
+                rule: byKind.rule.length,
+                pattern: byKind.pattern.length,
+                fact: byKind.fact.length,
+            },
+        },
+        meta: { tool: 'autosnippet_semantic_search', responseTimeMs: elapsed },
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/lib/external/mcp/handlers/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/search.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,83 @@
+/**
+ * MCP Handlers — Skills 加载与发现
+ *
+ * 为 MCP 外部 Agent 提供 Skills 访问能力，使其能按需获取领域操作指南。
+ * Skills 是 Agent 的知识增强文档，指导如何正确使用 AutoSnippet 工具。
+ *
+ * 设计原则：
+ *   - Skills 是只读文档，不涉及 AI 调用，不需要 Gateway gating
+ *   - 外部 Agent 应根据当前任务类型选择加载合适的 Skill
+ *   - list_skills 返回摘要帮助 Agent 判断该加载哪个 Skill
+ */
+import type { McpContext } from './types.js';
+/**
+ * 列出所有可用 Skills 及其摘要描述
+ *
+ * @returns {string} JSON envelope
+ */
+export declare function listSkills(): string;
+/**
+ * 加载指定 Skill 的完整文档内容
+ *
+ * @param {object} _ctx  MCP context（未使用，保持签名一致）
+ * @param {object} args  { skillName: string, section?: string }
+ * @returns {string} JSON envelope
+ */
+export declare function loadSkill(_ctx: McpContext | null, args: {
+    skillName?: string;
+    section?: string;
+}): string;
+/**
+ * 创建项目级 Skill — 写入 {projectRoot}/AutoSnippet/skills/<name>/SKILL.md
+ * 创建后自动 regenerate 编辑器索引（.cursor/rules/autosnippet-skills.mdc）
+ *
+ * @param {object} _ctx  MCP context
+ * @param {object} args  { name, description, content, overwrite? }
+ * @returns {string} JSON envelope
+ */
+interface CreateSkillArgs {
+    name?: string;
+    description?: string;
+    content?: string;
+    overwrite?: boolean;
+    createdBy?: string;
+    title?: string;
+}
+export declare function createSkill(_ctx: McpContext | null, args: CreateSkillArgs): string;
+/**
+ * 删除项目级 Skill — 移除 {projectRoot}/AutoSnippet/skills/<name>/ 整个目录
+ * 内置 Skill 不可删除。删除后自动 regenerate 编辑器索引。
+ *
+ * @param {object} _ctx  MCP context
+ * @param {object} args  { name: string }
+ * @returns {string} JSON envelope
+ */
+export declare function deleteSkill(_ctx: McpContext | null, args: {
+    name?: string;
+}): string;
+/**
+ * 更新项目级 Skill — 修改 description 和/或 content
+ * 内置 Skill 不可更新。更新后自动 regenerate 编辑器索引。
+ *
+ * @param {object} _ctx  MCP context
+ * @param {object} args  { name, description?, content? }
+ * @returns {string} JSON envelope
+ */
+interface UpdateSkillArgs {
+    name?: string;
+    description?: string;
+    content?: string;
+}
+export declare function updateSkill(_ctx: McpContext | null, args: UpdateSkillArgs): string;
+/**
+ * 基于项目使用模式分析，推荐创建 Skill
+ *
+ * 分析维度：Guard 违规模式、Memory 偏好积累、Recipe 分布缺口、候选积压
+ * Agent 可根据推荐结果自行决定是否调用 createSkill 创建
+ *
+ * @param {object} ctx  MCP context（含 container）
+ * @returns {Promise<string>} JSON envelope
+ */
+export declare function suggestSkills(ctx: McpContext): Promise<string>;
+export {};
+//# sourceMappingURL=skill.d.ts.map

package/dist/lib/external/mcp/handlers/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA4E7C;;;;GAIG;AACH,wBAAgB,UAAU,WA6EzB;AAMD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,UA2EhG;AAMD;;;;;;;GAOG;AACH,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,eAAe,UAsHzE;AAyED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,UAsE3E;AAMD;;;;;;;GAOG;AACH,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,EAAE,eAAe,UAiHzE;AAMD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,mBAmBlD"}