Developer
c8db6ce933
- Change mobile terminal CSS to use touch-action: none and overscroll-behavior: none so the custom touch handler owns swipes - Archive completed/partial OpenSpec specs to openspec/changes/archive/2026-06-14-completed-specs-archive/ - Regenerate project maps Quality gates: npm run typecheck, npm run lint (apps/web)
26 lines
2.5 KiB
Markdown
26 lines
2.5 KiB
Markdown
# explorations
|
|
dir: explorations
|
|
|
|
index: explorations/.pi-map.index.md
|
|
|
|
## role
|
|
Contains design exploration documents for proposed features and architectural improvements in a container instance management system.
|
|
## 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 `$HOME` in 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 RFC/exploration pattern, each analyzing a specific technical problem space, evaluating alternatives, and proposing solutions across mount systems, config profiles, container definitions, and terminal I/O performance.
|
|
## tags
|
|
mounts, container, mount, py, path, design, config, level
|
|
## symbols
|
|
-
|
|
## workflows
|
|
-
|
|
## dirty
|
|
-
|