superacli 1.0.1 → 1.1.2

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
+}

package/cli/plugins-command.js

@@ -0,0 +1,138 @@
+const {
+  installPlugin,
+  removePlugin,
+  getPlugin,
+  listInstalledPlugins,
+  getPluginInstallGuidance,
+  doctorPlugin,
+  doctorAllPlugins
+} = require("./plugins-manager")
+const { listRegistryPlugins } = require("./plugins-registry")
+const { loadConfig } = require("./config")
+
+async function handlePluginsCommand(options) {
+  const { positional, flags, humanMode, output, outputHumanTable, outputError } = options
+  const subcommand = positional[1]
+
+  if (subcommand === "list") {
+    const plugins = listInstalledPlugins().map(p => ({
+      name: p.name,
+      version: p.version,
+      commands: (p.commands || []).length,
+      description: p.description || ""
+    }))
+    if (humanMode) {
+      console.log("\n  ⚡ Plugins\n")
+      outputHumanTable(plugins, [
+        { key: "name", label: "Name" },
+        { key: "version", label: "Version" },
+        { key: "commands", label: "Commands" },
+        { key: "description", label: "Description" }
+      ])
+      console.log("")
+    } else {
+      output({ plugins })
+    }
+    return true
+  }
+
+  if (subcommand === "install") {
+    const ref = positional[2]
+    const gitRepo = flags.git
+    const manifestPath = flags["manifest-path"]
+    const gitRef = flags.ref
+
+    if (!ref && !gitRepo) {
+      outputError({
+        code: 85,
+        type: "invalid_argument",
+        message: "Usage: dcli plugins install <name|path> [--on-conflict fail|skip|replace] OR dcli plugins install --git <repo> --manifest-path <path> [--ref <ref>]",
+        recoverable: false
+      })
+      return true
+    }
+    const config = await loadConfig()
+    const result = installPlugin(ref || "(git)", {
+      onConflict: flags["on-conflict"] || "fail",
+      currentCommands: config.commands || [],
+      git: gitRepo,
+      manifestPath,
+      ref: gitRef
+    })
+    const guidance = getPluginInstallGuidance(result.plugin)
+    output({ ok: true, ...result, install_guidance: guidance })
+    return true
+  }
+
+  if (subcommand === "explore") {
+    const tags = String(flags.tags || "")
+      .split(",")
+      .map(t => t.trim())
+      .filter(Boolean)
+    const name = flags.name ? String(flags.name).trim() : ""
+    const plugins = listRegistryPlugins({ name, tags }).map(p => ({
+      name: p.name,
+      description: p.description,
+      tags: p.tags,
+      source_type: (p.source && p.source.type) || "bundled",
+      source_repo: p.source && p.source.repo ? p.source.repo : ""
+    }))
+
+    if (humanMode) {
+      console.log("\n  ⚡ Plugin Registry\n")
+      outputHumanTable(plugins, [
+        { key: "name", label: "Name" },
+        { key: "source_type", label: "Source" },
+        { key: "tags", label: "Tags" },
+        { key: "description", label: "Description" }
+      ])
+      console.log("")
+    } else {
+      output({
+        plugins,
+        filters: {
+          name: name || null,
+          tags
+        }
+      })
+    }
+    return true
+  }
+
+  if (subcommand === "remove") {
+    const name = positional[2]
+    if (!name) {
+      outputError({ code: 85, type: "invalid_argument", message: "Usage: dcli plugins remove <name>", recoverable: false })
+      return true
+    }
+    output({ ok: true, removed: removePlugin(name) })
+    return true
+  }
+
+  if (subcommand === "show") {
+    const name = positional[2]
+    if (!name) {
+      outputError({ code: 85, type: "invalid_argument", message: "Usage: dcli plugins show <name>", recoverable: false })
+      return true
+    }
+    const plugin = getPlugin(name)
+    if (!plugin) {
+      outputError({ code: 92, type: "resource_not_found", message: `Plugin '${name}' is not installed`, suggestions: ["Run: dcli plugins list"] })
+      return true
+    }
+    output({ plugin, install_guidance: getPluginInstallGuidance(name) })
+    return true
+  }
+
+  if (subcommand === "doctor") {
+    const name = positional[2]
+    const report = name ? doctorPlugin(name) : doctorAllPlugins()
+    output(report)
+    return true
+  }
+
+  outputError({ code: 85, type: "invalid_argument", message: "Unknown plugins subcommand. Use: list, explore, install, remove, show, doctor", recoverable: false })
+  return true
+}
+
+module.exports = { handlePluginsCommand }