superacli 1.1.6 → 1.1.7

package/plugins/aider/README.md

@@ -0,0 +1,53 @@
+# Aider Plugin
+
+Agent-friendly SuperCLI integration for `aider`, focused on one-shot non-interactive coding tasks.
+
+## Why This Plugin
+
+Aider is interactive by default, but it exposes strong scripting flags:
+
+- `--message` / `--message-file`
+- `--yes-always`
+- `--no-auto-commits`
+- `--dry-run`
+- `--no-pretty`
+- `--no-stream`
+
+This plugin wraps those options into predictable JSON output for agents.
+
+## Setup
+
+```bash
+dcli aider cli setup
+```
+
+You will also need a supported model/provider configuration, for example `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or another aider-supported provider.
+
+## Commands
+
+- `aider cli setup`: install `aider-chat`
+- `aider cli help-json`: inspect the wrapper contract
+- `aider models list --query sonnet`: list matching model names
+- `aider code apply`: run a one-shot editing task in a target repo
+- `aider code dry-run`: run the same flow without modifying files
+
+## Important Constraints
+
+- pass `--cwd` to target the repo or project directory
+- use `files` and `read` to constrain the task scope when possible
+- the wrapper disables auto-commits and pretty streaming output
+- stdout is JSON; raw aider stdout/stderr are returned inside the JSON payload
+
+## Stability Checklist
+
+- keep non-interactive flags enabled for wrapped commands
+- preserve `--no-auto-commits` and let SuperCLI or the user decide how to commit
+- capture changed files by comparing git status before and after the run
+- treat provider/API-key errors as structured failures, not free-form output
+
+## Skills
+
+- `plugins/aider/skills/quickstart/SKILL.md`
+- `plugins/aider/skills/one-shot-edits.md`
+- `plugins/aider/skills/dry-run-review.md`
+- `plugins/aider/skills/model-and-provider.md`

package/plugins/aider/plugin.json

@@ -0,0 +1,105 @@
+{
+  "name": "aider",
+  "version": "0.1.0",
+  "description": "Aider CLI plugin with one-shot non-interactive coding wrappers",
+  "source": "https://aider.chat/docs/scripting.html",
+  "checks": [
+    { "type": "binary", "name": "python3" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "aider",
+      "resource": "cli",
+      "action": "setup",
+      "description": "Install aider-chat for one-shot use",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/setup-aider.js"],
+        "parseJson": false,
+        "timeout_ms": 120000
+      },
+      "args": []
+    },
+    {
+      "namespace": "aider",
+      "resource": "cli",
+      "action": "help-json",
+      "description": "Show machine-readable help for the aider wrapper",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/aider-wrapper.js", "help-json"],
+        "parseJson": true,
+        "timeout_ms": 15000
+      },
+      "args": []
+    },
+    {
+      "namespace": "aider",
+      "resource": "models",
+      "action": "list",
+      "description": "List aider models matching a partial query",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/aider-wrapper.js", "models"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Please run 'dcli aider cli setup' to install aider-chat."
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true, "description": "Partial model name to search" }
+      ]
+    },
+    {
+      "namespace": "aider",
+      "resource": "code",
+      "action": "apply",
+      "description": "Run a one-shot aider coding task that may modify files",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/aider-wrapper.js", "apply"],
+        "parseJson": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Please run 'dcli aider cli setup' to install aider-chat."
+      },
+      "args": [
+        { "name": "cwd", "type": "string", "required": true, "description": "Absolute path to the target project directory" },
+        { "name": "prompt", "type": "string", "required": true, "description": "One-shot natural language instruction" },
+        { "name": "model", "type": "string", "required": false, "description": "Optional aider model name" },
+        { "name": "files", "type": "string", "required": false, "description": "Comma-separated editable files" },
+        { "name": "read", "type": "string", "required": false, "description": "Comma-separated read-only files" },
+        { "name": "timeout-seconds", "type": "number", "required": false, "description": "Aider API timeout in seconds" },
+        { "name": "verbose", "type": "boolean", "required": false, "description": "Enable verbose aider output" }
+      ]
+    },
+    {
+      "namespace": "aider",
+      "resource": "code",
+      "action": "dry-run",
+      "description": "Run a one-shot aider coding task without modifying files",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/aider-wrapper.js", "dry-run"],
+        "parseJson": true,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Please run 'dcli aider cli setup' to install aider-chat."
+      },
+      "args": [
+        { "name": "cwd", "type": "string", "required": true, "description": "Absolute path to the target project directory" },
+        { "name": "prompt", "type": "string", "required": true, "description": "One-shot natural language instruction" },
+        { "name": "model", "type": "string", "required": false, "description": "Optional aider model name" },
+        { "name": "files", "type": "string", "required": false, "description": "Comma-separated editable files" },
+        { "name": "read", "type": "string", "required": false, "description": "Comma-separated read-only files" },
+        { "name": "timeout-seconds", "type": "number", "required": false, "description": "Aider API timeout in seconds" },
+        { "name": "verbose", "type": "boolean", "required": false, "description": "Enable verbose aider output" }
+      ]
+    }
+  ]
+}

package/plugins/aider/scripts/aider-wrapper.js

@@ -0,0 +1,243 @@
+const fs = require("fs")
+const path = require("path")
+const { spawnSync } = require("child_process")
+
+const VERSION = "1.0"
+const EXIT_CODES = {
+  success: 0,
+  invalidInput: 80,
+  invalidState: 90,
+  integrationFailure: 100,
+  internalFailure: 110
+}
+
+const HELP = {
+  version: VERSION,
+  name: "aider-wrapper",
+  commands: {
+    models: {
+      required: ["--query"],
+      description: "List aider models matching a partial name."
+    },
+    apply: {
+      required: ["--cwd", "--prompt"],
+      description: "Run a one-shot aider edit task with writes enabled."
+    },
+    "dry-run": {
+      required: ["--cwd", "--prompt"],
+      description: "Run a one-shot aider edit task without modifying files."
+    }
+  },
+  notes: [
+    "The wrapper always disables auto-commits.",
+    "The wrapper returns JSON with stdout, stderr, exit_code, and changed_files."
+  ]
+}
+
+function parseArgs(argv) {
+  const args = { _: [] }
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i]
+    if (!token.startsWith("--")) {
+      args._.push(token)
+      continue
+    }
+    const trimmed = token.slice(2)
+    const eq = trimmed.indexOf("=")
+    if (eq >= 0) {
+      args[trimmed.slice(0, eq)] = trimmed.slice(eq + 1)
+      continue
+    }
+    const next = argv[i + 1]
+    if (!next || next.startsWith("--")) {
+      args[trimmed] = true
+      continue
+    }
+    args[trimmed] = next
+    i += 1
+  }
+  return args
+}
+
+function printJson(payload) {
+  process.stdout.write(`${JSON.stringify(payload)}\n`)
+}
+
+function fail(code, type, message, details = {}, suggestions = []) {
+  printJson({
+    version: VERSION,
+    status: "error",
+    error: { code, type, message, details, recoverable: false, retry_after: null, suggestions }
+  })
+  process.exit(code)
+}
+
+function splitCsv(value) {
+  if (!value) {
+    return []
+  }
+  return String(value).split(",").map((item) => item.trim()).filter(Boolean)
+}
+
+function ensureAbsoluteDir(dir) {
+  if (typeof dir !== "string" || dir.trim() === "") {
+    fail(EXIT_CODES.invalidInput, "missing_cwd", "Provide --cwd with an absolute target directory.", {}, ["Example: --cwd /absolute/path/to/repo"])
+  }
+  if (!path.isAbsolute(dir)) {
+    fail(EXIT_CODES.invalidInput, "cwd_not_absolute", `Target directory must be absolute: ${dir}`)
+  }
+  if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
+    fail(EXIT_CODES.invalidInput, "cwd_not_found", `Target directory not found: ${dir}`)
+  }
+}
+
+function readGitState(cwd) {
+  const result = spawnSync("git", ["status", "--porcelain"], {
+    cwd,
+    encoding: "utf-8"
+  })
+  if (result.error || result.status !== 0) {
+    return null
+  }
+
+  const entries = new Set()
+  for (const line of result.stdout.split(/\r?\n/)) {
+    if (!line.trim()) {
+      continue
+    }
+    entries.add(line.slice(3).trim())
+  }
+  return entries
+}
+
+function diffGitState(before, after) {
+  if (!after) {
+    return []
+  }
+  if (!before) {
+    return Array.from(after).sort()
+  }
+  return Array.from(after).filter((item) => !before.has(item)).sort()
+}
+
+function runModels(args) {
+  if (!args.query) {
+    fail(EXIT_CODES.invalidInput, "missing_query", "Provide --query for aider model lookup.")
+  }
+  const result = spawnSync("aider", ["--list-models", String(args.query)], {
+    encoding: "utf-8",
+    env: { ...process.env, NO_COLOR: "1", AIDER_GITIGNORE: "false", AIDER_ANALYTICS_DISABLE: "true" }
+  })
+  if (result.error) {
+    fail(EXIT_CODES.integrationFailure, "aider_not_available", result.error.message, {}, ["Run 'dcli aider cli setup' to install aider-chat."])
+  }
+  printJson({
+    version: VERSION,
+    status: result.status === 0 ? "success" : "error",
+    data: {
+      query: String(args.query),
+      stdout: result.stdout,
+      stderr: result.stderr,
+      exit_code: result.status
+    }
+  })
+  process.exit(result.status || 0)
+}
+
+function buildAiderArgs(mode, args) {
+  const aiderArgs = [
+    "--yes-always",
+    "--no-auto-commits",
+    "--no-gitignore",
+    "--no-pretty",
+    "--no-stream",
+    "--no-suggest-shell-commands",
+    "--no-check-update",
+    "--analytics-disable",
+    "--message",
+    String(args.prompt)
+  ]
+
+  if (args.model) {
+    aiderArgs.push("--model", String(args.model))
+  }
+  if (args["timeout-seconds"]) {
+    aiderArgs.push("--timeout", String(args["timeout-seconds"]))
+  }
+  if (args.verbose) {
+    aiderArgs.push("--verbose")
+  }
+  if (mode === "dry-run") {
+    aiderArgs.push("--dry-run")
+  }
+
+  for (const file of splitCsv(args.files)) {
+    aiderArgs.push("--file", file)
+  }
+  for (const file of splitCsv(args.read)) {
+    aiderArgs.push("--read", file)
+  }
+
+  return aiderArgs
+}
+
+function runTask(mode, args) {
+  ensureAbsoluteDir(args.cwd)
+  if (!args.prompt) {
+    fail(EXIT_CODES.invalidInput, "missing_prompt", "Provide --prompt for the aider task.")
+  }
+
+  const before = readGitState(args.cwd)
+  const result = spawnSync("aider", buildAiderArgs(mode, args), {
+    cwd: args.cwd,
+    encoding: "utf-8",
+    env: { ...process.env, NO_COLOR: "1", AIDER_GITIGNORE: "false", AIDER_ANALYTICS_DISABLE: "true" }
+  })
+
+  if (result.error) {
+    fail(EXIT_CODES.integrationFailure, "aider_execution_failed", result.error.message, {}, ["Run 'dcli aider cli setup' to install aider-chat."])
+  }
+
+  const after = readGitState(args.cwd)
+  const payload = {
+    version: VERSION,
+    status: result.status === 0 ? "success" : "error",
+    data: {
+      mode,
+      cwd: args.cwd,
+      prompt: String(args.prompt),
+      model: args.model || null,
+      dry_run: mode === "dry-run",
+      changed_files: diffGitState(before, after),
+      stdout: result.stdout,
+      stderr: result.stderr,
+      exit_code: result.status
+    }
+  }
+  printJson(payload)
+  process.exit(result.status || 0)
+}
+
+function main() {
+  const [command, ...rest] = process.argv.slice(2)
+  if (command === "help-json") {
+    printJson(HELP)
+    return
+  }
+
+  const args = parseArgs(rest)
+  if (command === "models") {
+    runModels(args)
+    return
+  }
+  if (command === "apply" || command === "dry-run") {
+    runTask(command, args)
+    return
+  }
+
+  fail(EXIT_CODES.invalidInput, "unknown_command", `Unknown command: ${command || "<missing>"}`)
+}
+
+if (require.main === module) {
+  main()
+}

package/plugins/aider/scripts/setup-aider.js

@@ -0,0 +1,37 @@
+const { spawnSync } = require("child_process")
+
+function run(command, args) {
+  return spawnSync(command, args, { stdio: "inherit", encoding: "utf-8" })
+}
+
+function fail(message, code = 1) {
+  console.error(message)
+  process.exit(code)
+}
+
+function main() {
+  console.log("Installing aider-chat...")
+
+  let result = run("python3", ["-m", "pip", "install", "--user", "aider-chat"])
+  if (result.error) {
+    fail(`Failed to start python3: ${result.error.message}`)
+  }
+
+  if (result.status !== 0) {
+    console.log("pip install failed, trying pipx...")
+    result = run("pipx", ["install", "aider-chat"])
+    if (result.error) {
+      fail(`Failed to install aider-chat via pip or pipx: ${result.error.message}`)
+    }
+    if (result.status !== 0) {
+      fail(`Failed to install aider-chat. Exit code: ${result.status}`, result.status || 1)
+    }
+  }
+
+  console.log("aider-chat installed.")
+  console.log("Next step: ensure your provider API key is configured before using the plugin.")
+}
+
+if (require.main === module) {
+  main()
+}

package/plugins/aider/skills/dry-run-review.md

@@ -0,0 +1,24 @@
+# Aider Dry-Run Review Skill
+
+Use `dcli aider code dry-run` to preview proposed edits before allowing file modifications.
+
+## Command Pattern
+
+```bash
+dcli aider code dry-run \
+  --cwd /absolute/path/to/repo \
+  --prompt "<requested change>" \
+  --files path/to/file
+```
+
+## Review Workflow
+
+1. Confirm `exit_code == 0`.
+2. Read `stdout` for the proposed SEARCH/REPLACE content.
+3. Verify `changed_files` stays empty in dry-run mode.
+4. If acceptable, rerun with `code apply`.
+
+## Agent Notes
+
+- Dry-run output is advisory; no edits are applied.
+- Use dry-run for policy-sensitive or broad refactors.

package/plugins/aider/skills/model-and-provider.md

@@ -0,0 +1,24 @@
+# Aider Model And Provider Skill
+
+Use this skill when an agent needs to confirm model/provider readiness before coding actions.
+
+## Model Discovery
+
+```bash
+dcli aider models list --query sonnet
+```
+
+Use a targeted query (`sonnet`, `gpt-4o`, `deepseek`) to reduce output volume.
+
+## Provider Preconditions
+
+Aider requires provider credentials in environment variables, for example:
+
+- `OPENAI_API_KEY`
+- `ANTHROPIC_API_KEY`
+- other provider keys supported by aider
+
+## Failure Handling
+
+- If the wrapper reports provider or auth failures, stop and request credential fixes.
+- Do not loop retries for static credential errors.

package/plugins/aider/skills/one-shot-edits.md

@@ -0,0 +1,30 @@
+# Aider One-Shot Edits Skill
+
+Use this skill for controlled one-shot edits with `dcli aider code apply`.
+
+## Preferred Command Shape
+
+```bash
+dcli aider code apply \
+  --cwd /absolute/path/to/repo \
+  --prompt "<clear change request>" \
+  --files path/to/file1,path/to/file2
+```
+
+## Guidance
+
+- Keep prompts precise and outcome-focused.
+- Limit `--files` scope to reduce unintended edits.
+- Add `--read` files for context that must not be modified.
+- Run `dry-run` first when change risk is medium/high.
+
+## Output Contract
+
+The wrapper returns JSON with:
+
+- `stdout`
+- `stderr`
+- `exit_code`
+- `changed_files`
+
+Use these fields for post-run control flow.

package/plugins/aider/skills/quickstart/SKILL.md

@@ -0,0 +1,51 @@
+# Aider Skill
+
+Use the Aider plugin when you want a one-shot coding sub-agent through the `aider` CLI without entering interactive chat mode.
+
+## Skill Map
+
+Use these plugin-local skills for focused workflows:
+
+- `plugins/aider/skills/one-shot-edits.md`
+- `plugins/aider/skills/dry-run-review.md`
+- `plugins/aider/skills/model-and-provider.md`
+
+## Quick Start
+
+### 1. Setup
+```bash
+dcli aider cli setup
+```
+
+### 2. Check Wrapper Contract
+```bash
+dcli aider cli help-json
+```
+
+### 3. Discover Models
+```bash
+dcli aider models list --query sonnet
+```
+
+### 4. Run A One-Shot Edit Task
+```bash
+dcli aider code apply \
+  --cwd /absolute/path/to/repo \
+  --prompt "Add clear docstrings to the public functions in src/utils.py" \
+  --files src/utils.py
+```
+
+### 5. Preview Without Writing
+```bash
+dcli aider code dry-run \
+  --cwd /absolute/path/to/repo \
+  --prompt "Refactor src/index.ts to reduce duplication" \
+  --files src/index.ts
+```
+
+## Agent Notes
+
+- The wrapper always uses one-shot `--message` mode.
+- Auto-commits are disabled.
+- Output is wrapped into JSON with `stdout`, `stderr`, `exit_code`, and `changed_files`.
+- Pass `--cwd` explicitly because plugin execution does not assume the user project directory.

package/plugins/azd/README.md

@@ -0,0 +1,28 @@
+# azd Plugin
+
+`azd` wraps Azure Developer CLI for deterministic automation workflows in supercli.
+
+## Install
+
+```bash
+supercli plugins install ./plugins/azd --json
+```
+
+Install the upstream CLI:
+
+```bash
+brew tap azure/azd && brew install azd
+# or follow: https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/install-azd
+```
+
+## Commands
+
+- `supercli azd cli version`
+- `supercli azd auth status`
+- `supercli azd deploy all --environment <name>`
+- `supercli azd <any upstream args...>`
+
+## Notes
+
+- Wrapper commands favor non-interactive behavior via `--no-prompt`.
+- Use passthrough for advanced operations not covered by wrappers.

package/plugins/azd/plugin.json

@@ -0,0 +1,87 @@
+{
+  "name": "azd",
+  "version": "0.1.0",
+  "description": "Azure Developer CLI plugin with non-interactive wrappers and passthrough",
+  "source": "https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/",
+  "tags": ["azure", "azd", "cloud", "devops", "automation"],
+  "checks": [
+    {
+      "type": "binary",
+      "name": "azd"
+    }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "azd",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show Azure Developer CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "azd",
+        "baseArgs": ["version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install Azure Developer CLI (azd) to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "azd",
+      "resource": "auth",
+      "action": "status",
+      "description": "Check Azure authentication status without interactive login",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "azd",
+        "baseArgs": ["auth", "login", "--check-status", "--no-prompt"],
+        "parseJson": false,
+        "timeout_ms": 20000,
+        "missingDependencyHelp": "Please install Azure Developer CLI (azd) to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "azd",
+      "resource": "deploy",
+      "action": "all",
+      "description": "Deploy all services in non-interactive mode",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "azd",
+        "baseArgs": ["deploy", "--all", "--no-prompt"],
+        "optionalArgs": {
+          "environment": "--environment"
+        },
+        "parseJson": false,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Please install Azure Developer CLI (azd) to use this command."
+      },
+      "args": [
+        {
+          "name": "environment",
+          "type": "string",
+          "required": false,
+          "description": "Optional azd environment name"
+        }
+      ]
+    },
+    {
+      "namespace": "azd",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Azure Developer CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "azd",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Please install Azure Developer CLI (azd) to use this command."
+      },
+      "args": []
+    }
+  ]
+}