@miraigent/free-ai-ops-mcp 0.1.40 → 0.1.42

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.1.42] - 2026-07-18
+
+### Changed
+
+- Clarified that the public help header prints the package version and added
+  smoke-test coverage for that header so npm users can spot stale `npx` cache
+  behavior before editing MCP client configuration.
+
+## [0.1.41] - 2026-07-17
+
+### Changed
+
+- Added an initialize response check to the public smoke-test path so MCP users
+  can confirm the protocol version, capabilities, and package version before
+  debugging desktop client configuration.
+
 ## [0.1.40] - 2026-07-16
 
 ### Changed

package/README.md

@@ -53,7 +53,10 @@ If you are checking the package from npm search, run the public help first:
     npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp --help
 
 The help output lists the available MCP tools, the one-command smoke test, and
-the public-safe boundary before you send any JSON-RPC input.
+the public-safe boundary before you send any JSON-RPC input. The first line
+also prints `Miraigent Free AI Ops MCP <version>`, which is the quickest way to
+confirm whether `npx` is using the current public package or a stale local
+cache.
 
 If a local npx cache or desktop MCP client appears stale, compare it with the
 public registry version before changing private client configuration:
@@ -75,6 +78,15 @@ If only the desktop MCP client shows an older version after those checks pass,
 restart the client and re-check its `command` and `args` path before changing
 any private workflow data.
 
+Quick initialize response check:
+
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl | head -n 1
+
+That first response should include `protocolVersion: "2024-11-05"`,
+`capabilities.tools`, and `serverInfo.version`. If those fields appear in the
+terminal but not in a desktop MCP client, debug the client restart/config path
+before changing private workflow data.
+
 If the result is unclear, open a Tried It feedback issue with synthetic input
 only. A useful issue can be as small as:
 
@@ -350,6 +362,10 @@ The session sends three JSON-RPC messages:
 - tools/list: confirms the four public alpha tools are visible.
 - tools/call: runs human_review_gate with synthetic support-reply data.
 
+The first response should include `protocolVersion: "2024-11-05"`,
+`capabilities.tools`, and a `serverInfo.version` value that matches
+`package.json` and the public npm registry version.
+
 If you open a GitHub issue, copy only synthetic input shapes and returned status
 fields. Do not paste private customer records, secrets, tokens, internal policy
 text, or MIRAI Memory behavior.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "Free MCP server for developers adding human review gates, prompt risk checks, FAQ review, and CRM note safety to AI tools.",
   "homepage": "https://github.com/Miraigent/miraigent-free-ai-ops-mcp",
   "type": "module",

package/scripts/smoke-test.mjs

@@ -22,6 +22,7 @@ await new Promise((resolve, reject) => {
 });
 
 assert.match(helpStdout, /npx -y free-ai-ops-mcp@npm:@miraigent\/free-ai-ops-mcp/);
+assert.match(helpStdout, new RegExp(`Miraigent Free AI Ops MCP ${packageJson.version.replaceAll('.', '\\.')}`));
 assert.match(helpStdout, /human_review_gate/);
 assert.match(helpStdout, /Do not paste secrets/);
 assert.match(helpStdout, /private memory behavior/);
@@ -119,6 +120,8 @@ async function runServerWithRequests(requestLines) {
 
 const responses = await runServerWithRequests(requests.map((request) => JSON.stringify(request)));
 assert.equal(responses.length, requests.length);
+assert.equal(responses[0].result.protocolVersion, '2024-11-05');
+assert.deepEqual(responses[0].result.capabilities, { tools: {} });
 assert.equal(responses[0].result.serverInfo.name, 'miraigent-free-ai-ops-mcp');
 assert.equal(responses[0].result.serverInfo.version, packageJson.version);
 assert.equal(responses[1].result.tools.length, 4);
@@ -166,6 +169,8 @@ const sampleSession = await readFile(
 const sampleLines = sampleSession.trim().split('\n');
 const sampleResponses = await runServerWithRequests(sampleLines);
 assert.equal(sampleResponses.length, 3);
+assert.equal(sampleResponses[0].result.protocolVersion, '2024-11-05');
+assert.deepEqual(sampleResponses[0].result.capabilities, { tools: {} });
 assert.equal(sampleResponses[0].result.serverInfo.name, 'miraigent-free-ai-ops-mcp');
 assert.equal(sampleResponses[0].result.serverInfo.version, packageJson.version);
 assert.equal(sampleResponses[1].result.tools.length, 4);
@@ -188,6 +193,8 @@ const promptRiskSession = await readFile(
 );
 const promptRiskResponses = await runServerWithRequests(promptRiskSession.trim().split('\n'));
 assert.equal(promptRiskResponses.length, 3);
+assert.equal(promptRiskResponses[0].result.protocolVersion, '2024-11-05');
+assert.deepEqual(promptRiskResponses[0].result.capabilities, { tools: {} });
 assert.equal(promptRiskResponses[0].result.serverInfo.name, 'miraigent-free-ai-ops-mcp');
 assert.equal(promptRiskResponses[0].result.serverInfo.version, packageJson.version);
 assert.equal(promptRiskResponses[1].result.tools.length, 4);