# CLAUDE.md — Rust Rewrite

## Session Start

Read the rewrite memory file before starting work:
`~/.claude/projects/-mnt-NV2-Development-sba-scouting/memory/rust-rewrite.md`

It has the phase plan, completion status, architecture decisions, and current file layout.

## Project Overview

Rust rewrite of the SBA Scout TUI. Uses ratatui + crossterm for the terminal UI, sqlx + SQLite for data, reqwest for API calls, and figment + TOML for configuration.

## Commands

```bash
cargo build              # compile
cargo run                # run TUI
cargo test               # run tests
cargo clippy             # lint
cargo fmt                # format
```

## Architecture

Same layered structure as the Python version, ported to Rust idioms:

```
src/
├── main.rs        # tokio runtime, event loop, file logging
├── app.rs         # App struct, screen routing, nav/status bars
├── config.rs      # figment-based TOML settings
├── lib.rs         # module re-exports
├── api/           # reqwest HTTP client, sync pipeline, CSV importers
├── calc/          # league stats, matchup scoring, score cache, weights
├── db/            # sqlx models, queries, schema
├── screens/       # ratatui screen states (all 7 screens complete)
└── widgets/       # reusable UI components (selector)
```

### Key Patterns

- **Async throughout**: tokio runtime, sqlx async, reqwest async
- **Message passing**: `mpsc::UnboundedSender<AppMessage>` for async task → UI communication
- **No global state**: Settings and SqlitePool passed by reference, no singletons
- **TOML config** (not YAML): `data/settings.toml` with `SBA_SCOUT_` env var overrides

### Screens (all complete)

- `dashboard.rs` — Roster summary, sync trigger
- `gameday.rs` — Matchup table + lineup builder (opponent/pitcher context)
- `roster.rs` — Tabbed roster view (Majors/Minors/IL), batter/pitcher sub-tables
- `matchup.rs` — Standalone matchup analysis with sort modes, state cached on nav-away
- `lineup.rs` — Standalone lineup builder, save/load/delete with confirmation
- `settings.rs` — Config form with TOML save, live team validation, per-field change indicators
- `standings.rs` — League standings with Division and Wild Card tabs, DB-cached with background API refresh

## Code Style

- Run `cargo fmt` and `cargo clippy` before committing
- A `cargo check` hook runs automatically after every `.rs` file edit (via `.claude/settings.json`). Run `cargo clippy` manually at logical checkpoints (before commits, after finishing a feature, after a batch of edits) to catch lint warnings beyond compile errors.
- Screen pattern: state struct → `new()` → `mount()` → `handle_key()` → `handle_message()` → `render()`