superacli 1.0.1 → 1.1.2

package/plugins/docker/plugin.json

@@ -0,0 +1,266 @@
+{
+  "name": "docker",
+  "version": "0.1.0",
+  "description": "Core Docker harness commands with non-TTY safety metadata",
+  "source": "https://www.docker.com/",
+  "checks": [
+    { "type": "binary", "name": "docker" }
+  ],
+  "commands": [
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "run",
+      "description": "Run a container",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "docker",
+        "baseArgs": ["run"],
+        "positionalArgs": ["image", "cmd"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "safetyLevel": "guarded",
+        "interactiveFlags": ["-i", "-t", "--interactive", "--tty"],
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "image", "type": "string", "required": true },
+        { "name": "cmd", "type": "string" },
+        { "name": "detach", "type": "boolean" },
+        { "name": "publish", "type": "string" },
+        { "name": "volume", "type": "string" },
+        { "name": "env", "type": "string" },
+        { "name": "name", "type": "string" },
+        { "name": "rm", "type": "boolean" },
+        { "name": "interactive", "type": "boolean" },
+        { "name": "tty", "type": "boolean" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "ps",
+      "description": "List running containers",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["ps"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "all", "type": "boolean" },
+        { "name": "format", "type": "string" },
+        { "name": "filter", "type": "string" },
+        { "name": "last", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "ls",
+      "description": "Alias to docker ps",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["ps"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "all", "type": "boolean" },
+        { "name": "format", "type": "string" },
+        { "name": "filter", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "start",
+      "description": "Start one or more stopped containers",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["start"], "positionalArgs": ["container"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "container", "type": "string", "required": true } ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "stop",
+      "description": "Stop one or more running containers",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["stop"], "positionalArgs": ["container"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "container", "type": "string", "required": true },
+        { "name": "time", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "restart",
+      "description": "Restart one or more containers",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["restart"], "positionalArgs": ["container"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "container", "type": "string", "required": true } ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "rm",
+      "description": "Remove one or more containers",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["rm"], "positionalArgs": ["container"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "container", "type": "string", "required": true },
+        { "name": "force", "type": "boolean" },
+        { "name": "volumes", "type": "boolean" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "exec",
+      "description": "Run a command in a running container",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "docker",
+        "baseArgs": ["exec"],
+        "positionalArgs": ["container", "cmd"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "safetyLevel": "guarded",
+        "interactiveFlags": ["-i", "-t", "--interactive", "--tty"],
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "container", "type": "string", "required": true },
+        { "name": "cmd", "type": "string", "required": true },
+        { "name": "interactive", "type": "boolean" },
+        { "name": "tty", "type": "boolean" },
+        { "name": "env", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "logs",
+      "description": "Fetch container logs",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["logs"], "positionalArgs": ["container"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "container", "type": "string", "required": true },
+        { "name": "follow", "type": "boolean" },
+        { "name": "tail", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "container",
+      "action": "inspect",
+      "description": "Display detailed container information",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["inspect"], "positionalArgs": ["container"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "container", "type": "string", "required": true } ]
+    },
+
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "build",
+      "description": "Build an image from a Dockerfile",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["build"], "positionalArgs": ["context"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "context", "type": "string", "required": true },
+        { "name": "tag", "type": "string" },
+        { "name": "file", "type": "string" },
+        { "name": "build-arg", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "images",
+      "description": "List images",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["images"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "all", "type": "boolean" },
+        { "name": "digests", "type": "boolean" },
+        { "name": "format", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "ls",
+      "description": "Alias to docker images",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["images"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "all", "type": "boolean" },
+        { "name": "format", "type": "string" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "pull",
+      "description": "Pull an image from a registry",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["pull"], "positionalArgs": ["image"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "image", "type": "string", "required": true } ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "push",
+      "description": "Push an image to a registry",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["push"], "positionalArgs": ["image"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "image", "type": "string", "required": true } ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "rmi",
+      "description": "Remove one or more images",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["rmi"], "positionalArgs": ["image"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "image", "type": "string", "required": true },
+        { "name": "force", "type": "boolean" }
+      ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "image",
+      "action": "tag",
+      "description": "Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["tag"], "positionalArgs": ["source", "target"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [
+        { "name": "source", "type": "string", "required": true },
+        { "name": "target", "type": "string", "required": true }
+      ]
+    },
+
+    {
+      "namespace": "docker",
+      "resource": "system",
+      "action": "info",
+      "description": "Display system-wide information",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["info"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "format", "type": "string" } ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "system",
+      "action": "version",
+      "description": "Show the Docker version information",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["version"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "format", "type": "string" } ]
+    },
+    {
+      "namespace": "docker",
+      "resource": "system",
+      "action": "df",
+      "description": "Show Docker disk usage",
+      "adapter": "process",
+      "adapterConfig": { "command": "docker", "baseArgs": ["system", "df"], "parseJson": true, "timeout_ms": 15000, "missingDependencyHelp": "Install Docker and run: docker --version" },
+      "args": [ { "name": "verbose", "type": "boolean" } ]
+    }
+  ]
+}

package/plugins/eza/README.md

@@ -0,0 +1,40 @@
+# eza Plugin Harness
+
+This plugin integrates the eza CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Ensure eza is available on your machine:
+
+```bash
+eza --version
+```
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the eza CLI version via `eza --version`.
+
+```bash
+dcli eza cli version --json
+```
+
+### Full Passthrough
+
+You can run any eza command through the `eza` namespace.
+
+```bash
+# List files one per line without color
+dcli eza --oneline --color=never
+
+# Long listing for a specific path
+dcli eza --long .
+
+# Show CLI help
+dcli eza --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/eza/plugin.json

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

package/plugins/gcloud/README.md

@@ -0,0 +1,46 @@
+# Google Cloud CLI Plugin Harness
+
+This plugin integrates the Google Cloud CLI (`gcloud`) into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install Google Cloud CLI with your preferred package manager, then verify it is available:
+
+```bash
+gcloud --version
+```
+
+Authenticate before running account or project commands:
+
+```bash
+gcloud auth login
+```
+
+## Available Commands
+
+### Account List (Wrapped)
+
+Returns authenticated accounts via `gcloud auth list --format=json`.
+
+```bash
+dcli gcloud account list --json
+```
+
+### Full Passthrough
+
+You can run any Google Cloud CLI command through the `gcloud` namespace.
+
+```bash
+# List projects
+dcli gcloud projects list --format=json
+
+# List compute zones
+dcli gcloud compute zones list --format=json
+
+# Show CLI help
+dcli gcloud --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/gcloud/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "gcloud",
+  "version": "0.1.0",
+  "description": "Google Cloud CLI plugin for dcli",
+  "source": "https://cloud.google.com/sdk/gcloud",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "gcloud"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "gcloud",
+      "resource": "account",
+      "action": "list",
+      "description": "List authenticated Google Cloud accounts",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gcloud",
+        "baseArgs": ["auth", "list", "--format=json"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please install Google Cloud CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "gcloud",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Google Cloud CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gcloud",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install Google Cloud CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/gh/README.md

@@ -0,0 +1,46 @@
+# GitHub CLI Plugin Harness
+
+This plugin integrates the official GitHub CLI (`gh`) into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install GitHub CLI with your preferred package manager, then verify it is available:
+
+```bash
+gh --version
+```
+
+Authenticate before running account or repository operations:
+
+```bash
+gh auth login
+```
+
+## Available Commands
+
+### Account Status (Wrapped)
+
+Returns GitHub CLI authentication status via `gh auth status --json hosts`.
+
+```bash
+dcli gh account status --json
+```
+
+### Full Passthrough
+
+You can run any GitHub CLI command through the `gh` namespace.
+
+```bash
+# List your repositories
+dcli gh repo list --limit 10 --json name,nameWithOwner,url
+
+# Show pull requests in the current repo
+dcli gh pr list --json number,title,state
+
+# Show CLI help
+dcli gh --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/gh/plugin.json

@@ -0,0 +1,43 @@
+{
+  "name": "gh",
+  "version": "0.1.0",
+  "description": "GitHub CLI plugin for dcli",
+  "source": "https://cli.github.com/manual/",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "gh"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "gh",
+      "resource": "account",
+      "action": "status",
+      "description": "Show GitHub CLI authentication status for known hosts",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gh",
+        "baseArgs": ["auth", "status"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Please install GitHub CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "gh",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any GitHub CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gh",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install GitHub CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/gwc/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "gwc",
+  "version": "0.1.0",
+  "description": "Wrap Google Workspace CLI (gws) with passthrough support",
+  "source": "https://github.com/googleworkspace/cli",
+  "checks": [
+    { "type": "binary", "name": "gws" }
+  ],
+  "commands": [
+    {
+      "namespace": "gwc",
+      "resource": "install",
+      "action": "steps",
+      "description": "Show gws installation steps for LLM automation",
+      "adapter": "builtin",
+      "adapterConfig": { "builtin": "gwc_install_steps" },
+      "args": []
+    },
+    {
+      "namespace": "gwc",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to gws CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "gws",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Run: dcli gwc install steps"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/helm/README.md

@@ -0,0 +1,42 @@
+# Helm Plugin Harness
+
+This plugin integrates the Helm CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install Helm with your preferred package manager, then verify it is available:
+
+```bash
+helm version --short
+```
+
+If you plan to run cluster-backed commands, ensure your Kubernetes context is configured first.
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns Helm CLI version information via `helm version --short`.
+
+```bash
+dcli helm cli version --json
+```
+
+### Full Passthrough
+
+You can run any Helm command through the `helm` namespace.
+
+```bash
+# List releases as JSON
+dcli helm list --output json
+
+# List configured repos as JSON
+dcli helm repo list --output json
+
+# Show CLI help
+dcli helm --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/helm/plugin.json

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