superacli 1.1.2 → 1.1.4

package/plugins/clix/plugin.json

@@ -0,0 +1,126 @@
+{
+  "name": "clix",
+  "version": "0.1.0",
+  "description": "Hybrid clix plugin with remote agent docs and safe read-only X wrappers",
+  "source": "https://github.com/spideystreet/clix",
+  "checks": [
+    { "type": "binary", "name": "curl" },
+    { "type": "binary", "name": "clix" }
+  ],
+  "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": "clix",
+      "resource": "auth",
+      "action": "status",
+      "description": "Show clix authentication status as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clix",
+        "baseArgs": ["auth", "status", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clix to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "clix",
+      "resource": "timeline",
+      "action": "list",
+      "description": "List timeline tweets as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clix",
+        "baseArgs": ["feed", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clix to use this command."
+      },
+      "args": [
+        { "name": "type", "type": "string", "required": false },
+        { "name": "count", "type": "integer", "required": false }
+      ]
+    },
+    {
+      "namespace": "clix",
+      "resource": "posts",
+      "action": "search",
+      "description": "Search posts as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clix",
+        "baseArgs": ["search", "--json"],
+        "positionalArgs": ["query"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clix to use this command."
+      },
+      "args": [
+        { "name": "query", "type": "string", "required": true },
+        { "name": "type", "type": "string", "required": false },
+        { "name": "count", "type": "integer", "required": false }
+      ]
+    },
+    {
+      "namespace": "clix",
+      "resource": "posts",
+      "action": "show",
+      "description": "Show a tweet and thread as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clix",
+        "baseArgs": ["tweet", "--json"],
+        "positionalArgs": ["id"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clix to use this command."
+      },
+      "args": [
+        { "name": "id", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "clix",
+      "resource": "users",
+      "action": "show",
+      "description": "Show a user profile and recent tweets as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clix",
+        "baseArgs": ["user", "--json"],
+        "positionalArgs": ["handle"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clix to use this command."
+      },
+      "args": [
+        { "name": "handle", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "clix",
+      "resource": "bookmarks",
+      "action": "list",
+      "description": "List bookmarks as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "clix",
+        "baseArgs": ["bookmarks", "--json"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install clix to use this command."
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,66 @@
+const { addProvider, syncCatalog } = require("../../../cli/skills-catalog")
+
+const OWNER = "spideystreet"
+const REPO = "clix"
+const REF = "main"
+const SOURCE_REPO = `https://github.com/${OWNER}/${REPO}`
+const RAW_BASE_URL = `https://raw.githubusercontent.com/${OWNER}/${REPO}/${REF}`
+
+const CATALOG_FILES = [
+  {
+    id: "root.skill",
+    name: "clix Agent Skill",
+    path: "SKILL.md",
+    description: "Agent-focused guidance for safe clix usage, JSON mode, and X workflows.",
+    tags: ["agents", "x", "twitter"]
+  },
+  {
+    id: "root.readme",
+    name: "clix Overview",
+    path: "README.md",
+    description: "Project overview, installation, auth model, and command examples for clix.",
+    tags: ["overview", "x", "cookies"]
+  }
+]
+
+function buildRemoteEntries() {
+  return CATALOG_FILES.map(file => ({
+    ...file,
+    source_url: `${RAW_BASE_URL}/${file.path}`
+  }))
+}
+
+function run() {
+  const entries = buildRemoteEntries()
+  addProvider({
+    name: "clix",
+    type: "remote_static",
+    enabled: true,
+    source_repo: SOURCE_REPO,
+    ref: REF,
+    entries
+  })
+
+  const index = syncCatalog()
+  return {
+    provider: "clix",
+    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,
+  buildRemoteEntries,
+  run
+}

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

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

@@ -0,0 +1,48 @@
+# Himalaya Plugin Harness
+
+This plugin integrates the Himalaya email CLI into dcli with safe read-only wrappers and full namespace passthrough.
+
+## Prerequisites
+
+Ensure `himalaya` is available on your machine:
+
+```bash
+himalaya --version
+```
+
+You also need a working Himalaya config, usually at `~/.config/himalaya/config.toml`, with at least one configured account.
+
+## Available Commands
+
+### Safe Read-Only Wrappers
+
+These wrappers target JSON-capable, automation-friendly commands and avoid write-side email actions.
+
+```bash
+dcli himalaya cli version --json
+dcli himalaya account list --json
+dcli himalaya account doctor --account personal --json
+dcli himalaya folder list --account personal --json
+dcli himalaya envelope list --account personal --folder INBOX --page 1 --json
+dcli himalaya envelope thread --account personal --folder INBOX --id 42 --json
+dcli himalaya message read-preview --account personal --folder INBOX --id 42 --json
+```
+
+### Full Passthrough
+
+You can run any Himalaya command through the `himalaya` namespace.
+
+```bash
+# Explicit upstream JSON mode
+dcli himalaya --output json account list
+
+# Raw CLI help
+dcli himalaya --help
+```
+
+## Notes
+
+- Wrapped list and preview commands bake in Himalaya's `--output json` support and return parsed data in the dcli envelope.
+- The wrapped `message read-preview` command forces `--preview` so it can inspect mail without marking it seen.
+- Destructive or interactive flows such as `account configure`, `message send`, `message write`, and delete/move operations are intentionally left out of wrapped v1.
+- Himalaya passthrough does not understand upstream `--json`; use `--output json` when you want Himalaya itself to emit JSON.

package/plugins/himalaya/plugin.json

@@ -0,0 +1,157 @@
+{
+  "name": "himalaya",
+  "version": "0.1.0",
+  "description": "Himalaya email CLI plugin with safe read-only wrappers and passthrough",
+  "source": "https://github.com/pimalaya/himalaya",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "himalaya"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "himalaya",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show Himalaya CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "account",
+      "action": "list",
+      "description": "List configured email accounts as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["--output", "json", "account", "list"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "account",
+      "action": "doctor",
+      "description": "Inspect a configured account without applying fixes",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["account", "doctor"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "env": { "NO_COLOR": "1" },
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": [
+        { "name": "account", "type": "string", "required": true }
+      ]
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "folder",
+      "action": "list",
+      "description": "List folders for a configured account as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["--output", "json", "folder", "list"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": [
+        { "name": "account", "type": "string", "required": true },
+        { "name": "page", "type": "integer", "required": false },
+        { "name": "page-size", "type": "integer", "required": false }
+      ]
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "envelope",
+      "action": "list",
+      "description": "List message envelopes for an account and folder as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["--output", "json", "envelope", "list"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": [
+        { "name": "account", "type": "string", "required": true },
+        { "name": "folder", "type": "string", "required": true },
+        { "name": "page", "type": "integer", "required": false },
+        { "name": "page-size", "type": "integer", "required": false },
+        { "name": "query", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "envelope",
+      "action": "thread",
+      "description": "Inspect an envelope thread as JSON",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["--output", "json", "envelope", "thread"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": [
+        { "name": "account", "type": "string", "required": true },
+        { "name": "folder", "type": "string", "required": true },
+        { "name": "id", "type": "integer", "required": true }
+      ]
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "message",
+      "action": "read-preview",
+      "description": "Read a message preview as JSON without marking it seen",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "baseArgs": ["--output", "json", "message", "read", "--preview"],
+        "positionalArgs": ["id"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": [
+        { "name": "account", "type": "string", "required": true },
+        { "name": "folder", "type": "string", "required": true },
+        { "name": "id", "type": "integer", "required": true },
+        { "name": "header", "type": "string[]", "required": false },
+        { "name": "no-headers", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "himalaya",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Himalaya CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "himalaya",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install Himalaya to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/mongosh/README.md

@@ -0,0 +1,56 @@
+# mongosh Plugin Harness
+
+This plugin integrates the MongoDB shell (`mongosh`) into dcli with wrapped version, ping, and eval commands plus full namespace passthrough.
+
+## Prerequisites
+
+Ensure `mongosh` is available on your machine:
+
+```bash
+mongosh --version
+```
+
+If you plan to connect to a protected server, provide the usual connection flags or rely on your environment and shell profile.
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the mongosh version via `mongosh --version`.
+
+```bash
+dcli mongosh cli version --json
+```
+
+### Server Ping (Wrapped)
+
+Runs `db.adminCommand({ ping: 1 })` with quiet relaxed JSON output.
+
+```bash
+dcli mongosh server ping --host 127.0.0.1 --port 27017 --json
+```
+
+### Eval Run (Wrapped)
+
+Runs a JavaScript expression through `mongosh --quiet --json=relaxed --eval`.
+
+```bash
+dcli mongosh eval run --javascript "db.runCommand({ buildInfo: 1 })" --json
+```
+
+### Full Passthrough
+
+You can run any mongosh command through the `mongosh` namespace.
+
+```bash
+# Show help
+dcli mongosh --help
+
+# Evaluate directly
+dcli mongosh --quiet --json=relaxed --eval "db.adminCommand({ ping: 1 })"
+```
+
+## Notes
+
+- This plugin targets `mongosh`, not the legacy `mongo` shell.
+- Wrapped commands parse relaxed JSON output when possible; more complex BSON values may still surface as Extended JSON structures.

package/plugins/mongosh/plugin.json

@@ -0,0 +1,88 @@
+{
+  "name": "mongosh",
+  "version": "0.1.0",
+  "description": "mongosh CLI plugin for dcli",
+  "source": "https://www.mongodb.com/docs/mongodb-shell/",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "mongosh"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "mongosh",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show mongosh CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mongosh",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install mongosh to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "mongosh",
+      "resource": "server",
+      "action": "ping",
+      "description": "Run a MongoDB admin ping through mongosh",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mongosh",
+        "baseArgs": ["--quiet", "--json=relaxed", "--eval", "db.adminCommand({ ping: 1 })"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install mongosh to use this command."
+      },
+      "args": [
+        { "name": "host", "type": "string", "required": false },
+        { "name": "port", "type": "integer", "required": false },
+        { "name": "username", "type": "string", "required": false },
+        { "name": "password", "type": "string", "required": false },
+        { "name": "authenticationDatabase", "type": "string", "required": false },
+        { "name": "tls", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "mongosh",
+      "resource": "eval",
+      "action": "run",
+      "description": "Run JavaScript in mongosh with relaxed JSON output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mongosh",
+        "baseArgs": ["--quiet", "--json=relaxed", "--eval"],
+        "positionalArgs": ["javascript"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install mongosh to use this command."
+      },
+      "args": [
+        { "name": "javascript", "type": "string", "required": true, "description": "JavaScript expression to evaluate" },
+        { "name": "host", "type": "string", "required": false },
+        { "name": "port", "type": "integer", "required": false },
+        { "name": "username", "type": "string", "required": false },
+        { "name": "password", "type": "string", "required": false },
+        { "name": "authenticationDatabase", "type": "string", "required": false },
+        { "name": "tls", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "mongosh",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any mongosh command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mongosh",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install mongosh to use this command."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/mysql/README.md

@@ -0,0 +1,48 @@
+# MySQL Plugin Harness
+
+This plugin integrates the MySQL CLI into dcli with a wrapped version command, a batch-friendly query wrapper, and full namespace passthrough.
+
+## Prerequisites
+
+Ensure `mysql` is available on your machine:
+
+```bash
+mysql --version
+```
+
+If you plan to connect to a remote server, set the usual connection flags or environment variables such as `MYSQL_HOST`, `MYSQL_USER`, `MYSQL_DATABASE`, and `MYSQL_PWD`.
+
+## Available Commands
+
+### CLI Version (Wrapped)
+
+Returns the MySQL client version via `mysql --version`.
+
+```bash
+dcli mysql cli version --json
+```
+
+### Query Execute (Wrapped)
+
+Runs `mysql --batch --raw --skip-column-names --execute <sql>` so the output stays automation-friendly.
+
+```bash
+dcli mysql query execute --execute "select 1" --host 127.0.0.1 --user root --database mysql --json
+```
+
+### Full Passthrough
+
+You can run any MySQL CLI command through the `mysql` namespace.
+
+```bash
+# Show help
+dcli mysql --help
+
+# Run a one-off query directly
+dcli mysql --execute "show databases()"
+```
+
+## Notes
+
+- The wrapped query command returns raw text output, not parsed JSON.
+- Prefer `MYSQL_PWD` or other secure credential mechanisms instead of putting passwords directly in shell history.

package/plugins/mysql/plugin.json

@@ -0,0 +1,64 @@
+{
+  "name": "mysql",
+  "version": "0.1.0",
+  "description": "MySQL CLI plugin for dcli",
+  "source": "https://dev.mysql.com/doc/refman/en/mysql.html",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "mysql"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "mysql",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show MySQL CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mysql",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install the MySQL CLI to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "mysql",
+      "resource": "query",
+      "action": "execute",
+      "description": "Execute a SQL query with batch-friendly MySQL output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mysql",
+        "baseArgs": ["--batch", "--raw", "--skip-column-names"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Please install the MySQL CLI to use this command."
+      },
+      "args": [
+        { "name": "execute", "type": "string", "required": true, "description": "SQL statement to execute" },
+        { "name": "host", "type": "string", "required": false },
+        { "name": "port", "type": "integer", "required": false },
+        { "name": "user", "type": "string", "required": false },
+        { "name": "password", "type": "string", "required": false },
+        { "name": "database", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "mysql",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any MySQL CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "mysql",
+        "passthrough": true,
+        "parseJson": true,
+        "missingDependencyHelp": "Please install the MySQL CLI to use this command."
+      },
+      "args": []
+    }
+  ]
+}