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>
117 lines
4.4 KiB
Markdown
117 lines
4.4 KiB
Markdown
# 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 | - |
|