command-ops

Command Operations

On-demand only. Command is no longer launched by squadrant launch --all. You were spawned by squadrant command --task <briefing|learnings-review|wiki-aggregate> to run a single task and exit. Do the task, then exit cleanly — no persistent loop.

Daily Briefing (Session Start)

Run when session starts, or user says "morning", "catch up", "summary":

1. Check handoffs from all projects (context from yesterday's sessions):

for project in $(cat ~/.config/squadrant/config.json | python3 -c "import json,sys; [print(p) for p in json.loads(sys.stdin.read())['projects']]"); do
  echo "=== $project ==="
  ~/.config/squadrant/scripts/read-handoff.sh "$project" --keep
done

Handoffs contain: currentState, openBranches, nextSteps, blockedItems, decisions. Use these to understand where each project left off.

1. Search claude-mem (mem-search skill) for recent activity across all projects.
2. Read yesterday's logs:

YESTERDAY=$(date -v-1d +"%Y-%m-%d")
for project in $(cat ~/.config/squadrant/config.json | python3 -c "import json,sys; [print(p) for p in json.loads(sys.stdin.read())['projects']]"); do
  echo "=== $project ==="
  cat ~/squadrant/workspace/"$project"/artifacts/daily-logs/"${YESTERDAY}.md" 2>/dev/null || echo "(no log)"
done

1. Run quick standup for context: squadrant standup --yesterday --raw
2. Present briefing, then save to {hubVault}/daily-logs/YYYY-MM-DD.md

Delegation Workflow

When the user gives a task for a project:

1. Identify project

Match to ~/.config/squadrant/config.json.

2. Check for captain workspace

squadrant runtime list

CRITICAL: Match the EXACT captainName from config. Brove ≠ ⚓ brove-captain.

3. Freshness gate (run BEFORE deciding to reuse)

A name match is not sufficient — the workspace may be holding a session from a previous day. Check sessions.json against today before reusing:

TODAY=$(date +%Y-%m-%d)
S="${SQUADRANT_STATE_DIR:-${XDG_STATE_HOME:-$HOME/.local/state}/squadrant}/sessions.json"
[ -f "$S" ] || S="$HOME/.config/squadrant/sessions.json"  # pre-#983 location
LAST=$(python3 -c "import json,sys; d=json.load(open(sys.argv[1])); print(d.get('workspaces',{}).get('{captainName}',{}).get('lastLaunched',''))" "$S" 2>/dev/null)
[ "$LAST" = "$TODAY" ] && echo "fresh" || echo "stale"

• fresh → reuse the existing workspace, proceed to step 5.
• stale (or no entry) → close the existing workspace, then go to step 4 to respawn so spawn-workspace.sh runs its ↻ new day — starting fresh session path:

  squadrant runtime stop <project>