superacli 1.13.0 → 1.15.0

package/.devin/config.local.json

@@ -1,7 +1,9 @@
 {
   "permissions": {
     "allow": [
-      "Exec(brew install)"
+      "Exec(brew install)",
+      "Exec(find)",
+      "Exec(python3)"
     ]
   }
 }

package/.github/workflows/catalog.yml

@@ -0,0 +1,39 @@
+name: Update Plugin Catalog
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - "plugins/**"
+      - "scripts/generate-catalog.js"
+
+jobs:
+  generate-catalog:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Generate plugins/catalog.json
+        run: node scripts/generate-catalog.js
+
+      - name: Commit catalog if changed
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add plugins/catalog.json
+          if git diff --cached --quiet; then
+            echo "No catalog changes to commit"
+          else
+            git commit -m "chore: regenerate plugins/catalog.json"
+            git push
+          fi

package/cli/plugins-command.js

@@ -10,6 +10,7 @@ const {
 const { listRegistryPlugins } = require("./plugins-registry")
 const { loadConfig } = require("./config")
 const { getPluginLearn } = require("./plugins-learn")
+const { updatePlugins } = require("./plugins-update")
 
 async function handlePluginsCommand(options) {
   const { positional, flags, humanMode, output, outputHumanTable, outputError } = options
@@ -214,7 +215,33 @@ async function handlePluginsCommand(options) {
     return true
   }
 
-  outputError({ code: 85, type: "invalid_argument", message: "Unknown plugins subcommand. Use: list, explore, install, remove, show, doctor, learn", recoverable: false })
+  if (subcommand === "update") {
+    const checkOnly = flags.check === true || flags.check === "true"
+    const force = flags.force === true || flags.force === "true"
+    try {
+      const result = await updatePlugins({ check: checkOnly, force })
+      if (humanMode) {
+        if (result.up_to_date) {
+          console.log("\n  ✓ Plugins already up to date\n")
+        } else if (checkOnly) {
+          console.log(`\n  Plugin update available: ${result.added} new, ${result.changed} changed\n`)
+          if (result.updated.length > 0) {
+            console.log("  Would update: " + result.updated.slice(0, 10).join(", ") + (result.updated.length > 10 ? ` ... (+${result.updated.length - 10} more)` : ""))
+          }
+          console.log("\n  Run: sc plugins update  (without --check) to apply\n")
+        } else {
+          console.log(`\n  ✓ Updated ${result.extracted} plugins (${result.added} new, ${result.changed} changed)\n`)
+        }
+      } else {
+        output({ ok: true, ...result })
+      }
+    } catch (err) {
+      outputError({ code: err.code || 105, type: err.type || "integration_error", message: err.message, recoverable: err.recoverable !== false, suggestions: err.suggestions })
+    }
+    return true
+  }
+
+  outputError({ code: 85, type: "invalid_argument", message: "Unknown plugins subcommand. Use: list, explore, install, remove, show, doctor, learn, update", recoverable: false })
   return true
 }
 

package/cli/plugins-registry.js

@@ -1,5 +1,6 @@
 const fs = require("fs")
 const path = require("path")
+const { REMOTE_BUNDLED_DIR } = require("./plugins-store")
 
 const REGISTRY_FILE = path.resolve(__dirname, "..", "plugins", "plugins.json")
 const BUNDLED_PLUGINS_DIR = path.resolve(__dirname, "..", "plugins")
@@ -66,11 +67,11 @@ function readMetaFile(metaPath) {
   }
 }
 
-function discoverBundledPlugins() {
-  if (!fs.existsSync(BUNDLED_PLUGINS_DIR)) return []
+function discoverPluginsInDir(dir, sourceType) {
+  if (!fs.existsSync(dir)) return []
   let entries
   try {
-    entries = fs.readdirSync(BUNDLED_PLUGINS_DIR, { withFileTypes: true })
+    entries = fs.readdirSync(dir, { withFileTypes: true })
   } catch {
     return []
   }
@@ -79,12 +80,12 @@ function discoverBundledPlugins() {
 
   for (const entry of entries) {
     if (!entry || !entry.isDirectory()) continue
-    const manifestPath = path.join(BUNDLED_PLUGINS_DIR, entry.name, "plugin.json")
+    const manifestPath = path.join(dir, entry.name, "plugin.json")
     if (!fs.existsSync(manifestPath)) continue
     const manifest = readManifest(manifestPath)
     if (!manifest) continue
 
-    const metaPath = path.join(BUNDLED_PLUGINS_DIR, entry.name, "meta.json")
+    const metaPath = path.join(dir, entry.name, "meta.json")
     const meta = readMetaFile(metaPath)
 
     plugins.push({
@@ -92,7 +93,7 @@ function discoverBundledPlugins() {
       description: meta && typeof meta.description === "string" ? meta.description : (manifest.description || ""),
       tags: meta && Array.isArray(meta.tags) ? meta.tags : (Array.isArray(manifest.tags) ? manifest.tags : []),
       source: {
-        type: "bundled",
+        type: sourceType,
         manifest_path: path.relative(path.resolve(__dirname, ".."), manifestPath).replace(/\\/g, "/")
       },
       has_learn: meta && meta.has_learn === true
@@ -109,6 +110,21 @@ function discoverBundledPlugins() {
   return plugins
 }
 
+function discoverBundledPlugins() {
+  // npm-bundled plugins are the baseline
+  const bundled = discoverPluginsInDir(BUNDLED_PLUGINS_DIR, "bundled")
+  // remote-cached plugins (from sc plugins update) override npm-bundled ones
+  const remote = discoverPluginsInDir(REMOTE_BUNDLED_DIR, "bundled")
+
+  if (remote.length === 0) return bundled
+
+  // remote wins: build map from npm-bundled, then overwrite with remote entries
+  const merged = new Map()
+  for (const p of bundled) merged.set(String(p.name || "").toLowerCase(), p)
+  for (const p of remote) merged.set(String(p.name || "").toLowerCase(), p)
+  return Array.from(merged.values())
+}
+
 function mergedRegistryPlugins() {
   const registry = readRegistry()
   const discovered = discoverBundledPlugins()

package/cli/plugins-store.js

@@ -6,6 +6,8 @@ const SUPERCLI_DIR = path.join(os.homedir(), ".supercli")
 const SUPERCLI_PLUGINS_DIR = path.join(SUPERCLI_DIR, "plugins")
 const SUPERCLI_LOCAL_LOCK_FILE = path.join(SUPERCLI_PLUGINS_DIR, "plugins.lock.json")
 const SUPERCLI_SERVER_LOCK_FILE = path.join(SUPERCLI_PLUGINS_DIR, "server.lock.json")
+const REMOTE_BUNDLED_DIR = path.join(SUPERCLI_PLUGINS_DIR, "bundled")
+const REMOTE_CATALOG_FILE = path.join(SUPERCLI_PLUGINS_DIR, "remote-catalog.json")
 
 const LEGACY_DCLI_DIR = path.join(os.homedir(), ".dcli")
 const LEGACY_PLUGINS_FILE = path.join(LEGACY_DCLI_DIR, "plugins.lock.json")
@@ -104,6 +106,8 @@ module.exports = {
   SUPERCLI_PLUGINS_DIR,
   SUPERCLI_LOCAL_LOCK_FILE,
   SUPERCLI_SERVER_LOCK_FILE,
+  REMOTE_BUNDLED_DIR,
+  REMOTE_CATALOG_FILE,
   LEGACY_PLUGINS_FILE,
   readPluginsLock,
   writePluginsLock,

package/cli/plugins-update.js

@@ -0,0 +1,204 @@
+"use strict"
+
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+const { spawnSync } = require("child_process")
+const { REMOTE_BUNDLED_DIR, REMOTE_CATALOG_FILE } = require("./plugins-store")
+
+const GITHUB_REPO = "javimosch/supercli"
+const CATALOG_URL = `https://raw.githubusercontent.com/${GITHUB_REPO}/master/plugins/catalog.json`
+const TARBALL_URL = `https://github.com/${GITHUB_REPO}/archive/refs/heads/master.tar.gz`
+const FETCH_TIMEOUT_MS = 15000
+
+function readLocalCatalog() {
+  try {
+    if (!fs.existsSync(REMOTE_CATALOG_FILE)) return null
+    const parsed = JSON.parse(fs.readFileSync(REMOTE_CATALOG_FILE, "utf-8"))
+    if (!parsed || typeof parsed !== "object") return null
+    return parsed
+  } catch {
+    return null
+  }
+}
+
+function writeLocalCatalog(catalog) {
+  const dir = path.dirname(REMOTE_CATALOG_FILE)
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+  fs.writeFileSync(REMOTE_CATALOG_FILE, JSON.stringify(catalog, null, 2) + "\n")
+}
+
+async function fetchWithTimeout(url, options = {}) {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS)
+  try {
+    const res = await fetch(url, { ...options, signal: controller.signal })
+    return res
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+async function fetchRemoteCatalog() {
+  const res = await fetchWithTimeout(CATALOG_URL)
+  if (!res.ok) {
+    throw Object.assign(new Error(`Failed to fetch plugin catalog: ${res.status} ${res.statusText}`), {
+      code: 105,
+      type: "integration_error",
+      recoverable: true,
+      suggestions: ["Check your internet connection and retry"]
+    })
+  }
+  const catalog = await res.json()
+  if (!catalog || !Array.isArray(catalog.plugins)) {
+    throw Object.assign(new Error("Invalid remote catalog format"), {
+      code: 105,
+      type: "integration_error",
+      recoverable: true
+    })
+  }
+  return catalog
+}
+
+function diffCatalogs(local, remote) {
+  const localMap = new Map()
+  if (local && Array.isArray(local.plugins)) {
+    for (const p of local.plugins) localMap.set(p.name, p.checksum)
+  }
+
+  const added = []
+  const changed = []
+  const unchanged = []
+
+  for (const p of remote.plugins) {
+    const localChecksum = localMap.get(p.name)
+    if (!localChecksum) {
+      added.push(p.name)
+    } else if (localChecksum !== p.checksum) {
+      changed.push(p.name)
+    } else {
+      unchanged.push(p.name)
+    }
+  }
+
+  return { added, changed, unchanged }
+}
+
+function downloadTarball(tmpDir) {
+  const tarPath = path.join(tmpDir, "supercli-master.tar.gz")
+  const res = spawnSync("curl", [
+    "-fsSL",
+    "--max-time", "60",
+    "-o", tarPath,
+    TARBALL_URL
+  ], { encoding: "utf-8", timeout: 60000 })
+
+  if (res.error) {
+    throw Object.assign(new Error(`Failed to download plugin archive: ${res.error.message}`), {
+      code: 105,
+      type: "integration_error",
+      recoverable: true,
+      suggestions: ["Ensure curl is installed and your internet connection is working"]
+    })
+  }
+  if (res.status !== 0) {
+    throw Object.assign(new Error(`curl exited with status ${res.status}: ${(res.stderr || "").trim()}`), {
+      code: 105,
+      type: "integration_error",
+      recoverable: true
+    })
+  }
+  if (!fs.existsSync(tarPath) || fs.statSync(tarPath).size === 0) {
+    throw Object.assign(new Error("Downloaded archive is empty"), {
+      code: 105,
+      type: "integration_error",
+      recoverable: true
+    })
+  }
+  return tarPath
+}
+
+function extractPluginsFromTarball(tarPath, pluginNames, destDir) {
+  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true })
+
+  // Extract in batches of 200 to avoid arg-list limits; exact paths (no wildcards)
+  // so tar exits 0 when paths are found and skips gracefully when not
+  const BATCH = 200
+  for (let i = 0; i < pluginNames.length; i += BATCH) {
+    const batch = pluginNames.slice(i, i + BATCH)
+    const paths = batch.map(n => `supercli-master/plugins/${n}`)
+    const args = [
+      "-xzf", tarPath,
+      "-C", destDir,
+      "--strip-components=2",  // strips "supercli-master/plugins" → plugin dir lands in destDir
+      ...paths
+    ]
+
+    const res = spawnSync("tar", args, { encoding: "utf-8", timeout: 30000 })
+
+    if (res.error) {
+      throw Object.assign(new Error(`Failed to extract plugin archive: ${res.error.message}`), {
+        code: 105,
+        type: "integration_error",
+        recoverable: true,
+        suggestions: ["Ensure tar is installed"]
+      })
+    }
+    // exit 2 means some paths were not found in archive — tolerable when
+    // catalog is slightly out of sync with tarball (e.g. gitignored dirs)
+    if (res.status !== 0 && res.status !== 2) {
+      throw Object.assign(new Error(`tar exited with status ${res.status}: ${(res.stderr || "").trim()}`), {
+        code: 105,
+        type: "integration_error",
+        recoverable: true
+      })
+    }
+  }
+}
+
+/**
+ * Main entry point.
+ *
+ * @param {object} options
+ * @param {boolean} [options.check]  - dry-run only, no writes
+ * @param {boolean} [options.force]  - ignore local catalog, update everything
+ * @returns {Promise<object>} result summary
+ */
+async function updatePlugins(options = {}) {
+  const { check = false, force = false } = options
+
+  const localCatalog = force ? null : readLocalCatalog()
+  const remoteCatalog = await fetchRemoteCatalog()
+  const diff = diffCatalogs(localCatalog, remoteCatalog)
+
+  const toUpdate = [...diff.added, ...diff.changed]
+
+  const result = {
+    remote_count: remoteCatalog.plugins.length,
+    added: diff.added.length,
+    changed: diff.changed.length,
+    unchanged: diff.unchanged.length,
+    updated: toUpdate,
+    check_only: check,
+    up_to_date: toUpdate.length === 0,
+  }
+
+  if (check || toUpdate.length === 0) {
+    return result
+  }
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "supercli-update-"))
+  try {
+    const tarPath = downloadTarball(tmpDir)
+    extractPluginsFromTarball(tarPath, toUpdate, REMOTE_BUNDLED_DIR)
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true })
+  }
+
+  writeLocalCatalog(remoteCatalog)
+  result.extracted = toUpdate.length
+
+  return result
+}
+
+module.exports = { updatePlugins }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superacli",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Config-driven, AI-friendly dynamic CLI",
   "license": "MIT",
   "main": "server/app.js",

package/plugins/agentmemory-cli/install-guidance.json

@@ -0,0 +1,11 @@
+{
+  "plugin": "agentmemory-cli",
+  "binary": "agentmemory-cli",
+  "check": "which agentmemory-cli",
+  "install_steps": [
+    "curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64",
+    "chmod +x agentmemory-cli-linux-amd64 && mv agentmemory-cli-linux-amd64 ~/.local/bin/agentmemory-cli",
+    "supercli plugins install ./plugins/agentmemory-cli --on-conflict replace --json"
+  ],
+  "note": "Standalone binary, zero dependencies. Stores data in ~/.agentmemory/memory.db. Supports --json output for programmatic use. Re-implemented from rohitg00/agentmemory as a headless CLI for AI agent memory persistence."
+}

package/plugins/agentmemory-cli/meta.json

@@ -0,0 +1,5 @@
+{
+  "description": "Persistent memory for AI coding agents — save, search, and recall context across sessions from the command line. Zero external dependencies, SQLite-backed, Bun.js compiled binary. Supports projects, tags, full-text search, and JSON output. Inspired by agentmemory (rohitg00/agentmemory) but re-implemented as a headless CLI.",
+  "tags": ["agentmemory", "memory", "ai", "persistence", "context", "cli"],
+  "has_learn": true
+}

package/plugins/agentmemory-cli/plugin.json

@@ -0,0 +1,193 @@
+{
+  "name": "agentmemory-cli",
+  "version": "0.1.0",
+  "description": "Persistent memory for AI coding agents \u2014 save, search, and recall context across sessions",
+  "source": "https://github.com/javimosch/agentmemory-cli",
+  "checks": [
+    {
+      "type": "binary",
+      "name": "agentmemory-cli"
+    }
+  ],
+  "install_guidance": {
+    "plugin": "agentmemory-cli",
+    "binary": "agentmemory-cli",
+    "check": "which agentmemory-cli",
+    "install_steps": [
+      "curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64",
+      "chmod +x agentmemory-cli-linux-amd64 && mv agentmemory-cli-linux-amd64 ~/.local/bin/agentmemory-cli",
+      "Verify: agentmemory-cli --version",
+      "supercli plugins install ./plugins/agentmemory-cli --on-conflict replace --json"
+    ]
+  },
+  "learn": {
+    "file": "skills/quickstart/SKILL.md"
+  },
+  "commands": [
+    {
+      "namespace": "agentmemory-cli",
+      "resource": "memory",
+      "action": "save",
+      "description": "Save a memory (usage: save --text <text> [--project <p>] [--tags <t>])",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "agentmemory-cli",
+        "baseArgs": [
+          "save"
+        ],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 10000,
+        "missingDependencyHelp": "Install: curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64 && chmod +x && mv ~/.local/bin/agentmemory-cli"
+      },
+      "args": [
+        {
+          "name": "text",
+          "type": "string",
+          "required": false,
+          "description": "Memory text content (-text)"
+        },
+        {
+          "name": "project",
+          "type": "string",
+          "required": false,
+          "description": "Project name (--project)"
+        },
+        {
+          "name": "tags",
+          "type": "string",
+          "required": false,
+          "description": "Tags (--tags)"
+        }
+      ]
+    },
+    {
+      "namespace": "agentmemory-cli",
+      "resource": "_",
+      "action": "_",
+      "description": "Passthrough mode for other commands",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "agentmemory-cli",
+        "cwd": "invoke_cwd",
+        "passthrough": true,
+        "timeout_ms": 30000,
+        "missingDependencyHelp": "Install: curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64 && chmod +x && mv ~/.local/bin/agentmemory-cli"
+      },
+      "args": []
+    },
+    {
+      "namespace": "agentmemory-cli",
+      "resource": "memory",
+      "action": "search",
+      "description": "Search memories (usage: search --query <q> [--project <p>] [--limit <n>])",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "agentmemory-cli",
+        "baseArgs": [
+          "search"
+        ],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 10000,
+        "missingDependencyHelp": "Install: curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64 && chmod +x && mv ~/.local/bin/agentmemory-cli"
+      },
+      "args": [
+        {
+          "name": "query",
+          "type": "string",
+          "required": false,
+          "description": "Search query (--query)"
+        },
+        {
+          "name": "project",
+          "type": "string",
+          "required": false,
+          "description": "Filter by project (--project)"
+        },
+        {
+          "name": "limit",
+          "type": "string",
+          "required": false,
+          "description": "Max results (--limit)"
+        }
+      ]
+    },
+    {
+      "namespace": "agentmemory-cli",
+      "resource": "memory",
+      "action": "list",
+      "description": "List recent memories",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "agentmemory-cli",
+        "baseArgs": [
+          "list"
+        ],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 10000,
+        "missingDependencyHelp": "Install: curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64 && chmod +x && mv ~/.local/bin/agentmemory-cli"
+      },
+      "args": [
+        {
+          "name": "project",
+          "type": "string",
+          "required": false,
+          "description": "Filter by project (--project)"
+        },
+        {
+          "name": "limit",
+          "type": "string",
+          "required": false,
+          "description": "Max results (--limit)"
+        }
+      ]
+    },
+    {
+      "namespace": "agentmemory-cli",
+      "resource": "memory",
+      "action": "forget",
+      "description": "Delete a memory by ID",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "agentmemory-cli",
+        "baseArgs": [
+          "forget"
+        ],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 10000,
+        "missingDependencyHelp": "Install: curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64 && chmod +x && mv ~/.local/bin/agentmemory-cli"
+      },
+      "args": [
+        {
+          "name": "id",
+          "type": "string",
+          "required": false,
+          "description": "Memory ID (--id)"
+        }
+      ]
+    },
+    {
+      "namespace": "agentmemory-cli",
+      "resource": "memory",
+      "action": "stats",
+      "description": "Show memory statistics",
+      "adapter": "process",
+      "adapterConfig": {
+        "command": "agentmemory-cli",
+        "baseArgs": [
+          "profile"
+        ],
+        "cwd": "invoke_cwd",
+        "timeout_ms": 10000,
+        "missingDependencyHelp": "Install: curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64 && chmod +x && mv ~/.local/bin/agentmemory-cli"
+      },
+      "args": [
+        {
+          "name": "project",
+          "type": "string",
+          "required": false,
+          "description": "Filter by project (--project)"
+        }
+      ]
+    }
+  ]
+}

package/plugins/agentmemory-cli/skills/quickstart/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: agentmemory-cli
+description: Use this skill when the user needs to save, search, or recall persistent context across AI coding sessions — remembering decisions, patterns, and project knowledge.
+---
+
+# agentmemory-cli — Persistent Memory for AI Coding Agents
+
+Save and recall context across sessions from the command line. Zero dependencies, SQLite-backed.
+
+## Installation
+
+```bash
+curl -LO https://github.com/javimosch/agentmemory-cli/releases/latest/download/agentmemory-cli-linux-amd64
+chmod +x agentmemory-cli-linux-amd64
+mv agentmemory-cli-linux-amd64 ~/.local/bin/agentmemory-cli
+```
+
+## Commands
+
+- `agentmemory-cli memory save <text> --project <name> --tags <a,b,c>` — Save a memory
+- `agentmemory-cli memory search <query> --project <name>` — Search memories
+- `agentmemory-cli memory list --limit <n>` — List recent memories
+- `agentmemory-cli memory forget <id>` — Delete by ID
+- `agentmemory-cli memory stats` — Show memory statistics
+- `agentmemory-cli _ _ demo` — Seed demo data
+
+## Usage Examples
+
+- "Save this: JWT auth uses jose middleware in src/middleware/auth.ts with project myapp and tags auth,jwt"
+- "Search for database optimization patterns"
+- "What did we decide about the API structure?"
+- "Show me all memories related to deployment"
+
+## Key Features
+- Full-text search with LIKE fallback
+- Projects and tags for organization
+- JSON output (--json) for scripting
+- Zero external dependencies (compiled binary)
+- Data stored in ~/.agentmemory/memory.db