chore: archive 15 completed OpenSpec changes

This commit is contained in:
Developer
2026-06-12 14:27:18 +00:00
493 changed files with 3563 additions and 3490 deletions
+35 -64
View File
@@ -1,73 +1,44 @@
# openspec/changes (index)
dir: openspec/changes
# . (index)
dir: .
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
## role
Implements a version control and change tracking system for managing schema evolution and data migrations in the OpenSpec framework.
Empty root directory awaiting package initialization or content.
## parent
index: openspec/.pi-map.index.md
map: openspec/.pi-map.md
-
## children
- openspec/changes/archive
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
- openspec/changes/backend-frontend-refactoring
index: openspec/changes/backend-frontend-refactoring/.pi-map.index.md
map: openspec/changes/backend-frontend-refactoring/.pi-map.md
- openspec/changes/config-profile-git-mounts
index: openspec/changes/config-profile-git-mounts/.pi-map.index.md
map: openspec/changes/config-profile-git-mounts/.pi-map.md
- openspec/changes/config-profile-includes-ui
index: openspec/changes/config-profile-includes-ui/.pi-map.index.md
map: openspec/changes/config-profile-includes-ui/.pi-map.md
- openspec/changes/config-profile-multi-repo-mounts
index: openspec/changes/config-profile-multi-repo-mounts/.pi-map.index.md
map: openspec/changes/config-profile-multi-repo-mounts/.pi-map.md
- openspec/changes/container-monitoring-notifications
index: openspec/changes/container-monitoring-notifications/.pi-map.index.md
map: openspec/changes/container-monitoring-notifications/.pi-map.md
- openspec/changes/git-mount-url-validation
index: openspec/changes/git-mount-url-validation/.pi-map.index.md
map: openspec/changes/git-mount-url-validation/.pi-map.md
- openspec/changes/home-path-expansion
index: openspec/changes/home-path-expansion/.pi-map.index.md
map: openspec/changes/home-path-expansion/.pi-map.md
- openspec/changes/mobile-terminal-ux
index: openspec/changes/mobile-terminal-ux/.pi-map.index.md
map: openspec/changes/mobile-terminal-ux/.pi-map.md
- openspec/changes/mount-specificity-ordering
index: openspec/changes/mount-specificity-ordering/.pi-map.index.md
map: openspec/changes/mount-specificity-ordering/.pi-map.md
- openspec/changes/multi-session-terminal-ux
index: openspec/changes/multi-session-terminal-ux/.pi-map.index.md
map: openspec/changes/multi-session-terminal-ux/.pi-map.md
- openspec/changes/notification-center
index: openspec/changes/notification-center/.pi-map.index.md
map: openspec/changes/notification-center/.pi-map.md
- openspec/changes/persistent-terminal-sessions
index: openspec/changes/persistent-terminal-sessions/.pi-map.index.md
map: openspec/changes/persistent-terminal-sessions/.pi-map.md
- openspec/changes/reorganize-long-files
index: openspec/changes/reorganize-long-files/.pi-map.index.md
map: openspec/changes/reorganize-long-files/.pi-map.md
- openspec/changes/session-list-overhaul
index: openspec/changes/session-list-overhaul/.pi-map.index.md
map: openspec/changes/session-list-overhaul/.pi-map.md
- openspec/changes/ssh-key-mounting
index: openspec/changes/ssh-key-mounting/.pi-map.index.md
map: openspec/changes/ssh-key-mounting/.pi-map.md
- openspec/changes/terminal-fullscreen-unified-header
index: openspec/changes/terminal-fullscreen-unified-header/.pi-map.index.md
map: openspec/changes/terminal-fullscreen-unified-header/.pi-map.md
- openspec/changes/working-copies
index: openspec/changes/working-copies/.pi-map.index.md
map: openspec/changes/working-copies/.pi-map.md
- openspec/changes/workspace-first-ui
index: openspec/changes/workspace-first-ui/.pi-map.index.md
map: openspec/changes/workspace-first-ui/.pi-map.md
- archive
index: archive/.pi-map.index.md
map: archive/.pi-map.md
- multi-session-terminal-ux
index: multi-session-terminal-ux/.pi-map.index.md
map: multi-session-terminal-ux/.pi-map.md
- reorganize-long-files
index: reorganize-long-files/.pi-map.index.md
map: reorganize-long-files/.pi-map.md
- working-copies
index: working-copies/.pi-map.index.md
map: working-copies/.pi-map.md
- workspace-first-ui
index: workspace-first-ui/.pi-map.index.md
map: workspace-first-ui/.pi-map.md
## files
## links
index: openspec/changes/.pi-map.index.md
map: openspec/changes/.pi-map.md
index: ./.pi-map.index.md
map: ./.pi-map.md
## workflows
-
## dirty
+19 -5
View File
@@ -1,13 +1,27 @@
# openspec/changes
dir: openspec/changes
# .
dir: .
index: openspec/changes/.pi-map.index.md
index: ./.pi-map.index.md
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
## role
Implements a version control and change tracking system for managing schema evolution and data migrations in the OpenSpec framework.
Empty root directory awaiting package initialization or content.
## files
## arch
Event-sourced architecture with command pattern for immutable change records, supporting branching/merging semantics and incremental schema transformations.
N/A - no files or architectural patterns present to analyze.
## tags
-
## symbols
+142 -139
View File
@@ -1,148 +1,151 @@
# openspec/changes/archive (index)
dir: openspec/changes/archive
# archive (index)
dir: archive
## role
Provides historical archive storage for tracked changes, enabling audit trails and rollback capabilities for OpenSpec documents.
This package provides functionality for creating, reading, and extracting compressed archive files in various formats.
## parent
index: openspec/changes/.pi-map.index.md
map: openspec/changes/.pi-map.md
index: ./.pi-map.index.md
map: ./.pi-map.md
## children
- openspec/changes/archive/2025-05-17-oauth-traefik-integration
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md
- openspec/changes/archive/2025-05-17-user-profile
index: openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/.pi-map.md
- openspec/changes/archive/2025-05-18-git-repo-management
index: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md
- openspec/changes/archive/2025-05-18-ssh-key-management
index: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md
- openspec/changes/archive/2025-05-18-test-infrastructure-improvements
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md
- openspec/changes/archive/2025-05-18-tool-types-definition
index: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md
- openspec/changes/archive/2025-05-18-user-config-management
index: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md
- openspec/changes/archive/2026-05-17-auth-oauth
index: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md
- openspec/changes/archive/2026-05-17-database-models
index: openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-database-models/.pi-map.md
- openspec/changes/archive/2026-05-17-frontend-foundation
index: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md
- openspec/changes/archive/2026-05-17-project-management
index: openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/.pi-map.md
- openspec/changes/archive/2026-05-18-database-setup-recovery
index: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md
- openspec/changes/archive/2026-05-18-simplify-authentik-auth
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md
- openspec/changes/archive/2026-05-19-api-documentation
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md
- openspec/changes/archive/2026-05-19-documentation-overhaul
index: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md
- openspec/changes/archive/2026-05-19-file-editor
index: openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-file-editor/.pi-map.md
- openspec/changes/archive/2026-05-19-git-control
index: openspec/changes/archive/2026-05-19-git-control/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-git-control/.pi-map.md
- openspec/changes/archive/2026-05-19-git-history-visualization
index: openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.md
- openspec/changes/archive/2026-05-19-repo-workspace
index: openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.md
- openspec/changes/archive/2026-05-19-responsive-spacing-improvements
index: openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.md
- openspec/changes/archive/2026-05-19-smart-git-url-parsing
index: openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.md
- openspec/changes/archive/2026-05-19-tool-instances
index: openspec/changes/archive/2026-05-19-tool-instances/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-tool-instances/.pi-map.md
- openspec/changes/archive/2026-05-19-tool-terminal
index: openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.md
- openspec/changes/archive/2026-05-19-universal-icon-system
index: openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.md
- openspec/changes/archive/2026-05-19-workspace-visual-overhaul
index: openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.md
- openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded
index: openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md
- openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config
index: openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md
- openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check
index: openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md
- openspec/changes/archive/2026-05-22-git-repo-working-clones
index: openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.md
- openspec/changes/archive/2026-05-22-instance-health-monitoring
index: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md
- openspec/changes/archive/2026-05-22-instance-proxy
index: openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.md
- openspec/changes/archive/2026-05-22-opencode-web-terminal
index: openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.md
- openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh
index: openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md
- openspec/changes/archive/2026-05-22-session-management-fixes
index: openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.md
- openspec/changes/archive/2026-05-22-sessions-hub
index: openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.md
- openspec/changes/archive/2026-05-22-tool-config-management
index: openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.md
- openspec/changes/archive/2026-05-22-tool-config-ui-rework
index: openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.md
- openspec/changes/archive/2026-05-22-tool-workshop
index: openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.md
- openspec/changes/archive/2026-05-22-ui-redesign-home-settings
index: openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md
map: openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.md
- openspec/changes/archive/2026-05-23-remove-built-in-tools
index: openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.index.md
map: openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.md
- openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools
index: openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md
map: openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md
- openspec/changes/archive/2026-05-25-add-config-profiles
index: openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.index.md
map: openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.md
- openspec/changes/archive/2026-05-25-mobile-app-usability
index: openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.index.md
map: openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.md
- openspec/changes/archive/2026-05-25-mobile-pages-overhaul
index: openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.md
- archive/2025-05-17-oauth-traefik-integration
index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/.pi-map.md
- archive/2025-05-17-user-profile
index: archive/2025-05-17-user-profile/.pi-map.index.md
map: archive/2025-05-17-user-profile/.pi-map.md
- archive/2025-05-18-git-repo-management
index: archive/2025-05-18-git-repo-management/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/.pi-map.md
- archive/2025-05-18-ssh-key-management
index: archive/2025-05-18-ssh-key-management/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/.pi-map.md
- archive/2025-05-18-test-infrastructure-improvements
index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/.pi-map.md
- archive/2025-05-18-tool-types-definition
index: archive/2025-05-18-tool-types-definition/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/.pi-map.md
- archive/2025-05-18-user-config-management
index: archive/2025-05-18-user-config-management/.pi-map.index.md
map: archive/2025-05-18-user-config-management/.pi-map.md
- archive/2026-05-17-auth-oauth
index: archive/2026-05-17-auth-oauth/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/.pi-map.md
- archive/2026-05-17-database-models
index: archive/2026-05-17-database-models/.pi-map.index.md
map: archive/2026-05-17-database-models/.pi-map.md
- archive/2026-05-17-frontend-foundation
index: archive/2026-05-17-frontend-foundation/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/.pi-map.md
- archive/2026-05-17-project-management
index: archive/2026-05-17-project-management/.pi-map.index.md
map: archive/2026-05-17-project-management/.pi-map.md
- archive/2026-05-18-database-setup-recovery
index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/.pi-map.md
- archive/2026-05-18-simplify-authentik-auth
index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: archive/2026-05-18-simplify-authentik-auth/.pi-map.md
- archive/2026-05-19-api-documentation
index: archive/2026-05-19-api-documentation/.pi-map.index.md
map: archive/2026-05-19-api-documentation/.pi-map.md
- archive/2026-05-19-documentation-overhaul
index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md
map: archive/2026-05-19-documentation-overhaul/.pi-map.md
- archive/2026-05-19-file-editor
index: archive/2026-05-19-file-editor/.pi-map.index.md
map: archive/2026-05-19-file-editor/.pi-map.md
- archive/2026-05-19-git-control
index: archive/2026-05-19-git-control/.pi-map.index.md
map: archive/2026-05-19-git-control/.pi-map.md
- archive/2026-05-19-git-history-visualization
index: archive/2026-05-19-git-history-visualization/.pi-map.index.md
map: archive/2026-05-19-git-history-visualization/.pi-map.md
- archive/2026-05-19-repo-workspace
index: archive/2026-05-19-repo-workspace/.pi-map.index.md
map: archive/2026-05-19-repo-workspace/.pi-map.md
- archive/2026-05-19-responsive-spacing-improvements
index: archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md
map: archive/2026-05-19-responsive-spacing-improvements/.pi-map.md
- archive/2026-05-19-smart-git-url-parsing
index: archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md
map: archive/2026-05-19-smart-git-url-parsing/.pi-map.md
- archive/2026-05-19-tool-instances
index: archive/2026-05-19-tool-instances/.pi-map.index.md
map: archive/2026-05-19-tool-instances/.pi-map.md
- archive/2026-05-19-tool-terminal
index: archive/2026-05-19-tool-terminal/.pi-map.index.md
map: archive/2026-05-19-tool-terminal/.pi-map.md
- archive/2026-05-19-universal-icon-system
index: archive/2026-05-19-universal-icon-system/.pi-map.index.md
map: archive/2026-05-19-universal-icon-system/.pi-map.md
- archive/2026-05-19-workspace-visual-overhaul
index: archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md
map: archive/2026-05-19-workspace-visual-overhaul/.pi-map.md
- archive/2026-05-22-cloudflare-tunnel-instances-superseded
index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md
map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md
- archive/2026-05-22-enforce-single-tool-type-with-port-config
index: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md
map: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md
- archive/2026-05-22-git-repo-ssh-clone-check
index: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md
map: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md
- archive/2026-05-22-git-repo-working-clones
index: archive/2026-05-22-git-repo-working-clones/.pi-map.index.md
map: archive/2026-05-22-git-repo-working-clones/.pi-map.md
- archive/2026-05-22-instance-health-monitoring
index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md
map: archive/2026-05-22-instance-health-monitoring/.pi-map.md
- archive/2026-05-22-instance-proxy
index: archive/2026-05-22-instance-proxy/.pi-map.index.md
map: archive/2026-05-22-instance-proxy/.pi-map.md
- archive/2026-05-22-opencode-web-terminal
index: archive/2026-05-22-opencode-web-terminal/.pi-map.index.md
map: archive/2026-05-22-opencode-web-terminal/.pi-map.md
- archive/2026-05-22-repo-clone-mode-with-ssh
index: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md
map: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md
- archive/2026-05-22-session-management-fixes
index: archive/2026-05-22-session-management-fixes/.pi-map.index.md
map: archive/2026-05-22-session-management-fixes/.pi-map.md
- archive/2026-05-22-sessions-hub
index: archive/2026-05-22-sessions-hub/.pi-map.index.md
map: archive/2026-05-22-sessions-hub/.pi-map.md
- archive/2026-05-22-tool-config-management
index: archive/2026-05-22-tool-config-management/.pi-map.index.md
map: archive/2026-05-22-tool-config-management/.pi-map.md
- archive/2026-05-22-tool-config-ui-rework
index: archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md
map: archive/2026-05-22-tool-config-ui-rework/.pi-map.md
- archive/2026-05-22-tool-workshop
index: archive/2026-05-22-tool-workshop/.pi-map.index.md
map: archive/2026-05-22-tool-workshop/.pi-map.md
- archive/2026-05-22-ui-redesign-home-settings
index: archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md
map: archive/2026-05-22-ui-redesign-home-settings/.pi-map.md
- archive/2026-05-23-remove-built-in-tools
index: archive/2026-05-23-remove-built-in-tools/.pi-map.index.md
map: archive/2026-05-23-remove-built-in-tools/.pi-map.md
- archive/2026-05-24-terminal-startup-and-container-tools
index: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md
map: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md
- archive/2026-05-25-add-config-profiles
index: archive/2026-05-25-add-config-profiles/.pi-map.index.md
map: archive/2026-05-25-add-config-profiles/.pi-map.md
- archive/2026-05-25-mobile-app-usability
index: archive/2026-05-25-mobile-app-usability/.pi-map.index.md
map: archive/2026-05-25-mobile-app-usability/.pi-map.md
- archive/2026-05-25-mobile-pages-overhaul
index: archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md
map: archive/2026-05-25-mobile-pages-overhaul/.pi-map.md
- archive/2026-06-12-completed-changes-archive
index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: archive/2026-06-12-completed-changes-archive/.pi-map.md
## files
## links
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## workflows
-
## dirty
+5 -5
View File
@@ -1,13 +1,13 @@
# openspec/changes/archive
dir: openspec/changes/archive
# archive
dir: archive
index: openspec/changes/archive/.pi-map.index.md
index: archive/.pi-map.index.md
## role
Provides historical archive storage for tracked changes, enabling audit trails and rollback capabilities for OpenSpec documents.
This package provides functionality for creating, reading, and extracting compressed archive files in various formats.
## files
## arch
Append-only immutable storage pattern with timestamp-versioned snapshots, likely using file-based or object-store backend with content-addressable indexing for deduplication.
The package uses a modular, format-agnostic interface pattern where a generic Archive type wraps format-specific implementations (tar, zip, etc.) with unified read/write/extract operations, supported by internal helper packages for each archive format.
## tags
-
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration
# archive/2025-05-17-oauth-traefik-integration (index)
dir: archive/2025-05-17-oauth-traefik-integration
## role
This package contains planning and design documents for integrating OAuth/Authentik authentication with Traefik reverse proxy deployment into a Docker-based application.
Designs and tracks the integration of a Docker-based application with Traefik reverse proxy and Authentik OAuth through environment-based configuration externalization.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
- archive/2025-05-17-oauth-traefik-integration/specs
index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration
# archive/2025-05-17-oauth-traefik-integration
dir: archive/2025-05-17-oauth-traefik-integration
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
## role
This package contains planning and design documents for integrating OAuth/Authentik authentication with Traefik reverse proxy deployment into a Docker-based application.
Designs and tracks the integration of a Docker-based application with Traefik reverse proxy and Authentik OAuth through environment-based configuration externalization.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- design.md | Design document for making a Docker-based application deployable behind an existing Traefik reverse proxy by removing hardcoded URLs and adding environment-based configuration | dep: Docker, Docker Compose, Traefik, Authentik, Python (config.py, auth.py), Vite (frontend)
- proposal.md | Proposes architectural changes to externalize Authentik/domain configuration to environment variables and add Traefik reverse proxy deployment support.
- tasks.md | A task tracking document for externalizing authentication/domain configuration, creating Traefik deployment, updating frontend config, and running verification tests.
## arch
Specification-driven development using OpenAPI metadata, with task-driven implementation planning focused on environment-based configuration externalization and reverse proxy integration patterns.
Documentation-driven design process using markdown specifications with phased task tracking, focusing on 12-factor app configuration principles (env vars over hardcoded values) and reverse proxy deployment patterns.
## tags
traefik, design, configuration, .openspec, document, docker, reverse, proxy
## symbols
@@ -1,25 +1,25 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
# archive/2025-05-17-oauth-traefik-integration/specs (index)
dir: archive/2025-05-17-oauth-traefik-integration/specs
## role
Contains specification documents for OAuth-Traefik integration architecture implemented on 2025-05-17, serving as archived design reference for the project's authentication/authorization infrastructure.
Contains specification documents for OAuth-Traefik integration design.
## parent
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/.pi-map.md
## children
- openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md
- openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md
- openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md
- archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
index: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md
- archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
index: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md
- archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
index: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
# archive/2025-05-17-oauth-traefik-integration/specs
dir: archive/2025-05-17-oauth-traefik-integration/specs
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
## role
Contains specification documents for OAuth-Traefik integration architecture implemented on 2025-05-17, serving as archived design reference for the project's authentication/authorization infrastructure.
Contains specification documents for OAuth-Traefik integration design.
## files
## arch
Specification-driven architecture using archived dated design documents for reverse-proxy-based OAuth integration, likely detailing Traefik middleware configuration patterns for external authentication providers.
Documentation-only package with no code architecture; stores technical specifications and design documents.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
# archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth (index)
dir: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
## role
Defines authentication specifications for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies.
Defines OAuth2/OIDC authentication requirements using Authentik with session security via httpOnly cookies for the Traefik integration project.
## parent
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
# archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
dir: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
index: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
## role
Defines authentication specifications for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies.
Defines OAuth2/OIDC authentication requirements using Authentik with session security via httpOnly cookies for the Traefik integration project.
## files
- spec.md | Specifies modified requirements for OAuth2/OIDC authentication via Authentik and session security with httpOnly cookies | dep: Authentik, Traefik, OAuth2, OIDC
## arch
Specification-driven design using markdown-based requirements documentation for external identity provider integration and browser security patterns.
Specification-driven requirements document using markdown-based technical specification pattern with security-focused authentication flow definitions.
## tags
oauth2, oidc, authentik, spec, specifies, modified, requirements, authentication
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
# archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure (index)
dir: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
## role
Defines Docker infrastructure requirements for OAuth-Traefik integration using behavior-driven specification examples.
Defines Docker infrastructure requirements and environment configuration specifications for the OAuth-Traefik integration project using behavior-driven examples.
## parent
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
# archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
dir: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
index: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
## role
Defines Docker infrastructure requirements for OAuth-Traefik integration using behavior-driven specification examples.
Defines Docker infrastructure requirements and environment configuration specifications for the OAuth-Traefik integration project using behavior-driven examples.
## files
- spec.md | Defines modified requirements for Docker Compose setup and environment configuration using specification by example (Gherkin-style scenarios) | dep: Docker Compose, Traefik
## arch
Specification-by-example pattern with Gherkin-style scenarios for declarative infrastructure requirements, separating environment configuration concerns from implementation details.
Specification-by-example pattern with Gherkin-style scenarios documenting Docker Compose setup requirements as executable documentation.
## tags
spec, defines, modified, requirements, docker, compose, setup, environment
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
# archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment (index)
dir: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
## role
Defines infrastructure deployment specifications for Traefik reverse proxy with OAuth integration
Defines deployment specifications for Traefik reverse proxy integration with OAuth authentication services
## parent
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md
index: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
map: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
# archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
dir: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
index: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
## role
Defines infrastructure deployment specifications for Traefik reverse proxy with OAuth integration
Defines deployment specifications for Traefik reverse proxy integration with OAuth authentication services
## files
- spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC
## arch
Markdown-based specification document using declarative configuration patterns for Docker Compose orchestration with environment-driven configuration management
Infrastructure-as-documentation pattern using Markdown specification files for declarative container orchestration configuration
## tags
traefik, spec, specifies, requirements, docker, compose, deployment, configuration
## symbols
@@ -1,15 +1,15 @@
# openspec/changes/archive/2025-05-17-user-profile (index)
dir: openspec/changes/archive/2025-05-17-user-profile
# archive/2025-05-17-user-profile (index)
dir: archive/2025-05-17-user-profile
## role
Contains archived specification documents for a 2025 user profile feature implementation, capturing design proposals, task tracking, and documentation for an authenticated profile read/update flow with avatar upload.
Archive of planning and design documents for an authenticated user profile management feature implementation.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-17-user-profile/specs
index: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md
- archive/2025-05-17-user-profile/specs
index: archive/2025-05-17-user-profile/specs/.pi-map.index.md
map: archive/2025-05-17-user-profile/specs/.pi-map.md
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: openspec/changes/archive/.pi-map.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/.pi-map.md
index: archive/2025-05-17-user-profile/.pi-map.index.md
map: archive/2025-05-17-user-profile/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# openspec/changes/archive/2025-05-17-user-profile
dir: openspec/changes/archive/2025-05-17-user-profile
# archive/2025-05-17-user-profile
dir: archive/2025-05-17-user-profile
index: openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md
index: archive/2025-05-17-user-profile/.pi-map.index.md
## role
Contains archived specification documents for a 2025 user profile feature implementation, capturing design proposals, task tracking, and documentation for an authenticated profile read/update flow with avatar upload.
Archive of planning and design documents for an authenticated user profile management feature implementation.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- README.md | Documents the implementation of an authenticated user profile read/update flow across API and frontend
@@ -12,7 +12,7 @@ Contains archived specification documents for a 2025 user profile feature implem
- proposal.md | Proposes implementing authenticated user profile management with read/update endpoints, frontend page, and avatar upload functionality. | dep: apps/api/src/api/, apps/web/src/, auth-oauth, User model
- tasks.md | Tracks implementation tasks for a user profile feature across backend API and frontend, with completion status and follow-up notes.
## arch
Documentation-driven specification archive using lightweight YAML metadata, markdown-based design docs (proposal → design → tasks → README progression), and OpenAPI schema conventions for cross-stack (backend API + frontend) feature planning.
Specification-driven development using OpenAPI standards, with phased task tracking across backend API and frontend layers.
## tags
api, user, profile, frontend, design, tasks, .openspec, implementation
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2025-05-17-user-profile/specs (index)
dir: openspec/changes/archive/2025-05-17-user-profile/specs
# archive/2025-05-17-user-profile/specs (index)
dir: archive/2025-05-17-user-profile/specs
## role
Contains archived user profile specification documents from a specific date snapshot in the OpenSpec changes tracking system.
Contains specification documents for the user profile feature that was archived on May 17, 2025.
## parent
index: openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/.pi-map.md
index: archive/2025-05-17-user-profile/.pi-map.index.md
map: archive/2025-05-17-user-profile/.pi-map.md
## children
- openspec/changes/archive/2025-05-17-user-profile/specs/user-profile
index: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md
- archive/2025-05-17-user-profile/specs/user-profile
index: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
map: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md
index: archive/2025-05-17-user-profile/specs/.pi-map.index.md
map: archive/2025-05-17-user-profile/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-17-user-profile/specs
dir: openspec/changes/archive/2025-05-17-user-profile/specs
# archive/2025-05-17-user-profile/specs
dir: archive/2025-05-17-user-profile/specs
index: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md
index: archive/2025-05-17-user-profile/specs/.pi-map.index.md
## role
Contains archived user profile specification documents from a specific date snapshot in the OpenSpec changes tracking system.
Contains specification documents for the user profile feature that was archived on May 17, 2025.
## files
## arch
Simple directory-based archival storage using date-scoped namespacing (YYYY-MM-DD-feature) for immutable specification snapshots with no active code architecture.
N/A (no code files present; directory contains only archived specification documents)
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-17-user-profile/specs/user-profile (index)
dir: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile
# archive/2025-05-17-user-profile/specs/user-profile (index)
dir: archive/2025-05-17-user-profile/specs/user-profile
## role
Defines functional specifications for a user profile management system including profile retrieval, updates, and local avatar storage.
Defines functional specifications for user profile management capabilities including profile data operations and avatar handling
## parent
index: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md
index: archive/2025-05-17-user-profile/specs/.pi-map.index.md
map: archive/2025-05-17-user-profile/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
map: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md
index: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
map: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-17-user-profile/specs/user-profile
dir: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile
# archive/2025-05-17-user-profile/specs/user-profile
dir: archive/2025-05-17-user-profile/specs/user-profile
index: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
index: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
## role
Defines functional specifications for a user profile management system including profile retrieval, updates, and local avatar storage.
Defines functional specifications for user profile management capabilities including profile data operations and avatar handling
## files
- spec.md | Defines functional specifications for a user profile management system including profile retrieval, updates, and local avatar storage | dep: auth-oauth, User database model, pytest, mypy, ruff, npm/typecheck, npm/lint
## arch
Specification-driven design using markdown-based documentation with date-versioned archiving for change tracking.
Specification-driven design using markdown-based requirements documentation with modular feature decomposition (retrieval, updates, local storage)
## tags
profile, npm, spec, defines, functional, specifications, user, management
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2025-05-18-git-repo-management (index)
dir: openspec/changes/archive/2025-05-18-git-repo-management
# archive/2025-05-18-git-repo-management (index)
dir: archive/2025-05-18-git-repo-management
## role
Defines a git repository management feature specification for creating, listing, cloning, and deleting bare git repositories within projects.
Proposes and designs a git repository management feature for projects, including bare repo creation, listing, cloning, and deletion across backend and frontend.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-git-repo-management/specs
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md
- archive/2025-05-18-git-repo-management/specs
index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md
index: archive/2025-05-18-git-repo-management/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2025-05-18-git-repo-management
dir: openspec/changes/archive/2025-05-18-git-repo-management
# archive/2025-05-18-git-repo-management
dir: archive/2025-05-18-git-repo-management
index: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md
index: archive/2025-05-18-git-repo-management/.pi-map.index.md
## role
Defines a git repository management feature specification for creating, listing, cloning, and deleting bare git repositories within projects.
Proposes and designs a git repository management feature for projects, including bare repo creation, listing, cloning, and deletion across backend and frontend.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document specifying a bare git repository management system for projects with create/list/clone/delete operations | dep: git, filesystem, database, API, Dockerfile
- proposal.md | Proposes a feature to add git repository creation, cloning, and management capabilities within existing projects | dep: project-management, git, backend API, frontend UI, disk storage
- tasks.md | Project task checklist tracking implementation of a Git repository management feature across backend API, frontend UI, and project integration with verification steps.
## arch
Specification-driven development using OpenSpec schema with phased task tracking (backend API → frontend UI → project integration) across design/proposal/task documents.
Specification-driven development using OpenSpec schema configuration, phased task tracking with verification gates, and layered documentation (proposal → design → implementation tasks).
## tags
git, management, design, repository, project, creation, .openspec, projects
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2025-05-18-git-repo-management/specs (index)
dir: openspec/changes/archive/2025-05-18-git-repo-management/specs
# archive/2025-05-18-git-repo-management/specs (index)
dir: archive/2025-05-18-git-repo-management/specs
## role
Contains dated specification documents for git repository management features planned in the OpenSpec project.
Defines specifications and requirements for git repository management functionality.
## parent
index: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md
index: archive/2025-05-18-git-repo-management/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md
- archive/2025-05-18-git-repo-management/specs/git-repo-management
index: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md
index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-18-git-repo-management/specs
dir: openspec/changes/archive/2025-05-18-git-repo-management/specs
# archive/2025-05-18-git-repo-management/specs
dir: archive/2025-05-18-git-repo-management/specs
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
## role
Contains dated specification documents for git repository management features planned in the OpenSpec project.
Defines specifications and requirements for git repository management functionality.
## files
## arch
Time-based archival directory structure using ISO date prefixes for historical spec tracking and change management.
Specification-driven development with structured documentation files (likely markdown or similar) capturing functional requirements, API contracts, and behavioral expectations for the git repo management system.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management (index)
dir: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management
# archive/2025-05-18-git-repo-management/specs/git-repo-management (index)
dir: archive/2025-05-18-git-repo-management/specs/git-repo-management
## role
Defines software requirements for a Git repository management system with CRUD and cascade deletion operations.
Defines functional requirements for a Git repository management system supporting CRUD operations with cascade deletion capabilities.
## parent
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md
index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md
index: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
map: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management
dir: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management
# archive/2025-05-18-git-repo-management/specs/git-repo-management
dir: archive/2025-05-18-git-repo-management/specs/git-repo-management
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
index: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
## role
Defines software requirements for a Git repository management system with CRUD and cascade deletion operations.
Defines functional requirements for a Git repository management system supporting CRUD operations with cascade deletion capabilities.
## files
- spec.md | This file specifies software requirements for a Git repository management system, including creation, cloning, listing, deletion, and cascade deletion features. | dep: git, database, filesystem, HTTP API
## arch
Specification-driven architecture using Markdown-based requirements documents following a dated archival structure.
Specification-driven design using a single markdown-based requirements document without explicit architectural patterns.
## tags
git, deletion, spec, specifies, software, requirements, repository, management
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2025-05-18-ssh-key-management (index)
dir: openspec/changes/archive/2025-05-18-ssh-key-management
# archive/2025-05-18-ssh-key-management (index)
dir: archive/2025-05-18-ssh-key-management
## role
Archive directory preserving the completed implementation plan for a full-stack SSH key management feature with Ed25519 key generation, encrypted storage, and git provider integration.
Implements a full-stack SSH key management feature for secure Ed25519 key generation, encrypted storage, and git operations with external providers.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-ssh-key-management/specs
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md
- archive/2025-05-18-ssh-key-management/specs
index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md
index: archive/2025-05-18-ssh-key-management/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2025-05-18-ssh-key-management
dir: openspec/changes/archive/2025-05-18-ssh-key-management
# archive/2025-05-18-ssh-key-management
dir: archive/2025-05-18-ssh-key-management
index: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md
index: archive/2025-05-18-ssh-key-management/.pi-map.index.md
## role
Archive directory preserving the completed implementation plan for a full-stack SSH key management feature with Ed25519 key generation, encrypted storage, and git provider integration.
Implements a full-stack SSH key management feature for secure Ed25519 key generation, encrypted storage, and git operations with external providers.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for implementing an API and UI to manage Ed25519 SSH keys with encrypted private key storage | dep: cryptography (Fernet, Ed25519), database/SSHKey model, frontend UI components, JWT_SECRET (for Fernet key derivation)
- proposal.md | Proposes adding SSH key management functionality (backend API, frontend UI, and Ed25519 key generation with encryption) to enable git operations with external providers. | dep: FastAPI (implied by router pattern), Fernet encryption, Ed25519 cryptography, React/Vue frontend (implied by web app), existing SSHKey model
- tasks.md | A completed task checklist documenting the implementation of a full-stack SSH key management feature with backend API, frontend UI, and verification steps. | dep: FastAPI, cryptography, Pydantic, React, React Router, npm, pytest, ruff, mypy
## arch
Specification-driven development using OpenSpec schema configuration with phased design-proposal-tasks workflow, documenting a full-stack feature from requirements through implementation verification.
Clean documentation-driven architecture using OpenSpec schema configuration, phased implementation (proposal → design → tasks), with separated backend API and frontend UI concerns and encrypted private key security pattern.
## tags
key, design, api, ssh, .openspec, ed25519, management, backend
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2025-05-18-ssh-key-management/specs (index)
dir: openspec/changes/archive/2025-05-18-ssh-key-management/specs
# archive/2025-05-18-ssh-key-management/specs (index)
dir: archive/2025-05-18-ssh-key-management/specs
## role
Defines specifications for SSH key management features added to the OpenSpec project on 2025-05-18.
Contains archived specifications for SSH key management features from May 18, 2025.
## parent
index: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md
index: archive/2025-05-18-ssh-key-management/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md
- archive/2025-05-18-ssh-key-management/specs/ssh-key-management
index: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md
index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-18-ssh-key-management/specs
dir: openspec/changes/archive/2025-05-18-ssh-key-management/specs
# archive/2025-05-18-ssh-key-management/specs
dir: archive/2025-05-18-ssh-key-management/specs
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
## role
Defines specifications for SSH key management features added to the OpenSpec project on 2025-05-18.
Contains archived specifications for SSH key management features from May 18, 2025.
## files
## arch
Specification-driven architecture using dated archival organization for tracking API/schema changes over time.
Document-based specification storage with date-versioned archiving pattern for historical feature planning documents.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management (index)
dir: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management
# archive/2025-05-18-ssh-key-management/specs/ssh-key-management (index)
dir: archive/2025-05-18-ssh-key-management/specs/ssh-key-management
## role
Defines functional requirements for SSH key lifecycle management operations in the OpenSpec project.
Defines functional requirements and acceptance criteria for SSH key lifecycle management operations.
## parent
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md
index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md
index: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
map: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management
dir: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management
# archive/2025-05-18-ssh-key-management/specs/ssh-key-management
dir: archive/2025-05-18-ssh-key-management/specs/ssh-key-management
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
index: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
## role
Defines functional requirements for SSH key lifecycle management operations in the OpenSpec project.
Defines functional requirements and acceptance criteria for SSH key lifecycle management operations.
## files
- spec.md | Defines requirements for SSH key management functionality including generation, listing, display, and deletion
## arch
Specification-driven design using Markdown-based requirements documents with structured feature definitions for generation, listing, display, and deletion operations.
Specification-driven design using structured requirements documentation with use-case based organization (generate, list, show, delete) and explicit acceptance criteria.
## tags
spec, defines, requirements, ssh, key, management, functionality, including
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements
# archive/2025-05-18-test-infrastructure-improvements (index)
dir: archive/2025-05-18-test-infrastructure-improvements
## role
Documents a completed test infrastructure modernization initiative that restructured a backend API project's testing into unit/integration/system tiers with multi-database support and E2E coverage.
Contains design documents, proposals, and task tracking for a test infrastructure restructuring initiative that was archived after completion.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
- archive/2025-05-18-test-infrastructure-improvements/specs
index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements
# archive/2025-05-18-test-infrastructure-improvements
dir: archive/2025-05-18-test-infrastructure-improvements
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
## role
Documents a completed test infrastructure modernization initiative that restructured a backend API project's testing into unit/integration/system tiers with multi-database support and E2E coverage.
Contains design documents, proposals, and task tracking for a test infrastructure restructuring initiative that was archived after completion.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | This file documents the design and migration plan for restructuring a test suite into unit, integration, and system categories with shared fixtures, SQLite/PostgreSQL separation, and E2E coverage. | dep: pytest, pytest-asyncio, SQLite, PostgreSQL, Playwright, Docker, React/Vite, asyncpg, pytest-xdist
- proposal.md | Proposes a comprehensive restructuring of test infrastructure to separate unit/integration/system tests, add shared fixtures, enable SQLite for unit tests, implement transaction rollback isolation, and introduce Playwright E2E testing. | dep: pytest, PostgreSQL, SQLite, Playwright, python-jose, docker, Makefile
- tasks.md | Project task list tracking completed testing infrastructure improvements for a backend API project including test restructuring, shared fixtures, multi-database support, E2E setup, and documentation. | dep: pytest, pytest-asyncio, SQLAlchemy, aiosqlite, PostgreSQL, Playwright, python-jose, TestClient, Makefile
## arch
Specification-driven change management using OpenSpec metadata with design-proposal-tasks workflow; test architecture follows layered pyramid pattern (unit/SQLite, integration/PostgreSQL, system/E2E with Playwright) employing shared fixtures and transaction rollback isolation.
Documentation-driven planning pattern with structured design docs (design.md, proposal.md) preceding implementation, tracked via task lists, using OpenSpec for schema metadata and following a test pyramid architecture (unit/integration/system/E2E tiers with shared fixtures and database isolation).
## tags
pytest, sqlite, postgresql, playwright, design, restructuring, test, unit
## symbols
@@ -1,25 +1,25 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
# archive/2025-05-18-test-infrastructure-improvements/specs (index)
dir: archive/2025-05-18-test-infrastructure-improvements/specs
## role
Contains specification documents for test infrastructure improvements planned for implementation on May 18, 2025.
Contains specification documents for test infrastructure improvements planned or implemented on 2025-05-18.
## parent
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md
- openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md
- openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md
- archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
index: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md
- archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
index: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md
- archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
index: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
# archive/2025-05-18-test-infrastructure-improvements/specs
dir: archive/2025-05-18-test-infrastructure-improvements/specs
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
## role
Contains specification documents for test infrastructure improvements planned for implementation on May 18, 2025.
Contains specification documents for test infrastructure improvements planned or implemented on 2025-05-18.
## files
## arch
Document-based specification storage using dated archival directories with descriptive naming conventions for tracking infrastructure change proposals.
Documentation-driven specification pattern with dated archival organization for tracking infrastructure changes over time.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
# archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing (index)
dir: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
## role
Defines end-to-end testing requirements using Playwright and Makefile integration for a software system.
Defines specifications for end-to-end testing infrastructure using Playwright and Makefile integration.
## parent
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
# archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
dir: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
## role
Defines end-to-end testing requirements using Playwright and Makefile integration for a software system.
Defines specifications for end-to-end testing infrastructure using Playwright and Makefile integration.
## files
- spec.md | Defines requirements for end-to-end testing with Playwright and Makefile test targets for a software system. | dep: Playwright, Makefile, test database
## arch
Specification-driven testing architecture with browser automation (Playwright) and build-tool orchestration (Makefile targets).
Specification-driven testing architecture with browser automation (Playwright) and build system (Makefile) orchestration for test execution.
## tags
end, playwright, makefile, spec, defines, requirements, testing, test
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
# archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation (index)
dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
## role
Defines requirements for shared test fixtures and transaction isolation in a testing infrastructure
Defines specifications for test isolation mechanisms ensuring clean, independent test execution through shared fixtures and transaction management.
## parent
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
# archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
## role
Defines requirements for shared test fixtures and transaction isolation in a testing infrastructure
Defines specifications for test isolation mechanisms ensuring clean, independent test execution through shared fixtures and transaction management.
## files
- spec.md | Defines requirements for shared test fixtures and transaction isolation in a testing infrastructure | dep: pytest, SQLAlchemy, TestClient, SQLite, PostgreSQL
## arch
Specification-driven requirements documentation using markdown-based spec files with no implemented code
Specification-driven design using requirement documents to define behavioral contracts for test infrastructure components.
## tags
spec, defines, requirements, shared, test, fixtures, transaction, isolation
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
# archive/2025-05-18-test-infrastructure-improvements/specs/test-organization (index)
dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
## role
Defines test categorization requirements using pytest markers for backend unit, integration, and system tests.
Defines testing standards for categorizing backend tests by scope using pytest markers
## parent
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
map: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
# archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
index: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
## role
Defines test categorization requirements using pytest markers for backend unit, integration, and system tests.
Defines testing standards for categorizing backend tests by scope using pytest markers
## files
- spec.md | Defines requirements for organizing backend tests into unit, integration, and system categories with pytest markers | dep: pytest, pyproject.toml, apps/api/tests/
## arch
Specification-driven testing architecture using pytest marker-based test organization with three-tier categorization (unit/integration/system).
Specification-driven testing strategy with hierarchical test classification (unit/integration/system) and marker-based test selection
## tags
tests, pytest, spec, defines, requirements, organizing, backend, unit
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2025-05-18-tool-types-definition (index)
dir: openspec/changes/archive/2025-05-18-tool-types-definition
# archive/2025-05-18-tool-types-definition (index)
dir: archive/2025-05-18-tool-types-definition
## role
Archive directory containing design documents and planning artifacts for a ToolType feature that enables defining and launching development tools via Docker Compose templates.
Design and planning package for a ToolType system that enables defining and launching development tools via Docker Compose templates.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-tool-types-definition/specs
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md
- archive/2025-05-18-tool-types-definition/specs
index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md
index: archive/2025-05-18-tool-types-definition/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2025-05-18-tool-types-definition
dir: openspec/changes/archive/2025-05-18-tool-types-definition
# archive/2025-05-18-tool-types-definition
dir: archive/2025-05-18-tool-types-definition
index: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md
index: archive/2025-05-18-tool-types-definition/.pi-map.index.md
## role
Archive directory containing design documents and planning artifacts for a ToolType feature that enables defining and launching development tools via Docker Compose templates.
Design and planning package for a ToolType system that enables defining and launching development tools via Docker Compose templates.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for implementing a ToolType system that defines development tools via Docker Compose templates with variable substitution | dep: Docker Compose, Jinja2, Alembic, database, API framework, frontend
- proposal.md | Defines a feature proposal for implementing a tool type system with Docker Compose template support to enable launching development tool instances | dep: SQLAlchemy, Docker Compose, apps/api/src/api/tool_types.py, apps/web/src/pages/tool-types.tsx
- tasks.md | Tracks completed development tasks for implementing a ToolType CRUD feature across backend API, frontend UI, and database migration | dep: SQLAlchemy, Alembic, FastAPI, Pydantic, React/TypeScript, pytest, ruff, mypy, npm
## arch
Specification-driven development with phased implementation tracking, using markdown-based design docs (proposal → design → tasks) and OpenSpec schema configuration for a Docker Compose template system with variable substitution.
Documentation-driven design pattern with structured specification files (OpenSpec config, design doc, proposal, task tracking) preceding implementation.
## tags
defines, design, implementing, development, proposal, tool, api, tasks
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2025-05-18-tool-types-definition/specs (index)
dir: openspec/changes/archive/2025-05-18-tool-types-definition/specs
# archive/2025-05-18-tool-types-definition/specs (index)
dir: archive/2025-05-18-tool-types-definition/specs
## role
Contains historical specification snapshots documenting the evolution of tool type definitions from May 18, 2025.
Contains specification documents defining tool types and their interfaces for the project.
## parent
index: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md
index: archive/2025-05-18-tool-types-definition/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md
- archive/2025-05-18-tool-types-definition/specs/tool-types-definition
index: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md
index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-18-tool-types-definition/specs
dir: openspec/changes/archive/2025-05-18-tool-types-definition/specs
# archive/2025-05-18-tool-types-definition/specs
dir: archive/2025-05-18-tool-types-definition/specs
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
## role
Contains historical specification snapshots documenting the evolution of tool type definitions from May 18, 2025.
Contains specification documents defining tool types and their interfaces for the project.
## files
## arch
Versioned archive pattern using date-stamped directories to preserve immutable spec revisions for auditability and rollback.
Documentation-driven specification pattern using structured definition files to establish contracts before implementation.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition (index)
dir: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition
# archive/2025-05-18-tool-types-definition/specs/tool-types-definition (index)
dir: archive/2025-05-18-tool-types-definition/specs/tool-types-definition
## role
Defines requirements for a ToolType management system that enables CRUD operations and Docker Compose template validation with variable substitution.
Defines specifications for a ToolType management system that enables CRUD operations and Docker Compose template validation with variable substitution.
## parent
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md
index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md
index: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
map: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition
dir: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition
# archive/2025-05-18-tool-types-definition/specs/tool-types-definition
dir: archive/2025-05-18-tool-types-definition/specs/tool-types-definition
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
index: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
## role
Defines requirements for a ToolType management system that enables CRUD operations and Docker Compose template validation with variable substitution.
Defines specifications for a ToolType management system that enables CRUD operations and Docker Compose template validation with variable substitution.
## files
- spec.md | Define requirements for a ToolType management system with CRUD API, Docker Compose template validation, and variable substitution | dep: REST API, Docker Compose, YAML parser, UUID, authentication/authorization system
## arch
Specification-driven requirements document using Markdown-based specification format with sections for overview, functional requirements, non-functional requirements, and API definitions.
Specification-driven architecture using markdown-based requirements documentation to define system behavior before implementation.
## tags
spec, define, requirements, tooltype, management, system, crud, api
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2025-05-18-user-config-management (index)
dir: openspec/changes/archive/2025-05-18-user-config-management
# archive/2025-05-18-user-config-management (index)
dir: archive/2025-05-18-user-config-management
## role
Design and planning package for a JSONB-backed user configuration management feature
Archive directory containing historical design documents and planning artifacts for a user configuration management feature that was proposed but not yet implemented.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-user-config-management/specs
index: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md
- archive/2025-05-18-user-config-management/specs
index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md
map: archive/2025-05-18-user-config-management/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md
index: archive/2025-05-18-user-config-management/.pi-map.index.md
map: archive/2025-05-18-user-config-management/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2025-05-18-user-config-management
dir: openspec/changes/archive/2025-05-18-user-config-management
# archive/2025-05-18-user-config-management
dir: archive/2025-05-18-user-config-management
index: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md
index: archive/2025-05-18-user-config-management/.pi-map.index.md
## role
Design and planning package for a JSONB-backed user configuration management feature
Archive directory containing historical design documents and planning artifacts for a user configuration management feature that was proposed but not yet implemented.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for a simple key-value user configuration system using PostgreSQL JSONB | dep: PostgreSQL, JSONB
- proposal.md | Proposes a feature to add persistent user preference storage and management through a JSONB-backed config system with API endpoints and frontend settings UI. | dep: database, API, frontend, UserConfig model, AppShell
- tasks.md | Project task tracking document for implementing a user settings/config feature with backend API, frontend UI, and verification steps | dep: SQLAlchemy, Alembic, FastAPI/HTTP endpoints, React/frontend router, Docker Compose, ruff, mypy, pytest, TypeScript tooling
## arch
Specification-driven development with phased implementation (proposal → design → tasks), using OpenSpec schema metadata and PostgreSQL JSONB for flexible schema-less storage
Document-driven design with OpenSpec schema definitions, Markdown-based design/proposal/task tracking, and a planned JSONB-backed key-value storage architecture with REST API and frontend UI components.
## tags
design, user, jsonb, api, frontend, configuration, .openspec, document
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2025-05-18-user-config-management/specs (index)
dir: openspec/changes/archive/2025-05-18-user-config-management/specs
# archive/2025-05-18-user-config-management/specs (index)
dir: archive/2025-05-18-user-config-management/specs
## role
Contains archived specification documents for user configuration management features dated May 18, 2025.
Contains archived specification documents for user configuration management features from May 2025.
## parent
index: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md
index: archive/2025-05-18-user-config-management/.pi-map.index.md
map: archive/2025-05-18-user-config-management/.pi-map.md
## children
- openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management
index: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md
- archive/2025-05-18-user-config-management/specs/user-config-management
index: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
map: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md
## files
## links
index: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md
index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md
map: archive/2025-05-18-user-config-management/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2025-05-18-user-config-management/specs
dir: openspec/changes/archive/2025-05-18-user-config-management/specs
# archive/2025-05-18-user-config-management/specs
dir: archive/2025-05-18-user-config-management/specs
index: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md
index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md
## role
Contains archived specification documents for user configuration management features dated May 18, 2025.
Contains archived specification documents for user configuration management features from May 2025.
## files
## arch
Document-based specification storage using date-versioned directory structure with flat file organization for tracking API/schema design decisions.
Documentation-only archive directory with no active code; stores historical design specifications using markdown/plaintext format.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management (index)
dir: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management
# archive/2025-05-18-user-config-management/specs/user-config-management (index)
dir: archive/2025-05-18-user-config-management/specs/user-config-management
## role
Defines technical specifications for a JSONB-based user configuration management system supporting storage, retrieval, and frontend theme application.
Defines technical specifications for a user-configurable theme system with JSONB-based storage and retrieval.
## parent
index: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md
index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md
map: archive/2025-05-18-user-config-management/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
map: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md
index: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
map: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management
dir: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management
# archive/2025-05-18-user-config-management/specs/user-config-management
dir: archive/2025-05-18-user-config-management/specs/user-config-management
index: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
index: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
## role
Defines technical specifications for a JSONB-based user configuration management system supporting storage, retrieval, and frontend theme application.
Defines technical specifications for a user-configurable theme system with JSONB-based storage and retrieval.
## files
- spec.md | Define system requirements for user configuration storage, retrieval, and frontend theme application using JSONB key-value pairs.
## arch
Specification-driven architecture using JSONB key-value pair storage pattern with separation of concerns between data persistence layer and frontend theme consumption.
Specification-driven design using JSONB key-value store pattern for flexible schema-less configuration persistence with frontend theme binding.
## tags
spec, define, system, requirements, user, configuration, storage, retrieval
## symbols
@@ -1,15 +1,15 @@
# openspec/changes/archive/2026-05-17-auth-oauth (index)
dir: openspec/changes/archive/2026-05-17-auth-oauth
# archive/2026-05-17-auth-oauth (index)
dir: archive/2026-05-17-auth-oauth
## role
Archive of a 2026-05-17 design proposal for implementing OAuth2/OIDC authentication with Authentik integration in a backend API.
Archive directory containing design documents and proposals for an OAuth2/OIDC authentication system with Authentik integration and JWT token management.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-17-auth-oauth/specs
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md
- archive/2026-05-17-auth-oauth/specs
index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/specs/.pi-map.md
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: openspec/changes/archive/.pi-map.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md
index: archive/2026-05-17-auth-oauth/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# openspec/changes/archive/2026-05-17-auth-oauth
dir: openspec/changes/archive/2026-05-17-auth-oauth
# archive/2026-05-17-auth-oauth
dir: archive/2026-05-17-auth-oauth
index: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md
index: archive/2026-05-17-auth-oauth/.pi-map.index.md
## role
Archive of a 2026-05-17 design proposal for implementing OAuth2/OIDC authentication with Authentik integration in a backend API.
Archive directory containing design documents and proposals for an OAuth2/OIDC authentication system with Authentik integration and JWT token management.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- README.md | Documents a project that implements OAuth2/OIDC authentication using Authentik with internal JWTs and database-backed refresh tokens | dep: Authentik, OAuth2, OIDC, JWT
@@ -12,7 +12,7 @@ Archive of a 2026-05-17 design proposal for implementing OAuth2/OIDC authenticat
- proposal.md | Proposes a technical implementation plan for adding production-ready OAuth2/OIDC authentication with Authentik integration, JWT session management, and secure token lifecycle handling to a backend API project. | dep: Authentik, OAuth2/OIDC, JWKS, JWT, database, apps/api/src, config, models, auth services, API routes
- tasks.md | Task tracking document for implementing OIDC/JWT authentication system with refresh tokens in a backend application. | dep: SQLAlchemy, Alembic, Authentik OIDC, pytest, ruff, mypy, asyncpg, PostgreSQL
## arch
Specification-driven design documentation using OpenAPI metadata, with phased implementation planning (proposal → design → tasks → README) for a hybrid token architecture (JWT access tokens + opaque DB-backed refresh tokens) with environment-aware security policies.
Document-driven design specification using markdown-based RFCs, with OpenAPI metadata, separating concerns into design rationale (design.md), implementation planning (proposal.md), task tracking (tasks.md), and project documentation (README.md).
## tags
oidc, authentik, oauth2, jwt, authentication, tokens, refresh, design
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2026-05-17-auth-oauth/specs (index)
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs
# archive/2026-05-17-auth-oauth/specs (index)
dir: archive/2026-05-17-auth-oauth/specs
## role
Contains archived OpenAPI specification files for an OAuth authentication feature change from May 17, 2026, serving as versioned documentation snapshots in the API specification change tracking system.
Contains historical specification documents for the OAuth authentication implementation from May 2026, serving as archived design reference.
## parent
index: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md
index: archive/2026-05-17-auth-oauth/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/.pi-map.md
## children
- openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md
- archive/2026-05-17-auth-oauth/specs/auth-oauth
index: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md
## files
## links
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md
index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2026-05-17-auth-oauth/specs
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs
# archive/2026-05-17-auth-oauth/specs
dir: archive/2026-05-17-auth-oauth/specs
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
## role
Contains archived OpenAPI specification files for an OAuth authentication feature change from May 17, 2026, serving as versioned documentation snapshots in the API specification change tracking system.
Contains historical specification documents for the OAuth authentication implementation from May 2026, serving as archived design reference.
## files
## arch
Flat directory structure with dated, feature-named archival folders using a timestamped naming convention (YYYY-MM-DD-{feature}) to preserve immutable specification versions for historical reference and auditability.
Documentation-only archive with no active code; likely contains markdown/ADR-style specification files capturing past architectural decisions for external authentication provider integration.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth (index)
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
# archive/2026-05-17-auth-oauth/specs/auth-oauth (index)
dir: archive/2026-05-17-auth-oauth/specs/auth-oauth
## role
Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider.
Defines authentication requirements for OAuth2/OIDC integration with Authentik identity provider.
## parent
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md
index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md
index: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
map: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
# archive/2026-05-17-auth-oauth/specs/auth-oauth
dir: archive/2026-05-17-auth-oauth/specs/auth-oauth
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
index: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
## role
Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider.
Defines authentication requirements for OAuth2/OIDC integration with Authentik identity provider.
## files
- spec.md | Specifies OAuth2/OIDC authentication, session security, token refresh, and logout requirements for a web application using Authentik as the identity provider. | dep: Authentik, JWKS, OAuth2, OIDC, HTTP cookies, database
## arch
Specification-driven architecture using Markdown-based requirements documentation for security and session management patterns.
Requirements specification document following standard markdown-based spec format with no implemented architecture.
## tags
oauth2, oidc, authentik, spec, specifies, authentication, session, security
## symbols
@@ -1,11 +1,11 @@
# openspec/changes/archive/2026-05-17-database-models (index)
dir: openspec/changes/archive/2026-05-17-database-models
# archive/2026-05-17-database-models (index)
dir: archive/2026-05-17-database-models
## role
Archive of a completed database infrastructure specification for implementing SQLAlchemy 2.0 async ORM models and Alembic migrations for core API entities.
Archive directory containing design documents and proposals for implementing SQLAlchemy 2.0 async database models and Alembic migrations for a PostgreSQL-backed API application.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
-
## files
@@ -15,8 +15,8 @@ map: openspec/changes/archive/.pi-map.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-database-models/.pi-map.md
index: archive/2026-05-17-database-models/.pi-map.index.md
map: archive/2026-05-17-database-models/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# openspec/changes/archive/2026-05-17-database-models
dir: openspec/changes/archive/2026-05-17-database-models
# archive/2026-05-17-database-models
dir: archive/2026-05-17-database-models
index: openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md
index: archive/2026-05-17-database-models/.pi-map.index.md
## role
Archive of a completed database infrastructure specification for implementing SQLAlchemy 2.0 async ORM models and Alembic migrations for core API entities.
Archive directory containing design documents and proposals for implementing SQLAlchemy 2.0 async database models and Alembic migrations for a PostgreSQL-backed API application.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- README.md | Defines a project for implementing SQLAlchemy database models and Alembic migrations for core entities. | dep: SQLAlchemy, Alembic
@@ -12,7 +12,7 @@ Archive of a completed database infrastructure specification for implementing SQ
- proposal.md | Proposes implementing SQLAlchemy 2.0 async database models and Alembic migrations for core entities in the Headquarter platform | dep: SQLAlchemy 2.0, Alembic, asyncpg, pytest, mypy, ruff
- tasks.md | Tracks completed implementation tasks for building a SQLAlchemy-based async database layer with models, migrations, seeding, and testing for an API application. | dep: SQLAlchemy, Alembic, Pydantic-settings, PostgreSQL, pytest, mypy, ruff
## arch
Specification-driven architecture using OpenAPI-style metadata tracking, with phased task-based implementation covering async PostgreSQL SQLAlchemy 2.0 models, Alembic migrations, seeding, and testing patterns.
Document-driven design with OpenAPI specification metadata, structured planning artifacts (proposal/design/tasks), and async SQLAlchemy 2.0 ORM pattern targeting PostgreSQL with Alembic migration management.
## tags
sqlalchemy, alembic, database, defines, models, migrations, design, async
## symbols
@@ -1,15 +1,15 @@
# openspec/changes/archive/2026-05-17-frontend-foundation (index)
dir: openspec/changes/archive/2026-05-17-frontend-foundation
# archive/2026-05-17-frontend-foundation (index)
dir: archive/2026-05-17-frontend-foundation
## role
Archive of a completed frontend foundation specification defining React/TypeScript/Vite application architecture with authentication, routing, and API integration patterns.
Archive of a completed frontend foundation project delivering a React/TypeScript/Vite starter with authentication, routing, and API integration patterns.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-17-frontend-foundation/specs
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md
- archive/2026-05-17-frontend-foundation/specs
index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/specs/.pi-map.md
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: openspec/changes/archive/.pi-map.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md
index: archive/2026-05-17-frontend-foundation/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# openspec/changes/archive/2026-05-17-frontend-foundation
dir: openspec/changes/archive/2026-05-17-frontend-foundation
# archive/2026-05-17-frontend-foundation
dir: archive/2026-05-17-frontend-foundation
index: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md
index: archive/2026-05-17-frontend-foundation/.pi-map.index.md
## role
Archive of a completed frontend foundation specification defining React/TypeScript/Vite application architecture with authentication, routing, and API integration patterns.
Archive of a completed frontend foundation project delivering a React/TypeScript/Vite starter with authentication, routing, and API integration patterns.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- README.md | Defines a project foundation for a frontend application with authentication, routing, and API integration capabilities.
@@ -12,7 +12,7 @@ Archive of a completed frontend foundation specification defining React/TypeScri
- proposal.md | Proposes a frontend foundation for a React/TypeScript web application with authentication, routing, and API integration. | dep: React, TypeScript, Vite, backend auth endpoints (/auth/login, /auth/logout, /auth/me, /auth/refresh)
- tasks.md | Tracks completed frontend development tasks for building an authenticated web application with routing, API integration, and dashboard UI.
## arch
Specification-driven architecture using OpenAPI metadata, layered documentation (proposal → design → tasks), and a modular React/TypeScript/Vite stack with authenticated routing, responsive shell layout, and centralized API client patterns.
Documentation-driven architecture with OpenAPI-first API contract, layered design docs (proposal → design → tasks), and modular React patterns including authenticated route guards, responsive shell layout, and centralized API client abstraction.
## tags
react, frontend, routing, api, typescript, auth, foundation, application
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2026-05-17-frontend-foundation/specs (index)
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs
# archive/2026-05-17-frontend-foundation/specs (index)
dir: archive/2026-05-17-frontend-foundation/specs
## role
Historical archive of frontend foundation specifications from a specific date snapshot
Contains archived specification documents for the frontend foundation project dated May 17, 2026, serving as historical reference for design decisions and requirements.
## parent
index: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md
index: archive/2026-05-17-frontend-foundation/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/.pi-map.md
## children
- openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md
- archive/2026-05-17-frontend-foundation/specs/frontend-foundation
index: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md
## files
## links
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md
index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2026-05-17-frontend-foundation/specs
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs
# archive/2026-05-17-frontend-foundation/specs
dir: archive/2026-05-17-frontend-foundation/specs
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
## role
Historical archive of frontend foundation specifications from a specific date snapshot
Contains archived specification documents for the frontend foundation project dated May 17, 2026, serving as historical reference for design decisions and requirements.
## files
## arch
Flat directory structure with date-versioned specification documents for project documentation tracking
Document-based specification storage using date-versioned directory naming convention for temporal organization of project requirements.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation (index)
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
# archive/2026-05-17-frontend-foundation/specs/frontend-foundation (index)
dir: archive/2026-05-17-frontend-foundation/specs/frontend-foundation
## role
Defines foundational frontend technical specifications for a React 18+ TypeScript web application including routing, authentication, layout, and HTTP client configuration.
Defines technical specifications for a React 18+ TypeScript frontend foundation including routing, auth, layout, and HTTP client patterns.
## parent
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md
index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md
index: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
map: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
# archive/2026-05-17-frontend-foundation/specs/frontend-foundation
dir: archive/2026-05-17-frontend-foundation/specs/frontend-foundation
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
index: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
## role
Defines foundational frontend technical specifications for a React 18+ TypeScript web application including routing, authentication, layout, and HTTP client configuration.
Defines technical specifications for a React 18+ TypeScript frontend foundation including routing, auth, layout, and HTTP client patterns.
## files
- spec.md | This file specifies frontend requirements for a React 18+ TypeScript web application with routing, authentication, layout, and HTTP client configuration. | dep: React 18+, TypeScript 5+, Vite, React Router, Axios/fetch
## arch
Specification-driven architecture using markdown-based requirements documentation with modular concerns separation (routing, auth, layout, HTTP) for a standards-compliant SPA foundation.
Specification-driven architecture with modular concerns (routing, auth, layout, HTTP) documented as requirements for a modern React SPA foundation.
## tags
spec, specifies, frontend, requirements, react, typescript, web, application
## symbols
@@ -1,15 +1,15 @@
# openspec/changes/archive/2026-05-17-project-management (index)
dir: openspec/changes/archive/2026-05-17-project-management
# archive/2026-05-17-project-management (index)
dir: archive/2026-05-17-project-management
## role
Archive directory containing historical specification documents for a full-stack project management feature with authentication, ownership, and SSH key integration.
This package contains archived design documentation and planning artifacts for a project management feature that was implemented with full-stack CRUD operations, ownership enforcement, and SSH key integration.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-17-project-management/specs
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md
- archive/2026-05-17-project-management/specs
index: archive/2026-05-17-project-management/specs/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/.pi-map.md
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: openspec/changes/archive/.pi-map.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/.pi-map.md
index: archive/2026-05-17-project-management/.pi-map.index.md
map: archive/2026-05-17-project-management/.pi-map.md
## workflows
-
## dirty
@@ -1,10 +1,10 @@
# openspec/changes/archive/2026-05-17-project-management
dir: openspec/changes/archive/2026-05-17-project-management
# archive/2026-05-17-project-management
dir: archive/2026-05-17-project-management
index: openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md
index: archive/2026-05-17-project-management/.pi-map.index.md
## role
Archive directory containing historical specification documents for a full-stack project management feature with authentication, ownership, and SSH key integration.
This package contains archived design documentation and planning artifacts for a project management feature that was implemented with full-stack CRUD operations, ownership enforcement, and SSH key integration.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- README.md | Defines a project management application that implements create, read, update, delete, listing, and ownership workflows across API and frontend layers
@@ -12,7 +12,7 @@ Archive directory containing historical specification documents for a full-stack
- proposal.md | Proposes a project management feature implementation covering authenticated CRUD APIs, frontend flows, SSH key integration, and cascading deletion behavior. | dep: authentication, data models, frontend foundation, apps/api/src, apps/web/src
- tasks.md | Tracks completed tasks for implementing full-stack project management features with ownership enforcement and verification checks.
## arch
Specification-driven development using OpenAPI metadata, phased design documents (proposal → design → tasks → README), and cross-layer (API/frontend) CRUD workflow planning with ownership-based access control.
Documentation-driven planning architecture using OpenAPI specification metadata, structured markdown design documents (proposal → design → tasks → README), and explicit separation of API/backend concerns from frontend integration workflows.
## tags
project, frontend, management, ownership, design, tasks, defines, .openspec
## symbols
@@ -1,25 +1,25 @@
# openspec/changes/archive/2026-05-17-project-management/specs (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs
# archive/2026-05-17-project-management/specs (index)
dir: archive/2026-05-17-project-management/specs
## role
Contains archived specification documents for project management features from a specific snapshot date (2026-05-17).
Contains archived specification documents from a project management snapshot dated May 17, 2026.
## parent
index: openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/.pi-map.md
index: archive/2026-05-17-project-management/.pi-map.index.md
map: archive/2026-05-17-project-management/.pi-map.md
## children
- openspec/changes/archive/2026-05-17-project-management/specs/git-repo
index: openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.md
- openspec/changes/archive/2026-05-17-project-management/specs/project-management
index: openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.md
- openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
index: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md
- archive/2026-05-17-project-management/specs/git-repo
index: archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/git-repo/.pi-map.md
- archive/2026-05-17-project-management/specs/project-management
index: archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/project-management/.pi-map.md
- archive/2026-05-17-project-management/specs/ssh-keys
index: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md
## files
## links
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md
index: archive/2026-05-17-project-management/specs/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2026-05-17-project-management/specs
dir: openspec/changes/archive/2026-05-17-project-management/specs
# archive/2026-05-17-project-management/specs
dir: archive/2026-05-17-project-management/specs
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
index: archive/2026-05-17-project-management/specs/.pi-map.index.md
## role
Contains archived specification documents for project management features from a specific snapshot date (2026-05-17).
Contains archived specification documents from a project management snapshot dated May 17, 2026.
## files
## arch
Flat directory structure storing versioned/archived specification files with date-based organizational hierarchy (YYYY-MM-DD-topic format).
Simple archival storage pattern with date-based directory naming for historical spec versioning.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-17-project-management/specs/git-repo (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs/git-repo
# archive/2026-05-17-project-management/specs/git-repo (index)
dir: archive/2026-05-17-project-management/specs/git-repo
## role
Defines requirements for Git repository lifecycle management tied to project deletion events
Specifies requirements for automatic cleanup of associated Git repositories when project management entities are deleted.
## parent
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md
index: archive/2026-05-17-project-management/specs/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.md
index: archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/git-repo/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-17-project-management/specs/git-repo
dir: openspec/changes/archive/2026-05-17-project-management/specs/git-repo
# archive/2026-05-17-project-management/specs/git-repo
dir: archive/2026-05-17-project-management/specs/git-repo
index: openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
index: archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
## role
Defines requirements for Git repository lifecycle management tied to project deletion events
Specifies requirements for automatic cleanup of associated Git repositories when project management entities are deleted.
## files
- spec.md | Defines modified requirements for cascading repository deletion when a project is deleted
## arch
Specification-driven requirements document using markdown-based change tracking for cascading delete operations
Requirements specification document using structured markdown with user stories, acceptance criteria, and behavioral rules for cascade deletion logic.
## tags
spec, defines, modified, requirements, cascading, repository, deletion, project
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-17-project-management/specs/project-management (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs/project-management
# archive/2026-05-17-project-management/specs/project-management (index)
dir: archive/2026-05-17-project-management/specs/project-management
## role
Defines requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management.
Defines modified requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management
## parent
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md
index: archive/2026-05-17-project-management/specs/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.md
index: archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/project-management/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-17-project-management/specs/project-management
dir: openspec/changes/archive/2026-05-17-project-management/specs/project-management
# archive/2026-05-17-project-management/specs/project-management
dir: archive/2026-05-17-project-management/specs/project-management
index: openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
index: archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
## role
Defines requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management.
Defines modified requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management
## files
- spec.md | Defines modified requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management
## arch
Specification-driven design using markdown-based requirements documentation with no explicit architectural patterns defined in the provided file.
Requirements specification document using Markdown format with structured sections for functional requirements, non-functional requirements, and system constraints
## tags
management, spec, defines, modified, requirements, project, system, crud
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
# archive/2026-05-17-project-management/specs/ssh-keys (index)
dir: archive/2026-05-17-project-management/specs/ssh-keys
## role
Defines specification requirements for SSH key management with project-level default key assignment validation rules.
Defines requirements specification for SSH key management with project default key assignment validation
## parent
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md
index: archive/2026-05-17-project-management/specs/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
map: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md
index: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
map: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
dir: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
# archive/2026-05-17-project-management/specs/ssh-keys
dir: archive/2026-05-17-project-management/specs/ssh-keys
index: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
index: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
## role
Defines specification requirements for SSH key management with project-level default key assignment validation rules.
Defines requirements specification for SSH key management with project default key assignment validation
## files
- spec.md | Defines modified requirements for SSH key association with project default-key assignment validation
## arch
Markdown-based specification document using requirement-definition pattern with validation constraints and behavioral rules.
Requirements-as-code pattern using markdown-based specification documents for feature definition
## tags
key, spec, defines, modified, requirements, ssh, association, project
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2026-05-18-database-setup-recovery (index)
dir: openspec/changes/archive/2026-05-18-database-setup-recovery
# archive/2026-05-18-database-setup-recovery (index)
dir: archive/2026-05-18-database-setup-recovery
## role
Archive directory preserving a completed 2026-05-18 specification for database setup and recovery mechanisms in a Dockerized API application.
Archive directory preserving historical design documents for database setup and recovery infrastructure in a Dockerized API application.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-18-database-setup-recovery/specs
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md
- archive/2026-05-18-database-setup-recovery/specs
index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md
index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2026-05-18-database-setup-recovery
dir: openspec/changes/archive/2026-05-18-database-setup-recovery
# archive/2026-05-18-database-setup-recovery
dir: archive/2026-05-18-database-setup-recovery
index: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md
index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md
## role
Archive directory preserving a completed 2026-05-18 specification for database setup and recovery mechanisms in a Dockerized API application.
Archive directory preserving historical design documents for database setup and recovery infrastructure in a Dockerized API application.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document specifying how to implement automatic database migration running, connection retry logic, and graceful error handling on application startup | dep: SQLAlchemy, Alembic, Docker, async context
- proposal.md | Proposes architectural changes for automatic database initialization, migration management, and seed data handling in a Dockerized API application | dep: alembic, docker-compose, traefik, fastapi/sqlalchemy (implied), postgres (implied)
- tasks.md | Project task checklist tracking completion status of database initialization, error handling, Docker integration, and testing work items.
## arch
Specification-driven design using OpenSpec schema metadata, with phased proposal/design/task documentation tracking database initialization, migration management, connection retry logic, and graceful error handling patterns.
Document-driven design archive containing OpenSpec configuration, architectural proposals, and task tracking for implementing resilient database initialization with migrations, connection retry logic, and graceful error handling.
## tags
design, database, handling, docker, .openspec, automatic, migration, error
## symbols
@@ -1,19 +1,19 @@
# openspec/changes/archive/2026-05-18-database-setup-recovery/specs (index)
dir: openspec/changes/archive/2026-05-18-database-setup-recovery/specs
# archive/2026-05-18-database-setup-recovery/specs (index)
dir: archive/2026-05-18-database-setup-recovery/specs
## role
Contains archived database setup and recovery specification documents from May 18, 2026, serving as historical reference for system design decisions.
Contains database setup and recovery specifications from a 2026-05-18 archive snapshot.
## parent
index: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md
index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/.pi-map.md
## children
- openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md
- archive/2026-05-18-database-setup-recovery/specs/database-initialization
index: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md
## files
## links
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md
index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# openspec/changes/archive/2026-05-18-database-setup-recovery/specs
dir: openspec/changes/archive/2026-05-18-database-setup-recovery/specs
# archive/2026-05-18-database-setup-recovery/specs
dir: archive/2026-05-18-database-setup-recovery/specs
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
## role
Contains archived database setup and recovery specification documents from May 18, 2026, serving as historical reference for system design decisions.
Contains database setup and recovery specifications from a 2026-05-18 archive snapshot.
## files
## arch
Simple archival storage pattern using date-based directory hierarchy with flat file organization for immutable specification snapshots.
Specification-driven documentation pattern using date-versioned archival storage for system recovery procedures.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization (index)
dir: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization
# archive/2026-05-18-database-setup-recovery/specs/database-initialization (index)
dir: archive/2026-05-18-database-setup-recovery/specs/database-initialization
## role
Defines behavioral specifications for database initialization and recovery mechanisms using Gherkin-style requirements.
Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios.
## parent
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md
index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/specs/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md
index: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
map: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization
dir: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization
# archive/2026-05-18-database-setup-recovery/specs/database-initialization
dir: archive/2026-05-18-database-setup-recovery/specs/database-initialization
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
index: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
## role
Defines behavioral specifications for database initialization and recovery mechanisms using Gherkin-style requirements.
Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios.
## files
- spec.md | Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios.
## arch
Specification-driven development with BDD (Behavior-Driven Development) patterns using Gherkin syntax for executable requirements documentation.
Behavior-driven specification using Gherkin syntax to define acceptance criteria for database lifecycle operations.
## tags
spec, defines, software, requirements, automatic, database, initialization, connection
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2026-05-18-simplify-authentik-auth (index)
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth
# archive/2026-05-18-simplify-authentik-auth (index)
dir: archive/2026-05-18-simplify-authentik-auth
## role
Contains planning and design documents for migrating authentication from JWT tokens to session-based cookies with Authentik/OAuth2 integration.
Contains historical design documents and planning artifacts for a completed authentication system migration from JWT tokens to session-based cookies with Authentik OAuth2 integration.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md
- archive/2026-05-18-simplify-authentik-auth/specs
index: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
map: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md
index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: archive/2026-05-18-simplify-authentik-auth/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2026-05-18-simplify-authentik-auth
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth
# archive/2026-05-18-simplify-authentik-auth
dir: archive/2026-05-18-simplify-authentik-auth
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
## role
Contains planning and design documents for migrating authentication from JWT tokens to session-based cookies with Authentik/OAuth2 integration.
Contains historical design documents and planning artifacts for a completed authentication system migration from JWT tokens to session-based cookies with Authentik OAuth2 integration.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document for migrating a backend authentication system from JWT tokens to session cookies with OAuth2/Authentik integration | dep: Authentik (OAuth2), Redis (optional), backend database, frontend
- proposal.md | Proposes simplifying an Authentik-based authentication system by replacing JWT/token-based auth with session-based cookies | dep: Authentik, OAuth2, session cookies, database user model, frontend auth state
- tasks.md | Project task list for migrating an application from JWT/OIDC authentication to session-based authentication using Authentik | dep: Authentik, Alembic, python-jose, ruff, mypy, pytest
## arch
Documentation-driven architecture using OpenSpec configuration with structured design docs (design, proposal, tasks) following a formal specification and change-management pattern.
Document-driven design process using OpenSpec schema configuration, structured design/proposal/task documents, and date-based archival organization for tracking architectural decisions and migration planning.
## tags
authentik, authentication, design, jwt, session, .openspec, migrating, system
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs (index)
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
# archive/2026-05-18-simplify-authentik-auth/specs (index)
dir: archive/2026-05-18-simplify-authentik-auth/specs
## role
Defines authentication specification for a simplified OAuth2 integration with Authentik using stateless signed session cookies
Defines technical specifications for a streamlined Authentik-based OAuth2 authentication system with stateless session management
## parent
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md
index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: archive/2026-05-18-simplify-authentik-auth/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md
index: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
map: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
# archive/2026-05-18-simplify-authentik-auth/specs
dir: archive/2026-05-18-simplify-authentik-auth/specs
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
index: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
## role
Defines authentication specification for a simplified OAuth2 integration with Authentik using stateless signed session cookies
Defines technical specifications for a streamlined Authentik-based OAuth2 authentication system with stateless session management
## files
- spec.md | Defines a simplified OAuth2 authentication flow using Authentik with stateless signed session cookies | dep: Authentik, HMAC-SHA256, OAuth2
## arch
Specification-driven design with markdown-based technical documentation for authentication flow requirements
Specification-driven design documenting a stateless authentication architecture using signed JWT cookies to eliminate server-side session storage
## tags
oauth2, authentik, spec, defines, simplified, authentication, flow, stateless
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-19-api-documentation/.openspec (index)
dir: openspec/changes/archive/2026-05-19-api-documentation/.openspec
# archive/2026-05-19-api-documentation/.openspec (index)
dir: archive/2026-05-19-api-documentation/.openspec
## role
Defines a schema-driven API documentation specification configuration for the OpenSpec changes archive.
Defines a schema-driven API documentation specification configuration for the OpenSpec standard
## parent
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md
index: archive/2026-05-19-api-documentation/.pi-map.index.md
map: archive/2026-05-19-api-documentation/.pi-map.md
## children
-
## files
- config.yaml
## links
index: openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.md
index: archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
map: archive/2026-05-19-api-documentation/.openspec/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-19-api-documentation/.openspec
dir: openspec/changes/archive/2026-05-19-api-documentation/.openspec
# archive/2026-05-19-api-documentation/.openspec
dir: archive/2026-05-19-api-documentation/.openspec
index: openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
index: archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
## role
Defines a schema-driven API documentation specification configuration for the OpenSpec changes archive.
Defines a schema-driven API documentation specification configuration for the OpenSpec standard
## files
- config.yaml | Defines a configuration file specifying a schema-driven API documentation specification
## arch
YAML-based declarative configuration pattern specifying schema metadata for API documentation generation.
YAML-based declarative configuration pattern for specifying API documentation metadata and schema references
## tags
config, defines, configuration, specifying, schema, driven, api, documentation
## symbols
@@ -1,25 +1,25 @@
# openspec/changes/archive/2026-05-19-api-documentation (index)
dir: openspec/changes/archive/2026-05-19-api-documentation
# archive/2026-05-19-api-documentation (index)
dir: archive/2026-05-19-api-documentation
## role
Planning and design documents for a comprehensive API documentation improvement initiative targeting a FastAPI-based application.
Archive of planning documents for a FastAPI API documentation improvement initiative, now superseded/historical.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-19-api-documentation/.openspec
index: openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.md
- openspec/changes/archive/2026-05-19-api-documentation/specs
index: openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.md
- archive/2026-05-19-api-documentation/.openspec
index: archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
map: archive/2026-05-19-api-documentation/.openspec/.pi-map.md
- archive/2026-05-19-api-documentation/specs
index: archive/2026-05-19-api-documentation/specs/.pi-map.index.md
map: archive/2026-05-19-api-documentation/specs/.pi-map.md
## files
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md
index: archive/2026-05-19-api-documentation/.pi-map.index.md
map: archive/2026-05-19-api-documentation/.pi-map.md
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# openspec/changes/archive/2026-05-19-api-documentation
dir: openspec/changes/archive/2026-05-19-api-documentation
# archive/2026-05-19-api-documentation
dir: archive/2026-05-19-api-documentation
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
index: archive/2026-05-19-api-documentation/.pi-map.index.md
## role
Planning and design documents for a comprehensive API documentation improvement initiative targeting a FastAPI-based application.
Archive of planning documents for a FastAPI API documentation improvement initiative, now superseded/historical.
## files
- design.md | Design document outlining API documentation structure, health endpoints, and OpenAPI enhancements for a FastAPI-based application | dep: FastAPI, Pydantic v2, psutil, SQLAlchemy, PostgreSQL, Docker
- proposal.md | Proposes a comprehensive API documentation improvement plan for a FastAPI-based project | dep: FastAPI, OpenAPI/Swagger, ReDoc, Pydantic, apps/api/README.md, docs/architecture/decisions/
- tasks.md | Project task tracking document for API documentation improvements across health endpoints, endpoint documentation, model documentation, README creation, architecture decisions, and quality gates
## arch
Document-driven planning architecture with three-tier separation: design specifications (design.md), strategic proposals (proposal.md), and task tracking/execution planning (tasks.md), organized by date-based archival structure for change management.
Documentation-driven planning with design-proposal-task hierarchy; covers OpenAPI schema enhancements, health endpoint standardization, and quality gating for developer experience.
## tags
documentation, api, fastapi, design, document, health, endpoints, openapi
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-19-api-documentation/specs (index)
dir: openspec/changes/archive/2026-05-19-api-documentation/specs
# archive/2026-05-19-api-documentation/specs (index)
dir: archive/2026-05-19-api-documentation/specs
## role
Defines API documentation standards and health endpoint specifications for a FastAPI-based project.
Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project
## parent
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md
index: archive/2026-05-19-api-documentation/.pi-map.index.md
map: archive/2026-05-19-api-documentation/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.md
index: archive/2026-05-19-api-documentation/specs/.pi-map.index.md
map: archive/2026-05-19-api-documentation/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-19-api-documentation/specs
dir: openspec/changes/archive/2026-05-19-api-documentation/specs
# archive/2026-05-19-api-documentation/specs
dir: archive/2026-05-19-api-documentation/specs
index: openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md
index: archive/2026-05-19-api-documentation/specs/.pi-map.index.md
## role
Defines API documentation standards and health endpoint specifications for a FastAPI-based project.
Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project
## files
- spec.md | Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project | dep: FastAPI, OpenAPI, Pydantic, Swagger UI, ReDoc
## arch
Specification-driven documentation using Markdown-based API contracts with standardized health check patterns.
Specification-driven documentation using markdown-based standards for OpenAPI/Swagger integration with FastAPI
## tags
documentation, fastapi, spec, defines, api, requirements, health, endpoint
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2026-05-19-documentation-overhaul (index)
dir: openspec/changes/archive/2026-05-19-documentation-overhaul
# archive/2026-05-19-documentation-overhaul (index)
dir: archive/2026-05-19-documentation-overhaul
## role
Contains archived planning documents for a 2026 documentation overhaul initiative, including configuration, design, proposal, and task tracking artifacts.
Historical archive of a planned documentation system overhaul project from May 2026, containing design specs, proposals, and task tracking artifacts.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-19-documentation-overhaul/specs
index: openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.md
- archive/2026-05-19-documentation-overhaul/specs
index: archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
map: archive/2026-05-19-documentation-overhaul/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md
index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md
map: archive/2026-05-19-documentation-overhaul/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2026-05-19-documentation-overhaul
dir: openspec/changes/archive/2026-05-19-documentation-overhaul
# archive/2026-05-19-documentation-overhaul
dir: archive/2026-05-19-documentation-overhaul
index: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md
index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md
## role
Contains archived planning documents for a 2026 documentation overhaul initiative, including configuration, design, proposal, and task tracking artifacts.
Historical archive of a planned documentation system overhaul project from May 2026, containing design specs, proposals, and task tracking artifacts.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Defines the structure, templates, and process for overhauling a project's documentation system
- proposal.md | Proposes a comprehensive documentation overhaul for a software project to address gaps in README, feature docs, API docs, deployment guides, and architecture documentation.
- tasks.md | Task tracking document for a comprehensive documentation overhaul project spanning README rewrite, documentation structure creation, feature/API/architecture documentation, deployment/development guides, and finalization
## arch
Document-driven project planning pattern using structured markdown specifications with YAML metadata, following a progression from proposal design → tasks workflow with explicit schema versioning.
Document-driven project planning with structured specification files (OpenSpec YAML), phased proposal design, and task-based workflow tracking for systematic documentation improvement.
## tags
documentation, project, defines, creation, .openspec, structure, design, comprehensive
## symbols
@@ -1,18 +1,18 @@
# openspec/changes/archive/2026-05-19-documentation-overhaul/specs (index)
dir: openspec/changes/archive/2026-05-19-documentation-overhaul/specs
# archive/2026-05-19-documentation-overhaul/specs (index)
dir: archive/2026-05-19-documentation-overhaul/specs
## role
Archive storage for historical specification documents related to a documentation overhaul initiative dated May 19, 2026.
Defines requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application.
## parent
index: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md
index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md
map: archive/2026-05-19-documentation-overhaul/.pi-map.md
## children
-
## files
- spec.md
## links
index: openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.md
index: archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
map: archive/2026-05-19-documentation-overhaul/specs/.pi-map.md
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# openspec/changes/archive/2026-05-19-documentation-overhaul/specs
dir: openspec/changes/archive/2026-05-19-documentation-overhaul/specs
# archive/2026-05-19-documentation-overhaul/specs
dir: archive/2026-05-19-documentation-overhaul/specs
index: openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
index: archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
## role
Archive storage for historical specification documents related to a documentation overhaul initiative dated May 19, 2026.
Defines requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application.
## files
- spec.md | Specification document outlining requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application
## arch
Simple flat-file archival pattern with dated directory structure preserving immutable specification snapshots.
Specification-driven documentation architecture using structured markdown templates, process workflows, and standardized content organization patterns.
## tags
spec, specification, document, outlining, requirements, templates, processes, comprehensive
## symbols
@@ -1,23 +1,23 @@
# openspec/changes/archive/2026-05-19-file-editor (index)
dir: openspec/changes/archive/2026-05-19-file-editor
# archive/2026-05-19-file-editor (index)
dir: archive/2026-05-19-file-editor
## role
Archive directory containing historical design documents and specifications for a file editor component that was planned to replace FileViewer with enhanced editing capabilities.
Archive directory containing historical design documents and specifications for a file editor component that was planned to replace FileViewer with editing, syntax highlighting, and git commit capabilities.
## parent
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
index: archive/.pi-map.index.md
map: archive/.pi-map.md
## children
- openspec/changes/archive/2026-05-19-file-editor/specs
index: openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.md
- archive/2026-05-19-file-editor/specs
index: archive/2026-05-19-file-editor/specs/.pi-map.index.md
map: archive/2026-05-19-file-editor/specs/.pi-map.md
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md
map: openspec/changes/archive/2026-05-19-file-editor/.pi-map.md
index: archive/2026-05-19-file-editor/.pi-map.index.md
map: archive/2026-05-19-file-editor/.pi-map.md
## workflows
-
## dirty
@@ -1,17 +1,17 @@
# openspec/changes/archive/2026-05-19-file-editor
dir: openspec/changes/archive/2026-05-19-file-editor
# archive/2026-05-19-file-editor
dir: archive/2026-05-19-file-editor
index: openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md
index: archive/2026-05-19-file-editor/.pi-map.index.md
## role
Archive directory containing historical design documents and specifications for a file editor component that was planned to replace FileViewer with enhanced editing capabilities.
Archive directory containing historical design documents and specifications for a file editor component that was planned to replace FileViewer with editing, syntax highlighting, and git commit capabilities.
## files
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design specification for a file editor component that replaces FileViewer with view/edit modes, syntax highlighting, and git commit integration | dep: react-simple-code-editor, prismjs, existing API endpoints (GET/POST /projects/{id}/repositories/{id}/files/content)
- proposal.md | Design proposal for adding syntax highlighting and in-browser editing capabilities to a repository file viewer with Git commit integration | dep: react-simple-code-editor, Prism.js, existing PUT /files/content API endpoint
- tasks.md | Project task list tracking implementation phases for a file editor component with syntax highlighting, editing, and commit capabilities | dep: react-simple-code-editor, prismjs, @types/prismjs, TypeScript, ESLint, ruff, mypy
## arch
Document-driven specification pattern using OpenSpec schema metadata, with phased implementation tracking (design proposal → tasks) for a component featuring dual-mode view/edit architecture, syntax highlighting integration, and git workflow commit integration.
Documentation-driven specification package with OpenSpec configuration, design docs, proposal, and task tracking—no actual implementation code, representing a waterfall-style planning artifact from a completed or abandoned feature cycle.
## tags
editor, design, syntax, highlighting, commit, react, simple, code
## symbols

Some files were not shown because too many files have changed in this diff Show More