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

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.1.26] - 2026-06-29
+
+### Changed
+
+- Clarified the bug report template so npm, Claude Desktop, Cursor, and custom
+  MCP users can include version, runtime, command shape, and synthetic JSON-RPC
+  reproduction details without sharing private data.
+
+## [0.1.25] - 2026-06-28
+
+### Added
+
+- Added a copy-ready prompt_risk_review JSON-RPC session example and smoke-test
+  coverage so developers can verify the customer-facing prompt stop path before
+  connecting private support or CRM workflows.
+
 ## [0.1.24] - 2026-06-25
 
 ### Changed

package/README.md

@@ -19,6 +19,10 @@ 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/.
 
+If your first concern is whether a customer-facing prompt should be stopped
+before AI use, use examples/prompt-risk-json-rpc-session/ for a copy-ready
+prompt_risk_review 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.
 
@@ -205,6 +209,8 @@ Copy-ready examples:
 - FAQ candidate review: `npm run example:faq-candidate-review`
 - AI-safe CRM note: `npm run example:ai-safe-crm-note`
 - Prompt risk review: `npm run example:prompt-risk-review`
+- Prompt risk JSON-RPC session:
+  `npm run mcp < examples/prompt-risk-json-rpc-session/sample-session.jsonl`
 
 All examples use synthetic data. Keep private customer records, secrets,
 internal policy text, and paid product files out of public issues and screenshots.

package/examples/prompt-risk-json-rpc-session/README.md

@@ -0,0 +1,32 @@
+# Prompt Risk JSON-RPC Session Example
+
+This example gives developers a copy-ready `prompt_risk_review` MCP session for
+the public @miraigent/free-ai-ops-mcp package.
+
+Use it when you want to check whether a customer-facing prompt should stop
+before AI use. The sample is synthetic and is covered by `npm test`, so the
+public example stays aligned with the packaged server response fields.
+
+## Run
+
+From the repository root:
+
+    npm run mcp < examples/prompt-risk-json-rpc-session/sample-session.jsonl
+
+You should receive three JSON-RPC response lines. The final response should
+include a `prompt_risk_review` result with:
+
+- recommendation: stop_before_ai_use
+- riskFlags: customer_facing and sensitive_data_possible
+- boundary: this tool is a prompt risk helper and does not call an AI API
+
+## Public-Safe Feedback
+
+If the output is unclear, open a Tried It feedback issue and include only:
+
+- which command you ran
+- the public-safe prompt shape
+- the returned recommendation or risk flag that was unclear
+
+Do not include secrets, credentials, private customer records, internal policy
+text, paid product files, or private memory behavior.

package/examples/prompt-risk-json-rpc-session/sample-session.jsonl

@@ -0,0 +1,3 @@
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
+{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
+{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"prompt_risk_review","arguments":{"operation":"support prompt review","promptSummary":"Draft a customer reply from an inquiry summary and order note.","dataTypes":["customer email","order note"],"customerFacing":true,"riskLevel":"medium"}}}

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.24' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.26' };
 
 const tools = [
   {

package/package.json

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

@@ -139,3 +139,17 @@ 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/);
+
+const promptRiskSession = await readFile(
+  new URL('../examples/prompt-risk-json-rpc-session/sample-session.jsonl', import.meta.url),
+  'utf8'
+);
+const promptRiskResponses = await runServerWithRequests(promptRiskSession.trim().split('\n'));
+assert.equal(promptRiskResponses.length, 3);
+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);
+assert.match(promptRiskResponses[2].result.content[0].text, /prompt_risk_review/);
+assert.match(promptRiskResponses[2].result.content[0].text, /stop_before_ai_use/);
+assert.match(promptRiskResponses[2].result.content[0].text, /customer_facing/);
+assert.match(promptRiskResponses[2].result.content[0].text, /sensitive_data_possible/);