docs(npu): update service maps and runbooks

README.md

@@ -19,6 +19,7 @@ swarm/
 │       └── vm/                 # VM provisioning role (local)
 ├── openclaw/                   # Live mirror of guest ~/.openclaw/
 ├── docker-compose.yaml         # LiteLLM + supporting services
+├── docs/                       # Swarm/agentmon/n8n infrastructure docs + diagrams
 ├── litellm-config.yaml         # LiteLLM static config
 ├── litellm-init-credentials.sh # Register API keys into LiteLLM DB
 ├── litellm-init-models.sh      # Register models into LiteLLM DB (idempotent)
@@ -29,6 +30,15 @@ swarm/
 └── README.md                   # This file
 ```
 
+## Current swarm/service architecture
+
+For the current host-side AI/search/voice automation stack, n8n watchdogs, and agentmon monitoring layer, see:
+
+- [`docs/swarm-infrastructure.md`](docs/swarm-infrastructure.md) — operational overview and quick checks
+- [`docs/swarm-infrastructure.html`](docs/swarm-infrastructure.html) — dark SVG architecture diagram
+- [`docs/diagram-maintenance.md`](docs/diagram-maintenance.md) — diagram upkeep conventions
+- OpenVINO NPU services and prototypes are documented in `swarm-common/obsidian-vault/will/will-shared-zap/Runbooks/OpenVINO NPU Services Runbook.md` and the component READMEs under `openvino-*-npu*/`. Live baseline ports are RAG `:18810`, Whisper NPU `:18816`, and embeddings `:18817`; sidecar ports `:18818`, `:18819`, `:18820`, and optional doc/image triage `:18829` are approved prototypes only, not live Atlas/Hermes routing.
+
 ## VM: zap
 
 | Property | Value |