Add integration coverage for companion platform clients

docs/plans/2026-02-16-companion-platform-clients-integration-coverage-checklist.md

@@ -0,0 +1,20 @@
+# Companion Platform Clients Integration Coverage Checklist (2026-02-16)
+
+## Scope
+
+- Add gateway-backed integration coverage for platform wrappers so behavior is validated against live JSON-RPC handling, not only mocks.
+
+## Implementation
+
+- Added `src/companion/platformClients.integration.test.ts`.
+- Test harness spins up a real `GatewayServer` fixture with node RPC enabled and token auth.
+- Each platform wrapper is exercised end-to-end:
+  - macOS: registration + status (`platform: macos`) + `system.nodes` visibility
+  - iOS: registration + APNs push registration + `system.nodes` visibility
+  - Android: registration + FCM push registration + `system.nodes` visibility
+
+## Validation
+
+- `pnpm test:run src/companion/platformClients.integration.test.ts src/companion/platformClients.test.ts src/companion/runtimeClient.test.ts`
+- `pnpm typecheck`
+- `pnpm build`

docs/plans/state.json

@@ -744,6 +744,19 @@
       ],
       "test_status": "pnpm test:run src/companion/platformClients.test.ts src/companion/runtimeClient.test.ts + pnpm typecheck + pnpm build passing"
     },
+    "companion-platform-clients-integration-coverage": {
+      "file": "2026-02-16-companion-platform-clients-integration-coverage-checklist.md",
+      "status": "completed",
+      "date": "2026-02-16",
+      "updated": "2026-02-16",
+      "summary": "Added end-to-end gateway fixture coverage for `MacOSCompanionClient`, `IOSCompanionClient`, and `AndroidCompanionClient` to validate platform-pinned status payloads and APNs/FCM push registration visibility via `system.nodes`.",
+      "files_created": [
+        "docs/plans/2026-02-16-companion-platform-clients-integration-coverage-checklist.md",
+        "src/companion/platformClients.integration.test.ts"
+      ],
+      "files_modified": [],
+      "test_status": "pnpm test:run src/companion/platformClients.integration.test.ts src/companion/platformClients.test.ts src/companion/runtimeClient.test.ts + pnpm typecheck + pnpm build passing"
+    },
     "qmd-backend": {
       "file": "2026-02-16-qmd-backend-checklist.md",
       "status": "completed",
@@ -3305,7 +3318,7 @@
     }
   },
   "overall_progress": {
-    "total_test_count": 1820,
+    "total_test_count": 1823,
     "all_tests_passing": true,
     "p0_completion": "3/3 (100%)",
     "p1_completion": "4/4 (100%)",
@@ -3325,7 +3338,7 @@
     "gmail_auth_cli": "flynn gmail-auth command implemented with OAuth2 flow, doctor check, config routed to Telegram",
     "native_audio_support": "completed — smart routing for native audio (Gemini/OpenAI/GitHub) vs Whisper transcription fallback",
     "remaining_phases_completion": "Phase 1: 3/3 (100%) — context levels, command registry, memory structure. Phase 2: 3/3 (100%) — component registry, confidence routing, history index. Phase 3: 2/2 (100%) — adaptive memory/compaction, truthfulness/autonomy hardening",
-    "next_up": "OpenClaw gap: integrate companion platform clients into concrete app runtimes and add end-to-end gateway fixture coverage"
+    "next_up": "OpenClaw gap: wire companion platform clients into concrete macOS/iOS/Android runtime app entrypoints"
   },
   "soul_md_and_cron_create": {
     "date": "2026-02-11",