feat(insights): /insights and jobs in USD at API list price (PBI-36 ST-072) #350

Merged
janpeter merged 4 commits from feat/pbi36-insights-usd into main 2026-10-09 22:20:30 +02:00
Owner

PBI-36 / ST-072 (sprint S-2026-10-09-2).

⚠️ Merge after scrum4me-shared#80 (use a merge commit, not squash), because the submodule points at 321bad9. Deploy after #349 + npm run seed:api-list-prices. Without API/USD rows these screens show "geen prijs".

JP decision 2026-10-09: screens show the API list price in USD for CLAUDE and CODEX (model_prices API/USD/standard). Credits and the USD proxy no longer reach the screens.

/insights

  • lib/insights/rate-card-sql.ts gets LIST_PRICE_JOIN_SQL (shared listPriceJoinSqlText) and LIST_PRICED_FILTER_SQL.
  • cost-analysis, token-stats and token-history use the new join.
  • estimate-vs-actual(-server) uses listPriceUsdSqlText and fullyListPricedTaskSqlText. Codex tasks now count for USD calibration.
  • Labels: "N credits", "(alleen Claude) + credits" and "USD-proxy" become "USD (API-prijs)".

Jobs

  • lib/jobs-mapper.ts uses the shared listPriceKey/priceRowKey, and the label becomes $x (API-prijs).
  • admin/jobs and api/jobs/[id] load only API/USD/standard rows.

Checks (run by me in the worktree)

  • npm run lint OK.
  • tsc --noEmit OK.
  • vitest run: 406 files / 4263 tests green, 33 skipped.
  • estimate-vs-actual.integration: skipped in the regular run (no PPE_TEST_DATABASE_URL). The implementing agent ran it against a temporary pglite-server: 3/3 green.

Out of scope, for a later decision: the MCP get_estimate_history still uses the subscription join (credits/USD-proxy). It feeds estimate_usd estimates, which can therefore differ from the list prices on screen.

🤖 Generated with Claude Code

PBI-36 / ST-072 (sprint S-2026-10-09-2). **⚠️ Merge after [scrum4me-shared#80](https://git.jp-visser.nl/janpeter/scrum4me-shared/pulls/80)** (use a merge commit, not squash), because the submodule points at `321bad9`. **Deploy after [#349](https://git.jp-visser.nl/janpeter/Scrum4Me/pulls/349) + `npm run seed:api-list-prices`.** Without API/USD rows these screens show "geen prijs". JP decision 2026-10-09: screens show the **API list price in USD** for CLAUDE and CODEX (`model_prices` API/USD/standard). Credits and the USD proxy no longer reach the screens. **`/insights`** - `lib/insights/rate-card-sql.ts` gets `LIST_PRICE_JOIN_SQL` (shared `listPriceJoinSqlText`) and `LIST_PRICED_FILTER_SQL`. - `cost-analysis`, `token-stats` and `token-history` use the new join. - `estimate-vs-actual(-server)` uses `listPriceUsdSqlText` and `fullyListPricedTaskSqlText`. Codex tasks now count for USD calibration. - Labels: "N credits", "(alleen Claude) + credits" and "USD-proxy" become "USD (API-prijs)". **Jobs** - `lib/jobs-mapper.ts` uses the shared `listPriceKey`/`priceRowKey`, and the label becomes `$x (API-prijs)`. - `admin/jobs` and `api/jobs/[id]` load only API/USD/standard rows. **Checks (run by me in the worktree)** - `npm run lint` OK. - `tsc --noEmit` OK. - `vitest run`: 406 files / 4263 tests green, 33 skipped. - `estimate-vs-actual.integration`: skipped in the regular run (no `PPE_TEST_DATABASE_URL`). The implementing agent ran it against a temporary pglite-server: 3/3 green. Out of scope, for a later decision: the MCP `get_estimate_history` still uses the subscription join (credits/USD-proxy). It feeds `estimate_usd` estimates, which can therefore differ from the list prices on screen. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Insights SQL, estimate-vs-actual, jobs-mapper and the UI now use the API/USD/standard
card per runtime (CLAUDE->anthropic, CODEX->openai) via the shared list-price helpers;
credits and USD-proxy wording are gone from the screens.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
test(insights): list-price USD fixtures and expectations (PBI-36)
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m50s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 5m5s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 3m41s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / DB Access Production Sentinel (pull_request) Successful in 1m3s
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
80a5b7851d
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

REQUEST_CHANGES

plan gekoppeld via pr_refs (product scrum4me-workers). Referentie: ST-072 (scrum4me-workers), taken T-228 en T-229. Er zijn geen onderdelen weggelaten (omitted leeg).

Findings:

  • ERROR / blokkerend — lib/insights/cost-analysis.ts:91: De nieuwe prijsfilter verwijdert jobs zonder API/USD-kaart uit de som; de mapper op regel 131 zet een ontbrekende som daarna om naar 0. Gereproduceerd met de echte query op tijdelijke PostgreSQL: één DONE Codex-job met 1 miljoen tokens zonder prijskaart geeft totalCostUsd: 0, jobCount: 0. Met een geprijsde job erbij verschijnt alleen het bekende bedrag als volledig totaal. De kostenkaart toont dus $0 of een ongemarkeerd onvolledig bedrag, terwijl ST-072 en de PR-beschrijving NULL/'geen prijs' vereisen. Hetzelfde nul-fallbackpatroon staat in token-stats en token-history. Behoud prijsdekking in de aggregaties en toon 'geen prijs' of expliciet onvolledige bedragen; voeg tests toe voor uitsluitend ongeprijsde en gemengd geprijsde jobs.
  • MINOR — docs/superpowers/specs/2026-10-04-session-usage-estimates-design.md:170: De actieve product-spec §3.4 schrijft nog CLAUDE/SUBSCRIPTION/USD_PROXY voor en zegt dat ClaudeJob-queries ongewijzigd blijven. Werk de productdocumentatie bij voor API/USD-prijzen van CLAUDE en CODEX en het onderscheid met interne subscription-accounting.

De gedeelde prijshelpers, runtime/provider-isolatie, jobs-labels en estimate-vs-actual sluiten verder aan op het plan. De expliciete afhankelijkheden shared#80 en web#349 plus prijs-seed zijn geen ontbrekend werk binnen deze PR. De uitgestelde MCP-estimate-history valt buiten de opgegeven web-scope.

Verificatie op commit 80a5b7851d8c916f33fd6e1d78fc7c72c834e091:

  • Lint: 0 errors, 6 warnings. Typecheck: geslaagd met hogere Node-geheugenlimiet (standaardrun liep tegen heaplimiet aan).
  • Volledige suite: 4262 geslaagd, 33 geskipt, 1 fout in ongewijzigde web-push-test door geërfde VAPID-configuratie. Gerichte herhaling zonder die variabelen: 4/4 geslaagd.
  • SQL-integratie estimate-vs-actual op tijdelijke PostgreSQL: 3/3 geslaagd. Gerichte SQL-reproductie bevestigt bovenstaande blokkerende finding.
  • Productiebuild: geslaagd met tijdelijke test-DATABASE_URL en SESSION_SECRET; eerste poging miste deze verplichte variabelen.
# REQUEST_CHANGES plan gekoppeld via pr_refs (product scrum4me-workers). Referentie: ST-072 (scrum4me-workers), taken T-228 en T-229. Er zijn geen onderdelen weggelaten (omitted leeg). Findings: - **ERROR / blokkerend — lib/insights/cost-analysis.ts:91:** De nieuwe prijsfilter verwijdert jobs zonder API/USD-kaart uit de som; de mapper op regel 131 zet een ontbrekende som daarna om naar 0. Gereproduceerd met de echte query op tijdelijke PostgreSQL: één DONE Codex-job met 1 miljoen tokens zonder prijskaart geeft `totalCostUsd: 0, jobCount: 0`. Met een geprijsde job erbij verschijnt alleen het bekende bedrag als volledig totaal. De kostenkaart toont dus $0 of een ongemarkeerd onvolledig bedrag, terwijl ST-072 en de PR-beschrijving NULL/'geen prijs' vereisen. Hetzelfde nul-fallbackpatroon staat in token-stats en token-history. Behoud prijsdekking in de aggregaties en toon 'geen prijs' of expliciet onvolledige bedragen; voeg tests toe voor uitsluitend ongeprijsde en gemengd geprijsde jobs. - **MINOR — docs/superpowers/specs/2026-10-04-session-usage-estimates-design.md:170:** De actieve product-spec §3.4 schrijft nog CLAUDE/SUBSCRIPTION/USD_PROXY voor en zegt dat ClaudeJob-queries ongewijzigd blijven. Werk de productdocumentatie bij voor API/USD-prijzen van CLAUDE en CODEX en het onderscheid met interne subscription-accounting. De gedeelde prijshelpers, runtime/provider-isolatie, jobs-labels en estimate-vs-actual sluiten verder aan op het plan. De expliciete afhankelijkheden shared#80 en web#349 plus prijs-seed zijn geen ontbrekend werk binnen deze PR. De uitgestelde MCP-estimate-history valt buiten de opgegeven web-scope. Verificatie op commit `80a5b7851d8c916f33fd6e1d78fc7c72c834e091`: - Lint: 0 errors, 6 warnings. Typecheck: geslaagd met hogere Node-geheugenlimiet (standaardrun liep tegen heaplimiet aan). - Volledige suite: 4262 geslaagd, 33 geskipt, 1 fout in ongewijzigde web-push-test door geërfde VAPID-configuratie. Gerichte herhaling zonder die variabelen: 4/4 geslaagd. - SQL-integratie estimate-vs-actual op tijdelijke PostgreSQL: 3/3 geslaagd. Gerichte SQL-reproductie bevestigt bovenstaande blokkerende finding. - Productiebuild: geslaagd met tijdelijke test-DATABASE_URL en SESSION_SECRET; eerste poging miste deze verplichte variabelen.
Author
Owner

Review 1196 verwerkt in 45946620:

  • ERROR (cost-analysis/token-stats/token-history): jobs zonder API/USD-kaart blijven in alle aggregaten (tokens, jobaantal). USD wordt alleen over geprijsde jobs opgeteld; null (nooit 0) als niets geprijsd is, plus pricedJobCount/unpricedJobCount (ook per dag/model/kind). UI toont geen prijs of ≥ $x · N jobs zonder prijs; jobCount = jobs met tokens. Jouw reproductie (één Codex-job, 1M tokens, geen kaart) geeft nu totalCostUsd: null, jobCount: 1.
  • MINOR (spec §3.4): gedateerde PBI-36-aanvulling in 2026-10-04-session-usage-estimates-design.md.

Verificatie (zelf gedraaid): lint 0 errors; tsc --noEmit OK; vitest run 409 files / 4286 tests groen. Nieuwe insights-list-price-coverage.integration (alleen-ongeprijsd, gemengd, volledig geprijsd door alle cost/token-functies) + estimate-vs-actual.integration tegen tijdelijke PostgreSQL 17: 8/8 groen.

Review 1196 verwerkt in `45946620`: - **ERROR (cost-analysis/token-stats/token-history):** jobs zonder API/USD-kaart blijven in alle aggregaten (tokens, jobaantal). USD wordt alleen over geprijsde jobs opgeteld; `null` (nooit 0) als niets geprijsd is, plus `pricedJobCount`/`unpricedJobCount` (ook per dag/model/kind). UI toont **geen prijs** of `≥ $x · N jobs zonder prijs`; `jobCount` = jobs met tokens. Jouw reproductie (één Codex-job, 1M tokens, geen kaart) geeft nu `totalCostUsd: null, jobCount: 1`. - **MINOR (spec §3.4):** gedateerde PBI-36-aanvulling in `2026-10-04-session-usage-estimates-design.md`. Verificatie (zelf gedraaid): lint 0 errors; `tsc --noEmit` OK; `vitest run` 409 files / 4286 tests groen. Nieuwe `insights-list-price-coverage.integration` (alleen-ongeprijsd, gemengd, volledig geprijsd door alle cost/token-functies) + `estimate-vs-actual.integration` tegen tijdelijke PostgreSQL 17: 8/8 groen.
fix(insights): keep unpriced jobs in aggregates, show price coverage (PBI-36)
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m49s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m5s
CI / DB Access Production Sentinel (pull_request) Successful in 1m12s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 8m29s
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
459466202d
Jobs without an API/USD list-price card were filtered out of the cost
analysis, token stats and token history, and a missing sum became $0.
Now every measured job stays in the counts and token totals; USD is summed
over priced jobs only and is null ("geen prijs") when none is priced. Totals
with unpriced jobs are shown as a lower bound ("≥ $x · N jobs zonder prijs").

Also amends the session-usage design spec (§3.4) for the PBI-36 list-price
rule.

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

COMMENT

Geen aangetoonde blokkerende regressies. Eén kleine opmerking; volledige web-verify/build kon in deze omgeving niet geheel groen worden bevestigd.

Findings

  • MINOR — app/(app)/insights/components/cost-analysis.tsx:180: “Top model” toont geen ondergrensmarkering bij gedeeltelijke prijsdekking. De bijbehorende SQL groepeert op model-id, zodat bij hetzelfde model-id in meerdere runtimes een ontbrekende prijs slechts een gedeeltelijke som oplevert. formatListUsd(kpi.topModelCostUsd) ontvangt geen dekking en toont dat bedrag als volledig. Geef het ongeprijsde aantal van de modelgroep mee en voeg een test voor deze combinatie toe. Niet blokkerend.

Plan en standaarden

plan gekoppeld via pr_refs (product scrum4me-workers). Referentie: ST-072 (scrum4me-workers), taken T-228 en T-229. Geen omitted onderdelen.

De geraakte scope sluit aan op het plan: Claude en Codex worden via de gedeelde API/USD/standard-lookup geprijsd; ontbrekende kaarten behouden NULL, tokens en jobs blijven meetellen, en labels/tests/documentatie zijn aangepast. Shared logica blijft in de submodule; de server/client-grens blijft behouden. De beschreven afhankelijkheden scrum4me-shared#80 en Scrum4Me#349 zijn gemergd. De prijsseed blijft een expliciete uitrolvoorwaarde. MCP-schattingen vallen volgens de PR buiten deze scope.

Verificatie

Beoordeeld op commit 459466202d.

  • Lint: 0 errors, 6 warnings buiten de gewijzigde bestanden.
  • Typecheck: geslaagd met extra Node-heap; eerste run stopte op de standaard geheugenlimiet.
  • Gerichte unit/componenttests: 159/159 geslaagd.
  • Echte PostgreSQL 17-integratietests voor prijsdekking en estimate-vs-actual: 8/8 geslaagd.
  • Volledige suite: 4294 geslaagd, 29 geskipt, 1 fout in de ongewijzigde __tests__/lib/hub/push-detailed.test.ts:80 door aanwezige VAPID-omgevingsvariabelen. De betreffende vier tests slagen na verwijderen van die variabelen.
  • Productiebuild: compilatie en TypeScript geslaagd; page-datafase gestopt door ontbrekende DATABASE_URL en SESSION_SECRET. Daardoor geen volledig geslaagde build bevestigd.

Geen inline-comments geplaatst.

# COMMENT Geen aangetoonde blokkerende regressies. Eén kleine opmerking; volledige web-verify/build kon in deze omgeving niet geheel groen worden bevestigd. ## Findings - **MINOR — app/(app)/insights/components/cost-analysis.tsx:180:** “Top model” toont geen ondergrensmarkering bij gedeeltelijke prijsdekking. De bijbehorende SQL groepeert op model-id, zodat bij hetzelfde model-id in meerdere runtimes een ontbrekende prijs slechts een gedeeltelijke som oplevert. `formatListUsd(kpi.topModelCostUsd)` ontvangt geen dekking en toont dat bedrag als volledig. Geef het ongeprijsde aantal van de modelgroep mee en voeg een test voor deze combinatie toe. Niet blokkerend. ## Plan en standaarden plan gekoppeld via pr_refs (product scrum4me-workers). Referentie: ST-072 (scrum4me-workers), taken T-228 en T-229. Geen omitted onderdelen. De geraakte scope sluit aan op het plan: Claude en Codex worden via de gedeelde API/USD/standard-lookup geprijsd; ontbrekende kaarten behouden NULL, tokens en jobs blijven meetellen, en labels/tests/documentatie zijn aangepast. Shared logica blijft in de submodule; de server/client-grens blijft behouden. De beschreven afhankelijkheden scrum4me-shared#80 en Scrum4Me#349 zijn gemergd. De prijsseed blijft een expliciete uitrolvoorwaarde. MCP-schattingen vallen volgens de PR buiten deze scope. ## Verificatie Beoordeeld op commit 459466202df3ed0aaae398d3fe1471b785dc86f9. - Lint: 0 errors, 6 warnings buiten de gewijzigde bestanden. - Typecheck: geslaagd met extra Node-heap; eerste run stopte op de standaard geheugenlimiet. - Gerichte unit/componenttests: 159/159 geslaagd. - Echte PostgreSQL 17-integratietests voor prijsdekking en estimate-vs-actual: 8/8 geslaagd. - Volledige suite: 4294 geslaagd, 29 geskipt, 1 fout in de ongewijzigde `__tests__/lib/hub/push-detailed.test.ts:80` door aanwezige VAPID-omgevingsvariabelen. De betreffende vier tests slagen na verwijderen van die variabelen. - Productiebuild: compilatie en TypeScript geslaagd; page-datafase gestopt door ontbrekende DATABASE_URL en SESSION_SECRET. Daardoor geen volledig geslaagde build bevestigd. Geen inline-comments geplaatst.
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!350
No description provided.