monomind 1.16.6 → 1.16.7

package/packages/@monomind/cli/.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`.

package/packages/@monomind/cli/.claude/skills/mastermind/agent-detail.md

@@ -0,0 +1,242 @@
+---
+name: mastermind-agent-detail
+description: Mastermind agent-detail — deep per-agent inspection: show config, run history, budget usage, heartbeat status, assigned skills, and reset/reconfigure a single agent within an org.
+type: domain-skill
+default_mode: auto
+---
+
+# Mastermind Agent Detail
+
+This skill is invoked by `mastermind:agent-detail` or directly via `/mastermind:agent-detail`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org the agent belongs to (required)
+- `agent_id`: agent slug/id (required)
+- `action`: show | runs | config | budget | heartbeat | skills | reset
+- `days`: lookback window for run history (default 7)
+- `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`.
+
+---
+
+## Step 1 — Load Agent Data
+
+```bash
+orgFile=".monomind/orgs/${org_name}.json"
+[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
+
+agentDef=$(jq -r --arg id "$agent_id" '(.roles // [])[] | select(.id == $id)' "$orgFile")
+[ -z "$agentDef" ] && { echo "ERROR: Agent '$agent_id' not found in org '$org_name'."; exit 1; }
+
+stateFile=".monomind/orgs/${org_name}-state.json"
+agentState="{}"
+[ -f "$stateFile" ] && agentState=$(jq -r --arg id "$agent_id" '.agents[$id] // {}' "$stateFile")
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+days=${days:-7}
+cutoff=$(date -u -v-${days}d +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d "${days} days ago" +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || echo "")
+```
+
+---
+
+## Step 2 — Execute Action
+
+### show (default)
+
+```bash
+echo "AGENT DETAIL — $agent_id @ $org_name"
+echo "────────────────────────────────────────────────────────"
+
+echo "$agentDef" | jq -r '
+  "  ID:          \(.id)",
+  "  Title:       \(.title // "-")",
+  "  Reports to:  \(.reports_to // "(top)")",
+  "  Governance:  \(.governance // "inherit")",
+  "  Model:       \(.adapter.model // "default")",
+  "  Max tokens:  \((.adapter.max_tokens // 8192) | tostring)",
+  "  Heartbeat:   \(if (.heartbeat.enabled // false) then "enabled (" + ((.heartbeat.interval // 900) | tostring) + "s)" else "disabled" end)"
+'
+
+status=$(echo "$agentState" | jq -r '.status // "unknown"')
+lastRun=$(echo "$agentState" | jq -r '.last_run // "-"')
+totalRuns=$(echo "$agentState" | jq -r '.total_runs // 0')
+tokenUsed=$(echo "$agentState" | jq -r '.tokens_used // 0')
+
+echo ""
+echo "  Status:      $status"
+echo "  Last run:    $lastRun"
+echo "  Total runs:  $totalRuns"
+echo "  Tokens used: $tokenUsed"
+
+# Skills
+skillCount=$(echo "$agentDef" | jq -r '(.skills // []) | length')
+echo ""
+echo "  Skills: $skillCount assigned"
+echo "$agentDef" | jq -r '(.skills // [])[] | "    · \(.)"'
+```
+
+### runs
+
+```bash
+echo "RUN HISTORY — $agent_id (last ${days} days)"
+echo "────────────────────────────────────────────────────────"
+printf "%-26s %-10s %-8s %-12s %s\n" "TIMESTAMP" "STATUS" "TOKENS" "DURATION" "TASK"
+echo "────────────────────────────────────────────────────────"
+
+found=0
+if [ -f "$activityFile" ]; then
+  while IFS= read -r line; do
+    agId=$(echo "$line" | jq -r '.agent // ""')
+    [ "$agId" != "$agent_id" ] && continue
+    ts=$(echo "$line" | jq -r '.ts // ""')
+    [ -n "$cutoff" ] && [ "$ts" \< "$cutoff" ] && continue
+    st=$(echo "$line" | jq -r '.status // "-"')
+    tok=$(echo "$line" | jq -r '.tokens // "-"')
+    dur=$(echo "$line" | jq -r '.duration_ms // "-"')
+    task=$(echo "$line" | jq -r '.task // "-"' | cut -c1-40)
+    printf "%-26s %-10s %-8s %-12s %s\n" "$ts" "$st" "$tok" "${dur}ms" "$task"
+    found=$((found + 1))
+  done < "$activityFile"
+fi
+
+[ "$found" -eq 0 ] && echo "  No runs in the last $days days."
+
+# 7-day summary bar
+echo ""
+echo "ACTIVITY SUMMARY (last 7 days)"
+for d in 6 5 4 3 2 1 0; do
+  dayLabel=$(date -u -v-${d}d +%Y-%m-%d 2>/dev/null || date -u -d "${d} days ago" +%Y-%m-%d 2>/dev/null || echo "?")
+  count=0
+  if [ -f "$activityFile" ]; then
+    count=$(grep "\"agent\":\"${agent_id}\"" "$activityFile" | grep "\"$dayLabel" | wc -l | tr -d ' ')
+  fi
+  bar=$(printf '%0.s█' $(seq 1 $((count > 10 ? 10 : count))))
+  printf "  %s  %-10s %s\n" "$dayLabel" "$bar" "($count)"
+done
+```
+
+### config
+
+```bash
+echo "ADAPTER CONFIG — $agent_id"
+echo "────────────────────────────────────────────────────────"
+echo "$agentDef" | jq '.adapter // {"model":"default","max_tokens":8192}'
+echo ""
+echo "RUNTIME CONFIG"
+echo "$agentDef" | jq '.runtimeConfig // {}'
+echo ""
+echo "HEARTBEAT CONFIG"
+echo "$agentDef" | jq '.heartbeat // {"enabled":false}'
+```
+
+### budget
+
+```bash
+echo "BUDGET — $agent_id @ $org_name"
+echo "────────────────────────────────────────────────────────"
+
+orgBudget=$(jq -r '.budget_tokens // 0' "$orgFile")
+agentBudget=$(echo "$agentDef" | jq -r '.budget_tokens // null')
+tokensUsed=$(echo "$agentState" | jq -r '.tokens_used // 0')
+
+echo "  Org budget:     $orgBudget tokens/day"
+[ "$agentBudget" != "null" ] && echo "  Agent cap:      $agentBudget tokens" || echo "  Agent cap:      (inherits org)"
+echo "  Used today:     $tokensUsed tokens"
+
+if [ "$orgBudget" -gt 0 ] && [ "$tokensUsed" -gt 0 ]; then
+  pct=$((tokensUsed * 100 / orgBudget))
+  echo "  Utilization:    ${pct}%"
+  [ "$pct" -ge 80 ] && echo "  WARNING: Agent has used ${pct}% of org daily budget."
+fi
+
+# Per-day breakdown from activity
+echo ""
+echo "DAILY USAGE (last 7 days)"
+for d in 6 5 4 3 2 1 0; do
+  dayLabel=$(date -u -v-${d}d +%Y-%m-%d 2>/dev/null || date -u -d "${d} days ago" +%Y-%m-%d 2>/dev/null || echo "?")
+  dayTok=0
+  if [ -f "$activityFile" ]; then
+    dayTok=$(grep "\"agent\":\"${agent_id}\"" "$activityFile" | grep "\"$dayLabel" | \
+      jq -rs '[.[].tokens // 0] | add // 0' 2>/dev/null || echo 0)
+  fi
+  printf "  %s  %s tokens\n" "$dayLabel" "$dayTok"
+done
+```
+
+### heartbeat
+
+```bash
+echo "HEARTBEAT CONFIG — $agent_id"
+echo "────────────────────────────────────────────────────────"
+enabled=$(echo "$agentDef" | jq -r '.heartbeat.enabled // false')
+interval=$(echo "$agentDef" | jq -r '.heartbeat.interval // 900')
+lastHb=$(echo "$agentState" | jq -r '.last_heartbeat // "-"')
+
+echo "  Enabled:   $enabled"
+echo "  Interval:  ${interval}s"
+echo "  Last beat: $lastHb"
+echo ""
+echo "To toggle: /mastermind:instance --action toggle-heartbeat --org $org_name --agent-id $agent_id"
+```
+
+### skills
+
+```bash
+echo "SKILLS — $agent_id"
+echo "────────────────────────────────────────────────────────"
+skillList=$(echo "$agentDef" | jq -r '(.skills // [])[]' 2>/dev/null)
+
+if [ -z "$skillList" ]; then
+  echo "  No skills assigned. Use /mastermind:skills to map skills to this agent."
+else
+  while IFS= read -r sk; do
+    skillFile=".claude/skills/${sk//:///}.md"
+    [ -f "$skillFile" ] && desc=$(head -5 "$skillFile" | grep 'description:' | sed 's/description: //') || desc="(skill file not found)"
+    printf "  %-30s %s\n" "$sk" "$desc"
+  done <<< "$skillList"
+fi
+```
+
+### reset
+
+```bash
+echo "Resetting agent state for '$agent_id'…"
+
+tmp="${stateFile}.tmp"
+if [ -f "$stateFile" ]; then
+  jq --arg id "$agent_id" \
+    '.agents[$id] = {"status":"idle","total_runs":0,"tokens_used":0,"last_run":null,"last_heartbeat":null}' \
+    "$stateFile" > "$tmp" && mv "$tmp" "$stateFile"
+fi
+
+echo "Agent '$agent_id' state reset. Run history is preserved in activity log."
+echo "To reconfigure adapter: edit the role in /mastermind:org --action show (then edit org config)."
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name>
+agent_id: <agent_id>
+agent_status: <status>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.

package/packages/@monomind/cli/.claude/skills/mastermind/agents.md

@@ -0,0 +1,178 @@
+---
+name: mastermind-agents
+description: Mastermind agents — list, inspect, hire, pause, and remove agents in a running org. Shows status, last heartbeat, adapter config, and burn rate per agent.
+type: domain-skill
+default_mode: confirm
+---
+
+# Mastermind Agents
+
+This skill is invoked by `mastermind:agents` or directly via `/mastermind:agents`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org to inspect (optional — lists all orgs if omitted)
+- `action`: list | hire | pause | resume | remove | inspect
+- `agent_id`: role id or agent slug (required for inspect/pause/resume/remove)
+- `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`.
+
+---
+
+## Step 1 — Resolve Org
+
+If `org_name` is provided, load `.monomind/orgs/<org_name>.json`. Otherwise list all orgs:
+
+```bash
+ls .monomind/orgs/*.json 2>/dev/null | grep -vE -- '-approvals|-state|-activity|-goals|-routines|-projects|-members|-issues|-workspaces|-worktrees|-environments|-plugins|-adapters|-bootstrap|-threads|-budgets|-project-workspaces|-approval-comments' | xargs -I{} basename {} .json
+```
+
+If no orgs exist, print: "No orgs found. Run /mastermind:createorg to define one."
+
+---
+
+## Step 2 — Execute Action
+
+### list (default)
+
+Display all agents in the org with status from state file:
+
+```bash
+orgFile=".monomind/orgs/${org_name}.json"
+stateFile=".monomind/orgs/${org_name}-state.json"
+
+jq -r '(.roles // [])[] | "• [\(.id)] \(.title)  agent=\(.agent_type)  reports_to=\(.reports_to // "none")"' "$orgFile"
+
+# Overlay runtime status from state file if present
+if [ -f "$stateFile" ]; then
+  echo ""
+  echo "RUNTIME STATUS:"
+  jq -r '.agents // {} | to_entries[] | "  \(.key): \(.value.status // "unknown")  last_beat=\(.value.last_heartbeat // "never")"' "$stateFile" 2>/dev/null || true
+fi
+```
+
+Render as table:
+
+```
+AGENTS — org: <org_name>
+──────────────────────────────────────────────────────
+ID              TITLE              AGENT TYPE          STATUS        LAST HEARTBEAT
+boss            CEO / Boss         coordinator         running       2 min ago
+content-writer  Content Writer     Content Creator     idle          8 min ago
+reviewer        Content Reviewer   reviewer            waiting       8 min ago
+...
+```
+
+### inspect
+
+Show full config + responsibilities + communication edges for a single agent:
+
+```bash
+jq --arg id "$agent_id" '(.roles // [])[] | select(.id == $id)' "$orgFile"
+jq --arg id "$agent_id" '(.communication // [])[] | select(.from == $id or .to == $id)' "$orgFile"
+```
+
+### hire
+
+Add a new role to the org. Prompt the user for:
+- `id` (slug, e.g. `seo-lead`), `title` (display name), `agent_type` (from mapping table in createorg.md), `responsibilities` (comma-separated), `reports_to` (role id or null)
+
+**Adapter/model selection** — present this picker:
+
+```
+ADAPTER / MODEL
+───────────────
+Available Claude models:
+  1. claude-sonnet-4-6    → balanced capability + speed (Recommended)
+  2. claude-opus-4-7      → highest capability, slower
+  3. claude-haiku-4-5     → fastest, lowest cost
+
+Enter choice [1]:
+```
+
+Set `adapter_config.model` from selection. Default: `claude-sonnet-4-6`.
+
+Append to `.monomind/orgs/<org_name>.json` roles array using jq:
+
+```bash
+# model from adapter picker (default: claude-sonnet-4-6)
+adapter_model="${selected_model:-claude-sonnet-4-6}"
+
+tmp="${orgFile}.tmp"
+jq --arg id "$agent_id" \
+   --arg title "$title" \
+   --arg agent_type "$agent_type" \
+   --arg reports_to "${reports_to:-}" \
+   --arg model "$adapter_model" \
+   --argjson resp "$(echo "$responsibilities" | jq -R 'split(",") | map(ltrimstr(" "))')" \
+   '.roles += [{"id":$id,"title":$title,"agent_type":$agent_type,
+     "responsibilities":$resp,
+     "reports_to":($reports_to|if .=="" then null else . end),
+     "adapter_config":{"model":$model,"max_tokens":8192}}]' \
+   "$orgFile" > "$tmp" && mv "$tmp" "$orgFile"
+echo "Hired: $title ($agent_type) → adapter: $adapter_model"
+```
+
+Then emit `org:agent:hired` event to dashboard:
+
+```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 role "$agent_id" --arg title "$title" \
+    '{type:"org:agent:hired",org:$org,role:$role,title:$title,ts:(now*1000|floor)}')" || true
+```
+
+### pause / resume
+
+Update state file:
+
+```bash
+stateFile=".monomind/orgs/${org_name}-state.json"
+[ ! -f "$stateFile" ] && echo '{"agents":{}}' > "$stateFile"
+tmp="${stateFile}.tmp"
+jq --arg id "$agent_id" --arg status "paused" \
+  '.agents[$id].status = $status | .agents[$id].updated_at = (now|todate)' \
+  "$stateFile" > "$tmp" && mv "$tmp" "$stateFile"
+```
+
+Emit `org:agent:paused` / `org:agent:resumed` event.
+
+### remove
+
+Confirm with user, then remove role from org config:
+
+```bash
+tmp="${orgFile}.tmp"
+jq --arg id "$agent_id" '.roles = [(.roles // [])[] | select(.id != $id)] | .communication = [(.communication // [])[] | select(.from != $id and .to != $id)]' \
+  "$orgFile" > "$tmp" && mv "$tmp" "$orgFile"
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name>
+agents_count: <N>
+```
+
+Print summary and any suggested next actions (e.g. "Run /mastermind:heartbeat to trigger a manual heartbeat for this agent").
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.