d365fo-mcp 1.0.0

package/dist/server/transport.js

@@ -0,0 +1,391 @@
+/**
+ * Custom HTTP Transport for MCP over Azure Web Service.
+ * Uses direct JSON responses (not SSE streaming) for Azure orchestrator compatibility.
+ */
+import { apiRateLimiter } from '../middleware/rateLimiter.js';
+import { getConfigManager } from '../utils/configManager.js';
+import { buildProgressMessage } from '../utils/toolProgressMessage.js';
+/**
+ * Per-request timeout for the HTTP transport (ms). Default 120s stays well below
+ * Azure's 230s request limit while allowing for slower SMB-backed SQLite I/O.
+ */
+const TOOL_TIMEOUT_MS = Math.max(10_000, parseInt(process.env.MCP_TOOL_TIMEOUT_MS || '120000', 10) || 120_000);
+/**
+ * Per-tool timeout classes so fast tools don't wait out a hung call's full
+ * timeout and heavy tools (build/db-sync/systest) aren't killed prematurely.
+ * All values can be overridden via env.
+ */
+const TOOL_TIMEOUT_FAST_MS = Math.max(5_000, parseInt(process.env.MCP_TOOL_TIMEOUT_FAST_MS || '30000', 10) || 30_000);
+const TOOL_TIMEOUT_HEAVY_MS = Math.max(60_000, parseInt(process.env.MCP_TOOL_TIMEOUT_HEAVY_MS || '600000', 10) || 600_000);
+const HEAVY_TOOLS = new Set([
+    'build_d365fo_project',
+    'trigger_db_sync',
+    'run_bp_check',
+    'run_systest_class',
+    'update_symbol_index',
+]);
+const FAST_TOOLS = new Set([
+    'search', 'batch_get_info',
+    'get_object_info',
+    'get_method',
+    'extension_info', 'security_info',
+    // `labels` excluded: write actions (create/rename) can scan many files.
+]);
+function resolveToolTimeout(toolName) {
+    if (!toolName)
+        return TOOL_TIMEOUT_MS;
+    if (HEAVY_TOOLS.has(toolName))
+        return TOOL_TIMEOUT_HEAVY_MS;
+    if (FAST_TOOLS.has(toolName))
+        return TOOL_TIMEOUT_FAST_MS;
+    return TOOL_TIMEOUT_MS;
+}
+/**
+ * Extract workspace folder path from GitHub Copilot MCP request (HTTP headers or
+ * params._meta). Returns a local file-system path (converts file:// URI → path).
+ */
+function extractWorkspaceFromRequest(req, requestBody) {
+    const headerCandidates = [
+        req.headers['x-vscode-workspace-folder-uris'],
+        req.headers['x-vscode-workspace-folder'],
+        req.headers['x-github-copilot-workspace'],
+        req.headers['x-workspace-folder'],
+        req.headers['x-workspace'],
+    ];
+    for (const h of headerCandidates) {
+        const val = Array.isArray(h) ? h[0] : h;
+        if (val) {
+            const path = fileUriToPath(val.split(',')[0].trim());
+            if (path)
+                return path;
+        }
+    }
+    const meta = requestBody.params?._meta;
+    if (meta) {
+        for (const key of ['workspaceFolders', 'workspaceFolderUris', 'roots']) {
+            const val = meta[key];
+            if (Array.isArray(val) && val.length > 0) {
+                const first = typeof val[0] === 'string' ? val[0] : val[0]?.uri;
+                const path = fileUriToPath(first);
+                if (path)
+                    return path;
+            }
+        }
+        for (const key of ['workspaceFolderUri', 'workspaceFolder', 'workspacePath']) {
+            const val = meta[key];
+            if (typeof val === 'string') {
+                const path = fileUriToPath(val);
+                if (path)
+                    return path;
+            }
+        }
+    }
+    return null;
+}
+/** Convert file:// URI to a local path, or return the string as-is if not a URI */
+function fileUriToPath(uri) {
+    if (!uri)
+        return null;
+    if (uri.startsWith('file:///')) {
+        const decoded = decodeURIComponent(uri.slice('file:///'.length));
+        if (process.platform === 'win32') {
+            // file:///K:/VSProjects/... → K:\VSProjects\...
+            return decoded.replace(/\//g, '\\');
+        }
+        // POSIX: file:///home/user/proj → /home/user/proj
+        return '/' + decoded;
+    }
+    if (uri.startsWith('file://')) {
+        const decoded = decodeURIComponent(uri.slice('file://'.length));
+        return process.platform === 'win32' ? decoded.replace(/\//g, '\\') : decoded;
+    }
+    // Already a local path — Windows drive letter or UNC, or POSIX absolute
+    if (uri.length > 2 && (uri[1] === ':' || uri.startsWith('\\\\') || uri.startsWith('/'))) {
+        return uri;
+    }
+    return null;
+}
+export class CustomHttpTransport {
+    server;
+    app;
+    context;
+    pendingRequests = new Map();
+    // Transport interface properties
+    onmessage;
+    onerror;
+    onclose;
+    constructor(server, app, context) {
+        this.server = server;
+        this.app = app;
+        this.context = context;
+        this.setupRoutes();
+        // Connect server immediately (must be done before handling requests)
+        this.connectServer().catch(err => {
+            process.stderr.write(`Failed to connect server: ${err}\n`);
+        });
+    }
+    /**
+     * Connects MCP server to this transport
+     * CRITICAL: Must be called for proper protocol lifecycle and completion signaling
+     */
+    async connectServer() {
+        await this.server.connect(this);
+    }
+    // Transport interface methods
+    async start() {
+        // HTTP transport doesn't need explicit start
+    }
+    async close() {
+        // Reject all in-flight promises so their awaiting callers fail fast
+        // instead of hanging until the per-request timeout fires.
+        const err = new Error('Transport closed');
+        for (const { reject } of this.pendingRequests.values()) {
+            reject(err);
+        }
+        this.pendingRequests.clear();
+    }
+    async send(message) {
+        // Route response to the correct pending request by id
+        if ('id' in message && message.id !== undefined && message.id !== null) {
+            const pending = this.pendingRequests.get(message.id);
+            if (pending) {
+                pending.resolve(message);
+                this.pendingRequests.delete(message.id);
+                return;
+            }
+        }
+        // Notifications / server-initiated messages with no id — nothing to route
+    }
+    setupRoutes() {
+        // Apply rate limiting
+        this.app.use('/mcp', apiRateLimiter);
+        // MCP endpoint - direct JSON-RPC
+        this.app.post('/mcp', async (req, res) => {
+            // Declare here so the catch block can clean it up regardless of where an error fires
+            let internalId;
+            try {
+                // Set response headers (keep-alive enabled for performance)
+                res.setHeader('Content-Type', 'application/json');
+                const request = req.body;
+                // Extract GitHub Copilot workspace path for per-request isolation.
+                // We no longer mutate the global ConfigManager singleton — instead both
+                // onmessage call-sites below run inside runWithRequestContext so concurrent
+                // requests from different users never bleed their workspacePath through
+                // the shared runtimeContext.
+                const workspacePath = extractWorkspaceFromRequest(req, request);
+                const requestCtx = workspacePath ? { workspacePath } : {};
+                if (!request.jsonrpc || !request.method) {
+                    res.status(400).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32600,
+                            message: 'Invalid Request: missing jsonrpc or method',
+                        },
+                        id: null,
+                    });
+                    return;
+                }
+                // Handle notifications (no response expected)
+                if (!('id' in request)) {
+                    // Handle special notifications
+                    if (request.method === 'notifications/cancelled' ||
+                        request.method === 'cancelled') {
+                        // A cancelled notification does NOT close the transport.
+                        // It signals that a specific in-flight request was cancelled by the client,
+                        // but the HTTP connection (per-request) is already done.  Simply acknowledge.
+                        res.status(202).json({ status: 'accepted' });
+                        return;
+                    }
+                    if (request.method === 'shutdown') {
+                        // In HTTP mode each request is independent — there is no persistent connection
+                        // to tear down.  Calling onclose() here would stop the entire server for ALL
+                        // concurrent users, which is wrong.  Acknowledge and do nothing else.
+                        res.status(202).json({ status: 'accepted', completed: true });
+                        return;
+                    }
+                    if (this.onmessage) {
+                        // Notifications don't need response routing, but they DO need the correct
+                        // per-request workspacePath context so tool dispatch is consistent.
+                        getConfigManager().runWithRequestContext(requestCtx, () => {
+                            this.onmessage(request);
+                            return Promise.resolve();
+                        }).catch(() => { });
+                    }
+                    res.status(202).json({ status: 'accepted' });
+                    return;
+                }
+                // Handle requests - send to MCP server via onmessage
+                // Wait for response via Promise
+                if (this.onmessage) {
+                    // MCP capability-probe methods that always return "Method not found" — log silently
+                    const SILENT_PROBES = new Set([
+                        'resources/templates/list',
+                        'resources/list',
+                        'prompts/list',
+                        'logging/setLevel',
+                        'completion/complete',
+                    ]);
+                    const isSilentProbe = SILENT_PROBES.has(request.method);
+                    // Log incoming request (skip silent probes)
+                    const toolName = request.params?.name || request.method;
+                    const args = request.params?.arguments;
+                    const argsSummary = args ? ` (${Object.keys(args).join(', ')})` : '';
+                    // Short request ID tag for disambiguating concurrent requests in the log
+                    const reqId = String(request.id).slice(-4);
+                    const tag = `[${reqId}]`;
+                    if (!isSilentProbe) {
+                        process.stdout.write(`\n→ ${tag} ${toolName}${argsSummary}\n`);
+                    }
+                    const responsePromise = new Promise((resolve, reject) => {
+                        // Use a unique internal key so concurrent requests from different clients
+                        // with identical JSON-RPC ids (e.g. both sending id=1) never collide.
+                        // We swap the request.id to this unique key before handing it to the MCP
+                        // server, so the response comes back with the same unique key and we can
+                        // route it back to the correct resolver. The original client id is restored
+                        // in the response before it is sent to the HTTP client.
+                        internalId = `__t_${Date.now()}_${Math.random().toString(36).slice(2)}`;
+                        const originalId = request.id;
+                        request.id = internalId;
+                        // Resolve the timeout class for this specific tool call so slow tools
+                        // (build / db-sync) aren't killed and fast tools don't starve the slot
+                        // for the full global ceiling.
+                        const perToolTimeoutMs = resolveToolTimeout(toolName);
+                        const timeoutId = setTimeout(() => {
+                            if (this.pendingRequests.has(internalId)) {
+                                this.pendingRequests.delete(internalId);
+                                request.id = originalId; // restore on timeout
+                                process.stderr.write(`← ${tag} ⏱️ ${toolName} timed out after ${perToolTimeoutMs / 1000}s\n`);
+                                reject(new Error(`Request timeout: ${toolName} did not complete within ${perToolTimeoutMs / 1000}s`));
+                            }
+                        }, perToolTimeoutMs);
+                        this.pendingRequests.set(internalId, {
+                            resolve: (message) => {
+                                clearTimeout(timeoutId);
+                                // Restore the original client id before resolving
+                                if ('id' in message)
+                                    message.id = originalId;
+                                resolve(message);
+                            },
+                            reject: (err) => {
+                                clearTimeout(timeoutId);
+                                request.id = originalId;
+                                reject(err);
+                            },
+                        });
+                    });
+                    // Send request to MCP server and await response — both inside the
+                    // per-request AsyncLocalStorage context so tool handlers see the correct
+                    // workspacePath for this specific user's request.
+                    const response = await getConfigManager().runWithRequestContext(requestCtx, async () => {
+                        this.onmessage(request);
+                        return await responsePromise;
+                    });
+                    // In HTTP mode the server cannot push notifications before a response
+                    // (request-response only — no SSE). As a workaround we prepend the same
+                    // progress description as the first line of the tool result so the user
+                    // can see what was processed when expanding the "ran <tool>" detail in VS2026.
+                    if (!isSilentProbe && 'result' in response) {
+                        const progressText = buildProgressMessage(toolName, args);
+                        const result = response.result;
+                        const resultContent = result?.content;
+                        if (Array.isArray(resultContent) && resultContent.length > 0) {
+                            const first = resultContent[0];
+                            if (first?.type === 'text' && typeof first.text === 'string') {
+                                // Clone instead of mutating in place: the result object may be
+                                // the same instance stored in the dedup cache — mutating it
+                                // would bake the progress line into the cached copy and every
+                                // dedup hit would then render the line twice.
+                                response.result = {
+                                    ...result,
+                                    content: [
+                                        { ...first, text: `${progressText}\n\n${first.text}` },
+                                        ...resultContent.slice(1),
+                                    ],
+                                };
+                            }
+                        }
+                    }
+                    // Log response (skip silent probes)
+                    if (!isSilentProbe) {
+                        if ('result' in response) {
+                            const content = response.result?.content?.[0]?.text;
+                            const isError = response.result?.isError === true;
+                            if (content) {
+                                const lines = content.split('\n').filter((l) => l.trim());
+                                if (isError) {
+                                    // For errors show up to 4 lines so type-mismatch hints are visible
+                                    const preview = lines.slice(0, 4).map((l) => l.substring(0, 100)).join(' | ');
+                                    process.stdout.write(`← ${tag} ❌ ${preview}\n`);
+                                }
+                                else {
+                                    const firstLine = lines[0].substring(0, 100);
+                                    // For file-creation tools also append the path/warning line so it's visible
+                                    const extraLine = lines.find((l) => l.startsWith('📁 Path:') || l.startsWith('⚠️ addToProject'));
+                                    const extra = extraLine ? ` | ${extraLine.substring(0, 100)}` : '';
+                                    process.stdout.write(`← ${tag} ${firstLine}${extra}\n`);
+                                }
+                            }
+                            else {
+                                process.stdout.write(`← ${tag} ✓ Success\n`);
+                            }
+                        }
+                        else if ('error' in response) {
+                            const errorMsg = response.error?.message || 'Unknown error';
+                            process.stdout.write(`← ${tag} ❌ ${errorMsg.substring(0, 100)}\n`);
+                        }
+                    }
+                    // Send JSON response and explicitly close to signal completion
+                    res.status(200)
+                        .setHeader('Content-Type', 'application/json')
+                        .send(JSON.stringify(response))
+                        .end();
+                }
+                else {
+                    res.status(500).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32603,
+                            message: 'Transport not connected',
+                        },
+                        id: request.id,
+                    });
+                }
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                process.stderr.write(`← Transport error: ${errorMsg}\n`);
+                // Clean up the pending request using internalId (the Map key after the id swap)
+                if (internalId) {
+                    this.pendingRequests.delete(internalId);
+                }
+                if (!res.headersSent) {
+                    // Use the original request id so the client can correlate this error.
+                    // request is block-scoped inside try, so fall back to req.body.
+                    const reqId = req.body?.id ?? null;
+                    res.status(500).json({
+                        jsonrpc: '2.0',
+                        error: {
+                            code: -32603,
+                            message: error instanceof Error ? error.message : 'Internal error',
+                        },
+                        id: reqId,
+                    });
+                }
+            }
+        });
+        // Health check
+        this.app.get('/health', (_req, res) => {
+            res.json({
+                status: 'healthy',
+                timestamp: new Date().toISOString(),
+                // Cached-only: a health probe must never trigger a 30-60 s COUNT scan.
+                symbols: this.context.symbolIndex.getCachedSymbolCounts()?.total ?? 0,
+            });
+        });
+    }
+}
+// Factory function
+export function createStreamableHttpTransport(server, app, context) {
+    return new CustomHttpTransport(server, app, context);
+}
+//# sourceMappingURL=transport.js.map

package/dist/server/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/server/transport.ts"],"names":[],"mappings":"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"}

package/dist/tools/analyzeCode.d.ts

@@ -0,0 +1,17 @@
+/**
+ * analyze_code Tool — unified "learn from the existing codebase" entry point.
+ *
+ * Replaces four analysis tools with one discriminated by `mode`:
+ *   • patterns        → common classes/methods/dependencies for a scenario
+ *   • implementations → real implementations of a similar method
+ *   • completeness    → missing standard methods on a class
+ *   • api-usage       → how an API is initialized and called
+ *
+ * Handler files stay where they are — only the MCP surface is consolidated.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare const ANALYZE_MODES: readonly ['patterns', 'implementations', 'completeness', 'api-usage'];
+export type AnalyzeMode = (typeof ANALYZE_MODES)[number];
+export declare function analyzeCodeTool(request: CallToolRequest, context: XppServerContext): Promise<any>;
+//# sourceMappingURL=analyzeCode.d.ts.map

package/dist/tools/analyzeCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeCode.d.ts","sourceRoot":"","sources":["../../src/tools/analyzeCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,eAAO,MAAM,aAAa,YAAI,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AACnG,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAoBzD,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,gBAiCxF"}

package/dist/tools/analyzeCode.js

@@ -0,0 +1,63 @@
+/**
+ * analyze_code Tool — unified "learn from the existing codebase" entry point.
+ *
+ * Replaces four analysis tools with one discriminated by `mode`:
+ *   • patterns        → common classes/methods/dependencies for a scenario
+ *   • implementations → real implementations of a similar method
+ *   • completeness    → missing standard methods on a class
+ *   • api-usage       → how an API is initialized and called
+ *
+ * Handler files stay where they are — only the MCP surface is consolidated.
+ */
+import { z } from 'zod';
+import { analyzeCodePatternsTool } from './analyzePatterns.js';
+import { suggestMethodImplementationTool } from './suggestImplementation.js';
+import { analyzeClassCompletenessTool } from './analyzeCompleteness.js';
+import { getApiUsagePatternsTool } from './apiUsagePatterns.js';
+export const ANALYZE_MODES = ['patterns', 'implementations', 'completeness', 'api-usage'];
+const ANALYZE_DISPATCH = {
+    patterns: { tool: analyzeCodePatternsTool, toolName: 'analyze_code_patterns' },
+    implementations: { tool: suggestMethodImplementationTool, toolName: 'suggest_method_implementation' },
+    completeness: { tool: analyzeClassCompletenessTool, toolName: 'analyze_class_completeness' },
+    'api-usage': { tool: getApiUsagePatternsTool, toolName: 'get_api_usage_patterns' },
+};
+const AnalyzeCodeArgsSchema = z
+    .object({
+    mode: z.enum(ANALYZE_MODES).describe('patterns (scenario → common classes/methods), implementations (className+methodName → real examples), ' +
+        'completeness (className → missing standard methods), api-usage (apiName → init/call patterns).'),
+})
+    .passthrough();
+export async function analyzeCodeTool(request, context) {
+    const parsed = AnalyzeCodeArgsSchema.safeParse(request.params.arguments ?? {});
+    if (!parsed.success) {
+        return {
+            content: [{ type: 'text', text: `❌ analyze_code: invalid arguments — ${parsed.error.message}` }],
+            isError: true,
+        };
+    }
+    const { mode, ...rest } = parsed.data;
+    // api-usage accepts className/class/api as aliases for apiName since the "API" is often a class.
+    if (mode === 'api-usage') {
+        const r = rest;
+        if (r.apiName === undefined) {
+            const alt = r.className ?? r.class ?? r.api;
+            if (typeof alt === 'string')
+                r.apiName = alt;
+        }
+    }
+    const dispatch = ANALYZE_DISPATCH[mode];
+    if (!dispatch) {
+        return {
+            content: [{ type: 'text', text: `❌ analyze_code: unsupported mode "${mode}".` }],
+            isError: true,
+        };
+    }
+    const subRequest = {
+        method: 'tools/call',
+        params: { name: dispatch.toolName, arguments: rest },
+    };
+    return dispatch.tool(subRequest, context);
+}
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts — the single source of truth for tool instructions.
+//# sourceMappingURL=analyzeCode.js.map

package/dist/tools/analyzeCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeCode.js","sourceRoot":"","sources":["../../src/tools/analyzeCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAKnG,MAAM,gBAAgB,GAAiE;IACrF,QAAQ,EAAS,EAAE,IAAI,EAAE,uBAAuB,EAAS,QAAQ,EAAE,uBAAuB,EAAE;IAC5F,eAAe,EAAE,EAAE,IAAI,EAAE,+BAA+B,EAAE,QAAQ,EAAE,+BAA+B,EAAE;IACrG,YAAY,EAAK,EAAE,IAAI,EAAE,4BAA4B,EAAK,QAAQ,EAAE,4BAA4B,EAAE;IAClG,WAAW,EAAM,EAAE,IAAI,EAAE,uBAAuB,EAAU,QAAQ,EAAE,wBAAwB,EAAE;CAC/F,CAAC;AAEF,MAAM,qBAAqB,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,CAClC,wGAAwG;QACxG,gGAAgG,CACjG;CACF,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB,EAAE,OAAyB;IACvF,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,uCAAuC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChG,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAEtC,iGAAiG;IACjG,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC;YAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAmB,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qCAAqC,IAAI,IAAI,EAAE,CAAC;YAChF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAoB;QAClC,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;KACrD,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,qEAAqE;AACrE,8EAA8E"}

package/dist/tools/analyzeCompleteness.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Class Completeness Analysis Tool
+ * Analyze class and suggest missing methods based on patterns
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare function analyzeClassCompletenessTool(request: CallToolRequest, context: XppServerContext): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    isError?: undefined;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=analyzeCompleteness.d.ts.map

package/dist/tools/analyzeCompleteness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeCompleteness.d.ts","sourceRoot":"","sources":["../../src/tools/analyzeCompleteness.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;;;;;GA2CrG"}

package/dist/tools/analyzeCompleteness.js

@@ -0,0 +1,103 @@
+/**
+ * Class Completeness Analysis Tool
+ * Analyze class and suggest missing methods based on patterns
+ */
+import { z } from 'zod';
+const AnalyzeClassCompletenessArgsSchema = z.object({
+    className: z.string().describe('Name of the class to analyze'),
+});
+export async function analyzeClassCompletenessTool(request, context) {
+    try {
+        const args = AnalyzeClassCompletenessArgsSchema.parse(request.params.arguments);
+        const { symbolIndex } = context;
+        const classSymbol = symbolIndex.getSymbolByName(args.className, 'class');
+        if (!classSymbol) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Class "${args.className}" not found in the index.\n\n` +
+                            `**Suggestions:**\n` +
+                            `- Check spelling of the class name\n` +
+                            `- Use \`search\` tool to find the correct name\n` +
+                            `- Ensure metadata has been extracted for this model`
+                    }],
+                isError: true
+            };
+        }
+        const existingMethods = symbolIndex.getClassMethods(args.className);
+        const suggestedMethods = symbolIndex.suggestMissingMethods(args.className);
+        const analysis = {
+            existingMethods,
+            suggestedMethods
+        };
+        const formatted = formatAnalysis(analysis, classSymbol);
+        return {
+            content: [{ type: 'text', text: formatted }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error analyzing class completeness: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                }],
+            isError: true,
+        };
+    }
+}
+function formatAnalysis(analysis, classSymbol) {
+    const { existingMethods, suggestedMethods } = analysis;
+    let output = `# Class Completeness Analysis\n\n`;
+    output += `**Class:** ${classSymbol.name}\n`;
+    output += `**Model:** ${classSymbol.model}\n`;
+    output += `**Pattern Type:** ${classSymbol.patternType || 'Unknown'}\n`;
+    output += `**Existing Methods:** ${existingMethods.length}\n\n`;
+    if (existingMethods.length > 0) {
+        output += `## Implemented Methods\n\n`;
+        output += `Current methods in ${classSymbol.name}:\n\n`;
+        for (const method of existingMethods) {
+            output += `- \`${method.signature || method.name}\`\n`;
+        }
+        output += '\n';
+    }
+    if (suggestedMethods && suggestedMethods.length > 0) {
+        output += `## 💡 Suggested Missing Methods\n\n`;
+        output += `Based on analysis of similar ${classSymbol.patternType || 'classes'} in your codebase:\n\n`;
+        for (const suggestion of suggestedMethods) {
+            const percentage = suggestion.percentage || 0;
+            const frequency = suggestion.frequency || 0;
+            const total = suggestion.totalClasses || 0;
+            let importance = '🔵';
+            if (percentage >= 80)
+                importance = '🔴'; // Very common
+            else if (percentage >= 50)
+                importance = '🟠'; // Common
+            else if (percentage >= 30)
+                importance = '🟡'; // Somewhat common
+            output += `${importance} **${suggestion.methodName}**: Found in ${percentage}% of similar classes (${frequency}/${total})\n`;
+        }
+        output += '\n';
+        output += `**Legend:**\n`;
+        output += `- 🔴 Very common (80%+) - Strongly recommended\n`;
+        output += `- 🟠 Common (50%+) - Recommended\n`;
+        output += `- 🟡 Somewhat common (30%+) - Consider adding\n`;
+        output += `- 🔵 Less common - Optional\n\n`;
+        output += `**Recommendation:** Consider implementing the 🔴 and 🟠 methods to follow common patterns in your codebase.\n\n`;
+        output += `**Next Steps:**\n`;
+        output += `1. Use \`analyze_code(mode="implementations")\` for specific methods to get implementation examples\n`;
+        output += `2. Use \`search\` to find classes that implement these methods\n`;
+        output += `3. Use \`get_object_info(objectType="class", name=...)\` to study similar classes\n`;
+    }
+    else {
+        output += `## ✅ Analysis Result\n\n`;
+        output += `No commonly missing methods detected. Class appears complete for its ${classSymbol.patternType || 'pattern'} type.\n\n`;
+        if (existingMethods.length === 0) {
+            output += `**Note:** No existing methods found. This might be:\n`;
+            output += `- A newly created class\n`;
+            output += `- A class with only inherited methods\n`;
+            output += `- An issue with metadata parsing\n`;
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=analyzeCompleteness.js.map

package/dist/tools/analyzeCompleteness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeCompleteness.js","sourceRoot":"","sources":["../../src/tools/analyzeCompleteness.ts"],"names":[],"mappings":"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"}