mcp-probe-kit 3.0.6 → 3.0.8

package/README.md

@@ -13,7 +13,7 @@
 
 > **Talk is cheap, show me the Context.**
 > 
-> mcp-probe-kit is a protocol-level toolkit designed for developers who want AI to truly understand their project's intent. It's not just a collection of 21 tools—it's a context-aware system that helps AI agents grasp what you're building.
+> mcp-probe-kit is a protocol-level toolkit designed for developers who want AI to truly understand their project's intent. It's not just a collection of 22 tools—it's a context-aware system that helps AI agents grasp what you're building.
 
 **Languages**: [English](README.md) | [简体中文](i18n/README.zh-CN.md) | [日本語](i18n/README.ja-JP.md) | [한국어](i18n/README.ko-KR.md) | [Español](i18n/README.es-ES.md) | [Français](i18n/README.fr-FR.md) | [Deutsch](i18n/README.de-DE.md) | [Português (BR)](i18n/README.pt-BR.md)
 
@@ -24,7 +24,7 @@
 
 > 🚀 AI-Powered Complete Development Toolkit - Covering the Entire Development Lifecycle
 
-A powerful MCP (Model Context Protocol) server providing **21 tools** covering the complete workflow from product analysis to final release (Requirements → Design → Development → Quality → Release), all tools support **structured output**.
+A powerful MCP (Model Context Protocol) server providing **22 tools** covering the complete workflow from product analysis to final release (Requirements → Design → Development → Quality → Release), all tools support **structured output**.
 
 **🎉 v3.0 Major Update**: Streamlined tool count, focus on core competencies, eliminate choice paralysis, let AI do more native work
 
@@ -39,7 +39,7 @@ A powerful MCP (Model Context Protocol) server providing **21 tools** covering t
 **👉 [https://mcp-probe-kit.bytezonex.com](https://mcp-probe-kit.bytezonex.com/)**
 
 - [Quick Start](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html) - Setup in 5 minutes
-- [All Tools](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - Complete list of 21 tools
+- [All Tools](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - Complete list of 22 tools
 - [Best Practices](https://mcp-probe-kit.bytezonex.com/pages/examples.html) - Full development workflow guide
 - [v3.0 Migration Guide](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - Upgrade from v2.x to v3.0
 
@@ -47,20 +47,29 @@ A powerful MCP (Model Context Protocol) server providing **21 tools** covering t
 
 ## ✨ Core Features
 
-### 📦 21 Tools
+### 📦 22 Tools
 
 - **🔄 Workflow Orchestration** (6 tools) - One-click complex development workflows
   - `start_feature`, `start_bugfix`, `start_onboard`, `start_ui`, `start_product`, `start_ralph`
-- **🔍 Code Analysis** (3 tools) - Code quality and refactoring
-  - `code_review`, `fix_bug`, `refactor`
+- **🔍 Code Analysis** (4 tools) - Code quality, refactoring, and graph insight
+  - `code_review`, `code_insight`, `fix_bug`, `refactor`
 - **📝 Git Tools** (2 tools) - Git commits and work reports
   - `gencommit`, `git_work_report`
 - **⚡ Code Generation** (1 tool) - Test generation
   - `gentest`
-- **📦 Project Management** (7 tools) - Project initialization and requirements management
-  - `init_project`, `init_project_context`, `add_feature`, `estimate`, `interview`, `ask_user`
-- **🎨 UI/UX Tools** (3 tools) - Design systems and data synchronization
-  - `ui_design_system`, `ui_search`, `sync_ui_data`
+- **📦 Project Management** (6 tools) - Project initialization and requirements management
+  - `init_project`, `init_project_context`, `add_feature`, `estimate`, `interview`, `ask_user`
+- **🎨 UI/UX Tools** (3 tools) - Design systems and data synchronization
+  - `ui_design_system`, `ui_search`, `sync_ui_data`
+
+### 🧠 Code Graph Bridge (GitNexus)
+
+- `code_insight` bridges GitNexus by default for query/context/impact analysis
+- `start_feature` and `start_bugfix` automatically enrich plans with graph context when available
+- If GitNexus is unavailable, the server falls back automatically without breaking orchestration
+- Graph snapshots are exposed as resources (`probe://graph/latest`, `probe://graph/history`, `probe://graph/latest.md`)
+- Graph snapshots are also persisted to readable files in `.mcp-probe-kit/graph-snapshots` (customizable via `MCP_GRAPH_SNAPSHOT_DIR`)
+- Tool responses include `_meta.graph` with snapshot URI and local JSON/Markdown file paths
 
 ### 🎯 Structured Output
 

package/build/index.js

@@ -3,15 +3,21 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { InMemoryTaskMessageQueue, InMemoryTaskStore, } from "@modelcontextprotocol/sdk/experimental/index.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ProgressNotificationSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { initProject, gencommit, codeReview, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct, gitWorkReport } from "./tools/index.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { initProject, gencommit, codeReview, codeInsight, gentest, refactor, initProjectContext, addFeature, fixBug, estimate, startFeature, startBugfix, startOnboard, startRalph, interview, askUser, uiDesignSystem, uiSearch, syncUiData, startUi, startProduct, gitWorkReport } from "./tools/index.js";
 import { VERSION, NAME } from "./version.js";
 import { allToolSchemas } from "./schemas/index.js";
 import { filterTools, getToolsetFromEnv } from "./lib/toolset-manager.js";
 import { isAbortError, } from "./lib/tool-execution-context.js";
 const EXTENSIONS_CAPABILITY_KEY = "io.github.mybolide/extensions";
 const MAX_UI_APP_RESOURCES = 30;
+const MAX_GRAPH_SNAPSHOTS = 20;
+const DEFAULT_GRAPH_SNAPSHOT_DIR = path.resolve(process.cwd(), ".mcp-probe-kit", "graph-snapshots");
 const uiAppResources = new Map();
 const uiAppResourceOrder = [];
+const graphSnapshots = new Map();
+const graphSnapshotOrder = [];
 function isEnvEnabled(name, fallback = false) {
     const raw = process.env[name];
     if (raw === undefined) {
@@ -19,9 +25,17 @@ function isEnvEnabled(name, fallback = false) {
     }
     return /^(1|true|yes|on)$/i.test(raw.trim());
 }
+function resolveGraphSnapshotDir() {
+    const raw = process.env.MCP_GRAPH_SNAPSHOT_DIR?.trim();
+    if (!raw) {
+        return DEFAULT_GRAPH_SNAPSHOT_DIR;
+    }
+    return path.isAbsolute(raw) ? raw : path.resolve(process.cwd(), raw);
+}
 const extensionsCapabilityEnabled = isEnvEnabled("MCP_ENABLE_EXTENSIONS_CAPABILITY", false);
 const uiAppsEnabled = isEnvEnabled("MCP_ENABLE_UI_APPS", false);
 const traceMetaKey = process.env.MCP_TRACE_META_KEY || "trace";
+const graphSnapshotDir = resolveGraphSnapshotDir();
 const serverCapabilities = {
     tools: {},
     resources: {},
@@ -178,8 +192,203 @@ function withUiResourceMeta(result, resourceUri) {
         },
     };
 }
+function withGraphSnapshotMeta(result, snapshot) {
+    const currentGraphMeta = result._meta?.graph;
+    const currentGraphMetaRecord = currentGraphMeta && typeof currentGraphMeta === "object"
+        ? currentGraphMeta
+        : {};
+    return {
+        ...result,
+        _meta: {
+            ...(result._meta ?? {}),
+            graph: {
+                ...currentGraphMetaRecord,
+                snapshotUri: snapshot.uri,
+                snapshotId: snapshot.id,
+                status: snapshot.status,
+                createdAt: snapshot.createdAt,
+                jsonFilePath: snapshot.jsonFilePath ?? null,
+                markdownFilePath: snapshot.markdownFilePath ?? null,
+            },
+        },
+    };
+}
+function trimText(value, maxLen) {
+    if (value.length <= maxLen) {
+        return value;
+    }
+    return `${value.slice(0, maxLen - 3)}...`;
+}
+function toPosixPath(value) {
+    return value.replace(/\\/g, "/");
+}
+function makeSafeFileSegment(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 48) || "snapshot";
+}
+function ensureGraphSnapshotDir() {
+    if (!fs.existsSync(graphSnapshotDir)) {
+        fs.mkdirSync(graphSnapshotDir, { recursive: true });
+    }
+}
+function renderGraphSnapshotMarkdown(snapshot) {
+    return [
+        "# Graph Snapshot",
+        "",
+        `- id: ${snapshot.id}`,
+        `- tool: ${snapshot.toolName}`,
+        `- status: ${snapshot.status}`,
+        `- createdAt: ${snapshot.createdAt}`,
+        `- summary: ${snapshot.summary}`,
+        "",
+        "## Payload",
+        "```json",
+        JSON.stringify(snapshot.payload, null, 2),
+        "```",
+        "",
+    ].join("\n");
+}
+function persistGraphSnapshot(snapshot) {
+    try {
+        ensureGraphSnapshotDir();
+        const safeTool = makeSafeFileSegment(snapshot.toolName);
+        const baseName = `${snapshot.id}-${safeTool}`;
+        const jsonPath = path.join(graphSnapshotDir, `${baseName}.json`);
+        const markdownPath = path.join(graphSnapshotDir, `${baseName}.md`);
+        const jsonText = JSON.stringify({
+            id: snapshot.id,
+            uri: snapshot.uri,
+            toolName: snapshot.toolName,
+            createdAt: snapshot.createdAt,
+            status: snapshot.status,
+            summary: snapshot.summary,
+            payload: snapshot.payload,
+        }, null, 2);
+        fs.writeFileSync(jsonPath, jsonText, "utf-8");
+        fs.writeFileSync(markdownPath, renderGraphSnapshotMarkdown(snapshot), "utf-8");
+        return {
+            ...snapshot,
+            jsonFilePath: toPosixPath(jsonPath),
+            markdownFilePath: toPosixPath(markdownPath),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[MCP Probe Kit] graph snapshot persist failed: ${message}`);
+        return snapshot;
+    }
+}
+function sanitizeGraphPayload(payload) {
+    if (!payload || typeof payload !== "object") {
+        return payload;
+    }
+    if (Array.isArray(payload)) {
+        return payload.slice(0, 20).map((item) => sanitizeGraphPayload(item));
+    }
+    const record = payload;
+    const next = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (typeof value === "string") {
+            next[key] = trimText(value, 6000);
+            continue;
+        }
+        if (key === "executions" && Array.isArray(value)) {
+            next[key] = value.slice(0, 8).map((item) => {
+                if (!item || typeof item !== "object") {
+                    return item;
+                }
+                const exec = item;
+                return {
+                    ...exec,
+                    text: typeof exec.text === "string" ? trimText(exec.text, 6000) : exec.text,
+                };
+            });
+            continue;
+        }
+        next[key] = sanitizeGraphPayload(value);
+    }
+    return next;
+}
+function readGraphPayload(toolName, result) {
+    if (result.isError) {
+        return null;
+    }
+    if (toolName === "code_insight" && result.structuredContent && typeof result.structuredContent === "object") {
+        const structured = result.structuredContent;
+        const status = typeof structured.status === "string" ? structured.status : "ok";
+        const summary = typeof structured.summary === "string"
+            ? structured.summary
+            : "code_insight 图谱结果";
+        return {
+            status,
+            summary,
+            payload: sanitizeGraphPayload(structured),
+        };
+    }
+    if ((toolName === "start_feature" || toolName === "start_bugfix")
+        && result.structuredContent
+        && typeof result.structuredContent === "object") {
+        const structured = result.structuredContent;
+        const metadata = structured.metadata;
+        if (!metadata || typeof metadata !== "object") {
+            return null;
+        }
+        const graphContext = metadata.graphContext;
+        if (!graphContext || typeof graphContext !== "object") {
+            return null;
+        }
+        const graphRecord = graphContext;
+        const status = graphRecord.available === false ? "degraded" : "ok";
+        const summary = typeof graphRecord.summary === "string"
+            ? graphRecord.summary
+            : `${toolName} 图谱上下文`;
+        return {
+            status,
+            summary,
+            payload: sanitizeGraphPayload({
+                graphContext,
+                plan: metadata.plan ?? null,
+            }),
+        };
+    }
+    return null;
+}
+function rememberGraphSnapshot(toolName, result) {
+    const graph = readGraphPayload(toolName, result);
+    if (!graph) {
+        return null;
+    }
+    const id = `${Date.now()}-${Math.random().toString(16).slice(2, 8)}`;
+    const uri = `probe://graph/${id}`;
+    const snapshot = persistGraphSnapshot({
+        id,
+        uri,
+        toolName,
+        createdAt: new Date().toISOString(),
+        status: graph.status,
+        summary: graph.summary,
+        payload: graph.payload,
+    });
+    graphSnapshots.set(id, snapshot);
+    graphSnapshotOrder.push(id);
+    while (graphSnapshotOrder.length > MAX_GRAPH_SNAPSHOTS) {
+        const oldest = graphSnapshotOrder.shift();
+        if (oldest) {
+            graphSnapshots.delete(oldest);
+        }
+    }
+    return snapshot;
+}
 function decorateResult(toolName, args, raw, traceMeta) {
     let result = withTraceMeta(raw, traceMeta);
+    const snapshot = rememberGraphSnapshot(toolName, result);
+    if (snapshot) {
+        result = withGraphSnapshotMeta(result, snapshot);
+    }
     if (uiAppsEnabled && isUiTool(toolName) && !result.isError) {
         const resourceUri = putUiAppResource(toolName, args, result);
         result = withUiResourceMeta(result, resourceUri);
@@ -212,6 +421,8 @@ async function executeTool(name, args, context) {
             return await gencommit(args);
         case "code_review":
             return await codeReview(args);
+        case "code_insight":
+            return await codeInsight(args, context);
         case "gentest":
             return await gentest(args);
         case "refactor":
@@ -424,7 +635,43 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
             description: "MCP Probe Kit 服务器当前状态",
             mimeType: "application/json",
         },
+        {
+            uri: "probe://graph/latest",
+            name: "图谱快照（最新）",
+            description: "最近一次 code_insight 或 start_* 生成的图谱快照",
+            mimeType: "application/json",
+        },
+        {
+            uri: "probe://graph/history",
+            name: "图谱快照（历史）",
+            description: `最近 ${graphSnapshotOrder.length} 条图谱快照摘要`,
+            mimeType: "application/json",
+        },
+        {
+            uri: "probe://graph/latest.md",
+            name: "图谱快照（最新 Markdown）",
+            description: "最近一次图谱快照的 Markdown 视图",
+            mimeType: "text/markdown",
+        },
+        {
+            uri: "probe://graph/files",
+            name: "图谱快照（文件索引）",
+            description: `图谱快照落盘目录: ${toPosixPath(graphSnapshotDir)}`,
+            mimeType: "application/json",
+        },
     ];
+    for (const id of graphSnapshotOrder.slice().reverse().slice(0, 10)) {
+        const snapshot = graphSnapshots.get(id);
+        if (!snapshot) {
+            continue;
+        }
+        resources.push({
+            uri: snapshot.uri,
+            name: `图谱快照 · ${snapshot.toolName}`,
+            description: `${snapshot.status} · ${trimText(snapshot.summary, 120)} (${snapshot.createdAt})`,
+            mimeType: "application/json",
+        });
+    }
     if (uiAppsEnabled) {
         for (const uri of uiAppResourceOrder.slice().reverse()) {
             const entry = uiAppResources.get(uri);
@@ -470,6 +717,30 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
                             createMessageStream: typeof server.experimental.tasks.createMessageStream === "function",
                             elicitInputStream: typeof server.experimental.tasks.elicitInputStream === "function",
                         },
+                        graphSnapshots: {
+                            count: graphSnapshotOrder.length,
+                            snapshotDir: toPosixPath(graphSnapshotDir),
+                            latest: (() => {
+                                const latestId = graphSnapshotOrder[graphSnapshotOrder.length - 1];
+                                if (!latestId) {
+                                    return null;
+                                }
+                                const latest = graphSnapshots.get(latestId);
+                                if (!latest) {
+                                    return null;
+                                }
+                                return {
+                                    id: latest.id,
+                                    uri: latest.uri,
+                                    toolName: latest.toolName,
+                                    status: latest.status,
+                                    summary: trimText(latest.summary, 140),
+                                    createdAt: latest.createdAt,
+                                    jsonFilePath: latest.jsonFilePath ?? null,
+                                    markdownFilePath: latest.markdownFilePath ?? null,
+                                };
+                            })(),
+                        },
                         toolCount: allToolSchemas.length,
                     }, null, 2),
                 },
@@ -491,6 +762,175 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
             ],
         };
     }
+    if (uri === "probe://graph/latest") {
+        const latestId = graphSnapshotOrder[graphSnapshotOrder.length - 1];
+        if (!latestId) {
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "application/json",
+                        text: JSON.stringify({
+                            status: "empty",
+                            message: "暂无图谱快照，请先调用 code_insight 或 start_feature/start_bugfix。",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        const snapshot = graphSnapshots.get(latestId);
+        if (!snapshot) {
+            throw new Error(`图谱快照不存在: ${latestId}`);
+        }
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        id: snapshot.id,
+                        uri: snapshot.uri,
+                        toolName: snapshot.toolName,
+                        createdAt: snapshot.createdAt,
+                        status: snapshot.status,
+                        summary: snapshot.summary,
+                        payload: snapshot.payload,
+                        files: {
+                            json: snapshot.jsonFilePath ?? null,
+                            markdown: snapshot.markdownFilePath ?? null,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    if (uri === "probe://graph/latest.md") {
+        const latestId = graphSnapshotOrder[graphSnapshotOrder.length - 1];
+        if (!latestId) {
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "text/markdown",
+                        text: "# Graph Snapshot\n\n暂无图谱快照，请先调用 code_insight 或 start_feature/start_bugfix。",
+                    },
+                ],
+            };
+        }
+        const snapshot = graphSnapshots.get(latestId);
+        if (!snapshot) {
+            throw new Error(`图谱快照不存在: ${latestId}`);
+        }
+        const markdown = snapshot.markdownFilePath && fs.existsSync(snapshot.markdownFilePath)
+            ? fs.readFileSync(snapshot.markdownFilePath, "utf-8")
+            : renderGraphSnapshotMarkdown(snapshot);
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "text/markdown",
+                    text: markdown,
+                },
+            ],
+        };
+    }
+    if (uri === "probe://graph/history") {
+        const history = graphSnapshotOrder
+            .slice()
+            .reverse()
+            .map((id) => graphSnapshots.get(id))
+            .filter((item) => Boolean(item))
+            .map((item) => ({
+            id: item.id,
+            uri: item.uri,
+            toolName: item.toolName,
+            createdAt: item.createdAt,
+            status: item.status,
+            summary: trimText(item.summary, 200),
+            files: {
+                json: item.jsonFilePath ?? null,
+                markdown: item.markdownFilePath ?? null,
+            },
+        }));
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        count: history.length,
+                        items: history,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    if (uri === "probe://graph/files") {
+        const latestId = graphSnapshotOrder[graphSnapshotOrder.length - 1];
+        const latest = latestId ? graphSnapshots.get(latestId) ?? null : null;
+        const hasDir = fs.existsSync(graphSnapshotDir);
+        const files = hasDir
+            ? fs
+                .readdirSync(graphSnapshotDir, { withFileTypes: true })
+                .filter((entry) => entry.isFile() && /\.(json|md)$/i.test(entry.name))
+                .map((entry) => toPosixPath(path.join(graphSnapshotDir, entry.name)))
+                .sort((a, b) => b.localeCompare(a))
+                .slice(0, 40)
+            : [];
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        snapshotDir: toPosixPath(graphSnapshotDir),
+                        exists: hasDir,
+                        latest: latest
+                            ? {
+                                id: latest.id,
+                                uri: latest.uri,
+                                toolName: latest.toolName,
+                                jsonFilePath: latest.jsonFilePath ?? null,
+                                markdownFilePath: latest.markdownFilePath ?? null,
+                            }
+                            : null,
+                        files,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    if (uri.startsWith("probe://graph/")) {
+        const id = uri.slice("probe://graph/".length);
+        if (!id || id === "latest" || id === "history" || id === "files" || id === "latest.md") {
+            throw new Error(`未知图谱资源: ${uri}`);
+        }
+        const snapshot = graphSnapshots.get(id);
+        if (!snapshot) {
+            throw new Error(`图谱快照不存在: ${id}`);
+        }
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        id: snapshot.id,
+                        uri: snapshot.uri,
+                        toolName: snapshot.toolName,
+                        createdAt: snapshot.createdAt,
+                        status: snapshot.status,
+                        summary: snapshot.summary,
+                        payload: snapshot.payload,
+                        files: {
+                            json: snapshot.jsonFilePath ?? null,
+                            markdown: snapshot.markdownFilePath ?? null,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
     throw new Error(`未知资源: ${uri}`);
 });
 // 启动服务器

package/build/lib/gitnexus-bridge.d.ts

@@ -0,0 +1,58 @@
+export type CodeInsightMode = "auto" | "query" | "context" | "impact";
+export type CodeInsightDirection = "upstream" | "downstream";
+export interface CodeInsightRequest {
+    mode?: CodeInsightMode;
+    query?: string;
+    target?: string;
+    repo?: string;
+    goal?: string;
+    taskContext?: string;
+    direction?: CodeInsightDirection;
+    maxDepth?: number;
+    includeTests?: boolean;
+    signal?: AbortSignal;
+}
+export interface CodeInsightExecution {
+    tool: string;
+    ok: boolean;
+    durationMs: number;
+    args: Record<string, unknown>;
+    text?: string;
+    structuredContent?: unknown;
+    error?: string;
+}
+export interface CodeInsightBridgeResult {
+    provider: "gitnexus";
+    enabled: boolean;
+    available: boolean;
+    degraded: boolean;
+    modeRequested: CodeInsightMode;
+    modeResolved: "query" | "context" | "impact";
+    summary: string;
+    executions: CodeInsightExecution[];
+    warnings: string[];
+    repo?: string;
+}
+export interface EmbeddedGraphContext {
+    enabled: boolean;
+    available: boolean;
+    degraded: boolean;
+    summary: string;
+    warnings: string[];
+    provider: "gitnexus";
+    mode: "query" | "context" | "impact";
+    highlights: string[];
+}
+export declare function runCodeInsightBridge(request: CodeInsightRequest): Promise<CodeInsightBridgeResult>;
+export declare function buildFeatureGraphContext(input: {
+    featureName: string;
+    description: string;
+    signal?: AbortSignal;
+    repo?: string;
+}): Promise<EmbeddedGraphContext>;
+export declare function buildBugfixGraphContext(input: {
+    errorMessage: string;
+    stackTrace?: string;
+    signal?: AbortSignal;
+    repo?: string;
+}): Promise<EmbeddedGraphContext>;