# explorations
dir: explorations

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

## role
Contains design exploration documents for proposed features and architectural improvements in a container instance management system.
## files
- config-profile-multi-repo-mounts.md | Proposes a design for supporting multiple directory mounts from a single git repository clone in config profiles, avoiding redundant clones.
- home-path-expansion.md | Explores design options for expanding `~` and `$HOME` in container mount paths based on target container user context | dep: config_profile_resolver.py, tool_instances.py, manifest_compiler.py, Docker Compose
- mount-file-level-overlays.md | Explains a bug where directory-level bind mounts hide sibling files and proposes file-level bind mounts as the solution for overlaying individual files without affecting their parent directories. | dep: Docker, os
- mount-specificity-ordering.md | Design document proposing a solution to fix Docker mount ordering where broader parent-path mounts hide more specific child-path mounts by sorting volumes by target path depth | dep: Docker Compose, Linux mount system, manifest_compiler.py, tool_instances.py
- ssh-key-mounting.md | Design document for adding SSH key mounting capability to config profiles in a container instance management system | dep: ssh_keys table, GitRepository, ConfigProfile, compose volume mounts, alembic migrations, React frontend
- 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-strings/Jinja, Ubuntu base images, Cloudflare tunnels, PTY/WebSocket terminals
- terminal-responsiveness.md | Explores architectural improvements to achieve low-latency terminal I/O performance comparable to VS Code Server by identifying bottlenecks and proposing optimizations for a WebSocket-based web terminal. | dep: xterm.js, WebSocket, asyncio, select, docker, Python, TypeScript, React, node-pty, libuv, Docker Engine API
## arch
Markdown-based design documents following an RFC/exploration pattern, each analyzing a specific technical problem space, evaluating alternatives, and proposing solutions across mount systems, config profiles, container definitions, and terminal I/O performance.
## tags
mounts, container, mount, py, path, design, config, level
## symbols
-
## workflows
-
## dirty
-
