From 40ac931c65e8a05cf523bb41b8b45e9634c7c19f Mon Sep 17 00:00:00 2001 From: Developer Date: Fri, 12 Jun 2026 14:43:22 +0000 Subject: [PATCH] chore: patch project maps for multi-session-terminal-ux metadata updates --- .pi-map.index.md | 2 +- .pi-map.md | 8 +-- openspec/.pi-map.index.md | 2 +- openspec/.pi-map.md | 4 +- openspec/changes/.pi-map.index.md | 57 +++++++------------ openspec/changes/.pi-map.md | 24 ++------ .../.pi-map.index.md | 14 ++--- .../multi-session-terminal-ux/.pi-map.md | 18 +++--- 8 files changed, 51 insertions(+), 78 deletions(-) diff --git a/.pi-map.index.md b/.pi-map.index.md index 4ec0df9..ea22442 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 -Infrastructure and deployment configuration package for a self-hosted project management platform with containerized services, SSO integration, and reverse proxy support. +Infrastructure and deployment configuration for a self-hosted project management platform with OAuth2 authentication, providing Docker Compose orchestration, environment templates, and development tooling. ## parent - ## children diff --git a/.pi-map.md b/.pi-map.md index 5639d5b..61d8d07 100644 --- a/.pi-map.md +++ b/.pi-map.md @@ -18,10 +18,10 @@ index: ./.pi-map.index.md Trust boundary: index routes, map orients, source decides. ## role -Infrastructure and deployment configuration package for a self-hosted project management platform with containerized services, SSO integration, and reverse proxy support. +Infrastructure and deployment configuration for a self-hosted project management platform with OAuth2 authentication, providing Docker Compose orchestration, environment templates, and development tooling. ## 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 patterns for files and directories that Git should ignore in this repository | dep: git, none +- .gitignore | Specifies files and directories for Git to ignore across a multi-language project with Python, Node, and various tooling | dep: git - AGENTS.md | Defines operational rules, workflows, and constraints for AI agents working within an OpenSpec-driven software development project. | dep: OpenSpec, superpowers, git, docker compose, conventional commits - 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 @@ -31,9 +31,9 @@ Infrastructure and deployment configuration package for a self-hosted project ma - 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 -Docker Compose-based microservices architecture with environment-driven configuration, Traefik reverse proxy integration, and separation of concerns between backend API, frontend, PostgreSQL persistence, and Redis caching layers. +Containerized microservices architecture using Docker Compose with separate frontend/API/PostgreSQL/Redis services, Traefik reverse proxy integration, and environment-driven configuration; includes AI agent governance via OpenSpec and Makefile-driven development workflows. ## tags -docker, redis, git, application, postgresql, compose, traefik, web +docker, redis, git, application, postgresql, compose, traefik, project ## symbols - ## workflows diff --git a/openspec/.pi-map.index.md b/openspec/.pi-map.index.md index c1391c2..7cf8d6e 100644 --- a/openspec/.pi-map.index.md +++ b/openspec/.pi-map.index.md @@ -2,7 +2,7 @@ dir: openspec ## role -Defines and configures a living documentation methodology and project governance rules for AI-assisted software development. +Defines the OpenSpec methodology and project configuration for managing software requirements, specifications, and task tracking as living documentation within a Docker-based coding agent management platform. ## parent index: ./.pi-map.index.md map: ./.pi-map.md diff --git a/openspec/.pi-map.md b/openspec/.pi-map.md index 7e64d92..d1f10b7 100644 --- a/openspec/.pi-map.md +++ b/openspec/.pi-map.md @@ -4,12 +4,12 @@ dir: openspec index: openspec/.pi-map.index.md ## role -Defines and configures a living documentation methodology and project governance rules for AI-assisted software development. +Defines the OpenSpec methodology and project configuration for managing software requirements, specifications, and task tracking as living documentation within a Docker-based coding agent management 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 -Declarative configuration-driven architecture using YAML-based project metadata and markdown-based specification tracking for human-AI collaborative development workflows. +Documentation-as-code pattern with YAML-based configuration management, combining structured metadata (config.yaml) with methodology documentation (README.md) to enforce software development discipline rules for automated agent workflows. ## 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 362dd67..87e3e37 100644 --- a/openspec/changes/.pi-map.index.md +++ b/openspec/changes/.pi-map.index.md @@ -1,44 +1,31 @@ -# . (index) -dir: . - -## Project Map Protocol - -1. Read this protocol and the root `.pi-map.index.md` first. -2. Use `index:` / `map:` references to open relevant directory indexes and maps. -3. Load indexes before rich maps during task-start navigation. -4. Read the local rich map and actual source before editing. -5. Treat non-empty `## dirty` sections in either artifact as stale. -6. If source and generated artifacts disagree, trust source. -7. If map and index disagree, trust neither blindly; verify from source and regenerate the pair. -8. After editing source, run `project_map_patch` for each changed file. -9. Before broad architectural claims or final handoff, run `project_map_validate` when freshness matters. - -Trust boundary: index routes, map orients, source decides. +# openspec/changes (index) +dir: openspec/changes ## role -Empty root directory awaiting package initialization or content. +Tracks and manages specification changes/versions for OpenAPI documents ## parent -- +index: openspec/.pi-map.index.md +map: openspec/.pi-map.md ## children -- archive - index: archive/.pi-map.index.md - map: archive/.pi-map.md -- multi-session-terminal-ux - index: multi-session-terminal-ux/.pi-map.index.md - map: multi-session-terminal-ux/.pi-map.md -- reorganize-long-files - index: reorganize-long-files/.pi-map.index.md - map: reorganize-long-files/.pi-map.md -- working-copies - index: working-copies/.pi-map.index.md - map: working-copies/.pi-map.md -- workspace-first-ui - index: workspace-first-ui/.pi-map.index.md - map: workspace-first-ui/.pi-map.md +- 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 ## files ## links -index: ./.pi-map.index.md -map: ./.pi-map.md +index: openspec/changes/.pi-map.index.md +map: openspec/changes/.pi-map.md ## workflows - ## dirty diff --git a/openspec/changes/.pi-map.md b/openspec/changes/.pi-map.md index 3f1f27a..e535cb3 100644 --- a/openspec/changes/.pi-map.md +++ b/openspec/changes/.pi-map.md @@ -1,27 +1,13 @@ -# . -dir: . +# openspec/changes +dir: openspec/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: openspec/changes/.pi-map.index.md ## role -Empty root directory awaiting package initialization or content. +Tracks and manages specification changes/versions for OpenAPI documents ## files ## arch -N/A - no files or architectural patterns present to analyze. +Simple data structure package with record types for change metadata, likely used by diff/merge tooling ## tags - ## symbols diff --git a/openspec/changes/multi-session-terminal-ux/.pi-map.index.md b/openspec/changes/multi-session-terminal-ux/.pi-map.index.md index 15a7c23..23b53d2 100644 --- a/openspec/changes/multi-session-terminal-ux/.pi-map.index.md +++ b/openspec/changes/multi-session-terminal-ux/.pi-map.index.md @@ -1,11 +1,11 @@ -# multi-session-terminal-ux (index) -dir: multi-session-terminal-ux +# openspec/changes/multi-session-terminal-ux (index) +dir: openspec/changes/multi-session-terminal-ux ## role -Design and specification package for implementing multi-session terminal UX support in a web-based tool instance platform. +Design specification and implementation documentation for adding multi-session terminal support to a tool instance platform ## parent -index: ./.pi-map.index.md -map: ./.pi-map.md +index: openspec/changes/.pi-map.index.md +map: openspec/changes/.pi-map.md ## children - ## files @@ -18,8 +18,8 @@ map: ./.pi-map.md - proposal.md - tasks.md ## links -index: multi-session-terminal-ux/.pi-map.index.md -map: multi-session-terminal-ux/.pi-map.md +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/multi-session-terminal-ux/.pi-map.md b/openspec/changes/multi-session-terminal-ux/.pi-map.md index 266aacd..5efd154 100644 --- a/openspec/changes/multi-session-terminal-ux/.pi-map.md +++ b/openspec/changes/multi-session-terminal-ux/.pi-map.md @@ -1,23 +1,23 @@ -# multi-session-terminal-ux -dir: multi-session-terminal-ux +# openspec/changes/multi-session-terminal-ux +dir: openspec/changes/multi-session-terminal-ux -index: multi-session-terminal-ux/.pi-map.index.md +index: openspec/changes/multi-session-terminal-ux/.pi-map.index.md ## role -Design and specification package for implementing multi-session terminal UX support in a web-based tool instance platform. +Design specification and implementation documentation for adding multi-session terminal support to a tool instance platform ## files -- .openspec.yaml | Defines an open specification for a multi-session terminal user experience project +- .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 -- apply-pr2.md | Empty file with no functionality +- apply-pr2.md | Documents the implementation of a multi-session terminal UX with WebSocket routing, REST CRUD endpoints, frontend API client/hook, and auth-focused tests, while maintaining backward compatibility with legacy single-session endpoints. | dep: WebSocket, REST API, React hooks, Python pytest, Docker/PTY, terminal session manager - apply-pr3.md | Documents a pull request implementing a frontend multi-session terminal UI with tabbed management, fullscreen mode, keyboard shortcuts, and mobile support. | dep: React, TypeScript, WebSocket, CSS, Python (backend terminal manager), testing framework - design.md | Software design document specifying architecture and implementation for adding multi-session terminal support (up to 5 concurrent sessions) to an existing tool instance platform | dep: FastAPI, SQLAlchemy, Alembic, React, xterm.js, WebSocket, PTY, docker exec, Python, TypeScript - explore.md | Explores architectural options for adding multi-session terminal support to an existing persistent terminal system, evaluating backend, frontend, protocol, and database design choices with recommendations for MVP implementation. | dep: TerminalManager, TerminalSession, TerminalComponent, TerminalPage, MobileTerminalWrapper, xterm.js, FastAPI, SQLAlchemy, alembic - 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 detailing a 12-task implementation plan for adding multi-session terminal UX support to a web application, organized across 3 stacked pull requests with TDD acceptance criteria. | dep: Alembic, SQLAlchemy, FastAPI, WebSocket, React, TypeScript, xterm.js, PTY, UUID, pytest, Jest/RTL +- 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 -Document-driven architecture using stacked PR planning (3 PRs: backend/core, empty/placeholder, frontend/UI), TDD acceptance criteria, and explicit MVP scoping with 5-session concurrency limit. +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 ## tags -terminal, multi, session, apply, alembic, support, design, implementation +terminal, session, multi, apply, implementation, alembic, websocket, support ## symbols - ## workflows