superacli 1.1.0 → 1.1.2

package/__tests__/watchexec-plugin.test.js

@@ -0,0 +1,80 @@
+const fs = require("fs")
+const os = require("os")
+const path = require("path")
+const { execSync } = require("child_process")
+
+const CLI = path.join(__dirname, "..", "cli", "supercli.js")
+
+function runNoServer(args, options = {}) {
+  try {
+    const env = { ...process.env }
+    delete env.SUPERCLI_SERVER
+    const out = execSync(`node ${CLI} ${args}`, {
+      encoding: "utf-8",
+      timeout: 15000,
+      env: { ...env, ...(options.env || {}) }
+    })
+    return { ok: true, output: out.trim(), code: 0 }
+  } catch (err) {
+    return {
+      ok: false,
+      output: (err.stdout || "").trim(),
+      stderr: (err.stderr || "").trim(),
+      code: err.status
+    }
+  }
+}
+
+function writeFakeWatchexecBinary(dir) {
+  const bin = path.join(dir, "watchexec")
+  fs.writeFileSync(bin, [
+    "#!/usr/bin/env node",
+    "const args = process.argv.slice(2);",
+    "if (args[0] === '--version') { console.log('watchexec 2.5.0-test'); process.exit(0); }",
+    "console.log(JSON.stringify({ ok: true, args }));"
+  ].join("\n"), "utf-8")
+  fs.chmodSync(bin, 0o755)
+  return bin
+}
+
+describe("watchexec plugin", () => {
+  const fakeDir = fs.mkdtempSync(path.join(os.tmpdir(), "dcli-watchexec-"))
+  const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "dcli-home-watchexec-"))
+  writeFakeWatchexecBinary(fakeDir)
+  const env = { ...process.env, PATH: `${fakeDir}:${process.env.PATH || ""}`, SUPERCLI_HOME: tempHome }
+
+  beforeAll(() => {
+    runNoServer("plugins install ./plugins/watchexec --on-conflict replace --json", { env })
+  })
+
+  afterAll(() => {
+    runNoServer("plugins remove watchexec --json", { env })
+    fs.rmSync(fakeDir, { recursive: true, force: true })
+    fs.rmSync(tempHome, { recursive: true, force: true })
+  })
+
+  test("routes cli version wrapped command", () => {
+    const r = runNoServer("watchexec cli version --json", { env })
+    expect(r.ok).toBe(true)
+    const data = JSON.parse(r.output)
+    expect(data.command).toBe("watchexec.cli.version")
+    expect(data.data.raw).toBe("watchexec 2.5.0-test")
+  })
+
+  test("supports namespace passthrough", () => {
+    const r = runNoServer("watchexec --help --json", { env })
+    expect(r.ok).toBe(true)
+    const data = JSON.parse(r.output)
+    expect(data.command).toBe("watchexec.passthrough")
+    expect(data.data.args).toContain("--help")
+    expect(data.data.args).toContain("--json")
+  })
+
+  test("doctor reports watchexec dependency as healthy", () => {
+    const r = runNoServer("plugins doctor watchexec --json", { env })
+    expect(r.ok).toBe(true)
+    const data = JSON.parse(r.output)
+    expect(data.ok).toBe(true)
+    expect(data.checks.some(c => c.type === "binary" && c.binary === "watchexec" && c.ok === true)).toBe(true)
+  })
+})

package/cli/adapter-schema.js

@@ -22,6 +22,7 @@ function validateCommonConfig(adapterName, config) {
   assertType(config.non_interactive, "boolean", "non_interactive")
   assertType(config.cwd, "string", "cwd")
   assertType(config.safetyLevel, "string", "safetyLevel")
+  assertType(config.stream, "string", "stream")
   if (config.interactiveFlags !== undefined && !Array.isArray(config.interactiveFlags)) {
     throw asInvalid("adapterConfig.interactiveFlags must be an array")
   }
@@ -39,6 +40,10 @@ function validateCommonConfig(adapterName, config) {
       throw asInvalid("adapterConfig.timeout_ms cannot exceed 15000ms")
     }
   }
+
+  if (config.stream !== undefined && !["jsonl"].includes(config.stream)) {
+    throw asInvalid("adapterConfig.stream must be 'jsonl'")
+  }
 }
 
 function validateAdapterConfig(cmd) {

package/cli/adapters/process.js

@@ -77,7 +77,27 @@ function validateNonTtySafety(cfg, args) {
   }
 }
 
-async function execute(cmd, flags) {
+function parseJsonLine(text) {
+  try {
+    return JSON.parse(text)
+  } catch {
+    return { raw: text }
+  }
+}
+
+function flushStreamBuffer(buffer, onLine) {
+  let pending = buffer
+  let newlineIndex = pending.indexOf("\n")
+  while (newlineIndex >= 0) {
+    const line = pending.slice(0, newlineIndex).trim()
+    pending = pending.slice(newlineIndex + 1)
+    if (line) onLine(line)
+    newlineIndex = pending.indexOf("\n")
+  }
+  return pending
+}
+
+async function execute(cmd, flags, context = {}) {
   const cfg = cmd.adapterConfig || {}
   const binary = cfg.command
   if (!binary) throw new Error("Process adapter requires adapterConfig.command")
@@ -93,6 +113,8 @@ async function execute(cmd, flags) {
   const passthroughInteractive = passthroughMode && flags.__passthroughInteractive === true
   const cwd = typeof cfg.cwd === "string" ? cfg.cwd : undefined
   const env = (cfg.env && typeof cfg.env === "object") ? { ...process.env, ...cfg.env } : process.env
+  const streamMode = cfg.stream || null
+  const onStreamEvent = typeof context.onStreamEvent === "function" ? context.onStreamEvent : null
 
   const check = preflightBinary(binary)
   if (!check.ok) {
@@ -136,6 +158,9 @@ async function execute(cmd, flags) {
     const child = spawn(binary, args, { stdio: passthroughInteractive ? "inherit" : ["ignore", "pipe", "pipe"], cwd, env })
     let out = ""
     let err = ""
+    let streamBuffer = ""
+    let streamEventCount = 0
+    let lastStreamEvent = null
     let settled = false
 
     const timer = setTimeout(() => {
@@ -152,7 +177,16 @@ async function execute(cmd, flags) {
     if (!passthroughInteractive) {
       child.stdout.setEncoding("utf-8")
       child.stderr.setEncoding("utf-8")
-      child.stdout.on("data", chunk => { out += chunk })
+      child.stdout.on("data", chunk => {
+        out += chunk
+        if (streamMode !== "jsonl") return
+        streamBuffer = flushStreamBuffer(streamBuffer + chunk, line => {
+          const event = parseJsonLine(line)
+          streamEventCount += 1
+          lastStreamEvent = event
+          if (onStreamEvent) onStreamEvent(event)
+        })
+      })
       child.stderr.on("data", chunk => { err += chunk })
     }
 
@@ -194,6 +228,23 @@ async function execute(cmd, flags) {
         return
       }
 
+      if (streamMode === "jsonl") {
+        const trailing = streamBuffer.trim()
+        if (trailing) {
+          const event = parseJsonLine(trailing)
+          streamEventCount += 1
+          lastStreamEvent = event
+          if (onStreamEvent) onStreamEvent(event)
+        }
+        resolve({
+          streamed: true,
+          stream: streamMode,
+          event_count: streamEventCount,
+          last_event: lastStreamEvent
+        })
+        return
+      }
+
       const text = out.trim()
       if (!parsedAsJson) {
         resolve({ raw: text })

package/cli/plugin-install-guidance.js

@@ -0,0 +1,320 @@
+const PLUGIN_INSTALL_GUIDANCE = {
+  beads: {
+    plugin: "beads",
+    binary: "br",
+    check: "br --version",
+    install_steps: [
+      "curl -fsSL \"https://raw.githubusercontent.com/Dicklesworthstone/beads_rust/main/install.sh?$(date +%s)\" | bash",
+      "br --version"
+    ],
+    note: "Installation is intentionally delegated to your LLM/automation flow (dcli/scli/supercli)."
+  },
+  gwc: {
+    plugin: "gwc",
+    binary: "gws",
+    check: "gws --version",
+    install_steps: [
+      "npm install -g @googleworkspace/cli",
+      "gws --version"
+    ],
+    note: "Installation is intentionally delegated to your LLM/automation flow (dcli/scli/supercli)."
+  },
+  commiat: {
+    plugin: "commiat",
+    binary: "commiat",
+    check: "commiat --version",
+    install_steps: [
+      "npm install -g commiat",
+      "commiat --version"
+    ],
+    note: "Installation is intentionally delegated to your LLM/automation flow (dcli/scli/supercli)."
+  },
+  docker: {
+    plugin: "docker",
+    binary: "docker",
+    check: "docker --version",
+    install_steps: [
+      "docker --version"
+    ],
+    note: "Install Docker Engine/Desktop using your OS package manager, then verify with docker --version."
+  },
+  stripe: {
+    plugin: "stripe",
+    binary: "stripe",
+    check: "stripe --version",
+    install_steps: [
+      "brew install stripe/stripe-cli/stripe",
+      "stripe --version",
+      "stripe login"
+    ],
+    note: "Install Stripe CLI and authenticate with stripe login before running API commands."
+  },
+  vercel: {
+    plugin: "vercel",
+    binary: "vercel",
+    check: "vercel --version",
+    install_steps: [
+      "npm install -g vercel",
+      "vercel --version",
+      "vercel login"
+    ],
+    note: "Install Vercel CLI and authenticate with vercel login before running account or project commands."
+  },
+  linear: {
+    plugin: "linear",
+    binary: "linear",
+    check: "linear --version",
+    install_steps: [
+      "npm install -g @schpet/linear-cli",
+      "npm install -D @schpet/linear-cli",
+      "linear --version",
+      "linear auth login"
+    ],
+    note: "Targets community package @schpet/linear-cli; if installed locally, invoke via npx --no-install linear."
+  },
+  railway: {
+    plugin: "railway",
+    binary: "railway",
+    check: "railway --version",
+    install_steps: [
+      "npm install -g @railway/cli",
+      "npm install -D @railway/cli",
+      "railway --version",
+      "railway login"
+    ],
+    note: "If installed locally, use npx --no-install railway and ensure node_modules/.bin is in PATH for dcli plugin execution."
+  },
+  supabase: {
+    plugin: "supabase",
+    binary: "supabase",
+    check: "supabase --version",
+    install_steps: [
+      "npm install -g supabase",
+      "npm install -D supabase",
+      "supabase --version",
+      "supabase login"
+    ],
+    note: "If installed locally, use npx --no-install supabase and ensure node_modules/.bin is in PATH for dcli plugin execution."
+  },
+  gh: {
+    plugin: "gh",
+    binary: "gh",
+    check: "gh --version",
+    install_steps: [
+      "gh --version",
+      "gh auth login"
+    ],
+    note: "Install GitHub CLI with your platform package manager and authenticate with gh auth login before using account or repo commands."
+  },
+  kubectl: {
+    plugin: "kubectl",
+    binary: "kubectl",
+    check: "kubectl version --client",
+    install_steps: [
+      "kubectl version --client",
+      "kubectl config current-context"
+    ],
+    note: "Install kubectl with your platform package manager and ensure your kubeconfig is already configured before using cluster commands."
+  },
+  terraform: {
+    plugin: "terraform",
+    binary: "terraform",
+    check: "terraform version -json",
+    install_steps: [
+      "terraform version -json",
+      "terraform init"
+    ],
+    note: "Install Terraform with your platform package manager. For state-dependent commands, run inside an initialized Terraform working directory."
+  },
+  aws: {
+    plugin: "aws",
+    binary: "aws",
+    check: "aws --version",
+    install_steps: [
+      "aws --version",
+      "aws configure"
+    ],
+    note: "Install AWS CLI with your platform package manager and configure credentials before using account or service commands."
+  },
+  gcloud: {
+    plugin: "gcloud",
+    binary: "gcloud",
+    check: "gcloud --version",
+    install_steps: [
+      "gcloud --version",
+      "gcloud auth login"
+    ],
+    note: "Install Google Cloud CLI with your platform package manager and authenticate with gcloud auth login before using account or project commands."
+  },
+  az: {
+    plugin: "az",
+    binary: "az",
+    check: "az version",
+    install_steps: [
+      "az version",
+      "az login"
+    ],
+    note: "Install Azure CLI with your platform package manager and authenticate with az login before using account or resource commands."
+  },
+  helm: {
+    plugin: "helm",
+    binary: "helm",
+    check: "helm version --short",
+    install_steps: [
+      "helm version --short",
+      "kubectl config current-context"
+    ],
+    note: "Install Helm with your platform package manager. For release and cluster-backed commands, ensure your Kubernetes context is already configured."
+  },
+  npm: {
+    plugin: "npm",
+    binary: "npm",
+    check: "npm --version",
+    install_steps: [
+      "npm --version",
+      "npm login"
+    ],
+    note: "npm is usually installed with Node.js. Run npm login only if you need authenticated registry operations."
+  },
+  pulumi: {
+    plugin: "pulumi",
+    binary: "pulumi",
+    check: "pulumi version",
+    install_steps: [
+      "pulumi version",
+      "pulumi login"
+    ],
+    note: "Install Pulumi with your platform package manager and authenticate with pulumi login before using stack or cloud-backed commands."
+  },
+  pnpm: {
+    plugin: "pnpm",
+    binary: "pnpm",
+    check: "pnpm --version",
+    install_steps: [
+      "pnpm --version",
+      "pnpm login"
+    ],
+    note: "Install pnpm with your platform package manager or via corepack. Run pnpm login only if you need authenticated registry operations."
+  },
+  uv: {
+    plugin: "uv",
+    binary: "uv",
+    check: "uv --version",
+    install_steps: [
+      "curl -LsSf https://astral.sh/uv/install.sh | sh",
+      "uv --version"
+    ],
+    note: "Install uv with the official installer or your platform package manager. Run uv auth login only if you need private index authentication."
+  },
+  poetry: {
+    plugin: "poetry",
+    binary: "poetry",
+    check: "poetry --version",
+    install_steps: [
+      "curl -sSL https://install.python-poetry.org | python3 -",
+      "poetry --version"
+    ],
+    note: "Install Poetry with the official installer or pipx. Configure repository credentials only if you need private package publishing or installs."
+  },
+  eza: {
+    plugin: "eza",
+    binary: "eza",
+    check: "eza --version",
+    install_steps: [
+      "cargo install eza",
+      "eza --version"
+    ],
+    note: "Install eza with your platform package manager or cargo. It is a non-interactive ls replacement, so no login or account setup is required."
+  },
+  just: {
+    plugin: "just",
+    binary: "just",
+    check: "just --version",
+    install_steps: [
+      "cargo install just",
+      "just --version"
+    ],
+    note: "Install just with your platform package manager or cargo. Most useful commands operate on a nearby justfile, but help and version commands work anywhere."
+  },
+  watchexec: {
+    plugin: "watchexec",
+    binary: "watchexec",
+    check: "watchexec --version",
+    install_steps: [
+      "cargo install --locked watchexec-cli",
+      "watchexec --version"
+    ],
+    note: "Install watchexec with your platform package manager, cargo binstall, or cargo. It is non-interactive and works well for scripted file-watching workflows."
+  },
+  nextest: {
+    plugin: "nextest",
+    binary: "cargo-nextest",
+    check: "cargo-nextest --version",
+    install_steps: [
+      "cargo install cargo-nextest --locked",
+      "cargo-nextest --version"
+    ],
+    note: "Install cargo-nextest with prebuilt binaries or cargo. Most commands are intended for Rust workspaces, but version and help commands work anywhere."
+  },
+  cline: {
+    plugin: "cline",
+    binary: "cline",
+    check: "cline --version",
+    install_steps: [
+      "npm install -g cline",
+      "cline --version",
+      "supercli plugins install cline",
+      "supercli cline cli version --json",
+      "supercli cline task run --prompt \"List files with more LOC in cwd\" --cwd . --timeout 30 --json",
+      "supercli skills sync --json",
+      "supercli skills get repo:cline-non-interactive"
+    ],
+    note: "Prefer the wrapped cline task run/plan commands for unattended automation. They bake in documented non-interactive defaults with JSON streaming support and are easier for agents to parse than raw passthrough."
+  },
+  nullclaw: {
+    plugin: "nullclaw",
+    binary: "nullclaw",
+    check: "nullclaw --version",
+    install_steps: [
+      "supercli plugins install nullclaw",
+      "curl --version",
+      "brew install nullclaw",
+      "nullclaw --version",
+      "supercli skills list --catalog --provider nullclaw --json",
+      "supercli skills get nullclaw:root.agents",
+      "supercli nullclaw cli version --json",
+      "supercli nullclaw system status --json"
+    ],
+    note: "This hybrid plugin indexes remote NullClaw docs into the local skills catalog and exposes the local nullclaw binary through wrapped commands plus passthrough. curl is required for remote doc retrieval."
+  },
+  "agency-agents": {
+    plugin: "agency-agents",
+    binary: "curl",
+    check: "curl --version",
+    install_steps: [
+      "supercli plugins install agency-agents",
+      "supercli skills list --catalog --provider agency-agents --json",
+      "supercli skills get agency-agents:engineering.engineering-frontend-developer"
+    ],
+    note: "Install indexes remote markdown skills from https://github.com/msitarzewski/agency-agents (best effort, upstream paths may change)."
+  },
+  "visual-explainer": {
+    plugin: "visual-explainer",
+    binary: "curl",
+    check: "curl --version",
+    install_steps: [
+      "supercli plugins install visual-explainer",
+      "supercli skills list --catalog --provider visual-explainer --json",
+      "supercli skills get visual-explainer:visual-explainer.skill"
+    ],
+    note: "Install indexes normalized markdown skills from https://github.com/javimosch/visual-explainer (plugins/visual-explainer-normalized)."
+  }
+}
+
+function getPluginInstallGuidance(name) {
+  return PLUGIN_INSTALL_GUIDANCE[name] || null
+}
+
+module.exports = {
+  getPluginInstallGuidance
+}