getprismo 0.1.36 → 0.1.37

package/lib/prismo-dev/cli.js

@@ -3,7 +3,7 @@ const { printHelp, printCommandHelp } = require("./help");
 
 const VALID_COMMANDS = new Set([
   "dev", "init", "doctor", "firewall", "benchmark", "shield", "mcp",
-  "connect", "sync", "status", "disconnect", "agent", "setup", "scan",
+  "connect", "sync", "status", "disconnect", "agent", "connector", "setup", "scan",
   "optimize", "context", "cc", "cursor", "receipt", "instructions",
   "timeline", "replay", "boundaries", "usage", "guard", "watch", "demo",
 ]);
@@ -70,6 +70,12 @@ function createCli(deps) {
     runGuard,
     renderAgentTerminal,
     runAgent,
+    renderConnectorTerminal,
+    runConnectorInstall,
+    runConnectorStart,
+    runConnectorStatus,
+    runConnectorStop,
+    runConnectorUninstall,
     renderInstructionsAblationTerminal,
     renderInstructionsApplyTerminal,
     renderInstructionsAuditTerminal,
@@ -131,7 +137,7 @@ function createCli(deps) {
       return;
     }
     if (!VALID_COMMANDS.has(command)) {
-      throw new Error(`Unknown command: ${command}. Try: prismo connect, prismo agent, prismo guard, prismo sync, prismo doctor, prismo watch, prismo receipt, prismo benchmark, prismo shield, prismo mcp, prismo firewall, prismo init, prismo scan, prismo optimize, prismo context, prismo cc, prismo cursor, or prismo usage`);
+      throw new Error(`Unknown command: ${command}. Try: prismo connect, prismo connector, prismo agent, prismo guard, prismo sync, prismo doctor, prismo watch, prismo receipt, prismo benchmark, prismo shield, prismo mcp, prismo firewall, prismo init, prismo scan, prismo optimize, prismo context, prismo cc, prismo cursor, or prismo usage`);
     }
 
     if (command === "demo") {
@@ -314,6 +320,14 @@ function createCli(deps) {
       const userIndex = rest.indexOf("--user");
       const deviceIndex = rest.indexOf("--device");
       const limitIndex = rest.indexOf("--limit");
+      const intervalIndex = rest.indexOf("--interval");
+      const modeIndex = rest.indexOf("--mode");
+      const modeValue = modeIndex >= 0 ? rest[modeIndex + 1] : "autopilot";
+      if (!AGENT_VALID_MODES.has(modeValue)) {
+        throw new Error(`Invalid connector mode: ${modeValue}. Valid modes: observe, suggest, autopilot`);
+      }
+      const positional = getPositionals(rest, new Set(["--token", "--api-url", "--org", "--user", "--device", "--limit", "--interval", "--mode"]));
+      const target = positional[0] || process.cwd();
       const result = runConnect({
         token: tokenIndex >= 0 ? rest[tokenIndex + 1] : null,
         apiUrl: apiUrlIndex >= 0 ? rest[apiUrlIndex + 1] : null,
@@ -322,6 +336,16 @@ function createCli(deps) {
         device: deviceIndex >= 0 ? rest[deviceIndex + 1] : null,
         limit: parsePositiveInt(limitIndex >= 0 ? rest[limitIndex + 1] : null, 20),
       });
+      if (result.connected && !rest.includes("--no-agent") && runConnectorInstall) {
+        result.connector = runConnectorInstall(target, {
+          interval: parsePositiveInt(intervalIndex >= 0 ? rest[intervalIndex + 1] : null, 15),
+          mode: modeValue,
+          dryRun: rest.includes("--dry-run"),
+        });
+        result.next = result.connector?.started
+          ? [`${NPX_COMMAND} status`, "Refresh Prismo Workspace"]
+          : [`${NPX_COMMAND} connector install`, `${NPX_COMMAND} status`];
+      }
       if (result.connected && (rest.includes("--open") || !rest.includes("--no-open"))) {
         openUrl("https://getprismo.dev/dashboard/dev");
       }
@@ -330,6 +354,38 @@ function createCli(deps) {
       return;
     }
 
+    if (command === "connector") {
+      const json = rest.includes("--json");
+      const intervalIndex = rest.indexOf("--interval");
+      const modeIndex = rest.indexOf("--mode");
+      const modeValue = modeIndex >= 0 ? rest[modeIndex + 1] : "autopilot";
+      if (!AGENT_VALID_MODES.has(modeValue)) {
+        throw new Error(`Invalid connector mode: ${modeValue}. Valid modes: observe, suggest, autopilot`);
+      }
+      const positional = getPositionals(rest, new Set(["--interval", "--mode"]));
+      const action = ["install", "start", "stop", "status", "uninstall"].includes(positional[0]) ? positional[0] : "status";
+      const target = ["install"].includes(action) ? positional[1] || process.cwd() : positional[0] || process.cwd();
+      let result;
+      if (action === "install") {
+        result = runConnectorInstall(target, {
+          interval: parsePositiveInt(intervalIndex >= 0 ? rest[intervalIndex + 1] : null, 15),
+          mode: modeValue,
+          dryRun: rest.includes("--dry-run"),
+        });
+      } else if (action === "start") {
+        result = runConnectorStart({ dryRun: rest.includes("--dry-run") });
+      } else if (action === "stop") {
+        result = runConnectorStop({ dryRun: rest.includes("--dry-run") });
+      } else if (action === "uninstall") {
+        result = runConnectorUninstall({ dryRun: rest.includes("--dry-run") });
+      } else {
+        result = runConnectorStatus();
+      }
+      if (json) console.log(JSON.stringify(result, null, 2));
+      else console.log(renderConnectorTerminal(result));
+      return;
+    }
+
     if (command === "sync") {
       const json = rest.includes("--json");
       const limitIndex = rest.indexOf("--limit");

package/lib/prismo-dev/cloud-sync.js

@@ -411,6 +411,11 @@ module.exports = function createCloudSync(deps) {
     lines.push(`Config: ${result.configPath}`);
     lines.push(`API: ${result.apiUrl}`);
     lines.push(`Device: ${result.device.name}`);
+    if (result.connector) {
+      lines.push(`Connector: ${result.connector.started ? "started" : result.connector.installed ? "installed" : "not started"}`);
+      if (result.connector.reason) lines.push(`Connector note: ${result.connector.reason}`);
+      if (result.connector.error) lines.push(`Connector error: ${result.connector.error}`);
+    }
     lines.push("");
     lines.push("Next");
     result.next.forEach((item, index) => lines.push(`${index + 1}. ${item}`));

package/lib/prismo-dev/connector.js

@@ -0,0 +1,299 @@
+module.exports = function createConnector(deps) {
+  const {
+    fs,
+    os,
+    path,
+    spawnSync,
+    NPX_COMMAND,
+  } = deps;
+
+  const LABEL = "dev.getprismo.connector";
+  const BACKGROUND_COMMAND = String(NPX_COMMAND || "").includes(" -y ")
+    ? NPX_COMMAND
+    : "npx -y getprismo@latest";
+
+  function prismoHome() {
+    return process.env.PRISMO_HOME || path.join(os.homedir(), ".prismo");
+  }
+
+  function connectorDir() {
+    return path.join(prismoHome(), "connector");
+  }
+
+  function statePath() {
+    return path.join(connectorDir(), "state.json");
+  }
+
+  function scriptPath() {
+    return path.join(connectorDir(), "run.sh");
+  }
+
+  function logPath() {
+    return path.join(connectorDir(), "connector.log");
+  }
+
+  function errorLogPath() {
+    return path.join(connectorDir(), "connector.err.log");
+  }
+
+  function plistPath() {
+    return path.join(os.homedir(), "Library", "LaunchAgents", `${LABEL}.plist`);
+  }
+
+  function readJson(filePath) {
+    try {
+      if (!fs.existsSync(filePath)) return null;
+      return JSON.parse(fs.readFileSync(filePath, "utf8"));
+    } catch {
+      return null;
+    }
+  }
+
+  function writeJson(filePath, payload) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+  }
+
+  function shellEscape(value) {
+    return `'${String(value).replace(/'/g, "'\\''")}'`;
+  }
+
+  function xmlEscape(value) {
+    return String(value)
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;");
+  }
+
+  function launchctl(args, options = {}) {
+    if (options.dryRun) return { status: 0, stdout: "", stderr: "" };
+    const result = spawnSync("launchctl", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+    return {
+      status: result.status,
+      stdout: String(result.stdout || ""),
+      stderr: String(result.stderr || ""),
+    };
+  }
+
+  function writeRunner(rootDir, options = {}) {
+    const root = path.resolve(rootDir || process.cwd());
+    const interval = Math.max(5, Number(options.interval || 15));
+    const mode = options.mode || "autopilot";
+    fs.mkdirSync(connectorDir(), { recursive: true });
+    const command = `${BACKGROUND_COMMAND} agent --watch --interval ${interval} --mode ${shellEscape(mode)} ${shellEscape(root)}`;
+    const contents = [
+      "#!/bin/sh",
+      "set -eu",
+      `cd ${shellEscape(root)}`,
+      `exec ${command}`,
+      "",
+    ].join("\n");
+    fs.writeFileSync(scriptPath(), contents, { encoding: "utf8", mode: 0o700 });
+    writeJson(statePath(), {
+      schemaVersion: 1,
+      installedAt: new Date().toISOString(),
+      root,
+      interval,
+      mode,
+      command,
+      platform: process.platform,
+      runner: scriptPath(),
+      logPath: logPath(),
+      errorLogPath: errorLogPath(),
+    });
+    return { root, interval, mode, command };
+  }
+
+  function writePlist() {
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/sh</string>
+    <string>${xmlEscape(scriptPath())}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(logPath())}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(errorLogPath())}</string>
+</dict>
+</plist>
+`;
+    fs.mkdirSync(path.dirname(plistPath()), { recursive: true });
+    fs.writeFileSync(plistPath(), plist, "utf8");
+  }
+
+  function isMacLaunchdAvailable() {
+    return process.platform === "darwin";
+  }
+
+  function runConnectorInstall(rootDir = process.cwd(), options = {}) {
+    const runner = writeRunner(rootDir, options);
+    if (!isMacLaunchdAvailable()) {
+      return {
+        schemaVersion: 1,
+        command: "connector",
+        action: "install",
+        installed: false,
+        started: false,
+        platform: process.platform,
+        statePath: statePath(),
+        runner: scriptPath(),
+        reason: "background-service-not-supported",
+        next: [`${NPX_COMMAND} agent --watch`],
+      };
+    }
+
+    writePlist();
+    launchctl(["bootout", `gui/${process.getuid()}`, plistPath()], options);
+    const bootstrap = launchctl(["bootstrap", `gui/${process.getuid()}`, plistPath()], options);
+    const kickstart = launchctl(["kickstart", "-k", `gui/${process.getuid()}/${LABEL}`], options);
+    const started = bootstrap.status === 0 || kickstart.status === 0 || options.dryRun;
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "install",
+      installed: true,
+      started,
+      label: LABEL,
+      root: runner.root,
+      mode: runner.mode,
+      interval: runner.interval,
+      plistPath: plistPath(),
+      statePath: statePath(),
+      runner: scriptPath(),
+      logPath: logPath(),
+      errorLogPath: errorLogPath(),
+      error: started ? null : (bootstrap.stderr || kickstart.stderr || "launchctl failed").trim(),
+    };
+  }
+
+  function runConnectorStart(options = {}) {
+    if (!isMacLaunchdAvailable()) {
+      return { schemaVersion: 1, command: "connector", action: "start", started: false, reason: "background-service-not-supported" };
+    }
+    if (!fs.existsSync(plistPath())) {
+      return { schemaVersion: 1, command: "connector", action: "start", started: false, reason: "not-installed", next: [`${NPX_COMMAND} connector install`] };
+    }
+    const result = launchctl(["kickstart", "-k", `gui/${process.getuid()}/${LABEL}`], options);
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "start",
+      started: result.status === 0 || options.dryRun,
+      label: LABEL,
+      error: result.status === 0 || options.dryRun ? null : result.stderr.trim(),
+    };
+  }
+
+  function runConnectorStop(options = {}) {
+    if (!isMacLaunchdAvailable()) {
+      return { schemaVersion: 1, command: "connector", action: "stop", stopped: false, reason: "background-service-not-supported" };
+    }
+    const result = launchctl(["bootout", `gui/${process.getuid()}`, plistPath()], options);
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "stop",
+      stopped: result.status === 0 || options.dryRun,
+      label: LABEL,
+      error: result.status === 0 || options.dryRun ? null : result.stderr.trim(),
+    };
+  }
+
+  function runConnectorUninstall(options = {}) {
+    const stop = runConnectorStop(options);
+    if (!options.dryRun) {
+      if (fs.existsSync(plistPath())) fs.rmSync(plistPath(), { force: true });
+      if (fs.existsSync(scriptPath())) fs.rmSync(scriptPath(), { force: true });
+    }
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "uninstall",
+      uninstalled: true,
+      stopped: stop.stopped,
+      removed: [plistPath(), scriptPath()],
+    };
+  }
+
+  function runConnectorStatus() {
+    const state = readJson(statePath());
+    const installed = fs.existsSync(plistPath()) || fs.existsSync(scriptPath());
+    let online = false;
+    let raw = "";
+    if (isMacLaunchdAvailable() && fs.existsSync(plistPath())) {
+      const result = launchctl(["print", `gui/${process.getuid()}/${LABEL}`]);
+      raw = `${result.stdout}${result.stderr}`;
+      online = result.status === 0 && /state = running|pid = \d+/i.test(raw);
+    }
+    return {
+      schemaVersion: 1,
+      command: "connector",
+      action: "status",
+      installed,
+      online,
+      label: LABEL,
+      platform: process.platform,
+      state,
+      plistPath: plistPath(),
+      runner: scriptPath(),
+      logPath: logPath(),
+      errorLogPath: errorLogPath(),
+    };
+  }
+
+  function renderConnectorTerminal(result) {
+    const lines = [];
+    lines.push("");
+    lines.push("PrismoDev Connector");
+    lines.push("");
+    if (result.action === "status") {
+      lines.push(`Installed: ${result.installed ? "yes" : "no"}`);
+      lines.push(`Status: ${result.online ? "online" : "idle"}`);
+      if (result.state?.root) lines.push(`Repo: ${result.state.root}`);
+      lines.push(`Logs: ${result.logPath}`);
+    } else if (result.action === "install") {
+      lines.push(`Status: ${result.started ? "started" : result.installed ? "installed" : "not installed"}`);
+      if (result.root) lines.push(`Repo: ${result.root}`);
+      if (result.reason) lines.push(`Note: ${result.reason}`);
+      if (result.error) lines.push(`Error: ${result.error}`);
+    } else if (result.action === "start") {
+      lines.push(`Status: ${result.started ? "started" : "not started"}`);
+      if (result.reason) lines.push(`Note: ${result.reason}`);
+      if (result.error) lines.push(`Error: ${result.error}`);
+    } else if (result.action === "stop") {
+      lines.push(`Status: ${result.stopped ? "stopped" : "not stopped"}`);
+      if (result.reason) lines.push(`Note: ${result.reason}`);
+      if (result.error) lines.push(`Error: ${result.error}`);
+    } else if (result.action === "uninstall") {
+      lines.push("Status: uninstalled");
+    }
+    if (result.next?.length) {
+      lines.push("");
+      lines.push("Next");
+      result.next.forEach((item, index) => lines.push(`${index + 1}. ${item}`));
+    }
+    return lines.join("\n");
+  }
+
+  return {
+    LABEL,
+    renderConnectorTerminal,
+    runConnectorInstall,
+    runConnectorStart,
+    runConnectorStatus,
+    runConnectorStop,
+    runConnectorUninstall,
+    writeRunner,
+  };
+};

package/lib/prismo-dev/help.js

@@ -13,6 +13,7 @@ Usage:
   prismo mcp [path]
   prismo mcp doctor [--json] [path]
   prismo connect [--json] [--token TOKEN] [--api-url URL] [--org ORG] [--user USER] [--device NAME]
+  prismo connector [status|install|start|stop|uninstall] [--json] [--interval N] [--mode observe|suggest|autopilot] [path]
   prismo sync [--json] [--dry-run] [--watch] [--interval N] [--limit N] [--tool all|codex|claude|cursor] [path]
   prismo status [--json]
   prismo disconnect [--json]
@@ -44,6 +45,7 @@ Commands:
   shield      Run a noisy command, store full output locally, and return a compact summary.
   mcp         Start a local MCP server exposing Prismo tools over stdio.
   connect     Store a PrismoDev cloud connection for seamless dashboard sync.
+  connector   Install or manage the background Prismo Workspace connector.
   sync        Send safe aggregate local agent telemetry to Prismo; use --watch for background-style sync.
   status      Show local PrismoDev connection and last sync state.
   disconnect  Remove the local PrismoDev cloud connection.
@@ -98,6 +100,7 @@ Options:
   --org ORG Organization identifier for connect mode.
   --user USER User email or identifier for connect mode.
   --device NAME Local device name for connect mode.
+  --no-agent  Connect without installing the background workspace connector.
   --tool TOOL Tool filter for sync mode: all, codex, claude, or cursor.
   --watch     Keep sync running and send updates on an interval.
   --once      Run watch mode once, useful for tests and scripts.
@@ -406,6 +409,7 @@ Output:
 
 Usage:
   prismo connect [--json] [--token TOKEN] [--api-url URL] [--org ORG] [--user USER] [--device NAME]
+  prismo connector [status|install|start|stop|uninstall] [--json] [--interval N] [--mode observe|suggest|autopilot] [path]
   prismo sync [--json] [--dry-run] [--watch] [--interval N] [--limit N] [--tool all|codex|claude|cursor] [path]
   prismo status [--json]
   prismo disconnect [--json]
@@ -413,6 +417,9 @@ Usage:
 Examples:
   prismo connect --token <token>
   prismo connect --token <token> --api-url https://api.getprismo.dev
+  prismo connect --token <token> --no-agent
+  prismo connector status
+  prismo connector install
   prismo sync --dry-run
   prismo sync
   prismo sync --watch --interval 60
@@ -420,10 +427,37 @@ Examples:
   prismo disconnect
 
 Output:
-  connect stores a local PrismoDev device connection in ~/.prismo/config.json.
+  connect stores a local PrismoDev device connection in ~/.prismo/config.json and starts the background workspace connector by default.
+  connector keeps Prismo Workspace online so repairs queued in the dashboard run locally without copy/paste commands.
   sync reads local Codex, Claude Code, and Cursor session logs, builds aggregate agent-efficiency telemetry, and sends it to Prismo.
   sync --watch keeps running so a local service manager can keep the Waste Scanner dashboard fresh.
   Sync does not upload prompts, source code, file contents, stdout, stderr, or full command logs.`,
+  connector: `PrismoDev Connector
+
+Usage:
+  prismo connector status [--json]
+  prismo connector install [--json] [--interval N] [--mode observe|suggest|autopilot] [path]
+  prismo connector start [--json]
+  prismo connector stop [--json]
+  prismo connector uninstall [--json]
+
+Modes:
+  observe    Keep the workspace connected but do not execute queued repairs.
+  suggest    Stage repairs as pending approval.
+  autopilot  Execute safe queued repairs automatically. (default)
+
+Examples:
+  prismo connector status
+  prismo connector install
+  prismo connector install --mode suggest --interval 30
+  prismo connector stop
+  prismo connector uninstall
+
+Output:
+  Installs and manages the local Prismo Workspace connector.
+  On macOS this creates a LaunchAgent so Prismo stays online after the terminal closes.
+  The connector claims safe repairs queued from Prismo Cloud, runs them locally, and reports status back.
+  It does not upload prompts, source code, file contents, stdout, stderr, or full command logs.`,
   sync: `PrismoDev Sync
 
 Usage:

package/lib/prismo-dev-scan.js

@@ -3,7 +3,7 @@ const http = require("http");
 const https = require("https");
 const os = require("os");
 const path = require("path");
-const { execSync } = require("child_process");
+const { execSync, spawnSync } = require("child_process");
 const { version: PACKAGE_VERSION } = require("../package.json");
 
 function openUrl(url) {
@@ -333,6 +333,21 @@ const {
   openUrl,
 });
 
+const {
+  renderConnectorTerminal,
+  runConnectorInstall,
+  runConnectorStart,
+  runConnectorStatus,
+  runConnectorStop,
+  runConnectorUninstall,
+} = require("./prismo-dev/connector")({
+  fs,
+  os,
+  path,
+  spawnSync,
+  NPX_COMMAND,
+});
+
 const {
   buildInstructionsAblationPlan,
   buildInstructionsApply,
@@ -439,6 +454,12 @@ const { runCli } = require("./prismo-dev/cli")({
   runGuard,
   renderAgentTerminal,
   runAgent,
+  renderConnectorTerminal,
+  runConnectorInstall,
+  runConnectorStart,
+  runConnectorStatus,
+  runConnectorStop,
+  runConnectorUninstall,
   renderInstructionsAblationTerminal,
   renderInstructionsApplyTerminal,
   renderInstructionsAuditTerminal,
@@ -531,6 +552,11 @@ module.exports = {
   runConnect,
   runDisconnect,
   runGuard,
+  runConnectorInstall,
+  runConnectorStart,
+  runConnectorStatus,
+  runConnectorStop,
+  runConnectorUninstall,
   runStatus,
   runSync,
   getUsageSummary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getprismo",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "description": "Local AI coding workflow scanner for Codex, Claude Code, Cursor, and token-waste diagnostics.",
   "license": "MIT",
   "homepage": "https://github.com/shanirsh/prismodev#readme",