# IMPLEMENTATION.md — Autopilot Runtime

## Changes Made
- Created `scripts/autopilot.py` — a real Python implementation replacing the pseudocode `drive_all()` loop
- Added stuck-task detection to `status.py --audit` as Category 5

## autopilot.py Commands
- `--summary`: Shows project task overview (total, terminal, blocked, unblocked, stuck)
- `--drive`: Drives one step — finds the most advanced unblocked task and outputs next instructions
- `--loop`: Runs continuous drive loop with configurable iterations and delay
- `--stuck`: Detects tasks stuck in non-terminal phases >N minutes (default: 60)

## How It Works
- `scan_all_tasks()` reads .state files from all task directories
- `is_terminal()` checks for complete/human_intervention phases
- `needs_user_input()` detects approval gates and VERDICT.md with FAIL/NEEDS_REVIEW
- `sort_by_advancement()` prioritizes tasks closest to completion
- `detect_stuck_tasks()` finds tasks unchanged >60 minutes in non-terminal phases
- Empty queue outputs actionable instructions to create new tasks