execute-parallel-cleanup

Kill in-flight /ai-sdlc execute-parallel panes and archive their session files (AISDLC-462).

Hard rules

1. AskUserQuestion before kill. Always list what will be killed and ask for confirmation.
2. Never merge PRs. Never close PRs or issues.
3. If a session is already done/failed, archive it without killing (no tmux window to kill).

Arguments

• No arguments: list and clean up ALL sessions (done, failed, and optionally in-progress).
• --all: same as no arguments.
• AISDLC-N,AISDLC-M,...: target specific task IDs only.

ARG="${ARGUMENTS:-}"
BOARD_DIR=".ai-sdlc/dispatch"
SESSIONS_DIR="$BOARD_DIR/sessions"
ARCHIVE_DIR="$SESSIONS_DIR/archived"
TMUX_SESSION="ai-sdlc-parallel"

# Parse target tasks
EXPLICIT_TASKS=""
if [ -n "$ARG" ] && [ "$ARG" != "--all" ]; then
  EXPLICIT_TASKS=$(printf '%s' "$ARG" | tr -d ' ')
fi

if [ ! -d "$SESSIONS_DIR" ]; then
  echo "No sessions directory at $SESSIONS_DIR. Nothing to clean up."
  exit 0
fi

mkdir -p "$ARCHIVE_DIR"

Step 1 — List sessions to clean up

# Collect candidate session files
CANDIDATES_JSON=$(node -e "
  const fs = require('fs');
  const path = require('path');
  const sessionsDir = process.argv[1];
  const explicitTasks = process.argv[2] ? process.argv[2].split(',').map(t => t.trim().toUpperCase()) : [];

  const sessions = [];
  try {
    const files = fs.readdirSync(sessionsDir).filter(f => f.endsWith('.session.json'));
    for (const f of files) {
      try {
        const s = JSON.parse(fs.readFileSync(path.join(sessionsDir, f), 'utf8'));
        if (explicitTasks.length === 0 || explicitTasks.includes((s.taskId || '').toUpperCase())) {
          sessions.push(s);
        }
      } catch {}
    }
  } catch {}

  process.stdout.write(JSON.stringify(sessions));
" "$SESSIONS_DIR" "$EXPLICIT_TASKS" 2>/dev/null || echo '[]')

Step 2 — Present the list and ask for confirmation (AskUserQuestion)

List all candidate sessions with their status and ask the operator to confirm before killing any in-progress sessions.