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 18c57f2e9d
Some checks failed
ci / check (push) Failing after 4s
HANDOFF.md: what a generated brief cannot say
Every workplan is done and nothing is in flight -- the session stopped at
a boundary, not mid-change -- so the risk on pick-up is not lost context
but MISREAD context.

Records the three findings most likely to be misread (attack_relief is
unreachable-then-real, not null; H1's rejection covers half of H1; the
scope module is inert in round one), what is waiting on ground-game
versus what is ours, the conventions a new session trips over (hub is a
read model; workplan status is active not in_progress; make vendor;
replays/ is gitignored), and the two habits that paid for themselves
repeatedly -- mutate every control, and test the path a player takes.

Linked from the README above the gates, since it should be read before
design — the finding register

  QUEUE (open findings)
    repro  F17  degenerate       raised       6d  ground-game
    repro  F18  inert            raised       6d  clay-borg
    repro  F24  inert            raised       5d  clay-borg
    repro  F25  inert            raised       4d  clay-borg
    repro  F26  inert            ruled        4d  ground-game
    repro  F27  unplayed         reported     4d  clay-borg
    repro  F31  unplayed         reported     4d  clay-borg
    repro  F30  degenerate       ruled        4d  ground-game

  NOTES (not reportable — GameDesign §3.1)
           F12  degenerate         11d
           F15  underdetermined     7d
           F21  degenerate          6d

  findings                       28   (+3 note(s))
  with a resolving reproduction  19/28 = 67%   target 100%
  open, lacking a reproduction   0   target 0
  reproductions green while open 0   target 0
  notes past 30 days             0   target 0
  closed (log)                   20   [U1, U2, U3, U4, U5, U6, U7, U8, U9, U10, F11, F13, F14, F16, F19, F20, F23, F22, F29, F28].

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-12 00:00:50 +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-0048 T02/T03/T04: Configuration replaces Variant in the state 2026-08-09 00:54:34 +02:00
decisions ADR-0023 + CB-WP-0049 T01: a policy is bound by what its seat can see 2026-08-08 22:45:55 +02:00
editions Apply ground-game's rulings: mastery in points, four boards, and a 2026-08-09 00:15:14 +02:00
evidence Apply ground-game's rulings: mastery in points, four boards, and a 2026-08-09 00:15:14 +02:00
games/ground CB-WP-0050 T02: F31 falsified — the module is unreachable, then real 2026-08-09 02:30:08 +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 ADR-0022 + CB-WP-0048 T00: the selector decision, and the mirror held 2026-08-08 22:07:57 +02:00
reviews CB-REV-0003: round 3, and three of four FATAL came from round 2's fixes 2026-08-08 10:26:25 +02:00
scenarios Apply ground-game's rulings: mastery in points, four boards, and a 2026-08-09 00:15:14 +02:00
simulators CB-RES-0009: extensive form is the lingua franca 2026-08-08 14:57:25 +02:00
specs GROUND-RPT-0007: correct our H1 report — H1-B was never measured 2026-08-10 11:28:31 +02:00
tools CB-WP-0048 T02/T03/T04: Configuration replaces Variant in the state 2026-08-09 00:54:34 +02:00
trials ADR-0022 + CB-WP-0048 T00: the selector decision, and the mirror held 2026-08-08 22:07:57 +02:00
workplans GROUND-RPT-0007: correct our H1 report — H1-B was never measured 2026-08-10 11:28:31 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-08-09 01:30:23 +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-0041 T01: perfect recall fails on the projection, holds on the history 2026-08-08 15:18:36 +02:00
HANDOFF.md HANDOFF.md: what a generated brief cannot say 2026-08-12 00:00:50 +02:00
INTENT.md simulators/: persist the survey, and let it shrink two of the three tracks 2026-08-08 11:56:27 +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-0050: every configuration, faceted by aspect — and F31 2026-08-09 01:45:53 +02:00
README.md HANDOFF.md: what a generated brief cannot say 2026-08-12 00:00:50 +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-0050 T02 2026-08-09 02:31: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.

Picking the work back up

HANDOFF.md — written by hand at the end of each working session, unlike the generated .custodian-brief.md. It records what is true, what is only reported, and what would be a mistake to assume. Read it before make design.

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.