Commit graph

3 commits

Author SHA1 Message Date
4fb506fcd1 CB-WP-0027 T01-T04: the commentary track
The meta view beside the table, and a note channel that provably cannot
carry a move.

T01 (ADR-0014). ADR-0007 D5 is SCOPED, NOT AMENDED, and the reason it was
easy is that PointerFact::parse already refuses any unrecognised field --
a comment could not reach the command path even by accident. So /command
carries pointer facts, /note carries text, and Note has no code path to
GroundCommand. Comments live in trials/<date>-<slug>.md, not in
ScenarioFile: a scenario is executed, replayed and hashed, and prose in it
is data the runner must ignore, which is how a format rots. The state hash
binds; round and step are for reading. And the retention question, decided
before any comment was written: RAW NOTES NEVER LEAVE clay-borg. A note
reaches ground-game only by being promoted to a register finding, by a
human, with the wording chosen then -- "the DARVO sequence is infuriating"
is useful signal and a bad way to open a message to the game's designer.

T02. CSS grid, minmax(0,1fr) on both tracks -- load-bearing, because a
grid child defaults to min-content width and without it the SVG table
refuses to shrink and pushes the meta column off-screen, looking correct
on the developer's monitor and broken everywhere else. Single-column
fallback under 64rem. The running tally moved into the panel so it is
visible WHILE PLAYING; it only appeared on the ending page before, and a
score you see once the game is over informs nothing.

T03. A plain <form method="post">, so the box works with the script
disabled; the command channel needs JavaScript because a drag is not a
form submission, a comment is one. 303 See Other so a reload does not
re-post. esc()'s first hostile input: <script>alert(1)</script> renders
escaped AND STILL READABLE -- escaping that eats the player's words is its
own defect. Verified over real HTTP: note posted 303, hostile note stored
as text, empty note refused 400, game did not advance.

T04. tools/trials.py and make trials. THE REPORT'S DESIGN CHANGED BECAUSE
I RAN IT: the first version called any note without a recording an orphan,
so a live session reported every note as broken -- the recording is only
written at game end. A metric that cries wolf is one nobody reads, which
is the exact failure this pass exists to prevent. Now ok / pending /
orphan, and only orphan is a target-0 number. The self-test exercises the
REPORTING path, not just the parser, because design-baseline.py had a
green self-test and an unexercised reporting path and that is where it
rotted.

And a latent Makefile defect surfaced: make trials did nothing, because
trials is also a directory and Make saw an up-to-date file. design,
difficulty and trials -- added by CB-WP-0022, CB-WP-0025 and this pass --
were ALL missing from .PHONY; only the one that collided revealed it.

make all: exit 0. 49 render tests, 26 cb-play, loop-lint clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 10:37:46 +02:00
5c6e322d5f Sync hub state for CB-WP-0027
Some checks failed
ci / check (push) Failing after 4s
Workplan and task ids written back by fix-consistency C-06.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 10:19:16 +02:00
fe772eebc9 CB-WP-0027: the commentary track — declare and register
Some checks are pending
ci / check (push) Waiting to run
The maintainer's ask: game interface left, meta and commentary right, with
comments bound to game state so a test player's perception, confusion and
reasoning become reviewable signal.

Declared M (chaos d8=7, no override, declaration 10 of window 2). It
touches two canonical interfaces: ADR-0007 D5's input contract, which
currently admits only raw pointer facts, and the recorded-session format,
which is deny_unknown_fields -- CB-WP-0026 just proved that bites.

FRAMED AS GameDesign §5's TRIAL PROTOCOL MADE ERGONOMIC, because that is
what it is. The protocol already exists and nobody would use it as
written: it asks the player to reconstruct their reasoning afterwards,
from memory, in a sibling file. A comment typed while the position is on
screen is contemporaneous, bound to something replayable, and captures the
one class of signal no gate in this project can see -- confusion and
frustration.

The reason it is worth more than a comment box: GameDesign §3.1 makes a
note unreportable until it has a reproduction, and three findings are
stuck there now (F12, F14, F15). A comment bound to a recorded state, plus
the recording, is the cheapest reproduction a play-derived observation can
have. So the pass closes the register's input path for findings that come
from playing rather than from building.

The failure it must not reproduce is named up front: a pile of prose
nobody reads is this project's signature defect -- the four-day unread
message, the ten uncollected rulings. Storage is not the deliverable,
surfacing is, and T04 carries it.

T01 (ADR-0014) must decide where comments live, what the page may send
(D5's transport widens from two ids to arbitrary user text -- amended or
merely scoped?), what binds a comment to a position, and the retention
question this project has not faced: these are the maintainer's own words
about his own game, one will eventually be unflattering, and whether they
travel to ground-game needs deciding before any are written.

T03 notes that esc() is about to face its first hostile input -- until now
it has escaped suit names.

loop-lint: no findings.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 10:18:35 +02:00