superacli 1.0.1 → 1.1.2

package/plugins/visual-explainer/scripts/post-install.js

@@ -0,0 +1,111 @@
+const { spawnSync } = require("child_process")
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+const OWNER = "javimosch"
+const REPO = "visual-explainer"
+const REF = "main"
+const SOURCE_REPO = `https://github.com/${OWNER}/${REPO}`
+const TREE_URL = `https://api.github.com/repos/${OWNER}/${REPO}/git/trees/${REF}?recursive=1`
+const RAW_BASE_URL = `https://raw.githubusercontent.com/${OWNER}/${REPO}/${REF}`
+const NORMALIZED_PREFIX = "plugins/visual-explainer-normalized/"
+
+function integrationError(message, suggestions = []) {
+  return Object.assign(new Error(message), {
+    code: 105,
+    type: "integration_error",
+    recoverable: true,
+    suggestions
+  })
+}
+
+function fetchJson(url) {
+  const res = spawnSync("curl", ["-fsSL", url], { encoding: "utf-8", timeout: 15000 })
+  if (res.error) {
+    throw integrationError(`Failed to fetch visual-explainer metadata: ${res.error.message}`, ["Check internet connectivity", "Retry: supercli plugins install visual-explainer"])
+  }
+  if (res.status !== 0) {
+    throw integrationError(`Failed to fetch visual-explainer metadata: ${(res.stderr || "").trim() || `exit ${res.status}`}`, ["Check internet connectivity", "Retry: supercli plugins install visual-explainer"])
+  }
+  try {
+    return JSON.parse((res.stdout || "").trim() || "{}")
+  } catch (err) {
+    throw integrationError(`Invalid visual-explainer metadata response: ${err.message}`)
+  }
+}
+
+function isNormalizedSkillFile(filePath) {
+  return filePath.startsWith(NORMALIZED_PREFIX) && filePath.endsWith(".md")
+}
+
+function toSkillId(relativePath) {
+  if (relativePath === "SKILL.md") return "visual-explainer.skill"
+  return `visual-explainer.${relativePath.replace(/\.md$/, "").replace(/\//g, ".")}`
+}
+
+function toSkillName(relativePath) {
+  const base = relativePath.split("/").pop() || relativePath
+  return base
+    .replace(/\.md$/, "")
+    .split("-")
+    .map(part => (part ? part[0].toUpperCase() + part.slice(1) : part))
+    .join(" ")
+}
+
+function buildRemoteEntriesFromTree(treeResponse) {
+  const tree = Array.isArray(treeResponse.tree) ? treeResponse.tree : []
+  const entries = []
+
+  for (const node of tree) {
+    if (!node || node.type !== "blob" || typeof node.path !== "string") continue
+    if (!isNormalizedSkillFile(node.path)) continue
+    const relativePath = node.path.slice(NORMALIZED_PREFIX.length)
+    entries.push({
+      id: toSkillId(relativePath),
+      name: toSkillName(relativePath),
+      path: node.path,
+      source_url: `${RAW_BASE_URL}/${node.path}`
+    })
+  }
+
+  entries.sort((a, b) => a.id.localeCompare(b.id))
+  return entries
+}
+
+function run() {
+  const treeResponse = fetchJson(TREE_URL)
+  const entries = buildRemoteEntriesFromTree(treeResponse)
+  if (entries.length === 0) {
+    throw integrationError("visual-explainer plugin found no normalized remote skill files to index")
+  }
+
+  addProvider({
+    name: "visual-explainer",
+    type: "remote_static",
+    enabled: true,
+    source_repo: SOURCE_REPO,
+    ref: REF,
+    entries
+  })
+
+  const index = syncCatalog()
+  return {
+    provider: "visual-explainer",
+    entries: entries.length,
+    synced_skills: Array.isArray(index.skills) ? index.skills.length : 0
+  }
+}
+
+if (require.main === module) {
+  try {
+    const result = run()
+    process.stdout.write(JSON.stringify(result))
+  } catch (err) {
+    process.stderr.write(err.message)
+    process.exit(1)
+  }
+}
+
+module.exports = {
+  run,
+  buildRemoteEntriesFromTree
+}

package/plugins/watchexec/README.md

@@ -0,0 +1,40 @@
+# watchexec Plugin Harness
+
+This plugin integrates the watchexec CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Ensure watchexec is available on your machine:
+
+```bash
+watchexec --version
+```
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the watchexec CLI version via `watchexec --version`.
+
+```bash
+dcli watchexec cli version --json
+```
+
+### Full Passthrough
+
+You can run any watchexec command through the `watchexec` namespace.
+
+```bash
+# Show help
+dcli watchexec --help
+
+# Print the manual
+dcli watchexec --manual
+
+# Run a watcher command directly
+dcli watchexec -e js -- echo changed
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/watchexec/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "watchexec",
+  "version": "0.1.0",
+  "description": "watchexec CLI plugin for dcli",
+  "source": "https://github.com/watchexec/watchexec",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "watchexec"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "watchexec",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show watchexec CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "watchexec",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install watchexec to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "watchexec",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any watchexec CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "watchexec",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install watchexec to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/tests/test-aws-smoke.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+
+echo "== AWS CLI smoke test (interactive) =="
+
+if ! command -v aws >/dev/null 2>&1; then
+  echo "AWS CLI not found in PATH."
+  echo "Install it first: https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+echo "Installing/refreshing aws plugin..."
+node "${CLI}" plugins install aws --on-conflict replace --json >/dev/null
+
+echo "Checking AWS authentication (aws sts get-caller-identity)..."
+if ! aws sts get-caller-identity >/dev/null 2>&1; then
+  if [[ ! -t 0 ]]; then
+    echo "No working AWS credentials found and no TTY available. Run 'aws configure' manually, then rerun this script."
+    exit 1
+  fi
+
+  echo "AWS credentials are required for live smoke tests."
+  read -r -p "Run 'aws configure' now? [Y/n] " ANSWER
+  ANSWER="${ANSWER:-Y}"
+  if [[ "${ANSWER}" =~ ^[Yy]$ ]]; then
+    aws configure
+  else
+    echo "Cancelled. Run 'aws configure' and retry when ready."
+    exit 1
+  fi
+
+  if ! aws sts get-caller-identity >/dev/null 2>&1; then
+    echo "AWS authentication check still failed after configure."
+    echo "Verify with: aws sts get-caller-identity"
+    exit 1
+  fi
+else
+  echo "AWS CLI is already authenticated. Skipping configuration."
+fi
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" aws account identity --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" aws s3api list-buckets
+
+echo "Smoke test completed."

package/tests/test-az-smoke.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+
+echo "== Azure CLI smoke test (interactive) =="
+
+if ! command -v az >/dev/null 2>&1; then
+  echo "Azure CLI not found in PATH."
+  echo "Install it first: https://learn.microsoft.com/cli/azure/install-azure-cli"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+echo "Installing/refreshing az plugin..."
+node "${CLI}" plugins install az --on-conflict replace --json >/dev/null
+
+echo "Checking Azure authentication (az account show)..."
+if ! az account show >/dev/null 2>&1; then
+  if [[ ! -t 0 ]]; then
+    echo "No working Azure login found and no TTY available. Run 'az login' manually, then rerun this script."
+    exit 1
+  fi
+
+  echo "Azure authentication is required for live smoke tests."
+  read -r -p "Run 'az login' now? [Y/n] " ANSWER
+  ANSWER="${ANSWER:-Y}"
+  if [[ "${ANSWER}" =~ ^[Yy]$ ]]; then
+    az login
+  else
+    echo "Cancelled. Run 'az login' and retry when ready."
+    exit 1
+  fi
+
+  if ! az account show >/dev/null 2>&1; then
+    echo "Azure authentication check still failed after login."
+    echo "Verify with: az account show"
+    exit 1
+  fi
+else
+  echo "Azure CLI is already authenticated. Skipping login."
+fi
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" az account show --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" az group list
+
+echo "Smoke test completed."

package/tests/test-cli.js

@@ -6,6 +6,8 @@
  */
 
 const { execSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
 const path = require("path");
 
 const SERVER = process.env.SUPERCLI_SERVER || "http://127.0.0.1:3000";
@@ -134,6 +136,18 @@ test("help --json returns namespaces", () => {
   assert(Array.isArray(d.namespaces), "should have namespaces array");
 });
 
+test("no-args non-tty returns agent bootstrap payload", () => {
+  const r = runNoServer("--json");
+  assert(r.ok, "no-args json should succeed");
+  const d = JSON.parse(r.output);
+  assert(d.mode === "agent_bootstrap", "should return agent bootstrap mode");
+  assert(Array.isArray(d.next), "should include next commands");
+  assert(
+    d.next.includes("supercli skills teach --format skill.md"),
+    "should point agents to skills teach",
+  );
+});
+
 // ── --help-json ──
 test("--help-json returns capability discovery", () => {
   run("sync --json");
@@ -163,8 +177,8 @@ test("sync is unavailable when SUPERCLI_SERVER is not set", () => {
 });
 
 test("plan works in local mode without SUPERCLI_SERVER", () => {
-  run("sync --json");
-  const r = runNoServer("plan test items list --json");
+  runNoServer("plugins install beads --json");
+  const r = runNoServer("plan beads install steps --json");
   assert(r.ok, "local plan should succeed");
   const d = JSON.parse(r.output);
   assert(d.execution_mode === "local", "execution_mode should be local");
@@ -173,6 +187,7 @@ test("plan works in local mode without SUPERCLI_SERVER", () => {
     Array.isArray(d.steps) && d.steps.length > 0,
     "should include plan steps",
   );
+  runNoServer("plugins remove beads --json");
 });
 
 test("local mcp registry can add/list/remove without SUPERCLI_SERVER", () => {
@@ -197,6 +212,95 @@ test("local mcp registry can add/list/remove without SUPERCLI_SERVER", () => {
   assert(remove.ok, "mcp remove should succeed");
 });
 
+test("plugins install/list/show/remove works locally", () => {
+  const install = runNoServer("plugins install ./plugins/beads --json");
+  assert(install.ok, "plugins install should succeed");
+  const installData = JSON.parse(install.output);
+  assert(installData.ok === true, "install should return ok");
+
+  const list = runNoServer("plugins list --json");
+  assert(list.ok, "plugins list should succeed");
+  const listData = JSON.parse(list.output);
+  assert(Array.isArray(listData.plugins), "plugins list should return array");
+  assert(listData.plugins.find((p) => p.name === "beads"), "beads plugin should be listed");
+
+  const show = runNoServer("plugins show beads --json");
+  assert(show.ok, "plugins show should succeed");
+  const showData = JSON.parse(show.output);
+  assert(showData.plugin.name === "beads", "plugins show should return beads plugin");
+
+  const doctor = runNoServer("plugins doctor beads --json");
+  assert(doctor.ok, "plugins doctor should succeed");
+  const doctorData = JSON.parse(doctor.output);
+  assert(doctorData.plugin === "beads", "doctor should target beads plugin");
+  assert(Array.isArray(doctorData.checks), "doctor should include checks array");
+
+  const remove = runNoServer("plugins remove beads --json");
+  assert(remove.ok, "plugins remove should succeed");
+});
+
+test("beads install steps command works after plugin install", () => {
+  runNoServer("plugins install beads --json");
+  const r = runNoServer("beads install steps --json");
+  assert(r.ok, "beads install steps should succeed");
+  const d = JSON.parse(r.output);
+  assert(d.data && Array.isArray(d.data.install_steps), "should include install steps array");
+  runNoServer("plugins remove beads --json");
+});
+
+test("gwc plugin supports install/show/doctor and passthrough", () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), "dcli-gws-"));
+  const gwsPath = path.join(dir, "gws");
+  fs.writeFileSync(
+    gwsPath,
+    [
+      "#!/usr/bin/env node",
+      "const args = process.argv.slice(2);",
+      "if (args.includes('--version')) { console.log('gws 0.0.0-test'); process.exit(0); }",
+      "if (args.length === 0 || args.includes('--help')) { console.log('gws-help-ok'); process.exit(0); }",
+      "console.log(JSON.stringify({ ok: true, args }));"
+    ].join("\n"),
+    "utf-8",
+  );
+  fs.chmodSync(gwsPath, 0o755);
+
+  const env = { ...process.env, PATH: `${dir}:${process.env.PATH || ""}` };
+
+  const install = runNoServer("plugins install ./plugins/gwc --json", { env });
+  assert(install.ok, "gwc install should succeed");
+
+  const show = runNoServer("plugins show gwc --json", { env });
+  assert(show.ok, "plugins show gwc should succeed");
+  const showData = JSON.parse(show.output);
+  assert(showData.plugin.name === "gwc", "plugins show should return gwc plugin");
+
+  const doctor = runNoServer("plugins doctor gwc --json", { env });
+  assert(doctor.ok, "plugins doctor gwc should succeed");
+  const doctorData = JSON.parse(doctor.output);
+  assert(doctorData.ok === true, "gwc doctor should pass with mocked gws binary");
+
+  const passthroughHelp = runNoServer("gwc --help --json", { env });
+  assert(passthroughHelp.ok, "gwc passthrough help should succeed");
+  const helpData = JSON.parse(passthroughHelp.output);
+  assert(helpData.data && helpData.data.raw.includes("gws-help-ok"), "gwc help should passthrough to gws");
+
+  const passthrough = runNoServer("gwc drive files list --params '{\"pageSize\":1}' --json", { env });
+  assert(passthrough.ok, "gwc passthrough call should succeed");
+  const passData = JSON.parse(passthrough.output);
+  assert(passData.data && passData.data.ok === true, "gwc passthrough should return gws JSON");
+  assert(Array.isArray(passData.data.args), "gwc passthrough should include forwarded args");
+  assert(passData.data.args[0] === "drive", "gwc passthrough should preserve positional args");
+
+  const installSteps = runNoServer("gwc install steps --json", { env });
+  assert(installSteps.ok, "gwc install steps should use builtin command");
+  const installData = JSON.parse(installSteps.output);
+  assert(Array.isArray(installData.data.install_steps), "gwc install steps should include install steps");
+
+  const remove = runNoServer("plugins remove gwc --json", { env });
+  assert(remove.ok, "plugins remove gwc should succeed");
+  fs.rmSync(dir, { recursive: true, force: true });
+});
+
 // ── config show ──
 test("config show returns cache info", () => {
   // First sync
@@ -237,6 +341,10 @@ test("skills list --json returns minimal metadata", () => {
     Object.keys(first).sort().join(",") === "description,name",
     "skill metadata should only include name and description",
   );
+  assert(
+    d.skills.some((s) => s.name === "plugins.registry.usage"),
+    "skills list should include plugins registry usage skill",
+  );
 });
 
 // ── skills teach ──
@@ -267,6 +375,12 @@ test("skills get can include DAG section", () => {
   assert(r.output.includes("dag:"), "should include dag section");
 });
 
+test("skills get plugins registry usage skill", () => {
+  const r = run("skills get plugins.registry.usage");
+  assert(r.ok, "plugins registry skill should succeed");
+  assert(r.output.includes("plugins explore"), "plugins registry skill should include explore guidance");
+});
+
 // ── namespace listing ──
 test("namespace listing returns resources", () => {
   const r = run("test --json");

package/tests/test-cline-smoke.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+
+echo "== cline smoke test (interactive) =="
+
+if ! command -v cline >/dev/null 2>&1; then
+  echo "cline not found in PATH."
+  echo "Install it first and verify with: cline --version"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+echo "Installing/refreshing cline plugin..."
+node "${CLI}" plugins install cline --on-conflict replace --json >/dev/null
+
+echo "Running wrapped version command..."
+node "${CLI}" cline cli version --json
+
+echo "Running wrapped non-interactive task command..."
+node "${CLI}" cline task run --prompt "List files with more LOC in cwd" --cwd . --timeout 30 --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" cline --help
+
+echo "Syncing and checking local skill catalog..."
+node "${CLI}" skills sync --json >/dev/null
+node "${CLI}" skills get repo:cline-non-interactive >/dev/null
+
+echo "Smoke test completed."

package/tests/test-eza-smoke.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+
+echo "== eza smoke test (interactive) =="
+
+if ! command -v eza >/dev/null 2>&1; then
+  echo "eza not found in PATH."
+  echo "Install it first: https://eza.rocks"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+echo "Installing/refreshing eza plugin..."
+node "${CLI}" plugins install eza --on-conflict replace --json >/dev/null
+
+echo "Checking eza CLI availability (eza --version)..."
+eza --version >/dev/null
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" eza cli version --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" eza --oneline --color=never
+
+echo "Smoke test completed."

package/tests/test-gcloud-smoke.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+
+echo "== Google Cloud CLI smoke test (interactive) =="
+
+if ! command -v gcloud >/dev/null 2>&1; then
+  echo "gcloud not found in PATH."
+  echo "Install it first: https://cloud.google.com/sdk/docs/install"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+echo "Installing/refreshing gcloud plugin..."
+node "${CLI}" plugins install gcloud --on-conflict replace --json >/dev/null
+
+echo "Checking Google Cloud authentication (gcloud auth list --format=json)..."
+if ! gcloud auth list --format=json >/dev/null 2>&1; then
+  if [[ ! -t 0 ]]; then
+    echo "No working gcloud auth found and no TTY available. Run 'gcloud auth login' manually, then rerun this script."
+    exit 1
+  fi
+
+  echo "Google Cloud authentication is required for live smoke tests."
+  read -r -p "Run 'gcloud auth login' now? [Y/n] " ANSWER
+  ANSWER="${ANSWER:-Y}"
+  if [[ "${ANSWER}" =~ ^[Yy]$ ]]; then
+    gcloud auth login
+  else
+    echo "Cancelled. Run 'gcloud auth login' and retry when ready."
+    exit 1
+  fi
+
+  if ! gcloud auth list --format=json >/dev/null 2>&1; then
+    echo "Google Cloud authentication check still failed after login."
+    echo "Verify with: gcloud auth list --format=json"
+    exit 1
+  fi
+else
+  echo "Google Cloud CLI is already authenticated. Skipping login."
+fi
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" gcloud account list --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" gcloud projects list --format=json
+
+echo "Smoke test completed."

package/tests/test-gh-smoke.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+
+echo "== GitHub CLI smoke test (interactive) =="
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "GitHub CLI not found in PATH (expected binary: gh)."
+  echo "Install it first: https://cli.github.com/"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+echo "Installing/refreshing gh plugin..."
+node "${CLI}" plugins install gh --on-conflict replace --json >/dev/null
+
+echo "Checking GitHub authentication (gh auth status)..."
+if ! gh auth status >/dev/null 2>&1; then
+  if [[ ! -t 0 ]]; then
+    echo "Not authenticated and no TTY available. Run 'gh auth login' manually, then rerun this script."
+    exit 1
+  fi
+
+  echo "GitHub login is required for live smoke tests."
+  read -r -p "Run 'gh auth login' now? [Y/n] " ANSWER
+  ANSWER="${ANSWER:-Y}"
+  if [[ "${ANSWER}" =~ ^[Yy]$ ]]; then
+    gh auth login
+  else
+    echo "Cancelled. Run 'gh auth login' and retry when ready."
+    exit 1
+  fi
+
+  if ! gh auth status >/dev/null 2>&1; then
+    echo "GitHub authentication check still failed after login."
+    echo "Verify with: gh auth status"
+    exit 1
+  fi
+else
+  echo "GitHub CLI is already authenticated. Skipping login."
+fi
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" gh account status --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" gh repo list --limit 1 --json name,nameWithOwner,url
+
+echo "Smoke test completed."