@miraigent/free-ai-ops-mcp 0.1.15 → 0.1.16

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.16] - 2026-06-19
+
+### Added
+
+- Added a public `--help` path for npm/npx users so package search visitors can
+  see the available MCP tools, one-command smoke test, safety boundary, and
+  feedback route before sending JSON-RPC input.
+
 ## [0.1.15] - 2026-06-18
 
 ### Fixed

package/README.md

@@ -40,6 +40,13 @@ the command, synthetic input shape, and returned status only.
 The package also exposes `free-ai-ops-mcp` and `miraigent-free-ai-ops-mcp` as
 bin aliases for npm exec environments that require an explicit command name.
 
+If you are checking the package from npm search, run the public help first:
+
+    npx @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.
+
 If the result is unclear, open a Tried It feedback issue with synthetic input
 only. A useful issue can be as small as:
 

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.15' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.16' };
 
 const tools = [
   {
@@ -65,6 +65,30 @@ function textContent(value) {
   return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
 }
 
+function printHelp() {
+  process.stdout.write(`Miraigent Free AI Ops MCP ${serverInfo.version}
+
+Run the public MCP server:
+  npx @miraigent/free-ai-ops-mcp
+
+Run a copy-ready public smoke test:
+  npx -y @miraigent/free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
+
+Available tools:
+  human_review_gate      Stop/review/approve AI drafts before sending
+  faq_candidate_review   Review repeated questions before FAQ publication
+  ai_safe_crm_note       Separate facts, AI suggestions, human decisions, and next actions
+  prompt_risk_review     Check customer-facing or sensitive prompts before AI use
+
+Public-safe boundary:
+  Use synthetic examples only. Do not paste secrets, customer records,
+  internal policy text, paid product files, or private memory behavior.
+
+Feedback:
+  https://github.com/Miraigent/miraigent-free-ai-ops-mcp/issues/new/choose
+`);
+}
+
 function normalizeRisk(value) {
   return String(value || 'medium').toLowerCase();
 }
@@ -197,6 +221,11 @@ function handle(request) {
   throw new Error('Unsupported method: ' + request.method);
 }
 
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  printHelp();
+  process.exit(0);
+}
+
 let buffer = '';
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', (chunk) => {

package/package.json

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

@@ -4,6 +4,27 @@ import { readFile } from 'node:fs/promises';
 
 const packageJson = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
 
+const helpChild = spawn(process.execPath, ['mcp/free-ai-ops-server.mjs', '--help'], {
+  stdio: ['ignore', 'pipe', 'inherit']
+});
+
+let helpStdout = '';
+helpChild.stdout.on('data', (chunk) => {
+  helpStdout += chunk;
+});
+
+await new Promise((resolve, reject) => {
+  helpChild.on('error', reject);
+  helpChild.on('close', (code) => {
+    if (code !== 0) reject(new Error('help exited with ' + code));
+    else resolve();
+  });
+});
+
+assert.match(helpStdout, /npx @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']
 });