Files
Sportstime/.planning/ROADMAP.md
Trey t 6e00663fec docs(08-01): complete GameDAGRouter edge cases plan
Plan 08-01 complete:
- 17 TDD tests for GameDAGRouter edge cases
- canTransition boundary validation tests
- Anchor filtering and repeat city handling tests

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 11:52:51 -06:00

117 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Roadmap: SportsTime
## Milestones
- ✅ [v1.0 Data Pipeline](milestones/v1.0-ROADMAP.md) (Phases 1-7) — SHIPPED 2026-01-10
- 🚧 **v1.1 TDD & Correctness** — Phases 8-12 (in progress)
## Completed Milestones
<details>
<summary>v1.0 Data Pipeline (Phases 1-7) — SHIPPED 2026-01-10</summary>
- [x] Phase 1: Script Architecture (3/3 plans) — completed 2026-01-10
- [x] Phase 2: Stadium Foundation (2/2 plans) — completed 2026-01-10
- [x] Phase 2.1: Additional Sports Stadiums (3/3 plans) — completed 2026-01-10
- [x] Phase 3: Alias Systems (2/2 plans) — completed 2026-01-10
- [x] Phase 4: Canonical Linking (1/1 plans) — completed 2026-01-10
- [x] Phase 5: CloudKit CRUD (2/2 plans) — completed 2026-01-10
- [x] Phase 6: Validation Reports (1/1 plans) — completed 2026-01-10
- [x] Phase 7: Testing & Documentation (1/1 plans) — completed 2026-01-10
**Full details:** [milestones/v1.0-ROADMAP.md](milestones/v1.0-ROADMAP.md)
</details>
### 🚧 v1.1 TDD & Correctness (In Progress)
**Milestone Goal:** Test-driven validation of trip planning engine — tests define correctness, code must match
**Constraints:**
- TDD approach: Write tests first with expected behavior, then fix code if tests fail (never modify tests to pass)
- Tests must include edge cases and error conditions
- Mix of short and long trips in test data, varied by region and mileage
#### Phase 8: DAG System TDD
**Goal**: Performance and edge case tests with tens of thousands of objects; fix code if tests fail
**Depends on**: v1.0 milestone complete
**Research**: Unlikely (internal patterns, existing code)
**Plans**: 2
Plans:
- [x] 08-01: GameDAGRouter edge cases and anchor validation TDD — completed 2026-01-10
- [ ] 08-02: GameDAGRouter performance with large datasets and diversity coverage TDD
#### Phase 9: Trip Planner Modes TDD
**Goal**: Test game scheduling (by dates), must-see games inclusion, start/end cities routing
**Depends on**: Phase 8
**Research**: Unlikely (internal patterns)
**Plans**: TBD
Test expectations:
- By Dates: Game scheduling fits date range, no conflicts, date boundaries respect timezone
- Must-See: All selected games appear, filler games don't conflict, impossible combos return error
- Start/End Cities: Route begins at start city, ends at end city, games found along corridor
Plans:
- [ ] 09-01: TBD (run /gsd:plan-phase 9 to break down)
#### Phase 10: Trip Builder Options TDD
**Goal**: Test repeat cities option (ON/OFF) and must-stops (non-game attractions)
**Depends on**: Phase 9
**Research**: Unlikely (internal patterns)
**Plans**: TBD
Test expectations:
- Repeat Cities ON: Can visit Dallas twice for different games
- Repeat Cities OFF: Visit each city once, algorithm picks best game
- Must-stops: Non-game POIs (attractions) appear in itinerary
Plans:
- [ ] 10-01: TBD (run /gsd:plan-phase 10 to break down)
#### Phase 11: Itinerary & Constraints TDD
**Goal**: Test travel itinerary output (directions, distance/time) and driving limits
**Depends on**: Phase 10
**Research**: Unlikely (internal patterns)
**Plans**: TBD
Test expectations:
- Travel itinerary: Distance and time shown between each stop
- Driving limits: 2 drivers × 400mi/day max = 800mi/day allowed; trips exceeding limit rejected
Plans:
- [ ] 11-01: TBD (run /gsd:plan-phase 11 to break down)
#### Phase 12: Integration Validation
**Goal**: End-to-end scenarios and regression suite covering all planning modes
**Depends on**: Phase 11
**Research**: Unlikely (internal patterns)
**Plans**: TBD
Plans:
- [ ] 12-01: TBD (run /gsd:plan-phase 12 to break down)
## Progress
| Phase | Milestone | Plans Complete | Status | Completed |
|-------|-----------|----------------|--------|-----------|
| 1. Script Architecture | v1.0 | 3/3 | Complete | 2026-01-10 |
| 2. Stadium Foundation | v1.0 | 2/2 | Complete | 2026-01-10 |
| 2.1. Additional Sports Stadiums | v1.0 | 3/3 | Complete | 2026-01-10 |
| 3. Alias Systems | v1.0 | 2/2 | Complete | 2026-01-10 |
| 4. Canonical Linking | v1.0 | 1/1 | Complete | 2026-01-10 |
| 5. CloudKit CRUD | v1.0 | 2/2 | Complete | 2026-01-10 |
| 6. Validation Reports | v1.0 | 1/1 | Complete | 2026-01-10 |
| 7. Testing & Documentation | v1.0 | 1/1 | Complete | 2026-01-10 |
| 8. DAG System TDD | v1.1 | 1/2 | In Progress | - |
| 9. Trip Planner Modes TDD | v1.1 | 0/? | Not started | - |
| 10. Trip Builder Options TDD | v1.1 | 0/? | Not started | - |
| 11. Itinerary & Constraints TDD | v1.1 | 0/? | Not started | - |
| 12. Integration Validation | v1.1 | 0/? | Not started | - |