@polterware/polter 0.4.1 → 0.4.2

package/dist/api.js

@@ -1,6 +1,6 @@
 import {
   createIpcClient
-} from "./chunk-VYHW3UNY.js";
+} from "./chunk-XCCKD3RZ.js";
 import {
   allCommands,
   applyActions,
@@ -22,6 +22,8 @@ import {
   getFlagsForTool,
   getMcpStatusInfo,
   getProcessOutput,
+  getSkillContent,
+  getSkillPath,
   getSocketPath,
   getToolDisplayName,
   getToolInfo,
@@ -30,17 +32,20 @@ import {
   listProcesses,
   parsePolterYaml,
   planChanges,
+  registerForegroundProcess,
   removeMcpServerSilent,
   removeProcess,
   resolvePkgArgs,
   resolveToolCommand,
   runCommand,
   savePipeline,
+  setupSkill,
+  setupSkillCli,
   startProcess,
   stopProcess,
   toolFlags,
   translateCommand
-} from "./chunk-ZHVOYB5M.js";
+} from "./chunk-CWBIXRZP.js";
 export {
   allCommands,
   applyActions,
@@ -63,6 +68,8 @@ export {
   getFlagsForTool,
   getMcpStatusInfo,
   getProcessOutput,
+  getSkillContent,
+  getSkillPath,
   getSocketPath,
   getToolDisplayName,
   getToolInfo,
@@ -71,12 +78,15 @@ export {
   listProcesses,
   parsePolterYaml,
   planChanges,
+  registerForegroundProcess,
   removeMcpServerSilent,
   removeProcess,
   resolvePkgArgs,
   resolveToolCommand,
   runCommand,
   savePipeline,
+  setupSkill,
+  setupSkillCli,
   startProcess,
   stopProcess,
   toolFlags,

package/dist/{chunk-ZHVOYB5M.js → chunk-CWBIXRZP.js}

@@ -1030,7 +1030,8 @@ function runCommand(execution, args, cwd = process.cwd(), options) {
         } catch {
         }
       }
-    }
+    },
+    child
   };
 }
 function runInteractiveCommand(execution, args, cwd = process.cwd()) {
@@ -1470,6 +1471,47 @@ function startProcess(id, command, args = [], cwd = process.cwd(), env) {
   registry.set(id, tracked);
   return toProcessInfo(tracked);
 }
+function registerForegroundProcess(id, command, args, cwd, child) {
+  const existing = registry.get(id);
+  if (existing && existing.status === "running") {
+    throw new Error(`Process "${id}" is already running (pid ${existing.child.pid})`);
+  }
+  registerCleanup();
+  const tracked = {
+    id,
+    command,
+    args,
+    cwd,
+    child,
+    status: "running",
+    exitCode: null,
+    signal: null,
+    startedAt: /* @__PURE__ */ new Date(),
+    exitedAt: null,
+    stdout: createRingBuffer(),
+    stderr: createRingBuffer()
+  };
+  child.stdout?.on("data", (data) => {
+    appendToBuffer(tracked.stdout, data.toString());
+  });
+  child.stderr?.on("data", (data) => {
+    appendToBuffer(tracked.stderr, data.toString());
+  });
+  child.on("exit", (code, signal) => {
+    tracked.status = "exited";
+    tracked.exitCode = code;
+    tracked.signal = signal;
+    tracked.exitedAt = /* @__PURE__ */ new Date();
+  });
+  child.on("error", (err) => {
+    tracked.status = "errored";
+    tracked.exitedAt = /* @__PURE__ */ new Date();
+    appendToBuffer(tracked.stderr, `spawn error: ${err.message}
+`);
+  });
+  registry.set(id, tracked);
+  return toProcessInfo(tracked);
+}
 function stopProcess(id) {
   const proc = registry.get(id);
   if (!proc) throw new Error(`No tracked process with id "${id}"`);
@@ -2389,6 +2431,119 @@ async function mcpStatus() {
   }
 }
 
+// src/lib/skillSetup.ts
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, existsSync as existsSync9 } from "fs";
+import { join as join9 } from "path";
+import { homedir as homedir2 } from "os";
+import pc2 from "picocolors";
+var SKILL_DIR = join9(homedir2(), ".claude", "skills", "polter");
+var SKILL_PATH = join9(SKILL_DIR, "SKILL.md");
+var SKILL_CONTENT = `---
+name: polter
+description: "Polter - Infrastructure Orchestrator. Use when developing in any project to: monitor dev processes and check logs for errors after code changes, manage pipelines (multi-step command sequences), run CLI commands (Supabase, GitHub, Vercel, Git), manage packages (install, build, publish, audit), and apply declarative infrastructure from polter.yaml."
+---
+
+# Polter Skill
+
+You have access to Polter MCP tools for infrastructure orchestration. Use them proactively during development.
+
+## Process Monitoring
+
+**Tools:** \`polter_ps\`, \`polter_logs\`, \`polter_start\`, \`polter_stop\`, \`polter_find_process\`, \`polter_smart_start\`, \`polter_run_script_bg\`
+
+- At the start of a session, run \`polter_ps\` to check for active dev processes
+- After significant code edits, check \`polter_logs\` for compilation or runtime errors
+- Use \`polter_find_process\` to find processes running in the current directory
+- Use \`polter_smart_start\` to start package.json scripts as background processes (e.g. dev servers)
+- Use \`polter_run_script_bg\` to run arbitrary scripts in the background
+- Use \`polter_stop\` to stop processes that are no longer needed
+
+## CLI Commands
+
+**Tools:** \`polter_list_commands\`, \`polter_run_command\`, \`polter_status\`
+
+- Execute commands for Supabase, GitHub CLI, Vercel, and Git via their command IDs
+- Use \`polter_list_commands\` to discover available commands, optionally filtered by tool
+- Use \`polter_run_command\` to execute a command by its ID with additional args/flags
+- Check \`polter_status\` to see which CLI tools are installed and their versions
+
+## Pipelines
+
+**Tools:** \`polter_list_pipelines\`, \`polter_run_pipeline\`, \`polter_create_pipeline\`, \`polter_update_pipeline\`, \`polter_delete_pipeline\`
+
+- List and run saved multi-step command sequences with \`polter_list_pipelines\` and \`polter_run_pipeline\`
+- Create new pipelines for repetitive workflows (e.g. build + test + deploy) with \`polter_create_pipeline\`
+- Suggest creating pipelines when you notice the user repeating the same sequence of commands
+
+## Package Management
+
+**Tools:** \`polter_pkg_build\`, \`polter_pkg_install\`, \`polter_pkg_publish\`, \`polter_pkg_run_script\`, \`polter_pkg_version_bump\`, \`polter_pkg_audit\`, \`polter_pkg_info\`
+
+- Auto-detects the package manager (npm, pnpm, yarn, bun) from lockfiles
+- Use \`polter_pkg_build\` for building, \`polter_pkg_install\` for installing dependencies
+- Use \`polter_pkg_run_script\` to run package.json scripts
+- Use \`polter_pkg_audit\` to check for vulnerabilities
+- Use \`polter_pkg_version_bump\` before publishing, then \`polter_pkg_publish\`
+
+## Declarative Infrastructure
+
+**Tools:** \`polter_plan\`, \`polter_apply\`
+
+- Use \`polter_plan\` to read \`polter.yaml\` and compute a diff of desired vs current state
+- Use \`polter_apply\` to execute the planned infrastructure changes
+- Always run \`polter_plan\` first to review changes before applying
+
+## Workflow Recommendations
+
+1. **Starting a session:** Run \`polter_ps\` to see what's already running
+2. **After code changes:** Check \`polter_logs\` for errors in dev server output
+3. **Setting up a project:** Use \`polter_status\` to verify tools, then \`polter_smart_start\` for dev server
+4. **Deploying:** Create a pipeline with build + test + deploy steps
+5. **Infrastructure changes:** Edit \`polter.yaml\`, run \`polter_plan\`, then \`polter_apply\`
+`;
+function setupSkill() {
+  if (existsSync9(SKILL_PATH)) {
+    const existing = readFileSync5(SKILL_PATH, "utf-8");
+    if (existing === SKILL_CONTENT) {
+      return { status: "already-up-to-date", path: SKILL_PATH };
+    }
+    writeFileSync3(SKILL_PATH, SKILL_CONTENT, "utf-8");
+    return { status: "updated", path: SKILL_PATH };
+  }
+  mkdirSync4(SKILL_DIR, { recursive: true });
+  writeFileSync3(SKILL_PATH, SKILL_CONTENT, "utf-8");
+  return { status: "created", path: SKILL_PATH };
+}
+function setupSkillCli() {
+  const result = setupSkill();
+  switch (result.status) {
+    case "created":
+      process.stdout.write(pc2.green(`
+  Skill installed at ${result.path}
+`));
+      process.stdout.write(pc2.dim("  Use /polter in Claude Code to activate.\n\n"));
+      break;
+    case "updated":
+      process.stdout.write(pc2.green(`
+  Skill updated at ${result.path}
+`));
+      process.stdout.write(pc2.dim("  Use /polter in Claude Code to activate.\n\n"));
+      break;
+    case "already-up-to-date":
+      process.stdout.write(pc2.cyan(`
+  Skill already up to date at ${result.path}
+
+`));
+      break;
+  }
+}
+function getSkillContent() {
+  return SKILL_CONTENT;
+}
+function getSkillPath() {
+  return SKILL_PATH;
+}
+
 export {
   __export,
   allCommands,
@@ -2414,6 +2569,7 @@ export {
   findNearestPackageRoot,
   generateProcessId,
   startProcess,
+  registerForegroundProcess,
   stopProcess,
   listProcesses,
   getProcessOutput,
@@ -2443,5 +2599,9 @@ export {
   getMcpStatusInfo,
   installMcpServerSilent,
   removeMcpServerSilent,
-  mcpStatus
+  mcpStatus,
+  setupSkill,
+  setupSkillCli,
+  getSkillContent,
+  getSkillPath
 };

package/dist/{chunk-VYHW3UNY.js → chunk-XCCKD3RZ.js}

@@ -1,7 +1,7 @@
 import {
   parseMessages,
   serializeMessage
-} from "./chunk-ZHVOYB5M.js";
+} from "./chunk-CWBIXRZP.js";
 
 // src/lib/ipcClient.ts
 import net from "net";