# Roadmap: opendeviationbar-py

## Milestones

- ✅ **v1.0 Junction Fix** — Phases 1-3 (shipped 2026-03-22) — [archive](milestones/v1.0-ROADMAP.md)
- ✅ **v1.4 Zero-Gap Zero-Overlap Guarantee** — Phases 1-6 (shipped 2026-03-23) — [archive](milestones/v1.4-ROADMAP.md)
- ✅ **v1.5 Sidecar Startup Architecture** — Phases 1-3 (shipped 2026-03-23) — [archive](milestones/v1.5-ROADMAP.md)

## Phases

(Next milestone to be defined via `/gsd:new-milestone`)

## Progress

| Phase                  | Milestone | Plans Complete | Status   | Completed  |
| ---------------------- | --------- | -------------- | -------- | ---------- |
| 1. Dedup Floor Fix     | v1.4      | 2/2            | Complete    | 2026-03-24 |
| 2. Midnight Preflight  | v1.4      | 2/2            | Complete    | 2026-03-24 |
| 3. Heartbeat Telemetry | v1.4      | 2/2            | Complete    | 2026-03-24 |
| 4. WS Resilience       | v1.4      | 2/2            | Complete | 2026-03-22 |
| 5. Seeder REST         | v1.4      | 4/4            | Complete | 2026-03-22 |
| 6. Memory Efficiency   | v1.4      | 4/4            | Complete | 2026-03-23 |
| 7. Yesterday Check     | v1.5      | 1/1            | Complete | 2026-03-23 |
| 8. Kintsugi Priority   | v1.5      | 1/1            | Complete | 2026-03-23 |
| 9. Startup Validation  | v1.5      | 1/1            | Complete | 2026-03-23 |

### Phase 1: Modularize long files: live_engine.rs, checkpoint.py, backfill.py

<!-- status: complete -->

**Goal:** Split the 3 longest files in the codebase into focused submodules for maintainability, with zero behavioral changes and full backward compatibility.
**Requirements**: TBD
**Depends on:** Phase 0
**Plans:** 3/3 plans complete

Plans:

- [x] 01-01-PLAN.md — Extract live_engine.rs into live_engine/ directory with types, trade_dispatch, puck, symbol_task submodules
- [x] 01-02-PLAN.md — Convert checkpoint.py into checkpoint/ package with models, storage, engine submodules
- [x] 01-03-PLAN.md — Extract rectify, memory_guard, vision_cache from backfill.py into sibling modules

### Phase 2: Exness daily tick cache seeder service with registry integration

<!-- status: complete -->

**Goal:** Build an Exness forex tick cache seeder mirroring the Binance seeder architecture, with 10 symbols in the unified registry, systemd 1h timer, Telegram reporting, and monit monitoring.
**Requirements**: EXNS-REG, EXNS-CFG, EXNS-DL, EXNS-PARSE, EXNS-WRITE, EXNS-IDEM, EXNS-TEL, EXNS-SVC, EXNS-MON, EXNS-DOC
**Depends on:** Phase 1
**Plans:** 3/3 plans complete

Plans:

- [x] 02-01-PLAN.md — Registry entries (10 Exness forex symbols in symbols.toml) + ExnessSeederConfig
- [x] 02-02-PLAN.md — Seeder script (download, parse CSV, write Parquet, Telegram) + unit tests
- [x] 02-03-PLAN.md — Deployment (systemd service + timer, monit monitor, CLAUDE.md updates)

### Phase 3: CLAUDE.md hub-and-spoke network: audit, create missing spokes, update root hub

<!-- status: complete -->

**Goal:** Create 10 missing CLAUDE.md spoke files for high-impact directories, update the root hub table from 13 to ~23 entries, fix the validation/day_mode parent chain, and verify full network integrity with zero orphans.
**Requirements**: SPOKE-SRC, SPOKE-SIDECAR, SPOKE-KINTSUGI, SPOKE-CHECKPOINT, SPOKE-VALIDATION, SPOKE-PROCESSORS, SPOKE-HEARTBEAT, SPOKE-COMPAT, SPOKE-NOTIFY, SPOKE-RATELIMIT, HUB-UPDATE, NETWORK-VERIFY
**Depends on:** Phase 2
**Plans:** 4/4 plans complete

Plans:

- [x] 03-01-PLAN.md — Create Tier 1 spokes Group A (src, sidecar, kintsugi, checkpoint)
- [x] 03-02-PLAN.md — Create Tier 1 spokes Group B (validation, processors, heartbeat, heartbeat/checks) + fix day_mode parent
- [x] 03-03-PLAN.md — Create Tier 2 spokes (compat, notify, ratelimit)
- [x] 03-04-PLAN.md — Update root hub table + verify complete network integrity

## Backlog

### Phase 999.1: Rust multi-threshold Arrow API for repair pipeline (BACKLOG)

**Goal:** Add `process_trades_arrow_multi()` to Rust processor — accept multiple thresholds in one call, eliminate Python GIL round-trips. Benchmarked 2026-03-24: 48 workers hit GIL ceiling at 469% CPU (15/32 cores). Est. 2-3x speedup (3,200 → 6,000-10,000 days/min).
**Requirements:** TBD
**Plans:** 0 plans

Plans:

- [ ] TBD (promote with /gsd:review-backlog when ready)
