quanTUI

A lightweight terminal for quanTUI — all 13 cognitive assessments, local stats, no network, minimal dependencies.

Built in Rust with ratatui + crossterm for low memory use and fast startup. Release builds use opt-level = "z" and LTO.

Requirements

• Rust 1.74+ (rustup)

Run

cargo run
# optimized binary (~few MB RSS at runtime)
cargo build --release && ./target/release/quantui

Install via Cargo (recommended)

# Change into the repo root
cd /Users/abhoo/Documents/repo/dev/ideation

# Build and install
cargo install --path .

What happens

• Cargo compiles a release‑mode binary (quantui) from src/main.rs.
• The compiled binary is moved to $HOME/.cargo/bin/quantui.
• On most systems, $HOME/.cargo/bin is already in your shell’s $PATH, so you can just type:

quantui   # launch the app

Updating

Whenever you pull new changes or want a fresh build, run:

cargo install --path . --force

## Controls (global)

| Key | Action |
|-----|--------|
| `↑` / `↓` or `j` / `k` | Move selection |
| `Enter` | Confirm |
| `Esc` / `q` | Back / quit from menu |
| `a` | Toggle adaptive difficulty |
| `p` | Progress & analysis |
| `?` | Help overlay |

In-game keys are shown on each screen footer.

## Assessments (13)

| # | Game | quantui parity |
|---|------|------------------|
| 1 | Arithmetic Master | Practice, Speed Drill, Survival, Perfect Streak, Blitz |
| 2 | Number Sense | Fermi-style estimation + order-of-magnitude checks |
| 3 | 3D Mental Rotation | ASCII block layouts, pick matching rotation |
| 4 | Memory Grid | Memorize highlighted cells, reproduce |
| 5 | Spot the Switch | Find the cell that changed |
| 6 | Reaction Time | Visual + choice reaction (ms timing) |
| 7 | Tower of Hanoi | Classic puzzle with move scoring |
| 8 | Arrow Storm | Stroop: direction vs label |
| 9 | Balloon Risk | Pump-or-cash behavioral risk task |
| 10 | Fraction Wars | Compare fractions quickly |
| 11 | Percentage Pro | Percent / reverse-percent drills |
| 12 | 80 in 8 | 80 arithmetic problems in 8 minutes |
| 13 | Approximation | Estimate arithmetic results within tolerance (5 modes) |

## Adaptive difficulty

When **adaptive mode** is on (default), each game maintains a skill rating from your last 8 sessions:

- High rolling accuracy (≥88%) → harder band (Easy → Medium → Hard)
- Low rolling accuracy (<50%) → easier band

Manual difficulty applies only when adaptive is off (`a` toggles, or main menu).

## Progress & analysis

Main menu → **Progress & analysis** (or press `p`):

| Tab | Contents |
|-----|----------|
| Overview | Sessions, streak, global accuracy, strengths/weaknesses |
| By game | Per-game accuracy, trend, adaptive level, best score |
| Coaching | Actionable tips (what to drill, consistency, momentum) |
| History | Last 12 sessions with timestamps |

## Data

Stats and settings are stored under the platform config dir:

- macOS/Linux: `~/.config/quantui/`
- Windows: `%APPDATA%\quantui\`

Files: `stats.json` (includes session history + per-game adaptive levels). Fully offline.

## Project layout

src/ main.rs # entry, terminal setup app.rs # event loop, routing menu.rs # main menu UI settings.rs # difficulty, timers storage.rs # JSON persistence math.rs # problem generators games/ # one module per assessment

## License

MIT