@miraigent/free-ai-ops-mcp 0.1.19 → 0.1.20

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.20] - 2026-06-20
+
+### Added
+
+- Added a copy-ready ai_safe_crm_note example so developers can test separating
+  customer facts, AI suggestions, human decisions, and next actions before
+  connecting private CRM notes.
+
 ## [0.1.19] - 2026-06-19
 
 ### Fixed

package/README.md

@@ -144,6 +144,7 @@ Copy-ready examples:
 
 - Human review gate: `npm run example:human-review-gate`
 - 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`
 
 All examples use synthetic data. Keep private customer records, secrets,
@@ -295,6 +296,10 @@ Run the FAQ candidate review example:
 
     npm run example:faq-candidate-review
 
+Run the AI-safe CRM note example:
+
+    npm run example:ai-safe-crm-note
+
 ## npm Package
 
 Package name: @miraigent/free-ai-ops-mcp

package/examples/ai-safe-crm-note/README.md

@@ -0,0 +1,33 @@
+# AI-Safe CRM Note Example
+
+This example shows how to call the public ai_safe_crm_note MCP tool before a
+support, sales, or onboarding note is copied into a CRM.
+
+Use it when a note mixes customer facts, AI suggestions, human decisions, and
+next actions in one paragraph.
+
+## Run
+
+From the repository root:
+
+    npm run example:ai-safe-crm-note
+
+The example sends sample-request.jsonl to the MCP server and prints the
+ai_safe_crm_note result.
+
+## What To Look For
+
+The sample uses a public-safe setup-timing note, so the tool should return:
+
+- crmNote.customerFacts: the factual summary only
+- crmNote.aiSuggestion: a separate AI suggestion placeholder
+- crmNote.humanDecision: a separate human decision placeholder
+- crmNote.nextAction: the next support or sales action
+
+## Safe Use
+
+Use synthetic examples only. Do not paste private customer records, names,
+emails, phone numbers, account IDs, contracts, payment details, internal policy
+text, or CRM exports into public issues, examples, or screenshots.
+
+This is an operations note helper. It does not write to a CRM or call an AI API.

package/examples/ai-safe-crm-note/run-example.mjs

@@ -0,0 +1,28 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+
+const child = spawn(process.execPath, ['mcp/free-ai-ops-server.mjs'], {
+  stdio: ['pipe', 'pipe', 'inherit']
+});
+
+const request = fs.readFileSync('examples/ai-safe-crm-note/sample-request.jsonl', 'utf8');
+let stdout = '';
+
+child.stdout.on('data', (chunk) => {
+  stdout += chunk;
+});
+
+child.stdin.write(request.trim() + '\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 response = JSON.parse(stdout.trim());
+const payload = JSON.parse(response.result.content[0].text);
+console.log(JSON.stringify(payload, null, 2));

package/examples/ai-safe-crm-note/sample-request.jsonl

@@ -0,0 +1 @@
+{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ai_safe_crm_note","arguments":{"rawNoteSummary":"Customer asked whether setup can start this week and wants the checklist before the kickoff call.","channel":"contact form","containsPersonalData":false,"nextAction":"send setup checklist and confirm kickoff date","owner":"sales operations"}}}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "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",
@@ -26,6 +26,7 @@
     "example:human-review-gate": "node examples/human-review-gate/run-example.mjs",
     "example:prompt-risk-review": "node examples/prompt-risk-review/run-example.mjs",
     "example:faq-candidate-review": "node examples/faq-candidate-review/run-example.mjs",
+    "example:ai-safe-crm-note": "node examples/ai-safe-crm-note/run-example.mjs",
     "mcp": "node mcp/free-ai-ops-server.mjs"
   },
   "keywords": [