Files
headquarter/.pi-map.index.md
T
Developer b26ed7c3e4 refactor: store workspaces as {workspace_id}/{repo_name} for natural git clone layout
Working copies were stored as /data/working-copies/{repo_id}/{workspace_name}/,
so git clone was forced into a user-named directory. That meant the container
mount basename was the workspace name (e.g. main) instead of the repo name.

- Generate the workspace UUID before cloning and clone into
  /data/working-copies/{workspace_id}/ so git creates {repo_name}/ naturally
- Set workspace.path to /data/working-copies/{workspace_id}/{repo_name}/
- Update _migrate_clone_into_workspace() to use the same layout
- _get_repository_mount_name() now prefers workspace.path basename and only
  falls back to remote URL / repo.name for legacy repo-only instances
- Update unit tests to assert workspace path basename is used for mounts

Quality gates:
- pytest tests/unit: 219 passed
- ruff: clean on changed files
- mypy: clean on changed files
2026-06-15 09:40:59 +00:00

2.1 KiB

. (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

A self-hosted project management and git repository platform with OAuth2 authentication, providing containerized deployment via Docker Compose.

parent

children

  • .atl index: .atl/.pi-map.index.md map: .atl/.pi-map.md
  • .claude index: .claude/.pi-map.index.md map: .claude/.pi-map.md
  • .opencode index: .opencode/.pi-map.index.md map: .opencode/.pi-map.md
  • .pi index: .pi/.pi-map.index.md map: .pi/.pi-map.md
  • .sisyphus index: .sisyphus/.pi-map.index.md map: .sisyphus/.pi-map.md
  • .stoneforge index: .stoneforge/.pi-map.index.md map: .stoneforge/.pi-map.md
  • apps index: apps/.pi-map.index.md map: apps/.pi-map.md
  • docs index: docs/.pi-map.index.md map: docs/.pi-map.md
  • e2e index: e2e/.pi-map.index.md map: e2e/.pi-map.md
  • minerv3 index: minerv3/.pi-map.index.md map: minerv3/.pi-map.md
  • openspec index: openspec/.pi-map.index.md map: openspec/.pi-map.md
  • scripts index: scripts/.pi-map.index.md map: scripts/.pi-map.md
  • tool-images index: tool-images/.pi-map.index.md map: tool-images/.pi-map.md
  • uploads index: uploads/.pi-map.index.md map: uploads/.pi-map.md

files

  • .env.example
  • .gitignore
  • AGENTS.md
  • CHANGELOG.md
  • Makefile
  • README.md
  • docker-compose.traefik.yml
  • docker-compose.yml
  • progress.md
  • swap-pane

index: ./.pi-map.index.md map: ./.pi-map.md

workflows

dirty