compose/pkg/api
Nicolas De Loof a182931307
api: write the event contract down, and hold the plan executor to it
The progress-event stream is a de-facto public surface: the TTY
renderer, --progress plain (grepped by user scripts), --progress json
(consumed by tools) and SDK EventProcessors all read it. Converging
the two lifecycle engines without a written contract is how silent
divergences happen.

api.EventProcessor now documents the contract: ordering is per
resource (global interleaving is explicitly not guaranteed), the
typical per-resource progressions
(Creating→Created, Starting→Started, Waiting→Healthy|Exited, ...),
early termination through Error or Skipped-with-reason, and status
texts as stable identifiers.

An executor test records the stream through a real plan (wait node +
enriched start) and asserts the per-resource progressions — the same
kind of assertion the wider phase 1 will lean on.

Validated design decision for #14081 (event parity contract).

Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
2026-08-17 21:48:03 +02:00
..
api.go Dedup pre_start hook images against service and each other 2026-07-30 10:40:06 +02:00
api_test.go Dedup pre_start hook images against service and each other 2026-07-30 10:40:06 +02:00
context.go Introduce abstractions to support SDK usage without requiring Docker CLI 2025-10-27 16:17:50 +01:00
env.go restore support for COMPOSE_COMPATIBILITY 2025-12-07 18:42:04 +01:00
errors.go move progress UI components into cmd 2025-11-12 11:17:28 +01:00
errors_test.go deps: remove deprecated github.com/pkg/errors 2023-09-29 06:28:58 +02:00
event.go api: write the event contract down, and hold the plan executor to it 2026-08-17 21:48:03 +02:00
labels.go feat(ps): add ENGINE column gated on label presence 2026-08-17 10:34:46 +02:00
labels_test.go golangci-lint: use gci formatter instead of goimports 2025-12-01 12:21:50 +01:00