superacli 1.0.1 → 1.1.2

package/docs/supported-harnesses.md

@@ -0,0 +1,277 @@
+# Supported Harnesses
+
+A comprehensive guide to all currently supported harnesses in dcli, including bundled harnesses, built-in adapters, and popular community harnesses available via the plugin system.
+
+## Bundled Harnesses
+
+These harnesses are included with dcli and require only the underlying CLI tool to be installed.
+
+### beads (Task/Issue Management)
+
+**CLI**: `br` (beads_rust)  
+**Repository**: [github.com/Dicklesworthstone/beads_rust](https://github.com/Dicklesworthstone/beads_rust)  
+**Status**: Fully integrated  
+
+A DAG-based issue tracking system designed for automation and task dependencies.
+
+**Key Commands**:
+```bash
+supercli beads issue create --title "Fix bug"
+supercli beads issue list --status open
+supercli beads issue update <id> --status in_progress
+supercli beads dep add <child> <parent>      # Add dependency
+supercli beads sync run                       # Sync to JSONL
+```
+
+**Installation**:
+```bash
+curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/beads_rust/main/install.sh | bash
+br --version
+```
+
+**Features**:
+- Priority levels (P0-P4)
+- Dependency tracking with cycle detection
+- JSONL export/import
+- JSON output for automation
+- Status tracking (open, in_progress, closed)
+
+---
+
+### gwc (Google Workspace CLI)
+
+**CLI**: `gws` (Google Workspace CLI)  
+**Repository**: [github.com/googleworkspace/cli](https://github.com/googleworkspace/cli)  
+**Status**: Fully integrated with passthrough  
+
+Full passthrough to Google Workspace CLI with access to Google Drive, Sheets, Docs, Gmail, and more.
+
+**Key Commands**:
+```bash
+supercli gwc drive files list
+supercli gwc drive files get <id>
+supercli gwc sheets values get <sheet-id> <range>
+supercli gwc gmail messages list --query "from:user@example.com"
+```
+
+**Installation**:
+```bash
+npm install -g @googleworkspace/cli
+gws --version
+```
+
+**Features**:
+- Full Google Drive access
+- Google Sheets manipulation
+- Gmail integration
+- Google Docs access
+- Full passthrough support (all gws commands available)
+
+---
+
+### commiat (Commit Automation)
+
+**CLI**: `commiat`  
+**Repository**: [npmjs.com/package/commiat](https://www.npmjs.com/package/commiat)  
+**Status**: Fully integrated with passthrough  
+
+CLI tool for intelligent commit message generation and validation.
+
+**Key Commands**:
+```bash
+supercli commiat validate --commit-msg "fix: resolve bug"
+supercli commiat generate --changes <file>
+supercli commiat suggest
+```
+
+**Installation**:
+```bash
+npm install -g commiat
+commiat --version
+```
+
+**Features**:
+- Intelligent commit message generation
+- Commit validation against standards
+- Integration with git hooks
+- Full passthrough support
+
+---
+
+## Built-in Adapters
+
+These don't require external CLI tools but provide core execution capabilities.
+
+### OpenAPI
+
+**Status**: Built-in, no CLI required  
+
+Execute commands defined by OpenAPI 3.0 specifications.
+
+**Usage**:
+```bash
+supercli openapi <operation-id> [--args]
+```
+
+**Features**:
+- Automatic schema validation
+- Request/response transformation
+- Security scheme support
+- Parameter validation
+
+---
+
+### HTTP
+
+**Status**: Built-in, no CLI required  
+
+Raw HTTP adapter for direct REST API calls.
+
+**Usage**:
+```bash
+supercli http <method> <url> [--headers] [--data]
+```
+
+**Features**:
+- GET, POST, PUT, PATCH, DELETE support
+- Custom headers
+- Request body handling
+- Response parsing
+
+---
+
+### MCP (Model Context Protocol)
+
+**Status**: Built-in, supports both stdio and SSE/HTTP  
+
+Integration with MCP servers for tool execution.
+
+**Key Commands**:
+```bash
+supercli mcp list                                      # List connected servers
+supercli mcp add <name> --url <server-url>           # Add server
+supercli mcp remove <name>                            # Remove server
+supercli <namespace> <tool> <action>                  # Execute tool
+```
+
+**Features**:
+- Stdio process management
+- SSE/HTTP server support
+- Local tool registration
+- Remote server integration
+
+---
+
+## Popular Community Harnesses (In Development)
+
+These harnesses are in active development and will be available as plugins. Status shows expected availability.
+
+### GitHub Ecosystem
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **gh** | gh (GitHub CLI) | Planned | Repository management, issues, PRs, actions |
+| **ghe** | GitHub Enterprise CLI | Planned | Enterprise GitHub deployment |
+
+---
+
+### Cloud Platforms
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **aws** | aws (AWS CLI v2) | Planned | EC2, S3, Lambda, RDS, and 200+ services |
+| **gcloud** | gcloud (Google Cloud CLI) | Planned | GCP services, Compute Engine, Storage, etc. |
+| **az** | az (Azure CLI) | Planned | Azure services, VMs, databases, etc. |
+| **do** | doctl (DigitalOcean) | Planned | Droplets, databases, app platform |
+
+---
+
+### Container & Orchestration
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **docker** | docker | Planned | Container management, images, volumes |
+| **docker-compose** | docker-compose | Planned | Multi-container orchestration |
+| **kubectl** | kubectl | Planned | Kubernetes cluster management |
+| **helm** | helm | Planned | Kubernetes package management |
+| **k3s** | k3s | Planned | Lightweight Kubernetes |
+
+---
+
+### Infrastructure & DevOps
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **terraform** | terraform | Planned | Infrastructure as Code provisioning |
+| **ansible** | ansible | Planned | Configuration management |
+| **pulumi** | pulumi | Planned | Infrastructure as Code (Python/Go/TS) |
+| **nomad** | nomad | Planned | Workload orchestration |
+
+---
+
+### Version Control & Release
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **git** | git | Planned | Git repository operations |
+| **git-cliff** | git-cliff | Planned | Changelog generation |
+| **commitizen** | cz | Planned | Conventional commits |
+| **conventional-changelog** | conventional-changelog | Planned | Changelog automation |
+
+---
+
+### Package Managers
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **npm** | npm | Planned | Node.js package management |
+| **pnpm** | pnpm | Planned | Fast Node.js package manager |
+| **yarn** | yarn | Planned | JavaScript dependency management |
+| **pip** | pip | Planned | Python package management |
+| **pipenv** | pipenv | Planned | Python environment management |
+| **poetry** | poetry | Planned | Python dependency management |
+| **cargo** | cargo | Planned | Rust package management |
+
+---
+
+### AI/ML Tools
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **huggingface** | huggingface-cli | Planned | Hugging Face model management |
+| **langchain** | langchain CLI | Planned | LangChain utilities |
+| **ollama** | ollama | Planned | Local LLM management |
+| **modal** | modal | Planned | ML cloud computing |
+
+---
+
+### Monitoring & Observability
+
+| Harness | CLI | Status | Purpose |
+|---------|-----|--------|---------|
+| **datadog** | datadog-cli | Planned | Datadog monitoring |
+| **prometheus** | prometheus | Planned | Metrics and alerting |
+| **grafana** | grafana CLI | Planned | Visualization and dashboards |
+| **newrelic** | newrelic-cli | Planned | Application monitoring |
+
+---
+
+## Contributing a Plugin Harness
+
+Want to create a plugin for your favorite CLI? Follow these steps:
+
+1. **Review the Plugin Guide**: See [plugin-harness-guide.md](plugin-harness-guide.md)
+2. **Create a Manifest**: Define your `plugin.json`
+3. **Test Locally**: Use `supercli plugins install ./your-plugin`
+4. **Publish**: Submit to the plugin registry via `supercli plugins publish`
+
+For detailed instructions, see [plugin-harness-guide.md](plugin-harness-guide.md).
+
+## Request a Harness
+
+Missing a CLI you'd like to use with dcli? [Open an issue](https://github.com/anomalyco/dcli/issues) with:
+- CLI name and link
+- Use cases in your workflow
+- Relevant commands/operations
+
+Community members can create plugins for requested CLIs!

package/docs/visual-overview.md

@@ -0,0 +1,21 @@
+# dcli visual overview
+
+The architecture blueprint for dcli lives in the self-contained HTML artifact generated via the `visual-explainer` plugin.
+
+- **File**: `~/.agent/diagrams/dcli-visual-architecture.html`
+- **Open**: `xdg-open ~/.agent/diagrams/dcli-visual-architecture.html`
+- **Source**: Created with `supercli skills get visual-explainer:visual-explainer.skill` guidance.
+
+## What the HTML covers
+
+1. **Skill routing pipeline** – Mermaid snapshot of `cli/supercli.js`, the skills catalog, plugin harness manager, server APIs, and adapters. Includes zoom, pan, and expand controls per the visual-explainer requirements.
+2. **Runtime pillars** – Card grid summarizing the CLI runtime, catalog, plugin manager, and Express backend with file references such as `cli/plugins-manager.js` and `server/app.js`.
+3. **Plugin & skill lifecycle** – Timeline of registry discovery → install → catalog sync → execution, tying back to commands like `supercli skills list --catalog`.
+4. **Capability matrix** – HTML table comparing bundled harnesses, built-in adapters, remote providers, and the server API, highlighting when to use commands such as `supercli sync`.
+5. **Operational cues** – Details blocks that document behaviors like plan building and storage fallbacks.
+
+## Regenerating or extending
+
+1. Ensure the `visual-explainer` provider is installed (`supercli plugins install visual-explainer`).
+2. Re-open the reference templates (`visual-explainer:visual-explainer.templates.architecture`, `...templates.data-table`, etc.) to stay within the mandated aesthetics.
+3. Update the HTML under `~/.agent/diagrams/` and refresh this markdown with any new sections you add. Keep this file as the only place in the repo that references the artifact’s path.

package/jest.config.js

@@ -0,0 +1,25 @@
+module.exports = {
+  rootDir: ".",
+  testEnvironment: "node",
+  testTimeout: 15000,
+  collectCoverage: true,
+  coverageProvider: "v8",
+  collectCoverageFrom: [
+    "cli/**/*.js",
+    "server/**/*.js",
+    "!cli/supercli.js",
+    "!cli/plugin-agency-agents.js",
+    "!server/public/**"
+  ],
+  testPathIgnorePatterns: ["/node_modules/", "/ref-btcbot/"],
+  coverageDirectory: "coverage",
+  coverageReporters: ["text", "lcov", "clover"],
+  coverageThreshold: {
+    global: {
+      branches: 10,
+      functions: 10,
+      lines: 10,
+      statements: 10
+    }
+  }
+}

package/package.json

@@ -1,22 +1,28 @@
 {
   "name": "superacli",
-  "version": "1.0.1",
+  "version": "1.1.2",
   "description": "Config-driven, AI-friendly dynamic CLI",
   "main": "server/app.js",
   "bin": {
     "dcli": "./cli/supercli.js",
     "scli": "./cli/supercli.js",
     "superacli": "./cli/supercli.js",
-    "supercli": "./cli/supercli.js"
+    "supercli": "./cli/supercli.js",
+    "sc":"./cli/supercli.js"
   },
   "scripts": {
     "start": "node server/app.js",
-    "dev": "node server/app.js"
+    "dev": "node server/app.js",
+    "test:unit": "jest --coverage --runInBand",
+    "test:unit:watch": "jest --watch"
   },
   "dependencies": {
     "dotenv": "^17.3.1",
     "ejs": "^3.1.9",
     "express": "^4.18.2",
     "mongodb": "^6.3.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
   }
 }

package/plugins/agency-agents/plugin.json

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

package/plugins/agency-agents/scripts/post-install.js

@@ -0,0 +1,122 @@
+const { spawnSync } = require("child_process")
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+const OWNER = "msitarzewski"
+const REPO = "agency-agents"
+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 CATEGORY_PREFIXES = [
+  "design/",
+  "engineering/",
+  "marketing/",
+  "product/",
+  "project-management/",
+  "testing/",
+  "support/",
+  "spatial-computing/",
+  "specialized/"
+]
+
+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 agency-agents metadata: ${res.error.message}`, ["Check internet connectivity", "Retry: supercli plugins install agency-agents"])
+  }
+  if (res.status !== 0) {
+    throw integrationError(`Failed to fetch agency-agents metadata: ${(res.stderr || "").trim() || `exit ${res.status}`}`, ["Check internet connectivity", "Retry: supercli plugins install agency-agents"])
+  }
+  try {
+    return JSON.parse((res.stdout || "").trim() || "{}")
+  } catch (err) {
+    throw integrationError(`Invalid agency-agents metadata response: ${err.message}`)
+  }
+}
+
+function toSkillId(filePath) {
+  return filePath.replace(/\.md$/, "").replace(/\//g, ".")
+}
+
+function toSkillName(filePath) {
+  const base = filePath.split("/").pop() || filePath
+  return base
+    .replace(/\.md$/, "")
+    .split("-")
+    .map(part => (part ? part[0].toUpperCase() + part.slice(1) : part))
+    .join(" ")
+}
+
+function isAgentFile(filePath) {
+  if (!filePath.endsWith(".md")) return false
+  if (filePath.endsWith("README.md")) return false
+  return CATEGORY_PREFIXES.some(prefix => filePath.startsWith(prefix))
+}
+
+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 (!isAgentFile(node.path)) continue
+    entries.push({
+      id: toSkillId(node.path),
+      name: toSkillName(node.path),
+      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("agency-agents plugin found no remote skill files to index")
+  }
+
+  addProvider({
+    name: "agency-agents",
+    type: "remote_static",
+    enabled: true,
+    source_repo: SOURCE_REPO,
+    ref: REF,
+    entries
+  })
+
+  const index = syncCatalog()
+  return {
+    provider: "agency-agents",
+    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/aws/README.md

@@ -0,0 +1,46 @@
+# AWS CLI Plugin Harness
+
+This plugin integrates the AWS CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install AWS CLI with your preferred package manager, then verify it is available:
+
+```bash
+aws --version
+```
+
+Configure credentials before running account or service commands:
+
+```bash
+aws configure
+```
+
+## Available Commands
+
+### Account Identity (Wrapped)
+
+Returns the active caller identity via `aws sts get-caller-identity`.
+
+```bash
+dcli aws account identity --json
+```
+
+### Full Passthrough
+
+You can run any AWS CLI command through the `aws` namespace.
+
+```bash
+# List S3 buckets
+dcli aws s3api list-buckets
+
+# List EC2 regions
+dcli aws ec2 describe-regions
+
+# Show CLI help
+dcli aws --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/aws/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "aws",
+  "version": "0.1.0",
+  "description": "AWS CLI plugin for dcli",
+  "source": "https://docs.aws.amazon.com/cli/latest/reference/",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "aws"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "aws",
+      "resource": "account",
+      "action": "identity",
+      "description": "Show AWS caller identity for the active credentials",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "aws",
+        "baseArgs": ["sts", "get-caller-identity"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please install AWS CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "aws",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any AWS CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "aws",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install AWS CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/az/README.md

@@ -0,0 +1,46 @@
+# Azure CLI Plugin Harness
+
+This plugin integrates the Azure CLI (`az`) into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Install Azure CLI with your preferred package manager, then verify it is available:
+
+```bash
+az version
+```
+
+Authenticate before running account or resource commands:
+
+```bash
+az login
+```
+
+## Available Commands
+
+### Account Show (Wrapped)
+
+Returns the active Azure subscription via `az account show`.
+
+```bash
+dcli az account show --json
+```
+
+### Full Passthrough
+
+You can run any Azure CLI command through the `az` namespace.
+
+```bash
+# List subscriptions
+dcli az account list
+
+# List resource groups
+dcli az group list
+
+# Show CLI help
+dcli az --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/az/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "az",
+  "version": "0.1.0",
+  "description": "Azure CLI plugin for dcli",
+  "source": "https://learn.microsoft.com/cli/azure/",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "az"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "az",
+      "resource": "account",
+      "action": "show",
+      "description": "Show the active Azure subscription",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "az",
+        "baseArgs": ["account", "show"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please install Azure CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "az",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Azure CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "az",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install Azure CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}