DOCKER-COMPOSE-5.5.1 release notes and known issues

Summary

What's Changed ✨ Improvements Feat(hooks): capture and surface lifecycle hook output by @glours in #14091 Feat(tracing): surface otel shutdown errors via --debug by @htoyoda18 in #14152 🐛 Fixes Fix(events): validate service names before subscribing to events by @glours in #14076 Fix: bake target names collision for services differing by . vs _ by @ndeloof in #14058 Fix(watch): sync into a symlinked directory instead of failing by @Endika in #14084 Fix(hooks): include hook output in the error when a hook fails by @dennislapchenko in #14088 Fix(build): TTY progress on Windows — hand the real stdout to buildkit by @ndeloof in #14090 Fix(watch): sync all files on initial_sync , regardless of mtime by @glours in #14096 Fix(network): pass IPAM options when creating networks by @glours in #14094 Fix(ps): honor psFormat from Docker CLI config when no --format flag given by @glours in #14095 Fix: dependency wait timeout surfaced only by luck by @ndeloof in #14105 Fix: hold startMx on the start path actually exercised by @ndeloof in #14106 Fix(watch): exclude Dockerfile and compose files from initial sync by @htoyoda18 in #14117 Fix(display): stop ttyWriter.Done from hanging after context cancel by @glours in #14119 Fix(build): honor provenance/sbom false in per-service bake attest by @glours in #14112 Fix(compose): reject unknown subcommands under bridge/transformations by @glours in #14143 Fix(plugins): honor PATHEXT for provider lookup on Windows by @ndeloof in #14159 Fix(watch): stop swallowing SetRecursive errors via nolint by @glours in #14165 Fix(bridge): confirm before wiping non-empty convert output dir by @glours in #14174 Fix(down): spare dangling images of orphaned services, like their tagged image by @htoyoda18 in #14154 🔧 Internal CI: raise e2e go-test timeout to 20m by @ndeloof in #14072 Lint: replace gocyclo with gocognit by @ndeloof in #14057 Test(e2e): prepend provider bin dir to PATH in provider tests by @glours in #14079 Refactor: dismantle the gocognit hotspots, one concern per function by @ndeloof in #14060 Test(e2e): declarative Scenario layer, project files under testdata// by @ndeloof in #14087 Docs: document engine container event sequences in up monitor by @ndeloof in #14024 E2E: fix test resource isolation and make standalone parallelism configurable by @glours in #14073 API: ScaleOptions carries the replica counts by @ndeloof in #14077 Chore: explicit, unique, greppable internal names by @ndeloof in #14049 Docs: update CONTRIBUTING.md to reflect current tooling and practices by @glours in #14098 API: option structs document what the implementation actually honors by @ndeloof in #14078 Test: unit-lock the imperative start path by @ndeloof in #14104 CLI: display.Mode always resolves to the mode actually rendered by @ndeloof in #14103 CI: validate generated mocks are in sync by @ndeloof in #14102 Docs(sdk): document the EventProcessor API that actually exists by @ndeloof in #14131 Test(e2e): gate the e2e suite behind the build tag the docs already promise by @ndeloof in #14132 Build: error messages name the real remedy, not a removed builder by @ndeloof in #14133 Docs(contributing): legibility guidelines — comments state behavior, not history by @ndeloof in #14135 Test(docs): compile the sdk.md examples by @ndeloof in #14136 Chore(compose): rename convergence.go, whose convergence engine no longer exists by @ndeloof in #14129 Chore(compose): comments state behavior, not history by @ndeloof in #14130 Test(build): re-enable wrong ssh key id test by @htoyoda18 in #14120 Chore(compose): orphan semantics stated where up and down diverge by @ndeloof in #14142 Refactor: NewGraph stops mutating the project by @ndeloof in #14124 Test(e2e): bump compose-bridge images to v0.0.7 by @ricardobranco777 in #14170 ⚙️ Dependencies Build(deps): bump github/codeql-action/upload-sarif from 4.37.6 to 4.37.7 by @dependabot [bot] in #14101 Remove buildx as a Go dependency by @ndeloof in #14123 Chore(deps): github.com/sirupsen/logrus v

Improvements and security content

• What's Changed ✨ Improvements Feat(hooks): capture and surface lifecycle hook output by @glours in #14091 Feat(tracing): surface otel shutdown errors via --debug by @htoyoda18 in #14152 🐛 Fixes Fix(events): validate service names before subscribing to events by @glours in #14076 Fix: bake target names collision for services differing by . vs _ by @ndeloof in #14058 Fix(watch): sync into a symlinked directory instead of failing by @Endika in #14084 Fix(hooks): include hook output in the error when a hook fails by @dennislapchenko in #14088 Fix(build): TTY progress on Windows — hand the real stdout to buildkit by @ndeloof in #14090 Fix(watch): sync all files on initial_sync , regardless of mtime by @glours in #14096 Fix(network): pass IPAM options when creating networks by @glours in #14094 Fix(ps): honor psFormat from Docker CLI config when no --format flag given by @glours in #14095 Fix: dependency wait timeout surfaced only by luck by @ndeloof in #14105 Fix: hold startMx on the start path actually exercised by @ndeloof in #14106 Fix(watch): exclude Dockerfile and compose files from initial sync by @htoyoda18 in #14117 Fix(display): stop ttyWriter.Done from hanging after context cancel by @glours in #14119 Fix(build): honor provenance/sbom false in per-service bake attest by @glours in #14112 Fix(compose): reject unknown subcommands under bridge/transformations by @glours in #14143 Fix(plugins): honor PATHEXT for provider lookup on Windows by @ndeloof in #14159 Fix(watch): stop swallowing SetRecursive errors via nolint by @glours in #14165 Fix(bridge): confirm before wiping non-empty convert output dir by @glours in #14174 Fix(down): spare dangling images of orphaned services, like their tagged image by @htoyoda18 in #14154 🔧 Internal CI: raise e2e go-test timeout to 20m by @ndeloof in #14072 Lint: replace gocyclo with gocognit by @ndeloof in #14057 Test(e2e): prepend provider bin dir to PATH in provider tests by @glours in #14079 Refactor: dismantle the gocognit hotspots, one concern per function by @ndeloof in #14060 Test(e2e): declarative Scenario layer, project files under testdata// by @ndeloof in #14087 Docs: document engine container event sequences in up monitor by @ndeloof in #14024 E2E: fix test resource isolation and make standalone parallelism configurable by @glours in #14073 API: ScaleOptions carries the replica counts by @ndeloof in #14077 Chore: explicit, unique, greppable internal names by @ndeloof in #14049 Docs: update CONTRIBUTING.md to reflect current tooling and practices by @glours in #14098 API: option structs document what the implementation actually honors by @ndeloof in #14078 Test: unit-lock the imperative start path by @ndeloof in #14104 CLI: display.Mode always resolves to the mode actually rendered by @ndeloof in #14103 CI: validate generated mocks are in sync by @ndeloof in #14102 Docs(sdk): document the EventProcessor API that actually exists by @ndeloof in #14131 Test(e2e): gate the e2e suite behind the build tag the docs already promise by @ndeloof in #14132 Build: error messages name the real remedy, not a removed builder by @ndeloof in #14133 Docs(contributing): legibility guidelines — comments state behavior, not history by @ndeloof in #14135 Test(docs): compile the sdk.md examples by @ndeloof in #14136 Chore(compose): rename convergence.go, whose convergence engine no longer exists by @ndeloof in #14129 Chore(compose): comments state behavior, not history by @ndeloof in #14130 Test(build): re-enable wrong ssh key id test by @htoyoda18 in #14120 Chore(compose): orphan semantics stated where up and down diverge by @ndeloof in #14142 Refactor: NewGraph stops mutating the project by @ndeloof in #14124 Test(e2e): bump compose-bridge images to v0.0.7 by @ricardobranco777 in #14170 ⚙️ Dependencies Build(deps): bump github/codeql-action/upload-sarif from 4.37.6 to 4.37.7 by @dependabot [bot] in #14101 Remove buildx as a Go dependency by @ndeloof in #14123 Chore(deps): github.com/sirupsen/logrus v

Affected products and versions

Recommended action

Review the official publisher document before deployment.

Official publisher evidence