mastermind-liveness

Mastermind Liveness

This skill is invoked directly via /mastermind-liveness.

---

Inputs

• brain_context: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
• org_name: org to check (required)
• action: check | checkout | release | wakeup | recover
• issue_id: specific issue to operate on (required for checkout/release/wakeup/recover)
• agent_id: agent claiming checkout (required for checkout)
• run_id: execution run ID (required for checkout)
• reason: recovery reason (required for recover)
• caller: command | master

---

Liveness Contract

An issue is healthy when the product can answer "what moves this forward next?" without requiring a human to reconstruct intent.

An issue is stalled when it is non-terminal but has no:

• active run linked to the issue
• queued wake or continuation deliverable to the responsible agent
• explicit execution-policy participant
• pending interaction waiting on a specific responder
• one-shot monitor (nextCheckAt) that will wake the assignee
• human owner (assigneeUserId)
• first-class blocker chain whose leaf issues are themselves healthy
• open explicit recovery action naming owner + next action

Valid non-terminal statuses for agent-owned work: todo, in_progress, blocked, in_review

Status → execution expectation:

• todo: actionable but not yet claimed — may still need wake path to assignee
• in_progress: must have agent assignee + active execution backing (strict)
• blocked: must have named external dependency (blockedByIssueIds) or explicit human decision needed
• in_review: review participant must be named; next move belongs to reviewer

---

Step 0 — Brain Load (standalone only)

If caller is not "command", load brain context following mastermind-protocol/SKILL.md Brain Load Procedure with namespace: ops.

---

Step 1 — Load Org and Issues

orgFile=".monomind/orgs/${org_name}.json"
[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }

issuesFile=".monomind/orgs/${org_name}-issues.json"
stateFile=".monomind/orgs/${org_name}-state.json"