# proposals
dir: proposals

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

## role
Houses architectural design proposals for future system enhancements and refinements.
## files
- config-profile-multi-repo-mounts.md | Proposes a backward-compatible extension to Config Profiles' git_mounts to support multiple source/target mappings per repository clone, enabling efficient monorepo directory mounting.
- home-path-expansion.md | Proposes expanding `~` and `$HOME` in container mount target paths to the appropriate home directory based on tool manifest user configuration during Docker Compose generation. | dep: Docker Compose, tool manifest, Dockerfile generation, git mounts
- mount-specificity-ordering.md | Proposes sorting Docker Compose volume mounts by target path depth to prevent broader mounts from hiding more specific ones | dep: Docker Compose, manifest_compiler.py, tool_instances.py
- streamline-tool-container-definitions.md | Proposes a declarative YAML manifest system to replace hand-written Dockerfiles and Compose files for defining tool containers, with automatic compilation into Docker/Compose artifacts and compatibility with existing ConfigProfile mounts. | dep: Docker, Docker Compose, YAML/JSON parsing, database (PostgreSQL implied by JSONB), Python (implied by syntax examples), Node.js/npm, apt, git
- terminal-responsiveness.md | Proposes architectural improvements to reduce web terminal latency and increase rendering performance through asyncio I/O, WebGL rendering, and WebSocket optimizations. | dep: docker, asyncio, WebSocket, WebGL, PTY, Docker Engine API
## arch
Markdown-based RFC-style documentation with no executable code, organized by independent feature proposals spanning configuration, containerization, and performance domains.
## tags
mounts, proposes, docker, home, tool, compose, config, target
## symbols
-
## workflows
-
## dirty
-
