superacli 1.1.6 → 1.1.7

package/plugins/squirrelscan/skills/publish-report/SKILL.md

@@ -0,0 +1,33 @@
+---
+description: Authenticate and publish squirrelscan reports from supercli.
+tags: squirrelscan,auth,publish,report,visibility
+---
+
+# Publish Reports
+
+Use this when you need to publish audit results to SquirrelScan reports.
+
+## Authenticate
+
+```bash
+supercli squirrel auth login
+supercli squirrel auth status
+```
+
+## Publish latest report
+
+```bash
+supercli squirrel report publish
+```
+
+## Publish with visibility
+
+```bash
+supercli squirrel report publish --visibility unlisted
+```
+
+## Logout
+
+```bash
+supercli squirrel auth logout
+```

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

@@ -0,0 +1,41 @@
+---
+description: Agent quickstart for using the squirrelscan Docker plugin in supercli.
+tags: squirrelscan,seo,audit,docker,plugin,quickstart
+---
+
+# SquirrelScan Quickstart
+
+Use this when you need a fast website audit through `supercli`.
+
+## Install and verify
+
+```bash
+supercli plugins install ./plugins/squirrelscan --json
+supercli plugins doctor squirrelscan --json
+```
+
+## Recommended command
+
+```bash
+supercli squirrel audit https://example.com -C quick
+```
+
+## Structured equivalent
+
+```bash
+supercli squirrel audit run --url https://example.com --coverage quick
+```
+
+## Useful follow-ups
+
+```bash
+supercli squirrel report list
+supercli squirrel report show --format llm
+supercli squirrel report show --format json --output report.json
+```
+
+## Notes
+
+- First run can be slower because the plugin builds a local Docker image.
+- Later runs are faster due to local image and volume reuse.
+- If you need full CLI behavior not wrapped by structured commands, use passthrough (`supercli squirrel ...`).

package/plugins/uipath/README.md

@@ -0,0 +1,27 @@
+# uipath Plugin
+
+`uipath` wraps UiPath CLI (`uipcli`) for CI/CD-oriented automation in supercli.
+
+## Install
+
+```bash
+supercli plugins install ./plugins/uipath --json
+```
+
+Install the upstream CLI (example):
+
+```bash
+dotnet tool install --global UiPath.CLI.Linux
+uipcli --version
+```
+
+## Commands
+
+- `supercli uipath cli version`
+- `supercli uipath package deploy --path <artifact-or-project-path> [auth flags]`
+- `supercli uipath <any upstream args...>`
+
+## Notes
+
+- The deploy wrapper exposes common external-app auth flags.
+- For full CI/CD lifecycle actions, use passthrough commands.

package/plugins/uipath/plugin.json

@@ -0,0 +1,86 @@
+{
+  "name": "uipath",
+  "version": "0.1.0",
+  "description": "UiPath CLI plugin with CI/CD-oriented wrappers and passthrough",
+  "source": "https://docs.uipath.com/cicd-integrations/standalone/2025.10",
+  "tags": ["uipath", "rpa", "cicd", "automation", "enterprise"],
+  "checks": [
+    {
+      "type": "binary",
+      "name": "uipcli"
+    }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "uipath",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show UiPath CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "uipcli",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Please install UiPath CLI (uipcli) to use this command."
+      },
+      "args": []
+    },
+    {
+      "namespace": "uipath",
+      "resource": "package",
+      "action": "deploy",
+      "description": "Deploy a UiPath package path using non-interactive credentials",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "uipcli",
+        "baseArgs": ["package", "deploy"],
+        "positionalArgs": ["path"],
+        "optionalArgs": {
+          "application-id": "--applicationId",
+          "application-secret": "--applicationSecret",
+          "account-for-app": "--accountForApp",
+          "application-scope": "--applicationScope",
+          "organization": "--organization",
+          "tenant": "--tenant",
+          "uri": "--uri"
+        },
+        "parseJson": false,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Please install UiPath CLI (uipcli) to use this command."
+      },
+      "args": [
+        {
+          "name": "path",
+          "type": "string",
+          "required": true,
+          "description": "Path to project or package artifact"
+        },
+        { "name": "application-id", "type": "string", "required": false },
+        { "name": "application-secret", "type": "string", "required": false },
+        { "name": "account-for-app", "type": "string", "required": false },
+        { "name": "application-scope", "type": "string", "required": false },
+        { "name": "organization", "type": "string", "required": false },
+        { "name": "tenant", "type": "string", "required": false },
+        { "name": "uri", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "uipath",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any UiPath CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "uipcli",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 120000,
+        "missingDependencyHelp": "Please install UiPath CLI (uipcli) to use this command."
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,47 @@
+---
+skill_name: uipath.quickstart
+description: Agent workflow for UiPath CLI package deployment with non-interactive credentials.
+tags: uipath,uipcli,rpa,cicd,automation
+---
+
+# uipath Quickstart
+
+Use this skill when automating UiPath package deployment tasks in CI/CD.
+
+## 1) Learn and install
+
+```bash
+supercli plugins learn uipath
+supercli plugins install ./plugins/uipath --json
+```
+
+## 2) Validate setup
+
+```bash
+supercli uipath cli version
+```
+
+## 3) Deploy with wrapper command
+
+```bash
+supercli uipath package deploy \
+  --path ./dist/my-automation \
+  --application-id "$UIPATH_APP_ID" \
+  --application-secret "$UIPATH_APP_SECRET" \
+  --account-for-app "$UIPATH_ORG" \
+  --organization "$UIPATH_ORG" \
+  --tenant "$UIPATH_TENANT" \
+  --uri "$UIPATH_URI"
+```
+
+## 4) Use passthrough for full CLI coverage
+
+```bash
+supercli uipath package pack ./project
+supercli uipath orchestrator folders list
+```
+
+## 5) Caveats
+
+- Prefer environment-injected secrets in automation contexts.
+- Use passthrough whenever a command or flag is not wrapped.

package/plugins/uipathcli/README.md

@@ -0,0 +1,28 @@
+# UiPath CLI Plugin
+
+The UiPath CLI plugin adds common automation lifecycle wrappers and passthrough support for `uipcli`.
+
+## Install
+
+1. Download/extract the UiPath CLI package for your OS.
+2. Ensure `uipcli` is on `PATH`, or set `UIPCLI_DLL` and have `dotnet` installed.
+3. Install plugin:
+
+```bash
+supercli plugins install uipathcli
+```
+
+## Commands
+
+- `supercli uipath self version`
+- `supercli uipath project pack`
+- `supercli uipath project analyze`
+- `supercli uipath project deploy`
+- `supercli uipath ...` (passthrough)
+
+## Runtime Resolution
+
+The plugin uses this runtime order:
+
+1. `uipcli` from `PATH`
+2. `dotnet $UIPCLI_DLL`

package/plugins/uipathcli/plugin.json

@@ -0,0 +1,120 @@
+{
+  "name": "uipathcli",
+  "version": "0.1.0",
+  "description": "UiPath CLI plugin with CI/CD lifecycle wrappers and passthrough",
+  "source": "https://docs.uipath.com/cicd-integrations/standalone/2025.10/user-guide/about-uipath-cli",
+  "checks": [
+    { "type": "binary", "name": "uipcli" }
+  ],
+  "install_guidance": {
+    "plugin": "uipathcli",
+    "binary": "uipcli",
+    "check": "uipcli --version",
+    "install_steps": [
+      "Download and extract UiPath CLI package for your OS",
+      "Ensure uipcli is on PATH, or set UIPCLI_DLL and install dotnet runtime",
+      "supercli plugins install uipathcli"
+    ],
+    "note": "On Linux/macOS, UiPath CLI commonly runs as 'dotnet uipcli.dll'. Set UIPCLI_DLL when no uipcli launcher is available."
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "uipath",
+      "resource": "self",
+      "action": "version",
+      "description": "Show UiPath CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-uipath-cli.js", "--version"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install UiPath CLI and ensure uipcli is available."
+      },
+      "args": []
+    },
+    {
+      "namespace": "uipath",
+      "resource": "project",
+      "action": "pack",
+      "description": "Pack a UiPath project into a package",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-uipath-cli.js", "package", "pack"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install UiPath CLI and ensure uipcli is available."
+      },
+      "args": [
+        { "name": "project-path", "type": "string", "required": false },
+        { "name": "output", "type": "string", "required": false },
+        { "name": "version", "type": "string", "required": false },
+        { "name": "orchestrator-url", "type": "string", "required": false },
+        { "name": "organization-unit", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false },
+        { "name": "password", "type": "string", "required": false },
+        { "name": "tenant", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "uipath",
+      "resource": "project",
+      "action": "analyze",
+      "description": "Run static analysis for a UiPath project",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-uipath-cli.js", "package", "analyze"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install UiPath CLI and ensure uipcli is available."
+      },
+      "args": [
+        { "name": "project-path", "type": "string", "required": false },
+        { "name": "stop-on-rule-violation", "type": "boolean", "required": false }
+      ]
+    },
+    {
+      "namespace": "uipath",
+      "resource": "project",
+      "action": "deploy",
+      "description": "Deploy a UiPath package to Orchestrator",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-uipath-cli.js", "package", "deploy"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install UiPath CLI and ensure uipcli is available."
+      },
+      "args": [
+        { "name": "orchestrator-url", "type": "string", "required": false },
+        { "name": "organization-unit", "type": "string", "required": false },
+        { "name": "tenant", "type": "string", "required": false },
+        { "name": "username", "type": "string", "required": false },
+        { "name": "password", "type": "string", "required": false },
+        { "name": "entry-points-path", "type": "string", "required": false }
+      ]
+    },
+    {
+      "namespace": "uipath",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any UiPath CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "node",
+        "baseArgs": ["scripts/run-uipath-cli.js"],
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install UiPath CLI and ensure uipcli is available."
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/uipathcli/scripts/run-uipath-cli.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+const fs = require("fs")
+const { spawnSync } = require("child_process")
+
+function isExecutableAvailable(binary) {
+  const result = spawnSync(binary, ["--version"], { encoding: "utf-8" })
+  return !result.error && result.status === 0
+}
+
+function run(command, args) {
+  const result = spawnSync(command, args, { encoding: "utf-8" })
+
+  if (result.stdout) process.stdout.write(result.stdout)
+  if (result.stderr) process.stderr.write(result.stderr)
+
+  if (result.error) {
+    process.stderr.write(`${result.error.message}\n`)
+    process.exit(1)
+  }
+
+  process.exit(typeof result.status === "number" ? result.status : 1)
+}
+
+function resolveRuntime() {
+  if (isExecutableAvailable("uipcli")) {
+    return { command: "uipcli", prefix: [] }
+  }
+
+  const dllPath = process.env.UIPCLI_DLL
+  if (dllPath) {
+    if (!fs.existsSync(dllPath)) {
+      process.stderr.write(`UIPCLI_DLL does not exist: ${dllPath}\n`)
+      process.exit(1)
+    }
+    if (!isExecutableAvailable("dotnet")) {
+      process.stderr.write("dotnet runtime is required when UIPCLI_DLL is set.\n")
+      process.exit(1)
+    }
+    return { command: "dotnet", prefix: [dllPath] }
+  }
+
+  process.stderr.write("UiPath CLI not found. Install a uipcli launcher or set UIPCLI_DLL to your extracted uipcli.dll path.\n")
+  process.exit(1)
+}
+
+const runtime = resolveRuntime()
+const args = runtime.prefix.concat(process.argv.slice(2))
+run(runtime.command, args)

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

@@ -0,0 +1,22 @@
+# UiPath CLI Quickstart
+
+Use this plugin for CI/CD automation tasks with UiPath CLI.
+
+## Prerequisites
+
+- Install UiPath CLI package for your OS.
+- Make `uipcli` available on PATH, or set `UIPCLI_DLL` and install `dotnet` runtime.
+- Install plugin: `supercli plugins install uipathcli`
+
+## Common Commands
+
+- Version: `supercli uipath self version`
+- Pack: `supercli uipath project pack --project-path .`
+- Analyze: `supercli uipath project analyze --project-path .`
+- Deploy: `supercli uipath project deploy --orchestrator-url https://...`
+
+## Passthrough
+
+Use passthrough for any command not wrapped in this plugin:
+
+`supercli uipath <raw uipcli args>`

package/plugins/xurl/README.md

@@ -1,12 +1,12 @@
 # xurl Plugin Harness
 
-This plugin is a hybrid harness for `xurl`: it indexes the upstream `SKILL.md` and `README.md` into the local skills catalog and exposes a curated set of safe read-only X API wrappers.
+This plugin is a hybrid harness for `xurl`: it indexes the upstream `SKILL.md` and `README.md` into the local skill-doc catalog and exposes a curated set of safe read-only X API wrappers.
 
 ## Why This Scope
 
 `xurl` can post, like, follow, upload media, manage auth state, and make arbitrary raw API requests. The wrapped commands in this plugin intentionally focus on low-risk inspection workflows.
 
-- upstream agent docs are indexed into the skills catalog
+- upstream agent docs are indexed into the skill-doc catalog
 - read-only wrappers are exposed for common account and timeline lookups
 - no wildcard passthrough in v1
 - no auth mutation, posting, social mutations, media upload, stream, or webhook wrappers
@@ -17,7 +17,7 @@ This plugin is a hybrid harness for `xurl`: it indexes the upstream `SKILL.md` a
 supercli plugins install xurl --json
 ```
 
-## Explore Indexed Skills
+## Explore Indexed Skill Documents
 
 ```bash
 supercli skills list --catalog --provider xurl --json
@@ -49,4 +49,4 @@ supercli xurl social following --of XDevelopers --max-results 20 --json
 - Wrapped JSON commands force `NO_COLOR=1` so dcli can parse upstream pretty-printed JSON reliably.
 - `~/.xurl` stores app credentials and tokens. Never paste its contents into chat or logs.
 - Use upstream `xurl` directly for OAuth setup, posting, likes, follows, DMs, media upload, raw requests, streams, and webhooks.
-- 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/server/app.js

@@ -9,13 +9,14 @@ const mcpRouter = require("./routes/mcp");
 const plansRouter = require("./routes/plans");
 const jobsRouter = require("./routes/jobs");
 const askRouter = require("./routes/ask");
+const pluginsRouter = require("./routes/plugins");
 
 const PORT = process.env.PORT || 3000;
 
 const app = express();
 
-app.use(express.json());
-app.use(express.urlencoded({ extended: true }));
+app.use(express.json({ limit: "20mb" }));
+app.use(express.urlencoded({ extended: true, limit: "20mb" }));
 
 app.set("view engine", "ejs");
 app.set("views", path.join(__dirname, "views"));
@@ -30,6 +31,7 @@ app.use("/api/mcp", mcpRouter);
 app.use("/api/plans", plansRouter);
 app.use("/api/jobs", jobsRouter);
 app.use("/api/ask", askRouter);
+app.use("/api/plugins", pluginsRouter);
 
 // Tree/command endpoints under /api (config router handles them)
 app.use("/api", configRouter);
@@ -41,6 +43,7 @@ app.get("/commands/new", (req, res) => res.redirect("/api/commands/new"));
 app.get("/specs", (req, res) => res.redirect("/api/specs"));
 app.get("/mcp", (req, res) => res.redirect("/api/mcp"));
 app.get("/jobs", (req, res) => res.redirect("/api/jobs"));
+app.get("/plugins", (req, res) => res.redirect("/api/plugins"));
 
 async function start() {
   try {

package/server/public/app.js

@@ -14,5 +14,8 @@
   } else if (path.startsWith("/api/jobs") || path.startsWith("/jobs")) {
     const el = document.getElementById("nav-jobs");
     if (el) el.classList.add("nav-active");
+  } else if (path.startsWith("/api/plugins") || path.startsWith("/plugins")) {
+    const el = document.getElementById("nav-plugins");
+    if (el) el.classList.add("nav-active");
   }
 })();