--- id: GROUND-WP-0002 type: workplan title: "Rulings the engine is blocked on, and the dataset it never loaded" domain: consumer repo: ground-game status: finished owner: bernd topic_slug: whynot created: "2026-08-03" updated: "2026-08-03" state_hub_workstream_id: "d8fc3a69-a5ae-4f6e-b4fc-b07d1ff9c783" --- # Rulings the engine is blocked on `clay-borg` implements the engine that simulates GROUND. Its INTENT says game-semantics questions defer to **this** repo. Ten underdetermined rules points, six provisional scenarios and three questions raised by play have accumulated there, and none has been answered, because none had a home. This is their home. **Nothing here is a clay-borg change.** Every item is a ruling only the game's owner can make; the engine already carries a provisional default for each and will flip it when the ruling lands. **Session 2026-08-03:** all rulings below were decided with the maintainer in a guided pass. Residual playtest work handed to [GROUND-WP-0003](GROUND-WP-0003-playtest-semi-and-coalitions.md). ## The finding that reframes most of this **The engine has never loaded this repository's edition data.** `games/ground/src/lib.rs:1839` builds Problems with `value: priority` and suits cycled by index — a stand-in it has always labelled as such. Mean- while `editions/ground-darvo-r0/Problems.csv` has carried the real thing since 2026-07-31: | | problems per scenario | values | total available | |---|---:|---|---:| | `Problems.csv` (real) | **5** | 2, 2, 2, 3, 3 | **12** | | the engine's stand-in | 3 | 1, 2, 3 | **6** | The dataset also defines `required_solution` (Repair / Clarify / Boundary), `visibility` (Surface / Hidden) and `hidden_priority` (0–4) — all of which the engine currently invents. **GR-E01's thresholds are 2p → 5, 3–4p → 7, 5–6p → 9.** Against 12 available points those are ordinary targets. Against a stand-in worth 6 they are unreachable, which is exactly what clay-borg reported as a rules gap needing a ruling here. **So the first question is not a rules question at all.** It is whether this dataset is authoritative — and if it is, several of the items below dissolve without anyone changing a rule. ## Task: declare the dataset authoritative, and say what the engine may rely on ```task id: GROUND-WP-0002-T01 status: done priority: high state_hub_task_id: "431cca12-e6d9-4eba-9360-f4f13ed263c1" ``` State whether `editions/ground-darvo-r0/` is the **authoritative** source for Problem values, required solutions, visibility and priority — and what the engine may treat as stable. `SCOPE.md` already promises *"stable IDs suitable for layout templates, print merges, and later digital import."* This task turns that into a contract clay-borg can build against: - which columns are authoritative vs presentational; - whether `point_value` and `required_solution` may change between `r0` and a later revision without a version bump; - what a version bump looks like, so the engine can pin one. **Until this is answered the engine cannot import the data, and every threshold question below stays unanswerable.** **RULED 2026-08-03, by the maintainer:** *"The edition dataset is authoritative."* So `editions/ground-darvo-r0/` is the source of truth for Problem values, required solutions, visibility and priority, and **the engine must import it rather than invent them**. That unblocks clay-borg and it very likely dissolves `gr-e01-threshold-unreachable-2p` — see T03. ### Dataset contract (confirmed 2026-08-03) | question | ruling | |---|---| | authoritative vs presentational columns | **Authoritative:** `problem_id`, `scenario_id`, `visibility`, `hidden_priority`, `required_solution`, `point_value`. **Presentational:** `title`, `problem_text`, `symbol_id`, `front_rules`, `reveal_effect`, `unresolved_effect`, `back_design_id` | | may `point_value` / `required_solution` change within `r0`? | **No** — a change to either is a new revision | | what a version bump looks like | the directory name: `ground-darvo-r0` → `-r1`. The engine pins a directory, so a bump is visible in a diff and never silent | **Rationale:** Problem value and required suit are *in* hashed game state. Silent in-revision edits would rot every recorded scenario hash in clay-borg. ## Task: rule on SOLVE's legality ```task id: GROUND-WP-0002-T02 status: done priority: high state_hub_task_id: "895573ac-d7b9-4160-a118-5bc8866c28c8" ``` Three related questions, all raised by play, all currently decided by the engine's default rather than by the rules. **(a) May SOLVE be selected against a *face-down* Problem?** Measured in the browser on 2026-08-03: a player selected SOLVE on a face-down Problem in three consecutive rounds. Nothing happened, three times, because GR-A02's resolver skips a Problem that is not face up. The engine offered the move each time. A face-down commit you cannot fulfil is a plausible **bluff** in a commit/reveal game with DARVO — which is why this is a ruling and not a bug. But if it is a bluff it should be *intended*; if it is not, the move should not be offered. **(b) May SOLVE be selected when the seat holds no Solution of the required suit?** Same shape: currently offered, silently does nothing. **(c) GR-A13 — SOLVE against an already-claimed Problem.** Long-standing in clay-borg's evidence as *"wasted SOLVE"*. Intended cost of a bad read, or a gap? For each: **intended, or not offered.** If intended, say what the player is meant to learn from the waste. ### RULED 2026-08-03 | sub | ruling | what the player learns | |---|---|---| | **(a)** face-down Problem | **Not offered** — illegal target | Matches ACT_SOLVE target and Rules §Problems: only face-up, non-Denied. Browser no-ops were a filter bug, not a bluff mechanic. | | **(b)** no matching Solution in hand | **Not offered** — digital legality filter | Player always knows their hand; engine only offers SOLVE when a matching suit is held. Physical tables self-police the same way. | | **(c)** already-claimed Problem | **Same-round race legal; prior-round claim not offered** | Competing SOLVEs resolve Lead-then-clockwise; losers keep their Solution. That race is the intended cost of a bad read. Targeting a Problem claimed in a prior round is illegal (nothing left to race for). | ## Task: answer the ten underdetermined points (U1–U10) ```task id: GROUND-WP-0002-T05 status: done priority: high state_hub_task_id: "e1d6a548-dedf-473a-9ebd-a2e3a286d510" ``` **This is the oldest item and it has never been read.** `clay-borg` messaged this repo on **2026-07-30** with ten points the dataset does not decide, each simulated under a provisional default, asking for *"confirm / correct (with ruling)"* per item. Four days later the message was still unopened, because there was nowhere for it to land. Now there is. | | question | the default clay-borg simulates | |---|---|---| | **U1** | Bond-acceptance timing | the target decides during Support resolution, post-reveal | | **U2** | Stress clamping | clamp on **every** application, not only at End — this changes when DARVO triggers mid-round | | **U3** | DENY with no legal target | no-op; the sequence still advances | | **U4** | Solution deck exhaustion | deterministic reshuffle of the discard, else skip the draw | | **U5** | rejected REVERSE self-effects | owner still gets −2 Stress and the sequence ends; no Blame, no +1, no Protection | | **U6** | same-round Bond-Support vs DARVO | the Support cancels that round's DARVO stage **before it fires** (step order 2 before 3) | | **U7** | player elimination | none exists — **confirm** | | **U8** | GROUND—OU vs Attack | OU cancels the Attack **before** Protection is consumed | | **U9** | simultaneous double DARVO trigger | needs no extra rule — **confirm** | | **U10** | hand limit | none | Full text of each default is in `clay-borg/specs/GroundRules.md` §Underdetermined. **U2, U6 and U8 are the ones that change play**, because each decides whether a DARVO stage fires at all; the rest are edge cases or confirmations. Answer per item: **confirm**, or **correct with the ruling**. ### RULED 2026-08-03 — all ten confirmed as clay-borg defaults | | ruling | note | |---|---|---| | **U1** | **Confirm** | Target accepts during Support resolution, with full knowledge of revealed Actions. Bond formed by *this* Support still does not cancel DARVO (printed designer note). | | **U2** | **Confirm** | Clamp Stress to 0–5 on **every** application. Matches physical mats. DARVO still arms only at End when at Stress 5 (GR-R08). | | **U3** | **Confirm** | DENY with no legal target is a no-op; sequence still advances. | | **U4** | **Confirm** | Deterministic reshuffle of discard into new deck; if both empty, skip the draw. | | **U5** | **Confirm** | GROUND—ND rejection cancels target effects (no Blame, no +1, no Protection) **and** owner still gets −2 Stress and the sequence ends. | | **U6** | **Confirm** | Pre-existing Bond Support (step 2) cancels that round's DARVO stage before it fires (step 3) and ends the sequence. | | **U7** | **Confirm** | No player elimination. | | **U8** | **Confirm** | When both GROUND—OU and Protection could cancel the same Attack: OU applies first; Protection is consumed only if it actually cancels. | | **U9** | **Confirm** | Two players at Stress 5 at the same End both trigger; later stages resolve in Lead order. No extra interaction rule. | | **U10** | **Confirm** | No hand limit in r0. Revisit only if playtest shows bloat. | ## Task: confirm or overturn the six provisional defaults ```task id: GROUND-WP-0002-T03 status: done priority: medium state_hub_task_id: "52cc157f-8fbd-469d-9da7-a96f1c60b654" ``` Six engine scenarios are tagged `provisional: true` with `provisional_owner: ground-game`. These are the **scenarios** that encode T05's defaults — answering U1–U10 will settle most of them, so take T05 first and use this list to check nothing was missed. A ruling flips the scenario; it does not change the kernel. | scenario | the default currently in force | |---|---| | `gr-a04-bond-support` | a Support with no existing relation forms **no** Bond, because GR-L02 requires the target's consent | | `gr-d01-darvo-trigger` | Stress **clamps** at 5 on every application (GR-F01 under the U2 default) | | `gr-d05-darvo-reverse` | the REVERSE stage's default resolution | | `gr-e01-threshold-unreachable-2p` | thresholds measured against the **stand-in** values — see the finding above | | `gr-e02-shared-ground` | SHARED GROUND scoring default | | `gr-e04-coalitions` | Bond networks score together; Rivalries do not connect; an unbonded player is a coalition of one | Confirm each or overturn it. **`gr-e01` should be taken last**, because T01 may dissolve it. ### RULED 2026-08-03 | scenario | ruling | |---|---| | `gr-a04-bond-support` | **Confirm** — consent required; no auto-Bond from no-relation Support | | `gr-d01-darvo-trigger` | **Confirm** — follows U2 | | `gr-d05-darvo-reverse` | **Confirm** — follows printed REVERSE + U5 | | `gr-e01-threshold-unreachable-2p` | **Void / overturn as a rules gap** — stand-in artifact. With authoritative `Problems.csv` (12 pts available) the printed thresholds (2p→5, 3–4p→7, 5–6p→9) stand. Retire or rewrite the scenario as a non-provisional data-import check, not a design ruling. | | `gr-e02-shared-ground` | **Confirm** — encode `Modes.csv` MODE_COOP as printed | | `gr-e04-coalitions` | **Confirm** — encode `Modes.csv` MODE_COALITION as printed | ## Task: GR-E03 and GR-E04 have never been played to the end ```task id: GROUND-WP-0002-T04 status: done priority: medium state_hub_task_id: "6c55eb56-22dc-4ee2-ac1a-4ced0dedfab9" ``` Both scoring modes are implemented and neither has been played through a full game — by a person or by the engine. Whatever the rules say, nobody knows what these modes feel like at the table. This is a **playtest** task, not an engine task, and it belongs here. ### Handed off 2026-08-03 (residual) Rules encoding for both modes is confirmed under T03 (`gr-e02`, `gr-e04`). Full-game felt experience is **not** a ruling and is residual work: - **Residual workplan:** [GROUND-WP-0003](GROUND-WP-0003-playtest-semi-and-coalitions.md) - **origin:** residual of GROUND-WP-0002-T04 This task is **done** as a handoff, not as a completed playtest. ## Ruling index (for clay-borg) One-page flip list. Engine may clear `provisional: true` against these. 1. **Dataset** — `editions/ground-darvo-r0/` authoritative; contract rows under T01. 2. **SOLVE legality** — offer only face-up non-Denied, unclaimed (or same-round race), with matching suit in hand. 3. **U1–U10** — all confirmed as prior clay-borg defaults (table under T05). 4. **Provisional scenarios** — confirm five; void `gr-e01` as stand-in artifact. 5. **Playtest residual** — GROUND-WP-0003.