superacli 1.0.1 → 1.1.2

package/plugins/beads/plugin.json

@@ -0,0 +1,202 @@
+{
+  "name": "beads",
+  "version": "0.1.0",
+  "description": "Wrap beads_rust (br) issue tracking commands",
+  "source": "https://github.com/Dicklesworthstone/beads_rust",
+  "checks": [
+    { "type": "binary", "name": "br" }
+  ],
+  "commands": [
+    {
+      "namespace": "beads",
+      "resource": "install",
+      "action": "steps",
+      "description": "Show beads_rust installation steps for LLM automation",
+      "adapter": "builtin",
+      "adapterConfig": { "builtin": "beads_install_steps" },
+      "args": []
+    },
+    {
+      "namespace": "beads",
+      "resource": "workspace",
+      "action": "init",
+      "description": "Initialize beads workspace in current repository",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["init"], "parseJson": false, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": []
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "create",
+      "description": "Create a beads issue",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "br",
+        "baseArgs": ["create"],
+        "positionalArgs": ["title"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Run: dcli beads install steps"
+      },
+      "args": [
+        { "name": "title", "type": "string", "required": true },
+        { "name": "type", "type": "string", "required": false },
+        { "name": "priority", "type": "integer", "required": false },
+        { "name": "description", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "list",
+      "description": "List beads issues",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["list"], "jsonFlag": "--json", "parseJson": true, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": [
+        { "name": "status", "type": "string", "required": false },
+        { "name": "priority", "type": "string", "required": false },
+        { "name": "assignee", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "ready",
+      "description": "List actionable beads issues",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["ready"], "jsonFlag": "--json", "parseJson": true, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": []
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "show",
+      "description": "Show beads issue details",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "br",
+        "baseArgs": ["show"],
+        "positionalArgs": ["id"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Run: dcli beads install steps"
+      },
+      "args": [
+        { "name": "id", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "update",
+      "description": "Update a beads issue",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "br",
+        "baseArgs": ["update"],
+        "positionalArgs": ["id"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Run: dcli beads install steps"
+      },
+      "args": [
+        { "name": "id", "type": "string", "required": true },
+        { "name": "status", "type": "string", "required": false },
+        { "name": "priority", "type": "integer", "required": false },
+        { "name": "assignee", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "close",
+      "description": "Close a beads issue",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "br",
+        "baseArgs": ["close"],
+        "positionalArgs": ["id"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Run: dcli beads install steps"
+      },
+      "args": [
+        { "name": "id", "type": "string", "required": true },
+        { "name": "reason", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "issue",
+      "action": "reopen",
+      "description": "Reopen a beads issue",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "br",
+        "baseArgs": ["reopen"],
+        "positionalArgs": ["id"],
+        "jsonFlag": "--json",
+        "parseJson": true,
+        "missingDependencyHelp": "Run: dcli beads install steps"
+      },
+      "args": [
+        { "name": "id", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "dep",
+      "action": "add",
+      "description": "Add dependency child->parent",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["dep", "add"], "positionalArgs": ["child", "parent"], "parseJson": false, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": [
+        { "name": "child", "type": "string", "required": true },
+        { "name": "parent", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "dep",
+      "action": "remove",
+      "description": "Remove dependency child->parent",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["dep", "remove"], "positionalArgs": ["child", "parent"], "parseJson": false, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": [
+        { "name": "child", "type": "string", "required": true },
+        { "name": "parent", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "dep",
+      "action": "cycles",
+      "description": "Find dependency cycles",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["dep", "cycles"], "jsonFlag": "--json", "parseJson": true, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": []
+    },
+    {
+      "namespace": "beads",
+      "resource": "sync",
+      "action": "run",
+      "description": "Run beads sync",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["sync"], "parseJson": false, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": [
+        { "name": "flush-only", "type": "boolean", "required": false },
+        { "name": "import-only", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "beads",
+      "resource": "stats",
+      "action": "show",
+      "description": "Show beads project stats",
+      "adapter": "process",
+      "adapterConfig": { "command": "br", "baseArgs": ["stats"], "jsonFlag": "--json", "parseJson": true, "missingDependencyHelp": "Run: dcli beads install steps" },
+      "args": []
+    }
+  ]
+}

package/plugins/clickup/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "clickup",
+  "version": "0.1.0",
+  "description": "ClickUp CLI (cu) for AI agents - task management, sprint tracking, and project workflows",
+  "source": "https://github.com/krodak/clickup-cli",
+  "tags": ["clickup", "tasks", "project-management", "sprint", "ai-agents"],
+  "checks": [
+    { "type": "binary", "name": "cu" }
+  ],
+  "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": [
+    {
+      "namespace": "clickup",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any cu CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cu",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clickup-cli: npm install -g @krodak/clickup-cli, then run: cu init"
+      },
+      "args": []
+    }
+  ]
+}
+

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

@@ -0,0 +1,107 @@
+const { spawnSync } = require("child_process")
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+const OWNER = "krodak"
+const REPO = "clickup-cli"
+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_PATH = "skills/clickup-cli/SKILL.md"
+
+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 clickup-cli skill: ${res.error.message}`, ["Check internet connectivity", "Retry: supercli plugins install clickup"])
+  }
+  if (res.status !== 0) {
+    throw integrationError(`Failed to fetch clickup-cli skill: ${(res.stderr || "").trim() || `exit ${res.status}`}`, ["Check internet connectivity", "Retry: supercli plugins install clickup"])
+  }
+  try {
+    return JSON.parse((res.stdout || "").trim() || "{}")
+  } catch (err) {
+    throw integrationError(`Invalid clickup-cli skill response: ${err.message}`)
+  }
+}
+
+function run() {
+  // Fetch the skill file directly
+  const skillUrl = `${RAW_BASE_URL}/${SKILLS_PATH}`
+  const res = spawnSync("curl", ["-fsSL", skillUrl], { encoding: "utf-8", timeout: 15000 })
+  
+  if (res.error || res.status !== 0) {
+    throw integrationError(`Failed to fetch clickup-cli SKILL.md: ${res.error?.message || `exit ${res.status}`}`, ["Check internet connectivity", "Retry: supercli plugins install clickup"])
+  }
+
+  const markdown = (res.stdout || "").trim()
+  
+  // Parse frontmatter for name and description
+  let name = "ClickUp CLI"
+  let description = "Use when managing ClickUp tasks, sprints, or comments via the cu CLI tool"
+  
+  if (markdown.startsWith("---\n")) {
+    const end = markdown.indexOf("\n---\n", 4)
+    if (end > 0) {
+      const frontmatter = markdown.slice(4, end)
+      for (const line of frontmatter.split("\n")) {
+        const idx = line.indexOf(":")
+        if (idx > 0) {
+          const key = line.slice(0, idx).trim()
+          const value = line.slice(idx + 1).trim().replace(/^"|"$/g, "")
+          if (key === "name") name = value
+          if (key === "description") description = value
+        }
+      }
+    }
+  }
+
+  // Add as a remote static provider with a single skill entry
+  addProvider({
+    name: "clickup",
+    type: "remote_static",
+    enabled: true,
+    source_repo: SOURCE_REPO,
+    ref: REF,
+    entries: [
+      {
+        id: "clickup",
+        name: name,
+        description: description,
+        path: SKILLS_PATH,
+        source_url: skillUrl
+      }
+    ]
+  })
+
+  const index = syncCatalog()
+  return {
+    provider: "clickup",
+    entries: 1,
+    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
+}
+

package/plugins/clickup/scripts/post-uninstall.js

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

@@ -0,0 +1,48 @@
+# Cline Plugin
+
+This plugin integrates the Cline CLI into dcli with rich non-interactive task wrappers and full namespace passthrough.
+
+## Prerequisites
+
+Ensure `cline` is available on your machine:
+
+```bash
+cline --version
+```
+
+## Wrapped Commands
+
+### CLI Version
+
+```bash
+supercli cline cli version --json
+```
+
+### Non-Interactive Task Run
+
+Runs Cline in act mode with `-a -y --json` and streams one JSON event envelope per line before the final summary envelope.
+
+```bash
+supercli cline task run --prompt "List files with most LOC in cwd" --cwd . --timeout 30 --json
+```
+
+### Non-Interactive Task Plan
+
+Runs Cline in plan mode with `-p -y --json` and the same streaming behavior.
+
+```bash
+supercli cline task plan --prompt "Plan a refactor of the auth module" --cwd . --json
+```
+
+## Full Passthrough
+
+```bash
+supercli cline --help
+supercli cline -a -y --json "List files with more LOC in cwd"
+```
+
+## Notes
+
+- Prefer the wrapped `cline task run` and `cline task plan` commands for agent automation.
+- Those wrappers bake in the documented headless-safe defaults: `--json` plus `-y`, with `-a` or `-p` selected for you.
+- Passthrough remains available when you need flags or flows not yet wrapped.

package/plugins/cline/plugin.json

@@ -0,0 +1,92 @@
+{
+  "name": "cline",
+  "version": "0.1.0",
+  "description": "Cline CLI plugin with non-interactive task wrappers and passthrough",
+  "source": "https://github.com/cline/cline",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "cline"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "cline",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show Cline CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cline",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install the Cline CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "cline",
+      "resource": "task",
+      "action": "run",
+      "description": "Run a non-interactive Cline task in act mode with streamed JSON events",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cline",
+        "baseArgs": ["-a", "-y", "--json"],
+        "positionalArgs": ["prompt"],
+        "flagsBeforePositionals": true,
+        "stream": "jsonl",
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install the Cline CLI to use this command."
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true },
+        { "name": "cwd", "type": "string", "required": false },
+        { "name": "model", "type": "string", "required": false },
+        { "name": "timeout", "type": "integer", "required": false },
+        { "name": "continue", "type": "boolean", "required": false },
+        { "name": "images", "type": "string[]", "required": false }
+      ]
+    },
+    {
+      "namespace": "cline",
+      "resource": "task",
+      "action": "plan",
+      "description": "Run a non-interactive Cline task in plan mode with streamed JSON events",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cline",
+        "baseArgs": ["-p", "-y", "--json"],
+        "positionalArgs": ["prompt"],
+        "flagsBeforePositionals": true,
+        "stream": "jsonl",
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install the Cline CLI to use this command."
+      },
+      "args": [
+        { "name": "prompt", "type": "string", "required": true },
+        { "name": "cwd", "type": "string", "required": false },
+        { "name": "model", "type": "string", "required": false },
+        { "name": "timeout", "type": "integer", "required": false },
+        { "name": "continue", "type": "boolean", "required": false },
+        { "name": "images", "type": "string[]", "required": false }
+      ]
+    },
+    {
+      "namespace": "cline",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Cline CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cline",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the Cline CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/commiat/plugin.json

@@ -0,0 +1,36 @@
+{
+  "name": "commiat",
+  "version": "0.1.0",
+  "description": "Wrap commiat CLI with passthrough support",
+  "source": "https://www.npmjs.com/package/commiat",
+  "checks": [
+    { "type": "binary", "name": "commiat" }
+  ],
+  "commands": [
+    {
+      "namespace": "commiat",
+      "resource": "install",
+      "action": "steps",
+      "description": "Show commiat installation steps for LLM automation",
+      "adapter": "builtin",
+      "adapterConfig": { "builtin": "commiat_install_steps" },
+      "args": []
+    },
+    {
+      "namespace": "commiat",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to commiat CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "commiat",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "nonTtyBaseArgs": ["--non-interactive"],
+        "missingDependencyHelp": "Run: dcli commiat install steps"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/docker/MANIFEST.md

@@ -0,0 +1,39 @@
+# Docker Manifest Reference
+
+Namespace: `docker`
+
+This plugin ships 20 commands.
+
+## `container`
+
+- `run` -> `docker run` (guarded interactive flags)
+- `ps` -> `docker ps`
+- `ls` -> `docker ps`
+- `start` -> `docker start`
+- `stop` -> `docker stop`
+- `restart` -> `docker restart`
+- `rm` -> `docker rm`
+- `exec` -> `docker exec` (guarded interactive flags)
+- `logs` -> `docker logs`
+- `inspect` -> `docker inspect`
+
+## `image`
+
+- `build` -> `docker build`
+- `images` -> `docker images`
+- `ls` -> `docker images`
+- `pull` -> `docker pull`
+- `push` -> `docker push`
+- `rmi` -> `docker rmi`
+- `tag` -> `docker tag`
+
+## `system`
+
+- `info` -> `docker info`
+- `version` -> `docker version`
+- `df` -> `docker system df`
+
+## Safety warnings
+
+- Non-TTY contexts cannot execute guarded interactive flags (`-i`, `-t`, `--interactive`, `--tty`) for `container run` and `container exec`.
+- Safety violations are rejected with code `91`.

package/plugins/docker/README.md

@@ -0,0 +1,35 @@
+# Docker Plugin
+
+The Docker plugin adds a focused Docker harness to dcli with a guarded non-TTY safety policy for interactive operations.
+
+## Install
+
+```bash
+dcli plugins install docker --json
+```
+
+## Explore
+
+```bash
+dcli plugins explore --name docker --json
+dcli plugins show docker --json
+dcli plugins doctor docker --json
+```
+
+## Common commands
+
+```bash
+dcli docker container ls --json
+dcli docker container run --image nginx --detach --publish 8080:80 --name demo --json
+dcli docker container logs --container demo --tail 100 --json
+dcli docker image build --context . --tag myapp:latest --json
+dcli docker system version --json
+```
+
+## Safety
+
+- Interactive flags are blocked in non-TTY contexts for guarded commands (`run`, `exec`).
+- Guarded flags: `-i`, `-t`, `--interactive`, `--tty`.
+- Rejected requests return `code: 91` and `type: safety_violation`.
+
+Reserved interactive-only operations (`attach`, `login`) are intentionally excluded from this MVP manifest and should run directly in a local interactive terminal.

package/plugins/docker/examples/build-image.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CONTEXT_DIR="${1:-.}"
+TAG="${2:-local/demo:latest}"
+
+dcli docker image build --context "$CONTEXT_DIR" --tag "$TAG" --json

package/plugins/docker/examples/inspect-container.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CONTAINER="${1:-demo-nginx}"
+
+dcli docker container inspect --container "$CONTAINER" --json

package/plugins/docker/examples/list-containers.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+dcli docker container ls --all --format "{{.ID}}\t{{.Image}}\t{{.Status}}" --json

package/plugins/docker/examples/multi-step-workflow.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+IMAGE="${1:-alpine:latest}"
+NAME="${2:-demo-alpine}"
+
+dcli docker image pull --image "$IMAGE" --json
+dcli docker container run --image "$IMAGE" --detach --name "$NAME" --json
+dcli docker container logs --container "$NAME" --tail 20 --json
+dcli docker container rm --container "$NAME" --force --json

package/plugins/docker/examples/run-container.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+IMAGE="${1:-nginx:latest}"
+NAME="${2:-demo-nginx}"
+
+dcli docker container run --image "$IMAGE" --detach --publish 8080:80 --name "$NAME" --rm --json