mastermind-plugin-manager

Mastermind Plugin Manager

This skill is invoked directly via /mastermind-plugin-manager.

Bookkeeping only — not enforced by the Org Runtime. It writes .monomind/plugins/registry.json, which no runtime code reads: installing, enabling, or disabling a plugin here does not load or unload anything.

---

Inputs

• brain_context: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
• action: list | install | uninstall | enable | disable | check-updates
• package_name: npm package name to install (for install; e.g. @monomind/plugin-github)
• plugin_id: plugin id slug (required for uninstall/enable/disable)
• confirm: yes (required second step for uninstall — prevents accidental removal)
• caller: command | master

---

Plugin Record Schema

{
  "id": "plugin-slug",
  "packageName": "@monomind/plugin-name",
  "status": "installed",
  "version": "1.2.0",
  "category": "monitoring",
  "description": "One-line plugin description",
  "installedAt": "2026-01-01T00:00:00Z",
  "config": {},
  "grants": [],
  "health": {"status": "ok", "lastCheck": null}
}

---

Step 0 — Brain Load (standalone only)

If caller is not "command", load brain context following mastermind-protocol/SKILL.md Brain Load Procedure with namespace: ops.

---

Step 1 — Load Plugin Registry

registryFile=".monomind/plugins/registry.json"
mkdir -p ".monomind/plugins"
[ ! -f "$registryFile" ] && echo '{"plugins":[]}' > "$registryFile"

---

Step 2 — Execute Action

list (default)

echo "INSTALLED PLUGINS"
echo "────────────────────────────────────────────────────────"
printf "%-24s %-10s %-10s %-14s %s\n" "ID" "STATUS" "VERSION" "CATEGORY" "PACKAGE"
echo "────────────────────────────────────────────────────────"

count=$(jq '.plugins | length' "$registryFile")
if [ "$count" -eq 0 ]; then
  echo "  No plugins installed."
  echo "  Install one: --action install --package-name @monomind/plugin-github"
else
  jq -r '(.plugins // [])[] |
    [.id, (.status // "installed"), (.version // "-"), (.category // "general"),
     (.packageName // "-")] | @tsv' \
    "$registryFile" | while IFS=$'\t' read -r id st ver cat pkg; do
    printf "%-24s %-10s %-10s %-14s %s\n" "$id" "$st" "$ver" "$cat" "$pkg"
  done

  errCount=$(jq '[(.plugins // [])[] | select(.status == "error")] | length' "$registryFile")
  [ "$errCount" -gt 0 ] && echo "" && echo "  WARNING: $errCount plugin(s) in error state. Run: --action list to inspect."
fi

echo ""
echo "  Install:    --action install --package-name <npm-package>"
echo "  Uninstall:  --action uninstall --plugin-id <id>"
echo "  Settings:   /mastermind-plugin-settings --plugin-id <id>"