Skip to content

Commit ffe760a

Browse files
author
npub1qyvc0c5kl4gqv2fd97fsk46tu378sqgy35vc83rvgfwne90sel7s0ed67d
committed
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

File tree

0 commit comments

Comments
 (0)