superacli 1.1.0 → 1.1.2

package/plugins/visual-explainer/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "visual-explainer",
+  "version": "0.1.0",
+  "description": "Remote skills index for javimosch/visual-explainer normalized markdown skills",
+  "source": "https://github.com/javimosch/visual-explainer",
+  "checks": [
+    { "type": "binary", "name": "curl" }
+  ],
+  "post_install": {
+    "script": "scripts/post-install.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "commands": []
+}

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-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."

package/tests/test-helm-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 "== Helm smoke test (interactive) =="
+
+if ! command -v helm >/dev/null 2>&1; then
+  echo "Helm not found in PATH."
+  echo "Install it first: https://helm.sh/docs/intro/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 helm plugin..."
+node "${CLI}" plugins install helm --on-conflict replace --json >/dev/null
+
+echo "Checking Helm CLI availability (helm version --short)..."
+helm version --short >/dev/null
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" helm cli version --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" helm version --short
+
+echo "Smoke test completed."

package/tests/test-just-smoke.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+CLI="${ROOT_DIR}/cli/supercli.js"
+TMP_DIR="$(mktemp -d)"
+trap 'rm -rf "${TMP_DIR}"' EXIT
+
+echo "== just smoke test (interactive) =="
+
+if ! command -v just >/dev/null 2>&1; then
+  echo "just not found in PATH."
+  echo "Install it first: https://just.systems"
+  exit 1
+fi
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "Node.js not found in PATH"
+  exit 1
+fi
+
+cat > "${TMP_DIR}/justfile" <<'EOF'
+default:
+	@echo smoke-ok
+EOF
+
+echo "Installing/refreshing just plugin..."
+node "${CLI}" plugins install just --on-conflict replace --json >/dev/null
+
+echo "Checking just CLI availability (just --version)..."
+just --version >/dev/null
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" just cli version --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" just --list --justfile "${TMP_DIR}/justfile"
+
+echo "Smoke test completed."

package/tests/test-kubectl-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 "== kubectl smoke test (interactive) =="
+
+if ! command -v kubectl >/dev/null 2>&1; then
+  echo "kubectl not found in PATH."
+  echo "Install it first: https://kubernetes.io/docs/tasks/tools/"
+  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 kubectl plugin..."
+node "${CLI}" plugins install kubectl --on-conflict replace --json >/dev/null
+
+echo "Checking Kubernetes context (kubectl config current-context)..."
+if ! kubectl config current-context >/dev/null 2>&1; then
+  echo "No active kubectl context found. Configure kubeconfig first, then rerun this script."
+  echo "Verify with: kubectl config current-context"
+  exit 1
+fi
+
+echo "Running wrapped command smoke test..."
+node "${CLI}" kubectl config current-context --json
+
+echo "Running passthrough smoke test..."
+node "${CLI}" kubectl get pods -o json
+
+echo "Smoke test completed."