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

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.1.18] - 2026-06-19
+
+### Fixed
+
+- Replaced the direct scoped-package `npx @miraigent/free-ai-ops-mcp` README
+  path with the verified `npm exec --package ... -- free-ai-ops-mcp` command so
+  npm users get a reliable public run path.
+
+## [0.1.17] - 2026-06-19
+
+### Fixed
+
+- Restored the package to a single npm bin entry so `npx
+  @miraigent/free-ai-ops-mcp` resolves to the default command reliably.
+
 ## [0.1.16] - 2026-06-19
 
 ### Added

package/README.md

@@ -11,7 +11,7 @@ reaches customers or shared systems.
 
 Run the public MCP server:
 
-    npx @miraigent/free-ai-ops-mcp
+    npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp
 
 Then send a JSON-RPC tool call such as the copy-ready example in
 examples/human-review-gate/.
@@ -24,7 +24,7 @@ one tool call, see examples/mcp-json-rpc-session/.
 Use this when you want to confirm the npm package works before editing a desktop
 MCP client config:
 
-    npx -y @miraigent/free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
+    npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
 
 The response should include:
 
@@ -37,12 +37,9 @@ 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.
 
-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
+    npm exec --yes --package=@miraigent/free-ai-ops-mcp -- 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.
@@ -155,7 +152,7 @@ internal policy text, and paid product files out of public issues and screenshot
 ## What To Do Next
 
 - Try one tool with synthetic data.
-- If you ran `npx @miraigent/free-ai-ops-mcp`, paste the public-safe result
+- If you ran `npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp`, paste the public-safe result
   shape into the Tried It feedback issue.
 - Share what happened in the Tried It feedback issue if setup, JSON-RPC input,
   or the returned gate decision was unclear.

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.16' };
+const serverInfo = { name: 'miraigent-free-ai-ops-mcp', version: '0.1.18' };
 
 const tools = [
   {
@@ -69,10 +69,10 @@ function printHelp() {
   process.stdout.write(`Miraigent Free AI Ops MCP ${serverInfo.version}
 
 Run the public MCP server:
-  npx @miraigent/free-ai-ops-mcp
+  npm exec --yes --package=@miraigent/free-ai-ops-mcp -- 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
+  npm exec --yes --package=@miraigent/free-ai-ops-mcp -- free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl
 
 Available tools:
   human_review_gate      Stop/review/approve AI drafts before sending

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "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",
@@ -18,8 +18,7 @@
     "scripts/"
   ],
   "bin": {
-    "free-ai-ops-mcp": "mcp/free-ai-ops-server.mjs",
-    "miraigent-free-ai-ops-mcp": "mcp/free-ai-ops-server.mjs"
+    "free-ai-ops-mcp": "mcp/free-ai-ops-server.mjs"
   },
   "scripts": {
     "check": "node --check mcp/free-ai-ops-server.mjs && node --check scripts/smoke-test.mjs && node --check scripts/secret-scan.mjs && node scripts/secret-scan.mjs",

package/scripts/smoke-test.mjs

@@ -21,7 +21,7 @@ await new Promise((resolve, reject) => {
   });
 });
 
-assert.match(helpStdout, /npx @miraigent\/free-ai-ops-mcp/);
+assert.match(helpStdout, /npm exec --yes --package=@miraigent\/free-ai-ops-mcp/);
 assert.match(helpStdout, /human_review_gate/);
 assert.match(helpStdout, /Do not paste secrets/);