genexus-mcp 3.3.0 → 3.3.2

package/cli/commands/axi.js

@@ -235,21 +235,41 @@ async function probeGatewaySpawn() {
     });
 }
 
-function resolveMcpBaseUrl(cwd) {
+function resolveMcpSmokeTarget(cwd) {
     const configPath = resolveConfigPathNoMutate(cwd);
     const fallback = 'http://127.0.0.1:5000/mcp';
-    if (!configPath) return fallback;
+    if (!configPath) {
+        return { applicable: true, status: null, detail: null, baseUrl: fallback };
+    }
 
     const cfg = readJsonFileSafe(configPath);
-    if (!cfg || typeof cfg !== 'object') return fallback;
+    if (!cfg || typeof cfg !== 'object') {
+        return { applicable: true, status: null, detail: null, baseUrl: fallback };
+    }
 
     const server = cfg.Server && typeof cfg.Server === 'object' ? cfg.Server : {};
+    const gatewayMode = typeof cfg.GatewayMode === 'string' ? cfg.GatewayMode.toLowerCase() : '';
+    const rawPort = server.HttpPort;
+    const parsedPort = typeof rawPort === 'number'
+        ? rawPort
+        : Number.parseInt(String(rawPort ?? ''), 10);
+    const stdioRuntime = gatewayMode === 'stdio-isolated'
+        || gatewayMode === 'stdio'
+        || (server.McpStdio === true && (!Number.isFinite(parsedPort) || parsedPort <= 0));
+    if (stdioRuntime) {
+        return {
+            applicable: false,
+            status: 'not_applicable',
+            detail: `MCP HTTP smoke skipped: ${gatewayMode || 'stdio'} runtime has no HTTP listener.`,
+            baseUrl: null
+        };
+    }
+
     const host = server.BindAddress && typeof server.BindAddress === 'string'
         ? server.BindAddress
         : '127.0.0.1';
-    const parsedPort = Number.parseInt(String(server.HttpPort || ''), 10);
     const port = Number.isFinite(parsedPort) && parsedPort > 0 ? parsedPort : 5000;
-    return `http://${host}:${port}/mcp`;
+    return { applicable: true, status: null, detail: null, baseUrl: `http://${host}:${port}/mcp` };
 }
 
 async function runMcpSmokeProbe(cwd) {
@@ -258,7 +278,11 @@ async function runMcpSmokeProbe(cwd) {
         return { status: 'warn', detail: 'MCP smoke script is missing.' };
     }
 
-    const baseUrl = resolveMcpBaseUrl(cwd);
+    const target = resolveMcpSmokeTarget(cwd);
+    if (!target.applicable) {
+        return { status: target.status, detail: target.detail };
+    }
+    const baseUrl = target.baseUrl;
     const shell = process.platform === 'win32' ? 'powershell' : 'pwsh';
     const args = process.platform === 'win32'
         ? ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, '-BaseUrl', baseUrl]
@@ -793,7 +817,7 @@ async function handleDoctor(options, ctx) {
     const summary = checks.reduce((acc, row) => {
         acc[row.status] = (acc[row.status] || 0) + 1;
         return acc;
-    }, { pass: 0, warn: 0, fail: 0 });
+    }, { pass: 0, warn: 0, fail: 0, not_applicable: 0 });
 
     // Support bundle for handing off to support: doctor output + config (with paths
     // anonymized by hash so we don't leak filesystem layout) + recent worker logs +
@@ -2608,5 +2632,6 @@ module.exports = {
     handleHelp,
     usageEnvelope,
     operationalErrorEnvelope,
+    resolveMcpSmokeTarget,
     commandHelpMap
 };

package/cli/run.test.js

@@ -25,7 +25,7 @@ const {
     compareGeneXusKbAndInstallation,
     patchClientConfig
 } = require('./lib/config');
-const { handleInit } = require('./commands/axi');
+const { handleInit, resolveMcpSmokeTarget } = require('./commands/axi');
 
 const cliPath = path.join(__dirname, 'run.js');
 const testGxPath = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-gx-'));
@@ -911,7 +911,26 @@ test('doctor --mcp-smoke adds explicit mcp_smoke check', () => {
     const parsed = JSON.parse(result.stdout);
     const smoke = parsed.ok.checks.find((c) => c.id === 'mcp_smoke');
     assert.ok(smoke);
-    assert.ok(['pass', 'warn', 'fail'].includes(smoke.status));
+    assert.ok(['pass', 'warn', 'fail', 'not_applicable'].includes(smoke.status));
+});
+
+test('doctor marks HTTP smoke not applicable for stdio-isolated runtime', () => {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-doctor-stdio-'));
+    const configPath = path.join(tempRoot, 'config.json');
+    fs.writeFileSync(configPath, JSON.stringify({
+        GatewayMode: 'stdio-isolated',
+        Server: { HttpPort: 0, McpStdio: true }
+    }));
+
+    try {
+        const target = resolveMcpSmokeTarget(tempRoot);
+        assert.equal(target.applicable, false);
+        assert.equal(target.status, 'not_applicable');
+        assert.equal(target.baseUrl, null);
+        assert.match(target.detail, /stdio-isolated|HTTP listener is disabled/);
+    } finally {
+        fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
 });
 
 test('doctor reports a KB and SDK major mismatch', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "mcpName": "io.github.lennix1337/genexus",
   "description": "GeneXus 17, GeneXus 18 MCP server — read, edit, and analyze Knowledge Base objects directly from Claude, Cursor, and other AI agents over the Model Context Protocol.",
   "keywords": [
@@ -32,8 +32,10 @@
     "automation"
   ],
   "scripts": {
-    "test": "node --test cli/run.test.js cli/lib/client-adapters.test.js cli/docs.test.js",
-    "lint": "eslint cli scripts eslint.config.js --max-warnings=0",
+    "test": "node --test cli/run.test.js cli/lib/client-adapters.test.js cli/docs.test.js scripts/lint.test.js && npm run test:live-contract",
+    "lint": "node scripts/lint.js",
+    "test:live-contract": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/tests/test-live.test.ps1",
+    "test:upstream-drift": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/tests/test-upstream-drift.ps1",
     "test:one": "node scripts/test-one.js",
     "prepack": "node scripts/clean-package.js",
     "postinstall": "node scripts/verify-install.js"

package/publish/GxMcp.Gateway.deps.json

@@ -7,7 +7,7 @@
   "targets": {
     ".NETCoreApp,Version=v10.0": {},
     ".NETCoreApp,Version=v10.0/win-x64": {
-      "GxMcp.Gateway/3.3.0": {
+      "GxMcp.Gateway/3.3.2": {
         "dependencies": {
           "Newtonsoft.Json": "13.0.3",
           "System.Management": "10.0.5",
@@ -66,7 +66,7 @@
     }
   },
   "libraries": {
-    "GxMcp.Gateway/3.3.0": {
+    "GxMcp.Gateway/3.3.2": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/publish/config.json

@@ -1,19 +1,19 @@
 {
   "GatewayMode": "stdio-isolated",
-  "Server": {
-    "EmitStructuredContent": false,
-    "McpStdio": true,
-    "WorkerIdleTimeoutMinutes": 5,
-    "TerseResponses": true,
-    "HttpPort": 0,
-    "SessionIdleTimeoutMinutes": 10
-  },
-  "ConfigSchemaVersion": 2,
   "GeneXus": {
     "WorkerExecutable": "worker\\\\GxMcp.Worker.exe",
     "InstallationPath": "C:\\Program Files (x86)\\GeneXus\\GeneXus18"
   },
   "Environment": {
     "ResolutionPolicy": "strict"
-  }
+  },
+  "Server": {
+    "McpStdio": true,
+    "EmitStructuredContent": false,
+    "HttpPort": 0,
+    "TerseResponses": true,
+    "SessionIdleTimeoutMinutes": 10,
+    "WorkerIdleTimeoutMinutes": 5
+  },
+  "ConfigSchemaVersion": 2
 }

package/publish/gxmcp-manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": "gxmcp-release-manifest/1",
-  "version": "3.3.0",
-  "sourceCommit": "6d2f307d10ca718c6dbec8682c0a1678eb90818b",
+  "version": "3.3.2",
+  "sourceCommit": "1196063f31a24e9615640855cc4b2023c217c9cf",
   "sourceCommitPolicy": "exact-tag",
-  "generatedAtUtc": "2026-09-11T03:19:49.1965424Z",
+  "generatedAtUtc": "2026-09-11T19:28:01.8382135Z",
   "runtime": {
     "gateway": "net10.0-windows",
     "worker": "net48-x86",
@@ -21,12 +21,12 @@
     {
       "path": "gxmcp-sbom.json",
       "size": 590,
-      "sha256": "cdbc21566af312db105a3c964a9df0462dd2cf473f80efa21d8605307ea893a9"
+      "sha256": "485151f0264f6806d60f3452304e7a962d59efb75c8af065ec68ac88a94a7add"
     },
     {
       "path": "GxMcp.Gateway.exe",
       "size": 162304,
-      "sha256": "e75f60b4cbd28abcaf15d4dd80f1e966b79f078b4155b29f035501686414837b"
+      "sha256": "2272c4ad133fe2600c7bdf88fa82d58bbb8acf993a38889016cd986bc5906b11"
     },
     {
       "path": "tool_definitions.json",
@@ -35,8 +35,8 @@
     },
     {
       "path": "worker/GxMcp.Worker.exe",
-      "size": 3082240,
-      "sha256": "d66461633c93c8e82a957b15aca6706ac87a1ea6433ae6bc7c855d1180548e1b"
+      "size": 3086336,
+      "sha256": "da4cb5c66cdfa117ff1dfe271f0f7f5603b18dda70967afe2da5c433989443b1"
     }
   ]
 }

package/publish/gxmcp-sbom.json

@@ -1,20 +1,20 @@
 {
   "schemaVersion": "gxmcp-provenance/1",
-  "version": "3.3.0",
-  "sourceCommit": "6d2f307d10ca718c6dbec8682c0a1678eb90818b",
+  "version": "3.3.2",
+  "sourceCommit": "1196063f31a24e9615640855cc4b2023c217c9cf",
   "sourceCommitPolicy": "exact-tag",
   "components": [
     {
       "name": "genexus-mcp",
       "lockfile": "package-lock.json",
       "size": 39914,
-      "sha256": "778573945c8e74dc124ea99ed313ea99ab45b44aa600977f8094afd18fa8b9af"
+      "sha256": "4a8fa8579a01a562f681e00c344de4b4b896af33ad87e6787a4a99c2ba059b05"
     },
     {
       "name": "nexus-ide",
       "lockfile": "src/nexus-ide/package-lock.json",
       "size": 274983,
-      "sha256": "ed6d742540a8e833f2c2ad5c51f46be23a97e2d80b892d71891f5f61f5f4728c"
+      "sha256": "4899762362b2c5c5f2f9892578a824b85f0097e3c5f621cfb29fdc272951dfaa"
     }
   ]
 }