# openspec/proposals
dir: openspec/proposals

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

## role
Contains design proposals and specifications for new features, architectural improvements, and UI/UX enhancements across the platform.
## files
- config-profile-multi-repo-mounts.md | Proposes a backward-compatible extension to Config Profile git_mounts to support multiple source/target mappings from a single repository clone
- home-path-expansion.md | Propose expanding `~` and `$HOME` in container mount target paths to the appropriate home directory based on tool manifest user configuration at compose generation time. | dep: Docker Compose, tool manifest, Dockerfile generation, git mount system
- 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
- project-pane-rework.md | A software design proposal for reworking the Projects page UI from expandable cards to a flat list showing project→repo→workspace→tool hierarchy with direct navigation. | dep: React/frontend, useProjects hook, useSessions hook, ProjectsPage.tsx, ProjectCard component, CSS/styles, routing/navigation
- streamline-tool-container-definitions.md | Proposes a declarative YAML/JSON manifest system to replace hand-written Dockerfiles and Compose files for tool container definitions, with automatic compilation and ConfigProfile compatibility. | dep: Docker, Docker Compose, YAML/JSON parsing, database (PostgreSQL with JSONB), existing ConfigProfile mount system, Node.js/apt/pip package managers
- terminal-responsiveness.md | Proposes architectural changes to improve web terminal performance by reducing latency, increasing throughput, and adding GPU rendering with async I/O. | dep: asyncio, WebSocket, Docker, WebGL, PTY, Docker Engine API
- ui-polish-round-config-sections-home-projects.md | Proposes UI polish changes to standardize config section styling, fix home page padding, and improve project repository layout alignment. | dep: global.css, manifest-editor.tsx, ConfigProfileEditorPanel.tsx, ProjectCard.tsx, styles/pages/projects.css
## arch
Markdown-based RFC/proposal system using flat-file documentation with no code implementation; covers config extensions, compose generation, container definitions, UI redesigns, and performance optimizations.
## tags
home, config, proposes, mounts, tool, container, projects, project
## symbols
-
## workflows
-
## dirty
-
