chore(project-map): regenerate .pi-map artifacts across the repo

This commit is contained in:
Developer
2026-06-17 11:31:24 +00:00
parent 0dd5f2317b
commit 93da9b42a2
683 changed files with 5075 additions and 4965 deletions
@@ -1,80 +1,80 @@
# 2026-06-12-completed-changes-archive (index)
dir: 2026-06-12-completed-changes-archive
# openspec/changes/archive/2026-06-12-completed-changes-archive (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive
## role
Historical archive documenting completed OpenSpec changes for audit and reference purposes.
Maintains a historical record of completed and audited OpenSpec changes for reference and traceability.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
index: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
index: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation
index: openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion
index: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux
index: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center
index: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files
index: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting
index: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
index: openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies
index: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui
index: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md
## files
- README.md
## links
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-12-completed-changes-archive
dir: 2026-06-12-completed-changes-archive
# openspec/changes/archive/2026-06-12-completed-changes-archive
dir: openspec/changes/archive/2026-06-12-completed-changes-archive
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
## role
Historical archive documenting completed OpenSpec changes for audit and reference purposes.
Maintains a historical record of completed and audited OpenSpec changes for reference and traceability.
## files
- README.md | Documents a historical archive of 17 fully implemented OpenSpec changes that have been audited against the source tree
- README.md | Documents archived completed OpenSpec changes that have been audited and confirmed as fully implemented in the source tree.
## arch
Simple documentation-based archive pattern with no active code, serving as immutable change log for compliance tracking.
Simple archival storage pattern using date-based directory naming with human-readable documentation for immutable change records.
## tags
readme, documents, historical, archive, fully, implemented, openspec, changes
readme, documents, archived, completed, openspec, changes, have, been
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/backend-frontend-refactoring (index)
dir: 2026-06-12-completed-changes-archive/backend-frontend-refactoring
# openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
## role
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.
This package archives a completed 2026 structural refactoring specification that reorganized a Python/FastAPI backend and TypeScript frontend monolith into domain-based subpackages with extracted schemas and standardized naming conventions.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -15,8 +15,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2026-06-12-completed-changes-archive/backend-frontend-refactoring
dir: 2026-06-12-completed-changes-archive/backend-frontend-refactoring
# openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring
index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md
## role
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.
This package archives a completed 2026 structural refactoring specification that reorganized a Python/FastAPI backend and TypeScript frontend monolith into domain-based subpackages with extracted schemas and standardized naming conventions.
## 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
- proposal.md | This file is a technical proposal document outlining a pure structural refactoring to split monolithic backend files and reorganize frontend code without changing any behavior.
- 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
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata
- design.md | A design document specifying a large-scale backend/frontend refactoring to split monolithic modules into domain-based subpackages, extract schemas, and standardize naming conventions. | dep: FastAPI, Pydantic, SQLAlchemy, Docker, React/TypeScript, Git
- proposal.md | Proposes a pure structural refactoring of a codebase to extract schemas, split monolithic services, refactor auth dependencies, and reorganize frontend files without changing behavior.
- spec.md | This file defines a pure structural refactoring specification for extracting schemas, splitting service monoliths, reorganizing frontend code, and enforcing file size limits without changing any behavior or API contracts. | dep: Pydantic, FastAPI, SQLAlchemy, Docker Compose, React/TypeScript, ruff, npm
- tasks.md | A phased project roadmap for reorganizing a Python/FastAPI backend and TypeScript frontend codebase into domain-based subpackages with verification steps | dep: Python, FastAPI, Pydantic, Docker, ruff, py_compile, pytest, npm, TypeScript, React
## arch
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.
Document-driven specification architecture using phased task breakdown (OpenSpec YAML metadata + layered markdown docs: design → proposal → spec → tasks) with behavior-preserving pure structural refactoring pattern enforced by file size limits and verification gates.
## tags
frontend, refactoring, defines, design, backend, monolithic, behavior, fastapi
frontend, fastapi, typescript, design, refactoring, schemas, pydantic, react
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/config-profile-directory-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-directory-mounts
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts
## role
Archives a completed configuration profile refactoring that fixes root-owned directory mount issues by staging and bind-mounting entire directories.
Provides a completed configuration profile fix for directory mount staging issues in OpenSpec, with full documentation of the bug diagnosis, solution design, and implementation tracking.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -13,8 +13,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- proposal.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/config-profile-directory-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-directory-mounts
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md
## role
Archives a completed configuration profile refactoring that fixes root-owned directory mount issues by staging and bind-mounting entire directories.
Provides a completed configuration profile fix for directory mount staging issues in OpenSpec, with full documentation of the bug diagnosis, solution design, and implementation tracking.
## 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.
- 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: config_profile_resolver.py, Docker volume mounts, container user permissions
- tasks.md | A completed task checklist tracking the diagnosis and fix of a per-file mount staging bug, its refactoring to directory-level mounts, and the associated testing and deployment steps.
## arch
Documentation-driven change proposal with OpenSpec configuration, using a task-tracked implementation workflow for filesystem mount refactoring.
Documentation-driven change management using YAML metadata, markdown proposal/design docs, and task checklists to track a bugfix from diagnosis through refactoring to deployment.
## tags
tasks, profile, directory, mounts, .openspec, staging, py, proposal
directory, mounts, profile, tracking, .openspec, fix, staging, proposal
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/config-profile-git-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
## role
Archive of completed work for adding git repository mount support to config profiles, enabling version-controlled dotfiles in containers.
Design and planning package for implementing git repository mount support in config profiles, containing specification, design document, proposal, and implementation tracking.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: openspec/changes/archive/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: 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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/config-profile-git-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts
dir: openspec/changes/archive/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
index: openspec/changes/archive/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, enabling version-controlled dotfiles in containers.
Design and planning package for implementing git repository mount support in config profiles, containing specification, design document, proposal, and implementation tracking.
## 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
- .openspec.yaml | Defines an OpenAPI specification metadata file indicating a spec-driven schema approach with creation date tracking.
- design.md | Design document for adding git repository mount support to config profiles in a container instance system | dep: ConfigProfile, git repositories, clone service, instance startup, Docker bind mounts, profile preview/resolve
- proposal.md | Proposes adding git repository mounting capability to config profiles for version-controlled dotfiles | dep: config profiles, git repositories, docker, instance startup pipeline, database migrations
- tasks.md | A task checklist tracking the implementation of a git repository mounting feature for config profiles across database, backend API, frontend, and documentation. | dep: Alembic, SQLAlchemy, Pydantic, FastAPI/HTTP API, TypeScript, React, glob library, git clone service, docker compose
## arch
Design-driven feature implementation using proposal/design/task documentation hierarchy, with cross-stack changes spanning database models, backend API, frontend UI, and documentation.
Specification-driven development with phased implementation tracking, using markdown-based documentation hierarchy (proposal → design → tasks) and YAML metadata for schema versioning.
## tags
design, git, repository, .openspec, adding, mount, config, profiles
design, git, repository, config, profiles, tracking, .openspec, adding
## symbols
-
## workflows
@@ -1,22 +1,22 @@
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs (index)
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
## role
Contains specification files defining configuration requirements and validation rules for git repository mount profiles.
Contains archived specification documents for completed configuration profile changes related to Git repository mounts from June 2026.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md
## files
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
## role
Contains specification files defining configuration requirements and validation rules for git repository mount profiles.
Contains archived specification documents for completed configuration profile changes related to Git repository mounts from June 2026.
## files
## arch
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.
Flat directory archive structure storing immutable, dated specification snapshots for historical change tracking and audit compliance.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts (index)
dir: openspec/changes/archive/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.
Defines requirements for mounting git repositories into containers via configuration profiles
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts
dir: openspec/changes/archive/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
index: openspec/changes/archive/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.
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
- spec.md | Specifies requirements for adding git repository mounting capabilities to config profiles in a container system | dep: git, containers, config profiles, bind mounts, glob pattern matching
## arch
Specification-driven requirements document using markdown-based technical specification pattern.
Specification-driven requirements document using markdown-based specification format with structured sections for overview, goals, and detailed requirements
## tags
git, spec, defines, requirements, adding, repository, mounting, capabilities
git, spec, specifies, requirements, adding, repository, mounting, capabilities
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
## role
Defines requirements for git repository mounting behavior during tool instance startup.
Defines requirements for git repository mount processing during tool instance startup from configuration profiles.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md
## role
Defines requirements for git repository mounting behavior during tool instance startup.
Defines requirements for git repository mount processing during tool instance startup from configuration profiles.
## 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.
- spec.md | Specifies requirements for processing git repository mounts from config profiles during tool instance startup, including bind mount creation, auto-cloning, and failure handling.
## arch
Specification-driven requirements document using plain markdown with no code implementation or architectural patterns.
Specification-driven requirements document using markdown-based technical specification pattern with functional requirements decomposition.
## tags
mount, spec, defines, requirements, git, repository, processing, tool
spec, specifies, requirements, processing, git, repository, mounts, config
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/config-profile-includes-ui (index)
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
## role
Archive of completed UI work for drag-and-drop config profile includes management with cycle detection and scope visualization.
Archive of a completed feature specification for adding drag-and-drop profile includes management UI to a config profile editor.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: openspec/changes/archive/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: 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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/config-profile-includes-ui
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
## role
Archive of completed UI work for drag-and-drop config profile includes management with cycle detection and scope visualization.
Archive of a completed feature specification for adding drag-and-drop profile includes management UI to a config profile editor.
## 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
- .openspec.yaml | Defines an OpenSpec schema configuration file with metadata
- design.md | Design document for adding drag-and-drop profile includes management to an existing frontend config profile editor. | dep: React, native HTML5 Drag and Drop API, config profiles backend API, listConfigProfiles, updateConfigProfile, updateProfileIncludes
- proposal.md | Proposes a UI feature for drag-and-drop management of config profile includes with scope visualization and cycle detection
- tasks.md | Task tracking document for implementing a profile includes UI feature with drag-and-drop reordering, cycle detection, and error handling
## arch
Design-driven feature development with phased task tracking, using OpenSpec schema validation and explicit frontend/UX architecture documentation.
Specification-driven development using OpenSpec schema with structured design/proposal/task documents for a frontend feature involving hierarchical drag-and-drop interfaces with dependency graph validation.
## tags
drag, profile, design, drop, includes, .openspec, document, management
profile, design, drag, drop, includes, .openspec, document, management
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs (index)
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
## role
Contains archived specification documents for the config-profile-includes-ui feature that was completed on 2026-06-12.
Contains UI specification documents for the config-profile-includes feature that was archived after completion on June 12, 2026.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md
## files
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs
dir: openspec/changes/archive/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
index: openspec/changes/archive/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 that was completed on 2026-06-12.
Contains UI specification documents for the config-profile-includes feature that was archived after completion on June 12, 2026.
## files
## arch
Document-based specification storage with date-versioned archiving pattern for completed feature requirements.
Archive-based documentation storage using date-stamped directories with flat file organization for historical change tracking.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
## role
Defines requirements for a config profile editor feature that enables users to view, modify, and persist profile include configurations through a management UI.
Defines UI specifications for managing configuration profile include files with CRUD and reordering operations.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md
## role
Defines requirements for a config profile editor feature that enables users to view, modify, and persist profile include configurations through a management UI.
Defines UI specifications for managing configuration profile include files with CRUD and reordering operations.
## 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
- spec.md | Defines requirements for a config profile include system with display, add/remove/reorder, save, and list count features
## arch
Requirements specification using structured documentation pattern with functional requirements organized by user interaction flows (display, add/remove, reorder, save) and explicit UI/UX constraints.
Specification-driven requirements document using markdown-based feature specification pattern with user story and acceptance criteria structure.
## tags
profile, spec, define, requirements, config, editor, feature, manages
spec, defines, requirements, config, profile, include, system, display
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts (index)
dir: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
## role
Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount entry.
Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
dir: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
# openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md
## role
Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount entry.
Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount.
## 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
- .openspec.yaml | Defines a completed feature specification for enabling multiple source/target mappings per git mount entry in Config Profiles with single repository cloning.
## arch
Specification-as-code pattern using OpenSpec YAML for formal feature documentation and change tracking in a dated archive directory structure.
Specification-driven change tracking using YAML-based feature documentation in a dated archive structure, capturing completed design decisions for multi-mapping repository mounts without sub-repository cloning.
## tags
.openspec, define, completed, feature, specification, enabling, multiple, source
.openspec, defines, completed, feature, specification, enabling, multiple, source
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/container-monitoring-notifications (index)
dir: 2026-06-12-completed-changes-archive/container-monitoring-notifications
# openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
## role
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.
Archive of design documents, specifications, and implementation records for a container monitoring and notification system delivered through three stacked pull requests.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -20,8 +20,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md
## workflows
-
## dirty
@@ -1,25 +1,25 @@
# 2026-06-12-completed-changes-archive/container-monitoring-notifications
dir: 2026-06-12-completed-changes-archive/container-monitoring-notifications
# openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications
index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md
## role
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.
Archive of design documents, specifications, and implementation records for a container monitoring and notification system delivered through three stacked pull requests.
## 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
- apply-pr2.md | Documents the implementation of a frontend UI for container monitoring and notifications using Server-Sent Events, custom toast system, and real-time status updates. | dep: React, EventSource, TypeScript, Vitest, CSS, AbortController, fetch API
- apply-pr3.md | Documents the completion status and implementation details of PR-3 for container monitoring and notifications integration, including tests, API endpoints, documentation updates, and quality gate results.
- apply-progress.md | Documents the implementation progress of two pull requests for a container monitoring and notifications system, covering backend core services (EventBus, HealthMonitor, SSE endpoints) and frontend UI components (SSE hooks, custom toast system, real-time status updates). | dep: pytest, vitest, SQLAlchemy, Alembic, FastAPI/SSE, React, TypeScript, EventSource, ruff, eslint, asyncio, inspect, collections.abc
- design.md | Design document for a container monitoring and notification system using in-memory pub/sub, background health polling, SSE streaming, and frontend toast notifications | dep: FastAPI, SQLAlchemy, Alembic, asyncio, Docker, SSE/EventSource, sonner, TypeScript, Python
- explore.md | Exploratory analysis document identifying gaps and recommending architecture for container monitoring, health checks, logging, and notifications in a Docker-based tool instance management system. | dep: FastAPI, Docker CLI, SQLAlchemy, cloudflared, asyncio, SSE, React/frontend stack
- proposal.md | Proposes a container monitoring and real-time notification system using SSE to push lifecycle events and health status from a FastAPI backend to a frontend toast component, replacing 30-second polling with instant visibility into container failures, tunnel health, and audit trails. | dep: FastAPI, SSE/StreamingResponse, asyncio, Docker CLI, PostgreSQL, JSONB, UUID, WebSocket (existing terminal), sonner/toast library
- 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
- apply-pr1.md | Documents the implementation of a backend monitoring and notification system for container instances, including database migrations, SQLAlchemy models, event bus, health monitoring, SSE streaming, lifecycle hooks, structured logging, and unit tests. | dep: Alembic, SQLAlchemy, asyncio, FastAPI, uvicorn, pytest, ruff, Docker, JSON
- apply-pr2.md | Documents a completed frontend pull request implementing real-time container monitoring and notifications via Server-Sent Events, custom toast system, and status badge updates | dep: React, EventSource, Vitest, TypeScript, ESLint, CSS
- apply-pr3.md | Documents the completion status, changed files, implementation summary, and quality gate results for PR-3 which integrated and polished container monitoring and notification features.
- apply-progress.md | Documents TDD-driven implementation progress for a container monitoring and notification system across backend (Python/FastAPI) and frontend (React/TypeScript) PRs, including architecture decisions, test evidence, and deviations from design. | dep: FastAPI, SQLAlchemy, Alembic, pytest, React, TypeScript, Vitest, EventSource, SSE, asyncio, inspect, collections.abc
- design.md | Design document for a container monitoring and notification system using pub/sub events, health monitoring, and Server-Sent Events to push real-time container status updates to a frontend toast notification system. | dep: FastAPI, SQLAlchemy, Alembic, asyncio, Docker, SSE/EventSource, sonner, React/TypeScript, JSON logging
- explore.md | Exploratory analysis document identifying gaps in container monitoring, logging, and notifications for a Docker-based tool instance management system, and recommending an SSE-based real-time event architecture. | dep: FastAPI, Docker CLI, docker-compose, SQLAlchemy, cloudflared, axios, asyncio, TerminalManager
- proposal.md | A software design proposal for implementing a real-time container monitoring and notification system with SSE-based push updates, health monitoring, and audit logging. | dep: FastAPI, Docker, asyncio, SSE/StreamingResponse, PostgreSQL, JSON logging, frontend toast component (sonner or custom), WebSocket (existing terminal), Docker CLI/shell-out patterns
- spec.md | Defines a container monitoring and notification system using an in-memory event bus, background health monitoring, SSE streaming, and real-time frontend notifications with persistent audit logging. | dep: asyncio, PostgreSQL, Docker CLI, HTTP/tunnel probes, SSE (Server-Sent Events), JWT/cookie authentication, JSON logging
- tasks.md | Defines a structured software design document (SDD) for building a container monitoring and notification system across 3 stacked PRs, detailing backend infrastructure (database, event bus, SSE, health monitoring) and frontend UI (SSE hook, toasts, badge updates) with specific tasks, acceptance criteria, and dependencies. | dep: FastAPI, SQLAlchemy, Alembic, Docker, asyncio, SSE/EventSource, React, sonner, pytest, uvicorn, contextvars, TypedDict
## arch
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.
Event-driven architecture using pub/sub in-memory event bus with SSE streaming for real-time frontend updates, TDD-driven 3-PR stacked delivery (backend infrastructure → frontend UI → integration/polish), health monitoring with lifecycle hooks, structured logging, and persistent audit trail.
## tags
sse, container, monitoring, system, apply, notifications, fastapi, asyncio
monitoring, container, system, sse, notification, apply, asyncio, fastapi
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/git-mount-url-validation (index)
dir: 2026-06-12-completed-changes-archive/git-mount-url-validation
# openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation
## role
Archives the completed specification for a git mount URL validation feature that was implemented as a high-priority item.
Preserves a completed feature specification for validating git repository URLs in mount configurations as a historical archive entry.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-12-completed-changes-archive/git-mount-url-validation
dir: 2026-06-12-completed-changes-archive/git-mount-url-validation
# openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md
## role
Archives the completed specification for a git mount URL validation feature that was implemented as a high-priority item.
Preserves a completed feature specification for validating git repository URLs in mount configurations as a historical archive entry.
## files
- .openspec.yaml | Defines an OpenSpec specification for a completed high-priority feature named "git-mount-url-validation"
- .openspec.yaml | Defines a completed high-priority feature specification for git mount URL validation
## arch
Specification-as-code pattern using OpenSpec YAML format for feature documentation and archival.
Specification-as-archive pattern using YAML-based feature documentation with date-versioned directory structure for immutable change tracking.
## tags
.openspec, defines, openspec, specification, completed, high, priority, feature
.openspec, defines, completed, high, priority, feature, specification, git
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/home-path-expansion (index)
dir: 2026-06-12-completed-changes-archive/home-path-expansion
# openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion
## role
Archive of a completed feature specification for home directory path expansion in container mount targets.
Defines a completed feature specification for home directory path expansion in container mount targets based on manifest user configuration.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-12-completed-changes-archive/home-path-expansion
dir: 2026-06-12-completed-changes-archive/home-path-expansion
# openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion
index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md
## role
Archive of a completed feature specification for home directory path expansion in container mount targets.
Defines a completed feature specification for home directory path expansion in container mount targets based on manifest user configuration.
## 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-driven change documentation using OpenSpec YAML format for tracking completed feature implementations.
Specification-driven documentation pattern using YAML-based OpenSpec format for capturing archived feature requirements and design decisions.
## tags
home, .openspec, defines, completed, feature, specification, resolving, directory
## symbols
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/mobile-terminal-ux (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
## role
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.
Documents a completed mobile terminal UX enhancement for web-based terminal applications with touch-friendly interfaces.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/mobile-terminal-ux
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux
index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
## role
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.
Documents a completed mobile terminal UX enhancement for web-based terminal applications with touch-friendly interfaces.
## 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
- .openspec.yaml | Defines an OpenSpec schema configuration file with metadata
- design.md | Design document outlining mobile terminal UX improvements for a web-based xterm.js terminal application | dep: xterm.js, React, browser APIs (Visual Viewport API, Clipboard API, WebSocket), CSS
- proposal.md | Proposes a mobile-optimized terminal user experience with touch-friendly controls, dynamic viewport handling, and special keys toolbar | dep: xterm.js, React, visualViewport API
- tasks.md | This file is a task checklist tracking the implementation of mobile terminal support for a web-based terminal application. | dep: React, WebSocket, Visual Viewport API, localStorage, CSS, TypeScript
## arch
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.
Specification-driven development using OpenSpec schema configuration with structured design/proposal/task documentation tracking implementation progress.
## tags
terminal, mobile, design, handling, react, .openspec, friendly, virtual
terminal, design, mobile, xterm, react, .openspec, web, application
## symbols
-
## workflows
@@ -1,25 +1,25 @@
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs (index)
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
## role
Contains archived mobile terminal user experience specifications from a completed June 2026 project phase.
Archive of completed mobile terminal UX specification changes from June 12, 2026, serving as historical record for the openspec project.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md
## files
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
## role
Contains archived mobile terminal user experience specifications from a completed June 2026 project phase.
Archive of completed mobile terminal UX specification changes from June 12, 2026, serving as historical record for the openspec project.
## files
## arch
Document-based specification storage with date-versioned archival structure for historical reference.
Flat directory structure using date-based versioning with descriptive naming convention for change tracking and specification immutability.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
## role
Defines frontend UI requirements for responsive layout components with mobile/desktop adaptations and specialized mobile terminal headers.
Defines frontend foundation specifications for responsive application layout components supporting desktop, mobile, and specialized terminal mobile interfaces.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md
## role
Defines frontend UI requirements for responsive layout components with mobile/desktop adaptations and specialized mobile terminal headers.
Defines frontend foundation specifications for responsive application layout components supporting desktop, mobile, and specialized terminal mobile interfaces.
## 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.
- spec.md | Defines modified requirements for a responsive application layout component with desktop and mobile variants including a specialized terminal page mobile layout
## arch
Specification-driven design with responsive breakpoint patterns, conditional rendering strategies, and mobile-first progressive enhancement.
Specification-driven architecture with responsive design patterns, platform-specific layout variants, and mobile-first terminal UX adaptations.
## tags
mobile, spec, defines, modified, requirements, responsive, application, layout
layout, mobile, spec, defines, modified, requirements, responsive, application
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
## role
Defines UI/UX specifications for a web-based mobile terminal interface with responsive design, touch interactions, and accessibility features.
Defines user experience specifications for a touch-optimized mobile terminal interface with adaptive input handling.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md
## role
Defines UI/UX specifications for a web-based mobile terminal interface with responsive design, touch interactions, and accessibility features.
Defines user experience specifications for a touch-optimized mobile terminal interface with adaptive input handling.
## 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
- spec.md | Specifies requirements for a mobile-responsive terminal interface with touch gestures, virtual keyboard handling, special keys toolbar, and adaptive layout. | dep: xterm.js, WebSocket, Visual Viewport API, localStorage, AppShell
## arch
Specification-driven design using requirements documents to define cross-platform mobile terminal behavior without implementation code.
Requirements-driven specification document using feature-based decomposition (gestures, keyboard, toolbar, layout) with responsive design patterns for cross-device compatibility.
## tags
terminal, spec, specifies, mobile, requirements, including, responsive, layout
spec, specifies, requirements, mobile, responsive, terminal, interface, touch
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
## role
Defines functional and UX requirements for a touch-optimized mobile terminal interface using WebSocket communication
Defines specifications for a mobile-responsive web terminal interface with WebSocket connectivity, touch gesture support, and special key handling for mobile devices.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md
## role
Defines functional and UX requirements for a touch-optimized mobile terminal interface using WebSocket communication
Defines specifications for a mobile-responsive web terminal interface with WebSocket connectivity, touch gesture support, and special key handling for mobile devices.
## 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
- spec.md | Define requirements for a mobile-responsive web terminal with WebSocket connectivity, touch gestures, and special key handling | dep: xterm.js, WebSocket, browser clipboard API, localStorage, viewport/meta tags
## arch
Specification-driven design with mobile-first responsive layout, gesture-based interaction patterns, and adaptive UI for varying screen sizes/orientations
Specification-driven design using markdown-based requirements documentation, likely feeding into a broader design-to-implementation pipeline for mobile terminal UX components.
## tags
websocket, spec, specifies, requirements, mobile, responsive, terminal, application
websocket, spec, define, requirements, mobile, responsive, web, terminal
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/mount-specificity-ordering (index)
dir: 2026-06-12-completed-changes-archive/mount-specificity-ordering
# openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
## role
Archives a completed specification for fixing mount specificity ordering behavior in the system.
Preserves a completed specification archive for a high-priority fix related to mount specificity ordering logic.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-12-completed-changes-archive/mount-specificity-ordering
dir: 2026-06-12-completed-changes-archive/mount-specificity-ordering
# openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering
index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md
## role
Archives a completed specification for fixing mount specificity ordering behavior in the system.
Preserves a completed specification archive for a high-priority fix related to mount specificity ordering logic.
## files
- .openspec.yaml | Defines an OpenSpec specification for a completed high-priority fix related to mount specificity ordering
- .openspec.yaml | Defines a completed high-priority fix specification named "mount-specificity-ordering"
## arch
Simple documentation archive using OpenSpec YAML format with no active code or runtime components.
Specification-as-code pattern using YAML-based change tracking with dated archival directory structure for immutable change history.
## tags
.openspec, defines, openspec, specification, completed, high, priority, fix
.openspec, defines, completed, high, priority, fix, specification, named
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/multi-session-terminal-ux (index)
dir: 2026-06-12-completed-changes-archive/multi-session-terminal-ux
# openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux
## role
Archive of completed design documents and implementation specifications for adding multi-session terminal support to an existing tool instance platform.
Archive of completed specification documents for a multi-session terminal UX feature that enables up to 5 concurrent terminal sessions per tool instance with tabbed UI, WebSocket routing, and hybrid storage.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -18,8 +18,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- proposal.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/multi-session-terminal-ux
dir: 2026-06-12-completed-changes-archive/multi-session-terminal-ux
# openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md
## role
Archive of completed design documents and implementation specifications for adding multi-session terminal support to an existing tool instance platform.
Archive of completed specification documents for a multi-session terminal UX feature that enables up to 5 concurrent terminal sessions per tool instance with tabbed UI, WebSocket routing, and hybrid storage.
## 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
- apply-pr2.md | Documents the implementation of a multi-session terminal UX with WebSocket routing, REST CRUD endpoints, frontend API client/hook, and auth-focused tests, while maintaining backward compatibility with legacy single-session endpoints. | dep: WebSocket, REST API, React hooks, Python pytest, Docker/PTY, terminal session manager
- apply-pr3.md | Documents a pull request implementing a frontend multi-session terminal UI with tabbed management, fullscreen mode, keyboard shortcuts, and mobile support. | dep: React, TypeScript, WebSocket, CSS, Python (backend terminal manager), testing framework
- design.md | Software design document specifying architecture and implementation for adding multi-session terminal support (up to 5 concurrent sessions) to an existing tool instance platform | dep: FastAPI, SQLAlchemy, Alembic, React, xterm.js, WebSocket, PTY, docker exec, Python, TypeScript
- explore.md | Explores architectural options for adding multi-session terminal support to an existing persistent terminal system, evaluating backend, frontend, protocol, and database design choices with recommendations for MVP implementation. | dep: TerminalManager, TerminalSession, TerminalComponent, TerminalPage, MobileTerminalWrapper, xterm.js, FastAPI, SQLAlchemy, alembic
- 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
- apply-pr1.md | Documents the implementation of database schema, Alembic migration, and multi-session terminal management core for a multi-session terminal UX feature in a backend API. | dep: Alembic, SQLAlchemy, aiosqlite, asyncio, pytest, WebSocket, TerminalSessionModel, UUIDPrimaryKeyMixin, TimestampMixin, SessionLocal
- apply-pr2.md | Documents the implementation of multi-session terminal WebSocket and REST API backend with frontend client/hook, including test results and deviations from original design. | dep: WebSocket, REST API, Python pytest, React/TypeScript (frontend hooks), Docker (implied for full integration), terminal PTY manager
- apply-pr3.md | Documents a frontend pull request implementing multi-session terminal UI with tabbed management, fullscreen mode, keyboard shortcuts, and mobile integration. | dep: React, TypeScript, WebSocket, CSS, Python (backend service)
- design.md | Software design document specifying a multi-session terminal UX architecture with up to 5 concurrent sessions per tool instance, using hybrid in-memory/DB storage and WebSocket-per-session routing. | dep: React, FastAPI, WebSocket, xterm.js, SQLAlchemy, Alembic, Docker PTY, Python asyncio
- explore.md | A software design document exploring the architecture, options, and feasibility for adding multi-session terminal support to an existing persistent terminal system. | dep: TerminalManager, TerminalSession, TerminalComponent, TerminalPage, MobileTerminalWrapper, xterm.js, FastAPI, WebSocket, docker exec, SQLAlchemy, alembic
- proposal.md | Proposes architectural changes to support multiple concurrent terminal sessions per tool instance with improved UI/UX features | dep: TerminalSession, TerminalManager, TerminalComponent, terminal.tsx, WebSocket, database
- tasks.md | Defines a detailed software development plan for implementing multi-session terminal UX across backend and frontend, broken into 12 tasks across 3 stacked PRs with TDD acceptance criteria. | dep: Alembic, SQLAlchemy, FastAPI, WebSocket, React, xterm.js, PTY, UUID, pytest, React Testing Library
## arch
Design-driven development with phased PR implementation (backend core → API/WebSocket → frontend UI), using FastAPI/WebSocket backend and React/TypeScript frontend, with explicit architectural exploration and task breakdown before coding.
Specification-driven development using stacked PR planning (3 PRs: backend schema/API, WebSocket/REST integration, frontend UI), hybrid in-memory/database session storage, WebSocket-per-session routing, and TDD acceptance criteria with documented design deviations.
## tags
terminal, session, multi, apply, implementation, alembic, websocket, support
terminal, session, websocket, multi, apply, alembic, design, sqlalchemy
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/notification-center (index)
dir: 2026-06-12-completed-changes-archive/notification-center
# openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center
## role
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.
Defines and documents a full-stack persistent notification center system replacing ephemeral toasts, with backend storage, REST API, React frontend, and user preference management.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -21,8 +21,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md
## workflows
-
## dirty
@@ -1,26 +1,26 @@
# 2026-06-12-completed-changes-archive/notification-center
dir: 2026-06-12-completed-changes-archive/notification-center
# openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center
index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md
## role
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.
Defines and documents a full-stack persistent notification center system replacing ephemeral toasts, with backend storage, REST API, React frontend, and user preference management.
## 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
- apply-pr2.md | This file is a completion report documenting the implementation of backend integration for a Notification Center (PR-2), covering wiring lifecycle hooks and health monitoring to a notification service, extending user configuration schemas, and validating through TDD with integration tests. | dep: notification_service, event_bus, lifecycle_hooks, health_monitor, user_config, Pydantic, pytest, unittest.mock, ruff, Alembic
- apply-pr3.md | Documents the implementation, testing, and validation of a frontend Notification Center feature (PR-3) including React components, hooks, state management, API client, and CSS styles. | dep: React, @phosphor-icons/react, vitest, testing-library, TypeScript, ESLint, CSS variables
- apply-pr4.md | Documents the implementation of toast notification coordination with user-configurable preferences for a notification center system. | dep: React, TypeScript, Vitest, UserConfig API, PATCH /user-config, tsc, eslint
- apply-progress.md | Documents the TDD-driven implementation progress of a full-stack Notification Center feature across 4 PRs, including backend API, frontend components, and toast coordination, with test evidence, file changes, and technical decisions. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, React, TypeScript, Vitest, pytest, ruff, ESLint, tsc, @phosphor-icons/react, unittest.mock
- design.md | Design document for a cross-cutting notification center system with backend FastAPI service, frontend React components, and event producer integration. | dep: FastAPI, SQLAlchemy/AsyncSession, Alembic, Pydantic, React/Context, SSE/event bus, Phosphor icons, lifecycle hooks, health monitor
- explore.md | Exploratory design document for adding a persistent, user-scoped Notification Center to an existing toast-only notification system, covering current state analysis, gaps, integration points, risks, and phased implementation roadmap. | dep: FastAPI, SQLAlchemy, Alembic, React, SSE/EventSource, Phosphor Icons, InstanceEventBus, HealthMonitor, LifecycleHooks, Toast System, Event Bridge
- proposal.md | This is a software design document (SDD) proposal for building a persistent, user-scoped notification center with REST API, database storage, and React frontend components, replacing ephemeral SSE-driven toasts. | dep: SQLAlchemy, Alembic, React, FastAPI/REST, PhosphorIcons, SSE (existing), UserConfig system, InstanceEventBus, HealthMonitor, lifecycle_hooks
- 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
- apply-pr1.md | Documents the implementation, testing, and validation of PR-1 backend core for a Notification Center system including database migrations, service layer, API endpoints, and comprehensive tests. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, SQLite, PostgreSQL, pytest, ruff
- apply-pr2.md | Documents the completion of PR-2 backend integration for a Notification Center, wiring lifecycle hooks and health monitoring to a notification service, extending user config schemas, and adding integration tests with TDD evidence. | dep: notification_service, event_bus, lifecycle_hooks, health_monitor, user_config, Pydantic, pytest, unittest.mock, ruff
- apply-pr3.md | Documents the implementation of a frontend notification center feature with bell icon, dropdown panel, polling, optimistic updates, and comprehensive tests. | dep: React, @phosphor-icons/react, vitest, testing-library, TypeScript, CSS variables
- apply-pr4.md | Documents the implementation of toast notification coordination for a notification center, including preference checks, category/severity mapping, settings UI, and comprehensive tests. | dep: React, UserConfig API, PATCH /user-config, vitest, TypeScript, ESLint
- apply-progress.md | Documents the TDD-driven implementation progress of a Notification Center feature across 4 PRs, covering backend CRUD/API, event producer integration, frontend React components/hooks, and toast coordination with user preferences. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, React, Vitest, pytest, ruff, eslint, TypeScript, unittest.mock, @phosphor-icons/react
- design.md | Design specification for a cross-cutting notification center system with backend persistence service, FastAPI endpoints, and React frontend components for user notifications. | dep: FastAPI, SQLAlchemy, AsyncSession, Alembic, Pydantic, React, Phosphor Icons, SSE/Event Bus, lifecycle_hooks, health_monitor, event-toast-bridge, UserConfig
- explore.md | Design document exploring the transition from an ephemeral toast-only notification system to a full persistent notification center with backend storage, user-scoped filtering, and a frontend UI component. | dep: FastAPI, SQLAlchemy, Alembic, React, SSE, Phosphor Icons, InstanceEventBus, HealthMonitor, LifecycleHooks, EventContext, Toast System, AppShell
- proposal.md | Proposes a system design for adding a persistent, per-user notification center with REST API, UI components, and toast coordination to replace ephemeral SSE-driven toasts. | dep: SQLAlchemy, Alembic, React, PhosphorIcons, FastAPI/REST, SSE, UserConfig, InstanceEventBus, HealthMonitor, lifecycle_hooks
- spec.md | Defines a full-stack notification center system with per-user persistent notifications, REST API, frontend UI, and user-scoped preferences for muting and toast suppression. | dep: SQLAlchemy, FastAPI, Alembic, PostgreSQL, React/frontend (implied), 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 and dependencies. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, pytest, AsyncSession, UUIDPrimaryKeyMixin, UserConfig, InstanceEventBus, lifecycle_hooks, health_monitor
## arch
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.
Specification-driven incremental development using 4 stacked PRs (backend core → backend integration → frontend core → toast coordination) with TDD, OpenAPI contracts, FastAPI service layer, React hooks/components, and event-driven lifecycle integration with health monitoring.
## tags
notification, react, center, apply, fastapi, sqlalchemy, alembic, user
notification, center, react, apply, fastapi, user, backend, alembic
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions (index)
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions
# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
## role
Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones.
Design specification package for persistent WebSocket terminal sessions that survive reconnections by reattaching to existing docker exec processes rather than spawning new ones.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions
# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions
index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
## role
Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones.
Design specification package for persistent WebSocket terminal sessions that survive reconnections by reattaching 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
- .openspec.yaml | Defines an OpenSpec schema configuration file with 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: WebSocket, docker exec, TerminalManager, TerminalSession, PTY, background task scheduler
- proposal.md | Design proposal for implementing persistent WebSocket terminal sessions that survive reconnections by reattaching to existing docker exec processes instead of spawning new ones. | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.py, terminal.tsx, use-terminal.ts
- tasks.md | A task tracking document outlining the refactoring of a terminal session system to support persistent, reconnectable WebSocket connections with circular output buffers, idle timeouts, and reset functionality across backend and frontend components. | dep: WebSocket, Docker, API backend, React/frontend terminal component
## arch
Event-driven architecture with WebSocket connection management, process state persistence, session lifecycle handling (reconnection/reset/idle timeout), and cross-layer backend-frontend coordination.
Specification-driven design using OpenSpec schema configuration with layered documentation (proposal → design → tasks) following a structured change-archive pattern for tracking system evolution across backend (Go circular buffers, idle timeouts, process reattachment) and frontend (WebSocket reconnection, reset functionality) components.
## tags
websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec
terminal, websocket, design, persistent, docker, proposal, .openspec, document
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs (index)
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs (index)
dir: openspec/changes/archive/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.
Archive of completed specification documents for persistent terminal sessions feature from June 12, 2026.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md
## files
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs
dir: openspec/changes/archive/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
index: openspec/changes/archive/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.
Archive of completed specification documents for persistent terminal sessions feature from June 12, 2026.
## files
## arch
Documentation-only archive directory with no active code; stores historical design specs for completed terminal session persistence functionality.
Flat directory structure storing finalized markdown specification files as historical project documentation.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
## role
Defines specifications for persistent WebSocket terminal sessions that maintain state across reconnections with buffered output, reset controls, and idle timeout management.
Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md
## role
Defines specifications for persistent WebSocket terminal sessions that maintain state across reconnections with buffered output, reset controls, and idle timeout management.
Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities
## files
- spec.md | Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities
- spec.md | Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities | dep: WebSocket, docker exec, terminal session management
## arch
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.
Specification-driven requirements document using markdown-based specification format with functional requirements, constraints, and capability definitions
## tags
spec, defines, requirements, persistent, websocket, terminal, sessions, reconnection
websocket, spec, defines, requirements, persistent, terminal, sessions, reconnection
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/reorganize-long-files (index)
dir: 2026-06-12-completed-changes-archive/reorganize-long-files
# openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files
## role
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.
This package archives the completed specification for a structural refactoring initiative that decomposed monolithic frontend pages and backend routers into smaller, focused components and services.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -14,8 +14,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/reorganize-long-files
dir: 2026-06-12-completed-changes-archive/reorganize-long-files
# openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files
index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md
## role
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.
This package archives the completed specification for a structural refactoring initiative that decomposed monolithic frontend pages and backend routers into smaller, focused components and services.
## 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.
- .openspec.yaml | Defines a completed project specification named "reorganize-long-files" with start and completion dates
- proposal.md | Proposes a structural refactoring to split monolithic frontend pages and backend routers into thin orchestrators and extracted components/services, restoring a thin-page/thin-router/fat-component pattern.
- spec.md | This file specifies a pure structural refactoring plan to decompose monolithic frontend pages, CSS, and backend routers into smaller, focused components and services without changing any behavior or API contracts. | dep: React, React Router, CSS Modules, WebSocket, FastAPI, Python services architecture
- tasks.md | Tracks the completion status of a code reorganization initiative to slim down long backend routers and frontend pages by extracting components and services into dedicated files. | dep: spec.md, api/tool/tool_instances.py, api/tool/tool_lifecycle.py, api/system/terminal.py, services/git/operations.py, services/config/crud_service.py, services/config/resolver_service.py, pages/ToolWorkshopPage.tsx, pages/ConfigProfilesPage.tsx, pages/TerminalPage.tsx, pages/WorkspaceDetailPage.tsx, components/features/terminal/, components/features/workspace/, main.py
## arch
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.
Specification-driven refactoring using a proposal-spec-tasks workflow pattern with YAML metadata tracking, mandating pure structural decomposition (thin orchestrators, fat extracted components) while preserving all behavioral and API contracts.
## tags
components, services, long, .openspec, structural, refactoring, split, monolithic
pages, py, services, components, api, tsx, frontend, backend
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/session-list-overhaul (index)
dir: 2026-06-12-completed-changes-archive/session-list-overhaul
# openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul
## role
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.
Archive of a completed 2026 UI refactoring project that unified duplicated session list components across dashboard and sessions pages into reusable React components.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/session-list-overhaul
dir: 2026-06-12-completed-changes-archive/session-list-overhaul
# openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul
index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
## role
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.
Archive of a completed 2026 UI refactoring project that unified duplicated session list components across dashboard and sessions pages into reusable React 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
- .openspec.yaml | Defines an OpenSpec schema configuration file with metadata
- design.md | Design document proposing a UI refactoring to unify duplicated session list rendering logic across dashboard and sessions pages into reusable components | 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
- tasks.md | A task tracking document for refactoring session UI components in a web application, detailing implementation steps for SessionCard and SessionList components with dashboard and sessions page updates. | dep: React, TypeScript, CSS, ESLint
## arch
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.
Documentation-driven development with structured planning artifacts (design doc, proposal, tasks) using OpenSpec schema configuration for tracking frontend component refactoring work.
## tags
dashboard, sessions, tsx, design, refactoring, session, components, .openspec
dashboard, sessions, components, tsx, design, refactoring, session, .openspec
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/session-list-overhaul/specs (index)
dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
## role
Contains archived specification documents for the completed session list overhaul feature from June 12, 2026.
Contains archived specification documents for the session list overhaul feature completed on June 12, 2026.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md
## files
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-06-12-completed-changes-archive/session-list-overhaul/specs
dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs
# openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
## role
Contains archived specification documents for the completed session list overhaul feature from June 12, 2026.
Contains archived specification documents for the session list overhaul feature completed on June 12, 2026.
## files
## arch
Documentation/archive pattern using date-prefixed directory naming for historical change tracking with specification-driven development artifacts.
Flat directory structure storing dated, completed change specifications as static documentation artifacts with no active code or dynamic patterns.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
## role
Defines UI specifications for unified session card components with display, controls, grouping, and filtering capabilities across dashboard and sessions pages.
Defines UI specifications for a redesigned session list component with card-based layout, management controls, and cross-page unification.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md
## role
Defines UI specifications for unified session card components with display, controls, grouping, and filtering capabilities across dashboard and sessions pages.
Defines UI specifications for a redesigned session list component with card-based layout, management controls, and cross-page unification.
## files
- spec.md | Specifies UI requirements for session card display, control actions, list grouping/filtering, and component unification across dashboard and sessions pages.
- spec.md | Define requirements for a session management UI with card-based display, control actions, grouping/filtering, and unified components across dashboard and sessions pages
## arch
Specification-driven design using requirements documentation to standardize component behavior and visual presentation across multiple page contexts.
Specification-driven design using requirement documents to formalize UI/UX patterns before implementation.
## tags
spec, specifies, requirements, session, card, display, control, actions
spec, define, requirements, session, management, card, display, control
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/ssh-key-mounting (index)
dir: 2026-06-12-completed-changes-archive/ssh-key-mounting
# openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting
## role
Defines requirements specification for mounting SSH keys into tool instances to enable secure authentication.
Defines an archived OpenSpec specification for SSH key mounting functionality in tool instance lifecycle operations.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-06-12-completed-changes-archive/ssh-key-mounting
dir: 2026-06-12-completed-changes-archive/ssh-key-mounting
# openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting
index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md
## role
Defines requirements specification for mounting SSH keys into tool instances to enable secure authentication.
Defines an archived OpenSpec specification for SSH key mounting functionality in tool instance lifecycle operations.
## files
- .openspec.yaml | Specification document defining requirements for SSH key mounting feature in tool instances
- .openspec.yaml | Defines an OpenSpec specification for implementing SSH key mounting functionality when creating/starting tool instances
## arch
Requirements-as-code pattern using OpenSpec YAML format for declarative feature specification.
Specification-driven API design using OpenSpec YAML configuration for declarative feature requirements.
## tags
.openspec, specification, document, defining, requirements, ssh, key, mounting
.openspec, defines, openspec, specification, implementing, ssh, key, mounting
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header (index)
dir: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
# openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
## role
Archives a completed bugfix specification for unifying terminal fullscreen mode header UI elements.
Archives a completed bugfix specification for unifying terminal fullscreen header UI elements.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
- .openspec.yaml
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
dir: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
# openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md
## role
Archives a completed bugfix specification for unifying terminal fullscreen mode header UI elements.
Archives a completed bugfix specification for unifying terminal fullscreen header UI elements.
## files
- .openspec.yaml | Defines a completed bugfix specification for unifying terminal fullscreen mode header elements
- .openspec.yaml | Defines a completed bugfix specification for unifying terminal fullscreen header elements
## arch
Specification-driven change tracking using YAML-based open specifications for completed work documentation.
Specification-driven change tracking using YAML metadata files in dated archive directories for completed work items.
## tags
.openspec, defines, completed, bugfix, specification, unifying, terminal, fullscreen
## symbols
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/tool-config-mount-cleanup (index)
dir: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup
## role
Completed change archive documenting the removal of configuration/state mounts from built-in tool definitions to enable config-profile-based user-specific configuration.
Archive record of a completed engineering task to refactor tool configuration mount handling by removing user-configurable mounts from built-in tool definitions.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -13,8 +13,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- proposal.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md
## workflows
-
## dirty
@@ -1,18 +1,18 @@
# 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
dir: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md
## role
Completed change archive documenting the removal of configuration/state mounts from built-in tool definitions to enable config-profile-based user-specific configuration.
Archive record of a completed engineering task to refactor tool configuration mount handling by removing user-configurable mounts from built-in tool definitions.
## 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
- .openspec.yaml | Defines an OpenSpec project configuration file tracking a completed task named "tool-config-mount-cleanup" with start and completion dates.
- proposal.md | Proposes removing user configuration and state mounts from built-in tool definitions to enforce separation between tool setup and user-configurable profiles.
- tasks.md | This file is a task checklist tracking the completion of a multi-step engineering task involving removing specific mounts and volumes from tool configurations and data migrations. | dep: Alembic, pytest, py_compile, pi-agent, opencode, apps/api
## arch
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.
Specification-driven change tracking using YAML metadata with Markdown-based proposal and task documentation, following a structured archive pattern with dated directories for completed work.
## tags
tool, configuration, completed, config, .openspec, proposal, tasks, defines
tool, task, configuration, tracking, completion, .openspec, removing, user
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates (index)
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
## role
Archives documentation for a completed frontend refactoring that added real-time session progress tracking via SSE events and shared React state.
Archive of completed design documents for a frontend refactoring that replaced blocking loading states with real-time SSE-driven progress tracking across tool session lifecycles.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: openspec/changes/archive/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: 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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
## role
Archives documentation for a completed frontend refactoring that added real-time session progress tracking via SSE events and shared React state.
Archive of completed design documents for a frontend refactoring that replaced blocking loading states with real-time SSE-driven progress tracking across tool session lifecycles.
## 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
- .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata
- 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 (Server-Sent Events), SessionsContext, useEvents, AppShell, DashboardPage, SessionsPage, CreateSessionForm, InstanceList, useInstanceActions, ToolStarter, StartToolFAB, EventToastBridge
- proposal.md | Proposes a frontend architecture change to replace blocking loading states with a global SSE-driven progress panel and shared session state for immediate UI updates across tool session lifecycle actions. | dep: React, SSE event stream, existing session state management, AppShell, DashboardPage, SessionsPage, CreateSessionForm, SessionCard, InstanceCard, use-instance-actions hook
- tasks.md | This is a task tracking document for a frontend refactoring project focused on implementing shared session state, a global progress panel, and removing legacy loading overlays in a React web 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
## arch
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.
Event-driven frontend architecture using Server-Sent Events (SSE) for live progress streaming, shared React context for global session state management, and a non-blocking global progress panel replacing legacy modal loading overlays.
## tags
session, tsx, components, features, progress, react, tool, state
session, tool, tsx, react, progress, state, components, features
## symbols
-
## workflows
@@ -1,22 +1,22 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
## role
This directory serves as a specification archive for completed tool session progress and updates, storing historical design documents and requirements for past changes.
Contains archived specification documents for tracking tool session progress and updates from June 12, 2026.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md
## children
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md
- openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md
## files
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs
dir: openspec/changes/archive/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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
## role
This directory serves as a specification archive for completed tool session progress and updates, storing historical design documents and requirements for past changes.
Contains archived specification documents for tracking tool session progress and updates from June 12, 2026.
## files
## arch
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.
Archive directory structure preserving historical change specifications with date-based versioning for completed project milestones.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux (index)
dir: openspec/changes/archive/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 and optimistic state updates during asynchronous session operations.
Defines UI/UX requirements for non-blocking progress indicators and optimistic deletion patterns in a session management system.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux
dir: openspec/changes/archive/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
index: openspec/changes/archive/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 and optimistic state updates during asynchronous session operations.
Defines UI/UX requirements for non-blocking progress indicators and optimistic deletion patterns in a session management system.
## 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
- spec.md | Defines UI/UX requirements for non-blocking progress indicators and optimistic deletion patterns in a session management system. | dep: SSE (Server-Sent Events), shared state management, API layer
## arch
Event-driven reactive UI pattern using Server-Sent Events (SSE) for streaming progress updates, with optimistic UI state management for non-blocking user experience.
Specification-driven design using markdown-based requirements documentation with focus on asynchronous user experience patterns and optimistic UI state management.
## tags
sse, spec, specifies, requirements, non, blocking, progress, indicators
spec, defines, requirements, non, blocking, progress, indicators, optimistic
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
## role
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.
Defines requirements for a shared session state system that synchronizes real-time UI updates across multiple application views when session data changes.
## parent
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md
## children
-
## files
- spec.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 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
# openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub
dir: openspec/changes/archive/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
index: openspec/changes/archive/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 that enables real-time UI synchronization across dashboard, sessions page, and navigation components when session data changes.
Defines requirements for a shared session state system that synchronizes real-time UI updates across multiple application views 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`)
- spec.md | Specifies requirements for a shared session state system that ensures immediate UI updates across navigation, dashboard, and sessions page when sessions are created or modified. | dep: React Context API, SessionsContext, session creation API, /users/me/sessions endpoint
## arch
Specification-driven architecture using a centralized session state hub with reactive update propagation to multiple UI surfaces.
Specification-driven requirements document using a hub-and-spoke pattern where a centralized sessions hub propagates state changes to distributed UI components (navigation, dashboard, sessions page) via reactive updates.
## tags
sessions, spec, defines, requirements, implementing, shared, global, session
sessions, spec, specifies, requirements, shared, session, state, system
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/working-copies (index)
dir: 2026-06-12-completed-changes-archive/working-copies
# openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies
## role
Archive of completed design documents for a project that replaced direct repository mounting/cloning with persistent, shared Git workspace copies for tool instances.
Archive of completed design and specification documents for implementing workspace-based git working copies to replace direct repository mounting in tool instances.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -16,8 +16,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md
## workflows
-
## dirty
@@ -1,21 +1,21 @@
# 2026-06-12-completed-changes-archive/working-copies
dir: 2026-06-12-completed-changes-archive/working-copies
# openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies
index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md
## role
Archive of completed design documents for a project that replaced direct repository mounting/cloning with persistent, shared Git workspace copies for tool instances.
Archive of completed design and specification documents for implementing workspace-based git working copies to replace direct repository mounting in 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
- explore.md | Design document proposing "Working Copies" (named "Workspace") as persistent writable clones of repositories to replace direct repo mounting/cloning in tool instances | dep: GitRepository, ToolInstance, Project, User, database, compose generation, filesystem mount system
- proposal.md | Proposes a new "Workspace" entity to replace the confusing mount/clone mode dichotomy for tool instances, enabling persistent writable repository clones that multiple tools can share.
- 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
- .openspec.yaml | Defines metadata for a completed project named "working-copies" with start and completion dates
- 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, React/TypeScript, Git, asyncio, uuid, datetime
- explore.md | Proposes a "Working Copy" (Workspace) entity architecture to replace direct repository mounting/cloning in tool instances, enabling persistent writable clones shared across multiple tool instances. | dep: GitRepository, ToolInstance, database/ORM, container compose generation, filesystem mount/bind-mount, UI/sidebar navigation
- proposal.md | Proposes a workspace-based architecture to replace mount/clone modes for tool instances with persistent, writable local repository clones
- spec.md | Technical specification document defining a workspace-based architecture for persistent, writable Git repository clones that replace mount/clone modes for tool instances. | dep: Git, PostgreSQL, REST API, Python, TypeScript, React/frontend framework, container runtime
- tasks.md | Tracks implementation tasks for a workspace-based tool instance feature across 4 sequential PRs, covering backend foundation, backend integration, frontend core, and frontend integration with acceptance criteria and verification steps. | dep: Alembic, FastAPI, SQLAlchemy models, GitService, WorkspaceManager, pytest, ruff, TypeScript, React hooks/components, React Router, ESLint, npm, Docker compose templates
## arch
Design-driven development with layered specification documents (exploration → proposal → design → spec → tasks) documenting a phased multi-PR implementation across backend and frontend systems.
Documentation-driven specification with layered architecture (exploration → proposal → design → spec → tasks) defining a workspace entity pattern with persistent writable git clones shared across isolated tool instances, replacing mount/clone modes.
## tags
workspace, tool, instances, git, design, replace, project, working
tool, workspace, instances, replace, repository, git, working, design
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-06-12-completed-changes-archive/workspace-first-ui (index)
dir: 2026-06-12-completed-changes-archive/workspace-first-ui
# openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui (index)
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui
## role
Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction.
Archive of completed design and planning documents for a workspace-first UI redesign that shifted the product from repository-centric to workspace-centric navigation.
## parent
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
## children
-
## files
@@ -15,8 +15,8 @@ map: 2026-06-12-completed-changes-archive/.pi-map.md
- spec.md
- tasks.md
## links
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
index: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2026-06-12-completed-changes-archive/workspace-first-ui
dir: 2026-06-12-completed-changes-archive/workspace-first-ui
# openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui
dir: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui
index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
index: openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md
## role
Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction.
Archive of completed design and planning documents for a workspace-first UI redesign that shifted the product from repository-centric to workspace-centric navigation.
## 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
- proposal.md | Proposes a UI refresh to replace the old repository workspace with a workspace-first navigation model centered around persistent writable clones.
- 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
- .openspec.yaml | Defines metadata for a completed UI project workspace in OpenSpec format
- design.md | Design document for a workspace-first UI refresh, defining backend API/services and frontend components for file management, git operations, and tool instances scoped to workspaces. | dep: FastAPI, SQLAlchemy/AsyncSession, React, React Router, TypeScript, asyncio, subprocess, os
- proposal.md | Proposes a UI redesign to replace the old repository workspace with a workspace-first navigation model centered on persistent workspace clones | dep: Working Copies Spec, repo-workspace.tsx, workspaces.tsx, pages/repo-workspace.tsx
- spec.md | Product specification document defining a workspace-first UI refresh that replaces direct repository file browsing with workspace-centric navigation, detail pages, and project organization.
- tasks.md | Documents the task breakdown, implementation order, and verification steps for a workspace-first UI refresh project across three sequential PRs (backend endpoints, workspace detail page, projects page refresh).
## arch
Documentation-heavy package using sequential PR-based task decomposition (backend → workspace detail → projects page) with layered specification hierarchy (proposal → design → spec → tasks) and OpenSpec metadata tracking.
Specification-driven development with phased PR implementation (backend → workspace detail → projects page), using OpenSpec metadata format and structured documentation hierarchy (proposal → design → spec → tasks).
## tags
workspace, first, refresh, design, document, project, specification, .openspec
workspace, first, refresh, project, design, tsx, .openspec, document
## symbols
-
## workflows