@monoes/monomindcli 2.10.10 → 2.10.13

package/.claude/skills/mastermind-issue-detail/SKILL.md

@@ -28,7 +28,7 @@ This skill is invoked by `mastermind:issue-detail` or directly via `/mastermind:
 ## Issue Status Flow
 
 ```
-open → in_progress → done
+todo → in_progress → in_review → done
          ↓
       blocked → in_progress
          ↓
@@ -52,7 +52,7 @@ orgFile=".monomind/orgs/${org_name}.json"
 [ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
 
 issuesFile=".monomind/orgs/${org_name}-issues.json"
-[ ! -f "$issuesFile" ] && { echo "ERROR: No issues file for org '$org_name'. Create tasks via /mastermind:tasks."; exit 1; }
+[ ! -f "$issuesFile" ] && { echo "ERROR: No issues file for org '$org_name'. Create issues via /mastermind:issues --action create."; exit 1; }
 
 issueDef=$(jq -r --arg id "$issue_id" '(.issues // [])[] | select(.id == $id or .slug == $id)' "$issuesFile")
 [ -z "$issueDef" ] && { echo "ERROR: Issue '$issue_id' not found in org '$org_name'."; exit 1; }
@@ -64,6 +64,38 @@ days=${days:-14}
 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 "")
 ```
 
+Normalize any legacy records written by a pre-2.10 version of these skills. Idempotent — safe to run on every load.
+
+```bash
+python3 - "$issuesFile" <<'PYEOF'
+import json, sys
+path = sys.argv[1]
+data = json.load(open(path))
+RENAME = {
+    "assignee_id": "assigneeId", "assigned_to": "assigneeId",
+    "created_at": "createdAt", "updated_at": "updatedAt",
+    "closed_at": "closedAt", "project_id": "projectId",
+    "parent_id": "parentId", "recovery_status": "recoveryStatus",
+    "lastActivityAt": "updatedAt",
+}
+changed = False
+for iss in data.get("issues", []):
+    for old, new in RENAME.items():
+        if old in iss:
+            iss.setdefault(new, iss.pop(old))
+            iss.pop(old, None)
+            changed = True
+    if iss.get("status") == "open":
+        iss["status"] = "todo"
+        changed = True
+if changed:
+    tmp = path + ".tmp"
+    with open(tmp, "w") as f:
+        json.dump(data, f, indent=2)
+    import os; os.replace(tmp, path)
+PYEOF
+```
+
 ---
 
 ## Step 2 — Execute Action
@@ -77,16 +109,17 @@ echo "────────────────────────
 echo "$issueDef" | jq -r '
   "  ID:            \(.id)",
   "  Title:         \(.title // "(no title)")",
-  "  Status:        \(.status // "open")",
+  "  Status:        \(.status // "todo")",
   "  Priority:      \(.priority // "medium")",
-  "  Assignee:      \(.assignee_id // "(unassigned)")",
-  "  Project:       \(.project_id // "(none)")",
-  "  Created:       \(.created_at // "-")",
-  "  Updated:       \(.updated_at // "-")"
+  "  Assignee:      \(.assigneeId // "(unassigned)")",
+  "  Agent:         \(.assigneeAgentId // "(none)")",
+  "  Project:       \(.projectId // "(none)")",
+  "  Created:       \(.createdAt // "-")",
+  "  Updated:       \(.updatedAt // "-")"
 '
 
 # Sub-issues
-subCount=$(jq --arg pid "$resolvedId" '[(.issues // [])[] | select(.parent_id == $pid)] | length' "$issuesFile" 2>/dev/null || echo 0)
+subCount=$(jq --arg pid "$resolvedId" '[(.issues // [])[] | select(.parentId == $pid)] | length' "$issuesFile" 2>/dev/null || echo 0)
 echo "  Sub-issues:    $subCount"
 
 # Attachments
@@ -94,7 +127,7 @@ attCount=$(echo "$issueDef" | jq -r '(.attachments // []) | length')
 echo "  Attachments:   $attCount"
 
 # Recovery
-recoveryStatus=$(echo "$issueDef" | jq -r '.recovery_status // "none"')
+recoveryStatus=$(echo "$issueDef" | jq -r '.recoveryStatus // "none"')
 [ "$recoveryStatus" != "none" ] && echo "" && echo "  RECOVERY STATUS: $recoveryStatus"
 
 # Description
@@ -169,15 +202,15 @@ printf "%-24s %-12s %-10s %s\n" "ID" "STATUS" "PRIORITY" "TITLE"
 echo "────────────────────────────────────────────────────────"
 
 count=0
-jq -r --arg pid "$resolvedId" '(.issues // [])[] | select(.parent_id == $pid) |
-  [.id, (.status // "open"), (.priority // "medium"), (.title // "(no title)")] | @tsv' \
+jq -r --arg pid "$resolvedId" '(.issues // [])[] | select(.parentId == $pid) |
+  [.id, (.status // "todo"), (.priority // "medium"), (.title // "(no title)")] | @tsv' \
   "$issuesFile" 2>/dev/null | while IFS=$'\t' read -r id st pri title; do
   printf "%-24s %-12s %-10s %s\n" "$id" "$st" "$pri" "$title"
   count=$((count + 1))
 done
 
 echo ""
-echo "To create a sub-issue: /mastermind:tasks --org $org_name --action create --parent-id $issue_id"
+echo "To create a sub-issue: /mastermind:issues --org $org_name --action create --title '<title>' --parent-id $issue_id"
 ```
 
 ### attachments
@@ -221,10 +254,16 @@ exists=$(jq --arg id "$assignee_id" '[(.roles // [])[] | select(.id == $id)] | l
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 tmp="${issuesFile}.tmp"
 jq --arg id "$resolvedId" --arg ag "$assignee_id" --arg ts "$ts" \
-  '.issues = [(.issues // [])[] | if .id == $id then .assignee_id = $ag | .updated_at = $ts else . end]' \
+  '.issues = [(.issues // [])[] | if .id == $id then .assigneeId = $ag | .assigneeAgentId = $ag | .assigneeUserId = null | .updatedAt = $ts else . end]' \
   "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
 
 echo "Issue '$issue_id' assigned to '$assignee_id'."
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+currentStatus=$(jq -r --arg id "$resolvedId" '(.issues // [])[] | select(.id == $id) | .status // "todo"' "$issuesFile")
+jq -cn --arg iid "$resolvedId" --arg ts "$ts" --arg st "$currentStatus" --arg ag "$assignee_id" --arg sm "assign $resolvedId" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"assign", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ### close
@@ -233,9 +272,14 @@ echo "Issue '$issue_id' assigned to '$assignee_id'."
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 tmp="${issuesFile}.tmp"
 jq --arg id "$resolvedId" --arg ts "$ts" \
-  '.issues = [(.issues // [])[] | if .id == $id then .status = "done" | .updated_at = $ts | .closed_at = $ts else . end]' \
+  '.issues = [(.issues // [])[] | if .id == $id then .status = "done" | .updatedAt = $ts | .closedAt = $ts else . end]' \
   "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
 echo "Issue '$issue_id' → done (closed at $ts)."
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+jq -cn --arg iid "$resolvedId" --arg ts "$ts" --arg st "done" --arg ag "operator" --arg sm "close $resolvedId" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"close", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ### reopen
@@ -244,9 +288,14 @@ echo "Issue '$issue_id' → done (closed at $ts)."
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 tmp="${issuesFile}.tmp"
 jq --arg id "$resolvedId" --arg ts "$ts" \
-  '.issues = [(.issues // [])[] | if .id == $id then .status = "open" | .updated_at = $ts | .closed_at = null else . end]' \
+  '.issues = [(.issues // [])[] | if .id == $id then .status = "todo" | .updatedAt = $ts | .closedAt = null else . end]' \
   "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
 echo "Issue '$issue_id' → reopened."
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+jq -cn --arg iid "$resolvedId" --arg ts "$ts" --arg st "todo" --arg ag "operator" --arg sm "reopen $resolvedId" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"reopen", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ### recover
@@ -263,12 +312,17 @@ newStatus=$([ "$recovery_action" = "accept" ] && echo "in_progress" || echo "can
 tmp="${issuesFile}.tmp"
 jq --arg id "$resolvedId" --arg st "$newStatus" --arg ts "$ts" --arg ra "$recovery_action" \
   '.issues = [(.issues // [])[] | if .id == $id then
-     .status = $st | .recovery_status = $ra | .updated_at = $ts
+     .status = $st | .recoveryStatus = $ra | .updatedAt = $ts
    else . end]' \
   "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
 
 echo "Recovery action '$recovery_action' applied to '$issue_id'."
 echo "  New status: $newStatus"
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+jq -cn --arg iid "$resolvedId" --arg ts "$ts" --arg st "$newStatus" --arg ag "operator" --arg sm "recover $resolvedId" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"recover", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ---

package/.claude/skills/mastermind-issues/SKILL.md

@@ -18,13 +18,14 @@ This skill is invoked by `mastermind:issues` or directly via `/mastermind:issues
 - `action`: list | create | update | close | search
 - `issue_id`: issue ID (required for update/close)
 - `query`: search term (for search)
-- `status`: open | in_progress | in_review | done | cancelled (filter)
+- `status`: todo | in_progress | blocked | in_review | done | cancelled (filter)
 - `assignee`: agent ID filter
 - `workspace`: workspace ID filter
 - `title`: issue title (for create)
 - `description`: issue body (for create)
 - `priority`: low | medium | high | urgent (for create/update)
 - `limit`: max results (default: 50)
+- `parent_id`: parent issue id, making the new issue a sub-issue (for create)
 - `caller`: command | master
 
 ---
@@ -47,6 +48,45 @@ issuesFile=".monomind/orgs/${org_name}-issues.json"
 limit="${limit:-50}"
 ```
 
+Normalize any legacy records written by a pre-2.10 version of these skills. Idempotent — safe to run on every load.
+
+```bash
+python3 - "$issuesFile" <<'PYEOF'
+import json, sys
+path = sys.argv[1]
+data = json.load(open(path))
+RENAME = {
+    "assignee_id": "assigneeId", "assigned_to": "assigneeId",
+    "created_at": "createdAt", "updated_at": "updatedAt",
+    "closed_at": "closedAt", "project_id": "projectId",
+    "parent_id": "parentId", "recovery_status": "recoveryStatus",
+    "lastActivityAt": "updatedAt",
+}
+changed = False
+for iss in data.get("issues", []):
+    for old, new in RENAME.items():
+        if old in iss:
+            iss.setdefault(new, iss.pop(old))
+            iss.pop(old, None)
+            changed = True
+    if iss.get("status") == "open":
+        iss["status"] = "todo"
+        changed = True
+if changed:
+    tmp = path + ".tmp"
+    with open(tmp, "w") as f:
+        json.dump(data, f, indent=2)
+    import os; os.replace(tmp, path)
+PYEOF
+```
+
+> **These issues are not auto-consumed by the org runtime.** `OrgDaemon` builds its `TaskDag`
+> fresh in memory on every start and never reads `<org>-issues.json` (verified: zero references
+> in `packages/@monomind/cli/src/orgrt/`). Issues created here are tracked by the
+> `mastermind-issues` / `mastermind-my-issues` / `mastermind-liveness` skills and shown in the
+> dashboard, but running `monomind org run <org>` will not pick them up. Drive execution from
+> this file with `mastermind-execute`, or pass work explicitly via `org run --task`.
+
 ---
 
 ## Step 2 — Execute Action
@@ -82,7 +122,7 @@ else:
     print("  " + "─" * 102)
     for iss in issues:
         iid   = iss.get("id","?")[:28]
-        st    = iss.get("status","open")[:14]
+        st    = iss.get("status","todo")[:14]
         pri   = iss.get("priority","medium")[:8]
         title = (iss.get("title") or "-")[:38]
         asgn  = (iss.get("assigneeTitle") or iss.get("assigneeId") or "—")[:20]
@@ -137,24 +177,42 @@ PYEOF
 [ -z "$title" ] && { echo "ERROR: --title required."; exit 1; }
 
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-newId="issue-$(python3 -c 'import time; print(int(time.time()*1000))')"
+newId="issue-$(python3 -c 'import time; print(int(time.time()*1000))')-001"
+
+python3 - "$issuesFile" "$newId" "$title" "${description:-}" "${priority:-medium}" "${assignee:-}" "${workspace:-}" "${parent_id:-}" "$ts" <<'PYEOF'
+import json, os, sys
+path, iid, title, desc, pri, asgn, ws, parent, ts = sys.argv[1:]
+
+VALID_PRIORITY = {"low","medium","high","urgent"}
+if pri not in VALID_PRIORITY:
+    print(f"ERROR: priority '{pri}' must be one of {sorted(VALID_PRIORITY)}.")
+    sys.exit(1)
 
-python3 - "$issuesFile" "$newId" "$title" "${description:-}" "${priority:-medium}" "${assignee:-}" "${workspace:-}" "$ts" <<'PYEOF'
-import json, sys
-path, iid, title, desc, pri, asgn, ws, ts = sys.argv[1:]
 data = json.load(open(path))
+issues = data.setdefault("issues", [])
+
+if parent and not any(i.get("id") == parent for i in issues):
+    print(f"ERROR: parent issue '{parent}' not found.")
+    sys.exit(1)
+
 issue = {
     "id": iid, "title": title, "description": desc,
-    "status": "open", "priority": pri,
-    "assigneeId": asgn or None, "workspaceId": ws or None,
-    "createdAt": ts, "updatedAt": ts
+    "status": "todo", "priority": pri,
+    "assigneeId": asgn or None,
+    "assigneeAgentId": None, "assigneeUserId": None,
+    "parentId": parent or None,
+    "projectId": None, "workspaceId": ws or None,
+    "blockedByIssueIds": [],
+    "createdAt": ts, "updatedAt": ts,
 }
-data.setdefault("issues", []).append(issue)
-with open(path, "w") as f:
+issues.append(issue)
+tmp = path + ".tmp"
+with open(tmp, "w") as f:
     json.dump(data, f, indent=2)
+os.replace(tmp, path)
 print(f"  Created: {iid}")
 print(f"  Title:   {title}")
-print(f"  Status:  open  |  Priority: {pri}")
+print(f"  Status:  todo  |  Priority: {pri}" + (f"  |  Parent: {parent}" if parent else ""))
 PYEOF
 ```
 
@@ -165,8 +223,18 @@ PYEOF
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 
 python3 - "$issuesFile" "$issue_id" "${status:-}" "${priority:-}" "${title:-}" "$ts" <<'PYEOF'
-import json, sys
+import json, os, sys
 path, iid, new_st, new_pri, new_title, ts = sys.argv[1:]
+
+VALID_STATUS   = {"todo","in_progress","blocked","in_review","done","cancelled"}
+VALID_PRIORITY = {"low","medium","high","urgent"}
+if new_st and new_st not in VALID_STATUS:
+    print(f"ERROR: status '{new_st}' must be one of {sorted(VALID_STATUS)}.")
+    sys.exit(1)
+if new_pri and new_pri not in VALID_PRIORITY:
+    print(f"ERROR: priority '{new_pri}' must be one of {sorted(VALID_PRIORITY)}.")
+    sys.exit(1)
+
 data = json.load(open(path))
 issues = data.get("issues", [])
 found = False
@@ -182,8 +250,10 @@ if not found:
     print(f"ERROR: Issue '{iid}' not found.")
     sys.exit(1)
 data["issues"] = issues
-with open(path, "w") as f:
+tmp = path + ".tmp"
+with open(tmp, "w") as f:
     json.dump(data, f, indent=2)
+os.replace(tmp, path)
 print(f"  Updated: {iid}  (updatedAt: {ts})")
 PYEOF
 ```
@@ -195,7 +265,7 @@ PYEOF
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 
 python3 - "$issuesFile" "$issue_id" "$ts" <<'PYEOF'
-import json, sys
+import json, os, sys
 path, iid, ts = sys.argv[1], sys.argv[2], sys.argv[3]
 data = json.load(open(path))
 issues = data.get("issues", [])
@@ -211,14 +281,39 @@ if not found:
     print(f"ERROR: Issue '{iid}' not found.")
     sys.exit(1)
 data["issues"] = issues
-with open(path, "w") as f:
+tmp = path + ".tmp"
+with open(tmp, "w") as f:
     json.dump(data, f, indent=2)
+os.replace(tmp, path)
 print(f"  Closed: {iid}  (closedAt: {ts})")
 PYEOF
 ```
 
 ---
 
+## Step 2.5 — Append Activity Record
+
+After any `create`, `update`, or `close` action succeeds, append one line to the org's
+activity log. This is the only writer for `<org>-activity.jsonl`; seven skills read it.
+
+```bash
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+jq -cn \
+  --arg iid "${affected_issue_id}" \
+  --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+  --arg st "${resulting_status}" \
+  --arg ag "${assignee:-operator}" \
+  --arg act "${action}" \
+  --arg sm "${action} ${affected_issue_id}" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:$act, summary:$sm}' \
+  >> "$activityFile"
+```
+
+`affected_issue_id` is `$newId` for `create` and `$issue_id` for `update`/`close`;
+`resulting_status` is `todo`, the new status, or `done` respectively.
+
+---
+
 ## Step 3 — Return Output
 
 ```yaml

package/.claude/skills/mastermind-liveness/SKILL.md

@@ -64,6 +64,38 @@ issuesFile=".monomind/orgs/${org_name}-issues.json"
 stateFile=".monomind/orgs/${org_name}-state.json"
 ```
 
+Normalize any legacy records written by a pre-2.10 version of these skills. Idempotent — safe to run on every load. Guarded because this skill tolerates a missing issues file.
+
+```bash
+[ -f "$issuesFile" ] && python3 - "$issuesFile" <<'PYEOF'
+import json, sys
+path = sys.argv[1]
+data = json.load(open(path))
+RENAME = {
+    "assignee_id": "assigneeId", "assigned_to": "assigneeId",
+    "created_at": "createdAt", "updated_at": "updatedAt",
+    "closed_at": "closedAt", "project_id": "projectId",
+    "parent_id": "parentId", "recovery_status": "recoveryStatus",
+    "lastActivityAt": "updatedAt",
+}
+changed = False
+for iss in data.get("issues", []):
+    for old, new in RENAME.items():
+        if old in iss:
+            iss.setdefault(new, iss.pop(old))
+            iss.pop(old, None)
+            changed = True
+    if iss.get("status") == "open":
+        iss["status"] = "todo"
+        changed = True
+if changed:
+    tmp = path + ".tmp"
+    with open(tmp, "w") as f:
+        json.dump(data, f, indent=2)
+    import os; os.replace(tmp, path)
+PYEOF
+```
+
 ---
 
 ## Step 2 — Execute Action
@@ -108,35 +140,44 @@ now = datetime.utcnow()
 
 for iss in issues:
     status = iss.get("status","")
-    if status in terminal_statuses or status not in non_terminal_statuses:
+    iid    = iss.get("id","?")
+    title  = (iss.get("title") or "?")[:50]
+
+    if status in terminal_statuses:
+        continue
+    if status not in non_terminal_statuses:
+        # Silently skipping an unknown status is how issues become invisible.
+        warnings.append((iid, title, status, f"unknown status '{status}' — outside the canonical vocabulary"))
         continue
 
-    aId = iss.get("assigneeAgentId") or iss.get("assigneeId")
+    aId = iss.get("assigneeAgentId")
     uId = iss.get("assigneeUserId")
-    iid = iss.get("id","?")
-    title = iss.get("title","?")[:50]
 
-    # User-owned: skip strict execution checks
+    # Human-owned: the next move belongs to a person, not an execution path.
     if uId and not aId:
         healthy.append((iid, title, status, "user-owned"))
         continue
 
-    # Evaluate liveness
     paths = []
 
     run_id = iss.get("executionRunId") or iss.get("checkoutRunId")
     if run_id and run_id in active_runs:
         paths.append("active-run")
 
+    resolved_ids = {i.get("id") for i in issues if i.get("status") in terminal_statuses}
     blockers = iss.get("blockedByIssueIds") or []
-    if status == "blocked" and blockers:
-        unresolved = [b for b in blockers if b not in
-                      {i["id"] for i in issues if i.get("status") in terminal_statuses}]
-        if unresolved:
-            paths.append(f"blocked-by:{','.join(unresolved[:2])}")
-        else:
-            # All blockers resolved — should transition
-            warnings.append((iid, title, status, "all blockers resolved but issue still blocked"))
+    if status == "blocked":
+        if blockers:
+            unresolved = [b for b in blockers if b not in resolved_ids]
+            if unresolved:
+                paths.append(f"blocked-by:{','.join(unresolved[:2])}")
+            else:
+                warnings.append((iid, title, status, "all blockers resolved but issue still blocked"))
+        elif not iss.get("recoveryActions"):
+            # Liveness Contract: blocked requires a named dependency or an
+            # explicit human decision. This issue records neither.
+            stalled.append((iid, title, status, "blocked with no blockedByIssueIds and no recovery action"))
+            continue
 
     if iss.get("executionPolicy", {}).get("monitor", {}).get("nextCheckAt"):
         paths.append("monitor")
@@ -150,7 +191,10 @@ for iss in issues:
     if iss.get("currentParticipant"):
         paths.append("participant")
 
-    # Stale heartbeat check (in_progress with no run and no recent update)
+    if status == "in_review" and not (iss.get("reviewerId") or iss.get("currentParticipant")):
+        stalled.append((iid, title, status, "in_review with no named reviewer"))
+        continue
+
     if status == "in_progress" and aId and not paths:
         updated = iss.get("updatedAt","")
         if updated:
@@ -159,16 +203,19 @@ for iss in issues:
                 if age > timedelta(hours=2):
                     stalled.append((iid, title, status, f"in_progress {int(age.total_seconds()//3600)}h with no active path"))
                     continue
-            except: pass
+            except Exception:
+                pass
         stalled.append((iid, title, status, "in_progress with no active execution path"))
         continue
 
-    if not paths and status == "todo" and aId:
-        warnings.append((iid, title, status, "todo assigned to agent — may need wakeup"))
-    elif paths:
+    if paths:
         healthy.append((iid, title, status, " + ".join(paths)))
+    elif not aId:
+        warnings.append((iid, title, status, "no assignee — nothing will pick this up"))
+    elif status == "todo":
+        warnings.append((iid, title, status, "todo assigned to agent — may need wakeup"))
     else:
-        healthy.append((iid, title, status, "no agent assignee"))
+        stalled.append((iid, title, status, f"{status} with an agent assignee but no execution path"))
 
 print(f"  ✓ Healthy: {len(healthy)}")
 if healthy:
@@ -206,7 +253,7 @@ Claim an issue for execution by an agent run. Sets `checkoutRunId` and `executio
 ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 
 python3 - "$issuesFile" "$issue_id" "$agent_id" "$run_id" "$ts" <<'PYEOF'
-import json, sys
+import json, os, sys
 
 path, iid, agentId, runId, ts = sys.argv[1:]
 data = json.load(open(path))
@@ -224,6 +271,7 @@ for iss in issues:
         iss["executionRunId"] = runId
         iss["assigneeId"]     = agentId
         iss["assigneeAgentId"]= agentId
+        iss["assigneeUserId"] = None
         iss["status"]         = "in_progress"
         iss["checkedOutAt"]   = ts
         iss["updatedAt"]      = ts
@@ -237,9 +285,16 @@ if not found:
     sys.exit(1)
 
 data["issues"] = issues
-with open(path, "w") as f:
+tmp = path + ".tmp"
+with open(tmp, "w") as f:
     json.dump(data, f, indent=2)
+os.replace(tmp, path)
 PYEOF
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+jq -cn --arg iid "$issue_id" --arg ts "$ts" --arg st "in_progress" --arg ag "$agent_id" --arg sm "checkout $issue_id" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"checkout", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ### release
@@ -269,13 +324,21 @@ for iss in issues:
         print(f"  RELEASED: Checkout cleared for issue {iid}")
         print(f"  Status remains: {iss.get('status','?')} — update separately if needed.")
         data["issues"] = issues
-        with open(path, "w") as f:
+        tmp = path + ".tmp"
+        with open(tmp, "w") as f:
             json.dump(data, f, indent=2)
+        os.replace(tmp, path)
         sys.exit(0)
 
 print(f"  ERROR: Issue '{iid}' not found.")
 sys.exit(1)
 PYEOF
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+currentStatus=$(jq -r --arg id "$issue_id" '(.issues // [])[] | select(.id == $id) | .status // "todo"' "$issuesFile")
+jq -cn --arg iid "$issue_id" --arg ts "$ts" --arg st "$currentStatus" --arg ag "${agent_id:-operator}" --arg sm "release $issue_id" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"release", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ### wakeup
@@ -296,7 +359,7 @@ if not iss:
     print(f"  ERROR: Issue '{iid}' not found.")
     sys.exit(1)
 
-checkout_agent = iss.get("assigneeAgentId") or iss.get("assigneeId","")
+checkout_agent = iss.get("assigneeAgentId") or ""
 checkout_run   = iss.get("checkoutRunId","")
 
 # Port of Paperclip's shouldWakeAssigneeOnCheckout logic
@@ -338,7 +401,7 @@ ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 recoveryId="recovery-$(python3 -c 'import time; print(int(time.time()*1000))')"
 
 python3 - "$issuesFile" "$issue_id" "$recoveryId" "${agent_id:-operator}" "$reason" "$ts" <<'PYEOF'
-import json, sys
+import json, os, sys
 
 path, iid, rid, owner, cause, ts = sys.argv[1:]
 data = json.load(open(path))
@@ -359,8 +422,10 @@ for iss in issues:
         iss["status"] = "blocked"
         iss["updatedAt"] = ts
         data["issues"] = issues
-        with open(path, "w") as f:
+        tmp = path + ".tmp"
+        with open(tmp, "w") as f:
             json.dump(data, f, indent=2)
+        os.replace(tmp, path)
         print(f"  RECOVERY ACTION FILED: {rid}")
         print(f"  Issue {iid} → status: blocked (pending recovery)")
         print(f"  Owner: {owner}")
@@ -371,6 +436,11 @@ for iss in issues:
 print(f"  ERROR: Issue '{iid}' not found.")
 sys.exit(1)
 PYEOF
+
+activityFile=".monomind/orgs/${org_name}-activity.jsonl"
+jq -cn --arg iid "$issue_id" --arg ts "$ts" --arg st "blocked" --arg ag "${agent_id:-operator}" --arg sm "recover $issue_id" \
+  '{issue_id:$iid, ts:$ts, status:$st, tokens:null, agent:$ag, type:"recover", summary:$sm}' \
+  >> "$activityFile"
 ```
 
 ---