feat(m37): wave 3 — watch-long-look, WatchConnectivity-relay en queue-tap-pad #210

Merged
janpeter merged 8 commits from claude/m37-wave3-watch into main 2026-08-29 19:56:57 +02:00
Owner

M37 wave 3 (PBI-153, ST-1566 + ST-1567): de polskant van IDEA-191 en de app-kant van IDEA-197. Hiermee is M37 codecompleet — wat resteert is de fysieke gate op iPhone + Apple Watch Ultra 2.

Inhoud

Basis is main na wave 2 (0eac9a0). Zeven commits, elk met eigen taakreview:

Commit Taak
c5bd63a T9 — LongLookContent/LongLookMapper + publieke permission-titelconstanten
71f7292 T10 — HubWatch productie: 14 WKNotificationScenes, long-look-states, RelaySender-stub
26947ee + 49e1ace T11 — WatchConnectivity-relay (watch + iPhone) en de reviewfixes
59701af Buiten het plan, op verzoek van JP — buildinfo (versie, buildnummer, buildtijd) op het watch-hoofdscherm
3bb43fd T12 — queue-tap-pad + stille foreground-presentatie
5048a3a T13 — hub-apns.md, .env.example, gate-runbook, buildnummer
ed79e9a Fixgolf uit de eindreview over de hele branch

De spike-watchapp is volledig vervangen: knoppen op de pols sturen nu echt een antwoord, via WatchConnectivity naar de iPhone, die het bestaande signed-POST-pad gebruikt. De watch bezit geen sleutels.

Beslissingen die van het plan afwijken

  1. Buildnummer 12, niet 11. Het plan schrijft "11" voor, maar dat nummer is vandaag al vergeven aan de wave-2-upload; App Store Connect weigert een herhaling binnen dezelfde MARKETING_VERSION.
  2. Het tint(_:)-codeblok uit het plan compileert niet. case .sending(let i) where i == index, .sent: bindt i niet in beide alternatieven. Gesplitst in twee arms met identiek gedrag.
  3. resolution alleen bij een terminale uitkomst. Het plan hing hem aan bij alles wat niet-retryable was, inclusief .surfaceError. Daardoor werd een 401 — plausibel tijdens het opnieuw pairen dat het gate-runbook zélf voorschrijft — op de pols een dood scherm met een rauwe "Unauthorized" en uitgeschakelde knoppen. Nu outcome == .terminal (409/404/410), met regressietests voor 401 en 422.

Verder verwerkt uit de reviews: een data race op de payload-capture in WatchRelayHandler (schrijven vanuit een niet-geïsoleerde Task, lezen vanaf de main-thread op het expiry-pad), een ontbrekende pending.note waardoor een antwoord op het queued-pad spoorloos kon verdwijnen, en een race-test die zijn eigen background-task-belofte niet controleerde.

Verificatie

Door de orkestrator zelf herhaald op ed79e9a, niet overgenomen van de uitvoerders:

resultaat
npm run verify 0 lint-errors (5 pre-existing warnings), typecheck schoon, 317 bestanden / 2614 tests groen
npm run ios:test TEST SUCCEEDED, 198 tests, 0 failures
npm run ios:build BUILD SUCCEEDED (HubApp + NSE + embedded HubWatch)
npm run docs INDEX + linkcheck groen

Gotcha die tijdens de bouw boven kwam: HubApp.xcodeproj is gitignored en géén van de npm-scripts draait xcodegen generate. Een groene ios:build bewijst dus niet dat een project.yml-wijziging is doorgekomen — draai xcodegen generate vóór het archiveren.

Na de merge

Build 12 uploaden naar TestFlight en de checklist in docs/runbooks/hub-m37-e2e-gate.md fysiek aflopen. Twee open punten staan daar expliciet in: of de getoonde buildtijd na Apple's hersignering nog de bouwtijd is of de installatietijd, en welke build vooraf op het toestel stond (dat bepaalt of gate-item 5 de v1-migratie of v2-continuïteit test).

🤖 Generated with Claude Code

M37 wave 3 (PBI-153, ST-1566 + ST-1567): de polskant van IDEA-191 en de app-kant van IDEA-197. Hiermee is M37 codecompleet — wat resteert is de fysieke gate op iPhone + Apple Watch Ultra 2. ## Inhoud Basis is `main` na wave 2 (`0eac9a0`). Zeven commits, elk met eigen taakreview: | Commit | Taak | |---|---| | `c5bd63a` | T9 — `LongLookContent`/`LongLookMapper` + publieke permission-titelconstanten | | `71f7292` | T10 — HubWatch productie: 14 `WKNotificationScene`s, long-look-states, `RelaySender`-stub | | `26947ee` + `49e1ace` | T11 — WatchConnectivity-relay (watch + iPhone) en de reviewfixes | | `59701af` | **Buiten het plan, op verzoek van JP** — buildinfo (versie, buildnummer, buildtijd) op het watch-hoofdscherm | | `3bb43fd` | T12 — queue-tap-pad + stille foreground-presentatie | | `5048a3a` | T13 — `hub-apns.md`, `.env.example`, gate-runbook, buildnummer | | `ed79e9a` | Fixgolf uit de eindreview over de hele branch | De spike-watchapp is volledig vervangen: knoppen op de pols sturen nu echt een antwoord, via WatchConnectivity naar de iPhone, die het bestaande signed-POST-pad gebruikt. De watch bezit geen sleutels. ## Beslissingen die van het plan afwijken 1. **Buildnummer 12, niet 11.** Het plan schrijft `"11"` voor, maar dat nummer is vandaag al vergeven aan de wave-2-upload; App Store Connect weigert een herhaling binnen dezelfde `MARKETING_VERSION`. 2. **Het `tint(_:)`-codeblok uit het plan compileert niet.** `case .sending(let i) where i == index, .sent:` bindt `i` niet in beide alternatieven. Gesplitst in twee arms met identiek gedrag. 3. **`resolution` alleen bij een terminale uitkomst.** Het plan hing hem aan bij alles wat niet-retryable was, inclusief `.surfaceError`. Daardoor werd een 401 — plausibel tijdens het opnieuw pairen dat het gate-runbook zélf voorschrijft — op de pols een dood scherm met een rauwe "Unauthorized" en uitgeschakelde knoppen. Nu `outcome == .terminal` (409/404/410), met regressietests voor 401 en 422. Verder verwerkt uit de reviews: een data race op de payload-capture in `WatchRelayHandler` (schrijven vanuit een niet-geïsoleerde Task, lezen vanaf de main-thread op het expiry-pad), een ontbrekende `pending.note` waardoor een antwoord op het queued-pad spoorloos kon verdwijnen, en een race-test die zijn eigen background-task-belofte niet controleerde. ## Verificatie Door de orkestrator zelf herhaald op `ed79e9a`, niet overgenomen van de uitvoerders: | | resultaat | |---|---| | `npm run verify` | 0 lint-errors (5 pre-existing warnings), typecheck schoon, **317 bestanden / 2614 tests groen** | | `npm run ios:test` | **TEST SUCCEEDED**, 198 tests, 0 failures | | `npm run ios:build` | **BUILD SUCCEEDED** (HubApp + NSE + embedded HubWatch) | | `npm run docs` | INDEX + linkcheck groen | Gotcha die tijdens de bouw boven kwam: `HubApp.xcodeproj` is gitignored en géén van de npm-scripts draait `xcodegen generate`. Een groene `ios:build` bewijst dus niet dat een `project.yml`-wijziging is doorgekomen — draai `xcodegen generate` vóór het archiveren. ## Na de merge Build 12 uploaden naar TestFlight en de checklist in `docs/runbooks/hub-m37-e2e-gate.md` fysiek aflopen. Twee open punten staan daar expliciet in: of de getoonde buildtijd na Apple's hersignering nog de bouwtijd is of de installatietijd, en welke build vooraf op het toestel stond (dat bepaalt of gate-item 5 de v1-migratie of v2-continuïteit test). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
HUB_DYN_*-classificatie loopt via dynamicSlotIndex(suffix:) (SlotLeases.swift)
i.p.v. een losse hasPrefix-check, zodat er geen tweede slot-classificatie
ontstaat naast T7/T8.
- FinishGate-race op `latest` opgelost: write + gate.finish(.completed) samen
  op de main actor (Important #1)
- pending.note(...) toegevoegd naast apply(...), zodat een 409/contractfout op
  het gequeuede (didReceiveUserInfo) pad niet stilzwijgend verdwijnt
  (Important #2)
- resolution alleen in de reply bij een niet-retryable outcome, zodat een
  429/500/503 op de watch als .failed (herprobeerbaar) i.p.v. .alreadyAnswered
  (permanent) landt (Important #3)
- race-test bewijst nu ook endBackgroundTask-exact-once en blijft het volledige
  stallingsvenster actief zodat een over-fulfil aan de juiste test wordt
  toegeschreven (Important #4); regressietest voor #3 toegevoegd, RED bevestigd
  vóór de fix
Documenteert het werkelijke gebouwde M37-gedrag in hub-apns.md (slot-
categorieën, watch-long-look, relay-antwoordcontract, queue-statuspush) en
voegt hub-m37-e2e-gate.md toe als fysiek draaiboek (spec §8 + twee extra
gate-items uit de T13-ruling: buildinfo op het horloge, stille foreground-
queue-push).

Ruling-afwijking van de brief: CURRENT_PROJECT_VERSION gaat naar "12", niet
"11" — build 11 is vandaag al naar App Store Connect geüpload voor de
vorige golf (M37-wave-2), en Apple weigert een hernieuwd buildnummer binnen
dezelfde MARKETING_VERSION.
fix(ios-hub): wave-3 review fixes voor watch-long-look (M37)
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 5m39s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
ed79e9a802
Blocking: resolution werd meegestuurd bij .surfaceError (401/403/422),
niet alleen .terminal (409/404/410) — een 401 tijdens de re-pairing-
window na een TestFlight-herinstall rendert daardoor als permanent
"al beantwoord" i.p.v. een herprobeerbare mislukking. Guard versmald
naar `outcome == .terminal`; nieuwe tests (401/422) bewijzen RED→GREEN.

Overige zeven findings: notificationActions-fallback in de
LongLookController-else-tak, stale SPIKE-comment in project.yml (M37
is productiecode), method- i.p.v. property-notatie in hub-apns.md,
ontbrekende build-context in gate-item 5, documentatie-comment voor
het ongebruikte reply["status"]-veld, os.Logger-trace voor de stille
didReceiveUserInfo-drop bij een nil clientProvider, en een
intentie-comment op de .failed-knoppenlock in LongLookView.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

Verdict: REQUEST_CHANGES

geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden.

Findings

  • Blocker — docs/patterns/hub-apns.md:218 / docs/runbooks/hub-m37-e2e-gate.md:19: deze PR documenteert queue-statuspushes als onderdeel van M37, inclusief HUB_QUEUE_STATUS_PUSH, shouldPushQueueStatus, sendQueueStatusPush, config-registratie en het invoegpunt in handleQueueEnvelope, maar de unified diff bevat geen wijzigingen in lib/hub/config-server.ts, lib/hub/runtime-server.ts, lib/hub/queue-status-payload.ts of lib/hub/queue-status-push-server.ts. Daardoor claimen docs/runbook/env dat een serverfeature live is terwijl de PR alleen de iOS tap-routing en watch-relay toevoegt. Dit is blokkerend: óf de serverimplementatie moet in deze PR zitten, óf de M37-docs/runbook/env-claim moeten worden teruggescopeerd naar wat deze PR daadwerkelijk levert.
# Verdict: REQUEST_CHANGES geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. ## Findings - **Blocker** — `docs/patterns/hub-apns.md:218` / `docs/runbooks/hub-m37-e2e-gate.md:19`: deze PR documenteert queue-statuspushes als onderdeel van M37, inclusief `HUB_QUEUE_STATUS_PUSH`, `shouldPushQueueStatus`, `sendQueueStatusPush`, config-registratie en het invoegpunt in `handleQueueEnvelope`, maar de unified diff bevat geen wijzigingen in `lib/hub/config-server.ts`, `lib/hub/runtime-server.ts`, `lib/hub/queue-status-payload.ts` of `lib/hub/queue-status-push-server.ts`. Daardoor claimen docs/runbook/env dat een serverfeature live is terwijl de PR alleen de iOS tap-routing en watch-relay toevoegt. Dit is blokkerend: óf de serverimplementatie moet in deze PR zitten, óf de M37-docs/runbook/env-claim moeten worden teruggescopeerd naar wat deze PR daadwerkelijk levert.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/Scrum4Me!210
No description provided.