chore: track all project map and index files

Add generated .pi-map.md and .pi-map.index.md files across the repository
so the project navigation maps are shared and versioned. These artifacts
are maintained by project_map_init/patch/validate and must be kept in
sync with source edits.

Note: .cache/ remains ignored (added in previous commit).

tool-images/.pi-map.index.md

@@ -0,0 +1,24 @@
+# tool-images (index)
+dir: tool-images
+
+## role
+Provides containerized development environment templates for various IDE, notebook, and AI agent tools used in the Headquarter platform.
+## parent
+index: ./.pi-map.index.md
+map: ./.pi-map.md
+## children
+-
+## files
+- README.md
+- base.dockerfile
+- code-server.dockerfile
+- jupyter.dockerfile
+- opencode.dockerfile
+- pi-agent.dockerfile
+## links
+index: tool-images/.pi-map.index.md
+map: tool-images/.pi-map.md
+## workflows
+-
+## dirty
+-

tool-images/.pi-map.md

@@ -0,0 +1,24 @@
+# tool-images
+dir: tool-images
+
+index: tool-images/.pi-map.index.md
+
+## role
+Provides containerized development environment templates for various IDE, notebook, and AI agent tools used in the Headquarter platform.
+## files
+- README.md | Documents a directory of Dockerfile templates for base tool types used in the Headquarter platform | dep: Docker, git, neovim, ranger, tmux, htop, tree, jq, Node.js 20, Pi Coding Agent
+- base.dockerfile | Defines a base Docker image for development environments with common CLI tools, Node.js, and a non-root user setup. | dep: ubuntu:24.04, curl, wget, git, neovim, ranger, tmux, htop, tree, jq, ca-certificates, nodejs
+- code-server.dockerfile | Builds a Docker image for browser-based VS Code with additional development tools and Node.js | dep: linuxserver/code-server, git, neovim, ranger, tmux, htop, tree, jq, Node.js 20
+- jupyter.dockerfile | Builds a Docker image for Jupyter Notebook/Lab with additional CLI tools and git configuration | dep: jupyter/scipy-notebook, apt, git, neovim, ranger, tmux, htop, tree, jq
+- opencode.dockerfile | Builds a Docker container for running the OpenCode AI agent as a server | dep: ubuntu:24.04, nodejs, npm, python3, git, opencode
+- pi-agent.dockerfile | Builds a Docker image for a terminal-based coding environment with the Pi Coding Agent, development tools, and a non-root user setup. | dep: ubuntu:24.04, nodejs, npm, @earendil-works/pi-coding-agent, neovim, ranger, tmux, git, python3, build-essential
+## arch
+Multi-stage Dockerfile pattern with shared base image containing common CLI utilities, Node.js, and non-root user security model, specialized per tool type (VS Code server, Jupyter, OpenCode agent, Pi agent).
+## tags
+git, docker, neovim, ranger, tmux, agent, base, htop
+## symbols
+-
+## workflows
+-
+## dirty
+-