From 8b09c51271277df7f54465b8c229e933be89944b Mon Sep 17 00:00:00 2001 From: funman300 Date: Tue, 7 Jul 2026 11:01:42 -0700 Subject: [PATCH] =?UTF-8?q?docs(architecture):=20correct=20KlondikePile=20?= =?UTF-8?q?sketch=20=E2=80=94=20upstream=20has=20no=20Waste=20variant?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ยง8 documented a Waste variant that doesn't exist in klondike 0.4; the real convention (Stock denotes the waste pile in pile-coordinate space) is now stated where the enum is sketched. Co-Authored-By: Claude Fable 5 --- ARCHITECTURE.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 9c274c5..ee2dfca 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -592,11 +592,15 @@ pub struct Session { /* replayable instruction log + derived stats */ } // From `klondike` (upstream โ€” never edit): pub enum KlondikePile { - Stock, - Waste, + Stock, // NB: no Waste variant โ€” see below Foundation(Foundation), // 4 slots, any suit may claim any slot Tableau(Tableau), // 7 columns } +// Pile-coordinate convention: upstream has no `Waste` variant. In +// pile-coordinate space `KlondikePile::Stock` denotes the face-up +// *waste* pile (the only stock-side pile cards move out of); use +// `GameState::stock_cards()` / `waste_cards()` when the face-down +// draw stack must be distinguished. Documented on `GameState::pile`. pub enum DrawStockConfig { DrawOne, DrawThree } pub enum KlondikeInstruction { /* RotateStock, DstFoundation, ... โ€” the serialized move format (schema v4+) */ }