monomind 2.3.3 → 2.3.4

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

@@ -51,12 +51,15 @@ stateFile=".monomind/orgs/${org_name}-state.json"
 
 jq -r '(.roles // [])[] | "• [\(.id)] \(.title)  agent=\(.agent_type)  reports_to=\(.reports_to // "none")"' "$orgFile"
 
+# LEGACY-ORG-V1: the state file's per-agent heartbeat tracking is a v1 concept —
+# v2 orgs report live status via `monomind org status`/`org report` instead.
 # 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
+# end LEGACY-ORG-V1
 ```
 
 Render as table:
@@ -134,6 +137,7 @@ curl -s -X POST "${CTRL_URL}/api/mastermind/event" -H "x-monomind-token: $(cat "
 
 ### pause / resume
 
+<!-- LEGACY-ORG-V1: the agent state/heartbeat file this pauses is a v1 concept. -->
 Update state file:
 
 ```bash
@@ -169,7 +173,7 @@ 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").
+Print summary and any suggested next actions (e.g. "Run /mastermind:heartbeatv1 to trigger a manual heartbeat for this agent").
 
 ---
 

package/packages/@monomind/cli/.claude/skills/mastermind-skills/{approve.md → approvev1.md}

@@ -1,13 +1,16 @@
 ---
-name: mastermind-approve
-description: Mastermind approve — review and action pending approval requests from agents in a running org. Agents can request human approval before proceeding with sensitive actions.
+name: mastermind-approvev1
+description: "LEGACY-ORG-V1 (2026-07): v2 approvals arrive as question events in the dashboard Human Input tab — no skill needed. Mastermind approvev1 — review and action pending approval requests from agents in a running v1 (prompt-orchestrated) org. Agents can request human approval before proceeding with sensitive actions. Reach it only via `/mastermind:approvev1`."
 type: domain-skill
 default_mode: confirm
 ---
 
-# Mastermind Approve
+# Mastermind Approve (v1, legacy)
 
-This skill is invoked by `mastermind:approve` or directly via `/mastermind:approve`.
+> **LEGACY-ORG-V1 — file-based approval queue for prompt-orchestrated v1 orgs. Reach it only via `/mastermind:approvev1`.**
+> v2 approvals arrive as `question` events in the dashboard Human Input tab — there is no v2 approve skill, the dashboard UI is the approval surface. This skill remains only for orgs not yet migrated off the v1 `board_id`/`topology` config shape.
+
+This skill is invoked by `mastermind:approvev1` or directly via `/mastermind:approvev1`.
 
 ---
 
@@ -150,7 +153,7 @@ jq --arg id "$approval_id" \
 
 2. Emit `org:approval:requested` event to dashboard (so the human is notified).
 
-3. Poll for the approval decision — check the approvals file first (authoritative, updated by both the dashboard UI and `/mastermind:approve`), then fall back to memory:
+3. Poll for the approval decision — check the approvals file first (authoritative, updated by both the dashboard UI and `/mastermind:approvev1`), then fall back to memory:
 ```bash
 approvalsFile=".monomind/orgs/${orgName}-approvals.json"
 while true; do

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

@@ -81,6 +81,7 @@ echo "  namespace: org:${org_name}"
 npx monomind@latest memory list --namespace "org:${org_name}" 2>/dev/null | wc -l | xargs echo "  stored entries:"
 echo ""
 
+# LEGACY-ORG-V1: board_id/*_col_id only exist on the pre-v2 board-backed org shape
 # Board config
 echo "TASK BOARD"
 echo "──────────"
@@ -90,6 +91,7 @@ echo "  todo_col:    $(jq -r '.todo_col_id // "NOT CONFIGURED"' "$orgFile")"
 echo "  doing_col:   $(jq -r '.doing_col_id // "NOT CONFIGURED"' "$orgFile")"
 echo "  done_col:    $(jq -r '.done_col_id // "NOT CONFIGURED"' "$orgFile")"
 echo ""
+# end LEGACY-ORG-V1 board block
 
 # Run config
 echo "RUN CONFIG"
@@ -129,9 +131,12 @@ for key in ANTHROPIC_API_KEY; do
   fi
 done
 
-# Check board IDs
+# LEGACY-ORG-V1: board_id belongs to the legacy v1 runner — see runorgv1. Org
+# Runtime v2 configs have no board_id at all, so this check only applies to
+# orgs still running the v1 board-backed shape.
 board_id=$(jq -r '.board_id // empty' "$orgFile")
-[ -z "$board_id" ] && { echo "  ✗ MISSING: board_id — run /mastermind:createorg to rebuild"; errors=$((errors + 1)); } || echo "  ✓ board_id"
+[ -z "$board_id" ] && { echo "  ✗ MISSING: board_id — boards belong to the legacy v1 runner, see runorgv1"; errors=$((errors + 1)); } || echo "  ✓ board_id"
+# end LEGACY-ORG-V1
 
 # Check roles
 role_count=$(jq '.roles | length' "$orgFile")

package/packages/@monomind/cli/.claude/skills/mastermind-skills/{heartbeat.md → heartbeatv1.md}

@@ -1,13 +1,16 @@
 ---
-name: mastermind-heartbeat
-description: Mastermind heartbeat — trigger a manual heartbeat for a specific agent in a running org. The agent wakes, checks its task queue, executes pending work, and reports back.
+name: mastermind-heartbeatv1
+description: "LEGACY-ORG-V1 (2026-07): v2: send the role a chat message from the dashboard, or inspect with `monomind org logs <name>` — no skill needed. Mastermind heartbeatv1 — trigger a manual heartbeat for a specific agent in a running v1 (prompt-orchestrated) org. The agent wakes, checks its task queue, executes pending work, and reports back. Reach it only via `/mastermind:heartbeatv1`."
 type: domain-skill
 default_mode: auto
 ---
 
-# Mastermind Heartbeat
+# Mastermind Heartbeat (v1, legacy)
 
-This skill is invoked by `mastermind:heartbeat` or directly via `/mastermind:heartbeat`.
+> **LEGACY-ORG-V1 — manual task-board wake-up for prompt-orchestrated v1 orgs. Reach it only via `/mastermind:heartbeatv1`.**
+> v2 roles run as live SDK sessions with no poll/wake cycle to trigger — send the role a chat message from the dashboard, or inspect activity with `monomind org logs <name>`. This skill remains only for orgs not yet migrated off the v1 `board_id`/`topology` config shape.
+
+This skill is invoked by `mastermind:heartbeatv1` or directly via `/mastermind:heartbeatv1`.
 
 ---
 

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

@@ -54,17 +54,23 @@ for org in $orgs; do
   stateFile=".monomind/orgs/${org}-state.json"
   approvalsFile=".monomind/orgs/${org}-approvals.json"
 
+  # LEGACY-ORG-V1: approvals files only exist for the v1 prompt-orchestrated
+  # runner — see runorgv1 / approvev1.
   # 1. Pending approvals
   if [ -f "$approvalsFile" ]; then
     pending=$(jq '[(.approvals // [])[] | select(.status == "pending")] | length' "$approvalsFile" 2>/dev/null || echo 0)
     total_approvals=$((total_approvals + pending))
   fi
+  # end LEGACY-ORG-V1
 
+  # LEGACY-ORG-V1: state-file "heartbeats" are the v1 scheduler's running-agent
+  # tracking — v2 runs live under .monomind/orgs/<name>/run-*/bus.jsonl instead.
   # 2. Running agents (active heartbeats)
   if [ -f "$stateFile" ]; then
     running=$(jq '[.agents // {} | to_entries[] | select(.value.status == "running")] | length' "$stateFile" 2>/dev/null || echo 0)
     total_heartbeats=$((total_heartbeats + running))
   fi
+  # end LEGACY-ORG-V1
 
   # 3. Budget alerts
   budget=$(jq -r '.run_config.budget_tokens // 0' "$orgFile" 2>/dev/null || echo 0)
@@ -101,13 +107,16 @@ for org in $orgs; do
 
   has_items=0
 
+  # LEGACY-ORG-V1: approvals belong to the v1 prompt-orchestrated runner
   # Pending approvals
   if [ -f "$approvalsFile" ]; then
     pending_approvals=$(jq -r '(.approvals // [])[] | select(.status == "pending") | "  [APPROVAL] [\(.id)] \(.agent_id): \(.title)  risk=\(.risk_level // "low")"' \
       "$approvalsFile" 2>/dev/null)
     [ -n "$pending_approvals" ] && { has_items=1; echo "ORG: $org"; echo "$pending_approvals"; }
   fi
+  # end LEGACY-ORG-V1
 
+  # LEGACY-ORG-V1: state-file heartbeats are the v1 scheduler's tracking
   # Running agents
   if [ -f "$stateFile" ]; then
     running_agents=$(jq -r '
@@ -116,6 +125,7 @@ for org in $orgs; do
     ' "$stateFile" 2>/dev/null)
     [ -n "$running_agents" ] && { has_items=1; [ $has_items -eq 1 ] || echo "ORG: $org"; echo "$running_agents"; }
   fi
+  # end LEGACY-ORG-V1
 
   [ $has_items -eq 1 ] && echo ""
 done
@@ -127,13 +137,14 @@ fi
 
 ### filter: approvals only
 
+<!-- LEGACY-ORG-V1: approvals belong to the v1 prompt-orchestrated runner — see runorgv1 / approvev1. -->
 ```bash
 for org in $orgs; do
   approvalsFile=".monomind/orgs/${org}-approvals.json"
   [ -f "$approvalsFile" ] || continue
   echo "=== $org ==="
   jq -r '(.approvals // [])[] | select(.status == "pending") |
-    "[\(.id)] \(.agent_id): \(.title)\n  Action: \(.action)\n  Risk: \(.risk_level // "low")\n  → /mastermind:approve --org '"$org"' --action approve --approval-id \(.id)"
+    "[\(.id)] \(.agent_id): \(.title)\n  Action: \(.action)\n  Risk: \(.risk_level // "low")\n  → /mastermind:approvev1 --org '"$org"' --action approve --approval-id \(.id)"
   ' "$approvalsFile" 2>/dev/null || echo "  No pending approvals."
   echo ""
 done
@@ -141,6 +152,7 @@ done
 
 ### filter: heartbeats only
 
+<!-- LEGACY-ORG-V1: state-file heartbeats are the v1 scheduler's running-agent tracking. -->
 Show currently running agent heartbeats across all orgs:
 
 ```bash
@@ -181,7 +193,7 @@ From the inbox, the user can directly:
 
 ```bash
 # Approve a pending request:
-/mastermind:approve --org <org> --action approve --approval-id <id>
+/mastermind:approvev1 --org <org> --action approve --approval-id <id>
 
 # Stop a running agent:
 /mastermind:agents --org <org> --action pause --agent-id <id>

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

@@ -84,6 +84,7 @@ echo "  Active orgs: $orgs"
 
 ### heartbeats
 
+<!-- LEGACY-ORG-V1: role-level heartbeat scheduling is a v1 org concept — v2 orgs run on `schedule` via the daemon instead. -->
 List all agents across all orgs that have scheduled heartbeats:
 
 ```bash
@@ -116,11 +117,12 @@ for orgF in .monomind/orgs/*.json; do
   done
 done
 
-[ "$found" -eq 0 ] && echo "  No scheduled heartbeat agents found. Configure via /mastermind:heartbeat."
+[ "$found" -eq 0 ] && echo "  No scheduled heartbeat agents found. Configure via /mastermind:heartbeatv1."
 ```
 
 ### toggle-heartbeat
 
+<!-- LEGACY-ORG-V1: role-level heartbeat scheduling is a v1 org concept. -->
 Enable or disable the scheduler heartbeat for a specific agent:
 
 ```bash

package/packages/@monomind/cli/.claude/skills/mastermind-skills/org-settings.md

@@ -9,7 +9,10 @@ default_mode: confirm
 
 This skill is invoked by `mastermind:org-settings` or directly via `/mastermind:org-settings`.
 
-It edits `.monomind/orgs/<org_name>.json` in place, and only ever touches fields that `OrgDefSchema` (`packages/@monomind/cli/src/orgrt/types.ts`) actually defines — every field listed below is read by the daemon (`org.ts`/`daemon.ts`/`session.ts`) at `monomind org run`/`serve` time. There is no `topology`, `governance`, `alert_threshold`, or `ceo_adapter` in Org Runtime v2 — those were v1 board/prompt-orchestration fields with no runtime effect and have been removed from this skill.
+It edits `.monomind/orgs/<org_name>.json` in place, and only ever touches fields that `OrgDefSchema` (`packages/@monomind/cli/src/orgrt/types.ts`) actually defines — every field listed below is read by the daemon (`org.ts`/`daemon.ts`/`session.ts`) at `monomind org run`/`serve` time. Its primary edit flow targets v2 fields only: `name`, `goal`, `schedule`, and `run_config` (`budget_tokens`, `memory_namespace`, `max_turns_per_message`). Role edits are not yet supported by this skill's `edit` action — `roles` is shown read-only via `show`.
+
+<!-- LEGACY-ORG-V1: remove this note when v1 orgs are gone -->
+There is no `topology`, `governance`, `alert_threshold`, or `ceo_adapter` in Org Runtime v2 — those were v1 board/prompt-orchestration fields with no runtime effect and have been removed from this skill's edit surface. Use `/mastermind:org-settings` only for v2-shaped orgs; v1 orgs must go through `monomind org migrate` first.
 
 ---
 

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

@@ -58,18 +58,8 @@ for f in $orgFiles; do
   schedule=$(jq -r '.schedule // empty' "$f" 2>/dev/null)
   loop_interval=$(jq -r '.loop.poll_interval_minutes // empty' "$f" 2>/dev/null)
 
-  if [ -n "$loop_interval" ]; then
-    # legacy v1 scheduled org — state lives in the config's status field
-    interval="${loop_interval}m (v1)"
-    status=$(jq -r '.status // "—"' "$f" 2>/dev/null)
-    case "$status" in
-      active)  indicator="● active" ;;
-      paused)  indicator="⏸ paused" ;;
-      *)       indicator="○ stopped" ;;
-    esac
-    last_run=$(jq -r '.loop.last_run // "—"' "$f" 2>/dev/null | sed 's/T/ /;s/Z//')
-  else
-    # v2 org — live state is in runtime.json (crashed = running record, dead pid)
+  if [ -z "$loop_interval" ]; then
+    # v2 org (default) — live state is in runtime.json (crashed = running record, dead pid)
     interval="${schedule:-manual}"
     rt=".monomind/orgs/${name}/runtime.json"
     rt_status=$(jq -r '.status // "never run"' "$rt" 2>/dev/null || echo "never run")
@@ -84,6 +74,17 @@ for f in $orgFiles; do
       indicator="○ ${rt_status}"
     fi
     last_run=$(jq -r '.updated // "—"' "$rt" 2>/dev/null | sed 's/T/ /;s/\..*Z//' || echo "—")
+  else
+    # LEGACY-ORG-V1: remove this branch when v1 orgs are gone
+    # legacy v1 scheduled org — state lives in the config's status field
+    interval="${loop_interval}m (v1)"
+    status=$(jq -r '.status // "—"' "$f" 2>/dev/null)
+    case "$status" in
+      active)  indicator="● active" ;;
+      paused)  indicator="⏸ paused" ;;
+      *)       indicator="○ stopped" ;;
+    esac
+    last_run=$(jq -r '.loop.last_run // "—"' "$f" 2>/dev/null | sed 's/T/ /;s/Z//')
   fi
 
   printf "%-28s %-14s %-12s %-22s\n" "$name" "$indicator" "$interval" "$last_run"
@@ -106,7 +107,7 @@ COMMANDS
   monomind org validate [name]           Check config against the runtime schema
   /mastermind:orgstatus --org <name>     Detailed status, last runs, activity
   /mastermind:createorg <goal>           Create a new org
-  /mastermind:runorg --org <name>        (legacy v1 orgs only — deprecated)
+  /mastermind:runorg --org <name>        v2 delegator (auto-migrates v1 configs, then runs via the daemon)
 ```
 
 ---

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

@@ -51,17 +51,21 @@ status=$(jq -r '.status // "no-schedule"' "$orgFile")
 role_count=$(jq '.roles | length' "$orgFile")
 created_at=$(jq -r '.created_at // "-"' "$orgFile")
 
-# v1 loop fields (legacy scheduled orgs only)
 has_schedule=$(jq -r 'if .loop.poll_interval_minutes then "yes" else "no" end' "$orgFile")
-poll_interval=$(jq -r '.loop.poll_interval_minutes // ""' "$orgFile")
-last_run=$(jq -r '.loop.last_run // "never"' "$orgFile")
-next_run=$(jq -r '.loop.next_run // "not scheduled"' "$orgFile")
-run_prompt_file=$(jq -r '.loop.run_prompt_file // ""' "$orgFile")
 
 # v2 fields
 is_v2=$([ "$has_schedule" = "no" ] && echo yes || echo no)
 v2_schedule=$(jq -r '.schedule // empty' "$orgFile")
 budget=$(jq -r '.run_config.budget_tokens // 1000000' "$orgFile")
+
+# LEGACY-ORG-V1: remove this block when v1 orgs are gone
+# v1 loop fields (legacy scheduled orgs only)
+poll_interval=$(jq -r '.loop.poll_interval_minutes // ""' "$orgFile")
+last_run=$(jq -r '.loop.last_run // "never"' "$orgFile")
+next_run=$(jq -r '.loop.next_run // "not scheduled"' "$orgFile")
+run_prompt_file=$(jq -r '.loop.run_prompt_file // ""' "$orgFile")
+# end LEGACY-ORG-V1 loop-fields block
+
 rtFile=".monomind/orgs/${org_name}/runtime.json"
 rt_status=$(jq -r '.status // "never run"' "$rtFile" 2>/dev/null || echo "never run")
 rt_run=$(jq -r '.run // ""' "$rtFile" 2>/dev/null || echo "")
@@ -95,6 +99,7 @@ if [ "$is_v2" = "yes" ]; then
   echo ""
 fi
 
+# LEGACY-ORG-V1: remove this block when v1 orgs are gone
 if [ "$has_schedule" = "yes" ]; then
   echo "SCHEDULED LOOP"
   echo "──────────────"
@@ -127,6 +132,7 @@ if [ "$is_v2" = "yes" ]; then
     && echo "  Config:    ✓ valid (monomind org validate)" \
     || echo "  Config:    ✗ INVALID — run: monomind org validate $name"
 else
+  # LEGACY-ORG-V1: remove this branch when v1 orgs are gone
   # v1 health: board / column IDs
   board_id=$(jq -r '.board_id // ""' "$orgFile")
   todo_col=$(jq -r '.todo_col_id // ""' "$orgFile")
@@ -139,12 +145,13 @@ else
   fi
 fi
 
+# LEGACY-ORG-V1: remove this branch when v1 orgs are gone
 # Pending approvals
 approvalsFile=".monomind/orgs/${org_name}-approvals.json"
 if [ -f "$approvalsFile" ]; then
   pending=$(jq '(.approvals // []) | map(select(.status == "pending")) | length' "$approvalsFile")
   [ "$pending" -gt 0 ] \
-    && echo "  Approvals: ⚠ ${pending} pending — /mastermind:approve --org ${name} --action list" \
+    && echo "  Approvals: ⚠ ${pending} pending — /mastermind:approvev1 --org ${name} --action list" \
     || echo "  Approvals: ✓ none pending"
 else
   echo "  Approvals: ✓ no approvals file"
@@ -152,8 +159,10 @@ fi
 
 # Stop file (pending stop signal) — v2 daemons poll <org>/stop; v1 used .stops/
 [ -f ".monomind/orgs/${org_name}/stop" ] && echo "  Stop file: ⚠ PRESENT (v2) — daemon will exit within 2s of seeing it"
+# LEGACY-ORG-V1: remove this check when v1 orgs are gone
 [ -f ".monomind/orgs/.stops/${org_name}.stop" ] && echo "  Stop file: ⚠ PRESENT (v1 legacy path)"
 
+# LEGACY-ORG-V1: remove this block when v1 orgs are gone
 # Loop prompt file (scheduled orgs)
 if [ "$has_schedule" = "yes" ]; then
   if [ -n "$run_prompt_file" ] && [ -f "$run_prompt_file" ]; then
@@ -182,6 +191,7 @@ if [ "$is_v2" = "yes" ]; then
     echo ""
   fi
 else
+  # LEGACY-ORG-V1: remove this branch when v1 orgs are gone
   activityFile=".monomind/orgs/${org_name}-activity.jsonl"
   if [ -f "$activityFile" ]; then
     echo "RECENT ACTIVITY (last 5)"
@@ -214,14 +224,15 @@ if [ "$is_v2" = "yes" ]; then
   echo "  Report:       monomind org report $name   (add --all for run history)"
   echo "  Validate:     monomind org validate $name"
   echo "  Settings:     /mastermind:org-settings --org $name"
+# LEGACY-ORG-V1: remove the next two branches when v1 orgs are gone
 elif [ "$has_schedule" = "yes" ]; then
   case "$status" in
     active|paused) echo "  Stop loop:    /mastermind:stoporg --org $name" ;;
-    stopped)       echo "  Start loop:   /mastermind:runorg --org $name  (legacy v1)" ;;
+    stopped)       echo "  Start loop:   /mastermind:runorg --org $name  (v1 config — will auto-migrate)" ;;
   esac
   echo "  Edit prompt:  \$EDITOR $run_prompt_file"
 else
-  echo "  Run org:      /mastermind:runorg --org $name  (legacy v1)"
+  echo "  Run org:      /mastermind:runorg --org $name  (v1 config — will auto-migrate)"
 fi
 echo "  All orgs:     /mastermind:orgs"
 echo ""

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

@@ -112,6 +112,8 @@ Show project summary with linked tasks from the board:
 project=$(jq --arg id "$project_id" '(.projects // [])[] | select(.id == $id)' "$projectsFile")
 echo "$project" | jq .
 
+# LEGACY-ORG-V1: board_id/*_col_id only exist on the pre-v2 board-backed org
+# shape — see runorgv1.
 # If board exists, count tasks tagged with this project
 orgFile=".monomind/orgs/${org_name}.json"
 board_id=$(jq -r '.board_id // empty' "$orgFile")
@@ -125,6 +127,7 @@ if [ -n "$board_id" ]; then
       jq -r --arg p "project:$project_id" '[.[] | select((.labels // []) | index($p))] | length' 2>/dev/null
   done
 fi
+# end LEGACY-ORG-V1
 ```
 
 ---