@monoes/monomindcli 1.9.17 → 1.10.0

package/.claude/skills/mastermind/adapter-manager.md

@@ -0,0 +1,259 @@
+---
+name: mastermind-adapter-manager
+description: Mastermind adapter-manager — global instance-level adapter catalog. Lists all built-in and npm-installed adapters, enables/disables them in menus, reinstalls from npm to pick up updates, adds custom HTTP adapters, and removes custom ones. Complements mastermind:adapters (per-org) with the global registry. Mirrors AdapterManager.tsx.
+type: domain-skill
+default_mode: confirm
+---
+
+# Mastermind Adapter Manager
+
+This skill is invoked by `mastermind:adapter-manager` or directly via `/mastermind:adapter-manager`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `action`: list | enable | disable | reinstall | add-http | remove | check-update
+- `adapter_type`: adapter type slug (required for enable/disable/reinstall/remove)
+- `http_url`: base URL for the HTTP adapter endpoint (for add-http)
+- `http_name`: display name for the HTTP adapter (for add-http)
+- `http_label`: short label (for add-http; default: http_name)
+- `caller`: command | master
+
+---
+
+## Adapter Registry Fields
+
+```json
+{
+  "type": "adapter-slug",
+  "label": "Display Name",
+  "source": "built-in | npm | http",
+  "packageName": "@paperclipai/adapter-name",
+  "version": "1.2.0",
+  "modelsCount": 3,
+  "disabled": false,
+  "isBuiltIn": true,
+  "installedAt": "2026-01-01T00:00:00Z"
+}
+```
+
+---
+
+## Built-in Adapter Types
+
+| Type | Label | Notes |
+|------|-------|-------|
+| `claude-local` | Claude (local CLI) | Default |
+| `gemini-local` | Gemini (local) | |
+| `codex-local` | Codex (OpenAI Codex CLI) | |
+| `cursor` | Cursor IDE | |
+| `opencode-local` | OpenCode | |
+| `hermes-local` | Hermes (Ollama) | |
+| `http` | Custom HTTP | Configurable endpoint |
+| `acpx` | ACPX Protocol | |
+
+---
+
+## Step 0 — Brain Load (standalone only)
+
+If `caller` is not "command", load brain context following _protocol.md Brain Load Procedure with namespace: `ops`.
+
+---
+
+## Step 1 — Load Global Adapter Registry
+
+```bash
+adapterFile=".monomind/adapters/registry.json"
+mkdir -p ".monomind/adapters"
+if [ ! -f "$adapterFile" ]; then
+  cat > "$adapterFile" <<'EOF'
+{
+  "adapters": [
+    {"type":"claude-local","label":"Claude (local CLI)","source":"built-in","isBuiltIn":true,"disabled":false,"modelsCount":3},
+    {"type":"gemini-local","label":"Gemini (local)","source":"built-in","isBuiltIn":true,"disabled":false,"modelsCount":2},
+    {"type":"codex-local","label":"Codex (OpenAI)","source":"built-in","isBuiltIn":true,"disabled":false,"modelsCount":3},
+    {"type":"cursor","label":"Cursor IDE","source":"built-in","isBuiltIn":true,"disabled":false,"modelsCount":1},
+    {"type":"opencode-local","label":"OpenCode","source":"built-in","isBuiltIn":true,"disabled":false,"modelsCount":1},
+    {"type":"hermes-local","label":"Hermes (Ollama)","source":"built-in","isBuiltIn":true,"disabled":false,"modelsCount":1},
+    {"type":"http","label":"Custom HTTP","source":"built-in","isBuiltIn":true,"disabled":true,"modelsCount":0},
+    {"type":"acpx","label":"ACPX Protocol","source":"built-in","isBuiltIn":true,"disabled":true,"modelsCount":0}
+  ]
+}
+EOF
+fi
+```
+
+---
+
+## Step 2 — Execute Action
+
+### list (default)
+
+```bash
+echo "GLOBAL ADAPTER REGISTRY"
+echo "────────────────────────────────────────────────────────"
+printf "%-20s %-22s %-10s %-8s %-8s %s\n" "TYPE" "LABEL" "SOURCE" "MODELS" "STATUS" "VERSION"
+echo "────────────────────────────────────────────────────────"
+
+jq -r '.adapters[] |
+  [.type, (.label // .type), (.source // "built-in"),
+   ((.modelsCount // 0) | tostring),
+   (if .disabled then "disabled" else "enabled" end),
+   (.version // "-")] | @tsv' \
+  "$adapterFile" | while IFS=$'\t' read -r type label src models status ver; do
+  printf "%-20s %-22s %-10s %-8s %-8s %s\n" "$type" "$label" "$src" "$models" "$status" "$ver"
+done
+
+total=$(jq '.adapters | length' "$adapterFile")
+enabled=$(jq '[.adapters[] | select(.disabled == false or .disabled == null)] | length' "$adapterFile")
+echo ""
+echo "  Total: $total  |  Enabled: $enabled  |  Disabled: $((total - enabled))"
+echo ""
+echo "  To add a custom HTTP adapter: --action add-http --http-url http://localhost:8080 --http-name 'My Model'"
+```
+
+### enable
+
+```bash
+[ -z "$adapter_type" ] && { echo "ERROR: --adapter-type required."; exit 1; }
+
+exists=$(jq -r --arg t "$adapter_type" '[.adapters[] | select(.type == $t)] | length' "$adapterFile")
+[ "$exists" -eq 0 ] && { echo "ERROR: Adapter '$adapter_type' not found. Use --action list to see available adapters."; exit 1; }
+
+tmp="${adapterFile}.tmp"
+jq --arg t "$adapter_type" \
+  '.adapters = [.adapters[] | if .type == $t then .disabled = false else . end]' \
+  "$adapterFile" > "$tmp" && mv "$tmp" "$adapterFile"
+
+echo "Adapter '$adapter_type' ENABLED — will appear in agent model menus."
+```
+
+### disable
+
+```bash
+[ -z "$adapter_type" ] && { echo "ERROR: --adapter-type required."; exit 1; }
+
+isBuiltIn=$(jq -r --arg t "$adapter_type" '.adapters[] | select(.type == $t) | .isBuiltIn // false' "$adapterFile")
+
+tmp="${adapterFile}.tmp"
+jq --arg t "$adapter_type" \
+  '.adapters = [.adapters[] | if .type == $t then .disabled = true else . end]' \
+  "$adapterFile" > "$tmp" && mv "$tmp" "$adapterFile"
+
+echo "Adapter '$adapter_type' DISABLED — hidden from model menus."
+[ "$isBuiltIn" = "true" ] && echo "  NOTE: Built-in adapter disabled but not removed. Re-enable with --action enable."
+```
+
+### reinstall
+
+```bash
+[ -z "$adapter_type" ] && { echo "ERROR: --adapter-type required."; exit 1; }
+
+pkg=$(jq -r --arg t "$adapter_type" '.adapters[] | select(.type == $t) | .packageName // ""' "$adapterFile")
+[ -z "$pkg" ] && { echo "ERROR: Adapter '$adapter_type' has no packageName — cannot reinstall. Only npm-installed adapters support reinstall."; exit 1; }
+
+echo "REINSTALL — $adapter_type from $pkg"
+echo "────────────────────────────────────────────────────────"
+echo "  Running: npm install $pkg"
+
+if npm install "$pkg" 2>&1 | tail -5; then
+  newVer=$(node -e "try{console.log(require('$pkg/package.json').version)}catch(e){console.log('unknown')}" 2>/dev/null)
+  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  tmp="${adapterFile}.tmp"
+  jq --arg t "$adapter_type" --arg v "$newVer" --arg ts "$ts" \
+    '.adapters = [.adapters[] | if .type == $t then .version = $v | .reinstalledAt = $ts else . end]' \
+    "$adapterFile" > "$tmp" && mv "$tmp" "$adapterFile"
+  echo "  Reinstalled: $adapter_type @ $newVer"
+else
+  echo "  ERROR: npm install failed. Check your network and package name."
+fi
+```
+
+### add-http
+
+```bash
+[ -z "$http_url" ] && { echo "ERROR: --http-url required (e.g. http://localhost:8080)."; exit 1; }
+[ -z "$http_name" ] && { echo "ERROR: --http-name required (display name for this adapter)."; exit 1; }
+
+# Validate URL
+echo "$http_url" | grep -qE '^https?://' || { echo "ERROR: --http-url must start with http:// or https://"; exit 1; }
+
+# Generate slug from name
+slug=$(echo "${http_name}" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '-' | sed 's/^-//;s/-$//')
+slug="http-${slug}"
+
+# Check for duplicate
+dup=$(jq -r --arg t "$slug" '[.adapters[] | select(.type == $t)] | length' "$adapterFile")
+[ "$dup" -gt 0 ] && { echo "ERROR: Adapter slug '$slug' already exists. Remove first: --action remove --adapter-type $slug"; exit 1; }
+
+ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+tmp="${adapterFile}.tmp"
+jq --arg type "$slug" \
+   --arg label "${http_label:-$http_name}" \
+   --arg url "$http_url" \
+   --arg ts "$ts" \
+  '.adapters += [{"type":$type,"label":$label,"source":"http","isBuiltIn":false,"disabled":false,"modelsCount":0,"httpUrl":$url,"installedAt":$ts}]' \
+  "$adapterFile" > "$tmp" && mv "$tmp" "$adapterFile"
+
+echo "HTTP adapter added: $slug"
+echo "  Label:   ${http_label:-$http_name}"
+echo "  URL:     $http_url"
+echo "  Slug:    $slug"
+echo "  Status:  enabled"
+```
+
+### remove
+
+```bash
+[ -z "$adapter_type" ] && { echo "ERROR: --adapter-type required."; exit 1; }
+
+isBuiltIn=$(jq -r --arg t "$adapter_type" '.adapters[] | select(.type == $t) | .isBuiltIn // false' "$adapterFile")
+[ "$isBuiltIn" = "true" ] && { echo "ERROR: Cannot remove built-in adapter '$adapter_type'. Use --action disable instead."; exit 1; }
+
+tmp="${adapterFile}.tmp"
+jq --arg t "$adapter_type" \
+  '.adapters = [.adapters[] | select(.type != $t)]' \
+  "$adapterFile" > "$tmp" && mv "$tmp" "$adapterFile"
+
+echo "Adapter '$adapter_type' removed from registry."
+```
+
+### check-update
+
+```bash
+echo "CHECKING FOR ADAPTER UPDATES"
+echo "────────────────────────────────────────────────────────"
+
+jq -r '.adapters[] | select(.packageName != null and .packageName != "") |
+  [.type, .packageName, (.version // "unknown")] | @tsv' \
+  "$adapterFile" | while IFS=$'\t' read -r type pkg ver; do
+  latest=$(curl -sf "https://registry.npmjs.org/${pkg}/latest" 2>/dev/null | jq -r '.version // "?"' 2>/dev/null || echo "?")
+  if [ "$latest" != "?" ] && [ "$latest" != "$ver" ]; then
+    echo "  [$type]  $ver  →  $latest  (update available: npm install $pkg)"
+  else
+    echo "  [$type]  $ver  (up to date)"
+  fi
+done
+
+npmCount=$(jq '[.adapters[] | select(.packageName != null)] | length' "$adapterFile")
+[ "$npmCount" -eq 0 ] && echo "  No npm-installed adapters to check."
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+adapter_type: <type>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.

package/.claude/skills/mastermind/adapters.md

@@ -0,0 +1,204 @@
+---
+name: mastermind-adapters
+description: Mastermind adapters — install, enable, disable, reload, and remove LLM adapter plugins per org. Supports claude-local, gemini-local, codex-local, cursor, hermes, http, and custom adapters.
+type: domain-skill
+default_mode: confirm
+---
+
+# Mastermind Adapters
+
+This skill is invoked by `mastermind:adapters` or directly via `/mastermind:adapters`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org to manage adapters for (required)
+- `action`: list | enable | disable | install | remove | reload | set-default
+- `adapter_type`: adapter slug (e.g. `claude-local`, `gemini-local`, `http`) — required for most actions
+- `package_name`: npm package name or local path (required for `install`)
+- `caller`: command | master
+
+---
+
+## Step 0 — Brain Load (standalone only)
+
+If `caller` is not "command", load brain context following _protocol.md Brain Load Procedure with namespace: `ops`.
+
+---
+
+## Built-in Adapter Registry
+
+| Type | Label | Source | Notes |
+|------|-------|--------|-------|
+| `claude-local` | Claude (local CLI) | built-in | Uses `claude` CLI |
+| `claude-opus-4-7` | Claude Opus 4.7 | built-in | High capability |
+| `claude-sonnet-4-6` | Claude Sonnet 4.6 | built-in | Balanced (default) |
+| `claude-haiku-4-5` | Claude Haiku 4.5 | built-in | Fast, low cost |
+| `gemini-local` | Gemini (local) | built-in | Uses `gemini` CLI |
+| `codex-local` | Codex (local) | built-in | Uses `codex` CLI |
+| `cursor` | Cursor | built-in | Uses Cursor agent |
+| `hermes-local` | Hermes (local) | built-in | Local Hermes LLM |
+| `http` | HTTP Adapter | built-in | Generic HTTP endpoint |
+| `acpx-local` | ACPX (local) | built-in | ACPX protocol |
+
+---
+
+## Step 1 — Load Adapter Registry
+
+```bash
+orgFile=".monomind/orgs/${org_name}.json"
+[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
+
+adaptersFile=".monomind/orgs/${org_name}-adapters.json"
+if [ ! -f "$adaptersFile" ]; then
+  # Bootstrap from org config adapter_config if present
+  defaultModel=$(jq -r '.run_config.ceo_adapter // "claude-sonnet-4-6"' "$orgFile")
+  cat > "$adaptersFile" <<EOF
+{
+  "org": "${org_name}",
+  "default_adapter": "${defaultModel}",
+  "adapters": [
+    {"type":"claude-local","label":"Claude (local CLI)","source":"built-in","disabled":false,"modelsCount":3},
+    {"type":"gemini-local","label":"Gemini (local)","source":"built-in","disabled":false,"modelsCount":1},
+    {"type":"http","label":"HTTP Adapter","source":"built-in","disabled":true,"modelsCount":0}
+  ]
+}
+EOF
+fi
+```
+
+---
+
+## Step 2 — Execute Action
+
+### list (default)
+
+```bash
+echo "ADAPTERS — org: $org_name"
+echo "──────────────────────────────────────────────────────"
+printf "%-22s %-28s %-10s %-8s %s\n" "TYPE" "LABEL" "SOURCE" "MODELS" "STATUS"
+echo "──────────────────────────────────────────────────────"
+
+defaultAdap=$(jq -r '.default_adapter // "claude-sonnet-4-6"' "$adaptersFile")
+
+jq -r --arg def "$defaultAdap" '
+  .adapters[] |
+  [.type, (.label // .type), (.source // "built-in"), (.modelsCount // 0 | tostring),
+   (if .disabled then "DISABLED" else "ACTIVE" end),
+   (if .type == $def then " ← default" else "" end)]
+  | @tsv
+' "$adaptersFile" | while IFS=$'\t' read -r type label source models status def; do
+  printf "%-22s %-28s %-10s %-8s %s%s\n" "$type" "$label" "$source" "$models" "$status" "$def"
+done
+
+echo ""
+echo "Default adapter: $defaultAdap"
+echo "External adapters: $(jq '[.adapters[] | select(.source == "external")] | length' "$adaptersFile")"
+```
+
+### enable / disable
+
+```bash
+action_status=$([ "$action" = "enable" ] && echo "false" || echo "true")
+tmp="${adaptersFile}.tmp"
+jq --arg type "$adapter_type" --argjson dis "$action_status" \
+  '.adapters = [.adapters[] | if .type == $type then .disabled = $dis else . end]' \
+  "$adaptersFile" > "$tmp" && mv "$tmp" "$adaptersFile"
+
+# If re-enabling, also check org config adapter_config for matching roles
+echo "Adapter '$adapter_type' → $([ "$action" = "enable" ] && echo 'ACTIVE' || echo 'DISABLED')"
+```
+
+### install
+
+Add an external adapter (npm package or local path):
+
+```bash
+[ -z "$package_name" ] && { echo "ERROR: --package-name required."; exit 1; }
+[ -z "$adapter_type" ] && adapter_type=$(echo "$package_name" | sed 's/[@/].*$//' | tr '-' '_')
+
+isLocal=false
+[[ "$package_name" == /* || "$package_name" == "./"* ]] && isLocal=true
+
+tmp="${adaptersFile}.tmp"
+jq --arg type "$adapter_type" \
+   --arg pkg "$package_name" \
+   --argjson local "$isLocal" \
+   '.adapters = [.adapters[] | select(.type != $type)] +
+    [{"type":$type,"label":$pkg,"source":"external","packageName":$pkg,"isLocalPath":$local,
+      "disabled":false,"modelsCount":0,"installedAt":(now|todate)}]' \
+  "$adaptersFile" > "$tmp" && mv "$tmp" "$adaptersFile"
+echo "Installed: $package_name as adapter type '$adapter_type'"
+echo "NOTE: Restart the org run to activate the new adapter."
+```
+
+Emit `org:adapter:installed` event:
+
+```bash
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+CTRL_URL=$(jq -r '.url // "http://localhost:4242"' "$REPO_ROOT/.monomind/control.json" 2>/dev/null || echo "http://localhost:4242")
+curl -s -X POST "${CTRL_URL}/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -cn --arg org "$org_name" --arg type "$adapter_type" --arg pkg "$package_name" \
+    '{type:"org:adapter:installed",org:$org,adapter:$type,package:$pkg,ts:(now*1000|floor)}')" || true
+```
+
+### remove
+
+```bash
+[ -z "$adapter_type" ] && { echo "ERROR: --adapter-type required."; exit 1; }
+
+# Verify it's external
+src=$(jq -r --arg t "$adapter_type" '.adapters[] | select(.type == $t) | .source' "$adaptersFile" 2>/dev/null)
+[ "$src" = "built-in" ] && { echo "ERROR: Cannot remove built-in adapters. Use 'disable' instead."; exit 1; }
+[ -z "$src" ] && { echo "ERROR: Adapter '$adapter_type' not found."; exit 1; }
+
+tmp="${adaptersFile}.tmp"
+jq --arg type "$adapter_type" '.adapters = [.adapters[] | select(.type != $type)]' \
+  "$adaptersFile" > "$tmp" && mv "$tmp" "$adaptersFile"
+echo "Removed adapter: $adapter_type"
+```
+
+### set-default
+
+```bash
+[ -z "$adapter_type" ] && { echo "ERROR: --adapter-type required."; exit 1; }
+tmp="${adaptersFile}.tmp"
+jq --arg type "$adapter_type" '.default_adapter = $type' "$adaptersFile" > "$tmp" && mv "$tmp" "$adaptersFile"
+# Sync to org run_config as well
+orgTmp="${orgFile}.tmp"
+jq --arg model "$adapter_type" '.run_config.ceo_adapter = $model' "$orgFile" > "$orgTmp" && mv "$orgTmp" "$orgFile"
+echo "Default adapter set to: $adapter_type"
+```
+
+### reload
+
+Force a reload hint (marks adapter as needing restart):
+
+```bash
+tmp="${adaptersFile}.tmp"
+jq --arg type "$adapter_type" --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+  '.adapters = [.adapters[] | if .type == $type then .last_reload = $ts else . end]' \
+  "$adaptersFile" > "$tmp" && mv "$tmp" "$adaptersFile"
+echo "Marked adapter '$adapter_type' for reload. Restart the org run to apply."
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name>
+adapter_type: <adapter_type if applicable>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.