execute-parallel

Spawn N concurrent /ai-sdlc execute sessions in tmux panes (AISDLC-462).

Hard rules

1. Hard cap: maximum 5 concurrent sessions. Refuses when already at cap.
2. Resource gate: refuses if available memory < 4GB OR 1-min load avg >= ncpu.
3. Mutual-awareness: refuses to spawn a task already in sessions/ with status != done|failed.
4. Operator confirmation: always AskUserQuestion before spawning.
5. Never merge PRs. Never force-push to main/master.

Path resolution

PLUGIN_SCRIPTS_DIR="${CLAUDE_PLUGIN_DIR:-${CLAUDE_PLUGIN_ROOT:-$(pwd)/ai-sdlc-plugin}}/scripts"
if [ -z "${PIPELINE_CLI_BIN:-}" ]; then
  PIPELINE_CLI_BIN=$(bash "$PLUGIN_SCRIPTS_DIR/resolve-pipeline-cli.sh") || exit 1
fi

Step 1 — Parse arguments

ARG="${ARGUMENTS:-}"
REQUESTED_COUNT=4
EXPLICIT_TASKS=""

# ─── Task ID validation gate (SECURITY) ──────────────────────────────────────
# ALL task IDs from ALL input pathways (--tasks arg, frontier JSON, operator
# confirmation) MUST pass through this function before being interpolated into
# tmux commands, file paths, or branch names. Reject with a clear error if any
# ID fails — this is the primary defense against command injection.
validate_task_id() {
  local id="$1"
  if ! printf '%s' "$id" | grep -qE '^[A-Z][A-Z0-9]+-[0-9]+(\.[0-9]+)*$'; then
    echo "ERROR: invalid task ID '$id' — must match ^[A-Z][A-Z0-9]+-[0-9]+(\.[0-9]+)*$" >&2
    return 1
  fi
  return 0
}

# Parse --count N
if printf '%s' "$ARG" | grep -q '\-\-count'; then
  REQUESTED_COUNT=$(printf '%s' "$ARG" | sed -E 's/.*--count[= ]([0-9]+).*/\1/')
fi
# Clamp to max 5
if [ "$REQUESTED_COUNT" -gt 5 ]; then
  echo "WARNING: --count $REQUESTED_COUNT exceeds hard cap of 5. Clamping to 5." >&2
  REQUESTED_COUNT=5
fi

# Parse --tasks AISDLC-N,...
if printf '%s' "$ARG" | grep -q '\-\-tasks'; then
  EXPLICIT_TASKS=$(printf '%s' "$ARG" | sed -E 's/.*--tasks[= ]([A-Z0-9,-]+).*/\1/')
fi

Step 2 — Resource gate

RESOURCE_GATE_SCRIPT="$PLUGIN_SCRIPTS_DIR/check-resource-gate.sh"
if [ -f "$RESOURCE_GATE_SCRIPT" ]; then
  bash "$RESOURCE_GATE_SCRIPT" || {
    echo "ERROR: resource gate refused — see stderr above." >&2
    echo "Set AI_SDLC_EXECUTE_PARALLEL_SKIP_RESOURCE_GATE=1 to override." >&2
    exit 1
  }
else
  echo "WARNING: check-resource-gate.sh not found at $RESOURCE_GATE_SCRIPT; skipping resource check." >&2
fi