superacli 1.1.6 → 1.1.7

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

@@ -0,0 +1,41 @@
+---
+skill_name: azd.quickstart
+description: Agent workflow for Azure Developer CLI with non-interactive wrappers and passthrough.
+tags: azd,azure,cloud,automation,devops
+---
+
+# azd Quickstart
+
+Use this skill when you need deterministic Azure deployment workflows from supercli.
+
+## 1) Learn and install
+
+```bash
+supercli plugins learn azd
+supercli plugins install ./plugins/azd --json
+```
+
+## 2) Validate setup
+
+```bash
+supercli azd cli version
+supercli azd auth status
+```
+
+## 3) Run non-interactive deployment
+
+```bash
+supercli azd deploy all --environment dev
+```
+
+## 4) Use full upstream command surface
+
+```bash
+supercli azd env list
+supercli azd up --no-prompt
+```
+
+## 5) Caveats
+
+- Prefer `--no-prompt` for unattended runs.
+- Use passthrough for commands not wrapped in this plugin.

package/plugins/blogwatcher/README.md

@@ -1,6 +1,6 @@
 # BlogWatcher Plugin
 
-This plugin is a hybrid harness: it indexes BlogWatcher's upstream `SKILL.md` and `README.md` into the local skills catalog and exposes the local `blogwatcher` binary through wrapped commands plus full passthrough.
+This plugin is a hybrid harness: it indexes BlogWatcher's upstream `SKILL.md` and `README.md` into the local skill-doc catalog and exposes the local `blogwatcher` binary through wrapped commands plus full passthrough.
 
 ## What It Adds
 
@@ -14,7 +14,7 @@ This plugin is a hybrid harness: it indexes BlogWatcher's upstream `SKILL.md` an
 supercli plugins install blogwatcher --json
 ```
 
-## Explore Indexed Skills
+## Explore Indexed Skill Documents
 
 ```bash
 supercli skills list --catalog --provider blogwatcher --json
@@ -49,4 +49,4 @@ supercli blogwatcher scan "Example Blog"
 - Wrapped commands return raw text in the dcli envelope because upstream does not expose JSON output.
 - The wrapped `blogs remove` and `articles read-all` commands force `--yes` to avoid interactive prompts.
 - BlogWatcher stores its SQLite data under `~/.blogwatcher`, so use an isolated `HOME` if you want disposable smoke testing.
-- Removing the plugin also removes its registered skills provider from the local catalog.
+- Removing the plugin also removes its registered skill-doc provider from the local catalog.

package/plugins/boxlite/Dockerfile

@@ -0,0 +1,9 @@
+FROM node:24-bookworm-slim
+
+ARG BOXLITE_NPM_VERSION=latest
+
+RUN npm install -g "@javimosch/boxlite@${BOXLITE_NPM_VERSION}" && npm cache clean --force
+
+ENV PATH="/usr/local/bin:${PATH}"
+
+CMD ["boxcli", "--output", "json", "capabilities"]

package/plugins/boxlite/README.md

@@ -0,0 +1,62 @@
+# BoxLite Plugin
+
+This plugin exposes `boxcli` (from `@javimosch/boxlite`) through a Docker runner in supercli.
+
+Status: **experimental**.
+
+## Install
+
+```bash
+supercli plugins install ./plugins/boxlite
+```
+
+## Requirements
+
+- `docker`
+- `node`
+
+On first command run, the plugin builds `dcli-boxlite:1.1.0` and reuses it afterward.
+
+## What currently works
+
+- Plugin install and discovery in supercli (`plugins install`, `plugins show`, `plugins doctor`)
+- Docker image build and reuse via `scripts/run-boxlite.js`
+- Command routing and passthrough wiring (`supercli boxlite ...` and `supercli boxlite exec run ...` command shape)
+
+## Current blockers
+
+- End-to-end VM execution is currently blocked in Docker-backed mode.
+- Native Node binding loading fails while starting `@javimosch/boxlite` in this path.
+- Most recent concrete failure: native `.node` load chain ends with symbol error (`krun_free_ctx`) and falls back to generic "Cannot find native binding".
+
+## What does not work yet
+
+- Reliable `box create` + `exec run` workflows for actual guest execution
+- Verified Python/JS execution inside BoxLite isolation from supercli plugin path
+- Human-ready stable behavior for runtime/image/box/exec command set in Docker-backed mode
+
+## Next focus
+
+- Fix native binding/runtime linking in Docker-backed plugin execution path.
+- Re-run manual e2e validation (`box create`, shell exec, Python exec, JS exec, isolation checks).
+- Keep publish strategy blocked until e2e execution is verified from supercli.
+
+## Commands
+
+```bash
+supercli boxlite capabilities show --json
+supercli boxlite runtime info --json
+supercli boxlite image list --json
+supercli boxlite image pull alpine:latest --json
+supercli boxlite image exists alpine:latest --json
+supercli boxlite box list --json
+supercli boxlite box get my-box --json
+supercli boxlite box create --image alpine:latest --name my-box --json
+supercli boxlite box remove my-box --if-exists --json
+```
+
+For advanced flows (for example `exec run` with `--` separator), use passthrough:
+
+```bash
+supercli boxlite exec run my-box -- sh -lc "echo ok"
+```

package/plugins/boxlite/plugin.json

@@ -0,0 +1,201 @@
+{
+  "name": "boxlite",
+  "version": "0.2.0",
+  "description": "BoxLite Docker-backed plugin using boxcli",
+  "source": "https://github.com/javimosch/boxlite",
+  "tags": ["experimental"],
+  "checks": [
+    { "type": "binary", "name": "node" },
+    { "type": "binary", "name": "docker" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "boxlite",
+      "resource": "capabilities",
+      "action": "show",
+      "description": "Show boxcli capabilities",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "capabilities"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": []
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "runtime",
+      "action": "info",
+      "description": "Show runtime info",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "runtime", "info"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "home", "type": "string", "required": false },
+        { "name": "registry", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "image",
+      "action": "list",
+      "description": "List cached images",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "image", "list"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": []
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "image",
+      "action": "pull",
+      "description": "Pull image into local cache",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "image", "pull"],
+        "positionalArgs": ["image"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "image", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "image",
+      "action": "exists",
+      "description": "Check if image exists in local cache",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "image", "exists"],
+        "positionalArgs": ["image"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "image", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "box",
+      "action": "list",
+      "description": "List boxes",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "box", "list"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": []
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "box",
+      "action": "get",
+      "description": "Get one box by id or name",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "box", "get"],
+        "positionalArgs": ["target"],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "target", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "box",
+      "action": "create",
+      "description": "Create a new box with image preflight",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "box", "create"],
+        "optionalArgs": {
+          "image": "--image",
+          "name": "--name",
+          "cpus": "--cpus",
+          "memory-mib": "--memory-mib",
+          "allow-image-pull": "--allow-image-pull"
+        },
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "image", "type": "string", "required": true },
+        { "name": "name", "type": "string", "required": false },
+        { "name": "cpus", "type": "integer", "required": false },
+        { "name": "memory-mib", "type": "integer", "required": false },
+        { "name": "allow-image-pull", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "box",
+      "action": "remove",
+      "description": "Remove a box",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js", "--output", "json", "box", "remove"],
+        "positionalArgs": ["target"],
+        "optionalArgs": {
+          "force": "--force",
+          "if-exists": "--if-exists"
+        },
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": [
+        { "name": "target", "type": "string", "required": true },
+        { "name": "force", "type": "boolean", "required": false },
+        { "name": "if-exists", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "boxlite",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to boxcli for advanced commands",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-boxlite.js"],
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install Docker and run: docker --version"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/boxlite/scripts/run-boxlite.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process")
+const path = require("path")
+const os = require("os")
+const fs = require("fs")
+
+const IMAGE_NAME = "dcli-boxlite"
+const IMAGE_TAG = "1.1.0"
+const FULL_IMAGE = `${IMAGE_NAME}:${IMAGE_TAG}`
+
+function runDocker(args, options = {}) {
+  return spawnSync("docker", args, {
+    encoding: "utf-8",
+    timeout: options.timeout ?? 300000,
+    cwd: options.cwd,
+    env: process.env,
+  })
+}
+
+function exitWithResult(result, fallbackMessage) {
+  if (result.stdout) process.stdout.write(result.stdout)
+  if (result.stderr) process.stderr.write(result.stderr)
+
+  if (result.error) {
+    process.stderr.write(`${fallbackMessage}: ${result.error.message}\n`)
+    process.exit(1)
+  }
+
+  process.exit(typeof result.status === "number" ? result.status : 1)
+}
+
+function ensureImage(pluginDir) {
+  const inspect = runDocker(["image", "inspect", FULL_IMAGE], { timeout: 15000 })
+  if (!inspect.error && inspect.status === 0) return
+
+  const build = runDocker(
+    [
+      "build",
+      "--tag",
+      FULL_IMAGE,
+      "--file",
+      path.join(pluginDir, "Dockerfile"),
+      pluginDir,
+    ],
+    { cwd: pluginDir, timeout: 600000 },
+  )
+
+  if (build.error || build.status !== 0) {
+    exitWithResult(build, `Failed to build Docker image ${FULL_IMAGE}`)
+  }
+}
+
+function run() {
+  const pluginDir = process.env.SUPERCLI_PLUGIN_DIR || process.cwd()
+  const passthroughArgs = process.argv.slice(2)
+  const home = os.homedir()
+  const hostRuntimeDir = process.env.BOXLITE_RUNTIME_HOME || path.join(home, ".boxlite")
+  const hostWorkspace = process.cwd()
+  const hostSdkDir = process.env.BOXLITE_SDK_DIR
+
+  ensureImage(pluginDir)
+
+  const dockerArgs = [
+    "run",
+    "--rm",
+    "--privileged",
+    "--volume",
+    `${hostRuntimeDir}:/root/.boxlite`,
+    "--volume",
+    `${hostWorkspace}:${hostWorkspace}`,
+    "--workdir",
+    hostWorkspace,
+  ]
+
+  if (process.env.BOXLITE_PLUGIN_NO_NETWORK !== "1") {
+    dockerArgs.push("--network", "host")
+  }
+
+  const kvmPath = "/dev/kvm"
+  const kvmCheck = spawnSync("test", ["-e", kvmPath])
+  if (kvmCheck.status === 0) {
+    dockerArgs.push("--device", `${kvmPath}:${kvmPath}`)
+  }
+
+  if (process.env.RUST_LOG) {
+    dockerArgs.push("--env", `RUST_LOG=${process.env.RUST_LOG}`)
+  }
+
+  let containerCommand = ["boxcli", ...passthroughArgs]
+
+  if (hostSdkDir) {
+    const cliEntry = path.join(hostSdkDir, "dist/cli/index.js")
+    if (fs.existsSync(cliEntry)) {
+      dockerArgs.push("--volume", `${hostSdkDir}:/opt/boxlite-sdk:ro`)
+      containerCommand = ["node", "/opt/boxlite-sdk/dist/cli/index.js", ...passthroughArgs]
+    }
+  }
+
+  dockerArgs.push(FULL_IMAGE, ...containerCommand)
+
+  const result = runDocker(dockerArgs, { timeout: 600000 })
+  exitWithResult(result, "Failed to run boxlite Docker container")
+}
+
+run()

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

@@ -0,0 +1,40 @@
+---
+skill_name: boxlite.quickstart
+description: Experimental BoxLite plugin status, known working flows, and current blockers.
+tags: boxlite,sandbox,vm,docker,experimental
+---
+
+# BoxLite Quickstart (Experimental)
+
+Use this skill to understand the current state of the BoxLite supercli plugin before running workflows.
+
+## 1) Install and inspect plugin
+
+```bash
+supercli plugins learn boxlite
+supercli plugins install ./plugins/boxlite
+supercli plugins show boxlite
+supercli plugins doctor boxlite
+```
+
+## 2) What currently works
+
+- Plugin registration, install, and doctor checks.
+- Docker runner bootstrap (`dcli-boxlite:1.1.0`) and command dispatch.
+- Routed command shape for wrapper and passthrough commands.
+
+## 3) What is currently blocked
+
+- Docker-backed runtime path does not yet complete end-to-end VM execution.
+- Native Node binding loading fails for `@javimosch/boxlite` in this flow.
+- Latest observed failure chain includes a native symbol error (`krun_free_ctx`) and surfaces as "Cannot find native binding".
+
+## 4) What does not work yet
+
+- Reliable `box create` + `exec run` for real guest command execution.
+- Verified Python and JavaScript execution inside BoxLite isolation from supercli plugin commands.
+
+## 5) Current recommendation
+
+- Treat the plugin as experimental until native binding/runtime linking is fixed in Docker mode.
+- Do not rely on this plugin yet for production VM execution workflows.

package/plugins/cass/plugin.json

@@ -0,0 +1,150 @@
+{
+  "name": "cass",
+  "version": "0.1.0",
+  "description": "Coding Agent Session Search (cass) - Unified indexing and search for local coding agent history",
+  "source": "https://github.com/Dicklesworthstone/coding_agent_session_search",
+  "checks": [
+    { "type": "binary", "name": "node" },
+    { "type": "binary", "name": "npm" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "cass",
+      "resource": "cli",
+      "action": "setup",
+      "description": "Install coding-agent-search (cass) dependency",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/setup-cass.js"],
+        "parseJson": false,
+        "timeout_ms": 180000
+      },
+      "args": []
+    },
+    {
+      "namespace": "cass",
+      "resource": "index",
+      "action": "health",
+      "description": "Check if the search index is healthy",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["health", "--json"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": []
+    },
+    {
+      "namespace": "cass",
+      "resource": "index",
+      "action": "run",
+      "description": "Rebuild or update the search index",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["index", "--json"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": [
+        { "name": "full", "type": "boolean", "required": false, "description": "Perform a full rebuild" },
+        { "name": "force-rebuild", "type": "boolean", "required": false, "description": "Force rebuild even if index exists" }
+      ]
+    },
+    {
+      "namespace": "cass",
+      "resource": "search",
+      "action": "run",
+      "description": "Search across all agent history",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["search", "--robot"],
+        "positionalArgs": ["query"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true, "description": "Search query" },
+        { "name": "limit", "type": "number", "required": false, "description": "Cap result count" },
+        { "name": "agent", "type": "string", "required": false, "description": "Filter by agent type" },
+        { "name": "days", "type": "number", "required": false, "description": "Limit to recent N days" },
+        { "name": "mode", "type": "string", "required": false, "description": "Search mode: lexical, semantic, hybrid" },
+        { "name": "fields", "type": "string", "required": false, "description": "Fields to return: minimal, summary, or custom list" }
+      ]
+    },
+    {
+      "namespace": "cass",
+      "resource": "session",
+      "action": "view",
+      "description": "View a specific session by path",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["view", "--json"],
+        "positionalArgs": ["path"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": true, "description": "Path to session file" },
+        { "name": "line-number", "alias": "n", "type": "number", "required": false, "description": "Line number to focus on" }
+      ]
+    },
+    {
+      "namespace": "cass",
+      "resource": "session",
+      "action": "expand",
+      "description": "Expand context around a search hit",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["expand", "--json"],
+        "positionalArgs": ["path"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": true, "description": "Path to session file" },
+        { "name": "line-number", "alias": "n", "type": "number", "required": true, "description": "Line number" },
+        { "name": "context", "alias": "C", "type": "number", "required": false, "description": "Number of lines of context" }
+      ]
+    },
+    {
+      "namespace": "cass",
+      "resource": "activity",
+      "action": "stats",
+      "description": "Show aggregate history statistics",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["stats", "--json"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": []
+    },
+    {
+      "namespace": "cass",
+      "resource": "activity",
+      "action": "timeline",
+      "description": "Display activity timeline",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "cass",
+        "baseArgs": ["timeline", "--json"],
+        "parseJson": true,
+        "missingDependencyHelp": "Please run 'dcli cass cli setup' to install cass."
+      },
+      "args": [
+        { "name": "days", "type": "number", "required": false, "description": "Limit to recent N days" },
+        { "name": "group-by", "type": "string", "required": false, "description": "Group results by: hour, day" }
+      ]
+    }
+  ]
+}

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

@@ -0,0 +1,47 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+
+function isCommandAvailable(command) {
+  try {
+    execSync(`${command} --version`, { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+console.log('--- Coding Agent Session Search (cass) Setup ---');
+
+if (isCommandAvailable('cass')) {
+  console.log('cass is already installed and working.');
+} else {
+  console.log('cass not found or broken (GLIBC mismatch). Attempting installation...');
+  
+  try {
+    execSync('which cargo', { stdio: 'ignore' });
+    console.log('cargo found. Installing from git to ensure compatibility...');
+    execSync('cargo install --git https://github.com/Dicklesworthstone/coding_agent_session_search coding-agent-search', { stdio: 'inherit' });
+    console.log('Success: cass installed via cargo.');
+  } catch (e) {
+    console.log('cargo not found or failed. Trying official install script...');
+    try {
+      // Official install script
+      execSync('curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.sh" | bash -s -- --easy-mode --verify', { stdio: 'inherit' });
+      console.log('Success: cass installed via script.');
+    } catch (e2) {
+      console.error('Failed to install cass.');
+      console.error('Please install Rust (https://rustup.rs) and run: cargo install --git https://github.com/Dicklesworthstone/coding_agent_session_search coding-agent-search');
+      process.exit(1);
+    }
+  }
+}
+
+// Final check
+try {
+  const version = execSync('cass --version').toString().trim();
+  console.log(`Verified: ${version} is available.`);
+} catch (e) {
+  console.error('Error: cass binary still not working. This usually means a GLIBC mismatch.');
+  console.error('Please install from source: cargo install --git https://github.com/Dicklesworthstone/coding_agent_session_search coding-agent-search');
+  process.exit(1);
+}