@miraigent/free-ai-ops-mcp 0.1.23 → 0.1.24

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.24] - 2026-06-25
+
+### Changed
+
+- Added smoke-test coverage for the public MCP JSON-RPC session example so npm
+  and GitHub users can trust that the copy-ready sample stays aligned with the
+  packaged server response fields.
+
 ## [0.1.23] - 2026-06-24
 
 ### Changed

package/README.md

@@ -19,6 +19,9 @@ examples/human-review-gate/.
 For a complete public-safe MCP session that covers initialize, tools/list, and
 one tool call, see examples/mcp-json-rpc-session/.
 
+That JSON-RPC session is also covered by `npm test`, so the README proof path
+and packaged example stay aligned when the MCP response shape changes.
+
 ## One-Command Public Smoke Test
 
 Use this when you want to confirm the npm package works before editing a desktop
@@ -37,6 +40,10 @@ This is the fastest public proof path for npm and GitHub users. If the command
 starts but the returned status is confusing, open a Tried It feedback issue with
 the command, synthetic input shape, and returned status only.
 
+For maintainers and contributors, `npm test` replays the same public
+`examples/mcp-json-rpc-session/sample-session.jsonl` file and checks the
+returned server name, version, tool count, and review-gate fields.
+
 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

package/examples/mcp-json-rpc-session/README.md

@@ -3,6 +3,10 @@
 This example gives developers a copy-ready MCP session for the public
 @miraigent/free-ai-ops-mcp package.
 
+The sample JSONL file in this directory is part of the repository smoke test.
+When `npm test` passes, this public copy-paste session has been replayed against
+the local MCP server and checked for the expected response fields.
+
 Use it before wiring the package into Claude Desktop, Cursor, or a custom MCP
 client. It verifies that the server responds to:
 
@@ -40,6 +44,10 @@ If those fields appear in the terminal but not in Claude Desktop, Cursor, or
 another client, the package is likely running and the next thing to check is the
 client config, restart behavior, or command path.
 
+Maintainers should update this sample and the smoke test together whenever a
+response field or tool name changes. That keeps the GitHub example, npm package,
+and README troubleshooting path from drifting apart.
+
 ## Public-Safe Feedback
 
 If the output is unclear, open a Tried It feedback issue and include only:

package/mcp/free-ai-ops-server.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.23' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.24' };
 
 const tools = [
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "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

@@ -25,10 +25,6 @@ assert.match(helpStdout, /npx -y free-ai-ops-mcp@npm:@miraigent\/free-ai-ops-mcp
 assert.match(helpStdout, /human_review_gate/);
 assert.match(helpStdout, /Do not paste secrets/);
 
-const child = spawn(process.execPath, ['mcp/free-ai-ops-server.mjs'], {
-  stdio: ['pipe', 'pipe', 'inherit']
-});
-
 const requests = [
   { jsonrpc: '2.0', id: 1, method: 'initialize', params: {} },
   { jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} },
@@ -93,25 +89,33 @@ const requests = [
   }
 ];
 
-let stdout = '';
-child.stdout.on('data', (chunk) => {
-  stdout += chunk;
-});
+async function runServerWithRequests(requestLines) {
+  const child = spawn(process.execPath, ['mcp/free-ai-ops-server.mjs'], {
+    stdio: ['pipe', 'pipe', 'inherit']
+  });
 
-for (const request of requests) {
-  child.stdin.write(JSON.stringify(request) + '\n');
-}
-child.stdin.end();
+  let stdout = '';
+  child.stdout.on('data', (chunk) => {
+    stdout += chunk;
+  });
 
-await new Promise((resolve, reject) => {
-  child.on('error', reject);
-  child.on('close', (code) => {
-    if (code !== 0) reject(new Error('server exited with ' + code));
-    else resolve();
+  for (const requestLine of requestLines) {
+    child.stdin.write(requestLine + '\n');
+  }
+  child.stdin.end();
+
+  await new Promise((resolve, reject) => {
+    child.on('error', reject);
+    child.on('close', (code) => {
+      if (code !== 0) reject(new Error('server exited with ' + code));
+      else resolve();
+    });
   });
-});
 
-const responses = stdout.trim().split('\n').map((line) => JSON.parse(line));
+  return stdout.trim().split('\n').map((line) => JSON.parse(line));
+}
+
+const responses = await runServerWithRequests(requests.map((request) => JSON.stringify(request)));
 assert.equal(responses.length, requests.length);
 assert.equal(responses[0].result.serverInfo.name, 'miraigent-free-ai-ops-mcp');
 assert.equal(responses[0].result.serverInfo.version, packageJson.version);
@@ -121,3 +125,17 @@ assert.match(responses[2].result.content[0].text, /nextLogRow/);
 assert.match(responses[3].result.content[0].text, /public_faq_candidate/);
 assert.match(responses[4].result.content[0].text, /crmNote/);
 assert.match(responses[5].result.content[0].text, /stop_before_ai_use|human_review_required/);
+
+const sampleSession = await readFile(
+  new URL('../examples/mcp-json-rpc-session/sample-session.jsonl', import.meta.url),
+  'utf8'
+);
+const sampleLines = sampleSession.trim().split('\n');
+const sampleResponses = await runServerWithRequests(sampleLines);
+assert.equal(sampleResponses.length, 3);
+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);
+assert.match(sampleResponses[2].result.content[0].text, /gateStatus/);
+assert.match(sampleResponses[2].result.content[0].text, /reviewOwner/);
+assert.match(sampleResponses[2].result.content[0].text, /boundary/);