Merge branch 'chore/archive-completed-openspec-changes' into dev

This commit is contained in:
Developer
2026-06-12 21:11:11 +00:00
41 changed files with 176 additions and 145 deletions
+23 -22
View File
@@ -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
+19 -5
View File
@@ -1,13 +1,27 @@
# openspec/changes
dir: openspec/changes
# .
dir: .
index: openspec/changes/.pi-map.index.md
index: ./.pi-map.index.md
## Project Map Protocol
1. Read this protocol and the root `.pi-map.index.md` first.
2. Use `index:` / `map:` references to open relevant directory indexes and maps.
3. Load indexes before rich maps during task-start navigation.
4. Read the local rich map and actual source before editing.
5. Treat non-empty `## dirty` sections in either artifact as stale.
6. If source and generated artifacts disagree, trust source.
7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair.
8. After editing source, run `project_map_patch` for each changed file.
9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters.
Trust boundary: index routes, map orients, source decides.
## role
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
+1 -1
View File
@@ -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
+2 -2
View File
@@ -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
@@ -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
@@ -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
@@ -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
-
@@ -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
@@ -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
-
@@ -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
@@ -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
-
@@ -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
@@ -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
-
@@ -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
@@ -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
-
@@ -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
-
@@ -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
-
@@ -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
-