Readable pull requests, working step replays, and sturdier Free chains #583

Merged
cmoriarty merged 6 commits from claude/pr-readability-570 into main 2026-11-21 11:21:30 -05:00
Owner

Braid's pull requests opened with up to 2,480 words, every title cut at 72 characters. One now opens with a short summary, the merge gate's checks in its own words, what is not done and how to try it, with Braid's record folded below (#570). Step replays, the evidence a fix to a brief closes on, work again: production could not capture a step, and local Free replays never started their agent (#581). And one model the Free router does not know no longer silences its whole chain (#582).

Checks: all passed

  • ./tools/test.sh: 940 backend tests, 212 UI unit tests and 64 browser journeys, in 68 s.
  • ./tools/sim.sh --smoke: 7 of 7 scenarios. A kept quick-fix run opened its pull request in the new shape.
  • Run 204's real records, rebuilt: 258 words before the first fold, against 1,249 in all before, and its checks word for word its merge gate's.
  • ./tools/replay.sh free --times 3 of a summary step with the new brief: 3 of 3 succeeded on real Free models, each summary in its shape, none describing the run.

Not done

  • Run 204's own summary step can be captured from production only once this deploys. It is replayed then.
  • Hetzner is unused until the Free router reads its new address: the router's built-in Hetzner provider keeps the old one.

Try it

  1. git fetch origin && git checkout claude/pr-readability-570
  2. ./tools/test.sh
  3. ./tools/replay.sh capture '<a step's console address>', then ./tools/replay.sh free <capsule> --times 1
  4. Read first: src/osf/pipeline/summary.py, then _pr_body in src/osf/forgejo.py.
What changed, by issue

#570, readable pull requests

  • .osf/summary.md is a # title line, one paragraph of at most 100 words, ## Not done and ## Try it. summary-shape fails a summary out of that shape, naming each problem.
  • The summary's brief no longer asks the agent to retell Braid's checks, and docs.write shares the same shape.
  • The pull request's checks come from evidence.proof, the merge gate's own record. The code review (one line a note, its summary dropped), the tests and the run's figures are folded. The run's link appears only on a private repository.
  • The plan reads Not done from its own section, and still reads older summaries.

#581, step replays

  • The capsule's bundle comes from git's standard output: osfd's git wrapper (braid#493) runs git with a /tmp of its own.
  • A Free replay's container gets production's seccomp profile, /dev/net/tun and OSF_SANDBOX=step-unfenced.
  • A run whose server cannot start ends a replay or a simulated run within seconds, with osfd's reason, and a stopped replay removes its containers.
  • Hetzner's address is https://inference.hetzner.com/v1, and Hetzner is unused while the router reads the old one.

#582, Free chains

  • A model the router refuses a chain for, not knowing it, is marked gone, and the chain is registered without it.

🤖 Generated with Claude Code

Braid's pull requests opened with up to 2,480 words, every title cut at 72 characters. One now opens with a short summary, the merge gate's checks in its own words, what is not done and how to try it, with Braid's record folded below (#570). Step replays, the evidence a fix to a brief closes on, work again: production could not capture a step, and local Free replays never started their agent (#581). And one model the Free router does not know no longer silences its whole chain (#582). **Checks: all passed** - `./tools/test.sh`: 940 backend tests, 212 UI unit tests and 64 browser journeys, in 68 s. - `./tools/sim.sh --smoke`: 7 of 7 scenarios. A kept quick-fix run opened its pull request in the new shape. - Run 204's real records, rebuilt: 258 words before the first fold, against 1,249 in all before, and its checks word for word its merge gate's. - `./tools/replay.sh free --times 3` of a summary step with the new brief: 3 of 3 succeeded on real Free models, each summary in its shape, none describing the run. **Not done** - Run 204's own summary step can be captured from production only once this deploys. It is replayed then. - Hetzner is unused until the Free router reads its new address: the router's built-in Hetzner provider keeps the old one. **Try it** 1. `git fetch origin && git checkout claude/pr-readability-570` 2. `./tools/test.sh` 3. `./tools/replay.sh capture '<a step's console address>'`, then `./tools/replay.sh free <capsule> --times 1` 4. Read first: `src/osf/pipeline/summary.py`, then `_pr_body` in `src/osf/forgejo.py`. <details> <summary>What changed, by issue</summary> **#570, readable pull requests** - `.osf/summary.md` is a `# ` title line, one paragraph of at most 100 words, `## Not done` and `## Try it`. `summary-shape` fails a summary out of that shape, naming each problem. - The summary's brief no longer asks the agent to retell Braid's checks, and `docs.write` shares the same shape. - The pull request's checks come from `evidence.proof`, the merge gate's own record. The code review (one line a note, its summary dropped), the tests and the run's figures are folded. The run's link appears only on a private repository. - The plan reads Not done from its own section, and still reads older summaries. **#581, step replays** - The capsule's bundle comes from git's standard output: osfd's git wrapper (braid#493) runs git with a `/tmp` of its own. - A Free replay's container gets production's seccomp profile, `/dev/net/tun` and `OSF_SANDBOX=step-unfenced`. - A run whose server cannot start ends a replay or a simulated run within seconds, with osfd's reason, and a stopped replay removes its containers. - Hetzner's address is `https://inference.hetzner.com/v1`, and Hetzner is unused while the router reads the old one. **#582, Free chains** - A model the router refuses a chain for, not knowing it, is marked gone, and the chain is registered without it. </details> --- 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Braid's last 14 pull requests ran 650 to 2,480 words, every title cut at 72 characters. The
summary is now a title line, one paragraph, what is not done and how to try it, held to that
shape by `summary-shape`. The pull request's checks are the merge gate's proof in its own words,
and the code review (one line a note), the tests and the run's figures are folded below. The
run's link is given only in a private repository. Run 204 rebuilt from its real records opens
with 258 words before the first fold.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Since braid#493 osfd runs git for a run's folder in a sandbox with a /tmp of its own, so the
capsule's bundle, asked for in a folder osfd made in its /tmp, could not be written: it now comes
from git's standard output. A Free replay's container is started as production starts osfd's,
with OSF_SANDBOX=step-unfenced, since Docker Desktop's kernel has no Landlock. A run whose server
cannot start ends a replay or a simulated run within seconds, with osfd's reason, and a stopped
replay removes its containers. Hetzner is unused: the router's built-in Hetzner provider reads an
address Hetzner no longer serves, and its model, never found, silenced five chains.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
fix(free): a model the router does not know leaves the chains (#582)
All checks were successful
test / suite (pull_request) Successful in 1m31s
e41fabfbd4
The router refuses a whole chain naming a model it does not know, and that model was never marked
gone: only a served 404 did that, and it never got a request. It is now marked gone from the
router's refusal, and the chain is made and put again without it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
cmoriarty/braid!583
No description provided.