@polterware/polter 0.3.1 → 0.4.0

package/dist/mcp.js

@@ -8,6 +8,8 @@ import {
   detectPkgManager,
   executePipeline,
   findPipelineByName,
+  findProcessesByCwd,
+  findRunningByCommand,
   generateProcessId,
   getAllPipelines,
   getCommandById,
@@ -23,8 +25,9 @@ import {
   runCommand,
   savePipeline,
   startProcess,
-  stopProcess
-} from "./chunk-7MIUDIAI.js";
+  stopProcess,
+  translateCommand
+} from "./chunk-YNOZDU75.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -14119,9 +14122,72 @@ 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 = findRunningByCommand(cwd, mgr.command, translated.args);
+      if (existing) {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              alreadyRunning: true,
+              process: existing,
+              output: getProcessOutput(existing.id, 20)
+            }, null, 2)
+          }]
+        };
+      }
+      const id = generateProcessId(mgr.command, translated.args);
+      const info = startProcess(id, mgr.command, translated.args, cwd);
+      await new Promise((r) => setTimeout(r, 500));
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            success: true,
+            process: info,
+            output: getProcessOutput(id, 20),
+            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 +14198,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 +14222,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 +14239,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 +14253,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 +14266,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 +14287,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")
   },
@@ -14318,6 +14384,100 @@ 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 = findRunningByCommand(cwd, mgr.command, runArgs);
+    if (existing) {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            alreadyRunning: true,
+            process: existing,
+            output: getProcessOutput(existing.id, tail)
+          }, null, 2)
+        }]
+      };
+    }
+    try {
+      const id = generateProcessId(mgr.command, runArgs);
+      const info = startProcess(id, mgr.command, runArgs, cwd);
+      await new Promise((r) => setTimeout(r, 500));
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            alreadyRunning: false,
+            process: info,
+            output: getProcessOutput(id, tail),
+            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();
+    let processes = findProcessesByCwd(cwd);
+    if (filter) {
+      const f = filter.toLowerCase();
+      processes = processes.filter(
+        (proc) => (proc.command + " " + proc.args.join(" ")).toLowerCase().includes(f)
+      );
+    }
+    const result = processes.map((proc) => ({
+      process: proc,
+      output: getProcessOutput(proc.id, tail)
+    }));
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, 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.0",
   "description": "An interactive CLI for managing Supabase CLI workflows.",
   "type": "module",
   "bin": {