genexus-mcp 3.7.2 → 3.9.0

package/cli/run.test.js

@@ -445,13 +445,28 @@ test('non-interactive init supports idempotent no-op', () => {
     assert.ok(Array.isArray(firstParsed.ok.verification.checks), 'verification should have checks array');
     assert.equal(firstParsed.meta.smokeSkipped, true, '--no-smoke should be reflected in meta');
 
+    const cfgPath = path.join(kbDir, 'config.json');
+    assert.equal(fs.existsSync(cfgPath), true);
+    const createdConfig = JSON.parse(fs.readFileSync(cfgPath, 'utf8'));
+    assert.equal(createdConfig.Server.ToolProfile, 'standard');
+
+    createdConfig.Server.ToolProfile = 'all';
+    const existingConfigBytes = JSON.stringify(createdConfig, null, 2);
+    fs.writeFileSync(cfgPath, existingConfigBytes);
+
     const second = runCli(args, { env: testGatewayEnv });
     assert.equal(second.status, 0);
     const secondParsed = JSON.parse(second.stdout);
     assert.equal(secondParsed.ok.noOp, true);
-
-    const cfgPath = path.join(kbDir, 'config.json');
-    assert.equal(fs.existsSync(cfgPath), true);
+    assert.equal(fs.readFileSync(cfgPath, 'utf8'), existingConfigBytes, 'init must not rewrite an existing profile');
+
+    delete createdConfig.Server.ToolProfile;
+    const profilelessConfigBytes = JSON.stringify(createdConfig, null, 2);
+    fs.writeFileSync(cfgPath, profilelessConfigBytes);
+    const third = runCli(args, { env: testGatewayEnv });
+    assert.equal(third.status, 0);
+    assert.equal(JSON.parse(third.stdout).ok.noOp, true);
+    assert.equal(fs.readFileSync(cfgPath, 'utf8'), profilelessConfigBytes, 'init must not retrofit profile-less configs');
 
     removeTempPath(tempRoot, { recursive: true, force: true });
 });

package/docs/llm_cli_mcp_playbook.md

@@ -103,6 +103,34 @@ with `commandStale: false`, not as stale, because the launcher is valid. `doctor
 
 For `tools/call`, parse `result.content[0].text` as JSON.
 
+### Tool profiles and schema budgets
+
+New neutral configs created by `genexus-mcp init` or client registration use
+`Server.ToolProfile: "standard"`; existing gateway configs are not rewritten.
+`genexus_whoami` reports the active profile and how to select another one.
+
+| Profile | Tools | Use |
+|---|---:|---|
+| `standard` | 16 | Recommended default for Cursor, Codex, OpenCode, Antigravity, Claude Desktop, and other clients that eagerly load every schema. Includes core read/search/lifecycle, create, structure, variable, properties, and IO tools. |
+| `core` | 11 | Read, search, inspect, edit, and lifecycle essentials. |
+| `authoring` | 29 | Core plus the full object-authoring and refactoring surface. |
+| `devops` | 33 | Core plus build, versioning, deployment, diagnostics, and worker operations. |
+| `ui` | 18 | Core plus layout, form, browser, and WorkWithPlus tools. |
+| `db` | 15 | Core plus database and data-view tools. |
+| `all` | 54 | Every canonical tool; use when an agent needs an unrestricted surface. |
+
+Profiles can be combined with `+`, for example `standard+db`. Set
+`Server.ToolProfile` in config or `GXMCP_PROFILE` in the process environment.
+Calling a known tool outside the active profile returns `ToolNotInProfile` with
+the profile(s) that expose it and the setting to change. Legacy alias names
+remain callable through compatibility rewrites but are not listed as tools.
+
+The public list omits examples and shortens long descriptions to stay within
+the enforced per-profile and per-tool byte budgets. Each tool description
+points to `genexus://kb/tool-help/<tool>`; read that resource when full
+constraints, rationale, or examples are needed. The original description and
+complete input schema remain available there.
+
 ### KB context, leases, and compatibility
 
 Use the neutral `stdio-isolated` + `ResolutionPolicy: "strict"` configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "3.7.2",
+  "version": "3.9.0",
   "mcpName": "io.github.lennix1337/genexus",
   "description": "GeneXus 16, GeneXus 17, GeneXus 18 MCP server with native SDK support; basic legacy compatibility for GeneXus Evolution 3, GeneXus Evolution 2, GeneXus Evolution 1, GeneXus 15, GeneXus 9.0, GeneXus 8.0 via com-gxpublic and dotnet-reflection drivers — read, edit, and analyze Knowledge Base objects directly from Claude, Cursor, and other AI agents over the Model Context Protocol.",
   "keywords": [
@@ -32,7 +32,7 @@
     "automation"
   ],
   "scripts": {
-    "test": "node --test cli/run.test.js cli/lib/client-adapters.test.js cli/docs.test.js scripts/lint.test.js scripts/verify-install.test.js && npm run test:live-contract",
+    "test": "node --test cli/run.test.js cli/lib/client-adapters.test.js cli/lib/runtime-stager.test.js cli/docs.test.js scripts/lint.test.js scripts/verify-install.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:integration": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/integration-preflight.ps1",

package/publish/GxMcp.Gateway.deps.json

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

package/publish/config.json

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

package/publish/gxmcp-manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": "gxmcp-release-manifest/1",
-  "version": "3.7.2",
-  "sourceCommit": "8bfec41e1fb31839fac72bd5696bf848285a194a",
+  "version": "3.9.0",
+  "sourceCommit": "9fac6a8ada3f87a633a857dbeb43eea101b0c085",
   "sourceCommitPolicy": "exact-tag",
-  "generatedAtUtc": "2026-09-22T04:09:07.5291470Z",
+  "generatedAtUtc": "2026-09-24T02:07:35.4354126Z",
   "runtime": {
     "gateway": "net10.0-windows",
     "worker": "net48-x86",
@@ -15,28 +15,28 @@
     "2026-07-28"
   ],
   "schema": "tool_definitions.json",
-  "schemaSha256": "1ee0eefa9c32227a76bd6261040f651b06b6096029607f91c9386e064461bb9e",
+  "schemaSha256": "e3d3d6247eb5725ed1622e99c8d1a85ffe614ac950e9e2c58d2e37a8404b0b87",
   "provenance": "gxmcp-sbom.json",
   "artifacts": [
     {
       "path": "gxmcp-sbom.json",
       "size": 590,
-      "sha256": "b01c1f14b0a9ac521c63f26a1c176765e8293784a362581370b01c86fbd3fffc"
+      "sha256": "864d16603041e8c62a86ab1870149af58ac400c3b421a1eeb659fb85d0456fa3"
     },
     {
       "path": "GxMcp.Gateway.exe",
       "size": 162304,
-      "sha256": "f9e1bbd84d47f15f53b51229f49ee02e9b166ebd827f379691731ee3ca39b32f"
+      "sha256": "4660652b1710719df9ed4e31e742d2ef0ea433d4fe0a3a4b1e5dd37d98ce749a"
     },
     {
       "path": "tool_definitions.json",
-      "size": 126649,
-      "sha256": "1ee0eefa9c32227a76bd6261040f651b06b6096029607f91c9386e064461bb9e"
+      "size": 127996,
+      "sha256": "e3d3d6247eb5725ed1622e99c8d1a85ffe614ac950e9e2c58d2e37a8404b0b87"
     },
     {
       "path": "worker/GxMcp.Worker.exe",
-      "size": 3476992,
-      "sha256": "3ee2a43ec18b709b69d174e05abaefa70f9b3054a59935180152eb84ffee1bde"
+      "size": 3588096,
+      "sha256": "75b511b894704797e623f580b5bd95b77ba64239000f49c7f7706a10c8848953"
     }
   ]
 }

package/publish/gxmcp-sbom.json

@@ -1,20 +1,20 @@
 {
   "schemaVersion": "gxmcp-provenance/1",
-  "version": "3.7.2",
-  "sourceCommit": "8bfec41e1fb31839fac72bd5696bf848285a194a",
+  "version": "3.9.0",
+  "sourceCommit": "9fac6a8ada3f87a633a857dbeb43eea101b0c085",
   "sourceCommitPolicy": "exact-tag",
   "components": [
     {
       "name": "genexus-mcp",
       "lockfile": "package-lock.json",
       "size": 39914,
-      "sha256": "858f4118fde52b680bc6bd39d52f607cc12c1e54f9d29a7d26bdb60690588d66"
+      "sha256": "f4b4ba71cb46893641b6724d23f6fd374915c7b1e1ed86cf809f6a55256893c6"
     },
     {
       "name": "nexus-ide",
       "lockfile": "src/nexus-ide/package-lock.json",
       "size": 274983,
-      "sha256": "6e6ad2ac8abc7f5180455cf72ad36906b9532fcab43185a936344e9b952f3882"
+      "sha256": "5d9ec910d7b16b23b039bd3b1221504967dc861103999d3b44b47485fa9343a9"
     }
   ]
 }