Select execution observers from context

This commit is contained in:
2026-11-22 18:07:17 +00:00
parent f762c0358e
commit ea7cc170ad
6 changed files with 104 additions and 6 deletions

View File

@@ -21,8 +21,9 @@ Prepared-content notification is a separate opt-in callback, not an event.
The facade masks inherited recorder and prepared-claim state when entering
preparation or execution. Delegated calls from an injected collaborator retain
the caller's cancellation, deadline, and unrelated context values, but do not
reuse the enclosing invocation's accounting. Only the new request's observer
(or the claimed handle's retained observer) enables its observation lifecycle.
reuse the enclosing invocation's accounting. Ordinary runs compose the request
observer before any observers selected by the invocation context; contextual
selection survives this boundary. Prepared handles use their retained observer.
A recorder keeps only counters, resolved identity fields, and the selected
callback. It has no global history, queue, goroutine, or mutex held across a
@@ -53,12 +54,13 @@ attempts above the first in a generation, and repair generations with at least
one dispatch. A terminal event is an aggregate and must not be added to its
attempt events.
An execution group is a zero-ready synchronized collector of explicitly selected
An execution group is a zero-ready synchronized collector of selected
events. It enrolls by run ID and aggregates each run's first terminal counters and
presence-aware usage exactly once. Snapshots copy members and totals under one
lock; terminal coverage and token completeness are distinct. Observer fan-out
copies the callback slice and invokes callbacks synchronously without holding a
group lock. No group history, registry, or automatic nested membership exists.
group lock. No group history or registry exists; contextual selection can enroll
nested ordinary runs that use the scoped context.
Smoke diagnostics mask inherited execution-recorder state while invoking
generation or HTTP collaborators. Their private attempt evidence is assembled

View File

@@ -72,6 +72,8 @@ a release, dependency upgrade, CLI implementation, or changes to published notes
## Stage 1 — Context Helper And Ordinary Run Selection
**Completed.**
Touch `observations.go`, the root `Engine.Run` in `engine.go`, and context support
in `internal/observation/recorder.go` or a focused adjacent file.