@polterware/polter 0.1.0 → 0.1.1

package/dist/index.js

@@ -3832,6 +3832,12 @@ function parseCliArgs(argv) {
   if (argv_[0] === "pipeline" && argv_[1] === "run" && argv_[2]) {
     return { mode: "pipeline-run", options: {}, pipelineName: argv_[2] };
   }
+  if (argv_[0] === "mcp" && argv_[1] === "install") {
+    let mcpScope = "local";
+    if (argv_.includes("--project")) mcpScope = "project";
+    else if (argv_.includes("--global")) mcpScope = "user";
+    return { mode: "mcp-install", options: {}, mcpScope };
+  }
   if (argv_[0] === "config") {
     const edit = argv_.includes("--edit");
     return { mode: "config", options: {}, configEdit: edit, classic };
@@ -3916,6 +3922,9 @@ function printCliHelp() {
       "  polter plan                      Show declarative state diff",
       "  polter apply                     Apply declarative state changes",
       "  polter status                    Show current tool status",
+      "  polter mcp install               Install Polter MCP server into Claude Code (local scope)",
+      "  polter mcp install --project     Install for this project only (shared via repo)",
+      "  polter mcp install --global      Install globally for all projects",
       "",
       "  polter app setup ops [--path <dir>] [--create-project|--use-existing-project] [--yes]",
       "  polter app link ops [--path <dir>] [--relink]",
@@ -4736,14 +4745,94 @@ async function runAppCli(options) {
   });
 }
 
-// src/index.tsx
+// src/lib/mcpInstaller.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, existsSync as existsSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir2 } from "os";
 import pc4 from "picocolors";
+var MCP_ARGS = ["npx", "-y", "-p", "@polterware/polter", "polter-mcp"];
+var SCOPE_LABELS = {
+  local: "local (this machine)",
+  project: "project (shared via repo)",
+  user: "global (all projects)"
+};
+function tryClaudeCli(scope) {
+  if (!commandExists("claude")) return false;
+  const result = spawnSync2("claude", ["mcp", "add", "-s", scope, "polter", "--", ...MCP_ARGS], {
+    stdio: "inherit",
+    shell: true
+  });
+  return result.status === 0;
+}
+function getSettingsPath(scope) {
+  if (scope === "project") {
+    return join3(process.cwd(), ".mcp.json");
+  }
+  return join3(homedir2(), ".claude", "settings.json");
+}
+function tryManualInstall(scope) {
+  const settingsPath = getSettingsPath(scope);
+  const dir = join3(settingsPath, "..");
+  let settings = {};
+  if (existsSync2(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync2(settingsPath, "utf-8"));
+    } catch {
+      process.stderr.write(pc4.red(`Failed to parse ${settingsPath}
+`));
+      return false;
+    }
+  } else {
+    mkdirSync2(dir, { recursive: true });
+  }
+  const mcpServers = settings.mcpServers ?? {};
+  mcpServers.polter = {
+    command: "npx",
+    args: ["-y", "-p", "@polterware/polter", "polter-mcp"]
+  };
+  settings.mcpServers = mcpServers;
+  writeFileSync2(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  return true;
+}
+async function installMcpServer(scope) {
+  process.stdout.write(pc4.bold(`Installing Polter MCP server \u2014 ${SCOPE_LABELS[scope]}
+
+`));
+  if (commandExists("claude")) {
+    process.stdout.write(`  Using 'claude mcp add -s ${scope}'...
+`);
+    if (tryClaudeCli(scope)) {
+      process.stdout.write(pc4.green("\n  Done! Restart Claude Code to use Polter tools.\n"));
+      return;
+    }
+    process.stdout.write(pc4.yellow("  'claude mcp add' failed, falling back to manual install...\n\n"));
+  }
+  const settingsPath = getSettingsPath(scope);
+  process.stdout.write(`  Writing to ${settingsPath}...
+`);
+  if (tryManualInstall(scope)) {
+    process.stdout.write(pc4.green("\n  Done! Restart Claude Code to use Polter tools.\n"));
+  } else {
+    process.stderr.write(pc4.red("\n  Failed to install. Add manually:\n\n"));
+    process.stderr.write(`  ${pc4.dim(JSON.stringify({ mcpServers: { polter: { command: "npx", args: ["-y", "-p", "@polterware/polter", "polter-mcp"] } } }, null, 2))}
+`);
+    process.exit(1);
+  }
+}
+
+// src/index.tsx
+import pc5 from "picocolors";
 async function main() {
   const parsed = parseCliArgs(process.argv.slice(2));
   if (parsed.mode === "help") {
     printCliHelp();
     return;
   }
+  if (parsed.mode === "mcp-install") {
+    await installMcpServer(parsed.mcpScope ?? "local");
+    return;
+  }
   if (parsed.mode === "app") {
     const exitCode = await runAppCli(parsed.options);
     process.exit(exitCode);
@@ -4755,7 +4844,7 @@ async function main() {
 `);
       process.exit(1);
     }
-    process.stdout.write(pc4.bold(`Running pipeline: ${pipeline.name}
+    process.stdout.write(pc5.bold(`Running pipeline: ${pipeline.name}
 `));
     const results = await executePipeline(pipeline, (progress) => {
       if (progress.done) return;
@@ -4769,24 +4858,24 @@ async function main() {
     });
     const errors = results.filter((r) => r.status === "error");
     if (errors.length > 0) {
-      process.stderr.write(pc4.red(`
+      process.stderr.write(pc5.red(`
 Pipeline completed with ${errors.length} error(s)
 `));
       process.exit(1);
     }
-    process.stdout.write(pc4.green("\nPipeline completed successfully!\n"));
+    process.stdout.write(pc5.green("\nPipeline completed successfully!\n"));
     return;
   }
   if (parsed.mode === "status") {
     const tools = ["supabase", "gh", "vercel"];
-    process.stdout.write(pc4.bold("Tool Status\n\n"));
+    process.stdout.write(pc5.bold("Tool Status\n\n"));
     for (const toolId of tools) {
       const info = getToolInfo(toolId);
-      const status = info.installed ? pc4.green(`\u2713 ${info.label} ${info.version ?? ""}`) : pc4.red(`\u2717 ${info.label} not found`);
+      const status = info.installed ? pc5.green(`\u2713 ${info.label} ${info.version ?? ""}`) : pc5.red(`\u2717 ${info.label} not found`);
       process.stdout.write(`  ${status}
 `);
     }
-    process.stdout.write(pc4.bold("\nProject Status\n\n"));
+    process.stdout.write(pc5.bold("\nProject Status\n\n"));
     const projectStatus = getCurrentStatus();
     if (projectStatus.supabase) {
       process.stdout.write(`  Supabase: ${projectStatus.supabase.linked ? "linked" : "not linked"}
@@ -4810,15 +4899,15 @@ Pipeline completed with ${errors.length} error(s)
     }
     const plan = planChanges(yaml);
     if (plan.noChanges) {
-      process.stdout.write(pc4.green("No changes needed. State is up to date.\n"));
+      process.stdout.write(pc5.green("No changes needed. State is up to date.\n"));
       return;
     }
-    process.stdout.write(pc4.bold(`Plan: ${plan.actions.length} action(s)
+    process.stdout.write(pc5.bold(`Plan: ${plan.actions.length} action(s)
 
 `));
     for (const action of plan.actions) {
       const prefix = action.action === "create" ? "+" : action.action === "delete" ? "-" : "~";
-      const color = action.action === "create" ? pc4.green : action.action === "delete" ? pc4.red : pc4.yellow;
+      const color = action.action === "create" ? pc5.green : action.action === "delete" ? pc5.red : pc5.yellow;
       process.stdout.write(`  ${color(`${prefix} [${action.tool}] ${action.description}`)}
 `);
     }
@@ -4832,10 +4921,10 @@ Pipeline completed with ${errors.length} error(s)
     }
     const plan = planChanges(yaml);
     if (plan.noChanges) {
-      process.stdout.write(pc4.green("No changes needed. State is up to date.\n"));
+      process.stdout.write(pc5.green("No changes needed. State is up to date.\n"));
       return;
     }
-    process.stdout.write(pc4.bold(`Applying ${plan.actions.length} action(s)...
+    process.stdout.write(pc5.bold(`Applying ${plan.actions.length} action(s)...
 
 `));
     const results = await applyActions(plan.actions, process.cwd(), (i, total, action) => {
@@ -4844,16 +4933,16 @@ Pipeline completed with ${errors.length} error(s)
     });
     const errors = results.filter((r) => !r.success);
     if (errors.length > 0) {
-      process.stderr.write(pc4.red(`
+      process.stderr.write(pc5.red(`
 Apply completed with ${errors.length} error(s).
 `));
       for (const err of errors) {
-        process.stderr.write(pc4.red(`  \u2717 ${err.action.description}
+        process.stderr.write(pc5.red(`  \u2717 ${err.action.description}
 `));
       }
       process.exit(1);
     }
-    process.stdout.write(pc4.green("\nAll changes applied successfully!\n"));
+    process.stdout.write(pc5.green("\nAll changes applied successfully!\n"));
     return;
   }
   if (parsed.mode === "config") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polterware/polter",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "An interactive CLI for managing Supabase CLI workflows.",
   "type": "module",
   "bin": {