squad-heartbeat

Shared context: read ../squad/shared.md for pipeline levels, status transitions, API endpoints, error handling, and agent context flow. Schema: read ../squad/schema.md for full DB schema, column descriptions, and JSON field formats.

/squad-heartbeat [--project X] [--days N] [--dry-run] -- Stagnant Task Detection

Scan all active projects (or a single project) for tasks that have had no agent activity for N days. Output a markdown table of stagnant tasks and optionally append a Heartbeat warning event to each task's activity stream.

Defaults: --days 3, all active projects, writes a Heartbeat activity event per stagnant task. --dry-run: report only, no activity writes.

Procedure

① Auth & Argument Setup

   Load credentials using the standard shared.md pattern: