superacli 1.1.10 → 1.1.12

package/plugins/clawteam/skills/usage/SKILL.md

@@ -0,0 +1,45 @@
+---
+skill_name: clawteam.usage.agent
+description: Workflow for agents to discover team members and delegate complex tasks via ClawTeam.
+tags: clawteam,collaboration,delegation,agents
+---
+
+# ClawTeam Agent Usage
+
+This skill guides agents in utilizing the ClawTeam network for collaborative task execution.
+
+## 1) Discovery
+
+List active agents in the network to identify expert capabilities:
+
+```bash
+supercli clawteam agents list --json
+```
+
+## 2) Task Delegation
+
+When you identify a task that requires a specialized agent (e.g., security audit, frontend design), use the delegation primitive.
+
+**Command Structure:**
+```bash
+supercli clawteam task delegate --agent <agent_id> --task "<task_description>" --json
+```
+
+**Example:**
+```bash
+supercli clawteam task delegate --agent "security-bot" --task "Review the latest PR for security vulnerabilities" --json
+```
+
+## 3) Monitoring Status
+
+Check the status of the local gateway to ensure connectivity to the team network:
+
+```bash
+supercli clawteam gateway status --json
+```
+
+## 4) Case Study
+
+For a complete end-to-end example of building a persistent SPA via delegation, refer to:
+`supercli skills get clawteam-local:clawteam.case_study.veg_basket_poc`
+

package/plugins/jsalt/README.md

@@ -0,0 +1,36 @@
+# JSALT Plugin
+
+`jsalt` helps agents learn and use the JSALT (JSA) framework by combining:
+
+- learnable framework guidance via `plugins learn`
+- executable `jsa-ast` wrappers for validation and AST output
+- passthrough access for full upstream CLI coverage
+
+## Install
+
+```bash
+npm install -g jsalt
+supercli plugins install ./plugins/jsalt --json
+```
+
+## Learn First (Recommended)
+
+```bash
+supercli plugins learn jsalt
+```
+
+This prints agent-focused JSALT syntax, common patterns, and examples for `.jsa` coding workflows.
+
+## Commands
+
+- `supercli jsalt cli help`
+- `supercli jsalt ast validate --path examples/counter.jsa`
+- `supercli jsalt ast json --path examples/counter.jsa`
+- `supercli jsalt ast tree --path examples/counter.jsa`
+- `supercli jsalt <any jsa-ast args...>`
+
+## Notes
+
+- Use `ast json` when an agent needs structured AST for planning or code transformation.
+- Use `ast validate` in CI or pre-commit checks for `.jsa` syntax safety.
+- Use passthrough when you need upstream flags not covered by wrappers.

package/plugins/jsalt/plugin.json

@@ -0,0 +1,109 @@
+{
+  "name": "jsalt",
+  "version": "0.1.0",
+  "description": "jsalt plugin exposing JSA docs-oriented workflows and jsa-ast validation commands",
+  "source": "https://github.com/javimosch/jsalt",
+  "tags": ["jsalt", "jsa", "frontend", "ast", "validation", "agents"],
+  "checks": [
+    { "type": "binary", "name": "jsa-ast", "args": ["--help"] }
+  ],
+  "install_guidance": {
+    "plugin": "jsalt",
+    "binary": "jsa-ast",
+    "check": "jsa-ast --help",
+    "install_steps": [
+      "npm install -g jsalt",
+      "jsa-ast --help",
+      "supercli plugins install ./plugins/jsalt --json"
+    ],
+    "note": "Use 'supercli plugins learn jsalt' to load agent-focused JSALT syntax, patterns, and examples before generating .jsa applications."
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "jsalt",
+      "resource": "cli",
+      "action": "help",
+      "description": "Show jsa-ast CLI usage help",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "jsa-ast",
+        "baseArgs": ["--help"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install jsalt globally: npm install -g jsalt"
+      },
+      "args": []
+    },
+    {
+      "namespace": "jsalt",
+      "resource": "ast",
+      "action": "validate",
+      "description": "Validate .jsa syntax for a file or directory",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "jsa-ast",
+        "positionalArgs": ["path"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install jsalt globally: npm install -g jsalt"
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": true, "description": "File, directory, or glob to validate" }
+      ]
+    },
+    {
+      "namespace": "jsalt",
+      "resource": "ast",
+      "action": "json",
+      "description": "Parse .jsa and emit machine-readable JSON AST",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "jsa-ast",
+        "baseArgs": ["--json"],
+        "positionalArgs": ["path"],
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install jsalt globally: npm install -g jsalt"
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": true, "description": "File, directory, or glob to parse" }
+      ]
+    },
+    {
+      "namespace": "jsalt",
+      "resource": "ast",
+      "action": "tree",
+      "description": "Render parsed .jsa structure as a tree",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "jsa-ast",
+        "baseArgs": ["--tree"],
+        "positionalArgs": ["path"],
+        "parseJson": false,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install jsalt globally: npm install -g jsalt"
+      },
+      "args": [
+        { "name": "path", "type": "string", "required": true, "description": "File, directory, or glob to parse" }
+      ]
+    },
+    {
+      "namespace": "jsalt",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to run any jsa-ast command",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "jsa-ast",
+        "passthrough": true,
+        "parseJson": true,
+        "timeout_ms": 15000,
+        "missingDependencyHelp": "Install jsalt globally: npm install -g jsalt"
+      },
+      "args": []
+    }
+  ]
+}

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

@@ -0,0 +1,94 @@
+---
+skill_name: jsalt.quickstart
+description: Agent workflow for learning JSALT and building .jsa apps with executable validation and AST checks.
+tags: jsalt,jsa,frontend,ast,validation,agents
+---
+
+# jsalt Quickstart
+
+Use this when you need to generate or edit JSALT (`.jsa`) apps with reliable syntax validation.
+
+## 1) Install plugin and dependency
+
+```bash
+supercli plugins learn jsalt
+npm install -g jsalt
+supercli plugins install ./plugins/jsalt --json
+```
+
+## 2) Validate CLI wiring
+
+```bash
+supercli jsalt cli help
+supercli plugins doctor jsalt --json
+```
+
+## 3) Core JSALT syntax checklist
+
+- `let key = value` for reactive state.
+- `const x = computed(() => expr)` for derived state.
+- `fn name = "handler code"` for reusable handlers.
+- `watch key = "handler code"` for side effects.
+- `on mount = "..."` and `on destroy = "..."` for lifecycle.
+- Element shape: `div#id.class { css: value } @click = "..." = "content"`.
+
+## 4) Useful directives for agent-generated UI
+
+- `if = "${expr}"` conditional render.
+- `show = "${expr}"` visibility toggle.
+- `each = "${array}"` loops (`item`, `idx` available).
+- `bind = "stateKey"` two-way form binding.
+- `:attr = "..."` dynamic attributes.
+- `html = "..."` raw HTML when needed.
+- `transition = "fade"` enter transition classes.
+
+## 5) Validate and inspect AST during generation
+
+```bash
+supercli jsalt ast validate --path app.jsa
+supercli jsalt ast json --path app.jsa
+supercli jsalt ast tree --path app.jsa
+```
+
+## 6) Full passthrough for advanced runs
+
+```bash
+supercli jsalt app.jsa --json
+supercli jsalt examples --tree
+```
+
+## 7) Minimal example patterns
+
+Counter:
+
+```jsa
+let count = 0
+const doubled = computed(() => count * 2)
+fn inc = "setState('count', getState('count') + 1)"
+
+div
+  h1 = "Count: ${count}"
+  p = "Doubled: ${doubled}"
+  button @click = "inc()" = "+"
+```
+
+Todo list loop:
+
+```jsa
+let items = []
+let text = ""
+fn add = "if(!getState('text')) return; setState('items', [...getState('items'), getState('text')]); setState('text', '')"
+
+div
+  input bind = "text"
+  button @click = "add()" = "Add"
+  ul
+    li each = "${items}" = "${idx + 1}. ${item}"
+```
+
+## 8) Agent workflow recommendation
+
+1. Draft `.jsa` using the syntax checklist.
+2. Run `ast validate` after each meaningful edit.
+3. Run `ast json` when tooling needs structural introspection.
+4. Prefer simple handlers and immutable updates for predictable diffs.

package/plugins/opencode/plugin.json

@@ -0,0 +1,43 @@
+{
+  "name": "opencode",
+  "version": "0.1.0",
+  "description": "OpenCode AI assistant CLI plugin for natural language coding tasks",
+  "source": "https://github.com/opencode-ai/opencode",
+  "tags": ["opencode", "ai", "coding", "assistant", "refactoring"],
+  "checks": [
+    {
+      "type": "binary",
+      "name": "opencode"
+    }
+  ],
+  "commands": [
+    {
+      "namespace": "opencode",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough to opencode CLI",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "opencode",
+        "passthrough": true,
+        "parseJson": false,
+        "missingDependencyHelp": "OpenCode CLI not found. Install with: npm i -g opencode"
+      },
+      "args": []
+    },
+    {
+      "namespace": "opencode", 
+      "resource": "cli",
+      "action": "version",
+      "description": "Check OpenCode CLI version and availability",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "opencode",
+        "baseArgs": ["--version"],
+        "parseJson": false,
+        "missingDependencyHelp": "OpenCode CLI not found. Install with: npm i -g opencode"
+      },
+      "args": []
+    }
+  ]
+}

package/plugins/plugins.json

@@ -10,6 +10,15 @@
         "manifest_path": "plugins/beads/plugin.json"
       }
     },
+    {
+      "name": "opencode",
+      "description": "OpenCode AI assistant CLI plugin for natural language coding tasks",
+      "tags": ["opencode", "ai", "coding", "assistant", "refactoring"],
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/opencode/plugin.json"
+      }
+    },
     {
       "name": "gwc",
       "description": "Google Workspace CLI passthrough plugin",
@@ -326,6 +335,16 @@
         "manifest_path": "plugins/nullclaw/plugin.json"
       }
     },
+    {
+      "name": "clawteam",
+      "description": "Collaborative agent sharing and discovery for teams via ClawTeam",
+      "tags": ["agents", "collaboration", "teamwork", "openclaw"],
+      "has_learn": true,
+      "source": {
+        "type": "bundled",
+        "manifest_path": "plugins/clawteam/plugin.json"
+      }
+    },
     {
       "name": "commiat",
       "description": "AI-assisted git commit message plugin",