docs(adr-125): Apple HomePod user guide + README badge

- Add docs/user-guide-apple-homepod.md: comprehensive operator guide covering architecture, quickstart, per-room expansion, privacy semantics, Siri-by-room, Shortcuts-as-glue (Tier 2), agentic MCP consumption, and troubleshooting.
- Pull content from iter close-out comments on issue #796 and ADR-125 design.
- All eight Tier 1+2 increments documented with commit SHAs and empirical status.
- Update README.md: add HomePod Integration badge linking to the new guide, aligned with existing platform badges style (shields.io format, Apple logo, black background).

Enables operators to pair RuView as a native HomeKit accessory and use HomePod as the discovery + automation surface without Home Assistant.

.claude-flow/metrics/codebase-map.json

@@ -1,11 +1,11 @@
 {
-  "timestamp": "2026-02-28T16:13:19.193Z",
-  "projectRoot": "/home/user/wifi-densepose",
+  "timestamp": "2026-05-25T06:07:33.385Z",
+  "projectRoot": "C:\\Users\\ruv\\Projects\\wifi-densepose",
   "structure": {
     "hasPackageJson": false,
     "hasTsConfig": false,
     "hasClaudeConfig": true,
     "hasClaudeFlow": true
   },
-  "scannedAt": 1772295199193
+  "scannedAt": 1779689253386
 }