# designs
dir: designs

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

## role
Contains architectural design documents specifying features for containerized development environments, mount configurations, and terminal infrastructure.
## files
- config-profile-multi-repo-mounts.md | Design document for extending git mount configuration to support multiple source-to-target mappings per repository in a config profile system. | dep: JSONB, Python, TypeScript, React, os.path, glob expansion, config profile API, tool instances API
- home-path-expansion.md | Design document for implementing `~` and `$HOME` expansion in container mount paths based on manifest user configuration | dep: config_profile_resolver.py, manifest_compiler.py, tool_instances.py, os
- mount-specificity-ordering.md | Defines a design for sorting Docker volume mounts by target path depth to ensure more specific mounts take precedence, with duplicate detection warnings. | 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, time, collections.deque, xterm.js, xterm-addon-webgl, WebSocket, docker, JSON
- tool-container-home-directory.md | Proposes a design for standardizing tool container home directories to `/home/user` with configurable paths, meaningful repo mounts, and backward-compatible `/workspace` symlinks. | dep: ToolType model, manifest schema, Alembic, Docker/dockerfile, compose, config-profile mounts, git mounts, entrypoint permission fixer, home-path-expansion
- tool-definition-manifest.md | Defines a system for creating, validating, and compiling tool definition manifests into Dockerfiles, Docker Compose files, and entrypoint scripts for containerized development environments. | dep: Docker, PostgreSQL, Python (json, hashlib, shlex, yaml, subprocess), JSON Schema, deb/nodesource package repositories
## arch
Design-driven specification pattern using Markdown RFCs covering config systems, path resolution, mount ordering, async I/O with WebSocket/WebGL, and container manifest compilation pipelines.
## tags
home, py, docker, tool, design, path, mounts, mount
## symbols
-
## workflows
-
## dirty
-