feat(tools): add kubernetes homelab awareness tools

README.md

@@ -28,6 +28,7 @@ Self-hosted personal AI assistant with Telegram and Terminal interfaces.
 - **Scheduled Backups**: Interval- or cron-based snapshot backups with optional startup run
 - **MinIO File Sharing Tool**: Upload a local file and return a temporary MinIO share link via `minio.share`
 - **MinIO Knowledge Ingestion Tool**: Pull text-like objects from MinIO into memory namespaces via `minio.ingest`
+- **Kubernetes Homelab Tools**: Inspect pods/deployments and fetch logs via `k8s.pods`, `k8s.deployments`, `k8s.logs`
 - **Gmail Pub/Sub Watcher**: Monitor Gmail inbox via Google Cloud Pub/Sub push notifications with polling fallback
 - **Vector Memory Search**: Hybrid keyword + semantic search with embeddings (OpenAI, Gemini, Ollama, llama.cpp, Voyage AI)
 - **Docker Deployment**: Multi-stage Dockerfile and docker-compose.yml for production containers
@@ -629,6 +630,22 @@ When `backup.minio.enabled` is configured, Flynn also exposes MinIO tools:
 - `minio.ingest`: read a text-like object from MinIO and append/replace a memory namespace (useful for syncing notes/runbooks into long-term memory)
 - `minio.sync`: recursively ingest a MinIO prefix into nested memory namespaces with object and size limits
 
+## Kubernetes Tools
+
+Optional Kubernetes tools are available when `k8s.enabled: true`:
+
+- `k8s.pods`: list pod status (phase, ready count, restarts)
+- `k8s.deployments`: list deployment replica readiness
+- `k8s.logs`: fetch recent pod logs
+
+```yaml
+k8s:
+  enabled: true
+  kubectl_path: kubectl
+  default_namespace: observability
+  allowed_namespaces: [observability, platform]
+```
+
 ## Inbound Webhooks
 
 HTTP endpoints that trigger agent processing. Each webhook accepts POST requests, optionally verifies an HMAC signature, renders a message template, and routes the agent's response to an output channel.