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

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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
+
+- Added README guidance for reading returned MCP status fields so npm and
+  GitHub users can choose the next safe action before changing client config or
+  connecting private workflows.
+
 ## [0.1.22] - 2026-06-22
 
 ### 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
@@ -120,6 +127,38 @@ you ran, the public-safe input shape, and the returned status field. Do not
 paste private customer records, secrets, internal policy text, or paid product
 files.
 
+## Read The Returned Status
+
+After the smoke test runs, look for the status field from the tool you called
+before changing client configuration or private workflows.
+
+For `human_review_gate`:
+
+- `auto_ok`: the synthetic draft looks low risk, but the tool still does not
+  send anything.
+- `review_required`: keep a human reviewer in the workflow before sending.
+- `stop`: pause the workflow and resolve the sensitive, payment, complaint,
+  privacy, public-facing, or policy issue first.
+
+For `prompt_risk_review`:
+
+- `review_checklist_required`: document the data-handling checklist before
+  running the prompt.
+- `human_review_required`: add a human review step before AI output can affect a
+  customer-facing workflow.
+- `stop_before_ai_use`: do not run the prompt until the data-handling rule is
+  reviewed.
+
+For `faq_candidate_review`, use `recommendedStatus` to decide whether the
+pattern belongs in a public FAQ, internal FAQ, or human-review rule. For
+`ai_safe_crm_note`, check that facts, AI suggestions, human decisions, and next
+actions stay in separate fields.
+
+If the status is surprising, open a Tried It feedback issue with synthetic input
+only. The most useful report says which status you expected, which status you
+received, and what extra rule or explanation would have made the result easier
+to use.
+
 ## Copy A Useful Feedback Result
 
 When you open a Tried It feedback issue, the most useful report is the smallest

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.22' };
+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.22",
+  "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/);