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

apps/api/src/models/tool/.pi-map.index.md

@@ -0,0 +1,23 @@
+# apps/api/src/models/tool (index)
+dir: apps/api/src/models/tool
+
+## role
+Defines SQLAlchemy ORM models for managing tool definitions, instances, and types in a container-based deployment system.
+## parent
+index: apps/api/src/models/.pi-map.index.md
+map: apps/api/src/models/.pi-map.md
+## children
+-
+## files
+- __init__.py
+- tool_definition_manifest.py
+- tool_instance.py
+- tool_type.py
+## links
+index: apps/api/src/models/tool/.pi-map.index.md
+map: apps/api/src/models/tool/.pi-map.md
+## workflows
+- change tool behavior
+  read: __init__.py, tool_definition_manifest.py, tool_instance.py
+## dirty
+-

apps/api/src/models/tool/.pi-map.md

@@ -0,0 +1,25 @@
+# apps/api/src/models/tool
+dir: apps/api/src/models/tool
+
+index: apps/api/src/models/tool/.pi-map.index.md
+
+## role
+Defines SQLAlchemy ORM models for managing tool definitions, instances, and types in a container-based deployment system.
+## files
+- __init__.py | Exports the public API for the tool models module by re-exporting three key classes. | dep: src.models.tool.tool_definition_manifest, src.models.tool.tool_instance, src.models.tool.tool_type
+- tool_definition_manifest.py | Defines a SQLAlchemy ORM model for storing tool definition manifests that compile to Dockerfiles and Compose files, supporting both base definitions and tool-specific definitions with inheritance. | exp: class:ToolDefinitionManifest | dep: uuid, typing, sqlalchemy, sqlalchemy.orm, src.models.base, src.models.user
+- tool_instance.py | Defines a SQLAlchemy ORM model for tool instances that represent deployed tools with container/runtime metadata and relationships to users, projects, repositories, and workspaces. | exp: class:ToolInstance | dep: uuid, datetime, typing, sqlalchemy, sqlalchemy.orm, src.models.base, src.models, src.models.project, src.models.user, src.models (ConfigProfile, GitRepository, Project, ToolType, User, Workspace)
+- tool_type.py | Defines a SQLAlchemy ORM model for tool types that represent configurable categories of tools with deployment templates, manifest references, and metadata. | exp: class:ToolType | dep: uuid, typing, sqlalchemy, sqlalchemy.orm, src.models.base, src.models.tool.tool_definition_manifest, src.models.user
+## arch
+Domain-driven SQLAlchemy ORM models with inheritance patterns (base/tool-specific manifests), rich relationships (users, projects, repositories, workspaces), and template-based deployment abstractions.
+## tags
+tool, models, src, sqlalchemy, orm, definition, manifest, base
+## symbols
+- ToolDefinitionManifest
+- ToolInstance
+- ToolType
+## workflows
+- change tool behavior
+  read: __init__.py, tool_definition_manifest.py, tool_instance.py
+## dirty
+-