# openspec/designs
dir: openspec/designs

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

## role
Contains architectural design documents and ADRs for planned features and improvements across the containerized development environment platform.
## files
- config-profile-multi-repo-mounts.md | Design document for adding multi-directory mapping support to git mounts in config profiles, allowing a single repository to mount multiple source paths to different target paths. | dep: os, JSONB database column, git cloning utilities, React/TypeScript frontend components, config profile API
- home-path-expansion.md | Design document specifying how to expand ~ and $HOME variables in container mount paths based on manifest-defined user or default /root | dep: config_profile_resolver.py, manifest_compiler.py, tool_instances.py, os
- mount-specificity-ordering.md | Design document specifying a helper function to sort Docker volume mounts by target path depth to ensure correct mount specificity ordering | dep: docker.py, manifest_compiler.py, tool_instances.py, collections.Counter, logging
- terminal-responsiveness.md | Design document for a high-performance web terminal rewrite using asyncio-native I/O, binary WebSocket frames, output batching, flow control, and WebGL rendering | dep: asyncio, pty, os, docker, xterm.js, xterm-addon-webgl, WebSocket, JSON
- tool-container-home-directory.md | Proposes a design/ADR for standardizing and making configurable the home directory in tool containers, defaulting to `/home/user`, with repository mounts under meaningful paths and a backward-compatible `/workspace` symlink. | dep: dockerfile, compose, ToolType model, manifest schema, Alembic, base.dockerfile, entrypoint permission fixer, config-profile mounts, git mounts
- tool-definition-manifest.md | Design document for a JSON-based manifest system that defines, validates, compiles, and deploys containerized development tools via Docker and Docker Compose | dep: Docker, Docker Compose, PostgreSQL, Python (json, hashlib, shlex, yaml, subprocess)
## arch
Markdown-based design documentation repository using lightweight ADR pattern with no code, focused on cross-cutting concerns spanning container orchestration, filesystem mounts, terminal I/O, and tool manifest systems.
## tags
home, design, py, docker, document, mounts, mount, tool
## symbols
-
## workflows
-
## dirty
-
