Repository navigation
Commit ffe760a
npub1qyvc0c5kl4gqv2fd97fsk46tu378sqgy35vc83rvgfwne90sel7s0ed67d
docs(remote-agents): Wren's review — layer-true conformance, ownership marker, finalization slice
Fixes the three blockers plus both recommendations from Wren's review of
4432030 (the layer split leaked in three load-bearing places):
- Conformance restructured into three checklists, one per §Launchers
layer, replacing the mixed tagged list. [L1] is now a launcher-neutral
five-item contract (nonempty identity; promises not suppressed —
presence stays on, inactivity knob is deliberate owner policy; signal
reaches the harness; intentional exit under the pinned clean-exit
contract; supervisor never restarts a clean exit) — a systemd unit can
satisfy it and a bash launcher can no longer satisfy it vacuously.
"Container/PID 1" wording moves to the Kubernetes [L3] list. [L2] keeps
the wire/reconciler items plus a generic L3 obligation stated as a
property (document lifetime + clean-exit restart realization); the
K8s spellings (inactivity_seconds, OnFailure/Never selection,
terminationGracePeriodSeconds) live only under [L3]. Cross-references
updated (testability paragraph now cites L2/L3 items).
- I1 restated launcher-neutrally: "no agent is ever launched
identityless, refused wherever the env is assembled", with the payload
refusal as the provider path's enforcement — no longer only "no deploy
request is emitted".
- Auto-repair fence now requires positive ownership evidence, not
identity evidence: new management marker (app.kubernetes.io/managed-by:
buzz-backend-kubernetes + buzz.block.xyz/binding-version) on every pod
and Secret, required before any destructive repair or GC — on top of
the annotation check and UID+resourceVersion fence. Honestly framed as
protocol evidence, not cryptographic proof (cluster writers can forge
metadata; the marker fails accidental collisions closed). §Pod shape
labels, §K8s GC pass, L2 item 4, and a new mandatory conformance case
(marker-absent object is never deleted) all updated.
- Shutdown budget gains a reserved finalization slice: presence offline
publish + relay close are held back out of the shared deadline and
child reaping degrades first, so cleanup cannot legally consume the
entire grace before the one action the grace exists to protect. §Stop,
§Pod shape grace bullet, Known Defect 7 aligned.
- Minimalness: §Pod shape's OnFailure bullet no longer re-argues I5's
rationale; it states the selection and points at I5.
Co-authored-by: npub1qyvc0c5kl4gqv2fd97fsk46tu378sqgy35vc83rvgfwne90sel7s0ed67d <011987e296fd5006292d2f930b574be47c7801048d1983c46c425d3c95f0cffd@buzz.block.builderlab.xyz>
Signed-off-by: npub1qyvc0c5kl4gqv2fd97fsk46tu378sqgy35vc83rvgfwne90sel7s0ed67d <011987e296fd5006292d2f930b574be47c7801048d1983c46c425d3c95f0cffd@buzz.block.builderlab.xyz>1 parent 4432030 commit ffe760a
1 file changed
Lines changed: 147 additions & 69 deletions
0 commit comments