# specs
dir: specs

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

## role
Defines formal specifications and requirements for core system features including container configuration, terminal I/O, and build tooling.
## files
- config-profile-multi-repo-mounts.md | Specifies requirements, API contracts, and test strategy for supporting multiple directory mappings per git repository mount in configuration profiles
- home-path-expansion.md | Specifies requirements for expanding `~` and `$HOME` in container mount paths during Docker compose generation based on manifest user configuration.
- mount-specificity-ordering.md | Specifies requirements and algorithm for sorting Docker volume mounts by target path depth to ensure parent mounts are applied before child mounts | dep: manifest_compiler.py, tool_instances.py, logging
- terminal-responsiveness.md | Specification document for a high-performance web terminal I/O pipeline rewrite targeting sub-frame latency with event-driven PTY reading, output batching, flow control, and WebGL rendering. | dep: asyncio, pty, docker, WebSocket, xterm.js, WebGL, TypeScript, Python
- tool-definition-manifest.md | Specifies a declarative manifest system for defining tool containers without Dockerfiles, including compilation to Docker/Compose, versioning, permission policies, and backward compatibility. | dep: Docker, Docker Compose, JSON Schema, database (PostgreSQL with JSONB), Alembic, Python/FastAPI (implied by paths)
## arch
Document-driven specification pattern with Markdown-based RFCs covering API contracts, algorithms, and test strategies for cross-functional alignment before implementation.
## tags
mounts, docker, specifies, mount, manifest, requirements, home, path
## symbols
-
## workflows
-
## dirty
-
