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/schemas/tool/.pi-map.md

@@ -0,0 +1,27 @@
+# apps/api/src/schemas/tool
+dir: apps/api/src/schemas/tool
+
+index: apps/api/src/schemas/tool/.pi-map.index.md
+
+## role
+Provides Pydantic data validation schemas for tool-related API operations including tool types and instances.
+## files
+- __init__.py | Re-exports tool-related schema classes from submodules to provide a unified import interface for the tool schemas module. | dep: src.schemas.tool.tool_instance, src.schemas.tool.tool_type
+- tool_instance.py | Defines Pydantic request/response schemas for tool instance lifecycle operations (create and start). | exp: class:CreateInstanceRequest, class:StartInstanceRequest | dep: pydantic
+- tool_type.py | Defines Pydantic request/response schemas for creating, updating, and validating tool types with Docker compose/dockerfile/manifest definitions | exp: class:ToolTypeCreate, class:ToolTypeUpdate, class:ToolTypeResponse, class:ToolTypeValidateRequest | dep: uuid, datetime, pydantic, src.api.tool.tool_types_validation
+## arch
+Modular schema organization with submodule-per-entity pattern and unified re-export interface via `__init__.py`, following standard Python package structure for clean API imports.
+## tags
+tool, type, request, instance, schemas, create, pydantic, response
+## symbols
+- CreateInstanceRequest
+- StartInstanceRequest
+- ToolTypeCreate
+- ToolTypeUpdate
+- ToolTypeResponse
+- ToolTypeValidateRequest
+## workflows
+- change tool behavior
+  read: __init__.py, tool_instance.py, tool_type.py
+## dirty
+-