feat(m37): wave 2 — queue-statuspushes server + iOS slot-categorieën (twee-lanes-run) #208

Merged
janpeter merged 30 commits from claude/m37-wave2-integration into main 2026-08-29 15:55:40 +02:00
Owner

M37 wave 2 (PBI-153): de serverkant van de stille queue-statuspushes en de iOS slot-categorieën, uitgevoerd als twee parallelle lanes met de parallel-plan-execution-skill. Dit was tevens de dogfood-gate van die skill (JP: geslaagd, 2026-08-29).

Inhoud

Basis is de dubbel-GO plan-branch (spec r6 + plan p6/p7 + de twee spikes), plus zeven taakcommits en één integratiecorrectie.

Orchestrator — T5 (SEQUENTIAL-BEFORE)

  • f438aa2 HubNotifications watch-deelbaar; HubWatch → package

Lane A — server/TypeScript (T1–T4)

  • ad7177b HUB_QUEUE_STATUS_PUSH-vlag
  • a8531d2 filter + envelope-only payload
  • ff33033 direct send met Unregistered-hygiëne
  • c57c79a invoegpunt vóór de info/mac:jp-guard

Lane B — iOS/Swift (T6–T8)

  • c830e64 slot-leases v2 met v1-migratie en no-steal-toewijzing
  • f082b28 slot-bewuste merge — vervang-op-identifier + finale-set-cap
  • 073077c CategoryCoordinator op slot-leases — budget-gate, slotnaam, actie-succescheck

Integratiecorrectie

  • aa2a34a mergeCategories zonder default op occupiedSlots. Lane B introduceerde die default in T7 om call sites compileerbaar te houden en meldde dat; T8 migreerde alle call sites expliciet (12/12 geverifieerd) maar de default bleef staan. De genormeerde signatuur in het plan heeft er geen, en een default maakt een vergeten argument stil "geen slot bezet" — precies de no-steal-invariant van spec §4.3.

Verificatie (door de orchestrator zelf herhaald, niet overgenomen van de lanes)

Gemeten baseline op f438aa2, en het resultaat op de merge:

baseline na merge + fix
lint 0 errors, 5 warnings 0 errors, 5 warnings
typecheck 0 fouten 0 fouten
vitest 313 passed | 1 skipped bestanden · 2593 passed | 6 skipped tests 317 | 1 · 2614 | 6
ios:test HubNotificationsTests 26/0 · HubTests 187/0 46/0 · 187/0
ios:build BUILD SUCCEEDED BUILD SUCCEEDED

De delta is volledig verklaard door eigen werk (+4 testbestanden, +21 server-tests, +20 iOS-tests); geen bestaande test veranderde van uitkomst.

Anti-vacuïteit — mutatiegetest, niet alleen groen: het invoegpunt uitschakelen maakt 2 van 3 seam-tests rood; het slot-bewustzijn op beide productie-call-sites wegnemen maakt de iOS-bundle rood. Beide mutaties zijn daarna hersteld.

Nul merge-conflicten — de vooraf gedane bestandsconflict-analyse (één schrijver per bestand) voorspelde dat exact.

Scope

Wave 2 van M37. Niet in deze PR: T9–T12 (LongLook-mapper, HubWatch-scenes, WatchConnectivity-relay, queue-tap-pad) en T13 (docs + fysieke e2e-gate op iPhone + Watch Ultra 2 + TestFlight-build 11). Die staan nog op TO_DO; de bijbehorende stories ST-1566/ST-1567 zijn ongewijzigd.

Scrum4Me: T-1695 t/m T-1702 staan op done, ST-1564 en ST-1565 zijn gepromoveerd, met de dragende commits gelogd.

🤖 Generated with Claude Code

M37 wave 2 (PBI-153): de serverkant van de stille queue-statuspushes en de iOS slot-categorieën, uitgevoerd als **twee parallelle lanes** met de `parallel-plan-execution`-skill. Dit was tevens de dogfood-gate van die skill (JP: geslaagd, 2026-08-29). ## Inhoud Basis is de dubbel-GO plan-branch (spec r6 + plan p6/p7 + de twee spikes), plus zeven taakcommits en één integratiecorrectie. **Orchestrator — T5 (SEQUENTIAL-BEFORE)** - `f438aa2` HubNotifications watch-deelbaar; HubWatch → package **Lane A — server/TypeScript (T1–T4)** - `ad7177b` `HUB_QUEUE_STATUS_PUSH`-vlag - `a8531d2` filter + envelope-only payload - `ff33033` direct send met Unregistered-hygiëne - `c57c79a` invoegpunt vóór de info/mac:jp-guard **Lane B — iOS/Swift (T6–T8)** - `c830e64` slot-leases v2 met v1-migratie en no-steal-toewijzing - `f082b28` slot-bewuste merge — vervang-op-identifier + finale-set-cap - `073077c` CategoryCoordinator op slot-leases — budget-gate, slotnaam, actie-succescheck **Integratiecorrectie** - `aa2a34a` `mergeCategories` zonder default op `occupiedSlots`. Lane B introduceerde die default in T7 om call sites compileerbaar te houden en meldde dat; T8 migreerde alle call sites expliciet (12/12 geverifieerd) maar de default bleef staan. De genormeerde signatuur in het plan heeft er geen, en een default maakt een vergeten argument stil "geen slot bezet" — precies de no-steal-invariant van spec §4.3. ## Verificatie (door de orchestrator zelf herhaald, niet overgenomen van de lanes) Gemeten baseline op `f438aa2`, en het resultaat op de merge: | | baseline | na merge + fix | |---|---|---| | lint | 0 errors, 5 warnings | 0 errors, 5 warnings | | typecheck | 0 fouten | 0 fouten | | vitest | 313 passed \| 1 skipped bestanden · 2593 passed \| 6 skipped tests | 317 \| 1 · 2614 \| 6 | | `ios:test` | HubNotificationsTests 26/0 · HubTests 187/0 | 46/0 · 187/0 | | `ios:build` | BUILD SUCCEEDED | BUILD SUCCEEDED | De delta is volledig verklaard door eigen werk (+4 testbestanden, +21 server-tests, +20 iOS-tests); geen bestaande test veranderde van uitkomst. **Anti-vacuïteit — mutatiegetest, niet alleen groen:** het invoegpunt uitschakelen maakt 2 van 3 seam-tests rood; het slot-bewustzijn op beide productie-call-sites wegnemen maakt de iOS-bundle rood. Beide mutaties zijn daarna hersteld. **Nul merge-conflicten** — de vooraf gedane bestandsconflict-analyse (één schrijver per bestand) voorspelde dat exact. ## Scope Wave 2 van M37. **Niet** in deze PR: T9–T12 (LongLook-mapper, HubWatch-scenes, WatchConnectivity-relay, queue-tap-pad) en T13 (docs + fysieke e2e-gate op iPhone + Watch Ultra 2 + TestFlight-build 11). Die staan nog op `TO_DO`; de bijbehorende stories ST-1566/ST-1567 zijn ongewijzigd. Scrum4Me: T-1695 t/m T-1702 staan op done, ST-1564 en ST-1565 zijn gepromoveerd, met de dragende commits gelogd. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Throwaway-spike voor IDEA-191 (watchOS companion-app). HubWatch-target
(single-target SwiftUI, watchOS 10+, embedded in HubApp) met interactieve
custom long-look op HUB_CHOICE_3, APPROVAL en PERMISSION_BASIC.

Simulator-bewijs (Watch Ultra 2, watchOS 26.5): scene matcht op directe
pushes met de echte payload-vorm; SwiftUI-knoppen tonen volledige
optieteksten zonder afkapping; systeemknoppen onderdrukt via
notificationActions=[]. ios:build en ios:test blijven groen.

Nog onbewezen (fysieke stage 2): matching op een gespiegelde iPhone-push.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Watch-target App Store-klaar: eigen AppIcon (1024, hergebruik iOS-icoon,
platform watchos) + CURRENT_PROJECT_VERSION 9→10. Release-archive headless
gesigneerd (automatic signing registreerde nl.jpvisser.s4mhub.watchkitapp)
en geüpload naar App Store Connect voor de stage-2-spiegelproef.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Design voor adversarial review: watch-long-look met slot-categorieën
HUB_DYN_0…7 (no-steal, overloop→statisch), relay-antwoordpad via
WatchConnectivity, en IDEA-197 queue-statuspushes (task+review_request,
claim+terminaal, envelope-only payload, collapse-id, kill-switch).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Queue-tap-pad volledig gespecificeerd, lease-migratie behoudt legacy-
categorieën (delivered ∪ lease als maat), Unregistered-write expliciet,
geen tweede agent_queue-listener (pure functies in handleQueueEnvelope),
APPROVAL_INFO uit de scene-lijst (14 scenes), §4.6 zonder pariteitsclaim.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Invoegpunt queue-statuspush vastgepind (ná nudge, vóór info/mac:jp-guard)
+ seam-test; cap-budget overgangsfase expliciet (live legacy > nieuw slot,
nil → statische fallback) + randtests; §5.4 stap 3 naar het bestaande
openId-deep-link-patroon (QueueDetailView is al id-gebaseerd).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
mergeCategories-liveness wordt slot-bewust (bezette slot-ids naast
approvalId-liveIds; coëxistentietest erbij); presentationOptions krijgt
een expliciete queue_status-tak zonder geluid + regressietest.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Slot-hertoewijzing vervangt de oude registratie i.p.v. toevoegen
(Set.insert is geen replace); cap-budget geëvalueerd tegen de finale set
(cap − statics = 57), drain-only bij over-budget-legacy; §7-tests herijkt
op acties en finale-set-grenzen.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Faalmodel gecorrigeerd op meting (UNNotificationCategory ≠ bij andere
acties → duplicatie); hertoewijzingstest eist cardinaliteit vóór titels;
geërfde 58–64-legacy = gedoogd-maar-nooit-gegroeid (drain-only, geen
prune); budget-toets vóór lease/toewijzing; succescheck ook op acties.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
codex 0/0/0 GO + claude 0/0/3 GO op r6 (1f08323); drie GO-compatibele
MINORs vastgelegd als plan-fase-aanwijzingen (actie-check op de gate,
ensureStatic-scoping, telneutrale budget-toets).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs/plans/M37-watch-longlook.md: deel B server (4 taken), deel A iOS
(8 taken), docs+gate (1 taak); verwerkt de drie GO-compatibele MINORs
uit het spec-review-record.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
FinishGate-contract in het relay-pad, spec-conforme lease-v2-vorm
(expiresAt), discriminerende no-steal/telneutraal/ensureStatic-fixtures,
runtime-server.test.ts meegenomen, helper-substap, zod-enum, range-guard.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
SlotModel.count + dynamicSlotIndex als enige classificatie-bron (T6),
T4-commit staget de gewijzigde bestaande test, ActivationWaiter vóór de
reachability-beslissing (queued-contract), helper-overloads, reply-
contract naar hub-apns.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Token-gebaseerde ActivationWaiter in HubNotifications mét lek-test,
activatie-guard vóór transferUserInfo hersteld (deterministisch .failed),
dynamicSlotIndex-grenzen-test, permission-specifieke titel-constanten.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
toApiEnvironment in het send-pad + mapping-asserties, T2-module
side-effect-vrij (zware imports naar T3), Files-bullet permission-
constanten, pendingCountForTesting internal.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Pure functies naar eigen import-schone module queue-status-payload.ts,
sendQueueStatusPush volledig non-throwing + findMany-reject-test,
MainActor-hop in de AppDelegate-queue-bedrading.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Dubbel-GO op p6 vastgelegd; losse kale code-fence na ActivationWaiterTests
verwijderd en T3 stap 3 'toevoegen aan' → 'aanmaken van'.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
fix(ios-hub): mergeCategories zonder default op occupiedSlots (planconform, M37 T7)
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 5m58s
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
aa2a34a0ac
Lane B introduceerde `occupiedSlots: Set<Int> = []` om tijdens T7 de bestaande
call sites compileerbaar te houden, en meldde dat. T8 migreerde alle call sites
expliciet (12/12 geverifieerd), maar de default bleef staan. De genormeerde
signatuur in het dubbel-GO-plan heeft er geen, en de default maakt een vergeten
argument stil 'geen slot bezet' — precies de no-steal-invariant die spec §4.3
bewaakt.
s4m-codex-reviewer left a comment

Verdict: REQUEST_CHANGES

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

Findings

  • ERROR — ios/HubApp/HubWatch/HubChoiceView.swift:21: De custom long-look knoppen zetten alleen lokale UI-state (chosen = option) en sturen geen antwoord terug naar de iPhone/server. Daardoor lijkt een approval-keuze op de Watch succesvol, maar er wordt geen bestaande signed answer-flow aangeroepen en de approval blijft server-side onbeantwoord. Dit is een blokkerende functionele regressie voor interactieve hub-keuzepushes.

  • ERROR — ios/HubApp/project.yml:34: De nieuwe HubWatch target wordt in de productie-iOS-app embedded, terwijl de toegevoegde watch-code zelf als IDEA-191 SPIKE en throwaway is gemarkeerd (HubWatchApp.swift:1-3) en expliciet zegt: "Geen antwoordpad, geen productiecode." Spike-code hoort niet als productie-target meegeleverd te worden; zeker niet met notificatie-autorisatie en long-look interactie die nog niet functioneel is.

  • ERROR — ios/HubApp/HubWatch/HubWatchApp.swift:17: Er worden slechts drie statische WKNotificationScenes geregistreerd (HUB_CHOICE_3, APPROVAL, PERMISSION_BASIC). De slot-categorieen die deze PR juist introduceert (HUB_DYN_0...7) krijgen geen watch notification scenes, waardoor gemuteerde dynamische categorieen niet door de custom long-look worden afgehandeld. Dit maakt de slot-categorie-integratie incompleet.

Opmerkingen

  • De serverkant voor queue-statuspushes volgt grotendeels het APNs-patroon: envelope-only payload, passive/thread-id, collapse-id, geen outbox/retry, en alleen device-deactivatie bij Unregistered.
  • Er zijn gerichte Vitest- en XCTest-tests toegevoegd, maar de productie-watchflow mist tests of implementatie voor relay/antwoordafhandeling.
# Verdict: REQUEST_CHANGES geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. ## Findings - **ERROR** — `ios/HubApp/HubWatch/HubChoiceView.swift:21`: De custom long-look knoppen zetten alleen lokale UI-state (`chosen = option`) en sturen geen antwoord terug naar de iPhone/server. Daardoor lijkt een approval-keuze op de Watch succesvol, maar er wordt geen bestaande signed answer-flow aangeroepen en de approval blijft server-side onbeantwoord. Dit is een blokkerende functionele regressie voor interactieve hub-keuzepushes. - **ERROR** — `ios/HubApp/project.yml:34`: De nieuwe `HubWatch` target wordt in de productie-iOS-app embedded, terwijl de toegevoegde watch-code zelf als `IDEA-191 SPIKE` en `throwaway` is gemarkeerd (`HubWatchApp.swift:1-3`) en expliciet zegt: "Geen antwoordpad, geen productiecode." Spike-code hoort niet als productie-target meegeleverd te worden; zeker niet met notificatie-autorisatie en long-look interactie die nog niet functioneel is. - **ERROR** — `ios/HubApp/HubWatch/HubWatchApp.swift:17`: Er worden slechts drie statische `WKNotificationScene`s geregistreerd (`HUB_CHOICE_3`, `APPROVAL`, `PERMISSION_BASIC`). De slot-categorieen die deze PR juist introduceert (`HUB_DYN_0...7`) krijgen geen watch notification scenes, waardoor gemuteerde dynamische categorieen niet door de custom long-look worden afgehandeld. Dit maakt de slot-categorie-integratie incompleet. ## Opmerkingen - De serverkant voor queue-statuspushes volgt grotendeels het APNs-patroon: envelope-only payload, passive/thread-id, collapse-id, geen outbox/retry, en alleen device-deactivatie bij `Unregistered`. - Er zijn gerichte Vitest- en XCTest-tests toegevoegd, maar de productie-watchflow mist tests of implementatie voor relay/antwoordafhandeling.
Author
Owner

Review (Claude, orkestrator-onafhankelijk herhaald)

Verdict: mergen. Code volgt de dubbel-GO-spec/plan; verificatie zelf gedraaid op aa2a34a, niet overgenomen:

  • npm run verify — lint 0 errors / 5 warnings (alle vijf pre-existing), typecheck schoon, vitest 317 bestanden | 2614 tests groen
  • npm run ios:test — TEST SUCCEEDED, HubTests 187/0
  • npm run ios:build — BUILD SUCCEEDED (incl. NSE + ingebed watch-target)

De cijfers in de PR-beschrijving kloppen exact.

Adjudicatie van de drie ERRORs van s4m-codex-reviewer

Alle drie zijn feitelijk juist maar beschrijven wave-3-scope (T9–T12), niet een regressie van deze PR. De reviewer meldt zelf "geen gekoppeld plan gevonden" — dat verklaart het: het plan (docs/plans/M37-watch-longlook.md, in deze PR) belegt precies deze drie punten in T9–T12.

  1. HubChoiceView stuurt geen antwoord — juist, en by design: dit is de spike-code (T11 bouwt WatchRelay + WatchRelayHandler op het bestaande signed-answer-pad). De HubWatch-bronbestanden zijn byte-identiek aan build 10 die al op het toestel staat; deze PR raakt ze niet (alleen project.yml +3 regels voor de package-dependency).
  2. Spike-target embedded in de productie-app — juist; dit is bewust dezelfde samenstelling als TestFlight-build 10. Blijft aanvaardbaar zolang er geen publieke build op staat; T10 vervangt de inhoud.
  3. Geen HUB_DYN_0…7-scenes op de watch — juist, en het is geen achteruitgang: vóór deze PR heetten de dynamische categorieën HUB_DYN_<approvalId> en matchten die evenmin. T10 registreert de 14 scenes.

Eén punt voor de deploy (geen merge-blokkade)

HUB_QUEUE_STATUS_PUSH staat default aan, terwijl de client-helft (T12) nog niet gebouwd is. Geverifieerd in NotificationHandler.swift: presentationOptions valt zonder kind-sleutel terug op [.banner, .sound, .list] — een queue-statuspush geeft in de foreground dus geluid, terwijl IDEA-197 juist "alleen voorbij zien komen" is. En tikken doet niets: de routing vereist approvalId, de payload draagt messageId (inert, geen crash).

→ Zet bij de serverdeploy HUB_QUEUE_STATUS_PUSH=false tot T12 landt; de kill-switch bestaat hiervoor.

## Review (Claude, orkestrator-onafhankelijk herhaald) **Verdict: mergen.** Code volgt de dubbel-GO-spec/plan; verificatie zelf gedraaid op `aa2a34a`, niet overgenomen: - `npm run verify` — lint 0 errors / 5 warnings (alle vijf pre-existing), typecheck schoon, vitest **317 bestanden | 2614 tests groen** - `npm run ios:test` — **TEST SUCCEEDED**, HubTests 187/0 - `npm run ios:build` — **BUILD SUCCEEDED** (incl. NSE + ingebed watch-target) De cijfers in de PR-beschrijving kloppen exact. ### Adjudicatie van de drie ERRORs van s4m-codex-reviewer Alle drie zijn **feitelijk juist** maar beschrijven **wave-3-scope (T9–T12)**, niet een regressie van deze PR. De reviewer meldt zelf "geen gekoppeld plan gevonden" — dat verklaart het: het plan (`docs/plans/M37-watch-longlook.md`, in deze PR) belegt precies deze drie punten in T9–T12. 1. **HubChoiceView stuurt geen antwoord** — juist, en by design: dit is de spike-code (T11 bouwt `WatchRelay` + `WatchRelayHandler` op het bestaande signed-answer-pad). De HubWatch-bronbestanden zijn **byte-identiek aan build 10** die al op het toestel staat; deze PR raakt ze niet (alleen `project.yml` +3 regels voor de package-dependency). 2. **Spike-target embedded in de productie-app** — juist; dit is bewust dezelfde samenstelling als TestFlight-build 10. Blijft aanvaardbaar zolang er geen publieke build op staat; T10 vervangt de inhoud. 3. **Geen `HUB_DYN_0…7`-scenes op de watch** — juist, en het is geen achteruitgang: vóór deze PR heetten de dynamische categorieën `HUB_DYN_<approvalId>` en matchten die evenmin. T10 registreert de 14 scenes. ### Eén punt voor de deploy (geen merge-blokkade) `HUB_QUEUE_STATUS_PUSH` staat **default aan**, terwijl de client-helft (T12) nog niet gebouwd is. Geverifieerd in `NotificationHandler.swift`: `presentationOptions` valt zonder `kind`-sleutel terug op `[.banner, .sound, .list]` — een queue-statuspush geeft in de **foreground dus geluid**, terwijl IDEA-197 juist "alleen voorbij zien komen" is. En tikken doet niets: de routing vereist `approvalId`, de payload draagt `messageId` (inert, geen crash). → Zet bij de serverdeploy `HUB_QUEUE_STATUS_PUSH=false` tot T12 landt; de kill-switch bestaat hiervoor.
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!208
No description provided.