monomind 1.9.16 → 1.10.0

package/.claude/skills/mastermind/activity.md

@@ -0,0 +1,191 @@
+---
+name: mastermind-activity
+description: Mastermind activity — full activity feed for an org with event-type filtering, actor lookups, and entity name resolution. Fetches up to 200 recent events across issue, project, goal, agent, and routine entity types. Mirrors Activity.tsx.
+type: domain-skill
+default_mode: auto
+---
+
+# Mastermind Activity
+
+This skill is invoked by `mastermind:activity` or directly via `/mastermind:activity`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org to query (required)
+- `action`: list | filter | export | stats
+- `entity_type`: issue | project | goal | agent | routine | all (default: all)
+- `actor_id`: filter by agent or user id (optional)
+- `limit`: max events to show (default: 50, max: 200)
+- `since`: ISO timestamp — show events after this time (optional)
+- `output_file`: file path to export JSONL (for export action)
+- `caller`: command | master
+
+---
+
+## Event Entity Types
+
+| Type | Description |
+|------|-------------|
+| `issue` | Issue created, status changed, assigned, closed |
+| `project` | Project created, updated, archived |
+| `goal` | Goal created, progress updated, closed |
+| `agent` | Agent started, stopped, errored, completed |
+| `routine` | Routine triggered, run started, run completed |
+| `approval` | Approval requested, approved, rejected |
+| `workspace` | Workspace provisioned, teardown |
+
+---
+
+## 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 Activity Log
+
+```bash
+orgFile=".monomind/orgs/${org_name}.json"
+[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+limit="${limit:-50}"
+entityType="${entity_type:-all}"
+```
+
+---
+
+## Step 2 — Execute Action
+
+### list (default)
+
+```bash
+echo "ACTIVITY — org: $org_name"
+echo "  Filter: type=${entityType}  limit=${limit}${actor_id:+  actor=${actor_id}}${since:+  since=${since}}"
+echo "────────────────────────────────────────────────────────"
+printf "%-20s %-12s %-14s %-24s %s\n" "TIMESTAMP" "ENTITY TYPE" "ACTOR" "ENTITY" "EVENT"
+echo "────────────────────────────────────────────────────────"
+
+if [ ! -f "$activityFile" ]; then
+  # Fall back to mastermind-events.jsonl
+  eventSrc="data/mastermind-events.jsonl"
+  if [ ! -f "$eventSrc" ]; then
+    echo "  No activity log found. Activity is written when agents run."
+    exit 0
+  fi
+  activityFile="$eventSrc"
+fi
+
+tail -${limit} "$activityFile" | while IFS= read -r line; do
+  et=$(echo "$line" | jq -r '.entityType // .type // "unknown"')
+  actor=$(echo "$line" | jq -r '.actorId // .actor // "-"' | cut -c1-12)
+  entity=$(echo "$line" | jq -r '(.entityId // .entity // "-")' | cut -c1-22)
+  event=$(echo "$line" | jq -r '.event // .action // .type // "-"')
+  ts=$(echo "$line" | jq -r '.ts // .timestamp // .createdAt // "-"' | cut -c1-19)
+
+  # Apply filters
+  [ "$entityType" != "all" ] && [ "$et" != "$entityType" ] && continue
+  [ -n "$actor_id" ] && [ "$actor" != "$actor_id" ] && continue
+  [ -n "$since" ] && [ "$ts" \< "$since" ] && continue
+
+  printf "%-20s %-12s %-14s %-24s %s\n" "$ts" "$et" "$actor" "$entity" "$event"
+done
+
+echo ""
+echo "  Showing last $limit events. Use --limit N for more (max 200)."
+```
+
+### filter
+
+```bash
+echo "ACTIVITY FILTER — org: $org_name  type=$entityType"
+echo "────────────────────────────────────────────────────────"
+
+if [ ! -f "$activityFile" ]; then
+  echo "  No activity log found."
+  exit 0
+fi
+
+# Show available entity types in the log
+echo "AVAILABLE ENTITY TYPES IN LOG:"
+tail -200 "$activityFile" | jq -r '.entityType // .type // "unknown"' 2>/dev/null | sort | uniq -c | sort -rn | while read -r cnt et; do
+  printf "  %-20s %d events\n" "$et" "$cnt"
+done
+
+echo ""
+echo "  Filter: /mastermind:activity --org $org_name --action list --entity-type <type>"
+```
+
+### stats
+
+```bash
+echo "ACTIVITY STATS — org: $org_name"
+echo "────────────────────────────────────────────────────────"
+
+if [ ! -f "$activityFile" ]; then
+  echo "  No activity log found."
+  exit 0
+fi
+
+total=$(wc -l < "$activityFile" | tr -d ' ')
+echo "  Total events: $total"
+echo ""
+
+echo "BY ENTITY TYPE:"
+tail -200 "$activityFile" | jq -r '.entityType // .type // "unknown"' 2>/dev/null | sort | uniq -c | sort -rn | \
+  while read -r cnt et; do printf "  %-20s %d\n" "$et" "$cnt"; done
+
+echo ""
+echo "BY ACTOR (top 5):"
+tail -200 "$activityFile" | jq -r '.actorId // .actor // "-"' 2>/dev/null | sort | uniq -c | sort -rn | head -5 | \
+  while read -r cnt actor; do printf "  %-28s %d\n" "$actor" "$cnt"; done
+
+# Last 24h
+cutoff=$(date -u -v-24H +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u --date="24 hours ago" +%Y-%m-%dT%H:%M:%SZ 2>/dev/null)
+last24=$(tail -200 "$activityFile" | jq -r --arg c "$cutoff" 'select((.ts // .timestamp // .createdAt // "") >= $c) | .entityType' 2>/dev/null | wc -l | tr -d ' ')
+echo ""
+echo "  Events in last 24h: $last24"
+```
+
+### export
+
+```bash
+outFile="${output_file:-.monomind/exports/${org_name}-activity-$(date +%Y%m%d%H%M%S).jsonl}"
+mkdir -p "$(dirname "$outFile")"
+
+if [ ! -f "$activityFile" ]; then
+  echo "  No activity log to export."
+  exit 0
+fi
+
+if [ "$entityType" != "all" ]; then
+  jq -r --arg et "$entityType" 'select(.entityType == $et or .type == $et)' "$activityFile" > "$outFile"
+else
+  cp "$activityFile" "$outFile"
+fi
+
+lines=$(wc -l < "$outFile" | tr -d ' ')
+echo "Activity exported: $outFile  ($lines events)"
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name>
+entity_type: <entity_type>
+events_shown: <N>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.

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`.