# openspec/specs
dir: openspec/specs

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

## role
Contains technical specification documents defining requirements, APIs, and implementation strategies for cross-functional features spanning configuration, containerization, UI/UX, and terminal infrastructure.
## 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. | dep: Docker, Git, JSONB, config_profiles
- home-path-expansion.md | Specification document defining requirements for expanding `~` and `$HOME` in container mount paths during compose generation.
- mount-specificity-ordering.md | Defines requirements and algorithm for sorting Docker volume mounts by target path depth to ensure parent mounts are applied before child mounts
- project-pane-rework.md | Specifies a UI rework of the desktop Projects page from card-based layout to a flat list showing projects with horizontally arranged repositories, workspaces, and running tools. | dep: React, React Router, TypeScript, CSS custom properties, sessions state hook, existing types (ProjectWithRepos, RepositorySummary, WorkspaceSummary, Session), existing components (Icon, Link)
- terminal-responsiveness.md | Technical specification for a high-performance web terminal I/O pipeline rewrite targeting sub-frame latency and smooth rendering via PTY-based docker exec, WebSocket binary frames, output batching, and flow control. | dep: asyncio, pty, docker, WebSocket, xterm.js, WebGL, Python, TypeScript, Docker
- tool-definition-manifest.md | Specifies a declarative manifest system for defining tool containers without writing Dockerfiles or Compose files, including compilation, versioning, and runtime configuration. | dep: Docker, Docker Compose, JSON Schema, database (PostgreSQL implied), Python/FastAPI (implied by file paths), Alembic
- ui-polish-round-config-sections-home-projects.md | Defines UI polish specifications for unifying config sections, restoring home page paddings, and improving project repository layout in a web application. | dep: React, CSS custom properties, global.css, projects.css, manifest-editor.tsx, ConfigProfileEditorPanel.tsx, ProjectCard.tsx
## arch
Markdown-based specification repository using one-document-per-feature pattern, with each spec following a consistent structure of requirements, API contracts, algorithms, and test strategies; serves as the single source of truth for design decisions before implementation.
## tags
docker, home, config, mounts, projects, mount, manifest, specifies
## symbols
-
## workflows
-
## dirty
-