roll-.dreamlisted

# Roll Dream (Nightly Code Health Scan) > Follows the Architecture Constraints, Development Discipline, and Engineering > Common Sense defined in the project AGENTS.md. **Passively triggered — do not invoke manually.** Runs nightly via scheduler. Consolidates structural signals accumulated during the day, surfaces technical debt, and writes REFACTOR entries to BACKLOG. The human reviews the dream log in the morning brief. ## Distinction from roll-sentinel | | roll-sentinel | roll-.dream | |--|--------------|------------| | **Trigger** | Post-deploy, scheduled patrol | Nightly, fixed schedule | | **Target** | Runtime behavior (production) | Code structure (codebase) | | **Output** | FIX entries | REFACTOR entries + dream log | | **Question** | "Is the product working?" | "Is the code healthy?" | ## Scan Logic Run all scans every night. Each scan is independent. ### Scan 1 — Dead Code Find code that is defined but never referenced: ```bash # Unused exports (TypeScript/JS) grep -r "^export " src/ --include="*.ts" -l | while read f; do symbol=$(grep -o "export \(function\|const\|class\|type\|interface\) [A-Za-z]*" "$f" | awk '{print $NF}') # check if symbol appears anywhere else in the codebase done # Unused files (no imports pointing to them) # Git: files not touched in 90+ days and not imported anywhere git log --since="90 days ago" --name-only --format="" | sort -u > /tmp/recently_touched ``` Flag: files or exports with zero references outside their own file. #