supbuddy 3.0.4 → 3.0.5

package/dist/bin.js

@@ -9196,9 +9196,9 @@ var require_mime_db = __commonJS({
   }
 });
 
-// ../../node_modules/mime-types/index.js
+// ../../node_modules/accepts/node_modules/mime-types/index.js
 var require_mime_types = __commonJS({
-  "../../node_modules/mime-types/index.js"(exports) {
+  "../../node_modules/accepts/node_modules/mime-types/index.js"(exports) {
     "use strict";
     var db = require_mime_db();
     var extname = __require("path").extname;

package/dist/lib.d.ts

@@ -0,0 +1,75 @@
+interface Attach {
+    url?: string;
+    token?: string;
+    stateDir?: string;
+    timeoutMs?: number;
+}
+declare class DaemonClient {
+    baseUrl: string;
+    private token;
+    private timeoutMs;
+    private id;
+    constructor(baseUrl: string, token: string, timeoutMs?: number);
+    private rpc;
+    call(tool: string, args?: object): Promise<any>;
+    stream(tool: string, args: object, onEvent: (e: any) => void, signal?: AbortSignal): Promise<void>;
+}
+declare function connect(a: Attach): Promise<DaemonClient>;
+
+interface DaemonInfo {
+    pid: number;
+    socketPort: number;
+    mcpPort: number;
+    stateDir: string;
+    bootToken: string;
+    startedAt: string;
+    /** Port of the Socket.IO native-relay server (socketPort + 1 by default). */
+    relayPort: number;
+    /** App version that spawned this daemon (== the worker's version). Stamped from
+     *  SUPBUDDY_APP_VERSION when a Tauri GUI ≥3.0.3 spawns it. Optional: a headless
+     *  `supbuddy daemon` or an older GUI omits it. The Tauri sidecar restarts a
+     *  daemon whose version differs from the app, so a GUI update reloads the worker. */
+    version?: string;
+}
+declare function readDaemonInfo(stateDir: string): Promise<DaemonInfo | null>;
+
+/**
+ * MUST match packages/core/store.ts getAppSupportDir() — the CLI/daemon/GUI
+ * share one state dir (two-writer corruption + docs-drift hazard otherwise).
+ */
+declare function defaultStateDir(): string;
+
+/**
+ * completions.ts — the command tree + shell-completion generators.
+ *
+ * COMMAND_TREE is the single source of truth for what commands/subcommands the
+ * CLI accepts. It powers `supbuddy completion zsh` today, and will feed the
+ * interactive `supbuddy shell` REPL (ghost-text autosuggest) next.
+ *
+ * Keep this in sync with the dispatch in bin.ts + the `case`/`sub ===` handling
+ * in commands.ts when commands change.
+ */
+/** command → its subcommands (empty = no subcommands). */
+declare const COMMAND_TREE: Record<string, string[]>;
+/** Flags accepted (almost) everywhere. */
+declare const GLOBAL_FLAGS: string[];
+declare const TOP_LEVEL: string[];
+/**
+ * Which `<module>:<action>` combos take a single resolvable target as their
+ * first arg, and where the candidate list comes from. Used by the interactive
+ * picker's "smart args" step (pick a project/mapping instead of erroring on a
+ * missing arg). Only single-target actions are listed; multi-arg actions
+ * (e.g. `scripts start <project> <script>`) are intentionally omitted for now.
+ */
+type ArgSource = 'projects' | 'mappings' | 'agents' | 'clients';
+declare const ARG_SOURCE: Record<string, ArgSource>;
+declare function argSourceFor(module: string, action: string): ArgSource | null;
+/**
+ * Short, human descriptions for modules and `module:action` combos — surfaced by
+ * the interactive picker so you know what each does. Keep concise (one line).
+ */
+declare const DESCRIPTIONS: Record<string, string>;
+/** Description for a module, or a `module action` combo (falls back to ''). */
+declare function describe(module: string, action?: string): string;
+
+export { ARG_SOURCE, type ArgSource, type Attach, COMMAND_TREE, DESCRIPTIONS, DaemonClient, type DaemonInfo, GLOBAL_FLAGS, TOP_LEVEL, argSourceFor, connect, defaultStateDir, describe, readDaemonInfo };

package/dist/lib.js

@@ -0,0 +1,393 @@
+#!/usr/bin/env node
+import { createRequire as __supbuddyCreateRequire } from 'module';
+const require = __supbuddyCreateRequire(import.meta.url);
+
+// src/daemon-json.ts
+import fs from "fs/promises";
+import path from "path";
+import { execFileSync } from "child_process";
+function isDaemonInfo(o) {
+  return !!o && typeof o === "object" && typeof o.pid === "number" && typeof o.socketPort === "number" && typeof o.mcpPort === "number" && typeof o.stateDir === "string" && typeof o.bootToken === "string" && typeof o.startedAt === "string" && typeof o.relayPort === "number" && (o.version === void 0 || typeof o.version === "string");
+}
+function daemonJsonPath(stateDir) {
+  return path.join(stateDir, "daemon.json");
+}
+async function readDaemonInfo(stateDir) {
+  try {
+    const raw = JSON.parse(await fs.readFile(daemonJsonPath(stateDir), "utf-8"));
+    return isDaemonInfo(raw) ? raw : null;
+  } catch {
+    return null;
+  }
+}
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e?.code === "EPERM";
+  }
+}
+
+// src/state-dir.ts
+import os from "os";
+import path2 from "path";
+function defaultStateDir() {
+  const override = process.env.SUPBUDDY_STATE_DIR;
+  if (override) return override;
+  const home = os.homedir();
+  if (process.platform === "darwin") return path2.join(home, "Library", "Application Support", "Supbuddy");
+  if (process.platform === "win32") return path2.join(process.env.APPDATA ?? path2.join(home, "AppData", "Roaming"), "Supbuddy");
+  return path2.join(process.env.XDG_CONFIG_HOME ?? path2.join(home, ".config"), "Supbuddy");
+}
+
+// src/client.ts
+var DaemonClient = class {
+  constructor(baseUrl, token, timeoutMs = 15e3) {
+    this.baseUrl = baseUrl;
+    this.token = token;
+    this.timeoutMs = timeoutMs;
+  }
+  baseUrl;
+  token;
+  timeoutMs;
+  id = 1;
+  async rpc(method, params) {
+    const res = await fetch(`${this.baseUrl}/mcp`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream"
+      },
+      body: JSON.stringify({ jsonrpc: "2.0", id: this.id++, method, params }),
+      signal: AbortSignal.timeout(this.timeoutMs)
+    });
+    if (res.status === 401) throw Object.assign(new Error("unauthorized"), { code: 401 });
+    if (!res.ok) throw new Error(`mcp http ${res.status}`);
+    const j = await res.json();
+    if (j.error) throw new Error(j.error.message ?? "mcp error");
+    return j.result;
+  }
+  async call(tool, args = {}) {
+    const result = await this.rpc("tools/call", { name: tool, arguments: args });
+    const text = result?.content?.[0]?.text;
+    if (typeof text !== "string") return result;
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  }
+  async stream(tool, args, onEvent, signal) {
+    const res = await fetch(`${this.baseUrl}/mcp`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json",
+        Accept: "text/event-stream"
+      },
+      body: JSON.stringify({ jsonrpc: "2.0", id: this.id++, method: "tools/call", params: { name: tool, arguments: args } }),
+      signal
+    });
+    if (!res.ok || !res.body) throw new Error(`mcp stream ${res.status}`);
+    const reader = res.body.getReader();
+    const dec = new TextDecoder();
+    let buf = "";
+    for (; ; ) {
+      let value;
+      let done;
+      try {
+        ;
+        ({ value, done } = await reader.read());
+      } catch (e) {
+        if (e?.name === "AbortError") return;
+        throw e;
+      }
+      if (done) break;
+      buf += dec.decode(value, { stream: true });
+      let i;
+      while ((i = buf.indexOf("\n\n")) >= 0) {
+        const frame = buf.slice(0, i);
+        buf = buf.slice(i + 2);
+        const line = frame.split("\n").find((l) => l.startsWith("data:"));
+        if (line) {
+          try {
+            onEvent(JSON.parse(line.slice(5).trim()));
+          } catch {
+          }
+        }
+      }
+    }
+  }
+};
+async function connect(a) {
+  const timeoutMs = a.timeoutMs ?? 15e3;
+  if (a.url) {
+    return new DaemonClient(a.url.replace(/\/+$/, ""), a.token ?? "", timeoutMs);
+  }
+  const dir = a.stateDir ?? defaultStateDir();
+  const info = await readDaemonInfo(dir);
+  if (!info) {
+    throw new Error(
+      "No Supbuddy daemon is running. Open the Supbuddy app, or start one with `supbuddy daemon --detach`."
+    );
+  }
+  const token = a.token ?? info.bootToken;
+  for (let p = info.mcpPort; p <= info.mcpPort + 5; p++) {
+    const client = new DaemonClient(`http://127.0.0.1:${p}`, token, timeoutMs);
+    try {
+      await client.call("get_health");
+      return client;
+    } catch (e) {
+      if (e?.code === 401 || e?.name === "TimeoutError" || e?.name === "SyntaxError" || /abort|timeout|ETIMEDOUT|ECONNREFUSED|ECONNRESET|fetch failed|JSON/i.test(String(e?.message ?? e))) {
+        continue;
+      }
+      throw e;
+    }
+  }
+  const stale = !isPidAlive(info.pid);
+  if (stale) {
+    throw new Error(
+      `The Supbuddy daemon recorded in ${dir} (pid ${info.pid}) is no longer running \u2014 its state file is stale. Open the Supbuddy app (or run \`supbuddy daemon --detach\`) to restart it.`
+    );
+  }
+  throw new Error(
+    `Could not reach the Supbuddy daemon at 127.0.0.1:${info.mcpPort} (pid ${info.pid} is running but not answering \u2014 it may still be starting up, or its control server failed to bind). Try again in a moment, or restart the Supbuddy app.`
+  );
+}
+
+// src/completions.ts
+var COMMAND_TREE = {
+  status: [],
+  proxy: ["status", "start", "stop", "restart"],
+  map: ["ls", "add", "get", "set", "enable", "disable", "rm", "restore"],
+  project: ["ls", "add", "get", "scan", "set", "enable", "disable", "rm", "restore", "env", "env-read", "set-supabase-path", "refresh-context"],
+  projects: [],
+  supabase: ["start", "stop", "restart", "status", "config", "init", "backups", "restore", "cancel", "force-recreate", "restart-container", "analytics"],
+  logs: ["requests", "audit", "get"],
+  compose: ["up", "down", "restart", "status", "logs"],
+  isolation: ["switch", "pending-migrations"],
+  migrate: ["start", "finish"],
+  ca: ["status", "install", "uninstall"],
+  env: ["copy", "write"],
+  settings: ["get", "set"],
+  mcp: ["add", "ls", "revoke", "approvals"],
+  account: [],
+  caps: [],
+  scripts: ["ls", "start", "restart", "stop", "logs", "bookmark"],
+  addons: ["seed", "scaffold"],
+  bundle: ["export", "import", "validate"],
+  connect: ["preview", "targets", "diff", "apply", "write", "test", "dismiss-drift"],
+  trust: ["status", "install", "remove", "detect", "test"],
+  tailscale: ["status", "set-key", "remove-key", "test"],
+  dns: ["status"],
+  pf: ["status", "enable", "disable", "reload"],
+  // bin.ts-handled commands
+  daemon: [],
+  stop: [],
+  service: ["install", "uninstall", "status"],
+  tui: [],
+  dash: [],
+  shell: [],
+  selftest: [],
+  completion: ["zsh"],
+  help: []
+};
+var GLOBAL_FLAGS = ["--json", "--details", "--follow", "--url", "--timeout", "--yes", "--quiet", "--state-dir", "--worker-port", "--detach"];
+var TOP_LEVEL = Object.keys(COMMAND_TREE);
+var ARG_SOURCE = {
+  "project:get": "projects",
+  "project:set": "projects",
+  "project:enable": "projects",
+  "project:disable": "projects",
+  "project:rm": "projects",
+  "project:restore": "projects",
+  "project:env": "projects",
+  "project:refresh-context": "projects",
+  "supabase:start": "projects",
+  "supabase:stop": "projects",
+  "supabase:restart": "projects",
+  "supabase:status": "projects",
+  "supabase:init": "projects",
+  "compose:up": "projects",
+  "compose:restart": "projects",
+  "compose:down": "projects",
+  "compose:status": "projects",
+  "scripts:ls": "projects",
+  "migrate:start": "projects",
+  "migrate:finish": "projects",
+  "connect:preview": "projects",
+  "connect:targets": "projects",
+  "connect:diff": "projects",
+  "connect:apply": "projects",
+  "connect:write": "projects",
+  "connect:test": "projects",
+  "connect:dismiss-drift": "projects",
+  "map:get": "mappings",
+  "map:set": "mappings",
+  "map:enable": "mappings",
+  "map:disable": "mappings",
+  "map:rm": "mappings",
+  "map:restore": "mappings",
+  "mcp:revoke": "clients",
+  "mcp:add": "agents"
+};
+function argSourceFor(module, action) {
+  return ARG_SOURCE[`${module}:${action}`] ?? null;
+}
+var DESCRIPTIONS = {
+  // modules
+  status: "daemon + proxy health",
+  proxy: "reverse-proxy control",
+  map: "domain \u2192 port mappings",
+  project: "registered dev projects",
+  supabase: "local Supabase lifecycle",
+  compose: "docker compose services",
+  scripts: "project dev scripts",
+  logs: "request + audit logs",
+  isolation: "host / thin isolation",
+  migrate: "vm \u2192 thin migration",
+  ca: "CA certificate trust",
+  env: "env-file helpers",
+  settings: "global settings",
+  mcp: "register Supbuddy into coding agents + manage MCP clients",
+  account: "account info",
+  caps: "client capabilities",
+  addons: "add-on compose services",
+  bundle: "export / import projects",
+  connect: "connection strings + env",
+  trust: "bundled-runtime CA trust",
+  tailscale: "Tailscale split-DNS",
+  dns: "local DNS status",
+  pf: "port-forwarding (pfctl)",
+  daemon: "run the headless daemon",
+  stop: "stop a running daemon",
+  service: "start-on-login service",
+  tui: "live dashboard",
+  completion: "shell completion script",
+  // proxy
+  "proxy:status": "show proxy status",
+  "proxy:start": "start the proxy (sudo)",
+  "proxy:stop": "stop the proxy",
+  "proxy:restart": "restart the proxy",
+  // map
+  "map:ls": "list mappings",
+  "map:add": "add a mapping",
+  "map:get": "show a mapping",
+  "map:set": "update a mapping",
+  "map:enable": "enable a mapping",
+  "map:disable": "disable a mapping",
+  "map:rm": "delete a mapping",
+  "map:restore": "restore from trash",
+  // project
+  "project:ls": "list projects",
+  "project:add": "register a project",
+  "project:get": "show project details",
+  "project:scan": "scan for services",
+  "project:set": "update name/domain",
+  "project:enable": "enable a project",
+  "project:disable": "disable a project",
+  "project:rm": "delete a project",
+  "project:restore": "restore from trash",
+  "project:env": "list env files",
+  "project:env-read": "read an env file",
+  "project:set-supabase-path": "set supabase config dir",
+  "project:refresh-context": "refresh project context",
+  // supabase
+  "supabase:start": "start Supabase",
+  "supabase:stop": "stop Supabase",
+  "supabase:restart": "restart Supabase",
+  "supabase:status": "show Supabase status",
+  "supabase:config": "read/write config.toml",
+  "supabase:init": "init Supabase",
+  "supabase:backups": "list backups",
+  "supabase:restore": "restore a backup",
+  "supabase:cancel": "cancel a start",
+  "supabase:force-recreate": "force-recreate containers",
+  "supabase:restart-container": "restart one container",
+  "supabase:analytics": "analytics on/off",
+  // compose
+  "compose:up": "start services",
+  "compose:restart": "restart services",
+  "compose:down": "tear down services",
+  "compose:status": "service status",
+  "compose:logs": "tail service logs",
+  // scripts
+  "scripts:ls": "list project scripts",
+  "scripts:start": "start a script",
+  "scripts:restart": "restart a script",
+  "scripts:stop": "stop a script",
+  "scripts:logs": "tail script logs",
+  "scripts:bookmark": "bookmark a script",
+  // logs
+  "logs:requests": "request logs (tail)",
+  "logs:audit": "audit log stream",
+  "logs:get": "one request log entry",
+  // isolation / migrate
+  "isolation:switch": "switch host/thin",
+  "isolation:pending-migrations": "list pending migrations",
+  "migrate:start": "begin vm\u2192thin migration",
+  "migrate:finish": "finish migration",
+  // ca / env / settings
+  "ca:status": "CA install status",
+  "ca:install": "install the CA",
+  "ca:uninstall": "uninstall the CA",
+  "env:copy": "copy a var between files",
+  "env:write": "write/delete env vars",
+  "settings:get": "show settings",
+  "settings:set": "update settings (json)",
+  // mcp / addons / bundle
+  "mcp:add": "add Supbuddy to a coding agent (--write/--print/--prompt)",
+  "mcp:ls": "list registered MCP clients",
+  "mcp:revoke": "revoke an MCP client token",
+  "mcp:approvals": "approve/cancel a queued destructive plan",
+  "addons:seed": "seed addon data",
+  "addons:scaffold": "scaffold addon services",
+  "bundle:export": "export a project bundle",
+  "bundle:import": "import a bundle",
+  "bundle:validate": "validate a bundle",
+  // connect / trust / tailscale / dns / pf
+  "connect:preview": "preview connection",
+  "connect:targets": "list env targets",
+  "connect:diff": "diff env vs target",
+  "connect:apply": "apply env to target",
+  "connect:write": "write connection",
+  "connect:test": "test connectivity",
+  "connect:dismiss-drift": "dismiss drift warning",
+  "trust:status": "trust status",
+  "trust:install": "install runtime trust",
+  "trust:remove": "remove runtime trust",
+  "trust:detect": "detect runtime tools",
+  "trust:test": "test trust",
+  "tailscale:status": "Tailscale status",
+  "tailscale:set-key": "set API key",
+  "tailscale:remove-key": "remove API key",
+  "tailscale:test": "test connection",
+  "dns:status": "DNS server status",
+  "pf:status": "port-forwarding status",
+  "pf:enable": "enable port-forwarding",
+  "pf:disable": "disable port-forwarding",
+  "pf:reload": "reload pf rules",
+  // service
+  "service:install": "install login service",
+  "service:uninstall": "uninstall service",
+  "service:status": "service status"
+};
+function describe(module, action) {
+  if (action) return DESCRIPTIONS[`${module}:${action}`] ?? "";
+  return DESCRIPTIONS[module] ?? "";
+}
+export {
+  ARG_SOURCE,
+  COMMAND_TREE,
+  DESCRIPTIONS,
+  DaemonClient,
+  GLOBAL_FLAGS,
+  TOP_LEVEL,
+  argSourceFor,
+  connect,
+  defaultStateDir,
+  describe,
+  readDaemonInfo
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supbuddy",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "Run multiple Supabase projects at once on custom local domains with HTTPS. A headless CLI and daemon (proxy, DNS, Supabase/Compose lifecycle, MCP) for macOS and Linux.",
   "keywords": [
     "supabase",
@@ -26,7 +26,10 @@
     "supbuddy": "./dist/bin.js"
   },
   "exports": {
-    "./lib": "./src/lib.ts"
+    "./lib": {
+      "types": "./dist/lib.d.ts",
+      "default": "./dist/lib.js"
+    }
   },
   "files": [
     "dist",