chore: update project maps for tool container home directory artifacts
This commit is contained in:
Developer
@@ -2,7 +2,7 @@
|
||||
dir: docs
|
||||
|
||||
## role
|
||||
Provides user-facing documentation and knowledge base for the Headquarter platform.
|
||||
Central documentation hub and knowledge base for the Headquarter platform.
|
||||
## parent
|
||||
index: ./.pi-map.index.md
|
||||
map: ./.pi-map.md
|
||||
|
||||
+2
-2
@@ -4,11 +4,11 @@ dir: docs
|
||||
index: docs/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Provides user-facing documentation and knowledge base for the Headquarter platform.
|
||||
Central documentation hub and knowledge base for the Headquarter platform.
|
||||
## files
|
||||
- README.md | Serves as the main index and navigation hub for the Headquarter platform documentation, organizing links to feature guides, API docs, architecture, deployment, and development resources.
|
||||
## arch
|
||||
Static documentation site using markdown files organized hierarchically with a central README index.
|
||||
Static documentation organization using hierarchical markdown files with cross-referenced navigation structure.
|
||||
## tags
|
||||
readme, serves, main, index, navigation, hub, headquarter, platform
|
||||
## symbols
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
dir: docs/superpowers
|
||||
|
||||
## role
|
||||
Documentation directory for specialized or advanced capabilities/features of the project.
|
||||
Documentation for advanced or specialized features and capabilities of the project.
|
||||
## parent
|
||||
index: docs/.pi-map.index.md
|
||||
map: docs/.pi-map.md
|
||||
|
||||
@@ -4,10 +4,10 @@ dir: docs/superpowers
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Documentation directory for specialized or advanced capabilities/features of the project.
|
||||
Documentation for advanced or specialized features and capabilities of the project.
|
||||
## files
|
||||
## arch
|
||||
Static documentation storage with no executable code architecture; likely contains markdown or text files describing enhanced functionality.
|
||||
Flat documentation structure with topic-based markdown files describing extended functionality beyond core features.
|
||||
## tags
|
||||
-
|
||||
## symbols
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
dir: docs/superpowers/plans
|
||||
|
||||
## role
|
||||
Contains implementation planning documents for core infrastructure, authentication, database modeling, and UI feature development.
|
||||
Contains dated implementation planning documents that specify step-by-step technical approaches for major infrastructure, authentication, database, and UI feature development.
|
||||
## parent
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
map: docs/superpowers/.pi-map.md
|
||||
@@ -13,6 +13,7 @@ map: docs/superpowers/.pi-map.md
|
||||
- 2026-05-17-auth-oauth.md
|
||||
- 2026-05-17-database-models.md
|
||||
- 2026-05-24-session-branch-selection.md
|
||||
- tool-container-home-directory.md
|
||||
## links
|
||||
index: docs/superpowers/plans/.pi-map.index.md
|
||||
map: docs/superpowers/plans/.pi-map.md
|
||||
|
||||
@@ -4,16 +4,17 @@ dir: docs/superpowers/plans
|
||||
index: docs/superpowers/plans/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Contains implementation planning documents for core infrastructure, authentication, database modeling, and UI feature development.
|
||||
Contains dated implementation planning documents that specify step-by-step technical approaches for major infrastructure, authentication, database, and UI feature development.
|
||||
## files
|
||||
- 2024-05-16-docker-infrastructure.md | Defines a step-by-step implementation plan for setting up a complete Docker-based development infrastructure with multi-service orchestration including PostgreSQL, Redis, Traefik, Authentik, FastAPI backend, and React frontend. | dep: Docker, Docker Compose, Make, Python 3.11, Node.js 20, PostgreSQL, Redis, Traefik, Authentik, FastAPI, React, Vite, nginx, alembic, uvicorn, SQLAlchemy, pydantic, structlog
|
||||
- 2026-05-17-auth-oauth.md | Implementation plan for adding Authentik-backed OIDC authentication with JWT access tokens and DB-backed refresh tokens to a FastAPI application | dep: FastAPI, SQLAlchemy, Alembic, python-jose, httpx, pytest, Authentik, PostgreSQL
|
||||
- 2026-05-17-database-models.md | Define an implementation plan for building SQLAlchemy 2.0 async database models, Alembic migrations, and seed data for a FastAPI backend. | dep: SQLAlchemy 2.x, asyncpg, Alembic, pytest, pytest-asyncio, Pydantic Settings, PostgreSQL, FastAPI
|
||||
- 2026-05-24-session-branch-selection.md | Implementation plan for replacing free-text branch input with a dropdown of available branches and adding "Create new branch" functionality in a session creation form | dep: React, TypeScript, FastAPI, Python, Git subprocess, Pydantic, API client
|
||||
- tool-container-home-directory.md | Implementation plan to make `/home/user` the configurable default home directory for tool containers while preserving repository name in mount targets, migrating legacy tool types, and maintaining `/workspace` backward compatibility symlink. | dep: Alembic, Docker, Compose, manifest compiler, instance service, config profile resolver, permission fixer, base dockerfile, pytest
|
||||
## arch
|
||||
Markdown-based technical specification documents using date-prefixed naming convention, each detailing phased implementation steps for specific system capabilities with technology stack integration points.
|
||||
Document-driven planning architecture using chronological Markdown specifications with precise technical scope, dependencies, and migration strategies for incremental system evolution.
|
||||
## tags
|
||||
05, fastapi, 2026, implementation, plan, docker, postgresql, authentik
|
||||
05, fastapi, 2026, implementation, plan, docker, alembic, postgresql
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
dir: docs/superpowers/specs
|
||||
|
||||
## role
|
||||
Contains design specification documents for planned system features, serving as architectural decision records for authentication and session management capabilities.
|
||||
Contains design specifications and test plans for upcoming features ("superpowers") being planned for the project.
|
||||
## parent
|
||||
index: docs/superpowers/.pi-map.index.md
|
||||
map: docs/superpowers/.pi-map.md
|
||||
@@ -11,6 +11,7 @@ map: docs/superpowers/.pi-map.md
|
||||
## files
|
||||
- 2026-05-17-auth-oauth-design.md
|
||||
- 2026-05-24-session-branch-selection-design.md
|
||||
- tool-container-home-directory-test-plan.md
|
||||
## links
|
||||
index: docs/superpowers/specs/.pi-map.index.md
|
||||
map: docs/superpowers/specs/.pi-map.md
|
||||
|
||||
@@ -4,14 +4,15 @@ dir: docs/superpowers/specs
|
||||
index: docs/superpowers/specs/.pi-map.index.md
|
||||
|
||||
## role
|
||||
Contains design specification documents for planned system features, serving as architectural decision records for authentication and session management capabilities.
|
||||
Contains design specifications and test plans for upcoming features ("superpowers") being planned for the project.
|
||||
## files
|
||||
- 2026-05-17-auth-oauth-design.md | Design document for implementing OAuth2/OIDC authentication with Authentik, internal JWT access tokens, and database-backed refresh token rotation. | dep: Authentik, JWKS, JWT, database/PostgreSQL, cookies, pytest, mypy, ruff
|
||||
- 2026-05-24-session-branch-selection-design.md | Design document for replacing free-text branch input with a dropdown of available branches and adding the ability to create a new local branch at clone time in a session creation UI. | dep: React/TypeScript frontend, Python/FastAPI backend, Git, API client, ToolInstance database model
|
||||
- tool-container-home-directory-test-plan.md | Test plan and QA checklist for validating configurable home directory behavior in tool containers, covering manifest compilation, path expansion, database migrations, and mount target resolution. | dep: pytest, alembic, docker, compose, manifest compiler, instance service, ToolType, config profiles, git mounts
|
||||
## arch
|
||||
Markdown-based technical design documentation following a chronological naming convention (YYYY-MM-DD-feature-name-design.md) with no executable code, using a lightweight specification format for capturing requirements, decisions, and implementation plans before development.
|
||||
Document-driven architecture using dated Markdown design documents for feature specifications, plus standalone test plans for QA validation of complex features.
|
||||
## tags
|
||||
design, 2026, 05, branch, session, document, authentik, jwt
|
||||
design, 2026, 05, branch, database, session, test, plan
|
||||
## symbols
|
||||
-
|
||||
## workflows
|
||||
|
||||
Reference in New Issue
Block a user