autosnippet 3.2.10 → 3.2.12

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

@@ -0,0 +1,180 @@
+/**
+ * MCP Handler — 外部 Agent 驱动的 Bootstrap (External-Agent-Driven)
+ *
+ * `autosnippet_bootstrap` 的主入口（无参数）：
+ *   Phase 1-4 同步执行（文件收集 / AST / 依赖图 / Guard）
+ *   → 构建 Mission Briefing 一次性返回
+ *   → 不启动 Phase 5 异步 AI pipeline
+ *   → 等待外部 Agent (Cursor/Copilot) 主动提交知识 + 完成维度
+ *
+ * 与 bootstrap-internal.js 的关系：
+ *   - 本文件: 外部 Agent 路径 — Agent 自己分析代码 + 提交知识，不需要 AI Provider
+ *   - bootstrap-internal.js: 内部 Agent 路径 — 内置 Analyst/Producer pipeline，需要 API Key
+ *   - 两者共享 Phase 1-4 的分析逻辑 → bootstrap/shared/bootstrap-phases.js
+ *
+ * @module handlers/bootstrap-external
+ */
+import path from 'node:path';
+import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
+import { envelope } from '../envelope.js';
+import { BootstrapSessionManager } from './bootstrap/BootstrapSession.js';
+import { buildMissionBriefing } from './bootstrap/MissionBriefingBuilder.js';
+import { runAllPhases } from './bootstrap/shared/bootstrap-phases.js';
+import { buildLanguageExtension } from './LanguageExtensions.js';
+// ── 进程级 Session 管理器 ─────────────────────────────────
+let _sessionManager = null;
+/**
+ * 获取或创建 BootstrapSessionManager
+ * @param {object} container - ServiceContainer
+ * @returns {BootstrapSessionManager}
+ */
+function getSessionManager(container) {
+    // 优先使用容器注册的 (如果已注册)
+    try {
+        const mgr = container.get('bootstrapSessionManager');
+        if (mgr) {
+            return mgr;
+        }
+    }
+    catch {
+        /* not registered yet */
+    }
+    // 降级为模块级单例
+    if (!_sessionManager) {
+        _sessionManager = new BootstrapSessionManager();
+    }
+    // 注册到容器，让 submitKnowledgeBatch / consolidated 等 handler 也能访问
+    try {
+        container.register('bootstrapSessionManager', () => _sessionManager);
+    }
+    catch {
+        /* already registered or container doesn't support register */
+    }
+    return _sessionManager;
+}
+// ── 主入口 ─────────────────────────────────────────────────────
+/**
+ * bootstrapExternal — 外部 Agent 驱动的一键冷启动
+ *
+ * 无参数调用，返回 Mission Briefing。
+ * Phase 1-4 复用现有 bootstrap.js 逻辑，Phase 5 不启动。
+ *
+ * @param {object} ctx - { container, logger, startedAt }
+ * @returns {Promise<object>} - envelope({ success, data: MissionBriefing })
+ */
+export async function bootstrapExternal(ctx) {
+    const t0 = Date.now();
+    const projectRoot = resolveProjectRoot(ctx.container);
+    // ═══════════════════════════════════════════════════════════
+    // Phase 1-4: 共享数据收集管线
+    // ═══════════════════════════════════════════════════════════
+    const phaseResults = await runAllPhases(projectRoot, ctx, {
+        maxFiles: 500,
+        contentMaxLines: 120,
+        sourceTag: 'bootstrap-external',
+        summaryPrefix: 'Bootstrap-external scan',
+        clearOldData: true,
+        generateReport: true,
+        incremental: true,
+    });
+    // 空项目 fast-path
+    if (phaseResults.isEmpty) {
+        return envelope({
+            success: true,
+            data: { message: 'No source files found. Nothing to bootstrap.' },
+            meta: { tool: 'autosnippet_bootstrap', responseTimeMs: Date.now() - t0 },
+        });
+    }
+    const { allFiles, primaryLang, depGraphData, langStats, astProjectSummary, codeEntityResult, callGraphResult, guardAudit, activeDimensions: dimensions, targetsSummary, langProfile, incrementalPlan, } = phaseResults;
+    // ═══════════════════════════════════════════════════════════
+    // Phase 4: 构建 Mission Briefing
+    // ═══════════════════════════════════════════════════════════
+    // 创建 BootstrapSession
+    const sessionManager = getSessionManager(ctx.container);
+    const session = sessionManager.createSession({
+        projectRoot,
+        dimensions,
+        projectContext: {
+            projectName: path.basename(projectRoot),
+            primaryLang,
+            fileCount: allFiles.length,
+            modules: depGraphData?.nodes?.length || 0,
+        },
+    });
+    // 缓存 Phase 结果供 wiki_plan 复用
+    session.setPhaseCache({
+        allFiles,
+        astProjectSummary,
+        codeEntityResult,
+        callGraphResult,
+        depGraphData,
+        guardAudit,
+        langStats,
+        primaryLang,
+        targetsSummary,
+    });
+    // 构建 projectMeta
+    const projectMeta = {
+        name: path.basename(projectRoot),
+        primaryLanguage: primaryLang,
+        secondaryLanguages: langProfile.secondary || [],
+        isMultiLang: langProfile.isMultiLang || false,
+        fileCount: allFiles.length,
+        projectType: phaseResults.discoverer.id,
+        projectRoot,
+    };
+    // 构建 Mission Briefing
+    const briefing = buildMissionBriefing({
+        projectMeta,
+        astData: astProjectSummary,
+        codeEntityResult,
+        callGraphResult,
+        depGraphData,
+        guardAudit,
+        targets: targetsSummary,
+        activeDimensions: dimensions,
+        session,
+        languageExtension: buildLanguageExtension(primaryLang), // §7.1
+        incrementalPlan,
+        languageStats: langStats,
+    });
+    // 附加 warnings
+    if (phaseResults.warnings.length > 0) {
+        briefing.meta = briefing.meta || {};
+        briefing.meta.warnings = [...(briefing.meta.warnings || []), ...phaseResults.warnings];
+    }
+    ctx.logger.info(`[BootstrapExternal] Mission Briefing ready: ${allFiles.length} files, ${dimensions.length} dims, ` +
+        `${briefing.meta?.responseSizeKB || '?'}KB — session ${session.id}`);
+    return envelope({
+        success: true,
+        data: briefing,
+        meta: { tool: 'autosnippet_bootstrap', responseTimeMs: Date.now() - t0 },
+    });
+}
+/**
+ * 获取当前 active session（供其他 handler 使用）
+ *
+ * 当指定了 sessionId 时，如果 active session 已过期但 id 匹配，
+ * 仍然返回该 session（支持新 bootstrap 创建后旧 session 的 dimension_complete 继续工作）。
+ *
+ * @param {object} container
+ * @param {string} [sessionId]
+ * @returns {import('./bootstrap/BootstrapSession.js').BootstrapSession|null}
+ */
+export function getActiveSession(container, sessionId) {
+    const mgr = getSessionManager(container);
+    const session = mgr.getSession(sessionId);
+    if (session) {
+        return session;
+    }
+    // 当指定了 sessionId 但 active session 已过期/被替换时，
+    // 尝试用 getAnySession() 恢复 — 防止正在进行的维度完成调用因新 bootstrap 而失败
+    if (sessionId) {
+        const anySession = mgr.getAnySession();
+        if (anySession && anySession.id === sessionId) {
+            return anySession;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=bootstrap-external.js.map

package/dist/lib/external/mcp/handlers/bootstrap-external.js.map

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

package/dist/lib/external/mcp/handlers/bootstrap-internal.d.ts

@@ -0,0 +1,111 @@
+/**
+ * MCP Handlers — Bootstrap 冷启动知识库初始化 (内部 Agent 路径)
+ *
+ * ⚠️ 本文件是「内部 Agent」冷启动路径 — 由 AutoSnippet 内置的 Analyst/Producer
+ *    双 Agent AI pipeline 自动完成知识提取。需要配置 AI Provider (API Key)。
+ *
+ * 调用方:
+ *   - CLI: `asd bootstrap --knowledge`
+ *   - AgentRuntime: `bootstrapKnowledgeTool` (infrastructure.js)
+ *   - Dashboard HTTP: POST /api/bootstrap/knowledge
+ *
+ * 外部 Agent 路径（Cursor/Copilot 等 IDE Agent）请参见:
+ *   - bootstrap-external.js  — 无参数 Mission Briefing 入口
+ *   - dimension-complete.js  — 维度完成通知
+ *   外部 Agent 使用 read_file/grep_search 等原生能力自行分析代码，
+ *   不经过本文件的 Phase 5 AI pipeline。
+ *
+ * 内部 Agent 架构 (v5 + Async Fill):
+ *
+ * 同步阶段（快速返回，~1-3s）:
+ *   Phase 1   → 文件收集（SPM Target 源文件扫描）
+ *   Phase 1.5 → AST 代码结构分析（Tree-sitter）
+ *   Phase 2   → SPM 依赖关系 → knowledge_edges（模块级图谱）
+ *   Phase 3   → Guard 规则审计
+ *   Phase 4   → 构建响应骨架（filesByTarget + analysisFramework + 任务清单）
+ *
+ * 异步阶段（后台逐一填充，通过 Socket.io 推送进度）:
+ *   Phase 5   → 微观维度 × 子主题提取代码特征 → 创建 N 条 Candidate（PENDING 状态）
+ *              skillWorthy 维度仅提取内容，不创建 Candidate（避免与 Skill 重复）
+ *              anti-pattern 已移除 — 代码问题由 Guard 独立处理
+ *   Phase 5.5 → 宏观维度（architecture/code-standard/project-profile/agent-guidelines）
+ *              自动聚合为 Project Skill → 写入 AutoSnippet/skills/（不产生 Candidate）
+ *
+ * 进度推送事件（Socket.io + EventBus）:
+ *   bootstrap:started        — 骨架创建完成，携带任务清单
+ *   bootstrap:task-started   — 单个维度开始填充
+ *   bootstrap:task-completed — 单个维度填充完成
+ *   bootstrap:task-failed    — 单个维度失败
+ *   bootstrap:all-completed  — 全部维度完成（前端弹出通知）
+ *
+ * 模块结构:
+ *   bootstrap.js              ← 内部 Agent 主入口 (本文件)
+ *   bootstrap-external.js     ← 外部 Agent 主入口 (Mission Briefing)
+
+ *   bootstrap/patterns.js     ← 多语言代码模式匹配（内部 Agent 专用）
+ *   bootstrap/dimensions.js   ← 7 维度知识提取器（内部 Agent 专用）
+ *   bootstrap/projectSkills.js ← Phase 5.5 Project Skill 生成（内部 Agent 专用）
+ */
+import { bootstrapRefine } from './bootstrap/refine.js';
+import type { McpContext } from './types.js';
+export { bootstrapRefine };
+interface BootstrapLogger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+interface BootstrapMcpContext extends McpContext {
+    logger: BootstrapLogger;
+}
+interface BootstrapKnowledgeArgs {
+    maxFiles?: number;
+    skipGuard?: boolean;
+    contentMaxLines?: number;
+    incremental?: boolean;
+    skipAsyncFill?: boolean;
+    loadSkills?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * bootstrapKnowledge — 一键初始化知识库 (Skill-aware)
+ *
+ * 覆盖 7 大知识维度: 项目规范、使用习惯、架构模式、代码模式、最佳实践、项目库特征、Agent开发注意事项
+ * （注意：反模式/代码问题由 Guard 独立处理，不在 Bootstrap 覆盖范围）
+ * 为每个维度自动创建 Candidate（PENDING），由内置 Analyst/Producer pipeline 分析代码。
+ *
+ * ⚠️ 本函数是内部 Agent 路径。外部 Agent 使用 bootstrap-external.js 的 Mission Briefing + dimension_complete 流程。
+ *
+ * @param {object} ctx  { container, logger }
+ * @param {object} args
+ * @param {number} [args.maxFiles=500] 最大扫描文件数
+ * @param {boolean} [args.skipGuard=false] 是否跳过 Guard 审计
+ * @param {number} [args.contentMaxLines=120] 每文件读取最大行数
+ * @param {boolean} [args.incremental=true] 是否启用增量 Bootstrap (自动检测变更, 仅重跑受影响维度)
+ */
+export declare function bootstrapKnowledge(ctx: BootstrapMcpContext, args: BootstrapKnowledgeArgs): Promise<{
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: {
+        report: import("./bootstrap/shared/bootstrap-phases.js").PhaseReport | {} | null;
+        message: string;
+    } | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+} | {
+    success: boolean;
+    errorCode: string | null;
+    message: string;
+    data: Record<string, unknown> | null;
+    meta: {
+        source?: string | undefined;
+        responseTimeMs?: number | undefined;
+        version: string;
+        tool?: string | undefined;
+    };
+}>;
+//# sourceMappingURL=bootstrap-internal.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-internal.d.ts","sourceRoot":"","sources":["../../../../../lib/external/mcp/handlers/bootstrap-internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAMH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,CAAC;AAI3B,UAAU,eAAe;IACvB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,UAAU,mBAAoB,SAAQ,UAAU;IAC9C,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAoDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;GAsX9F"}