# . (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
This is an empty package directory with no files to analyze.
## parent
-
## children
- 2025-05-17-oauth-traefik-integration
  index: 2025-05-17-oauth-traefik-integration/.pi-map.index.md
  map: 2025-05-17-oauth-traefik-integration/.pi-map.md
- 2025-05-17-user-profile
  index: 2025-05-17-user-profile/.pi-map.index.md
  map: 2025-05-17-user-profile/.pi-map.md
- 2025-05-18-git-repo-management
  index: 2025-05-18-git-repo-management/.pi-map.index.md
  map: 2025-05-18-git-repo-management/.pi-map.md
- 2025-05-18-ssh-key-management
  index: 2025-05-18-ssh-key-management/.pi-map.index.md
  map: 2025-05-18-ssh-key-management/.pi-map.md
- 2025-05-18-test-infrastructure-improvements
  index: 2025-05-18-test-infrastructure-improvements/.pi-map.index.md
  map: 2025-05-18-test-infrastructure-improvements/.pi-map.md
- 2025-05-18-tool-types-definition
  index: 2025-05-18-tool-types-definition/.pi-map.index.md
  map: 2025-05-18-tool-types-definition/.pi-map.md
- 2025-05-18-user-config-management
  index: 2025-05-18-user-config-management/.pi-map.index.md
  map: 2025-05-18-user-config-management/.pi-map.md
- 2026-05-17-auth-oauth
  index: 2026-05-17-auth-oauth/.pi-map.index.md
  map: 2026-05-17-auth-oauth/.pi-map.md
- 2026-05-17-database-models
  index: 2026-05-17-database-models/.pi-map.index.md
  map: 2026-05-17-database-models/.pi-map.md
- 2026-05-17-frontend-foundation
  index: 2026-05-17-frontend-foundation/.pi-map.index.md
  map: 2026-05-17-frontend-foundation/.pi-map.md
- 2026-05-17-project-management
  index: 2026-05-17-project-management/.pi-map.index.md
  map: 2026-05-17-project-management/.pi-map.md
- 2026-05-18-database-setup-recovery
  index: 2026-05-18-database-setup-recovery/.pi-map.index.md
  map: 2026-05-18-database-setup-recovery/.pi-map.md
- 2026-05-18-simplify-authentik-auth
  index: 2026-05-18-simplify-authentik-auth/.pi-map.index.md
  map: 2026-05-18-simplify-authentik-auth/.pi-map.md
- 2026-05-19-api-documentation
  index: 2026-05-19-api-documentation/.pi-map.index.md
  map: 2026-05-19-api-documentation/.pi-map.md
- 2026-05-19-documentation-overhaul
  index: 2026-05-19-documentation-overhaul/.pi-map.index.md
  map: 2026-05-19-documentation-overhaul/.pi-map.md
- 2026-05-19-file-editor
  index: 2026-05-19-file-editor/.pi-map.index.md
  map: 2026-05-19-file-editor/.pi-map.md
- 2026-05-19-git-control
  index: 2026-05-19-git-control/.pi-map.index.md
  map: 2026-05-19-git-control/.pi-map.md
- 2026-05-19-git-history-visualization
  index: 2026-05-19-git-history-visualization/.pi-map.index.md
  map: 2026-05-19-git-history-visualization/.pi-map.md
- 2026-05-19-repo-workspace
  index: 2026-05-19-repo-workspace/.pi-map.index.md
  map: 2026-05-19-repo-workspace/.pi-map.md
- 2026-05-19-responsive-spacing-improvements
  index: 2026-05-19-responsive-spacing-improvements/.pi-map.index.md
  map: 2026-05-19-responsive-spacing-improvements/.pi-map.md
- 2026-05-19-smart-git-url-parsing
  index: 2026-05-19-smart-git-url-parsing/.pi-map.index.md
  map: 2026-05-19-smart-git-url-parsing/.pi-map.md
- 2026-05-19-tool-instances
  index: 2026-05-19-tool-instances/.pi-map.index.md
  map: 2026-05-19-tool-instances/.pi-map.md
- 2026-05-19-tool-terminal
  index: 2026-05-19-tool-terminal/.pi-map.index.md
  map: 2026-05-19-tool-terminal/.pi-map.md
- 2026-05-19-universal-icon-system
  index: 2026-05-19-universal-icon-system/.pi-map.index.md
  map: 2026-05-19-universal-icon-system/.pi-map.md
- 2026-05-19-workspace-visual-overhaul
  index: 2026-05-19-workspace-visual-overhaul/.pi-map.index.md
  map: 2026-05-19-workspace-visual-overhaul/.pi-map.md
- 2026-05-22-cloudflare-tunnel-instances-superseded
  index: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.index.md
  map: 2026-05-22-cloudflare-tunnel-instances-superseded/.pi-map.md
- 2026-05-22-enforce-single-tool-type-with-port-config
  index: 2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.index.md
  map: 2026-05-22-enforce-single-tool-type-with-port-config/.pi-map.md
- 2026-05-22-git-repo-ssh-clone-check
  index: 2026-05-22-git-repo-ssh-clone-check/.pi-map.index.md
  map: 2026-05-22-git-repo-ssh-clone-check/.pi-map.md
- 2026-05-22-git-repo-working-clones
  index: 2026-05-22-git-repo-working-clones/.pi-map.index.md
  map: 2026-05-22-git-repo-working-clones/.pi-map.md
- 2026-05-22-instance-health-monitoring
  index: 2026-05-22-instance-health-monitoring/.pi-map.index.md
  map: 2026-05-22-instance-health-monitoring/.pi-map.md
- 2026-05-22-instance-proxy
  index: 2026-05-22-instance-proxy/.pi-map.index.md
  map: 2026-05-22-instance-proxy/.pi-map.md
- 2026-05-22-opencode-web-terminal
  index: 2026-05-22-opencode-web-terminal/.pi-map.index.md
  map: 2026-05-22-opencode-web-terminal/.pi-map.md
- 2026-05-22-repo-clone-mode-with-ssh
  index: 2026-05-22-repo-clone-mode-with-ssh/.pi-map.index.md
  map: 2026-05-22-repo-clone-mode-with-ssh/.pi-map.md
- 2026-05-22-session-management-fixes
  index: 2026-05-22-session-management-fixes/.pi-map.index.md
  map: 2026-05-22-session-management-fixes/.pi-map.md
- 2026-05-22-sessions-hub
  index: 2026-05-22-sessions-hub/.pi-map.index.md
  map: 2026-05-22-sessions-hub/.pi-map.md
- 2026-05-22-tool-config-management
  index: 2026-05-22-tool-config-management/.pi-map.index.md
  map: 2026-05-22-tool-config-management/.pi-map.md
- 2026-05-22-tool-config-ui-rework
  index: 2026-05-22-tool-config-ui-rework/.pi-map.index.md
  map: 2026-05-22-tool-config-ui-rework/.pi-map.md
- 2026-05-22-tool-workshop
  index: 2026-05-22-tool-workshop/.pi-map.index.md
  map: 2026-05-22-tool-workshop/.pi-map.md
- 2026-05-22-ui-redesign-home-settings
  index: 2026-05-22-ui-redesign-home-settings/.pi-map.index.md
  map: 2026-05-22-ui-redesign-home-settings/.pi-map.md
- 2026-05-23-remove-built-in-tools
  index: 2026-05-23-remove-built-in-tools/.pi-map.index.md
  map: 2026-05-23-remove-built-in-tools/.pi-map.md
- 2026-05-24-terminal-startup-and-container-tools
  index: 2026-05-24-terminal-startup-and-container-tools/.pi-map.index.md
  map: 2026-05-24-terminal-startup-and-container-tools/.pi-map.md
- 2026-05-25-add-config-profiles
  index: 2026-05-25-add-config-profiles/.pi-map.index.md
  map: 2026-05-25-add-config-profiles/.pi-map.md
- 2026-05-25-mobile-app-usability
  index: 2026-05-25-mobile-app-usability/.pi-map.index.md
  map: 2026-05-25-mobile-app-usability/.pi-map.md
- 2026-05-25-mobile-pages-overhaul
  index: 2026-05-25-mobile-pages-overhaul/.pi-map.index.md
  map: 2026-05-25-mobile-pages-overhaul/.pi-map.md
- 2026-06-12-completed-changes-archive
  index: 2026-06-12-completed-changes-archive/.pi-map.index.md
  map: 2026-06-12-completed-changes-archive/.pi-map.md
- 2026-06-14-completed-specs-archive
  index: 2026-06-14-completed-specs-archive/.pi-map.index.md
  map: 2026-06-14-completed-specs-archive/.pi-map.md
## files
## links
index: ./.pi-map.index.md
map: ./.pi-map.md
## workflows
-
## dirty
-