fix: disable native touch panning on mobile terminal and archive specs

- 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)
This commit is contained in:
Developer
2026-06-14 18:07:01 +00:00
parent 896674195c
commit c8db6ce933
580 changed files with 4678 additions and 4333 deletions
@@ -1,80 +1,80 @@
# archive/2026-06-12-completed-changes-archive (index)
dir: archive/2026-06-12-completed-changes-archive
# 2026-06-12-completed-changes-archive (index)
dir: 2026-06-12-completed-changes-archive
## role
Stores historical records of fully implemented and audited OpenSpec changes for reference and audit trail purposes.
Historical archive documenting completed OpenSpec changes for audit and reference purposes.
## parent
index: archive/.pi-map.index.md
map: archive/.pi-map.md
index: ./.pi-map.index.md
map: ./.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
index: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md
- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
- archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
- archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md
- archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md
- archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md
- archive/2026-06-12-completed-changes-archive/git-mount-url-validation
index: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md
- archive/2026-06-12-completed-changes-archive/home-path-expansion
index: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md
- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
- archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
index: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md
- archive/2026-06-12-completed-changes-archive/notification-center
index: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md
- archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
- archive/2026-06-12-completed-changes-archive/session-list-overhaul
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
- archive/2026-06-12-completed-changes-archive/ssh-key-mounting
index: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md
- archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
index: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md
- archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup
index: archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md
- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
- archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux
index: archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md
- archive/2026-06-12-completed-changes-archive/reorganize-long-files
index: archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md
- archive/2026-06-12-completed-changes-archive/working-copies
index: archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md
- archive/2026-06-12-completed-changes-archive/workspace-first-ui
index: archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md
- 2026-06-12-completed-changes-archive/backend-frontend-refactoring
index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-directory-mounts
index: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-git-mounts
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-includes-ui
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
index: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md
- 2026-06-12-completed-changes-archive/container-monitoring-notifications
index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md
- 2026-06-12-completed-changes-archive/git-mount-url-validation
index: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md
- 2026-06-12-completed-changes-archive/home-path-expansion
index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md
- 2026-06-12-completed-changes-archive/mobile-terminal-ux
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
- 2026-06-12-completed-changes-archive/mount-specificity-ordering
index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md
- 2026-06-12-completed-changes-archive/multi-session-terminal-ux
index: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md
- 2026-06-12-completed-changes-archive/notification-center
index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/notification-center/.pi-map.md
- 2026-06-12-completed-changes-archive/persistent-terminal-sessions
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
- 2026-06-12-completed-changes-archive/reorganize-long-files
index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md
- 2026-06-12-completed-changes-archive/session-list-overhaul
index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
- 2026-06-12-completed-changes-archive/ssh-key-mounting
index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md
- 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
index: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md
- 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
index: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md
- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
- 2026-06-12-completed-changes-archive/working-copies
index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/working-copies/.pi-map.md
- 2026-06-12-completed-changes-archive/workspace-first-ui
index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md
## files
- README.md
## links
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## workflows
-
## dirty
@@ -1,22 +1,16 @@
# archive/2026-06-12-completed-changes-archive
dir: archive/2026-06-12-completed-changes-archive
# 2026-06-12-completed-changes-archive
dir: 2026-06-12-completed-changes-archive
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
## role
Stores historical records of fully implemented and audited OpenSpec changes for reference and audit trail purposes.
Historical archive documenting completed OpenSpec changes for audit and reference purposes.
## files
- README.md | Documents archived completed OpenSpec changes that have been audited and confirmed as fully implemented
- config-profile-directory-mounts | Completed OpenSpec change for directory-level config profile mounts
- multi-session-terminal-ux | Completed OpenSpec change for multi-session terminal UX
- reorganize-long-files | Completed OpenSpec change for reorganizing long files
- tool-config-mount-cleanup | Completed OpenSpec change for cleaning up built-in tool config/state mounts
- working-copies | Completed OpenSpec change for workspace-first working copies
- workspace-first-ui | Completed OpenSpec change for workspace-first UI
- README.md | Documents a historical archive of 17 fully implemented OpenSpec changes that have been audited against the source tree
## arch
Simple flat-file archive using date-based directory naming and markdown documentation for immutable change tracking.
Simple documentation-based archive pattern with no active code, serving as immutable change log for compliance tracking.
## tags
readme, documents, archived, completed, openspec, changes, have, been
readme, documents, historical, archive, fully, implemented, openspec, changes
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring (index)
dir: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
# 2026-06-12-completed-changes-archive/backend-frontend-refactoring (index)
dir: 2026-06-12-completed-changes-archive/backend-frontend-refactoring
## role
This package serves as a completed historical archive of a structural refactoring initiative to decompose monolithic backend/frontend code into domain-based modular subpackages without changing behavior or API contracts.
This package serves as an archived planning and specification artifact for a completed structural refactoring that decomposed a monolithic Python/FastAPI backend and TypeScript frontend into domain-based modular subpackages.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -15,8 +15,8 @@ map: archive/2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md
index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
dir: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
# 2026-06-12-completed-changes-archive/backend-frontend-refactoring
dir: 2026-06-12-completed-changes-archive/backend-frontend-refactoring
index: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
## role
This package serves as a completed historical archive of a structural refactoring initiative to decompose monolithic backend/frontend code into domain-based modular subpackages without changing behavior or API contracts.
This package serves as an archived planning and specification artifact for a completed structural refactoring that decomposed a monolithic Python/FastAPI backend and TypeScript frontend into domain-based modular subpackages.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Architecture design document for a large-scale backend/frontend refactoring to decompose monolithic modules into domain-based subpackages while preserving API contracts and behavior | dep: FastAPI, Pydantic, SQLAlchemy, Docker, cloudflared, React/TypeScript
@@ -12,7 +12,7 @@ This package serves as a completed historical archive of a structural refactorin
- spec.md | Defines a pure structural refactoring specification for extracting schemas, splitting monolithic services, reorganizing frontend features, and standardizing naming conventions without changing any behavior or API contracts. | dep: Pydantic, FastAPI (implied by Depends, API routers), SQLAlchemy AsyncSession, React/TypeScript frontend, Docker, ruff, npm
- tasks.md | Defines a multi-phase refactoring plan to reorganize a Python/FastAPI backend and TypeScript frontend codebase into modular subpackages with verification steps | dep: FastAPI, Docker, pytest, ruff, py_compile, npm, TypeScript, React Router
## arch
Documentation-driven refactoring architecture using phased planning (proposal → design → spec → tasks) with OpenSpec schema validation, emphasizing pure structural changes with zero behavioral modification and comprehensive verification steps.
Document-driven waterfall planning architecture using OpenSpec schema configuration, multi-phase task breakdown (design → proposal → specification → implementation), and strict behavior-preserving refactoring patterns with API contract immutability and verification gates.
## tags
frontend, refactoring, defines, design, backend, monolithic, behavior, fastapi
## symbols
@@ -1,24 +1,11 @@
# . (index)
dir: .
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
# 2026-06-12-completed-changes-archive/config-profile-directory-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-directory-mounts
## role
Provides configuration and documentation for a mount staging system that resolves file ownership issues in containerized environments.
Archives a completed configuration profile refactoring that fixes root-owned directory mount issues by staging and bind-mounting entire directories.
## parent
-
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -26,8 +13,8 @@ Provides configuration and documentation for a mount staging system that resolve
- proposal.md
- tasks.md
## links
index: ./.pi-map.index.md
map: ./.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,30 +1,16 @@
# .
dir: .
# 2026-06-12-completed-changes-archive/config-profile-directory-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-directory-mounts
index: ./.pi-map.index.md
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
index: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
## role
Provides configuration and documentation for a mount staging system that resolves file ownership issues in containerized environments.
Archives a completed configuration profile refactoring that fixes root-owned directory mount issues by staging and bind-mounting entire directories.
## files
- .openspec.yaml | Defines an OpenSpec configuration profile for directory mounts with completion tracking metadata
- proposal.md | Proposes a design change to fix root-owned directory issues in config profile mounts by staging and bind-mounting entire directories instead of individual files. | dep: Docker, config_profile_resolver.py, test_config_profile_resolver.py
- tasks.md | Tracks completed development tasks for refactoring a mount staging system and running quality gates.
## arch
Configuration-driven design using YAML profiles for directory mounts, with a proposal-based development approach documenting a shift from file-level to directory-level bind-mount staging.
Documentation-driven change proposal with OpenSpec configuration, using a task-tracked implementation workflow for filesystem mount refactoring.
## tags
tasks, profile, directory, mounts, .openspec, staging, py, proposal
## symbols
@@ -1,23 +1,23 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
# 2026-06-12-completed-changes-archive/config-profile-git-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts
## role
Archive of completed work for adding git repository mount support to config profiles for version-controlled dotfiles in containers.
Archive of completed work for adding git repository mount support to config profiles, enabling version-controlled dotfiles in containers.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
# 2026-06-12-completed-changes-archive/config-profile-git-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
## role
Archive of completed work for adding git repository mount support to config profiles for version-controlled dotfiles in containers.
Archive of completed work for adding git repository mount support to config profiles, enabling version-controlled dotfiles in containers.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for adding git repository mount support to config profiles in a container management system | dep: ConfigProfile, git repositories, clone service, instance startup, Docker/volume mounts, database/JSONB
- proposal.md | Proposes adding git repository mounts to config profiles for version-controlled dotfiles in containers | dep: config profiles, git repositories, docker/container startup, database migrations, frontend UI/API
- tasks.md | A completed task checklist for implementing git repository mount functionality across database models, backend API, frontend UI, and documentation | dep: Alembic, SQLAlchemy, Pydantic, FastAPI, TypeScript, Docker Compose, git clone service
## arch
Design-driven feature implementation with proposal/design/task phases, covering full stack changes (database models, backend API, frontend UI, documentation) and OpenSpec configuration schema.
Design-driven feature implementation using proposal/design/task documentation hierarchy, with cross-stack changes spanning database models, backend API, frontend UI, and documentation.
## tags
design, git, repository, .openspec, adding, mount, config, profiles
## symbols
@@ -1,22 +1,22 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs (index)
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
## role
Contains archived specification documents for a configuration profile feature that manages Git repository mounts, preserved as a historical snapshot from June 12, 2026.
Contains specification files defining configuration requirements and validation rules for git repository mount profiles.
## parent
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md
- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md
## files
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
## role
Contains archived specification documents for a configuration profile feature that manages Git repository mounts, preserved as a historical snapshot from June 12, 2026.
Contains specification files defining configuration requirements and validation rules for git repository mount profiles.
## files
## arch
Flat directory structure storing archived specification files with no active code, serving as a read-only reference for completed system changes.
Declarative specification pattern using structured config files (likely JSON/YAML) to define mount schemas, with separation of concerns between profile definitions and their operational implementation.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
## role
Defines requirements for mounting git repositories into containers via configuration profiles, enabling version-controlled configuration and content injection.
Defines requirements for mounting git repositories into containers via configuration profiles.
## parent
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
## role
Defines requirements for mounting git repositories into containers via configuration profiles, enabling version-controlled configuration and content injection.
Defines requirements for mounting git repositories into containers via configuration profiles.
## files
- spec.md | Defines requirements for adding git repository mounting capabilities to config profiles in a container management system | dep: git, container runtime, config profile system, UI/profile editor
## arch
Specification-driven requirements document using structured markdown with sections for overview, requirements, and use cases, serving as a design contract for a container platform feature.
Specification-driven requirements document using markdown-based technical specification pattern.
## tags
git, spec, defines, requirements, adding, repository, mounting, capabilities
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances (index)
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
## role
Defines requirements for git repository mount processing during tool instance startup.
Defines requirements for git repository mounting behavior during tool instance startup.
## parent
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
## role
Defines requirements for git repository mount processing during tool instance startup.
Defines requirements for git repository mounting behavior during tool instance startup.
## files
- spec.md | Defines requirements for git repository mount processing during tool instance startup, including config profile resolution, bind mount creation, auto-cloning, and failure handling.
## arch
Specification-driven requirements document using markdown-based technical specification pattern.
Specification-driven requirements document using plain markdown with no code implementation or architectural patterns.
## tags
mount, spec, defines, requirements, git, repository, processing, tool
## symbols
@@ -1,23 +1,23 @@
# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
# 2026-06-12-completed-changes-archive/config-profile-includes-ui (index)
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui
## role
Archive of a completed frontend UI feature for drag-and-drop management of config profile includes with dependency visualization and cycle detection.
Archive of completed UI work for drag-and-drop config profile includes management with cycle detection and scope visualization.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
# 2026-06-12-completed-changes-archive/config-profile-includes-ui
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
## role
Archive of a completed frontend UI feature for drag-and-drop management of config profile includes with dependency visualization and cycle detection.
Archive of completed UI work for drag-and-drop config profile includes management with cycle detection and scope visualization.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata
- design.md | Design document for adding drag-and-drop profile includes management UI to an existing config profile editor frontend | dep: React, HTML5 Drag and Drop API, config profiles backend API (listConfigProfiles, updateConfigProfile, updateProfileIncludes), existing scope badge components
- proposal.md | Proposes a UI feature for drag-and-drop management of ordered config profile includes with cycle detection and scope visualization | dep: config profiles backend API, frontend React app, drag-and-drop library
- tasks.md | Task tracking document for implementing a profile "includes" feature with UI, drag-and-drop reordering, and error handling
## arch
Design-proposal-task documentation trail with OpenSpec schema metadata, capturing iterative specification of a React/Vue-like component-based UI with topological ordering constraints and visual dependency graph rendering.
Design-driven feature development with phased task tracking, using OpenSpec schema validation and explicit frontend/UX architecture documentation.
## tags
drag, profile, design, drop, includes, .openspec, document, management
## symbols
@@ -1,19 +1,19 @@
# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs (index)
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
## role
Contains archived specification documents for the config-profile-includes-ui feature from a completed changeset dated June 12, 2026.
Contains archived specification documents for the config-profile-includes-ui feature that was completed on 2026-06-12.
## parent
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md
- 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md
## files
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
## role
Contains archived specification documents for the config-profile-includes-ui feature from a completed changeset dated June 12, 2026.
Contains archived specification documents for the config-profile-includes-ui feature that was completed on 2026-06-12.
## files
## arch
N/A (empty directory - no code or architectural patterns present; intended as historical documentation storage for completed UI specifications)
Document-based specification storage with date-versioned archiving pattern for completed feature requirements.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management (index)
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
## role
Defines requirements for a UI feature that allows users to manage which configuration profiles are included in another profile.
Defines requirements for a config profile editor feature that enables users to view, modify, and persist profile include configurations through a management UI.
## parent
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
## role
Defines requirements for a UI feature that allows users to manage which configuration profiles are included in another profile.
Defines requirements for a config profile editor feature that enables users to view, modify, and persist profile include configurations through a management UI.
## files
- spec.md | Define requirements for a config profile editor feature that manages profile includes with display, add/remove/reorder functionality, and save capabilities | dep: profile editor UI, includes API, profile update API, dropdown component, drag-and-drop system
## arch
Specification-driven requirements document using Markdown format with user stories, acceptance criteria, and UI/UX details for a CRUD+reorder management interface.
Requirements specification using structured documentation pattern with functional requirements organized by user interaction flows (display, add/remove, reorder, save) and explicit UI/UX constraints.
## tags
profile, spec, define, requirements, config, editor, feature, manages
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts (index)
dir: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
# 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
## role
Preserves the completed feature specification for multi-repo mount configuration in Config Profiles as a historical archive record.
Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount entry.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
index: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md
index: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
dir: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
# 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
index: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
## role
Preserves the completed feature specification for multi-repo mount configuration in Config Profiles as a historical archive record.
Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount entry.
## files
- .openspec.yaml | Define a completed feature specification for enabling multiple source/target mappings per git mount entry in Config Profiles with single repository cloning
## arch
Specification-as-Archive pattern using OpenSpec YAML format to document finalized feature requirements outside active codebase.
Specification-as-code pattern using OpenSpec YAML for formal feature documentation and change tracking in a dated archive directory structure.
## tags
.openspec, define, completed, feature, specification, enabling, multiple, source
## symbols
@@ -1,11 +1,11 @@
# archive/2026-06-12-completed-changes-archive/container-monitoring-notifications (index)
dir: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
# 2026-06-12-completed-changes-archive/container-monitoring-notifications (index)
dir: 2026-06-12-completed-changes-archive/container-monitoring-notifications
## role
Archive of completed design, specification, and implementation documentation for a real-time container monitoring and notification system that replaced polling with Server-Sent Events.
Implements a real-time container monitoring and notification system that streams lifecycle events and health status from backend to frontend via SSE, replacing polling with instant visibility into container failures.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -20,8 +20,8 @@ map: archive/2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md
index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
dir: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
# 2026-06-12-completed-changes-archive/container-monitoring-notifications
dir: 2026-06-12-completed-changes-archive/container-monitoring-notifications
index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
## role
Archive of completed design, specification, and implementation documentation for a real-time container monitoring and notification system that replaced polling with Server-Sent Events.
Implements a real-time container monitoring and notification system that streams lifecycle events and health status from backend to frontend via SSE, replacing polling with instant visibility into container failures.
## files
- .openspec.yaml | Defines an OpenSpec project specification for a container monitoring and notification system
- apply-pr1.md | Documents the implementation of a backend core for container monitoring and notifications, including database migrations, SQLAlchemy models, event bus, health monitoring, SSE endpoint, lifecycle hooks, structured logging, and unit tests. | dep: SQLAlchemy, Alembic, FastAPI, asyncio, uvicorn, pytest, ruff, Docker, JSON
@@ -17,7 +17,7 @@ Archive of completed design, specification, and implementation documentation for
- spec.md | Specifies a container monitoring and notification system using an in-memory event bus, background health monitor, SSE streaming, and frontend toast notifications with persistent audit logging. | dep: asyncio, PostgreSQL, Docker CLI, HTTP/tunnel, SSE/Server-Sent Events, JWT/cookie auth, JSON logging
- tasks.md | Defines a detailed software development plan for building a container monitoring and notification system across backend and frontend, broken into chained PRs with specific tasks, acceptance criteria, and dependencies. | dep: FastAPI, SQLAlchemy, Alembic, Docker, asyncio, SSE/EventSource, React, sonner, pytest
## arch
Event-driven architecture using in-memory pub/sub EventBus, background health polling with SQLAlchemy persistence, SSE streaming from FastAPI backend, and frontend toast notifications; implemented via 3 chained PRs with structured logging, audit trails, and comprehensive test coverage.
Event-driven architecture with in-memory pub/sub EventBus, background health polling, Server-Sent Events streaming from FastAPI backend, and frontend toast notification UI; implemented across chained PRs with SQLAlchemy models, structured logging, and persistent audit logging.
## tags
sse, container, monitoring, system, apply, notifications, fastapi, asyncio
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/git-mount-url-validation (index)
dir: archive/2026-06-12-completed-changes-archive/git-mount-url-validation
# 2026-06-12-completed-changes-archive/git-mount-url-validation (index)
dir: 2026-06-12-completed-changes-archive/git-mount-url-validation
## role
Preserves the historical specification for a completed git mount URL validation feature as an archived OpenSpec artifact.
Archives the completed specification for a git mount URL validation feature that was implemented as a high-priority item.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
index: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md
index: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/git-mount-url-validation
dir: archive/2026-06-12-completed-changes-archive/git-mount-url-validation
# 2026-06-12-completed-changes-archive/git-mount-url-validation
dir: 2026-06-12-completed-changes-archive/git-mount-url-validation
index: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
## role
Preserves the historical specification for a completed git mount URL validation feature as an archived OpenSpec artifact.
Archives the completed specification for a git mount URL validation feature that was implemented as a high-priority item.
## files
- .openspec.yaml | Defines an OpenSpec specification for a completed high-priority feature named "git-mount-url-validation"
## arch
Simple archive pattern using dated directory structure with YAML-based specification storage for completed feature tracking.
Specification-as-code pattern using OpenSpec YAML format for feature documentation and archival.
## tags
.openspec, defines, openspec, specification, completed, high, priority, feature
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/home-path-expansion (index)
dir: archive/2026-06-12-completed-changes-archive/home-path-expansion
# 2026-06-12-completed-changes-archive/home-path-expansion (index)
dir: 2026-06-12-completed-changes-archive/home-path-expansion
## role
Preserves a completed feature specification for home directory path expansion in container mount targets.
Archive of a completed feature specification for home directory path expansion in container mount targets.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
index: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md
index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/home-path-expansion
dir: archive/2026-06-12-completed-changes-archive/home-path-expansion
# 2026-06-12-completed-changes-archive/home-path-expansion
dir: 2026-06-12-completed-changes-archive/home-path-expansion
index: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
## role
Preserves a completed feature specification for home directory path expansion in container mount targets.
Archive of a completed feature specification for home directory path expansion in container mount targets.
## files
- .openspec.yaml | Defines a completed feature specification for resolving home directory path expansion (~ and $HOME) in container mount target paths based on manifest user configuration.
## arch
Specification-as-archive pattern using YAML-based feature documentation for completed work.
Specification-driven change documentation using OpenSpec YAML format for tracking completed feature implementations.
## tags
home, .openspec, defines, completed, feature, specification, resolving, directory
## symbols
@@ -1,23 +1,23 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux (index)
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
# 2026-06-12-completed-changes-archive/mobile-terminal-ux (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux
## role
Contains archived design documents and planning artifacts for a mobile-friendly web terminal UX enhancement that was completed on 2026-06-12.
Archives the completed mobile terminal UX redesign that enables web-based terminal usage on mobile devices through virtual keyboard handling, viewport optimization, and touch-friendly controls without external dependencies.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
# 2026-06-12-completed-changes-archive/mobile-terminal-ux
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
## role
Contains archived design documents and planning artifacts for a mobile-friendly web terminal UX enhancement that was completed on 2026-06-12.
Archives the completed mobile terminal UX redesign that enables web-based terminal usage on mobile devices through virtual keyboard handling, viewport optimization, and touch-friendly controls without external dependencies.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata
- design.md | Design document for making a web-based terminal mobile-friendly by addressing virtual keyboard handling, maximizing screen real estate, and providing special key access without adding new dependencies. | dep: React, xterm.js, browser APIs (Visual Viewport API, Clipboard API, WebSocket)
- proposal.md | Proposes a mobile-optimized terminal interface with special keys toolbar, dynamic viewport handling, and touch gestures to make terminal sessions usable on mobile devices. | dep: xterm.js, React, visualViewport API
- tasks.md | Task tracking checklist for implementing a mobile-responsive terminal interface with WebSocket connectivity, touch-friendly controls, and virtual keyboard handling. | dep: React, Visual Viewport API, WebSocket, Visibility API, localStorage, CSS transitions, npm
## arch
Documentation-driven specification pattern using OpenSpec schema with phased design-proposal-tasks workflow covering viewport management, touch gesture handling, and zero-dependency progressive enhancement.
Documentation-driven specification with OpenSpec schema validation, structured design/proposal/task artifacts, and WebSocket-based real-time terminal connectivity with pure CSS/JavaScript touch gesture handling.
## tags
terminal, mobile, design, handling, react, .openspec, friendly, virtual
## symbols
@@ -1,25 +1,25 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs (index)
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
## role
Contains archived mobile terminal user experience specification documents from a completed project snapshot dated June 12, 2026.
Contains archived mobile terminal user experience specifications from a completed June 2026 project phase.
## parent
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md
- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md
- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md
- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md
- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md
- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md
## files
## links
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
## role
Contains archived mobile terminal user experience specification documents from a completed project snapshot dated June 12, 2026.
Contains archived mobile terminal user experience specifications from a completed June 2026 project phase.
## files
## arch
Document archive storage with date-based versioning and hierarchical categorization (mobile-terminal-ux/specs) for historical reference and audit trail preservation.
Document-based specification storage with date-versioned archival structure for historical reference.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation (index)
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
## role
Defines frontend foundation specifications for responsive application layouts with desktop/mobile adaptations and mobile terminal-specific minimal headers.
Defines frontend UI requirements for responsive layout components with mobile/desktop adaptations and specialized mobile terminal headers.
## parent
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
## role
Defines frontend foundation specifications for responsive application layouts with desktop/mobile adaptations and mobile terminal-specific minimal headers.
Defines frontend UI requirements for responsive layout components with mobile/desktop adaptations and specialized mobile terminal headers.
## files
- spec.md | Defines modified requirements for a responsive application layout component with desktop/mobile adaptations and a specialized minimal header for mobile terminal pages.
## arch
Requirements-driven specification pattern with responsive design breakpoints, device-specific component variants, and conditional rendering logic for mobile terminal contexts.
Specification-driven design with responsive breakpoint patterns, conditional rendering strategies, and mobile-first progressive enhancement.
## tags
mobile, spec, defines, modified, requirements, responsive, application, layout
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux (index)
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
## role
Defines UI/UX specifications for mobile terminal interface ensuring responsive, touch-friendly terminal experience on mobile devices.
Defines UI/UX specifications for a web-based mobile terminal interface with responsive design, touch interactions, and accessibility features.
## parent
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
## role
Defines UI/UX specifications for mobile terminal interface ensuring responsive, touch-friendly terminal experience on mobile devices.
Defines UI/UX specifications for a web-based mobile terminal interface with responsive design, touch interactions, and accessibility features.
## files
- spec.md | Specifies mobile terminal UI/UX requirements including responsive layout, special keys toolbar, virtual keyboard handling, touch gestures, screen orientation, copy/paste, and font scaling for a web-based terminal application. | dep: WebSocket, xterm.js, Visual Viewport API, localStorage
## arch
Specification-driven design with requirements documentation pattern covering layout, input methods, gestures, and accessibility concerns for cross-platform mobile web terminal.
Specification-driven design using requirements documents to define cross-platform mobile terminal behavior without implementation code.
## tags
terminal, spec, specifies, mobile, requirements, including, responsive, layout
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal (index)
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
## role
Defines functional and UX requirements for a mobile-optimized terminal interface with touch-native interactions and adaptive responsive design.
Defines functional and UX requirements for a touch-optimized mobile terminal interface using WebSocket communication
## parent
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
## role
Defines functional and UX requirements for a mobile-optimized terminal interface with touch-native interactions and adaptive responsive design.
Defines functional and UX requirements for a touch-optimized mobile terminal interface using WebSocket communication
## files
- spec.md | Specifies requirements for a mobile-responsive WebSocket terminal application with touch gestures, special keys, and adaptive layout | dep: xterm.js, WebSocket, browser clipboard API, localStorage, viewport meta tag
## arch
Specification-driven requirements document using structured markdown with sections for features, gestures, layout modes, and special key handling; no implementation code present.
Specification-driven design with mobile-first responsive layout, gesture-based interaction patterns, and adaptive UI for varying screen sizes/orientations
## tags
websocket, spec, specifies, requirements, mobile, responsive, terminal, application
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/mount-specificity-ordering (index)
dir: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
# 2026-06-12-completed-changes-archive/mount-specificity-ordering (index)
dir: 2026-06-12-completed-changes-archive/mount-specificity-ordering
## role
Archives the completed specification for a mount specificity ordering fix that was implemented as a high-priority change.
Archives a completed specification for fixing mount specificity ordering behavior in the system.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
index: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md
index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
dir: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
# 2026-06-12-completed-changes-archive/mount-specificity-ordering
dir: 2026-06-12-completed-changes-archive/mount-specificity-ordering
index: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
## role
Archives the completed specification for a mount specificity ordering fix that was implemented as a high-priority change.
Archives a completed specification for fixing mount specificity ordering behavior in the system.
## files
- .openspec.yaml | Defines an OpenSpec specification for a completed high-priority fix related to mount specificity ordering
## arch
Simple archival storage pattern using date-prefixed directory structure with YAML-based OpenSpec specification files for tracking completed changes.
Simple documentation archive using OpenSpec YAML format with no active code or runtime components.
## tags
.openspec, defines, openspec, specification, completed, high, priority, fix
## symbols
@@ -1,11 +1,11 @@
# archive/2026-06-12-active-changes-archive/multi-session-terminal-ux (index)
dir: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux
# 2026-06-12-completed-changes-archive/multi-session-terminal-ux (index)
dir: 2026-06-12-completed-changes-archive/multi-session-terminal-ux
## role
Archive of design documents and implementation plans for adding multi-session terminal UX support to a tool instance platform, preserving historical decision-making and phased development records.
Archive of completed design documents and implementation specifications for adding multi-session terminal support to an existing tool instance platform.
## parent
index: archive/2026-06-12-active-changes-archive/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -18,8 +18,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.md
index: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# archive/2026-06-12-active-changes-archive/multi-session-terminal-ux
dir: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux
# 2026-06-12-completed-changes-archive/multi-session-terminal-ux
dir: 2026-06-12-completed-changes-archive/multi-session-terminal-ux
index: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
## role
Archive of design documents and implementation plans for adding multi-session terminal UX support to a tool instance platform, preserving historical decision-making and phased development records.
Archive of completed design documents and implementation specifications for adding multi-session terminal support to an existing tool instance platform.
## files
- .openspec.yaml | Defines metadata for a completed project specification named "multi-session-terminal-ux"
- apply-pr1.md | Documents the implementation of database schema, Alembic migration, and TerminalManager multi-session core for a multi-session terminal UX feature. | dep: Alembic, SQLAlchemy, aiosqlite, asyncio, pytest, TerminalSession, TerminalManager, UUIDPrimaryKeyMixin, TimestampMixin, SessionLocal
@@ -15,7 +15,7 @@ Archive of design documents and implementation plans for adding multi-session te
- proposal.md | Proposes architectural changes to support multiple concurrent terminal sessions per tool instance with improved UI/UX features | dep: TerminalManager, TerminalSession, api/terminal.py, TerminalComponent, terminal.tsx, WebSocket protocol, database schema
- tasks.md | A software design document specifying 12 implementation tasks for adding multi-session terminal UX support across backend (Python/FastAPI) and frontend (React/TypeScript) with detailed acceptance criteria, file changes, and TDD testing steps. | dep: Alembic, FastAPI, WebSocket, React, TypeScript, xterm.js (implied), pytest, Jest/npm test
## arch
Specification-driven development with phased PR documentation (backend schema/migrations → API/WebSocket/frontend hooks → UI components), using FastAPI/Python backend with Alembic migrations, React/TypeScript frontend, WebSocket protocol, and TDD acceptance criteria across 12 structured implementation tasks.
Design-driven development with phased PR implementation (backend core → API/WebSocketfrontend UI), using FastAPI/WebSocket backend and React/TypeScript frontend, with explicit architectural exploration and task breakdown before coding.
## tags
terminal, session, multi, apply, implementation, alembic, websocket, support
## symbols
@@ -1,11 +1,11 @@
# archive/2026-06-12-completed-changes-archive/notification-center (index)
dir: archive/2026-06-12-completed-changes-archive/notification-center
# 2026-06-12-completed-changes-archive/notification-center (index)
dir: 2026-06-12-completed-changes-archive/notification-center
## role
Archive directory preserving the complete design, specification, and implementation history of a full-stack Notification Center feature that added persistent user-scoped notifications to replace ephemeral toast-only alerts.
Archive of completed implementation artifacts for a full-stack Notification Center feature that added persistent, user-scoped notifications with REST API, React frontend, and toast coordination to an existing application.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -21,8 +21,8 @@ map: archive/2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md
index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/notification-center/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# archive/2026-06-12-completed-changes-archive/notification-center
dir: archive/2026-06-12-completed-changes-archive/notification-center
# 2026-06-12-completed-changes-archive/notification-center
dir: 2026-06-12-completed-changes-archive/notification-center
index: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
## role
Archive directory preserving the complete design, specification, and implementation history of a full-stack Notification Center feature that added persistent user-scoped notifications to replace ephemeral toast-only alerts.
Archive of completed implementation artifacts for a full-stack Notification Center feature that added persistent, user-scoped notifications with REST API, React frontend, and toast coordination to an existing application.
## files
- .openspec.yaml | Defines an OpenAPI specification metadata file for a notification center service
- apply-pr1.md | Documents the implementation, testing, and validation of a backend notification center system for a FastAPI/SQLAlchemy application. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, pytest, ruff, SQLite/PostgreSQL
@@ -18,7 +18,7 @@ Archive directory preserving the complete design, specification, and implementat
- spec.md | Defines a full-stack notification center system with per-user persistent notifications, REST API, frontend UI, and user-scoped preferences for category muting and toast suppression. | dep: FastAPI, SQLAlchemy, Alembic, PostgreSQL, React/frontend, SSE/EventToastBridge, Phosphor icons, UserConfig, lifecycle_hooks, health_monitor
- tasks.md | Defines a detailed task breakdown for implementing a Notification Center feature across 4 stacked PRs, covering backend core, backend integration, frontend core, and toast coordination with specific acceptance criteria, dependencies, and effort estimates. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, pytest, SQLite/PostgreSQL, AsyncSession, UUIDPrimaryKeyMixin, UserConfig, lifecycle_hooks, health_monitor, InstanceEventBus
## arch
Document-driven phased implementation using stacked PRs (4 sequential PRs) with TDD validation, cross-cutting FastAPI/SQLAlchemy backend and React frontend, OpenAPI-specified REST API, and event-driven integration with existing toast notification system.
Phased TDD-driven implementation across 4 stacked PRs (backend core → backend integration → frontend core → toast coordination) using FastAPI/SQLAlchemy backend, React/TypeScript frontend, OpenAPI specs, and comprehensive design documentation with acceptance criteria.
## tags
notification, react, center, apply, fastapi, sqlalchemy, alembic, user
## symbols
@@ -1,23 +1,23 @@
# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions (index)
dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions (index)
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions
## role
Implements persistent terminal sessions that survive WebSocket disconnections and reconnect to existing docker exec processes rather than spawning new ones.
Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
- 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
## role
Implements persistent terminal sessions that survive WebSocket disconnections and reconnect to existing docker exec processes rather than spawning new ones.
Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata
- design.md | Design document for implementing persistent terminal sessions that survive WebSocket disconnections while maintaining shell state and allowing reconnection to the same docker exec process. | dep: TerminalManager, TerminalSession, WebSocket, docker exec, PTY
- proposal.md | Proposes architectural changes to make WebSocket terminal sessions persistent across reconnections instead of spawning new docker exec processes each time | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.tsx, use-terminal.ts
- tasks.md | This file is a project task list tracking the implementation of persistent terminal sessions with WebSocket reconnection, reset functionality, and idle timeout management across backend and frontend components. | dep: TerminalSession, TerminalManager, WebSocket, docker exec, API endpoints, frontend terminal component, terminal hook
## arch
Event-driven architecture with WebSocket connection management, process state persistence layer, session lifecycle tracking (idle timeouts, explicit resets), and bidirectional frontend-backend coordination for seamless terminal reconnection.
Event-driven architecture with WebSocket connection management, process state persistence, session lifecycle handling (reconnection/reset/idle timeout), and cross-layer backend-frontend coordination.
## tags
websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec
## symbols
@@ -1,19 +1,19 @@
# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs (index)
dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs (index)
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
## role
Contains archived specification documents for a persistent terminal sessions feature that was completed on June 12, 2026.
## parent
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md
- 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md
## files
## links
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
## role
Contains archived specification documents for a persistent terminal sessions feature that was completed on June 12, 2026.
## files
## arch
Document-based specification storage with date-versioned archival structure for historical feature documentation.
Documentation-only archive directory with no active code; stores historical design specs for completed terminal session persistence functionality.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal (index)
dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal (index)
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
## role
Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities
Defines specifications for persistent WebSocket terminal sessions that maintain state across reconnections with buffered output, reset controls, and idle timeout management.
## parent
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
## role
Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities
Defines specifications for persistent WebSocket terminal sessions that maintain state across reconnections with buffered output, reset controls, and idle timeout management.
## files
- spec.md | Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities
## arch
Specification-driven requirements document using markdown-based technical specification pattern with functional requirement enumeration
Specification-driven architecture using a single requirements document to define session persistence, WebSocket transport, circular output buffering, and state machine behaviors (active/idle/closed) with explicit client-server protocol semantics.
## tags
spec, defines, requirements, persistent, websocket, terminal, sessions, reconnection
## symbols
@@ -1,11 +1,11 @@
# archive/2026-06-12-active-changes-archive/reorganize-long-files (index)
dir: archive/2026-06-12-active-changes-archive/reorganize-long-files
# 2026-06-12-completed-changes-archive/reorganize-long-files (index)
dir: 2026-06-12-completed-changes-archive/reorganize-long-files
## role
Contains archived planning documents for a completed structural refactoring initiative that split monolithic frontend pages and backend routers into thinner, more modular components and services.
This is an archived project planning directory documenting a completed structural refactoring initiative to decompose monolithic frontend pages and backend routers into thinner, more maintainable modules.
## parent
index: archive/2026-06-12-active-changes-archive/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -14,8 +14,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
index: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.md
index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-active-changes-archive/reorganize-long-files
dir: archive/2026-06-12-active-changes-archive/reorganize-long-files
# 2026-06-12-completed-changes-archive/reorganize-long-files
dir: 2026-06-12-completed-changes-archive/reorganize-long-files
index: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
## role
Contains archived planning documents for a completed structural refactoring initiative that split monolithic frontend pages and backend routers into thinner, more modular components and services.
This is an archived project planning directory documenting a completed structural refactoring initiative to decompose monolithic frontend pages and backend routers into thinner, more maintainable modules.
## files
- .openspec.yaml | Configuration file tracking a completed project task for reorganizing long files
- proposal.md | Proposes a structural refactoring to split monolithic frontend pages and backend routers into thinner orchestrators with extracted components/services, restoring a thin-page/thin-router/fat-component pattern. | dep: React components, FastAPI routers, WebSocket, Docker, git services
- spec.md | A specification document defining a pure structural refactoring to split monolithic frontend pages/backend routers and CSS into smaller, focused components and services without changing any behavior or API contracts. | dep: React, CSS Modules, WebSocket, FastAPI/Flask routers, TypeScript, Vite
- tasks.md | Tracks the completion status of a codebase reorganization initiative to slim long files by extracting components and services into dedicated modules.
## arch
Documentation-driven refactoring using specification-proposal-task workflow with a thin-page/thin-router/fat-component pattern, emphasizing pure structural decomposition without behavioral changes.
Task-driven documentation pattern using YAML configuration, markdown specs (proposal/spec/tasks), and a strict separation of planning artifacts from implementation, following a "thin orchestrator/fat component" modular decomposition strategy with zero-behavior-change refactoring constraints.
## tags
components, services, long, .openspec, structural, refactoring, split, monolithic
## symbols
@@ -1,23 +1,23 @@
# archive/2026-06-12-completed-changes-archive/session-list-overhaul (index)
dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul
# 2026-06-12-completed-changes-archive/session-list-overhaul (index)
dir: 2026-06-12-completed-changes-archive/session-list-overhaul
## role
Archives a completed frontend refactoring project that unified duplicated session list rendering logic into reusable components across dashboard and sessions pages.
This package archives the completed design documentation and planning artifacts for a frontend refactoring initiative that unified duplicated session list rendering logic across dashboard and sessions pages into reusable components.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
- 2026-06-12-completed-changes-archive/session-list-overhaul/specs
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-completed-changes-archive/session-list-overhaul
dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul
# 2026-06-12-completed-changes-archive/session-list-overhaul
dir: 2026-06-12-completed-changes-archive/session-list-overhaul
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
## role
Archives a completed frontend refactoring project that unified duplicated session list rendering logic into reusable components across dashboard and sessions pages.
This package archives the completed design documentation and planning artifacts for a frontend refactoring initiative that unified duplicated session list rendering logic across dashboard and sessions pages into reusable components.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata
- design.md | Design document for refactoring duplicated session list rendering logic into unified reusable components across dashboard and sessions pages. | dep: dashboard.tsx, sessions.tsx, SessionCard, SessionList
- proposal.md | Proposes a frontend refactoring to unify session list UI components across dashboard and sessions pages | dep: React components, CSS styling, dashboard.tsx, sessions.tsx
- tasks.md | Task tracking checklist for refactoring session UI components in a web application dashboard
## arch
Documentation-driven refactoring with OpenSpec configuration, design docs, proposals, and task tracking; no active code, purely historical archive of a UI component consolidation initiative.
Documentation-driven waterfall planning with structured design docs (design.md, proposal.md, tasks.md) and OpenSpec schema configuration, using markdown-based task tracking and formal proposal/approval process before implementation.
## tags
dashboard, sessions, tsx, design, refactoring, session, components, .openspec
## symbols
@@ -1,19 +1,19 @@
# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs (index)
dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
# 2026-06-12-completed-changes-archive/session-list-overhaul/specs (index)
dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs
## role
Contains archived specification documents for a completed session list overhaul feature from June 2026.
Contains archived specification documents for the completed session list overhaul feature from June 12, 2026.
## parent
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md
- 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md
## files
## links
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
# 2026-06-12-completed-changes-archive/session-list-overhaul/specs
dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
## role
Contains archived specification documents for a completed session list overhaul feature from June 2026.
Contains archived specification documents for the completed session list overhaul feature from June 12, 2026.
## files
## arch
N/A (empty directory - no files to analyze)
Documentation/archive pattern using date-prefixed directory naming for historical change tracking with specification-driven development artifacts.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui (index)
dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
# 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui (index)
dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
## role
Defines UI specifications for unifying and overhauling session list displays across dashboard and sessions pages.
Defines UI specifications for unified session card components with display, controls, grouping, and filtering capabilities across dashboard and sessions pages.
## parent
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
# 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
## role
Defines UI specifications for unifying and overhauling session list displays across dashboard and sessions pages.
Defines UI specifications for unified session card components with display, controls, grouping, and filtering capabilities across dashboard and sessions pages.
## files
- spec.md | Specifies UI requirements for session card display, control actions, list grouping/filtering, and component unification across dashboard and sessions pages.
## arch
Specification-driven design using requirements documents to standardize component behavior, filtering, and grouping patterns before implementation.
Specification-driven design using requirements documentation to standardize component behavior and visual presentation across multiple page contexts.
## tags
spec, specifies, requirements, session, card, display, control, actions
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/ssh-key-mounting (index)
dir: archive/2026-06-12-completed-changes-archive/ssh-key-mounting
# 2026-06-12-completed-changes-archive/ssh-key-mounting (index)
dir: 2026-06-12-completed-changes-archive/ssh-key-mounting
## role
Defines requirements for mounting SSH keys into tool instances to enable secure authentication.
Defines requirements specification for mounting SSH keys into tool instances to enable secure authentication.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
index: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md
index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/ssh-key-mounting
dir: archive/2026-06-12-completed-changes-archive/ssh-key-mounting
# 2026-06-12-completed-changes-archive/ssh-key-mounting
dir: 2026-06-12-completed-changes-archive/ssh-key-mounting
index: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
## role
Defines requirements for mounting SSH keys into tool instances to enable secure authentication.
Defines requirements specification for mounting SSH keys into tool instances to enable secure authentication.
## files
- .openspec.yaml | Specification document defining requirements for SSH key mounting feature in tool instances
## arch
Specification-driven design using OpenSpec YAML format for declarative feature requirements documentation.
Requirements-as-code pattern using OpenSpec YAML format for declarative feature specification.
## tags
.openspec, specification, document, defining, requirements, ssh, key, mounting
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header (index)
dir: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
# 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header (index)
dir: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
## role
Archived completed specification for a terminal fullscreen mode header unification bugfix.
Archives a completed bugfix specification for unifying terminal fullscreen mode header UI elements.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
index: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md
index: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
dir: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
# 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
dir: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
index: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
## role
Archived completed specification for a terminal fullscreen mode header unification bugfix.
Archives a completed bugfix specification for unifying terminal fullscreen mode header UI elements.
## files
- .openspec.yaml | Defines a completed bugfix specification for unifying terminal fullscreen mode header elements
## arch
Specification-as-artifact pattern; single YAML-based change record in a date-versioned archive directory.
Specification-driven change tracking using YAML-based open specifications for completed work documentation.
## tags
.openspec, defines, completed, bugfix, specification, unifying, terminal, fullscreen
## symbols
@@ -1,24 +1,11 @@
# . (index)
dir: .
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
# 2026-06-12-completed-changes-archive/tool-config-mount-cleanup (index)
dir: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
## role
Package containing completed specification, proposal, and task tracking for a tool configuration mount cleanup feature that separates built-in tool definitions from user-specific configuration.
Completed change archive documenting the removal of configuration/state mounts from built-in tool definitions to enable config-profile-based user-specific configuration.
## parent
-
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -26,8 +13,8 @@ Package containing completed specification, proposal, and task tracking for a to
- proposal.md
- tasks.md
## links
index: ./.pi-map.index.md
map: ./.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md
## workflows
-
## dirty
@@ -1,30 +1,16 @@
# .
dir: .
# 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
dir: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
index: ./.pi-map.index.md
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
index: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
## role
Package containing completed specification, proposal, and task tracking for a tool configuration mount cleanup feature that separates built-in tool definitions from user-specific configuration.
Completed change archive documenting the removal of configuration/state mounts from built-in tool definitions to enable config-profile-based user-specific configuration.
## files
- .openspec.yaml | Defines a completed OpenSpec configuration for a tool named "tool-config-mount-cleanup"
- proposal.md | Proposes removing configuration and state mounts from built-in tool definitions to separate tool setup from user-specific configuration handled by config profiles.
- tasks.md | This is a completed task checklist for modifying built-in tool configurations and database migrations in a codebase. | dep: alembic, pytest, opencode, pi-agent
## arch
Documentation-driven change management with OpenSpec configuration, markdown-based proposal/justification, and structured task checklist for tracking implementation of a configuration separation pattern.
Specification-driven migration pattern using OpenSpec for declarative tool configuration, with separation of concerns between built-in tool setup and user-configurable profiles, plus database migration coordination.
## tags
tool, configuration, completed, config, .openspec, proposal, tasks, defines
## symbols
@@ -1,23 +1,23 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates (index)
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates (index)
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
## role
Archives completed frontend architecture changes for real-time session progress tracking using SSE events and shared React state management.
Archives documentation for a completed frontend refactoring that added real-time session progress tracking via SSE events and shared React state.
## parent
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
## role
Archives completed frontend architecture changes for real-time session progress tracking using SSE events and shared React state management.
Archives documentation for a completed frontend refactoring that added real-time session progress tracking via SSE events and shared React state.
## files
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document for frontend-only refactoring of session lifecycle progress tracking and live UI updates using SSE events and shared React context. | dep: React, SSE (useEvents), SessionsContext, SessionOperationsContext, AppShell, DashboardPage, SessionsPage, CreateSessionForm, InstanceList, useInstanceActions, ToolStarter, StartToolFAB, EventToastBridge
- proposal.md | Proposes a frontend architecture change to add real-time session progress tracking via SSE and shared state across the application. | dep: React, SSE events, state management, AppShell, DashboardPage, SessionsPage, use-instance-actions, CreateSessionForm, SessionCard, InstanceCard
- tasks.md | A completed task checklist tracking implementation of shared session state, global progress panel, optimistic UI updates, and removal of legacy progress overlays in a React frontend application. | dep: React, state/sessions.tsx, state/session-operations.tsx, useEvents, hooks/use-instance-actions.ts, AppShell, SessionsPage, DashboardPage, components/features/session/session-progress-panel.tsx, components/features/tool/tool-starter.tsx, components/features/tool/start-tool-fab.tsx, components/features/tool/instance-list.tsx, components/features/session/create-session-form.tsx, components/features/session/session-card.tsx
## arch
Event-driven reactive frontend pattern using Server-Sent Events (SSE) for live updates, shared React context for global session state, optimistic UI updates, and component-based progress panels replacing legacy overlay system.
Event-driven frontend architecture using Server-Sent Events (SSE) for live updates, shared React context for global session state, optimistic UI patterns, and a centralized progress panel replacing legacy overlay components.
## tags
session, tsx, components, features, progress, react, tool, state
## symbols
@@ -1,22 +1,22 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs (index)
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs (index)
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
## role
Contains historical specification documents for tool session progress tracking features that were completed and archived on June 12, 2026.
This directory serves as a specification archive for completed tool session progress and updates, storing historical design documents and requirements for past changes.
## parent
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
## children
- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md
- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md
- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md
- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md
## files
## links
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
## role
Contains historical specification documents for tool session progress tracking features that were completed and archived on June 12, 2026.
This directory serves as a specification archive for completed tool session progress and updates, storing historical design documents and requirements for past changes.
## files
## arch
Document-based archive pattern with dated directory structure for preserving completed technical specifications outside active development paths.
Simple archival directory structure with no active architecture; likely contains flat-file documentation or markdown specs organized by date for historical reference and audit trails.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux (index)
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux (index)
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
## role
Defines UI/UX specifications for real-time progress feedback during session lifecycle operations via server-sent events.
Defines UI/UX specifications for real-time progress feedback and optimistic state updates during asynchronous session operations.
## parent
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
## role
Defines UI/UX specifications for real-time progress feedback during session lifecycle operations via server-sent events.
Defines UI/UX specifications for real-time progress feedback and optimistic state updates during asynchronous session operations.
## files
- spec.md | Specifies UI/UX requirements for non-blocking progress indicators and optimistic updates for session lifecycle actions using SSE events. | dep: SSE, global progress indicator, shared state management, API
## arch
Event-driven reactive UI pattern with optimistic updates and non-blocking progress indicators using SSE (Server-Sent Events) for asynchronous server communication.
Event-driven reactive UI pattern using Server-Sent Events (SSE) for streaming progress updates, with optimistic UI state management for non-blocking user experience.
## tags
sse, spec, specifies, requirements, non, blocking, progress, indicators
## symbols
@@ -1,18 +1,18 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub (index)
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub (index)
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
## role
Defines requirements for a shared global session state system enabling real-time UI synchronization across dashboard, sessions page, and navigation components when sessions change.
Defines requirements for a shared global session state system that enables real-time UI synchronization across dashboard, sessions page, and navigation components when session data changes.
## parent
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
## role
Defines requirements for a shared global session state system enabling real-time UI synchronization across dashboard, sessions page, and navigation components when sessions change.
Defines requirements for a shared global session state system that enables real-time UI synchronization across dashboard, sessions page, and navigation components when session data changes.
## files
- spec.md | Defines requirements for implementing a shared global session state across dashboard, sessions page, and navigation to enable immediate UI updates when sessions are created or modified. | dep: SessionsContext, React Context API, sessions API (`/users/me/sessions`)
## arch
Specification-driven architecture using a centralized global state pattern with reactive UI updates, documented in markdown-based requirements specification.
Specification-driven architecture using a centralized session state hub with reactive update propagation to multiple UI surfaces.
## tags
sessions, spec, defines, requirements, implementing, shared, global, session
## symbols
@@ -1,11 +1,11 @@
# archive/2026-06-12-active-changes-archive/working-copies (index)
dir: archive/2026-06-12-active-changes-archive/working-copies
# 2026-06-12-completed-changes-archive/working-copies (index)
dir: 2026-06-12-completed-changes-archive/working-copies
## role
Archive of design documents and specifications for implementing persistent workspace-based tool instances that replace direct repository mounting with isolated git working copies.
Archive of completed design documents for a project that replaced direct repository mounting/cloning with persistent, shared Git workspace copies for tool instances.
## parent
index: archive/2026-06-12-active-changes-archive/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -16,8 +16,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
index: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.md
index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/working-copies/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# archive/2026-06-12-active-changes-archive/working-copies
dir: archive/2026-06-12-active-changes-archive/working-copies
# 2026-06-12-completed-changes-archive/working-copies
dir: 2026-06-12-completed-changes-archive/working-copies
index: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
## role
Archive of design documents and specifications for implementing persistent workspace-based tool instances that replace direct repository mounting with isolated git working copies.
Archive of completed design documents for a project that replaced direct repository mounting/cloning with persistent, shared Git workspace copies for tool instances.
## files
- .openspec.yaml | Defines metadata for a completed project named "working-copies" with timeline tracking
- design.md | Design document for implementing workspace-based tool instances that replace direct repository mounting with isolated git working copies | dep: FastAPI, SQLAlchemy, Alembic, Docker Compose, Git, React/TypeScript, asyncio subprocess
@@ -13,7 +13,7 @@ Archive of design documents and specifications for implementing persistent works
- spec.md | Technical specification for implementing persistent workspace-based tool instances that replace mount/clone modes with explicit Git repository workspaces | dep: Git, PostgreSQL, REST API, React/TypeScript frontend, Docker containers, Python backend
- tasks.md | Project task tracking document for implementing workspace-based tool instances across backend and frontend in a multi-PR phased approach | dep: Alembic, FastAPI, SQLAlchemy, React, TypeScript, pytest, ruff, ESLint, Git, Docker Compose
## arch
Design-driven documentation package containing phased technical specifications (proposal → design → exploration → spec → tasks) for a Workspace entity abstraction, with YAML metadata tracking and multi-PR implementation planning across backend/frontend systems.
Design-driven development with layered specification documents (exploration → proposal → design → spec → tasks) documenting a phased multi-PR implementation across backend and frontend systems.
## tags
workspace, tool, instances, git, design, replace, project, working
## symbols
@@ -1,11 +1,11 @@
# archive/2026-06-12-active-changes-archive/workspace-first-ui (index)
dir: archive/2026-06-12-active-changes-archive/workspace-first-ui
# 2026-06-12-completed-changes-archive/workspace-first-ui (index)
dir: 2026-06-12-completed-changes-archive/workspace-first-ui
## role
Archive of planning documents for a workspace-first UI redesign that reorients the product around persistent writable workspaces rather than direct repository browsing.
Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction.
## parent
index: archive/2026-06-12-active-changes-archive/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/.pi-map.md
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -15,8 +15,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
index: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.index.md
map: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.md
index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# archive/2026-06-12-active-changes-archive/workspace-first-ui
dir: archive/2026-06-12-active-changes-archive/workspace-first-ui
# 2026-06-12-completed-changes-archive/workspace-first-ui
dir: 2026-06-12-completed-changes-archive/workspace-first-ui
index: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.index.md
index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
## role
Archive of planning documents for a workspace-first UI redesign that reorients the product around persistent writable workspaces rather than direct repository browsing.
Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction.
## files
- .openspec.yaml | Defines metadata for a completed project specification named "workspace-first-ui"
- design.md | Design document for a workspace-first UI refresh, detailing backend API/services and frontend components for file management, git operations, and tool instances scoped to workspaces. | dep: FastAPI, SQLAlchemy/AsyncSession, React, React Router, asyncio, subprocess, os
@@ -12,7 +12,7 @@ Archive of planning documents for a workspace-first UI redesign that reorients t
- spec.md | Product specification document defining a workspace-first UI refresh that replaces direct repository file browsing with workspace-centric navigation, new routes, and redesigned pages for projects and workspace details. | dep: React/Next.js (implied by .tsx, routing), REST API backend, database (existing workspaces table), TypeScript, ruff, eslint
- tasks.md | Project task tracking document for a workspace-first UI refresh, breaking work into 3 sequential PRs with backend endpoints, frontend workspace detail page, and projects page refresh with routing changes. | dep: markdown, pytest, ruff, TypeScript compiler, eslint, npm, git, python
## arch
Specification-driven development with phased PR-based delivery (backend → frontend → routing), using structured product docs (proposal → design → spec → tasks) and OpenAPI-style metadata for project tracking.
Documentation-heavy package using sequential PR-based task decomposition (backend → workspace detailprojects page) with layered specification hierarchy (proposal → design → spec → tasks) and OpenSpec metadata tracking.
## tags
workspace, first, refresh, design, document, project, specification, .openspec
## symbols