Developer
070cd4d5a5
Add generated .pi-map.md and .pi-map.index.md files across the repository so the project navigation maps are shared and versioned. These artifacts are maintained by project_map_init/patch/validate and must be kept in sync with source edits. Note: .cache/ remains ignored (added in previous commit).
2.4 KiB
2.4 KiB
openspec/explorations
dir: openspec/explorations
index: openspec/explorations/.pi-map.index.md
role
Design exploration and technical specification documents for container instance management system features and architectural improvements.
files
- config-profile-multi-repo-mounts.md | Proposes a design for supporting multiple directory mounts from a single git repository clone in config profiles, avoiding redundant clones.
- home-path-expansion.md | Explores design options for expanding
~and$HOMEin container mount paths based on target container user context | dep: config_profile_resolver.py, tool_instances.py, manifest_compiler.py, Docker Compose - mount-file-level-overlays.md | Explains a bug where directory-level bind mounts hide sibling files and proposes file-level bind mounts as the solution for overlaying individual files without affecting their parent directories. | dep: Docker, os
- mount-specificity-ordering.md | Design document proposing a solution to fix Docker mount ordering where broader parent-path mounts hide more specific child-path mounts by sorting volumes by target path depth | dep: Docker Compose, Linux mount system, manifest_compiler.py, tool_instances.py
- ssh-key-mounting.md | Design document for adding SSH key mounting capability to config profiles in a container instance management system | dep: ssh_keys table, GitRepository, ConfigProfile, compose volume mounts, alembic migrations, React frontend
- streamline-tool-container-definitions.md | Explores architectural redesign of a tool container definition system to replace monolithic Dockerfile strings and ad-hoc compose generation with a layered, declarative approach | dep: Docker, Docker Compose, SQLAlchemy, Python f-strings/Jinja, Ubuntu base images, Cloudflare tunnels, PTY/WebSocket terminals
- terminal-responsiveness.md | Explores architectural improvements to achieve low-latency terminal I/O performance comparable to VS Code Server by identifying bottlenecks and proposing optimizations for a WebSocket-based web terminal. | dep: xterm.js, WebSocket, asyncio, select, docker, Python, TypeScript, React, node-pty, libuv, Docker Engine API
arch
Markdown-based design documents following an exploratory RFC pattern, covering mount resolution algorithms, path expansion strategies, container definition layering, and WebSocket optimization techniques.
tags
mounts, container, mount, py, path, design, config, level