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

This commit is contained in:
Developer
2026-06-17 11:31:24 +00:00
parent 0dd5f2317b
commit 93da9b42a2
683 changed files with 5075 additions and 4965 deletions
+148 -158
View File
@@ -1,167 +1,157 @@
# . (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.
# openspec/changes/archive (index)
dir: openspec/changes/archive
## role
This is an empty package directory with no files to analyze.
Provides historical record and backward compatibility for schema changes that have been archived or superseded.
## parent
-
index: openspec/changes/.pi-map.index.md
map: openspec/changes/.pi-map.md
## children
- 2025-05-17-oauth-traefik-integration
index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/.pi-map.md
- 2025-05-17-user-profile
index: 2025-05-17-user-profile/.pi-map.index.md
map: 2025-05-17-user-profile/.pi-map.md
- 2025-05-18-git-repo-management
index: 2025-05-18-git-repo-management/.pi-map.index.md
map: 2025-05-18-git-repo-management/.pi-map.md
- 2025-05-18-ssh-key-management
index: 2025-05-18-ssh-key-management/.pi-map.index.md
map: 2025-05-18-ssh-key-management/.pi-map.md
- 2025-05-18-test-infrastructure-improvements
index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/.pi-map.md
- 2025-05-18-tool-types-definition
index: 2025-05-18-tool-types-definition/.pi-map.index.md
map: 2025-05-18-tool-types-definition/.pi-map.md
- 2025-05-18-user-config-management
index: 2025-05-18-user-config-management/.pi-map.index.md
map: 2025-05-18-user-config-management/.pi-map.md
- 2026-05-17-auth-oauth
index: 2026-05-17-auth-oauth/.pi-map.index.md
map: 2026-05-17-auth-oauth/.pi-map.md
- 2026-05-17-database-models
index: 2026-05-17-database-models/.pi-map.index.md
map: 2026-05-17-database-models/.pi-map.md
- 2026-05-17-frontend-foundation
index: 2026-05-17-frontend-foundation/.pi-map.index.md
map: 2026-05-17-frontend-foundation/.pi-map.md
- 2026-05-17-project-management
index: 2026-05-17-project-management/.pi-map.index.md
map: 2026-05-17-project-management/.pi-map.md
- 2026-05-18-database-setup-recovery
index: 2026-05-18-database-setup-recovery/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/.pi-map.md
- 2026-05-18-simplify-authentik-auth
index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: 2026-05-18-simplify-authentik-auth/.pi-map.md
- 2026-05-19-api-documentation
index: 2026-05-19-api-documentation/.pi-map.index.md
map: 2026-05-19-api-documentation/.pi-map.md
- 2026-05-19-documentation-overhaul
index: 2026-05-19-documentation-overhaul/.pi-map.index.md
map: 2026-05-19-documentation-overhaul/.pi-map.md
- 2026-05-19-file-editor
index: 2026-05-19-file-editor/.pi-map.index.md
map: 2026-05-19-file-editor/.pi-map.md
- 2026-05-19-git-control
index: 2026-05-19-git-control/.pi-map.index.md
map: 2026-05-19-git-control/.pi-map.md
- 2026-05-19-git-history-visualization
index: 2026-05-19-git-history-visualization/.pi-map.index.md
map: 2026-05-19-git-history-visualization/.pi-map.md
- 2026-05-19-repo-workspace
index: 2026-05-19-repo-workspace/.pi-map.index.md
map: 2026-05-19-repo-workspace/.pi-map.md
- 2026-05-19-responsive-spacing-improvements
index: 2026-05-19-responsive-spacing-improvements/.pi-map.index.md
map: 2026-05-19-responsive-spacing-improvements/.pi-map.md
- 2026-05-19-smart-git-url-parsing
index: 2026-05-19-smart-git-url-parsing/.pi-map.index.md
map: 2026-05-19-smart-git-url-parsing/.pi-map.md
- 2026-05-19-tool-instances
index: 2026-05-19-tool-instances/.pi-map.index.md
map: 2026-05-19-tool-instances/.pi-map.md
- 2026-05-19-tool-terminal
index: 2026-05-19-tool-terminal/.pi-map.index.md
map: 2026-05-19-tool-terminal/.pi-map.md
- 2026-05-19-universal-icon-system
index: 2026-05-19-universal-icon-system/.pi-map.index.md
map: 2026-05-19-universal-icon-system/.pi-map.md
- 2026-05-19-workspace-visual-overhaul
index: 2026-05-19-workspace-visual-overhaul/.pi-map.index.md
map: 2026-05-19-workspace-visual-overhaul/.pi-map.md
- 2026-05-22-cloudflare-tunnel-instances-superseded
index: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md
map: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md
- 2026-05-22-enforce-single-tool-type-with-port-config
index: 2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md
map: 2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md
- 2026-05-22-git-repo-ssh-clone-check
index: 2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md
map: 2026-05-22-git-repo-ssh-clone-check/.pi-map.md
- 2026-05-22-git-repo-working-clones
index: 2026-05-22-git-repo-working-clones/.pi-map.index.md
map: 2026-05-22-git-repo-working-clones/.pi-map.md
- 2026-05-22-instance-health-monitoring
index: 2026-05-22-instance-health-monitoring/.pi-map.index.md
map: 2026-05-22-instance-health-monitoring/.pi-map.md
- 2026-05-22-instance-proxy
index: 2026-05-22-instance-proxy/.pi-map.index.md
map: 2026-05-22-instance-proxy/.pi-map.md
- 2026-05-22-opencode-web-terminal
index: 2026-05-22-opencode-web-terminal/.pi-map.index.md
map: 2026-05-22-opencode-web-terminal/.pi-map.md
- 2026-05-22-repo-clone-mode-with-ssh
index: 2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md
map: 2026-05-22-repo-clone-mode-with-ssh/.pi-map.md
- 2026-05-22-session-management-fixes
index: 2026-05-22-session-management-fixes/.pi-map.index.md
map: 2026-05-22-session-management-fixes/.pi-map.md
- 2026-05-22-sessions-hub
index: 2026-05-22-sessions-hub/.pi-map.index.md
map: 2026-05-22-sessions-hub/.pi-map.md
- 2026-05-22-tool-config-management
index: 2026-05-22-tool-config-management/.pi-map.index.md
map: 2026-05-22-tool-config-management/.pi-map.md
- 2026-05-22-tool-config-ui-rework
index: 2026-05-22-tool-config-ui-rework/.pi-map.index.md
map: 2026-05-22-tool-config-ui-rework/.pi-map.md
- 2026-05-22-tool-workshop
index: 2026-05-22-tool-workshop/.pi-map.index.md
map: 2026-05-22-tool-workshop/.pi-map.md
- 2026-05-22-ui-redesign-home-settings
index: 2026-05-22-ui-redesign-home-settings/.pi-map.index.md
map: 2026-05-22-ui-redesign-home-settings/.pi-map.md
- 2026-05-23-remove-built-in-tools
index: 2026-05-23-remove-built-in-tools/.pi-map.index.md
map: 2026-05-23-remove-built-in-tools/.pi-map.md
- 2026-05-24-terminal-startup-and-container-tools
index: 2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md
map: 2026-05-24-terminal-startup-and-container-tools/.pi-map.md
- 2026-05-25-add-config-profiles
index: 2026-05-25-add-config-profiles/.pi-map.index.md
map: 2026-05-25-add-config-profiles/.pi-map.md
- 2026-05-25-mobile-app-usability
index: 2026-05-25-mobile-app-usability/.pi-map.index.md
map: 2026-05-25-mobile-app-usability/.pi-map.md
- 2026-05-25-mobile-pages-overhaul
index: 2026-05-25-mobile-pages-overhaul/.pi-map.index.md
map: 2026-05-25-mobile-pages-overhaul/.pi-map.md
- 2026-06-12-completed-changes-archive
index: 2026-06-12-completed-changes-archive/.pi-map.index.md
map: 2026-06-12-completed-changes-archive/.pi-map.md
- 2026-06-14-completed-specs-archive
index: 2026-06-14-completed-specs-archive/.pi-map.index.md
map: 2026-06-14-completed-specs-archive/.pi-map.md
- 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
- openspec/changes/archive/2026-06-12-completed-changes-archive
index: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md
- openspec/changes/archive/2026-06-14-completed-specs-archive
index: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md
map: openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md
- openspec/changes/archive/web-ui-spacing-typography-rework
index: openspec/changes/archive/web-ui-spacing-typography-rework/.pi-map.index.md
map: openspec/changes/archive/web-ui-spacing-typography-rework/.pi-map.md
## files
## links
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## workflows
-
## dirty
+5 -19
View File
@@ -1,27 +1,13 @@
# .
dir: .
# openspec/changes/archive
dir: openspec/changes/archive
index: ./.pi-map.index.md
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
index: openspec/changes/archive/.pi-map.index.md
## role
This is an empty package directory with no files to analyze.
Provides historical record and backward compatibility for schema changes that have been archived or superseded.
## files
## arch
N/A - no code or architecture patterns present
Immutable archive pattern with versioned change records, likely using append-only storage for audit trails and rollback support.
## tags
-
## symbols
@@ -1,23 +1,23 @@
# 2025-05-17-oauth-traefik-integration (index)
dir: 2025-05-17-oauth-traefik-integration
# openspec/changes/archive/2025-05-17-oauth-traefik-integration (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration
## role
Infrastructure integration package for deploying a Docker-based application behind an existing Traefik reverse proxy with OAuth authentication via Authentik.
Archive of design documents and task tracking for integrating OAuth authentication with Traefik reverse proxy deployment
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-17-oauth-traefik-integration/specs
index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2025-05-17-oauth-traefik-integration
dir: 2025-05-17-oauth-traefik-integration
# openspec/changes/archive/2025-05-17-oauth-traefik-integration
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration
index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md
## role
Infrastructure integration package for deploying a Docker-based application behind an existing Traefik reverse proxy with OAuth authentication via Authentik.
Archive of design documents and task tracking for integrating OAuth authentication with Traefik reverse proxy deployment
## 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.
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- design.md | Design document outlining the plan to make an application deployable behind an existing Traefik reverse proxy by removing hardcoded URLs and making all external service endpoints configurable via environment variables. | dep: Docker, Docker Compose, Traefik, Authentik, Python (config.py, auth.py), Vite (frontend)
- proposal.md | Proposes infrastructure changes to externalize Authentik/domain configuration via environment variables and add Traefik reverse proxy deployment support. | dep: docker-compose, traefik, authentik, python, vite
- tasks.md | Tracks completion of infrastructure and configuration tasks for externalizing Authentik auth, adding Traefik reverse proxy support, and updating frontend/backend configuration.
## arch
Environment-driven configuration pattern replacing hardcoded URLs with externalized variables, plus reverse proxy integration using Traefik labels and Docker Compose deployment orchestration.
Specification-driven infrastructure migration using environment-based configuration externalization pattern to decouple hardcoded service dependencies
## tags
traefik, design, configuration, .openspec, document, docker, reverse, proxy
traefik, configuration, authentik, design, reverse, proxy, tasks, .openspec
## symbols
-
## workflows
@@ -1,25 +1,25 @@
# 2025-05-17-oauth-traefik-integration/specs (index)
dir: 2025-05-17-oauth-traefik-integration/specs
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs (index)
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
## role
Contains specification documents and design requirements for the OAuth-Traefik integration feature
Contains archived specification documents for an OAuth and Traefik integration feature planned for May 17, 2025.
## parent
index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/.pi-map.md
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
## children
- 2025-05-17-oauth-traefik-integration/specs/auth-oauth
index: 2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md
- 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
index: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md
- 2025-05-17-oauth-traefik-integration/specs/traefik-deployment
index: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md
- 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
## files
## links
index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-17-oauth-traefik-integration/specs
dir: 2025-05-17-oauth-traefik-integration/specs
# openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
dir: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs
index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
## role
Contains specification documents and design requirements for the OAuth-Traefik integration feature
Contains archived specification documents for an OAuth and Traefik integration feature planned for May 17, 2025.
## files
## arch
Documentation-driven development with structured specification files (likely markdown/asciidoc) defining system requirements, API contracts, and integration patterns before implementation
Specification-driven design using dated archival structure for tracking feature requirements and technical design decisions.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-17-oauth-traefik-integration/specs/auth-oauth (index)
dir: 2025-05-17-oauth-traefik-integration/specs/auth-oauth
# 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
## role
Defines authentication requirements for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies.
Defines authentication specifications for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies.
## parent
index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-17-oauth-traefik-integration/specs/auth-oauth
dir: 2025-05-17-oauth-traefik-integration/specs/auth-oauth
# 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
index: 2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md
## role
Defines authentication requirements for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies.
Defines authentication specifications for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies.
## files
- spec.md | Specifies modified requirements for OAuth2/OIDC authentication via Authentik and session security with httpOnly cookies | dep: Authentik, Traefik, OAuth2, OIDC
- spec.md | Defines modified requirements for OAuth2/OIDC authentication with Authentik and session security using httpOnly cookies | dep: Authentik, Traefik, OAuth2/OIDC, JWKS
## arch
Specification-driven architecture with external identity provider delegation, token-based authentication flows, and cookie-based session security patterns.
Specification-driven design using markdown-based requirements documents with focus on security patterns (OAuth2/OIDC flow, httpOnly cookie-based session storage).
## tags
oauth2, oidc, authentik, spec, specifies, modified, requirements, authentication
oauth2, oidc, authentik, spec, defines, modified, requirements, authentication
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure (index)
dir: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
# 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
## role
Defines Docker infrastructure specifications using behavior-driven development examples to validate environment configuration and service orchestration requirements.
Defines infrastructure specifications for Docker-based deployment supporting OAuth and Traefik integration.
## parent
index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md
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
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
dir: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure
# 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
index: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md
## role
Defines Docker infrastructure specifications using behavior-driven development examples to validate environment configuration and service orchestration requirements.
Defines infrastructure specifications for Docker-based deployment supporting OAuth and Traefik integration.
## files
- spec.md | Defines modified requirements for Docker Compose setup and environment configuration using specification by example (Gherkin-style scenarios) | dep: Docker Compose, Traefik
- spec.md | Defines modified requirements for Docker Compose setup and environment configuration documentation | dep: Docker Compose, Traefik, .env.example
## arch
Specification-by-example pattern with Gherkin-style scenarios for executable requirements, targeting Docker Compose-based infrastructure validation.
Documentation-driven specification pattern using markdown-based requirements definition for container orchestration configuration.
## tags
spec, defines, modified, requirements, docker, compose, setup, environment
## symbols
@@ -1,18 +1,18 @@
# 2025-05-17-oauth-traefik-integration/specs/traefik-deployment (index)
dir: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment
# 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
## role
Defines deployment specifications for Traefik reverse proxy infrastructure in a Docker Compose environment.
Defines infrastructure-as-code specifications for deploying Traefik reverse proxy with OAuth integration via Docker Compose
## parent
index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
map: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-17-oauth-traefik-integration/specs/traefik-deployment
dir: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment
# 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
index: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md
## role
Defines deployment specifications for Traefik reverse proxy infrastructure in a Docker Compose environment.
Defines infrastructure-as-code specifications for deploying Traefik reverse proxy with OAuth integration via Docker Compose
## files
- spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC
- spec.md | Defines requirements for Traefik Docker Compose deployment configuration with environment-based domain routing | dep: Docker Compose, Traefik, Authentik, OIDC
## arch
Infrastructure-as-specification pattern using markdown-based requirements documentation for containerized reverse proxy deployment.
Specification-driven documentation pattern using markdown-based requirements definition for containerized deployment configuration
## tags
traefik, spec, specifies, requirements, docker, compose, deployment, configuration
traefik, spec, defines, requirements, docker, compose, deployment, configuration
## symbols
-
## workflows
@@ -1,15 +1,15 @@
# 2025-05-17-user-profile (index)
dir: 2025-05-17-user-profile
# openspec/changes/archive/2025-05-17-user-profile (index)
dir: openspec/changes/archive/2025-05-17-user-profile
## role
Design and planning package for an authenticated user profile management feature with read/update endpoints, frontend page, and avatar upload.
Defines a complete user profile management feature specification including backend API, frontend UI, and avatar upload capabilities.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-17-user-profile/specs
index: 2025-05-17-user-profile/specs/.pi-map.index.md
map: 2025-05-17-user-profile/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: ./.pi-map.md
- proposal.md
- tasks.md
## links
index: 2025-05-17-user-profile/.pi-map.index.md
map: 2025-05-17-user-profile/.pi-map.md
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
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2025-05-17-user-profile
dir: 2025-05-17-user-profile
# openspec/changes/archive/2025-05-17-user-profile
dir: openspec/changes/archive/2025-05-17-user-profile
index: 2025-05-17-user-profile/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md
## role
Design and planning package for an authenticated user profile management feature with read/update endpoints, frontend page, and avatar upload.
Defines a complete user profile management feature specification including backend API, frontend UI, and avatar upload capabilities.
## files
- .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- README.md | Documents the implementation of an authenticated user profile read/update flow across API and frontend
- design.md | Design document for implementing a user profile management feature with backend API endpoints and frontend page | dep: FastAPI, JWT authentication, cookie-based auth, static file serving, React/frontend framework
- 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.
- design.md | Design document specifying a user profile management feature with backend API endpoints and frontend page for viewing/updating profile data and uploading avatars. | dep: FastAPI, JWT authentication, User model, UploadFile, static file serving, frontend routing/form handling
- proposal.md | This file is a technical proposal document outlining the implementation of user profile management functionality, including API endpoints, frontend page, and avatar upload capabilities.
- tasks.md | A project task tracking file documenting the implementation status of a user profile feature across backend API, frontend UI, and verification steps.
## arch
Specification-driven development using OpenAPI schema definitions, with phased task tracking across backend API and frontend implementation, documented through proposal, design, and task artifacts.
Specification-driven development using OpenSpec schema with structured design documents (design/proposal/tasks) separating concerns across backend API endpoints and frontend React page components.
## tags
api, user, profile, frontend, design, tasks, .openspec, implementation
profile, user, api, frontend, implementation, design, proposal, .openspec
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2025-05-17-user-profile/specs (index)
dir: 2025-05-17-user-profile/specs
# openspec/changes/archive/2025-05-17-user-profile/specs (index)
dir: openspec/changes/archive/2025-05-17-user-profile/specs
## role
Contains specification documents defining requirements and behavior for the user profile feature.
Contains archived specification documents for user profile feature changes from May 17, 2025, serving as historical design documentation for the openspec project.
## parent
index: 2025-05-17-user-profile/.pi-map.index.md
map: 2025-05-17-user-profile/.pi-map.md
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
## children
- 2025-05-17-user-profile/specs/user-profile
index: 2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
map: 2025-05-17-user-profile/specs/user-profile/.pi-map.md
- 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
## files
## links
index: 2025-05-17-user-profile/specs/.pi-map.index.md
map: 2025-05-17-user-profile/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-17-user-profile/specs
dir: 2025-05-17-user-profile/specs
# openspec/changes/archive/2025-05-17-user-profile/specs
dir: openspec/changes/archive/2025-05-17-user-profile/specs
index: 2025-05-17-user-profile/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md
## role
Contains specification documents defining requirements and behavior for the user profile feature.
Contains archived specification documents for user profile feature changes from May 17, 2025, serving as historical design documentation for the openspec project.
## files
## arch
Documentation-driven specification pattern with date-based versioning for feature scoping.
Simple date-based archival directory structure with no active code, following a flat file storage pattern for version-controlled specification snapshots.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-17-user-profile/specs/user-profile (index)
dir: 2025-05-17-user-profile/specs/user-profile
# openspec/changes/archive/2025-05-17-user-profile/specs/user-profile (index)
dir: openspec/changes/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 requirements for user profile management capabilities including data retrieval, updates, and local avatar storage.
## parent
index: 2025-05-17-user-profile/specs/.pi-map.index.md
map: 2025-05-17-user-profile/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
map: 2025-05-17-user-profile/specs/user-profile/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-17-user-profile/specs/user-profile
dir: 2025-05-17-user-profile/specs/user-profile
# openspec/changes/archive/2025-05-17-user-profile/specs/user-profile
dir: openspec/changes/archive/2025-05-17-user-profile/specs/user-profile
index: 2025-05-17-user-profile/specs/user-profile/.pi-map.index.md
index: openspec/changes/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 requirements for user profile management capabilities including data retrieval, updates, and local avatar storage.
## 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
- spec.md | Specifies requirements for user profile management including retrieval, updates, and local avatar storage | dep: auth-oauth, User database model, pytest, mypy, ruff, npm typecheck, npm lint
## arch
Specification-driven design with markdown-based requirements documentation
Specification-driven requirements document using markdown-based structured documentation pattern for feature specification.
## tags
profile, npm, spec, defines, functional, specifications, user, management
spec, specifies, requirements, user, profile, management, including, retrieval
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2025-05-18-git-repo-management (index)
dir: 2025-05-18-git-repo-management
# openspec/changes/archive/2025-05-18-git-repo-management (index)
dir: openspec/changes/archive/2025-05-18-git-repo-management
## role
This package contains design and planning documents for implementing a git repository management feature that enables creating, listing, cloning, and deleting bare git repositories within projects.
Contains completed specification documents for implementing git repository management feature in an existing project/SSH-key platform.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-18-git-repo-management/specs
index: 2025-05-18-git-repo-management/specs/.pi-map.index.md
map: 2025-05-18-git-repo-management/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2025-05-18-git-repo-management/.pi-map.index.md
map: 2025-05-18-git-repo-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2025-05-18-git-repo-management
dir: 2025-05-18-git-repo-management
# openspec/changes/archive/2025-05-18-git-repo-management
dir: openspec/changes/archive/2025-05-18-git-repo-management
index: 2025-05-18-git-repo-management/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md
## role
This package contains design and planning documents for implementing a git repository management feature that enables creating, listing, cloning, and deleting bare git repositories within projects.
Contains completed specification documents for implementing git repository management feature in an existing project/SSH-key platform.
## 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.
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document for adding bare git repository management to a platform that already has projects and SSH keys | dep: git, subprocess, filesystem storage, database, API, frontend
- proposal.md | Proposes adding git repository management functionality to a platform that already has projects but lacks repository creation and management capabilities | dep: git, backend API, frontend UI, disk storage, project management system
- tasks.md | This is a completed task checklist for implementing a Git repository management feature with backend API, frontend UI, project integration, and verification steps. | dep: FastAPI, Pydantic, React, git, pytest, ruff, mypy, npm, docker-compose
## arch
Documentation-driven specification pattern using layered design docs (proposal → design → tasks → API spec) to formally define requirements before implementation, with clear separation between backend API, frontend UI, and project integration concerns.
Specification-driven development with layered documentation (proposal → design → tasks) plus OpenAPI metadata, following a structured change request process with clear separation of backend API, frontend UI, and integration concerns.
## tags
git, management, design, repository, project, creation, .openspec, projects
git, repository, management, design, creation, .openspec, adding, platform
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2025-05-18-git-repo-management/specs (index)
dir: 2025-05-18-git-repo-management/specs
# openspec/changes/archive/2025-05-18-git-repo-management/specs (index)
dir: openspec/changes/archive/2025-05-18-git-repo-management/specs
## role
Contains specification documents that define requirements, standards, or design contracts for the git repository management project.
This directory stores version-controlled specification documents for a git repository management feature, organized by date for archival and change tracking purposes.
## parent
index: 2025-05-18-git-repo-management/.pi-map.index.md
map: 2025-05-18-git-repo-management/.pi-map.md
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
## children
- 2025-05-18-git-repo-management/specs/git-repo-management
index: 2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
map: 2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md
- 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
## files
## links
index: 2025-05-18-git-repo-management/specs/.pi-map.index.md
map: 2025-05-18-git-repo-management/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-18-git-repo-management/specs
dir: 2025-05-18-git-repo-management/specs
# openspec/changes/archive/2025-05-18-git-repo-management/specs
dir: openspec/changes/archive/2025-05-18-git-repo-management/specs
index: 2025-05-18-git-repo-management/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md
## role
Contains specification documents that define requirements, standards, or design contracts for the git repository management project.
This directory stores version-controlled specification documents for a git repository management feature, organized by date for archival and change tracking purposes.
## files
## arch
Documentation-driven architecture using specification files (likely markdown or structured text) to establish formal contracts before implementation, supporting design-first or contract-first development patterns.
Date-based archival directory structure with flat file storage for specifications, using filesystem hierarchy as temporal versioning without explicit code architecture.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-18-git-repo-management/specs/git-repo-management (index)
dir: 2025-05-18-git-repo-management/specs/git-repo-management
# 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
## role
Defines functional requirements for a Git repository management system supporting lifecycle operations.
Defines system requirements for a Git repository management service supporting create, clone, list, delete, and cascade delete operations
## parent
index: 2025-05-18-git-repo-management/specs/.pi-map.index.md
map: 2025-05-18-git-repo-management/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
map: 2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-18-git-repo-management/specs/git-repo-management
dir: 2025-05-18-git-repo-management/specs/git-repo-management
# 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
index: 2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md
## role
Defines functional requirements for a Git repository management system supporting lifecycle operations.
Defines system requirements for a Git repository management service supporting create, clone, list, delete, and cascade delete operations
## 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
- spec.md | Defines system requirements for a Git repository management service supporting create, clone, list, delete, and cascade delete operations | dep: git, database, filesystem, HTTP/web framework
## arch
Specification-driven design using a single requirements document with feature-based organization (CRUD + cascade operations).
Specification-driven architecture using Markdown-based requirements documentation with dated archival organization for change tracking
## tags
git, deletion, spec, specifies, software, requirements, repository, management
git, delete, spec, defines, system, requirements, repository, management
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2025-05-18-ssh-key-management (index)
dir: 2025-05-18-ssh-key-management
# openspec/changes/archive/2025-05-18-ssh-key-management (index)
dir: openspec/changes/archive/2025-05-18-ssh-key-management
## role
Implements a full-stack SSH key management system for secure Ed25519 key generation, encrypted storage, and git operations with external providers.
Archive directory containing completed design and planning documents for a full-stack SSH key management feature that enables git operations via generated SSH keys.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-18-ssh-key-management/specs
index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: 2025-05-18-ssh-key-management/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2025-05-18-ssh-key-management/.pi-map.index.md
map: 2025-05-18-ssh-key-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2025-05-18-ssh-key-management
dir: 2025-05-18-ssh-key-management
# openspec/changes/archive/2025-05-18-ssh-key-management
dir: openspec/changes/archive/2025-05-18-ssh-key-management
index: 2025-05-18-ssh-key-management/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md
## role
Implements a full-stack SSH key management system for secure Ed25519 key generation, encrypted storage, and git operations with external providers.
Archive directory containing completed design and planning documents for a full-stack SSH key management feature that enables git operations via generated SSH keys.
## 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
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document for implementing an SSH key management API and frontend feature | dep: cryptography (Fernet, Ed25519), database/SSHKey model, JWT_SECRET/application secret, frontend router/table components
- proposal.md | Proposes a feature to add SSH key generation, management, and UI capabilities for git operations | dep: FastAPI, Fernet, Ed25519, React/Vue (implied by frontend), existing SSHKey model
- tasks.md | A completed task checklist tracking the implementation of a full-stack SSH key management feature with backend API, frontend UI, and verification steps.
## arch
Full-stack feature module with backend REST API, frontend UI, encrypted private key storage, and task-driven implementation documentation following design-proposal-tasks workflow.
Specification-driven development with OpenAPI schema metadata, phased implementation tracking (proposal → design → tasks), and full-stack feature delivery encompassing backend API, frontend UI, and verification workflows.
## tags
key, design, api, ssh, .openspec, ed25519, management, backend
design, ssh, key, management, feature, .openspec, api, frontend
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2025-05-18-ssh-key-management/specs (index)
dir: 2025-05-18-ssh-key-management/specs
# openspec/changes/archive/2025-05-18-ssh-key-management/specs (index)
dir: openspec/changes/archive/2025-05-18-ssh-key-management/specs
## role
Contains specification documents defining requirements and design for SSH key management functionality.
Defines OpenAPI specifications for SSH key management API endpoints introduced in the 2025-05-18 release.
## parent
index: 2025-05-18-ssh-key-management/.pi-map.index.md
map: 2025-05-18-ssh-key-management/.pi-map.md
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
## children
- 2025-05-18-ssh-key-management/specs/ssh-key-management
index: 2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
map: 2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md
- 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
## files
## links
index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: 2025-05-18-ssh-key-management/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-18-ssh-key-management/specs
dir: 2025-05-18-ssh-key-management/specs
# openspec/changes/archive/2025-05-18-ssh-key-management/specs
dir: openspec/changes/archive/2025-05-18-ssh-key-management/specs
index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md
## role
Contains specification documents defining requirements and design for SSH key management functionality.
Defines OpenAPI specifications for SSH key management API endpoints introduced in the 2025-05-18 release.
## files
## arch
Documentation-driven specification pattern using dated directory organization for version tracking of feature requirements.
OpenAPI 3.0 specification files organized as modular schema definitions for RESTful API contract documentation and code generation.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-18-ssh-key-management/specs/ssh-key-management (index)
dir: 2025-05-18-ssh-key-management/specs/ssh-key-management
# 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
## role
Defines functional requirements and specifications for SSH key lifecycle management operations.
Defines functional requirements for SSH key lifecycle management operations in the OpenSpec project.
## parent
index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md
map: 2025-05-18-ssh-key-management/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
map: 2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-18-ssh-key-management/specs/ssh-key-management
dir: 2025-05-18-ssh-key-management/specs/ssh-key-management
# 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
index: 2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md
## role
Defines functional requirements and specifications for SSH key lifecycle management operations.
Defines functional requirements for SSH key lifecycle management operations in the OpenSpec project.
## files
- spec.md | Defines requirements for SSH key management functionality including generation, listing, display, and deletion
- spec.md | Specifies requirements for SSH key management functionality including generation, listing, display, and deletion
## arch
Specification-driven design using requirement documents to define system behavior before implementation.
Specification-driven design using markdown-based requirements documents with dated archival versioning.
## tags
spec, defines, requirements, ssh, key, management, functionality, including
spec, specifies, requirements, ssh, key, management, functionality, including
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2025-05-18-test-infrastructure-improvements (index)
dir: 2025-05-18-test-infrastructure-improvements
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements
## role
Documents the planning, design, and tracking of test infrastructure improvements for a backend API project.
Documents a completed test infrastructure improvement initiative for restructuring and modernizing a multi-language backend testing suite.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-18-test-infrastructure-improvements/specs
index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2025-05-18-test-infrastructure-improvements
dir: 2025-05-18-test-infrastructure-improvements
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements
index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md
## role
Documents the planning, design, and tracking of test infrastructure improvements for a backend API project.
Documents a completed test infrastructure improvement initiative for restructuring and modernizing a multi-language backend testing suite.
## 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
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document for restructuring a test suite to separate unit/integration/system tests, introduce shared fixtures, and add E2E coverage | dep: pytest, pytest-asyncio, SQLite, PostgreSQL, Playwright, Docker, React/Vite, asyncpg, conftest.py, pytest-xdist
- proposal.md | Proposes restructuring a Python/Node.js test suite to separate unit, integration, and system tests, add shared fixtures, enable SQLite for fast unit tests, implement transaction rollback isolation, and introduce Playwright E2E testing. | dep: pytest, PostgreSQL, SQLite, Playwright, python-jose, Docker, Makefile
- tasks.md | A completed task checklist documenting the restructuring of a backend testing suite with unit/integration/system test separation, shared fixtures, SQLite support, E2E setup, and documentation | dep: pytest, pytest-asyncio, aiosqlite, SQLAlchemy, PostgreSQL, Playwright, python-jose, TestClient, Makefile
## arch
Documentation-driven project management using structured markdown files (proposal → design → tasks) with OpenSpec metadata, following a waterfall-like planning pattern for test suite restructuring across unit/integration/system/E2E layers.
Specification-driven change management using OpenAPI metadata tracking, with design-proposal-task documentation pipeline covering test pyramid separation (unit/integration/system/E2E), shared fixture patterns, database isolation strategies, and cross-language tooling unification.
## tags
pytest, sqlite, postgresql, playwright, design, restructuring, test, unit
pytest, unit, sqlite, playwright, design, restructuring, test, suite
## symbols
-
## workflows
@@ -1,25 +1,25 @@
# 2025-05-18-test-infrastructure-improvements/specs (index)
dir: 2025-05-18-test-infrastructure-improvements/specs
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs (index)
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
## role
Contains specification documents defining requirements and design for test infrastructure improvements
Contains specification documents for test infrastructure improvements planned or implemented on 2025-05-18.
## parent
index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/.pi-map.md
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
## children
- 2025-05-18-test-infrastructure-improvements/specs/e2e-testing
index: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md
- 2025-05-18-test-infrastructure-improvements/specs/test-isolation
index: 2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md
- 2025-05-18-test-infrastructure-improvements/specs/test-organization
index: 2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md
- 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
## files
## links
index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-18-test-infrastructure-improvements/specs
dir: 2025-05-18-test-infrastructure-improvements/specs
# openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
dir: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs
index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
## role
Contains specification documents defining requirements and design for test infrastructure improvements
Contains specification documents for test infrastructure improvements planned or implemented on 2025-05-18.
## files
## arch
Documentation-as-code pattern using dated directories for versioned specification tracking
Document-based specification storage using dated archival directories for change tracking and historical reference.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-18-test-infrastructure-improvements/specs/e2e-testing (index)
dir: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing
# 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
## role
Defines end-to-end testing requirements using Playwright and Makefile integration for automated browser-based system validation.
Defines end-to-end testing specifications using Playwright and Makefile integration for automated browser-based validation of system behavior.
## parent
index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-18-test-infrastructure-improvements/specs/e2e-testing
dir: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing
# 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
index: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md
index: openspec/changes/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 automated browser-based system validation.
Defines end-to-end testing specifications using Playwright and Makefile integration for automated browser-based validation of system behavior.
## 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
- spec.md | Specifies 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 Makefile target orchestration and Playwright-based browser automation framework.
Specification-driven testing architecture with Playwright for cross-browser automation, Makefile target orchestration for CI/CD integration, and markdown-based requirement documentation.
## tags
end, playwright, makefile, spec, defines, requirements, testing, test
end, playwright, makefile, spec, specifies, requirements, testing, test
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2025-05-18-test-infrastructure-improvements/specs/test-isolation (index)
dir: 2025-05-18-test-infrastructure-improvements/specs/test-isolation
# 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
## role
Defines requirements for ensuring test isolation through shared fixtures and database transaction management in a testing infrastructure.
Defines specifications for test isolation mechanisms to ensure reliable, independent test execution through shared fixtures and database transaction boundaries.
## parent
index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md
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
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2025-05-18-test-infrastructure-improvements/specs/test-isolation
dir: 2025-05-18-test-infrastructure-improvements/specs/test-isolation
# 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
index: 2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md
## role
Defines requirements for ensuring test isolation through shared fixtures and database transaction management in a testing infrastructure.
Defines specifications for test isolation mechanisms to ensure reliable, independent test execution through shared fixtures and database transaction boundaries.
## files
- spec.md | Defines requirements for shared test fixtures and transaction isolation in a testing infrastructure | dep: pytest, SQLAlchemy, TestClient, SQLite, PostgreSQL
- spec.md | Defines requirements for shared test fixtures and transaction isolation in a testing system | dep: pytest, SQLAlchemy, TestClient, SQLite, PostgreSQL
## arch
Specification-driven architecture using markdown-based requirements documents to define behavioral contracts for test infrastructure components.
Specification-driven architecture using markdown-based requirements documents that establish behavioral contracts for test infrastructure components.
## tags
spec, defines, requirements, shared, test, fixtures, transaction, isolation
## symbols
@@ -1,18 +1,18 @@
# 2025-05-18-test-infrastructure-improvements/specs/test-organization (index)
dir: 2025-05-18-test-infrastructure-improvements/specs/test-organization
# 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
## role
Defines testing standards and categorization requirements for the backend test suite using pytest markers.
Defines test categorization requirements for backend tests using pytest markers to distinguish unit, integration, and system test levels.
## parent
index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
map: 2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md
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
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2025-05-18-test-infrastructure-improvements/specs/test-organization
dir: 2025-05-18-test-infrastructure-improvements/specs/test-organization
# 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
index: 2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md
## role
Defines testing standards and categorization requirements for the backend test suite using pytest markers.
Defines test categorization requirements for backend tests using pytest markers to distinguish unit, integration, and system test levels.
## 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 documentation pattern establishing a three-tier test hierarchy (unit/integration/system) with marker-based test organization.
Specification-driven testing architecture using pytest marker-based test organization with clear separation of concerns across three test tiers.
## tags
tests, pytest, spec, defines, requirements, organizing, backend, unit
## symbols
@@ -1,23 +1,23 @@
# 2025-05-18-tool-types-definition (index)
dir: 2025-05-18-tool-types-definition
# openspec/changes/archive/2025-05-18-tool-types-definition (index)
dir: openspec/changes/archive/2025-05-18-tool-types-definition
## role
Design and planning package for a ToolType system that enables defining and launching development tools via Docker Compose templates.
Defines an archived OpenAPI specification for a ToolType system that enables Docker Compose-based development tool templates with variable substitution.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-18-tool-types-definition/specs
index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: 2025-05-18-tool-types-definition/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2025-05-18-tool-types-definition/.pi-map.index.md
map: 2025-05-18-tool-types-definition/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2025-05-18-tool-types-definition
dir: 2025-05-18-tool-types-definition
# openspec/changes/archive/2025-05-18-tool-types-definition
dir: openspec/changes/archive/2025-05-18-tool-types-definition
index: 2025-05-18-tool-types-definition/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md
## role
Design and planning package for a ToolType system that enables defining and launching development tools via Docker Compose templates.
Defines an archived OpenAPI specification for a ToolType system that enables Docker Compose-based development tool templates with variable substitution.
## 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
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document specifying a ToolType system for defining and managing Docker Compose-based development tool templates with variable substitution | dep: Docker Compose, Jinja2, Alembic, database, admin auth system
- proposal.md | Defines a feature proposal for adding a tool type system with Docker Compose templates to enable launching development tool instances like VS Code Server and Jupyter notebooks. | dep: SQLAlchemy, Docker Compose, apps/api/src/api/tool_types.py, apps/web/src/pages/tool-types.tsx
- tasks.md | Project task checklist tracking implementation of a ToolType CRUD feature across database, backend API, frontend, and verification phases | dep: SQLAlchemy, Alembic, Pydantic, FastAPI, React/TypeScript, pytest, ruff, mypy, npm
## arch
Documentation-driven specification pattern using OpenSpec schema configuration, layered design docs (proposal → design → tasks), and CRUD-focused implementation planning across full stack (API/UI/database).
Specification-driven design using OpenAPI metadata, phased CRUD implementation tracking, and Docker Compose template abstraction with variable substitution for portable development environments.
## tags
defines, design, implementing, development, proposal, tool, api, tasks
tool, design, proposal, api, defines, type, .openspec, tooltype
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2025-05-18-tool-types-definition/specs (index)
dir: 2025-05-18-tool-types-definition/specs
# openspec/changes/archive/2025-05-18-tool-types-definition/specs (index)
dir: openspec/changes/archive/2025-05-18-tool-types-definition/specs
## role
Contains specification documents defining tool types, interfaces, and behavioral contracts for the project's tooling system.
Contains archived specification documents from May 18, 2025 defining tool types for the OpenSpec project.
## parent
index: 2025-05-18-tool-types-definition/.pi-map.index.md
map: 2025-05-18-tool-types-definition/.pi-map.md
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
## children
- 2025-05-18-tool-types-definition/specs/tool-types-definition
index: 2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
map: 2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md
- 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
## files
## links
index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: 2025-05-18-tool-types-definition/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-18-tool-types-definition/specs
dir: 2025-05-18-tool-types-definition/specs
# openspec/changes/archive/2025-05-18-tool-types-definition/specs
dir: openspec/changes/archive/2025-05-18-tool-types-definition/specs
index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md
## role
Contains specification documents defining tool types, interfaces, and behavioral contracts for the project's tooling system.
Contains archived specification documents from May 18, 2025 defining tool types for the OpenSpec project.
## files
## arch
Document-driven specification pattern using formal interface definitions to establish contracts between tool implementations and consumers, likely supporting code generation or validation.
Archive directory storing dated specification snapshots with no active code architecture or patterns.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-18-tool-types-definition/specs/tool-types-definition (index)
dir: 2025-05-18-tool-types-definition/specs/tool-types-definition
# 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
## role
Defines specifications for a ToolType management system that enables CRUD operations, Docker Compose template validation, and variable substitution for configurable tool deployments.
Defines system requirements for a ToolType model that manages containerized tool definitions with CRUD operations, Docker Compose validation, variable substitution, and built-in seeding capabilities.
## parent
index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md
map: 2025-05-18-tool-types-definition/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
map: 2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-18-tool-types-definition/specs/tool-types-definition
dir: 2025-05-18-tool-types-definition/specs/tool-types-definition
# 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
index: 2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md
## role
Defines specifications for a ToolType management system that enables CRUD operations, Docker Compose template validation, and variable substitution for configurable tool deployments.
Defines system requirements for a ToolType model that manages containerized tool definitions with CRUD operations, Docker Compose validation, variable substitution, and built-in seeding capabilities.
## 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
- spec.md | Define system requirements for a ToolType model with CRUD API, Docker Compose template validation, variable substitution, and built-in tool type seeding | dep: REST API, Docker Compose, YAML parser, UUID, authentication/authorization system
## arch
Specification-driven architecture using markdown-based requirements documentation with structured sections for functional requirements, API design, data models, and validation rules.
Specification-driven architecture using a single markdown requirements document that defines a domain model (ToolType) with validation rules, template processing (Jinja2-style variable substitution), and seeding infrastructure for predefined tool configurations.
## tags
spec, define, requirements, tooltype, management, system, crud, api
spec, define, system, requirements, tooltype, model, crud, api
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2025-05-18-user-config-management (index)
dir: 2025-05-18-user-config-management
# openspec/changes/archive/2025-05-18-user-config-management (index)
dir: openspec/changes/archive/2025-05-18-user-config-management
## role
Design and planning package for a JSONB-backed user configuration management feature with API and UI components.
Design and specification package for a persistent user configuration management feature using PostgreSQL JSONB storage.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2025-05-18-user-config-management/specs
index: 2025-05-18-user-config-management/specs/.pi-map.index.md
map: 2025-05-18-user-config-management/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2025-05-18-user-config-management/.pi-map.index.md
map: 2025-05-18-user-config-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2025-05-18-user-config-management
dir: 2025-05-18-user-config-management
# openspec/changes/archive/2025-05-18-user-config-management
dir: openspec/changes/archive/2025-05-18-user-config-management
index: 2025-05-18-user-config-management/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md
## role
Design and planning package for a JSONB-backed user configuration management feature with API and UI components.
Design and specification package for a persistent user configuration management feature using PostgreSQL JSONB storage.
## 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
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document specifying a simple key-value user configuration system using PostgreSQL JSONB with merge semantics and lazy creation | dep: PostgreSQL, JSONB
- proposal.md | Design proposal for implementing persistent user preferences and settings storage across sessions
- 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 framework, Docker Compose, ruff, mypy, pytest, TypeScript
## arch
Specification-driven development using OpenSpec schema definitions, paired with markdown-based design documents (design.md, proposal.md, tasks.md) following a proposal → design → task breakdown workflow pattern.
Specification-driven development with phased implementation (backend API → frontend UI → verification), using lazy-creation merge semantics for JSONB key-value preferences, tracked through OpenAPI metadata, design docs, proposals, and task breakdown.
## tags
design, user, jsonb, api, frontend, configuration, .openspec, document
design, user, proposal, creation, .openspec, document, postgresql, jsonb
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2025-05-18-user-config-management/specs (index)
dir: 2025-05-18-user-config-management/specs
# openspec/changes/archive/2025-05-18-user-config-management/specs (index)
dir: openspec/changes/archive/2025-05-18-user-config-management/specs
## role
Contains specification documents defining requirements and design for the user configuration management feature.
Archives a historical specification snapshot for user configuration management features from May 18, 2025.
## parent
index: 2025-05-18-user-config-management/.pi-map.index.md
map: 2025-05-18-user-config-management/.pi-map.md
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
## children
- 2025-05-18-user-config-management/specs/user-config-management
index: 2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
map: 2025-05-18-user-config-management/specs/user-config-management/.pi-map.md
- 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
## files
## links
index: 2025-05-18-user-config-management/specs/.pi-map.index.md
map: 2025-05-18-user-config-management/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2025-05-18-user-config-management/specs
dir: 2025-05-18-user-config-management/specs
# openspec/changes/archive/2025-05-18-user-config-management/specs
dir: openspec/changes/archive/2025-05-18-user-config-management/specs
index: 2025-05-18-user-config-management/specs/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md
## role
Contains specification documents defining requirements and design for the user configuration management feature.
Archives a historical specification snapshot for user configuration management features from May 18, 2025.
## files
## arch
Documentation-driven development with structured specification files (likely markdown/txt) serving as the single source of truth for implementation requirements and acceptance criteria.
Read-only archive directory using date-based versioning with no active code or architectural patterns.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2025-05-18-user-config-management/specs/user-config-management (index)
dir: 2025-05-18-user-config-management/specs/user-config-management
# 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
## role
Defines system requirements for JSONB-based user configuration storage, retrieval, and frontend theme application.
Defines requirements for a user configuration storage system that persists JSONB key-value pairs via API endpoints and applies them to frontend themes.
## parent
index: 2025-05-18-user-config-management/specs/.pi-map.index.md
map: 2025-05-18-user-config-management/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
map: 2025-05-18-user-config-management/specs/user-config-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2025-05-18-user-config-management/specs/user-config-management
dir: 2025-05-18-user-config-management/specs/user-config-management
# 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
index: 2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
index: openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md
## role
Defines system requirements for JSONB-based user configuration storage, retrieval, and frontend theme application.
Defines requirements for a user configuration storage system that persists JSONB key-value pairs via API endpoints and applies them to frontend themes.
## files
- spec.md | Define system requirements for user configuration storage, retrieval, and frontend theme application using JSONB key-value pairs.
- spec.md | Define requirements for a user configuration storage system with JSONB key-value pairs, API endpoints, and frontend theme application
## arch
Specification-driven architecture using JSONB key-value pairs for flexible schema-less user preferences with clear separation between storage backend and frontend consumption patterns.
Specification-driven architecture using JSONB document storage with REST API layer and frontend theme binding pattern, documented in Markdown specification format.
## tags
spec, define, system, requirements, user, configuration, storage, retrieval
spec, define, requirements, user, configuration, storage, system, jsonb
## symbols
-
## workflows
@@ -1,15 +1,15 @@
# 2026-05-17-auth-oauth (index)
dir: 2026-05-17-auth-oauth
# openspec/changes/archive/2026-05-17-auth-oauth (index)
dir: openspec/changes/archive/2026-05-17-auth-oauth
## role
Authentication and authorization package implementing OAuth2/OIDC integration with Authentik for secure user session management.
Archive directory containing design documentation and implementation records for an OAuth2/OIDC authentication system with Authentik integration, internal JWTs, and database-backed refresh tokens.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-17-auth-oauth/specs
index: 2026-05-17-auth-oauth/specs/.pi-map.index.md
map: 2026-05-17-auth-oauth/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: ./.pi-map.md
- proposal.md
- tasks.md
## links
index: 2026-05-17-auth-oauth/.pi-map.index.md
map: 2026-05-17-auth-oauth/.pi-map.md
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
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2026-05-17-auth-oauth
dir: 2026-05-17-auth-oauth
# openspec/changes/archive/2026-05-17-auth-oauth
dir: openspec/changes/archive/2026-05-17-auth-oauth
index: 2026-05-17-auth-oauth/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md
## role
Authentication and authorization package implementing OAuth2/OIDC integration with Authentik for secure user session management.
Archive directory containing design documentation and implementation records for an OAuth2/OIDC authentication system with Authentik integration, internal JWTs, and database-backed refresh tokens.
## 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
- design.md | Design document specifying an OAuth2/OIDC authentication system using Authentik with internal JWT access tokens, DB-backed opaque refresh tokens, and environment-aware cookie policies. | dep: Authentik, Python async SQLAlchemy, Alembic, JWT library, JWKS client, cookie handling library
- 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
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- README.md | Implements OAuth2/OIDC authentication using Authentik with internal JWTs and database-backed refresh tokens
- design.md | Design document specifying an Authentik OIDC-based authentication system with internal JWT access tokens, DB-backed opaque refresh tokens, and environment-aware cookie policies for a Python async SQLAlchemy backend. | dep: Authentik OIDC, Python async SQLAlchemy, Alembic, JWKS, JWT, pytest, ruff, mypy
- proposal.md | Proposes a secure OAuth2/OIDC authentication system using Authentik with internal JWT access tokens, server-side refresh token management, and environment-aware cookie policies. | dep: Authentik, JWKS, JWT, database, apps/api/src, config, models, auth services, API routes, frontend
- tasks.md | This is a completed task checklist documenting the implementation of an OIDC/JWT-based authentication system with refresh tokens for a backend application. | dep: Authentik OIDC, SQLAlchemy, Alembic, PostgreSQL/asyncpg, pytest, ruff, mypy, JWKS, JWT
## arch
Layered security architecture with external IdP delegation (Authentik OIDC), internal JWT stateless access tokens, database-backed opaque refresh tokens, and environment-aware cookie security policies.
Specification-driven architecture using OpenSpec schema definitions with phased implementation tracking (design → proposal → tasks → README), documenting an async Python/SQLAlchemy backend with external IdP (Authentik OIDC), internal JWT access tokens, opaque DB refresh tokens, and environment-aware cookie security policies.
## tags
oidc, authentik, oauth2, jwt, authentication, tokens, refresh, design
jwt, tokens, oidc, authentication, authentik, refresh, internal, design
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2026-05-17-auth-oauth/specs (index)
dir: 2026-05-17-auth-oauth/specs
# openspec/changes/archive/2026-05-17-auth-oauth/specs (index)
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs
## role
Contains specification documents defining requirements, interfaces, and behavior contracts for the OAuth authentication system.
Contains archived specification documents for an OAuth-based authentication feature change from May 17, 2026, serving as historical design reference for the openspec project.
## parent
index: 2026-05-17-auth-oauth/.pi-map.index.md
map: 2026-05-17-auth-oauth/.pi-map.md
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
## children
- 2026-05-17-auth-oauth/specs/auth-oauth
index: 2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
map: 2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md
- 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
## files
## links
index: 2026-05-17-auth-oauth/specs/.pi-map.index.md
map: 2026-05-17-auth-oauth/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-05-17-auth-oauth/specs
dir: 2026-05-17-auth-oauth/specs
# openspec/changes/archive/2026-05-17-auth-oauth/specs
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs
index: 2026-05-17-auth-oauth/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md
## role
Contains specification documents defining requirements, interfaces, and behavior contracts for the OAuth authentication system.
Contains archived specification documents for an OAuth-based authentication feature change from May 17, 2026, serving as historical design reference for the openspec project.
## files
## arch
Documentation-driven design using specification files (likely markdown or similar) to formalize system requirements before implementation.
Specification-driven architecture using dated archive directories for change tracking, with isolated spec documents per feature change for versioned documentation history.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2026-05-17-auth-oauth/specs/auth-oauth (index)
dir: 2026-05-17-auth-oauth/specs/auth-oauth
# openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth (index)
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
## role
Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider.
Defines OAuth2/OIDC authentication requirements for integration with Authentik identity provider, covering session lifecycle security.
## parent
index: 2026-05-17-auth-oauth/specs/.pi-map.index.md
map: 2026-05-17-auth-oauth/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
map: 2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-17-auth-oauth/specs/auth-oauth
dir: 2026-05-17-auth-oauth/specs/auth-oauth
# openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
dir: openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth
index: 2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md
index: openspec/changes/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 OAuth2/OIDC authentication requirements for integration with Authentik identity provider, covering session lifecycle security.
## 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
- spec.md | Defines modified requirements for OAuth2/OIDC authentication, session security, token refresh, and session termination using Authentik | dep: Authentik, OAuth2, OIDC, JWKS
## arch
Specification-driven security architecture using standard OAuth2/OIDC flows with session management, token lifecycle, and secure logout patterns.
Specification-driven requirements document using markdown-based RFC-style specification format with no executable code.
## tags
oauth2, oidc, authentik, spec, specifies, authentication, session, security
oauth2, oidc, session, authentik, spec, defines, modified, requirements
## symbols
-
## workflows
@@ -1,11 +1,11 @@
# 2026-05-17-database-models (index)
dir: 2026-05-17-database-models
# openspec/changes/archive/2026-05-17-database-models (index)
dir: openspec/changes/archive/2026-05-17-database-models
## role
Database persistence layer providing SQLAlchemy 2.0 async ORM models and Alembic migration infrastructure for PostgreSQL data management in the Headquarter platform API.
Defines database ORM models and migration infrastructure for a PostgreSQL-backed async SQLAlchemy layer with UUID primary keys and Alembic version control.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
-
## files
@@ -15,8 +15,8 @@ map: ./.pi-map.md
- proposal.md
- tasks.md
## links
index: 2026-05-17-database-models/.pi-map.index.md
map: 2026-05-17-database-models/.pi-map.md
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
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2026-05-17-database-models
dir: 2026-05-17-database-models
# openspec/changes/archive/2026-05-17-database-models
dir: openspec/changes/archive/2026-05-17-database-models
index: 2026-05-17-database-models/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md
## role
Database persistence layer providing SQLAlchemy 2.0 async ORM models and Alembic migration infrastructure for PostgreSQL data management in the Headquarter platform API.
Defines database ORM models and migration infrastructure for a PostgreSQL-backed async SQLAlchemy layer with UUID primary keys and Alembic version control.
## 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
- design.md | Defines the database schema design, technology choices, and project structure for an async SQLAlchemy-based PostgreSQL ORM in an API application. | dep: SQLAlchemy 2.0, asyncpg, Alembic, pydantic-settings, PostgreSQL
- 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
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- README.md | Documents a project component responsible for implementing SQLAlchemy ORM models and Alembic database migration infrastructure for core business entities. | dep: SQLAlchemy, Alembic
- design.md | Defines the database schema design, technology choices, and architecture for an async SQLAlchemy-based PostgreSQL ORM layer with UUID primary keys, relationships, and migration strategy | dep: SQLAlchemy 2.0, asyncpg, Alembic, PostgreSQL, pydantic-settings, pytest, mypy, ruff
- proposal.md | Proposes implementing SQLAlchemy 2.0 async database models and Alembic migrations for core entities in a platform called Headquarter. | dep: SQLAlchemy 2.0, Alembic, asyncpg, pytest, mypy, ruff
- tasks.md | Tracks completed implementation tasks for building SQLAlchemy database models with async PostgreSQL support, Alembic migrations, and testing infrastructure | dep: SQLAlchemy, Alembic, pydantic-settings, PostgreSQL, pytest, mypy, ruff
## arch
Async SQLAlchemy 2.0 declarative ORM with Alembic migration tooling, following repository pattern for data access, with model-driven schema design and automated migration generation for PostgreSQL backend.
Specification-driven architecture using OpenSpec format with phased implementation tracking (design → proposal → tasks → archive), employing SQLAlchemy 2.0 async patterns, UUID-based entity relationships, and Alembic migration strategy for a platform called Headquarter.
## tags
sqlalchemy, alembic, database, defines, models, migrations, design, async
alembic, sqlalchemy, database, postgresql, models, design, async, pytest
## symbols
-
## workflows
@@ -1,15 +1,15 @@
# 2026-05-17-frontend-foundation (index)
dir: 2026-05-17-frontend-foundation
# openspec/changes/archive/2026-05-17-frontend-foundation (index)
dir: openspec/changes/archive/2026-05-17-frontend-foundation
## role
Establishes a foundational frontend architecture for authenticated React/TypeScript/Vite web applications with routing, API integration, and responsive UI patterns.
Defines a frontend foundation specification for a React/TypeScript/Vite web application with authentication, routing, and API integration capabilities.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-17-frontend-foundation/specs
index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: 2026-05-17-frontend-foundation/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: ./.pi-map.md
- proposal.md
- tasks.md
## links
index: 2026-05-17-frontend-foundation/.pi-map.index.md
map: 2026-05-17-frontend-foundation/.pi-map.md
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
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2026-05-17-frontend-foundation
dir: 2026-05-17-frontend-foundation
# openspec/changes/archive/2026-05-17-frontend-foundation
dir: openspec/changes/archive/2026-05-17-frontend-foundation
index: 2026-05-17-frontend-foundation/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md
## role
Establishes a foundational frontend architecture for authenticated React/TypeScript/Vite web applications with routing, API integration, and responsive UI patterns.
Defines a frontend foundation specification for a React/TypeScript/Vite web application with authentication, routing, and API integration capabilities.
## 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.
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- README.md | Defines a project foundation for a frontend application with authentication, routing, and API integration capabilities
- design.md | Design document outlining the frontend foundation architecture for a React/TypeScript/Vite web app with authenticated routing, responsive shell layout, and API client patterns. | dep: react-router-dom, Axios, React, TypeScript, Vite
- 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)
- proposal.md | Proposes a frontend React foundation for authentication, routing, and API integration in a web application. | 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
Document-driven specification package using OpenAPI metadata, design documents, and task tracking to define a layered frontend architecture with authenticated routing, API client abstraction, and shell-based responsive layout components.
Specification-driven architecture using OpenSpec schema with documented design-proposal-task workflow; React SPA with Vite build tooling, authenticated route guards, responsive shell layout, and centralized API client pattern.
## tags
react, frontend, routing, api, typescript, auth, foundation, application
react, frontend, routing, api, auth, foundation, application, integration
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2026-05-17-frontend-foundation/specs (index)
dir: 2026-05-17-frontend-foundation/specs
# openspec/changes/archive/2026-05-17-frontend-foundation/specs (index)
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs
## role
Contains specification documents defining requirements and design decisions for the frontend foundation layer.
Contains historical specification documents for the frontend foundation changes dated May 17, 2026, serving as an archived record of past design decisions.
## parent
index: 2026-05-17-frontend-foundation/.pi-map.index.md
map: 2026-05-17-frontend-foundation/.pi-map.md
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
## children
- 2026-05-17-frontend-foundation/specs/frontend-foundation
index: 2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
map: 2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md
- 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
## files
## links
index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: 2026-05-17-frontend-foundation/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-05-17-frontend-foundation/specs
dir: 2026-05-17-frontend-foundation/specs
# openspec/changes/archive/2026-05-17-frontend-foundation/specs
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs
index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md
## role
Contains specification documents defining requirements and design decisions for the frontend foundation layer.
Contains historical specification documents for the frontend foundation changes dated May 17, 2026, serving as an archived record of past design decisions.
## files
## arch
Documentation-driven architecture using specification files to formalize API contracts, component interfaces, and implementation standards before code development.
Simple archival storage pattern using date-based directory naming convention with flat file organization for version-controlled specification documents.
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2026-05-17-frontend-foundation/specs/frontend-foundation (index)
dir: 2026-05-17-frontend-foundation/specs/frontend-foundation
# openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation (index)
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
## role
Defines the technical specification and requirements for a React 18+ TypeScript frontend foundation with routing, authentication, layout, and HTTP client capabilities.
Defines frontend foundation specifications for a React 18+ TypeScript web application including routing, layout, HTTP client, and loading state management.
## parent
index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md
map: 2026-05-17-frontend-foundation/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
map: 2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md
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
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-05-17-frontend-foundation/specs/frontend-foundation
dir: 2026-05-17-frontend-foundation/specs/frontend-foundation
# openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
dir: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation
index: 2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md
## role
Defines the technical specification and requirements for a React 18+ TypeScript frontend foundation with routing, authentication, layout, and HTTP client capabilities.
Defines frontend foundation specifications for a React 18+ TypeScript web application including routing, layout, HTTP client, and loading state management.
## 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
- spec.md | Specifies frontend requirements for a React 18+ TypeScript web application with routing, layout, HTTP client, and loading state management. | dep: React 18+, TypeScript 5+, Vite, React Router, Axios/fetch
## arch
Specification-driven architecture using React 18 with TypeScript, likely implementing common patterns such as component-based UI, client-side routing, token-based authentication, responsive layout systems, and configurable HTTP interceptors.
Specification-driven architecture using markdown-based requirements documentation to establish foundational frontend patterns before implementation.
## tags
spec, specifies, frontend, requirements, react, typescript, web, application
## symbols
@@ -1,15 +1,15 @@
# 2026-05-17-project-management (index)
dir: 2026-05-17-project-management
# openspec/changes/archive/2026-05-17-project-management (index)
dir: openspec/changes/archive/2026-05-17-project-management
## role
Defines specifications, design, and implementation tracking for a full-stack project management feature with authenticated CRUD, ownership enforcement, and SSH key integration.
Archive of design documents for a full-stack project management feature implementing authenticated CRUD operations with ownership enforcement.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-17-project-management/specs
index: 2026-05-17-project-management/specs/.pi-map.index.md
map: 2026-05-17-project-management/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- README.md
@@ -17,8 +17,8 @@ map: ./.pi-map.md
- proposal.md
- tasks.md
## links
index: 2026-05-17-project-management/.pi-map.index.md
map: 2026-05-17-project-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,20 +1,20 @@
# 2026-05-17-project-management
dir: 2026-05-17-project-management
# openspec/changes/archive/2026-05-17-project-management
dir: openspec/changes/archive/2026-05-17-project-management
index: 2026-05-17-project-management/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md
## role
Defines specifications, design, and implementation tracking for a full-stack project management feature with authenticated CRUD, ownership enforcement, and SSH key integration.
Archive of design documents for a full-stack project management feature implementing authenticated CRUD operations with ownership enforcement.
## 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
- design.md | Design document specifying authenticated project CRUD implementation with ownership rules, default SSH key support, and frontend integration. | dep: auth-oauth, frontend-foundation, backend API routes, JWT, project service layer, repository associations, SSH key system
- 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.
- .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata
- README.md | Describes a project management system implementing CRUD operations, listing, and ownership workflows across API and frontend layers.
- design.md | Design document specifying authenticated project CRUD implementation connecting backend and frontend with ownership/security rules | dep: auth-oauth, frontend-foundation, JWT, project service layer, repository associations, SSH keys
- proposal.md | Proposes implementation of end-to-end project management functionality with authentication, ownership enforcement, and SSH key integration across backend and frontend. | dep: apps/api/src, apps/web/src, authentication, data models, SSH keys, repositories
- tasks.md | A task tracking document for implementing full-stack project management functionality with ownership enforcement, covering backend API, frontend flows, and verification steps.
## arch
Documentation-driven specification pattern using OpenAPI metadata, layered design docs (proposal → design → tasks), and separation of concerns across API/backend and frontend concerns with explicit ownership-based access control.
Specification-driven development using OpenSpec schema with phased implementation tracking across backend API, frontend UI, and security layers (SSH key integration, ownership rules).
## tags
project, frontend, management, ownership, design, tasks, defines, .openspec
frontend, project, ownership, management, api, design, backend, .openspec
## symbols
-
## workflows
@@ -1,25 +1,25 @@
# 2026-05-17-project-management/specs (index)
dir: 2026-05-17-project-management/specs
# openspec/changes/archive/2026-05-17-project-management/specs (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs
## role
Contains project specifications and requirements documentation for the 2026-05-17-project-management system.
Contains archived specification documents for project management features from a May 2026 snapshot
## parent
index: 2026-05-17-project-management/.pi-map.index.md
map: 2026-05-17-project-management/.pi-map.md
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
## children
- 2026-05-17-project-management/specs/git-repo
index: 2026-05-17-project-management/specs/git-repo/.pi-map.index.md
map: 2026-05-17-project-management/specs/git-repo/.pi-map.md
- 2026-05-17-project-management/specs/project-management
index: 2026-05-17-project-management/specs/project-management/.pi-map.index.md
map: 2026-05-17-project-management/specs/project-management/.pi-map.md
- 2026-05-17-project-management/specs/ssh-keys
index: 2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
map: 2026-05-17-project-management/specs/ssh-keys/.pi-map.md
- 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
## files
## links
index: 2026-05-17-project-management/specs/.pi-map.index.md
map: 2026-05-17-project-management/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-05-17-project-management/specs
dir: 2026-05-17-project-management/specs
# openspec/changes/archive/2026-05-17-project-management/specs
dir: openspec/changes/archive/2026-05-17-project-management/specs
index: 2026-05-17-project-management/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md
## role
Contains project specifications and requirements documentation for the 2026-05-17-project-management system.
Contains archived specification documents for project management features from a May 2026 snapshot
## files
## arch
Documentation-driven specification pattern with no code architecture; serves as the requirements foundation for downstream implementation packages.
Flat directory structure storing dated, versioned specification files with no subdirectories or code files present
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2026-05-17-project-management/specs/git-repo (index)
dir: 2026-05-17-project-management/specs/git-repo
# openspec/changes/archive/2026-05-17-project-management/specs/git-repo (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs/git-repo
## role
Defines specification requirements for cascading repository deletion when a project is deleted in a project management system.
Defines a specification for maintaining referential integrity between project and repository data through cascading deletion.
## parent
index: 2026-05-17-project-management/specs/.pi-map.index.md
map: 2026-05-17-project-management/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-17-project-management/specs/git-repo/.pi-map.index.md
map: 2026-05-17-project-management/specs/git-repo/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-17-project-management/specs/git-repo
dir: 2026-05-17-project-management/specs/git-repo
# openspec/changes/archive/2026-05-17-project-management/specs/git-repo
dir: openspec/changes/archive/2026-05-17-project-management/specs/git-repo
index: 2026-05-17-project-management/specs/git-repo/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md
## role
Defines specification requirements for cascading repository deletion when a project is deleted in a project management system.
Defines a specification for maintaining referential integrity between project and repository data through cascading deletion.
## files
- spec.md | Defines modified requirements for cascading repository deletion when a project is deleted
- spec.md | Specifies a requirement for cascading deletion of repository records when their parent project is deleted.
## arch
Specification-driven design using markdown-based requirements documentation with focus on referential integrity and cascading delete operations across project-repository boundaries.
Specification-driven design using Markdown-based requirement documentation with explicit behavioral constraints for data lifecycle management.
## tags
spec, defines, modified, requirements, cascading, repository, deletion, project
spec, specifies, requirement, cascading, deletion, repository, records, their
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-17-project-management/specs/project-management (index)
dir: 2026-05-17-project-management/specs/project-management
# openspec/changes/archive/2026-05-17-project-management/specs/project-management (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs/project-management
## role
Defines the specification requirements for a project management system including CRUD operations, access control, and SSH key management features.
Defines system requirements and specifications for a project management API with authentication, access control, and SSH key management features.
## parent
index: 2026-05-17-project-management/specs/.pi-map.index.md
map: 2026-05-17-project-management/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-17-project-management/specs/project-management/.pi-map.index.md
map: 2026-05-17-project-management/specs/project-management/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-17-project-management/specs/project-management
dir: 2026-05-17-project-management/specs/project-management
# openspec/changes/archive/2026-05-17-project-management/specs/project-management
dir: openspec/changes/archive/2026-05-17-project-management/specs/project-management
index: 2026-05-17-project-management/specs/project-management/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md
## role
Defines the specification requirements for a project management system including CRUD operations, access control, and SSH key management features.
Defines system requirements and specifications for a project management API with authentication, access control, and SSH key management features.
## files
- spec.md | Defines modified requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management
- spec.md | Defines modified system requirements for a project management API with authentication, ownership-based access control, and SSH key management.
## arch
Requirements-driven specification document using natural language descriptions of functional requirements, business rules, and system constraints without explicit architectural patterns.
Specification-driven design using Markdown-based requirements documentation with no implemented code architecture.
## tags
management, spec, defines, modified, requirements, project, system, crud
management, spec, defines, modified, system, requirements, project, api
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-17-project-management/specs/ssh-keys (index)
dir: 2026-05-17-project-management/specs/ssh-keys
# openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys (index)
dir: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
## role
Specifies requirements for SSH key management and project-level default key assignment with validation rules.
Defines requirements for SSH key management within project-scoped access control.
## parent
index: 2026-05-17-project-management/specs/.pi-map.index.md
map: 2026-05-17-project-management/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
map: 2026-05-17-project-management/specs/ssh-keys/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-17-project-management/specs/ssh-keys
dir: 2026-05-17-project-management/specs/ssh-keys
# openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
dir: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys
index: 2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
index: openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md
## role
Specifies requirements for SSH key management and project-level default key assignment with validation rules.
Defines requirements for SSH key management within project-scoped access control.
## files
- spec.md | Defines modified requirements for SSH key association with project default-key assignment validation
- spec.md | Specifies modified requirements for SSH key association with projects, restricting default-key assignment to valid keys within the authenticated owner's project scope.
## arch
Requirements specification using markdown-based structured documentation pattern.
Specification-driven requirements document using markdown-based change specification pattern.
## tags
key, spec, defines, modified, requirements, ssh, association, project
key, spec, specifies, modified, requirements, ssh, association, projects
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-05-18-database-setup-recovery (index)
dir: 2026-05-18-database-setup-recovery
# openspec/changes/archive/2026-05-18-database-setup-recovery (index)
dir: openspec/changes/archive/2026-05-18-database-setup-recovery
## role
This package contains planning and design documents for implementing automatic database setup, migration, and recovery mechanisms for a Dockerized API application.
Documents a completed database setup and recovery feature implementation for containerized API application startup resilience.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-18-database-setup-recovery/specs
index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2026-05-18-database-setup-recovery/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-05-18-database-setup-recovery
dir: 2026-05-18-database-setup-recovery
# openspec/changes/archive/2026-05-18-database-setup-recovery
dir: openspec/changes/archive/2026-05-18-database-setup-recovery
index: 2026-05-18-database-setup-recovery/.pi-map.index.md
index: openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md
## role
This package contains planning and design documents for implementing automatic database setup, migration, and recovery mechanisms for a Dockerized API application.
Documents a completed database setup and recovery feature implementation for containerized API application startup resilience.
## 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.
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document for implementing automatic database migrations, connection retries, and graceful error handling on application startup | dep: SQLAlchemy, Alembic, Docker
- proposal.md | Proposes architectural changes for automatic database initialization, migration management, and seed data handling in a containerized API application | dep: alembic, docker-compose, traefik, python/fastapi, postgres/sqlalchemy
- tasks.md | Project task checklist tracking completion of database initialization, error handling, Docker integration, and testing work items.
## arch
Documentation-driven architecture using OpenSpec for schema configuration, with designs for startup-time database initialization, connection retry with exponential backoff, migration running, and seed data handling integrated into Docker container orchestration.
Specification-driven development using OpenAPI metadata standards with structured design/proposal/task documentation pattern for tracking infrastructure feature delivery.
## tags
design, database, handling, docker, .openspec, automatic, migration, error
design, database, handling, docker, .openspec, automatic, error, application
## symbols
-
## workflows
@@ -1,19 +1,19 @@
# 2026-05-18-database-setup-recovery/specs (index)
dir: 2026-05-18-database-setup-recovery/specs
# openspec/changes/archive/2026-05-18-database-setup-recovery/specs (index)
dir: openspec/changes/archive/2026-05-18-database-setup-recovery/specs
## role
Contains specification documents defining requirements for database setup and recovery procedures.
Contains archived specification documents for database setup and recovery features from a 2026-05-18 change cycle, serving as historical design reference for the openspec project.
## parent
index: 2026-05-18-database-setup-recovery/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/.pi-map.md
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
## children
- 2026-05-18-database-setup-recovery/specs/database-initialization
index: 2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md
- 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
## files
## links
index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,13 +1,13 @@
# 2026-05-18-database-setup-recovery/specs
dir: 2026-05-18-database-setup-recovery/specs
# openspec/changes/archive/2026-05-18-database-setup-recovery/specs
dir: openspec/changes/archive/2026-05-18-database-setup-recovery/specs
index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md
## role
Contains specification documents defining requirements for database setup and recovery procedures.
Contains archived specification documents for database setup and recovery features from a 2026-05-18 change cycle, serving as historical design reference for the openspec project.
## files
## arch
Documentation-driven specification pattern with structured requirement definitions for system recovery capabilities.
Flat directory structure storing dated, immutable specification snapshots with no active code or architectural patterns—purely document archival using temporal organization (YYYY-MM-DD-descriptive-name).
## tags
-
## symbols
@@ -1,18 +1,18 @@
# 2026-05-18-database-setup-recovery/specs/database-initialization (index)
dir: 2026-05-18-database-setup-recovery/specs/database-initialization
# 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
## role
Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios.
Defines requirements for robust database initialization and connection handling during application startup.
## parent
index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/specs/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
map: 2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-18-database-setup-recovery/specs/database-initialization
dir: 2026-05-18-database-setup-recovery/specs/database-initialization
# 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
index: 2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
index: openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md
## role
Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios.
Defines requirements for robust database initialization and connection handling during application startup.
## files
- spec.md | Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios.
- spec.md | Specifies requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging for an application.
## arch
Behavior-driven specification using Gherkin syntax (Given/When/Then) to define executable requirements for database lifecycle management.
Specification-driven requirements document using markdown-based technical specification pattern.
## tags
spec, defines, software, requirements, automatic, database, initialization, connection
spec, specifies, requirements, automatic, database, initialization, connection, resilience
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-05-18-simplify-authentik-auth (index)
dir: 2026-05-18-simplify-authentik-auth
# openspec/changes/archive/2026-05-18-simplify-authentik-auth (index)
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth
## role
Authentication system migration package for replacing JWT/OIDC token-based auth with session-based cookies using Authentik OAuth2.
Archive of a 2026 proposal to simplify authentication by migrating from JWT/OIDC to session-cookie-based OAuth2 with Authentik
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-18-simplify-authentik-auth/specs
index: 2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
map: 2026-05-18-simplify-authentik-auth/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: 2026-05-18-simplify-authentik-auth/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-05-18-simplify-authentik-auth
dir: 2026-05-18-simplify-authentik-auth
# openspec/changes/archive/2026-05-18-simplify-authentik-auth
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth
index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md
## role
Authentication system migration package for replacing JWT/OIDC token-based auth with session-based cookies using Authentik OAuth2.
Archive of a 2026 proposal to simplify authentication by migrating from JWT/OIDC to session-cookie-based OAuth2 with Authentik
## 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
- .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date
- design.md | Design document for migrating from JWT-based authentication to simplified session-cookie-based OAuth2 authentication with Authentik | dep: Authentik (OAuth2), Backend session store, Redis (optional), Database (users, user_configs)
- proposal.md | Proposes replacing a complex JWT/OIDC authentication system with a simplified session-based OAuth2 flow using Authentik | dep: Authentik, OAuth2, session cookies, HTTP cookies, JWKS
- tasks.md | Project task list for migrating an application from JWT-based authentication to session-based authentication using Authentik
## arch
Documentation-driven migration planning with specification files (OpenSpec), design documents, proposals, and task tracking—no implementation code, purely planning artifacts for a backend auth architecture change.
Specification-driven change management using OpenAPI metadata with structured design documents (design/proposal/tasks) for architectural decision records
## tags
authentik, authentication, design, jwt, session, .openspec, migrating, system
authentication, authentik, design, jwt, session, oauth2, .openspec, migrating
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-18-simplify-authentik-auth/specs (index)
dir: 2026-05-18-simplify-authentik-auth/specs
# openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs (index)
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
## role
Defines technical specifications for a simplified OAuth2 authentication system using Authentik with stateless signed session cookies
Defines authentication specification for a simplified OAuth2 integration with Authentik using stateless signed session cookies
## parent
index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md
map: 2026-05-18-simplify-authentik-auth/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
map: 2026-05-18-simplify-authentik-auth/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,14 +1,14 @@
# 2026-05-18-simplify-authentik-auth/specs
dir: 2026-05-18-simplify-authentik-auth/specs
# openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
dir: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs
index: 2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md
## role
Defines technical specifications for a simplified OAuth2 authentication system using Authentik with stateless signed session cookies
Defines authentication specification for a simplified OAuth2 integration with Authentik using stateless signed session cookies
## files
- spec.md | Defines a simplified OAuth2 authentication flow using Authentik with stateless signed session cookies | dep: Authentik, HMAC-SHA256, OAuth2
- spec.md | Defines a simplified OAuth2 authentication flow using Authentik with stateless signed session cookies | dep: OAuth2, Authentik, HMAC-SHA256, session cookies
## arch
Specification-driven design using markdown documentation to define authentication flow requirements before implementation
Specification-driven design using markdown-based technical specification documents
## tags
oauth2, authentik, spec, defines, simplified, authentication, flow, stateless
## symbols
@@ -1,18 +1,18 @@
# 2026-05-19-api-documentation/.openspec (index)
dir: 2026-05-19-api-documentation/.openspec
# openspec/changes/archive/2026-05-19-api-documentation/.openspec (index)
dir: openspec/changes/archive/2026-05-19-api-documentation/.openspec
## role
Defines the OpenAPI specification configuration schema for generating API documentation
Defines configuration metadata for an archived API documentation specification snapshot
## parent
index: 2026-05-19-api-documentation/.pi-map.index.md
map: 2026-05-19-api-documentation/.pi-map.md
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
## children
-
## files
- config.yaml
## links
index: 2026-05-19-api-documentation/.openspec/.pi-map.index.md
map: 2026-05-19-api-documentation/.openspec/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-19-api-documentation/.openspec
dir: 2026-05-19-api-documentation/.openspec
# openspec/changes/archive/2026-05-19-api-documentation/.openspec
dir: openspec/changes/archive/2026-05-19-api-documentation/.openspec
index: 2026-05-19-api-documentation/.openspec/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md
## role
Defines the OpenAPI specification configuration schema for generating API documentation
Defines configuration metadata for an archived API documentation specification snapshot
## files
- config.yaml | Defines a configuration file specifying a schema-driven API documentation specification
- config.yaml | Defines a basic configuration file specifying a schema type and name for API documentation
## arch
Schema-driven configuration using YAML to specify API documentation generation parameters and metadata
Simple declarative configuration using YAML key-value pairs for schema identification
## tags
config, defines, configuration, specifying, schema, driven, api, documentation
config, defines, basic, configuration, specifying, schema, type, name
## symbols
-
## workflows
@@ -1,25 +1,25 @@
# 2026-05-19-api-documentation (index)
dir: 2026-05-19-api-documentation
# openspec/changes/archive/2026-05-19-api-documentation (index)
dir: openspec/changes/archive/2026-05-19-api-documentation
## role
Planning and design documents for improving API documentation in a FastAPI-based application.
Archive directory preserving historical API documentation improvement proposals and their implementation tracking for a FastAPI project.
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-19-api-documentation/.openspec
index: 2026-05-19-api-documentation/.openspec/.pi-map.index.md
map: 2026-05-19-api-documentation/.openspec/.pi-map.md
- 2026-05-19-api-documentation/specs
index: 2026-05-19-api-documentation/specs/.pi-map.index.md
map: 2026-05-19-api-documentation/specs/.pi-map.md
- 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
## files
- design.md
- proposal.md
- tasks.md
## links
index: 2026-05-19-api-documentation/.pi-map.index.md
map: 2026-05-19-api-documentation/.pi-map.md
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
## workflows
-
## dirty
@@ -1,18 +1,18 @@
# 2026-05-19-api-documentation
dir: 2026-05-19-api-documentation
# openspec/changes/archive/2026-05-19-api-documentation
dir: openspec/changes/archive/2026-05-19-api-documentation
index: 2026-05-19-api-documentation/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md
## role
Planning and design documents for improving API documentation in a FastAPI-based application.
Archive directory preserving historical API documentation improvement proposals and their implementation tracking for a FastAPI project.
## 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
- design.md | Design document outlining API documentation structure, health endpoints, and architecture decisions for a FastAPI-based application | dep: FastAPI, Pydantic, psutil, SQLAlchemy, PostgreSQL, Docker, OpenAPI/Swagger
- proposal.md | Proposes a plan to add comprehensive API documentation, health monitoring, and developer onboarding materials to a FastAPI-based project. | dep: FastAPI, OpenAPI/Swagger, Pydantic, ADR
- tasks.md | Tracks completed API documentation tasks across health endpoints, endpoint documentation, model documentation, README creation, architecture decisions, and quality verification for a FastAPI-based project.
## arch
Documentation-driven development with structured markdown specifications covering OpenAPI enhancements, health endpoint standards, and phased task tracking for documentation quality gates.
Document-driven change management using sequential design-proposal-tasks workflow with markdown-based specification and progress tracking.
## tags
documentation, api, fastapi, design, document, health, endpoints, openapi
documentation, fastapi, design, api, health, tasks, endpoints, architecture
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-19-api-documentation/specs (index)
dir: 2026-05-19-api-documentation/specs
# openspec/changes/archive/2026-05-19-api-documentation/specs (index)
dir: openspec/changes/archive/2026-05-19-api-documentation/specs
## role
Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project
Defines API documentation requirements and specifications for health endpoints, auto-generated docs, and developer onboarding materials for a FastAPI-based service
## parent
index: 2026-05-19-api-documentation/.pi-map.index.md
map: 2026-05-19-api-documentation/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-19-api-documentation/specs/.pi-map.index.md
map: 2026-05-19-api-documentation/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-19-api-documentation/specs
dir: 2026-05-19-api-documentation/specs
# openspec/changes/archive/2026-05-19-api-documentation/specs
dir: openspec/changes/archive/2026-05-19-api-documentation/specs
index: 2026-05-19-api-documentation/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md
## role
Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project
Defines API documentation requirements and specifications for health endpoints, auto-generated docs, and developer onboarding materials for a FastAPI-based service
## 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
- spec.md | Defines API documentation requirements and specifications for health endpoints, auto-generated docs, and developer onboarding materials for a FastAPI-based service | dep: FastAPI, Pydantic, OpenAPI/Swagger, ReDoc
## arch
Specification-driven documentation approach using markdown-based standards for API contract definition and health check endpoint design
Specification-driven documentation architecture using Markdown-based API specs with FastAPI auto-generation patterns for health endpoints and developer onboarding materials
## tags
documentation, fastapi, spec, defines, api, requirements, health, endpoint
fastapi, spec, defines, api, documentation, requirements, specifications, health
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-05-19-documentation-overhaul (index)
dir: 2026-05-19-documentation-overhaul
# openspec/changes/archive/2026-05-19-documentation-overhaul (index)
dir: openspec/changes/archive/2026-05-19-documentation-overhaul
## role
Planning and tracking documents for a comprehensive documentation overhaul initiative scheduled for 2026-05-19.
Archive directory preserving historical planning artifacts for a 2026 documentation restructuring initiative
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-19-documentation-overhaul/specs
index: 2026-05-19-documentation-overhaul/specs/.pi-map.index.md
map: 2026-05-19-documentation-overhaul/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2026-05-19-documentation-overhaul/.pi-map.index.md
map: 2026-05-19-documentation-overhaul/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-05-19-documentation-overhaul
dir: 2026-05-19-documentation-overhaul
# openspec/changes/archive/2026-05-19-documentation-overhaul
dir: openspec/changes/archive/2026-05-19-documentation-overhaul
index: 2026-05-19-documentation-overhaul/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md
## role
Planning and tracking documents for a comprehensive documentation overhaul initiative scheduled for 2026-05-19.
Archive directory preserving historical planning artifacts for a 2026 documentation restructuring initiative
## 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
- design.md | Design specification for overhauling and restructuring a software project's documentation system | dep: Markdown, Mermaid, FastAPI, GitHub Pages, Docker, Traefik, Authentik, OpenSpec
- proposal.md | Proposes a comprehensive documentation overhaul for a software project to address gaps in README, feature docs, API docs, deployment guides, architecture docs, and user guides
- tasks.md | A phased task list for overhauling and creating comprehensive documentation for a software project
## arch
Standard project management structure using OpenSpec configuration, design specification, formal proposal, and task breakdown documents.
Flat timestamped archive using date-prefixed naming with structured planning documents (design spec, proposal, task breakdown) in Markdown, governed by an OpenSpec metadata file
## tags
documentation, project, defines, creation, .openspec, structure, design, comprehensive
design, software, project, documentation, docs, openspec, .openspec, overhauling
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-19-documentation-overhaul/specs (index)
dir: 2026-05-19-documentation-overhaul/specs
# openspec/changes/archive/2026-05-19-documentation-overhaul/specs (index)
dir: openspec/changes/archive/2026-05-19-documentation-overhaul/specs
## role
Defines requirements and standards for a documentation overhaul of a project management/Git repository web application.
Defines requirements, templates, and processes for a comprehensive documentation overhaul of a software project
## parent
index: 2026-05-19-documentation-overhaul/.pi-map.index.md
map: 2026-05-19-documentation-overhaul/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-19-documentation-overhaul/specs/.pi-map.index.md
map: 2026-05-19-documentation-overhaul/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-19-documentation-overhaul/specs
dir: 2026-05-19-documentation-overhaul/specs
# openspec/changes/archive/2026-05-19-documentation-overhaul/specs
dir: openspec/changes/archive/2026-05-19-documentation-overhaul/specs
index: 2026-05-19-documentation-overhaul/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md
## role
Defines requirements and standards for a documentation overhaul of a project management/Git repository web application.
Defines requirements, templates, and processes for a comprehensive documentation overhaul of a software project
## files
- spec.md | Specification document outlining requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application
- spec.md | Specifies requirements, templates, and processes for a comprehensive documentation overhaul of a software project
## arch
Specification-driven documentation framework using structured templates, process workflows, and hierarchical requirement organization.
Specification-driven documentation standardization using markdown-based requirement definitions and process templates
## tags
spec, specification, document, outlining, requirements, templates, processes, comprehensive
spec, specifies, requirements, templates, processes, comprehensive, documentation, overhaul
## symbols
-
## workflows
@@ -1,23 +1,23 @@
# 2026-05-19-file-editor (index)
dir: 2026-05-19-file-editor
# openspec/changes/archive/2026-05-19-file-editor (index)
dir: openspec/changes/archive/2026-05-19-file-editor
## role
Design and planning documentation for a next-generation file editor component with view/edit modes, syntax highlighting, and git integration
Contains archived specification documents for a file editor feature implementation in an OpenSpec project workspace
## parent
index: ./.pi-map.index.md
map: ./.pi-map.md
index: openspec/changes/archive/.pi-map.index.md
map: openspec/changes/archive/.pi-map.md
## children
- 2026-05-19-file-editor/specs
index: 2026-05-19-file-editor/specs/.pi-map.index.md
map: 2026-05-19-file-editor/specs/.pi-map.md
- 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
## files
- .openspec.yaml
- design.md
- proposal.md
- tasks.md
## links
index: 2026-05-19-file-editor/.pi-map.index.md
map: 2026-05-19-file-editor/.pi-map.md
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
## workflows
-
## dirty
@@ -1,19 +1,19 @@
# 2026-05-19-file-editor
dir: 2026-05-19-file-editor
# openspec/changes/archive/2026-05-19-file-editor
dir: openspec/changes/archive/2026-05-19-file-editor
index: 2026-05-19-file-editor/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md
## role
Design and planning documentation for a next-generation file editor component with view/edit modes, syntax highlighting, and git integration
Contains archived specification documents for a file editor feature implementation in an OpenSpec project workspace
## 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
- design.md | Design document for a React-based file editor component with view/edit modes, syntax highlighting, and Git commit integration | dep: react-simple-code-editor, prismjs, CSS variables/theme system, Git repository API
- proposal.md | Proposes a file editor feature with syntax highlighting and editing capabilities for a repository workspace | dep: react-simple-code-editor, Prism.js, existing PUT /files/content API endpoint
- tasks.md | Project task checklist tracking implementation of a file editor component with syntax highlighting, editing, and commit capabilities | dep: react-simple-code-editor, prismjs, @types/prismjs, React, TypeScript, ESLint, ruff, mypy
## arch
Specification-driven development using OpenSpec schema definitions, phased milestone tracking, and iterative design documentation (design doc → proposal → task breakdown)
Documentation-driven specification pattern with design/proposal/task separation, using YAML metadata for schema versioning and Markdown for structured technical documentation
## tags
editor, design, syntax, highlighting, commit, react, simple, code
editor, react, design, syntax, highlighting, simple, code, prismjs
## symbols
-
## workflows
@@ -1,18 +1,18 @@
# 2026-05-19-file-editor/specs (index)
dir: 2026-05-19-file-editor/specs
# openspec/changes/archive/2026-05-19-file-editor/specs (index)
dir: openspec/changes/archive/2026-05-19-file-editor/specs
## role
Defines technical specifications and requirements for a web-based file editor with syntax highlighting and git integration.
Defines technical specifications for a web-based file editor component with syntax highlighting, view/edit modes, and Git commit integration
## parent
index: 2026-05-19-file-editor/.pi-map.index.md
map: 2026-05-19-file-editor/.pi-map.md
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
## children
-
## files
- spec.md
## links
index: 2026-05-19-file-editor/specs/.pi-map.index.md
map: 2026-05-19-file-editor/specs/.pi-map.md
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
## workflows
-
## dirty
@@ -1,16 +1,16 @@
# 2026-05-19-file-editor/specs
dir: 2026-05-19-file-editor/specs
# openspec/changes/archive/2026-05-19-file-editor/specs
dir: openspec/changes/archive/2026-05-19-file-editor/specs
index: 2026-05-19-file-editor/specs/.pi-map.index.md
index: openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.index.md
## role
Defines technical specifications and requirements for a web-based file editor with syntax highlighting and git integration.
Defines technical specifications for a web-based file editor component with syntax highlighting, view/edit modes, and Git commit integration
## files
- spec.md | Specifies requirements, API contracts, component interfaces, and testing strategy for a web-based file editor with syntax highlighting and git commit integration | dep: Prism.js, React/TypeScript (implied by interfaces), REST API endpoints, URL routing
- spec.md | Defines technical specifications for a web-based file editor component with syntax highlighting, view/edit modes, and Git commit integration | dep: Prism.js, React/TypeScript (implied), REST API backend, URL routing/state management
## arch
Specification-driven design using requirements documentation, API contracts, and interface definitions to guide implementation.
Specification-driven design with feature-based modularization, separating view and edit modes, and integrating with Git workflows for version control operations
## tags
spec, specifies, requirements, api, contracts, component, interfaces, testing
spec, defines, technical, specifications, web, editor, component, syntax
## symbols
-
## workflows

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