ndeloof · Oct 8, 2026 · Oct 8, 2026 · Oct 8, 2026
@@ -0,0 +1,5 @@
+services:
+  app:
+    image: alpine
+    command: sleep infinity
+    init: true
@@ -0,0 +1,16 @@
+services:
+  db:
+    image: alpine
+    command: sleep infinity
+    init: true
+    healthcheck:
+      test: ["CMD", "false"]
+      interval: 1s
+      timeout: 1s
+      retries: 100
+  web:
+    image: alpine
+    command: echo web-started
+    depends_on:
+      db:
+        condition: service_healthy
@@ -0,0 +1,13 @@
+services:
+  app:
+    image: alpine
+    command: sh -c 'echo "app-read:$(cat /shared/init.txt)"; sleep 3'
+    volumes:
+      - data:/shared
+    pre_start:
+      - image: alpine
+        command: sh -c 'echo "pre-start-file-content" > /shared/init.txt'
+    post_start:
+      - command: echo post-start-hook-ran
+volumes:
+  data:
@@ -0,0 +1,8 @@
+services:
+  quick:
+    image: alpine
+    command: echo hi
+  long:
+    image: alpine
+    command: sleep infinity
+    init: true
@@ -0,0 +1,6 @@
+services:
+  app:
+    image: alpine
+    command: sh -c 'echo "value=$VALUE"; sleep 2'
+    environment:
+      VALUE: ${VALUE:-one}
@@ -0,0 +1,4 @@
+services:
+  app:
+    image: alpine
+    command: sh -c 'if [ -f /tmp/ran ]; then echo second-run; else touch /tmp/ran; fi'
@@ -0,0 +1,22 @@
+services:
+  db:
+    image: alpine
+    command: sh -c 'sleep 3; touch /shared/ready; sleep 60'
+    init: true
+    volumes:
+      - shared:/shared
+    healthcheck:
+      test: ["CMD", "test", "-f", "/shared/ready"]
+      interval: 1s
+      timeout: 1s
+      retries: 30
+  web:
+    image: alpine
+    command: sh -c 'if [ -f /shared/ready ]; then echo web-saw-ready; else echo web-too-early; fi'
+    volumes:
+      - shared:/shared
+    depends_on:
+      db:
+        condition: service_healthy
+volumes:
+  shared:
@@ -0,0 +1,106 @@
+//go:build e2e && !windows
+
+/*
+   Copyright 2026 Docker Compose CLI authors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+*/
+
+package e2e
+
+import (
+	"testing"
+	"time"
+)
+
+// The scenarios below lock the observable behavior of the foreground
+// (non-detached) `compose up`, whose create and start phases are driven by two
+// separate code paths today. They exist so a change of the machinery behind
+// it (epic #14081, lot 2) can be reviewed against a fixed specification.
+// Most e2e coverage of the start phase runs detached; these do not.
+
+// pre_start output is not asserted: a foreground up does not stream it into the
+// session today, only post_start's. What is locked for pre_start is its effect.
+func TestUpInteractiveHookLogs(t *testing.T) {
+	NewScenario(t, "a foreground up must run pre_start before the service starts and stream post_start output into its session").
+		Step("up shows post_start's output, and the service reads what pre_start wrote before it started",
+			ComposeCmd("up", "--menu=false").Within(120*time.Second),
+			OutputContains("app-read:pre-start-file-content"),
+			OutputContains("post-start-hook-ran"),
+			ServiceState("app", "exited"))
+}
+
+func TestUpInteractiveImmediateExit(t *testing.T) {
+	NewScenario(t, "a foreground up --abort-on-container-exit must notice a container that exits as soon as it starts").
+		Step("up aborts on the instantly exiting container instead of waiting for the long-running one",
+			ComposeCmd("up", "--menu=false", "--abort-on-container-exit").Within(60*time.Second),
+			OutputContains("quick-1 exited with code 0"),
+			OutputContains("Aborting on container exit"),
+			ServiceState("quick", "exited"),
+			Eventually(ServiceState("long", "exited"), 10*time.Second))
+}
+
+func TestUpInteractiveRestartsExitedContainer(t *testing.T) {
+	NewScenario(t, "a foreground up must start a container that exited earlier, reusing it").
+		Step("up -d leaves the service exited after its first run",
+			ComposeCmd("up", "-d"),
+			Eventually(ServiceState("app", "exited"), 15*time.Second)).
+		Step("a foreground up runs the same container a second time",
+			ComposeCmd("up", "--menu=false").Within(60*time.Second),
+			NotRecreated("app"),
+			OutputContains("second-run"),
+			ServiceState("app", "exited"))
+}
+
+func TestUpInteractiveWaitsForHealthy(t *testing.T) {
+	NewScenario(t, "a foreground up must not start a service before its service_healthy dependency is healthy").
+		Step("up starts web only once db reports healthy",
+			ComposeCmd("up", "--menu=false", "--abort-on-container-exit").Within(120*time.Second),
+			OutputContains("web-saw-ready"),
+			OutputNotContains("web-too-early"))
+}
+
+func TestUpInteractiveRecreateStreamsNewContainer(t *testing.T) {
+	NewScenario(t, "a foreground up after a config change must recreate the service and stream the new container's output").
+		Step("up -d creates the service with its first configuration",
+			ComposeCmd("up", "-d"),
+			Eventually(ServiceState("app", "exited"), 15*time.Second)).
+		Step("a foreground up with another value recreates it and shows the new output",
+			ComposeCmd("up", "--menu=false").WithEnv("VALUE=two").Within(60*time.Second),
+			Recreated("app"),
+			OutputContains("value=two"))
+}
+
+func TestUpInteractiveDependencyTimeout(t *testing.T) {
+	NewScenario(t, "a foreground up with --wait-timeout must fail once a dependency stays unhealthy, without starting the dependent").
+		Step("up fails on the dependency timeout; web is created but never started",
+			ComposeCmd("up", "--menu=false", "--wait-timeout", "3").MayFail().Within(60*time.Second),
+			ExitCode(1),
+			OutputContains("timeout waiting for dependencies"),
+			OutputNotContains("web-started"),
+			ServiceState("db", "running"),
+			// web's container is created in the create phase, before the start
+			// phase blocks on db's health: "created" (not "no container") is
+			// what says it was prepared but never started.
+			ServiceState("web", "created"))
+}
+
+func TestUpDryRunCreatesNothing(t *testing.T) {
+	s := NewScenario(t, "a foreground up --dry-run must plan the create phase only, never the start phase")
+	s.Step("up --dry-run reports the creation, no start, and leaves no container behind",
+		ComposeCmd("up", "--menu=false", "--dry-run").Within(60*time.Second),
+		OutputContains("Container "+s.Project()+"-app-1 Created"),
+		OutputNotContains(s.Project()+"-app-1 Start"),
+		OutputContains("interactive run is not supported in dry-run mode"),
+		ServiceNotCreated("app"))
+}