mastermind-workspaces

Mastermind Workspaces

This skill is invoked directly via /mastermind-workspaces.

---

Inputs

• brain_context: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
• org_name: org to manage workspaces for (required)
• action: list | status | attach | detach | stop | prune
• workspace_id: workspace id (required for status/detach/stop)
• project_id: project to filter by (optional for list)
• agent_id: agent to assign to workspace (required for attach)
• worktree_path: filesystem path of the worktree (required for attach)
• caller: command | master

---

Workspace Model

A workspace is a git worktree assigned to a project, optionally running services and assigned to an agent.

{
  "id": "ws-abc123",
  "project_id": "project-slug",
  "agent_id": "backend-dev",
  "worktree_path": "/tmp/monomind/worktrees/project-slug-abc123",
  "branch": "feat/my-feature",
  "status": "active",
  "services": ["dev-server", "db-watcher"],
  "createdAt": "2026-01-01T00:00:00Z",
  "lastActiveAt": "2026-01-02T00:00:00Z"
}

---

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 Workspace Data

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

wsFile=".monomind/orgs/${org_name}-workspaces.json"
[ ! -f "$wsFile" ] && echo '{"workspaces":[]}' > "$wsFile"

projectsFile=".monomind/orgs/${org_name}-projects.json"
worktreeRegistry=".monomind/orgs/${org_name}-worktrees.json"

---

Step 2 — Execute Action

list (default)

echo "WORKSPACES — org: $org_name"
[ -n "$project_id" ] && echo "(filtered by project: $project_id)"
echo "────────────────────────────────────────────────────────"

total=$(jq '.workspaces | length' "$wsFile")

if [ "$total" -eq 0 ]; then
  echo "  No workspaces. Use --action attach to register one."
else
  # Group by project
  projects=$(jq -r --arg pid "${project_id:-}" '
    .workspaces |
    if $pid != "" then map(select(.project_id == $pid)) else . end |
    [.[].project_id] | unique[]
  ' "$wsFile")

  while IFS= read -r proj; do
    [ -z "$proj" ] && continue
    projName=$([ -f "$projectsFile" ] && jq -r --arg pid "$proj" '(.projects // [])[] | select(.id == $pid) | .name // $pid' "$projectsFile" || echo "$proj")
    echo ""
    echo "  PROJECT: $projName"
    echo "  ──────────────────────────────────────────────────"
    printf "  %-18s %-14s %-18s %-12s %-6s %s\n" "ID" "STATUS" "AGENT" "BRANCH" "SVCS" "PATH"

    jq -r --arg pid "$proj" '(.workspaces // [])[] | select(.project_id == $pid) |
      [.id, (.status // "unknown"), (.agent_id // "(none)"),
       (.branch // "?"), ((.services // []) | length | tostring),
       (.worktree_path // "-")]
      | @tsv' "$wsFile" | while IFS=$'\t' read -r id st ag br svc path; do
      printf "  %-18s %-14s %-18s %-12s %-6s %s\n" "$id" "$st" "$ag" "$br" "$svc" "$path"
    done
  done <<< "$projects"
fi

echo ""
echo "Total: $total workspace(s)"