diff --git a/openspec/changes/.pi-map.index.md b/openspec/changes/.pi-map.index.md index 8204cb4..13f5add 100644 --- a/openspec/changes/.pi-map.index.md +++ b/openspec/changes/.pi-map.index.md @@ -1,31 +1,32 @@ -# openspec/changes (index) -dir: openspec/changes +# . (index) +dir: . + +## Project Map Protocol + +1. Read this protocol and the root `.pi-map.index.md` first. +2. Use `index:` / `map:` references to open relevant directory indexes and maps. +3. Load indexes before rich maps during task-start navigation. +4. Read the local rich map and actual source before editing. +5. Treat non-empty `## dirty` sections in either artifact as stale. +6. If source and generated artifacts disagree, trust source. +7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. +8. After editing source, run `project_map_patch` for each changed file. +9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. + +Trust boundary: index routes, map orients, source decides. ## role -Manages and tracks specification changes, versioning, and changelog generation for the OpenAPI specification. +This is an empty directory with no files to analyze. ## parent -index: openspec/.pi-map.index.md -map: openspec/.pi-map.md +- ## children -- openspec/changes/archive - index: openspec/changes/archive/.pi-map.index.md - map: openspec/changes/archive/.pi-map.md -- openspec/changes/multi-session-terminal-ux - index: openspec/changes/multi-session-terminal-ux/.pi-map.index.md - map: openspec/changes/multi-session-terminal-ux/.pi-map.md -- openspec/changes/reorganize-long-files - index: openspec/changes/reorganize-long-files/.pi-map.index.md - map: openspec/changes/reorganize-long-files/.pi-map.md -- openspec/changes/working-copies - index: openspec/changes/working-copies/.pi-map.index.md - map: openspec/changes/working-copies/.pi-map.md -- openspec/changes/workspace-first-ui - index: openspec/changes/workspace-first-ui/.pi-map.index.md - map: openspec/changes/workspace-first-ui/.pi-map.md +- archive + index: archive/.pi-map.index.md + map: archive/.pi-map.md ## files ## links -index: openspec/changes/.pi-map.index.md -map: openspec/changes/.pi-map.md +index: ./.pi-map.index.md +map: ./.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/.pi-map.md b/openspec/changes/.pi-map.md index d69d2f0..878b2e2 100644 --- a/openspec/changes/.pi-map.md +++ b/openspec/changes/.pi-map.md @@ -1,13 +1,27 @@ -# openspec/changes -dir: openspec/changes +# . +dir: . -index: openspec/changes/.pi-map.index.md +index: ./.pi-map.index.md + +## Project Map Protocol + +1. Read this protocol and the root `.pi-map.index.md` first. +2. Use `index:` / `map:` references to open relevant directory indexes and maps. +3. Load indexes before rich maps during task-start navigation. +4. Read the local rich map and actual source before editing. +5. Treat non-empty `## dirty` sections in either artifact as stale. +6. If source and generated artifacts disagree, trust source. +7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. +8. After editing source, run `project_map_patch` for each changed file. +9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. + +Trust boundary: index routes, map orients, source decides. ## role -Manages and tracks specification changes, versioning, and changelog generation for the OpenAPI specification. +This is an empty directory with no files to analyze. ## files ## arch -Event-sourced or diff-based architecture with structured change records, likely supporting incremental versioning and audit trails for specification evolution. +N/A - no code or architecture present ## tags - ## symbols diff --git a/openspec/changes/archive/.pi-map.index.md b/openspec/changes/archive/.pi-map.index.md index 6c155c0..cc80d5a 100644 --- a/openspec/changes/archive/.pi-map.index.md +++ b/openspec/changes/archive/.pi-map.index.md @@ -2,7 +2,7 @@ dir: archive ## role -This package provides functionality for creating, reading, and extracting compressed archive files in various formats. +Contains historical or deprecated code and resources that are no longer active in the project but retained for reference or backup purposes. ## parent index: ./.pi-map.index.md map: ./.pi-map.md diff --git a/openspec/changes/archive/.pi-map.md b/openspec/changes/archive/.pi-map.md index 39bfd31..dcdf178 100644 --- a/openspec/changes/archive/.pi-map.md +++ b/openspec/changes/archive/.pi-map.md @@ -4,10 +4,10 @@ dir: archive index: archive/.pi-map.index.md ## role -This package provides functionality for creating, reading, and extracting compressed archive files in various formats. +Contains historical or deprecated code and resources that are no longer active in the project but retained for reference or backup purposes. ## files ## arch -The package uses a modular, format-agnostic interface pattern where a generic Archive type wraps format-specific implementations (tar, zip, etc.) with unified read/write/extract operations, supported by internal helper packages for each archive format. +No active architecture; typically flat storage of obsolete files with no dependencies or patterns, isolated from the main codebase. ## tags - ## 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 c50eebe..9b465db 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 @@ -52,6 +52,18 @@ map: archive/.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 ## files - README.md ## links 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 4fe6b29..67cbb28 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 @@ -7,6 +7,10 @@ index: archive/2026-06-12-completed-changes-archive/.pi-map.index.md Stores historical records of fully implemented and audited OpenSpec changes for reference and audit trail purposes. ## files - README.md | Documents archived completed OpenSpec changes that have been audited and confirmed as fully implemented +- multi-session-terminal-ux | Completed OpenSpec change for multi-session terminal UX +- reorganize-long-files | Completed OpenSpec change for reorganizing long files +- working-copies | Completed OpenSpec change for workspace-first working copies +- workspace-first-ui | Completed OpenSpec change for workspace-first UI ## arch Simple flat-file archive using date-based directory naming and markdown documentation for immutable change tracking. ## tags diff --git a/openspec/changes/multi-session-terminal-ux/.openspec.yaml b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.openspec.yaml similarity index 100% rename from openspec/changes/multi-session-terminal-ux/.openspec.yaml rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.openspec.yaml 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 new file mode 100644 index 0000000..ca79b97 --- /dev/null +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.index.md @@ -0,0 +1,26 @@ +# archive/2026-06-12-active-changes-archive/multi-session-terminal-ux (index) +dir: archive/2026-06-12-active-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. +## parent +index: archive/2026-06-12-active-changes-archive/.pi-map.index.md +map: archive/2026-06-12-active-changes-archive/.pi-map.md +## children +- +## files +- .openspec.yaml +- apply-pr1.md +- apply-pr2.md +- apply-pr3.md +- design.md +- explore.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 +## workflows +- +## dirty +- diff --git a/openspec/changes/multi-session-terminal-ux/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md similarity index 76% rename from openspec/changes/multi-session-terminal-ux/.pi-map.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/.pi-map.md index 5efd154..8fddddd 100644 --- a/openspec/changes/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 @@ -# openspec/changes/multi-session-terminal-ux -dir: openspec/changes/multi-session-terminal-ux +# archive/2026-06-12-active-changes-archive/multi-session-terminal-ux +dir: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux -index: openspec/changes/multi-session-terminal-ux/.pi-map.index.md +index: archive/2026-06-12-active-changes-archive/multi-session-terminal-ux/.pi-map.index.md ## role -Design specification and implementation documentation for adding multi-session terminal support to a tool instance platform +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. ## 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 @@ Design specification and implementation documentation for adding multi-session t - 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 using phased PR implementation (backend schema/API → WebSocket/REST integration → frontend UI), with FastAPI/Python backend and React/TypeScript frontend, featuring TDD, backward compatibility preservation, and MVP-focused architectural decision records +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. ## tags terminal, session, multi, apply, implementation, alembic, websocket, support ## symbols diff --git a/openspec/changes/multi-session-terminal-ux/apply-pr1.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/apply-pr1.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/apply-pr1.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/apply-pr1.md diff --git a/openspec/changes/multi-session-terminal-ux/apply-pr2.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/apply-pr2.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/apply-pr2.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/apply-pr2.md diff --git a/openspec/changes/multi-session-terminal-ux/apply-pr3.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/apply-pr3.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/apply-pr3.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/apply-pr3.md diff --git a/openspec/changes/multi-session-terminal-ux/design.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/design.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/design.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/design.md diff --git a/openspec/changes/multi-session-terminal-ux/explore.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/explore.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/explore.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/explore.md diff --git a/openspec/changes/multi-session-terminal-ux/proposal.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/proposal.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/proposal.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/proposal.md diff --git a/openspec/changes/multi-session-terminal-ux/tasks.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/tasks.md similarity index 100% rename from openspec/changes/multi-session-terminal-ux/tasks.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/multi-session-terminal-ux/tasks.md diff --git a/openspec/changes/reorganize-long-files/.openspec.yaml b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.openspec.yaml similarity index 100% rename from openspec/changes/reorganize-long-files/.openspec.yaml rename to openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.openspec.yaml 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 new file mode 100644 index 0000000..8571ef3 --- /dev/null +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.index.md @@ -0,0 +1,22 @@ +# archive/2026-06-12-active-changes-archive/reorganize-long-files (index) +dir: archive/2026-06-12-active-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. +## parent +index: archive/2026-06-12-active-changes-archive/.pi-map.index.md +map: archive/2026-06-12-active-changes-archive/.pi-map.md +## children +- +## files +- .openspec.yaml +- proposal.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 +## workflows +- +## dirty +- diff --git a/openspec/changes/reorganize-long-files/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md similarity index 62% rename from openspec/changes/reorganize-long-files/.pi-map.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/.pi-map.md index 64754e6..079df56 100644 --- a/openspec/changes/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 @@ -# openspec/changes/reorganize-long-files -dir: openspec/changes/reorganize-long-files +# archive/2026-06-12-active-changes-archive/reorganize-long-files +dir: archive/2026-06-12-active-changes-archive/reorganize-long-files -index: openspec/changes/reorganize-long-files/.pi-map.index.md +index: archive/2026-06-12-active-changes-archive/reorganize-long-files/.pi-map.index.md ## role -Tracks a completed structural refactoring initiative to decompose monolithic frontend pages and backend routers into smaller, focused components and services. +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. ## 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 spec/proposal/task tracking files with a thin-page/thin-router/fat-component pattern, preserving all API contracts and behavior while extracting dedicated component/service modules. +Documentation-driven refactoring using specification-proposal-task workflow with a thin-page/thin-router/fat-component pattern, emphasizing pure structural decomposition without behavioral changes. ## tags components, services, long, .openspec, structural, refactoring, split, monolithic ## symbols diff --git a/openspec/changes/reorganize-long-files/proposal.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/proposal.md similarity index 100% rename from openspec/changes/reorganize-long-files/proposal.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/proposal.md diff --git a/openspec/changes/reorganize-long-files/spec.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/spec.md similarity index 100% rename from openspec/changes/reorganize-long-files/spec.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/spec.md diff --git a/openspec/changes/reorganize-long-files/tasks.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/tasks.md similarity index 100% rename from openspec/changes/reorganize-long-files/tasks.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/reorganize-long-files/tasks.md diff --git a/openspec/changes/working-copies/.openspec.yaml b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.openspec.yaml similarity index 100% rename from openspec/changes/working-copies/.openspec.yaml rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.openspec.yaml 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 new file mode 100644 index 0000000..4a821ed --- /dev/null +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.index.md @@ -0,0 +1,24 @@ +# archive/2026-06-12-active-changes-archive/working-copies (index) +dir: archive/2026-06-12-active-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. +## parent +index: archive/2026-06-12-active-changes-archive/.pi-map.index.md +map: archive/2026-06-12-active-changes-archive/.pi-map.md +## children +- +## files +- .openspec.yaml +- design.md +- explore.md +- proposal.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 +## workflows +- +## dirty +- diff --git a/openspec/changes/working-copies/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md similarity index 69% rename from openspec/changes/working-copies/.pi-map.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md index 92ebef0..59e634e 100644 --- a/openspec/changes/working-copies/.pi-map.md +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/.pi-map.md @@ -1,10 +1,10 @@ -# openspec/changes/working-copies -dir: openspec/changes/working-copies +# archive/2026-06-12-active-changes-archive/working-copies +dir: archive/2026-06-12-active-changes-archive/working-copies -index: openspec/changes/working-copies/.pi-map.index.md +index: archive/2026-06-12-active-changes-archive/working-copies/.pi-map.index.md ## role -Design and specification package for replacing direct repository mounting/cloning with persistent, shared Git working copy workspaces in tool instances. +Archive of design documents and specifications for implementing persistent workspace-based tool instances that replace direct repository mounting with isolated git working copies. ## 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 @@ Design and specification package for replacing direct repository mounting/clonin - 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 -Document-driven design process using layered specification documents (exploration → proposal → design → spec → tasks) with YAML metadata tracking, following a phased multi-PR implementation strategy across backend and frontend systems. +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. ## tags workspace, tool, instances, git, design, replace, project, working ## symbols diff --git a/openspec/changes/working-copies/design.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/design.md similarity index 100% rename from openspec/changes/working-copies/design.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/design.md diff --git a/openspec/changes/working-copies/explore.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/explore.md similarity index 100% rename from openspec/changes/working-copies/explore.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/explore.md diff --git a/openspec/changes/working-copies/proposal.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/proposal.md similarity index 100% rename from openspec/changes/working-copies/proposal.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/proposal.md diff --git a/openspec/changes/working-copies/spec.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/spec.md similarity index 100% rename from openspec/changes/working-copies/spec.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/spec.md diff --git a/openspec/changes/working-copies/tasks.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/tasks.md similarity index 100% rename from openspec/changes/working-copies/tasks.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/working-copies/tasks.md diff --git a/openspec/changes/workspace-first-ui/.openspec.yaml b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.openspec.yaml similarity index 100% rename from openspec/changes/workspace-first-ui/.openspec.yaml rename to openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.openspec.yaml 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 new file mode 100644 index 0000000..6d81a0f --- /dev/null +++ b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.index.md @@ -0,0 +1,23 @@ +# archive/2026-06-12-active-changes-archive/workspace-first-ui (index) +dir: archive/2026-06-12-active-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. +## parent +index: archive/2026-06-12-active-changes-archive/.pi-map.index.md +map: archive/2026-06-12-active-changes-archive/.pi-map.md +## children +- +## files +- .openspec.yaml +- design.md +- proposal.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 +## workflows +- +## dirty +- diff --git a/openspec/changes/workspace-first-ui/.pi-map.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md similarity index 68% rename from openspec/changes/workspace-first-ui/.pi-map.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/.pi-map.md index 648a4fd..71d84bb 100644 --- a/openspec/changes/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 @@ -# openspec/changes/workspace-first-ui -dir: openspec/changes/workspace-first-ui +# archive/2026-06-12-active-changes-archive/workspace-first-ui +dir: archive/2026-06-12-active-changes-archive/workspace-first-ui -index: openspec/changes/workspace-first-ui/.pi-map.index.md +index: archive/2026-06-12-active-changes-archive/workspace-first-ui/.pi-map.index.md ## role -Product specification and design documentation package for a workspace-first UI refresh project that reorients the application around persistent writable workspaces rather than direct repository browsing. +Archive of planning documents for a workspace-first UI redesign that reorients the product around persistent writable workspaces rather than direct repository browsing. ## 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 @@ Product specification and design documentation package for a workspace-first UI - 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 -Documentation-driven specification architecture using sequential PR-based task breakdown (backend → workspace detail page → projects page/routing), with layered design documents progressing from proposal → product spec → technical design → implementation tasks. +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. ## tags workspace, first, refresh, design, document, project, specification, .openspec ## symbols diff --git a/openspec/changes/workspace-first-ui/design.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/design.md similarity index 100% rename from openspec/changes/workspace-first-ui/design.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/design.md diff --git a/openspec/changes/workspace-first-ui/proposal.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/proposal.md similarity index 100% rename from openspec/changes/workspace-first-ui/proposal.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/proposal.md diff --git a/openspec/changes/workspace-first-ui/spec.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/spec.md similarity index 100% rename from openspec/changes/workspace-first-ui/spec.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/spec.md diff --git a/openspec/changes/workspace-first-ui/tasks.md b/openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/tasks.md similarity index 100% rename from openspec/changes/workspace-first-ui/tasks.md rename to openspec/changes/archive/2026-06-12-completed-changes-archive/workspace-first-ui/tasks.md diff --git a/openspec/changes/multi-session-terminal-ux/.pi-map.index.md b/openspec/changes/multi-session-terminal-ux/.pi-map.index.md deleted file mode 100644 index 23b53d2..0000000 --- a/openspec/changes/multi-session-terminal-ux/.pi-map.index.md +++ /dev/null @@ -1,26 +0,0 @@ -# openspec/changes/multi-session-terminal-ux (index) -dir: openspec/changes/multi-session-terminal-ux - -## role -Design specification and implementation documentation for adding multi-session terminal support to a tool instance platform -## parent -index: openspec/changes/.pi-map.index.md -map: openspec/changes/.pi-map.md -## children -- -## files -- .openspec.yaml -- apply-pr1.md -- apply-pr2.md -- apply-pr3.md -- design.md -- explore.md -- proposal.md -- tasks.md -## links -index: openspec/changes/multi-session-terminal-ux/.pi-map.index.md -map: openspec/changes/multi-session-terminal-ux/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/changes/reorganize-long-files/.pi-map.index.md b/openspec/changes/reorganize-long-files/.pi-map.index.md deleted file mode 100644 index 38ede60..0000000 --- a/openspec/changes/reorganize-long-files/.pi-map.index.md +++ /dev/null @@ -1,22 +0,0 @@ -# openspec/changes/reorganize-long-files (index) -dir: openspec/changes/reorganize-long-files - -## role -Tracks a completed structural refactoring initiative to decompose monolithic frontend pages and backend routers into smaller, focused components and services. -## parent -index: openspec/changes/.pi-map.index.md -map: openspec/changes/.pi-map.md -## children -- -## files -- .openspec.yaml -- proposal.md -- spec.md -- tasks.md -## links -index: openspec/changes/reorganize-long-files/.pi-map.index.md -map: openspec/changes/reorganize-long-files/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/changes/working-copies/.pi-map.index.md b/openspec/changes/working-copies/.pi-map.index.md deleted file mode 100644 index f52c3e0..0000000 --- a/openspec/changes/working-copies/.pi-map.index.md +++ /dev/null @@ -1,24 +0,0 @@ -# openspec/changes/working-copies (index) -dir: openspec/changes/working-copies - -## role -Design and specification package for replacing direct repository mounting/cloning with persistent, shared Git working copy workspaces in tool instances. -## parent -index: openspec/changes/.pi-map.index.md -map: openspec/changes/.pi-map.md -## children -- -## files -- .openspec.yaml -- design.md -- explore.md -- proposal.md -- spec.md -- tasks.md -## links -index: openspec/changes/working-copies/.pi-map.index.md -map: openspec/changes/working-copies/.pi-map.md -## workflows -- -## dirty -- diff --git a/openspec/changes/workspace-first-ui/.pi-map.index.md b/openspec/changes/workspace-first-ui/.pi-map.index.md deleted file mode 100644 index 16da32f..0000000 --- a/openspec/changes/workspace-first-ui/.pi-map.index.md +++ /dev/null @@ -1,23 +0,0 @@ -# openspec/changes/workspace-first-ui (index) -dir: openspec/changes/workspace-first-ui - -## role -Product specification and design documentation package for a workspace-first UI refresh project that reorients the application around persistent writable workspaces rather than direct repository browsing. -## parent -index: openspec/changes/.pi-map.index.md -map: openspec/changes/.pi-map.md -## children -- -## files -- .openspec.yaml -- design.md -- proposal.md -- spec.md -- tasks.md -## links -index: openspec/changes/workspace-first-ui/.pi-map.index.md -map: openspec/changes/workspace-first-ui/.pi-map.md -## workflows -- -## dirty --