From c8db6ce933055f97fb71cc7755376064f9511629 Mon Sep 17 00:00:00 2001 From: Developer Date: Sun, 14 Jun 2026 18:07:01 +0000 Subject: [PATCH] fix: disable native touch panning on mobile terminal and archive specs - Change mobile terminal CSS to use touch-action: none and overscroll-behavior: none so the custom touch handler owns swipes - Archive completed/partial OpenSpec specs to openspec/changes/archive/2026-06-14-completed-specs-archive/ - Regenerate project maps Quality gates: npm run typecheck, npm run lint (apps/web) --- .pi-map.index.md | 3 +- .pi-map.md | 7 +- apps/.pi-map.index.md | 2 +- apps/.pi-map.md | 4 +- apps/web/.pi-map.index.md | 2 +- apps/web/.pi-map.md | 4 +- apps/web/src/.pi-map.md | 2 +- apps/web/src/styles/.pi-map.index.md | 2 +- apps/web/src/styles/.pi-map.md | 8 +- apps/web/src/styles/utilities.css | 37 ++- openspec/.pi-map.index.md | 69 ++-- openspec/.pi-map.md | 24 +- openspec/changes/.pi-map.index.md | 53 ++-- openspec/changes/.pi-map.md | 24 +- openspec/changes/archive/.pi-map.index.md | 300 +++++++++--------- openspec/changes/archive/.pi-map.md | 24 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 32 +- .../specs/.pi-map.md | 10 +- .../specs/auth-oauth/.pi-map.index.md | 14 +- .../specs/auth-oauth/.pi-map.md | 10 +- .../docker-infrastructure/.pi-map.index.md | 14 +- .../specs/docker-infrastructure/.pi-map.md | 10 +- .../specs/traefik-deployment/.pi-map.index.md | 14 +- .../specs/traefik-deployment/.pi-map.md | 10 +- .../2025-05-17-user-profile/.pi-map.index.md | 20 +- .../2025-05-17-user-profile/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../2025-05-17-user-profile/specs/.pi-map.md | 10 +- .../specs/user-profile/.pi-map.index.md | 14 +- .../specs/user-profile/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../2025-05-18-git-repo-management/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../git-repo-management/.pi-map.index.md | 14 +- .../specs/git-repo-management/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../2025-05-18-ssh-key-management/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../specs/ssh-key-management/.pi-map.index.md | 14 +- .../specs/ssh-key-management/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 32 +- .../specs/.pi-map.md | 10 +- .../specs/e2e-testing/.pi-map.index.md | 14 +- .../specs/e2e-testing/.pi-map.md | 10 +- .../specs/test-isolation/.pi-map.index.md | 14 +- .../specs/test-isolation/.pi-map.md | 10 +- .../specs/test-organization/.pi-map.index.md | 14 +- .../specs/test-organization/.pi-map.md | 10 +- .../.pi-map.index.md | 18 +- .../.pi-map.md | 8 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../tool-types-definition/.pi-map.index.md | 14 +- .../specs/tool-types-definition/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../user-config-management/.pi-map.index.md | 14 +- .../specs/user-config-management/.pi-map.md | 10 +- .../2026-05-17-auth-oauth/.pi-map.index.md | 20 +- .../archive/2026-05-17-auth-oauth/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../2026-05-17-auth-oauth/specs/.pi-map.md | 10 +- .../specs/auth-oauth/.pi-map.index.md | 14 +- .../specs/auth-oauth/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../2026-05-17-database-models/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../2026-05-17-frontend-foundation/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../frontend-foundation/.pi-map.index.md | 14 +- .../specs/frontend-foundation/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../2026-05-17-project-management/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 32 +- .../specs/.pi-map.md | 10 +- .../specs/git-repo/.pi-map.index.md | 14 +- .../specs/git-repo/.pi-map.md | 10 +- .../specs/project-management/.pi-map.index.md | 14 +- .../specs/project-management/.pi-map.md | 10 +- .../specs/ssh-keys/.pi-map.index.md | 14 +- .../specs/ssh-keys/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../database-initialization/.pi-map.index.md | 12 +- .../specs/database-initialization/.pi-map.md | 8 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.openspec/.pi-map.index.md | 14 +- .../.openspec/.pi-map.md | 10 +- .../.pi-map.index.md | 26 +- .../2026-05-19-api-documentation/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 12 +- .../specs/.pi-map.md | 8 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../2026-05-19-file-editor/.pi-map.index.md | 20 +- .../archive/2026-05-19-file-editor/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 12 +- .../2026-05-19-file-editor/specs/.pi-map.md | 8 +- .../2026-05-19-git-control/.pi-map.index.md | 20 +- .../archive/2026-05-19-git-control/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../2026-05-19-git-control/specs/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../2026-05-19-repo-workspace/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 12 +- .../specs/.pi-map.md | 8 +- .../.openspec/.pi-map.index.md | 14 +- .../.openspec/.pi-map.md | 10 +- .../.pi-map.index.md | 26 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.openspec/.pi-map.index.md | 14 +- .../.openspec/.pi-map.md | 10 +- .../.pi-map.index.md | 26 +- .../2026-05-19-tool-instances/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.openspec/.pi-map.index.md | 14 +- .../.openspec/.pi-map.md | 10 +- .../2026-05-19-tool-terminal/.pi-map.index.md | 26 +- .../2026-05-19-tool-terminal/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../2026-05-19-tool-terminal/specs/.pi-map.md | 10 +- .../.openspec/.pi-map.index.md | 14 +- .../.openspec/.pi-map.md | 10 +- .../.pi-map.index.md | 26 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 12 +- .../cloudflare-tunnel-management/.pi-map.md | 8 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 38 +-- .../specs/.pi-map.md | 10 +- .../frontend-foundation/.pi-map.index.md | 14 +- .../specs/frontend-foundation/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../tool-type-port-visibility/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../tool-type-single-interface/.pi-map.md | 10 +- .../tool-types-definition/.pi-map.index.md | 14 +- .../specs/tool-types-definition/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 44 +-- .../specs/.pi-map.md | 10 +- .../instance-runtime-health/.pi-map.index.md | 14 +- .../specs/instance-runtime-health/.pi-map.md | 10 +- .../instance-startup-health/.pi-map.index.md | 14 +- .../specs/instance-startup-health/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../readiness-probe-integration/.pi-map.md | 10 +- .../smart-tunnel-recovery/.pi-map.index.md | 12 +- .../specs/smart-tunnel-recovery/.pi-map.md | 8 +- .../specs/tool-instances/.pi-map.index.md | 14 +- .../specs/tool-instances/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../2026-05-22-instance-proxy/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../specs/instance-proxy/.pi-map.index.md | 14 +- .../specs/instance-proxy/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 32 +- .../specs/.pi-map.md | 10 +- .../opencode-web-server/.pi-map.index.md | 14 +- .../specs/opencode-web-server/.pi-map.md | 10 +- .../tool-port-configuration/.pi-map.index.md | 14 +- .../specs/tool-port-configuration/.pi-map.md | 10 +- .../specs/tool-types/.pi-map.index.md | 14 +- .../specs/tool-types/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 32 +- .../specs/.pi-map.md | 10 +- .../specs/git-repo/.pi-map.index.md | 14 +- .../specs/git-repo/.pi-map.md | 10 +- .../specs/repo-clone-mode/.pi-map.index.md | 12 +- .../specs/repo-clone-mode/.pi-map.md | 8 +- .../specs/tool-instances/.pi-map.index.md | 14 +- .../specs/tool-instances/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 32 +- .../specs/.pi-map.md | 10 +- .../session-lifecycle-ux/.pi-map.index.md | 12 +- .../specs/session-lifecycle-ux/.pi-map.md | 8 +- .../specs/tool-instances/.pi-map.index.md | 14 +- .../specs/tool-instances/.pi-map.md | 10 +- .../tunnel-health-monitoring/.pi-map.index.md | 14 +- .../specs/tunnel-health-monitoring/.pi-map.md | 10 +- .../.openspec/.pi-map.index.md | 14 +- .../.openspec/.pi-map.md | 10 +- .../2026-05-22-sessions-hub/.pi-map.index.md | 26 +- .../2026-05-22-sessions-hub/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../2026-05-22-sessions-hub/specs/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../tool-config-management/.pi-map.index.md | 14 +- .../specs/tool-config-management/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../tool-config-management/.pi-map.index.md | 14 +- .../specs/tool-config-management/.pi-map.md | 10 +- .../2026-05-22-tool-workshop/.pi-map.index.md | 20 +- .../2026-05-22-tool-workshop/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 14 +- .../2026-05-22-tool-workshop/specs/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../specs/tool-types/.pi-map.index.md | 14 +- .../specs/tool-types/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 38 +-- .../specs/.pi-map.md | 10 +- .../opencode-web-server/.pi-map.index.md | 14 +- .../specs/opencode-web-server/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../tool-terminal-startup-command/.pi-map.md | 10 +- .../specs/tool-terminal/.pi-map.index.md | 14 +- .../specs/tool-terminal/.pi-map.md | 10 +- .../tool-types-definition/.pi-map.index.md | 12 +- .../specs/tool-types-definition/.pi-map.md | 8 +- .../.pi-map.index.md | 20 +- .../2026-05-25-add-config-profiles/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 38 +-- .../specs/.pi-map.md | 10 +- .../specs/config-profiles/.pi-map.index.md | 14 +- .../specs/config-profiles/.pi-map.md | 10 +- .../tool-config-management/.pi-map.index.md | 14 +- .../specs/tool-config-management/.pi-map.md | 10 +- .../specs/tool-instances/.pi-map.index.md | 14 +- .../specs/tool-instances/.pi-map.md | 10 +- .../specs/user-config/.pi-map.index.md | 14 +- .../specs/user-config/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 50 +-- .../specs/.pi-map.md | 10 +- .../frontend-foundation/.pi-map.index.md | 14 +- .../specs/frontend-foundation/.pi-map.md | 10 +- .../specs/mobile-navigation/.pi-map.index.md | 14 +- .../specs/mobile-navigation/.pi-map.md | 10 +- .../.pi-map.index.md | 12 +- .../mobile-responsive-layouts/.pi-map.md | 8 +- .../.pi-map.index.md | 14 +- .../mobile-session-management/.pi-map.md | 10 +- .../session-lifecycle-ux/.pi-map.index.md | 12 +- .../specs/session-lifecycle-ux/.pi-map.md | 8 +- .../specs/tool-instances/.pi-map.index.md | 14 +- .../specs/tool-instances/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 38 +-- .../specs/.pi-map.md | 10 +- .../specs/mobile-list-detail/.pi-map.index.md | 14 +- .../specs/mobile-list-detail/.pi-map.md | 10 +- .../specs/mobile-navigation/.pi-map.index.md | 14 +- .../specs/mobile-navigation/.pi-map.md | 10 +- .../mobile-repo-workspace/.pi-map.index.md | 14 +- .../specs/mobile-repo-workspace/.pi-map.md | 10 +- .../mobile-tools-navigation/.pi-map.index.md | 14 +- .../specs/mobile-tools-navigation/.pi-map.md | 10 +- .../.pi-map.index.md | 140 ++++---- .../.pi-map.md | 20 +- .../.pi-map.index.md | 14 +- .../backend-frontend-refactoring/.pi-map.md | 10 +- .../.pi-map.index.md | 27 +- .../.pi-map.md | 24 +- .../.pi-map.index.md | 20 +- .../config-profile-git-mounts/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 26 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../config-profile-git-mounts/.pi-map.md | 10 +- .../specs/tool-instances/.pi-map.index.md | 14 +- .../specs/tool-instances/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../config-profile-includes-ui/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../specs/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../git-mount-url-validation/.pi-map.index.md | 14 +- .../git-mount-url-validation/.pi-map.md | 10 +- .../home-path-expansion/.pi-map.index.md | 14 +- .../home-path-expansion/.pi-map.md | 10 +- .../mobile-terminal-ux/.pi-map.index.md | 20 +- .../mobile-terminal-ux/.pi-map.md | 10 +- .../mobile-terminal-ux/specs/.pi-map.index.md | 32 +- .../mobile-terminal-ux/specs/.pi-map.md | 10 +- .../frontend-foundation/.pi-map.index.md | 14 +- .../specs/frontend-foundation/.pi-map.md | 10 +- .../specs/mobile-terminal-ux/.pi-map.index.md | 14 +- .../specs/mobile-terminal-ux/.pi-map.md | 10 +- .../specs/tool-terminal/.pi-map.index.md | 14 +- .../specs/tool-terminal/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../mount-specificity-ordering/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../multi-session-terminal-ux/.pi-map.md | 10 +- .../notification-center/.pi-map.index.md | 14 +- .../notification-center/.pi-map.md | 10 +- .../.pi-map.index.md | 20 +- .../persistent-terminal-sessions/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 18 +- .../specs/.pi-map.md | 8 +- .../persistent-terminal/.pi-map.index.md | 14 +- .../specs/persistent-terminal/.pi-map.md | 10 +- .../reorganize-long-files/.pi-map.index.md | 14 +- .../reorganize-long-files/.pi-map.md | 10 +- .../session-list-overhaul/.pi-map.index.md | 20 +- .../session-list-overhaul/.pi-map.md | 10 +- .../specs/.pi-map.index.md | 20 +- .../session-list-overhaul/specs/.pi-map.md | 10 +- .../specs/session-list-ui/.pi-map.index.md | 14 +- .../specs/session-list-ui/.pi-map.md | 10 +- .../ssh-key-mounting/.pi-map.index.md | 14 +- .../ssh-key-mounting/.pi-map.md | 10 +- .../.pi-map.index.md | 14 +- .../.pi-map.md | 10 +- .../.pi-map.index.md | 27 +- .../tool-config-mount-cleanup/.pi-map.md | 24 +- .../.pi-map.index.md | 20 +- .../.pi-map.md | 10 +- .../specs/.pi-map.index.md | 26 +- .../specs/.pi-map.md | 10 +- .../session-lifecycle-ux/.pi-map.index.md | 14 +- .../specs/session-lifecycle-ux/.pi-map.md | 10 +- .../specs/sessions-hub/.pi-map.index.md | 14 +- .../specs/sessions-hub/.pi-map.md | 10 +- .../working-copies/.pi-map.index.md | 14 +- .../working-copies/.pi-map.md | 10 +- .../workspace-first-ui/.pi-map.index.md | 14 +- .../workspace-first-ui/.pi-map.md | 10 +- .../.pi-map.index.md | 120 +++++++ .../.pi-map.md | 19 ++ .../README.md | 60 ++++ .../api-documentation/.pi-map.index.md | 19 ++ .../api-documentation/.pi-map.md | 19 ++ .../api-documentation/spec.md | 0 .../auth-oauth/.pi-map.index.md | 19 ++ .../auth-oauth/.pi-map.md | 19 ++ .../auth-oauth/spec.md | 0 .../database-models/.pi-map.index.md | 19 ++ .../database-models/.pi-map.md | 19 ++ .../database-models/spec.md | 0 .../docker-infrastructure/.pi-map.index.md | 19 ++ .../docker-infrastructure/.pi-map.md | 8 +- .../docker-infrastructure/spec.md | 0 .../frontend-foundation/.pi-map.index.md | 19 ++ .../frontend-foundation/.pi-map.md | 19 ++ .../frontend-foundation/spec.md | 0 .../git-repo/.pi-map.index.md | 19 ++ .../git-repo/.pi-map.md | 19 ++ .../git-repo/spec.md | 0 .../instance-proxy/.pi-map.index.md | 19 ++ .../instance-proxy/.pi-map.md | 19 ++ .../instance-proxy/spec.md | 0 .../instance-runtime-health/.pi-map.index.md | 19 ++ .../instance-runtime-health/.pi-map.md | 19 ++ .../instance-runtime-health/spec.md | 0 .../instance-startup-health/.pi-map.index.md | 19 ++ .../instance-startup-health/.pi-map.md | 19 ++ .../instance-startup-health/spec.md | 0 .../mobile-list-detail/.pi-map.index.md | 19 ++ .../mobile-list-detail/.pi-map.md | 19 ++ .../mobile-list-detail/spec.md | 0 .../mobile-navigation/.pi-map.index.md | 19 ++ .../mobile-navigation/.pi-map.md | 19 ++ .../mobile-navigation/spec.md | 0 .../mobile-repo-workspace/.pi-map.index.md | 19 ++ .../mobile-repo-workspace/.pi-map.md | 19 ++ .../mobile-repo-workspace/spec.md | 0 .../mobile-tools-navigation/.pi-map.index.md | 19 ++ .../mobile-tools-navigation/.pi-map.md | 19 ++ .../mobile-tools-navigation/spec.md | 0 .../opencode-web-server/.pi-map.index.md | 19 ++ .../opencode-web-server/.pi-map.md | 19 ++ .../opencode-web-server/spec.md | 0 .../project-management/.pi-map.index.md | 19 ++ .../project-management/.pi-map.md | 8 +- .../project-management/spec.md | 0 .../.pi-map.index.md | 19 ++ .../readiness-probe-integration/.pi-map.md | 19 ++ .../readiness-probe-integration/spec.md | 0 .../repo-clone-mode/.pi-map.index.md | 19 ++ .../repo-clone-mode/.pi-map.md | 19 ++ .../repo-clone-mode/spec.md | 0 .../session-lifecycle-ux/.pi-map.index.md | 19 ++ .../session-lifecycle-ux/.pi-map.md | 19 ++ .../session-lifecycle-ux/spec.md | 0 .../sessions-hub/.pi-map.index.md | 19 ++ .../sessions-hub/.pi-map.md | 10 +- .../sessions-hub/spec.md | 0 .../smart-tunnel-recovery/.pi-map.index.md | 19 ++ .../smart-tunnel-recovery/.pi-map.md | 19 ++ .../smart-tunnel-recovery/spec.md | 0 .../ssh-keys/.pi-map.index.md | 19 ++ .../ssh-keys/.pi-map.md | 19 ++ .../ssh-keys/spec.md | 0 .../tool-config-management/.pi-map.index.md | 19 ++ .../tool-config-management/.pi-map.md | 8 +- .../tool-config-management/spec.md | 0 .../tool-instances/.pi-map.index.md | 19 ++ .../tool-instances/.pi-map.md | 19 ++ .../tool-instances/spec.md | 0 .../tool-port-configuration/.pi-map.index.md | 19 ++ .../tool-port-configuration/.pi-map.md | 19 ++ .../tool-port-configuration/spec.md | 0 .../.pi-map.index.md | 19 ++ .../tool-terminal-startup-command/.pi-map.md | 19 ++ .../tool-terminal-startup-command/spec.md | 0 .../tool-terminal/.pi-map.index.md | 19 ++ .../tool-terminal/.pi-map.md | 19 ++ .../tool-terminal/spec.md | 0 .../.pi-map.index.md | 19 ++ .../tool-type-port-visibility/.pi-map.md | 19 ++ .../tool-type-port-visibility/spec.md | 0 .../.pi-map.index.md | 19 ++ .../tool-type-single-interface/.pi-map.md | 19 ++ .../tool-type-single-interface/spec.md | 0 .../tool-types-definition/.pi-map.index.md | 19 ++ .../tool-types-definition/.pi-map.md | 19 ++ .../tool-types-definition/spec.md | 0 .../tool-types/.pi-map.index.md | 19 ++ .../tool-types/.pi-map.md | 19 ++ .../tool-types/spec.md | 0 .../traefik-deployment/.pi-map.index.md | 19 ++ .../traefik-deployment/.pi-map.md | 19 ++ .../traefik-deployment/spec.md | 0 .../tunnel-health-monitoring/.pi-map.index.md | 19 ++ .../tunnel-health-monitoring/.pi-map.md | 19 ++ .../tunnel-health-monitoring/spec.md | 0 .../user-config/.pi-map.index.md | 19 ++ .../user-config/.pi-map.md | 19 ++ .../user-config/spec.md | 0 .../user-profile/.pi-map.index.md | 19 ++ .../user-profile/.pi-map.md | 10 +- .../user-profile/spec.md | 0 .../.pi-map.index.md | 20 ++ .../.pi-map.md | 20 ++ .../fix-tmux-mouse-config/.pi-map.index.md | 20 ++ .../changes/fix-tmux-mouse-config/.pi-map.md | 20 ++ .../.pi-map.index.md | 20 ++ .../mobile-config-profiles-ui/.pi-map.md | 20 ++ .../.pi-map.index.md | 20 ++ .../.pi-map.md | 20 ++ .../.pi-map.index.md | 20 ++ .../mobile-list-delete-button/.pi-map.md | 20 ++ .../mobile-tool-profile-ui/.pi-map.index.md | 20 ++ .../changes/mobile-tool-profile-ui/.pi-map.md | 20 ++ openspec/designs/.pi-map.index.md | 14 +- openspec/designs/.pi-map.md | 10 +- openspec/docs/.pi-map.index.md | 14 +- openspec/docs/.pi-map.md | 10 +- openspec/explorations/.pi-map.index.md | 14 +- openspec/explorations/.pi-map.md | 10 +- openspec/proposals/.pi-map.index.md | 14 +- openspec/proposals/.pi-map.md | 10 +- openspec/specs/.pi-map.index.md | 117 +------ openspec/specs/.pi-map.md | 10 +- .../specs/api-documentation/.pi-map.index.md | 19 -- openspec/specs/api-documentation/.pi-map.md | 19 -- openspec/specs/auth-oauth/.pi-map.index.md | 19 -- openspec/specs/auth-oauth/.pi-map.md | 19 -- .../specs/database-models/.pi-map.index.md | 19 -- openspec/specs/database-models/.pi-map.md | 19 -- .../docker-infrastructure/.pi-map.index.md | 19 -- .../frontend-foundation/.pi-map.index.md | 19 -- openspec/specs/frontend-foundation/.pi-map.md | 19 -- openspec/specs/git-repo/.pi-map.index.md | 19 -- openspec/specs/git-repo/.pi-map.md | 19 -- .../specs/instance-proxy/.pi-map.index.md | 19 -- openspec/specs/instance-proxy/.pi-map.md | 19 -- .../instance-runtime-health/.pi-map.index.md | 19 -- .../specs/instance-runtime-health/.pi-map.md | 19 -- .../instance-startup-health/.pi-map.index.md | 19 -- .../specs/instance-startup-health/.pi-map.md | 19 -- .../specs/mobile-list-detail/.pi-map.index.md | 19 -- openspec/specs/mobile-list-detail/.pi-map.md | 19 -- .../specs/mobile-navigation/.pi-map.index.md | 19 -- openspec/specs/mobile-navigation/.pi-map.md | 19 -- .../mobile-repo-workspace/.pi-map.index.md | 19 -- .../specs/mobile-repo-workspace/.pi-map.md | 19 -- .../mobile-tools-navigation/.pi-map.index.md | 19 -- .../specs/mobile-tools-navigation/.pi-map.md | 19 -- .../opencode-web-server/.pi-map.index.md | 19 -- openspec/specs/opencode-web-server/.pi-map.md | 19 -- .../specs/project-management/.pi-map.index.md | 19 -- .../.pi-map.index.md | 19 -- .../readiness-probe-integration/.pi-map.md | 19 -- .../specs/repo-clone-mode/.pi-map.index.md | 19 -- openspec/specs/repo-clone-mode/.pi-map.md | 19 -- .../session-lifecycle-ux/.pi-map.index.md | 19 -- .../specs/session-lifecycle-ux/.pi-map.md | 19 -- openspec/specs/sessions-hub/.pi-map.index.md | 19 -- .../smart-tunnel-recovery/.pi-map.index.md | 19 -- .../specs/smart-tunnel-recovery/.pi-map.md | 19 -- openspec/specs/ssh-keys/.pi-map.index.md | 19 -- openspec/specs/ssh-keys/.pi-map.md | 19 -- .../tool-config-management/.pi-map.index.md | 19 -- .../specs/tool-instances/.pi-map.index.md | 19 -- openspec/specs/tool-instances/.pi-map.md | 19 -- .../tool-port-configuration/.pi-map.index.md | 19 -- .../specs/tool-port-configuration/.pi-map.md | 19 -- .../.pi-map.index.md | 19 -- .../tool-terminal-startup-command/.pi-map.md | 19 -- openspec/specs/tool-terminal/.pi-map.index.md | 19 -- openspec/specs/tool-terminal/.pi-map.md | 19 -- .../.pi-map.index.md | 19 -- .../tool-type-port-visibility/.pi-map.md | 19 -- .../.pi-map.index.md | 19 -- .../tool-type-single-interface/.pi-map.md | 19 -- .../tool-types-definition/.pi-map.index.md | 19 -- .../specs/tool-types-definition/.pi-map.md | 19 -- openspec/specs/tool-types/.pi-map.index.md | 19 -- openspec/specs/tool-types/.pi-map.md | 19 -- .../specs/traefik-deployment/.pi-map.index.md | 19 -- openspec/specs/traefik-deployment/.pi-map.md | 19 -- .../tunnel-health-monitoring/.pi-map.index.md | 19 -- .../specs/tunnel-health-monitoring/.pi-map.md | 19 -- openspec/specs/user-config/.pi-map.index.md | 19 -- openspec/specs/user-config/.pi-map.md | 19 -- openspec/specs/user-profile/.pi-map.index.md | 19 -- openspec/tasks/.pi-map.index.md | 14 +- openspec/tasks/.pi-map.md | 10 +- 580 files changed, 4678 insertions(+), 4333 deletions(-) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/README.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/api-documentation/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/auth-oauth/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/database-models/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/docker-infrastructure/.pi-map.md (60%) rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/docker-infrastructure/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/frontend-foundation/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/git-repo/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/instance-proxy/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/instance-runtime-health/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/instance-startup-health/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/mobile-list-detail/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/mobile-navigation/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/mobile-repo-workspace/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/mobile-tools-navigation/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/opencode-web-server/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/project-management/.pi-map.md (57%) rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/project-management/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/readiness-probe-integration/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/repo-clone-mode/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/session-lifecycle-ux/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/sessions-hub/.pi-map.md (51%) rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/sessions-hub/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/smart-tunnel-recovery/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/ssh-keys/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-config-management/.pi-map.md (54%) rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-config-management/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-instances/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-port-configuration/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-terminal-startup-command/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-terminal/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-type-port-visibility/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-type-single-interface/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-types-definition/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tool-types/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/traefik-deployment/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/tunnel-health-monitoring/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/user-config/spec.md (100%) create mode 100644 openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/user-profile/.pi-map.md (51%) rename openspec/{specs => changes/archive/2026-06-14-completed-specs-archive}/user-profile/spec.md (100%) create mode 100644 openspec/changes/fix-terminal-container-overflow/.pi-map.index.md create mode 100644 openspec/changes/fix-terminal-container-overflow/.pi-map.md create mode 100644 openspec/changes/fix-tmux-mouse-config/.pi-map.index.md create mode 100644 openspec/changes/fix-tmux-mouse-config/.pi-map.md create mode 100644 openspec/changes/mobile-config-profiles-ui/.pi-map.index.md create mode 100644 openspec/changes/mobile-config-profiles-ui/.pi-map.md create mode 100644 openspec/changes/mobile-edit-default-bottom-actions/.pi-map.index.md create mode 100644 openspec/changes/mobile-edit-default-bottom-actions/.pi-map.md create mode 100644 openspec/changes/mobile-list-delete-button/.pi-map.index.md create mode 100644 openspec/changes/mobile-list-delete-button/.pi-map.md create mode 100644 openspec/changes/mobile-tool-profile-ui/.pi-map.index.md create mode 100644 openspec/changes/mobile-tool-profile-ui/.pi-map.md delete mode 100644 openspec/specs/api-documentation/.pi-map.index.md delete mode 100644 openspec/specs/api-documentation/.pi-map.md delete mode 100644 openspec/specs/auth-oauth/.pi-map.index.md delete mode 100644 openspec/specs/auth-oauth/.pi-map.md delete mode 100644 openspec/specs/database-models/.pi-map.index.md delete mode 100644 openspec/specs/database-models/.pi-map.md delete mode 100644 openspec/specs/docker-infrastructure/.pi-map.index.md delete mode 100644 openspec/specs/frontend-foundation/.pi-map.index.md delete mode 100644 openspec/specs/frontend-foundation/.pi-map.md delete mode 100644 openspec/specs/git-repo/.pi-map.index.md delete mode 100644 openspec/specs/git-repo/.pi-map.md delete mode 100644 openspec/specs/instance-proxy/.pi-map.index.md delete mode 100644 openspec/specs/instance-proxy/.pi-map.md delete mode 100644 openspec/specs/instance-runtime-health/.pi-map.index.md delete mode 100644 openspec/specs/instance-runtime-health/.pi-map.md delete mode 100644 openspec/specs/instance-startup-health/.pi-map.index.md delete mode 100644 openspec/specs/instance-startup-health/.pi-map.md delete mode 100644 openspec/specs/mobile-list-detail/.pi-map.index.md delete mode 100644 openspec/specs/mobile-list-detail/.pi-map.md delete mode 100644 openspec/specs/mobile-navigation/.pi-map.index.md delete mode 100644 openspec/specs/mobile-navigation/.pi-map.md delete mode 100644 openspec/specs/mobile-repo-workspace/.pi-map.index.md delete mode 100644 openspec/specs/mobile-repo-workspace/.pi-map.md delete mode 100644 openspec/specs/mobile-tools-navigation/.pi-map.index.md delete mode 100644 openspec/specs/mobile-tools-navigation/.pi-map.md delete mode 100644 openspec/specs/opencode-web-server/.pi-map.index.md delete mode 100644 openspec/specs/opencode-web-server/.pi-map.md delete mode 100644 openspec/specs/project-management/.pi-map.index.md delete mode 100644 openspec/specs/readiness-probe-integration/.pi-map.index.md delete mode 100644 openspec/specs/readiness-probe-integration/.pi-map.md delete mode 100644 openspec/specs/repo-clone-mode/.pi-map.index.md delete mode 100644 openspec/specs/repo-clone-mode/.pi-map.md delete mode 100644 openspec/specs/session-lifecycle-ux/.pi-map.index.md delete mode 100644 openspec/specs/session-lifecycle-ux/.pi-map.md delete mode 100644 openspec/specs/sessions-hub/.pi-map.index.md delete mode 100644 openspec/specs/smart-tunnel-recovery/.pi-map.index.md delete mode 100644 openspec/specs/smart-tunnel-recovery/.pi-map.md delete mode 100644 openspec/specs/ssh-keys/.pi-map.index.md delete mode 100644 openspec/specs/ssh-keys/.pi-map.md delete mode 100644 openspec/specs/tool-config-management/.pi-map.index.md delete mode 100644 openspec/specs/tool-instances/.pi-map.index.md delete mode 100644 openspec/specs/tool-instances/.pi-map.md delete mode 100644 openspec/specs/tool-port-configuration/.pi-map.index.md delete mode 100644 openspec/specs/tool-port-configuration/.pi-map.md delete mode 100644 openspec/specs/tool-terminal-startup-command/.pi-map.index.md delete mode 100644 openspec/specs/tool-terminal-startup-command/.pi-map.md delete mode 100644 openspec/specs/tool-terminal/.pi-map.index.md delete mode 100644 openspec/specs/tool-terminal/.pi-map.md delete mode 100644 openspec/specs/tool-type-port-visibility/.pi-map.index.md delete mode 100644 openspec/specs/tool-type-port-visibility/.pi-map.md delete mode 100644 openspec/specs/tool-type-single-interface/.pi-map.index.md delete mode 100644 openspec/specs/tool-type-single-interface/.pi-map.md delete mode 100644 openspec/specs/tool-types-definition/.pi-map.index.md delete mode 100644 openspec/specs/tool-types-definition/.pi-map.md delete mode 100644 openspec/specs/tool-types/.pi-map.index.md delete mode 100644 openspec/specs/tool-types/.pi-map.md delete mode 100644 openspec/specs/traefik-deployment/.pi-map.index.md delete mode 100644 openspec/specs/traefik-deployment/.pi-map.md delete mode 100644 openspec/specs/tunnel-health-monitoring/.pi-map.index.md delete mode 100644 openspec/specs/tunnel-health-monitoring/.pi-map.md delete mode 100644 openspec/specs/user-config/.pi-map.index.md delete mode 100644 openspec/specs/user-config/.pi-map.md delete mode 100644 openspec/specs/user-profile/.pi-map.index.md diff --git a/.pi-map.index.md b/.pi-map.index.md index 478b78d..9a5e8fd 100644 --- a/.pi-map.index.md +++ b/.pi-map.index.md @@ -16,7 +16,7 @@ dir: . Trust boundary: index routes, map orients, source decides. ## role -A self-hosted web-based project management and Git repository platform with OAuth2 authentication, designed for deployment via Docker Compose with Traefik reverse proxy. +Infrastructure and configuration package for a self-hosted project management platform with containerized deployment, SSO integration, and AI-assisted development workflows. ## parent - ## children @@ -69,6 +69,7 @@ A self-hosted web-based project management and Git repository platform with OAut - CHANGELOG.md - Makefile - README.md +- context.md - docker-compose.traefik.yml - docker-compose.yml - progress.md diff --git a/.pi-map.md b/.pi-map.md index 1ed326a..132e0f4 100644 --- a/.pi-map.md +++ b/.pi-map.md @@ -18,7 +18,7 @@ index: ./.pi-map.index.md Trust boundary: index routes, map orients, source decides. ## role -A self-hosted web-based project management and Git repository platform with OAuth2/SSO authentication, containerized for Docker deployment. +Infrastructure and configuration package for a self-hosted project management platform with containerized deployment, SSO integration, and AI-assisted development workflows. ## files - .env.example | Provides a template of environment variables for configuring a Headquarter application with PostgreSQL, Redis, Authentik SSO, and Docker/Traefik deployment - .gitignore | Specifies files and directories for Git to ignore across a multi-language project with Python, Node, and custom tooling | dep: Git @@ -26,14 +26,15 @@ A self-hosted web-based project management and Git repository platform with OAut - CHANGELOG.md | Documents version history and notable changes for a Git-based project management web application - Makefile | Provides standard development commands for containerized web application lifecycle management via Docker Compose | dep: docker compose, alembic, pytest, ruff, mypy, playwright, npm, postgres, redis - README.md | A self-hosted platform for managing projects, git repositories, and development tools with OAuth2 authentication. | dep: FastAPI, SQLAlchemy, Pydantic, Alembic, python-jose, React, TypeScript, Vite, React Router, Docker, PostgreSQL, Traefik, Authentik, Git +- context.md | Documents a mobile web terminal scrolling bug where CSS touch-action rules conflict with a custom touch handler, preventing proper gesture interception in xterm.js on mobile devices. | dep: React, xterm.js, CSS modules, use-terminal-page hook, MobileTerminalView, DesktopTerminalView, TerminalComponent, AppShell - docker-compose.traefik.yml | Deploys a multi-service web application (frontend, API, PostgreSQL, Redis) behind an existing Traefik reverse proxy with TLS termination and environment-configurable domains. | dep: docker, traefik, postgres, redis, authentik, docker-compose - docker-compose.yml | Defines a multi-service Docker Compose stack with PostgreSQL, Redis, API backend, and web frontend services for a "headquarter" application | dep: Docker, PostgreSQL, Redis, Vite, asyncpg, nginx - progress.md | Tracks completed and remaining tasks for a backend-frontend code refactoring project organized in 7 phases - swap-pane | Empty file with no functionality ## arch -Multi-service containerized architecture (PostgreSQL, Redis, API backend, web frontend) with reverse proxy integration (Traefik), environment-driven configuration, and AI-agent-guided development workflows via OpenSpec. +Docker Compose-based microservices architecture with frontend/backend separation, PostgreSQL/Redis data layer, Traefik reverse proxy with TLS, OAuth2 SSO via Authentik, and OpenSpec-driven AI agent orchestration. ## tags -docker, redis, git, application, postgresql, compose, traefik, project +docker, redis, git, application, postgresql, web, compose, traefik ## symbols - ## workflows diff --git a/apps/.pi-map.index.md b/apps/.pi-map.index.md index f19c62d..80dbe60 100644 --- a/apps/.pi-map.index.md +++ b/apps/.pi-map.index.md @@ -2,7 +2,7 @@ dir: apps ## role -Contains the main application entry points and top-level configurations for different deployable targets. +Container directory for all deployable application entry points in the project. ## parent index: ./.pi-map.index.md map: ./.pi-map.md diff --git a/apps/.pi-map.md b/apps/.pi-map.md index 71fa511..4dca58e 100644 --- a/apps/.pi-map.md +++ b/apps/.pi-map.md @@ -4,10 +4,10 @@ dir: apps index: apps/.pi-map.index.md ## role -Contains the main deployable applications or entry points for the project. +Container directory for all deployable application entry points in the project. ## files ## arch -Typically follows a multi-app workspace pattern where each subdirectory is an independent executable or service sharing common libraries. +Monorepo-style top-level organization following workspace/package boundary pattern with likely separate deployable units per subdirectory. ## tags - ## symbols diff --git a/apps/web/.pi-map.index.md b/apps/web/.pi-map.index.md index d7be654..6a5a4ae 100644 --- a/apps/web/.pi-map.index.md +++ b/apps/web/.pi-map.index.md @@ -2,7 +2,7 @@ dir: apps/web ## role -Frontend web application providing a browser-based UI with code editing, terminal, and routing capabilities for the "headquarter" project. +Frontend web application providing the browser-based user interface for the project, built with React/Vite and served via nginx. ## parent index: apps/.pi-map.index.md map: apps/.pi-map.md diff --git a/apps/web/.pi-map.md b/apps/web/.pi-map.md index e236167..68c2411 100644 --- a/apps/web/.pi-map.md +++ b/apps/web/.pi-map.md @@ -4,7 +4,7 @@ dir: apps/web index: apps/web/.pi-map.index.md ## role -Frontend web application providing a browser-based UI with code editing, terminal, and routing capabilities for the "headquarter" project. +Frontend web application providing the browser-based user interface for the project, built with React/Vite and served via nginx. ## files - .env.example | Template file defining example environment variables for frontend API and application URL configuration - .eslintrc.cjs | Configures ESLint for a TypeScript browser project with modern ECMAScript module support | dep: @typescript-eslint/parser, @typescript-eslint/eslint-plugin, eslint @@ -16,7 +16,7 @@ Frontend web application providing a browser-based UI with code editing, termina - tsconfig.json | TypeScript configuration file for a React project using Vite with modern ES2020 target and bundler module resolution | dep: typescript, react, vite - vite.config.ts | Configures Vite build tool for a React project with custom dev server port and Vitest test settings. | dep: vite, @vitejs/plugin-react ## arch -Modern React SPA built with Vite and TypeScript, containerized via multi-stage Docker with nginx serving, featuring client-side routing, optimized static asset delivery, and development tooling (ESLint, Vitest). +Modern SPA architecture using Vite for bundling, TypeScript for type safety, React for UI components, with containerized nginx deployment and environment-driven configuration. ## tags react, eslint, vite, typescript, dom, application, nginx, web ## symbols diff --git a/apps/web/src/.pi-map.md b/apps/web/src/.pi-map.md index 4e991b8..91f9308 100644 --- a/apps/web/src/.pi-map.md +++ b/apps/web/src/.pi-map.md @@ -10,7 +10,7 @@ Provides the core web application entry point, routing infrastructure, and share - router.tsx | Defines the React Router configuration for a web application with protected routes, nested layouts, and redirects. | exp: AppRouter | dep: react-router-dom, ./components/app-shell, ./components/protected-route, ./pages/DashboardPage, ./pages/PlaceholderPage, ./pages/ProfilePage, ./pages/ProjectsPage, ./pages/GitRepositoriesPage, ./pages/GitHistoryPage, ./pages/ProjectSettingsPage, ./pages/SettingsPage, ./pages/TerminalPage, ./pages/ToolWorkshopPage, ./pages/SshKeysPage, ./pages/ConfigProfilesPage, ./pages/SessionsPage, ./pages/WorkspacesPage, ./pages/WorkspaceDetailPage - types.ts | Defines TypeScript type definitions for user sessions, projects, repositories, and workspaces in an application. | exp: SessionUser, SessionPayload, Project, WorkspaceSummary, RepositorySummary, ProjectWithRepos ## arch -Modular React SPA with provider-based dependency injection, declarative routing with nested layouts and route guards, and centralized TypeScript type definitions. +Implements a modular React SPA architecture using React Router v6 with nested route layouts, protected route guards via authentication/session providers, and centralized TypeScript domain modeling for cross-cutting concerns. ## tags pages, styles, css, router, react, session, dom, project ## symbols diff --git a/apps/web/src/styles/.pi-map.index.md b/apps/web/src/styles/.pi-map.index.md index ca7caf9..0d79258 100644 --- a/apps/web/src/styles/.pi-map.index.md +++ b/apps/web/src/styles/.pi-map.index.md @@ -2,7 +2,7 @@ dir: apps/web/src/styles ## role -Provides the complete visual design system and styling foundation for the web application, including themes, tokens, utilities, and component-specific styles. +Provides the complete visual design system and styling foundation for the web application, encompassing global styles, theme tokens, utility classes, and component-specific styles. ## parent index: apps/web/src/.pi-map.index.md map: apps/web/src/.pi-map.md diff --git a/apps/web/src/styles/.pi-map.md b/apps/web/src/styles/.pi-map.md index ff77a07..97e38b0 100644 --- a/apps/web/src/styles/.pi-map.md +++ b/apps/web/src/styles/.pi-map.md @@ -4,16 +4,16 @@ dir: apps/web/src/styles index: apps/web/src/styles/.pi-map.index.md ## role -Provides the complete visual design system and styling foundation for the web application, including themes, tokens, utilities, and component-specific styles. +Provides the complete visual design system and styling foundation for the web application, encompassing global styles, theme tokens, utility classes, and component-specific styles. ## files - global.css | Defines global CSS styles for a web application shell layout, navigation, cards, forms, dialogs, settings pages, and responsive design patterns. | dep: CSS custom properties (CSS variables: --border, --panel, --brand, --muted, --ink, --bg, --danger, --success, --warning, --font-size-xs, --font-size-sm, --space-2, --space-3, --space-4, --space-5) - syntax-highlight.css | Stylesheet for a syntax highlighting component with toolbar, line numbers, code display, and Prism.js theme integration | dep: Prism.js - tokens.css | Defines a comprehensive CSS design token system with light/dark themes, spacing scales, breakpoints, and fluid typography for a web application. -- utilities.css | Provides responsive CSS utility classes and component styles for a web application including layout, terminal, session navigation, and mobile-specific adaptations. | dep: CSS custom properties (--space-*, --border, --bg, --muted, --brand, --danger, --danger-light, --success, --text, --text-xs, --text-sm), xterm.js (terminal library) +- utilities.css | Provides a comprehensive CSS utility system for responsive layouts, terminal interfaces, and UI components with mobile-first design patterns. | dep: CSS custom properties (--space-*, --border, --bg, --muted, --success, --text, --brand, --danger, --danger-light), xterm.js (terminal library) ## arch -Token-driven CSS architecture using CSS custom properties for light/dark theming, utility-first responsive patterns, and modular separation of concerns across global base styles, design tokens, syntax highlighting, and adaptive utilities. +Token-driven CSS architecture using CSS custom properties for themeable design system with mobile-first responsive utilities, separate component-specific stylesheets, and light/dark mode support. ## tags -space, global, css, web, application, danger, syntax, text +space, global, css, design, danger, syntax, defines, web ## symbols - ## workflows diff --git a/apps/web/src/styles/utilities.css b/apps/web/src/styles/utilities.css index 223cbea..43f0f9c 100644 --- a/apps/web/src/styles/utilities.css +++ b/apps/web/src/styles/utilities.css @@ -564,6 +564,14 @@ a.nav-item, width: 100% !important; } +/* On mobile the custom touch handler scrolls the buffer; disable native + panning/overscroll so swipe gestures are not forwarded to a scrollbar. */ +.terminal-wrapper.mobile .terminal-container, +.terminal-wrapper.mobile .terminal-container .xterm-viewport { + touch-action: none; + overscroll-behavior: none; +} + /* xterm.js manages its own positioning and sizing */ .terminal-container canvas { @@ -1771,7 +1779,7 @@ a.nav-item, /* Disable zoom on mobile terminal */ @media (max-width: 767px) { .mobile-terminal-wrapper { - touch-action: pan-y; + touch-action: none; -webkit-text-size-adjust: none; } @@ -1781,9 +1789,14 @@ a.nav-item, } .terminal-container { - touch-action: pan-y; + touch-action: none; padding: 0; } + + .terminal-wrapper.mobile .terminal-container .xterm-viewport { + touch-action: none; + overscroll-behavior: none; + } } /* Animations */ @@ -2280,8 +2293,9 @@ a.nav-item, } .mobile-edit-code { - font-family: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, - Consolas, monospace; + font-family: + "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, + monospace; font-size: 0.8125rem; } @@ -2440,8 +2454,9 @@ a.nav-item, } .mobile-form-code { - font-family: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, - Consolas, monospace; + font-family: + "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, + monospace; font-size: 0.8125rem; } @@ -2694,8 +2709,9 @@ a.nav-item, border-radius: 8px; overflow-x: auto; font-size: 0.8125rem; - font-family: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, - Consolas, monospace; + font-family: + "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, + monospace; margin: var(--space-2) 0 0 0; } @@ -2715,8 +2731,9 @@ a.nav-item, } .mobile-preview-mapping { - font-family: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, - Consolas, monospace; + font-family: + "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, + monospace; font-size: 0.8125rem; color: var(--muted); margin-top: var(--space-1); diff --git a/openspec/.pi-map.index.md b/openspec/.pi-map.index.md index 8ffb692..e3d4c8c 100644 --- a/openspec/.pi-map.index.md +++ b/openspec/.pi-map.index.md @@ -1,39 +1,52 @@ -# openspec (index) -dir: openspec +# . (index) +dir: . + +## Project Map Protocol + +1. Read this protocol and the root `.pi-map.index.md` first. +2. Use `index:` / `map:` references to open relevant directory indexes and maps. +3. Load indexes before rich maps during task-start navigation. +4. Read the local rich map and actual source before editing. +5. Treat non-empty `## dirty` sections in either artifact as stale. +6. If source and generated artifacts disagree, trust source. +7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. +8. After editing source, run `project_map_patch` for each changed file. +9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. + +Trust boundary: index routes, map orients, source decides. ## role -Defines the OpenSpec methodology and configuration for managing software requirements, specifications, and task tracking as living documentation within a Docker-based coding agent management platform. +Defines a living documentation methodology and project configuration for managing software requirements, specifications, and development discipline rules within a Docker-based coding agent platform. ## parent -index: ./.pi-map.index.md -map: ./.pi-map.md +- ## children -- openspec/changes - index: openspec/changes/.pi-map.index.md - map: openspec/changes/.pi-map.md -- openspec/designs - index: openspec/designs/.pi-map.index.md - map: openspec/designs/.pi-map.md -- openspec/docs - index: openspec/docs/.pi-map.index.md - map: openspec/docs/.pi-map.md -- openspec/explorations - index: openspec/explorations/.pi-map.index.md - map: openspec/explorations/.pi-map.md -- openspec/proposals - index: openspec/proposals/.pi-map.index.md - map: openspec/proposals/.pi-map.md -- openspec/specs - index: openspec/specs/.pi-map.index.md - map: openspec/specs/.pi-map.md -- openspec/tasks - index: openspec/tasks/.pi-map.index.md - map: openspec/tasks/.pi-map.md +- changes + index: changes/.pi-map.index.md + map: changes/.pi-map.md +- designs + index: designs/.pi-map.index.md + map: designs/.pi-map.md +- docs + index: docs/.pi-map.index.md + map: docs/.pi-map.md +- explorations + index: explorations/.pi-map.index.md + map: explorations/.pi-map.md +- proposals + index: proposals/.pi-map.index.md + map: proposals/.pi-map.md +- specs + index: specs/.pi-map.index.md + map: specs/.pi-map.md +- tasks + index: tasks/.pi-map.index.md + map: tasks/.pi-map.md ## files - README.md - config.yaml ## links -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## workflows - ## dirty diff --git a/openspec/.pi-map.md b/openspec/.pi-map.md index 211f8b5..6bb99b5 100644 --- a/openspec/.pi-map.md +++ b/openspec/.pi-map.md @@ -1,15 +1,29 @@ -# openspec -dir: openspec +# . +dir: . -index: openspec/.pi-map.index.md +index: ./.pi-map.index.md + +## Project Map Protocol + +1. Read this protocol and the root `.pi-map.index.md` first. +2. Use `index:` / `map:` references to open relevant directory indexes and maps. +3. Load indexes before rich maps during task-start navigation. +4. Read the local rich map and actual source before editing. +5. Treat non-empty `## dirty` sections in either artifact as stale. +6. If source and generated artifacts disagree, trust source. +7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. +8. After editing source, run `project_map_patch` for each changed file. +9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. + +Trust boundary: index routes, map orients, source decides. ## role -Defines the OpenSpec methodology and configuration for managing software requirements, specifications, and task tracking as living documentation within a Docker-based coding agent management platform. +Defines a living documentation methodology and project configuration for managing software requirements, specifications, and development discipline rules within a Docker-based coding agent platform. ## files - README.md | Documents the OpenSpec methodology for managing software requirements, specifications, and task tracking as living documentation within a project repository. | dep: OpenSpec CLI (@fission-ai/openspec), Docker, SQLAlchemy, Alembic, Authentik, React, TypeScript, Tailwind, Traefik, Jinja2, xterm.js, pytest, mypy, ruff, npm - config.yaml | Configuration file defining project metadata, technology stack, and software development discipline rules for a Docker-based coding agent management platform | dep: FastAPI, React, Vite, PostgreSQL, SQLAlchemy, Redis, Alembic, pytest, Docker Compose, Traefik, Authentik ## arch -Documentation-as-code pattern with YAML-based configuration management, structured metadata definitions, and rule-based discipline enforcement for AI-assisted software development workflows. +Documentation-as-code pattern with YAML-based declarative configuration separating project metadata, technology stack definitions, and behavioral rules for automated agent orchestration. ## tags software, project, docker, sqlalchemy, alembic, authentik, react, traefik ## symbols diff --git a/openspec/changes/.pi-map.index.md b/openspec/changes/.pi-map.index.md index 13f5add..82c2160 100644 --- a/openspec/changes/.pi-map.index.md +++ b/openspec/changes/.pi-map.index.md @@ -1,32 +1,37 @@ -# . (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. +# changes (index) +dir: changes ## role -This is an empty directory with no files to analyze. +Package for tracking, storing, and managing file changes or diffs in the project. ## parent -- -## children -- archive - index: archive/.pi-map.index.md - map: archive/.pi-map.md -## files -## links index: ./.pi-map.index.md map: ./.pi-map.md +## children +- changes/archive + index: changes/archive/.pi-map.index.md + map: changes/archive/.pi-map.md +- changes/fix-terminal-container-overflow + index: changes/fix-terminal-container-overflow/.pi-map.index.md + map: changes/fix-terminal-container-overflow/.pi-map.md +- changes/fix-tmux-mouse-config + index: changes/fix-tmux-mouse-config/.pi-map.index.md + map: changes/fix-tmux-mouse-config/.pi-map.md +- changes/mobile-config-profiles-ui + index: changes/mobile-config-profiles-ui/.pi-map.index.md + map: changes/mobile-config-profiles-ui/.pi-map.md +- changes/mobile-edit-default-bottom-actions + index: changes/mobile-edit-default-bottom-actions/.pi-map.index.md + map: changes/mobile-edit-default-bottom-actions/.pi-map.md +- changes/mobile-list-delete-button + index: changes/mobile-list-delete-button/.pi-map.index.md + map: changes/mobile-list-delete-button/.pi-map.md +- changes/mobile-tool-profile-ui + index: changes/mobile-tool-profile-ui/.pi-map.index.md + map: changes/mobile-tool-profile-ui/.pi-map.md +## files +## links +index: changes/.pi-map.index.md +map: changes/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/.pi-map.md b/openspec/changes/.pi-map.md index 878b2e2..cee2d9f 100644 --- a/openspec/changes/.pi-map.md +++ b/openspec/changes/.pi-map.md @@ -1,27 +1,13 @@ -# . -dir: . +# changes +dir: changes -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: changes/.pi-map.index.md ## role -This is an empty directory with no files to analyze. +Package for tracking, storing, and managing file changes or diffs in the project. ## files ## arch -N/A - no code or architecture present +Likely implements a change-log or diff-storage pattern, possibly with immutable change records and versioning for audit trails or synchronization. ## tags - ## symbols diff --git a/openspec/changes/archive/.pi-map.index.md b/openspec/changes/archive/.pi-map.index.md index cc80d5a..14ac49d 100644 --- a/openspec/changes/archive/.pi-map.index.md +++ b/openspec/changes/archive/.pi-map.index.md @@ -1,151 +1,167 @@ -# archive (index) -dir: archive +# . (index) +dir: . + +## Project Map Protocol + +1. Read this protocol and the root `.pi-map.index.md` first. +2. Use `index:` / `map:` references to open relevant directory indexes and maps. +3. Load indexes before rich maps during task-start navigation. +4. Read the local rich map and actual source before editing. +5. Treat non-empty `## dirty` sections in either artifact as stale. +6. If source and generated artifacts disagree, trust source. +7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. +8. After editing source, run `project_map_patch` for each changed file. +9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. + +Trust boundary: index routes, map orients, source decides. ## role -Contains historical or deprecated code and resources that are no longer active in the project but retained for reference or backup purposes. +This is an empty package directory with no files to analyze. ## parent -index: ./.pi-map.index.md -map: ./.pi-map.md +- ## children -- archive/2025-05-17-oauth-traefik-integration - index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md - map: archive/2025-05-17-oauth-traefik-integration/.pi-map.md -- archive/2025-05-17-user-profile - index: archive/2025-05-17-user-profile/.pi-map.index.md - map: archive/2025-05-17-user-profile/.pi-map.md -- archive/2025-05-18-git-repo-management - index: archive/2025-05-18-git-repo-management/.pi-map.index.md - map: archive/2025-05-18-git-repo-management/.pi-map.md -- archive/2025-05-18-ssh-key-management - index: archive/2025-05-18-ssh-key-management/.pi-map.index.md - map: archive/2025-05-18-ssh-key-management/.pi-map.md -- archive/2025-05-18-test-infrastructure-improvements - index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md - map: archive/2025-05-18-test-infrastructure-improvements/.pi-map.md -- archive/2025-05-18-tool-types-definition - index: archive/2025-05-18-tool-types-definition/.pi-map.index.md - map: archive/2025-05-18-tool-types-definition/.pi-map.md -- archive/2025-05-18-user-config-management - index: archive/2025-05-18-user-config-management/.pi-map.index.md - map: archive/2025-05-18-user-config-management/.pi-map.md -- archive/2026-05-17-auth-oauth - index: archive/2026-05-17-auth-oauth/.pi-map.index.md - map: archive/2026-05-17-auth-oauth/.pi-map.md -- archive/2026-05-17-database-models - index: archive/2026-05-17-database-models/.pi-map.index.md - map: archive/2026-05-17-database-models/.pi-map.md -- archive/2026-05-17-frontend-foundation - index: archive/2026-05-17-frontend-foundation/.pi-map.index.md - map: archive/2026-05-17-frontend-foundation/.pi-map.md -- archive/2026-05-17-project-management - index: archive/2026-05-17-project-management/.pi-map.index.md - map: archive/2026-05-17-project-management/.pi-map.md -- archive/2026-05-18-database-setup-recovery - index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md - map: archive/2026-05-18-database-setup-recovery/.pi-map.md -- archive/2026-05-18-simplify-authentik-auth - index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md - map: archive/2026-05-18-simplify-authentik-auth/.pi-map.md -- archive/2026-05-19-api-documentation - index: archive/2026-05-19-api-documentation/.pi-map.index.md - map: archive/2026-05-19-api-documentation/.pi-map.md -- archive/2026-05-19-documentation-overhaul - index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md - map: archive/2026-05-19-documentation-overhaul/.pi-map.md -- archive/2026-05-19-file-editor - index: archive/2026-05-19-file-editor/.pi-map.index.md - map: archive/2026-05-19-file-editor/.pi-map.md -- archive/2026-05-19-git-control - index: archive/2026-05-19-git-control/.pi-map.index.md - map: archive/2026-05-19-git-control/.pi-map.md -- archive/2026-05-19-git-history-visualization - index: archive/2026-05-19-git-history-visualization/.pi-map.index.md - map: archive/2026-05-19-git-history-visualization/.pi-map.md -- archive/2026-05-19-repo-workspace - index: archive/2026-05-19-repo-workspace/.pi-map.index.md - map: archive/2026-05-19-repo-workspace/.pi-map.md -- archive/2026-05-19-responsive-spacing-improvements - index: archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md - map: archive/2026-05-19-responsive-spacing-improvements/.pi-map.md -- archive/2026-05-19-smart-git-url-parsing - index: archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md - map: archive/2026-05-19-smart-git-url-parsing/.pi-map.md -- archive/2026-05-19-tool-instances - index: archive/2026-05-19-tool-instances/.pi-map.index.md - map: archive/2026-05-19-tool-instances/.pi-map.md -- archive/2026-05-19-tool-terminal - index: archive/2026-05-19-tool-terminal/.pi-map.index.md - map: archive/2026-05-19-tool-terminal/.pi-map.md -- archive/2026-05-19-universal-icon-system - index: archive/2026-05-19-universal-icon-system/.pi-map.index.md - map: archive/2026-05-19-universal-icon-system/.pi-map.md -- archive/2026-05-19-workspace-visual-overhaul - index: archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md - map: archive/2026-05-19-workspace-visual-overhaul/.pi-map.md -- archive/2026-05-22-cloudflare-tunnel-instances-superseded - index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md - map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md -- archive/2026-05-22-enforce-single-tool-type-with-port-config - index: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md - map: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md -- archive/2026-05-22-git-repo-ssh-clone-check - index: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md - map: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md -- archive/2026-05-22-git-repo-working-clones - index: archive/2026-05-22-git-repo-working-clones/.pi-map.index.md - map: archive/2026-05-22-git-repo-working-clones/.pi-map.md -- archive/2026-05-22-instance-health-monitoring - index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/.pi-map.md -- archive/2026-05-22-instance-proxy - index: archive/2026-05-22-instance-proxy/.pi-map.index.md - map: archive/2026-05-22-instance-proxy/.pi-map.md -- archive/2026-05-22-opencode-web-terminal - index: archive/2026-05-22-opencode-web-terminal/.pi-map.index.md - map: archive/2026-05-22-opencode-web-terminal/.pi-map.md -- archive/2026-05-22-repo-clone-mode-with-ssh - index: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md - map: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md -- archive/2026-05-22-session-management-fixes - index: archive/2026-05-22-session-management-fixes/.pi-map.index.md - map: archive/2026-05-22-session-management-fixes/.pi-map.md -- archive/2026-05-22-sessions-hub - index: archive/2026-05-22-sessions-hub/.pi-map.index.md - map: archive/2026-05-22-sessions-hub/.pi-map.md -- archive/2026-05-22-tool-config-management - index: archive/2026-05-22-tool-config-management/.pi-map.index.md - map: archive/2026-05-22-tool-config-management/.pi-map.md -- archive/2026-05-22-tool-config-ui-rework - index: archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md - map: archive/2026-05-22-tool-config-ui-rework/.pi-map.md -- archive/2026-05-22-tool-workshop - index: archive/2026-05-22-tool-workshop/.pi-map.index.md - map: archive/2026-05-22-tool-workshop/.pi-map.md -- archive/2026-05-22-ui-redesign-home-settings - index: archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md - map: archive/2026-05-22-ui-redesign-home-settings/.pi-map.md -- archive/2026-05-23-remove-built-in-tools - index: archive/2026-05-23-remove-built-in-tools/.pi-map.index.md - map: archive/2026-05-23-remove-built-in-tools/.pi-map.md -- archive/2026-05-24-terminal-startup-and-container-tools - index: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md - map: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md -- archive/2026-05-25-add-config-profiles - index: archive/2026-05-25-add-config-profiles/.pi-map.index.md - map: archive/2026-05-25-add-config-profiles/.pi-map.md -- archive/2026-05-25-mobile-app-usability - index: archive/2026-05-25-mobile-app-usability/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/.pi-map.md -- archive/2026-05-25-mobile-pages-overhaul - index: archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md - map: archive/2026-05-25-mobile-pages-overhaul/.pi-map.md -- archive/2026-06-12-completed-changes-archive - index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/.pi-map.md +- 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 ## files ## links -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/.pi-map.md b/openspec/changes/archive/.pi-map.md index dcdf178..13e37b0 100644 --- a/openspec/changes/archive/.pi-map.md +++ b/openspec/changes/archive/.pi-map.md @@ -1,13 +1,27 @@ -# archive -dir: archive +# . +dir: . -index: archive/.pi-map.index.md +index: ./.pi-map.index.md + +## Project Map Protocol + +1. Read this protocol and the root `.pi-map.index.md` first. +2. Use `index:` / `map:` references to open relevant directory indexes and maps. +3. Load indexes before rich maps during task-start navigation. +4. Read the local rich map and actual source before editing. +5. Treat non-empty `## dirty` sections in either artifact as stale. +6. If source and generated artifacts disagree, trust source. +7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. +8. After editing source, run `project_map_patch` for each changed file. +9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. + +Trust boundary: index routes, map orients, source decides. ## role -Contains historical or deprecated code and resources that are no longer active in the project but retained for reference or backup purposes. +This is an empty package directory with no files to analyze. ## files ## arch -No active architecture; typically flat storage of obsolete files with no dependencies or patterns, isolated from the main codebase. +N/A - no code or architecture patterns present ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md index 023baa7..f82fe39 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2025-05-17-oauth-traefik-integration (index) -dir: archive/2025-05-17-oauth-traefik-integration +# 2025-05-17-oauth-traefik-integration (index) +dir: 2025-05-17-oauth-traefik-integration ## role -Designs and tracks the integration of a Docker-based application with Traefik reverse proxy and Authentik OAuth through environment-based configuration externalization. +Infrastructure integration package for deploying a Docker-based application behind an existing Traefik reverse proxy with OAuth authentication via Authentik. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-17-oauth-traefik-integration/specs - index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md - map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/.pi-map.md +index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md +map: 2025-05-17-oauth-traefik-integration/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md index ca8487c..f0b158d 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2025-05-17-oauth-traefik-integration -dir: archive/2025-05-17-oauth-traefik-integration +# 2025-05-17-oauth-traefik-integration +dir: 2025-05-17-oauth-traefik-integration -index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md +index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md ## role -Designs and tracks the integration of a Docker-based application with Traefik reverse proxy and Authentik OAuth through environment-based configuration externalization. +Infrastructure integration package for deploying a Docker-based application behind an existing Traefik reverse proxy with OAuth authentication via Authentik. ## files - .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date - design.md | Design document for making a Docker-based application deployable behind an existing Traefik reverse proxy by removing hardcoded URLs and adding environment-based configuration | dep: Docker, Docker Compose, Traefik, Authentik, Python (config.py, auth.py), Vite (frontend) - proposal.md | Proposes architectural changes to externalize Authentik/domain configuration to environment variables and add Traefik reverse proxy deployment support. - tasks.md | A task tracking document for externalizing authentication/domain configuration, creating Traefik deployment, updating frontend config, and running verification tests. ## arch -Documentation-driven design process using markdown specifications with phased task tracking, focusing on 12-factor app configuration principles (env vars over hardcoded values) and reverse proxy deployment patterns. +Environment-driven configuration pattern replacing hardcoded URLs with externalized variables, plus reverse proxy integration using Traefik labels and Docker Compose deployment orchestration. ## tags traefik, design, configuration, .openspec, document, docker, reverse, proxy ## symbols diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md index 9f66eda..2f99a20 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2025-05-17-oauth-traefik-integration/specs (index) -dir: archive/2025-05-17-oauth-traefik-integration/specs +# 2025-05-17-oauth-traefik-integration/specs (index) +dir: 2025-05-17-oauth-traefik-integration/specs ## role -Contains specification documents for OAuth-Traefik integration design. +Contains specification documents and design requirements for the OAuth-Traefik integration feature ## parent -index: archive/2025-05-17-oauth-traefik-integration/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/.pi-map.md +index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md +map: 2025-05-17-oauth-traefik-integration/.pi-map.md ## children -- archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth - index: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md - map: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md -- archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure - index: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md - map: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md -- archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment - index: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md - map: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md +index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md +map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md index 2b1df15..1e62ffe 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-17-oauth-traefik-integration/specs -dir: archive/2025-05-17-oauth-traefik-integration/specs +# 2025-05-17-oauth-traefik-integration/specs +dir: 2025-05-17-oauth-traefik-integration/specs -index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md +index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md ## role -Contains specification documents for OAuth-Traefik integration design. +Contains specification documents and design requirements for the OAuth-Traefik integration feature ## files ## arch -Documentation-only package with no code architecture; stores technical specifications and design documents. +Documentation-driven development with structured specification files (likely markdown/asciidoc) defining system requirements, API contracts, and integration patterns before implementation ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md index b5b88f3..2b32992 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth (index) -dir: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth +# 2025-05-17-oauth-traefik-integration/specs/auth-oauth (index) +dir: 2025-05-17-oauth-traefik-integration/specs/auth-oauth ## role -Defines OAuth2/OIDC authentication requirements using Authentik with session security via httpOnly cookies for the Traefik integration project. +Defines authentication requirements for OAuth2/OIDC integration with Authentik and secure session management using httpOnly cookies. ## parent -index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md +index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md +map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md index 4cb1d48..0d7a1a1 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth -dir: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth +# 2025-05-17-oauth-traefik-integration/specs/auth-oauth +dir: 2025-05-17-oauth-traefik-integration/specs/auth-oauth -index: archive/2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md +index: 2025-05-17-oauth-traefik-integration/specs/auth-oauth/.pi-map.index.md ## role -Defines OAuth2/OIDC authentication requirements using Authentik with session security via httpOnly cookies for the Traefik integration project. +Defines authentication requirements 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 ## arch -Specification-driven requirements document using markdown-based technical specification pattern with security-focused authentication flow definitions. +Specification-driven architecture with external identity provider delegation, token-based authentication flows, and cookie-based session security patterns. ## tags oauth2, oidc, authentik, spec, specifies, modified, requirements, authentication ## symbols diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md index 4e19102..29f082d 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure (index) -dir: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure +# 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure (index) +dir: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure ## role -Defines Docker infrastructure requirements and environment configuration specifications for the OAuth-Traefik integration project using behavior-driven examples. +Defines Docker infrastructure specifications using behavior-driven development examples to validate environment configuration and service orchestration requirements. ## parent -index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md +index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md +map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md index 92b8598..2850208 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure -dir: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure +# 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure +dir: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure -index: archive/2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md +index: 2025-05-17-oauth-traefik-integration/specs/docker-infrastructure/.pi-map.index.md ## role -Defines Docker infrastructure requirements and environment configuration specifications for the OAuth-Traefik integration project using behavior-driven examples. +Defines Docker infrastructure specifications using behavior-driven development examples to validate environment configuration and service orchestration requirements. ## files - spec.md | Defines modified requirements for Docker Compose setup and environment configuration using specification by example (Gherkin-style scenarios) | dep: Docker Compose, Traefik ## arch -Specification-by-example pattern with Gherkin-style scenarios documenting Docker Compose setup requirements as executable documentation. +Specification-by-example pattern with Gherkin-style scenarios for executable requirements, targeting Docker Compose-based infrastructure validation. ## tags spec, defines, modified, requirements, docker, compose, setup, environment ## symbols diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md index bd2b7e1..c65212f 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment (index) -dir: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment +# 2025-05-17-oauth-traefik-integration/specs/traefik-deployment (index) +dir: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment ## role -Defines deployment specifications for Traefik reverse proxy integration with OAuth authentication services +Defines deployment specifications for Traefik reverse proxy infrastructure in a Docker Compose environment. ## parent -index: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/.pi-map.md +index: 2025-05-17-oauth-traefik-integration/specs/.pi-map.index.md +map: 2025-05-17-oauth-traefik-integration/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md -map: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md index 1126200..347d23c 100644 --- a/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment -dir: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment +# 2025-05-17-oauth-traefik-integration/specs/traefik-deployment +dir: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment -index: archive/2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md +index: 2025-05-17-oauth-traefik-integration/specs/traefik-deployment/.pi-map.index.md ## role -Defines deployment specifications for Traefik reverse proxy integration with OAuth authentication services +Defines deployment specifications for Traefik reverse proxy infrastructure in a Docker Compose environment. ## files - spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC ## arch -Infrastructure-as-documentation pattern using Markdown specification files for declarative container orchestration configuration +Infrastructure-as-specification pattern using markdown-based requirements documentation for containerized reverse proxy deployment. ## tags traefik, spec, specifies, requirements, docker, compose, deployment, configuration ## symbols diff --git a/openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md b/openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md index ab37e32..9c37392 100644 --- a/openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-user-profile/.pi-map.index.md @@ -1,15 +1,15 @@ -# archive/2025-05-17-user-profile (index) -dir: archive/2025-05-17-user-profile +# 2025-05-17-user-profile (index) +dir: 2025-05-17-user-profile ## role -Archive of planning and design documents for an authenticated user profile management feature implementation. +Design and planning package for an authenticated user profile management feature with read/update endpoints, frontend page, and avatar upload. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-17-user-profile/specs - index: archive/2025-05-17-user-profile/specs/.pi-map.index.md - map: archive/2025-05-17-user-profile/specs/.pi-map.md +- 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 ## files - .openspec.yaml - README.md @@ -17,8 +17,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2025-05-17-user-profile/.pi-map.index.md -map: archive/2025-05-17-user-profile/.pi-map.md +index: 2025-05-17-user-profile/.pi-map.index.md +map: 2025-05-17-user-profile/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-user-profile/.pi-map.md b/openspec/changes/archive/2025-05-17-user-profile/.pi-map.md index 23afa7e..4451c54 100644 --- a/openspec/changes/archive/2025-05-17-user-profile/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-user-profile/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2025-05-17-user-profile -dir: archive/2025-05-17-user-profile +# 2025-05-17-user-profile +dir: 2025-05-17-user-profile -index: archive/2025-05-17-user-profile/.pi-map.index.md +index: 2025-05-17-user-profile/.pi-map.index.md ## role -Archive of planning and design documents for an authenticated user profile management feature implementation. +Design and planning package for an authenticated user profile management feature with read/update endpoints, frontend page, and avatar upload. ## files - .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date - README.md | Documents the implementation of an authenticated user profile read/update flow across API and frontend @@ -12,7 +12,7 @@ Archive of planning and design documents for an authenticated user profile manag - proposal.md | Proposes implementing authenticated user profile management with read/update endpoints, frontend page, and avatar upload functionality. | dep: apps/api/src/api/, apps/web/src/, auth-oauth, User model - tasks.md | Tracks implementation tasks for a user profile feature across backend API and frontend, with completion status and follow-up notes. ## arch -Specification-driven development using OpenAPI standards, with phased task tracking across backend API and frontend layers. +Specification-driven development using OpenAPI schema definitions, with phased task tracking across backend API and frontend implementation, documented through proposal, design, and task artifacts. ## tags api, user, profile, frontend, design, tasks, .openspec, implementation ## symbols diff --git a/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md index 5b58abc..c14b6f9 100644 --- a/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2025-05-17-user-profile/specs (index) -dir: archive/2025-05-17-user-profile/specs +# 2025-05-17-user-profile/specs (index) +dir: 2025-05-17-user-profile/specs ## role -Contains specification documents for the user profile feature that was archived on May 17, 2025. +Contains specification documents defining requirements and behavior for the user profile feature. ## parent -index: archive/2025-05-17-user-profile/.pi-map.index.md -map: archive/2025-05-17-user-profile/.pi-map.md +index: 2025-05-17-user-profile/.pi-map.index.md +map: 2025-05-17-user-profile/.pi-map.md ## children -- archive/2025-05-17-user-profile/specs/user-profile - index: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md - map: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-17-user-profile/specs/.pi-map.index.md -map: archive/2025-05-17-user-profile/specs/.pi-map.md +index: 2025-05-17-user-profile/specs/.pi-map.index.md +map: 2025-05-17-user-profile/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md b/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md index d07538a..65fdd3b 100644 --- a/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-user-profile/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-17-user-profile/specs -dir: archive/2025-05-17-user-profile/specs +# 2025-05-17-user-profile/specs +dir: 2025-05-17-user-profile/specs -index: archive/2025-05-17-user-profile/specs/.pi-map.index.md +index: 2025-05-17-user-profile/specs/.pi-map.index.md ## role -Contains specification documents for the user profile feature that was archived on May 17, 2025. +Contains specification documents defining requirements and behavior for the user profile feature. ## files ## arch -N/A (no code files present; directory contains only archived specification documents) +Documentation-driven specification pattern with date-based versioning for feature scoping. ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md b/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md index 835a5ed..6d850b3 100644 --- a/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-17-user-profile/specs/user-profile (index) -dir: archive/2025-05-17-user-profile/specs/user-profile +# 2025-05-17-user-profile/specs/user-profile (index) +dir: 2025-05-17-user-profile/specs/user-profile ## role -Defines functional specifications for user profile management capabilities including profile data operations and avatar handling +Defines functional specifications for a user profile management system including profile retrieval, updates, and local avatar storage ## parent -index: archive/2025-05-17-user-profile/specs/.pi-map.index.md -map: archive/2025-05-17-user-profile/specs/.pi-map.md +index: 2025-05-17-user-profile/specs/.pi-map.index.md +map: 2025-05-17-user-profile/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md -map: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md b/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md index 848a9d8..606312c 100644 --- a/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md +++ b/openspec/changes/archive/2025-05-17-user-profile/specs/user-profile/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-17-user-profile/specs/user-profile -dir: archive/2025-05-17-user-profile/specs/user-profile +# 2025-05-17-user-profile/specs/user-profile +dir: 2025-05-17-user-profile/specs/user-profile -index: archive/2025-05-17-user-profile/specs/user-profile/.pi-map.index.md +index: 2025-05-17-user-profile/specs/user-profile/.pi-map.index.md ## role -Defines functional specifications for user profile management capabilities including profile data operations and avatar handling +Defines functional specifications for a user profile management system including profile 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 ## arch -Specification-driven design using markdown-based requirements documentation with modular feature decomposition (retrieval, updates, local storage) +Specification-driven design with markdown-based requirements documentation ## tags profile, npm, spec, defines, functional, specifications, user, management ## symbols diff --git a/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md b/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md index 0eae9eb..d173e5e 100644 --- a/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2025-05-18-git-repo-management (index) -dir: archive/2025-05-18-git-repo-management +# 2025-05-18-git-repo-management (index) +dir: 2025-05-18-git-repo-management ## role -Proposes and designs a git repository management feature for projects, including bare repo creation, listing, cloning, and deletion across backend and frontend. +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. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-18-git-repo-management/specs - index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md - map: archive/2025-05-18-git-repo-management/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2025-05-18-git-repo-management/.pi-map.index.md -map: archive/2025-05-18-git-repo-management/.pi-map.md +index: 2025-05-18-git-repo-management/.pi-map.index.md +map: 2025-05-18-git-repo-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md b/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md index 06b4cb0..1e44665 100644 --- a/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-git-repo-management/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2025-05-18-git-repo-management -dir: archive/2025-05-18-git-repo-management +# 2025-05-18-git-repo-management +dir: 2025-05-18-git-repo-management -index: archive/2025-05-18-git-repo-management/.pi-map.index.md +index: 2025-05-18-git-repo-management/.pi-map.index.md ## role -Proposes and designs a git repository management feature for projects, including bare repo creation, listing, cloning, and deletion across backend and frontend. +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. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document specifying a bare git repository management system for projects with create/list/clone/delete operations | dep: git, filesystem, database, API, Dockerfile - proposal.md | Proposes a feature to add git repository creation, cloning, and management capabilities within existing projects | dep: project-management, git, backend API, frontend UI, disk storage - tasks.md | Project task checklist tracking implementation of a Git repository management feature across backend API, frontend UI, and project integration with verification steps. ## arch -Specification-driven development using OpenSpec schema configuration, phased task tracking with verification gates, and layered documentation (proposal → design → implementation tasks). +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. ## tags git, management, design, repository, project, creation, .openspec, projects ## symbols diff --git a/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md index 295f657..a91868f 100644 --- a/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2025-05-18-git-repo-management/specs (index) -dir: archive/2025-05-18-git-repo-management/specs +# 2025-05-18-git-repo-management/specs (index) +dir: 2025-05-18-git-repo-management/specs ## role -Defines specifications and requirements for git repository management functionality. +Contains specification documents that define requirements, standards, or design contracts for the git repository management project. ## parent -index: archive/2025-05-18-git-repo-management/.pi-map.index.md -map: archive/2025-05-18-git-repo-management/.pi-map.md +index: 2025-05-18-git-repo-management/.pi-map.index.md +map: 2025-05-18-git-repo-management/.pi-map.md ## children -- archive/2025-05-18-git-repo-management/specs/git-repo-management - index: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md - map: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md -map: archive/2025-05-18-git-repo-management/specs/.pi-map.md +index: 2025-05-18-git-repo-management/specs/.pi-map.index.md +map: 2025-05-18-git-repo-management/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md b/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md index 8e449f1..35004c7 100644 --- a/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-git-repo-management/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-18-git-repo-management/specs -dir: archive/2025-05-18-git-repo-management/specs +# 2025-05-18-git-repo-management/specs +dir: 2025-05-18-git-repo-management/specs -index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md +index: 2025-05-18-git-repo-management/specs/.pi-map.index.md ## role -Defines specifications and requirements for git repository management functionality. +Contains specification documents that define requirements, standards, or design contracts for the git repository management project. ## files ## arch -Specification-driven development with structured documentation files (likely markdown or similar) capturing functional requirements, API contracts, and behavioral expectations for the git repo management system. +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. ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md b/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md index 3faf1b7..2656765 100644 --- a/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-git-repo-management/specs/git-repo-management (index) -dir: archive/2025-05-18-git-repo-management/specs/git-repo-management +# 2025-05-18-git-repo-management/specs/git-repo-management (index) +dir: 2025-05-18-git-repo-management/specs/git-repo-management ## role -Defines functional requirements for a Git repository management system supporting CRUD operations with cascade deletion capabilities. +Defines functional requirements for a Git repository management system supporting lifecycle operations. ## parent -index: archive/2025-05-18-git-repo-management/specs/.pi-map.index.md -map: archive/2025-05-18-git-repo-management/specs/.pi-map.md +index: 2025-05-18-git-repo-management/specs/.pi-map.index.md +map: 2025-05-18-git-repo-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md -map: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md b/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md index 43bc6c1..cd6ce46 100644 --- a/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-git-repo-management/specs/git-repo-management -dir: archive/2025-05-18-git-repo-management/specs/git-repo-management +# 2025-05-18-git-repo-management/specs/git-repo-management +dir: 2025-05-18-git-repo-management/specs/git-repo-management -index: archive/2025-05-18-git-repo-management/specs/git-repo-management/.pi-map.index.md +index: 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 CRUD operations with cascade deletion capabilities. +Defines functional requirements for a Git repository management system supporting lifecycle 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 ## arch -Specification-driven design using a single markdown-based requirements document without explicit architectural patterns. +Specification-driven design using a single requirements document with feature-based organization (CRUD + cascade operations). ## tags git, deletion, spec, specifies, software, requirements, repository, management ## symbols diff --git a/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md b/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md index df7493f..660a82b 100644 --- a/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2025-05-18-ssh-key-management (index) -dir: archive/2025-05-18-ssh-key-management +# 2025-05-18-ssh-key-management (index) +dir: 2025-05-18-ssh-key-management ## role -Implements a full-stack SSH key management feature for secure Ed25519 key generation, encrypted storage, and git operations with external providers. +Implements a full-stack SSH key management system for secure Ed25519 key generation, encrypted storage, and git operations with external providers. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-18-ssh-key-management/specs - index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md - map: archive/2025-05-18-ssh-key-management/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2025-05-18-ssh-key-management/.pi-map.index.md -map: archive/2025-05-18-ssh-key-management/.pi-map.md +index: 2025-05-18-ssh-key-management/.pi-map.index.md +map: 2025-05-18-ssh-key-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md b/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md index 4542621..2df6aaa 100644 --- a/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-ssh-key-management/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2025-05-18-ssh-key-management -dir: archive/2025-05-18-ssh-key-management +# 2025-05-18-ssh-key-management +dir: 2025-05-18-ssh-key-management -index: archive/2025-05-18-ssh-key-management/.pi-map.index.md +index: 2025-05-18-ssh-key-management/.pi-map.index.md ## role -Implements a full-stack SSH key management feature for secure Ed25519 key generation, encrypted storage, and git operations with external providers. +Implements a full-stack SSH key management system for secure Ed25519 key generation, encrypted storage, and git operations with external providers. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for implementing an API and UI to manage Ed25519 SSH keys with encrypted private key storage | dep: cryptography (Fernet, Ed25519), database/SSHKey model, frontend UI components, JWT_SECRET (for Fernet key derivation) - proposal.md | Proposes adding SSH key management functionality (backend API, frontend UI, and Ed25519 key generation with encryption) to enable git operations with external providers. | dep: FastAPI (implied by router pattern), Fernet encryption, Ed25519 cryptography, React/Vue frontend (implied by web app), existing SSHKey model - tasks.md | A completed task checklist documenting the implementation of a full-stack SSH key management feature with backend API, frontend UI, and verification steps. | dep: FastAPI, cryptography, Pydantic, React, React Router, npm, pytest, ruff, mypy ## arch -Clean documentation-driven architecture using OpenSpec schema configuration, phased implementation (proposal → design → tasks), with separated backend API and frontend UI concerns and encrypted private key security pattern. +Full-stack feature module with backend REST API, frontend UI, encrypted private key storage, and task-driven implementation documentation following design-proposal-tasks workflow. ## tags key, design, api, ssh, .openspec, ed25519, management, backend ## symbols diff --git a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md index 42828c0..e16fab1 100644 --- a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2025-05-18-ssh-key-management/specs (index) -dir: archive/2025-05-18-ssh-key-management/specs +# 2025-05-18-ssh-key-management/specs (index) +dir: 2025-05-18-ssh-key-management/specs ## role -Contains archived specifications for SSH key management features from May 18, 2025. +Contains specification documents defining requirements and design for SSH key management functionality. ## parent -index: archive/2025-05-18-ssh-key-management/.pi-map.index.md -map: archive/2025-05-18-ssh-key-management/.pi-map.md +index: 2025-05-18-ssh-key-management/.pi-map.index.md +map: 2025-05-18-ssh-key-management/.pi-map.md ## children -- archive/2025-05-18-ssh-key-management/specs/ssh-key-management - index: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md - map: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md -map: archive/2025-05-18-ssh-key-management/specs/.pi-map.md +index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md +map: 2025-05-18-ssh-key-management/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md index cf6bfc8..673a68a 100644 --- a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-18-ssh-key-management/specs -dir: archive/2025-05-18-ssh-key-management/specs +# 2025-05-18-ssh-key-management/specs +dir: 2025-05-18-ssh-key-management/specs -index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md +index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md ## role -Contains archived specifications for SSH key management features from May 18, 2025. +Contains specification documents defining requirements and design for SSH key management functionality. ## files ## arch -Document-based specification storage with date-versioned archiving pattern for historical feature planning documents. +Documentation-driven specification pattern using dated directory organization for version tracking of feature requirements. ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md index 2dea7ab..3321f83 100644 --- a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-ssh-key-management/specs/ssh-key-management (index) -dir: archive/2025-05-18-ssh-key-management/specs/ssh-key-management +# 2025-05-18-ssh-key-management/specs/ssh-key-management (index) +dir: 2025-05-18-ssh-key-management/specs/ssh-key-management ## role -Defines functional requirements and acceptance criteria for SSH key lifecycle management operations. +Defines functional requirements and specifications for SSH key lifecycle management operations. ## parent -index: archive/2025-05-18-ssh-key-management/specs/.pi-map.index.md -map: archive/2025-05-18-ssh-key-management/specs/.pi-map.md +index: 2025-05-18-ssh-key-management/specs/.pi-map.index.md +map: 2025-05-18-ssh-key-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md -map: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md index 72eb551..10ea59f 100644 --- a/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-ssh-key-management/specs/ssh-key-management -dir: archive/2025-05-18-ssh-key-management/specs/ssh-key-management +# 2025-05-18-ssh-key-management/specs/ssh-key-management +dir: 2025-05-18-ssh-key-management/specs/ssh-key-management -index: archive/2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md +index: 2025-05-18-ssh-key-management/specs/ssh-key-management/.pi-map.index.md ## role -Defines functional requirements and acceptance criteria for SSH key lifecycle management operations. +Defines functional requirements and specifications for SSH key lifecycle management operations. ## files - spec.md | Defines requirements for SSH key management functionality including generation, listing, display, and deletion ## arch -Specification-driven design using structured requirements documentation with use-case based organization (generate, list, show, delete) and explicit acceptance criteria. +Specification-driven design using requirement documents to define system behavior before implementation. ## tags spec, defines, requirements, ssh, key, management, functionality, including ## symbols diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md index 64eeb04..46c2673 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2025-05-18-test-infrastructure-improvements (index) -dir: archive/2025-05-18-test-infrastructure-improvements +# 2025-05-18-test-infrastructure-improvements (index) +dir: 2025-05-18-test-infrastructure-improvements ## role -Contains design documents, proposals, and task tracking for a test infrastructure restructuring initiative that was archived after completion. +Documents the planning, design, and tracking of test infrastructure improvements for a backend API project. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-18-test-infrastructure-improvements/specs - index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md - map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/.pi-map.md +index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md +map: 2025-05-18-test-infrastructure-improvements/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md index 2ded712..c6f9fe6 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2025-05-18-test-infrastructure-improvements -dir: archive/2025-05-18-test-infrastructure-improvements +# 2025-05-18-test-infrastructure-improvements +dir: 2025-05-18-test-infrastructure-improvements -index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md +index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md ## role -Contains design documents, proposals, and task tracking for a test infrastructure restructuring initiative that was archived after completion. +Documents the planning, design, and tracking of test infrastructure improvements for a backend API project. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | This file documents the design and migration plan for restructuring a test suite into unit, integration, and system categories with shared fixtures, SQLite/PostgreSQL separation, and E2E coverage. | dep: pytest, pytest-asyncio, SQLite, PostgreSQL, Playwright, Docker, React/Vite, asyncpg, pytest-xdist - proposal.md | Proposes a comprehensive restructuring of test infrastructure to separate unit/integration/system tests, add shared fixtures, enable SQLite for unit tests, implement transaction rollback isolation, and introduce Playwright E2E testing. | dep: pytest, PostgreSQL, SQLite, Playwright, python-jose, docker, Makefile - tasks.md | Project task list tracking completed testing infrastructure improvements for a backend API project including test restructuring, shared fixtures, multi-database support, E2E setup, and documentation. | dep: pytest, pytest-asyncio, SQLAlchemy, aiosqlite, PostgreSQL, Playwright, python-jose, TestClient, Makefile ## arch -Documentation-driven planning pattern with structured design docs (design.md, proposal.md) preceding implementation, tracked via task lists, using OpenSpec for schema metadata and following a test pyramid architecture (unit/integration/system/E2E tiers with shared fixtures and database isolation). +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. ## tags pytest, sqlite, postgresql, playwright, design, restructuring, test, unit ## symbols diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md index f573a8c..da19d60 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs (index) -dir: archive/2025-05-18-test-infrastructure-improvements/specs +# 2025-05-18-test-infrastructure-improvements/specs (index) +dir: 2025-05-18-test-infrastructure-improvements/specs ## role -Contains specification documents for test infrastructure improvements planned or implemented on 2025-05-18. +Contains specification documents defining requirements and design for test infrastructure improvements ## parent -index: archive/2025-05-18-test-infrastructure-improvements/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/.pi-map.md +index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md +map: 2025-05-18-test-infrastructure-improvements/.pi-map.md ## children -- archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing - index: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md - map: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md -- archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation - index: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md - map: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md -- archive/2025-05-18-test-infrastructure-improvements/specs/test-organization - index: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md - map: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md +index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md +map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md index 740d025..98a87eb 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs -dir: archive/2025-05-18-test-infrastructure-improvements/specs +# 2025-05-18-test-infrastructure-improvements/specs +dir: 2025-05-18-test-infrastructure-improvements/specs -index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md +index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md ## role -Contains specification documents for test infrastructure improvements planned or implemented on 2025-05-18. +Contains specification documents defining requirements and design for test infrastructure improvements ## files ## arch -Documentation-driven specification pattern with dated archival organization for tracking infrastructure changes over time. +Documentation-as-code pattern using dated directories for versioned specification tracking ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md index 08aa220..c42c707 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing (index) -dir: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing +# 2025-05-18-test-infrastructure-improvements/specs/e2e-testing (index) +dir: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing ## role -Defines specifications for end-to-end testing infrastructure using Playwright and Makefile integration. +Defines end-to-end testing requirements using Playwright and Makefile integration for automated browser-based system validation. ## parent -index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md +index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md +map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md index 289c91f..00b1345 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing -dir: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing +# 2025-05-18-test-infrastructure-improvements/specs/e2e-testing +dir: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing -index: archive/2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md +index: 2025-05-18-test-infrastructure-improvements/specs/e2e-testing/.pi-map.index.md ## role -Defines specifications for end-to-end testing infrastructure using Playwright and Makefile integration. +Defines end-to-end testing requirements using Playwright and Makefile integration for automated browser-based system validation. ## files - spec.md | Defines requirements for end-to-end testing with Playwright and Makefile test targets for a software system. | dep: Playwright, Makefile, test database ## arch -Specification-driven testing architecture with browser automation (Playwright) and build system (Makefile) orchestration for test execution. +Specification-driven testing architecture with Makefile target orchestration and Playwright-based browser automation framework. ## tags end, playwright, makefile, spec, defines, requirements, testing, test ## symbols diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md index 87fd7c0..113336b 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation (index) -dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation +# 2025-05-18-test-infrastructure-improvements/specs/test-isolation (index) +dir: 2025-05-18-test-infrastructure-improvements/specs/test-isolation ## role -Defines specifications for test isolation mechanisms ensuring clean, independent test execution through shared fixtures and transaction management. +Defines requirements for ensuring test isolation through shared fixtures and database transaction management in a testing infrastructure. ## parent -index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md +index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md +map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md index f7bcc33..36cd4d0 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation -dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation +# 2025-05-18-test-infrastructure-improvements/specs/test-isolation +dir: 2025-05-18-test-infrastructure-improvements/specs/test-isolation -index: archive/2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md +index: 2025-05-18-test-infrastructure-improvements/specs/test-isolation/.pi-map.index.md ## role -Defines specifications for test isolation mechanisms ensuring clean, independent test execution through shared fixtures and transaction management. +Defines requirements for ensuring test isolation through shared fixtures and database transaction management in a testing infrastructure. ## files - spec.md | Defines requirements for shared test fixtures and transaction isolation in a testing infrastructure | dep: pytest, SQLAlchemy, TestClient, SQLite, PostgreSQL ## arch -Specification-driven design using requirement documents to define behavioral contracts for test infrastructure components. +Specification-driven architecture using markdown-based requirements documents to define behavioral contracts for test infrastructure components. ## tags spec, defines, requirements, shared, test, fixtures, transaction, isolation ## symbols diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md index bdaa727..c1c0e61 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs/test-organization (index) -dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization +# 2025-05-18-test-infrastructure-improvements/specs/test-organization (index) +dir: 2025-05-18-test-infrastructure-improvements/specs/test-organization ## role -Defines testing standards for categorizing backend tests by scope using pytest markers +Defines testing standards and categorization requirements for the backend test suite using pytest markers. ## parent -index: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/.pi-map.md +index: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.index.md +map: 2025-05-18-test-infrastructure-improvements/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md -map: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md index f741c06..f0a9ba7 100644 --- a/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-test-infrastructure-improvements/specs/test-organization -dir: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization +# 2025-05-18-test-infrastructure-improvements/specs/test-organization +dir: 2025-05-18-test-infrastructure-improvements/specs/test-organization -index: archive/2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md +index: 2025-05-18-test-infrastructure-improvements/specs/test-organization/.pi-map.index.md ## role -Defines testing standards for categorizing backend tests by scope using pytest markers +Defines testing standards and categorization requirements for the backend test suite using pytest markers. ## files - spec.md | Defines requirements for organizing backend tests into unit, integration, and system categories with pytest markers | dep: pytest, pyproject.toml, apps/api/tests/ ## arch -Specification-driven testing strategy with hierarchical test classification (unit/integration/system) and marker-based test selection +Specification-driven documentation pattern establishing a three-tier test hierarchy (unit/integration/system) with marker-based test organization. ## tags tests, pytest, spec, defines, requirements, organizing, backend, unit ## symbols diff --git a/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md b/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md index 590b433..c9823e0 100644 --- a/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2025-05-18-tool-types-definition (index) -dir: archive/2025-05-18-tool-types-definition +# 2025-05-18-tool-types-definition (index) +dir: 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. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-18-tool-types-definition/specs - index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md - map: archive/2025-05-18-tool-types-definition/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2025-05-18-tool-types-definition/.pi-map.index.md -map: archive/2025-05-18-tool-types-definition/.pi-map.md +index: 2025-05-18-tool-types-definition/.pi-map.index.md +map: 2025-05-18-tool-types-definition/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md b/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md index 203fe29..f88424b 100644 --- a/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-tool-types-definition/.pi-map.md @@ -1,7 +1,7 @@ -# archive/2025-05-18-tool-types-definition -dir: archive/2025-05-18-tool-types-definition +# 2025-05-18-tool-types-definition +dir: 2025-05-18-tool-types-definition -index: archive/2025-05-18-tool-types-definition/.pi-map.index.md +index: 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. @@ -11,7 +11,7 @@ Design and planning package for a ToolType system that enables defining and laun - proposal.md | Defines a feature proposal for implementing a tool type system with Docker Compose template support to enable launching development tool instances | dep: SQLAlchemy, Docker Compose, apps/api/src/api/tool_types.py, apps/web/src/pages/tool-types.tsx - tasks.md | Tracks completed development tasks for implementing a ToolType CRUD feature across backend API, frontend UI, and database migration | dep: SQLAlchemy, Alembic, FastAPI, Pydantic, React/TypeScript, pytest, ruff, mypy, npm ## arch -Documentation-driven design pattern with structured specification files (OpenSpec config, design doc, proposal, task tracking) preceding implementation. +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). ## tags defines, design, implementing, development, proposal, tool, api, tasks ## symbols diff --git a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md index 153d96f..bdae7f2 100644 --- a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2025-05-18-tool-types-definition/specs (index) -dir: archive/2025-05-18-tool-types-definition/specs +# 2025-05-18-tool-types-definition/specs (index) +dir: 2025-05-18-tool-types-definition/specs ## role -Contains specification documents defining tool types and their interfaces for the project. +Contains specification documents defining tool types, interfaces, and behavioral contracts for the project's tooling system. ## parent -index: archive/2025-05-18-tool-types-definition/.pi-map.index.md -map: archive/2025-05-18-tool-types-definition/.pi-map.md +index: 2025-05-18-tool-types-definition/.pi-map.index.md +map: 2025-05-18-tool-types-definition/.pi-map.md ## children -- archive/2025-05-18-tool-types-definition/specs/tool-types-definition - index: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md - map: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md -map: archive/2025-05-18-tool-types-definition/specs/.pi-map.md +index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md +map: 2025-05-18-tool-types-definition/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md index 8ab27aa..707f76c 100644 --- a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-18-tool-types-definition/specs -dir: archive/2025-05-18-tool-types-definition/specs +# 2025-05-18-tool-types-definition/specs +dir: 2025-05-18-tool-types-definition/specs -index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md +index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md ## role -Contains specification documents defining tool types and their interfaces for the project. +Contains specification documents defining tool types, interfaces, and behavioral contracts for the project's tooling system. ## files ## arch -Documentation-driven specification pattern using structured definition files to establish contracts before implementation. +Document-driven specification pattern using formal interface definitions to establish contracts between tool implementations and consumers, likely supporting code generation or validation. ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md index 4fc1bd0..20d155d 100644 --- a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-tool-types-definition/specs/tool-types-definition (index) -dir: archive/2025-05-18-tool-types-definition/specs/tool-types-definition +# 2025-05-18-tool-types-definition/specs/tool-types-definition (index) +dir: 2025-05-18-tool-types-definition/specs/tool-types-definition ## role -Defines specifications for a ToolType management system that enables CRUD operations and Docker Compose template validation with variable substitution. +Defines specifications for a ToolType management system that enables CRUD operations, Docker Compose template validation, and variable substitution for configurable tool deployments. ## parent -index: archive/2025-05-18-tool-types-definition/specs/.pi-map.index.md -map: archive/2025-05-18-tool-types-definition/specs/.pi-map.md +index: 2025-05-18-tool-types-definition/specs/.pi-map.index.md +map: 2025-05-18-tool-types-definition/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md -map: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md index d265ae3..848c605 100644 --- a/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-tool-types-definition/specs/tool-types-definition -dir: archive/2025-05-18-tool-types-definition/specs/tool-types-definition +# 2025-05-18-tool-types-definition/specs/tool-types-definition +dir: 2025-05-18-tool-types-definition/specs/tool-types-definition -index: archive/2025-05-18-tool-types-definition/specs/tool-types-definition/.pi-map.index.md +index: 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 and Docker Compose template validation with variable substitution. +Defines specifications for a ToolType management system that enables CRUD operations, Docker Compose template validation, and variable substitution for configurable tool deployments. ## files - spec.md | Define requirements for a ToolType management system with CRUD API, Docker Compose template validation, and variable substitution | dep: REST API, Docker Compose, YAML parser, UUID, authentication/authorization system ## arch -Specification-driven architecture using markdown-based requirements documentation to define system behavior before implementation. +Specification-driven architecture using markdown-based requirements documentation with structured sections for functional requirements, API design, data models, and validation rules. ## tags spec, define, requirements, tooltype, management, system, crud, api ## symbols diff --git a/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md b/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md index c2b283d..e171a32 100644 --- a/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2025-05-18-user-config-management (index) -dir: archive/2025-05-18-user-config-management +# 2025-05-18-user-config-management (index) +dir: 2025-05-18-user-config-management ## role -Archive directory containing historical design documents and planning artifacts for a user configuration management feature that was proposed but not yet implemented. +Design and planning package for a JSONB-backed user configuration management feature with API and UI components. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2025-05-18-user-config-management/specs - index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md - map: archive/2025-05-18-user-config-management/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2025-05-18-user-config-management/.pi-map.index.md -map: archive/2025-05-18-user-config-management/.pi-map.md +index: 2025-05-18-user-config-management/.pi-map.index.md +map: 2025-05-18-user-config-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md b/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md index 56ccb88..4e13fc2 100644 --- a/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-user-config-management/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2025-05-18-user-config-management -dir: archive/2025-05-18-user-config-management +# 2025-05-18-user-config-management +dir: 2025-05-18-user-config-management -index: archive/2025-05-18-user-config-management/.pi-map.index.md +index: 2025-05-18-user-config-management/.pi-map.index.md ## role -Archive directory containing historical design documents and planning artifacts for a user configuration management feature that was proposed but not yet implemented. +Design and planning package for a JSONB-backed user configuration management feature with API and UI components. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for a simple key-value user configuration system using PostgreSQL JSONB | dep: PostgreSQL, JSONB - proposal.md | Proposes a feature to add persistent user preference storage and management through a JSONB-backed config system with API endpoints and frontend settings UI. | dep: database, API, frontend, UserConfig model, AppShell - tasks.md | Project task tracking document for implementing a user settings/config feature with backend API, frontend UI, and verification steps | dep: SQLAlchemy, Alembic, FastAPI/HTTP endpoints, React/frontend router, Docker Compose, ruff, mypy, pytest, TypeScript tooling ## arch -Document-driven design with OpenSpec schema definitions, Markdown-based design/proposal/task tracking, and a planned JSONB-backed key-value storage architecture with REST API and frontend UI components. +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. ## tags design, user, jsonb, api, frontend, configuration, .openspec, document ## symbols diff --git a/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md b/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md index 6506731..0d89199 100644 --- a/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2025-05-18-user-config-management/specs (index) -dir: archive/2025-05-18-user-config-management/specs +# 2025-05-18-user-config-management/specs (index) +dir: 2025-05-18-user-config-management/specs ## role -Contains archived specification documents for user configuration management features from May 2025. +Contains specification documents defining requirements and design for the user configuration management feature. ## parent -index: archive/2025-05-18-user-config-management/.pi-map.index.md -map: archive/2025-05-18-user-config-management/.pi-map.md +index: 2025-05-18-user-config-management/.pi-map.index.md +map: 2025-05-18-user-config-management/.pi-map.md ## children -- archive/2025-05-18-user-config-management/specs/user-config-management - index: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md - map: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md +- 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 ## files ## links -index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md -map: archive/2025-05-18-user-config-management/specs/.pi-map.md +index: 2025-05-18-user-config-management/specs/.pi-map.index.md +map: 2025-05-18-user-config-management/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md b/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md index 57ea6d2..1e1cdb6 100644 --- a/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-user-config-management/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2025-05-18-user-config-management/specs -dir: archive/2025-05-18-user-config-management/specs +# 2025-05-18-user-config-management/specs +dir: 2025-05-18-user-config-management/specs -index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md +index: 2025-05-18-user-config-management/specs/.pi-map.index.md ## role -Contains archived specification documents for user configuration management features from May 2025. +Contains specification documents defining requirements and design for the user configuration management feature. ## files ## arch -Documentation-only archive directory with no active code; stores historical design specifications using markdown/plaintext format. +Documentation-driven development with structured specification files (likely markdown/txt) serving as the single source of truth for implementation requirements and acceptance criteria. ## tags - ## symbols diff --git a/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md b/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md index 5275312..5625a3e 100644 --- a/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md +++ b/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2025-05-18-user-config-management/specs/user-config-management (index) -dir: archive/2025-05-18-user-config-management/specs/user-config-management +# 2025-05-18-user-config-management/specs/user-config-management (index) +dir: 2025-05-18-user-config-management/specs/user-config-management ## role -Defines technical specifications for a user-configurable theme system with JSONB-based storage and retrieval. +Defines system requirements for JSONB-based user configuration storage, retrieval, and frontend theme application. ## parent -index: archive/2025-05-18-user-config-management/specs/.pi-map.index.md -map: archive/2025-05-18-user-config-management/specs/.pi-map.md +index: 2025-05-18-user-config-management/specs/.pi-map.index.md +map: 2025-05-18-user-config-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md -map: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md b/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md index c1c93ad..698cfaf 100644 --- a/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md +++ b/openspec/changes/archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2025-05-18-user-config-management/specs/user-config-management -dir: archive/2025-05-18-user-config-management/specs/user-config-management +# 2025-05-18-user-config-management/specs/user-config-management +dir: 2025-05-18-user-config-management/specs/user-config-management -index: archive/2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md +index: 2025-05-18-user-config-management/specs/user-config-management/.pi-map.index.md ## role -Defines technical specifications for a user-configurable theme system with JSONB-based storage and retrieval. +Defines system requirements for JSONB-based user configuration storage, retrieval, and frontend theme application. ## files - spec.md | Define system requirements for user configuration storage, retrieval, and frontend theme application using JSONB key-value pairs. ## arch -Specification-driven design using JSONB key-value store pattern for flexible schema-less configuration persistence with frontend theme binding. +Specification-driven architecture using JSONB key-value pairs for flexible schema-less user preferences with clear separation between storage backend and frontend consumption patterns. ## tags spec, define, system, requirements, user, configuration, storage, retrieval ## symbols diff --git a/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md b/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md index ddea375..818ddd7 100644 --- a/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.index.md @@ -1,15 +1,15 @@ -# archive/2026-05-17-auth-oauth (index) -dir: archive/2026-05-17-auth-oauth +# 2026-05-17-auth-oauth (index) +dir: 2026-05-17-auth-oauth ## role -Archive directory containing design documents and proposals for an OAuth2/OIDC authentication system with Authentik integration and JWT token management. +Authentication and authorization package implementing OAuth2/OIDC integration with Authentik for secure user session management. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-17-auth-oauth/specs - index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md - map: archive/2026-05-17-auth-oauth/specs/.pi-map.md +- 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 ## files - .openspec.yaml - README.md @@ -17,8 +17,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-17-auth-oauth/.pi-map.index.md -map: archive/2026-05-17-auth-oauth/.pi-map.md +index: 2026-05-17-auth-oauth/.pi-map.index.md +map: 2026-05-17-auth-oauth/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md b/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md index 45f54e2..c0446b6 100644 --- a/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-auth-oauth/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-05-17-auth-oauth -dir: archive/2026-05-17-auth-oauth +# 2026-05-17-auth-oauth +dir: 2026-05-17-auth-oauth -index: archive/2026-05-17-auth-oauth/.pi-map.index.md +index: 2026-05-17-auth-oauth/.pi-map.index.md ## role -Archive directory containing design documents and proposals for an OAuth2/OIDC authentication system with Authentik integration and JWT token management. +Authentication and authorization package implementing OAuth2/OIDC integration with Authentik for secure user session management. ## files - .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date - README.md | Documents a project that implements OAuth2/OIDC authentication using Authentik with internal JWTs and database-backed refresh tokens | dep: Authentik, OAuth2, OIDC, JWT @@ -12,7 +12,7 @@ Archive directory containing design documents and proposals for an OAuth2/OIDC a - proposal.md | Proposes a technical implementation plan for adding production-ready OAuth2/OIDC authentication with Authentik integration, JWT session management, and secure token lifecycle handling to a backend API project. | dep: Authentik, OAuth2/OIDC, JWKS, JWT, database, apps/api/src, config, models, auth services, API routes - tasks.md | Task tracking document for implementing OIDC/JWT authentication system with refresh tokens in a backend application. | dep: SQLAlchemy, Alembic, Authentik OIDC, pytest, ruff, mypy, asyncpg, PostgreSQL ## arch -Document-driven design specification using markdown-based RFCs, with OpenAPI metadata, separating concerns into design rationale (design.md), implementation planning (proposal.md), task tracking (tasks.md), and project documentation (README.md). +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. ## tags oidc, authentik, oauth2, jwt, authentication, tokens, refresh, design ## symbols diff --git a/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md index 40bbfb0..b7ed854 100644 --- a/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-17-auth-oauth/specs (index) -dir: archive/2026-05-17-auth-oauth/specs +# 2026-05-17-auth-oauth/specs (index) +dir: 2026-05-17-auth-oauth/specs ## role -Contains historical specification documents for the OAuth authentication implementation from May 2026, serving as archived design reference. +Contains specification documents defining requirements, interfaces, and behavior contracts for the OAuth authentication system. ## parent -index: archive/2026-05-17-auth-oauth/.pi-map.index.md -map: archive/2026-05-17-auth-oauth/.pi-map.md +index: 2026-05-17-auth-oauth/.pi-map.index.md +map: 2026-05-17-auth-oauth/.pi-map.md ## children -- archive/2026-05-17-auth-oauth/specs/auth-oauth - index: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md - map: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md +- 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 ## files ## links -index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md -map: archive/2026-05-17-auth-oauth/specs/.pi-map.md +index: 2026-05-17-auth-oauth/specs/.pi-map.index.md +map: 2026-05-17-auth-oauth/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md b/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md index 1e82bf2..f6ce503 100644 --- a/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-auth-oauth/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-17-auth-oauth/specs -dir: archive/2026-05-17-auth-oauth/specs +# 2026-05-17-auth-oauth/specs +dir: 2026-05-17-auth-oauth/specs -index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md +index: 2026-05-17-auth-oauth/specs/.pi-map.index.md ## role -Contains historical specification documents for the OAuth authentication implementation from May 2026, serving as archived design reference. +Contains specification documents defining requirements, interfaces, and behavior contracts for the OAuth authentication system. ## files ## arch -Documentation-only archive with no active code; likely contains markdown/ADR-style specification files capturing past architectural decisions for external authentication provider integration. +Documentation-driven design using specification files (likely markdown or similar) to formalize system requirements before implementation. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md b/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md index a8b0a04..0001175 100644 --- a/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-17-auth-oauth/specs/auth-oauth (index) -dir: archive/2026-05-17-auth-oauth/specs/auth-oauth +# 2026-05-17-auth-oauth/specs/auth-oauth (index) +dir: 2026-05-17-auth-oauth/specs/auth-oauth ## role -Defines authentication requirements for OAuth2/OIDC integration with Authentik identity provider. +Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider. ## parent -index: archive/2026-05-17-auth-oauth/specs/.pi-map.index.md -map: archive/2026-05-17-auth-oauth/specs/.pi-map.md +index: 2026-05-17-auth-oauth/specs/.pi-map.index.md +map: 2026-05-17-auth-oauth/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md -map: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md b/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md index 08cb126..18bf837 100644 --- a/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-17-auth-oauth/specs/auth-oauth -dir: archive/2026-05-17-auth-oauth/specs/auth-oauth +# 2026-05-17-auth-oauth/specs/auth-oauth +dir: 2026-05-17-auth-oauth/specs/auth-oauth -index: archive/2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md +index: 2026-05-17-auth-oauth/specs/auth-oauth/.pi-map.index.md ## role -Defines authentication requirements for OAuth2/OIDC integration with Authentik identity provider. +Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider. ## files - spec.md | Specifies OAuth2/OIDC authentication, session security, token refresh, and logout requirements for a web application using Authentik as the identity provider. | dep: Authentik, JWKS, OAuth2, OIDC, HTTP cookies, database ## arch -Requirements specification document following standard markdown-based spec format with no implemented architecture. +Specification-driven security architecture using standard OAuth2/OIDC flows with session management, token lifecycle, and secure logout patterns. ## tags oauth2, oidc, authentik, spec, specifies, authentication, session, security ## symbols diff --git a/openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md b/openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md index 652a4b7..7093fa1 100644 --- a/openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-database-models/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-05-17-database-models (index) -dir: archive/2026-05-17-database-models +# 2026-05-17-database-models (index) +dir: 2026-05-17-database-models ## role -Archive directory containing design documents and proposals for implementing SQLAlchemy 2.0 async database models and Alembic migrations for a PostgreSQL-backed API application. +Database persistence layer providing SQLAlchemy 2.0 async ORM models and Alembic migration infrastructure for PostgreSQL data management in the Headquarter platform API. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -15,8 +15,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-17-database-models/.pi-map.index.md -map: archive/2026-05-17-database-models/.pi-map.md +index: 2026-05-17-database-models/.pi-map.index.md +map: 2026-05-17-database-models/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-database-models/.pi-map.md b/openspec/changes/archive/2026-05-17-database-models/.pi-map.md index 327d20f..9e83663 100644 --- a/openspec/changes/archive/2026-05-17-database-models/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-database-models/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-05-17-database-models -dir: archive/2026-05-17-database-models +# 2026-05-17-database-models +dir: 2026-05-17-database-models -index: archive/2026-05-17-database-models/.pi-map.index.md +index: 2026-05-17-database-models/.pi-map.index.md ## role -Archive directory containing design documents and proposals for implementing SQLAlchemy 2.0 async database models and Alembic migrations for a PostgreSQL-backed API application. +Database persistence layer providing SQLAlchemy 2.0 async ORM models and Alembic migration infrastructure for PostgreSQL data management in the Headquarter platform API. ## files - .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date - README.md | Defines a project for implementing SQLAlchemy database models and Alembic migrations for core entities. | dep: SQLAlchemy, Alembic @@ -12,7 +12,7 @@ Archive directory containing design documents and proposals for implementing SQL - proposal.md | Proposes implementing SQLAlchemy 2.0 async database models and Alembic migrations for core entities in the Headquarter platform | dep: SQLAlchemy 2.0, Alembic, asyncpg, pytest, mypy, ruff - tasks.md | Tracks completed implementation tasks for building a SQLAlchemy-based async database layer with models, migrations, seeding, and testing for an API application. | dep: SQLAlchemy, Alembic, Pydantic-settings, PostgreSQL, pytest, mypy, ruff ## arch -Document-driven design with OpenAPI specification metadata, structured planning artifacts (proposal/design/tasks), and async SQLAlchemy 2.0 ORM pattern targeting PostgreSQL with Alembic migration management. +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. ## tags sqlalchemy, alembic, database, defines, models, migrations, design, async ## symbols diff --git a/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md b/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md index c9f90f7..bdb51a2 100644 --- a/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.index.md @@ -1,15 +1,15 @@ -# archive/2026-05-17-frontend-foundation (index) -dir: archive/2026-05-17-frontend-foundation +# 2026-05-17-frontend-foundation (index) +dir: 2026-05-17-frontend-foundation ## role -Archive of a completed frontend foundation project delivering a React/TypeScript/Vite starter with authentication, routing, and API integration patterns. +Establishes a foundational frontend architecture for authenticated React/TypeScript/Vite web applications with routing, API integration, and responsive UI patterns. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-17-frontend-foundation/specs - index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md - map: archive/2026-05-17-frontend-foundation/specs/.pi-map.md +- 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 ## files - .openspec.yaml - README.md @@ -17,8 +17,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-17-frontend-foundation/.pi-map.index.md -map: archive/2026-05-17-frontend-foundation/.pi-map.md +index: 2026-05-17-frontend-foundation/.pi-map.index.md +map: 2026-05-17-frontend-foundation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md b/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md index f11e738..535c0c9 100644 --- a/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-frontend-foundation/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-05-17-frontend-foundation -dir: archive/2026-05-17-frontend-foundation +# 2026-05-17-frontend-foundation +dir: 2026-05-17-frontend-foundation -index: archive/2026-05-17-frontend-foundation/.pi-map.index.md +index: 2026-05-17-frontend-foundation/.pi-map.index.md ## role -Archive of a completed frontend foundation project delivering a React/TypeScript/Vite starter with authentication, routing, and API integration patterns. +Establishes a foundational frontend architecture for authenticated React/TypeScript/Vite web applications with routing, API integration, and responsive UI patterns. ## files - .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date - README.md | Defines a project foundation for a frontend application with authentication, routing, and API integration capabilities. @@ -12,7 +12,7 @@ Archive of a completed frontend foundation project delivering a React/TypeScript - proposal.md | Proposes a frontend foundation for a React/TypeScript web application with authentication, routing, and API integration. | dep: React, TypeScript, Vite, backend auth endpoints (/auth/login, /auth/logout, /auth/me, /auth/refresh) - tasks.md | Tracks completed frontend development tasks for building an authenticated web application with routing, API integration, and dashboard UI. ## arch -Documentation-driven architecture with OpenAPI-first API contract, layered design docs (proposal → design → tasks), and modular React patterns including authenticated route guards, responsive shell layout, and centralized API client abstraction. +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. ## tags react, frontend, routing, api, typescript, auth, foundation, application ## symbols diff --git a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md index aa27786..6b6d244 100644 --- a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-17-frontend-foundation/specs (index) -dir: archive/2026-05-17-frontend-foundation/specs +# 2026-05-17-frontend-foundation/specs (index) +dir: 2026-05-17-frontend-foundation/specs ## role -Contains archived specification documents for the frontend foundation project dated May 17, 2026, serving as historical reference for design decisions and requirements. +Contains specification documents defining requirements and design decisions for the frontend foundation layer. ## parent -index: archive/2026-05-17-frontend-foundation/.pi-map.index.md -map: archive/2026-05-17-frontend-foundation/.pi-map.md +index: 2026-05-17-frontend-foundation/.pi-map.index.md +map: 2026-05-17-frontend-foundation/.pi-map.md ## children -- archive/2026-05-17-frontend-foundation/specs/frontend-foundation - index: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md - map: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md +- 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 ## files ## links -index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md -map: archive/2026-05-17-frontend-foundation/specs/.pi-map.md +index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md +map: 2026-05-17-frontend-foundation/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md index 50d9f8a..1c6898b 100644 --- a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-17-frontend-foundation/specs -dir: archive/2026-05-17-frontend-foundation/specs +# 2026-05-17-frontend-foundation/specs +dir: 2026-05-17-frontend-foundation/specs -index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md +index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md ## role -Contains archived specification documents for the frontend foundation project dated May 17, 2026, serving as historical reference for design decisions and requirements. +Contains specification documents defining requirements and design decisions for the frontend foundation layer. ## files ## arch -Document-based specification storage using date-versioned directory naming convention for temporal organization of project requirements. +Documentation-driven architecture using specification files to formalize API contracts, component interfaces, and implementation standards before code development. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md index 568930c..8f6578c 100644 --- a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-17-frontend-foundation/specs/frontend-foundation (index) -dir: archive/2026-05-17-frontend-foundation/specs/frontend-foundation +# 2026-05-17-frontend-foundation/specs/frontend-foundation (index) +dir: 2026-05-17-frontend-foundation/specs/frontend-foundation ## role -Defines technical specifications for a React 18+ TypeScript frontend foundation including routing, auth, layout, and HTTP client patterns. +Defines the technical specification and requirements for a React 18+ TypeScript frontend foundation with routing, authentication, layout, and HTTP client capabilities. ## parent -index: archive/2026-05-17-frontend-foundation/specs/.pi-map.index.md -map: archive/2026-05-17-frontend-foundation/specs/.pi-map.md +index: 2026-05-17-frontend-foundation/specs/.pi-map.index.md +map: 2026-05-17-frontend-foundation/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md -map: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md index a844c0f..2200764 100644 --- a/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-17-frontend-foundation/specs/frontend-foundation -dir: archive/2026-05-17-frontend-foundation/specs/frontend-foundation +# 2026-05-17-frontend-foundation/specs/frontend-foundation +dir: 2026-05-17-frontend-foundation/specs/frontend-foundation -index: archive/2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md +index: 2026-05-17-frontend-foundation/specs/frontend-foundation/.pi-map.index.md ## role -Defines technical specifications for a React 18+ TypeScript frontend foundation including routing, auth, layout, and HTTP client patterns. +Defines the technical specification and requirements for a React 18+ TypeScript frontend foundation with routing, authentication, layout, and HTTP client capabilities. ## files - spec.md | This file specifies frontend requirements for a React 18+ TypeScript web application with routing, authentication, layout, and HTTP client configuration. | dep: React 18+, TypeScript 5+, Vite, React Router, Axios/fetch ## arch -Specification-driven architecture with modular concerns (routing, auth, layout, HTTP) documented as requirements for a modern React SPA foundation. +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. ## tags spec, specifies, frontend, requirements, react, typescript, web, application ## symbols diff --git a/openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md b/openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md index 66e4718..9b3c537a 100644 --- a/openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-project-management/.pi-map.index.md @@ -1,15 +1,15 @@ -# archive/2026-05-17-project-management (index) -dir: archive/2026-05-17-project-management +# 2026-05-17-project-management (index) +dir: 2026-05-17-project-management ## role -This package contains archived design documentation and planning artifacts for a project management feature that was implemented with full-stack CRUD operations, ownership enforcement, and SSH key integration. +Defines specifications, design, and implementation tracking for a full-stack project management feature with authenticated CRUD, ownership enforcement, and SSH key integration. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-17-project-management/specs - index: archive/2026-05-17-project-management/specs/.pi-map.index.md - map: archive/2026-05-17-project-management/specs/.pi-map.md +- 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 ## files - .openspec.yaml - README.md @@ -17,8 +17,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-17-project-management/.pi-map.index.md -map: archive/2026-05-17-project-management/.pi-map.md +index: 2026-05-17-project-management/.pi-map.index.md +map: 2026-05-17-project-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-project-management/.pi-map.md b/openspec/changes/archive/2026-05-17-project-management/.pi-map.md index d205752..2867ea3 100644 --- a/openspec/changes/archive/2026-05-17-project-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-project-management/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-05-17-project-management -dir: archive/2026-05-17-project-management +# 2026-05-17-project-management +dir: 2026-05-17-project-management -index: archive/2026-05-17-project-management/.pi-map.index.md +index: 2026-05-17-project-management/.pi-map.index.md ## role -This package contains archived design documentation and planning artifacts for a project management feature that was implemented with full-stack CRUD operations, ownership enforcement, and SSH key integration. +Defines specifications, design, and implementation tracking for a full-stack project management feature with authenticated CRUD, ownership enforcement, and SSH key integration. ## files - .openspec.yaml | Defines an OpenAPI specification file metadata with schema type and creation date - README.md | Defines a project management application that implements create, read, update, delete, listing, and ownership workflows across API and frontend layers @@ -12,7 +12,7 @@ This package contains archived design documentation and planning artifacts for a - proposal.md | Proposes a project management feature implementation covering authenticated CRUD APIs, frontend flows, SSH key integration, and cascading deletion behavior. | dep: authentication, data models, frontend foundation, apps/api/src, apps/web/src - tasks.md | Tracks completed tasks for implementing full-stack project management features with ownership enforcement and verification checks. ## arch -Documentation-driven planning architecture using OpenAPI specification metadata, structured markdown design documents (proposal → design → tasks → README), and explicit separation of API/backend concerns from frontend integration workflows. +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. ## tags project, frontend, management, ownership, design, tasks, defines, .openspec ## symbols diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md index cfb90fe..b89f023 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-17-project-management/specs (index) -dir: archive/2026-05-17-project-management/specs +# 2026-05-17-project-management/specs (index) +dir: 2026-05-17-project-management/specs ## role -Contains archived specification documents from a project management snapshot dated May 17, 2026. +Contains project specifications and requirements documentation for the 2026-05-17-project-management system. ## parent -index: archive/2026-05-17-project-management/.pi-map.index.md -map: archive/2026-05-17-project-management/.pi-map.md +index: 2026-05-17-project-management/.pi-map.index.md +map: 2026-05-17-project-management/.pi-map.md ## children -- archive/2026-05-17-project-management/specs/git-repo - index: archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md - map: archive/2026-05-17-project-management/specs/git-repo/.pi-map.md -- archive/2026-05-17-project-management/specs/project-management - index: archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md - map: archive/2026-05-17-project-management/specs/project-management/.pi-map.md -- archive/2026-05-17-project-management/specs/ssh-keys - index: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md - map: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md +- 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 ## files ## links -index: archive/2026-05-17-project-management/specs/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/.pi-map.md +index: 2026-05-17-project-management/specs/.pi-map.index.md +map: 2026-05-17-project-management/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md b/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md index d883a57..76ef054 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-17-project-management/specs -dir: archive/2026-05-17-project-management/specs +# 2026-05-17-project-management/specs +dir: 2026-05-17-project-management/specs -index: archive/2026-05-17-project-management/specs/.pi-map.index.md +index: 2026-05-17-project-management/specs/.pi-map.index.md ## role -Contains archived specification documents from a project management snapshot dated May 17, 2026. +Contains project specifications and requirements documentation for the 2026-05-17-project-management system. ## files ## arch -Simple archival storage pattern with date-based directory naming for historical spec versioning. +Documentation-driven specification pattern with no code architecture; serves as the requirements foundation for downstream implementation packages. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md b/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md index 2e5b923..9f8b417 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-17-project-management/specs/git-repo (index) -dir: archive/2026-05-17-project-management/specs/git-repo +# 2026-05-17-project-management/specs/git-repo (index) +dir: 2026-05-17-project-management/specs/git-repo ## role -Specifies requirements for automatic cleanup of associated Git repositories when project management entities are deleted. +Defines specification requirements for cascading repository deletion when a project is deleted in a project management system. ## parent -index: archive/2026-05-17-project-management/specs/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/.pi-map.md +index: 2026-05-17-project-management/specs/.pi-map.index.md +map: 2026-05-17-project-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/git-repo/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.md b/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.md index fde9df4..bdf95bc 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/git-repo/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-17-project-management/specs/git-repo -dir: archive/2026-05-17-project-management/specs/git-repo +# 2026-05-17-project-management/specs/git-repo +dir: 2026-05-17-project-management/specs/git-repo -index: archive/2026-05-17-project-management/specs/git-repo/.pi-map.index.md +index: 2026-05-17-project-management/specs/git-repo/.pi-map.index.md ## role -Specifies requirements for automatic cleanup of associated Git repositories when project management entities are deleted. +Defines specification requirements for cascading repository deletion when a project is deleted in a project management system. ## files - spec.md | Defines modified requirements for cascading repository deletion when a project is deleted ## arch -Requirements specification document using structured markdown with user stories, acceptance criteria, and behavioral rules for cascade deletion logic. +Specification-driven design using markdown-based requirements documentation with focus on referential integrity and cascading delete operations across project-repository boundaries. ## tags spec, defines, modified, requirements, cascading, repository, deletion, project ## symbols diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md b/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md index d0e3eb4..a132df8 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-17-project-management/specs/project-management (index) -dir: archive/2026-05-17-project-management/specs/project-management +# 2026-05-17-project-management/specs/project-management (index) +dir: 2026-05-17-project-management/specs/project-management ## role -Defines modified requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management +Defines the specification requirements for a project management system including CRUD operations, access control, and SSH key management features. ## parent -index: archive/2026-05-17-project-management/specs/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/.pi-map.md +index: 2026-05-17-project-management/specs/.pi-map.index.md +map: 2026-05-17-project-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/project-management/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.md b/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.md index 76e9cef..98ced5c 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/project-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-17-project-management/specs/project-management -dir: archive/2026-05-17-project-management/specs/project-management +# 2026-05-17-project-management/specs/project-management +dir: 2026-05-17-project-management/specs/project-management -index: archive/2026-05-17-project-management/specs/project-management/.pi-map.index.md +index: 2026-05-17-project-management/specs/project-management/.pi-map.index.md ## role -Defines modified requirements for a project management system with CRUD operations, ownership-based access control, and SSH key management +Defines the specification requirements for a project management system including CRUD operations, 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 ## arch -Requirements specification document using Markdown format with structured sections for functional requirements, non-functional requirements, and system constraints +Requirements-driven specification document using natural language descriptions of functional requirements, business rules, and system constraints without explicit architectural patterns. ## tags management, spec, defines, modified, requirements, project, system, crud ## symbols diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md b/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md index a372a48..81e0b39 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-17-project-management/specs/ssh-keys (index) -dir: archive/2026-05-17-project-management/specs/ssh-keys +# 2026-05-17-project-management/specs/ssh-keys (index) +dir: 2026-05-17-project-management/specs/ssh-keys ## role -Defines requirements specification for SSH key management with project default key assignment validation +Specifies requirements for SSH key management and project-level default key assignment with validation rules. ## parent -index: archive/2026-05-17-project-management/specs/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/.pi-map.md +index: 2026-05-17-project-management/specs/.pi-map.index.md +map: 2026-05-17-project-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md -map: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md b/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md index 708a651..205f04c 100644 --- a/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md +++ b/openspec/changes/archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-17-project-management/specs/ssh-keys -dir: archive/2026-05-17-project-management/specs/ssh-keys +# 2026-05-17-project-management/specs/ssh-keys +dir: 2026-05-17-project-management/specs/ssh-keys -index: archive/2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md +index: 2026-05-17-project-management/specs/ssh-keys/.pi-map.index.md ## role -Defines requirements specification for SSH key management with project default key assignment validation +Specifies requirements for SSH key management and project-level default key assignment with validation rules. ## files - spec.md | Defines modified requirements for SSH key association with project default-key assignment validation ## arch -Requirements-as-code pattern using markdown-based specification documents for feature definition +Requirements specification using markdown-based structured documentation pattern. ## tags key, spec, defines, modified, requirements, ssh, association, project ## symbols diff --git a/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md b/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md index 9216199..e60369d 100644 --- a/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-18-database-setup-recovery (index) -dir: archive/2026-05-18-database-setup-recovery +# 2026-05-18-database-setup-recovery (index) +dir: 2026-05-18-database-setup-recovery ## role -Archive directory preserving historical design documents for database setup and recovery infrastructure in a Dockerized API application. +This package contains planning and design documents for implementing automatic database setup, migration, and recovery mechanisms for a Dockerized API application. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-18-database-setup-recovery/specs - index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md - map: archive/2026-05-18-database-setup-recovery/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md -map: archive/2026-05-18-database-setup-recovery/.pi-map.md +index: 2026-05-18-database-setup-recovery/.pi-map.index.md +map: 2026-05-18-database-setup-recovery/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md b/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md index ec9e1e2..7a391b7 100644 --- a/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md +++ b/openspec/changes/archive/2026-05-18-database-setup-recovery/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-18-database-setup-recovery -dir: archive/2026-05-18-database-setup-recovery +# 2026-05-18-database-setup-recovery +dir: 2026-05-18-database-setup-recovery -index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md +index: 2026-05-18-database-setup-recovery/.pi-map.index.md ## role -Archive directory preserving historical design documents for database setup and recovery infrastructure in a Dockerized API application. +This package contains planning and design documents for implementing automatic database setup, migration, and recovery mechanisms for a Dockerized API application. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document specifying how to implement automatic database migration running, connection retry logic, and graceful error handling on application startup | dep: SQLAlchemy, Alembic, Docker, async context - proposal.md | Proposes architectural changes for automatic database initialization, migration management, and seed data handling in a Dockerized API application | dep: alembic, docker-compose, traefik, fastapi/sqlalchemy (implied), postgres (implied) - tasks.md | Project task checklist tracking completion status of database initialization, error handling, Docker integration, and testing work items. ## arch -Document-driven design archive containing OpenSpec configuration, architectural proposals, and task tracking for implementing resilient database initialization with migrations, connection retry logic, and graceful error handling. +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. ## tags design, database, handling, docker, .openspec, automatic, migration, error ## symbols diff --git a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md index dd9a7a9..911735e 100644 --- a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-18-database-setup-recovery/specs (index) -dir: archive/2026-05-18-database-setup-recovery/specs +# 2026-05-18-database-setup-recovery/specs (index) +dir: 2026-05-18-database-setup-recovery/specs ## role -Contains database setup and recovery specifications from a 2026-05-18 archive snapshot. +Contains specification documents defining requirements for database setup and recovery procedures. ## parent -index: archive/2026-05-18-database-setup-recovery/.pi-map.index.md -map: archive/2026-05-18-database-setup-recovery/.pi-map.md +index: 2026-05-18-database-setup-recovery/.pi-map.index.md +map: 2026-05-18-database-setup-recovery/.pi-map.md ## children -- archive/2026-05-18-database-setup-recovery/specs/database-initialization - index: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md - map: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md +- 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 ## files ## links -index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md -map: archive/2026-05-18-database-setup-recovery/specs/.pi-map.md +index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md +map: 2026-05-18-database-setup-recovery/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md index 30853c7..3ee5aa8 100644 --- a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-18-database-setup-recovery/specs -dir: archive/2026-05-18-database-setup-recovery/specs +# 2026-05-18-database-setup-recovery/specs +dir: 2026-05-18-database-setup-recovery/specs -index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md +index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md ## role -Contains database setup and recovery specifications from a 2026-05-18 archive snapshot. +Contains specification documents defining requirements for database setup and recovery procedures. ## files ## arch -Specification-driven documentation pattern using date-versioned archival storage for system recovery procedures. +Documentation-driven specification pattern with structured requirement definitions for system recovery capabilities. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md index 3cebcd1..b89309c 100644 --- a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-18-database-setup-recovery/specs/database-initialization (index) -dir: archive/2026-05-18-database-setup-recovery/specs/database-initialization +# 2026-05-18-database-setup-recovery/specs/database-initialization (index) +dir: 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. ## parent -index: archive/2026-05-18-database-setup-recovery/specs/.pi-map.index.md -map: archive/2026-05-18-database-setup-recovery/specs/.pi-map.md +index: 2026-05-18-database-setup-recovery/specs/.pi-map.index.md +map: 2026-05-18-database-setup-recovery/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md -map: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md index 7cd66a9..5ae11d9 100644 --- a/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md +++ b/openspec/changes/archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-18-database-setup-recovery/specs/database-initialization -dir: archive/2026-05-18-database-setup-recovery/specs/database-initialization +# 2026-05-18-database-setup-recovery/specs/database-initialization +dir: 2026-05-18-database-setup-recovery/specs/database-initialization -index: archive/2026-05-18-database-setup-recovery/specs/database-initialization/.pi-map.index.md +index: 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. ## files - spec.md | Defines software requirements for automatic database initialization, connection resilience, seed data management, and startup error messaging using Gherkin-style scenarios. ## arch -Behavior-driven specification using Gherkin syntax to define acceptance criteria for database lifecycle operations. +Behavior-driven specification using Gherkin syntax (Given/When/Then) to define executable requirements for database lifecycle management. ## tags spec, defines, software, requirements, automatic, database, initialization, connection ## symbols diff --git a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md index 379814f..68ce718 100644 --- a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-18-simplify-authentik-auth (index) -dir: archive/2026-05-18-simplify-authentik-auth +# 2026-05-18-simplify-authentik-auth (index) +dir: 2026-05-18-simplify-authentik-auth ## role -Contains historical design documents and planning artifacts for a completed authentication system migration from JWT tokens to session-based cookies with Authentik OAuth2 integration. +Authentication system migration package for replacing JWT/OIDC token-based auth with session-based cookies using Authentik OAuth2. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-18-simplify-authentik-auth/specs - index: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md - map: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md -map: archive/2026-05-18-simplify-authentik-auth/.pi-map.md +index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md +map: 2026-05-18-simplify-authentik-auth/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md index d614761..3ced602 100644 --- a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md +++ b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-18-simplify-authentik-auth -dir: archive/2026-05-18-simplify-authentik-auth +# 2026-05-18-simplify-authentik-auth +dir: 2026-05-18-simplify-authentik-auth -index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md +index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md ## role -Contains historical design documents and planning artifacts for a completed authentication system migration from JWT tokens to session-based cookies with Authentik OAuth2 integration. +Authentication system migration package for replacing JWT/OIDC token-based auth with session-based cookies using Authentik OAuth2. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for migrating a backend authentication system from JWT tokens to session cookies with OAuth2/Authentik integration | dep: Authentik (OAuth2), Redis (optional), backend database, frontend - proposal.md | Proposes simplifying an Authentik-based authentication system by replacing JWT/token-based auth with session-based cookies | dep: Authentik, OAuth2, session cookies, database user model, frontend auth state - tasks.md | Project task list for migrating an application from JWT/OIDC authentication to session-based authentication using Authentik | dep: Authentik, Alembic, python-jose, ruff, mypy, pytest ## arch -Document-driven design process using OpenSpec schema configuration, structured design/proposal/task documents, and date-based archival organization for tracking architectural decisions and migration planning. +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. ## tags authentik, authentication, design, jwt, session, .openspec, migrating, system ## symbols diff --git a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md index 70c3b97..924163c 100644 --- a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-18-simplify-authentik-auth/specs (index) -dir: archive/2026-05-18-simplify-authentik-auth/specs +# 2026-05-18-simplify-authentik-auth/specs (index) +dir: 2026-05-18-simplify-authentik-auth/specs ## role -Defines technical specifications for a streamlined Authentik-based OAuth2 authentication system with stateless session management +Defines technical specifications for a simplified OAuth2 authentication system using Authentik with stateless signed session cookies ## parent -index: archive/2026-05-18-simplify-authentik-auth/.pi-map.index.md -map: archive/2026-05-18-simplify-authentik-auth/.pi-map.md +index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md +map: 2026-05-18-simplify-authentik-auth/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md -map: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md +index: 2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md +map: 2026-05-18-simplify-authentik-auth/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md index 6d7dd06..e514d13 100644 --- a/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-18-simplify-authentik-auth/specs -dir: archive/2026-05-18-simplify-authentik-auth/specs +# 2026-05-18-simplify-authentik-auth/specs +dir: 2026-05-18-simplify-authentik-auth/specs -index: archive/2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md +index: 2026-05-18-simplify-authentik-auth/specs/.pi-map.index.md ## role -Defines technical specifications for a streamlined Authentik-based OAuth2 authentication system with stateless session management +Defines technical specifications for a simplified OAuth2 authentication system using Authentik with 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 ## arch -Specification-driven design documenting a stateless authentication architecture using signed JWT cookies to eliminate server-side session storage +Specification-driven design using markdown documentation to define authentication flow requirements before implementation ## tags oauth2, authentik, spec, defines, simplified, authentication, flow, stateless ## symbols diff --git a/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md b/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md index d1c1b9f..341570a 100644 --- a/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-api-documentation/.openspec (index) -dir: archive/2026-05-19-api-documentation/.openspec +# 2026-05-19-api-documentation/.openspec (index) +dir: 2026-05-19-api-documentation/.openspec ## role -Defines a schema-driven API documentation specification configuration for the OpenSpec standard +Defines the OpenAPI specification configuration schema for generating API documentation ## parent -index: archive/2026-05-19-api-documentation/.pi-map.index.md -map: archive/2026-05-19-api-documentation/.pi-map.md +index: 2026-05-19-api-documentation/.pi-map.index.md +map: 2026-05-19-api-documentation/.pi-map.md ## children - ## files - config.yaml ## links -index: archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md -map: archive/2026-05-19-api-documentation/.openspec/.pi-map.md +index: 2026-05-19-api-documentation/.openspec/.pi-map.index.md +map: 2026-05-19-api-documentation/.openspec/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.md b/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.md index 19369e3..9f51fa3 100644 --- a/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-api-documentation/.openspec/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-api-documentation/.openspec -dir: archive/2026-05-19-api-documentation/.openspec +# 2026-05-19-api-documentation/.openspec +dir: 2026-05-19-api-documentation/.openspec -index: archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md +index: 2026-05-19-api-documentation/.openspec/.pi-map.index.md ## role -Defines a schema-driven API documentation specification configuration for the OpenSpec standard +Defines the OpenAPI specification configuration schema for generating API documentation ## files - config.yaml | Defines a configuration file specifying a schema-driven API documentation specification ## arch -YAML-based declarative configuration pattern for specifying API documentation metadata and schema references +Schema-driven configuration using YAML to specify API documentation generation parameters and metadata ## tags config, defines, configuration, specifying, schema, driven, api, documentation ## symbols diff --git a/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md b/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md index 5d6393d..c0610fb 100644 --- a/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-19-api-documentation (index) -dir: archive/2026-05-19-api-documentation +# 2026-05-19-api-documentation (index) +dir: 2026-05-19-api-documentation ## role -Archive of planning documents for a FastAPI API documentation improvement initiative, now superseded/historical. +Planning and design documents for improving API documentation in a FastAPI-based application. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-api-documentation/.openspec - index: archive/2026-05-19-api-documentation/.openspec/.pi-map.index.md - map: archive/2026-05-19-api-documentation/.openspec/.pi-map.md -- archive/2026-05-19-api-documentation/specs - index: archive/2026-05-19-api-documentation/specs/.pi-map.index.md - map: archive/2026-05-19-api-documentation/specs/.pi-map.md +- 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 ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-api-documentation/.pi-map.index.md -map: archive/2026-05-19-api-documentation/.pi-map.md +index: 2026-05-19-api-documentation/.pi-map.index.md +map: 2026-05-19-api-documentation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md b/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md index 36bfce7..7332a98 100644 --- a/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-api-documentation/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-19-api-documentation -dir: archive/2026-05-19-api-documentation +# 2026-05-19-api-documentation +dir: 2026-05-19-api-documentation -index: archive/2026-05-19-api-documentation/.pi-map.index.md +index: 2026-05-19-api-documentation/.pi-map.index.md ## role -Archive of planning documents for a FastAPI API documentation improvement initiative, now superseded/historical. +Planning and design documents for improving API documentation in a FastAPI-based application. ## files - design.md | Design document outlining API documentation structure, health endpoints, and OpenAPI enhancements for a FastAPI-based application | dep: FastAPI, Pydantic v2, psutil, SQLAlchemy, PostgreSQL, Docker - proposal.md | Proposes a comprehensive API documentation improvement plan for a FastAPI-based project | dep: FastAPI, OpenAPI/Swagger, ReDoc, Pydantic, apps/api/README.md, docs/architecture/decisions/ - tasks.md | Project task tracking document for API documentation improvements across health endpoints, endpoint documentation, model documentation, README creation, architecture decisions, and quality gates ## arch -Documentation-driven planning with design-proposal-task hierarchy; covers OpenAPI schema enhancements, health endpoint standardization, and quality gating for developer experience. +Documentation-driven development with structured markdown specifications covering OpenAPI enhancements, health endpoint standards, and phased task tracking for documentation quality gates. ## tags documentation, api, fastapi, design, document, health, endpoints, openapi ## symbols diff --git a/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md index b38c379..342f71c 100644 --- a/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-api-documentation/specs (index) -dir: archive/2026-05-19-api-documentation/specs +# 2026-05-19-api-documentation/specs (index) +dir: 2026-05-19-api-documentation/specs ## role Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project ## parent -index: archive/2026-05-19-api-documentation/.pi-map.index.md -map: archive/2026-05-19-api-documentation/.pi-map.md +index: 2026-05-19-api-documentation/.pi-map.index.md +map: 2026-05-19-api-documentation/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-api-documentation/specs/.pi-map.index.md -map: archive/2026-05-19-api-documentation/specs/.pi-map.md +index: 2026-05-19-api-documentation/specs/.pi-map.index.md +map: 2026-05-19-api-documentation/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.md index e601fab..c5d9602 100644 --- a/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-api-documentation/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-api-documentation/specs -dir: archive/2026-05-19-api-documentation/specs +# 2026-05-19-api-documentation/specs +dir: 2026-05-19-api-documentation/specs -index: archive/2026-05-19-api-documentation/specs/.pi-map.index.md +index: 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 ## files - spec.md | Defines API documentation requirements, health endpoint specifications, and documentation standards for a FastAPI-based project | dep: FastAPI, OpenAPI, Pydantic, Swagger UI, ReDoc ## arch -Specification-driven documentation using markdown-based standards for OpenAPI/Swagger integration with FastAPI +Specification-driven documentation approach using markdown-based standards for API contract definition and health check endpoint design ## tags documentation, fastapi, spec, defines, api, requirements, health, endpoint ## symbols diff --git a/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md b/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md index c3753e2..3c0213a 100644 --- a/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-documentation-overhaul (index) -dir: archive/2026-05-19-documentation-overhaul +# 2026-05-19-documentation-overhaul (index) +dir: 2026-05-19-documentation-overhaul ## role -Historical archive of a planned documentation system overhaul project from May 2026, containing design specs, proposals, and task tracking artifacts. +Planning and tracking documents for a comprehensive documentation overhaul initiative scheduled for 2026-05-19. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-documentation-overhaul/specs - index: archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md - map: archive/2026-05-19-documentation-overhaul/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md -map: archive/2026-05-19-documentation-overhaul/.pi-map.md +index: 2026-05-19-documentation-overhaul/.pi-map.index.md +map: 2026-05-19-documentation-overhaul/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md b/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md index 16f3cf1..66143c0 100644 --- a/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-documentation-overhaul/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-documentation-overhaul -dir: archive/2026-05-19-documentation-overhaul +# 2026-05-19-documentation-overhaul +dir: 2026-05-19-documentation-overhaul -index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md +index: 2026-05-19-documentation-overhaul/.pi-map.index.md ## role -Historical archive of a planned documentation system overhaul project from May 2026, containing design specs, proposals, and task tracking artifacts. +Planning and tracking documents for a comprehensive documentation overhaul initiative scheduled for 2026-05-19. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Defines the structure, templates, and process for overhauling a project's documentation system - proposal.md | Proposes a comprehensive documentation overhaul for a software project to address gaps in README, feature docs, API docs, deployment guides, and architecture documentation. - tasks.md | Task tracking document for a comprehensive documentation overhaul project spanning README rewrite, documentation structure creation, feature/API/architecture documentation, deployment/development guides, and finalization ## arch -Document-driven project planning with structured specification files (OpenSpec YAML), phased proposal design, and task-based workflow tracking for systematic documentation improvement. +Standard project management structure using OpenSpec configuration, design specification, formal proposal, and task breakdown documents. ## tags documentation, project, defines, creation, .openspec, structure, design, comprehensive ## symbols diff --git a/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md index 4fb200d..6ac0fcd 100644 --- a/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-documentation-overhaul/specs (index) -dir: archive/2026-05-19-documentation-overhaul/specs +# 2026-05-19-documentation-overhaul/specs (index) +dir: 2026-05-19-documentation-overhaul/specs ## role -Defines requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application. +Defines requirements and standards for a documentation overhaul of a project management/Git repository web application. ## parent -index: archive/2026-05-19-documentation-overhaul/.pi-map.index.md -map: archive/2026-05-19-documentation-overhaul/.pi-map.md +index: 2026-05-19-documentation-overhaul/.pi-map.index.md +map: 2026-05-19-documentation-overhaul/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md -map: archive/2026-05-19-documentation-overhaul/specs/.pi-map.md +index: 2026-05-19-documentation-overhaul/specs/.pi-map.index.md +map: 2026-05-19-documentation-overhaul/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.md index bcb03af..3acc69f 100644 --- a/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-documentation-overhaul/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-documentation-overhaul/specs -dir: archive/2026-05-19-documentation-overhaul/specs +# 2026-05-19-documentation-overhaul/specs +dir: 2026-05-19-documentation-overhaul/specs -index: archive/2026-05-19-documentation-overhaul/specs/.pi-map.index.md +index: 2026-05-19-documentation-overhaul/specs/.pi-map.index.md ## role -Defines requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application. +Defines requirements and standards for a documentation overhaul of a project management/Git repository web application. ## files - spec.md | Specification document outlining requirements, templates, and processes for a comprehensive documentation overhaul of a project management/Git repository web application ## arch -Specification-driven documentation architecture using structured markdown templates, process workflows, and standardized content organization patterns. +Specification-driven documentation framework using structured templates, process workflows, and hierarchical requirement organization. ## tags spec, specification, document, outlining, requirements, templates, processes, comprehensive ## symbols diff --git a/openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md b/openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md index 41b399a..42c5e42 100644 --- a/openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-file-editor/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-file-editor (index) -dir: archive/2026-05-19-file-editor +# 2026-05-19-file-editor (index) +dir: 2026-05-19-file-editor ## role -Archive directory containing historical design documents and specifications for a file editor component that was planned to replace FileViewer with editing, syntax highlighting, and git commit capabilities. +Design and planning documentation for a next-generation file editor component with view/edit modes, syntax highlighting, and git integration ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-file-editor/specs - index: archive/2026-05-19-file-editor/specs/.pi-map.index.md - map: archive/2026-05-19-file-editor/specs/.pi-map.md +- 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 ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-file-editor/.pi-map.index.md -map: archive/2026-05-19-file-editor/.pi-map.md +index: 2026-05-19-file-editor/.pi-map.index.md +map: 2026-05-19-file-editor/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-file-editor/.pi-map.md b/openspec/changes/archive/2026-05-19-file-editor/.pi-map.md index db0e007..b055e14 100644 --- a/openspec/changes/archive/2026-05-19-file-editor/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-file-editor/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-file-editor -dir: archive/2026-05-19-file-editor +# 2026-05-19-file-editor +dir: 2026-05-19-file-editor -index: archive/2026-05-19-file-editor/.pi-map.index.md +index: 2026-05-19-file-editor/.pi-map.index.md ## role -Archive directory containing historical design documents and specifications for a file editor component that was planned to replace FileViewer with editing, syntax highlighting, and git commit capabilities. +Design and planning documentation for a next-generation file editor component with view/edit modes, syntax highlighting, and git integration ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design specification for a file editor component that replaces FileViewer with view/edit modes, syntax highlighting, and git commit integration | dep: react-simple-code-editor, prismjs, existing API endpoints (GET/POST /projects/{id}/repositories/{id}/files/content) - proposal.md | Design proposal for adding syntax highlighting and in-browser editing capabilities to a repository file viewer with Git commit integration | dep: react-simple-code-editor, Prism.js, existing PUT /files/content API endpoint - tasks.md | Project task list tracking implementation phases for a file editor component with syntax highlighting, editing, and commit capabilities | dep: react-simple-code-editor, prismjs, @types/prismjs, TypeScript, ESLint, ruff, mypy ## arch -Documentation-driven specification package with OpenSpec configuration, design docs, proposal, and task tracking—no actual implementation code, representing a waterfall-style planning artifact from a completed or abandoned feature cycle. +Specification-driven development using OpenSpec schema definitions, phased milestone tracking, and iterative design documentation (design doc → proposal → task breakdown) ## tags editor, design, syntax, highlighting, commit, react, simple, code ## symbols diff --git a/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.index.md index ac8b922..fde39ea 100644 --- a/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-file-editor/specs (index) -dir: archive/2026-05-19-file-editor/specs +# 2026-05-19-file-editor/specs (index) +dir: 2026-05-19-file-editor/specs ## role Defines technical specifications and requirements for a web-based file editor with syntax highlighting and git integration. ## parent -index: archive/2026-05-19-file-editor/.pi-map.index.md -map: archive/2026-05-19-file-editor/.pi-map.md +index: 2026-05-19-file-editor/.pi-map.index.md +map: 2026-05-19-file-editor/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-file-editor/specs/.pi-map.index.md -map: archive/2026-05-19-file-editor/specs/.pi-map.md +index: 2026-05-19-file-editor/specs/.pi-map.index.md +map: 2026-05-19-file-editor/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.md index 16a83f3..e0fca77 100644 --- a/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-file-editor/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-file-editor/specs -dir: archive/2026-05-19-file-editor/specs +# 2026-05-19-file-editor/specs +dir: 2026-05-19-file-editor/specs -index: archive/2026-05-19-file-editor/specs/.pi-map.index.md +index: 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. ## 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 ## arch -Specification-driven design using structured documentation for API contracts, component interfaces, and testing strategy. +Specification-driven design using requirements documentation, API contracts, and interface definitions to guide implementation. ## tags spec, specifies, requirements, api, contracts, component, interfaces, testing ## symbols diff --git a/openspec/changes/archive/2026-05-19-git-control/.pi-map.index.md b/openspec/changes/archive/2026-05-19-git-control/.pi-map.index.md index fe05c1f..2914356 100644 --- a/openspec/changes/archive/2026-05-19-git-control/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-git-control/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-git-control (index) -dir: archive/2026-05-19-git-control +# 2026-05-19-git-control (index) +dir: 2026-05-19-git-control ## role -Archive of design documents and specifications for adding Git version control capabilities to a browser-based repository workspace +Defines specifications and planning documents for implementing Git version control capabilities in a browser-based repository management interface. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-git-control/specs - index: archive/2026-05-19-git-control/specs/.pi-map.index.md - map: archive/2026-05-19-git-control/specs/.pi-map.md +- 2026-05-19-git-control/specs + index: 2026-05-19-git-control/specs/.pi-map.index.md + map: 2026-05-19-git-control/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-git-control/.pi-map.index.md -map: archive/2026-05-19-git-control/.pi-map.md +index: 2026-05-19-git-control/.pi-map.index.md +map: 2026-05-19-git-control/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-git-control/.pi-map.md b/openspec/changes/archive/2026-05-19-git-control/.pi-map.md index 9cf1dc6..5b1751c 100644 --- a/openspec/changes/archive/2026-05-19-git-control/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-git-control/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-git-control -dir: archive/2026-05-19-git-control +# 2026-05-19-git-control +dir: 2026-05-19-git-control -index: archive/2026-05-19-git-control/.pi-map.index.md +index: 2026-05-19-git-control/.pi-map.index.md ## role -Archive of design documents and specifications for adding Git version control capabilities to a browser-based repository workspace +Defines specifications and planning documents for implementing Git version control capabilities in a browser-based repository management interface. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design specification for a Git-based repository management UI with backend API and frontend workspace components | dep: Git, React/TypeScript, REST API, file tree UI components, dialog/modal system - proposal.md | Proposes adding git control capabilities (branch management, commit, push/pull, merge) to a browser-based repository workspace that currently only provides read-only access | dep: git, repository workspace, file viewer, branch selector, toolbar - tasks.md | Project task tracking document outlining implementation phases for a Git version control feature in a full-stack application | dep: GitPython, FastAPI, React/Vue frontend, pytest, ruff, mypy ## arch -Document-driven design with phased implementation planning, separating concerns into backend API (REST/JSON) and frontend workspace components, using Git CLI integration over libgit2 for simplicity +Documentation-driven specification pattern using OpenSpec schema configuration, phased task tracking, and separation of concerns between design specification (backend API + frontend workspace) and feature proposal (read-only to full read/write Git operations). ## tags git, design, .openspec, repository, management, workspace, react, control ## symbols diff --git a/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.index.md index 04fc6ff..a1a4fba 100644 --- a/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-git-control/specs (index) -dir: archive/2026-05-19-git-control/specs +# 2026-05-19-git-control/specs (index) +dir: 2026-05-19-git-control/specs ## role -Defines specifications for a Git version control interface with REST API and frontend capabilities for branch management, commits, remote sync, and merge operations. +Defines the API contract and UI specification for a Git version control interface that enables branch management, commits, remote sync, and merge operations. ## parent -index: archive/2026-05-19-git-control/.pi-map.index.md -map: archive/2026-05-19-git-control/.pi-map.md +index: 2026-05-19-git-control/.pi-map.index.md +map: 2026-05-19-git-control/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-git-control/specs/.pi-map.index.md -map: archive/2026-05-19-git-control/specs/.pi-map.md +index: 2026-05-19-git-control/specs/.pi-map.index.md +map: 2026-05-19-git-control/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.md index 59e49a0..28b3523 100644 --- a/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-git-control/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-git-control/specs -dir: archive/2026-05-19-git-control/specs +# 2026-05-19-git-control/specs +dir: 2026-05-19-git-control/specs -index: archive/2026-05-19-git-control/specs/.pi-map.index.md +index: 2026-05-19-git-control/specs/.pi-map.index.md ## role -Defines specifications for a Git version control interface with REST API and frontend capabilities for branch management, commits, remote sync, and merge operations. +Defines the API contract and UI specification for a Git version control interface that enables branch management, commits, remote sync, and merge operations. ## files - spec.md | Defines a REST API and frontend specification for a Git version control interface enabling branch management, commits, remote sync, and merge operations ## arch -Specification-driven design using Markdown-based API documentation with clear separation between backend REST endpoints and frontend UI requirements. +Specification-driven design using REST API documentation paired with frontend requirements, establishing clear interfaces between backend services and client implementation. ## tags spec, defines, rest, api, frontend, specification, git, version ## symbols diff --git a/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.index.md b/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.index.md index 03a54d4..90a0e23 100644 --- a/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-git-history-visualization (index) -dir: archive/2026-05-19-git-history-visualization +# 2026-05-19-git-history-visualization (index) +dir: 2026-05-19-git-history-visualization ## role -Design and planning documentation for an interactive Git history visualization web application feature. +Design and planning package for an interactive Git history visualization web application feature ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-git-history-visualization/specs - index: archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md - map: archive/2026-05-19-git-history-visualization/specs/.pi-map.md +- 2026-05-19-git-history-visualization/specs + index: 2026-05-19-git-history-visualization/specs/.pi-map.index.md + map: 2026-05-19-git-history-visualization/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-git-history-visualization/.pi-map.index.md -map: archive/2026-05-19-git-history-visualization/.pi-map.md +index: 2026-05-19-git-history-visualization/.pi-map.index.md +map: 2026-05-19-git-history-visualization/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.md b/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.md index 4e1bd70..60edb3d 100644 --- a/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-git-history-visualization/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-git-history-visualization -dir: archive/2026-05-19-git-history-visualization +# 2026-05-19-git-history-visualization +dir: 2026-05-19-git-history-visualization -index: archive/2026-05-19-git-history-visualization/.pi-map.index.md +index: 2026-05-19-git-history-visualization/.pi-map.index.md ## role -Design and planning documentation for an interactive Git history visualization web application feature. +Design and planning package for an interactive Git history visualization web application feature ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document specifying architecture, API endpoints, data models, and UI layout for a Git history visualization web application | dep: Git CLI, Backend API, Frontend (SVG rendering), JSON - proposal.md | Proposes building an interactive git history visualization tool with graph and list views for exploring commit history, branches, and diffs | dep: git CLI, React, SVG - tasks.md | Project task checklist for building a Git history visualization feature with backend API, frontend components, page integration, and testing phases | dep: Git, Python (backend), TypeScript/JavaScript (frontend), SVG, React/Vue (implied by component structure), HTTP API, Router ## arch -Specification-driven development with OpenSpec schema definitions, layered architecture (API/backend, data models, UI components), and phased task-based implementation covering graph/list dual-view frontend with commit/branch/diff exploration capabilities. +Specification-driven development with markdown-based design documents, OpenSpec schema configuration, and phased task-based project management ## tags git, history, design, visualization, .openspec, api, git cli, building ## symbols diff --git a/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md index 5f5caed..db8c8fa 100644 --- a/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-git-history-visualization/specs (index) -dir: archive/2026-05-19-git-history-visualization/specs +# 2026-05-19-git-history-visualization/specs (index) +dir: 2026-05-19-git-history-visualization/specs ## role -Defines technical specifications for a Git history visualization feature with graph/list views, commit details, and REST API endpoints +Defines technical requirements and API contract for a Git history visualization feature ## parent -index: archive/2026-05-19-git-history-visualization/.pi-map.index.md -map: archive/2026-05-19-git-history-visualization/.pi-map.md +index: 2026-05-19-git-history-visualization/.pi-map.index.md +map: 2026-05-19-git-history-visualization/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md -map: archive/2026-05-19-git-history-visualization/specs/.pi-map.md +index: 2026-05-19-git-history-visualization/specs/.pi-map.index.md +map: 2026-05-19-git-history-visualization/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.md index 4d4b007..8674fe6 100644 --- a/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-git-history-visualization/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-git-history-visualization/specs -dir: archive/2026-05-19-git-history-visualization/specs +# 2026-05-19-git-history-visualization/specs +dir: 2026-05-19-git-history-visualization/specs -index: archive/2026-05-19-git-history-visualization/specs/.pi-map.index.md +index: 2026-05-19-git-history-visualization/specs/.pi-map.index.md ## role -Defines technical specifications for a Git history visualization feature with graph/list views, commit details, and REST API endpoints +Defines technical requirements and API contract for a Git history visualization feature ## files - spec.md | Defines technical specifications for a Git history visualization feature with graph/list views, commit details, and REST API endpoints ## arch -Specification-driven design using markdown-based documentation with structured API endpoint definitions and view-layer separation +Specification-driven design using RESTful API patterns with dual-view UI (graph/list) architecture ## tags spec, defines, technical, specifications, git, history, visualization, feature ## symbols diff --git a/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.index.md b/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.index.md index 523e69c..c93cf4a 100644 --- a/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-repo-workspace (index) -dir: archive/2026-05-19-repo-workspace +# 2026-05-19-repo-workspace (index) +dir: 2026-05-19-repo-workspace ## role -Design and planning documentation for a repository workspace UI feature that enables browsing, viewing, and editing project files with Git integration. +Defines a repository workspace UI feature for browsing, viewing, and editing Git project files with branch navigation and syntax highlighting. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-repo-workspace/specs - index: archive/2026-05-19-repo-workspace/specs/.pi-map.index.md - map: archive/2026-05-19-repo-workspace/specs/.pi-map.md +- 2026-05-19-repo-workspace/specs + index: 2026-05-19-repo-workspace/specs/.pi-map.index.md + map: 2026-05-19-repo-workspace/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-repo-workspace/.pi-map.index.md -map: archive/2026-05-19-repo-workspace/.pi-map.md +index: 2026-05-19-repo-workspace/.pi-map.index.md +map: 2026-05-19-repo-workspace/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.md b/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.md index c545a0c..d8721a7 100644 --- a/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-repo-workspace/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-repo-workspace -dir: archive/2026-05-19-repo-workspace +# 2026-05-19-repo-workspace +dir: 2026-05-19-repo-workspace -index: archive/2026-05-19-repo-workspace/.pi-map.index.md +index: 2026-05-19-repo-workspace/.pi-map.index.md ## role -Design and planning documentation for a repository workspace UI feature that enables browsing, viewing, and editing project files with Git integration. +Defines a repository workspace UI feature for browsing, viewing, and editing Git project files with branch navigation and syntax highlighting. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document specifying a repository workspace UI for browsing, viewing, and editing project files with repo/branch/file navigation, syntax highlighting, and quick edit capabilities. | dep: React, URL routing, REST API, syntax highlighter, virtual scrolling - proposal.md | Proposes a repository workspace as the default project view with file browsing, branch selection, and file viewing/editing capabilities - tasks.md | Project task tracking document outlining implementation phases for a Git repository workspace UI with file browsing, editing, and navigation features | dep: git, React/Next.js, FastAPI, prismjs, ruff, mypy, pytest ## arch -Document-driven specification package using markdown-based design docs, proposals, and task tracking with YAML configuration metadata, following a phased implementation planning pattern. +Documentation-driven specification with OpenSpec schema configuration, using phased task planning (design → proposal → implementation tracking) for a file-tree navigation pattern with quick-edit capabilities. ## tags design, repository, workspace, browsing, editing, project, .openspec, document ## symbols diff --git a/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.index.md index 96d9c29..fbe5c27 100644 --- a/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-repo-workspace/specs (index) -dir: archive/2026-05-19-repo-workspace/specs +# 2026-05-19-repo-workspace/specs (index) +dir: 2026-05-19-repo-workspace/specs ## role Defines technical specifications for a repository workspace web application with file browsing, branch navigation, and quick editing capabilities ## parent -index: archive/2026-05-19-repo-workspace/.pi-map.index.md -map: archive/2026-05-19-repo-workspace/.pi-map.md +index: 2026-05-19-repo-workspace/.pi-map.index.md +map: 2026-05-19-repo-workspace/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-repo-workspace/specs/.pi-map.index.md -map: archive/2026-05-19-repo-workspace/specs/.pi-map.md +index: 2026-05-19-repo-workspace/specs/.pi-map.index.md +map: 2026-05-19-repo-workspace/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.md index 4912953..2e14381 100644 --- a/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-repo-workspace/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-repo-workspace/specs -dir: archive/2026-05-19-repo-workspace/specs +# 2026-05-19-repo-workspace/specs +dir: 2026-05-19-repo-workspace/specs -index: archive/2026-05-19-repo-workspace/specs/.pi-map.index.md +index: 2026-05-19-repo-workspace/specs/.pi-map.index.md ## role Defines technical specifications for a repository workspace web application with file browsing, branch navigation, and quick editing capabilities ## files - spec.md | Defines technical specifications for a repository workspace web application with file browsing, branch navigation, and quick editing capabilities | dep: React, React Router, URLSearchParams, git backend, syntax highlighting library ## arch -Specification-driven design with markdown-based documentation defining requirements for a web-based code repository interface +Specification-driven design using Markdown documentation as the single source of truth for requirements and system behavior ## tags spec, defines, technical, specifications, repository, workspace, web, application ## symbols diff --git a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md index 7848395..05f0c33 100644 --- a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-responsive-spacing-improvements/.openspec (index) -dir: archive/2026-05-19-responsive-spacing-improvements/.openspec +# 2026-05-19-responsive-spacing-improvements/.openspec (index) +dir: 2026-05-19-responsive-spacing-improvements/.openspec ## role -Defines the OpenAPI-style specification configuration for a responsive spacing design system improvement project. +Configuration directory for a specification-driven project defining responsive spacing improvements ## parent -index: archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md -map: archive/2026-05-19-responsive-spacing-improvements/.pi-map.md +index: 2026-05-19-responsive-spacing-improvements/.pi-map.index.md +map: 2026-05-19-responsive-spacing-improvements/.pi-map.md ## children - ## files - config.yaml ## links -index: archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md -map: archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md +index: 2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md +map: 2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md index d70eb19..e284487 100644 --- a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-responsive-spacing-improvements/.openspec -dir: archive/2026-05-19-responsive-spacing-improvements/.openspec +# 2026-05-19-responsive-spacing-improvements/.openspec +dir: 2026-05-19-responsive-spacing-improvements/.openspec -index: archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md +index: 2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md ## role -Defines the OpenAPI-style specification configuration for a responsive spacing design system improvement project. +Configuration directory for a specification-driven project defining responsive spacing improvements ## files - config.yaml | Defines a configuration file for a specification-driven project named "responsive-spacing-improvements" ## arch -YAML-based declarative configuration pattern for specification-driven API or design token generation. +Single YAML configuration file using declarative specification pattern for project metadata and settings ## tags config, defines, configuration, specification, driven, project, named, responsive ## symbols diff --git a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md index 48ce357..ba09553 100644 --- a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-19-responsive-spacing-improvements (index) -dir: archive/2026-05-19-responsive-spacing-improvements +# 2026-05-19-responsive-spacing-improvements (index) +dir: 2026-05-19-responsive-spacing-improvements ## role -Documentation archive for a completed responsive design system overhaul that standardized spacing, sizing, and mobile usability across a web application's UI. +Documents a completed responsive design system project that improved spacing, sizing, and mobile usability across a web application's UI. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-responsive-spacing-improvements/.openspec - index: archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md - map: archive/2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md -- archive/2026-05-19-responsive-spacing-improvements/specs - index: archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md - map: archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.md +- 2026-05-19-responsive-spacing-improvements/.openspec + index: 2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.index.md + map: 2026-05-19-responsive-spacing-improvements/.openspec/.pi-map.md +- 2026-05-19-responsive-spacing-improvements/specs + index: 2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md + map: 2026-05-19-responsive-spacing-improvements/specs/.pi-map.md ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md -map: archive/2026-05-19-responsive-spacing-improvements/.pi-map.md +index: 2026-05-19-responsive-spacing-improvements/.pi-map.index.md +map: 2026-05-19-responsive-spacing-improvements/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.md b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.md index e4ab54f..7c80995 100644 --- a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-19-responsive-spacing-improvements -dir: archive/2026-05-19-responsive-spacing-improvements +# 2026-05-19-responsive-spacing-improvements +dir: 2026-05-19-responsive-spacing-improvements -index: archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md +index: 2026-05-19-responsive-spacing-improvements/.pi-map.index.md ## role -Documentation archive for a completed responsive design system overhaul that standardized spacing, sizing, and mobile usability across a web application's UI. +Documents a completed responsive design system project that improved spacing, sizing, and mobile usability across a web application's UI. ## files - design.md | Design document specifying a responsive CSS design system with spacing scales, breakpoints, layout components, and migration strategy for improving responsive behavior across a web application. - proposal.md | Proposes a comprehensive responsive design system to fix spacing, sizing, and mobile usability issues in a UI - tasks.md | A completed task checklist documenting a responsive spacing and layout improvement project across CSS foundations, layout utilities, component updates, overflow fixes, touch targets, and quality gates. ## arch -Design-proposal-execution pattern with structured design specs, formal proposals, and task-based project tracking; follows a design system architecture with token-based spacing scales, breakpoint-driven responsive utilities, and component-level migration strategy. +Design-system architecture with token-based CSS spacing scales, breakpoint-driven responsive utilities, component migration strategy, and phased implementation with quality gates for systematic UI modernization. ## tags design, responsive, spacing, layout, css, system, across, proposal ## symbols diff --git a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md index f32791c..6a0dc1b 100644 --- a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-responsive-spacing-improvements/specs (index) -dir: archive/2026-05-19-responsive-spacing-improvements/specs +# 2026-05-19-responsive-spacing-improvements/specs (index) +dir: 2026-05-19-responsive-spacing-improvements/specs ## role -Defines technical specifications for responsive design system improvements including spacing, typography, and mobile-first layouts. +Defines technical specifications for responsive design system improvements including spacing, typography, and layout. ## parent -index: archive/2026-05-19-responsive-spacing-improvements/.pi-map.index.md -map: archive/2026-05-19-responsive-spacing-improvements/.pi-map.md +index: 2026-05-19-responsive-spacing-improvements/.pi-map.index.md +map: 2026-05-19-responsive-spacing-improvements/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md -map: archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.md +index: 2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md +map: 2026-05-19-responsive-spacing-improvements/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.md index 7d134fe..7c1cf3b 100644 --- a/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-responsive-spacing-improvements/specs -dir: archive/2026-05-19-responsive-spacing-improvements/specs +# 2026-05-19-responsive-spacing-improvements/specs +dir: 2026-05-19-responsive-spacing-improvements/specs -index: archive/2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md +index: 2026-05-19-responsive-spacing-improvements/specs/.pi-map.index.md ## role -Defines technical specifications for responsive design system improvements including spacing, typography, and mobile-first layouts. +Defines technical specifications for responsive design system improvements including spacing, typography, and layout. ## files - spec.md | Defines a specification for implementing responsive spacing, fluid typography, and mobile-first layout improvements across a web application | dep: CSS custom properties, clamp(), viewport units, media queries, WCAG 2.5.5 ## arch -Documentation-driven specification pattern using a single markdown file to capture requirements for cross-cutting UI/UX enhancements. +Markdown-based specification document using prose requirements with code examples, following a mobile-first responsive design pattern with fluid CSS techniques. ## tags spec, defines, specification, implementing, responsive, spacing, fluid, typography ## symbols diff --git a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md index 1ee5625..738fbaf 100644 --- a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-smart-git-url-parsing (index) -dir: archive/2026-05-19-smart-git-url-parsing +# 2026-05-19-smart-git-url-parsing (index) +dir: 2026-05-19-smart-git-url-parsing ## role -Prototype package containing design documents and specifications for a smart Git URL parsing feature that normalizes browser URLs to cloneable Git URLs +Defines a feature proposal and implementation plan for intelligent Git URL parsing that converts browser URLs to valid clone URLs during repository creation. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-smart-git-url-parsing/specs - index: archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md - map: archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.md +- 2026-05-19-smart-git-url-parsing/specs + index: 2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md + map: 2026-05-19-smart-git-url-parsing/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md -map: archive/2026-05-19-smart-git-url-parsing/.pi-map.md +index: 2026-05-19-smart-git-url-parsing/.pi-map.index.md +map: 2026-05-19-smart-git-url-parsing/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.md b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.md index aa02371..bd90c47 100644 --- a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-smart-git-url-parsing -dir: archive/2026-05-19-smart-git-url-parsing +# 2026-05-19-smart-git-url-parsing +dir: 2026-05-19-smart-git-url-parsing -index: archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md +index: 2026-05-19-smart-git-url-parsing/.pi-map.index.md ## role -Prototype package containing design documents and specifications for a smart Git URL parsing feature that normalizes browser URLs to cloneable Git URLs +Defines a feature proposal and implementation plan for intelligent Git URL parsing that converts browser URLs to valid clone URLs during repository creation. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for a smart Git URL parsing feature that detects browser URLs from GitHub/GitLab/Bitbucket and converts them to valid clone URLs - proposal.md | Proposes a feature to intelligently parse and correct malformed Git repository URLs pasted by users during repository creation - tasks.md | Project task breakdown for implementing smart Git URL parsing across backend and frontend with validation, suggestion, and user confirmation flows | dep: FastAPI, Python, TypeScript, React, ruff, mypy, pytest ## arch -Document-driven specification pattern with OpenSpec schema configuration, separated into design rationale (design.md), feature proposal (proposal.md), and implementation task tracking (tasks.md) +Documentation-driven design using markdown specs (design/proposal/tasks) with YAML metadata, following a structured product development workflow from concept to task breakdown. ## tags design, git, urls, creation, .openspec, smart, url, parsing ## symbols diff --git a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md index 62e292f..a9f8ce0 100644 --- a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-smart-git-url-parsing/specs (index) -dir: archive/2026-05-19-smart-git-url-parsing/specs +# 2026-05-19-smart-git-url-parsing/specs (index) +dir: 2026-05-19-smart-git-url-parsing/specs ## role -Defines specifications for intelligent URL parsing to distinguish browser URLs from git clone URLs with repository extraction and user confirmation workflows. +Defines the behavioral specification for a smart URL parsing system that distinguishes browser URLs from git clone URLs and extracts canonical repository URLs with user confirmation workflows. ## parent -index: archive/2026-05-19-smart-git-url-parsing/.pi-map.index.md -map: archive/2026-05-19-smart-git-url-parsing/.pi-map.md +index: 2026-05-19-smart-git-url-parsing/.pi-map.index.md +map: 2026-05-19-smart-git-url-parsing/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md -map: archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.md +index: 2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md +map: 2026-05-19-smart-git-url-parsing/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.md index 81d966d..0cc5925 100644 --- a/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-smart-git-url-parsing/specs -dir: archive/2026-05-19-smart-git-url-parsing/specs +# 2026-05-19-smart-git-url-parsing/specs +dir: 2026-05-19-smart-git-url-parsing/specs -index: archive/2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md +index: 2026-05-19-smart-git-url-parsing/specs/.pi-map.index.md ## role -Defines specifications for intelligent URL parsing to distinguish browser URLs from git clone URLs with repository extraction and user confirmation workflows. +Defines the behavioral specification for a smart URL parsing system that distinguishes browser URLs from git clone URLs and extracts canonical repository URLs with user confirmation workflows. ## files - spec.md | Defines a specification for detecting browser URLs versus git clone URLs and extracting base repository URLs with user confirmation workflows ## arch -Markdown-based specification document using structured requirements definition with workflow state diagrams and decision trees for URL classification logic. +Specification-driven design using markdown-based requirements documentation with structured sections for overview, goals, non-goals, user stories, and detailed behavioral specifications for URL classification, extraction, and interactive confirmation flows. ## tags urls, spec, defines, specification, detecting, browser, versus, git ## symbols diff --git a/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md b/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md index 029d7c9..f9f8ea4 100644 --- a/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-tool-instances/.openspec (index) -dir: archive/2026-05-19-tool-instances/.openspec +# 2026-05-19-tool-instances/.openspec (index) +dir: 2026-05-19-tool-instances/.openspec ## role -Defines the OpenAPI specification schema configuration for tool instance metadata. +Defines the OpenAPI specification schema configuration for tool instances in the project. ## parent -index: archive/2026-05-19-tool-instances/.pi-map.index.md -map: archive/2026-05-19-tool-instances/.pi-map.md +index: 2026-05-19-tool-instances/.pi-map.index.md +map: 2026-05-19-tool-instances/.pi-map.md ## children - ## files - config.yaml ## links -index: archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md -map: archive/2026-05-19-tool-instances/.openspec/.pi-map.md +index: 2026-05-19-tool-instances/.openspec/.pi-map.index.md +map: 2026-05-19-tool-instances/.openspec/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.md b/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.md index 279ef23..3b349cc 100644 --- a/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-tool-instances/.openspec/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-tool-instances/.openspec -dir: archive/2026-05-19-tool-instances/.openspec +# 2026-05-19-tool-instances/.openspec +dir: 2026-05-19-tool-instances/.openspec -index: archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md +index: 2026-05-19-tool-instances/.openspec/.pi-map.index.md ## role -Defines the OpenAPI specification schema configuration for tool instance metadata. +Defines the OpenAPI specification schema configuration for tool instances in the project. ## files - config.yaml | Defines a configuration file specifying a schema type and name for tool instances. ## arch -Simple declarative configuration using YAML to specify schema types and naming conventions. +Simple declarative configuration using YAML to specify schema metadata (type "openapi" and name "ToolInstances") for code generation or API documentation purposes. ## tags config, defines, configuration, specifying, schema, type, name, tool ## symbols diff --git a/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.index.md index 22cc31a..1ea6315 100644 --- a/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-19-tool-instances (index) -dir: archive/2026-05-19-tool-instances +# 2026-05-19-tool-instances (index) +dir: 2026-05-19-tool-instances ## role -Design and planning documents for a Docker-based ephemeral development environment system that provisions per-repository tool instances with lifecycle management. +Defines the architecture and requirements for a Docker-based containerized development environment management system that provisions isolated tool instances per repository with lifecycle management. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-tool-instances/.openspec - index: archive/2026-05-19-tool-instances/.openspec/.pi-map.index.md - map: archive/2026-05-19-tool-instances/.openspec/.pi-map.md -- archive/2026-05-19-tool-instances/specs - index: archive/2026-05-19-tool-instances/specs/.pi-map.index.md - map: archive/2026-05-19-tool-instances/specs/.pi-map.md +- 2026-05-19-tool-instances/.openspec + index: 2026-05-19-tool-instances/.openspec/.pi-map.index.md + map: 2026-05-19-tool-instances/.openspec/.pi-map.md +- 2026-05-19-tool-instances/specs + index: 2026-05-19-tool-instances/specs/.pi-map.index.md + map: 2026-05-19-tool-instances/specs/.pi-map.md ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-tool-instances/.pi-map.index.md -map: archive/2026-05-19-tool-instances/.pi-map.md +index: 2026-05-19-tool-instances/.pi-map.index.md +map: 2026-05-19-tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.md b/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.md index 1dbd597..b08c4d0 100644 --- a/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-tool-instances/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-19-tool-instances -dir: archive/2026-05-19-tool-instances +# 2026-05-19-tool-instances +dir: 2026-05-19-tool-instances -index: archive/2026-05-19-tool-instances/.pi-map.index.md +index: 2026-05-19-tool-instances/.pi-map.index.md ## role -Design and planning documents for a Docker-based ephemeral development environment system that provisions per-repository tool instances with lifecycle management. +Defines the architecture and requirements for a Docker-based containerized development environment management system that provisions isolated tool instances per repository with lifecycle management. ## files - design.md | Design document specifying a Docker-based tool instance system for launching and managing development environments per repository with lifecycle management and frontend integration. | dep: Docker, Docker Compose, SQLAlchemy/Base, React/useAtom, AppShell, GitRepository, ToolType, Project, User - proposal.md | Proposes a system for managing Docker-based development tool instances with persistent sessions linked to repositories | dep: Docker Compose, Docker API, GitRepository, ToolType, database - tasks.md | Project task tracking document for implementing Docker-based tool instance management with backend API, frontend UI, and lifecycle operations | dep: FastAPI, SQLAlchemy, Alembic, Docker, React/TypeScript, Jotai, docker-compose ## arch -Specification-driven architecture using Docker containers for isolated tool instances, REST API backend for lifecycle operations (create/start/stop/delete), WebSocket or polling for frontend status updates, and repository-scoped persistent sessions with state management. +Event-driven microservices architecture with REST API backend, frontend UI, and Docker container orchestration using session persistence, lifecycle state machines, and repository-scoped resource isolation. ## tags docker, design, tool, document, instance, system, managing, development ## symbols diff --git a/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.index.md index a1a4a27..2bccaf8 100644 --- a/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-tool-instances/specs (index) -dir: archive/2026-05-19-tool-instances/specs +# 2026-05-19-tool-instances/specs (index) +dir: 2026-05-19-tool-instances/specs ## role -Defines technical specifications for a tool instance management system that creates, monitors, and controls Docker containers for user sessions with lifecycle operations and status tracking. +Defines technical specifications for a Docker-based tool instance management system handling container lifecycle and status tracking. ## parent -index: archive/2026-05-19-tool-instances/.pi-map.index.md -map: archive/2026-05-19-tool-instances/.pi-map.md +index: 2026-05-19-tool-instances/.pi-map.index.md +map: 2026-05-19-tool-instances/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-tool-instances/specs/.pi-map.index.md -map: archive/2026-05-19-tool-instances/specs/.pi-map.md +index: 2026-05-19-tool-instances/specs/.pi-map.index.md +map: 2026-05-19-tool-instances/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.md index 2c306e7..db6515e 100644 --- a/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-tool-instances/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-tool-instances/specs -dir: archive/2026-05-19-tool-instances/specs +# 2026-05-19-tool-instances/specs +dir: 2026-05-19-tool-instances/specs -index: archive/2026-05-19-tool-instances/specs/.pi-map.index.md +index: 2026-05-19-tool-instances/specs/.pi-map.index.md ## role -Defines technical specifications for a tool instance management system that creates, monitors, and controls Docker containers for user sessions with lifecycle operations and status tracking. +Defines technical specifications for a Docker-based tool instance management system handling container lifecycle and status tracking. ## files - spec.md | Defines technical specifications for a tool instance management system that creates, monitors, and controls Docker containers for user sessions with lifecycle operations and status tracking. | dep: Docker, PostgreSQL, REST API, Git repositories, template engine ## arch -Specification-driven architecture using markdown-based documentation to define system requirements, container lifecycle management patterns, and session-based resource orchestration for ephemeral Docker environments. +Specification-driven architecture with lifecycle state management (create/monitor/control) for session-isolated container orchestration. ## tags docker, spec, defines, technical, specifications, tool, instance, management ## symbols diff --git a/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md b/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md index 26a861e..a37beb6 100644 --- a/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-tool-terminal/.openspec (index) -dir: archive/2026-05-19-tool-terminal/.openspec +# 2026-05-19-tool-terminal/.openspec (index) +dir: 2026-05-19-tool-terminal/.openspec ## role -Defines an OpenAPI-style specification for a tool-terminal component configuration. +Defines the OpenAPI specification configuration for the tool-terminal component. ## parent -index: archive/2026-05-19-tool-terminal/.pi-map.index.md -map: archive/2026-05-19-tool-terminal/.pi-map.md +index: 2026-05-19-tool-terminal/.pi-map.index.md +map: 2026-05-19-tool-terminal/.pi-map.md ## children - ## files - config.yaml ## links -index: archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md -map: archive/2026-05-19-tool-terminal/.openspec/.pi-map.md +index: 2026-05-19-tool-terminal/.openspec/.pi-map.index.md +map: 2026-05-19-tool-terminal/.openspec/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.md b/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.md index 507208d..036c8d2 100644 --- a/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-tool-terminal/.openspec/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-tool-terminal/.openspec -dir: archive/2026-05-19-tool-terminal/.openspec +# 2026-05-19-tool-terminal/.openspec +dir: 2026-05-19-tool-terminal/.openspec -index: archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md +index: 2026-05-19-tool-terminal/.openspec/.pi-map.index.md ## role -Defines an OpenAPI-style specification for a tool-terminal component configuration. +Defines the OpenAPI specification configuration for the tool-terminal component. ## files - config.yaml | Defines a basic configuration file specifying a schema type and name for a tool-terminal component. ## arch -Declarative schema configuration using YAML for component metadata definition. +Simple declarative configuration using YAML for schema metadata definition. ## tags config, defines, basic, configuration, specifying, schema, type, name ## symbols diff --git a/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.index.md b/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.index.md index 7976414..c5d1176 100644 --- a/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-19-tool-terminal (index) -dir: archive/2026-05-19-tool-terminal +# 2026-05-19-tool-terminal (index) +dir: 2026-05-19-tool-terminal ## role -Archive directory containing historical design documents for a browser-based Docker container terminal feature using WebSocket streaming. +Implements a browser-based terminal interface for Docker containers using WebSocket bidirectional streaming with xterm.js frontend and docker exec PTY backend. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-tool-terminal/.openspec - index: archive/2026-05-19-tool-terminal/.openspec/.pi-map.index.md - map: archive/2026-05-19-tool-terminal/.openspec/.pi-map.md -- archive/2026-05-19-tool-terminal/specs - index: archive/2026-05-19-tool-terminal/specs/.pi-map.index.md - map: archive/2026-05-19-tool-terminal/specs/.pi-map.md +- 2026-05-19-tool-terminal/.openspec + index: 2026-05-19-tool-terminal/.openspec/.pi-map.index.md + map: 2026-05-19-tool-terminal/.openspec/.pi-map.md +- 2026-05-19-tool-terminal/specs + index: 2026-05-19-tool-terminal/specs/.pi-map.index.md + map: 2026-05-19-tool-terminal/specs/.pi-map.md ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-tool-terminal/.pi-map.index.md -map: archive/2026-05-19-tool-terminal/.pi-map.md +index: 2026-05-19-tool-terminal/.pi-map.index.md +map: 2026-05-19-tool-terminal/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.md b/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.md index 3f002f7..93c3b84 100644 --- a/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-tool-terminal/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-19-tool-terminal -dir: archive/2026-05-19-tool-terminal +# 2026-05-19-tool-terminal +dir: 2026-05-19-tool-terminal -index: archive/2026-05-19-tool-terminal/.pi-map.index.md +index: 2026-05-19-tool-terminal/.pi-map.index.md ## role -Archive directory containing historical design documents for a browser-based Docker container terminal feature using WebSocket streaming. +Implements a browser-based terminal interface for Docker containers using WebSocket bidirectional streaming with xterm.js frontend and docker exec PTY backend. ## files - design.md | Design document specifying a web-based terminal interface for Docker containers using WebSocket bidirectional streaming with xterm.js frontend and docker exec PTY backend. | dep: WebSocket, Docker, xterm.js, asyncio, subprocess, fcntl, xterm-addon-fit, xterm-addon-web-links - proposal.md | Proposes a browser-based terminal access system for Docker containers via WebSocket | dep: Docker, WebSocket, xterm.js, pseudo-TTY/PTY - tasks.md | Project task tracking document for implementing a WebSocket-based terminal feature using xterm.js and Docker exec | dep: FastAPI, WebSocket, asyncio-subprocess, xterm.js, xterm-addon-fit, xterm-addon-web-links, docker, PTY, React/Next.js ## arch -WebSocket bidirectional architecture with xterm.js frontend, docker exec PTY backend, and full-duplex streaming for browser-based container shell access. +Client-server architecture with WebSocket for real-time bidirectional communication, xterm.js for terminal emulation in the browser, and Docker exec API for PTY allocation to container processes. ## tags xterm, docker, websocket, js, addon, design, web, terminal ## symbols diff --git a/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.index.md index 23c71a6..e4587ed 100644 --- a/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-tool-terminal/specs (index) -dir: archive/2026-05-19-tool-terminal/specs +# 2026-05-19-tool-terminal/specs (index) +dir: 2026-05-19-tool-terminal/specs ## role -Defines protocol specifications for browser-based terminal access to Docker containers +Defines protocol specifications for browser-based remote terminal access to Docker containers ## parent -index: archive/2026-05-19-tool-terminal/.pi-map.index.md -map: archive/2026-05-19-tool-terminal/.pi-map.md +index: 2026-05-19-tool-terminal/.pi-map.index.md +map: 2026-05-19-tool-terminal/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-tool-terminal/specs/.pi-map.index.md -map: archive/2026-05-19-tool-terminal/specs/.pi-map.md +index: 2026-05-19-tool-terminal/specs/.pi-map.index.md +map: 2026-05-19-tool-terminal/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.md index fede958..adf2176 100644 --- a/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-tool-terminal/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-tool-terminal/specs -dir: archive/2026-05-19-tool-terminal/specs +# 2026-05-19-tool-terminal/specs +dir: 2026-05-19-tool-terminal/specs -index: archive/2026-05-19-tool-terminal/specs/.pi-map.index.md +index: 2026-05-19-tool-terminal/specs/.pi-map.index.md ## role -Defines protocol specifications for browser-based terminal access to Docker containers +Defines protocol specifications for browser-based remote terminal access to Docker containers ## files - spec.md | Defines a WebSocket-based terminal specification for spawning interactive shell sessions inside Docker containers via browser-based terminals | dep: FastAPI, asyncio, docker CLI, xterm.js, xterm-addon-fit, xterm-addon-web-links ## arch -WebSocket-based API specification document describing bidirectional communication protocol for interactive shell sessions +Markdown-based specification document using WebSocket transport protocol with Docker container runtime integration ## tags xterm, addon, spec, defines, websocket, terminal, specification, spawning ## symbols diff --git a/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md b/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md index d942bda..2269058 100644 --- a/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-universal-icon-system/.openspec (index) -dir: archive/2026-05-19-universal-icon-system/.openspec +# 2026-05-19-universal-icon-system/.openspec (index) +dir: 2026-05-19-universal-icon-system/.openspec ## role -Defines configuration schema and defaults for the universal icon system's specification format. +Provides configuration specification for a universal icon system that generates icons across multiple platforms and formats from a single source. ## parent -index: archive/2026-05-19-universal-icon-system/.pi-map.index.md -map: archive/2026-05-19-universal-icon-system/.pi-map.md +index: 2026-05-19-universal-icon-system/.pi-map.index.md +map: 2026-05-19-universal-icon-system/.pi-map.md ## children - ## files - config.yaml ## links -index: archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md -map: archive/2026-05-19-universal-icon-system/.openspec/.pi-map.md +index: 2026-05-19-universal-icon-system/.openspec/.pi-map.index.md +map: 2026-05-19-universal-icon-system/.openspec/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.md b/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.md index 1e8c46b..ce9cae5 100644 --- a/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-universal-icon-system/.openspec/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-universal-icon-system/.openspec -dir: archive/2026-05-19-universal-icon-system/.openspec +# 2026-05-19-universal-icon-system/.openspec +dir: 2026-05-19-universal-icon-system/.openspec -index: archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md +index: 2026-05-19-universal-icon-system/.openspec/.pi-map.index.md ## role -Defines configuration schema and defaults for the universal icon system's specification format. +Provides configuration specification for a universal icon system that generates icons across multiple platforms and formats from a single source. ## files - config.yaml | Defines a basic configuration for a specification-driven universal icon system ## arch -YAML-based declarative configuration pattern with minimal single-file structure for specification-driven design systems. +YAML-based declarative configuration pattern defining build targets, output formats, and source asset specifications for cross-platform icon generation. ## tags config, defines, basic, configuration, specification, driven, universal, icon ## symbols diff --git a/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.index.md b/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.index.md index e35ef02..db3d21d 100644 --- a/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-19-universal-icon-system (index) -dir: archive/2026-05-19-universal-icon-system +# 2026-05-19-universal-icon-system (index) +dir: 2026-05-19-universal-icon-system ## role -Design and planning documentation for a centralized Phosphor icon system to standardize icon usage across a React application. +Design and planning documentation for a centralized Phosphor icon system to replace inconsistent Unicode symbols in a React application. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-universal-icon-system/.openspec - index: archive/2026-05-19-universal-icon-system/.openspec/.pi-map.index.md - map: archive/2026-05-19-universal-icon-system/.openspec/.pi-map.md -- archive/2026-05-19-universal-icon-system/specs - index: archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md - map: archive/2026-05-19-universal-icon-system/specs/.pi-map.md +- 2026-05-19-universal-icon-system/.openspec + index: 2026-05-19-universal-icon-system/.openspec/.pi-map.index.md + map: 2026-05-19-universal-icon-system/.openspec/.pi-map.md +- 2026-05-19-universal-icon-system/specs + index: 2026-05-19-universal-icon-system/specs/.pi-map.index.md + map: 2026-05-19-universal-icon-system/specs/.pi-map.md ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-universal-icon-system/.pi-map.index.md -map: archive/2026-05-19-universal-icon-system/.pi-map.md +index: 2026-05-19-universal-icon-system/.pi-map.index.md +map: 2026-05-19-universal-icon-system/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.md b/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.md index 139f265..dc8f69e 100644 --- a/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-universal-icon-system/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-19-universal-icon-system -dir: archive/2026-05-19-universal-icon-system +# 2026-05-19-universal-icon-system +dir: 2026-05-19-universal-icon-system -index: archive/2026-05-19-universal-icon-system/.pi-map.index.md +index: 2026-05-19-universal-icon-system/.pi-map.index.md ## role -Design and planning documentation for a centralized Phosphor icon system to standardize icon usage across a React application. +Design and planning documentation for a centralized Phosphor icon system to replace inconsistent Unicode symbols in a React application. ## files - design.md | Design specification for implementing a centralized icon system using Phosphor icons to replace raw Unicode symbols across a React application | dep: @phosphor-icons/react, React, TypeScript, CSS - proposal.md | Proposes implementing a universal icon system using Phosphor Icons to replace inconsistent Unicode symbols across a frontend project. | dep: phosphor-react - tasks.md | Project task list for implementing a universal icon system using Phosphor Icons across a React/TypeScript application | dep: @phosphor-icons/react, React, TypeScript, CSS/SCSS ## arch -Markdown-based project specification package containing design docs, proposal, and task breakdown for a Unicode-to-SVG icon migration system. +Markdown-based specification documents using a hierarchical task breakdown (design → proposal → tasks) with no actual code implementation; follows a documentation-first planning pattern for UI component standardization. ## tags react, icons, phosphor, design, implementing, icon, system, across ## symbols diff --git a/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md index b4cb28b..272300a 100644 --- a/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-universal-icon-system/specs (index) -dir: archive/2026-05-19-universal-icon-system/specs +# 2026-05-19-universal-icon-system/specs (index) +dir: 2026-05-19-universal-icon-system/specs ## role -Defines technical specifications for a universal icon system using Phosphor icons with standardized sizing, centralized registry, and accessibility compliance. +Defines technical specifications and requirements for implementing a universal icon system with standardized sizing, accessibility, and registry-based icon management. ## parent -index: archive/2026-05-19-universal-icon-system/.pi-map.index.md -map: archive/2026-05-19-universal-icon-system/.pi-map.md +index: 2026-05-19-universal-icon-system/.pi-map.index.md +map: 2026-05-19-universal-icon-system/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md -map: archive/2026-05-19-universal-icon-system/specs/.pi-map.md +index: 2026-05-19-universal-icon-system/specs/.pi-map.index.md +map: 2026-05-19-universal-icon-system/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.md index d34e912..cab5bd7 100644 --- a/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-universal-icon-system/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-universal-icon-system/specs -dir: archive/2026-05-19-universal-icon-system/specs +# 2026-05-19-universal-icon-system/specs +dir: 2026-05-19-universal-icon-system/specs -index: archive/2026-05-19-universal-icon-system/specs/.pi-map.index.md +index: 2026-05-19-universal-icon-system/specs/.pi-map.index.md ## role -Defines technical specifications for a universal icon system using Phosphor icons with standardized sizing, centralized registry, and accessibility compliance. +Defines technical specifications and requirements for implementing a universal icon system with standardized sizing, accessibility, and registry-based icon management. ## files - spec.md | Specification document defining a universal icon system using Phosphor icons with a centralized registry, size variants, and accessibility requirements. | dep: @phosphor-icons/react ## arch -Documentation-driven specification pattern establishing design system contracts with explicit token-based sizing, registry-based icon lookup, and WCAG-aligned accessibility requirements. +Specification-driven architecture using centralized registry pattern with variant-based sizing system and accessibility-first design constraints. ## tags icons, spec, specification, document, defining, universal, icon, system ## symbols diff --git a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md index 9e045c3..e3d96b3 100644 --- a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-19-workspace-visual-overhaul (index) -dir: archive/2026-05-19-workspace-visual-overhaul +# 2026-05-19-workspace-visual-overhaul (index) +dir: 2026-05-19-workspace-visual-overhaul ## role -Contains historical planning documents for a 2026 UI/UX redesign of a workspace interface with repository management, sidebar, and settings overhaul. +Design and planning package for a UI/UX visual overhaul of a workspace/settings interface adopting GitHub-style conventions. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-19-workspace-visual-overhaul/specs - index: archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md - map: archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.md +- 2026-05-19-workspace-visual-overhaul/specs + index: 2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md + map: 2026-05-19-workspace-visual-overhaul/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md -map: archive/2026-05-19-workspace-visual-overhaul/.pi-map.md +index: 2026-05-19-workspace-visual-overhaul/.pi-map.index.md +map: 2026-05-19-workspace-visual-overhaul/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.md b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.md index 838cff8..63c9c00 100644 --- a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-19-workspace-visual-overhaul -dir: archive/2026-05-19-workspace-visual-overhaul +# 2026-05-19-workspace-visual-overhaul +dir: 2026-05-19-workspace-visual-overhaul -index: archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md +index: 2026-05-19-workspace-visual-overhaul/.pi-map.index.md ## role -Contains historical planning documents for a 2026 UI/UX redesign of a workspace interface with repository management, sidebar, and settings overhaul. +Design and planning package for a UI/UX visual overhaul of a workspace/settings interface adopting GitHub-style conventions. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for a workspace visual overhaul featuring a new project header, consolidated settings page with tabs, simplified sidebar, and updated routing structure. | dep: React/TypeScript component system, CSS variables/styling system, React Router, existing project API endpoints - proposal.md | Proposes a UI/UX redesign of a repository workspace to follow GitHub-style layout conventions - tasks.md | Project task list tracking a multi-phase UI overhaul for a workspace/settings interface with repository management, sidebar cleanup, and polish items ## arch -Document-based project planning with no executable code; uses Markdown for design specs, task tracking, and proposals, plus YAML for configuration metadata. +Documentation-driven design process using structured markdown specifications (OpenSpec config, design doc, proposal, task tracking) without implementation code. ## tags design, workspace, .openspec, overhaul, project, settings, sidebar, repository ## symbols diff --git a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md index 0981ad2..03d32e0 100644 --- a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-19-workspace-visual-overhaul/specs (index) -dir: archive/2026-05-19-workspace-visual-overhaul/specs +# 2026-05-19-workspace-visual-overhaul/specs (index) +dir: 2026-05-19-workspace-visual-overhaul/specs ## role -Defines technical specifications for migrating repository management to a settings page and simplifying sidebar navigation in a workspace UI redesign. +Defines technical specifications and requirements for a workspace UI visual overhaul focused on repository management relocation and sidebar simplification. ## parent -index: archive/2026-05-19-workspace-visual-overhaul/.pi-map.index.md -map: archive/2026-05-19-workspace-visual-overhaul/.pi-map.md +index: 2026-05-19-workspace-visual-overhaul/.pi-map.index.md +map: 2026-05-19-workspace-visual-overhaul/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md -map: archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.md +index: 2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md +map: 2026-05-19-workspace-visual-overhaul/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.md b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.md index 3a1f8a2..eb21c02 100644 --- a/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-19-workspace-visual-overhaul/specs -dir: archive/2026-05-19-workspace-visual-overhaul/specs +# 2026-05-19-workspace-visual-overhaul/specs +dir: 2026-05-19-workspace-visual-overhaul/specs -index: archive/2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md +index: 2026-05-19-workspace-visual-overhaul/specs/.pi-map.index.md ## role -Defines technical specifications for migrating repository management to a settings page and simplifying sidebar navigation in a workspace UI redesign. +Defines technical specifications and requirements for a workspace UI visual overhaul focused on repository management relocation and sidebar simplification. ## files - spec.md | Specification document for a workspace UI visual overhaul project, defining requirements, route changes, component interfaces, and API contracts for moving repository management into a settings page and simplifying the sidebar navigation. | dep: React, React Router, TypeScript, API client, toast notification system, form validation library, responsive design framework, accessibility tools ## arch -Markdown-based specification document using structured requirements, route definitions, component interface contracts, and API schema descriptions without executable code. +Documentation-driven specification pattern using markdown-based requirements documents that define route changes, component interfaces, and API contracts. ## tags spec, specification, document, workspace, visual, overhaul, project, defining ## symbols diff --git a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md index 1a2c294..e17b5d2 100644 --- a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-cloudflare-tunnel-instances-superseded (index) -dir: archive/2026-05-22-cloudflare-tunnel-instances-superseded +# 2026-05-22-cloudflare-tunnel-instances-superseded (index) +dir: 2026-05-22-cloudflare-tunnel-instances-superseded ## role -Archived documentation for a completed/superseded project to replace API proxy-based tool access with Cloudflare Tunnel direct HTTPS subdomains. +Superseded architectural proposal and planning documents for migrating tool instance access from an API proxy to Cloudflare Tunnel-based direct HTTPS subdomains. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs - index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md - map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md +- 2026-05-22-cloudflare-tunnel-instances-superseded/specs + index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md + map: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md -map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md +map: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md index 8a84437..97bccae 100644 --- a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-cloudflare-tunnel-instances-superseded -dir: archive/2026-05-22-cloudflare-tunnel-instances-superseded +# 2026-05-22-cloudflare-tunnel-instances-superseded +dir: 2026-05-22-cloudflare-tunnel-instances-superseded -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md ## role -Archived documentation for a completed/superseded project to replace API proxy-based tool access with Cloudflare Tunnel direct HTTPS subdomains. +Superseded architectural proposal and planning documents for migrating tool instance access from an API proxy to Cloudflare Tunnel-based direct HTTPS subdomains. ## files - .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata - design.md | Architecture design document for replacing an API proxy with Cloudflare Tunnel to expose tool instances via unique HTTPS subdomains | dep: Cloudflare REST API, cloudflared, Docker, httpx, Cloudflare DNS - proposal.md | Proposes replacing an API proxy endpoint with Cloudflare Tunnel integration to provide direct public URLs for tool instances | dep: FastAPI, Cloudflare API, cloudflared, Docker, Cloudflare Tunnel - tasks.md | Project task list for migrating a proxy-based application access system to Cloudflare Tunnel-based public URLs | dep: docker-compose.traefik.yml, cloudflared, Cloudflare API, Alembic, FastAPI, React/TypeScript frontend ## arch -Design proposal and migration planning documents using infrastructure-as-code patterns with OpenAPI specs, phased task execution, and tunnel-based reverse proxy architecture replacing traditional API gateway routing. +Design documentation package using OpenAPI specification configuration, with structured markdown documents covering architecture design, technical proposal, and task breakdown for a cloud infrastructure migration pattern. ## tags design, proxy, cloudflare, tunnel, cloudflared, docker, .openspec, replacing ## symbols diff --git a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md index 869f60b..4f24571 100644 --- a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs (index) -dir: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs +# 2026-05-22-cloudflare-tunnel-instances-superseded/specs (index) +dir: 2026-05-22-cloudflare-tunnel-instances-superseded/specs ## role -Contains archived technical specifications for a cloudflare tunnel instances feature that was superseded on 2026-05-22. +Contains specification documents for the Cloudflare tunnel instances feature that has been superseded. ## parent -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md -map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md +map: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md ## children -- archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management - index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md - map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md +- 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management + index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md + map: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md ## files ## links -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md -map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md +map: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md index 7593b8a..fb2e040 100644 --- a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs -dir: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs +# 2026-05-22-cloudflare-tunnel-instances-superseded/specs +dir: 2026-05-22-cloudflare-tunnel-instances-superseded/specs -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md ## role -Contains archived technical specifications for a cloudflare tunnel instances feature that was superseded on 2026-05-22. +Contains specification documents for the Cloudflare tunnel instances feature that has been superseded. ## files ## arch -Specification-driven design documentation with dated archival structure for tracking obsolete/deprecated system designs. +Documentation/specification-driven architecture using markdown files to define technical requirements and design decisions for infrastructure components. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md index 3237754..0d20786 100644 --- a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management (index) -dir: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management +# 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management (index) +dir: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management ## role Defines requirements for automated Cloudflare tunnel lifecycle management tied to tool instance start/stop/delete operations with owner-based access control ## parent -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md -map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.index.md +map: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md -map: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md +map: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md index 22de2b0..d56e53a 100644 --- a/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management -dir: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management +# 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management +dir: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management -index: archive/2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md +index: 2026-05-22-cloudflare-tunnel-instances-superseded/specs/cloudflare-tunnel-management/.pi-map.index.md ## role Defines requirements for automated Cloudflare tunnel lifecycle management tied to tool instance start/stop/delete operations with owner-based access control ## files - spec.md | Defines requirements for automated Cloudflare tunnel lifecycle management tied to tool instance start/stop/delete operations with owner-based access control | dep: Cloudflare API, DNS/CNAME records, database, container orchestration, frontend ## arch -Specification-driven requirements document using markdown-based structured documentation with user stories, acceptance criteria, and lifecycle state definitions +Specification-driven requirements document using structured markdown with functional requirements, access control rules, and lifecycle operation mappings ## tags spec, defines, requirements, automated, cloudflare, tunnel, lifecycle, management ## symbols diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md index c16cdb5..a233e8c 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config (index) -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config +# 2026-05-22-enforce-single-tool-type-with-port-config (index) +dir: 2026-05-22-enforce-single-tool-type-with-port-config ## role -Historical archive of a completed feature proposal to refactor tool types from multiple interfaces to a single interface type with port configuration +Design and planning package for a system-wide refactoring to enforce single interface types per tool with port configuration requirements ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-enforce-single-tool-type-with-port-config/specs - index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md - map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +- 2026-05-22-enforce-single-tool-type-with-port-config/specs + index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md + map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md index 15dc564..0d2dba1 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config +# 2026-05-22-enforce-single-tool-type-with-port-config +dir: 2026-05-22-enforce-single-tool-type-with-port-config -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md ## role -Historical archive of a completed feature proposal to refactor tool types from multiple interfaces to a single interface type with port configuration +Design and planning package for a system-wide refactoring to enforce single interface types per tool with port configuration requirements ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for migrating tool types from a JSON interfaces array to a single interface_type string with requires_port boolean | dep: Alembic, Pydantic, SQLAlchemy, frontend API client, database - proposal.md | Proposes a breaking change to simplify tool types from supporting multiple interfaces to a single interface type, with conditional port configuration based on interface type. - tasks.md | Task checklist tracking database migration, backend/frontend API updates, UI changes, and verification steps for refactoring a tool types system from multiple interfaces to single interface_type with requires_port flag | dep: Alembic, SQLAlchemy, Pydantic, TypeScript, React, pytest, npm ## arch -Documentation-driven design with structured proposal workflow (design doc → proposal → task tracking) for breaking API changes +Specification-driven change management using OpenSpec schema definitions, phased design documents (proposal → design → tasks), and migration-based architecture with explicit backend/frontend/UI coordination ## tags type, interface, design, tool, types, interfaces, single, port ## symbols diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md index c2075a6..011b932 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md @@ -1,28 +1,28 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs (index) -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs +# 2026-05-22-enforce-single-tool-type-with-port-config/specs (index) +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs ## role -Contains archived specification documents from May 22, 2026 for enforcing single tool type with port configuration requirements. +Contains specification documents defining requirements for enforcing single tool type configurations with port settings. ## parent -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md +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 ## children -- archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation - index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md - map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md -- archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility - index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md - map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md -- archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface - index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md - map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md -- archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition - index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md - map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md +- 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation + index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md + map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md +- 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility + index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md + map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md +- 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface + index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md + map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md +- 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition + index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md + map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md ## files ## links -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md index da53561..63c6fb1 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs +# 2026-05-22-enforce-single-tool-type-with-port-config/specs +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md ## role -Contains archived specification documents from May 22, 2026 for enforcing single tool type with port configuration requirements. +Contains specification documents defining requirements for enforcing single tool type configurations with port settings. ## files ## arch -Document-based specification storage with date-versioned archival pattern for tracking design decisions over time. +Documentation-driven specification pattern using dated versioning for feature requirements. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md index 319ca6b..76f8796 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation (index) -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation (index) +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation ## role -Defines UI requirements for a tool configuration workshop with dynamic field visibility based on selected interface type +Defines UI requirements for a tool workshop interface with dynamic field visibility based on selected interface type ## parent -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md index 7267cda..47579e4 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/frontend-foundation/.pi-map.index.md ## role -Defines UI requirements for a tool configuration workshop with dynamic field visibility based on selected interface type +Defines UI requirements for a tool workshop interface with dynamic field visibility based on selected interface type ## files - spec.md | Define requirements for a tool workshop UI with conditional field visibility based on interface type selection ## arch -Specification-driven design using conditional form rendering pattern with interface-type-gated field visibility +Specification-driven design using requirements documentation with conditional configuration patterns for form field management ## tags spec, define, requirements, tool, workshop, conditional, field, visibility ## symbols diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md index 2aa2a18..94f0c19 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility (index) -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility (index) +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility ## role -Defines specification requirements for conditionally showing/hiding port configuration UI and enforcing validation based on whether a tool type requires port settings. +Defines requirements for conditionally showing/hiding port configuration fields and enforcing validation based on whether a tool type requires network ports. ## parent -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md index 3f92235..fa78aa6 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-port-visibility/.pi-map.index.md ## role -Defines specification requirements for conditionally showing/hiding port configuration UI and enforcing validation based on whether a tool type requires port settings. +Defines requirements for conditionally showing/hiding port configuration fields and enforcing validation based on whether a tool type requires network ports. ## files - spec.md | Defines requirements for conditional port configuration visibility and validation based on a tool type's `requires_port` flag across UI and API. ## arch -Specification-driven design using a single markdown document to capture cross-layer (UI and API) behavioral requirements for a conditional visibility feature flag. +Specification-driven requirements document using markdown with UI/API cross-cutting concerns, feature-flag-like conditional logic based on tool type metadata, and dual validation (client-side visibility + server-side enforcement). ## tags port, spec, defines, requirements, conditional, configuration, visibility, validation ## symbols diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md index f30224a..0e1b7e6 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface (index) -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface (index) +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface ## role -Defines specifications for migrating from legacy multiple tool interfaces to a single enforced interface type with port configuration constraints. +Defines specification requirements for migrating from legacy multi-interface tool configurations to a single validated interface type with port configuration constraints. ## parent -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md index 0f77e79..622c8c2 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-type-single-interface/.pi-map.index.md ## role -Defines specifications for migrating from legacy multiple tool interfaces to a single enforced interface type with port configuration constraints. +Defines specification requirements for migrating from legacy multi-interface tool configurations to a single validated interface type with port configuration constraints. ## files - spec.md | Defines requirements for enforcing single interface type validation, migration from legacy interfaces array, and allowed value constraints for tool types ## arch -Specification-driven design using requirement documents with explicit validation rules, migration path documentation, and enumerated allowed value constraints. +Specification-driven requirements document using constraint-based validation patterns with explicit migration path from legacy array-based interface definitions to single-value enforced types. ## tags spec, defines, requirements, enforcing, single, interface, type, validation ## symbols diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md index 3b4652c..e24c744 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition (index) -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition (index) +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition ## role -Defines the specification requirements for a ToolType domain model with port configuration validation and single-interface constraints. +Defines requirements for a ToolType model and CRUD API with interface validation, port requirements, and template validation. ## parent -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md -map: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md +map: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md index 413a145..1627baa 100644 --- a/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition -dir: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition +# 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition +dir: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition -index: archive/2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md +index: 2026-05-22-enforce-single-tool-type-with-port-config/specs/tool-types-definition/.pi-map.index.md ## role -Defines the specification requirements for a ToolType domain model with port configuration validation and single-interface constraints. +Defines requirements for a ToolType model and CRUD API with interface validation, port requirements, and template validation. ## files - spec.md | Specification document defining requirements for a ToolType model and CRUD API with single interface validation, port requirement logic, and template validation | dep: REST API, Docker Compose, YAML parsing, UUID, database timestamps ## arch -Specification-driven domain modeling with validation rules layered through interface constraints, port requirement logic, and template validation patterns. +Specification-driven API design with domain model constraints (single interface per tool type, conditional port requirements based on interface type, template-based validation). ## tags validation, spec, specification, document, defining, requirements, tooltype, model ## symbols diff --git a/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md b/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md index b6723d8..891459d 100644 --- a/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-05-22-git-repo-ssh-clone-check (index) -dir: archive/2026-05-22-git-repo-ssh-clone-check +# 2026-05-22-git-repo-ssh-clone-check (index) +dir: 2026-05-22-git-repo-ssh-clone-check ## role -Archive of design documents and proposals for a Git repository SSH clone feature with structured owner/repo input and preflight validation. +Defines a feature for SSH-based Git repository cloning with owner/repo shorthand input and preflight existence validation. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -14,8 +14,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md -map: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md b/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md index 697f3f8..14ed0a4 100644 --- a/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-git-repo-ssh-clone-check -dir: archive/2026-05-22-git-repo-ssh-clone-check +# 2026-05-22-git-repo-ssh-clone-check +dir: 2026-05-22-git-repo-ssh-clone-check -index: archive/2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md +index: 2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md ## role -Archive of design documents and proposals for a Git repository SSH clone feature with structured owner/repo input and preflight validation. +Defines a feature for SSH-based Git repository cloning with owner/repo shorthand input and preflight existence validation. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document specifying a feature to clone repositories from a hardcoded Git provider using structured owner/repo inputs with preflight existence validation via SSH. | dep: git, existing repository creation endpoint (POST /projects/{project_id}/repositories), shared repository creation dialog - proposal.md | Proposes a UI/UX enhancement to simplify Git repository creation by allowing owner/repo shorthand input instead of full URLs, with SSH-only clone validation via preflight checks. | dep: git, SSH, frontend dialog components, backend API endpoints, git ls-remote - tasks.md | Project task tracking document for implementing SSH repository existence checks and structured clone form improvements | dep: git_repositories.py, RepositoryCreateDialog, git.commumedia.org ## arch -Specification-driven design using OpenSpec schema configuration, with separate design/proposal/task documents following a lightweight RFC-like pattern for feature planning. +Documentation-driven specification package using OpenSpec schema configuration, separated design/proposal/task documents, and structured SSH validation workflow for Git provider integration. ## tags git, ssh, design, clone, creation, .openspec, document, structured ## symbols diff --git a/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.index.md b/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.index.md index 3fabcdf..7aa1890 100644 --- a/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-05-22-git-repo-working-clones (index) -dir: archive/2026-05-22-git-repo-working-clones +# 2026-05-22-git-repo-working-clones (index) +dir: 2026-05-22-git-repo-working-clones ## role -Contains historical design documents and task tracking for migrating the Git backend from bare/mirror repositories to working-tree clones with proper branch initialization. +Planning and design documents for migrating the project's Git backend from bare/mirror repositories to standard working-tree clones with proper branch initialization. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -13,8 +13,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-git-repo-working-clones/.pi-map.index.md -map: archive/2026-05-22-git-repo-working-clones/.pi-map.md +index: 2026-05-22-git-repo-working-clones/.pi-map.index.md +map: 2026-05-22-git-repo-working-clones/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.md b/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.md index 2bd2935..c54c2e2 100644 --- a/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-git-repo-working-clones/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-22-git-repo-working-clones -dir: archive/2026-05-22-git-repo-working-clones +# 2026-05-22-git-repo-working-clones +dir: 2026-05-22-git-repo-working-clones -index: archive/2026-05-22-git-repo-working-clones/.pi-map.index.md +index: 2026-05-22-git-repo-working-clones/.pi-map.index.md ## role -Contains historical design documents and task tracking for migrating the Git backend from bare/mirror repositories to working-tree clones with proper branch initialization. +Planning and design documents for migrating the project's Git backend from bare/mirror repositories to standard working-tree clones with proper branch initialization. ## files - design.md | Design document for migrating repository creation from bare/mirror repos to working-tree repos with proper branch initialization | dep: git, repository backend, workspace UI, file browser, commit editor, git toolbar - proposal.md | Proposes changes to repository creation and git operations to use normal working clones instead of mirrored bare repositories - tasks.md | A task tracking document for backend Git repository creation and synchronization improvements with test coverage and quality gates. ## arch -Documentation-driven planning artifacts using markdown-based design proposals, technical specifications, and structured task tracking with quality gates and test coverage requirements. +Document-driven architecture with markdown specifications covering design rationale, technical proposals, and task tracking with quality gates and test coverage requirements. ## tags design, repository, creation, git, document, bare, repos, working ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md index 4752c00..2344935 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-instance-health-monitoring (index) -dir: archive/2026-05-22-instance-health-monitoring +# 2026-05-22-instance-health-monitoring (index) +dir: 2026-05-22-instance-health-monitoring ## role -Design and planning package for a container health monitoring and tunnel recovery system that prevents false-positive tunnel recreations by distinguishing container health from tunnel health. +Design and planning package for improving instance health monitoring in a container-based tunnel service, covering architecture proposals, implementation tasks, and OpenSpec configuration. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-instance-health-monitoring/specs - index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +- 2026-05-22-instance-health-monitoring/specs + index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md + map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/.pi-map.md +index: 2026-05-22-instance-health-monitoring/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md index 4e264c1..452cbb8 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-instance-health-monitoring -dir: archive/2026-05-22-instance-health-monitoring +# 2026-05-22-instance-health-monitoring +dir: 2026-05-22-instance-health-monitoring -index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/.pi-map.index.md ## role -Design and planning package for a container health monitoring and tunnel recovery system that prevents false-positive tunnel recreations by distinguishing container health from tunnel health. +Design and planning package for improving instance health monitoring in a container-based tunnel service, covering architecture proposals, implementation tasks, and OpenSpec configuration. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for improving instance health monitoring by distinguishing container health from tunnel health, integrating readiness probes, and preventing false-positive tunnel recreation | dep: Docker, Docker Compose, cloudflared, Docker API, Python, JSON, HTTP/REST API, WebSocket (mentioned as non-goal), database (tool_types table) - proposal.md | Proposes architectural improvements to instance health monitoring, startup verification, and auto-recovery for a container-based tunnel service. | dep: Docker, docker compose, Docker API, React/Next.js (frontend), Python API backend - tasks.md | Tracks completed backend and frontend tasks for implementing container startup verification, readiness probes, health checks, smart tunnel recovery, and status display UI | dep: Docker, docker compose, curl, ruff, mypy, tsc, FastAPI/Flask (implied by api/tool_instances.py), React/Vue (implied by frontend components) ## arch -Specification-driven design using OpenSpec schema definitions, with phased implementation tracked through task-based project management (design → proposal → tasks), employing readiness probes and smart auto-recovery patterns for container-based tunnel services. +Documentation-driven design with structured specifications (OpenSpec YAML), phased architectural proposals (design/proposal docs), and task-tracked implementation covering health check separation, readiness probes, and smart auto-recovery patterns. ## tags health, tunnel, design, container, docker, docker compose, tasks, .openspec ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md index 09177a3..295d433 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md @@ -1,31 +1,31 @@ -# archive/2026-05-22-instance-health-monitoring/specs (index) -dir: archive/2026-05-22-instance-health-monitoring/specs +# 2026-05-22-instance-health-monitoring/specs (index) +dir: 2026-05-22-instance-health-monitoring/specs ## role -Contains historical specification documents for a May 2026 instance health monitoring feature, serving as archived design documentation. +Contains specification documents defining requirements and design for the instance health monitoring feature. ## parent -index: archive/2026-05-22-instance-health-monitoring/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/.pi-map.md +index: 2026-05-22-instance-health-monitoring/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/.pi-map.md ## children -- archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health - index: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md -- archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health - index: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md -- archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration - index: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md -- archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery - index: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md -- archive/2026-05-22-instance-health-monitoring/specs/tool-instances - index: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md - map: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md +- 2026-05-22-instance-health-monitoring/specs/instance-runtime-health + index: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md + map: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md +- 2026-05-22-instance-health-monitoring/specs/instance-startup-health + index: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md + map: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md +- 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration + index: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md + map: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md +- 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery + index: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md + map: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md +- 2026-05-22-instance-health-monitoring/specs/tool-instances + index: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md + map: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md ## files ## links -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md index c5129bc..b3bc9f9 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-instance-health-monitoring/specs -dir: archive/2026-05-22-instance-health-monitoring/specs +# 2026-05-22-instance-health-monitoring/specs +dir: 2026-05-22-instance-health-monitoring/specs -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md ## role -Contains historical specification documents for a May 2026 instance health monitoring feature, serving as archived design documentation. +Contains specification documents defining requirements and design for the instance health monitoring feature. ## files ## arch -Document-based architecture with date-versioned directory structure for preserving feature specifications outside active codebase. +Documentation-as-code pattern using dated directories for version control and traceability of system specifications. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md index 82d7d78..47ed582 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health (index) -dir: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health +# 2026-05-22-instance-health-monitoring/specs/instance-runtime-health (index) +dir: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health ## role -Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane. +Defines health monitoring, polling, and container state synchronization requirements for a container/instance management system. ## parent -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md index 7c051ac..7b8c061 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health -dir: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health +# 2026-05-22-instance-health-monitoring/specs/instance-runtime-health +dir: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health -index: archive/2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/specs/instance-runtime-health/.pi-map.index.md ## role -Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane. +Defines health monitoring, polling, and container state synchronization requirements for a container/instance management system. ## files - spec.md | Specification document defining health monitoring, polling, and container state synchronization requirements for a container/instance management system | dep: Docker, HTTP tunneling, REST API ## arch -Specification-driven design using polling-based health checks with state machine transitions for container lifecycle management. +Specification-driven design using requirement documents to formalize system behavior before implementation. ## tags container, spec, specification, document, defining, health, monitoring, polling ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md index f98d95f..3e58a04 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health (index) -dir: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health +# 2026-05-22-instance-health-monitoring/specs/instance-startup-health (index) +dir: 2026-05-22-instance-health-monitoring/specs/instance-startup-health ## role -Defines technical specifications for container health verification and lifecycle monitoring in a tool instance management system. +Defines technical specifications for verifying container startup health and readiness in a Docker Compose-based tool instance management system. ## parent -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md index 8e57146..49fd6a6 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health -dir: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health +# 2026-05-22-instance-health-monitoring/specs/instance-startup-health +dir: 2026-05-22-instance-health-monitoring/specs/instance-startup-health -index: archive/2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/specs/instance-startup-health/.pi-map.index.md ## role -Defines technical specifications for container health verification and lifecycle monitoring in a tool instance management system. +Defines technical specifications for verifying container startup health and readiness in a Docker Compose-based tool instance management system. ## files - spec.md | Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose | dep: docker compose, docker ps, readiness probes, tunnels, health endpoints, database ## arch -Requirements-driven specification document using Docker Compose for container orchestration with startup probes, readiness checks, and health monitoring patterns. +Specification-driven requirements document using prose-based standards with sections for overview, requirements, and implementation notes, targeting integration with Docker Compose health check mechanisms and container orchestration patterns. ## tags spec, defines, requirements, container, startup, verification, readiness, probe ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md index d090505..bbe19cc 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration (index) -dir: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration +# 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration (index) +dir: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration ## role -Defines technical specifications for integrating container readiness probes into instance health monitoring during startup. +Defines technical specifications for Kubernetes-style readiness probe integration to determine container startup health state ## parent -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md index 9f1b7a5..af3314e 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration -dir: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration +# 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration +dir: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration -index: archive/2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/specs/readiness-probe-integration/.pi-map.index.md ## role -Defines technical specifications for integrating container readiness probes into instance health monitoring during startup. +Defines technical specifications for Kubernetes-style readiness probe integration to determine container startup health state ## files - spec.md | Defines requirements for container readiness probe configuration, execution, and result storage during instance startup | dep: docker, container orchestration, health endpoint, logging system ## arch -Specification-driven design using requirements documentation as the single source of truth for probe configuration, execution, and result storage behavior. +Specification-driven requirements document using markdown-based technical specification pattern with functional requirements decomposition ## tags spec, defines, requirements, container, readiness, probe, configuration, execution ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md index 60a44c5..02cde60 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery (index) -dir: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery +# 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery (index) +dir: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery ## role Defines requirements for distinguishing network tunnel failures from application-level errors in a health monitoring system to enable appropriate recovery strategies and user-facing behaviors. ## parent -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md index 05b1365..0c2e7d9 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery -dir: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery +# 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery +dir: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery -index: archive/2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/specs/smart-tunnel-recovery/.pi-map.index.md ## role Defines requirements for distinguishing network tunnel failures from application-level errors in a health monitoring system to enable appropriate recovery strategies and user-facing behaviors. ## files - spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system with different UI behaviors and recovery actions. ## arch -Specification-driven design using requirement-based decomposition with clear separation between failure classification logic, UI state mapping, and recovery action orchestration. +Specification-driven design using requirement decomposition with clear separation between failure classification logic, UI state transitions, and automated recovery action definitions. ## tags spec, specifies, requirements, classifying, tunnel, failures, versus, application ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md index cfd40e3..e0e0b97 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-instance-health-monitoring/specs/tool-instances (index) -dir: archive/2026-05-22-instance-health-monitoring/specs/tool-instances +# 2026-05-22-instance-health-monitoring/specs/tool-instances (index) +dir: 2026-05-22-instance-health-monitoring/specs/tool-instances ## role -Defines system requirements for container health monitoring and tunnel management capabilities in the tool instances infrastructure. +Defines system requirements for container health monitoring and automatic tunnel recovery mechanisms. ## parent -index: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md -map: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md +index: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md +map: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md index e393d23..150d1d1 100644 --- a/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-instance-health-monitoring/specs/tool-instances -dir: archive/2026-05-22-instance-health-monitoring/specs/tool-instances +# 2026-05-22-instance-health-monitoring/specs/tool-instances +dir: 2026-05-22-instance-health-monitoring/specs/tool-instances -index: archive/2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md +index: 2026-05-22-instance-health-monitoring/specs/tool-instances/.pi-map.index.md ## role -Defines system requirements for container health monitoring and tunnel management capabilities in the tool instances infrastructure. +Defines system requirements for container health monitoring and automatic tunnel recovery mechanisms. ## files - spec.md | Defines modified and added system requirements for container status monitoring, health check endpoints, and smart tunnel recreation logic. ## arch -Requirements specification document using structured markdown with modified/added requirement tracking for incremental system capability definition. +Requirements specification document following structured system specification pattern with functional requirements for monitoring, health checking, and self-healing infrastructure. ## tags spec, defines, modified, added, system, requirements, container, status ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md index 3ab0255..da2cf58 100644 --- a/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-instance-proxy (index) -dir: archive/2026-05-22-instance-proxy +# 2026-05-22-instance-proxy (index) +dir: 2026-05-22-instance-proxy ## role -Provides design documentation and planning artifacts for an authenticated HTTP/WebSocket proxy service that enables secure user access to internal Docker containerized tool instances. +Provides an authenticated HTTP/WebSocket proxy layer to expose internal Docker containerized tool instances to users through a single API endpoint, replacing broken localhost links. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-instance-proxy/specs - index: archive/2026-05-22-instance-proxy/specs/.pi-map.index.md - map: archive/2026-05-22-instance-proxy/specs/.pi-map.md +- 2026-05-22-instance-proxy/specs + index: 2026-05-22-instance-proxy/specs/.pi-map.index.md + map: 2026-05-22-instance-proxy/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-instance-proxy/.pi-map.index.md -map: archive/2026-05-22-instance-proxy/.pi-map.md +index: 2026-05-22-instance-proxy/.pi-map.index.md +map: 2026-05-22-instance-proxy/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.md index a4de02c..6fedf27 100644 --- a/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-proxy/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-instance-proxy -dir: archive/2026-05-22-instance-proxy +# 2026-05-22-instance-proxy +dir: 2026-05-22-instance-proxy -index: archive/2026-05-22-instance-proxy/.pi-map.index.md +index: 2026-05-22-instance-proxy/.pi-map.index.md ## role -Provides design documentation and planning artifacts for an authenticated HTTP/WebSocket proxy service that enables secure user access to internal Docker containerized tool instances. +Provides an authenticated HTTP/WebSocket proxy layer to expose internal Docker containerized tool instances to users through a single API endpoint, replacing broken localhost links. ## files - .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata - design.md | Design document for implementing a FastAPI-based HTTP/WebSocket proxy to allow users to access internal Docker tool instances through a single authenticated API endpoint. | dep: FastAPI, httpx, starlette.websockets, Docker - proposal.md | Proposes adding an HTTP/WebSocket proxy endpoint to expose Docker containerized tool instances to users over HTTPS instead of broken localhost links | dep: docker, backend API, frontend, WebSocket, HTTPS - tasks.md | Project task tracking checklist for implementing a proxy endpoint system that routes HTTP/WebSocket traffic to Docker container instances | dep: Docker, FastAPI/httpx, WebSocket, code-server, ruff, mypy ## arch -Document-driven design specification using markdown-based design docs, proposals, and task tracking; intended FastAPI implementation with OpenAPI spec for a reverse proxy routing layer between external HTTPS and internal Docker instances. +FastAPI-based reverse proxy architecture with WebSocket support, using OpenAPI-specified endpoints for authenticated traffic routing to dynamic Docker container instances. ## tags docker, websocket, design, fastapi, http, proxy, instances, endpoint ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.index.md index 908859c..c66b986 100644 --- a/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-22-instance-proxy/specs (index) -dir: archive/2026-05-22-instance-proxy/specs +# 2026-05-22-instance-proxy/specs (index) +dir: 2026-05-22-instance-proxy/specs ## role -Contains specification documents defining requirements and interfaces for the instance proxy component. +Contains test specifications and behavioral contracts for the instance-proxy component. ## parent -index: archive/2026-05-22-instance-proxy/.pi-map.index.md -map: archive/2026-05-22-instance-proxy/.pi-map.md +index: 2026-05-22-instance-proxy/.pi-map.index.md +map: 2026-05-22-instance-proxy/.pi-map.md ## children -- archive/2026-05-22-instance-proxy/specs/instance-proxy - index: archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md - map: archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md +- 2026-05-22-instance-proxy/specs/instance-proxy + index: 2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md + map: 2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md ## files ## links -index: archive/2026-05-22-instance-proxy/specs/.pi-map.index.md -map: archive/2026-05-22-instance-proxy/specs/.pi-map.md +index: 2026-05-22-instance-proxy/specs/.pi-map.index.md +map: 2026-05-22-instance-proxy/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.md index 5a535d7..7071a91 100644 --- a/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-proxy/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-instance-proxy/specs -dir: archive/2026-05-22-instance-proxy/specs +# 2026-05-22-instance-proxy/specs +dir: 2026-05-22-instance-proxy/specs -index: archive/2026-05-22-instance-proxy/specs/.pi-map.index.md +index: 2026-05-22-instance-proxy/specs/.pi-map.index.md ## role -Contains specification documents defining requirements and interfaces for the instance proxy component. +Contains test specifications and behavioral contracts for the instance-proxy component. ## files ## arch -Documentation-driven design with structured specification files establishing contracts for implementation. +Specification-driven testing with structured test definitions, likely using BDD or contract-based patterns to define expected proxy behaviors. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md b/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md index e75f374..717475b 100644 --- a/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-instance-proxy/specs/instance-proxy (index) -dir: archive/2026-05-22-instance-proxy/specs/instance-proxy +# 2026-05-22-instance-proxy/specs/instance-proxy (index) +dir: 2026-05-22-instance-proxy/specs/instance-proxy ## role -Defines the API specification for an HTTP/WebSocket proxy that routes client requests to running tool instances with owner-based access control. +Defines API contract for routing client requests to isolated tool instances with authenticated access mediation ## parent -index: archive/2026-05-22-instance-proxy/specs/.pi-map.index.md -map: archive/2026-05-22-instance-proxy/specs/.pi-map.md +index: 2026-05-22-instance-proxy/specs/.pi-map.index.md +map: 2026-05-22-instance-proxy/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md -map: archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md +index: 2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md +map: 2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md b/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md index 7de1540..7771b3e 100644 --- a/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-instance-proxy/specs/instance-proxy -dir: archive/2026-05-22-instance-proxy/specs/instance-proxy +# 2026-05-22-instance-proxy/specs/instance-proxy +dir: 2026-05-22-instance-proxy/specs/instance-proxy -index: archive/2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md +index: 2026-05-22-instance-proxy/specs/instance-proxy/.pi-map.index.md ## role -Defines the API specification for an HTTP/WebSocket proxy that routes client requests to running tool instances with owner-based access control. +Defines API contract for routing client requests to isolated tool instances with authenticated access mediation ## files - spec.md | Specifies API requirements for an HTTP/WebSocket proxy endpoint that forwards requests to running tool instances with owner-based access control ## arch -API specification document using Markdown format to define endpoint requirements, authentication/authorization rules (owner-based access), and dual-protocol support (HTTP/WebSocket) for request forwarding. +Specification-driven API design using HTTP/WebSocket dual-protocol proxy pattern with owner-scoped authorization and instance-level request forwarding ## tags spec, specifies, api, requirements, http, websocket, proxy, endpoint ## symbols diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.index.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.index.md index 15fb0ae..88f2949 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-opencode-web-terminal (index) -dir: archive/2026-05-22-opencode-web-terminal +# 2026-05-22-opencode-web-terminal (index) +dir: 2026-05-22-opencode-web-terminal ## role -Design and planning package for adding web terminal accessibility to OpenCode through standardized port configuration and web interface support. +Infrastructure configuration package for enabling web terminal access to OpenCode through standardized port management and API specification. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-opencode-web-terminal/specs - index: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md - map: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md +- 2026-05-22-opencode-web-terminal/specs + index: 2026-05-22-opencode-web-terminal/specs/.pi-map.index.md + map: 2026-05-22-opencode-web-terminal/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-opencode-web-terminal/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/.pi-map.md +index: 2026-05-22-opencode-web-terminal/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.md index 937fe99..a6d4001 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-opencode-web-terminal -dir: archive/2026-05-22-opencode-web-terminal +# 2026-05-22-opencode-web-terminal +dir: 2026-05-22-opencode-web-terminal -index: archive/2026-05-22-opencode-web-terminal/.pi-map.index.md +index: 2026-05-22-opencode-web-terminal/.pi-map.index.md ## role -Design and planning package for adding web terminal accessibility to OpenCode through standardized port configuration and web interface support. +Infrastructure configuration package for enabling web terminal access to OpenCode through standardized port management and API specification. ## files - .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata - design.md | Design document for making OpenCode accessible via web terminal, standardizing port configuration across tool types, and adding validation for tool type ports and interfaces. - proposal.md | Proposes a systematic tool port configuration system with web interface support for terminal-first tools like OpenCode - tasks.md | Project task list tracking implementation of tool type port configuration, OpenCode web server integration, tunnel port fixes, frontend updates, database migrations, and testing for a development tools platform | dep: Alembic, Docker Compose, OpenCode, backend API, frontend UI, tunnel service ## arch -Specification-driven design documentation with OpenAPI configuration, structured proposal-to-implementation workflow (design → proposal → tasks), and incremental feature delivery pattern for developer tool integration. +Specification-driven design using OpenAPI configuration, task-tracked iterative implementation, and document-based proposal system covering port validation, tunnel fixes, database migrations, and frontend integration. ## tags configuration, opencode, port, tool, type, design, web, .openspec ## symbols diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md index 2bd35d1..47709a3 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-22-opencode-web-terminal/specs (index) -dir: archive/2026-05-22-opencode-web-terminal/specs +# 2026-05-22-opencode-web-terminal/specs (index) +dir: 2026-05-22-opencode-web-terminal/specs ## role -Contains archived specification documents for the OpenCode web terminal feature from May 2026, serving as historical design documentation for the project. +Contains test specifications and behavioral contracts for the web terminal component. ## parent -index: archive/2026-05-22-opencode-web-terminal/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/.pi-map.md +index: 2026-05-22-opencode-web-terminal/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/.pi-map.md ## children -- archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server - index: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md - map: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md -- archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration - index: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md - map: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md -- archive/2026-05-22-opencode-web-terminal/specs/tool-types - index: archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md - map: archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md +- 2026-05-22-opencode-web-terminal/specs/opencode-web-server + index: 2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md + map: 2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md +- 2026-05-22-opencode-web-terminal/specs/tool-port-configuration + index: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md + map: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md +- 2026-05-22-opencode-web-terminal/specs/tool-types + index: 2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md + map: 2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md ## files ## links -index: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md index 9f47ebe..128d203 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-opencode-web-terminal/specs -dir: archive/2026-05-22-opencode-web-terminal/specs +# 2026-05-22-opencode-web-terminal/specs +dir: 2026-05-22-opencode-web-terminal/specs -index: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md +index: 2026-05-22-opencode-web-terminal/specs/.pi-map.index.md ## role -Contains archived specification documents for the OpenCode web terminal feature from May 2026, serving as historical design documentation for the project. +Contains test specifications and behavioral contracts for the web terminal component. ## files ## arch -Flat directory structure storing dated specification files, following a simple archival pattern with timestamp-prefixed naming convention for version tracking and historical reference. +Specification-driven testing pattern using formal test files to define expected behavior before implementation. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md index 71cba55..9b95792 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server (index) -dir: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server +# 2026-05-22-opencode-web-terminal/specs/opencode-web-server (index) +dir: 2026-05-22-opencode-web-terminal/specs/opencode-web-server ## role -Defines specifications for a web server component that provides browser-based terminal access to OpenCode containers via port 3000 with tunneling and UI integration. +Defines the specification for a web server component that provides browser-based terminal access to OpenCode containers through tunneled connections on port 3000. ## parent -index: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md index 6567ea5..d89d3e1 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server -dir: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server +# 2026-05-22-opencode-web-terminal/specs/opencode-web-server +dir: 2026-05-22-opencode-web-terminal/specs/opencode-web-server -index: archive/2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md +index: 2026-05-22-opencode-web-terminal/specs/opencode-web-server/.pi-map.index.md ## role -Defines specifications for a web server component that provides browser-based terminal access to OpenCode containers via port 3000 with tunneling and UI integration. +Defines the specification for a web server component that provides browser-based terminal access to OpenCode containers through tunneled connections on port 3000. ## files - spec.md | Specifies requirements for OpenCode containers to run a web server on port 3000 with a web terminal interface, proper tunneling, and UI integration. ## arch -Requirements-driven specification document using declarative constraints (port binding, tunneling protocol, UI embedding) without implementation architecture. +Specification-driven architecture using requirements documents to define container interfaces, port binding conventions, and UI integration patterns without containing implementation code. ## tags web, spec, specifies, requirements, opencode, containers, run, server ## symbols diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md index 5a9e576..6184e27 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration (index) -dir: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration +# 2026-05-22-opencode-web-terminal/specs/tool-port-configuration (index) +dir: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration ## role -Defines specifications for validating tool types, managing default network ports, exposing services through Docker Compose templates, and supporting multiple network interfaces in the OpenCode web terminal project. +Defines specifications for validating and configuring network port assignments and exposure patterns for development tools in containerized environments. ## parent -index: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md index 0146a93..c8da613 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration -dir: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration +# 2026-05-22-opencode-web-terminal/specs/tool-port-configuration +dir: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration -index: archive/2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md +index: 2026-05-22-opencode-web-terminal/specs/tool-port-configuration/.pi-map.index.md ## role -Defines specifications for validating tool types, managing default network ports, exposing services through Docker Compose templates, and supporting multiple network interfaces in the OpenCode web terminal project. +Defines specifications for validating and configuring network port assignments and exposure patterns for development tools in containerized environments. ## files - spec.md | Defines requirements for tool type validation including default ports, compose template port exposure, and multiple interface support ## arch -Specification-driven architecture using markdown-based requirements documents to define validation rules, port configuration schemas, and multi-interface networking patterns before implementation. +Specification-driven requirements documentation using markdown-based technical specs with structured requirement categories (validation rules, template configurations, multi-interface support). ## tags spec, defines, requirements, tool, type, validation, including, default ## symbols diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md index 069912c..7869672 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-opencode-web-terminal/specs/tool-types (index) -dir: archive/2026-05-22-opencode-web-terminal/specs/tool-types +# 2026-05-22-opencode-web-terminal/specs/tool-types (index) +dir: 2026-05-22-opencode-web-terminal/specs/tool-types ## role -Defines specifications for managing tool types with Docker Compose validation and built-in tool definitions in a web terminal environment. +Defines requirements for a tool type management system that validates Docker Compose templates and manages built-in tool definitions ## parent -index: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md -map: archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md +index: 2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md +map: 2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md index 3d45b4c..b3c6719 100644 --- a/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-opencode-web-terminal/specs/tool-types -dir: archive/2026-05-22-opencode-web-terminal/specs/tool-types +# 2026-05-22-opencode-web-terminal/specs/tool-types +dir: 2026-05-22-opencode-web-terminal/specs/tool-types -index: archive/2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md +index: 2026-05-22-opencode-web-terminal/specs/tool-types/.pi-map.index.md ## role -Defines specifications for managing tool types with Docker Compose validation and built-in tool definitions in a web terminal environment. +Defines requirements for a tool type management system that validates Docker Compose templates and manages built-in tool definitions ## files - spec.md | Specifies requirements for a tool type management system with Docker Compose template validation and built-in tool definitions | dep: database, docker-compose, validation framework ## arch -Specification-driven architecture using markdown-based requirements documentation with Docker Compose template validation patterns. +Specification-driven architecture using markdown-based requirements documentation with Docker Compose template validation patterns ## tags tool, docker, compose, spec, specifies, requirements, type, management ## symbols diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md index 1e980a3..2d9dc63 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh (index) -dir: archive/2026-05-22-repo-clone-mode-with-ssh +# 2026-05-22-repo-clone-mode-with-ssh (index) +dir: 2026-05-22-repo-clone-mode-with-ssh ## role -Archive of a completed feature implementation for adding SSH-based repository clone mode as an alternative to mount mode for isolated tool instances. +Implements a repository clone mode with SSH key support to enable isolated, clean-room git operations inside tool instances without affecting host working copies. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-repo-clone-mode-with-ssh/specs - index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md - map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md +- 2026-05-22-repo-clone-mode-with-ssh/specs + index: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md + map: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md index 698d4a9..25cd961 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh -dir: archive/2026-05-22-repo-clone-mode-with-ssh +# 2026-05-22-repo-clone-mode-with-ssh +dir: 2026-05-22-repo-clone-mode-with-ssh -index: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md +index: 2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md ## role -Archive of a completed feature implementation for adding SSH-based repository clone mode as an alternative to mount mode for isolated tool instances. +Implements a repository clone mode with SSH key support to enable isolated, clean-room git operations inside tool instances without affecting host working copies. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document specifying a system to support both mount and clone repository access modes for tool instances, with SSH key management for clone operations. | dep: GitRepository, ToolInstance, Alembic, compose templates, SSH key system, _modify_compose_file - proposal.md | Proposes a feature to add repository clone mode with SSH key support for isolated tool instances, enabling clean-room development and git operations inside containers without affecting the host working copy. | dep: GitRepository, ToolInstance, Docker, SSH keys, database migrations, backend API, frontend UI - tasks.md | A completed task checklist for implementing SSH key-based git clone functionality with mount/clone modes across database, backend, frontend, and DevOps infrastructure | dep: Alembic, Pydantic, SQLAlchemy, FastAPI, React/TypeScript, pytest, ruff, mypy, npm, git, subprocess, SSH ## arch -Feature-driven documentation structure with design proposal pattern (design.md → proposal.md → tasks.md) plus OpenSpec configuration metadata, covering full-stack implementation across database schema, backend API, frontend UI, and DevOps/SSH infrastructure. +Feature-driven documentation-first architecture using OpenSpec schema configuration, design/proposal/task documents, and cross-stack implementation (database, backend, frontend, DevOps) supporting dual access modes (mount vs. clone) with SSH credential management. ## tags clone, ssh, design, key, git, .openspec, support, mount ## symbols diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md index fa12f34..b0d3c55 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs (index) -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs +# 2026-05-22-repo-clone-mode-with-ssh/specs (index) +dir: 2026-05-22-repo-clone-mode-with-ssh/specs ## role -Contains archived SSH-based repository cloning specifications from a specific date snapshot. +Defines test specifications and requirements for the SSH clone mode feature. ## parent -index: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/.pi-map.md +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 ## children -- archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo - index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md - map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md -- archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode - index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md - map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md -- archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances - index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md - map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md +- 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo + index: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md + map: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md +- 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode + index: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md + map: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md +- 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances + index: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md + map: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md ## files ## links -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md index 602fef2..b2d9b52 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs +# 2026-05-22-repo-clone-mode-with-ssh/specs +dir: 2026-05-22-repo-clone-mode-with-ssh/specs -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md ## role -Contains archived SSH-based repository cloning specifications from a specific date snapshot. +Defines test specifications and requirements for the SSH clone mode feature. ## files ## arch -Simple archival directory structure with date-based versioning and no active code patterns. +Behavior-driven specification files (likely Gherkin/Cucumber format) describing feature scenarios and acceptance criteria. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md index 699aba5..cc40dff 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo (index) -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo +# 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo (index) +dir: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo ## role -Defines SSH key authentication requirements for secure Git repository cloning and container-based git operations. +Defines specifications for SSH-based Git repository authentication and cloning operations in containerized environments. ## parent -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md index 3ec62a7..21c5a98 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo +# 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo +dir: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/git-repo/.pi-map.index.md ## role -Defines SSH key authentication requirements for secure Git repository cloning and container-based git operations. +Defines specifications for SSH-based Git repository authentication and cloning operations in containerized environments. ## files - spec.md | Defines requirements for associating SSH keys with Git repositories for clone operations and container git access ## arch -Specification-driven requirements document using markdown-based technical specification pattern with use-case and scenario-based structure. +Requirements-driven specification document using markdown-based documentation pattern with user story and acceptance criteria structure. ## tags git, spec, defines, requirements, associating, ssh, keys, repositories ## symbols diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md index a8e545e..96dd7e2 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode (index) -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode +# 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode (index) +dir: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode ## role Defines requirements for host-side repository cloning with branch selection, SSH key preparation for containers, and repository dirty state detection ## parent -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md index 7f14073..869cba6 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode +# 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode +dir: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/repo-clone-mode/.pi-map.index.md ## role Defines requirements for host-side repository cloning with branch selection, SSH key preparation for containers, and repository dirty state detection ## files - spec.md | Defines requirements for host-side repository cloning with branch selection, SSH key preparation for containers, and repository dirty state detection | dep: git, ssh, filesystem ## arch -Specification-driven requirements document using Markdown-based technical specification pattern with functional requirements, non-functional requirements, and acceptance criteria sections +Specification-driven design using Markdown-based requirements documents with clear separation of concerns (cloning, SSH key management, state detection) ## tags repository, ssh, spec, defines, requirements, host, side, cloning ## symbols diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md index 28bc12f..2653a50 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances (index) -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances +# 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances (index) +dir: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances ## role -Defines requirements for managing tool instances with lifecycle operations including clone/mount modes, SSH key mounting, and safe deletion with dirty-state validation. +Defines requirements for managing tool instances with lifecycle operations including cloning, mounting, and safe deletion with state validation. ## parent -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md -map: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md +map: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md index 08f0320..5c49524 100644 --- a/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances -dir: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances +# 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances +dir: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances -index: archive/2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md +index: 2026-05-22-repo-clone-mode-with-ssh/specs/tool-instances/.pi-map.index.md ## role -Defines requirements for managing tool instances with lifecycle operations including clone/mount modes, SSH key mounting, and safe deletion with dirty-state validation. +Defines requirements for managing tool instances with lifecycle operations including cloning, mounting, and safe deletion with state validation. ## files - spec.md | Specifies requirements for a tool instance management system supporting clone/mount modes, SSH key mounting, and dirty-state checks before deletion. | dep: git, docker-compose, SSH, container runtime ## arch -Specification-driven requirements document using Markdown, focusing on stateful resource management with mode-based configuration (clone vs mount) and safety guards for destructive operations. +Specification-driven requirements document using markdown-based structured documentation for system behavior and constraints. ## tags ssh, spec, specifies, requirements, tool, instance, management, system ## symbols diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.index.md b/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.index.md index 88707fd..5a9564c 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-session-management-fixes (index) -dir: archive/2026-05-22-session-management-fixes +# 2026-05-22-session-management-fixes (index) +dir: 2026-05-22-session-management-fixes ## role -Archive of design documents and specifications for a session management system enhancement using temporary Cloudflare tunnels. +Design and planning package for session management system improvements using Cloudflare tunnels. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-session-management-fixes/specs - index: archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md - map: archive/2026-05-22-session-management-fixes/specs/.pi-map.md +- 2026-05-22-session-management-fixes/specs + index: 2026-05-22-session-management-fixes/specs/.pi-map.index.md + map: 2026-05-22-session-management-fixes/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-session-management-fixes/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/.pi-map.md +index: 2026-05-22-session-management-fixes/.pi-map.index.md +map: 2026-05-22-session-management-fixes/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.md b/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.md index 110e26a..bb6b81c 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-session-management-fixes -dir: archive/2026-05-22-session-management-fixes +# 2026-05-22-session-management-fixes +dir: 2026-05-22-session-management-fixes -index: archive/2026-05-22-session-management-fixes/.pi-map.index.md +index: 2026-05-22-session-management-fixes/.pi-map.index.md ## role -Archive of design documents and specifications for a session management system enhancement using temporary Cloudflare tunnels. +Design and planning package for session management system improvements using Cloudflare tunnels. ## files - .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata - design.md | Design document for UX and reliability improvements to a session management system using temporary Cloudflare tunnels | dep: React, Cloudflare (cloudflared), HTTP/polling, backend API, database - proposal.md | Proposes UX and reliability improvements for session management UI including confirmation dialogs, state fixes, tunnel health monitoring, and tunnel recreation capabilities | dep: React, Cloudflare tunnels, Docker, tool_instances API, sessions API - tasks.md | Project task tracking document listing completed backend and frontend development tasks for tunnel management features in a Docker-based application | dep: docker.py, tool_instances.py, sessions.ts, ToolInstance model, SessionsPage, InstanceList ## arch -Documentation-driven design with OpenAPI specs, phased task tracking (backend/frontend), and iterative UX improvement proposals for Docker-based tunnel infrastructure. +Documentation-driven design with structured planning documents (OpenAPI spec, design docs, proposals, task tracking) for a Docker-based web application with tunnel-based remote access. ## tags design, management, tunnel, docker, tasks, .openspec, document, reliability ## symbols diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md index d508f04..d82fe47 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-22-session-management-fixes/specs (index) -dir: archive/2026-05-22-session-management-fixes/specs +# 2026-05-22-session-management-fixes/specs (index) +dir: 2026-05-22-session-management-fixes/specs ## role -Contains archived technical specifications for session management fixes from a specific dated release. +Contains specifications and design documents for session management fixes planned for the 2026-05-22 release. ## parent -index: archive/2026-05-22-session-management-fixes/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/.pi-map.md +index: 2026-05-22-session-management-fixes/.pi-map.index.md +map: 2026-05-22-session-management-fixes/.pi-map.md ## children -- archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux - index: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md - map: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md -- archive/2026-05-22-session-management-fixes/specs/tool-instances - index: archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md - map: archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md -- archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring - index: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md - map: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md +- 2026-05-22-session-management-fixes/specs/session-lifecycle-ux + index: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md + map: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md +- 2026-05-22-session-management-fixes/specs/tool-instances + index: 2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md + map: 2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md +- 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring + index: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md + map: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md ## files ## links -index: archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.md index 0cf5911..5fbc85d 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-session-management-fixes/specs -dir: archive/2026-05-22-session-management-fixes/specs +# 2026-05-22-session-management-fixes/specs +dir: 2026-05-22-session-management-fixes/specs -index: archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md +index: 2026-05-22-session-management-fixes/specs/.pi-map.index.md ## role -Contains archived technical specifications for session management fixes from a specific dated release. +Contains specifications and design documents for session management fixes planned for the 2026-05-22 release. ## files ## arch -Document-based specification storage with date-versioned archiving pattern for tracking historical design decisions. +Documentation-driven specification pattern with no executable code, serving as requirements/blueprint reference for implementation. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md index a493748..c491326 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux (index) -dir: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux +# 2026-05-22-session-management-fixes/specs/session-lifecycle-ux (index) +dir: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux ## role Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates ## parent -index: archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md index 03d769c..e73a4d2 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux -dir: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux +# 2026-05-22-session-management-fixes/specs/session-lifecycle-ux +dir: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux -index: archive/2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md +index: 2026-05-22-session-management-fixes/specs/session-lifecycle-ux/.pi-map.index.md ## role Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates ## files - spec.md | Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates ## arch -Specification document using requirements-based documentation pattern with behavioral definitions for UI interactions +Specification-driven requirements documentation using markdown-based behavioral specifications with user-centric interaction patterns ## tags spec, defines, software, requirements, session, management, behaviors, including ## symbols diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md index 755e7a7..a9921d1 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-session-management-fixes/specs/tool-instances (index) -dir: archive/2026-05-22-session-management-fixes/specs/tool-instances +# 2026-05-22-session-management-fixes/specs/tool-instances (index) +dir: 2026-05-22-session-management-fixes/specs/tool-instances ## role -Defines specification requirements for a tool lifecycle management system with Docker Compose, Cloudflare tunneling, and health monitoring capabilities. +Defines requirements for a tool lifecycle management system enabling Docker-based tool deployment with networking and health monitoring. ## parent -index: archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md index 7b542ee..67e98f5 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-session-management-fixes/specs/tool-instances -dir: archive/2026-05-22-session-management-fixes/specs/tool-instances +# 2026-05-22-session-management-fixes/specs/tool-instances +dir: 2026-05-22-session-management-fixes/specs/tool-instances -index: archive/2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md +index: 2026-05-22-session-management-fixes/specs/tool-instances/.pi-map.index.md ## role -Defines specification requirements for a tool lifecycle management system with Docker Compose, Cloudflare tunneling, and health monitoring capabilities. +Defines requirements for a tool lifecycle management system enabling Docker-based tool deployment with networking and health monitoring. ## files - spec.md | Defines modified and added requirements for a tool lifecycle management system with Docker Compose, Cloudflare tunneling, and health monitoring capabilities. | dep: Docker Compose, cloudflared, Cloudflare tunnel API, HTTP health check client ## arch -Specification-driven design using requirement-based documentation with modified/added requirement tracking for containerized tool orchestration and tunnel-based networking. +Specification-driven requirements documentation using markdown-based structured requirements with sections for new capabilities, modified behaviors, and feature specifications. ## tags spec, defines, modified, added, requirements, tool, lifecycle, management ## symbols diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md index f033395..c226e53 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring (index) -dir: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring +# 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring (index) +dir: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring ## role -Specifies requirements for automated health monitoring and recovery of cloudflared tunnels to ensure persistent connectivity for running instances. +Defines specifications for detecting and automatically recovering failed cloudflared tunnels to maintain persistent connectivity for running instances. ## parent -index: archive/2026-05-22-session-management-fixes/specs/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md -map: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md +index: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md +map: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md index 7c40e8d..b12f088 100644 --- a/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring -dir: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring +# 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring +dir: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring -index: archive/2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md +index: 2026-05-22-session-management-fixes/specs/tunnel-health-monitoring/.pi-map.index.md ## role -Specifies requirements for automated health monitoring and recovery of cloudflared tunnels to ensure persistent connectivity for running instances. +Defines specifications for detecting and automatically recovering failed cloudflared tunnels to maintain persistent connectivity for running instances. ## files - spec.md | Defines requirements for monitoring and recreating cloudflared tunnels for running instances | dep: cloudflared, HTTP health checks, UI components ## arch -Requirements specification document following a single-file markdown specification pattern with no implemented code or architectural components. +Requirements-driven specification document using scenario-based documentation pattern with defined acceptance criteria for tunnel health monitoring and recreation behavior. ## tags cloudflared, spec, defines, requirements, monitoring, recreating, tunnels, running ## symbols diff --git a/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md b/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md index 5a6cd96..7dcddad 100644 --- a/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-sessions-hub/.openspec (index) -dir: archive/2026-05-22-sessions-hub/.openspec +# 2026-05-22-sessions-hub/.openspec (index) +dir: 2026-05-22-sessions-hub/.openspec ## role -Defines the configuration schema and validation rules for a sessions hub service using OpenAPI-style specification format. +Defines the OpenAPI specification and schema-driven configuration for the sessions hub service API ## parent -index: archive/2026-05-22-sessions-hub/.pi-map.index.md -map: archive/2026-05-22-sessions-hub/.pi-map.md +index: 2026-05-22-sessions-hub/.pi-map.index.md +map: 2026-05-22-sessions-hub/.pi-map.md ## children - ## files - config.yaml ## links -index: archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md -map: archive/2026-05-22-sessions-hub/.openspec/.pi-map.md +index: 2026-05-22-sessions-hub/.openspec/.pi-map.index.md +map: 2026-05-22-sessions-hub/.openspec/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.md b/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.md index 4cd0140..be8d5f6 100644 --- a/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-sessions-hub/.openspec/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-sessions-hub/.openspec -dir: archive/2026-05-22-sessions-hub/.openspec +# 2026-05-22-sessions-hub/.openspec +dir: 2026-05-22-sessions-hub/.openspec -index: archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md +index: 2026-05-22-sessions-hub/.openspec/.pi-map.index.md ## role -Defines the configuration schema and validation rules for a sessions hub service using OpenAPI-style specification format. +Defines the OpenAPI specification and schema-driven configuration for the sessions hub service API ## files - config.yaml | Defines a configuration file for a sessions hub service using spec-driven schema ## arch -Spec-driven configuration with YAML-based schema definition for service configuration validation and documentation. +Spec-driven schema configuration using YAML-based API contract definition ## tags config, defines, configuration, sessions, hub, service, spec, driven ## symbols diff --git a/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.index.md b/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.index.md index 6d56db4..cc80c42 100644 --- a/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-05-22-sessions-hub (index) -dir: archive/2026-05-22-sessions-hub +# 2026-05-22-sessions-hub (index) +dir: 2026-05-22-sessions-hub ## role -Design and planning package for a centralized Sessions Hub feature that manages user workspace sessions across projects. +Centralized workspace session management feature enabling users to view, organize, and control active tool instances across projects. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-sessions-hub/.openspec - index: archive/2026-05-22-sessions-hub/.openspec/.pi-map.index.md - map: archive/2026-05-22-sessions-hub/.openspec/.pi-map.md -- archive/2026-05-22-sessions-hub/specs - index: archive/2026-05-22-sessions-hub/specs/.pi-map.index.md - map: archive/2026-05-22-sessions-hub/specs/.pi-map.md +- 2026-05-22-sessions-hub/.openspec + index: 2026-05-22-sessions-hub/.openspec/.pi-map.index.md + map: 2026-05-22-sessions-hub/.openspec/.pi-map.md +- 2026-05-22-sessions-hub/specs + index: 2026-05-22-sessions-hub/specs/.pi-map.index.md + map: 2026-05-22-sessions-hub/specs/.pi-map.md ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-sessions-hub/.pi-map.index.md -map: archive/2026-05-22-sessions-hub/.pi-map.md +index: 2026-05-22-sessions-hub/.pi-map.index.md +map: 2026-05-22-sessions-hub/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.md b/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.md index 4900ceb..73446bd 100644 --- a/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-sessions-hub/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-22-sessions-hub -dir: archive/2026-05-22-sessions-hub +# 2026-05-22-sessions-hub +dir: 2026-05-22-sessions-hub -index: archive/2026-05-22-sessions-hub/.pi-map.index.md +index: 2026-05-22-sessions-hub/.pi-map.index.md ## role -Design and planning package for a centralized Sessions Hub feature that manages user workspace sessions across projects. +Centralized workspace session management feature enabling users to view, organize, and control active tool instances across projects. ## files - design.md | Design document for implementing a Sessions Hub feature with page layout, navigation, data flow, and API changes for managing user workspace sessions. | dep: Navigation, AppShell, SessionsPage, UserConfig, API endpoints (/users/me/sessions, /users/me/config), workspace, state management, polling - proposal.md | Proposes a centralized "Sessions Hub" feature for managing active tool instances across projects - tasks.md | Project task tracking document for implementing a Sessions Hub feature across backend and frontend | dep: UserConfig model, Alembic, Pydantic, AppShell, React Router, sessions context, workspace, npm ## arch -Documentation-driven architecture using markdown-based design documents (design.md, proposal.md, tasks.md) to specify page layouts, navigation flows, data models, and API contracts before implementation. +Product design documents following a structured proposal-to-design-to-tasks workflow, with API-driven backend/frontend coordination and hub-and-spoke navigation pattern. ## tags sessions, design, hub, feature, workspace, document, implementing, navigation ## symbols diff --git a/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.index.md index fe62039..e8cb046 100644 --- a/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-sessions-hub/specs (index) -dir: archive/2026-05-22-sessions-hub/specs +# 2026-05-22-sessions-hub/specs (index) +dir: 2026-05-22-sessions-hub/specs ## role -Defines technical specifications for a Sessions Hub feature that manages user sessions in a web application. +Defines comprehensive technical specifications for the Sessions Hub feature, serving as the authoritative design document for requirements, APIs, UI, and quality standards. ## parent -index: archive/2026-05-22-sessions-hub/.pi-map.index.md -map: archive/2026-05-22-sessions-hub/.pi-map.md +index: 2026-05-22-sessions-hub/.pi-map.index.md +map: 2026-05-22-sessions-hub/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-sessions-hub/specs/.pi-map.index.md -map: archive/2026-05-22-sessions-hub/specs/.pi-map.md +index: 2026-05-22-sessions-hub/specs/.pi-map.index.md +map: 2026-05-22-sessions-hub/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.md index b0ee85e..4c95347 100644 --- a/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-sessions-hub/specs/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-sessions-hub/specs -dir: archive/2026-05-22-sessions-hub/specs +# 2026-05-22-sessions-hub/specs +dir: 2026-05-22-sessions-hub/specs -index: archive/2026-05-22-sessions-hub/specs/.pi-map.index.md +index: 2026-05-22-sessions-hub/specs/.pi-map.index.md ## role -Defines technical specifications for a Sessions Hub feature that manages user sessions in a web application. +Defines comprehensive technical specifications for the Sessions Hub feature, serving as the authoritative design document for requirements, APIs, UI, and quality standards. ## files - spec.md | Defines technical specifications for a "Sessions Hub" feature including requirements, API endpoints, UI layouts, state management, and quality gates for managing user sessions in a web application. | dep: REST API, TypeScript, React/frontend framework (implied by UI specs and quality gates), polling-based state management, Pydantic/BaseModel ## arch -Specification-driven design using structured documentation with requirements, API contracts, UI wireframes, state diagrams, and quality gates. +Specification-driven development with structured documentation covering functional requirements, RESTful API design, component-based UI architecture, Redux-style state management patterns, and gated quality checkpoints. ## tags sessions, spec, defines, technical, specifications, hub, feature, including ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.index.md index 2c9236f..d0aca72 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-tool-config-management (index) -dir: archive/2026-05-22-tool-config-management +# 2026-05-22-tool-config-management (index) +dir: 2026-05-22-tool-config-management ## role -Designs and tracks implementation of a per-user/per-project tool configuration management system with environment variables and file-based configs for containerized development tools. +Designs and tracks implementation of a flexible tool configuration management system for containerized development tools with user-global and project-scoped environment variables and file-based configurations. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-tool-config-management/specs - index: archive/2026-05-22-tool-config-management/specs/.pi-map.index.md - map: archive/2026-05-22-tool-config-management/specs/.pi-map.md +- 2026-05-22-tool-config-management/specs + index: 2026-05-22-tool-config-management/specs/.pi-map.index.md + map: 2026-05-22-tool-config-management/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-tool-config-management/.pi-map.index.md -map: archive/2026-05-22-tool-config-management/.pi-map.md +index: 2026-05-22-tool-config-management/.pi-map.index.md +map: 2026-05-22-tool-config-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.md index 755ea83..cc526ef 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-config-management/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-tool-config-management -dir: archive/2026-05-22-tool-config-management +# 2026-05-22-tool-config-management +dir: 2026-05-22-tool-config-management -index: archive/2026-05-22-tool-config-management/.pi-map.index.md +index: 2026-05-22-tool-config-management/.pi-map.index.md ## role -Designs and tracks implementation of a per-user/per-project tool configuration management system with environment variables and file-based configs for containerized development tools. +Designs and tracks implementation of a flexible tool configuration management system for containerized development tools with user-global and project-scoped environment variables and file-based configurations. ## files - .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata - design.md | Design document for implementing a flexible tool configuration system with user-global and project-scoped env vars and file-based configs for containerized tools - proposal.md | Proposes a feature to add per-user/per-project tool configuration management with categorization and container mounting for a development tools platform. | dep: database, container-runtime, API, frontend - tasks.md | Project task checklist tracking implementation of tool configuration system with database models, backend APIs, frontend UI, and OpenCode integration ## arch -Documentation-driven design using markdown specs (design.md, proposal.md) with task tracking (tasks.md) and OpenAPI schema configuration (.openspec.yaml), following a phased implementation approach across database, backend API, frontend UI, and external integration layers. +Specification-driven development using OpenAPI standards, phased implementation tracking (database → backend → frontend → IDE integration), and hierarchical configuration scoping (user-global vs project-specific) with container mount integration. ## tags configuration, design, tool, project, .openspec, system, user, tools ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.index.md index 7d6644e..a2a2369 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-22-tool-config-management/specs (index) -dir: archive/2026-05-22-tool-config-management/specs +# 2026-05-22-tool-config-management/specs (index) +dir: 2026-05-22-tool-config-management/specs ## role -Contains specification documents for a tool configuration management system dated May 22, 2026. +Contains specification documents defining requirements and design for a tool configuration management system. ## parent -index: archive/2026-05-22-tool-config-management/.pi-map.index.md -map: archive/2026-05-22-tool-config-management/.pi-map.md +index: 2026-05-22-tool-config-management/.pi-map.index.md +map: 2026-05-22-tool-config-management/.pi-map.md ## children -- archive/2026-05-22-tool-config-management/specs/tool-config-management - index: archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md - map: archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md +- 2026-05-22-tool-config-management/specs/tool-config-management + index: 2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md + map: 2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md ## files ## links -index: archive/2026-05-22-tool-config-management/specs/.pi-map.index.md -map: archive/2026-05-22-tool-config-management/specs/.pi-map.md +index: 2026-05-22-tool-config-management/specs/.pi-map.index.md +map: 2026-05-22-tool-config-management/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.md index 6f2310c..d89dc57 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-config-management/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-tool-config-management/specs -dir: archive/2026-05-22-tool-config-management/specs +# 2026-05-22-tool-config-management/specs +dir: 2026-05-22-tool-config-management/specs -index: archive/2026-05-22-tool-config-management/specs/.pi-map.index.md +index: 2026-05-22-tool-config-management/specs/.pi-map.index.md ## role -Contains specification documents for a tool configuration management system dated May 22, 2026. +Contains specification documents defining requirements and design for a tool configuration management system. ## files ## arch -Documentation/specification-driven architecture with dated archive organization for historical tracking of configuration management requirements. +Documentation-driven specification pattern using dated directory organization to track evolving system requirements over time. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md index 93ed4de..1512747 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-tool-config-management/specs/tool-config-management (index) -dir: archive/2026-05-22-tool-config-management/specs/tool-config-management +# 2026-05-22-tool-config-management/specs/tool-config-management (index) +dir: 2026-05-22-tool-config-management/specs/tool-config-management ## role -Defines system requirements for managing user-scoped tool configurations with environment/file types, tool categorization, and built-in OpenCode tool support +Defines system requirements for user-scoped tool configurations, environment/file config types, tool categorization with interfaces, and built-in OpenCode tool support ## parent -index: archive/2026-05-22-tool-config-management/specs/.pi-map.index.md -map: archive/2026-05-22-tool-config-management/specs/.pi-map.md +index: 2026-05-22-tool-config-management/specs/.pi-map.index.md +map: 2026-05-22-tool-config-management/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md -map: archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md +index: 2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md +map: 2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md index ecd4a1d..cd81e56 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-tool-config-management/specs/tool-config-management -dir: archive/2026-05-22-tool-config-management/specs/tool-config-management +# 2026-05-22-tool-config-management/specs/tool-config-management +dir: 2026-05-22-tool-config-management/specs/tool-config-management -index: archive/2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md +index: 2026-05-22-tool-config-management/specs/tool-config-management/.pi-map.index.md ## role -Defines system requirements for managing user-scoped tool configurations with environment/file types, tool categorization, and built-in OpenCode tool support +Defines system requirements for user-scoped tool configurations, environment/file config types, tool categorization with interfaces, and built-in OpenCode tool support ## files - spec.md | Defines system requirements for user-scoped tool configurations, environment/file config types, tool categorization with interfaces, and built-in OpenCode tool support ## arch -Specification-driven architecture using requirements documents to define configuration management patterns, tool interfaces, and extensible tool categorization system +Specification-driven architecture using markdown-based requirements documentation with interface definitions for tool configuration management ## tags tool, spec, defines, system, requirements, user, scoped, configurations ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md index 7d4c850..d510e36 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-22-tool-config-ui-rework (index) -dir: archive/2026-05-22-tool-config-ui-rework +# 2026-05-22-tool-config-ui-rework (index) +dir: 2026-05-22-tool-config-ui-rework ## role -Archive of design documents and specifications for a tool configuration UI rework project from May 2026 +Design and planning package for a UI/UX rework of a tool configuration management interface with backend schema changes ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-tool-config-ui-rework/specs - index: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md - map: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md +- 2026-05-22-tool-config-ui-rework/specs + index: 2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md + map: 2026-05-22-tool-config-ui-rework/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md -map: archive/2026-05-22-tool-config-ui-rework/.pi-map.md +index: 2026-05-22-tool-config-ui-rework/.pi-map.index.md +map: 2026-05-22-tool-config-ui-rework/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.md index 4d44e5d..aded380 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-tool-config-ui-rework -dir: archive/2026-05-22-tool-config-ui-rework +# 2026-05-22-tool-config-ui-rework +dir: 2026-05-22-tool-config-ui-rework -index: archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md +index: 2026-05-22-tool-config-ui-rework/.pi-map.index.md ## role -Archive of design documents and specifications for a tool configuration UI rework project from May 2026 +Design and planning package for a UI/UX rework of a tool configuration management interface with backend schema changes ## files - .openspec.yaml | Defines an OpenAPI specification configuration file with schema type and creation date metadata - design.md | Design document for redesigning a tool configuration page with split-pane layout, new configuration fields, and improved UX | dep: PostgreSQL, JSON, Docker/container runtime (referenced but not modified) - proposal.md | Proposes a UI/UX redesign of a tool configuration management page with backend schema changes to support additional configuration fields | dep: database, API endpoints, frontend components, migration system - tasks.md | Project task checklist tracking implementation of container runtime configuration features across database, backend, and frontend | dep: Alembic, SQLAlchemy, Pydantic, FastAPI, React/TypeScript, JSON editor component, ruff, mypy, tsc, eslint ## arch -Document-driven design process with OpenAPI spec integration, split-pane UI pattern, and cross-stack (database/backend/frontend) implementation tracking +Specification-driven design with OpenAPI configuration, split-pane frontend layout, and cross-layer task tracking across database/backend/frontend tiers ## tags configuration, design, schema, .openspec, tool, page, fields, backend ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md index d4cfacf..f2e6972 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-22-tool-config-ui-rework/specs (index) -dir: archive/2026-05-22-tool-config-ui-rework/specs +# 2026-05-22-tool-config-ui-rework/specs (index) +dir: 2026-05-22-tool-config-ui-rework/specs ## role -Contains archived specification documents for a tool configuration UI rework project from May 22, 2026. +Contains specification documents for the tool configuration UI rework planned for 2026-05-22. ## parent -index: archive/2026-05-22-tool-config-ui-rework/.pi-map.index.md -map: archive/2026-05-22-tool-config-ui-rework/.pi-map.md +index: 2026-05-22-tool-config-ui-rework/.pi-map.index.md +map: 2026-05-22-tool-config-ui-rework/.pi-map.md ## children -- archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management - index: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md - map: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md +- 2026-05-22-tool-config-ui-rework/specs/tool-config-management + index: 2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md + map: 2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md ## files ## links -index: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md -map: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md +index: 2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md +map: 2026-05-22-tool-config-ui-rework/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md index fd440f8..59706f5 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-22-tool-config-ui-rework/specs -dir: archive/2026-05-22-tool-config-ui-rework/specs +# 2026-05-22-tool-config-ui-rework/specs +dir: 2026-05-22-tool-config-ui-rework/specs -index: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md +index: 2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md ## role -Contains archived specification documents for a tool configuration UI rework project from May 22, 2026. +Contains specification documents for the tool configuration UI rework planned for 2026-05-22. ## files ## arch -Document-based specification storage with date-versioned archiving pattern for historical project requirements and design documentation. +Documentation/specification-driven design with dated versioning for UI redesign planning. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md index 36ecc22..a7a5502 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management (index) -dir: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management +# 2026-05-22-tool-config-ui-rework/specs/tool-config-management (index) +dir: 2026-05-22-tool-config-ui-rework/specs/tool-config-management ## role -Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. +Defines requirements and specifications for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. ## parent -index: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md -map: archive/2026-05-22-tool-config-ui-rework/specs/.pi-map.md +index: 2026-05-22-tool-config-ui-rework/specs/.pi-map.index.md +map: 2026-05-22-tool-config-ui-rework/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md -map: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md +index: 2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md +map: 2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md index ddfa3d9..095bea8 100644 --- a/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management -dir: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management +# 2026-05-22-tool-config-ui-rework/specs/tool-config-management +dir: 2026-05-22-tool-config-ui-rework/specs/tool-config-management -index: archive/2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md +index: 2026-05-22-tool-config-ui-rework/specs/tool-config-management/.pi-map.index.md ## role -Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. +Defines requirements and specifications for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. ## files - spec.md | Defines requirements for a tool configuration system with runtime fields, split-pane UI, JSON editors, and validation ## arch -Specification-driven design using requirements documents to define UI/UX patterns (split-pane layout, JSON editing) and system behaviors (validation, runtime field handling) before implementation. +Specification-driven design using requirements documentation as the architectural foundation for a configuration UI with split-pane layout, JSON editing capabilities, and field validation. ## tags spec, defines, requirements, tool, configuration, system, runtime, fields ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.index.md index 6e07b8c..801cf34 100644 --- a/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.index.md @@ -1,22 +1,22 @@ -# archive/2026-05-22-tool-workshop (index) -dir: archive/2026-05-22-tool-workshop +# 2026-05-22-tool-workshop (index) +dir: 2026-05-22-tool-workshop ## role -Design and planning documentation for a "Tool Workshop" feature that extends a tool management platform to support Docker-based tools with rich configuration, reusable configs, and readiness probes. +Design and planning documentation for a "Tool Workshop" system that enables user-defined Docker-based tools with rich configuration, reusable configs, and readiness probes through a unified management interface. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-22-tool-workshop/specs - index: archive/2026-05-22-tool-workshop/specs/.pi-map.index.md - map: archive/2026-05-22-tool-workshop/specs/.pi-map.md +- 2026-05-22-tool-workshop/specs + index: 2026-05-22-tool-workshop/specs/.pi-map.index.md + map: 2026-05-22-tool-workshop/specs/.pi-map.md ## files - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-tool-workshop/.pi-map.index.md -map: archive/2026-05-22-tool-workshop/.pi-map.md +index: 2026-05-22-tool-workshop/.pi-map.index.md +map: 2026-05-22-tool-workshop/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.md index 4d1ab97..c81085a 100644 --- a/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-workshop/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-22-tool-workshop -dir: archive/2026-05-22-tool-workshop +# 2026-05-22-tool-workshop +dir: 2026-05-22-tool-workshop -index: archive/2026-05-22-tool-workshop/.pi-map.index.md +index: 2026-05-22-tool-workshop/.pi-map.index.md ## role -Design and planning documentation for a "Tool Workshop" feature that extends a tool management platform to support Docker-based tools with rich configuration, reusable configs, and readiness probes. +Design and planning documentation for a "Tool Workshop" system that enables user-defined Docker-based tools with rich configuration, reusable configs, and readiness probes through a unified management interface. ## files - design.md | Design specification for a "Tool Workshop" system that extends an existing tool management platform to support Docker Compose and Dockerfile definitions, readiness probes, reusable config file collections, rich configuration fields, and a unified management UI. | dep: Docker Compose, Docker, Python, JSONB, Cloudflare tunnels, database (implied), web framework (implied) - proposal.md | Proposes a comprehensive redesign of a tool system to support user-defined Docker tools, rich configuration, reusable config folders, and readiness probes through a unified "Tool Workshop" interface. | dep: Docker Compose, Dockerfiles, database migration system, frontend routing/navigation system, Docker build service - tasks.md | A comprehensive project task list tracking the implementation of a Docker-based tool management platform with backend API, frontend UI, and deployment phases, all marked as complete. | dep: Alembic, Pydantic, Docker, React/TypeScript, FastAPI, SQLAlchemy ## arch -Specification-driven design documents following a proposal-to-design-to-tasks workflow; the system architecture centers on Docker Compose/Dockerfile-based tool definitions, reusable configuration file collections, readiness probe health checks, and a unified management UI with backend API and frontend components. +Specification-driven design documents using markdown-based technical proposals with phased implementation tracking (design spec → proposal → task breakdown), covering backend API extensions, frontend UI components, and Docker/container orchestration patterns. ## tags tool, docker, design, management, workshop, system, platform, support ## symbols diff --git a/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.index.md index ad403e4..19b5aec 100644 --- a/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-05-22-tool-workshop/specs (index) -dir: archive/2026-05-22-tool-workshop/specs +# 2026-05-22-tool-workshop/specs (index) +dir: 2026-05-22-tool-workshop/specs ## role -Defines specifications and requirements for a unified Docker-based development tool management system with configuration mounting and health checking capabilities. +Defines technical specifications and requirements for a containerized development tool management system including configuration, lifecycle, and orchestration concerns. ## parent -index: archive/2026-05-22-tool-workshop/.pi-map.index.md -map: archive/2026-05-22-tool-workshop/.pi-map.md +index: 2026-05-22-tool-workshop/.pi-map.index.md +map: 2026-05-22-tool-workshop/.pi-map.md ## children - ## files @@ -13,8 +13,8 @@ map: archive/2026-05-22-tool-workshop/.pi-map.md - readiness-probes.md - tool-workshop.md ## links -index: archive/2026-05-22-tool-workshop/specs/.pi-map.index.md -map: archive/2026-05-22-tool-workshop/specs/.pi-map.md +index: 2026-05-22-tool-workshop/specs/.pi-map.index.md +map: 2026-05-22-tool-workshop/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.md b/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.md index 8d598c1..216c65e 100644 --- a/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-tool-workshop/specs/.pi-map.md @@ -1,16 +1,16 @@ -# archive/2026-05-22-tool-workshop/specs -dir: archive/2026-05-22-tool-workshop/specs +# 2026-05-22-tool-workshop/specs +dir: 2026-05-22-tool-workshop/specs -index: archive/2026-05-22-tool-workshop/specs/.pi-map.index.md +index: 2026-05-22-tool-workshop/specs/.pi-map.index.md ## role -Defines specifications and requirements for a unified Docker-based development tool management system with configuration mounting and health checking capabilities. +Defines technical specifications and requirements for a containerized development tool management system including configuration, lifecycle, and orchestration concerns. ## files - config-folders.md | Defines requirements and design for a reusable config folder system that mounts user configuration files into tool instances with project-specific override support - readiness-probes.md | Defines functional requirements and specifications for container readiness probes that determine when tool instances are fully initialized and marked as running. | dep: docker, pydantic/BaseModel, shell commands (curl, nc, pg_isready), JSON - tool-workshop.md | Defines requirements and specifications for a unified tool management system that handles Docker-based development tools through type definitions, configurations, config folders, and readiness probes. | dep: Docker Compose, Dockerfile, container runtime, design.md ## arch -Documentation-driven specification architecture using modular requirement documents (config folders, readiness probes, tool workshop) that compose into a complete system design through hierarchical dependency (tool-workshop.md orchestrates config-folders.md and readiness-probes.md). +Specification-driven design with layered documentation architecture: base system spec (tool-workshop.md), and modular sub-specs (config-folders.md, readiness-probes.md) that decompose concerns into independently specified, composable components. ## tags tool, config, readiness, probes, defines, requirements, folders, design ## symbols diff --git a/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md b/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md index 09eca46..047e0c3 100644 --- a/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-05-22-ui-redesign-home-settings (index) -dir: archive/2026-05-22-ui-redesign-home-settings +# 2026-05-22-ui-redesign-home-settings (index) +dir: 2026-05-22-ui-redesign-home-settings ## role -This package contains archived planning and design documents for a UI redesign project focused on consolidating the authenticated frontend around a Home overview and tabbed Settings hub. +Contains design documentation and planning artifacts for a UI redesign project focused on restructuring the authenticated frontend around a Home overview and tabbed Settings hub. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -14,8 +14,8 @@ map: archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md -map: archive/2026-05-22-ui-redesign-home-settings/.pi-map.md +index: 2026-05-22-ui-redesign-home-settings/.pi-map.index.md +map: 2026-05-22-ui-redesign-home-settings/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.md b/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.md index fb8f685..99bb6db 100644 --- a/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.md +++ b/openspec/changes/archive/2026-05-22-ui-redesign-home-settings/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-22-ui-redesign-home-settings -dir: archive/2026-05-22-ui-redesign-home-settings +# 2026-05-22-ui-redesign-home-settings +dir: 2026-05-22-ui-redesign-home-settings -index: archive/2026-05-22-ui-redesign-home-settings/.pi-map.index.md +index: 2026-05-22-ui-redesign-home-settings/.pi-map.index.md ## role -This package contains archived planning and design documents for a UI redesign project focused on consolidating the authenticated frontend around a Home overview and tabbed Settings hub. +Contains design documentation and planning artifacts for a UI redesign project focused on restructuring the authenticated frontend around a Home overview and tabbed Settings hub. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design specification document for a UI redesign covering information architecture, page layouts, visual direction, routing, and component strategy. - proposal.md | Proposes a UI redesign to consolidate the authenticated frontend around a Home overview and a tabbed Settings hub while keeping existing functionality and APIs unchanged. - tasks.md | Task checklist tracking completed work for a UI redesign project involving navigation restructuring, home page redesign, and settings hub reorganization ## arch -Document-driven waterfall-style project planning with structured specification hierarchy (proposal → design → tasks → config) using markdown-based documentation and YAML metadata for archival tracking. +Documentation-driven design with specification files (OpenSpec config, design doc, proposal, and task tracking) following a structured planning approach with clear separation between proposal, design specification, and implementation tracking. ## tags redesign, design, .openspec, page, home, settings, hub, proposal ## symbols diff --git a/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.index.md b/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.index.md index 4555187..cf37610 100644 --- a/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-23-remove-built-in-tools (index) -dir: archive/2026-05-23-remove-built-in-tools +# 2026-05-23-remove-built-in-tools (index) +dir: 2026-05-23-remove-built-in-tools ## role -Archive directory containing historical design documents for a completed refactoring that eliminated special "built-in" tool type handling in favor of uniform database records. +This package contains design documents and planning artifacts for a refactoring initiative to eliminate special-case handling of built-in tool types by converting them to regular database records. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-23-remove-built-in-tools/specs - index: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md - map: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md +- 2026-05-23-remove-built-in-tools/specs + index: 2026-05-23-remove-built-in-tools/specs/.pi-map.index.md + map: 2026-05-23-remove-built-in-tools/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-23-remove-built-in-tools/.pi-map.index.md -map: archive/2026-05-23-remove-built-in-tools/.pi-map.md +index: 2026-05-23-remove-built-in-tools/.pi-map.index.md +map: 2026-05-23-remove-built-in-tools/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.md b/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.md index ff5239c..9526b8b 100644 --- a/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.md +++ b/openspec/changes/archive/2026-05-23-remove-built-in-tools/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-23-remove-built-in-tools -dir: archive/2026-05-23-remove-built-in-tools +# 2026-05-23-remove-built-in-tools +dir: 2026-05-23-remove-built-in-tools -index: archive/2026-05-23-remove-built-in-tools/.pi-map.index.md +index: 2026-05-23-remove-built-in-tools/.pi-map.index.md ## role -Archive directory containing historical design documents for a completed refactoring that eliminated special "built-in" tool type handling in favor of uniform database records. +This package contains design documents and planning artifacts for a refactoring initiative to eliminate special-case handling of built-in tool types by converting them to regular database records. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for removing built-in tool type special handling by migrating seeded data to regular database records via Alembic migration | dep: Alembic, SQLAlchemy/model layer, main.py startup logic, API layer, frontend - proposal.md | Proposes a refactoring to eliminate the privileged "built-in" tool type classification and make all tool types equal, first-class database records | dep: ToolType model, main.py, tool_types.py API, database migration system, frontend - tasks.md | Task checklist tracking the removal of `is_builtin` functionality from tool types across a full-stack application (database, backend, frontend, and testing) | dep: Alembic, SQLAlchemy, Pydantic, FastAPI, PostgreSQL, pytest, ruff, mypy, React/frontend build system ## arch -Migration-driven refactoring with phased full-stack removal (database/backend/frontend/test) using Alembic for data migration and OpenSpec for API schema documentation. +Documentation-driven change management using a structured proposal pipeline (proposal → design → tasks → OpenSpec config) to coordinate a full-stack migration involving database schema changes (Alembic), backend API modifications, frontend updates, and test suite adjustments. ## tags tool, type, design, database, alembic, frontend, .openspec, records ## symbols diff --git a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md index 5aaec85..995ca4f 100644 --- a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-05-23-remove-built-in-tools/specs (index) -dir: archive/2026-05-23-remove-built-in-tools/specs +# 2026-05-23-remove-built-in-tools/specs (index) +dir: 2026-05-23-remove-built-in-tools/specs ## role -Contains archived specification documents for the removal of built-in tools feature from the project, dated May 23, 2026. +Contains test specifications for verifying the removal of built-in tools functionality. ## parent -index: archive/2026-05-23-remove-built-in-tools/.pi-map.index.md -map: archive/2026-05-23-remove-built-in-tools/.pi-map.md +index: 2026-05-23-remove-built-in-tools/.pi-map.index.md +map: 2026-05-23-remove-built-in-tools/.pi-map.md ## children -- archive/2026-05-23-remove-built-in-tools/specs/tool-types - index: archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md - map: archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md +- 2026-05-23-remove-built-in-tools/specs/tool-types + index: 2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md + map: 2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md ## files ## links -index: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md -map: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md +index: 2026-05-23-remove-built-in-tools/specs/.pi-map.index.md +map: 2026-05-23-remove-built-in-tools/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md index 27b6a67..995296e 100644 --- a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-23-remove-built-in-tools/specs -dir: archive/2026-05-23-remove-built-in-tools/specs +# 2026-05-23-remove-built-in-tools/specs +dir: 2026-05-23-remove-built-in-tools/specs -index: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md +index: 2026-05-23-remove-built-in-tools/specs/.pi-map.index.md ## role -Contains archived specification documents for the removal of built-in tools feature from the project, dated May 23, 2026. +Contains test specifications for verifying the removal of built-in tools functionality. ## files ## arch -N/A (no code files present; directory serves as historical documentation archive for a completed or planned feature removal) +BDD-style specification files using Gherkin/Cucumber syntax for executable acceptance testing. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md index 8dfaf38..661578f 100644 --- a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-23-remove-built-in-tools/specs/tool-types (index) -dir: archive/2026-05-23-remove-built-in-tools/specs/tool-types +# 2026-05-23-remove-built-in-tools/specs/tool-types (index) +dir: 2026-05-23-remove-built-in-tools/specs/tool-types ## role -Archive of historical specification for removing built-in tool types from the system +Software specification document defining modified and removed requirements for a tool type management system ## parent -index: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.index.md -map: archive/2026-05-23-remove-built-in-tools/specs/.pi-map.md +index: 2026-05-23-remove-built-in-tools/specs/.pi-map.index.md +map: 2026-05-23-remove-built-in-tools/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md -map: archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md +index: 2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md +map: 2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md index 2e26006..7bd81b2 100644 --- a/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md +++ b/openspec/changes/archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-23-remove-built-in-tools/specs/tool-types -dir: archive/2026-05-23-remove-built-in-tools/specs/tool-types +# 2026-05-23-remove-built-in-tools/specs/tool-types +dir: 2026-05-23-remove-built-in-tools/specs/tool-types -index: archive/2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md +index: 2026-05-23-remove-built-in-tools/specs/tool-types/.pi-map.index.md ## role -Archive of historical specification for removing built-in tool types from the system +Software specification document defining modified and removed requirements for a tool type management system ## files - spec.md | Software specification document defining modified and removed requirements for a tool type management system ## arch -Document-based specification storage with dated versioning for change tracking +Requirements specification document following standard software specification format with sections for removed and modified requirements ## tags spec, software, specification, document, defining, modified, removed, requirements ## symbols diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md index 23f8420..e1792bc 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-24-terminal-startup-and-container-tools (index) -dir: archive/2026-05-24-terminal-startup-and-container-tools +# 2026-05-24-terminal-startup-and-container-tools (index) +dir: 2026-05-24-terminal-startup-and-container-tools ## role -Defines specifications and implementation plans for adding per-tool-type terminal startup commands and productivity utilities to a WebSocket-based container terminal system. +Implements a feature for customizable per-tool-type terminal startup commands and productivity utilities in a WebSocket-based container terminal system. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-24-terminal-startup-and-container-tools/specs - index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md - map: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +- 2026-05-24-terminal-startup-and-container-tools/specs + index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md + map: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md +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 ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md index e540128..a556a92 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-24-terminal-startup-and-container-tools -dir: archive/2026-05-24-terminal-startup-and-container-tools +# 2026-05-24-terminal-startup-and-container-tools +dir: 2026-05-24-terminal-startup-and-container-tools -index: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md +index: 2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md ## role -Defines specifications and implementation plans for adding per-tool-type terminal startup commands and productivity utilities to a WebSocket-based container terminal system. +Implements a feature for customizable per-tool-type terminal startup commands and productivity utilities in a WebSocket-based container terminal system. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata - design.md | Design specification for adding per-tool-type terminal startup commands and productivity utilities to a WebSocket-based container terminal system | dep: tool-types-definition, tool-terminal, opencode-web-server, tool-config-management, Docker, WebSocket, bash, Docker Compose - proposal.md | Proposes adding customizable startup commands to terminal tool types and productivity tools to the OpenCode container - tasks.md | Task tracking checklist for implementing a `startup_command` feature across database, backend API, terminal execution, frontend, and container tooling | dep: Alembic, SQLAlchemy, Pydantic, FastAPI, WebSocket, bash/tmux/ranger, npm, pytest, mypy, ruff ## arch -Specification-driven development with layered architecture (database schema → API → WebSocket execution → frontend UI), using OpenSpec for configuration management, and task-driven agile tracking across backend/frontend/container boundaries. +Specification-driven development using OpenSpec schema definitions, with cross-layer implementation spanning database schema, backend API, WebSocket terminal execution, frontend UI, and container tooling, tracked via structured task checklists. ## tags tool, terminal, design, startup, websocket, container, .openspec, adding ## symbols diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md index b4abacf..b8345a5 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md @@ -1,28 +1,28 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs (index) -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs +# 2026-05-24-terminal-startup-and-container-tools/specs (index) +dir: 2026-05-24-terminal-startup-and-container-tools/specs ## role -Contains specification documents for terminal startup and container tools features archived on 2026-05-24. +Contains specification documents that define requirements and designs for terminal startup and container tools features. ## parent -index: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/.pi-map.md +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 ## children -- archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server - index: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md - map: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md -- archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal - index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md - map: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md -- archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command - index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md - map: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md -- archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition - index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md - map: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md +- 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server + index: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md + map: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md +- 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal + index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md + map: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md +- 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command + index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md + map: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md +- 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition + index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md + map: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md ## files ## links -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md index 13ffa09..3ee4b31 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs +# 2026-05-24-terminal-startup-and-container-tools/specs +dir: 2026-05-24-terminal-startup-and-container-tools/specs -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md ## role -Contains specification documents for terminal startup and container tools features archived on 2026-05-24. +Contains specification documents that define requirements and designs for terminal startup and container tools features. ## files ## arch -Document-based architecture using dated archival organization with specification-driven design for feature planning. +Documentation-driven specification pattern using dated organizational structure with markdown-based technical specifications. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md index 246416d..037ecc0 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server (index) -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server +# 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server (index) +dir: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server ## role -Defines container specifications for running a web server with integrated terminal interface on port 3000 +Defines specification requirements for a containerized web server that provides browser-based terminal access via port 3000. ## parent -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md index bd05932..94ca09a 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server +# 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server +dir: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/opencode-web-server/.pi-map.index.md ## role -Defines container specifications for running a web server with integrated terminal interface on port 3000 +Defines specification requirements for a containerized web server that provides browser-based terminal access via port 3000. ## files - spec.md | Defines modified requirements for OpenCode containers to run a web server with a web terminal interface on port 3000 ## arch -Requirements specification document using markdown-based specification format +Specification-driven design using requirement documents to define container behavior, port binding, and terminal interface integration. ## tags web, spec, defines, modified, requirements, opencode, containers, run ## symbols diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md index b460d96..e443ee9 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command (index) -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command +# 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command (index) +dir: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command ## role -Defines specification requirements for extending terminal tools with pre-shell startup command execution capability. +Defines requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions. ## parent -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md index 5c36754..d0fce20 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command +# 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command +dir: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal-startup-command/.pi-map.index.md ## role -Defines specification requirements for extending terminal tools with pre-shell startup command execution capability. +Defines requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions. ## files - spec.md | Defines requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions. ## arch -Markdown-based specification document using requirement-driven design with explicit constraints, behavior definitions, and backward-compatibility considerations. +Specification-driven design using markdown-based requirements documents with a single focused feature proposal. ## tags terminal, spec, defines, requirements, adding, optional, startup, command ## symbols diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md index 87b11a3..bc528ec 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal (index) -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal +# 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal (index) +dir: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal ## role -Defines protocol specifications for WebSocket-based interactive terminal sessions with startup command execution and lifecycle management for containerized development tools. +Defines WebSocket-based terminal session specifications for containerized tools with startup command execution and lifecycle management. ## parent -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md index e8e67e4..9a6bfbe 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal +# 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal +dir: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-terminal/.pi-map.index.md ## role -Defines protocol specifications for WebSocket-based interactive terminal sessions with startup command execution and lifecycle management for containerized development tools. +Defines WebSocket-based terminal session specifications for containerized tools with startup command execution and lifecycle management. ## files - spec.md | Defines requirements for WebSocket-based terminal sessions with startup command execution and session management for containerized tools | dep: WebSocket, Docker (docker exec), container runtime, shell/terminal emulation ## arch -Specification-driven design using Markdown-based requirements documents that define WebSocket communication protocols, session state machines, and container integration patterns for terminal tooling. +Specification-driven API design using Markdown-based requirements documentation for WebSocket real-time communication with container session orchestration. ## tags websocket, spec, defines, requirements, terminal, sessions, startup, command ## symbols diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md index 523d8ca..6de0298 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition (index) -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition +# 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition (index) +dir: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition ## role Defines the data model and API contract for tool type management with template validation capabilities. ## parent -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md -map: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md +map: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md index b00725d..4761a70 100644 --- a/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md +++ b/openspec/changes/archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition -dir: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition +# 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition +dir: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition -index: archive/2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md +index: 2026-05-24-terminal-startup-and-container-tools/specs/tool-types-definition/.pi-map.index.md ## role Defines the data model and API contract for tool type management with template validation capabilities. ## files - spec.md | Defines requirements for a ToolType model and REST API endpoints for managing tool definitions with template validation | dep: REST API, Docker Compose, Dockerfile, YAML validation, UUID, authentication/authorization ## arch -Specification-driven design using Markdown-based requirements documents that define REST API endpoints and model validation rules. +Specification-driven design using Markdown-based requirements documentation for a model-REST API pattern with validation constraints. ## tags spec, defines, requirements, tooltype, model, rest, api, endpoints ## symbols diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.index.md b/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.index.md index 886e007..4595b2b 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-25-add-config-profiles (index) -dir: archive/2026-05-25-add-config-profiles +# 2026-05-25-add-config-profiles (index) +dir: 2026-05-25-add-config-profiles ## role -Archive directory preserving the historical design documentation for a config profiles feature that restructured tool instance configuration management. +Design and planning package for a new config profiles feature that replaces legacy config folder mounting with reusable, composable, user-owned launch configurations for tool sessions. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-25-add-config-profiles/specs - index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md - map: archive/2026-05-25-add-config-profiles/specs/.pi-map.md +- 2026-05-25-add-config-profiles/specs + index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md + map: 2026-05-25-add-config-profiles/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-25-add-config-profiles/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/.pi-map.md +index: 2026-05-25-add-config-profiles/.pi-map.index.md +map: 2026-05-25-add-config-profiles/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.md b/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.md index 9818da6..bf3cd25 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-25-add-config-profiles -dir: archive/2026-05-25-add-config-profiles +# 2026-05-25-add-config-profiles +dir: 2026-05-25-add-config-profiles -index: archive/2026-05-25-add-config-profiles/.pi-map.index.md +index: 2026-05-25-add-config-profiles/.pi-map.index.md ## role -Archive directory preserving the historical design documentation for a config profiles feature that restructured tool instance configuration management. +Design and planning package for a new config profiles feature that replaces legacy config folder mounting with reusable, composable, user-owned launch configurations for tool sessions. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata - design.md | Design document for a config profile system that replaces legacy config folders with user-owned, composable, selectable launch configurations for tool instances. | dep: Docker Compose, tool instance start system, config folder system (legacy), database tables (profiles, profile includes, instance profile selection) - proposal.md | Proposes a new "config profiles" feature to replace legacy config folder mounting with reusable, composable, user-owned launch configurations for tool sessions. - tasks.md | Project task tracking document outlining a multi-phase software development plan for implementing a config profile system with backend/frontend integration and quality gates. ## arch -Specification-driven design with phased implementation planning (backend → frontend → integration) using OpenSpec schema definitions and markdown-based design/proposal documentation. +Document-driven design process using structured markdown specifications (design.md, proposal.md) with formal schema definition (.openspec.yaml) and phased task tracking (tasks.md) following a requirements → proposal → design → implementation planning workflow. ## tags config, design, .openspec, document, profile, system, legacy, user ## symbols diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md index 72351ba..0bd9fdd 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md @@ -1,28 +1,28 @@ -# archive/2026-05-25-add-config-profiles/specs (index) -dir: archive/2026-05-25-add-config-profiles/specs +# 2026-05-25-add-config-profiles/specs (index) +dir: 2026-05-25-add-config-profiles/specs ## role -Contains archived specification documents for a feature to add configuration profiles, dated May 25, 2026. +Contains specification documents for the "add-config-profiles" feature, defining requirements and behavior for a configuration profiles system. ## parent -index: archive/2026-05-25-add-config-profiles/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/.pi-map.md +index: 2026-05-25-add-config-profiles/.pi-map.index.md +map: 2026-05-25-add-config-profiles/.pi-map.md ## children -- archive/2026-05-25-add-config-profiles/specs/config-profiles - index: archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md - map: archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md -- archive/2026-05-25-add-config-profiles/specs/tool-config-management - index: archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md - map: archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md -- archive/2026-05-25-add-config-profiles/specs/tool-instances - index: archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md - map: archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md -- archive/2026-05-25-add-config-profiles/specs/user-config - index: archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md - map: archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.md +- 2026-05-25-add-config-profiles/specs/config-profiles + index: 2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md + map: 2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md +- 2026-05-25-add-config-profiles/specs/tool-config-management + index: 2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md + map: 2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md +- 2026-05-25-add-config-profiles/specs/tool-instances + index: 2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md + map: 2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md +- 2026-05-25-add-config-profiles/specs/user-config + index: 2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md + map: 2026-05-25-add-config-profiles/specs/user-config/.pi-map.md ## files ## links -index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.md index 0e7a20a..a3cb7fe 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-25-add-config-profiles/specs -dir: archive/2026-05-25-add-config-profiles/specs +# 2026-05-25-add-config-profiles/specs +dir: 2026-05-25-add-config-profiles/specs -index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md +index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md ## role -Contains archived specification documents for a feature to add configuration profiles, dated May 25, 2026. +Contains specification documents for the "add-config-profiles" feature, defining requirements and behavior for a configuration profiles system. ## files ## arch -Document-based specification storage using date-prefixed directory naming for version tracking and archival purposes. +Specification-driven development with dated feature folders, using markdown/plaintext docs to separate design documentation from implementation code. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md index 91ed68c..1a2221d 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-add-config-profiles/specs/config-profiles (index) -dir: archive/2026-05-25-add-config-profiles/specs/config-profiles +# 2026-05-25-add-config-profiles/specs/config-profiles (index) +dir: 2026-05-25-add-config-profiles/specs/config-profiles ## role -Defines system requirements for a user-owned config profile management system with scoped compatibility, content storage, ordered includes, resolution layering, and default selection for launch configurations. +Defines requirements for a user-owned configuration profile management system supporting scoped compatibility, content storage, ordered includes, resolution layering, and default selection for launch configurations. ## parent -index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md index 38d66e8..e551738 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-add-config-profiles/specs/config-profiles -dir: archive/2026-05-25-add-config-profiles/specs/config-profiles +# 2026-05-25-add-config-profiles/specs/config-profiles +dir: 2026-05-25-add-config-profiles/specs/config-profiles -index: archive/2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md +index: 2026-05-25-add-config-profiles/specs/config-profiles/.pi-map.index.md ## role -Defines system requirements for a user-owned config profile management system with scoped compatibility, content storage, ordered includes, resolution layering, and default selection for launch configurations. +Defines requirements for a user-owned configuration profile management system supporting scoped compatibility, content storage, ordered includes, resolution layering, and default selection for launch configurations. ## files - spec.md | Defines system requirements for a user-owned config profile management system with scoped compatibility, content storage, ordered includes, resolution layering, and default selection for launch configurations. ## arch -Specification-driven design using markdown-based requirements documents with layered configuration resolution, ordered include chains, and scope-based compatibility filtering. +Specification-driven design using layered resolution architecture with profile scoping, content-addressable storage, ordered dependency chains (includes), and precedence-based default selection for launch-time configuration resolution. ## tags system, spec, defines, requirements, user, owned, config, profile ## symbols diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md index d670194..8a48041 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-add-config-profiles/specs/tool-config-management (index) -dir: archive/2026-05-25-add-config-profiles/specs/tool-config-management +# 2026-05-25-add-config-profiles/specs/tool-config-management (index) +dir: 2026-05-25-add-config-profiles/specs/tool-config-management ## role -Defines requirements for a tool configuration system that separates runtime fields from reusable launch setup via config profiles. +Specifies requirements for a tool configuration system that introduces config profiles to separate runtime state from reusable launch configurations. ## parent -index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md index 5d61691..61d248a 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-add-config-profiles/specs/tool-config-management -dir: archive/2026-05-25-add-config-profiles/specs/tool-config-management +# 2026-05-25-add-config-profiles/specs/tool-config-management +dir: 2026-05-25-add-config-profiles/specs/tool-config-management -index: archive/2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md +index: 2026-05-25-add-config-profiles/specs/tool-config-management/.pi-map.index.md ## role -Defines requirements for a tool configuration system that separates runtime fields from reusable launch setup via config profiles. +Specifies requirements for a tool configuration system that introduces config profiles to separate runtime state from reusable launch configurations. ## files - spec.md | Defines modified and removed requirements for a tool configuration system that separates runtime fields from reusable launch setup via config profiles. ## arch -Specification-driven design using requirement documents with explicit modification and removal tracking of prior requirements. +Requirements-driven specification using delta notation (MODIFIED/REMOVED) to track evolving constraints for a profile-based configuration management system with clear separation between persistent setup and ephemeral runtime data. ## tags spec, defines, modified, removed, requirements, tool, configuration, system ## symbols diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md index 9b8b85b..f4a1fda 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-add-config-profiles/specs/tool-instances (index) -dir: archive/2026-05-25-add-config-profiles/specs/tool-instances +# 2026-05-25-add-config-profiles/specs/tool-instances (index) +dir: 2026-05-25-add-config-profiles/specs/tool-instances ## role -Defines requirements for creating tool instances with clone/mount modes and applying config profiles at startup. +Defines specifications for creating and configuring tool instances with support for clone/mount modes and config profile application at startup. ## parent -index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md index 2e9fe29..1bff6e0 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-add-config-profiles/specs/tool-instances -dir: archive/2026-05-25-add-config-profiles/specs/tool-instances +# 2026-05-25-add-config-profiles/specs/tool-instances +dir: 2026-05-25-add-config-profiles/specs/tool-instances -index: archive/2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md +index: 2026-05-25-add-config-profiles/specs/tool-instances/.pi-map.index.md ## role -Defines requirements for creating tool instances with clone/mount modes and applying config profiles at startup. +Defines specifications for creating and configuring tool instances with support for clone/mount modes and config profile application at startup. ## files - spec.md | Defines requirements for tool instance creation with clone/mount modes and config profile application at startup ## arch -Specification-driven requirements documentation using markdown-based feature specs with mode-based instantiation patterns and startup-time configuration injection. +Specification-driven design using markdown-based requirements documents that define behavioral contracts for instance lifecycle management and configuration injection patterns. ## tags spec, defines, requirements, tool, instance, creation, clone, mount ## symbols diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md index 57bf0df..908df4a 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-add-config-profiles/specs/user-config (index) -dir: archive/2026-05-25-add-config-profiles/specs/user-config +# 2026-05-25-add-config-profiles/specs/user-config (index) +dir: 2026-05-25-add-config-profiles/specs/user-config ## role -Defines requirements for a user configuration profile management system with settings editor and launch-time profile selection UI. +Defines requirements for a configuration profile management system enabling users to create, edit, and select runtime profiles through both a settings editor and launch-time UI. ## parent -index: archive/2026-05-25-add-config-profiles/specs/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md -map: archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.md +index: 2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md +map: 2026-05-25-add-config-profiles/specs/user-config/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.md b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.md index e410a0e..626416b 100644 --- a/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-add-config-profiles/specs/user-config -dir: archive/2026-05-25-add-config-profiles/specs/user-config +# 2026-05-25-add-config-profiles/specs/user-config +dir: 2026-05-25-add-config-profiles/specs/user-config -index: archive/2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md +index: 2026-05-25-add-config-profiles/specs/user-config/.pi-map.index.md ## role -Defines requirements for a user configuration profile management system with settings editor and launch-time profile selection UI. +Defines requirements for a configuration profile management system enabling users to create, edit, and select runtime profiles through both a settings editor and launch-time UI. ## files - spec.md | Defines requirements for a config profile management system including a settings editor and launch-time profile selection UI ## arch -Specification-driven design using markdown-based requirements documentation for a feature archived on 2026-05-25. +Specification-driven design using markdown-based requirements documents that separate functional requirements (profile CRUD, UI flows) from system constraints, following a document-as-contract pattern for feature development. ## tags profile, spec, defines, requirements, config, management, system, including ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.index.md index 03ee4a0..571469e 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-25-mobile-app-usability (index) -dir: archive/2026-05-25-mobile-app-usability +# 2026-05-25-mobile-app-usability (index) +dir: 2026-05-25-mobile-app-usability ## role -Contains historical documentation for a completed mobile responsiveness overhaul project targeting the Headquarter web app's critical workflows on 320-768px viewports. +Mobile responsiveness improvement package for a React web application's frontend usability overhaul. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-25-mobile-app-usability/specs - index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +- 2026-05-25-mobile-app-usability/specs + index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-25-mobile-app-usability/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/.pi-map.md +index: 2026-05-25-mobile-app-usability/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.md index a0e6cef..f568ec3 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-25-mobile-app-usability -dir: archive/2026-05-25-mobile-app-usability +# 2026-05-25-mobile-app-usability +dir: 2026-05-25-mobile-app-usability -index: archive/2026-05-25-mobile-app-usability/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/.pi-map.index.md ## role -Contains historical documentation for a completed mobile responsiveness overhaul project targeting the Headquarter web app's critical workflows on 320-768px viewports. +Mobile responsiveness improvement package for a React web application's frontend usability overhaul. ## files - .openspec.yaml | Defines an OpenSpec configuration file specifying a spec-driven schema with a creation date. - design.md | Design document outlining mobile UX improvements for a React desktop-first web application, focusing on navigation, session management, forms, and touch targets for 320-768px viewports. | dep: React, CSS media queries, mobile browser safe-area-insets, routing system - proposal.md | Proposes a frontend mobile responsiveness overhaul for the Headquarter web app to make critical workflows usable on mobile devices - tasks.md | A completed task checklist for implementing comprehensive mobile responsive design across a web application ## arch -Spec-driven design documentation using OpenSpec schema configuration with structured design/proposal/task artifacts following a desktop-to-mobile adaptation pattern for React web applications. +Documentation-driven specification approach using OpenSpec schema configuration, design documents, and task-based project tracking for iterative mobile-first responsive UI implementation. ## tags design, mobile, web, .openspec, react, application, proposal, tasks ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md index 5de651b..9e939a7 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md @@ -1,34 +1,34 @@ -# archive/2026-05-25-mobile-app-usability/specs (index) -dir: archive/2026-05-25-mobile-app-usability/specs +# 2026-05-25-mobile-app-usability/specs (index) +dir: 2026-05-25-mobile-app-usability/specs ## role -Contains archived mobile app usability specifications from May 2026, preserving historical design requirements for reference or compliance purposes. +Defines technical specifications and requirements for the 2026-05-25 mobile app usability improvement initiative. ## parent -index: archive/2026-05-25-mobile-app-usability/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/.pi-map.md +index: 2026-05-25-mobile-app-usability/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/.pi-map.md ## children -- archive/2026-05-25-mobile-app-usability/specs/frontend-foundation - index: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md -- archive/2026-05-25-mobile-app-usability/specs/mobile-navigation - index: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md -- archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts - index: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md -- archive/2026-05-25-mobile-app-usability/specs/mobile-session-management - index: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md -- archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux - index: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md -- archive/2026-05-25-mobile-app-usability/specs/tool-instances - index: archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md - map: archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md +- 2026-05-25-mobile-app-usability/specs/frontend-foundation + index: 2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md +- 2026-05-25-mobile-app-usability/specs/mobile-navigation + index: 2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md +- 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts + index: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md +- 2026-05-25-mobile-app-usability/specs/mobile-session-management + index: 2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md +- 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux + index: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md +- 2026-05-25-mobile-app-usability/specs/tool-instances + index: 2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md + map: 2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md ## files ## links -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.md index ea379ae..0976532 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-25-mobile-app-usability/specs -dir: archive/2026-05-25-mobile-app-usability/specs +# 2026-05-25-mobile-app-usability/specs +dir: 2026-05-25-mobile-app-usability/specs -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md ## role -Contains archived mobile app usability specifications from May 2026, preserving historical design requirements for reference or compliance purposes. +Defines technical specifications and requirements for the 2026-05-25 mobile app usability improvement initiative. ## files ## arch -Simple flat-file archive structure with date-based namespacing, no active code or architectural patterns—pure document storage using filesystem hierarchy for versioning. +Document-driven specification pattern with date-prefixed milestone organization for tracking mobile UX enhancement requirements. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md index b2d0c4f..33c286b 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-app-usability/specs/frontend-foundation (index) -dir: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation +# 2026-05-25-mobile-app-usability/specs/frontend-foundation (index) +dir: 2026-05-25-mobile-app-usability/specs/frontend-foundation ## role -Defines the responsive layout and navigation specification for a web application's frontend foundation, covering both desktop sidebar and mobile bottom tab bar patterns. +Defines responsive layout and navigation specifications for a web application supporting both desktop sidebar and mobile bottom tab bar interfaces. ## parent -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md index 70fa8ee..d1557f8 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-app-usability/specs/frontend-foundation -dir: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation +# 2026-05-25-mobile-app-usability/specs/frontend-foundation +dir: 2026-05-25-mobile-app-usability/specs/frontend-foundation -index: archive/2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/frontend-foundation/.pi-map.index.md ## role -Defines the responsive layout and navigation specification for a web application's frontend foundation, covering both desktop sidebar and mobile bottom tab bar patterns. +Defines responsive layout and navigation specifications for a web application supporting both desktop sidebar and mobile bottom tab bar interfaces. ## files - spec.md | Specifies modified responsive layout and navigation requirements for a web application with desktop sidebar and mobile bottom tab bar navigation. ## arch -Responsive design specification using breakpoint-based layout switching (desktop sidebar vs. mobile bottom navigation) with platform-adaptive UI patterns. +Specification-driven responsive design pattern with breakpoint-based adaptive navigation switching between desktop and mobile layouts. ## tags navigation, spec, specifies, modified, responsive, layout, requirements, web ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md index 81d5b59..7d967be 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-app-usability/specs/mobile-navigation (index) -dir: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation +# 2026-05-25-mobile-app-usability/specs/mobile-navigation (index) +dir: 2026-05-25-mobile-app-usability/specs/mobile-navigation ## role -Defines responsive mobile navigation requirements for viewport-adaptive layouts with touch-friendly bottom tab bars and safe area compatibility. +Defines mobile responsive navigation requirements including bottom tab bar for mobile viewports and safe area support ## parent -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md index 826135b..62e3781 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-app-usability/specs/mobile-navigation -dir: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation +# 2026-05-25-mobile-app-usability/specs/mobile-navigation +dir: 2026-05-25-mobile-app-usability/specs/mobile-navigation -index: archive/2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/mobile-navigation/.pi-map.index.md ## role -Defines responsive mobile navigation requirements for viewport-adaptive layouts with touch-friendly bottom tab bars and safe area compatibility. +Defines mobile responsive navigation requirements including bottom tab bar for mobile viewports and safe area support ## files - spec.md | Defines mobile responsive navigation requirements including bottom tab bar for mobile viewports and safe area support ## arch -Specification-driven design using platform-aware responsive patterns (mobile-first with viewport detection, safe area insets for notched devices, and bottom tab bar as primary mobile navigation paradigm). +Specification-driven requirements document using markdown-based functional specification pattern for mobile UI/UX constraints ## tags mobile, spec, defines, responsive, navigation, requirements, including, bottom ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md index 8862cbb..eb45e14 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts (index) -dir: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts +# 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts (index) +dir: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts ## role Defines mobile-specific UI/UX requirements for responsive design, touch interactions, and navigation patterns ## parent -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md index d4c331c..02a4417 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts -dir: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts +# 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts +dir: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts -index: archive/2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/mobile-responsive-layouts/.pi-map.index.md ## role Defines mobile-specific UI/UX requirements for responsive design, touch interactions, and navigation patterns ## files - spec.md | Defines mobile-specific UI/UX requirements for responsive design, touch interactions, and navigation patterns ## arch -Specification-driven design documentation using markdown-based requirements specification +Specification-driven design documentation using markdown-based requirements specification pattern ## tags spec, defines, mobile, specific, requirements, responsive, design, touch ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md index fc02d1a..f86839c 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-app-usability/specs/mobile-session-management (index) -dir: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management +# 2026-05-25-mobile-app-usability/specs/mobile-session-management (index) +dir: 2026-05-25-mobile-app-usability/specs/mobile-session-management ## role -Defines UI/UX specifications for mobile session management features including touch-optimized interfaces and responsive design patterns. +Defines UI/UX specifications for a mobile-responsive session management interface. ## parent -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md index 57757ce..b89efbb 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-app-usability/specs/mobile-session-management -dir: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management +# 2026-05-25-mobile-app-usability/specs/mobile-session-management +dir: 2026-05-25-mobile-app-usability/specs/mobile-session-management -index: archive/2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/mobile-session-management/.pi-map.index.md ## role -Defines UI/UX specifications for mobile session management features including touch-optimized interfaces and responsive design patterns. +Defines UI/UX specifications for a mobile-responsive session management interface. ## files - spec.md | Specifies mobile-responsive UI requirements for a session management system including touch-optimized cards, creation flow, and list views. ## arch -Specification-driven design with mobile-first responsive patterns, touch-optimized card-based layouts, and structured user flow documentation for session creation and list interactions. +Specification-driven design with mobile-first responsive patterns and touch-optimized interaction flows. ## tags spec, specifies, mobile, responsive, requirements, session, management, system ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md index 379053d..d733768 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux (index) -dir: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux +# 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux (index) +dir: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux ## role Defines mobile-optimized interaction requirements for session management in a software specification document. ## parent -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md index 41081fe..c0fa04f 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux -dir: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux +# 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux +dir: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux -index: archive/2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/session-lifecycle-ux/.pi-map.index.md ## role Defines mobile-optimized interaction requirements for session management in a software specification document. ## files - spec.md | Defines mobile-optimized interaction requirements for session management in a software specification document. ## arch -Specification document following standard markdown documentation patterns for UX requirements. +Specification-driven design with user experience focus for mobile session lifecycle patterns. ## tags spec, defines, mobile, optimized, interaction, requirements, session, management ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md index fdc80e1..1130da4 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-app-usability/specs/tool-instances (index) -dir: archive/2026-05-25-mobile-app-usability/specs/tool-instances +# 2026-05-25-mobile-app-usability/specs/tool-instances (index) +dir: 2026-05-25-mobile-app-usability/specs/tool-instances ## role -Defines UI specifications for managing tool instances in a mobile-responsive interface +Defines mobile-responsive design specifications for the tool instance management user interface. ## parent -index: archive/2026-05-25-mobile-app-usability/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md -map: archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md +index: 2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md +map: 2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md index c7844fb..750f7aa 100644 --- a/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-app-usability/specs/tool-instances -dir: archive/2026-05-25-mobile-app-usability/specs/tool-instances +# 2026-05-25-mobile-app-usability/specs/tool-instances +dir: 2026-05-25-mobile-app-usability/specs/tool-instances -index: archive/2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md +index: 2026-05-25-mobile-app-usability/specs/tool-instances/.pi-map.index.md ## role -Defines UI specifications for managing tool instances in a mobile-responsive interface +Defines mobile-responsive design specifications for the tool instance management user interface. ## files - spec.md | Mobile responsive design requirements for instance management UI controls, status display, and creation forms ## arch -Specification-driven design with mobile-first responsive patterns for instance lifecycle management (creation, status display, controls) +Specification-driven design documentation with responsive UI patterns for mobile form controls and status displays. ## tags spec, mobile, responsive, design, requirements, instance, management, controls ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md index 99ec488..f56c94c 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-05-25-mobile-pages-overhaul (index) -dir: archive/2026-05-25-mobile-pages-overhaul +# 2026-05-25-mobile-pages-overhaul (index) +dir: 2026-05-25-mobile-pages-overhaul ## role -Archive of a completed mobile-first responsive UI overhaul project for three complex desktop split-pane interfaces. +Mobile-responsive UI overhaul package that adapts three complex desktop split-pane interfaces for mobile while preserving existing desktop experiences. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-05-25-mobile-pages-overhaul/specs - index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md - map: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +- 2026-05-25-mobile-pages-overhaul/specs + index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md + map: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.md index 75d1126..a476a32 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-05-25-mobile-pages-overhaul -dir: archive/2026-05-25-mobile-pages-overhaul +# 2026-05-25-mobile-pages-overhaul +dir: 2026-05-25-mobile-pages-overhaul -index: archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md +index: 2026-05-25-mobile-pages-overhaul/.pi-map.index.md ## role -Archive of a completed mobile-first responsive UI overhaul project for three complex desktop split-pane interfaces. +Mobile-responsive UI overhaul package that adapts three complex desktop split-pane interfaces for mobile while preserving existing desktop experiences. ## files - .openspec.yaml | Defines an OpenSpec configuration file specifying a spec-driven schema with a creation date. - design.md | Design document specifying mobile-first responsive UI adaptations for three desktop split-pane interfaces (Tool Workshop, Config Profiles, Repo Workspace) while preserving existing desktop experiences. - proposal.md | Proposes mobile-first redesigns for complex configuration and workspace pages while preserving existing desktop layouts - tasks.md | Project task checklist tracking mobile UI/UX implementation progress across navigation, list-detail views, tool workshop, config profiles, repo workspace, and testing ## arch -Specification-driven development using OpenSpec schema, design documents, and task-based project tracking with mobile-first responsive design pattern preserving desktop parity. +Specification-driven design with phased task execution, employing responsive mobile-first adaptation pattern that transforms desktop split-pane layouts into mobile-appropriate navigation and list-detail view patterns. ## tags design, mobile, desktop, workspace, configuration, specifying, .openspec, first ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md index 788ac77..b28e78d 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md @@ -1,28 +1,28 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs (index) -dir: archive/2026-05-25-mobile-pages-overhaul/specs +# 2026-05-25-mobile-pages-overhaul/specs (index) +dir: 2026-05-25-mobile-pages-overhaul/specs ## role -Contains specification documents for the mobile pages overhaul project dated 2026-05-25. +Contains specification documents for the 2026 mobile pages overhaul project. ## parent -index: archive/2026-05-25-mobile-pages-overhaul/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/.pi-map.md ## children -- archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail - index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md - map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md -- archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation - index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md - map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md -- archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace - index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md - map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md -- archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation - index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md - map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md +- 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail + index: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md + map: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md +- 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation + index: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md + map: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md +- 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace + index: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md + map: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md +- 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation + index: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md + map: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md ## files ## links -index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md index 0638557..d709834 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs -dir: archive/2026-05-25-mobile-pages-overhaul/specs +# 2026-05-25-mobile-pages-overhaul/specs +dir: 2026-05-25-mobile-pages-overhaul/specs -index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md ## role -Contains specification documents for the mobile pages overhaul project dated 2026-05-25. +Contains specification documents for the 2026 mobile pages overhaul project. ## files ## arch -N/A (no files present in directory) +Documentation-driven development with dated project milestones using flat file organization for requirements/specs. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md index 5269d42..978b279 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail (index) -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail +# 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail (index) +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail ## role -Defines detailed UI specifications for mobile list and detail views in a configuration management system overhaul. +Defines UI/UX specifications for mobile-responsive list and detail views in a configuration management system. ## parent -index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md index e51adaf..6107d01 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail +# 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-list-detail/.pi-map.index.md ## role -Defines detailed UI specifications for mobile list and detail views in a configuration management system overhaul. +Defines UI/UX specifications for mobile-responsive list and detail views in a configuration management system. ## files - spec.md | Defines mobile UI requirements for a configuration management system with list views, detail views, editing, and CRUD operations for tool types and config profiles. ## arch -Document-driven specification pattern using markdown-based requirements docs with no active code architecture. +Specification-driven design with feature-based organization, defining interaction patterns for master-detail navigation, CRUD flows, and responsive mobile interfaces. ## tags views, spec, defines, mobile, requirements, configuration, management, system ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md index 773e30e..d7dc588 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation (index) -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation +# 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation (index) +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation ## role -Defines functional requirements and interaction specifications for mobile bottom navigation with grouped menu items and expandable submenus. +Defines requirements for a grouped bottom navigation system with submenu behavior on mobile devices. ## parent -index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md index ee17d5e..808d4e4 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation +# 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-navigation/.pi-map.index.md ## role -Defines functional requirements and interaction specifications for mobile bottom navigation with grouped menu items and expandable submenus. +Defines requirements for a grouped bottom navigation system with submenu behavior on mobile devices. ## files - spec.md | Defines requirements for grouped bottom navigation with submenu behavior on mobile ## arch -Specification-driven design using markdown-based requirements documentation with behavioral specifications for UI component state transitions and touch interaction patterns. +Specification-driven design using a single markdown requirements document to capture mobile UX patterns for hierarchical navigation. ## tags spec, defines, requirements, grouped, bottom, navigation, submenu, behavior ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md index fa31131..11c17f5 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace (index) -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace +# 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace (index) +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace ## role -Defines UI specifications for a mobile repository workspace interface +Defines mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views ## parent -index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md index ee67ea9..c7eb69a 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace +# 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-repo-workspace/.pi-map.index.md ## role -Defines UI specifications for a mobile repository workspace interface +Defines mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views ## files - spec.md | Define mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views ## arch -Specification document architecture with view-based modular design for file tree, editor, git, and terminal components +Specification document using structured requirements format with feature decomposition into distinct functional views (file tree, editor, git, terminal) ## tags spec, define, mobile, requirements, repository, workspace, featuring, tree ## symbols diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md index b7c4d15..520b78b 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation (index) -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation +# 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation (index) +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation ## role -Defines UI specification for a grouped Tools navigation entry in mobile bottom navigation with expandable bottom sheet menu +Defines UX specifications for the mobile tools navigation component, including bottom sheet menu behavior and active state visualization. ## parent -index: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md -map: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md +map: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md index f95e9a8..04aa5a2 100644 --- a/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md +++ b/openspec/changes/archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation -dir: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation +# 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation +dir: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation -index: archive/2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md +index: 2026-05-25-mobile-pages-overhaul/specs/mobile-tools-navigation/.pi-map.index.md ## role -Defines UI specification for a grouped Tools navigation entry in mobile bottom navigation with expandable bottom sheet menu +Defines UX specifications for the mobile tools navigation component, including bottom sheet menu behavior and active state visualization. ## files - spec.md | Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication ## arch -Specification-driven design using markdown-based requirements documentation with behavioral state definitions (active/inactive) and interaction patterns (bottom sheet, grouped menu items) +Specification-driven design using markdown-based requirements documentation with behavioral state definitions (active/inactive) and interaction patterns (bottom sheet, grouped navigation items). ## tags bottom, spec, defines, mobile, requirements, grouped, tools, navigation ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md index 7ff86b3..8ef115b 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.index.md @@ -1,80 +1,80 @@ -# archive/2026-06-12-completed-changes-archive (index) -dir: archive/2026-06-12-completed-changes-archive +# 2026-06-12-completed-changes-archive (index) +dir: 2026-06-12-completed-changes-archive ## role -Stores historical records of fully implemented and audited OpenSpec changes for reference and audit trail purposes. +Historical archive documenting completed OpenSpec changes for audit and reference purposes. ## parent -index: archive/.pi-map.index.md -map: archive/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring - index: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md -- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts - index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md -- archive/2026-06-12-completed-changes-archive/config-profile-includes-ui - index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md -- archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts - index: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md -- archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts - index: archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md -- archive/2026-06-12-completed-changes-archive/container-monitoring-notifications - index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md -- archive/2026-06-12-completed-changes-archive/git-mount-url-validation - index: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md -- archive/2026-06-12-completed-changes-archive/home-path-expansion - index: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md -- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux - index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md -- archive/2026-06-12-completed-changes-archive/mount-specificity-ordering - index: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md -- archive/2026-06-12-completed-changes-archive/notification-center - index: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md -- archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions - index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md -- archive/2026-06-12-completed-changes-archive/session-list-overhaul - index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md -- archive/2026-06-12-completed-changes-archive/ssh-key-mounting - index: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md -- archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header - index: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md -- archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup - index: archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md -- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates - index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md -- archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux - index: archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md -- archive/2026-06-12-completed-changes-archive/reorganize-long-files - index: archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md -- archive/2026-06-12-completed-changes-archive/working-copies - index: archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md -- archive/2026-06-12-completed-changes-archive/workspace-first-ui - index: archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md +- 2026-06-12-completed-changes-archive/backend-frontend-refactoring + index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-directory-mounts + index: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-git-mounts + index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-includes-ui + index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts + index: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md +- 2026-06-12-completed-changes-archive/container-monitoring-notifications + index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md +- 2026-06-12-completed-changes-archive/git-mount-url-validation + index: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md +- 2026-06-12-completed-changes-archive/home-path-expansion + index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md +- 2026-06-12-completed-changes-archive/mobile-terminal-ux + index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md +- 2026-06-12-completed-changes-archive/mount-specificity-ordering + index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md +- 2026-06-12-completed-changes-archive/multi-session-terminal-ux + index: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md +- 2026-06-12-completed-changes-archive/notification-center + index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/notification-center/.pi-map.md +- 2026-06-12-completed-changes-archive/persistent-terminal-sessions + index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md +- 2026-06-12-completed-changes-archive/reorganize-long-files + index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md +- 2026-06-12-completed-changes-archive/session-list-overhaul + index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md +- 2026-06-12-completed-changes-archive/ssh-key-mounting + index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md +- 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header + index: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md +- 2026-06-12-completed-changes-archive/tool-config-mount-cleanup + index: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md +- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates + index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md +- 2026-06-12-completed-changes-archive/working-copies + index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/working-copies/.pi-map.md +- 2026-06-12-completed-changes-archive/workspace-first-ui + index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md ## files - README.md ## links -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md index 67896ac..96c5595 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/.pi-map.md @@ -1,22 +1,16 @@ -# archive/2026-06-12-completed-changes-archive -dir: archive/2026-06-12-completed-changes-archive +# 2026-06-12-completed-changes-archive +dir: 2026-06-12-completed-changes-archive -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md ## role -Stores historical records of fully implemented and audited OpenSpec changes for reference and audit trail purposes. +Historical archive documenting completed OpenSpec changes for audit and reference purposes. ## files -- README.md | Documents archived completed OpenSpec changes that have been audited and confirmed as fully implemented -- config-profile-directory-mounts | Completed OpenSpec change for directory-level config profile mounts -- multi-session-terminal-ux | Completed OpenSpec change for multi-session terminal UX -- reorganize-long-files | Completed OpenSpec change for reorganizing long files -- tool-config-mount-cleanup | Completed OpenSpec change for cleaning up built-in tool config/state mounts -- working-copies | Completed OpenSpec change for workspace-first working copies -- workspace-first-ui | Completed OpenSpec change for workspace-first UI +- README.md | Documents a historical archive of 17 fully implemented OpenSpec changes that have been audited against the source tree ## arch -Simple flat-file archive using date-based directory naming and markdown documentation for immutable change tracking. +Simple documentation-based archive pattern with no active code, serving as immutable change log for compliance tracking. ## tags -readme, documents, archived, completed, openspec, changes, have, been +readme, documents, historical, archive, fully, implemented, openspec, changes ## symbols - ## workflows diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md index a715174..cf45b18 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring (index) -dir: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring +# 2026-06-12-completed-changes-archive/backend-frontend-refactoring (index) +dir: 2026-06-12-completed-changes-archive/backend-frontend-refactoring ## role -This package serves as a completed historical archive of a structural refactoring initiative to decompose monolithic backend/frontend code into domain-based modular subpackages without changing behavior or API contracts. +This package serves as an archived planning and specification artifact for a completed structural refactoring that decomposed a monolithic Python/FastAPI backend and TypeScript frontend into domain-based modular subpackages. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -15,8 +15,8 @@ map: archive/2026-06-12-completed-changes-archive/.pi-map.md - spec.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md +index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md index d4b69af..9d4ca98 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring -dir: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring +# 2026-06-12-completed-changes-archive/backend-frontend-refactoring +dir: 2026-06-12-completed-changes-archive/backend-frontend-refactoring -index: archive/2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/backend-frontend-refactoring/.pi-map.index.md ## role -This package serves as a completed historical archive of a structural refactoring initiative to decompose monolithic backend/frontend code into domain-based modular subpackages without changing behavior or API contracts. +This package serves as an archived planning and specification artifact for a completed structural refactoring that decomposed a monolithic Python/FastAPI backend and TypeScript frontend into domain-based modular subpackages. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Architecture design document for a large-scale backend/frontend refactoring to decompose monolithic modules into domain-based subpackages while preserving API contracts and behavior | dep: FastAPI, Pydantic, SQLAlchemy, Docker, cloudflared, React/TypeScript @@ -12,7 +12,7 @@ This package serves as a completed historical archive of a structural refactorin - spec.md | Defines a pure structural refactoring specification for extracting schemas, splitting monolithic services, reorganizing frontend features, and standardizing naming conventions without changing any behavior or API contracts. | dep: Pydantic, FastAPI (implied by Depends, API routers), SQLAlchemy AsyncSession, React/TypeScript frontend, Docker, ruff, npm - tasks.md | Defines a multi-phase refactoring plan to reorganize a Python/FastAPI backend and TypeScript frontend codebase into modular subpackages with verification steps | dep: FastAPI, Docker, pytest, ruff, py_compile, npm, TypeScript, React Router ## arch -Documentation-driven refactoring architecture using phased planning (proposal → design → spec → tasks) with OpenSpec schema validation, emphasizing pure structural changes with zero behavioral modification and comprehensive verification steps. +Document-driven waterfall planning architecture using OpenSpec schema configuration, multi-phase task breakdown (design → proposal → specification → implementation), and strict behavior-preserving refactoring patterns with API contract immutability and verification gates. ## tags frontend, refactoring, defines, design, backend, monolithic, behavior, fastapi ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md index d29ca8e..b740c49 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md @@ -1,24 +1,11 @@ -# . (index) -dir: . - -## Project Map Protocol - -1. Read this protocol and the root `.pi-map.index.md` first. -2. Use `index:` / `map:` references to open relevant directory indexes and maps. -3. Load indexes before rich maps during task-start navigation. -4. Read the local rich map and actual source before editing. -5. Treat non-empty `## dirty` sections in either artifact as stale. -6. If source and generated artifacts disagree, trust source. -7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. -8. After editing source, run `project_map_patch` for each changed file. -9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. - -Trust boundary: index routes, map orients, source decides. +# 2026-06-12-completed-changes-archive/config-profile-directory-mounts (index) +dir: 2026-06-12-completed-changes-archive/config-profile-directory-mounts ## role -Provides configuration and documentation for a mount staging system that resolves file ownership issues in containerized environments. +Archives a completed configuration profile refactoring that fixes root-owned directory mount issues by staging and bind-mounting entire directories. ## parent -- +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -26,8 +13,8 @@ Provides configuration and documentation for a mount staging system that resolve - proposal.md - tasks.md ## links -index: ./.pi-map.index.md -map: ./.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md index 78f6710..8f8a489 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.md @@ -1,30 +1,16 @@ -# . -dir: . +# 2026-06-12-completed-changes-archive/config-profile-directory-mounts +dir: 2026-06-12-completed-changes-archive/config-profile-directory-mounts -index: ./.pi-map.index.md - -## Project Map Protocol - -1. Read this protocol and the root `.pi-map.index.md` first. -2. Use `index:` / `map:` references to open relevant directory indexes and maps. -3. Load indexes before rich maps during task-start navigation. -4. Read the local rich map and actual source before editing. -5. Treat non-empty `## dirty` sections in either artifact as stale. -6. If source and generated artifacts disagree, trust source. -7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. -8. After editing source, run `project_map_patch` for each changed file. -9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. - -Trust boundary: index routes, map orients, source decides. +index: 2026-06-12-completed-changes-archive/config-profile-directory-mounts/.pi-map.index.md ## role -Provides configuration and documentation for a mount staging system that resolves file ownership issues in containerized environments. +Archives a completed configuration profile refactoring that fixes root-owned directory mount issues by staging and bind-mounting entire directories. ## files - .openspec.yaml | Defines an OpenSpec configuration profile for directory mounts with completion tracking metadata - proposal.md | Proposes a design change to fix root-owned directory issues in config profile mounts by staging and bind-mounting entire directories instead of individual files. | dep: Docker, config_profile_resolver.py, test_config_profile_resolver.py - tasks.md | Tracks completed development tasks for refactoring a mount staging system and running quality gates. ## arch -Configuration-driven design using YAML profiles for directory mounts, with a proposal-based development approach documenting a shift from file-level to directory-level bind-mount staging. +Documentation-driven change proposal with OpenSpec configuration, using a task-tracked implementation workflow for filesystem mount refactoring. ## tags tasks, profile, directory, mounts, .openspec, staging, py, proposal ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md index 2c14a9c..962c1d3 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts +# 2026-06-12-completed-changes-archive/config-profile-git-mounts (index) +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts ## role -Archive of completed work for adding git repository mount support to config profiles for version-controlled dotfiles in containers. +Archive of completed work for adding git repository mount support to config profiles, enabling version-controlled dotfiles in containers. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs - index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs + index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md index 2c535d9..d17e71e 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts +# 2026-06-12-completed-changes-archive/config-profile-git-mounts +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md ## role -Archive of completed work for adding git repository mount support to config profiles for version-controlled dotfiles in containers. +Archive of completed work for adding git repository mount support to config profiles, enabling version-controlled dotfiles in containers. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema type and creation date metadata - design.md | Design document for adding git repository mount support to config profiles in a container management system | dep: ConfigProfile, git repositories, clone service, instance startup, Docker/volume mounts, database/JSONB - proposal.md | Proposes adding git repository mounts to config profiles for version-controlled dotfiles in containers | dep: config profiles, git repositories, docker/container startup, database migrations, frontend UI/API - tasks.md | A completed task checklist for implementing git repository mount functionality across database models, backend API, frontend UI, and documentation | dep: Alembic, SQLAlchemy, Pydantic, FastAPI, TypeScript, Docker Compose, git clone service ## arch -Design-driven feature implementation with proposal/design/task phases, covering full stack changes (database models, backend API, frontend UI, documentation) and OpenSpec configuration schema. +Design-driven feature implementation using proposal/design/task documentation hierarchy, with cross-stack changes spanning database models, backend API, frontend UI, and documentation. ## tags design, git, repository, .openspec, adding, mount, config, profiles ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md index ec4dd5b..93b783e 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md @@ -1,22 +1,22 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs +# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs (index) +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs ## role -Contains archived specification documents for a configuration profile feature that manages Git repository mounts, preserved as a historical snapshot from June 12, 2026. +Contains specification files defining configuration requirements and validation rules for git repository mount profiles. ## parent -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts - index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md -- archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances - index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts + index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances + index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md ## files ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md index 6300902..5b3e2d3 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs +# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md ## role -Contains archived specification documents for a configuration profile feature that manages Git repository mounts, preserved as a historical snapshot from June 12, 2026. +Contains specification files defining configuration requirements and validation rules for git repository mount profiles. ## files ## arch -Flat directory structure storing archived specification files with no active code, serving as a read-only reference for completed system changes. +Declarative specification pattern using structured config files (likely JSON/YAML) to define mount schemas, with separation of concerns between profile definitions and their operational implementation. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md index 0e1159e..f386404 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts +# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts (index) +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts ## role -Defines requirements for mounting git repositories into containers via configuration profiles, enabling version-controlled configuration and content injection. +Defines requirements for mounting git repositories into containers via configuration profiles. ## parent -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md index 81bd21b..d9668c9 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts +# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/config-profile-git-mounts/.pi-map.index.md ## role -Defines requirements for mounting git repositories into containers via configuration profiles, enabling version-controlled configuration and content injection. +Defines requirements for mounting git repositories into containers via configuration profiles. ## files - spec.md | Defines requirements for adding git repository mounting capabilities to config profiles in a container management system | dep: git, container runtime, config profile system, UI/profile editor ## arch -Specification-driven requirements document using structured markdown with sections for overview, requirements, and use cases, serving as a design contract for a container platform feature. +Specification-driven requirements document using markdown-based technical specification pattern. ## tags git, spec, defines, requirements, adding, repository, mounting, capabilities ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md index 1c2e011..13d7f49 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances +# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances (index) +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances ## role -Defines requirements for git repository mount processing during tool instance startup. +Defines requirements for git repository mounting behavior during tool instance startup. ## parent -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md index dc0f276..8da55bf 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances -dir: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances +# 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances +dir: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances -index: archive/2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-git-mounts/specs/tool-instances/.pi-map.index.md ## role -Defines requirements for git repository mount processing during tool instance startup. +Defines requirements for git repository mounting behavior during tool instance startup. ## files - spec.md | Defines requirements for git repository mount processing during tool instance startup, including config profile resolution, bind mount creation, auto-cloning, and failure handling. ## arch -Specification-driven requirements document using markdown-based technical specification pattern. +Specification-driven requirements document using plain markdown with no code implementation or architectural patterns. ## tags mount, spec, defines, requirements, git, repository, processing, tool ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md index 00149d4..25b7e2b 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui +# 2026-06-12-completed-changes-archive/config-profile-includes-ui (index) +dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui ## role -Archive of a completed frontend UI feature for drag-and-drop management of config profile includes with dependency visualization and cycle detection. +Archive of completed UI work for drag-and-drop config profile includes management with cycle detection and scope visualization. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs - index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs + index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md index bb75e7e..69fee77 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui -dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui +# 2026-06-12-completed-changes-archive/config-profile-includes-ui +dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md ## role -Archive of a completed frontend UI feature for drag-and-drop management of config profile includes with dependency visualization and cycle detection. +Archive of completed UI work for drag-and-drop config profile includes management with cycle detection and scope visualization. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata - design.md | Design document for adding drag-and-drop profile includes management UI to an existing config profile editor frontend | dep: React, HTML5 Drag and Drop API, config profiles backend API (listConfigProfiles, updateConfigProfile, updateProfileIncludes), existing scope badge components - proposal.md | Proposes a UI feature for drag-and-drop management of ordered config profile includes with cycle detection and scope visualization | dep: config profiles backend API, frontend React app, drag-and-drop library - tasks.md | Task tracking document for implementing a profile "includes" feature with UI, drag-and-drop reordering, and error handling ## arch -Design-proposal-task documentation trail with OpenSpec schema metadata, capturing iterative specification of a React/Vue-like component-based UI with topological ordering constraints and visual dependency graph rendering. +Design-driven feature development with phased task tracking, using OpenSpec schema validation and explicit frontend/UX architecture documentation. ## tags drag, profile, design, drop, includes, .openspec, document, management ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md index 900f176..73dca3f 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs +# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs (index) +dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs ## role -Contains archived specification documents for the config-profile-includes-ui feature from a completed changeset dated June 12, 2026. +Contains archived specification documents for the config-profile-includes-ui feature that was completed on 2026-06-12. ## parent -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management - index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md +- 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management + index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md ## files ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md index a4e93ea..8b822cc 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs -dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs +# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs +dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md ## role -Contains archived specification documents for the config-profile-includes-ui feature from a completed changeset dated June 12, 2026. +Contains archived specification documents for the config-profile-includes-ui feature that was completed on 2026-06-12. ## files ## arch -N/A (empty directory - no code or architectural patterns present; intended as historical documentation storage for completed UI specifications) +Document-based specification storage with date-versioned archiving pattern for completed feature requirements. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md index f30e0aa..368789e 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management +# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management (index) +dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management ## role -Defines requirements for a UI feature that allows users to manage which configuration profiles are included in another profile. +Defines requirements for a config profile editor feature that enables users to view, modify, and persist profile include configurations through a management UI. ## parent -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md index 13e84f2..d37e3cd 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management -dir: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management +# 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management +dir: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management -index: archive/2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-includes-ui/specs/config-profile-includes-management/.pi-map.index.md ## role -Defines requirements for a UI feature that allows users to manage which configuration profiles are included in another profile. +Defines requirements for a config profile editor feature that enables users to view, modify, and persist profile include configurations through a management UI. ## files - spec.md | Define requirements for a config profile editor feature that manages profile includes with display, add/remove/reorder functionality, and save capabilities | dep: profile editor UI, includes API, profile update API, dropdown component, drag-and-drop system ## arch -Specification-driven requirements document using Markdown format with user stories, acceptance criteria, and UI/UX details for a CRUD+reorder management interface. +Requirements specification using structured documentation pattern with functional requirements organized by user interaction flows (display, add/remove, reorder, save) and explicit UI/UX constraints. ## tags profile, spec, define, requirements, config, editor, feature, manages ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md index 89b3bf8..c73be0a 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts (index) -dir: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts +# 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts (index) +dir: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts ## role -Preserves the completed feature specification for multi-repo mount configuration in Config Profiles as a historical archive record. +Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount entry. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files - .openspec.yaml ## links -index: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md +index: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md index 10a7709..57f6a16 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts -dir: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts +# 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts +dir: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts -index: archive/2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/config-profile-multi-repo-mounts/.pi-map.index.md ## role -Preserves the completed feature specification for multi-repo mount configuration in Config Profiles as a historical archive record. +Archives a completed feature specification for extending Config Profiles to support multiple source/target path mappings within a single git repository mount entry. ## files - .openspec.yaml | Define a completed feature specification for enabling multiple source/target mappings per git mount entry in Config Profiles with single repository cloning ## arch -Specification-as-Archive pattern using OpenSpec YAML format to document finalized feature requirements outside active codebase. +Specification-as-code pattern using OpenSpec YAML for formal feature documentation and change tracking in a dated archive directory structure. ## tags .openspec, define, completed, feature, specification, enabling, multiple, source ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md index 74703f0..088bb28 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-completed-changes-archive/container-monitoring-notifications (index) -dir: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications +# 2026-06-12-completed-changes-archive/container-monitoring-notifications (index) +dir: 2026-06-12-completed-changes-archive/container-monitoring-notifications ## role -Archive of completed design, specification, and implementation documentation for a real-time container monitoring and notification system that replaced polling with Server-Sent Events. +Implements a real-time container monitoring and notification system that streams lifecycle events and health status from backend to frontend via SSE, replacing polling with instant visibility into container failures. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -20,8 +20,8 @@ map: archive/2026-06-12-completed-changes-archive/.pi-map.md - spec.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md +index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md index 86dd732..0fe8f7b 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-06-12-completed-changes-archive/container-monitoring-notifications -dir: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications +# 2026-06-12-completed-changes-archive/container-monitoring-notifications +dir: 2026-06-12-completed-changes-archive/container-monitoring-notifications -index: archive/2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/container-monitoring-notifications/.pi-map.index.md ## role -Archive of completed design, specification, and implementation documentation for a real-time container monitoring and notification system that replaced polling with Server-Sent Events. +Implements a real-time container monitoring and notification system that streams lifecycle events and health status from backend to frontend via SSE, replacing polling with instant visibility into container failures. ## files - .openspec.yaml | Defines an OpenSpec project specification for a container monitoring and notification system - apply-pr1.md | Documents the implementation of a backend core for container monitoring and notifications, including database migrations, SQLAlchemy models, event bus, health monitoring, SSE endpoint, lifecycle hooks, structured logging, and unit tests. | dep: SQLAlchemy, Alembic, FastAPI, asyncio, uvicorn, pytest, ruff, Docker, JSON @@ -17,7 +17,7 @@ Archive of completed design, specification, and implementation documentation for - spec.md | Specifies a container monitoring and notification system using an in-memory event bus, background health monitor, SSE streaming, and frontend toast notifications with persistent audit logging. | dep: asyncio, PostgreSQL, Docker CLI, HTTP/tunnel, SSE/Server-Sent Events, JWT/cookie auth, JSON logging - tasks.md | Defines a detailed software development plan for building a container monitoring and notification system across backend and frontend, broken into chained PRs with specific tasks, acceptance criteria, and dependencies. | dep: FastAPI, SQLAlchemy, Alembic, Docker, asyncio, SSE/EventSource, React, sonner, pytest ## arch -Event-driven architecture using in-memory pub/sub EventBus, background health polling with SQLAlchemy persistence, SSE streaming from FastAPI backend, and frontend toast notifications; implemented via 3 chained PRs with structured logging, audit trails, and comprehensive test coverage. +Event-driven architecture with in-memory pub/sub EventBus, background health polling, Server-Sent Events streaming from FastAPI backend, and frontend toast notification UI; implemented across chained PRs with SQLAlchemy models, structured logging, and persistent audit logging. ## tags sse, container, monitoring, system, apply, notifications, fastapi, asyncio ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md index e0025bb..d45cb88 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/git-mount-url-validation (index) -dir: archive/2026-06-12-completed-changes-archive/git-mount-url-validation +# 2026-06-12-completed-changes-archive/git-mount-url-validation (index) +dir: 2026-06-12-completed-changes-archive/git-mount-url-validation ## role -Preserves the historical specification for a completed git mount URL validation feature as an archived OpenSpec artifact. +Archives the completed specification for a git mount URL validation feature that was implemented as a high-priority item. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files - .openspec.yaml ## links -index: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md +index: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md index d77d4e0..8433f91 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/git-mount-url-validation -dir: archive/2026-06-12-completed-changes-archive/git-mount-url-validation +# 2026-06-12-completed-changes-archive/git-mount-url-validation +dir: 2026-06-12-completed-changes-archive/git-mount-url-validation -index: archive/2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/git-mount-url-validation/.pi-map.index.md ## role -Preserves the historical specification for a completed git mount URL validation feature as an archived OpenSpec artifact. +Archives the completed specification for a git mount URL validation feature that was implemented as a high-priority item. ## files - .openspec.yaml | Defines an OpenSpec specification for a completed high-priority feature named "git-mount-url-validation" ## arch -Simple archive pattern using dated directory structure with YAML-based specification storage for completed feature tracking. +Specification-as-code pattern using OpenSpec YAML format for feature documentation and archival. ## tags .openspec, defines, openspec, specification, completed, high, priority, feature ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md index badb9ce..503f70b 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/home-path-expansion (index) -dir: archive/2026-06-12-completed-changes-archive/home-path-expansion +# 2026-06-12-completed-changes-archive/home-path-expansion (index) +dir: 2026-06-12-completed-changes-archive/home-path-expansion ## role -Preserves a completed feature specification for home directory path expansion in container mount targets. +Archive of a completed feature specification for home directory path expansion in container mount targets. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files - .openspec.yaml ## links -index: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md +index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md index 230f3f5..f61c6a3 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/home-path-expansion -dir: archive/2026-06-12-completed-changes-archive/home-path-expansion +# 2026-06-12-completed-changes-archive/home-path-expansion +dir: 2026-06-12-completed-changes-archive/home-path-expansion -index: archive/2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/home-path-expansion/.pi-map.index.md ## role -Preserves a completed feature specification for home directory path expansion in container mount targets. +Archive of a completed feature specification for home directory path expansion in container mount targets. ## files - .openspec.yaml | Defines a completed feature specification for resolving home directory path expansion (~ and $HOME) in container mount target paths based on manifest user configuration. ## arch -Specification-as-archive pattern using YAML-based feature documentation for completed work. +Specification-driven change documentation using OpenSpec YAML format for tracking completed feature implementations. ## tags home, .openspec, defines, completed, feature, specification, resolving, directory ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md index a87295b..73e2a3a 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux (index) -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux +# 2026-06-12-completed-changes-archive/mobile-terminal-ux (index) +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux ## role -Contains archived design documents and planning artifacts for a mobile-friendly web terminal UX enhancement that was completed on 2026-06-12. +Archives the completed mobile terminal UX redesign that enables web-based terminal usage on mobile devices through virtual keyboard handling, viewport optimization, and touch-friendly controls without external dependencies. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs - index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md +- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs + index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md index 4e773ab..674b789 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux +# 2026-06-12-completed-changes-archive/mobile-terminal-ux +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md ## role -Contains archived design documents and planning artifacts for a mobile-friendly web terminal UX enhancement that was completed on 2026-06-12. +Archives the completed mobile terminal UX redesign that enables web-based terminal usage on mobile devices through virtual keyboard handling, viewport optimization, and touch-friendly controls without external dependencies. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata - design.md | Design document for making a web-based terminal mobile-friendly by addressing virtual keyboard handling, maximizing screen real estate, and providing special key access without adding new dependencies. | dep: React, xterm.js, browser APIs (Visual Viewport API, Clipboard API, WebSocket) - proposal.md | Proposes a mobile-optimized terminal interface with special keys toolbar, dynamic viewport handling, and touch gestures to make terminal sessions usable on mobile devices. | dep: xterm.js, React, visualViewport API - tasks.md | Task tracking checklist for implementing a mobile-responsive terminal interface with WebSocket connectivity, touch-friendly controls, and virtual keyboard handling. | dep: React, Visual Viewport API, WebSocket, Visibility API, localStorage, CSS transitions, npm ## arch -Documentation-driven specification pattern using OpenSpec schema with phased design-proposal-tasks workflow covering viewport management, touch gesture handling, and zero-dependency progressive enhancement. +Documentation-driven specification with OpenSpec schema validation, structured design/proposal/task artifacts, and WebSocket-based real-time terminal connectivity with pure CSS/JavaScript touch gesture handling. ## tags terminal, mobile, design, handling, react, .openspec, friendly, virtual ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md index 25d8ef6..a30f253 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md @@ -1,25 +1,25 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs (index) -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs (index) +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs ## role -Contains archived mobile terminal user experience specification documents from a completed project snapshot dated June 12, 2026. +Contains archived mobile terminal user experience specifications from a completed June 2026 project phase. ## parent -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation - index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md -- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux - index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md -- archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal - index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md +- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation + index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md +- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux + index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md +- 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal + index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md ## files ## links -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md index 2371c26..e8c76eb 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md ## role -Contains archived mobile terminal user experience specification documents from a completed project snapshot dated June 12, 2026. +Contains archived mobile terminal user experience specifications from a completed June 2026 project phase. ## files ## arch -Document archive storage with date-based versioning and hierarchical categorization (mobile-terminal-ux/specs) for historical reference and audit trail preservation. +Document-based specification storage with date-versioned archival structure for historical reference. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md index f8ce43b..445d127 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation (index) -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation (index) +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation ## role -Defines frontend foundation specifications for responsive application layouts with desktop/mobile adaptations and mobile terminal-specific minimal headers. +Defines frontend UI requirements for responsive layout components with mobile/desktop adaptations and specialized mobile terminal headers. ## parent -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md index 8ebc9da..b219ccf 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/frontend-foundation/.pi-map.index.md ## role -Defines frontend foundation specifications for responsive application layouts with desktop/mobile adaptations and mobile terminal-specific minimal headers. +Defines frontend UI requirements for responsive layout components with mobile/desktop adaptations and specialized mobile terminal headers. ## files - spec.md | Defines modified requirements for a responsive application layout component with desktop/mobile adaptations and a specialized minimal header for mobile terminal pages. ## arch -Requirements-driven specification pattern with responsive design breakpoints, device-specific component variants, and conditional rendering logic for mobile terminal contexts. +Specification-driven design with responsive breakpoint patterns, conditional rendering strategies, and mobile-first progressive enhancement. ## tags mobile, spec, defines, modified, requirements, responsive, application, layout ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md index 959c844..2ab9b1b 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux (index) -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux (index) +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux ## role -Defines UI/UX specifications for mobile terminal interface ensuring responsive, touch-friendly terminal experience on mobile devices. +Defines UI/UX specifications for a web-based mobile terminal interface with responsive design, touch interactions, and accessibility features. ## parent -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md index 8f7e538..7e8ab87 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/mobile-terminal-ux/.pi-map.index.md ## role -Defines UI/UX specifications for mobile terminal interface ensuring responsive, touch-friendly terminal experience on mobile devices. +Defines UI/UX specifications for a web-based mobile terminal interface with responsive design, touch interactions, and accessibility features. ## files - spec.md | Specifies mobile terminal UI/UX requirements including responsive layout, special keys toolbar, virtual keyboard handling, touch gestures, screen orientation, copy/paste, and font scaling for a web-based terminal application. | dep: WebSocket, xterm.js, Visual Viewport API, localStorage ## arch -Specification-driven design with requirements documentation pattern covering layout, input methods, gestures, and accessibility concerns for cross-platform mobile web terminal. +Specification-driven design using requirements documents to define cross-platform mobile terminal behavior without implementation code. ## tags terminal, spec, specifies, mobile, requirements, including, responsive, layout ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md index a73f475..f29fdd5 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal (index) -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal (index) +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal ## role -Defines functional and UX requirements for a mobile-optimized terminal interface with touch-native interactions and adaptive responsive design. +Defines functional and UX requirements for a touch-optimized mobile terminal interface using WebSocket communication ## parent -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md index 0e58560..be132bb 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal -dir: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal +# 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal +dir: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal -index: archive/2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/mobile-terminal-ux/specs/tool-terminal/.pi-map.index.md ## role -Defines functional and UX requirements for a mobile-optimized terminal interface with touch-native interactions and adaptive responsive design. +Defines functional and UX requirements for a touch-optimized mobile terminal interface using WebSocket communication ## files - spec.md | Specifies requirements for a mobile-responsive WebSocket terminal application with touch gestures, special keys, and adaptive layout | dep: xterm.js, WebSocket, browser clipboard API, localStorage, viewport meta tag ## arch -Specification-driven requirements document using structured markdown with sections for features, gestures, layout modes, and special key handling; no implementation code present. +Specification-driven design with mobile-first responsive layout, gesture-based interaction patterns, and adaptive UI for varying screen sizes/orientations ## tags websocket, spec, specifies, requirements, mobile, responsive, terminal, application ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md index e4ec292..dea344f 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/mount-specificity-ordering (index) -dir: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering +# 2026-06-12-completed-changes-archive/mount-specificity-ordering (index) +dir: 2026-06-12-completed-changes-archive/mount-specificity-ordering ## role -Archives the completed specification for a mount specificity ordering fix that was implemented as a high-priority change. +Archives a completed specification for fixing mount specificity ordering behavior in the system. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files - .openspec.yaml ## links -index: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md +index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md index 2cfb620..446b84d 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/mount-specificity-ordering -dir: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering +# 2026-06-12-completed-changes-archive/mount-specificity-ordering +dir: 2026-06-12-completed-changes-archive/mount-specificity-ordering -index: archive/2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/mount-specificity-ordering/.pi-map.index.md ## role -Archives the completed specification for a mount specificity ordering fix that was implemented as a high-priority change. +Archives a completed specification for fixing mount specificity ordering behavior in the system. ## files - .openspec.yaml | Defines an OpenSpec specification for a completed high-priority fix related to mount specificity ordering ## arch -Simple archival storage pattern using date-prefixed directory structure with YAML-based OpenSpec specification files for tracking completed changes. +Simple documentation archive using OpenSpec YAML format with no active code or runtime components. ## tags .openspec, defines, openspec, specification, completed, high, priority, fix ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md index ca79b97..8819587 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-active-changes-archive/multi-session-terminal-ux (index) -dir: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux +# 2026-06-12-completed-changes-archive/multi-session-terminal-ux (index) +dir: 2026-06-12-completed-changes-archive/multi-session-terminal-ux ## role -Archive of design documents and implementation plans for adding multi-session terminal UX support to a tool instance platform, preserving historical decision-making and phased development records. +Archive of completed design documents and implementation specifications for adding multi-session terminal support to an existing tool instance platform. ## parent -index: archive/2026-06-12-active-changes-archive/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -18,8 +18,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.md +index: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md index 8fddddd..f48779f 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-06-12-active-changes-archive/multi-session-terminal-ux -dir: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux +# 2026-06-12-completed-changes-archive/multi-session-terminal-ux +dir: 2026-06-12-completed-changes-archive/multi-session-terminal-ux -index: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md ## role -Archive of design documents and implementation plans for adding multi-session terminal UX support to a tool instance platform, preserving historical decision-making and phased development records. +Archive of completed design documents and implementation specifications for adding multi-session terminal support to an existing tool instance platform. ## files - .openspec.yaml | Defines metadata for a completed project specification named "multi-session-terminal-ux" - apply-pr1.md | Documents the implementation of database schema, Alembic migration, and TerminalManager multi-session core for a multi-session terminal UX feature. | dep: Alembic, SQLAlchemy, aiosqlite, asyncio, pytest, TerminalSession, TerminalManager, UUIDPrimaryKeyMixin, TimestampMixin, SessionLocal @@ -15,7 +15,7 @@ Archive of design documents and implementation plans for adding multi-session te - proposal.md | Proposes architectural changes to support multiple concurrent terminal sessions per tool instance with improved UI/UX features | dep: TerminalManager, TerminalSession, api/terminal.py, TerminalComponent, terminal.tsx, WebSocket protocol, database schema - tasks.md | A software design document specifying 12 implementation tasks for adding multi-session terminal UX support across backend (Python/FastAPI) and frontend (React/TypeScript) with detailed acceptance criteria, file changes, and TDD testing steps. | dep: Alembic, FastAPI, WebSocket, React, TypeScript, xterm.js (implied), pytest, Jest/npm test ## arch -Specification-driven development with phased PR documentation (backend schema/migrations → API/WebSocket/frontend hooks → UI components), using FastAPI/Python backend with Alembic migrations, React/TypeScript frontend, WebSocket protocol, and TDD acceptance criteria across 12 structured implementation tasks. +Design-driven development with phased PR implementation (backend core → API/WebSocket → frontend UI), using FastAPI/WebSocket backend and React/TypeScript frontend, with explicit architectural exploration and task breakdown before coding. ## tags terminal, session, multi, apply, implementation, alembic, websocket, support ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md index 61b9939..ac0d868 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-completed-changes-archive/notification-center (index) -dir: archive/2026-06-12-completed-changes-archive/notification-center +# 2026-06-12-completed-changes-archive/notification-center (index) +dir: 2026-06-12-completed-changes-archive/notification-center ## role -Archive directory preserving the complete design, specification, and implementation history of a full-stack Notification Center feature that added persistent user-scoped notifications to replace ephemeral toast-only alerts. +Archive of completed implementation artifacts for a full-stack Notification Center feature that added persistent, user-scoped notifications with REST API, React frontend, and toast coordination to an existing application. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -21,8 +21,8 @@ map: archive/2026-06-12-completed-changes-archive/.pi-map.md - spec.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md +index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/notification-center/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md index c92aae7..56fdf31 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-06-12-completed-changes-archive/notification-center -dir: archive/2026-06-12-completed-changes-archive/notification-center +# 2026-06-12-completed-changes-archive/notification-center +dir: 2026-06-12-completed-changes-archive/notification-center -index: archive/2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/notification-center/.pi-map.index.md ## role -Archive directory preserving the complete design, specification, and implementation history of a full-stack Notification Center feature that added persistent user-scoped notifications to replace ephemeral toast-only alerts. +Archive of completed implementation artifacts for a full-stack Notification Center feature that added persistent, user-scoped notifications with REST API, React frontend, and toast coordination to an existing application. ## files - .openspec.yaml | Defines an OpenAPI specification metadata file for a notification center service - apply-pr1.md | Documents the implementation, testing, and validation of a backend notification center system for a FastAPI/SQLAlchemy application. | dep: FastAPI, SQLAlchemy, Alembic, Pydantic, pytest, ruff, SQLite/PostgreSQL @@ -18,7 +18,7 @@ Archive directory preserving the complete design, specification, and implementat - spec.md | Defines a full-stack notification center system with per-user persistent notifications, REST API, frontend UI, and user-scoped preferences for category muting and toast suppression. | dep: FastAPI, SQLAlchemy, Alembic, PostgreSQL, React/frontend, SSE/EventToastBridge, Phosphor icons, UserConfig, lifecycle_hooks, health_monitor - tasks.md | Defines a detailed task breakdown for implementing a Notification Center feature across 4 stacked PRs, covering backend core, backend integration, frontend core, and toast coordination with specific acceptance criteria, dependencies, and effort estimates. | dep: Alembic, SQLAlchemy, FastAPI, Pydantic, pytest, SQLite/PostgreSQL, AsyncSession, UUIDPrimaryKeyMixin, UserConfig, lifecycle_hooks, health_monitor, InstanceEventBus ## arch -Document-driven phased implementation using stacked PRs (4 sequential PRs) with TDD validation, cross-cutting FastAPI/SQLAlchemy backend and React frontend, OpenAPI-specified REST API, and event-driven integration with existing toast notification system. +Phased TDD-driven implementation across 4 stacked PRs (backend core → backend integration → frontend core → toast coordination) using FastAPI/SQLAlchemy backend, React/TypeScript frontend, OpenAPI specs, and comprehensive design documentation with acceptance criteria. ## tags notification, react, center, apply, fastapi, sqlalchemy, alembic, user ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md index ce169e8..4de1e29 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions (index) -dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions +# 2026-06-12-completed-changes-archive/persistent-terminal-sessions (index) +dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions ## role -Implements persistent terminal sessions that survive WebSocket disconnections and reconnect to existing docker exec processes rather than spawning new ones. +Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs - index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md +- 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs + index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md index fe0e52d..9ed16c6 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions -dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions +# 2026-06-12-completed-changes-archive/persistent-terminal-sessions +dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md ## role -Implements persistent terminal sessions that survive WebSocket disconnections and reconnect to existing docker exec processes rather than spawning new ones. +Implements persistent WebSocket terminal sessions that survive disconnections and reconnect to existing docker exec processes rather than spawning new ones. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata - design.md | Design document for implementing persistent terminal sessions that survive WebSocket disconnections while maintaining shell state and allowing reconnection to the same docker exec process. | dep: TerminalManager, TerminalSession, WebSocket, docker exec, PTY - proposal.md | Proposes architectural changes to make WebSocket terminal sessions persistent across reconnections instead of spawning new docker exec processes each time | dep: docker exec, WebSocket, TerminalManager, terminal_session.py, terminal.tsx, use-terminal.ts - tasks.md | This file is a project task list tracking the implementation of persistent terminal sessions with WebSocket reconnection, reset functionality, and idle timeout management across backend and frontend components. | dep: TerminalSession, TerminalManager, WebSocket, docker exec, API endpoints, frontend terminal component, terminal hook ## arch -Event-driven architecture with WebSocket connection management, process state persistence layer, session lifecycle tracking (idle timeouts, explicit resets), and bidirectional frontend-backend coordination for seamless terminal reconnection. +Event-driven architecture with WebSocket connection management, process state persistence, session lifecycle handling (reconnection/reset/idle timeout), and cross-layer backend-frontend coordination. ## tags websocket, terminal, design, persistent, sessions, terminalmanager, docker exec, .openspec ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md index 45f20fb..e45a21d 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs (index) -dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs +# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs (index) +dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs ## role Contains archived specification documents for a persistent terminal sessions feature that was completed on June 12, 2026. ## parent -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal - index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md +- 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal + index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md ## files ## links -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md index 0888eb9..9dc094b 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs -dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs +# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs +dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md ## role Contains archived specification documents for a persistent terminal sessions feature that was completed on June 12, 2026. ## files ## arch -Document-based specification storage with date-versioned archival structure for historical feature documentation. +Documentation-only archive directory with no active code; stores historical design specs for completed terminal session persistence functionality. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md index e80d36a..8bc33c0 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal (index) -dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal +# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal (index) +dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal ## role -Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities +Defines specifications for persistent WebSocket terminal sessions that maintain state across reconnections with buffered output, reset controls, and idle timeout management. ## parent -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md index 0e9f1e5..cabf958 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal -dir: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal +# 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal +dir: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal -index: archive/2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/persistent-terminal-sessions/specs/persistent-terminal/.pi-map.index.md ## role -Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities +Defines specifications for persistent WebSocket terminal sessions that maintain state across reconnections with buffered output, reset controls, and idle timeout management. ## files - spec.md | Defines requirements for persistent WebSocket terminal sessions with reconnection, output buffering, reset, and idle timeout capabilities ## arch -Specification-driven requirements document using markdown-based technical specification pattern with functional requirement enumeration +Specification-driven architecture using a single requirements document to define session persistence, WebSocket transport, circular output buffering, and state machine behaviors (active/idle/closed) with explicit client-server protocol semantics. ## tags spec, defines, requirements, persistent, websocket, terminal, sessions, reconnection ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md index 8571ef3..b7267e1 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-active-changes-archive/reorganize-long-files (index) -dir: archive/2026-06-12-active-changes-archive/reorganize-long-files +# 2026-06-12-completed-changes-archive/reorganize-long-files (index) +dir: 2026-06-12-completed-changes-archive/reorganize-long-files ## role -Contains archived planning documents for a completed structural refactoring initiative that split monolithic frontend pages and backend routers into thinner, more modular components and services. +This is an archived project planning directory documenting a completed structural refactoring initiative to decompose monolithic frontend pages and backend routers into thinner, more maintainable modules. ## parent -index: archive/2026-06-12-active-changes-archive/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -14,8 +14,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md - spec.md - tasks.md ## links -index: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.md +index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md index 079df56..aefd5d1 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-active-changes-archive/reorganize-long-files -dir: archive/2026-06-12-active-changes-archive/reorganize-long-files +# 2026-06-12-completed-changes-archive/reorganize-long-files +dir: 2026-06-12-completed-changes-archive/reorganize-long-files -index: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md ## role -Contains archived planning documents for a completed structural refactoring initiative that split monolithic frontend pages and backend routers into thinner, more modular components and services. +This is an archived project planning directory documenting a completed structural refactoring initiative to decompose monolithic frontend pages and backend routers into thinner, more maintainable modules. ## files - .openspec.yaml | Configuration file tracking a completed project task for reorganizing long files - proposal.md | Proposes a structural refactoring to split monolithic frontend pages and backend routers into thinner orchestrators with extracted components/services, restoring a thin-page/thin-router/fat-component pattern. | dep: React components, FastAPI routers, WebSocket, Docker, git services - spec.md | A specification document defining a pure structural refactoring to split monolithic frontend pages/backend routers and CSS into smaller, focused components and services without changing any behavior or API contracts. | dep: React, CSS Modules, WebSocket, FastAPI/Flask routers, TypeScript, Vite - tasks.md | Tracks the completion status of a codebase reorganization initiative to slim long files by extracting components and services into dedicated modules. ## arch -Documentation-driven refactoring using specification-proposal-task workflow with a thin-page/thin-router/fat-component pattern, emphasizing pure structural decomposition without behavioral changes. +Task-driven documentation pattern using YAML configuration, markdown specs (proposal/spec/tasks), and a strict separation of planning artifacts from implementation, following a "thin orchestrator/fat component" modular decomposition strategy with zero-behavior-change refactoring constraints. ## tags components, services, long, .openspec, structural, refactoring, split, monolithic ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md index ea4b377..87f418f 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-06-12-completed-changes-archive/session-list-overhaul (index) -dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul +# 2026-06-12-completed-changes-archive/session-list-overhaul (index) +dir: 2026-06-12-completed-changes-archive/session-list-overhaul ## role -Archives a completed frontend refactoring project that unified duplicated session list rendering logic into reusable components across dashboard and sessions pages. +This package archives the completed design documentation and planning artifacts for a frontend refactoring initiative that unified duplicated session list rendering logic across dashboard and sessions pages into reusable components. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs - index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md +- 2026-06-12-completed-changes-archive/session-list-overhaul/specs + index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md index dcc0db0..c5ab8e4 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-completed-changes-archive/session-list-overhaul -dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul +# 2026-06-12-completed-changes-archive/session-list-overhaul +dir: 2026-06-12-completed-changes-archive/session-list-overhaul -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md ## role -Archives a completed frontend refactoring project that unified duplicated session list rendering logic into reusable components across dashboard and sessions pages. +This package archives the completed design documentation and planning artifacts for a frontend refactoring initiative that unified duplicated session list rendering logic across dashboard and sessions pages into reusable components. ## files - .openspec.yaml | Defines an OpenSpec configuration file with schema version and creation date metadata - design.md | Design document for refactoring duplicated session list rendering logic into unified reusable components across dashboard and sessions pages. | dep: dashboard.tsx, sessions.tsx, SessionCard, SessionList - proposal.md | Proposes a frontend refactoring to unify session list UI components across dashboard and sessions pages | dep: React components, CSS styling, dashboard.tsx, sessions.tsx - tasks.md | Task tracking checklist for refactoring session UI components in a web application dashboard ## arch -Documentation-driven refactoring with OpenSpec configuration, design docs, proposals, and task tracking; no active code, purely historical archive of a UI component consolidation initiative. +Documentation-driven waterfall planning with structured design docs (design.md, proposal.md, tasks.md) and OpenSpec schema configuration, using markdown-based task tracking and formal proposal/approval process before implementation. ## tags dashboard, sessions, tsx, design, refactoring, session, components, .openspec ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md index 453212a..3a1d01d 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md @@ -1,19 +1,19 @@ -# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs (index) -dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs +# 2026-06-12-completed-changes-archive/session-list-overhaul/specs (index) +dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs ## role -Contains archived specification documents for a completed session list overhaul feature from June 2026. +Contains archived specification documents for the completed session list overhaul feature from June 12, 2026. ## parent -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/session-list-overhaul/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui - index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md +- 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui + index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md ## files ## links -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md index 85a46e1..cfc230d 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs -dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs +# 2026-06-12-completed-changes-archive/session-list-overhaul/specs +dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md ## role -Contains archived specification documents for a completed session list overhaul feature from June 2026. +Contains archived specification documents for the completed session list overhaul feature from June 12, 2026. ## files ## arch -N/A (empty directory - no files to analyze) +Documentation/archive pattern using date-prefixed directory naming for historical change tracking with specification-driven development artifacts. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md index 4c4414e..27f67d3 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui (index) -dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui +# 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui (index) +dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui ## role -Defines UI specifications for unifying and overhauling session list displays across dashboard and sessions pages. +Defines UI specifications for unified session card components with display, controls, grouping, and filtering capabilities across dashboard and sessions pages. ## parent -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md index 8ec2272..d436e84 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui -dir: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui +# 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui +dir: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui -index: archive/2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/session-list-overhaul/specs/session-list-ui/.pi-map.index.md ## role -Defines UI specifications for unifying and overhauling session list displays across dashboard and sessions pages. +Defines UI specifications for unified session card components with display, controls, grouping, and filtering capabilities across dashboard and sessions pages. ## files - spec.md | Specifies UI requirements for session card display, control actions, list grouping/filtering, and component unification across dashboard and sessions pages. ## arch -Specification-driven design using requirements documents to standardize component behavior, filtering, and grouping patterns before implementation. +Specification-driven design using requirements documentation to standardize component behavior and visual presentation across multiple page contexts. ## tags spec, specifies, requirements, session, card, display, control, actions ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md index 6036a5e..7046db9 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/ssh-key-mounting (index) -dir: archive/2026-06-12-completed-changes-archive/ssh-key-mounting +# 2026-06-12-completed-changes-archive/ssh-key-mounting (index) +dir: 2026-06-12-completed-changes-archive/ssh-key-mounting ## role -Defines requirements for mounting SSH keys into tool instances to enable secure authentication. +Defines requirements specification for mounting SSH keys into tool instances to enable secure authentication. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files - .openspec.yaml ## links -index: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md +index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md index 509354d..53806ad 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/ssh-key-mounting -dir: archive/2026-06-12-completed-changes-archive/ssh-key-mounting +# 2026-06-12-completed-changes-archive/ssh-key-mounting +dir: 2026-06-12-completed-changes-archive/ssh-key-mounting -index: archive/2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/ssh-key-mounting/.pi-map.index.md ## role -Defines requirements for mounting SSH keys into tool instances to enable secure authentication. +Defines requirements specification for mounting SSH keys into tool instances to enable secure authentication. ## files - .openspec.yaml | Specification document defining requirements for SSH key mounting feature in tool instances ## arch -Specification-driven design using OpenSpec YAML format for declarative feature requirements documentation. +Requirements-as-code pattern using OpenSpec YAML format for declarative feature specification. ## tags .openspec, specification, document, defining, requirements, ssh, key, mounting ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md index 4f417c7..a90e418 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header (index) -dir: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header +# 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header (index) +dir: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header ## role -Archived completed specification for a terminal fullscreen mode header unification bugfix. +Archives a completed bugfix specification for unifying terminal fullscreen mode header UI elements. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files - .openspec.yaml ## links -index: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md +index: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md index fffadba..f5ec25c 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header -dir: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header +# 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header +dir: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header -index: archive/2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/terminal-fullscreen-unified-header/.pi-map.index.md ## role -Archived completed specification for a terminal fullscreen mode header unification bugfix. +Archives a completed bugfix specification for unifying terminal fullscreen mode header UI elements. ## files - .openspec.yaml | Defines a completed bugfix specification for unifying terminal fullscreen mode header elements ## arch -Specification-as-artifact pattern; single YAML-based change record in a date-versioned archive directory. +Specification-driven change tracking using YAML-based open specifications for completed work documentation. ## tags .openspec, defines, completed, bugfix, specification, unifying, terminal, fullscreen ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md index 55a0f34..0835d12 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md @@ -1,24 +1,11 @@ -# . (index) -dir: . - -## Project Map Protocol - -1. Read this protocol and the root `.pi-map.index.md` first. -2. Use `index:` / `map:` references to open relevant directory indexes and maps. -3. Load indexes before rich maps during task-start navigation. -4. Read the local rich map and actual source before editing. -5. Treat non-empty `## dirty` sections in either artifact as stale. -6. If source and generated artifacts disagree, trust source. -7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. -8. After editing source, run `project_map_patch` for each changed file. -9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. - -Trust boundary: index routes, map orients, source decides. +# 2026-06-12-completed-changes-archive/tool-config-mount-cleanup (index) +dir: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup ## role -Package containing completed specification, proposal, and task tracking for a tool configuration mount cleanup feature that separates built-in tool definitions from user-specific configuration. +Completed change archive documenting the removal of configuration/state mounts from built-in tool definitions to enable config-profile-based user-specific configuration. ## parent -- +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -26,8 +13,8 @@ Package containing completed specification, proposal, and task tracking for a to - proposal.md - tasks.md ## links -index: ./.pi-map.index.md -map: ./.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md index 3f0f9e8..f378249 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.md @@ -1,30 +1,16 @@ -# . -dir: . +# 2026-06-12-completed-changes-archive/tool-config-mount-cleanup +dir: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup -index: ./.pi-map.index.md - -## Project Map Protocol - -1. Read this protocol and the root `.pi-map.index.md` first. -2. Use `index:` / `map:` references to open relevant directory indexes and maps. -3. Load indexes before rich maps during task-start navigation. -4. Read the local rich map and actual source before editing. -5. Treat non-empty `## dirty` sections in either artifact as stale. -6. If source and generated artifacts disagree, trust source. -7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. -8. After editing source, run `project_map_patch` for each changed file. -9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. - -Trust boundary: index routes, map orients, source decides. +index: 2026-06-12-completed-changes-archive/tool-config-mount-cleanup/.pi-map.index.md ## role -Package containing completed specification, proposal, and task tracking for a tool configuration mount cleanup feature that separates built-in tool definitions from user-specific configuration. +Completed change archive documenting the removal of configuration/state mounts from built-in tool definitions to enable config-profile-based user-specific configuration. ## files - .openspec.yaml | Defines a completed OpenSpec configuration for a tool named "tool-config-mount-cleanup" - proposal.md | Proposes removing configuration and state mounts from built-in tool definitions to separate tool setup from user-specific configuration handled by config profiles. - tasks.md | This is a completed task checklist for modifying built-in tool configurations and database migrations in a codebase. | dep: alembic, pytest, opencode, pi-agent ## arch -Documentation-driven change management with OpenSpec configuration, markdown-based proposal/justification, and structured task checklist for tracking implementation of a configuration separation pattern. +Specification-driven migration pattern using OpenSpec for declarative tool configuration, with separation of concerns between built-in tool setup and user-configurable profiles, plus database migration coordination. ## tags tool, configuration, completed, config, .openspec, proposal, tasks, defines ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md index 0304386..5b58cbf 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md @@ -1,23 +1,23 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates (index) -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates (index) +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates ## role -Archives completed frontend architecture changes for real-time session progress tracking using SSE events and shared React state management. +Archives documentation for a completed frontend refactoring that added real-time session progress tracking via SSE events and shared React state. ## parent -index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs - index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md +- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs + index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md ## files - .openspec.yaml - design.md - proposal.md - tasks.md ## links -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md index fab3a72..ad2ecf2 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md @@ -1,17 +1,17 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md ## role -Archives completed frontend architecture changes for real-time session progress tracking using SSE events and shared React state management. +Archives documentation for a completed frontend refactoring that added real-time session progress tracking via SSE events and shared React state. ## files - .openspec.yaml | Defines an OpenAPI specification metadata file with schema type and creation date - design.md | Design document for frontend-only refactoring of session lifecycle progress tracking and live UI updates using SSE events and shared React context. | dep: React, SSE (useEvents), SessionsContext, SessionOperationsContext, AppShell, DashboardPage, SessionsPage, CreateSessionForm, InstanceList, useInstanceActions, ToolStarter, StartToolFAB, EventToastBridge - proposal.md | Proposes a frontend architecture change to add real-time session progress tracking via SSE and shared state across the application. | dep: React, SSE events, state management, AppShell, DashboardPage, SessionsPage, use-instance-actions, CreateSessionForm, SessionCard, InstanceCard - tasks.md | A completed task checklist tracking implementation of shared session state, global progress panel, optimistic UI updates, and removal of legacy progress overlays in a React frontend application. | dep: React, state/sessions.tsx, state/session-operations.tsx, useEvents, hooks/use-instance-actions.ts, AppShell, SessionsPage, DashboardPage, components/features/session/session-progress-panel.tsx, components/features/tool/tool-starter.tsx, components/features/tool/start-tool-fab.tsx, components/features/tool/instance-list.tsx, components/features/session/create-session-form.tsx, components/features/session/session-card.tsx ## arch -Event-driven reactive frontend pattern using Server-Sent Events (SSE) for live updates, shared React context for global session state, optimistic UI updates, and component-based progress panels replacing legacy overlay system. +Event-driven frontend architecture using Server-Sent Events (SSE) for live updates, shared React context for global session state, optimistic UI patterns, and a centralized progress panel replacing legacy overlay components. ## tags session, tsx, components, features, progress, react, tool, state ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md index df4d06f..f0ee6c1 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md @@ -1,22 +1,22 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs (index) -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs (index) +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs ## role -Contains historical specification documents for tool session progress tracking features that were completed and archived on June 12, 2026. +This directory serves as a specification archive for completed tool session progress and updates, storing historical design documents and requirements for past changes. ## parent -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/.pi-map.md ## children -- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux - index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md -- archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub - index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md - map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md +- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux + index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md +- 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub + index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md + map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md ## files ## links -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md index 6c4da35..533b51a 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md @@ -1,13 +1,13 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md ## role -Contains historical specification documents for tool session progress tracking features that were completed and archived on June 12, 2026. +This directory serves as a specification archive for completed tool session progress and updates, storing historical design documents and requirements for past changes. ## files ## arch -Document-based archive pattern with dated directory structure for preserving completed technical specifications outside active development paths. +Simple archival directory structure with no active architecture; likely contains flat-file documentation or markdown specs organized by date for historical reference and audit trails. ## tags - ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md index 0d7da7d..919f929 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux (index) -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux (index) +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux ## role -Defines UI/UX specifications for real-time progress feedback during session lifecycle operations via server-sent events. +Defines UI/UX specifications for real-time progress feedback and optimistic state updates during asynchronous session operations. ## parent -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md index 7a3fcb2..9166ea3 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/session-lifecycle-ux/.pi-map.index.md ## role -Defines UI/UX specifications for real-time progress feedback during session lifecycle operations via server-sent events. +Defines UI/UX specifications for real-time progress feedback and optimistic state updates during asynchronous session operations. ## files - spec.md | Specifies UI/UX requirements for non-blocking progress indicators and optimistic updates for session lifecycle actions using SSE events. | dep: SSE, global progress indicator, shared state management, API ## arch -Event-driven reactive UI pattern with optimistic updates and non-blocking progress indicators using SSE (Server-Sent Events) for asynchronous server communication. +Event-driven reactive UI pattern using Server-Sent Events (SSE) for streaming progress updates, with optimistic UI state management for non-blocking user experience. ## tags sse, spec, specifies, requirements, non, blocking, progress, indicators ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md index 594c521..2a442fa 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md @@ -1,18 +1,18 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub (index) -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub (index) +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub ## role -Defines requirements for a shared global session state system enabling real-time UI synchronization across dashboard, sessions page, and navigation components when sessions change. +Defines requirements for a shared global session state system that enables real-time UI synchronization across dashboard, sessions page, and navigation components when session data changes. ## parent -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/.pi-map.md ## children - ## files - spec.md ## links -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md -map: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md index daa0e5a..576398f 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.md @@ -1,14 +1,14 @@ -# archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub -dir: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub +# 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub +dir: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub -index: archive/2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/tool-session-progress-and-updates/specs/sessions-hub/.pi-map.index.md ## role -Defines requirements for a shared global session state system enabling real-time UI synchronization across dashboard, sessions page, and navigation components when sessions change. +Defines requirements for a shared global session state system that enables real-time UI synchronization across dashboard, sessions page, and navigation components when session data changes. ## files - spec.md | Defines requirements for implementing a shared global session state across dashboard, sessions page, and navigation to enable immediate UI updates when sessions are created or modified. | dep: SessionsContext, React Context API, sessions API (`/users/me/sessions`) ## arch -Specification-driven architecture using a centralized global state pattern with reactive UI updates, documented in markdown-based requirements specification. +Specification-driven architecture using a centralized session state hub with reactive update propagation to multiple UI surfaces. ## tags sessions, spec, defines, requirements, implementing, shared, global, session ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md index 4a821ed..1b09707 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-active-changes-archive/working-copies (index) -dir: archive/2026-06-12-active-changes-archive/working-copies +# 2026-06-12-completed-changes-archive/working-copies (index) +dir: 2026-06-12-completed-changes-archive/working-copies ## role -Archive of design documents and specifications for implementing persistent workspace-based tool instances that replace direct repository mounting with isolated git working copies. +Archive of completed design documents for a project that replaced direct repository mounting/cloning with persistent, shared Git workspace copies for tool instances. ## parent -index: archive/2026-06-12-active-changes-archive/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -16,8 +16,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md - spec.md - tasks.md ## links -index: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.md +index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/working-copies/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md index 59e634e..ac54305 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-06-12-active-changes-archive/working-copies -dir: archive/2026-06-12-active-changes-archive/working-copies +# 2026-06-12-completed-changes-archive/working-copies +dir: 2026-06-12-completed-changes-archive/working-copies -index: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md ## role -Archive of design documents and specifications for implementing persistent workspace-based tool instances that replace direct repository mounting with isolated git working copies. +Archive of completed design documents for a project that replaced direct repository mounting/cloning with persistent, shared Git workspace copies for tool instances. ## files - .openspec.yaml | Defines metadata for a completed project named "working-copies" with timeline tracking - design.md | Design document for implementing workspace-based tool instances that replace direct repository mounting with isolated git working copies | dep: FastAPI, SQLAlchemy, Alembic, Docker Compose, Git, React/TypeScript, asyncio subprocess @@ -13,7 +13,7 @@ Archive of design documents and specifications for implementing persistent works - spec.md | Technical specification for implementing persistent workspace-based tool instances that replace mount/clone modes with explicit Git repository workspaces | dep: Git, PostgreSQL, REST API, React/TypeScript frontend, Docker containers, Python backend - tasks.md | Project task tracking document for implementing workspace-based tool instances across backend and frontend in a multi-PR phased approach | dep: Alembic, FastAPI, SQLAlchemy, React, TypeScript, pytest, ruff, ESLint, Git, Docker Compose ## arch -Design-driven documentation package containing phased technical specifications (proposal → design → exploration → spec → tasks) for a Workspace entity abstraction, with YAML metadata tracking and multi-PR implementation planning across backend/frontend systems. +Design-driven development with layered specification documents (exploration → proposal → design → spec → tasks) documenting a phased multi-PR implementation across backend and frontend systems. ## tags workspace, tool, instances, git, design, replace, project, working ## symbols diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md index 6d81a0f..50eafd2 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md @@ -1,11 +1,11 @@ -# archive/2026-06-12-active-changes-archive/workspace-first-ui (index) -dir: archive/2026-06-12-active-changes-archive/workspace-first-ui +# 2026-06-12-completed-changes-archive/workspace-first-ui (index) +dir: 2026-06-12-completed-changes-archive/workspace-first-ui ## role -Archive of planning documents for a workspace-first UI redesign that reorients the product around persistent writable workspaces rather than direct repository browsing. +Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction. ## parent -index: archive/2026-06-12-active-changes-archive/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/.pi-map.md +index: 2026-06-12-completed-changes-archive/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/.pi-map.md ## children - ## files @@ -15,8 +15,8 @@ map: archive/2026-06-12-active-changes-archive/.pi-map.md - spec.md - tasks.md ## links -index: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.index.md -map: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.md +index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md +map: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md index 71d84bb..64f04fe 100644 --- a/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md @@ -1,10 +1,10 @@ -# archive/2026-06-12-active-changes-archive/workspace-first-ui -dir: archive/2026-06-12-active-changes-archive/workspace-first-ui +# 2026-06-12-completed-changes-archive/workspace-first-ui +dir: 2026-06-12-completed-changes-archive/workspace-first-ui -index: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.index.md +index: 2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md ## role -Archive of planning documents for a workspace-first UI redesign that reorients the product around persistent writable workspaces rather than direct repository browsing. +Archive of completed design and planning documents for a workspace-first UI navigation redesign that shifts from repository-centric to workspace-centric project interaction. ## files - .openspec.yaml | Defines metadata for a completed project specification named "workspace-first-ui" - design.md | Design document for a workspace-first UI refresh, detailing backend API/services and frontend components for file management, git operations, and tool instances scoped to workspaces. | dep: FastAPI, SQLAlchemy/AsyncSession, React, React Router, asyncio, subprocess, os @@ -12,7 +12,7 @@ Archive of planning documents for a workspace-first UI redesign that reorients t - spec.md | Product specification document defining a workspace-first UI refresh that replaces direct repository file browsing with workspace-centric navigation, new routes, and redesigned pages for projects and workspace details. | dep: React/Next.js (implied by .tsx, routing), REST API backend, database (existing workspaces table), TypeScript, ruff, eslint - tasks.md | Project task tracking document for a workspace-first UI refresh, breaking work into 3 sequential PRs with backend endpoints, frontend workspace detail page, and projects page refresh with routing changes. | dep: markdown, pytest, ruff, TypeScript compiler, eslint, npm, git, python ## arch -Specification-driven development with phased PR-based delivery (backend → frontend → routing), using structured product docs (proposal → design → spec → tasks) and OpenAPI-style metadata for project tracking. +Documentation-heavy package using sequential PR-based task decomposition (backend → workspace detail → projects page) with layered specification hierarchy (proposal → design → spec → tasks) and OpenSpec metadata tracking. ## tags workspace, first, refresh, design, document, project, specification, .openspec ## symbols diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md new file mode 100644 index 0000000..138579c --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.index.md @@ -0,0 +1,120 @@ +# 2026-06-14-completed-specs-archive (index) +dir: 2026-06-14-completed-specs-archive + +## role +Historical archive for completed and audited OpenSpec specifications that are no longer active in the project. +## parent +index: ./.pi-map.index.md +map: ./.pi-map.md +## children +- 2026-06-14-completed-specs-archive/api-documentation + index: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.md +- 2026-06-14-completed-specs-archive/auth-oauth + index: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md +- 2026-06-14-completed-specs-archive/database-models + index: 2026-06-14-completed-specs-archive/database-models/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/database-models/.pi-map.md +- 2026-06-14-completed-specs-archive/docker-infrastructure + index: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md +- 2026-06-14-completed-specs-archive/frontend-foundation + index: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md +- 2026-06-14-completed-specs-archive/git-repo + index: 2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/git-repo/.pi-map.md +- 2026-06-14-completed-specs-archive/instance-proxy + index: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md +- 2026-06-14-completed-specs-archive/instance-runtime-health + index: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md +- 2026-06-14-completed-specs-archive/instance-startup-health + index: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md +- 2026-06-14-completed-specs-archive/mobile-list-detail + index: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md +- 2026-06-14-completed-specs-archive/mobile-navigation + index: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md +- 2026-06-14-completed-specs-archive/mobile-repo-workspace + index: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md +- 2026-06-14-completed-specs-archive/mobile-tools-navigation + index: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md +- 2026-06-14-completed-specs-archive/opencode-web-server + index: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md +- 2026-06-14-completed-specs-archive/project-management + index: 2026-06-14-completed-specs-archive/project-management/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/project-management/.pi-map.md +- 2026-06-14-completed-specs-archive/readiness-probe-integration + index: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md +- 2026-06-14-completed-specs-archive/repo-clone-mode + index: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md +- 2026-06-14-completed-specs-archive/session-lifecycle-ux + index: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md +- 2026-06-14-completed-specs-archive/sessions-hub + index: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md +- 2026-06-14-completed-specs-archive/smart-tunnel-recovery + index: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md +- 2026-06-14-completed-specs-archive/ssh-keys + index: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-config-management + index: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-instances + index: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-port-configuration + index: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-terminal + index: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-terminal-startup-command + index: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-type-port-visibility + index: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-type-single-interface + index: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-types + index: 2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-types/.pi-map.md +- 2026-06-14-completed-specs-archive/tool-types-definition + index: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md +- 2026-06-14-completed-specs-archive/traefik-deployment + index: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md +- 2026-06-14-completed-specs-archive/tunnel-health-monitoring + index: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md +- 2026-06-14-completed-specs-archive/user-config + index: 2026-06-14-completed-specs-archive/user-config/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/user-config/.pi-map.md +- 2026-06-14-completed-specs-archive/user-profile + index: 2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md + map: 2026-06-14-completed-specs-archive/user-profile/.pi-map.md +## files +- README.md +## links +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md new file mode 100644 index 0000000..06cc3d2 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive +dir: 2026-06-14-completed-specs-archive + +index: 2026-06-14-completed-specs-archive/.pi-map.index.md + +## role +Historical archive for completed and audited OpenSpec specifications that are no longer active in the project. +## files +- README.md | Documents archived OpenSpec specifications that have been audited against the source tree and moved to historical reference. +## arch +Simple archival directory structure with README-based documentation; no active code or runtime architecture. +## tags +readme, documents, archived, openspec, specifications, have, been, audited +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/README.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/README.md new file mode 100644 index 0000000..af9920d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/README.md @@ -0,0 +1,60 @@ +# Archived Completed Specs — 2026-06-14 + +These OpenSpec specs have been audited against the current source tree and confirmed as either fully implemented or partially implemented/outdated. They are archived here for historical reference. + +## Archived specs + +- api-documentation +- auth-oauth +- database-models +- docker-infrastructure +- frontend-foundation +- git-repo +- instance-proxy +- instance-runtime-health +- instance-startup-health +- mobile-list-detail +- mobile-navigation +- mobile-repo-workspace +- mobile-tools-navigation +- opencode-web-server +- project-management +- readiness-probe-integration +- repo-clone-mode +- session-lifecycle-ux +- sessions-hub +- smart-tunnel-recovery +- ssh-keys +- tool-config-management +- tool-instances +- tool-port-configuration +- tool-terminal +- tool-terminal-startup-command +- tool-type-port-visibility +- tool-type-single-interface +- tool-types +- tool-types-definition +- traefik-deployment +- tunnel-health-monitoring +- user-config +- user-profile + +## Audit summary + +| Status | Count | +|--------|-------| +| Fully implemented | 24 | +| Partially implemented / outdated | 11 | +| Not implemented | 2 (archived as obsolete) | + +Audit report generated before archiving. + +## Note + +The remaining active specs live in `openspec/specs/`: + +- config-profile-multi-repo-mounts.md +- home-path-expansion.md +- mount-specificity-ordering.md +- terminal-responsiveness.md +- tool-definition-manifest.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md new file mode 100644 index 0000000..961e217 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/api-documentation (index) +dir: 2026-06-14-completed-specs-archive/api-documentation + +## role +Defines API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.md new file mode 100644 index 0000000..8874554 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/api-documentation +dir: 2026-06-14-completed-specs-archive/api-documentation + +index: 2026-06-14-completed-specs-archive/api-documentation/.pi-map.index.md + +## role +Defines API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system. +## files +- spec.md | Define API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system. | dep: FastAPI, Pydantic v2, Swagger UI, Database, Redis +## arch +Specification-driven documentation architecture using markdown-based requirements definition for API standards, health check endpoints, and onboarding workflows. +## tags +fastapi, spec, define, api, documentation, health, monitoring, developer +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/api-documentation/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/spec.md similarity index 100% rename from openspec/specs/api-documentation/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/api-documentation/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md new file mode 100644 index 0000000..d61794a --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/auth-oauth (index) +dir: 2026-06-14-completed-specs-archive/auth-oauth + +## role +Defines authentication and authorization specifications for OAuth2/OIDC integration with Authentik identity provider. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md new file mode 100644 index 0000000..e7f60b0 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/auth-oauth +dir: 2026-06-14-completed-specs-archive/auth-oauth + +index: 2026-06-14-completed-specs-archive/auth-oauth/.pi-map.index.md + +## role +Defines authentication and authorization specifications for OAuth2/OIDC integration with Authentik identity provider. +## files +- spec.md | Specifies OAuth2/OIDC authentication requirements using Authentik with secure session handling, token refresh, and logout functionality | dep: Authentik OIDC provider, Database (User model), pytest, mypy, ruff +## arch +Security-focused specification document outlining token-based authentication flow with session management, refresh mechanisms, and secure logout procedures. +## tags +spec, specifies, oauth2, oidc, authentication, requirements, authentik, secure +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/auth-oauth/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/spec.md similarity index 100% rename from openspec/specs/auth-oauth/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/auth-oauth/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md new file mode 100644 index 0000000..1cfc02c --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/database-models (index) +dir: 2026-06-14-completed-specs-archive/database-models + +## role +Defines the database schema, SQLAlchemy 2.0 async ORM models, Alembic migrations, and seeding logic for six core entities in the Headquarter platform. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/database-models/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/database-models/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.md new file mode 100644 index 0000000..f81207d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/database-models +dir: 2026-06-14-completed-specs-archive/database-models + +index: 2026-06-14-completed-specs-archive/database-models/.pi-map.index.md + +## role +Defines the database schema, SQLAlchemy 2.0 async ORM models, Alembic migrations, and seeding logic for six core entities in the Headquarter platform. +## files +- spec.md | Define database schema and SQLAlchemy 2.0 async models for the Headquarter platform with six core entities, Alembic migrations, and seeding. | dep: PostgreSQL, SQLAlchemy 2.0, asyncpg, Alembic, Fernet, pytest, mypy, ruff +## arch +Async SQLAlchemy 2.0 declarative ORM with Alembic for migrations, supporting PostgreSQL with structured seeding and six interconnected domain entities. +## tags +alembic, spec, define, database, schema, sqlalchemy, async, models +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/database-models/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/spec.md similarity index 100% rename from openspec/specs/database-models/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/database-models/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md new file mode 100644 index 0000000..335ffcf --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/docker-infrastructure (index) +dir: 2026-06-14-completed-specs-archive/docker-infrastructure + +## role +Defines Docker-based infrastructure specifications for multi-service development and production deployment environments. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/specs/docker-infrastructure/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md similarity index 60% rename from openspec/specs/docker-infrastructure/.pi-map.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md index 8bd28bd..83390b5 100644 --- a/openspec/specs/docker-infrastructure/.pi-map.md +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.md @@ -1,14 +1,14 @@ -# openspec/specs/docker-infrastructure -dir: openspec/specs/docker-infrastructure +# 2026-06-14-completed-specs-archive/docker-infrastructure +dir: 2026-06-14-completed-specs-archive/docker-infrastructure -index: openspec/specs/docker-infrastructure/.pi-map.index.md +index: 2026-06-14-completed-specs-archive/docker-infrastructure/.pi-map.index.md ## role Defines Docker-based infrastructure specifications for multi-service development and production deployment environments. ## files - spec.md | Define Docker-based infrastructure specifications for a multi-service development and production deployment environment | dep: Docker, Docker Compose, Make, Python 3.11, Node.js 20+, nginx, Traefik, Vite, Authentik, Redis, PostgreSQL ## arch -Infrastructure-as-code specification using Docker containerization with environment-specific configurations for development and production deployments. +Specification-driven architecture using markdown-based documentation to define container orchestration patterns for cross-environment parity. ## tags docker, spec, define, infrastructure, specifications, multi, service, development ## symbols diff --git a/openspec/specs/docker-infrastructure/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/spec.md similarity index 100% rename from openspec/specs/docker-infrastructure/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/docker-infrastructure/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md new file mode 100644 index 0000000..1e82477 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/frontend-foundation (index) +dir: 2026-06-14-completed-specs-archive/frontend-foundation + +## role +Defines the technical specification for a modern React 18+ TypeScript frontend foundation with build tooling, routing, styling, and core UI features. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md new file mode 100644 index 0000000..eb2ebca --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/frontend-foundation +dir: 2026-06-14-completed-specs-archive/frontend-foundation + +index: 2026-06-14-completed-specs-archive/frontend-foundation/.pi-map.index.md + +## role +Defines the technical specification for a modern React 18+ TypeScript frontend foundation with build tooling, routing, styling, and core UI features. +## files +- spec.md | Define a specification for a modern React 18+ TypeScript frontend with Vite, React Router, Tailwind CSS, authenticated routing, responsive layout, and dashboard/tool workshop features. | dep: React 18+, TypeScript 5+, Vite, React Router, Tailwind CSS, Axios +## arch +Specification-driven architecture using Vite for bundling, React Router for client-side navigation with authenticated route guards, Tailwind CSS for utility-first styling, and a component-based layout structure supporting responsive dashboards and tool workshops. +## tags +react, vite, spec, define, specification, modern, typescript, frontend +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/frontend-foundation/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/spec.md similarity index 100% rename from openspec/specs/frontend-foundation/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/frontend-foundation/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md new file mode 100644 index 0000000..5fb9d0d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/git-repo (index) +dir: 2026-06-14-completed-specs-archive/git-repo + +## role +Defines specifications for a bare git repository management service that bridges filesystem storage with database-backed metadata and SSH key integration. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/git-repo/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.md new file mode 100644 index 0000000..ef1173f --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/git-repo +dir: 2026-06-14-completed-specs-archive/git-repo + +index: 2026-06-14-completed-specs-archive/git-repo/.pi-map.index.md + +## role +Defines specifications for a bare git repository management service that bridges filesystem storage with database-backed metadata and SSH key integration. +## files +- spec.md | Specifies requirements for managing bare git repositories on disk with database metadata, including creation, SSH key association, cloning, listing, deletion, and duplicate prevention. | dep: Database models (GitRepository, Project, User), Docker volume for repo storage +## arch +Specification-driven domain design with clear separation between storage operations (create/clone/delete), metadata persistence, and access control (SSH keys), emphasizing idempotency and duplicate prevention constraints. +## tags +spec, specifies, requirements, managing, bare, git, repositories, disk +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/git-repo/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/spec.md similarity index 100% rename from openspec/specs/git-repo/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/git-repo/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md new file mode 100644 index 0000000..0173c0d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/instance-proxy (index) +dir: 2026-06-14-completed-specs-archive/instance-proxy + +## role +Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-based access control. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md new file mode 100644 index 0000000..f3e5c1d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/instance-proxy +dir: 2026-06-14-completed-specs-archive/instance-proxy + +index: 2026-06-14-completed-specs-archive/instance-proxy/.pi-map.index.md + +## role +Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-based access control. +## files +- spec.md | Specifies API requirements for an HTTP/WebSocket proxy endpoint that forwards requests to running tool instances with owner-based access control +## arch +API specification using markdown-based documentation; defines REST/WebSocket endpoint patterns with authentication/authorization requirements, request forwarding semantics, and ownership-based access control policies. +## tags +spec, specifies, api, requirements, http, websocket, proxy, endpoint +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/instance-proxy/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/spec.md similarity index 100% rename from openspec/specs/instance-proxy/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/instance-proxy/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md new file mode 100644 index 0000000..1ee655d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/instance-runtime-health (index) +dir: 2026-06-14-completed-specs-archive/instance-runtime-health + +## role +Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md new file mode 100644 index 0000000..9f9cbf0 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/instance-runtime-health +dir: 2026-06-14-completed-specs-archive/instance-runtime-health + +index: 2026-06-14-completed-specs-archive/instance-runtime-health/.pi-map.index.md + +## role +Defines requirements for monitoring container health states and synchronizing runtime status between instances and a central control plane. +## files +- spec.md | Specification document defining health monitoring, polling, and container state synchronization requirements for a container/instance management system | dep: Docker, HTTP tunneling, REST API +## arch +Specification-driven contract pattern with event-based polling architecture, health state machine transitions, and asynchronous status reconciliation between distributed agents and centralized coordinator. +## tags +container, spec, specification, document, defining, health, monitoring, polling +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/instance-runtime-health/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/spec.md similarity index 100% rename from openspec/specs/instance-runtime-health/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/instance-runtime-health/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md new file mode 100644 index 0000000..4adde0b --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/instance-startup-health (index) +dir: 2026-06-14-completed-specs-archive/instance-startup-health + +## role +Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md new file mode 100644 index 0000000..5cdfd39 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/instance-startup-health +dir: 2026-06-14-completed-specs-archive/instance-startup-health + +index: 2026-06-14-completed-specs-archive/instance-startup-health/.pi-map.index.md + +## role +Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose. +## files +- spec.md | Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose | dep: docker compose, docker ps, readiness probes, tunnels, health endpoints, database +## arch +Specification-driven requirements document using Markdown format with structured sections for overview, requirements, and behavior definitions, following a declarative specification pattern for system behavior documentation. +## tags +spec, defines, requirements, container, startup, verification, readiness, probe +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/instance-startup-health/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/spec.md similarity index 100% rename from openspec/specs/instance-startup-health/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/instance-startup-health/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md new file mode 100644 index 0000000..056f0c6 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-list-detail (index) +dir: 2026-06-14-completed-specs-archive/mobile-list-detail + +## role +Defines mobile UI specifications for list-detail CRUD screens managing tool types and configuration profiles. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md new file mode 100644 index 0000000..124e7f3 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-list-detail +dir: 2026-06-14-completed-specs-archive/mobile-list-detail + +index: 2026-06-14-completed-specs-archive/mobile-list-detail/.pi-map.index.md + +## role +Defines mobile UI specifications for list-detail CRUD screens managing tool types and configuration profiles. +## files +- spec.md | Defines mobile UI requirements for a configuration management system with list views, detail views, editing, and CRUD operations for tool types and config profiles. +## arch +Specification-driven documentation using structured markdown with user stories, acceptance criteria, and screen flow definitions for mobile configuration management interfaces. +## tags +views, spec, defines, mobile, requirements, configuration, management, system +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/mobile-list-detail/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/spec.md similarity index 100% rename from openspec/specs/mobile-list-detail/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-list-detail/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md new file mode 100644 index 0000000..e455464 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-navigation (index) +dir: 2026-06-14-completed-specs-archive/mobile-navigation + +## role +Archives completed mobile bottom navigation specification with grouped items and submenu behavior. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md new file mode 100644 index 0000000..7227d7d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-navigation +dir: 2026-06-14-completed-specs-archive/mobile-navigation + +index: 2026-06-14-completed-specs-archive/mobile-navigation/.pi-map.index.md + +## role +Archives completed mobile bottom navigation specification with grouped items and submenu behavior. +## files +- spec.md | Defines requirements for grouped bottom navigation with submenu behavior on mobile +## arch +Specification document archive with no active code architecture; serves as historical reference for mobile UI pattern requirements. +## tags +spec, defines, requirements, grouped, bottom, navigation, submenu, behavior +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/mobile-navigation/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/spec.md similarity index 100% rename from openspec/specs/mobile-navigation/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-navigation/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md new file mode 100644 index 0000000..7265dcc --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-repo-workspace (index) +dir: 2026-06-14-completed-specs-archive/mobile-repo-workspace + +## role +Defines mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md new file mode 100644 index 0000000..8056282 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-repo-workspace +dir: 2026-06-14-completed-specs-archive/mobile-repo-workspace + +index: 2026-06-14-completed-specs-archive/mobile-repo-workspace/.pi-map.index.md + +## role +Defines mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views +## files +- spec.md | Define mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views +## arch +Specification document using markdown-based requirements definition with view-based modular decomposition +## tags +spec, define, mobile, requirements, repository, workspace, featuring, tree +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/mobile-repo-workspace/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/spec.md similarity index 100% rename from openspec/specs/mobile-repo-workspace/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-repo-workspace/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md new file mode 100644 index 0000000..b340da7 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-tools-navigation (index) +dir: 2026-06-14-completed-specs-archive/mobile-tools-navigation + +## role +Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md new file mode 100644 index 0000000..18d3c9f --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/mobile-tools-navigation +dir: 2026-06-14-completed-specs-archive/mobile-tools-navigation + +index: 2026-06-14-completed-specs-archive/mobile-tools-navigation/.pi-map.index.md + +## role +Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication. +## files +- spec.md | Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication +## arch +Specification-driven documentation pattern using Markdown-based requirements documents with no executable code. +## tags +bottom, spec, defines, mobile, requirements, grouped, tools, navigation +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/mobile-tools-navigation/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/spec.md similarity index 100% rename from openspec/specs/mobile-tools-navigation/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/mobile-tools-navigation/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md new file mode 100644 index 0000000..0247e40 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/opencode-web-server (index) +dir: 2026-06-14-completed-specs-archive/opencode-web-server + +## role +Defines specifications for a web-based terminal server feature that enables remote container access through browser-based tmux and ranger interfaces. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md new file mode 100644 index 0000000..cd8a4d8 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/opencode-web-server +dir: 2026-06-14-completed-specs-archive/opencode-web-server + +index: 2026-06-14-completed-specs-archive/opencode-web-server/.pi-map.index.md + +## role +Defines specifications for a web-based terminal server feature that enables remote container access through browser-based tmux and ranger interfaces. +## files +- spec.md | Specifies requirements for OpenCode containers to run a web terminal server on port 3000 with tmux and ranger, exposed through tunnels and UI buttons +## arch +Requirements-driven specification document using feature-based organization with functional requirements (port 3000, tmux, ranger), integration patterns (tunnel exposure, UI buttons), and containerized deployment constraints. +## tags +spec, specifies, requirements, opencode, containers, run, web, terminal +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/opencode-web-server/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/spec.md similarity index 100% rename from openspec/specs/opencode-web-server/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/opencode-web-server/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md new file mode 100644 index 0000000..29a1cae --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/project-management (index) +dir: 2026-06-14-completed-specs-archive/project-management + +## role +Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/project-management/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/project-management/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/specs/project-management/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.md similarity index 57% rename from openspec/specs/project-management/.pi-map.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.md index 944dc11..004b639 100644 --- a/openspec/specs/project-management/.pi-map.md +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/.pi-map.md @@ -1,14 +1,14 @@ -# openspec/specs/project-management -dir: openspec/specs/project-management +# 2026-06-14-completed-specs-archive/project-management +dir: 2026-06-14-completed-specs-archive/project-management -index: openspec/specs/project-management/.pi-map.index.md +index: 2026-06-14-completed-specs-archive/project-management/.pi-map.index.md ## role Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management. ## files - spec.md | Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management. | dep: Project, User, GitRepository, SSHKey, git-repo, ssh-keys ## arch -Specification-driven design using markdown-based requirements documentation. +Specification-driven requirements document using Markdown format to define functional and non-functional requirements for a repository grouping and access control system. ## tags project, management, ssh, spec, defines, requirements, system, groups ## symbols diff --git a/openspec/specs/project-management/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/spec.md similarity index 100% rename from openspec/specs/project-management/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/project-management/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md new file mode 100644 index 0000000..08c6724 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/readiness-probe-integration (index) +dir: 2026-06-14-completed-specs-archive/readiness-probe-integration + +## role +Defines specifications for container readiness probe integration during instance startup to determine when services are ready to receive traffic. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md new file mode 100644 index 0000000..8ebd258 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/readiness-probe-integration +dir: 2026-06-14-completed-specs-archive/readiness-probe-integration + +index: 2026-06-14-completed-specs-archive/readiness-probe-integration/.pi-map.index.md + +## role +Defines specifications for container readiness probe integration during instance startup to determine when services are ready to receive traffic. +## files +- spec.md | Defines requirements for container readiness probe configuration, execution, and result storage during instance startup | dep: docker, container orchestration, health endpoint, logging system +## arch +Specification-driven documentation pattern with requirements organized around configuration, execution, and storage concerns. +## tags +spec, defines, requirements, container, readiness, probe, configuration, execution +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/readiness-probe-integration/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/spec.md similarity index 100% rename from openspec/specs/readiness-probe-integration/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/readiness-probe-integration/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md new file mode 100644 index 0000000..2972352 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/repo-clone-mode (index) +dir: 2026-06-14-completed-specs-archive/repo-clone-mode + +## role +Defines host-side git repository cloning requirements with SSH key preparation and dirty state detection for containerized tool instances. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md new file mode 100644 index 0000000..9af14cf --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/repo-clone-mode +dir: 2026-06-14-completed-specs-archive/repo-clone-mode + +index: 2026-06-14-completed-specs-archive/repo-clone-mode/.pi-map.index.md + +## role +Defines host-side git repository cloning requirements with SSH key preparation and dirty state detection for containerized tool instances. +## files +- spec.md | Specifies requirements for host-side git repository cloning with SSH key preparation and dirty state detection for containerized tool instances. | dep: GitRepository, ToolInstance, SSHKey, Docker Compose, Git, pytest, mypy, ruff, npm +## arch +Specification-driven architecture using markdown-based requirements document with clear functional boundaries for host/container interaction patterns. +## tags +git, spec, specifies, requirements, host, side, repository, cloning +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/repo-clone-mode/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/spec.md similarity index 100% rename from openspec/specs/repo-clone-mode/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/repo-clone-mode/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md new file mode 100644 index 0000000..0d885c6 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/session-lifecycle-ux (index) +dir: 2026-06-14-completed-specs-archive/session-lifecycle-ux + +## role +Defines UI/UX requirements for session lifecycle management including confirmation flows and real-time deletion feedback. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md new file mode 100644 index 0000000..608231e --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/session-lifecycle-ux +dir: 2026-06-14-completed-specs-archive/session-lifecycle-ux + +index: 2026-06-14-completed-specs-archive/session-lifecycle-ux/.pi-map.index.md + +## role +Defines UI/UX requirements for session lifecycle management including confirmation flows and real-time deletion feedback. +## files +- spec.md | Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates +## arch +Specification-driven design using requirements documentation with behavioral definitions for user-facing state transitions. +## tags +spec, defines, software, requirements, session, management, behaviors, including +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/session-lifecycle-ux/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/spec.md similarity index 100% rename from openspec/specs/session-lifecycle-ux/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/session-lifecycle-ux/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md new file mode 100644 index 0000000..4adb9a8 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/sessions-hub (index) +dir: 2026-06-14-completed-specs-archive/sessions-hub + +## role +Defines technical specifications for a "Sessions Hub" feature that manages user sessions in a web application. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/specs/sessions-hub/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md similarity index 51% rename from openspec/specs/sessions-hub/.pi-map.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md index 5c7d2e3..2624a15 100644 --- a/openspec/specs/sessions-hub/.pi-map.md +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/.pi-map.md @@ -1,14 +1,14 @@ -# openspec/specs/sessions-hub -dir: openspec/specs/sessions-hub +# 2026-06-14-completed-specs-archive/sessions-hub +dir: 2026-06-14-completed-specs-archive/sessions-hub -index: openspec/specs/sessions-hub/.pi-map.index.md +index: 2026-06-14-completed-specs-archive/sessions-hub/.pi-map.index.md ## role -Defines technical specifications for a centralized user session management feature that enables viewing, filtering, and terminating active sessions across devices. +Defines technical specifications for a "Sessions Hub" feature that manages user sessions in a web application. ## files - spec.md | Defines technical specifications for a "Sessions Hub" feature including requirements, API endpoints, UI layouts, state management, and quality gates for managing user sessions in a web application. | dep: REST API, TypeScript, React/frontend framework (implied by UI specs and quality gates), polling-based state management, Pydantic/BaseModel ## arch -Specification-driven design using structured documentation with hierarchical sections (requirements, API, UI, state, quality gates) to enforce contract-first development between frontend and backend teams. +Specification-driven architecture using requirements documentation, API endpoint definitions, UI layout diagrams, state management patterns, and quality gate checklists. ## tags sessions, spec, defines, technical, specifications, hub, feature, including ## symbols diff --git a/openspec/specs/sessions-hub/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/spec.md similarity index 100% rename from openspec/specs/sessions-hub/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/sessions-hub/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md new file mode 100644 index 0000000..aa254ff --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/smart-tunnel-recovery (index) +dir: 2026-06-14-completed-specs-archive/smart-tunnel-recovery + +## role +Defines classification logic and recovery behavior for distinguishing infrastructure tunnel failures from application-level errors in health monitoring. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md new file mode 100644 index 0000000..dfbe93c --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/smart-tunnel-recovery +dir: 2026-06-14-completed-specs-archive/smart-tunnel-recovery + +index: 2026-06-14-completed-specs-archive/smart-tunnel-recovery/.pi-map.index.md + +## role +Defines classification logic and recovery behavior for distinguishing infrastructure tunnel failures from application-level errors in health monitoring. +## files +- spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system with different UI behaviors and recovery actions. +## arch +Specification-driven requirements document with decision-tree logic mapping error classifications to distinct UI states and automated recovery actions. +## tags +spec, specifies, requirements, classifying, tunnel, failures, versus, application +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/smart-tunnel-recovery/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/spec.md similarity index 100% rename from openspec/specs/smart-tunnel-recovery/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/smart-tunnel-recovery/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md new file mode 100644 index 0000000..35688c3 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/ssh-keys (index) +dir: 2026-06-14-completed-specs-archive/ssh-keys + +## role +Defines security specifications for SSH key generation and access control for git operations. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md new file mode 100644 index 0000000..e5cd11d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/ssh-keys +dir: 2026-06-14-completed-specs-archive/ssh-keys + +index: 2026-06-14-completed-specs-archive/ssh-keys/.pi-map.index.md + +## role +Defines security specifications for SSH key generation and access control for git operations. +## files +- spec.md | Specifies requirements for generating, managing, and securing Ed25519 SSH keys for git operations with project-scoped access control. | dep: SSHKey, User, Project, cryptography, pytest, mypy, ruff, npm +## arch +Security specification document establishing Ed25519 cryptographic standards with project-scoped access control patterns. +## tags +project, spec, specifies, requirements, generating, managing, securing, ed25519 +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/ssh-keys/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/spec.md similarity index 100% rename from openspec/specs/ssh-keys/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/ssh-keys/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md new file mode 100644 index 0000000..a221c1a --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-config-management (index) +dir: 2026-06-14-completed-specs-archive/tool-config-management + +## role +Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-config-management/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md similarity index 54% rename from openspec/specs/tool-config-management/.pi-map.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md index f29d8bc..4fcf78c 100644 --- a/openspec/specs/tool-config-management/.pi-map.md +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/.pi-map.md @@ -1,14 +1,14 @@ -# openspec/specs/tool-config-management -dir: openspec/specs/tool-config-management +# 2026-06-14-completed-specs-archive/tool-config-management +dir: 2026-06-14-completed-specs-archive/tool-config-management -index: openspec/specs/tool-config-management/.pi-map.index.md +index: 2026-06-14-completed-specs-archive/tool-config-management/.pi-map.index.md ## role Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. ## files - spec.md | Defines requirements for a tool configuration system with runtime fields, split-pane UI, JSON editors, and validation ## arch -Specification-driven architecture using markdown-based requirements documentation with UI/UX patterns for split-pane interfaces, JSON schema validation, and runtime field configuration. +Specification-driven architecture with split-pane UI pattern, JSON-based configuration with schema validation, and runtime field computation. ## tags spec, defines, requirements, tool, configuration, system, runtime, fields ## symbols diff --git a/openspec/specs/tool-config-management/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/spec.md similarity index 100% rename from openspec/specs/tool-config-management/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-config-management/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md new file mode 100644 index 0000000..0cff76b --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-instances (index) +dir: 2026-06-14-completed-specs-archive/tool-instances + +## role +Defines requirements for a tool instance management system handling lifecycle, networking, and operational state of deployed tool environments. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.md new file mode 100644 index 0000000..ba6e843 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-instances +dir: 2026-06-14-completed-specs-archive/tool-instances + +index: 2026-06-14-completed-specs-archive/tool-instances/.pi-map.index.md + +## role +Defines requirements for a tool instance management system handling lifecycle, networking, and operational state of deployed tool environments. +## files +- spec.md | Define modified and added requirements for a tool instance management system including status monitoring, health checks, tunnel management, clone mode operations, and SSH key handling +## arch +Specification-driven requirements document using structured markdown with sections for functional requirements, status definitions, health check protocols, tunnel/clone/SSH subsystems, and explicit "do not implement" exclusions. +## tags +management, spec, define, modified, added, requirements, tool, instance +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-instances/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/spec.md similarity index 100% rename from openspec/specs/tool-instances/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-instances/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md new file mode 100644 index 0000000..71fc66d --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-port-configuration (index) +dir: 2026-06-14-completed-specs-archive/tool-port-configuration + +## role +Defines specifications for validating tool port configurations, including default ports, Docker Compose template exposure, and multi-interface support. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md new file mode 100644 index 0000000..4addad1 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-port-configuration +dir: 2026-06-14-completed-specs-archive/tool-port-configuration + +index: 2026-06-14-completed-specs-archive/tool-port-configuration/.pi-map.index.md + +## role +Defines specifications for validating tool port configurations, including default ports, Docker Compose template exposure, and multi-interface support. +## files +- spec.md | Defines requirements for tool type validation including default ports, compose template port exposure, and multiple interface support +## arch +Specification-driven requirements documentation with structured constraints for port validation rules and template-based configuration patterns. +## tags +spec, defines, requirements, tool, type, validation, including, default +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-port-configuration/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/spec.md similarity index 100% rename from openspec/specs/tool-port-configuration/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-port-configuration/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md new file mode 100644 index 0000000..3650af2 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-terminal-startup-command (index) +dir: 2026-06-14-completed-specs-archive/tool-terminal-startup-command + +## role +Defines requirements for a pre-execution command feature in terminal tool sessions that runs before the interactive shell starts. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md new file mode 100644 index 0000000..4078f29 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-terminal-startup-command +dir: 2026-06-14-completed-specs-archive/tool-terminal-startup-command + +index: 2026-06-14-completed-specs-archive/tool-terminal-startup-command/.pi-map.index.md + +## role +Defines requirements for a pre-execution command feature in terminal tool sessions that runs before the interactive shell starts. +## files +- spec.md | Specifies requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions. | dep: tool-types-definition, tool-terminal +## arch +Specification document using requirement-driven design with field-based configuration pattern for tool type extensions. +## tags +terminal, tool, types, spec, specifies, requirements, adding, optional +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-terminal-startup-command/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/spec.md similarity index 100% rename from openspec/specs/tool-terminal-startup-command/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal-startup-command/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md new file mode 100644 index 0000000..187e7e9 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-terminal (index) +dir: 2026-06-14-completed-specs-archive/tool-terminal + +## role +Defines requirements for a browser-based WebSocket terminal interface that enables secure, session-managed access to running Docker containers with bidirectional I/O streaming. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md new file mode 100644 index 0000000..ca4479c --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-terminal +dir: 2026-06-14-completed-specs-archive/tool-terminal + +index: 2026-06-14-completed-specs-archive/tool-terminal/.pi-map.index.md + +## role +Defines requirements for a browser-based WebSocket terminal interface that enables secure, session-managed access to running Docker containers with bidirectional I/O streaming. +## files +- spec.md | Specifies requirements for a browser-based WebSocket terminal system for accessing running Docker containers with session management, I/O streaming, and access control. | dep: tool-instances, auth-oauth, xterm.js, ptyprocess +## arch +Event-driven WebSocket architecture with session-based multiplexing, container-attach abstraction layer, and token-based access control for real-time bidirectional streaming between browser clients and Docker container TTY/stdout/stderr interfaces. +## tags +spec, specifies, requirements, browser, websocket, terminal, system, accessing +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-terminal/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/spec.md similarity index 100% rename from openspec/specs/tool-terminal/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-terminal/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md new file mode 100644 index 0000000..6a82be5 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-type-port-visibility (index) +dir: 2026-06-14-completed-specs-archive/tool-type-port-visibility + +## role +Defines requirements for conditionally showing/hiding port configuration fields and validating port values based on whether a tool type requires network port access. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md new file mode 100644 index 0000000..b54eede --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-type-port-visibility +dir: 2026-06-14-completed-specs-archive/tool-type-port-visibility + +index: 2026-06-14-completed-specs-archive/tool-type-port-visibility/.pi-map.index.md + +## role +Defines requirements for conditionally showing/hiding port configuration fields and validating port values based on whether a tool type requires network port access. +## files +- spec.md | Defines requirements for conditional port configuration visibility and validation based on a tool type's `requires_port` flag +## arch +Specification-driven validation pattern using boolean flag (`requires_port`) to control dynamic UI field visibility and conditional form validation rules. +## tags +port, spec, defines, requirements, conditional, configuration, visibility, validation +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-type-port-visibility/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/spec.md similarity index 100% rename from openspec/specs/tool-type-port-visibility/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-port-visibility/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md new file mode 100644 index 0000000..5766389 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-type-single-interface (index) +dir: 2026-06-14-completed-specs-archive/tool-type-single-interface + +## role +Defines specifications for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md new file mode 100644 index 0000000..7d3a339 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-type-single-interface +dir: 2026-06-14-completed-specs-archive/tool-type-single-interface + +index: 2026-06-14-completed-specs-archive/tool-type-single-interface/.pi-map.index.md + +## role +Defines specifications for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration. +## files +- spec.md | Defines requirements for enforcing single interface types, validating allowed values, and migrating legacy data for a tool type system +## arch +Requirements specification document using a constraint-based validation pattern with explicit migration rules for backward compatibility. +## tags +spec, defines, requirements, enforcing, single, interface, types, validating +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-type-single-interface/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/spec.md similarity index 100% rename from openspec/specs/tool-type-single-interface/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-type-single-interface/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md new file mode 100644 index 0000000..9568de8 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-types-definition (index) +dir: 2026-06-14-completed-specs-archive/tool-types-definition + +## role +Defines specifications for a tool type management system that enables CRUD operations, Docker template validation, and variable substitution for development environments. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md new file mode 100644 index 0000000..bad1168 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-types-definition +dir: 2026-06-14-completed-specs-archive/tool-types-definition + +index: 2026-06-14-completed-specs-archive/tool-types-definition/.pi-map.index.md + +## role +Defines specifications for a tool type management system that enables CRUD operations, Docker template validation, and variable substitution for development environments. +## files +- spec.md | Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments. | dep: REST API, Docker Compose, YAML parser, authentication/authorization system, database ORM +## arch +Specification-driven architecture with requirements documented in a single markdown file, focusing on API design, template validation, and environment configuration patterns. +## tags +spec, defines, requirements, tool, type, management, system, crud +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-types-definition/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/spec.md similarity index 100% rename from openspec/specs/tool-types-definition/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types-definition/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md new file mode 100644 index 0000000..2c6e937 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-types (index) +dir: 2026-06-14-completed-specs-archive/tool-types + +## role +Defines requirements for migrating tool type definitions from code to database storage with validation and migration capabilities. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tool-types/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.md new file mode 100644 index 0000000..52089a9 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tool-types +dir: 2026-06-14-completed-specs-archive/tool-types + +index: 2026-06-14-completed-specs-archive/tool-types/.pi-map.index.md + +## role +Defines requirements for migrating tool type definitions from code to database storage with validation and migration capabilities. +## files +- spec.md | Defines modified requirements for a tool type management system with database-stored definitions, Docker Compose template validation, and migration of built-in tools to regular records. | dep: database, docker compose validation, migration system +## arch +Specification-driven architecture using markdown-based requirements with Docker Compose template validation and database-backed configuration management. +## tags +database, spec, defines, modified, requirements, tool, type, management +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tool-types/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/spec.md similarity index 100% rename from openspec/specs/tool-types/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tool-types/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md new file mode 100644 index 0000000..777a445 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/traefik-deployment (index) +dir: 2026-06-14-completed-specs-archive/traefik-deployment + +## role +Defines deployment specifications for the Traefik reverse proxy/load balancer using Docker Compose +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md new file mode 100644 index 0000000..faf77fb --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/traefik-deployment +dir: 2026-06-14-completed-specs-archive/traefik-deployment + +index: 2026-06-14-completed-specs-archive/traefik-deployment/.pi-map.index.md + +## role +Defines deployment specifications for the Traefik reverse proxy/load balancer using Docker Compose +## files +- spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC +## arch +Infrastructure-as-code pattern with containerized reverse proxy, environment-based configuration, and declarative service specification +## tags +traefik, spec, specifies, requirements, docker, compose, deployment, configuration +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/traefik-deployment/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/spec.md similarity index 100% rename from openspec/specs/traefik-deployment/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/traefik-deployment/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md new file mode 100644 index 0000000..e47d7f7 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tunnel-health-monitoring (index) +dir: 2026-06-14-completed-specs-archive/tunnel-health-monitoring + +## role +Defines specifications for automated health monitoring and recovery of cloudflared tunnels to ensure persistent connectivity for running instances. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md new file mode 100644 index 0000000..2ee20c3 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/tunnel-health-monitoring +dir: 2026-06-14-completed-specs-archive/tunnel-health-monitoring + +index: 2026-06-14-completed-specs-archive/tunnel-health-monitoring/.pi-map.index.md + +## role +Defines specifications for automated health monitoring and recovery of cloudflared tunnels to ensure persistent connectivity for running instances. +## files +- spec.md | Defines requirements for monitoring and recreating cloudflared tunnels for running instances | dep: cloudflared, HTTP health checks, UI components +## arch +Requirements-driven specification document using prose-based system design with functional requirements, success criteria, and operational parameters for a tunnel health monitoring subsystem. +## tags +cloudflared, spec, defines, requirements, monitoring, recreating, tunnels, running +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/tunnel-health-monitoring/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/spec.md similarity index 100% rename from openspec/specs/tunnel-health-monitoring/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/tunnel-health-monitoring/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md new file mode 100644 index 0000000..8dc06f6 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/user-config (index) +dir: 2026-06-14-completed-specs-archive/user-config + +## role +Defines data specifications for a JSONB-based user preference configuration system with frontend theme integration. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/user-config/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/user-config/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.md new file mode 100644 index 0000000..cddcc49 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/.pi-map.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/user-config +dir: 2026-06-14-completed-specs-archive/user-config + +index: 2026-06-14-completed-specs-archive/user-config/.pi-map.index.md + +## role +Defines data specifications for a JSONB-based user preference configuration system with frontend theme integration. +## files +- spec.md | Defines specifications for a user configuration system that stores JSONB key-value preferences, supports specific config keys, and integrates with frontend theme application. | dep: UserConfig, User, auth-oauth, pytest, mypy, ruff, npm +## arch +Specification-driven schema design using JSONB key-value store with enumerated config keys and frontend theme mapping pattern. +## tags +user, spec, defines, specifications, configuration, system, stores, jsonb +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/specs/user-config/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/spec.md similarity index 100% rename from openspec/specs/user-config/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/user-config/spec.md diff --git a/openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md new file mode 100644 index 0000000..395d4f8 --- /dev/null +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md @@ -0,0 +1,19 @@ +# 2026-06-14-completed-specs-archive/user-profile (index) +dir: 2026-06-14-completed-specs-archive/user-profile + +## role +Defines functional specifications for user profile retrieval, updates, and local avatar storage. +## parent +index: 2026-06-14-completed-specs-archive/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/.pi-map.md +## children +- +## files +- spec.md +## links +index: 2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md +map: 2026-06-14-completed-specs-archive/user-profile/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/specs/user-profile/.pi-map.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.md similarity index 51% rename from openspec/specs/user-profile/.pi-map.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.md index 3004bc6..603213b 100644 --- a/openspec/specs/user-profile/.pi-map.md +++ b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/.pi-map.md @@ -1,14 +1,14 @@ -# openspec/specs/user-profile -dir: openspec/specs/user-profile +# 2026-06-14-completed-specs-archive/user-profile +dir: 2026-06-14-completed-specs-archive/user-profile -index: openspec/specs/user-profile/.pi-map.index.md +index: 2026-06-14-completed-specs-archive/user-profile/.pi-map.index.md ## role -Defines functional specifications for user profile management capabilities including retrieval, updates, and local avatar storage +Defines functional specifications for user profile 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 ## arch -Specification-driven documentation pattern using markdown-based requirements definition without implementation code +Specification-driven design with clear functional requirements documentation. ## tags profile, npm, spec, defines, functional, specifications, user, management ## symbols diff --git a/openspec/specs/user-profile/spec.md b/openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/spec.md similarity index 100% rename from openspec/specs/user-profile/spec.md rename to openspec/changes/archive/2026-06-14-completed-specs-archive/user-profile/spec.md diff --git a/openspec/changes/fix-terminal-container-overflow/.pi-map.index.md b/openspec/changes/fix-terminal-container-overflow/.pi-map.index.md new file mode 100644 index 0000000..76f1886 --- /dev/null +++ b/openspec/changes/fix-terminal-container-overflow/.pi-map.index.md @@ -0,0 +1,20 @@ +# changes/fix-terminal-container-overflow (index) +dir: changes/fix-terminal-container-overflow + +## role +CSS bug fix for terminal container overflow issue on desktop viewports +## parent +index: changes/.pi-map.index.md +map: changes/.pi-map.md +## children +- +## files +- change.md +- tasks.md +## links +index: changes/fix-terminal-container-overflow/.pi-map.index.md +map: changes/fix-terminal-container-overflow/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/fix-terminal-container-overflow/.pi-map.md b/openspec/changes/fix-terminal-container-overflow/.pi-map.md new file mode 100644 index 0000000..a6e803d --- /dev/null +++ b/openspec/changes/fix-terminal-container-overflow/.pi-map.md @@ -0,0 +1,20 @@ +# changes/fix-terminal-container-overflow +dir: changes/fix-terminal-container-overflow + +index: changes/fix-terminal-container-overflow/.pi-map.index.md + +## role +CSS bug fix for terminal container overflow issue on desktop viewports +## files +- change.md | Documents a CSS flexbox bug fix for terminal container overflow on desktop by adding min-height: 0 to prevent intrinsic content expansion | dep: CSS flexbox, xterm.js, apps/web/src/styles/utilities.css +- tasks.md | Tracks completed tasks for fixing a terminal container overflow bug on desktop via CSS adjustments. +## arch +Simple documentation-only change package using markdown files to track a single CSS flexbox fix (min-height: 0) with no code implementation files present +## tags +css, tasks, bug, terminal, container, overflow, desktop, change +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/changes/fix-tmux-mouse-config/.pi-map.index.md b/openspec/changes/fix-tmux-mouse-config/.pi-map.index.md new file mode 100644 index 0000000..95f4e76 --- /dev/null +++ b/openspec/changes/fix-tmux-mouse-config/.pi-map.index.md @@ -0,0 +1,20 @@ +# changes/fix-tmux-mouse-config (index) +dir: changes/fix-tmux-mouse-config + +## role +Documents a bug fix for tmux mouse configuration in Pi Agent Docker images where single-quoted echo strings prevented newline interpretation. +## parent +index: changes/.pi-map.index.md +map: changes/.pi-map.md +## children +- +## files +- change.md +- tasks.md +## links +index: changes/fix-tmux-mouse-config/.pi-map.index.md +map: changes/fix-tmux-mouse-config/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/fix-tmux-mouse-config/.pi-map.md b/openspec/changes/fix-tmux-mouse-config/.pi-map.md new file mode 100644 index 0000000..db07ea9 --- /dev/null +++ b/openspec/changes/fix-tmux-mouse-config/.pi-map.md @@ -0,0 +1,20 @@ +# changes/fix-tmux-mouse-config +dir: changes/fix-tmux-mouse-config + +index: changes/fix-tmux-mouse-config/.pi-map.index.md + +## role +Documents a bug fix for tmux mouse configuration in Pi Agent Docker images where single-quoted echo strings prevented newline interpretation. +## files +- change.md | Documents a bug fix for tmux mouse mode configuration in Pi Agent Docker images caused by single-quoted echo strings preventing newline interpretation of \n. | dep: tmux, Docker, Python, Alembic, xterm.js +- tasks.md | Track completion of tasks to fix tmux mouse mode configuration by replacing literal `\n` with proper newlines in Pi Agent dockerfiles and migration files. +## arch +Simple documentation-based change tracking using markdown files (change.md for problem description, tasks.md for task checklist) to coordinate a configuration fix across dockerfiles and migration files. +## tags +tmux, tasks, fix, mouse, mode, configuration, agent, docker +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-config-profiles-ui/.pi-map.index.md b/openspec/changes/mobile-config-profiles-ui/.pi-map.index.md new file mode 100644 index 0000000..c224fdb --- /dev/null +++ b/openspec/changes/mobile-config-profiles-ui/.pi-map.index.md @@ -0,0 +1,20 @@ +# changes/mobile-config-profiles-ui (index) +dir: changes/mobile-config-profiles-ui + +## role +Product specification and task tracking for a mobile UI rework of configuration profiles to achieve desktop feature parity. +## parent +index: changes/.pi-map.index.md +map: changes/.pi-map.md +## children +- +## files +- change.md +- tasks.md +## links +index: changes/mobile-config-profiles-ui/.pi-map.index.md +map: changes/mobile-config-profiles-ui/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-config-profiles-ui/.pi-map.md b/openspec/changes/mobile-config-profiles-ui/.pi-map.md new file mode 100644 index 0000000..504c242 --- /dev/null +++ b/openspec/changes/mobile-config-profiles-ui/.pi-map.md @@ -0,0 +1,20 @@ +# changes/mobile-config-profiles-ui +dir: changes/mobile-config-profiles-ui + +index: changes/mobile-config-profiles-ui/.pi-map.index.md + +## role +Product specification and task tracking for a mobile UI rework of configuration profiles to achieve desktop feature parity. +## files +- change.md | This file is a product specification document defining a UI rework task to bring mobile Config Profiles pages to parity with desktop functionality. +- tasks.md | Task checklist tracking the completion of a mobile UI rework for configuration profiles. +## arch +Documentation-driven project management with markdown-based specification (change.md) and checklist-based task tracking (tasks.md). +## tags +rework, task, mobile, profiles, change, tasks, product, specification +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-edit-default-bottom-actions/.pi-map.index.md b/openspec/changes/mobile-edit-default-bottom-actions/.pi-map.index.md new file mode 100644 index 0000000..0bcc9b0 --- /dev/null +++ b/openspec/changes/mobile-edit-default-bottom-actions/.pi-map.index.md @@ -0,0 +1,20 @@ +# changes/mobile-edit-default-bottom-actions (index) +dir: changes/mobile-edit-default-bottom-actions + +## role +Implements a mobile UX pattern change that makes edit mode the default view with persistent bottom action bars for saving and deleting items. +## parent +index: changes/.pi-map.index.md +map: changes/.pi-map.md +## children +- +## files +- change.md +- tasks.md +## links +index: changes/mobile-edit-default-bottom-actions/.pi-map.index.md +map: changes/mobile-edit-default-bottom-actions/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-edit-default-bottom-actions/.pi-map.md b/openspec/changes/mobile-edit-default-bottom-actions/.pi-map.md new file mode 100644 index 0000000..960a328 --- /dev/null +++ b/openspec/changes/mobile-edit-default-bottom-actions/.pi-map.md @@ -0,0 +1,20 @@ +# changes/mobile-edit-default-bottom-actions +dir: changes/mobile-edit-default-bottom-actions + +index: changes/mobile-edit-default-bottom-actions/.pi-map.index.md + +## role +Implements a mobile UX pattern change that makes edit mode the default view with persistent bottom action bars for saving and deleting items. +## files +- change.md | Documents a mobile UX change that makes edit mode the default view for config profiles and tool types, with sticky bottom action bars for Save/Delete buttons. +- tasks.md | Task checklist for implementing mobile edit-as-default UI pattern with sticky bottom action bars across multiple views | dep: MobileEditView, ConfigProfilesMobileView, ToolWorkshopMobileView, CSS modules, npm tooling +## arch +UX pattern migration using sticky bottom action bars as a consistent cross-view mobile UI component for primary actions. +## tags +change, mobile, edit, default, sticky, bottom, action, bars +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-list-delete-button/.pi-map.index.md b/openspec/changes/mobile-list-delete-button/.pi-map.index.md new file mode 100644 index 0000000..48d9965 --- /dev/null +++ b/openspec/changes/mobile-list-delete-button/.pi-map.index.md @@ -0,0 +1,20 @@ +# changes/mobile-list-delete-button (index) +dir: changes/mobile-list-delete-button + +## role +Implements mobile UI fixes to restore missing delete/duplicate buttons in list views and correct sticky action bar positioning above mobile navigation. +## parent +index: changes/.pi-map.index.md +map: changes/.pi-map.md +## children +- +## files +- change.md +- tasks.md +## links +index: changes/mobile-list-delete-button/.pi-map.index.md +map: changes/mobile-list-delete-button/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-list-delete-button/.pi-map.md b/openspec/changes/mobile-list-delete-button/.pi-map.md new file mode 100644 index 0000000..38c35c2 --- /dev/null +++ b/openspec/changes/mobile-list-delete-button/.pi-map.md @@ -0,0 +1,20 @@ +# changes/mobile-list-delete-button +dir: changes/mobile-list-delete-button + +index: changes/mobile-list-delete-button/.pi-map.index.md + +## role +Implements mobile UI fixes to restore missing delete/duplicate buttons in list views and correct sticky action bar positioning above mobile navigation. +## files +- change.md | Documents UI fixes to restore delete/duplicate buttons in mobile list views and reposition a sticky action bar above mobile navigation. | dep: MobileListView, MobileEditView, ToolWorkshopMobileView, ConfigProfilesMobileView, utilities.css +- tasks.md | Task checklist documenting implementation of mobile UI fixes for list view delete/duplicate buttons and edit view sticky action bar positioning. +## arch +Documentation-driven change tracking using markdown-based design documents (change.md for requirements, tasks.md for implementation checklist) without actual source code in this directory. +## tags +mobile, fixes, delete, duplicate, buttons, list, sticky, action +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-tool-profile-ui/.pi-map.index.md b/openspec/changes/mobile-tool-profile-ui/.pi-map.index.md new file mode 100644 index 0000000..98e570b --- /dev/null +++ b/openspec/changes/mobile-tool-profile-ui/.pi-map.index.md @@ -0,0 +1,20 @@ +# changes/mobile-tool-profile-ui (index) +dir: changes/mobile-tool-profile-ui + +## role +Mobile UI modernization package for adapting Tool Workshop and Profile pages to responsive/mobile-first design while maintaining desktop compatibility. +## parent +index: changes/.pi-map.index.md +map: changes/.pi-map.md +## children +- +## files +- change.md +- tasks.md +## links +index: changes/mobile-tool-profile-ui/.pi-map.index.md +map: changes/mobile-tool-profile-ui/.pi-map.md +## workflows +- +## dirty +- diff --git a/openspec/changes/mobile-tool-profile-ui/.pi-map.md b/openspec/changes/mobile-tool-profile-ui/.pi-map.md new file mode 100644 index 0000000..f27c25b --- /dev/null +++ b/openspec/changes/mobile-tool-profile-ui/.pi-map.md @@ -0,0 +1,20 @@ +# changes/mobile-tool-profile-ui +dir: changes/mobile-tool-profile-ui + +index: changes/mobile-tool-profile-ui/.pi-map.index.md + +## role +Mobile UI modernization package for adapting Tool Workshop and Profile pages to responsive/mobile-first design while maintaining desktop compatibility. +## files +- change.md | Requirements specification for reworking mobile UI of Tool Workshop and Profile pages while preserving desktop functionality +- tasks.md | This file is a completed task checklist documenting the rework of mobile UI components for a tool workshop and profile page in a web application. +## arch +Requirements-driven incremental migration pattern with task-based completion tracking, separating mobile-specific component rework from preserved desktop functionality through feature-parallel development workflow. +## tags +mobile, tool, workshop, profile, change, tasks, requirements, specification +## symbols +- +## workflows +- +## dirty +- diff --git a/openspec/designs/.pi-map.index.md b/openspec/designs/.pi-map.index.md index 5db0a0c..67df3b1 100644 --- a/openspec/designs/.pi-map.index.md +++ b/openspec/designs/.pi-map.index.md @@ -1,11 +1,11 @@ -# openspec/designs (index) -dir: openspec/designs +# designs (index) +dir: designs ## role -Design document repository for architectural specifications and technical planning of containerized development environment features. +Contains architectural design documents specifying features for containerized development environments, mount configurations, and terminal infrastructure. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -16,8 +16,8 @@ map: openspec/.pi-map.md - tool-container-home-directory.md - tool-definition-manifest.md ## links -index: openspec/designs/.pi-map.index.md -map: openspec/designs/.pi-map.md +index: designs/.pi-map.index.md +map: designs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/designs/.pi-map.md b/openspec/designs/.pi-map.md index 044cbe8..c6eb578 100644 --- a/openspec/designs/.pi-map.md +++ b/openspec/designs/.pi-map.md @@ -1,10 +1,10 @@ -# openspec/designs -dir: openspec/designs +# designs +dir: designs -index: openspec/designs/.pi-map.index.md +index: designs/.pi-map.index.md ## role -Design document repository for architectural specifications and technical planning of containerized development environment features. +Contains architectural design documents specifying features for containerized development environments, mount configurations, and terminal infrastructure. ## files - config-profile-multi-repo-mounts.md | Design document for extending git mount configuration to support multiple source-to-target mappings per repository in a config profile system. | dep: JSONB, Python, TypeScript, React, os.path, glob expansion, config profile API, tool instances API - home-path-expansion.md | Design document for implementing `~` and `$HOME` expansion in container mount paths based on manifest user configuration | dep: config_profile_resolver.py, manifest_compiler.py, tool_instances.py, os @@ -13,7 +13,7 @@ Design document repository for architectural specifications and technical planni - tool-container-home-directory.md | Proposes a design for standardizing tool container home directories to `/home/user` with configurable paths, meaningful repo mounts, and backward-compatible `/workspace` symlinks. | dep: ToolType model, manifest schema, Alembic, Docker/dockerfile, compose, config-profile mounts, git mounts, entrypoint permission fixer, home-path-expansion - tool-definition-manifest.md | Defines a system for creating, validating, and compiling tool definition manifests into Dockerfiles, Docker Compose files, and entrypoint scripts for containerized development environments. | dep: Docker, PostgreSQL, Python (json, hashlib, shlex, yaml, subprocess), JSON Schema, deb/nodesource package repositories ## arch -Markdown-based RFC-style design documents covering configuration systems, container filesystem layout, terminal I/O architecture, and Docker toolchain generation with emphasis on backward compatibility and incremental feature rollout. +Design-driven specification pattern using Markdown RFCs covering config systems, path resolution, mount ordering, async I/O with WebSocket/WebGL, and container manifest compilation pipelines. ## tags home, py, docker, tool, design, path, mounts, mount ## symbols diff --git a/openspec/docs/.pi-map.index.md b/openspec/docs/.pi-map.index.md index a046844..1c7d9b3 100644 --- a/openspec/docs/.pi-map.index.md +++ b/openspec/docs/.pi-map.index.md @@ -1,18 +1,18 @@ -# openspec/docs (index) -dir: openspec/docs +# docs (index) +dir: docs ## role -End-user documentation for the platform's tool type definition and management capabilities, covering both legacy container-based and modern declarative manifest approaches. +End-user documentation for the platform's tool type system, explaining how to create and manage container-based tools. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files - tool-workshop-guide.md ## links -index: openspec/docs/.pi-map.index.md -map: openspec/docs/.pi-map.md +index: docs/.pi-map.index.md +map: docs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/docs/.pi-map.md b/openspec/docs/.pi-map.md index abb08c4..01a7829 100644 --- a/openspec/docs/.pi-map.md +++ b/openspec/docs/.pi-map.md @@ -1,14 +1,14 @@ -# openspec/docs -dir: openspec/docs +# docs +dir: docs -index: openspec/docs/.pi-map.index.md +index: docs/.pi-map.index.md ## role -End-user documentation for the platform's tool type definition and management capabilities, covering both legacy container-based and modern declarative manifest approaches. +End-user documentation for the platform's tool type system, explaining how to create and manage container-based tools. ## files - tool-workshop-guide.md | User guide for defining and managing container-based tool types in a platform called Headquarter using legacy (Compose/Dockerfile) or recommended declarative manifest approaches. | dep: Docker, Docker Compose, JSON, apt, npm, pip, Node.js, git, ssh ## arch -Static markdown documentation with no code architecture; follows a tutorial/guide pattern with progressive disclosure from legacy Docker/Compose workflows to recommended declarative manifest specifications. +Static markdown documentation with tutorial-style instructional content, covering both legacy (Docker Compose/Dockerfile) and modern declarative manifest approaches. ## tags guide, tool, workshop, user, defining, managing, container, types ## symbols diff --git a/openspec/explorations/.pi-map.index.md b/openspec/explorations/.pi-map.index.md index ec3cda4..32fce27 100644 --- a/openspec/explorations/.pi-map.index.md +++ b/openspec/explorations/.pi-map.index.md @@ -1,11 +1,11 @@ -# openspec/explorations (index) -dir: openspec/explorations +# explorations (index) +dir: explorations ## role -Design exploration and technical specification documents for container instance management system features and architectural improvements. +Contains design exploration documents for proposed features and architectural improvements in a container instance management system. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -17,8 +17,8 @@ map: openspec/.pi-map.md - streamline-tool-container-definitions.md - terminal-responsiveness.md ## links -index: openspec/explorations/.pi-map.index.md -map: openspec/explorations/.pi-map.md +index: explorations/.pi-map.index.md +map: explorations/.pi-map.md ## workflows - ## dirty diff --git a/openspec/explorations/.pi-map.md b/openspec/explorations/.pi-map.md index 0fdb858..7ec7c6a 100644 --- a/openspec/explorations/.pi-map.md +++ b/openspec/explorations/.pi-map.md @@ -1,10 +1,10 @@ -# openspec/explorations -dir: openspec/explorations +# explorations +dir: explorations -index: openspec/explorations/.pi-map.index.md +index: explorations/.pi-map.index.md ## role -Design exploration and technical specification documents for container instance management system features and architectural improvements. +Contains design exploration documents for proposed features and architectural improvements in a container instance management system. ## files - config-profile-multi-repo-mounts.md | Proposes a design for supporting multiple directory mounts from a single git repository clone in config profiles, avoiding redundant clones. - home-path-expansion.md | Explores design options for expanding `~` and `$HOME` in container mount paths based on target container user context | dep: config_profile_resolver.py, tool_instances.py, manifest_compiler.py, Docker Compose @@ -14,7 +14,7 @@ Design exploration and technical specification documents for container instance - streamline-tool-container-definitions.md | Explores architectural redesign of a tool container definition system to replace monolithic Dockerfile strings and ad-hoc compose generation with a layered, declarative approach | dep: Docker, Docker Compose, SQLAlchemy, Python f-strings/Jinja, Ubuntu base images, Cloudflare tunnels, PTY/WebSocket terminals - terminal-responsiveness.md | Explores architectural improvements to achieve low-latency terminal I/O performance comparable to VS Code Server by identifying bottlenecks and proposing optimizations for a WebSocket-based web terminal. | dep: xterm.js, WebSocket, asyncio, select, docker, Python, TypeScript, React, node-pty, libuv, Docker Engine API ## arch -Markdown-based design documents following an exploratory RFC pattern, covering mount resolution algorithms, path expansion strategies, container definition layering, and WebSocket optimization techniques. +Markdown-based design documents following an RFC/exploration pattern, each analyzing a specific technical problem space, evaluating alternatives, and proposing solutions across mount systems, config profiles, container definitions, and terminal I/O performance. ## tags mounts, container, mount, py, path, design, config, level ## symbols diff --git a/openspec/proposals/.pi-map.index.md b/openspec/proposals/.pi-map.index.md index 3183c69..65ff70d 100644 --- a/openspec/proposals/.pi-map.index.md +++ b/openspec/proposals/.pi-map.index.md @@ -1,11 +1,11 @@ -# openspec/proposals (index) -dir: openspec/proposals +# proposals (index) +dir: proposals ## role -Contains architectural design proposals for extending and improving the OpenSpec project's container tooling, configuration, and terminal performance capabilities. +Houses architectural design proposals for future system enhancements and refinements. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -15,8 +15,8 @@ map: openspec/.pi-map.md - streamline-tool-container-definitions.md - terminal-responsiveness.md ## links -index: openspec/proposals/.pi-map.index.md -map: openspec/proposals/.pi-map.md +index: proposals/.pi-map.index.md +map: proposals/.pi-map.md ## workflows - ## dirty diff --git a/openspec/proposals/.pi-map.md b/openspec/proposals/.pi-map.md index 702ab1a..01d91b5 100644 --- a/openspec/proposals/.pi-map.md +++ b/openspec/proposals/.pi-map.md @@ -1,10 +1,10 @@ -# openspec/proposals -dir: openspec/proposals +# proposals +dir: proposals -index: openspec/proposals/.pi-map.index.md +index: proposals/.pi-map.index.md ## role -Contains architectural design proposals for extending and improving the OpenSpec project's container tooling, configuration, and terminal performance capabilities. +Houses architectural design proposals for future system enhancements and refinements. ## files - config-profile-multi-repo-mounts.md | Proposes a backward-compatible extension to Config Profiles' git_mounts to support multiple source/target mappings per repository clone, enabling efficient monorepo directory mounting. - home-path-expansion.md | Proposes expanding `~` and `$HOME` in container mount target paths to the appropriate home directory based on tool manifest user configuration during Docker Compose generation. | dep: Docker Compose, tool manifest, Dockerfile generation, git mounts @@ -12,7 +12,7 @@ Contains architectural design proposals for extending and improving the OpenSpec - streamline-tool-container-definitions.md | Proposes a declarative YAML manifest system to replace hand-written Dockerfiles and Compose files for defining tool containers, with automatic compilation into Docker/Compose artifacts and compatibility with existing ConfigProfile mounts. | dep: Docker, Docker Compose, YAML/JSON parsing, database (PostgreSQL implied by JSONB), Python (implied by syntax examples), Node.js/npm, apt, git - terminal-responsiveness.md | Proposes architectural improvements to reduce web terminal latency and increase rendering performance through asyncio I/O, WebGL rendering, and WebSocket optimizations. | dep: docker, asyncio, WebSocket, WebGL, PTY, Docker Engine API ## arch -Markdown-based RFC/proposal pattern using individual specification documents for distinct feature proposals, covering Docker Compose generation, volume mounting semantics, YAML-driven declarative container definitions, and async I/O/WebSocket optimizations. +Markdown-based RFC-style documentation with no executable code, organized by independent feature proposals spanning configuration, containerization, and performance domains. ## tags mounts, proposes, docker, home, tool, compose, config, target ## symbols diff --git a/openspec/specs/.pi-map.index.md b/openspec/specs/.pi-map.index.md index a893ca8..3d77fb9 100644 --- a/openspec/specs/.pi-map.index.md +++ b/openspec/specs/.pi-map.index.md @@ -1,114 +1,13 @@ -# openspec/specs (index) -dir: openspec/specs +# specs (index) +dir: specs ## role -Contains formal specification documents defining requirements, APIs, algorithms, and test strategies for core platform features across configuration management, container orchestration, terminal I/O, and tool definition systems. +Defines formal specifications and requirements for core system features including container configuration, terminal I/O, and build tooling. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children -- openspec/specs/api-documentation - index: openspec/specs/api-documentation/.pi-map.index.md - map: openspec/specs/api-documentation/.pi-map.md -- openspec/specs/auth-oauth - index: openspec/specs/auth-oauth/.pi-map.index.md - map: openspec/specs/auth-oauth/.pi-map.md -- openspec/specs/database-models - index: openspec/specs/database-models/.pi-map.index.md - map: openspec/specs/database-models/.pi-map.md -- openspec/specs/docker-infrastructure - index: openspec/specs/docker-infrastructure/.pi-map.index.md - map: openspec/specs/docker-infrastructure/.pi-map.md -- openspec/specs/frontend-foundation - index: openspec/specs/frontend-foundation/.pi-map.index.md - map: openspec/specs/frontend-foundation/.pi-map.md -- openspec/specs/git-repo - index: openspec/specs/git-repo/.pi-map.index.md - map: openspec/specs/git-repo/.pi-map.md -- openspec/specs/instance-proxy - index: openspec/specs/instance-proxy/.pi-map.index.md - map: openspec/specs/instance-proxy/.pi-map.md -- openspec/specs/instance-runtime-health - index: openspec/specs/instance-runtime-health/.pi-map.index.md - map: openspec/specs/instance-runtime-health/.pi-map.md -- openspec/specs/instance-startup-health - index: openspec/specs/instance-startup-health/.pi-map.index.md - map: openspec/specs/instance-startup-health/.pi-map.md -- openspec/specs/mobile-list-detail - index: openspec/specs/mobile-list-detail/.pi-map.index.md - map: openspec/specs/mobile-list-detail/.pi-map.md -- openspec/specs/mobile-navigation - index: openspec/specs/mobile-navigation/.pi-map.index.md - map: openspec/specs/mobile-navigation/.pi-map.md -- openspec/specs/mobile-repo-workspace - index: openspec/specs/mobile-repo-workspace/.pi-map.index.md - map: openspec/specs/mobile-repo-workspace/.pi-map.md -- openspec/specs/mobile-tools-navigation - index: openspec/specs/mobile-tools-navigation/.pi-map.index.md - map: openspec/specs/mobile-tools-navigation/.pi-map.md -- openspec/specs/opencode-web-server - index: openspec/specs/opencode-web-server/.pi-map.index.md - map: openspec/specs/opencode-web-server/.pi-map.md -- openspec/specs/project-management - index: openspec/specs/project-management/.pi-map.index.md - map: openspec/specs/project-management/.pi-map.md -- openspec/specs/readiness-probe-integration - index: openspec/specs/readiness-probe-integration/.pi-map.index.md - map: openspec/specs/readiness-probe-integration/.pi-map.md -- openspec/specs/repo-clone-mode - index: openspec/specs/repo-clone-mode/.pi-map.index.md - map: openspec/specs/repo-clone-mode/.pi-map.md -- openspec/specs/session-lifecycle-ux - index: openspec/specs/session-lifecycle-ux/.pi-map.index.md - map: openspec/specs/session-lifecycle-ux/.pi-map.md -- openspec/specs/sessions-hub - index: openspec/specs/sessions-hub/.pi-map.index.md - map: openspec/specs/sessions-hub/.pi-map.md -- openspec/specs/smart-tunnel-recovery - index: openspec/specs/smart-tunnel-recovery/.pi-map.index.md - map: openspec/specs/smart-tunnel-recovery/.pi-map.md -- openspec/specs/ssh-keys - index: openspec/specs/ssh-keys/.pi-map.index.md - map: openspec/specs/ssh-keys/.pi-map.md -- openspec/specs/tool-config-management - index: openspec/specs/tool-config-management/.pi-map.index.md - map: openspec/specs/tool-config-management/.pi-map.md -- openspec/specs/tool-instances - index: openspec/specs/tool-instances/.pi-map.index.md - map: openspec/specs/tool-instances/.pi-map.md -- openspec/specs/tool-port-configuration - index: openspec/specs/tool-port-configuration/.pi-map.index.md - map: openspec/specs/tool-port-configuration/.pi-map.md -- openspec/specs/tool-terminal - index: openspec/specs/tool-terminal/.pi-map.index.md - map: openspec/specs/tool-terminal/.pi-map.md -- openspec/specs/tool-terminal-startup-command - index: openspec/specs/tool-terminal-startup-command/.pi-map.index.md - map: openspec/specs/tool-terminal-startup-command/.pi-map.md -- openspec/specs/tool-type-port-visibility - index: openspec/specs/tool-type-port-visibility/.pi-map.index.md - map: openspec/specs/tool-type-port-visibility/.pi-map.md -- openspec/specs/tool-type-single-interface - index: openspec/specs/tool-type-single-interface/.pi-map.index.md - map: openspec/specs/tool-type-single-interface/.pi-map.md -- openspec/specs/tool-types - index: openspec/specs/tool-types/.pi-map.index.md - map: openspec/specs/tool-types/.pi-map.md -- openspec/specs/tool-types-definition - index: openspec/specs/tool-types-definition/.pi-map.index.md - map: openspec/specs/tool-types-definition/.pi-map.md -- openspec/specs/traefik-deployment - index: openspec/specs/traefik-deployment/.pi-map.index.md - map: openspec/specs/traefik-deployment/.pi-map.md -- openspec/specs/tunnel-health-monitoring - index: openspec/specs/tunnel-health-monitoring/.pi-map.index.md - map: openspec/specs/tunnel-health-monitoring/.pi-map.md -- openspec/specs/user-config - index: openspec/specs/user-config/.pi-map.index.md - map: openspec/specs/user-config/.pi-map.md -- openspec/specs/user-profile - index: openspec/specs/user-profile/.pi-map.index.md - map: openspec/specs/user-profile/.pi-map.md +- ## files - config-profile-multi-repo-mounts.md - home-path-expansion.md @@ -116,8 +15,8 @@ map: openspec/.pi-map.md - terminal-responsiveness.md - tool-definition-manifest.md ## links -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md +index: specs/.pi-map.index.md +map: specs/.pi-map.md ## workflows - ## dirty diff --git a/openspec/specs/.pi-map.md b/openspec/specs/.pi-map.md index 2bd41cb..ead525c 100644 --- a/openspec/specs/.pi-map.md +++ b/openspec/specs/.pi-map.md @@ -1,10 +1,10 @@ -# openspec/specs -dir: openspec/specs +# specs +dir: specs -index: openspec/specs/.pi-map.index.md +index: specs/.pi-map.index.md ## role -Contains formal specification documents defining requirements, APIs, algorithms, and test strategies for core platform features across configuration management, container orchestration, terminal I/O, and tool definition systems. +Defines formal specifications and requirements for core system features including container configuration, terminal I/O, and build tooling. ## files - config-profile-multi-repo-mounts.md | Specifies requirements, API contracts, and test strategy for supporting multiple directory mappings per git repository mount in configuration profiles - home-path-expansion.md | Specifies requirements for expanding `~` and `$HOME` in container mount paths during Docker compose generation based on manifest user configuration. @@ -12,7 +12,7 @@ Contains formal specification documents defining requirements, APIs, algorithms, - terminal-responsiveness.md | Specification document for a high-performance web terminal I/O pipeline rewrite targeting sub-frame latency with event-driven PTY reading, output batching, flow control, and WebGL rendering. | dep: asyncio, pty, docker, WebSocket, xterm.js, WebGL, TypeScript, Python - tool-definition-manifest.md | Specifies a declarative manifest system for defining tool containers without Dockerfiles, including compilation to Docker/Compose, versioning, permission policies, and backward compatibility. | dep: Docker, Docker Compose, JSON Schema, database (PostgreSQL with JSONB), Alembic, Python/FastAPI (implied by paths) ## arch -Specification-driven development pattern using Markdown-based RFCs/ADRs that separate design documentation from implementation, covering behavioral contracts, edge cases, and verification strategies before coding. +Document-driven specification pattern with Markdown-based RFCs covering API contracts, algorithms, and test strategies for cross-functional alignment before implementation. ## tags mounts, docker, specifies, mount, manifest, requirements, home, path ## symbols diff --git a/openspec/specs/api-documentation/.pi-map.index.md b/openspec/specs/api-documentation/.pi-map.index.md deleted file mode 100644 index b218f8a..0000000 --- a/openspec/specs/api-documentation/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/api-documentation (index) -dir: openspec/specs/api-documentation - -## role -Defines OpenAPI specification, health monitoring, and developer onboarding requirements for the FastAPI-based system. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/api-documentation/.pi-map.index.md -map: openspec/specs/api-documentation/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/api-documentation/.pi-map.md b/openspec/specs/api-documentation/.pi-map.md deleted file mode 100644 index 2292a35..0000000 --- a/openspec/specs/api-documentation/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/api-documentation -dir: openspec/specs/api-documentation - -index: openspec/specs/api-documentation/.pi-map.index.md - -## role -Defines OpenAPI specification, health monitoring, and developer onboarding requirements for the FastAPI-based system. -## files -- spec.md | Define API documentation, health monitoring, and developer onboarding requirements for a FastAPI-based system. | dep: FastAPI, Pydantic v2, Swagger UI, Database, Redis -## arch -Specification-driven documentation using Markdown-based requirements with FastAPI-native patterns (OpenAPI, health endpoints, auto-generated docs). -## tags -fastapi, spec, define, api, documentation, health, monitoring, developer -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/auth-oauth/.pi-map.index.md b/openspec/specs/auth-oauth/.pi-map.index.md deleted file mode 100644 index ec9ee21..0000000 --- a/openspec/specs/auth-oauth/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/auth-oauth (index) -dir: openspec/specs/auth-oauth - -## role -Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/auth-oauth/.pi-map.index.md -map: openspec/specs/auth-oauth/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/auth-oauth/.pi-map.md b/openspec/specs/auth-oauth/.pi-map.md deleted file mode 100644 index 77cc3eb..0000000 --- a/openspec/specs/auth-oauth/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/auth-oauth -dir: openspec/specs/auth-oauth - -index: openspec/specs/auth-oauth/.pi-map.index.md - -## role -Defines authentication and authorization requirements for OAuth2/OIDC integration with Authentik identity provider -## files -- spec.md | Specifies OAuth2/OIDC authentication requirements using Authentik with secure session handling, token refresh, and logout functionality | dep: Authentik OIDC provider, Database (User model), pytest, mypy, ruff -## arch -Specification-driven contract using markdown-based OpenAPI-style documentation for security requirements, session lifecycle, and token management patterns -## tags -spec, specifies, oauth2, oidc, authentication, requirements, authentik, secure -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/database-models/.pi-map.index.md b/openspec/specs/database-models/.pi-map.index.md deleted file mode 100644 index a80a2ab..0000000 --- a/openspec/specs/database-models/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/database-models (index) -dir: openspec/specs/database-models - -## role -Defines the database schema, SQLAlchemy 2.0 async ORM models, and migration infrastructure for the Headquarter platform's six core entities. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/database-models/.pi-map.index.md -map: openspec/specs/database-models/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/database-models/.pi-map.md b/openspec/specs/database-models/.pi-map.md deleted file mode 100644 index a6c90e4..0000000 --- a/openspec/specs/database-models/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/database-models -dir: openspec/specs/database-models - -index: openspec/specs/database-models/.pi-map.index.md - -## role -Defines the database schema, SQLAlchemy 2.0 async ORM models, and migration infrastructure for the Headquarter platform's six core entities. -## files -- spec.md | Define database schema and SQLAlchemy 2.0 async models for the Headquarter platform with six core entities, Alembic migrations, and seeding. | dep: PostgreSQL, SQLAlchemy 2.0, asyncpg, Alembic, Fernet, pytest, mypy, ruff -## arch -Specification-driven architecture using SQLAlchemy 2.0 async declarative models with Alembic for migrations, seeding support, and strict separation between schema definition and implementation. -## tags -alembic, spec, define, database, schema, sqlalchemy, async, models -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/docker-infrastructure/.pi-map.index.md b/openspec/specs/docker-infrastructure/.pi-map.index.md deleted file mode 100644 index 2c9de54..0000000 --- a/openspec/specs/docker-infrastructure/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/docker-infrastructure (index) -dir: openspec/specs/docker-infrastructure - -## role -Defines Docker-based infrastructure specifications for multi-service development and production deployment environments. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/docker-infrastructure/.pi-map.index.md -map: openspec/specs/docker-infrastructure/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/frontend-foundation/.pi-map.index.md b/openspec/specs/frontend-foundation/.pi-map.index.md deleted file mode 100644 index c8241b8..0000000 --- a/openspec/specs/frontend-foundation/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/frontend-foundation (index) -dir: openspec/specs/frontend-foundation - -## role -Defines the frontend foundation specification for a modern React 18+ TypeScript application with Vite tooling, routing, styling, and authentication patterns. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/frontend-foundation/.pi-map.index.md -map: openspec/specs/frontend-foundation/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/frontend-foundation/.pi-map.md b/openspec/specs/frontend-foundation/.pi-map.md deleted file mode 100644 index bb922e7..0000000 --- a/openspec/specs/frontend-foundation/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/frontend-foundation -dir: openspec/specs/frontend-foundation - -index: openspec/specs/frontend-foundation/.pi-map.index.md - -## role -Defines the frontend foundation specification for a modern React 18+ TypeScript application with Vite tooling, routing, styling, and authentication patterns. -## files -- spec.md | Define a specification for a modern React 18+ TypeScript frontend with Vite, React Router, Tailwind CSS, authenticated routing, responsive layout, and dashboard/tool workshop features. | dep: React 18+, TypeScript 5+, Vite, React Router, Tailwind CSS, Axios -## arch -Specification-driven architecture using Vite for build tooling, React Router for client-side routing with authenticated route guards, Tailwind CSS for utility-first styling, and a modular dashboard/tool workshop layout pattern. -## tags -react, vite, spec, define, specification, modern, typescript, frontend -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/git-repo/.pi-map.index.md b/openspec/specs/git-repo/.pi-map.index.md deleted file mode 100644 index 2f13910..0000000 --- a/openspec/specs/git-repo/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/git-repo (index) -dir: openspec/specs/git-repo - -## role -Defines the specification for a bare git repository management service that coordinates on-disk git storage with database-backed metadata. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/git-repo/.pi-map.index.md -map: openspec/specs/git-repo/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/git-repo/.pi-map.md b/openspec/specs/git-repo/.pi-map.md deleted file mode 100644 index e750917..0000000 --- a/openspec/specs/git-repo/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/git-repo -dir: openspec/specs/git-repo - -index: openspec/specs/git-repo/.pi-map.index.md - -## role -Defines the specification for a bare git repository management service that coordinates on-disk git storage with database-backed metadata. -## files -- spec.md | Specifies requirements for managing bare git repositories on disk with database metadata, including creation, SSH key association, cloning, listing, deletion, and duplicate prevention. | dep: Database models (GitRepository, Project, User), Docker volume for repo storage -## arch -Domain-driven specification pattern with clear separation between storage concerns (filesystem git operations) and metadata concerns (database records), using SSH key-based access control and duplicate prevention logic. -## tags -spec, specifies, requirements, managing, bare, git, repositories, disk -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/instance-proxy/.pi-map.index.md b/openspec/specs/instance-proxy/.pi-map.index.md deleted file mode 100644 index 2ce5ca2..0000000 --- a/openspec/specs/instance-proxy/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/instance-proxy (index) -dir: openspec/specs/instance-proxy - -## role -Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-scoped access control. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/instance-proxy/.pi-map.index.md -map: openspec/specs/instance-proxy/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/instance-proxy/.pi-map.md b/openspec/specs/instance-proxy/.pi-map.md deleted file mode 100644 index 2f4ad29..0000000 --- a/openspec/specs/instance-proxy/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/instance-proxy -dir: openspec/specs/instance-proxy - -index: openspec/specs/instance-proxy/.pi-map.index.md - -## role -Defines the API contract for a secure proxy service that routes HTTP/WebSocket traffic to running tool instances with owner-scoped access control. -## files -- spec.md | Specifies API requirements for an HTTP/WebSocket proxy endpoint that forwards requests to running tool instances with owner-based access control -## arch -Specification-driven API design using markdown-based OpenAPI-style documentation with WebSocket upgrade support, reverse proxy patterns, and owner-based authorization middleware. -## tags -spec, specifies, api, requirements, http, websocket, proxy, endpoint -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/instance-runtime-health/.pi-map.index.md b/openspec/specs/instance-runtime-health/.pi-map.index.md deleted file mode 100644 index 39fa2a3..0000000 --- a/openspec/specs/instance-runtime-health/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/instance-runtime-health (index) -dir: openspec/specs/instance-runtime-health - -## role -Defines health monitoring and container state synchronization requirements for container lifecycle management. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/instance-runtime-health/.pi-map.index.md -map: openspec/specs/instance-runtime-health/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/instance-runtime-health/.pi-map.md b/openspec/specs/instance-runtime-health/.pi-map.md deleted file mode 100644 index 53be827..0000000 --- a/openspec/specs/instance-runtime-health/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/instance-runtime-health -dir: openspec/specs/instance-runtime-health - -index: openspec/specs/instance-runtime-health/.pi-map.index.md - -## role -Defines health monitoring and container state synchronization requirements for container lifecycle management. -## files -- spec.md | Specification document defining health monitoring, polling, and container state synchronization requirements for a container/instance management system | dep: Docker, HTTP tunneling, REST API -## arch -Specification-driven design using requirement-based documentation with polling-based health checks and state reconciliation patterns. -## tags -container, spec, specification, document, defining, health, monitoring, polling -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/instance-startup-health/.pi-map.index.md b/openspec/specs/instance-startup-health/.pi-map.index.md deleted file mode 100644 index 7b3ec40..0000000 --- a/openspec/specs/instance-startup-health/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/instance-startup-health (index) -dir: openspec/specs/instance-startup-health - -## role -Defines behavioral specifications for container health verification during tool instance startup lifecycle. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/instance-startup-health/.pi-map.index.md -map: openspec/specs/instance-startup-health/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/instance-startup-health/.pi-map.md b/openspec/specs/instance-startup-health/.pi-map.md deleted file mode 100644 index 73617d3..0000000 --- a/openspec/specs/instance-startup-health/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/instance-startup-health -dir: openspec/specs/instance-startup-health - -index: openspec/specs/instance-startup-health/.pi-map.index.md - -## role -Defines behavioral specifications for container health verification during tool instance startup lifecycle. -## files -- spec.md | Defines requirements for container startup verification, readiness probe execution, and health monitoring for a tool instance management system using Docker Compose | dep: docker compose, docker ps, readiness probes, tunnels, health endpoints, database -## arch -Specification-driven validation using Markdown-based requirements documentation with Docker Compose integration patterns. -## tags -spec, defines, requirements, container, startup, verification, readiness, probe -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-list-detail/.pi-map.index.md b/openspec/specs/mobile-list-detail/.pi-map.index.md deleted file mode 100644 index cdee820..0000000 --- a/openspec/specs/mobile-list-detail/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-list-detail (index) -dir: openspec/specs/mobile-list-detail - -## role -Defines mobile UI specification for a configuration management system with list/detail views and CRUD operations. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/mobile-list-detail/.pi-map.index.md -map: openspec/specs/mobile-list-detail/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-list-detail/.pi-map.md b/openspec/specs/mobile-list-detail/.pi-map.md deleted file mode 100644 index 93f1af5..0000000 --- a/openspec/specs/mobile-list-detail/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-list-detail -dir: openspec/specs/mobile-list-detail - -index: openspec/specs/mobile-list-detail/.pi-map.index.md - -## role -Defines mobile UI specification for a configuration management system with list/detail views and CRUD operations. -## files -- spec.md | Defines mobile UI requirements for a configuration management system with list views, detail views, editing, and CRUD operations for tool types and config profiles. -## arch -Specification-driven design using markdown-based requirements documentation for mobile list-detail UI pattern with editing capabilities. -## tags -views, spec, defines, mobile, requirements, configuration, management, system -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-navigation/.pi-map.index.md b/openspec/specs/mobile-navigation/.pi-map.index.md deleted file mode 100644 index 52a3ae2..0000000 --- a/openspec/specs/mobile-navigation/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-navigation (index) -dir: openspec/specs/mobile-navigation - -## role -Defines mobile navigation UI requirements for grouped bottom navigation with expandable submenu behavior. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/mobile-navigation/.pi-map.index.md -map: openspec/specs/mobile-navigation/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-navigation/.pi-map.md b/openspec/specs/mobile-navigation/.pi-map.md deleted file mode 100644 index 66fe688..0000000 --- a/openspec/specs/mobile-navigation/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-navigation -dir: openspec/specs/mobile-navigation - -index: openspec/specs/mobile-navigation/.pi-map.index.md - -## role -Defines mobile navigation UI requirements for grouped bottom navigation with expandable submenu behavior. -## files -- spec.md | Defines requirements for grouped bottom navigation with submenu behavior on mobile -## arch -Specification-driven design using markdown-based requirement documentation with behavioral state definitions for mobile-responsive interaction patterns. -## tags -spec, defines, requirements, grouped, bottom, navigation, submenu, behavior -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-repo-workspace/.pi-map.index.md b/openspec/specs/mobile-repo-workspace/.pi-map.index.md deleted file mode 100644 index 8cb6e0e..0000000 --- a/openspec/specs/mobile-repo-workspace/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-repo-workspace (index) -dir: openspec/specs/mobile-repo-workspace - -## role -Defines functional requirements and user interaction specifications for the mobile repository workspace interface. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/mobile-repo-workspace/.pi-map.index.md -map: openspec/specs/mobile-repo-workspace/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-repo-workspace/.pi-map.md b/openspec/specs/mobile-repo-workspace/.pi-map.md deleted file mode 100644 index cd24617..0000000 --- a/openspec/specs/mobile-repo-workspace/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-repo-workspace -dir: openspec/specs/mobile-repo-workspace - -index: openspec/specs/mobile-repo-workspace/.pi-map.index.md - -## role -Defines functional requirements and user interaction specifications for the mobile repository workspace interface. -## files -- spec.md | Define mobile UI requirements for a repository workspace featuring file tree navigation, editor, git, and terminal views -## arch -Specification-driven design using modular view decomposition (file tree, editor, git, terminal) with responsive mobile UX patterns. -## tags -spec, define, mobile, requirements, repository, workspace, featuring, tree -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-tools-navigation/.pi-map.index.md b/openspec/specs/mobile-tools-navigation/.pi-map.index.md deleted file mode 100644 index 800505a..0000000 --- a/openspec/specs/mobile-tools-navigation/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-tools-navigation (index) -dir: openspec/specs/mobile-tools-navigation - -## role -Defines the specification for mobile bottom navigation UI behavior and interaction patterns for the Tools menu. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/mobile-tools-navigation/.pi-map.index.md -map: openspec/specs/mobile-tools-navigation/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/mobile-tools-navigation/.pi-map.md b/openspec/specs/mobile-tools-navigation/.pi-map.md deleted file mode 100644 index 66eaf3c..0000000 --- a/openspec/specs/mobile-tools-navigation/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/mobile-tools-navigation -dir: openspec/specs/mobile-tools-navigation - -index: openspec/specs/mobile-tools-navigation/.pi-map.index.md - -## role -Defines the specification for mobile bottom navigation UI behavior and interaction patterns for the Tools menu. -## files -- spec.md | Defines mobile UI requirements for a grouped "Tools" bottom navigation with a bottom sheet menu and active state indication -## arch -Specification-driven design using markdown-based requirements documentation with behavioral state definitions for UI components. -## tags -bottom, spec, defines, mobile, requirements, grouped, tools, navigation -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/opencode-web-server/.pi-map.index.md b/openspec/specs/opencode-web-server/.pi-map.index.md deleted file mode 100644 index c4bc524..0000000 --- a/openspec/specs/opencode-web-server/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/opencode-web-server (index) -dir: openspec/specs/opencode-web-server - -## role -Defines the specification for a web-based terminal server container that provides browser-accessible development tools via tmux and ranger. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/opencode-web-server/.pi-map.index.md -map: openspec/specs/opencode-web-server/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/opencode-web-server/.pi-map.md b/openspec/specs/opencode-web-server/.pi-map.md deleted file mode 100644 index 1c6d822..0000000 --- a/openspec/specs/opencode-web-server/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/opencode-web-server -dir: openspec/specs/opencode-web-server - -index: openspec/specs/opencode-web-server/.pi-map.index.md - -## role -Defines the specification for a web-based terminal server container that provides browser-accessible development tools via tmux and ranger. -## files -- spec.md | Specifies requirements for OpenCode containers to run a web terminal server on port 3000 with tmux and ranger, exposed through tunnels and UI buttons -## arch -Container-based microservice specification with tunnel-based networking exposure and UI integration points for embedded terminal access. -## tags -spec, specifies, requirements, opencode, containers, run, web, terminal -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/project-management/.pi-map.index.md b/openspec/specs/project-management/.pi-map.index.md deleted file mode 100644 index 6c78ac3..0000000 --- a/openspec/specs/project-management/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/project-management (index) -dir: openspec/specs/project-management - -## role -Defines requirements for a project management system that groups repositories with ownership, access control, and SSH key management. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/project-management/.pi-map.index.md -map: openspec/specs/project-management/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/readiness-probe-integration/.pi-map.index.md b/openspec/specs/readiness-probe-integration/.pi-map.index.md deleted file mode 100644 index b86a164..0000000 --- a/openspec/specs/readiness-probe-integration/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/readiness-probe-integration (index) -dir: openspec/specs/readiness-probe-integration - -## role -Defines requirements for container readiness probe configuration, execution, and result storage during instance startup -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/readiness-probe-integration/.pi-map.index.md -map: openspec/specs/readiness-probe-integration/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/readiness-probe-integration/.pi-map.md b/openspec/specs/readiness-probe-integration/.pi-map.md deleted file mode 100644 index 0b16415..0000000 --- a/openspec/specs/readiness-probe-integration/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/readiness-probe-integration -dir: openspec/specs/readiness-probe-integration - -index: openspec/specs/readiness-probe-integration/.pi-map.index.md - -## role -Defines requirements for container readiness probe configuration, execution, and result storage during instance startup -## files -- spec.md | Defines requirements for container readiness probe configuration, execution, and result storage during instance startup | dep: docker, container orchestration, health endpoint, logging system -## arch -Specification-driven documentation pattern using markdown-based requirements definition with no executable code architecture -## tags -spec, defines, requirements, container, readiness, probe, configuration, execution -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/repo-clone-mode/.pi-map.index.md b/openspec/specs/repo-clone-mode/.pi-map.index.md deleted file mode 100644 index ada2e5f..0000000 --- a/openspec/specs/repo-clone-mode/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/repo-clone-mode (index) -dir: openspec/specs/repo-clone-mode - -## role -Defines the contract for host-side git repository cloning operations to enable containerized tools to work with local code. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/repo-clone-mode/.pi-map.index.md -map: openspec/specs/repo-clone-mode/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/repo-clone-mode/.pi-map.md b/openspec/specs/repo-clone-mode/.pi-map.md deleted file mode 100644 index 16b123a..0000000 --- a/openspec/specs/repo-clone-mode/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/repo-clone-mode -dir: openspec/specs/repo-clone-mode - -index: openspec/specs/repo-clone-mode/.pi-map.index.md - -## role -Defines the contract for host-side git repository cloning operations to enable containerized tools to work with local code. -## files -- spec.md | Specifies requirements for host-side git repository cloning with SSH key preparation and dirty state detection for containerized tool instances. | dep: GitRepository, ToolInstance, SSHKey, Docker Compose, Git, pytest, mypy, ruff, npm -## arch -Specification-driven design using markdown-based requirements documentation with SSH key management and dirty-state detection concerns. -## tags -git, spec, specifies, requirements, host, side, repository, cloning -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/session-lifecycle-ux/.pi-map.index.md b/openspec/specs/session-lifecycle-ux/.pi-map.index.md deleted file mode 100644 index 10d7cb3..0000000 --- a/openspec/specs/session-lifecycle-ux/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/session-lifecycle-ux (index) -dir: openspec/specs/session-lifecycle-ux - -## role -Defines user experience requirements for session lifecycle management interactions -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/session-lifecycle-ux/.pi-map.index.md -map: openspec/specs/session-lifecycle-ux/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/session-lifecycle-ux/.pi-map.md b/openspec/specs/session-lifecycle-ux/.pi-map.md deleted file mode 100644 index 87c3fb3..0000000 --- a/openspec/specs/session-lifecycle-ux/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/session-lifecycle-ux -dir: openspec/specs/session-lifecycle-ux - -index: openspec/specs/session-lifecycle-ux/.pi-map.index.md - -## role -Defines user experience requirements for session lifecycle management interactions -## files -- spec.md | Defines software requirements for session management UI behaviors including stop confirmation dialogs and immediate deletion updates -## arch -Specification-driven requirements documentation using behavioral scenario descriptions with explicit user flow states and UI feedback expectations -## tags -spec, defines, software, requirements, session, management, behaviors, including -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/sessions-hub/.pi-map.index.md b/openspec/specs/sessions-hub/.pi-map.index.md deleted file mode 100644 index 0eb3086..0000000 --- a/openspec/specs/sessions-hub/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/sessions-hub (index) -dir: openspec/specs/sessions-hub - -## role -Defines technical specifications for a centralized user session management feature that enables viewing, filtering, and terminating active sessions across devices. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/sessions-hub/.pi-map.index.md -map: openspec/specs/sessions-hub/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/smart-tunnel-recovery/.pi-map.index.md b/openspec/specs/smart-tunnel-recovery/.pi-map.index.md deleted file mode 100644 index 40292cb..0000000 --- a/openspec/specs/smart-tunnel-recovery/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/smart-tunnel-recovery (index) -dir: openspec/specs/smart-tunnel-recovery - -## role -Defines health check classification requirements to distinguish infrastructure tunnel failures from application-level errors and specify their respective UI behaviors and automated recovery procedures. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/smart-tunnel-recovery/.pi-map.index.md -map: openspec/specs/smart-tunnel-recovery/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/smart-tunnel-recovery/.pi-map.md b/openspec/specs/smart-tunnel-recovery/.pi-map.md deleted file mode 100644 index 92317f1..0000000 --- a/openspec/specs/smart-tunnel-recovery/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/smart-tunnel-recovery -dir: openspec/specs/smart-tunnel-recovery - -index: openspec/specs/smart-tunnel-recovery/.pi-map.index.md - -## role -Defines health check classification requirements to distinguish infrastructure tunnel failures from application-level errors and specify their respective UI behaviors and automated recovery procedures. -## files -- spec.md | Specifies requirements for classifying tunnel failures versus application errors in a health check system with different UI behaviors and recovery actions. -## arch -Specification-driven requirements document using scenario-based behavioral specification with clear separation between failure domains (tunnel vs. application), state-based recovery actions, and conditional UI response patterns. -## tags -spec, specifies, requirements, classifying, tunnel, failures, versus, application -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/ssh-keys/.pi-map.index.md b/openspec/specs/ssh-keys/.pi-map.index.md deleted file mode 100644 index 61f2285..0000000 --- a/openspec/specs/ssh-keys/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/ssh-keys (index) -dir: openspec/specs/ssh-keys - -## role -Defines security requirements for SSH key generation, storage, and access control for Git operations. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/ssh-keys/.pi-map.index.md -map: openspec/specs/ssh-keys/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/ssh-keys/.pi-map.md b/openspec/specs/ssh-keys/.pi-map.md deleted file mode 100644 index ed71ea9..0000000 --- a/openspec/specs/ssh-keys/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/ssh-keys -dir: openspec/specs/ssh-keys - -index: openspec/specs/ssh-keys/.pi-map.index.md - -## role -Defines security requirements for SSH key generation, storage, and access control for Git operations. -## files -- spec.md | Specifies requirements for generating, managing, and securing Ed25519 SSH keys for git operations with project-scoped access control. | dep: SSHKey, User, Project, cryptography, pytest, mypy, ruff, npm -## arch -Specification-driven security policy using Ed25519 cryptography with project-scoped RBAC for multi-tenant key isolation. -## tags -project, spec, specifies, requirements, generating, managing, securing, ed25519 -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-config-management/.pi-map.index.md b/openspec/specs/tool-config-management/.pi-map.index.md deleted file mode 100644 index 3248b96..0000000 --- a/openspec/specs/tool-config-management/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-config-management (index) -dir: openspec/specs/tool-config-management - -## role -Defines requirements for a tool configuration management system with runtime fields, split-pane UI, JSON editors, and validation. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-config-management/.pi-map.index.md -map: openspec/specs/tool-config-management/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-instances/.pi-map.index.md b/openspec/specs/tool-instances/.pi-map.index.md deleted file mode 100644 index 9aff9cc..0000000 --- a/openspec/specs/tool-instances/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-instances (index) -dir: openspec/specs/tool-instances - -## role -Defines requirements for managing tool instances with health monitoring, tunnel connectivity, clone mode, and SSH key operations. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-instances/.pi-map.index.md -map: openspec/specs/tool-instances/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-instances/.pi-map.md b/openspec/specs/tool-instances/.pi-map.md deleted file mode 100644 index bbad44a..0000000 --- a/openspec/specs/tool-instances/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-instances -dir: openspec/specs/tool-instances - -index: openspec/specs/tool-instances/.pi-map.index.md - -## role -Defines requirements for managing tool instances with health monitoring, tunnel connectivity, clone mode, and SSH key operations. -## files -- spec.md | Define modified and added requirements for a tool instance management system including status monitoring, health checks, tunnel management, clone mode operations, and SSH key handling -## arch -Specification-driven requirements document using structured markdown with sections for status, health checks, tunnels, clone mode, and SSH keys. -## tags -management, spec, define, modified, added, requirements, tool, instance -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-port-configuration/.pi-map.index.md b/openspec/specs/tool-port-configuration/.pi-map.index.md deleted file mode 100644 index 452aa04..0000000 --- a/openspec/specs/tool-port-configuration/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-port-configuration (index) -dir: openspec/specs/tool-port-configuration - -## role -Defines validation requirements for tool port configurations including default ports, compose template exposure, and multi-interface support. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-port-configuration/.pi-map.index.md -map: openspec/specs/tool-port-configuration/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-port-configuration/.pi-map.md b/openspec/specs/tool-port-configuration/.pi-map.md deleted file mode 100644 index 68876df..0000000 --- a/openspec/specs/tool-port-configuration/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-port-configuration -dir: openspec/specs/tool-port-configuration - -index: openspec/specs/tool-port-configuration/.pi-map.index.md - -## role -Defines validation requirements for tool port configurations including default ports, compose template exposure, and multi-interface support. -## files -- spec.md | Defines requirements for tool type validation including default ports, compose template port exposure, and multiple interface support -## arch -Specification-driven requirements document using markdown-based declarative specification pattern. -## tags -spec, defines, requirements, tool, type, validation, including, default -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-terminal-startup-command/.pi-map.index.md b/openspec/specs/tool-terminal-startup-command/.pi-map.index.md deleted file mode 100644 index 7bb18dc..0000000 --- a/openspec/specs/tool-terminal-startup-command/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-terminal-startup-command (index) -dir: openspec/specs/tool-terminal-startup-command - -## role -Defines requirements for pre-shell initialization commands in terminal tool configurations. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-terminal-startup-command/.pi-map.index.md -map: openspec/specs/tool-terminal-startup-command/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-terminal-startup-command/.pi-map.md b/openspec/specs/tool-terminal-startup-command/.pi-map.md deleted file mode 100644 index 524c0bc..0000000 --- a/openspec/specs/tool-terminal-startup-command/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-terminal-startup-command -dir: openspec/specs/tool-terminal-startup-command - -index: openspec/specs/tool-terminal-startup-command/.pi-map.index.md - -## role -Defines requirements for pre-shell initialization commands in terminal tool configurations. -## files -- spec.md | Specifies requirements for adding an optional `startup_command` field to terminal tool types that executes before the interactive shell in new terminal sessions. | dep: tool-types-definition, tool-terminal -## arch -Specification-driven design using markdown-based requirements documents with field extension patterns for tool type schemas. -## tags -terminal, tool, types, spec, specifies, requirements, adding, optional -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-terminal/.pi-map.index.md b/openspec/specs/tool-terminal/.pi-map.index.md deleted file mode 100644 index cafd002..0000000 --- a/openspec/specs/tool-terminal/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-terminal (index) -dir: openspec/specs/tool-terminal - -## role -Defines the specification for a browser-based terminal interface that enables secure, real-time access to running Docker containers via WebSocket connections. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-terminal/.pi-map.index.md -map: openspec/specs/tool-terminal/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-terminal/.pi-map.md b/openspec/specs/tool-terminal/.pi-map.md deleted file mode 100644 index 9da66ee..0000000 --- a/openspec/specs/tool-terminal/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-terminal -dir: openspec/specs/tool-terminal - -index: openspec/specs/tool-terminal/.pi-map.index.md - -## role -Defines the specification for a browser-based terminal interface that enables secure, real-time access to running Docker containers via WebSocket connections. -## files -- spec.md | Specifies requirements for a browser-based WebSocket terminal system for accessing running Docker containers with session management, I/O streaming, and access control. | dep: tool-instances, auth-oauth, xterm.js, ptyprocess -## arch -WebSocket-based streaming architecture with session management, bidirectional I/O streaming, and access control for containerized environments. -## tags -spec, specifies, requirements, browser, websocket, terminal, system, accessing -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-type-port-visibility/.pi-map.index.md b/openspec/specs/tool-type-port-visibility/.pi-map.index.md deleted file mode 100644 index 7aba789..0000000 --- a/openspec/specs/tool-type-port-visibility/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-type-port-visibility (index) -dir: openspec/specs/tool-type-port-visibility - -## role -Defines validation rules for conditionally showing or hiding port configuration fields based on whether a tool type requires network port settings. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-type-port-visibility/.pi-map.index.md -map: openspec/specs/tool-type-port-visibility/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-type-port-visibility/.pi-map.md b/openspec/specs/tool-type-port-visibility/.pi-map.md deleted file mode 100644 index 89f61ba..0000000 --- a/openspec/specs/tool-type-port-visibility/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-type-port-visibility -dir: openspec/specs/tool-type-port-visibility - -index: openspec/specs/tool-type-port-visibility/.pi-map.index.md - -## role -Defines validation rules for conditionally showing or hiding port configuration fields based on whether a tool type requires network port settings. -## files -- spec.md | Defines requirements for conditional port configuration visibility and validation based on a tool type's `requires_port` flag -## arch -Specification-driven validation pattern using a single markdown specification file to declaratively define conditional UI visibility and form validation requirements. -## tags -port, spec, defines, requirements, conditional, configuration, visibility, validation -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-type-single-interface/.pi-map.index.md b/openspec/specs/tool-type-single-interface/.pi-map.index.md deleted file mode 100644 index da8cb8b..0000000 --- a/openspec/specs/tool-type-single-interface/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-type-single-interface (index) -dir: openspec/specs/tool-type-single-interface - -## role -Defines specification requirements for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-type-single-interface/.pi-map.index.md -map: openspec/specs/tool-type-single-interface/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-type-single-interface/.pi-map.md b/openspec/specs/tool-type-single-interface/.pi-map.md deleted file mode 100644 index 7c65fc3..0000000 --- a/openspec/specs/tool-type-single-interface/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-type-single-interface -dir: openspec/specs/tool-type-single-interface - -index: openspec/specs/tool-type-single-interface/.pi-map.index.md - -## role -Defines specification requirements for a tool type system that enforces single interface constraints, validates allowed values, and handles legacy data migration. -## files -- spec.md | Defines requirements for enforcing single interface types, validating allowed values, and migrating legacy data for a tool type system -## arch -Specification-driven architecture using markdown-based requirements documentation with validation rules, allowed value constraints, and data migration patterns for backward compatibility. -## tags -spec, defines, requirements, enforcing, single, interface, types, validating -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-types-definition/.pi-map.index.md b/openspec/specs/tool-types-definition/.pi-map.index.md deleted file mode 100644 index 7e098a5..0000000 --- a/openspec/specs/tool-types-definition/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-types-definition (index) -dir: openspec/specs/tool-types-definition - -## role -Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-types-definition/.pi-map.index.md -map: openspec/specs/tool-types-definition/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-types-definition/.pi-map.md b/openspec/specs/tool-types-definition/.pi-map.md deleted file mode 100644 index 7f49e92..0000000 --- a/openspec/specs/tool-types-definition/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-types-definition -dir: openspec/specs/tool-types-definition - -index: openspec/specs/tool-types-definition/.pi-map.index.md - -## role -Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments. -## files -- spec.md | Defines requirements for a tool type management system with CRUD API, Docker template validation, and variable substitution for development environments. | dep: REST API, Docker Compose, YAML parser, authentication/authorization system, database ORM -## arch -Specification-driven design using markdown-based requirements documentation with Docker template patterns and variable substitution mechanisms for environment configuration. -## tags -spec, defines, requirements, tool, type, management, system, crud -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-types/.pi-map.index.md b/openspec/specs/tool-types/.pi-map.index.md deleted file mode 100644 index 3ae4ec4..0000000 --- a/openspec/specs/tool-types/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-types (index) -dir: openspec/specs/tool-types - -## role -Defines specifications for a database-driven tool type management system that replaces hardcoded tool definitions with configurable, migratable records. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tool-types/.pi-map.index.md -map: openspec/specs/tool-types/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tool-types/.pi-map.md b/openspec/specs/tool-types/.pi-map.md deleted file mode 100644 index ed69ee2..0000000 --- a/openspec/specs/tool-types/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tool-types -dir: openspec/specs/tool-types - -index: openspec/specs/tool-types/.pi-map.index.md - -## role -Defines specifications for a database-driven tool type management system that replaces hardcoded tool definitions with configurable, migratable records. -## files -- spec.md | Defines modified requirements for a tool type management system with database-stored definitions, Docker Compose template validation, and migration of built-in tools to regular records. | dep: database, docker compose validation, migration system -## arch -Specification-driven design using markdown-based requirements docs with Docker Compose validation rules and migration patterns for built-in to dynamic tool type conversion. -## tags -database, spec, defines, modified, requirements, tool, type, management -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/traefik-deployment/.pi-map.index.md b/openspec/specs/traefik-deployment/.pi-map.index.md deleted file mode 100644 index 8759aaf..0000000 --- a/openspec/specs/traefik-deployment/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/traefik-deployment (index) -dir: openspec/specs/traefik-deployment - -## role -Defines requirements and documentation standards for Traefik reverse proxy deployment using Docker Compose. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/traefik-deployment/.pi-map.index.md -map: openspec/specs/traefik-deployment/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/traefik-deployment/.pi-map.md b/openspec/specs/traefik-deployment/.pi-map.md deleted file mode 100644 index 1a2274f..0000000 --- a/openspec/specs/traefik-deployment/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/traefik-deployment -dir: openspec/specs/traefik-deployment - -index: openspec/specs/traefik-deployment/.pi-map.index.md - -## role -Defines requirements and documentation standards for Traefik reverse proxy deployment using Docker Compose. -## files -- spec.md | Specifies requirements for Traefik Docker Compose deployment configuration and environment variable documentation | dep: Traefik, Docker Compose, Authentik, OIDC -## arch -Specification-driven configuration with environment-based parameterization and infrastructure-as-code patterns. -## tags -traefik, spec, specifies, requirements, docker, compose, deployment, configuration -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/tunnel-health-monitoring/.pi-map.index.md b/openspec/specs/tunnel-health-monitoring/.pi-map.index.md deleted file mode 100644 index 89789d9..0000000 --- a/openspec/specs/tunnel-health-monitoring/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tunnel-health-monitoring (index) -dir: openspec/specs/tunnel-health-monitoring - -## role -Defines behavioral specifications for health monitoring and automatic recovery of cloudflared tunnel connections to ensure high availability. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/tunnel-health-monitoring/.pi-map.index.md -map: openspec/specs/tunnel-health-monitoring/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/tunnel-health-monitoring/.pi-map.md b/openspec/specs/tunnel-health-monitoring/.pi-map.md deleted file mode 100644 index c86bd02..0000000 --- a/openspec/specs/tunnel-health-monitoring/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/tunnel-health-monitoring -dir: openspec/specs/tunnel-health-monitoring - -index: openspec/specs/tunnel-health-monitoring/.pi-map.index.md - -## role -Defines behavioral specifications for health monitoring and automatic recovery of cloudflared tunnel connections to ensure high availability. -## files -- spec.md | Defines requirements for monitoring and recreating cloudflared tunnels for running instances | dep: cloudflared, HTTP health checks, UI components -## arch -Specification-driven requirements document using markdown-based behavioral specification pattern with no executable code, focusing on system-level observability and self-healing tunnel infrastructure. -## tags -cloudflared, spec, defines, requirements, monitoring, recreating, tunnels, running -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/user-config/.pi-map.index.md b/openspec/specs/user-config/.pi-map.index.md deleted file mode 100644 index 7ce3824..0000000 --- a/openspec/specs/user-config/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/user-config (index) -dir: openspec/specs/user-config - -## role -Defines data models and API contracts for a user-configurable preferences system with JSONB storage and theme integration. -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/user-config/.pi-map.index.md -map: openspec/specs/user-config/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/specs/user-config/.pi-map.md b/openspec/specs/user-config/.pi-map.md deleted file mode 100644 index edc066b..0000000 --- a/openspec/specs/user-config/.pi-map.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/user-config -dir: openspec/specs/user-config - -index: openspec/specs/user-config/.pi-map.index.md - -## role -Defines data models and API contracts for a user-configurable preferences system with JSONB storage and theme integration. -## files -- spec.md | Defines specifications for a user configuration system that stores JSONB key-value preferences, supports specific config keys, and integrates with frontend theme application. | dep: UserConfig, User, auth-oauth, pytest, mypy, ruff, npm -## arch -Specification-driven architecture using markdown-based API documentation with JSONB schema definitions for flexible key-value storage. -## tags -user, spec, defines, specifications, configuration, system, stores, jsonb -## symbols -- -## workflows -- -## dirty -- diff --git a/openspec/specs/user-profile/.pi-map.index.md b/openspec/specs/user-profile/.pi-map.index.md deleted file mode 100644 index 9952634..0000000 --- a/openspec/specs/user-profile/.pi-map.index.md +++ /dev/null @@ -1,19 +0,0 @@ -# openspec/specs/user-profile (index) -dir: openspec/specs/user-profile - -## role -Defines functional specifications for user profile management capabilities including retrieval, updates, and local avatar storage -## parent -index: openspec/specs/.pi-map.index.md -map: openspec/specs/.pi-map.md -## children -- -## files -- spec.md -## links -index: openspec/specs/user-profile/.pi-map.index.md -map: openspec/specs/user-profile/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/tasks/.pi-map.index.md b/openspec/tasks/.pi-map.index.md index e981d51..811a84a 100644 --- a/openspec/tasks/.pi-map.index.md +++ b/openspec/tasks/.pi-map.index.md @@ -1,11 +1,11 @@ -# openspec/tasks (index) -dir: openspec/tasks +# tasks (index) +dir: tasks ## role -Contains technical specification documents tracking planned features and architectural improvements for the project. +This directory contains technical specification and design documents tracking pending engineering tasks for a containerized development environment platform. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## children - ## files @@ -15,8 +15,8 @@ map: openspec/.pi-map.md - terminal-responsiveness.md - tool-definition-manifest.md ## links -index: openspec/tasks/.pi-map.index.md -map: openspec/tasks/.pi-map.md +index: tasks/.pi-map.index.md +map: tasks/.pi-map.md ## workflows - ## dirty diff --git a/openspec/tasks/.pi-map.md b/openspec/tasks/.pi-map.md index c770074..ff1fa0e 100644 --- a/openspec/tasks/.pi-map.md +++ b/openspec/tasks/.pi-map.md @@ -1,10 +1,10 @@ -# openspec/tasks -dir: openspec/tasks +# tasks +dir: tasks -index: openspec/tasks/.pi-map.index.md +index: tasks/.pi-map.index.md ## role -Contains technical specification documents tracking planned features and architectural improvements for the project. +This directory contains technical specification and design documents tracking pending engineering tasks for a containerized development environment platform. ## files - config-profile-multi-repo-mounts.md | Technical specification for refactoring git mount configuration to support multiple repository mappings per mount instead of single source/target pairs | dep: git, docker compose, react/typescript, pytest, npm, fastapi - home-path-expansion.md | Design and implementation plan for adding configurable home/workspace directory support to tool containers in an API application. | dep: SQLAlchemy/Alembic, Docker, Docker Compose, pytest, PostgreSQL, Node.js/npm @@ -12,7 +12,7 @@ Contains technical specification documents tracking planned features and archite - terminal-responsiveness.md | A technical specification document outlining 7 pending tasks to improve web terminal performance through asyncio-native I/O, binary WebSocket frames, WebGL rendering, flow control, and comprehensive benchmarking. | dep: asyncio, WebSocket, xterm-addon-webgl, docker, pytest - tool-definition-manifest.md | A project task specification document defining a multi-PR system for implementing a Tool Definition Manifest System with backend manifest compilation, frontend workshop UI, and legacy migration support. | dep: SQLAlchemy, Alembic, Docker, Docker Compose, FastAPI/REST API, React/TypeScript frontend ## arch -Markdown-based task tracking system using standalone specification documents that each define discrete feature work across backend, frontend, and infrastructure concerns. +Markdown-based task tracking system using single-file specifications per feature, covering API/backend services, frontend UI, Docker/container infrastructure, and performance optimization workstreams. ## tags mount, docker, pytest, tool, manifest, specification, support, docker compose ## symbols