Files
headquarter/openspec/tasks/mount-specificity-ordering.md
T
Alex Blank 0952aa8217 fix: sort mount volumes by specificity to prevent parent mounts hiding children
When git repo mounts and regular file mounts have overlapping target
paths, broader parent mounts hide deeper child mounts because Docker
Compose applies volumes in array order.

- Add sort_volumes_by_specificity() to docker.py:
  - Sorts by target path depth (parent paths first, child paths last)
  - Logs warnings for duplicate targets
  - Handles :bind and :ro suffixes correctly

- Integrate into manifest flow (compile_compose):
  - Sorts manifest mounts + EXTRA_VOLUMES before writing compose

- Integrate into legacy flow (_modify_compose_file):
  - Sorts after appending extra_volumes to existing template volumes

- Add 6 unit tests covering parent/child ordering, stable sort,
  type suffixes, empty list, single volume, and duplicate warnings.

Quality gates: pytest (214 passed, 6 pre-existing), tsc --noEmit (clean)
2026-05-29 11:35:27 +02:00

431 B

Tasks: Mount Specificity Ordering

  • Exploration written
  • Proposal written
  • Spec written
  • Design written
  • Implement sort_volumes_by_specificity in docker.py
  • Integrate sorting into compile_compose (manifest flow)
  • Integrate sorting into _modify_compose_file (legacy flow)
  • Add unit tests for helper and overlap scenarios
  • Run quality gates (pytest, tsc)
  • Commit and merge