# openspec/explorations
dir: openspec/explorations

index: openspec/explorations/.pi-map.index.md

## role
Contains exploratory design documents and architectural proposals for future enhancements and bug fixes across the container runtime, configuration system, and developer experience.
## files
- config-profile-multi-repo-mounts.md | Design document proposing a schema enhancement to allow multiple directory mounts from a single git repository clone in config profiles.
- home-path-expansion.md | Design document for implementing `~` and `$HOME` expansion in container mount paths with manifest-aware home directory resolution | dep: Docker Compose, manifest system, config profile resolver, git mount mappings, tool instances API
- mount-file-level-overlays.md | Documents a bug fix for file-level mount overlays in Docker volume mounts to prevent directory replacement from hiding sibling files | dep: Docker, os, pathlib
- mount-specificity-ordering.md | Explores a bug where Docker volume mount ordering causes broader parent mounts to hide more specific child mounts, and recommends sorting mounts by path depth to fix it. | dep: Docker Compose, manifest_compiler.py, tool_instances.py, Linux mount system
- ssh-key-mounting.md | Design document proposing to add SSH key mounting capability to ConfigProfile for all instance types, decoupling SSH keys from repositories | dep: config_profile, ssh_keys, GitRepository, instance_dir/mounts, compose, alembic, config_profile_resolver, config_profiles API/web
- streamline-tool-container-definitions.md | Explores architectural redesign of a tool container definition system to replace monolithic Dockerfile strings and ad-hoc compose generation with a layered, declarative approach | dep: Docker, Docker Compose, SQLAlchemy, Python f-string templating, Jinja-like templating, PTY/WebSocket terminal sessions, Cloudflare tunneling
- terminal-responsiveness.md | A software design document analyzing terminal I/O latency bottlenecks and proposing optimizations to achieve VS Code Server-level responsiveness in a web-based terminal. | dep: docker, xterm.js, WebSocket, asyncio, Python os/select, node-pty (reference), Docker SDK
## arch
Markdown-based RFC/ADR pattern with no executable code; each document independently analyzes a specific problem space, evaluates trade-offs, and proposes solutions using structured software design document format with problem statements, options analysis, and recommendations.
## tags
mounts, mount, docker, design, document, home, container, level
## symbols
-
## workflows
-
## dirty
-
