superacli 1.0.1 → 1.1.2

package/plugins/stripe/README.md

@@ -0,0 +1,49 @@
+# Stripe Plugin Harness
+
+This plugin integrates the [Stripe CLI](https://stripe.com/docs/stripe-cli) natively into dcli, providing both wrapped core commands and full passthrough support.
+
+## Prerequisites
+
+You must have the Stripe CLI installed to use this plugin:
+
+```bash
+# macOS (Homebrew)
+brew install stripe/stripe-cli/stripe
+
+# Linux/Windows
+# See: https://docs.stripe.com/stripe-cli
+```
+
+Make sure you are authenticated before using it:
+```bash
+stripe login
+```
+
+## Available Commands
+
+### Customers List
+
+Lists the Stripe customers associated with your account.
+
+```bash
+dcli stripe customers list --limit 10 --json
+```
+
+### Full Passthrough
+
+You can pass *any* Stripe CLI command directly via the passthrough functionality.
+
+```bash
+# Listen to webhooks
+dcli stripe listen --forward-to localhost:3000
+
+# Trigger events
+dcli stripe trigger payment_intent.succeeded
+
+# Show CLI version
+dcli stripe version
+```
+
+## Output
+
+All commands execute the underlying `stripe` binary and wrap the standard output in dcli's JSON envelope format.

package/plugins/stripe/plugin.json

@@ -0,0 +1,52 @@
+{
+  "name": "stripe",
+  "version": "0.1.0",
+  "description": "Stripe CLI plugin for dcli",
+  "source": "https://stripe.com/docs/stripe-cli",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "stripe"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "stripe",
+      "resource": "customers",
+      "action": "list",
+      "description": "List existing Stripe customers",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "stripe",
+        "baseArgs": ["customers", "list"],
+        "optionalArgs": {
+          "limit": "--limit"
+        },
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the Stripe CLI to use this command."
+      },
+      "args": [
+        {
+          "name": "limit",
+          "type": "integer",
+          "required": false,
+          "description": "Limit the number of customers returned"
+        }
+      ]
+    },
+    {
+      "namespace": "stripe",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Stripe CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "stripe",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the Stripe CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/supabase/README.md

@@ -0,0 +1,55 @@
+# Supabase Plugin Harness
+
+This plugin integrates the Supabase CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install Supabase CLI globally or locally:
+
+```bash
+# Global install
+npm install -g supabase
+
+# Local install in this repo
+npm install -D supabase
+```
+
+Verify the binary:
+
+```bash
+supabase --version
+# if local only:
+npx --no-install supabase --version
+```
+
+Authenticate before running management commands:
+
+```bash
+supabase login
+```
+
+## Available Commands
+
+### Projects List (Wrapped)
+
+Returns the authenticated account projects via `supabase projects list --output json`.
+
+```bash
+dcli supabase projects list --json
+```
+
+### Full Passthrough
+
+You can run any Supabase CLI command through the `supabase` namespace.
+
+```bash
+# Show CLI help
+dcli supabase --help
+
+# List projects directly via passthrough
+dcli supabase projects list --output json
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/supabase/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "supabase",
+  "version": "0.1.0",
+  "description": "Supabase CLI plugin for dcli",
+  "source": "https://supabase.com/docs/reference/cli/introduction",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "supabase"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "supabase",
+      "resource": "projects",
+      "action": "list",
+      "description": "List Supabase projects for the authenticated account",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "supabase",
+        "baseArgs": ["projects", "list", "--output", "json"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the Supabase CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "supabase",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Supabase CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "supabase",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the Supabase CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/superpowers/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "superpowers",
+  "version": "0.1.0",
+  "description": "Agentic skills framework for software development methodology from obra/superpowers",
+  "source": "https://github.com/obra/superpowers",
+  "tags": ["skills", "agents", "development", "methodology", "catalog"],
+  "checks": [
+    { "type": "binary", "name": "curl" }
+  ],
+  "post_install": {
+    "script": "scripts/post-install.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "post_uninstall": {
+    "script": "scripts/post-uninstall.js",
+    "runtime": "node",
+    "timeout_ms": 15000
+  },
+  "commands": []
+}
+

package/plugins/superpowers/scripts/post-install.js

@@ -0,0 +1,124 @@
+const { spawnSync } = require("child_process")
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+const OWNER = "obra"
+const REPO = "superpowers"
+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 SKILLS_PREFIX = "skills/"
+
+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 superpowers metadata: ${res.error.message}`, ["Check internet connectivity", "Retry: supercli plugins install superpowers"])
+  }
+  if (res.status !== 0) {
+    throw integrationError(`Failed to fetch superpowers metadata: ${(res.stderr || "").trim() || `exit ${res.status}`}`, ["Check internet connectivity", "Retry: supercli plugins install superpowers"])
+  }
+  try {
+    return JSON.parse((res.stdout || "").trim() || "{}")
+  } catch (err) {
+    throw integrationError(`Invalid superpowers metadata response: ${err.message}`)
+  }
+}
+
+function toSkillId(filePath) {
+  // Convert skills/brainstorming/SKILL.md -> brainstorming
+  return filePath
+    .replace(/^skills\//, "")
+    .replace(/\/SKILL\.md$/, "")
+}
+
+function toSkillName(filePath) {
+  // Convert directory name to readable name
+  // e.g., "test-driven-development" -> "Test Driven Development"
+  const base = toSkillId(filePath)
+  return base
+    .split("-")
+    .map(part => (part ? part[0].toUpperCase() + part.slice(1) : part))
+    .join(" ")
+}
+
+function isSkillFile(filePath) {
+  if (!filePath.endsWith(".md")) return false
+  if (!filePath.startsWith(SKILLS_PREFIX)) return false
+  if (filePath.endsWith("README.md")) return false
+  // Only match skills/*/SKILL.md pattern
+  const parts = filePath.split("/")
+  return parts.length === 3 && parts[2] === "SKILL.md"
+}
+
+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 (!isSkillFile(node.path)) continue
+    
+    const id = toSkillId(node.path)
+    entries.push({
+      id: id,
+      name: toSkillName(node.path),
+      path: node.path,
+      source_url: `${RAW_BASE_URL}/${node.path}`,
+      description: `Superpowers skill: ${toSkillName(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("superpowers plugin found no remote skill files to index")
+  }
+
+  addProvider({
+    name: "superpowers",
+    type: "remote_static",
+    enabled: true,
+    source_repo: SOURCE_REPO,
+    ref: REF,
+    entries
+  })
+
+  const index = syncCatalog()
+  return {
+    provider: "superpowers",
+    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/superpowers/scripts/post-uninstall.js

@@ -0,0 +1,30 @@
+const { removeProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+function run() {
+  const removed = removeProvider("superpowers")
+  
+  if (removed) {
+    // Re-sync catalog to remove superpowers skills
+    syncCatalog()
+  }
+  
+  return {
+    provider: "superpowers",
+    removed: removed
+  }
+}
+
+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
+}
+

package/plugins/terraform/README.md

@@ -0,0 +1,46 @@
+# Terraform Plugin Harness
+
+This plugin integrates the Terraform CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install Terraform with your preferred package manager, then verify it is available:
+
+```bash
+terraform version -json
+```
+
+If you plan to run state or output commands, ensure you are in a Terraform working directory with initialized state:
+
+```bash
+terraform init
+```
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns Terraform CLI version information via `terraform version -json`.
+
+```bash
+dcli terraform cli version --json
+```
+
+### Full Passthrough
+
+You can run any Terraform CLI command through the `terraform` namespace.
+
+```bash
+# Show outputs in JSON
+dcli terraform output -json
+
+# Show plan help
+dcli terraform plan --help
+
+# Show CLI help
+dcli terraform --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/terraform/plugin.json

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

package/plugins/uv/README.md

@@ -0,0 +1,46 @@
+# uv Plugin Harness
+
+This plugin integrates the uv CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Ensure uv is available on your machine:
+
+```bash
+uv --version
+```
+
+If you plan to use private package indexes, authenticate first:
+
+```bash
+uv auth login <service>
+```
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the uv CLI version via `uv --version`.
+
+```bash
+dcli uv cli version --json
+```
+
+### Full Passthrough
+
+You can run any uv command through the `uv` namespace.
+
+```bash
+# Show available Python interpreters
+dcli uv python list
+
+# Run a pip-compatible command
+dcli uv pip list --format json
+
+# Show CLI help
+dcli uv --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/uv/plugin.json

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

package/plugins/vercel/README.md

@@ -0,0 +1,47 @@
+# Vercel Plugin Harness
+
+This plugin integrates the [Vercel CLI](https://vercel.com/docs/cli) into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install Vercel CLI first:
+
+```bash
+npm install -g vercel
+vercel --version
+```
+
+Authenticate before running account or project operations:
+
+```bash
+vercel login
+```
+
+## Available Commands
+
+### Account Whoami (Wrapped)
+
+Returns the currently logged in Vercel account username.
+
+```bash
+dcli vercel account whoami --json
+```
+
+### Full Passthrough
+
+You can run any Vercel CLI command through the `vercel` namespace.
+
+```bash
+# List recent deployments
+dcli vercel list
+
+# List projects
+dcli vercel project ls
+
+# Check CLI version
+dcli vercel --version
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/vercel/plugin.json

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

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": []
+}