Release v1.0.12: harden Compose V2 detection in Makefiles.

Probe docker compose with an absolute docker binary, then fall back to docker-compose.

Author: HecFranco

Makefile

@@ -1,12 +1,12 @@
 # Makefile for API Studio Bundle
 
 COMPOSE_FILE := docker-compose.yml
-# Prefer Compose V2; use absolute docker path so a local ./docker/ dir cannot shadow the CLI (PATH has ".").
+# Prefer Compose V2 with absolute docker path (avoid ./docker/ shadowing when PATH has ".") (REQ-MAKE-010).
 DOCKER_BIN := $(shell command -v docker 2>/dev/null)
 ifeq ($(DOCKER_BIN),)
 COMPOSE_BIN := docker-compose
 else
-COMPOSE_BIN := $(DOCKER_BIN) compose
+COMPOSE_BIN := $(shell $(DOCKER_BIN) compose version >/dev/null 2>&1 && echo "$(DOCKER_BIN) compose" || echo "docker-compose")
 endif
 COMPOSE     := $(COMPOSE_BIN) -f $(COMPOSE_FILE)
 SERVICE_PHP := php

demo/symfony8/Makefile

@@ -3,7 +3,7 @@ DOCKER_BIN := $(shell command -v docker 2>/dev/null)
 ifeq ($(DOCKER_BIN),)
 COMPOSE ?= docker-compose
 else
-COMPOSE ?= $(DOCKER_BIN) compose
+COMPOSE ?= $(shell $(DOCKER_BIN) compose version >/dev/null 2>&1 && echo "$(DOCKER_BIN) compose" || echo "docker-compose")
 endif
 
 .PHONY: help up down build install shell logs test test-coverage cache-clear reset-demo link-bundle update-bundle ensure-up restart release-check setup verify

demo/symfony8/composer.lock

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## Table of contents
 
 - [[Unreleased]](#unreleased)
+- [[1.0.12] - 2026-07-29](#1012-2026-07-29)
 - [[1.0.11] - 2026-07-29](#1011-2026-07-29)
 - [[1.0.10] - 2026-07-28](#1010-2026-07-28)
 - [[1.0.9] - 2026-07-28](#109-2026-07-28)
@@ -23,6 +24,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.12] - 2026-07-29
+
+### Changed
+
+- Makefiles probe Compose V2 via absolute `docker` binary (`command -v`) before falling back to `docker-compose` (REQ-MAKE-010).
+
+### Compatibility
+
+- Unchanged: PHP `>=8.2 <8.6`, Symfony `^7.0 || ^8.0`.
+
+[1.0.12]: https://github.com/nowo-tech/ApiStudioBundle/releases/tag/v1.0.12
+
 ## [1.0.11] - 2026-07-29
 
 ### Changed

docs/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - [General](#general)
 - [Before upgrading](#before-upgrading)
+- [To 1.0.12](#to-1012)
 - [To 1.0.11](#to-1011)
 - [To 1.0.10](#to-1010)
 - [To 1.0.9](#to-109)
@@ -28,6 +29,16 @@ Follow [CHANGELOG.md](CHANGELOG.md) for breaking changes between versions.
 2. Run your test suite and `composer audit`.
 3. Back up the database if you store Api Studio entities in production.
 
+## To 1.0.12
+
+From **1.0.11** — maintainer Makefile only.
+
+```bash
+composer update nowo-tech/api-studio-bundle
+```
+
+No application changes. Makefiles probe Compose V2 with an absolute `docker` path, then fall back to `docker-compose`.
+
 ## To 1.0.11
 
 From **1.0.10** — maintainer Makefile only.