getprismo 0.1.15 → 0.1.17

package/README.md

@@ -806,6 +806,7 @@ npx getprismo doctor --help
 npx getprismo watch --help
 npx getprismo shield --help
 npx getprismo mcp --help
+npx getprismo mcp doctor
 npx getprismo cc --help
 npx getprismo scan --help
 ```

package/docs/mcp.md

@@ -8,6 +8,16 @@ PrismoDev can run as a local MCP server so compatible coding agents can inspect
 npx getprismo mcp /path/to/your/repo
 ```
 
+## Doctor
+
+Before adding PrismoDev to a client, validate the local MCP surface:
+
+```bash
+npx getprismo mcp doctor /path/to/your/repo
+```
+
+This checks that the MCP server can expose all Prismo tools, runs a scan smoke test, and prints a ready-to-use client config snippet.
+
 ## Generic MCP Config
 
 ```json

package/lib/prismo-dev/mcp.js

@@ -258,7 +258,96 @@ function runMcpServer(deps) {
   });
 }
 
+async function runMcpDoctor(deps) {
+  const { rootDir, packageVersion = "0.0.0" } = deps;
+  const { tools, callTool } = createMcpTools(deps);
+  const requiredTools = [
+    "prismo_scan",
+    "prismo_doctor_dry_run",
+    "prismo_watch_snapshot",
+    "prismo_shield_run",
+    "prismo_shield_search",
+    "prismo_shield_last",
+    "prismo_context_pack",
+    "prismo_firewall",
+    "prismo_cc_timeline",
+  ];
+  const toolNames = tools.map((tool) => tool.name);
+  const missingTools = requiredTools.filter((name) => !toolNames.includes(name));
+  const scanResult = await callTool("prismo_scan", { path: rootDir, includeUsage: false, limit: 1 });
+  let scanPayload = {};
+  try {
+    scanPayload = JSON.parse(scanResult.content?.[0]?.text || "{}");
+  } catch {
+    scanPayload = {};
+  }
+  const config = {
+    mcpServers: {
+      prismodev: {
+        command: "npx",
+        args: ["-y", "getprismo", "mcp", rootDir],
+      },
+    },
+  };
+  return {
+    schemaVersion: 1,
+    ok: missingTools.length === 0 && Boolean(scanPayload.schemaVersion),
+    server: {
+      name: "prismodev",
+      version: packageVersion,
+      transport: "stdio",
+      root: rootDir,
+    },
+    tools: {
+      count: tools.length,
+      required: requiredTools,
+      missing: missingTools,
+      hasShield: toolNames.includes("prismo_shield_run") && toolNames.includes("prismo_shield_search"),
+    },
+    smoke: {
+      scan: {
+        ok: Boolean(scanPayload.schemaVersion),
+        score: scanPayload.score ?? null,
+        riskLevel: scanPayload.riskLevel ?? null,
+      },
+    },
+    config,
+    next: [
+      "Add the config snippet to your MCP-compatible client.",
+      "Restart the client and confirm prismodev appears in the MCP tool list.",
+      "Ask the agent to call prismo_scan or prismo_shield_run.",
+    ],
+  };
+}
+
+function renderMcpDoctorTerminal(result) {
+  const lines = [];
+  lines.push("");
+  lines.push("Prismo MCP Doctor");
+  lines.push("");
+  lines.push(`Status: ${result.ok ? "ready" : "needs attention"}`);
+  lines.push(`Server: ${result.server.name}@${result.server.version}`);
+  lines.push(`Transport: ${result.server.transport}`);
+  lines.push(`Repo: ${result.server.root}`);
+  lines.push("");
+  lines.push("Checks");
+  lines.push(`- Tools exposed: ${result.tools.count}`);
+  lines.push(`- Required tools missing: ${result.tools.missing.length ? result.tools.missing.join(", ") : "none"}`);
+  lines.push(`- Shield tools: ${result.tools.hasShield ? "ready" : "missing"}`);
+  lines.push(`- Scan smoke: ${result.smoke.scan.ok ? `ok (${result.smoke.scan.score}/100, ${result.smoke.scan.riskLevel})` : "failed"}`);
+  lines.push("");
+  lines.push("MCP config");
+  lines.push("");
+  lines.push(JSON.stringify(result.config, null, 2));
+  lines.push("");
+  lines.push("Next");
+  result.next.forEach((step, index) => lines.push(`${index + 1}. ${step}`));
+  return lines.join("\n");
+}
+
 module.exports = {
   createMcpTools,
+  renderMcpDoctorTerminal,
+  runMcpDoctor,
   runMcpServer,
 };

package/lib/prismo-dev-scan.js

@@ -283,7 +283,11 @@ const {
   color,
 });
 
-const { runMcpServer } = require("./prismo-dev/mcp");
+const {
+  renderMcpDoctorTerminal,
+  runMcpDoctor,
+  runMcpServer,
+} = require("./prismo-dev/mcp");
 
 function printHelp() {
   console.log(`Prismo CLI
@@ -298,6 +302,7 @@ Usage:
   prismo shield last [--json] [--limit N] [path]
   prismo shield search <query> [--json] [--limit N] [path]
   prismo mcp [path]
+  prismo mcp doctor [--json] [path]
   prismo setup [--json] [--proxy-url URL] [path]
   prismo scan [--fix] [--ci] [--json] [--usage] [--simple] [--no-report] [path]
   prismo optimize [scope] [--json] [path]
@@ -521,10 +526,13 @@ Output:
 
 Usage:
   prismo mcp [path]
+  prismo mcp doctor [--json] [path]
 
 Examples:
   prismo mcp
   prismo mcp /path/to/repo
+  prismo mcp doctor
+  prismo mcp doctor --json
 
 Tools exposed:
   prismo_scan
@@ -538,7 +546,9 @@ Tools exposed:
   prismo_cc_timeline
 
 Output:
-  Starts a local JSON-RPC MCP server over stdio. Use it from MCP-compatible clients so agents can scan context waste, search shielded command output, and request scoped context without loading huge logs into chat.`,
+  Starts a local JSON-RPC MCP server over stdio. Use it from MCP-compatible clients so agents can scan context waste, search shielded command output, and request scoped context without loading huge logs into chat.
+
+  prismo mcp doctor validates the local MCP tool surface and prints a ready-to-use client config snippet.`,
     ci: `Prismo CI
 
 Usage:
@@ -707,8 +717,11 @@ async function runCli(argv) {
   }
 
   if (command === "mcp") {
-    const target = getPositionals(rest)[0] || process.cwd();
-    runMcpServer({
+    const json = rest.includes("--json");
+    const positional = getPositionals(rest);
+    const subcommand = positional[0] === "doctor" ? "doctor" : "server";
+    const target = subcommand === "doctor" ? positional[1] || process.cwd() : positional[0] || process.cwd();
+    const mcpDeps = {
       rootDir: path.resolve(target),
       packageVersion: PACKAGE_VERSION,
       scanRepo,
@@ -724,7 +737,14 @@ async function runCli(argv) {
       runShield,
       runShieldLast,
       runShieldSearch,
-    });
+    };
+    if (subcommand === "doctor") {
+      const result = await runMcpDoctor(mcpDeps);
+      if (json) console.log(JSON.stringify(result, null, 2));
+      else console.log(renderMcpDoctorTerminal(result));
+      return;
+    }
+    runMcpServer(mcpDeps);
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getprismo",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Local AI coding workflow scanner for Codex, Claude Code, Cursor, and token-waste diagnostics.",
   "license": "MIT",
   "homepage": "https://github.com/shanirsh/prismodev#readme",
@@ -24,7 +24,8 @@
     "access": "public"
   },
   "bin": {
-    "prismo": "bin/prismo.js"
+    "prismo": "bin/prismo.js",
+    "getprismo": "bin/prismo.js"
   },
   "files": [
     "bin/",