@polterware/polter 0.3.1 → 0.4.1

package/dist/mcp.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
-import "./chunk-AGVTFYXU.js";
+import {
+  createIpcClient
+} from "./chunk-VYHW3UNY.js";
 import {
   __export,
   allCommands,
@@ -8,12 +10,15 @@ import {
   detectPkgManager,
   executePipeline,
   findPipelineByName,
+  findProcessesByCwd,
+  findRunningByCommand,
   generateProcessId,
   getAllPipelines,
   getCommandById,
   getCommandsByTool,
   getCurrentStatus,
   getProcessOutput,
+  getSocketPath,
   getToolInfo,
   listProcesses,
   parsePolterYaml,
@@ -23,8 +28,9 @@ import {
   runCommand,
   savePipeline,
   startProcess,
-  stopProcess
-} from "./chunk-7MIUDIAI.js";
+  stopProcess,
+  translateCommand
+} from "./chunk-ZHVOYB5M.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -13803,6 +13809,19 @@ import crypto from "crypto";
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
 var TOOL_IDS = ["supabase", "gh", "vercel", "git", "pkg"];
+async function withTuiConnection(method, params, fallback) {
+  const socketPath = getSocketPath();
+  if (!socketPath) return fallback();
+  try {
+    const client = createIpcClient(socketPath);
+    await client.connect();
+    const result = await client.call(method, params);
+    client.disconnect();
+    return result;
+  } catch {
+    return fallback();
+  }
+}
 var server = new McpServer({
   name: "polter",
   version: "0.1.0"
@@ -14119,9 +14138,90 @@ function pkgRunHelper(base, extraArgs = []) {
     { quiet: true }
   ).promise;
 }
+server.tool(
+  "polter_run_script_bg",
+  "Start a package.json script as a tracked background process using the detected package manager (npm/pnpm/yarn/bun). The process output is captured and can be read with polter_logs. Use polter_ps to check status.",
+  {
+    script: external_exports.string().describe("Script name from package.json (e.g. 'dev', 'build', 'test')"),
+    args: external_exports.array(external_exports.string()).optional().describe("Extra arguments to pass to the script"),
+    cwd: external_exports.string().optional().describe("Working directory. Defaults to current directory.")
+  },
+  async ({ script, args: extraArgs, cwd: cwdArg }) => {
+    const cwd = cwdArg ?? process.cwd();
+    const pkgPath = join(cwd, "package.json");
+    if (!existsSync(pkgPath)) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: "No package.json found in " + cwd }) }],
+        isError: true
+      };
+    }
+    const raw = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const scripts = raw.scripts ?? {};
+    if (!scripts[script]) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: `Script "${script}" not found. Available: ${Object.keys(scripts).join(", ")}` }) }],
+        isError: true
+      };
+    }
+    const mgr = detectPkgManager(cwd);
+    try {
+      const translated = translateCommand(["run", script, ...extraArgs ?? []], mgr.id);
+      const existing = await withTuiConnection(
+        "ps.find_running",
+        { cwd, command: mgr.command, args: translated.args },
+        () => findRunningByCommand(cwd, mgr.command, translated.args)
+      );
+      if (existing) {
+        const output2 = await withTuiConnection(
+          "ps.logs",
+          { id: existing.id, tail: 20 },
+          () => getProcessOutput(existing.id, 20)
+        );
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              alreadyRunning: true,
+              process: existing,
+              output: output2
+            }, null, 2)
+          }]
+        };
+      }
+      const id = generateProcessId(mgr.command, translated.args);
+      const info = await withTuiConnection(
+        "ps.start",
+        { command: mgr.command, args: translated.args, cwd, id },
+        () => startProcess(id, mgr.command, translated.args, cwd)
+      );
+      await new Promise((r) => setTimeout(r, 500));
+      const output = await withTuiConnection(
+        "ps.logs",
+        { id, tail: 20 },
+        () => getProcessOutput(id, 20)
+      );
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            process: info,
+            output,
+            packageManager: mgr.id
+          }, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: err.message }) }],
+        isError: true
+      };
+    }
+  }
+);
 server.tool(
   "polter_pkg_build",
-  "Run the build script from package.json using the detected package manager.",
+  "Run the build script from package.json using the detected package manager (npm/pnpm/yarn/bun).",
   {},
   async () => {
     const result = await pkgRunHelper(["run", "build"]);
@@ -14132,7 +14232,7 @@ server.tool(
 );
 server.tool(
   "polter_pkg_publish",
-  "Publish the package to the npm registry.",
+  "Publish the package to the registry using the detected package manager (npm/pnpm/yarn/bun).",
   {
     tag: external_exports.string().optional().describe("Dist-tag (e.g. 'next', 'beta')"),
     dryRun: external_exports.boolean().optional().describe("Simulate publish without uploading")
@@ -14156,7 +14256,7 @@ server.tool(
 );
 server.tool(
   "polter_pkg_install",
-  "Install dependencies. Optionally install specific packages.",
+  "Install dependencies using the detected package manager (npm/pnpm/yarn/bun). Optionally install specific packages.",
   {
     packages: external_exports.array(external_exports.string()).optional().describe("Specific packages to install"),
     dev: external_exports.boolean().optional().describe("Install as dev dependency")
@@ -14173,7 +14273,7 @@ server.tool(
 );
 server.tool(
   "polter_pkg_run_script",
-  "Run a script defined in package.json.",
+  "Run a script defined in package.json using the detected package manager (npm/pnpm/yarn/bun).",
   {
     script: external_exports.string().describe("Script name to run"),
     args: external_exports.array(external_exports.string()).optional().describe("Extra arguments")
@@ -14187,7 +14287,7 @@ server.tool(
 );
 server.tool(
   "polter_pkg_version_bump",
-  "Bump the package version (semver).",
+  "Bump the package version (semver) using the detected package manager (npm/pnpm/yarn/bun).",
   {
     type: external_exports.enum(["patch", "minor", "major"]).describe("Version bump type")
   },
@@ -14200,7 +14300,7 @@ server.tool(
 );
 server.tool(
   "polter_pkg_audit",
-  "Run a security audit on dependencies.",
+  "Run a security audit on dependencies using the detected package manager (npm/pnpm/yarn/bun).",
   {
     fix: external_exports.boolean().optional().describe("Attempt to fix vulnerabilities")
   },
@@ -14221,7 +14321,7 @@ server.tool(
 );
 server.tool(
   "polter_pkg_info",
-  "Get information about a package from the registry.",
+  "Get information about a package from the registry using the detected package manager (npm/pnpm/yarn/bun).",
   {
     package: external_exports.string().describe("Package name to look up")
   },
@@ -14244,7 +14344,7 @@ server.tool(
   "List all tracked background processes with their status, PID, uptime, and exit info.",
   {},
   async () => {
-    const processes = listProcesses();
+    const processes = await withTuiConnection("ps.list", {}, () => listProcesses());
     return {
       content: [{ type: "text", text: JSON.stringify(processes, null, 2) }]
     };
@@ -14264,7 +14364,11 @@ server.tool(
     const processId = id ?? generateProcessId(command, processArgs);
     const processCwd = cwd ?? process.cwd();
     try {
-      const info = startProcess(processId, command, processArgs, processCwd);
+      const info = await withTuiConnection(
+        "ps.start",
+        { command, args: processArgs, cwd: processCwd, id: processId },
+        () => startProcess(processId, command, processArgs, processCwd)
+      );
       return {
         content: [{ type: "text", text: JSON.stringify({ success: true, process: info }, null, 2) }]
       };
@@ -14286,7 +14390,11 @@ server.tool(
   },
   async ({ id, tail, stream }) => {
     try {
-      const output = getProcessOutput(id, tail, stream);
+      const output = await withTuiConnection(
+        "ps.logs",
+        { id, ...tail !== void 0 ? { tail } : {}, ...stream !== void 0 ? { stream } : {} },
+        () => getProcessOutput(id, tail, stream)
+      );
       return {
         content: [{ type: "text", text: JSON.stringify(output, null, 2) }]
       };
@@ -14306,7 +14414,11 @@ server.tool(
   },
   async ({ id }) => {
     try {
-      const info = await stopProcess(id);
+      const info = await withTuiConnection(
+        "ps.stop",
+        { id },
+        () => stopProcess(id)
+      );
       return {
         content: [{ type: "text", text: JSON.stringify({ success: true, process: info }, null, 2) }]
       };
@@ -14318,6 +14430,130 @@ server.tool(
     }
   }
 );
+server.tool(
+  "polter_smart_start",
+  "Smart process starter: reads package.json, auto-detects package manager, starts a script as a background process. If script is omitted, lists available scripts. If already running, returns current info and recent logs instead of duplicating.",
+  {
+    script: external_exports.string().optional().describe("Script name from package.json (e.g. 'dev', 'build')"),
+    cwd: external_exports.string().optional().describe("Repository directory. Defaults to current directory."),
+    tail: external_exports.number().optional().default(20).describe("Number of initial log lines to return")
+  },
+  async ({ script, cwd: cwdArg, tail }) => {
+    const cwd = cwdArg ?? process.cwd();
+    const pkgPath = join(cwd, "package.json");
+    if (!existsSync(pkgPath)) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: "No package.json found in " + cwd }) }],
+        isError: true
+      };
+    }
+    const raw = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const scripts = raw.scripts ?? {};
+    if (!script) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ scripts: Object.keys(scripts) }, null, 2) }]
+      };
+    }
+    if (!scripts[script]) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: `Script "${script}" not found. Available: ${Object.keys(scripts).join(", ")}` }) }],
+        isError: true
+      };
+    }
+    const mgr = detectPkgManager(cwd);
+    const runArgs = ["run", script];
+    const existing = await withTuiConnection(
+      "ps.find_running",
+      { cwd, command: mgr.command, args: runArgs },
+      () => findRunningByCommand(cwd, mgr.command, runArgs)
+    );
+    if (existing) {
+      const output = await withTuiConnection(
+        "ps.logs",
+        { id: existing.id, tail },
+        () => getProcessOutput(existing.id, tail)
+      );
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            alreadyRunning: true,
+            process: existing,
+            output
+          }, null, 2)
+        }]
+      };
+    }
+    try {
+      const id = generateProcessId(mgr.command, runArgs);
+      const info = await withTuiConnection(
+        "ps.start",
+        { command: mgr.command, args: runArgs, cwd, id },
+        () => startProcess(id, mgr.command, runArgs, cwd)
+      );
+      await new Promise((r) => setTimeout(r, 500));
+      const output = await withTuiConnection(
+        "ps.logs",
+        { id, tail },
+        () => getProcessOutput(id, tail)
+      );
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            alreadyRunning: false,
+            process: info,
+            output,
+            packageManager: mgr.id
+          }, null, 2)
+        }]
+      };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: err.message }) }],
+        isError: true
+      };
+    }
+  }
+);
+server.tool(
+  "polter_find_process",
+  "Find all tracked processes for a repository directory. Returns process info with recent logs embedded. No need to know process IDs \u2014 just point to the repo.",
+  {
+    cwd: external_exports.string().optional().describe("Repository directory. Defaults to current directory."),
+    filter: external_exports.string().optional().describe("Filter by substring in command+args"),
+    tail: external_exports.number().optional().default(20).describe("Number of log lines per process")
+  },
+  async ({ cwd: cwdArg, filter, tail }) => {
+    const cwd = cwdArg ?? process.cwd();
+    const processes = await withTuiConnection(
+      "ps.find_by_cwd",
+      { cwd, ...filter ? { filter } : {} },
+      () => {
+        let procs = findProcessesByCwd(cwd);
+        if (filter) {
+          const f = filter.toLowerCase();
+          procs = procs.filter(
+            (proc) => (proc.command + " " + proc.args.join(" ")).toLowerCase().includes(f)
+          );
+        }
+        return procs;
+      }
+    );
+    const results = [];
+    for (const proc of processes) {
+      const output = await withTuiConnection(
+        "ps.logs",
+        { id: proc.id, tail },
+        () => getProcessOutput(proc.id, tail)
+      );
+      results.push({ process: proc, output });
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify(results, null, 2) }]
+    };
+  }
+);
 server.resource(
   "package-json",
   "polter://package-json",

package/package.json

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