autosnippet 3.2.9 → 3.2.11

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

@@ -0,0 +1,292 @@
+/**
+ * MCP 整合 Handler — 参数路由层
+ *
+ * 将整合后的工具（autosnippet_search / knowledge / structure / graph / guard / skill）
+ * 按 operation / mode 参数路由到已有 handler 实现。
+ *
+ * 不包含业务逻辑，仅做参数解构 → 路由 → 转发。
+ *
+ * autosnippet_bootstrap 已迁移到 bootstrap-external.js（外部 Agent 路径）。
+ */
+import { getRequiredFieldsDescription } from '#shared/FieldSpec.js';
+import * as browseHandlers from './browse.js';
+import * as candidateHandlers from './candidate.js';
+import * as guardHandlers from './guard.js';
+import * as searchHandlers from './search.js';
+import * as skillHandlers from './skill.js';
+import * as structureHandlers from './structure.js';
+// ─── autosnippet_search (整合 4 → 1) ────────────────────────
+/**
+ * 统合搜索：根据 mode 参数路由到对应搜索 handler
+ *   auto (默认) → search()
+ *   keyword     → keywordSearch()
+ *   semantic    → semanticSearch()
+ *   context     → contextSearch()
+ */
+export async function consolidatedSearch(ctx, args) {
+    const mode = args.mode || 'auto';
+    switch (mode) {
+        case 'keyword':
+            return searchHandlers.keywordSearch(ctx, args);
+        case 'semantic':
+            return searchHandlers.semanticSearch(ctx, args);
+        case 'context':
+            return searchHandlers.contextSearch(ctx, args);
+        default:
+            return searchHandlers.search(ctx, { ...args, mode });
+    }
+}
+// ─── autosnippet_knowledge (整合 7 → 1) ─────────────────────
+/**
+ * 知识浏览：根据 operation 参数路由
+ *   list (默认) → listByKind() 或 listRecipes()
+ *   get          → getRecipe()
+ *   insights     → recipeInsights()
+ *   confirm_usage → confirmUsage()
+ */
+export async function consolidatedKnowledge(ctx, args) {
+    const op = args.operation || 'list';
+    switch (op) {
+        case 'list': {
+            const kind = args.kind;
+            if (kind && kind !== 'all') {
+                return browseHandlers.listByKind(ctx, kind, args);
+            }
+            return browseHandlers.listRecipes(ctx, args);
+        }
+        case 'get':
+            return browseHandlers.getRecipe(ctx, args);
+        case 'insights':
+            return browseHandlers.recipeInsights(ctx, args);
+        case 'confirm_usage':
+            // confirmUsage expects { recipeId, usageType, feedback }
+            // 适配：如果传了 id 但没传 recipeId，自动映射
+            if (args.id && !args.recipeId) {
+                args.recipeId = args.id;
+            }
+            return browseHandlers.confirmUsage(ctx, args);
+        default:
+            throw new Error(`Unknown knowledge operation: ${op}. Expected: list, get, insights, confirm_usage`);
+    }
+}
+// ─── autosnippet_structure (整合 3 → 1) ─────────────────────
+/**
+ * 项目结构：根据 operation 参数路由
+ *   targets (默认) → getTargets()
+ *   files          → getTargetFiles()
+ *   metadata       → getTargetMetadata()
+ */
+export async function consolidatedStructure(ctx, args) {
+    const op = args.operation || 'targets';
+    switch (op) {
+        case 'targets':
+            return structureHandlers.getTargets(ctx, args);
+        case 'files':
+            return structureHandlers.getTargetFiles(ctx, args);
+        case 'metadata':
+            return structureHandlers.getTargetMetadata(ctx, args);
+        default:
+            throw new Error(`Unknown structure operation: ${op}. Expected: targets, files, metadata`);
+    }
+}
+// ─── autosnippet_call_context (Phase 5) ─────────────────────
+/**
+ * 调用链上下文查询：直接转发到 structure.callContext
+ */
+export async function consolidatedCallContext(ctx, args) {
+    return structureHandlers.callContext(ctx, args);
+}
+// ─── autosnippet_graph (整合 4 → 1) ─────────────────────────
+/**
+ * 知识图谱：根据 operation 参数路由
+ *   query   → graphQuery()
+ *   impact  → graphImpact()
+ *   path    → graphPath()
+ *   stats   → graphStats()
+ */
+export async function consolidatedGraph(ctx, args) {
+    const op = args.operation;
+    if (!op) {
+        throw new Error('Missing required parameter: operation. Expected: query, impact, path, stats');
+    }
+    switch (op) {
+        case 'query':
+            return structureHandlers.graphQuery(ctx, args);
+        case 'impact':
+            return structureHandlers.graphImpact(ctx, args);
+        case 'path':
+            return structureHandlers.graphPath(ctx, args);
+        case 'stats':
+            return structureHandlers.graphStats(ctx);
+        default:
+            throw new Error(`Unknown graph operation: ${op}. Expected: query, impact, path, stats`);
+    }
+}
+// ─── autosnippet_guard (整合 3 → 1) ─────────────────────────
+/**
+ * Guard 检查：按参数自动路由
+ *   无参数       → guardReview()    (自动 git diff 检测 + inline recipe)
+ *   有 files     → guardReview()    (指定文件 + inline recipe) — files 为 string[] 或 {path}[]
+ *   有 code      → guardCheck()     (单文件内联检查)
+ */
+export async function consolidatedGuard(ctx, args) {
+    // 有 code → 单文件检查（旧模式）
+    if (args.code) {
+        return guardHandlers.guardCheck(ctx, args);
+    }
+    // 有 files（string[] 或 {path}[]）或无参数 → review 模式
+    // review 模式内部处理 files 参数和自动检测
+    return guardHandlers.guardReview(ctx, args);
+}
+// ─── autosnippet_skill (整合 6 → 1) ─────────────────────────
+/**
+ * Skill 管理：根据 operation 参数路由
+ *   list    → listSkills()
+ *   load    → loadSkill()
+ *   create  → createSkill()
+ *   update  → updateSkill()
+ *   delete  → deleteSkill()
+ *   suggest → suggestSkills()
+ */
+export async function consolidatedSkill(ctx, args) {
+    const op = args.operation;
+    if (!op) {
+        throw new Error('Missing required parameter: operation. Expected: list, load, create, update, delete, suggest');
+    }
+    // loadSkill expects { skillName }, map from { name }
+    if (args.name && !args.skillName) {
+        args.skillName = args.name;
+    }
+    switch (op) {
+        case 'list':
+            return skillHandlers.listSkills();
+        case 'load':
+            return skillHandlers.loadSkill(ctx, args);
+        case 'create':
+            return skillHandlers.createSkill(ctx, args);
+        case 'update':
+            return skillHandlers.updateSkill(ctx, args);
+        case 'delete':
+            return skillHandlers.deleteSkill(ctx, args);
+        case 'suggest':
+            return skillHandlers.suggestSkills(ctx);
+        default:
+            throw new Error(`Unknown skill operation: ${op}. Expected: list, load, create, update, delete, suggest`);
+    }
+}
+// ─── autosnippet_submit_knowledge (增强：严格前置校验 + dedup + 提交追踪) ──
+/**
+ * 增强版提交：严格前置校验，缺少必要字段直接拒绝（不入库）。
+ * 通过校验后执行提交 + 去重检测，结果附在响应中。
+ * v2: 成功提交后记录到 BootstrapSession.submissionTracker (如果有活跃 session)。
+ *
+ * 设计原则：
+ *   - 不降级：缺字段不自动补全，要求 Agent 一次性生成完整数据
+ *   - 不重复提交：拒绝时不创建任何记录，Agent 需补齐后重新调用
+ */
+export async function enhancedSubmitKnowledge(ctx, args) {
+    const { submitKnowledge } = await import('./knowledge.js');
+    const { UnifiedValidator } = await import('#shared/UnifiedValidator.js');
+    const { envelope } = await import('../envelope.js');
+    const skipDuplicateCheck = args.skipDuplicateCheck === true;
+    // ── 严格前置校验：UnifiedValidator 不通过则直接拒绝 ──
+    const validator = new UnifiedValidator();
+    const validResult = validator.validate(args, {
+        skipUniqueness: true, // 去重由下方 dedup 单独处理
+    });
+    if (!validResult.pass) {
+        // v2: 记录拒绝到 BootstrapSession tracker
+        _trackRejection(ctx, args);
+        return envelope({
+            success: false,
+            message: `提交被拒绝：${validResult.errors.join('; ')}。请在单次调用中补齐所有字段后重新提交，不要分步提交或先提交再补全。`,
+            errorCode: 'INCOMPLETE_SUBMISSION',
+            data: {
+                errors: validResult.errors,
+                warnings: validResult.warnings,
+                requiredFields: getRequiredFieldsDescription(),
+            },
+            meta: { tool: 'autosnippet_submit_knowledge' },
+        });
+    }
+    // ── 校验通过，执行提交 ──
+    const result = await submitKnowledge(ctx, args);
+    // 如果提交本身失败，直接返回
+    if (result && !result.success) {
+        return result;
+    }
+    // ── 附加去重检测结果（非阻塞） ──
+    let duplicateCheck = null;
+    if (!skipDuplicateCheck) {
+        try {
+            const dedupCandidate = {
+                title: args.title,
+                summary: args.description || '',
+                code: args.content?.pattern || '',
+            };
+            const dedupResult = await candidateHandlers.checkDuplicate(ctx, {
+                candidate: dedupCandidate,
+                threshold: 0.7,
+                topK: 3,
+            });
+            if (dedupResult?.data) {
+                duplicateCheck = {
+                    hasSimilar: dedupResult.data.similar?.length > 0,
+                    closest: dedupResult.data.similar?.[0] || null,
+                };
+            }
+        }
+        catch {
+            duplicateCheck = { hasSimilar: false, note: 'dedup skipped due to error' };
+        }
+    }
+    // 将去重结果附到响应中
+    if (result?.data) {
+        result.data.duplicateCheck = duplicateCheck;
+    }
+    // v2: 记录成功提交到 BootstrapSession tracker
+    if (result?.data?.id) {
+        _trackSubmission(ctx, args, result.data.id);
+    }
+    return result;
+}
+// ── v2: BootstrapSession 提交追踪辅助函数 ──────────────────
+/**
+ * 记录成功提交到活跃 BootstrapSession 的 submissionTracker
+ * 静默失败 — tracker 不可用时不影响提交本身
+ */
+function _trackSubmission(ctx, args, recipeId) {
+    try {
+        const sessionManager = ctx.container.get('bootstrapSessionManager');
+        const session = sessionManager?.getSession?.();
+        if (!session?.submissionTracker) {
+            return;
+        }
+        // 推断当前维度: 优先使用 Agent 显式传递的 dimensionId，其次推断 remainingDimIds[0]
+        const progress = session.getProgress();
+        const currentDimId = args.dimensionId || progress.remainingDimIds[0] || args.knowledgeType || 'unknown';
+        session.submissionTracker.recordSubmission(currentDimId, args, recipeId);
+    }
+    catch {
+        // tracker 不可用时静默降级
+    }
+}
+/**
+ * 记录拒绝到活跃 BootstrapSession 的 submissionTracker
+ */
+function _trackRejection(ctx, args) {
+    try {
+        const sessionManager = ctx.container.get('bootstrapSessionManager');
+        const session = sessionManager?.getSession?.();
+        if (!session?.submissionTracker) {
+            return;
+        }
+        const progress = session.getProgress();
+        const currentDimId = args?.dimensionId || progress.remainingDimIds[0] || 'unknown';
+        session.submissionTracker.recordRejection(currentDimId, args?.title || '(untitled)', 'validation failed');
+    }
+    catch {
+        // 静默降级
+    }
+}
+//# sourceMappingURL=consolidated.js.map

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

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

package/dist/lib/external/mcp/handlers/dimension-complete-external.d.ts

@@ -0,0 +1,57 @@
+/**
+ * MCP Handler — 维度完成通知 (dimension_complete)
+ *
+ * 外部 Agent 完成一个维度的分析后调用此 handler：
+ *   1. Recipe 关联 — 标记 submit_knowledge 提交的 recipes 属于此维度
+ *   2. Skill 生成 — skillWorthy 维度自动生成 Project Skill
+ *   3. Checkpoint 保存 — 持久化进度，支持断点续传
+ *   4. EpisodicMemory 写入 — 供 Dashboard 和增量 Bootstrap
+ *   5. SemanticMemory 固化 — 提炼为项目级永久记忆
+ *   6. 进度推送 — Socket.io/EventBus 通知 Dashboard
+ *   7. Hints 收集与分发 — 跨维度知识传递
+ *
+ * 幂等性：同一 dimensionId 多次调用 → 覆盖更新，不产生重复
+ *
+ * @module handlers/dimension-complete
+ */
+import type { McpContext } from './types.js';
+/**
+ * dimensionComplete — 维度分析完成通知
+ *
+ * @param {object} ctx  - { container, logger, startedAt }
+ * @param {object} args 工具参数
+ * @param {string} [args.sessionId]          - bootstrap 返回的 session.id
+ * @param {string} args.dimensionId          维度 ID
+ * @param {string[]} args.submittedRecipeIds 本维度提交的 recipe ID 列表
+ * @param {string} args.analysisText         分析报告全文（Markdown）
+ * @param {string[]} [args.referencedFiles]  引用的文件路径列表
+ * @param {string[]} [args.keyFindings]      关键发现摘要 (3-5 条)
+ * @param {number} [args.candidateCount]     本维度提交的候选数量
+ * @param {object} [args.crossDimensionHints] 对其他维度的建议
+ * @returns {Promise<object>}
+ */
+interface DimensionCompleteArgs {
+    sessionId?: string;
+    dimensionId?: string;
+    submittedRecipeIds?: string[];
+    analysisText?: string;
+    referencedFiles?: string[];
+    keyFindings?: string[];
+    candidateCount?: number;
+    crossDimensionHints?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export declare function dimensionComplete(ctx: McpContext, args: DimensionCompleteArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: unknown;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+export {};
+//# sourceMappingURL=dimension-complete-external.d.ts.map

package/dist/lib/external/mcp/handlers/dimension-complete-external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-complete-external.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/dimension-complete-external.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C;;;;;;;;;;;;;;GAcG;AACH,UAAU,qBAAqB;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,qBAAqB;;;;;;;;;;;GAmdnF"}