superacli 1.1.0 → 1.1.2

package/plugins/linear/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "linear",
+  "version": "0.1.0",
+  "description": "Linear CLI plugin for dcli",
+  "source": "https://linear.app",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "linear"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "linear",
+      "resource": "account",
+      "action": "whoami",
+      "description": "Show the currently logged in Linear user",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "linear",
+        "baseArgs": ["auth", "whoami"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install the Linear CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "linear",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Linear CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "linear",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the Linear CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/nextest/README.md

@@ -0,0 +1,42 @@
+# nextest Plugin Harness
+
+This plugin integrates the `cargo-nextest` CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Ensure `cargo-nextest` is available on your machine:
+
+```bash
+cargo-nextest --version
+```
+
+Many nextest commands are most useful inside a Rust workspace. Help and version commands work anywhere, and listing commands are good non-interactive entry points.
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the `cargo-nextest` CLI version via `cargo-nextest --version`.
+
+```bash
+dcli nextest cli version --json
+```
+
+### Full Passthrough
+
+You can run any `cargo-nextest` command through the `nextest` namespace.
+
+```bash
+# Show help
+dcli nextest --help
+
+# List tests in machine-readable form
+dcli nextest list --message-format json
+
+# Run tests in a workspace
+dcli nextest run
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/nextest/plugin.json

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

package/plugins/npm/README.md

@@ -0,0 +1,46 @@
+# npm Plugin Harness
+
+This plugin integrates the npm CLI into dcli with one wrapped core command and full namespace passthrough.
+
+## Prerequisites
+
+Ensure npm is available on your machine:
+
+```bash
+npm --version
+```
+
+If you plan to run authenticated registry commands, log in first:
+
+```bash
+npm login
+```
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the npm CLI version via `npm --version`.
+
+```bash
+dcli npm cli version --json
+```
+
+### Full Passthrough
+
+You can run any npm command through the `npm` namespace.
+
+```bash
+# Search packages as JSON
+dcli npm search react --json
+
+# Show current user if authenticated
+dcli npm whoami
+
+# Show CLI help
+dcli npm --help
+```
+
+## Output
+
+Wrapped commands and passthrough responses are returned in dcli envelope format when `--json` is used with dcli-level commands.

package/plugins/npm/plugin.json

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

package/plugins/nullclaw/README.md

@@ -0,0 +1,45 @@
+# nullclaw Plugin
+
+This plugin is a hybrid harness: it indexes NullClaw's upstream docs into the dcli skills catalog and exposes the local `nullclaw` binary through wrapped commands plus full passthrough.
+
+## What It Adds
+
+- top-level project context from `README.md`, `AGENTS.md`, and contributor docs
+- operator guidance for installation, configuration, commands, usage, security, and gateway API
+- implementation guidance for contributors working on the Zig codebase
+
+## Install
+
+```bash
+supercli plugins install nullclaw --json
+```
+
+## Explore Indexed Skills
+
+```bash
+supercli skills list --catalog --provider nullclaw --json
+supercli skills get nullclaw:root.agents
+supercli skills get nullclaw:docs.en.commands
+supercli skills get nullclaw:docs.en.architecture
+```
+
+## Available CLI Commands
+
+```bash
+# Wrapped version command
+supercli nullclaw cli version --json
+
+# Wrapped status command
+supercli nullclaw system status --json
+
+# Full passthrough
+supercli nullclaw models list
+supercli nullclaw agent -m "hello"
+```
+
+## Notes
+
+- This plugin indexes remote markdown from `https://github.com/nullclaw/nullclaw`.
+- It does not install the upstream `nullclaw` binary for you.
+- If you also want the runtime locally, follow the upstream install path such as `brew install nullclaw`.
+- Removing the plugin also removes its registered skills provider from the local catalog.

package/plugins/nullclaw/plugin.json

@@ -0,0 +1,64 @@
+{
+  "name": "nullclaw",
+  "version": "0.1.0",
+  "description": "Remote docs and agent guidance index for nullclaw/nullclaw",
+  "source": "https://github.com/nullclaw/nullclaw",
+  "checks": [
+    { "type": "binary", "name": "curl" },
+    { "type": "binary", "name": "nullclaw" }
+  ],
+  "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": "nullclaw",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show nullclaw CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "nullclaw",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install nullclaw to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "nullclaw",
+      "resource": "system",
+      "action": "status",
+      "description": "Show nullclaw system status",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "nullclaw",
+        "baseArgs": ["status"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install nullclaw to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "nullclaw",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any nullclaw CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "nullclaw",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install nullclaw to use this command."
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,189 @@
+const { spawnSync } = require("child_process")
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+const OWNER = "nullclaw"
+const REPO = "nullclaw"
+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 CATALOG_FILES = [
+  {
+    id: "root.readme",
+    name: "NullClaw Overview",
+    path: "README.md",
+    description: "Project overview, quick start, common commands, and platform capabilities.",
+    tags: ["overview", "runtime", "agents"]
+  },
+  {
+    id: "root.agents",
+    name: "NullClaw Agent Protocol",
+    path: "AGENTS.md",
+    description: "Repository-specific engineering protocol for coding agents implementing NullClaw features.",
+    tags: ["agents", "engineering", "implementation"]
+  },
+  {
+    id: "root.claude",
+    name: "NullClaw Claude Guidance",
+    path: "CLAUDE.md",
+    description: "Additional repository instructions for LLM-assisted development workflows.",
+    tags: ["agents", "llms", "implementation"]
+  },
+  {
+    id: "root.contributing",
+    name: "NullClaw Contributing",
+    path: "CONTRIBUTING.md",
+    description: "Contribution workflow, validation expectations, and repository conventions.",
+    tags: ["contributing", "development", "workflow"]
+  },
+  {
+    id: "docs.en.readme",
+    name: "NullClaw Docs Overview",
+    path: "docs/en/README.md",
+    description: "Guided docs entry point for users and contributors.",
+    tags: ["docs", "overview", "onboarding"]
+  },
+  {
+    id: "docs.en.installation",
+    name: "NullClaw Installation",
+    path: "docs/en/installation.md",
+    description: "Install and first-run setup guidance for the NullClaw binary.",
+    tags: ["installation", "setup", "operations"]
+  },
+  {
+    id: "docs.en.configuration",
+    name: "NullClaw Configuration",
+    path: "docs/en/configuration.md",
+    description: "Config schema guidance for models, channels, memory, gateway, autonomy, and security.",
+    tags: ["configuration", "operations", "security"]
+  },
+  {
+    id: "docs.en.commands",
+    name: "NullClaw Commands",
+    path: "docs/en/commands.md",
+    description: "Task-oriented CLI reference covering onboarding, agent, service, channel, skills, and data commands.",
+    tags: ["commands", "cli", "operations"]
+  },
+  {
+    id: "docs.en.usage",
+    name: "NullClaw Usage",
+    path: "docs/en/usage.md",
+    description: "Operational workflows for day-to-day use, health checks, troubleshooting, and service mode.",
+    tags: ["usage", "operations", "troubleshooting"]
+  },
+  {
+    id: "docs.en.architecture",
+    name: "NullClaw Architecture",
+    path: "docs/en/architecture.md",
+    description: "Subsystem design and extension points for providers, channels, tools, runtime, memory, and security.",
+    tags: ["architecture", "engineering", "implementation"]
+  },
+  {
+    id: "docs.en.security",
+    name: "NullClaw Security",
+    path: "docs/en/security.md",
+    description: "Security model for pairing, sandboxing, allowlists, secrets, and runtime boundaries.",
+    tags: ["security", "operations", "implementation"]
+  },
+  {
+    id: "docs.en.gateway-api",
+    name: "NullClaw Gateway API",
+    path: "docs/en/gateway-api.md",
+    description: "Gateway endpoints, pairing flow, auth expectations, and integration details.",
+    tags: ["api", "gateway", "integrations"]
+  },
+  {
+    id: "docs.en.development",
+    name: "NullClaw Development",
+    path: "docs/en/development.md",
+    description: "Build, test, source layout, and development workflow for contributors.",
+    tags: ["development", "engineering", "zig"]
+  }
+]
+
+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 nullclaw metadata: ${res.error.message}`, [
+      "Check internet connectivity",
+      "Retry: supercli plugins install nullclaw"
+    ])
+  }
+  if (res.status !== 0) {
+    throw integrationError(`Failed to fetch nullclaw metadata: ${(res.stderr || "").trim() || `exit ${res.status}`}`, [
+      "Check internet connectivity",
+      "Retry: supercli plugins install nullclaw"
+    ])
+  }
+  try {
+    return JSON.parse((res.stdout || "").trim() || "{}")
+  } catch (err) {
+    throw integrationError(`Invalid nullclaw metadata response: ${err.message}`)
+  }
+}
+
+function buildRemoteEntriesFromTree(treeResponse) {
+  const tree = Array.isArray(treeResponse.tree) ? treeResponse.tree : []
+  const availablePaths = new Set(
+    tree
+      .filter(node => node && node.type === "blob" && typeof node.path === "string")
+      .map(node => node.path)
+  )
+
+  return CATALOG_FILES
+    .filter(file => availablePaths.has(file.path))
+    .map(file => ({
+      ...file,
+      source_url: `${RAW_BASE_URL}/${file.path}`
+    }))
+}
+
+function run() {
+  const treeResponse = fetchJson(TREE_URL)
+  const entries = buildRemoteEntriesFromTree(treeResponse)
+  if (entries.length === 0) {
+    throw integrationError("nullclaw plugin found no remote documentation files to index")
+  }
+
+  addProvider({
+    name: "nullclaw",
+    type: "remote_static",
+    enabled: true,
+    source_repo: SOURCE_REPO,
+    ref: REF,
+    entries
+  })
+
+  const index = syncCatalog()
+  return {
+    provider: "nullclaw",
+    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 = {
+  CATALOG_FILES,
+  run,
+  buildRemoteEntriesFromTree
+}

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

@@ -0,0 +1,25 @@
+const { removeProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+function run() {
+  const removed = removeProvider("nullclaw")
+  const index = syncCatalog()
+  return {
+    provider: "nullclaw",
+    removed,
+    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/openfang/plugin.json

@@ -0,0 +1,37 @@
+{
+  "name": "openfang",
+  "version": "0.1.0",
+  "description": "OpenFang - Agent Operating System. CLI passthrough + 60+ bundled skills for AI agents",
+  "source": "https://github.com/RightNow-AI/openfang",
+  "checks": [
+    { "type": "binary", "name": "openfang" }
+  ],
+  "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": "openfang",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any openfang CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "openfang",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Run: curl -fsSL https://openfang.sh/install | sh"
+      },
+      "args": []
+    }
+  ]
+}
+