superacli 1.1.20 → 1.1.21

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

@@ -0,0 +1,25 @@
+# vale Quickstart
+
+Markup-aware linter for prose
+
+## Installation
+
+```bash
+brew install vale
+```
+
+## Quick Examples
+
+```bash
+# Check version
+vale --version
+
+# Get help
+vale --help
+```
+
+## Resources
+
+- GitHub: https://github.com/vale-cli/vale
+- Stars: 5,360
+- Language: go

package/plugins/volta/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "volta",
+  "binary": "volta",
+  "check": "which volta",
+  "install_steps": [
+    "curl https://get.volta.sh | bash",
+    "Verify: volta --version",
+    "supercli plugins install ./plugins/volta --on-conflict replace --json"
+  ],
+  "note": "Source: https://github.com/volta-cli/volta (12,933 stars). Written in rust."
+}

package/plugins/volta/meta.json

@@ -0,0 +1,12 @@
+{
+  "description": "JS Toolchains as Code - hassle-free JavaScript tools",
+  "tags": [
+    "volta",
+    "javascript",
+    "nodejs",
+    "toolchain",
+    "version-manager",
+    "rust"
+  ],
+  "has_learn": true
+}

package/plugins/volta/plugin.json

@@ -0,0 +1,75 @@
+{
+  "name": "volta",
+  "version": "0.1.0",
+  "description": "JS Toolchains as Code - hassle-free JavaScript tools",
+  "source": "https://github.com/volta-cli/volta",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "volta"
+    }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "volta",
+      "resource": "install",
+      "action": "package",
+      "description": "Install a package",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "volta",
+        "baseArgs": [
+          "install"
+        ],
+        "passthrough": true
+      },
+      "args": [
+        {
+          "name": "package",
+          "type": "string",
+          "required": true,
+          "description": "Package to install"
+        }
+      ]
+    },
+    {
+      "namespace": "volta",
+      "resource": "pin",
+      "action": "tool",
+      "description": "Pin tool version",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "volta",
+        "baseArgs": [
+          "pin"
+        ],
+        "passthrough": true
+      },
+      "args": [
+        {
+          "name": "tool",
+          "type": "string",
+          "required": true,
+          "description": "Tool to pin"
+        }
+      ]
+    },
+    {
+      "namespace": "volta",
+      "resource": "list",
+      "action": "tools",
+      "description": "List installed tools",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "volta",
+        "baseArgs": [
+          "list"
+        ],
+        "passthrough": true
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,25 @@
+# volta Quickstart
+
+JS Toolchains as Code - hassle-free JavaScript tools
+
+## Installation
+
+```bash
+curl https://get.volta.sh | bash
+```
+
+## Quick Examples
+
+```bash
+# Check version
+volta --version
+
+# Get help
+volta --help
+```
+
+## Resources
+
+- GitHub: https://github.com/volta-cli/volta
+- Stars: 12,933
+- Language: rust

package/plugins/wgcf/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "wgcf",
+  "binary": "wgcf",
+  "check": "which wgcf",
+  "install_steps": [
+    "go install github.com/ViRb3/wgcf@latest",
+    "Verify: wgcf --version",
+    "supercli plugins install ./plugins/wgcf --on-conflict replace --json"
+  ],
+  "note": "Source: https://github.com/ViRb3/wgcf (8,192 stars). Written in go."
+}

package/plugins/wgcf/meta.json

@@ -0,0 +1,12 @@
+{
+  "description": "Cross-platform CLI for Cloudflare Warp",
+  "tags": [
+    "wgcf",
+    "cloudflare",
+    "warp",
+    "wireguard",
+    "vpn",
+    "go"
+  ],
+  "has_learn": true
+}

package/plugins/wgcf/plugin.json

@@ -0,0 +1,45 @@
+{
+  "name": "wgcf",
+  "version": "0.1.0",
+  "description": "Cross-platform CLI for Cloudflare Warp",
+  "source": "https://github.com/ViRb3/wgcf",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "wgcf"
+    }
+  ],
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "wgcf",
+      "resource": "account",
+      "action": "register",
+      "description": "Register new Cloudflare account",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wgcf",
+        "baseArgs": [
+          "register"
+        ],
+        "passthrough": true
+      }
+    },
+    {
+      "namespace": "wgcf",
+      "resource": "profile",
+      "action": "generate",
+      "description": "Generate WireGuard profile",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "wgcf",
+        "baseArgs": [
+          "generate"
+        ],
+        "passthrough": true
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,25 @@
+# wgcf Quickstart
+
+Cross-platform CLI for Cloudflare Warp
+
+## Installation
+
+```bash
+go install github.com/ViRb3/wgcf@latest
+```
+
+## Quick Examples
+
+```bash
+# Check version
+wgcf --version
+
+# Get help
+wgcf --help
+```
+
+## Resources
+
+- GitHub: https://github.com/ViRb3/wgcf
+- Stars: 8,192
+- Language: go

package/scripts/analyze-plugins.js

@@ -0,0 +1,130 @@
+// Analyze all plugins and score them based on agent-friendly criteria
+// Scoring criteria:
+// - no_interactive: +3 (very important for agents)
+// - go_rust_nodejs: +2 (preferred languages)
+// - cli: +2 (must be a CLI)
+// - tui: -3 (strong penalty for TUI)
+// - auth_required: -1 (penalty but acceptable)
+// - binary: +1 (bonus, not required)
+// - json_support: +2 (bonus for agents)
+// - complexity: low=+2, medium=+1, high=0
+// Usage: node scripts/analyze-plugins.js
+const f=require('fs'),p=require('path'),b='/home/jarancibia/ai/supercli/plugins';
+const plugins=f.readdirSync(b).filter(x=>!x.startsWith('.'));
+const results=[];
+
+for(const name of plugins){
+  const dir=p.join(b,name);
+  const pj=p.join(dir,'plugin.json');
+  const mj=p.join(dir,'meta.json');
+  const ij=p.join(dir,'install-guidance.json');
+  
+  if(!f.existsSync(pj)) continue;
+  
+  try{
+    const plugin=JSON.parse(f.readFileSync(pj));
+    const meta=f.existsSync(mj)?JSON.parse(f.readFileSync(mj)):null;
+    const guide=f.existsSync(ij)?JSON.parse(f.readFileSync(ij)):null;
+    
+    // Analyze criteria
+    const source=plugin.source||'';
+    const install=guide?.install_steps?.[0]||'';
+    const binary=guide?.binary||plugin.checks?.[0]?.name||'';
+    
+    // Language detection from source URL
+    const isGo=source.includes('github.com')&&install.includes('go install')||install.includes('curl')&&source.includes('/go');
+    const isRust=source.includes('github.com')&&install.includes('cargo install')||install.includes('curl')&&source.includes('/rs');
+    const isNode=install.includes('npm install')||install.includes('yarn')||install.includes('pnpm')||source.includes('/node')||source.includes('/js')||source.includes('/ts');
+    
+    // Binary detection (bonus, not requirement)
+    const isBinary=install.includes('curl')||install.includes('wget')||install.includes('brew')||install.includes('apt')||install.includes('snap')||install.includes('go install')||install.includes('cargo install');
+    
+    // CLI detection (from description and commands)
+    const desc=plugin.description||'';
+    const isCLI=desc.toLowerCase().includes('cli')||desc.toLowerCase().includes('command line')||desc.toLowerCase().includes('command-line')||plugin.commands?.length>0;
+    
+    // TUI/interactive detection (strong penalty)
+    const isTUI=desc.toLowerCase().includes('tui')||desc.toLowerCase().includes('interactive')||desc.toLowerCase().includes('terminal ui')||meta?.tags?.some(t=>t.toLowerCase().includes('tui')||t.toLowerCase().includes('interactive'));
+    
+    // Auth detection (penalty but acceptable)
+    const isAuth=desc.toLowerCase().includes('auth')||desc.toLowerCase().includes('authentication')||desc.toLowerCase().includes('login')||desc.toLowerCase().includes('token')||desc.toLowerCase().includes('api key')||meta?.tags?.some(t=>t.toLowerCase().includes('auth')||t.toLowerCase().includes('oauth'));
+    
+    // Complexity (based on install steps count and description length)
+    const complexityScore=(install.length/100)+(desc.length/50);
+    let complexity='low';
+    if(complexityScore>3) complexity='medium';
+    if(complexityScore>6) complexity='high';
+    
+    // Non-interactive/JSON support (very important for agents)
+    const hasJSON=plugin.commands?.some(c=>c.adapterConfig?.parseJson)||desc.toLowerCase().includes('json')||install.includes('json');
+    const isNonInteractive=!isTUI;
+    
+    results.push({
+      name,
+      no_interactive: isNonInteractive ? 'yes' : 'no',
+      go_rust_nodejs: (isGo||isRust||isNode) ? 'yes' : 'no',
+      language: isGo?'go':isRust?'rust':isNode?'nodejs':'other',
+      cli: isCLI ? 'yes' : 'no',
+      tui: isTUI ? 'yes' : 'no',
+      auth_required: isAuth ? 'yes' : 'no',
+      complexity,
+      binary: isBinary ? 'yes' : 'no',
+      json_support: hasJSON ? 'yes' : 'no',
+      description: desc.substring(0,100),
+      install: install.substring(0,80)
+    });
+  }catch(e){
+    console.error('Error parsing',name,e.message);
+  }
+}
+
+// Improved scoring - more balanced, not requiring ALL criteria
+results.forEach(r=>{
+  let score=0;
+  if(r.no_interactive==='yes') score+=3;  // Very important for agents
+  if(r.go_rust_nodejs==='yes') score+=2; // Preferred languages
+  if(r.cli==='yes') score+=2;              // Must be a CLI
+  if(r.tui==='yes') score-=3;              // Strong penalty for TUI
+  if(r.auth_required==='yes') score-=1;   // Penalty but acceptable
+  if(r.binary==='yes') score+=1;           // Bonus, not required
+  if(r.json_support==='yes') score+=2;     // Bonus for agents
+  if(r.complexity==='low') score+=2;       // Prefer simple
+  else if(r.complexity==='medium') score+=1;
+  r.score=score;
+});
+
+// Sort by score descending
+results.sort((a,b)=>b.score-a.score);
+
+// Write CSV
+const header='name,score,no_interactive,go_rust_nodejs,language,cli,tui,auth_required,complexity,binary,json_support,description,install\n';
+const csv=header+results.map(r=>[
+  r.name,
+  r.score,
+  r.no_interactive,
+  r.go_rust_nodejs,
+  r.language,
+  r.cli,
+  r.tui,
+  r.auth_required,
+  r.complexity,
+  r.binary,
+  r.json_support,
+  `"${r.description.replace(/"/g,'""')}"`,
+  `"${r.install.replace(/"/g,'""')}"`
+].join(',')).join('\n');
+
+f.writeFileSync('/tmp/plugin-scores-v2.csv',csv);
+console.log('Analyzed',results.length,'plugins');
+console.log('CSV written to /tmp/plugin-scores-v2.csv');
+console.log('\nTop 50 plugins by score:');
+results.slice(0,50).forEach(r=>console.log(`${r.name}: ${r.score} (${r.language}, tui=${r.tui}, auth=${r.auth_required}, binary=${r.binary})`));
+
+// Count plugins by score ranges
+const highScore=results.filter(r=>r.score>=8).length;
+const medScore=results.filter(r=>r.score>=5&&r.score<8).length;
+const lowScore=results.filter(r=>r.score<5).length;
+console.log(`\nScore distribution:`);
+console.log(`High score (8+): ${highScore}`);
+console.log(`Medium score (5-7): ${medScore}`);
+console.log(`Low score (<5): ${lowScore}`);

package/scripts/enrich-meta-plugins.js

@@ -0,0 +1,67 @@
+const fs = require('fs');
+const path = require('path');
+
+const SCORES_CSV = path.join(__dirname, '..', 'plugin-scores.csv');
+const META_PLUGINS = path.join(__dirname, '..', 'docs', 'meta-plugins.json');
+
+function parseCSV(filePath) {
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lines = content.trim().split('\n');
+  const headers = lines[0].split(',').map(h => h.trim());
+  
+  const scores = {};
+  
+  for (let i = 1; i < lines.length; i++) {
+    const values = lines[i].split(',').map(v => v.trim());
+    const row = {};
+    headers.forEach((header, index) => {
+      row[header] = values[index];
+    });
+    scores[row.name] = row;
+  }
+  
+  return scores;
+}
+
+function enrichMetaPlugins() {
+  const scores = parseCSV(SCORES_CSV);
+  const metaPlugins = JSON.parse(fs.readFileSync(META_PLUGINS, 'utf8'));
+  
+  const enrichedPlugins = metaPlugins.plugins.map(plugin => {
+    const scoreData = scores[plugin.name];
+    
+    if (scoreData) {
+      return {
+        ...plugin,
+        score: {
+          value: parseInt(scoreData.score, 10),
+          no_interactive: scoreData.no_interactive === 'yes',
+          go_rust_nodejs: scoreData.go_rust_nodejs === 'yes',
+          language: scoreData.language,
+          cli: scoreData.cli === 'yes',
+          tui: scoreData.tui === 'yes',
+          auth_required: scoreData.auth_required === 'yes',
+          complexity: scoreData.complexity,
+          binary: scoreData.binary === 'yes',
+          json_support: scoreData.json_support === 'yes',
+          install: scoreData.install
+        }
+      };
+    }
+    
+    return plugin;
+  });
+  
+  const output = {
+    generated: new Date().toISOString(),
+    count: enrichedPlugins.length,
+    plugins: enrichedPlugins
+  };
+  
+  fs.writeFileSync(META_PLUGINS, JSON.stringify(output, null, 2));
+  console.log(`Enriched ${META_PLUGINS} with score metadata`);
+  const pluginsWithScores = enrichedPlugins.filter(p => p.score).length;
+  console.log(`Added scores to ${pluginsWithScores} plugins`);
+}
+
+enrichMetaPlugins();

package/server/app.js

@@ -2,6 +2,8 @@ const express = require("express");
 const path = require("path");
 const { getStorage } = require("./storage/adapter");
 
+const dashboardRouter = require("./routes/dashboard");
+const adaptersRouter = require("./routes/adapters");
 const commandsRouter = require("./routes/commands");
 const configRouter = require("./routes/config");
 const specsRouter = require("./routes/specs");
@@ -24,6 +26,8 @@ app.set("views", path.join(__dirname, "views"));
 app.use("/static", express.static(path.join(__dirname, "public")));
 
 // API routes
+app.use("/api/dashboard", dashboardRouter);
+app.use("/api/adapters", adaptersRouter);
 app.use("/api/config", configRouter);
 app.use("/api/commands", commandsRouter);
 app.use("/api/specs", specsRouter);
@@ -36,14 +40,32 @@ app.use("/api/plugins", pluginsRouter);
 // Tree/command endpoints under /api (config router handles them)
 app.use("/api", configRouter);
 
+app.use("/", dashboardRouter);
+
+// Error handler - return JSON for API requests
+app.use((err, req, res, next) => {
+  if (req.path.startsWith('/api') || req.headers.accept?.includes('application/json')) {
+    res.status(err.status || 500).json({
+      error: {
+        code: err.code || 500,
+        type: err.type || 'internal_error',
+        message: err.message || 'Internal server error',
+        recoverable: !!err.recoverable
+      }
+    });
+  } else {
+    res.status(err.status || 500).render('error', { message: err.message || 'Internal server error' });
+  }
+});
+
 // UI page redirects
-app.get("/", (req, res) => res.redirect("/api/commands"));
 app.get("/commands", (req, res) => res.redirect("/api/commands"));
 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"));
+app.get("/adapters", (req, res) => res.redirect("/api/adapters"));
 
 async function start() {
   try {