CAT-NR1: every build narrates its asks of a seat in one place

asked, waiting on the seat every five minutes, stored or refused, as the ask's
phase on its step key, so a publish or a copy that stands still is readable on
the bus. PublishOne and PublishFiles narrate for every build module; the image
copy and the late publish use the same narration.

Claude-Session: https://claude.ai/code/session_01JG73KJNrH5EgFXMKKYSrig
This commit is contained in:
2026-11-04 16:05:27 +01:00
parent 1c4739698a
commit 37a1f2be53
6 changed files with 262 additions and 8 deletions
+4 -1
View File
@@ -144,7 +144,10 @@ builder writes the older form beside it while a counted node-engine reads only t
seat nothing holds, fails the step `not stored: <artifact>: <the holder's words>`. The packed bytes never stay on the node.
A build the builder numbers later is published late: the module consumes the builder's `version.numbered` and, for a
bundle or an archive with a digest, publishes that held digest under its version, naming its one part by digest and
sending nothing (`latepublish.go`); a holder that no longer holds the digest fails the event, which is offered again.
sending nothing (`latepublish.go`); a holder that no longer holds the digest fails the event, which is offered again. Every
ask of a seat a build module makes (a publish, a late publish, an image's copy) is narrated by `buildstep/narrate.go`:
asked, waiting on the seat every five minutes while it has not answered, stored or refused, each the ask's phase on its
running step key (logged outside an ask).
A contracts module (a package artifact naming `generated-from`) has its generated Go files regenerated with the seat
generator this module is built with and compared (`buildstep/generated.go`): the unit level of `build_go_test` fails
naming each file that differs, is missing or was not written by the generator (its `out-of-step`), and a build ask