mastermind-approval-detail

name	mastermind-approval-detail
description	Mastermind approval-detail — deep inspection and action on a single approval request. View approval metadata, payload, comments, linked issues, and perform approve/reject/revision/resubmit actions. Mirrors ApprovalDetail.tsx.
type	domain-skill
default_mode	confirm

Mastermind Approval Detail

This skill is invoked by mastermind:approval-detail or directly via /mastermind:approval-detail.

---

Inputs

• brain_context: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
• org_name: org the approval belongs to (required)
• approval_id: approval id or short prefix (required)
• action: show | comments | linked-issues | comment | approve | reject | request-revision | resubmit
• comment_body: comment text (for comment action)
• caller: command | master

---

Approval Statuses

Status	Meaning
pending	Awaiting review — actionable
approved	Approved and resolved
rejected	Rejected and resolved
revision_requested	Agent asked to revise — still actionable
resubmitted	Agent resubmitted after revision

---

Approval Types

Type	Description
budget_override_required	Agent needs to exceed budget cap
agent_hire	Agent is requesting to hire another agent
tool_grant	Agent requests a new tool permission
action_confirm	Agent requests confirmation before a destructive action
custom	Plugin-defined approval type

---

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 Approval

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

approvalsFile=".monomind/orgs/${org_name}-approvals.json"
[ ! -f "$approvalsFile" ] && { echo "ERROR: No approvals file for org '${org_name}'."; exit 1; }

# Find approval by full id or prefix
approvalDef=$(jq -r --arg id "$approval_id" \
  '(.approvals // [])[] | select(.id == $id or (.id | startswith($id)))' \
  "$approvalsFile" | head -1)
[ -z "$approvalDef" ] && { echo "ERROR: Approval '${approval_id}' not found."; exit 1; }

approvalId=$(echo "$approvalDef" | jq -r '.id')
commentsFile=".monomind/orgs/${org_name}-approval-comments.jsonl"

---

Step 2 — Execute Action

show (default)

echo "APPROVAL — ${approvalId}"
echo "────────────────────────────────────────────────────────"

echo "$approvalDef" | jq -r '
  "  ID:         \(.id)",
  "  Type:       \(.type // "unknown")",
  "  Status:     \(.status // "pending")",
  "  Agent:      \(.agentId // "(unknown)")",
  "  Created:    \(.createdAt // "-")",
  "  Resolved:   \(.resolvedAt // "-")"
'

echo ""
echo "PAYLOAD"
echo "────────────────────────────────────────────────────────"
echo "$approvalDef" | jq -r '.payload // {}' | jq .

status=$(echo "$approvalDef" | jq -r '.status // "pending"')
if [ "$status" = "pending" ] || [ "$status" = "revision_requested" ]; then
  echo ""
  echo "ACTIONS AVAILABLE"
  echo "  approve:          --action approve"
  echo "  reject:           --action reject"
  echo "  request revision: --action request-revision"
  echo "  add comment:      --action comment --comment-body 'your notes'"
fi

comments

echo "COMMENTS — ${approvalId}"
echo "────────────────────────────────────────────────────────"

if [ ! -f "$commentsFile" ]; then
  echo "  No comments."
else
  count=$(grep -c "\"approvalId\":\"${approvalId}\"" "$commentsFile" 2>/dev/null || echo 0)
  echo "  Total: $count"
  echo ""
  grep "\"approvalId\":\"${approvalId}\"" "$commentsFile" 2>/dev/null | while IFS= read -r line; do
    author=$(echo "$line" | jq -r '.authorType // "user"')
    body=$(echo "$line" | jq -r '.body // ""')
    ts=$(echo "$line" | jq -r '.createdAt // "-"')
    echo "  [$ts] ($author)"
    echo "  $body"
    echo ""
  done
fi

linked-issues

issuesFile=".monomind/orgs/${org_name}-issues.json"
echo "LINKED ISSUES — ${approvalId}"
echo "────────────────────────────────────────────────────────"
printf "%-24s %-12s %s\n" "ID" "STATUS" "TITLE"
echo "────────────────────────────────────────────────────────"

linkedIds=$(echo "$approvalDef" | jq -r '(.linkedIssueIds // [])[]')
if [ -z "$linkedIds" ]; then
  echo "  No linked issues."
else
  if [ -f "$issuesFile" ]; then
    echo "$linkedIds" | while read -r iid; do
      row=$(jq -r --arg id "$iid" '(.issues // [])[] | select(.id == $id) | [.id, (.status // "open"), (.title // "(no title)")] | @tsv' "$issuesFile")
      [ -n "$row" ] && echo "$row" | while IFS=$'\t' read -r id st title; do
        printf "%-24s %-12s %s\n" "$id" "$st" "$title"
      done || printf "%-24s %-12s %s\n" "$iid" "(unknown)" "(not found)"
    done
  fi
fi

comment

[ -z "$comment_body" ] && { echo "ERROR: --comment-body required."; exit 1; }

ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
entry=$(jq -n \
  --arg aid "$approvalId" \
  --arg org "$org_name" \
  --arg body "$comment_body" \
  --arg ts "$ts" \
  '{"approvalId":$aid,"org":$org,"authorType":"operator","body":$body,"createdAt":$ts}')

echo "$entry" >> "$commentsFile"

echo "Comment added to approval ${approvalId}."
echo "  Body: $comment_body"
echo "  At:   $ts"

approve

status=$(echo "$approvalDef" | jq -r '.status // "pending"')
if [ "$status" != "pending" ] && [ "$status" != "revision_requested" ]; then
  echo "ERROR: Approval is in status '$status' — cannot approve."
  exit 1
fi

ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
tmp="${approvalsFile}.tmp"
jq --arg id "$approvalId" --arg ts "$ts" \
  '.approvals = [(.approvals // [])[] | if .id == $id then
     .status = "approved" | .resolvedAt = $ts | .resolvedBy = "operator"
   else . end]' \
  "$approvalsFile" > "$tmp" && mv "$tmp" "$approvalsFile"

echo "Approval '${approvalId}' APPROVED."
echo "  Resolved at: $ts"
echo "  Agent will be notified to proceed."

reject

ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
tmp="${approvalsFile}.tmp"
jq --arg id "$approvalId" --arg ts "$ts" \
  '.approvals = [(.approvals // [])[] | if .id == $id then
     .status = "rejected" | .resolvedAt = $ts | .resolvedBy = "operator"
   else . end]' \
  "$approvalsFile" > "$tmp" && mv "$tmp" "$approvalsFile"

echo "Approval '${approvalId}' REJECTED."
echo "  Resolved at: $ts"

request-revision

ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
tmp="${approvalsFile}.tmp"
jq --arg id "$approvalId" --arg ts "$ts" \
  '.approvals = [(.approvals // [])[] | if .id == $id then
     .status = "revision_requested" | .revisionRequestedAt = $ts
   else . end]' \
  "$approvalsFile" > "$tmp" && mv "$tmp" "$approvalsFile"

echo "Revision requested for approval '${approvalId}'."
echo "  Agent will be notified to revise and resubmit."

resubmit

ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
tmp="${approvalsFile}.tmp"
jq --arg id "$approvalId" --arg ts "$ts" \
  '.approvals = [(.approvals // [])[] | if .id == $id then
     .status = "pending" | .resubmittedAt = $ts
   else . end]' \
  "$approvalsFile" > "$tmp" && mv "$tmp" "$approvalsFile"

echo "Approval '${approvalId}' resubmitted (status reset to pending)."

---

Step 3 — Return Output

domain: ops
status: complete
action: <action>
org: <org_name>
approval_id: <approval_id>
approval_status: <status>

---

Step 4 — Brain Write (standalone only)

If caller is not "command", follow mastermind-protocol/SKILL.md Brain Write Procedure for domain ops.