funman300/Ferrous-Solitaire
1
1
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases 28 Wiki Activity

docs: mark Phase 6 part 1 (XP/levels) complete in session handoff

Browse Source 
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
funman300
2026-04-24 19:11:32 -07:00
parent ef043c14d4
commit 0cb8b32ec4
1 changed files with 20 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/SESSION_HANDOFF.md
+20 -11
View File
@@ -2,7 +2,7 @@
> Last updated: 2026-04-24 > Last updated: 2026-04-24
> Branch: `master` — pushed to https://git.aleshym.co/funman300/Rusty_Solitare.git > Branch: `master` — pushed to https://git.aleshym.co/funman300/Rusty_Solitare.git
> Test count: **148 passing** (76 core + 19 data + 53 engine), `cargo clippy --workspace -- -D warnings` clean > Test count: **168 passing** (76 core + 33 data + 59 engine), `cargo clippy --workspace -- -D warnings` clean
--- ---
@@ -96,19 +96,28 @@ All sub-phases (3A–3F) done. Plugins: `GamePlugin`, `TablePlugin`, `CardPlugin
- New `StatsUpdate` system set lets `AchievementPlugin` order itself after stats are incremented - New `StatsUpdate` system set lets `AchievementPlugin` order itself after stats are incremented
- Deferred: `daily_devotee` (needs `PlayerProgress`), `comeback` (needs recycle counter), `zen_winner` (needs modes), `perfectionist` (needs max-score calc). Stubs can be added in later phases. - Deferred: `daily_devotee` (needs `PlayerProgress`), `comeback` (needs recycle counter), `zen_winner` (needs modes), `perfectionist` (needs max-score calc). Stubs can be added in later phases.
### Phase 6 (part 1) — XP, Levels, ProgressPlugin ✅ COMPLETE
- `solitaire_data::PlayerProgress` with `total_xp`, `level`, daily/weekly/unlock fields
- `level_for_xp(xp)` and `xp_for_win(time, used_undo)` helpers (per ARCHITECTURE.md §13)
- `add_xp(amount) -> prev_level` with `leveled_up_from(prev)` for level-up detection
- Atomic `progress.json` persistence via `save_progress_to` / `load_progress_from`
- `ProgressPlugin` — on `GameWonEvent`, awards XP (base 50 + speed bonus 10–50 + no-undo 25), persists, emits `LevelUpEvent`
- `ProgressUpdate` system set for ordering downstream systems
- `ProgressPlugin::default()` for production, `::headless()` for tests
## What Is Next ## What Is Next
### Phase 6 — Progression (XP, Levels, Daily Challenges, Modes) ### Phase 6 (part 2) — Daily Challenges, Weekly Goals, Special Modes
- `solitaire_data::PlayerProgress` (XP, level, daily challenge streak, unlocked card backs/backgrounds) - Daily challenge seed generation (deterministic from date, same for all players globally)
- XP award on `GameWonEvent` — base + speed bonus + no-undo bonus - Daily challenge completion tracking → `daily_challenge_streak` field
- Level formula (from ARCHITECTURE.md §13) - After this lands, wire up the `daily_devotee` achievement
- Daily challenge seed generation + completion tracking - Weekly goals (`weekly_goal_progress` HashMap is already in `PlayerProgress`)
- Weekly goals (rotating set of mini-objectives) - Time Attack / Challenge / Zen modes (unlock at level 5)
- Time Attack / Challenge Mode / Zen Mode — unlocked at level 5 - LevelUp toast — connect `LevelUpEvent` to a toast in `AnimationPlugin`
- After this lands, the `daily_devotee` achievement can be wired up
### Phases 7–8 (in order after Phase 6) ### Phases 7–8 (in order after Phase 6 part 2)
| Phase | Scope | | Phase | Scope |
|---|---| |---|---|
@@ -165,7 +174,7 @@ For Phase 3 onwards, write a new plan using the `superpowers:writing-plans` skil
# Check everything compiles # Check everything compiles
cargo check --workspace cargo check --workspace
# Run all tests (148 tests, all should pass) # Run all tests (168 tests, all should pass)
cargo test --workspace cargo test --workspace
# Lint (must be zero warnings) # Lint (must be zero warnings)