feat(hub): unified inbox over queue + jobs; Feed vervalt (M33) #156

Merged
janpeter merged 13 commits from feat/m33-hub-inbox into main 2026-08-13 09:18:29 +02:00
Owner

M33 — slice 2 van docs/superpowers/specs/2026-08-12-hub-inbox-queue-archivering-design.md (DUBBEL-GO r5, 6d8ea8c), uitgewerkt in docs/plans/M33-hub-inbox.md (DUBBEL-GO r4, a937da6). Alle 12 plan-taken, TDD: elke test is eerst aantoonbaar rood gedraaid. Bouwt op M32, dat sinds gisteren live is (archived_at + 5 indexen).

Wat

Contractlaag. lib/hub/inbox-cursor.ts — opake compound keyset-cursor, base64url via web-API's (btoa/TextEncoder, géén Buffer: het bestand belooft client-safe en de test draait daarom bewust in jsdom). decodeCursor gooit CursorError op élke malformed vorm; isUuid is de guard die PG-castfouten uit de routes houdt. Daarnaast de InboxItemDto-union en detail-DTO's in lib/hub/dto.ts.

Serverlaag. lib/hub/inbox-server.ts: queue-rijen via raw pg, job-rijen via Prisma (gescoopt op product.user_id — feed-pariteit, bewust níét ClaudeJob.user_id), en een merge op BigInt epoch-µs. Sorteren en keyset staan native in SQL zodat de M32-indexen matchen; de µs-afleiding gebruikt (EXTRACT(EPOCH FROM created_at)::numeric * 1000000)::bigint en is daarmee orde-isomorf op elke PG-versie. Plus fetchQueueDetail en archive/unarchiveQueueSubtree (transitieve subtree, alleen terminaal, per rij idempotent, géén NOTIFY — identiek aan het M32 CLI/MCP-pad).

Zeven device-signed routes achter HUB_ENABLED: GET /api/hub/inbox (bron-facet, filters, cursor, limit) en detail + archive/unarchive voor queue en jobs. Foutcontract exact: 400 cursor/parse · 422 Zod/enum/bron-mismatch · 404 onbekend én vreemd id (niet te onderscheiden) · 409 niet-terminaal, mét blockingId/blockingStatus.

iOS. InboxDto (union op source, recursieve JSONValue, gecureerde meta.task), InboxStore (facetten, filters, cursor-paginatie, setArchived-kern) en InboxView + beide detailviews. De Feed-tab is vervangen door de Inbox-tab; InboxTabView bezit de store via @StateObject en koppelt de refresh-triggers (openen, foreground, pull-to-refresh, push-puls). Geen nieuwe pushes (B9).

Feed vervalt volledig: route, DTO's, listRecentJpMessages, JobDto, de iOS-Feed-map, FeedLoader en alle bijbehorende tests. Dode-import-grep is leeg. Approvals-endpoint en -tab zijn niet aangeraakt (B4).

Waar de review-loop zich uitbetaalde

Drie dingen die het plan expliciet had voorgeschreven en die in de tests ook echt bijten:

  • Cursorvalidatie vóór élke query. Een syntactisch geldige cursor met een onmogelijke datum (2026-02-31), een offset buiten ±15:59 (+99) of een niet-uuid zou als PG-castfout (22P02/22008/22009) een 500 opleveren waar het contract 400 eist. De eigen timestamp-parser (mét schrikkeljaar-tabel) dekt dat; bewust géén JS Date, die normaliseert 31 februari stil naar 3 maart. Acht negatieve gevallen zijn getest, inclusief de assertie dat er dán géén bron-query loopt.
  • Meerpagina-paginatie met cross-bron-ties. Het harnas simuleert per bron het echte keyset-predicaat en pagineert herhaald met decodeCursor(nextCursor). De zwaarste dataset: negen items die állemaal op dezelfde µs tie'en, verdeeld over beide bronnen, met limit 3 — paginagrenzen vallen dus middenin de tie-groep én de cross-bron-overgang. Uitkomst is exact-once én volledige globale orde.
  • Race-vastheid in de store. Generatietoken + in-flight-guard; de twee race-tests dwingen de overlap af met een responder-entry-handshake (geen sleeps). De handshake-timeout wordt nu geassert — anders zou een niet-afgevuurde semafoor de race-test vacuüm groen houden (openstaande MINOR uit plan-review r4, hier verwerkt).

Gates

  • Web: GATE GROEN op 30a006cccb0972b3802e658124edc5cc8f5407f9 — volledige npm ci && npm run verify && npm run build in een wegwerp-clone op exact deze SHA, inclusief schone-tree-check en git diff --exit-code ná de build. 242 bestanden, 1887 tests.
  • iOS: xcodebuild test -scheme Hub → 31 tests groen; xcodebuild build -scheme Hub → BUILD SUCCEEDED. Destination was iPhone 17 (iOS 26.5) — de iPhone 16 uit het plan bestaat niet op deze machine.

Twee omgevings-afwijkingen, bewust en onderbouwd

  1. BigInt-literals → constructor. Het plan gebruikt 1000n; deze repo target ES2017 en literals vereisen ES2020. Omgezet naar BigInt(1000) (werkt wél, lib staat op esnext), met een comment zodat niemand het terugdraait.
  2. PUPPETEER_SKIP_DOWNLOAD=1 in het gate-script. Puppeteer is een transitieve dev-dep (mermaid-cli, alleen npm run diagrams) die verify noch build raakt. Zijn postinstall haalt chrome-headless-shell op en die extractie levert hier structureel een halve map op (alleen ABOUT + LICENSE, geen binair), waarna élke volgende npm ci faalt op "folder exists but executable is missing" — drie keer gereproduceerd. De lokale dev-install slaat diezelfde postinstall sowieso al over via npm's allow-scripts-policy.

Rollout

Geen migraties in M33 — het schema kwam uit M32; verifieer nul migraties in de deploy-log. Daarna TestFlight-build en de e2e-gate met JP volgens het nieuwe docs/runbooks/hub-inbox-e2e-gate.md.

🤖 Generated with Claude Code

M33 — slice 2 van `docs/superpowers/specs/2026-08-12-hub-inbox-queue-archivering-design.md` (DUBBEL-GO r5, `6d8ea8c`), uitgewerkt in `docs/plans/M33-hub-inbox.md` (DUBBEL-GO r4, `a937da6`). Alle 12 plan-taken, TDD: elke test is eerst aantoonbaar rood gedraaid. Bouwt op M32, dat sinds gisteren live is (`archived_at` + 5 indexen). ## Wat **Contractlaag.** `lib/hub/inbox-cursor.ts` — opake compound keyset-cursor, base64url via web-API's (`btoa`/`TextEncoder`, géén `Buffer`: het bestand belooft client-safe en de test draait daarom bewust in jsdom). `decodeCursor` gooit `CursorError` op élke malformed vorm; `isUuid` is de guard die PG-castfouten uit de routes houdt. Daarnaast de `InboxItemDto`-union en detail-DTO's in `lib/hub/dto.ts`. **Serverlaag.** `lib/hub/inbox-server.ts`: queue-rijen via raw `pg`, job-rijen via Prisma (gescoopt op `product.user_id` — feed-pariteit, bewust níét `ClaudeJob.user_id`), en een merge op **BigInt epoch-µs**. Sorteren en keyset staan native in SQL zodat de M32-indexen matchen; de µs-afleiding gebruikt `(EXTRACT(EPOCH FROM created_at)::numeric * 1000000)::bigint` en is daarmee orde-isomorf op elke PG-versie. Plus `fetchQueueDetail` en `archive/unarchiveQueueSubtree` (transitieve subtree, alleen terminaal, per rij idempotent, géén NOTIFY — identiek aan het M32 CLI/MCP-pad). **Zeven device-signed routes** achter `HUB_ENABLED`: `GET /api/hub/inbox` (bron-facet, filters, cursor, limit) en detail + archive/unarchive voor queue en jobs. Foutcontract exact: **400** cursor/parse · **422** Zod/enum/bron-mismatch · **404** onbekend én vreemd id (niet te onderscheiden) · **409** niet-terminaal, mét `blockingId`/`blockingStatus`. **iOS.** `InboxDto` (union op `source`, recursieve `JSONValue`, gecureerde `meta.task`), `InboxStore` (facetten, filters, cursor-paginatie, `setArchived`-kern) en `InboxView` + beide detailviews. De Feed-tab is vervangen door de Inbox-tab; `InboxTabView` bezit de store via `@StateObject` en koppelt de refresh-triggers (openen, foreground, pull-to-refresh, push-puls). Geen nieuwe pushes (B9). **Feed vervalt volledig**: route, DTO's, `listRecentJpMessages`, `JobDto`, de iOS-Feed-map, `FeedLoader` en alle bijbehorende tests. Dode-import-grep is leeg. Approvals-endpoint en -tab zijn niet aangeraakt (B4). ## Waar de review-loop zich uitbetaalde Drie dingen die het plan expliciet had voorgeschreven en die in de tests ook echt bijten: - **Cursorvalidatie vóór élke query.** Een syntactisch geldige cursor met een onmogelijke datum (`2026-02-31`), een offset buiten ±15:59 (`+99`) of een niet-uuid zou als PG-castfout (22P02/22008/22009) een 500 opleveren waar het contract 400 eist. De eigen timestamp-parser (mét schrikkeljaar-tabel) dekt dat; bewust géén JS `Date`, die normaliseert 31 februari stil naar 3 maart. Acht negatieve gevallen zijn getest, inclusief de assertie dat er dán géén bron-query loopt. - **Meerpagina-paginatie met cross-bron-ties.** Het harnas simuleert per bron het echte keyset-predicaat en pagineert herhaald met `decodeCursor(nextCursor)`. De zwaarste dataset: negen items die állemaal op dezelfde µs tie'en, verdeeld over beide bronnen, met `limit 3` — paginagrenzen vallen dus middenin de tie-groep én de cross-bron-overgang. Uitkomst is exact-once én volledige globale orde. - **Race-vastheid in de store.** Generatietoken + in-flight-guard; de twee race-tests dwingen de overlap af met een responder-entry-handshake (geen sleeps). De handshake-timeout wordt nu geassert — anders zou een niet-afgevuurde semafoor de race-test vacuüm groen houden (openstaande MINOR uit plan-review r4, hier verwerkt). ## Gates - Web: **`GATE GROEN op 30a006cccb0972b3802e658124edc5cc8f5407f9`** — volledige `npm ci && npm run verify && npm run build` in een wegwerp-clone op exact deze SHA, inclusief schone-tree-check en `git diff --exit-code` ná de build. **242 bestanden, 1887 tests.** - iOS: `xcodebuild test -scheme Hub` → **31 tests groen**; `xcodebuild build -scheme Hub` → BUILD SUCCEEDED. Destination was `iPhone 17` (iOS 26.5) — de `iPhone 16` uit het plan bestaat niet op deze machine. ### Twee omgevings-afwijkingen, bewust en onderbouwd 1. **BigInt-literals → constructor.** Het plan gebruikt `1000n`; deze repo target ES2017 en literals vereisen ES2020. Omgezet naar `BigInt(1000)` (werkt wél, `lib` staat op `esnext`), met een comment zodat niemand het terugdraait. 2. **`PUPPETEER_SKIP_DOWNLOAD=1` in het gate-script.** Puppeteer is een transitieve dev-dep (mermaid-cli, alleen `npm run diagrams`) die verify noch build raakt. Zijn postinstall haalt `chrome-headless-shell` op en die extractie levert hier structureel een halve map op (alleen ABOUT + LICENSE, geen binair), waarna élke volgende `npm ci` faalt op "folder exists but executable is missing" — drie keer gereproduceerd. De lokale dev-install slaat diezelfde postinstall sowieso al over via npm's allow-scripts-policy. ## Rollout **Geen migraties in M33** — het schema kwam uit M32; verifieer `nul migraties` in de deploy-log. Daarna TestFlight-build en de e2e-gate met JP volgens het nieuwe `docs/runbooks/hub-inbox-e2e-gate.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(hub): e2e-gate-runbook voor de unified inbox + INDEX (M33 spec 8)
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m24s
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
30a006cccb
s4m-codex-reviewer left a comment

Verdict: COMMENT

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

Findings

  • minor — ios/Hub/Sources/Hub/Features/Inbox/InboxView.swift:55 — De fout-alert gebruikt isPresented: .constant(store.lastError != nil) en de OK-knop start een refresh in plaats van de fout expliciet te clearen. Als een refresh opnieuw faalt, blijft dezelfde alert direct zichtbaar en kan de gebruiker hem niet echt dismissen. Maak dit bij voorkeur state-gestuurd met een clear-pad, of expose een kleine clearError() op InboxStore.

Review

De serverroutes volgen de Hub/M33-context: device-signed routes, env-gating via withSignedDevice, queue bewust ongescoopt, jobs via product.user_id, cursorvalidatie vóór PG-casts, en archiveren met terminale/idempotente semantiek. De diff bevat gerichte Vitest- en XCTest-dekking voor cursor, merge/paginatie, routevalidatie, detail/archive-paden en de iOS store-races. Docs zijn bijgewerkt met een M33 inbox E2E-gate.

Geen blokkerende bevindingen gevonden op basis van de aangeleverde diff.

# Verdict: COMMENT geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. ## Findings - minor — `ios/Hub/Sources/Hub/Features/Inbox/InboxView.swift:55` — De fout-alert gebruikt `isPresented: .constant(store.lastError != nil)` en de OK-knop start een refresh in plaats van de fout expliciet te clearen. Als een refresh opnieuw faalt, blijft dezelfde alert direct zichtbaar en kan de gebruiker hem niet echt dismissen. Maak dit bij voorkeur state-gestuurd met een clear-pad, of expose een kleine `clearError()` op `InboxStore`. ## Review De serverroutes volgen de Hub/M33-context: device-signed routes, env-gating via `withSignedDevice`, queue bewust ongescoopt, jobs via `product.user_id`, cursorvalidatie vóór PG-casts, en archiveren met terminale/idempotente semantiek. De diff bevat gerichte Vitest- en XCTest-dekking voor cursor, merge/paginatie, routevalidatie, detail/archive-paden en de iOS store-races. Docs zijn bijgewerkt met een M33 inbox E2E-gate. Geen blokkerende bevindingen gevonden op basis van de aangeleverde diff.
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!156
No description provided.