superacli 1.1.5 → 1.1.7

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

@@ -0,0 +1,44 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const localRepoPath = '/home/jarancibia/ai/gifcap';
+
+function run(cmd, cwd = process.cwd()) {
+  console.log(`Executing: ${cmd} in ${cwd}`);
+  try {
+    return execSync(cmd, { cwd, stdio: 'inherit' });
+  } catch (e) {
+    console.error(`Failed to execute: ${cmd}`);
+    process.exit(1);
+  }
+}
+
+console.log('--- GifCap Setup ---');
+
+if (fs.existsSync(localRepoPath)) {
+  console.log(`Found local gifcap repository at ${localRepoPath}`);
+  console.log('Linking local repository for development...');
+  
+  // Ensure dependencies are installed in the repo
+  if (!fs.existsSync(path.join(localRepoPath, 'node_modules'))) {
+    console.log('Installing local dependencies...');
+    run('npm install', localRepoPath);
+  }
+  
+  // Link the repo
+  run('npm link', localRepoPath);
+  console.log('Success: Local gifcap linked.');
+} else {
+  console.log('Local repository not found. Installing from npm...');
+  run('npm install -g gifcap');
+}
+
+// Final check
+try {
+  const version = execSync('gifcap --version').toString().trim();
+  console.log(`Verified: gifcap ${version} is available.`);
+} catch (e) {
+  console.error('Error: gifcap binary not found after installation.');
+  process.exit(1);
+}

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

@@ -0,0 +1,34 @@
+# GifCap Skill
+
+Capture your screen, optimize GIFs, and automate media documentation with `gifcap`.
+
+## Quick Start
+
+### 1. Setup
+Install dependencies and link the CLI:
+```bash
+dcli gifcap cli setup
+```
+
+### 2. Automated Recording
+Record 5 seconds of the screen:
+```bash
+dcli gifcap screen record --duration 5 --output recording.gif
+```
+
+### 3. Smart Cropping
+Record a specific area (e.g., center screen or removing bars):
+```bash
+dcli gifcap screen record --duration 10 --top 100 --left 50 --output tutorial.gif
+```
+
+### 4. GIF Optimization
+Reduce file size of an existing GIF to below 2MB:
+```bash
+dcli gifcap media optimize --input large.gif --target-size 2 --output optimized.gif
+```
+
+## Tips for Agents
+- **Non-Interactive Mode**: Always use `--duration` for recording to ensure the process terminates.
+- **JSON Output**: The plugin uses `parseJson: true`, so commands return structured data about the output path and final media metadata.
+- **Cropping**: Use `-t`, `-l`, `-b`, `-r` to focus on the relevant part of the UI.

package/plugins/goose/README.md

@@ -0,0 +1,36 @@
+# Goose Plugin
+
+Use this plugin to run the `goose` CLI through SuperCLI with safer headless defaults.
+
+## Install
+
+```bash
+curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
+supercli plugins install goose
+```
+
+## Fast path
+
+```bash
+supercli goose cli version
+supercli goose task text --text "Summarize this repository"
+supercli goose task json --text "List the main services as JSON"
+supercli goose task stream --text "Plan a docs update"
+supercli goose task file --instructions ./task.txt
+```
+
+These wrapped commands default to `goose run --no-session --quiet` so they work better in CI and other non-interactive automation.
+
+## Passthrough
+
+Use passthrough when you need an upstream flag that is not wrapped yet:
+
+```bash
+supercli goose run --text "Explain this project" --output-format json --no-session
+```
+
+## Notes
+
+- Prefer the wrapped commands for deterministic automation.
+- `task stream` emits JSONL events.
+- `task file` accepts a file path or `-` for stdin.

package/plugins/goose/plugin.json

@@ -0,0 +1,183 @@
+{
+  "name": "goose",
+  "version": "0.1.0",
+  "description": "Goose CLI plugin with headless automation wrappers and passthrough",
+  "source": "https://github.com/block/goose",
+  "checks": [
+    { "type": "binary", "name": "goose" }
+  ],
+  "install_guidance": {
+    "plugin": "goose",
+    "binary": "goose",
+    "check": "goose --version",
+    "install_steps": [
+      "curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash",
+      "goose --version",
+      "supercli plugins install goose"
+    ],
+    "note": "Use headless wrappers with --no-session defaults in CI or other non-interactive workflows."
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "goose",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show installed Goose CLI version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["--version"],
+        "cwd": "invoke_cwd",
+        "parseJson": false,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": []
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "text",
+      "description": "Run a Goose headless task and return text output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet"],
+        "cwd": "invoke_cwd",
+        "optionalArgs": {
+          "text": "--text"
+        },
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "text", "type": "string", "required": true, "description": "Instruction text to run headlessly" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "json",
+      "description": "Run a Goose headless task and return structured JSON output",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet", "--output-format", "json"],
+        "cwd": "invoke_cwd",
+        "optionalArgs": {
+          "text": "--text"
+        },
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "text", "type": "string", "required": true, "description": "Instruction text to run headlessly" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "stream",
+      "description": "Run a Goose headless task with stream-json events",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet", "--output-format", "stream-json"],
+        "cwd": "invoke_cwd",
+        "optionalArgs": {
+          "text": "--text"
+        },
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "stream": "jsonl",
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "text", "type": "string", "required": true, "description": "Instruction text to run headlessly" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "task",
+      "action": "file",
+      "description": "Run a Goose headless task from an instructions file",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "baseArgs": ["run", "--no-session", "--quiet", "--instructions"],
+        "cwd": "invoke_cwd",
+        "positionalArgs": ["instructions"],
+        "errorMatchers": [
+          {
+            "match": "No provider configured",
+            "message": "Goose is installed but not configured with a provider yet. Escalate to a human to run `goose configure` and complete provider setup, then retry.",
+            "suggestions": [
+              "Ask a human to run `goose configure` and choose a provider/model.",
+              "Retry the same Goose command after provider setup completes."
+            ],
+            "recoverable": true
+          }
+        ],
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": [
+        { "name": "instructions", "type": "string", "required": true, "description": "Instruction file path or - for stdin" }
+      ]
+    },
+    {
+      "namespace": "goose",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any Goose CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "goose",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "parseJson": false,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,44 @@
+---
+skill_name: goose.quickstart
+description: Agent workflow for running Goose in headless mode with non-interactive defaults and structured output.
+tags: goose,ai,automation,headless,json,jsonl
+---
+
+# Goose Quickstart
+
+Use this when you need Goose in scripts, CI, or agent workflows without interactive prompts.
+
+## 1) Install plugin and dependency
+
+```bash
+curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
+supercli plugins install goose --json
+```
+
+## 2) Validate setup
+
+```bash
+supercli goose cli version
+```
+
+## 3) Headless wrappers
+
+```bash
+supercli goose task text --text "Summarize this repository"
+supercli goose task json --text "Return the top risks in JSON"
+supercli goose task stream --text "Plan a refactor"
+supercli goose task file --instructions ./task.txt
+```
+
+## 4) Passthrough for advanced flags
+
+```bash
+supercli goose run --text "Explain the architecture" --output-format json --no-session
+supercli goose run --instructions ./task.txt --output-format stream-json --no-session
+```
+
+## 5) Caveats
+
+- Wrapped commands include `--no-session` and `--quiet` by default.
+- `task stream` returns JSONL event lines; consume them line by line.
+- Use passthrough for recipes, provider configuration, or flags not covered by wrappers.

package/plugins/json-server/README.md

@@ -0,0 +1,58 @@
+# json-server Plugin Harness
+
+This plugin integrates `@javimosch/json-server` into supercli with agent-friendly background server lifecycle wrappers and full passthrough.
+
+## What You Get
+
+- wrappers for `server start/status/logs/stop`
+- `cli version` wrapper for environment checks
+- full passthrough for all upstream `json-server` commands
+- learn content via `supercli plugins learn json-server`
+
+## Prerequisites
+
+Install the package globally so the `json-server` binary is available:
+
+```bash
+npm install -g @javimosch/json-server
+```
+
+## Install Plugin
+
+```bash
+supercli plugins learn json-server
+supercli plugins install json-server --json
+```
+
+## Wrapper Commands
+
+```bash
+supercli json-server cli version
+supercli json-server server start --file fixtures/db.json --port 43111 --state-dir .json-server-test
+supercli json-server server status --state-dir .json-server-test
+supercli json-server server logs --state-dir .json-server-test --lines 50
+supercli json-server server stop --state-dir .json-server-test
+```
+
+## Full Passthrough Examples
+
+```bash
+supercli json-server server start fixtures/db.json --json
+supercli json-server fixtures/db.json --json --no-interactive --no-color
+```
+
+## Important Caveats
+
+- Prefer wrapper args as flags (`--file`, `--state-dir`) for deterministic invocation.
+- `server start` runs detached and returns immediately; use a short readiness retry loop before API calls.
+- Default state directory is `./.json-server`; isolate environments with `--state-dir` to avoid PID/log collisions.
+- Always run `server stop` after automation flows so stale state does not block future starts.
+
+Example readiness check:
+
+```bash
+for i in 1 2 3 4 5 6 7 8 9 10; do
+  curl -sS http://localhost:43111/posts >/dev/null && break
+  sleep 0.2
+done
+```

package/plugins/json-server/plugin.json

@@ -0,0 +1,113 @@
+{
+  "name": "json-server",
+  "version": "0.1.0",
+  "description": "@javimosch/json-server plugin with agent-friendly server lifecycle wrappers and passthrough",
+  "source": "https://github.com/javimosch/json-server",
+  "checks": [
+    { "type": "binary", "name": "json-server" }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "json-server",
+      "resource": "cli",
+      "action": "version",
+      "description": "Show installed json-server version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "json-server",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "Install with: npm install -g @javimosch/json-server"
+      },
+      "args": []
+    },
+    {
+      "namespace": "json-server",
+      "resource": "server",
+      "action": "start",
+      "description": "Start json-server in background and return immediately",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "json-server",
+        "baseArgs": ["server", "start"],
+        "parseJson": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install with: npm install -g @javimosch/json-server"
+      },
+      "args": [
+        { "name": "file", "type": "string", "required": true, "description": "Path to db.json or db.json5" },
+        { "name": "port", "type": "integer", "required": false, "description": "Port to bind (default: 3000)" },
+        { "name": "host", "type": "string", "required": false, "description": "Host to bind (default: localhost)" },
+        { "name": "state-dir", "type": "string", "required": false, "description": "Local state directory for PID/log/state files" },
+        { "name": "static", "type": "string[]", "required": false, "description": "Additional static directories (repeatable)" }
+      ]
+    },
+    {
+      "namespace": "json-server",
+      "resource": "server",
+      "action": "status",
+      "description": "Check whether background json-server is running",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "json-server",
+        "baseArgs": ["server", "status"],
+        "parseJson": true,
+        "missingDependencyHelp": "Install with: npm install -g @javimosch/json-server"
+      },
+      "args": [
+        { "name": "state-dir", "type": "string", "required": false, "description": "Local state directory for PID/log/state files" }
+      ]
+    },
+    {
+      "namespace": "json-server",
+      "resource": "server",
+      "action": "logs",
+      "description": "Get recent background server logs",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "json-server",
+        "baseArgs": ["server", "logs"],
+        "parseJson": true,
+        "missingDependencyHelp": "Install with: npm install -g @javimosch/json-server"
+      },
+      "args": [
+        { "name": "state-dir", "type": "string", "required": false, "description": "Local state directory for PID/log/state files" },
+        { "name": "lines", "type": "integer", "required": false, "description": "How many recent log lines to return" }
+      ]
+    },
+    {
+      "namespace": "json-server",
+      "resource": "server",
+      "action": "stop",
+      "description": "Stop background json-server",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "json-server",
+        "baseArgs": ["server", "stop"],
+        "parseJson": true,
+        "missingDependencyHelp": "Install with: npm install -g @javimosch/json-server"
+      },
+      "args": [
+        { "name": "state-dir", "type": "string", "required": false, "description": "Local state directory for PID/log/state files" }
+      ]
+    },
+    {
+      "namespace": "json-server",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough command to execute any json-server CLI command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "json-server",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 180000,
+        "missingDependencyHelp": "Install with: npm install -g @javimosch/json-server"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/json-server/skills/quickstart/SKILL.md

@@ -0,0 +1,57 @@
+---
+skill_name: json-server.quickstart
+description: Agent workflow for background json-server lifecycle with deterministic JSON outputs.
+tags: json-server,mock-api,rest,agent-friendly,automation
+---
+
+# json-server Quickstart
+
+Use this when you need a local fake REST API that an agent can start, inspect, and stop non-interactively.
+
+## 1) Install plugin and dependency
+
+```bash
+supercli plugins learn json-server
+supercli plugins install json-server --json
+npm install -g @javimosch/json-server
+```
+
+## 2) Validate setup
+
+```bash
+supercli json-server cli version
+```
+
+## 3) Agent-friendly lifecycle flow
+
+```bash
+supercli json-server server start --file fixtures/db.json --port 43111 --state-dir .json-server-test
+supercli json-server server status --state-dir .json-server-test
+supercli json-server server logs --state-dir .json-server-test --lines 50
+supercli json-server server stop --state-dir .json-server-test
+```
+
+## 3.1) Readiness wait (avoid startup race)
+
+`server start` is non-blocking. The first HTTP probe can fail if the process is still binding the port.
+
+```bash
+for i in 1 2 3 4 5 6 7 8 9 10; do
+  curl -sS http://localhost:43111/posts >/dev/null && break
+  sleep 0.2
+done
+```
+
+## 4) Full passthrough for all CLI commands
+
+```bash
+supercli json-server fixtures/db.json --json --no-interactive --no-color
+supercli json-server server start fixtures/db.json --json
+```
+
+## 5) Caveats
+
+- Use wrapper command args as flags (for example `--file`) for reliable invocation.
+- `server start` is non-blocking and returns immediately; always use a short readiness retry loop before API calls.
+- Default state location is `./.json-server`; use `--state-dir` to isolate concurrent local environments.
+- Always stop background servers after tasks to avoid stale PID/log state and port conflicts.