# Proposal: Mount Specificity Ordering

## Problem
When git repo mounts and regular file mounts have overlapping target paths, the broader mount hides the more specific one because Docker Compose applies volumes in array order.

Example: repo → `/workspace/x` (directory) hides file → `/workspace/x/y/config.json`.

## Solution
Sort all volume entries by target path depth before writing the compose file. Parent paths first, child paths last, so deeper mounts overlay correctly.

## Scope
- `manifest_compiler.py` — `compile_compose()`
- `tool_instances.py` — `_modify_compose_file()`
- Unit tests for overlap scenarios

## Impact
- Fixes silent mount hiding
- Deterministic ordering
- No user-facing API or schema changes