mcp-adr-analysis-server 2.6.20 → 2.7.19

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -1378,6 +1378,11 @@ export class McpAdrAnalysisServer {
                                     description: 'Directory containing ADR files',
                                     default: 'docs/adrs',
                                 },
+                                researchDirectory: {
+                                    type: 'string',
+                                    description: 'Directory the research document is written to. Previously unset and unsettable: output went to docs/context/research/ regardless (#1528).',
+                                    default: 'docs/research',
+                                },
                                 confidenceThreshold: {
                                     type: 'number',
                                     description: 'Minimum confidence threshold (0-1) before suggesting web search',
@@ -3700,7 +3705,25 @@ export class McpAdrAnalysisServer {
                     const directive = getCEMCPDirective(name, safeArgs);
                     if (directive) {
                         this.logger.info(`[CE-MCP] Returning directive for tool: ${name}`);
-                        return formatDirectiveResponse(directive);
+                        const directiveResponse = formatDirectiveResponse(directive);
+                        // Record BEFORE returning. This early return skips the dispatch
+                        // switch below and, with it, the trackToolExecution call on the
+                        // success path -- so every tool in CE_MCP_DIRECTIVE_TOOLS was
+                        // invisible to usage tracking whenever CE-MCP mode was on. All
+                        // twelve of them, including `perform_research`, whose disposition
+                        // ADR-023 defers *pending usage data*. See #1489.
+                        //
+                        // Deliberately not fatal: a directive is the tool's real answer, and
+                        // failing to record it must never withhold it. trackToolExecution
+                        // already swallows and warns internally; the catch here covers a
+                        // throw before that boundary.
+                        try {
+                            await this.trackToolExecution(name, args, directiveResponse, true);
+                        }
+                        catch (trackingError) {
+                            this.logger.warn(`[CE-MCP] Usage tracking failed for ${name}: ${trackingError instanceof Error ? trackingError.message : String(trackingError)}`);
+                        }
+                        return directiveResponse;
                     }
                     // Fall through to legacy execution if no directive available
                     this.logger.info(`[CE-MCP] No directive available for ${name}, using legacy path`);
@@ -4356,13 +4379,30 @@ export class McpAdrAnalysisServer {
 - **Execution Mode**: ${status.executionMode}
 - **AI Model**: ${status.model}
 
-${status.reason
-                            ? `## ⚠️ Issue Detected
+${
+                        // CE-MCP is the DEFAULT mode and needs no API key. Reporting the absence of
+                        // one as an "Issue Detected" -- immediately after saying no external API call
+                        // is needed -- told every new user to go and buy a key they do not need.
+                        // Legacy configuration is only a problem for someone who asked for it. (#1414)
+                        status.executionMode === 'ce-mcp'
+                            ? `## ✅ Running in CE-MCP mode
+
+No API key is required. Tools return orchestration directives that your host LLM
+executes directly, which is why **AI Execution Enabled: NO** above is expected and
+correct rather than a fault.
+
+Note that only some tools currently return a directive; the rest return their
+result directly. See ADR-014 and ADR-021.
+
+Legacy OpenRouter execution is off by design. You only need the configuration
+below if you deliberately want that older path.`
+                            : status.reason
+                                ? `## ⚠️ Issue Detected
 **Problem**: ${status.reason}
 
 ## Solution
 ${!status.hasApiKey
-                                ? `
+                                    ? `
 1. Get an OpenRouter API key from https://openrouter.ai/keys
 2. Add it to your MCP configuration:
    \`\`\`json
@@ -4381,8 +4421,8 @@ ${!status.hasApiKey
    \`\`\`
 3. Restart your MCP client (Claude Desktop, etc.)
 `
-                                : status.executionMode !== 'full'
-                                    ? `
+                                    : status.executionMode !== 'full'
+                                        ? `
 1. Update your MCP configuration to set EXECUTION_MODE to "full":
    \`\`\`json
    {
@@ -4397,8 +4437,8 @@ ${!status.hasApiKey
    \`\`\`
 2. Restart your MCP client
 `
-                                    : ''}`
-                            : `## ✅ Configuration Looks Good!
+                                        : ''}`
+                                : `## ✅ Configuration Looks Good!
 
 AI execution is properly configured. Tools should return actual results instead of prompts.
 
@@ -7505,7 +7545,17 @@ Please provide:
             // Fall back to static resource handling
             // Parse URI to determine resource type and parameters
             const url = new globalThis.URL(uri);
-            const resourceType = url.pathname.replace('/', '');
+            // For a non-special scheme like `adr://adr_list`, WHATWG URL puts the name in
+            // `host`, not `pathname` -- pathname is ''. Reading pathname alone made every one
+            // of the 16 cases below unreachable: resourceType was always '', so the switch fell
+            // straight to `default` and threw "Unknown resource type: " with nothing after the
+            // colon. 16 of the 17 concrete resources advertised in resources/list were dead.
+            //
+            //   adr://adr_list  ->  host 'adr_list', pathname ''
+            //   adr://adr/{id}  ->  host 'adr',      pathname '/%7Bid%7D'
+            //
+            // Prefer the host; fall back to pathname so path-style URIs still resolve.
+            const resourceType = url.host || url.pathname.replace('/', '');
             const params = Object.fromEntries(url.searchParams.entries());
             switch (resourceType) {
                 case 'architectural_knowledge_graph': {