webmcp-codegen 0.3.1 → 0.3.3

package/dist/cli.js

@@ -1,25 +1,160 @@
 #!/usr/bin/env node
 import {
   findSpecs,
-  loadDataFile,
   resolveSetup,
-  saveDataFile
-} from "./chunk-CCVNYNJ5.js";
+  saveDataFile,
+  startDevServer
+} from "./chunk-MUTXYBL6.js";
 import {
+  CONFIG_FILE_NAMES,
   runGenerate
 } from "./chunk-MJQ5B6HB.js";
+import "./chunk-EAKYM4YS.js";
 import "./chunk-3LTHWIAP.js";
 import "./chunk-FWSATV7C.js";
-import "./chunk-I4ZL527H.js";
 import "./chunk-KSQMJERY.js";
 
 // src/cli.ts
-import { existsSync, watch } from "fs";
+import { existsSync } from "fs";
 import { writeFile as writeFile2 } from "fs/promises";
-import { join as join2, relative as relative2 } from "path";
-import "readline/promises";
+import { join as join2 } from "path";
 import { parseArgs } from "util";
 
+// src/cli-output.ts
+var ESC = "\x1B[";
+var RESET = `${ESC}0m`;
+var BOLD = `${ESC}1m`;
+var DIM = `${ESC}2m`;
+var FG = {
+  red: `${ESC}31m`,
+  green: `${ESC}32m`,
+  yellow: `${ESC}33m`,
+  blue: `${ESC}34m`,
+  cyan: `${ESC}36m`,
+  gray: `${ESC}90m`
+};
+function c(color, text) {
+  return `${FG[color]}${text}${RESET}`;
+}
+function bold(text) {
+  return `${BOLD}${text}${RESET}`;
+}
+function dim(text) {
+  return `${DIM}${text}${RESET}`;
+}
+function summarizeFindings(findings) {
+  const counts = { auth: 0, admin: 0, pii: 0, postAsRead: 0, other: 0 };
+  for (const f of findings) {
+    const msg = f.message.toLowerCase();
+    if (msg.includes("sign-in") || msg.includes("auth") || msg.includes("session")) {
+      counts.auth++;
+    } else if (msg.includes("admin")) {
+      counts.admin++;
+    } else if (msg.includes("pii") || msg.includes("email")) {
+      counts.pii++;
+    } else if (msg.includes("post") && msg.includes("read")) {
+      counts.postAsRead++;
+    } else {
+      counts.other++;
+    }
+  }
+  return counts;
+}
+function renderSummary(result, setup, _cwd, wiring) {
+  const { tools, findings, skipped } = result;
+  const reads = tools.filter((t) => t.sideEffect === "read").length;
+  const writes = tools.filter((t) => t.sideEffect === "write").length;
+  const destructives = tools.filter((t) => t.sideEffect === "destructive").length;
+  const enabled = tools.filter((t) => t.enabledByDefault).length;
+  const findingCounts = summarizeFindings(findings);
+  const totalFindings = findings.length;
+  console.log("");
+  console.log(`  ${bold("webmcp-codegen")}`);
+  console.log(dim(`  ${setup.label}`));
+  console.log("");
+  console.log(`  ${c("green", "\u2713")} ${bold(`${tools.length} tools generated`)}`);
+  console.log(dim(`    ${enabled} ready to use, ${tools.length - enabled} start disabled`));
+  if (skipped.length > 0) {
+    console.log(dim(`    ${skipped.length} skipped (webhooks and excluded endpoints)`));
+  }
+  console.log("");
+  if (totalFindings > 0) {
+    console.log(`  ${c("yellow", "!")} ${bold(`${totalFindings} safety note${totalFindings === 1 ? "" : "s"}`)}`);
+    if (findingCounts.auth > 0) {
+      console.log(dim(`    ${findingCounts.auth} auth endpoint${findingCounts.auth === 1 ? "" : "s"} disabled (agents shouldn't sign in)`));
+    }
+    if (findingCounts.admin > 0) {
+      console.log(dim(`    ${findingCounts.admin} admin endpoint${findingCounts.admin === 1 ? "" : "s"} disabled (review each before enabling)`));
+    }
+    if (findingCounts.pii > 0) {
+      console.log(dim(`    ${findingCounts.pii} endpoint${findingCounts.pii === 1 ? "" : "s"} may return personal data`));
+    }
+    if (findingCounts.postAsRead > 0) {
+      console.log(dim(`    ${findingCounts.postAsRead} POST endpoint${findingCounts.postAsRead === 1 ? "" : "s"} treated as read-only (verify this is correct)`));
+    }
+    console.log(dim(`    Run with --verbose to see all details`));
+    console.log("");
+  }
+  const outDir = setup.config.generate[0]?.outDir ?? "src/webmcp";
+  console.log(`  ${c("cyan", "\u2192")} ${bold("Files")} ${outDir}`);
+  if (wiring && !wiring.alreadyWired) {
+    console.log(`  ${c("cyan", "\u2192")} ${bold("Registration")} wired into your app`);
+  }
+  console.log("");
+  console.log(`  ${bold("Next:")} ${c("cyan", "npx webmcp-codegen dev")}`);
+  console.log(dim("  Review your tools, edit descriptions, test them live"));
+  console.log("");
+  console.log(dim(`  Docs: https://webmcp-codegen.vercel.app/docs`));
+  console.log("");
+}
+function renderVerbose(result, setup, _cwd) {
+  const { tools, findings, skipped } = result;
+  console.log("");
+  console.log(bold(`webmcp-codegen`));
+  console.log(dim(`${tools.length} tools from ${setup.label}`));
+  console.log("");
+  if (skipped.length > 0) {
+    console.log(c("gray", "Skipped:"));
+    for (const s of skipped) {
+      console.log(`  ${dim(s.ref)}`);
+      console.log(`    ${dim(s.reason)}`);
+    }
+    console.log("");
+  }
+  const byRisk = {
+    read: tools.filter((t) => t.sideEffect === "read"),
+    write: tools.filter((t) => t.sideEffect === "write"),
+    destructive: tools.filter((t) => t.sideEffect === "destructive")
+  };
+  const riskLabels = {
+    read: c("green", "Read-only"),
+    write: c("yellow", "Write"),
+    destructive: c("red", "Destructive")
+  };
+  for (const [risk, group] of Object.entries(byRisk)) {
+    if (group.length === 0) continue;
+    console.log(riskLabels[risk] ?? risk);
+    for (const tool of group) {
+      const status = tool.enabledByDefault ? "" : dim(" (disabled)");
+      console.log(`  ${tool.name}${status}`);
+      if (tool.description) console.log(`    ${dim(tool.description)}`);
+    }
+    console.log("");
+  }
+  if (findings.length > 0) {
+    console.log(bold("Safety notes:"));
+    for (const f of findings) {
+      const icon = f.level === "error" ? c("red", "\u2716") : c("yellow", "\u26A0");
+      const where = f.tool ? dim(` (${f.tool})`) : "";
+      console.log(`  ${icon} ${f.message}${where}`);
+    }
+    console.log("");
+  }
+  console.log(dim(`Files: ${setup.config.generate[0]?.outDir ?? "src/webmcp"}`));
+  console.log(dim(`Docs: https://webmcp-codegen.vercel.app/docs`));
+  console.log("");
+}
+
 // src/wire.ts
 import { readFile, writeFile } from "fs/promises";
 import { dirname, join, relative } from "path";
@@ -151,38 +286,46 @@ async function firstExisting(paths) {
 }
 
 // src/cli.ts
-var HELP = `webmcp-codegen: generate WebMCP tools from the API contracts you already have
+var HELP = `
+webmcp-codegen \u2014 generate WebMCP tools from your OpenAPI spec
 
-Fastest start (no install, no config):
-  npx webmcp-codegen generate --dry-run   Detect your spec, preview the tools
-  npx webmcp-codegen generate             Write the tool files, wire them up
+Usage
+  npx webmcp-codegen [command] [flags]
 
-Commands:
-  init                         Write a codegen.config.mjs for full control
-  generate                     Generate (or update) your WebMCP tools
-  generate --watch             Re-generate when files change
-  dev                          Open the tools dashboard (list, edit, try tools)
+Commands
+  generate    Generate tool files from your spec (default when no command given)
+  dev         Open the tools dashboard (list, describe, toggle, test)
+  init        Write a codegen.config.mjs for full control
 
-Flags for generate:
+Flags
   --spec PATH    Which OpenAPI spec to use (auto-detected when omitted)
-  --out DIR      Where the tool files go (default: your web app's src/webmcp)
+  --out DIR      Where tool files go (default: your web app's src/webmcp)
   --dry-run      Preview what would be written, write nothing
-  --skip-audit   Skip the safety report
+  --verbose      Show every tool, not just the summary
   --force        Write files even when the audit reports errors
+  --skip-audit   Skip the safety report
   --config PATH  Use a config file at PATH
-
-Flags for dev:
   --port N       Dashboard port (default: 4700)
+  --help         Show this help
+
+Examples
+  npx webmcp-codegen generate              # detect spec, generate tools
+  npx webmcp-codegen generate --dry-run    # preview without writing
+  npx webmcp-codegen dev                   # open the dashboard
+  npx webmcp-codegen generate --verbose    # see all 72 tools listed
+
+Docs
+  https://webmcp-codegen.vercel.app/docs
 `;
-var CONFIG_FILE = "codegen.config.mjs";
-var MAX_LISTED_TOOLS = 15;
 async function main() {
-  const { positionals, values } = parseArgs({
+  const { values, positionals } = parseArgs({
+    args: process.argv.slice(2),
     allowPositionals: true,
     options: {
       "dry-run": { type: "boolean", default: false },
       "skip-audit": { type: "boolean", default: false },
       force: { type: "boolean", default: false },
+      verbose: { type: "boolean", default: false },
       watch: { type: "boolean", default: false },
       config: { type: "string" },
       spec: { type: "string" },
@@ -191,28 +334,32 @@ async function main() {
       help: { type: "boolean", default: false }
     }
   });
-  const command = positionals[0];
-  if (values.help || !command) {
+  const flags = {
+    dryRun: values["dry-run"] ?? false,
+    skipAudit: values["skip-audit"] ?? false,
+    force: values.force ?? false,
+    verbose: values.verbose ?? false,
+    watch: values.watch ?? false,
+    config: values.config,
+    spec: values.spec,
+    out: values.out,
+    port: values.port ? Number.parseInt(values.port, 10) : void 0,
+    help: values.help
+  };
+  if (flags.help) {
     console.log(HELP);
     return 0;
   }
+  const command = positionals[0] ?? "generate";
   switch (command) {
     case "init":
       return init();
     case "dev":
-      return dev(Number.parseInt(values.port ?? "4700", 10));
+      return dev(flags.port ?? 4700);
     case "generate":
-      return generate({
-        dryRun: values["dry-run"],
-        skipAudit: values["skip-audit"],
-        force: values.force,
-        watch: values.watch,
-        configPath: values.config,
-        spec: values.spec,
-        out: values.out
-      });
+      return generate(flags);
     default:
-      console.error(`Unknown command "${command}".
+      console.error(`Unknown command: ${command}
 `);
       console.log(HELP);
       return 1;
@@ -220,9 +367,12 @@ async function main() {
 }
 async function init() {
   const cwd = process.cwd();
-  const configPath = join2(cwd, CONFIG_FILE);
+  const configFile = CONFIG_FILE_NAMES[0] ?? "codegen.config.mjs";
+  const configPath = join2(cwd, configFile);
   if (existsSync(configPath)) {
-    console.error(`${CONFIG_FILE} already exists. Nothing to do.`);
+    console.error(`
+\u2716 ${configFile} already exists. Nothing to do.
+`);
     return 1;
   }
   const specs = await findSpecs(cwd);
@@ -245,40 +395,48 @@ export default defineConfig({
 });
 `
   );
-  console.log("Installed the package? A config file needs it:");
-  console.log("  npm install -D webmcp-codegen\n");
-  if (specs.length > 0) {
-    console.log(`Found ${specs[0]}. Wrote ${CONFIG_FILE}.`);
-    console.log("\nNext: npx webmcp-codegen generate --dry-run");
-  } else {
-    console.log(`No OpenAPI spec found, so ${CONFIG_FILE} points at ./openapi.yaml.`);
-    console.log("Edit the `spec` path to point at your spec, then run:");
-    console.log("\n  npx webmcp-codegen generate --dry-run");
-  }
+  console.log(`
+\u2714 Wrote ${configFile}
+`);
+  console.log("Edit it to add sources, change the output directory, or set safety options.");
+  console.log("Docs: https://webmcp-codegen.vercel.app/docs/configuration\n");
   return 0;
 }
-async function generate(flags) {
+async function dev(port) {
   const cwd = process.cwd();
-  if (flags.watch) {
-    await watchLoop(cwd, flags);
-    return 0;
-  }
-  const result = await runOnce(cwd, flags);
-  return result.blocked ? 1 : 0;
+  const server = await startDevServer({ cwd, port, open: true });
+  console.log(`
+\u2714 Dashboard: http://localhost:${port}
+`);
+  console.log("List, describe, enable, and test your tools. Ctrl+C to stop.\n");
+  await new Promise((resolveExit) => {
+    process.on("SIGINT", () => {
+      server.close();
+      resolveExit();
+    });
+  });
+  return 0;
 }
-async function runOnce(cwd, flags) {
-  const setup = await resolveSetup(cwd, flags);
-  const data = await loadDataFile(cwd);
+async function generate(flags) {
+  const cwd = process.cwd();
+  const setup = await resolveSetup(cwd, {
+    dryRun: flags.dryRun,
+    skipAudit: flags.skipAudit,
+    force: flags.force,
+    watch: flags.watch,
+    spec: flags.spec,
+    out: flags.out,
+    configPath: flags.config
+  });
   const result = await runGenerate(setup.config, {
     cwd,
     dryRun: flags.dryRun,
-    skipAudit: flags.skipAudit,
     force: flags.force,
-    overrides: data.overrides
+    skipAudit: flags.skipAudit
   });
   let wiring = null;
   if (!result.blocked && setup.app) {
-    const outDir = findOutDir(setup.config);
+    const outDir = setup.config.generate[0]?.outDir;
     if (outDir) {
       wiring = await planWiring(cwd, setup.app, outDir);
       if (wiring && wiring.edits.length > 0 && !flags.dryRun && result.wrote) {
@@ -289,143 +447,22 @@ async function runOnce(cwd, flags) {
   if (!setup.fromConfigFile && !flags.dryRun && result.wrote) {
     await saveDataFile(cwd, setup.remember);
   }
-  printReport(result, flags, setup, wiring, cwd);
-  return result;
-}
-function findOutDir(config) {
-  return config.generate[0]?.outDir;
-}
-function printReport(result, flags, setup, wiring, cwd) {
-  const { tools, skipped, findings, files, notes, blocked } = result;
-  console.log(`
-webmcp-codegen (${setup.label}): ${tools.length} tool(s)`);
-  for (const note of notes) {
-    console.log(`
-  note: ${note}`);
-  }
-  if (skipped.length > 0) {
-    console.log(`
-  ${skipped.length} endpoint(s) skipped:`);
-    for (const entry of skipped) {
-      console.log(`    ${entry.ref}: ${entry.reason}`);
-    }
-  }
-  console.log("");
-  const listed = tools.slice(0, MAX_LISTED_TOOLS);
-  for (const tool of listed) {
-    const state = tool.enabledByDefault ? "" : "  starts disabled";
-    console.log(`  ${tool.name}  [${tool.sideEffect}]${state}  \u2190 ${tool.source.ref}`);
-  }
-  if (tools.length > listed.length) {
-    console.log(`  \u2026and ${tools.length - listed.length} more`);
-  }
-  if (findings.length > 0) {
-    console.log("");
-    for (const finding of findings) {
-      const icon = finding.level === "error" ? "\u2716" : "\u26A0";
-      const where = finding.tool ? ` (${finding.tool})` : "";
-      console.log(`  ${icon} ${finding.message}${where}`);
-    }
-  }
-  if (files.length > 0) {
-    console.log("");
-    for (const file of files) {
-      if (file.action === "unchanged" && !file.conflict) continue;
-      const shown = file.conflict ? `conflict \u2192 wrote ${relative2(cwd, file.conflict)}` : file.action;
-      console.log(`  ${shown}: ${relative2(cwd, file.path)}`);
-    }
-  }
-  if (wiring) {
-    if (wiring.alreadyWired) {
-      console.log("\n  registration: already wired into your app");
-    } else if (wiring.edits.length > 0) {
-      console.log(flags.dryRun ? "\n  registration (would do):" : "\n  registration:");
-      for (const edit of wiring.edits) {
-        console.log(`    ${edit.summary}`);
-      }
-      if (!flags.dryRun) {
-        console.log("    undo: delete the added lines (nothing else was touched)");
-      }
-    }
-  } else if (!blocked && setup.app) {
-    console.log("\n  registration: could not find your app's entry file, so add this by hand:");
-    console.log('    import { registerAllTools } from "<path-to>/src/webmcp";');
-    console.log("    void registerAllTools();");
-  }
-  if (blocked) {
-    console.log(
-      "\nGeneration blocked by audit errors. Fix them, or re-run with --force to write anyway."
-    );
-    return;
+  if (flags.verbose) {
+    renderVerbose(result, setup, cwd);
+  } else {
+    renderSummary(result, setup, cwd, wiring);
   }
-  if (flags.dryRun) {
-    console.log("\nDry run: nothing written. Re-run without --dry-run to write these files.");
-    return;
+  if (flags.watch && !flags.dryRun) {
+    console.log(dim("\n  --watch is not implemented yet. Run generate again after changes.\n"));
   }
-  printNextSteps(result);
+  return result.blocked ? 1 : 0;
 }
-function printNextSteps(result) {
-  const enabled = result.tools.filter((tool) => tool.enabledByDefault);
-  const disabled = result.tools.filter((tool) => !tool.enabledByDefault);
-  const parts = [];
-  if (enabled.length > 0) parts.push(`${enabled.length} read tool(s) work out of the box`);
-  if (disabled.length > 0) {
-    parts.push(`${disabled.length} tool(s) start disabled (open the file and uncomment to enable)`);
+main().then(
+  (code) => process.exit(code),
+  (error) => {
+    console.error("\n\u2716 Unexpected error:", error instanceof Error ? error.message : error);
+    console.error("\nPlease report this: https://github.com/SouravInsights/groundstate/issues\n");
+    process.exit(1);
   }
-  console.log(`
-Done. ${parts.join("; ")}.`);
-  const suggestion = pickSuggestedTool(result.tools);
-  console.log("\nTry it:");
-  console.log("  1. Start your app and open it in Chrome.");
-  console.log("  2. Turn on chrome://flags/#enable-webmcp-testing and reload the page.");
-  if (suggestion) {
-    console.log(`  3. Ask the agent: "${suggestion}"`);
-  } else {
-    console.log("  3. Ask the agent to use one of your tools.");
-  }
-}
-function pickSuggestedTool(tools) {
-  const reads = tools.filter((tool2) => tool2.enabledByDefault && tool2.endpointRole === "endpoint");
-  if (reads.length === 0) return void 0;
-  const tool = reads.find((candidate) => /^(list|get|search|find|fetch|recent)-/.test(candidate.name)) ?? reads[0];
-  if (!tool) return void 0;
-  const description = tool.description.trim().replace(/\.$/, "");
-  const looksTemplated = /^(GET|POST|PUT|PATCH|DELETE)\s/.test(description);
-  const phrase = looksTemplated ? tool.name.replace(/-/g, " ") : description.charAt(0).toLowerCase() + description.slice(1);
-  return phrase;
-}
-async function dev(port) {
-  const { startDevServer } = await import("./server-DWP6IHCS.js");
-  const server = await startDevServer({ cwd: process.cwd(), port });
-  console.log(`
-webmcp-codegen dashboard: http://localhost:${port}`);
-  console.log("List, describe, enable, and try your tools. Ctrl+C to stop.\n");
-  await new Promise((resolveExit) => {
-    process.on("SIGINT", () => {
-      server.close();
-      resolveExit();
-    });
-  });
-  return 0;
-}
-async function watchLoop(cwd, flags) {
-  await runOnce(cwd, { ...flags, dryRun: false });
-  console.log("\nWatching for changes\u2026 (Ctrl+C to stop)");
-  let timer;
-  watch(cwd, { recursive: true }, (_event, filename) => {
-    if (!filename) return;
-    if (/node_modules|\.git|\/dist|\/src\/webmcp|\.webmcp-codegen\.json/.test(filename)) return;
-    if (!/\.(ya?ml|json|ts|tsx|mts|mjs)$/.test(filename)) return;
-    clearTimeout(timer);
-    timer = setTimeout(() => {
-      runOnce(cwd, { ...flags, dryRun: false }).catch((error) => {
-        console.error(error instanceof Error ? error.message : error);
-      });
-    }, 300);
-  });
-}
-main().then((code) => process.exit(code)).catch((error) => {
-  console.error(error instanceof Error ? error.message : error);
-  process.exit(1);
-});
+);
 //# sourceMappingURL=cli.js.map