codex
b5730f280b
Records absent from central carried random pre-ADR-007 identifiers minted by the retired local hub, which C-06 refused as stale references. Deriving from the canonical record id takes no identity from anything. Refs CUST-WP-0068-T06 Assistant: claude-code Assistant-Model: opus Assistant-Process: 2583210@bnt-lap001 Assistant-Session: f2bff2d5-e9b2-4338-92ca-10282a927006
110 lines
3.9 KiB
Markdown
110 lines
3.9 KiB
Markdown
---
|
||
id: GROUND-WP-0001
|
||
type: workplan
|
||
title: "Bootstrap State Hub integration"
|
||
domain: consumer
|
||
repo: ground-game
|
||
status: done
|
||
owner: codex
|
||
topic_slug: whynot
|
||
created: "2026-07-31"
|
||
updated: "2026-08-03"
|
||
state_hub_workstream_id: "221583ba-992a-5ca1-a519-6b100ea90157"
|
||
---
|
||
|
||
# Bootstrap State Hub integration
|
||
|
||
Product repo for GROUND — A Game of Bonds and Rivalry (DARVO Edition): playtest edition datasets, rules content, and design history for a semi-cooperative conflict card game.
|
||
|
||
## Review Generated Integration Files
|
||
|
||
```task
|
||
id: GROUND-WP-0001-T01
|
||
status: done
|
||
priority: high
|
||
state_hub_task_id: "5a2dd899-1117-5981-ae15-3527c26772e5"
|
||
```
|
||
|
||
Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
|
||
Replace generated placeholders with repo-specific facts where needed.
|
||
|
||
**Done 2026-08-03.** Reviewed; **no generated placeholders remain** —
|
||
`INTENT.md`, `SCOPE.md` and `AGENTS.md` all carry repo-specific content
|
||
(the DARVO edition, the `ground-darvo-r0` dataset, the consumer domain,
|
||
the `GROUND-WP-` prefix). Nothing to replace.
|
||
|
||
One gap worth naming rather than editing: `SCOPE.md`'s *"In scope now"*
|
||
does not mention that this repo is the **authority the engine defers to**
|
||
for game semantics. That is a real relationship — `clay-borg`'s INTENT
|
||
says *"game-semantics questions defer to that repo"* — and it now has
|
||
nine unanswered questions behind it. Rather than amend SCOPE by hand, it
|
||
is carried as GROUND-WP-0002 T01, which has to answer what the engine may
|
||
rely on before the scope sentence can be written honestly.
|
||
|
||
## Verify Local Developer Workflow
|
||
|
||
```task
|
||
id: GROUND-WP-0001-T02
|
||
status: done
|
||
priority: high
|
||
state_hub_task_id: "481611a1-38bf-586b-92de-9c57afa25f3a"
|
||
```
|
||
|
||
Identify the repo's install, test, lint, build, and run commands. Add or refine
|
||
those commands in the agent instructions so future coding sessions can verify
|
||
changes confidently.
|
||
|
||
**Done 2026-08-03.** There are none, and that is the honest answer rather
|
||
than an omission: this is a **content repository**. It holds CSV edition
|
||
data under `editions/ground-darvo-r0/`, prose under `INTENT`/`SCOPE`, and
|
||
design history. There is no build, no test runner and no linter, because
|
||
there is nothing here that executes.
|
||
|
||
The workflow is therefore:
|
||
|
||
| step | command |
|
||
|---|---|
|
||
| register workplan and task changes | `statehub fix-consistency` |
|
||
| verify the dataset loads | *(none — see below)* |
|
||
|
||
**The missing one is worth stating as a finding.** Nothing in this repo
|
||
validates that `Problems.csv` and its sibling sheets are internally
|
||
consistent — that `required_solution` values exist in `Solutions.csv`,
|
||
that `scenario_id` values exist in `Scenarios.csv`, that IDs are unique.
|
||
The engine has never loaded them, so nothing has ever checked them.
|
||
|
||
Not fixed here: a validator is real work and it should be built against
|
||
the contract GROUND-WP-0002 T01 defines, not before it.
|
||
|
||
## Seed First Real Workplan
|
||
|
||
```task
|
||
id: GROUND-WP-0001-T03
|
||
status: done
|
||
priority: medium
|
||
state_hub_task_id: "ab005402-9c7e-5425-be54-53e7eb693ec3"
|
||
```
|
||
|
||
Create the first implementation workplan for the repository's most important
|
||
next change. After workplan file updates, run the sync locally from this repo
|
||
checkout:
|
||
|
||
```bash
|
||
statehub fix-consistency
|
||
```
|
||
|
||
**Done 2026-08-03.**
|
||
[GROUND-WP-0002](GROUND-WP-0002-rulings-clay-borg-is-blocked-on.md) —
|
||
*the rulings the engine is blocked on, and the dataset it never loaded.*
|
||
|
||
The most important next change is not a content change. It is that
|
||
**`clay-borg` has never loaded this repository's edition data** and has
|
||
been running on a stand-in that invents Problem values and suits. Its
|
||
`GR-E01 unreachable below 5 seats` finding — carried for passes as a rules
|
||
gap needing a ruling here — is most likely an artifact of that: the
|
||
thresholds (2p → 5, 3–4p → 7, 5–6p → 9) are ordinary against the 12 points
|
||
`Problems.csv` actually provides, and unreachable against the stand-in's
|
||
6.
|
||
|
||
So GROUND-WP-0002 leads with declaring the dataset authoritative, then
|
||
takes the rulings that survive it.
|