Scrum Usage-prototype: staaf, taart en Vis-styling (IDEA-248) #157

Merged
janpeter merged 19 commits from claude/usage-ledger-2602c3 into main 2026-10-12 19:10:36 +02:00
Owner

Samenvatting

Lokaal Scrum Usage-prototype voor IDEA-248 in prototypes/scrum-usage/: een losse Next.js 16-app die tokenverbruik en kosten van Scrum4Me toont, read-only op databaseservice scrum4me-ro. Nog niet ingebouwd in de workers-app en geen menu-item.

  • Increment 1 (S-2026-10-12-1): filters op product, periode, eenheid (tokens of USD) en bron; gestapelde staaf per dag of week, per provider en model; melding van ongeprijsd verbruik. USD is de API-lijstprijs volgens PBI-36: zonder prijsrij geen bedrag, nooit 0.
  • Increment 2 (S-2026-10-12-2): taart per idee of sprint met Open/Alles/Afgesloten en inzoomen (idee naar vijf fases, sprint naar PBI/Story/Taak). Ongekoppeld verbruik is een melding onder de taart, geen segment (besluit JP). De inzoomstand staat in de URL.
  • Vis-styling: layout en kleuren volgens het Vis-designsysteem. styles/theme.css blijft de Scrum4Me-kopie; ontbrekende Vis-tokens en de grafiekkleuren staan in styles/vis.css. Waar workers' docs/design/styling.md afwijkt, wint dat document.
  • Spec en plan: docs/superpowers/specs/2026-10-12-scrum-usage-prototype-design.md en docs/superpowers/plans/2026-10-12-scrum-usage-prototype.md.

Invloed op workers

  • Workers-root sluit prototypes/ uit van tsconfig en ESLint; de prototypecode doet niet mee in de workers-build.
  • Geen schema-wijziging, geen migratie, geen deploy.

Verificatie

  • Prototype: npm run typecheck groen; PGSERVICE=scrum4me-ro npx vitest run 84/84 groen, inclusief een echte time-out van 15 s.
  • Paletcontrole op app, components en lib: geen ruwe paletklassen en geen hex in .ts/.tsx.
  • Workers-root: npm run verify groen (2668 passed, 43 skipped); tsc --listFilesOnly bevat 0 prototypebestanden. Eén bestaande lint-waarschuwing (taskCode ongebruikt) staat buiten deze wijziging.
  • Browser: licht, donker en telefoonbreedte zonder horizontale scroll; ideeën- en sprinttaart, inzoomen op alle niveaus, tooltip van een deels ongeprijsd segment.

Bekende beperkingen

  • Een idee zonder bouwsprint, zoals IDEA-248 zelf, houdt een lege fase Sprint.
  • Het grootste deel van het verbruik hangt niet aan een idee; de melding daarover is groot.
  • In het donkere thema worden lichtere grafiektinten doffer.

🤖 Generated with Claude Code

## Samenvatting Lokaal Scrum Usage-prototype voor IDEA-248 in `prototypes/scrum-usage/`: een losse Next.js 16-app die tokenverbruik en kosten van Scrum4Me toont, read-only op databaseservice `scrum4me-ro`. Nog niet ingebouwd in de workers-app en geen menu-item. - **Increment 1 (S-2026-10-12-1):** filters op product, periode, eenheid (tokens of USD) en bron; gestapelde staaf per dag of week, per provider en model; melding van ongeprijsd verbruik. USD is de API-lijstprijs volgens PBI-36: zonder prijsrij geen bedrag, nooit 0. - **Increment 2 (S-2026-10-12-2):** taart per idee of sprint met Open/Alles/Afgesloten en inzoomen (idee naar vijf fases, sprint naar PBI/Story/Taak). Ongekoppeld verbruik is een melding onder de taart, geen segment (besluit JP). De inzoomstand staat in de URL. - **Vis-styling:** layout en kleuren volgens het Vis-designsysteem. `styles/theme.css` blijft de Scrum4Me-kopie; ontbrekende Vis-tokens en de grafiekkleuren staan in `styles/vis.css`. Waar workers' `docs/design/styling.md` afwijkt, wint dat document. - **Spec en plan:** `docs/superpowers/specs/2026-10-12-scrum-usage-prototype-design.md` en `docs/superpowers/plans/2026-10-12-scrum-usage-prototype.md`. ## Invloed op workers - Workers-root sluit `prototypes/` uit van `tsconfig` en ESLint; de prototypecode doet niet mee in de workers-build. - Geen schema-wijziging, geen migratie, geen deploy. ## Verificatie - Prototype: `npm run typecheck` groen; `PGSERVICE=scrum4me-ro npx vitest run` 84/84 groen, inclusief een echte time-out van 15 s. - Paletcontrole op `app`, `components` en `lib`: geen ruwe paletklassen en geen hex in `.ts`/`.tsx`. - Workers-root: `npm run verify` groen (2668 passed, 43 skipped); `tsc --listFilesOnly` bevat 0 prototypebestanden. Eén bestaande lint-waarschuwing (`taskCode` ongebruikt) staat buiten deze wijziging. - Browser: licht, donker en telefoonbreedte zonder horizontale scroll; ideeën- en sprinttaart, inzoomen op alle niveaus, tooltip van een deels ongeprijsd segment. ## Bekende beperkingen - Een idee zonder bouwsprint, zoals IDEA-248 zelf, houdt een lege fase Sprint. - Het grootste deel van het verbruik hangt niet aan een idee; de melding daarover is groot. - In het donkere thema worden lichtere grafiektinten doffer. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Lokaal prototype in prototypes/scrum-usage/ op de read-only service scrum4me-ro:
één usage-feit-CTE over sessies en workerjobs, staaf per bucket gestapeld per
model, taart per idee (fases) of sprint (PBI/Story/Taak) met inzoomen, USD
volgens de PBI-36-afspraak (geen prijsrij → geen bedrag).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Lokaal prototype in prototypes/scrum-usage: Next 16 + Vis-thema, eigen
resolver voor PGSERVICE (node-postgres leest geen pg_service.conf), elke
verbinding read-only met statement_timeout 15s, /api/health en een
configuratiekaart in plaats van een stille libpq-default. prototypes/ is
uitgesloten van de workers-typecheck en -lint.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
parseFilters/toSearchParams (theme inbegrepen, ongeldige waarden → default
met waarschuwing) en resolveRange/bucketFor/bucketKeys op de lokale kalender:
grenzen zijn instants van Amsterdamse middernacht, weeksleutels ISO zoals
Postgres IYYY-"W"IW. Tests dekken de wintertijddag en de jaarwisseling.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sessies en workerjobs worden één usage-feit (naïeve UTC expliciet als UTC,
buckets in Europe/Amsterdam). USD volgt PBI-36: API-lijstprijs via runtime +
provider + pricing_model_id, geen prijsrij → NULL, Harness nooit geprijsd,
NULL-tellers als 0. VALUES-tests en een rooktest tegen scrum4me-ro bewaken de
sommen, de ongeprijsd-gelijkheid en de brongelijkheden.

Read-only en statement_timeout gaan nu als startparameter (options) mee in
plaats van een SET in de connect-handler: geldt vóór de eerste query en
vermijdt de pg-deprecation voor gelijktijdige client.query.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
De pagina toont per dag of week een gestapelde staaf per model, gegroepeerd
Anthropic → OpenAI → Harness in de Vis-chartkleuren, met een eigen tooltip op
popover-tokens. Alle keuzes (product, periode, eenheid, bron, thema) staan in
de URL. USD-weergave tekent alleen geprijsde feiten en meldt de rest; bekende
databasefouten (config, onbereikbaar, time-out) worden een kaart, geen 500.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Bewijst dat de options-startparameter de query na 15 s afbreekt en dat
SQLSTATE 57014 als time-out geclassificeerd wordt (basis van de time-outkaart).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Taak 5–7: fasemapping als één TS-constante waaruit de SQL-CASE komt,
taartstate in de URL (entity/status/focus/level), taartqueries met
idee-toerekening via idea_id of bouwsprint, rooktests op Σ-invarianten,
componenten met inzoomen en broodkruimel. Gemeten op scrum4me-ro: 3–8 %
van de tokens hangt aan een idee; voorstel (wacht op JP) om ongekoppeld
verbruik als melding te tonen in plaats van als segment.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PHASE_RULES is de enige bron voor de fasemapping: phaseOf en de SQL-CASE
lezen haar allebei. Filters krijgt entity/status/focus/level; toPieData
bundelt kleine items tot Overig en zet restsegmenten neutraal achteraan.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
fetchItemShares geeft per idee of sprint een slice en het ongekoppelde deel
apart (besluit JP: melding, geen segment). fetchIdeaPhases gebruikt de
uit PHASE_RULES gegenereerde CASE; fetchSprintLevels groepeert per PBI,
story of taak met Sprintoverhead, Zonder PBI en Onbekend. Rooktests: Σ taart
+ niet gekoppeld = Σ staaf, open + afgesloten = alles, Σ taart 2 = item.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Taart per idee of sprint onder de staaf, met Open/Alles/Afgesloten, inzoomen
naar vijf idee-fases of PBI/Story/Taak en de inzoomstand in de URL.
Ongekoppeld verbruik staat als melding onder de taart (besluit JP), zodat
taart plus melding gelijk is aan de staaf. Fases in vaste volgorde, kleine
aandelen als "< 0,1 %", productcode in het sprintlabel. README beschrijft
de URL-parameters en bekende beperkingen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
style(usage-proto): layout en kleuren volgens het Vis-designsysteem (IDEA-248)
All checks were successful
CI / Verify (pull_request) Successful in 4m10s
3cb68d1845
Op verzoek van JP: paginaframe van 1200px met Vis-goot, serif koppen
(heading-lg, title), productkaarten met shadow-subtle, keuzegroepen op stof,
invoervelden met border-control, meldingen als warme callout en zwevende
lagen op papier met rand. Grafiekkleuren uit niet-ember Vis-tokens op één
plek (styles/vis.css): Anthropic accent-violet, OpenAI accent-green,
Harness grijs; taart wisselt violet, blauw en groen. theme.css blijft de
Scrum4Me-kopie; ontbrekende Vis-tokens staan in styles/vis.css.

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

Verdict: COMMENT

Geen blokkerende codefindings gevonden. Eén kleine documentatieafwijking verhindert een eenduidige bevestiging van volledige plan-conformiteit.

Findings

  • MINOR (niet blokkerend) — docs/superpowers/specs/2026-10-12-scrum-usage-prototype-design.md:187: de spec schrijft Anthropic/OpenAI/Harness via --chart-1/2/4 voor. Het gekoppelde plan herhaalt dit in het providerColor-contract en de acceptatiechecks, maar lib/providers.ts en styles/vis.css gebruiken violet/groen/grijs. De README beschrijft de nieuwe keuze wel. Werk spec §7 en de betreffende plancontracten/checks bij zodat de actuele afspraak overal hetzelfde is.

Plan en scope

plan gekoppeld via pr_refs. References:

  • docs/superpowers/specs/2026-10-12-scrum-usage-prototype-design.md
  • docs/superpowers/plans/2026-10-12-scrum-usage-prototype.md

Geen omitted onderdelen. De code dekt de door deze PR geclaimde incrementen 1 en 2: afzonderlijke lokale app, gedeelde read-only feitenbasis, filters, staafdiagram, taart en inzoomen. Overzetten naar Workers en het besluit uit increment 3 vallen buiten deze PR en zijn geen finding. Architectuur en de bestaande Workers-stylingregels zijn verder gevolgd; thema-kopie is bytegelijk.

Verificatie

Beoordeeld op head 3cb68d18458b198a7f8ad57a3f74e1cc0c56b2e2; remote PR-head komt overeen.

  • Prototype: typecheck en productiebuild geslaagd; 60 tests geslaagd, 24 database-tests overgeslagen.
  • Workers-root: npm run verify geslaagd; 2668 tests geslaagd, 43 overgeslagen. Eén bestaande lint-waarschuwing buiten de diff.
  • SQL en navigatie statisch beoordeeld. Database-rooktests en browserinteracties niet onafhankelijk uitgevoerd; de benodigde read-only serviceconfiguratie ontbreekt hier.
# Verdict: COMMENT Geen blokkerende codefindings gevonden. Eén kleine documentatieafwijking verhindert een eenduidige bevestiging van volledige plan-conformiteit. ## Findings - **MINOR (niet blokkerend)** — `docs/superpowers/specs/2026-10-12-scrum-usage-prototype-design.md:187`: de spec schrijft Anthropic/OpenAI/Harness via `--chart-1/2/4` voor. Het gekoppelde plan herhaalt dit in het providerColor-contract en de acceptatiechecks, maar `lib/providers.ts` en `styles/vis.css` gebruiken violet/groen/grijs. De README beschrijft de nieuwe keuze wel. Werk spec §7 en de betreffende plancontracten/checks bij zodat de actuele afspraak overal hetzelfde is. ## Plan en scope plan gekoppeld via pr_refs. References: - `docs/superpowers/specs/2026-10-12-scrum-usage-prototype-design.md` - `docs/superpowers/plans/2026-10-12-scrum-usage-prototype.md` Geen omitted onderdelen. De code dekt de door deze PR geclaimde incrementen 1 en 2: afzonderlijke lokale app, gedeelde read-only feitenbasis, filters, staafdiagram, taart en inzoomen. Overzetten naar Workers en het besluit uit increment 3 vallen buiten deze PR en zijn geen finding. Architectuur en de bestaande Workers-stylingregels zijn verder gevolgd; thema-kopie is bytegelijk. ## Verificatie Beoordeeld op head `3cb68d18458b198a7f8ad57a3f74e1cc0c56b2e2`; remote PR-head komt overeen. - Prototype: typecheck en productiebuild geslaagd; 60 tests geslaagd, 24 database-tests overgeslagen. - Workers-root: `npm run verify` geslaagd; 2668 tests geslaagd, 43 overgeslagen. Eén bestaande lint-waarschuwing buiten de diff. - SQL en navigatie statisch beoordeeld. Database-rooktests en browserinteracties niet onafhankelijk uitgevoerd; de benodigde read-only serviceconfiguratie ontbreekt hier.
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-workers!157
No description provided.