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 ac57ce2011
Some checks failed
ci / check (push) Failing after 4s
make help, and make ground — one way in, and a list of the rest
Tier S (utility inside a boundary; chaos d8=5, no override). Provenance in
this message per InnerLoop §Loop tiers.

The maintainer asked how to start the UI. The answer was a five-flag
cb-play invocation nobody could be expected to remember, in a Makefile
whose own header calls itself "one command surface" -- a surface you have
to read the source of is not one.

  make ground                      # play, recording a trial
  make ground PLAYERS=2 SLUG=darvo-confusion
  make trials                      # read the notes back

`ground` timestamps the trial name so two sessions in one day cannot
overwrite each other's notes, and keeps the date prefix because
tools/trials.py reads the age from there.

`make` with no target now lists targets instead of running the heaviest
thing in the file. It extracts the `## ` comments that were already the
convention -- ten of them existed and NOTHING HAD EVER RENDERED THEM.

Which is how the first run found a real defect: `## run all GROUND
scenarios through cb-sim` sat above `dep-weight:`, 167 lines from the
`sim:` it describes. A doc comment nothing reads rots, and this one had --
same family as the message that sat unread for four days and the ten
rulings nobody collected, in a third medium. Moved to `sim`, and
`dep-weight` given its own.

Documented the targets a person reaches for (coverage, status, all,
self-tests, sim, design, difficulty, trials) and listed the undocumented
instruments compactly, so nothing in the file is invisible.

Verified end to end rather than by inspection: `make ground` served a
page (200), a note posted through it (303), and `make trials` reported it
bound to its position.

loop-lint clean, check clean, self-tests 0 failures.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-06 14:53:07 +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-0027 T01-T04: the commentary track 2026-08-06 10:37:46 +02:00
decisions CB-WP-0027 T01-T04: the commentary track 2026-08-06 10:37:46 +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-0027 T05: evidence — and the one question this file cannot answer 2026-08-06 10:39:12 +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-0027 T01-T04: the commentary track 2026-08-06 10:37:46 +02:00
workplans CB-WP-0027 T05: evidence — and the one question this file cannot answer 2026-08-06 10:39:12 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-08-06 10:39:42 +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 make help, and make ground — one way in, and a list of the rest 2026-08-06 14:53:07 +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-0027 2026-08-06 10:39:48 +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.