@peernova/cuneiform-sf 1.0.4-beta.9 → 1.0.4

package/oclif.manifest.json

@@ -280,87 +280,6 @@
         "check:compatibility:cuneiform"
       ]
     },
-    "cuneiform:mcp:serve": {
-      "aliases": [],
-      "args": {},
-      "description": "Starts the Cuneiform MCP (Model Context Protocol) server, exposing Cuneiform CLI capabilities as tools for AI assistants. Once running, an LLM client can query your org, list objects, describe fields, manage definitions, and execute profiling through natural language — using the same permissions as your CLI session.\n\nThe server registers tools across categories covering org and metadata discovery, user management, definition lifecycle, definition import/export, analysis, and profiling execution. A system prompt provides LLMs with an incremental exploration workflow for the KYCD journey.\n\nDavid Chen wires this into Claude Desktop and Cursor workflows — the registered tools give him a well-defined API contract. Marcus Thompson uses it to accelerate org exploration through conversational queries. Andre Robitaille demonstrates MCP integration during workshops, where attendees experience Cuneiform through natural dialogue.\n\nTRANSPORT: The server uses stdio (stdin/stdout) with JSON-RPC 2.0 protocol. Logging goes to stderr (enable with --debug). The stdio transport ensures the server runs locally alongside the Salesforce CLI — same machine, same authenticated session.\n\nThis command blocks until the MCP client disconnects. It is designed to be launched by an MCP client (Claude Desktop, Cursor, etc.). The access gate validates Cuneiform permissions at startup — the same gate used by all Cuneiform commands. On access gate failure, the command exits with an error describing the missing permission and how to resolve it via `user details --configure`.\n\n**When to run this command:**\n\n- AI-guided org discovery — let Claude explore a new client org through natural language\n- Hands-free definition creation — describe what you want and let the AI translate to tool calls\n- Training demonstrations — show Cuneiform capabilities through interactive AI conversation\n- Automated workflows — integrate Cuneiform tools into AI agent pipelines\n\nNATURAL LANGUAGE → FLAG MAPPING:\n\"start the MCP server\" → --target-org myOrg\n\"troubleshoot MCP tool calls\" → --target-org myOrg --debug\n\"pin a specific API version\" → --target-org myOrg --api-version 59.0\n\nCONFIGURATION: Add the server to your AI tool's settings. For Claude Desktop, add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cuneiform\": {\n      \"command\": \"sf\",\n      \"args\": [\"cuneiform\", \"mcp\", \"serve\", \"--target-org\", \"myOrg\"]\n    }\n  }\n}\n```",
-      "examples": [
-        "Start the MCP server for an org — the standard launch configuration:\n<%= config.bin %> <%= command.id %> --target-org myOrg",
-        "Start with debug logging — see tool invocations and parameters on stderr:\n<%= config.bin %> <%= command.id %> --target-org myOrg --debug",
-        "Pin a specific API version — for consistent behavior across environments:\n<%= config.bin %> <%= command.id %> --target-org myOrg --api-version 59.0"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org": {
-          "char": "o",
-          "name": "target-org",
-          "noCacheDefault": true,
-          "required": true,
-          "summary": "The Salesforce org to connect the MCP server to. The server inherits this org's authentication for all 18 tool invocations. Specify the org alias or username.",
-          "hasDynamicHelp": true,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "char": "a",
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "summary": "Override the API version used for Salesforce API requests made through MCP tools. Use when troubleshooting version-specific behavior or testing against a specific API release.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "debug": {
-          "char": "d",
-          "name": "debug",
-          "summary": "Enable debug logging to stderr. Shows tool invocations, parameters, and response metadata for troubleshooting MCP communication. stdout remains reserved for MCP protocol traffic.",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": true,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "cuneiform:mcp:serve",
-      "pluginAlias": "@peernova/cuneiform-sf",
-      "pluginName": "@peernova/cuneiform-sf",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Start the MCP server to expose 18 Cuneiform tools to AI assistants — enabling natural language org discovery, definition management, and profiling through Claude Desktop, Cursor, or any MCP client.",
-      "enableJsonFlag": true,
-      "skipAccessGate": false,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "cuneiform",
-        "mcp",
-        "serve.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "cuneiform:mcp:serve",
-        "mcp:cuneiform:serve",
-        "mcp:serve:cuneiform",
-        "cuneiform:serve:mcp",
-        "serve:cuneiform:mcp",
-        "serve:mcp:cuneiform"
-      ]
-    },
     "cuneiform:definition:create": {
       "aliases": [],
       "args": {},
@@ -1494,6 +1413,87 @@
         "update:definition:cuneiform"
       ]
     },
+    "cuneiform:mcp:serve": {
+      "aliases": [],
+      "args": {},
+      "description": "Starts the Cuneiform MCP (Model Context Protocol) server, exposing Cuneiform CLI capabilities as tools for AI assistants. Once running, an LLM client can query your org, list objects, describe fields, manage definitions, and execute profiling through natural language — using the same permissions as your CLI session.\n\nThe server registers tools across categories covering org and metadata discovery, user management, definition lifecycle, definition import/export, analysis, and profiling execution. A system prompt provides LLMs with an incremental exploration workflow for the KYCD journey.\n\nDavid Chen wires this into Claude Desktop and Cursor workflows — the registered tools give him a well-defined API contract. Marcus Thompson uses it to accelerate org exploration through conversational queries. Andre Robitaille demonstrates MCP integration during workshops, where attendees experience Cuneiform through natural dialogue.\n\nTRANSPORT: The server uses stdio (stdin/stdout) with JSON-RPC 2.0 protocol. Logging goes to stderr (enable with --debug). The stdio transport ensures the server runs locally alongside the Salesforce CLI — same machine, same authenticated session.\n\nThis command blocks until the MCP client disconnects. It is designed to be launched by an MCP client (Claude Desktop, Cursor, etc.). The access gate validates Cuneiform permissions at startup — the same gate used by all Cuneiform commands. On access gate failure, the command exits with an error describing the missing permission and how to resolve it via `user details --configure`.\n\n**When to run this command:**\n\n- AI-guided org discovery — let Claude explore a new client org through natural language\n- Hands-free definition creation — describe what you want and let the AI translate to tool calls\n- Training demonstrations — show Cuneiform capabilities through interactive AI conversation\n- Automated workflows — integrate Cuneiform tools into AI agent pipelines\n\nNATURAL LANGUAGE → FLAG MAPPING:\n\"start the MCP server\" → --target-org myOrg\n\"troubleshoot MCP tool calls\" → --target-org myOrg --debug\n\"pin a specific API version\" → --target-org myOrg --api-version 59.0\n\nCONFIGURATION: Add the server to your AI tool's settings. For Claude Desktop, add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cuneiform\": {\n      \"command\": \"sf\",\n      \"args\": [\"cuneiform\", \"mcp\", \"serve\", \"--target-org\", \"myOrg\"]\n    }\n  }\n}\n```",
+      "examples": [
+        "Start the MCP server for an org — the standard launch configuration:\n<%= config.bin %> <%= command.id %> --target-org myOrg",
+        "Start with debug logging — see tool invocations and parameters on stderr:\n<%= config.bin %> <%= command.id %> --target-org myOrg --debug",
+        "Pin a specific API version — for consistent behavior across environments:\n<%= config.bin %> <%= command.id %> --target-org myOrg --api-version 59.0"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "char": "o",
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "The Salesforce org to connect the MCP server to. The server inherits this org's authentication for all 18 tool invocations. Specify the org alias or username.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "char": "a",
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "summary": "Override the API version used for Salesforce API requests made through MCP tools. Use when troubleshooting version-specific behavior or testing against a specific API release.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "name": "debug",
+          "summary": "Enable debug logging to stderr. Shows tool invocations, parameters, and response metadata for troubleshooting MCP communication. stdout remains reserved for MCP protocol traffic.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "cuneiform:mcp:serve",
+      "pluginAlias": "@peernova/cuneiform-sf",
+      "pluginName": "@peernova/cuneiform-sf",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Start the MCP server to expose 18 Cuneiform tools to AI assistants — enabling natural language org discovery, definition management, and profiling through Claude Desktop, Cursor, or any MCP client.",
+      "enableJsonFlag": true,
+      "skipAccessGate": false,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "cuneiform",
+        "mcp",
+        "serve.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "cuneiform:mcp:serve",
+        "mcp:cuneiform:serve",
+        "mcp:serve:cuneiform",
+        "cuneiform:serve:mcp",
+        "serve:cuneiform:mcp",
+        "serve:mcp:cuneiform"
+      ]
+    },
     "cuneiform:object:describe": {
       "aliases": [],
       "args": {},
@@ -2897,5 +2897,5 @@
       ]
     }
   },
-  "version": "1.0.4-beta.9"
+  "version": "1.0.4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@peernova/cuneiform-sf",
   "description": "Cuneiform for Salesforce CLI-Powered Data Profiling",
-  "version": "1.0.4-beta.9",
+  "version": "1.0.4",
   "cuneiform": {
     "_comment": "Compatibility manifest. CLI-2932. requiredAppVersion is the minimum Cuneiform For Salesforce managed package version this CLI build expects in the target org. Update at release time alongside the CLI version. See README → Compatibility.",
     "requiredAppVersion": "4.12.0.17"