A rebuild from scratch simulation and games engine framework set up to assimilate and optimize techniques and implementations useful for games, simulations, robotics.
Find a file
tegwick fe772eebc9
Some checks are pending
ci / check (push) Waiting to run
CB-WP-0027: the commentary track — declare and register
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
.forgejo/workflows T01: audit every InnerLoop rule, and make the checkable ones executable 2026-07-31 09:16:00 +02:00
benchmarks CB-WP-0006 T07: implement K18, amend K14 2026-08-01 12:47:16 +02:00
crates CB-WP-0024: the table you can watch 2026-08-05 17:32:48 +02:00
decisions CB-WP-0025 T03: ADR-0013 -- one world after the game, and difficulty that 2026-08-05 18:47:07 +02:00
editions/ground-darvo-r0 CB-WP-0021 T01/T02/T05: the engine plays its own data — AM-7 blocks 2026-08-04 00:47:56 +02:00
evidence CB-WP-0025 T06/T07: a difficulty baseline that reports its own confound 2026-08-05 19:24:49 +02:00
games/ground CB-WP-0025 T06/T07: a difficulty baseline that reports its own confound 2026-08-05 19:24:49 +02:00
history CB-WP-0025 T02: the review withdrew the finding, and the fifth wrong 2026-08-05 18:06:03 +02:00
research CB-WP-0025 T02: the review withdrew the finding, and the fifth wrong 2026-08-05 18:06:03 +02:00
scenarios CB-WP-0026: collect the rulings -- ten answers that arrived and were never applied 2026-08-05 16:13:37 +02:00
specs CB-WP-0025 T06/T07: a difficulty baseline that reports its own confound 2026-08-05 19:24:49 +02:00
tools CB-WP-0024: the table you can watch 2026-08-05 17:32:48 +02:00
workplans CB-WP-0027: the commentary track — declare and register 2026-08-06 10:18:35 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-08-05 19:25:22 +02:00
.gitignore chore: stop tracking tools/__pycache__ 2026-08-01 12:49:17 +02:00
Cargo.lock CB-WP-0016: the drop target that was never there 2026-08-02 20:48:18 +02:00
Cargo.toml CB-WP-0012-T04: cb-render-html — stage 1 draws, and the browser is the toolkit 2026-08-02 04:27:25 +02:00
clippy.toml T07: Cargo workspace scaffold — cb-kernel/cb-events/cb-game-runtime/games-ground/cb-sim, HashMap deny-lint, scenario format + runner stub, Criterion skeleton, Makefile, CI 2026-07-31 01:57:13 +02:00
facts.toml CB-WP-0023: SOLVE is legal only where it can do something 2026-08-04 00:18:40 +02:00
gates.toml CB-WP-0021 T01/T02/T05: the engine plays its own data — AM-7 blocks 2026-08-04 00:47:56 +02:00
INTENT.md CB-WP-0022 T03: ADR-0012 -- the register already existed, and the rule was 2026-08-05 15:05:51 +02:00
LICENSE Adopt TRSL V1C1 license; link ground-game and target-revenue sister repos 2026-07-31 00:25:30 +02:00
Makefile CB-WP-0025 T06/T07: a difficulty baseline that reports its own confound 2026-08-05 19:24:49 +02:00
README.md CB-WP-0004 T01: fix environment friction at the root 2026-07-31 10:13:52 +02:00
rust-toolchain.toml T07: Cargo workspace scaffold — cb-kernel/cb-events/cb-game-runtime/games-ground/cb-sim, HashMap deny-lint, scenario format + runner stub, Criterion skeleton, Makefile, CI 2026-07-31 01:57:13 +02:00
WORK-RECORDS.md Sync hub state for CB-WP-0025 2026-08-05 19:25:45 +02:00

clay-borg

A rebuild from scratch simulation and games engine framework set up to assimilate and optimize techniques and implementations useful for games, simulations, robotics.

Licensed under the Target Revenue Source License (TRSL V1C1) — see LICENSE; canonical text lives in the org's target-revenue repository.

Running the gates

make all                      # every gate, from a clean shell
make -C /path/to/clay-borg all   # …or from any other directory

There is no environment setup step. No cd, no export PATH, no activation script. make locates the repo from its own path and cargo from the standard rustup locations; the Python tools do the same via tools/repo.py. The only prerequisites are a rustup toolchain and Python 3.11+.

This is deliberate and enforced: make env-test runs every tool from / with a PATH containing no cargo, and make all includes it. CB-RES-0003 measured 84 agent turns and $15.33 spent prefixing commands with cd and export PATH before that friction was fixed at the root (CB-WP-0004 T01).

Other useful targets: make cost (spend per task), make cost-budget (spend since the last commit), make cost-mix (mechanical vs judgment turns), make loop-lint (executable InnerLoop rules), make self-tests (every tool's positive control).

GROUND

The first product vertical is a virtual tabletop implementation of GROUND — A Game of Bonds and Rivalry: DARVO Edition. The boardgame itself (rules, editions, content) is at home in the sister repository ground-game — that repo is authoritative for what GROUND is; clay-borg implements the engine that runs it.