feat(solo-dialogs): layout-conformance + entity-profielen

Story 6 van PBI "Alle dialogen conform docs/patterns/dialog.md".

- batch-enqueue-blocker-dialog: entityDialog* layout-classes
- task-detail-dialog: entityDialog* layout-classes (rest van interne
  layout blijft custom — hybride detail+blur-save view)
- docs/specs/dialogs/task-detail.md — profiel dat het blur-save +
  PATCH-route patroon documenteert (afwijking van klassieke
  Server-Action+form flow)
- docs/specs/dialogs/batch-enqueue-blocker.md — profiel voor
  informational confirm-dialog

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Janpeter Visser 2026-05-04 07:32:57 +02:00
parent 784791d8f9
commit 0a58557e9d
5 changed files with 157 additions and 34 deletions

View file

@ -0,0 +1,48 @@
---
title: "BatchEnqueueBlockerDialog Profiel"
status: active
audience: [ai-agent, contributor]
language: nl
last_updated: 2026-05-04
---
# BatchEnqueueBlockerDialog Profiel
> Volgt `docs/patterns/dialog.md`. Dit is een **informational / confirm-dialog** zonder eigen entiteit — geen schema, geen demo-policy, geen server actions.
## Doel
Wanneer de gebruiker in solo-mode "stuur volgende N taken naar Claude" probeert maar er een blokkade voor de N-de taak ligt (een PBI op `blocked` of een taak op `review`), stopt de UI het in deze dialog en biedt aan om alleen de taken **vóór** de blokkade te queuen.
## Modus
Confirm-dialog. Geen create/edit/detail. Geen form.
## Props
```ts
{
open: boolean
onOpenChange: (v: boolean) => void
prefixCount: number // hoeveel taken vóór de blokkade liggen
blockerReason: 'task-review' | 'pbi-blocked'
blockerLabel: string // titel van de blokkerende PBI/taak
onConfirm: () => void // alleen taken vóór de blokkade queuen
onCancel: () => void // helemaal annuleren
}
```
## URL- of state-pattern
- Gekozen: **state-based** — gerendeerd door `solo-board` met een `BatchEnqueueState | null`-prop.
## Layout
Gebruikt `entityDialogContentClasses` voor responsive sizing.
## Bewust NIET in v1
- ❌ **Geen demo-policy** — de dialog schrijft niet zelf; demo-blokkering vindt plaats wanneer `onConfirm` de daadwerkelijke `enqueueClaudeJobAction` aanroept (laag 2 demo-check zit daar).
- ❌ **Geen schema** — geen veldwaarden in/uit; alleen confirm/cancel.
- ❌ **Geen dirty-close-guard** — geen state om dirty te raken.
- ❌ **Geen Cmd/Ctrl+Enter** — niet zinvol voor confirm-only.

View file

@ -0,0 +1,65 @@
---
title: "TaskDetailDialog Profiel"
status: active
audience: [ai-agent, contributor]
language: nl
last_updated: 2026-05-04
---
# TaskDetailDialog Profiel
> Volgt `docs/patterns/dialog.md`. Dit document beschrijft alleen de Solo-specifieke afwijkingen.
> **Niet te verwarren met `TaskDialog`** (`app/_components/tasks/task-dialog.tsx`) — dat is de classic create/edit-dialog voor backlog-taken. **`TaskDetailDialog`** is een solo-board-specifieke detail+edit-overlay die een lopende taak laat zien terwijl de Claude-agent eraan werkt.
## Doel
Vanuit het solo-board kan de gebruiker op een task-card klikken om:
- Het implementation_plan te lezen / bewerken (markdown, blur-save)
- Verify-instellingen te wijzigen (`verify_only`, `verify_required`)
- Claude-job-status en branch-link te zien
- De huidige taak naar Claude te sturen / te annuleren
## Velden
| Veld | Type | Validatie |
|---|---|---|
| `implementation_plan` | string \| null | max 10000, markdown, blur-save |
| `verify_only` | boolean | toggle, direct opgeslagen |
| `verify_required` | enum `'ALIGNED' \| 'ALIGNED_OR_PARTIAL' \| 'ANY'` | radio, direct opgeslagen |
## URL- of state-pattern
- Gekozen: **state-based**`task: SoloTask | null` prop uit `solo-board`. `null` = dialog gesloten.
- Reden: solo-board is one-page; de detail-dialog is altijd in context.
## Persistence
**Geen klassiek form-submit.** Wijzigingen schrijven via `fetch('/api/tasks/:id', { method: 'PATCH' })` (route handler), getriggerd door:
- Plan-textarea: blur of debounced auto-save
- Verify-toggles: direct bij click
Dit valt buiten de standaard "Server Action met form" flow van `docs/patterns/dialog.md` § 7. Reden: het zijn fine-grained edits van een lopende taak, geen save-dan-sluit-flow.
## Drielaagse demo-policy
- **Laag 1 (proxy.ts):** `/api/tasks/[id]`-route is via `apiAuth`-helper beschermd; demo-write zou geblokkeerd moeten worden in de route handler zelf
- **Laag 2 (route handler):** `session.isDemo`-check in `app/api/tasks/[id]/route.ts` (PATCH) — verifieer dat dit aanwezig is
- **Laag 3 (UI):** `<DemoTooltip show={isDemo}>` rond plan-textarea en verify-toggles; `readOnly` resp `disabled`-state op de controls
## Layout
Gebruikt `entityDialogContentClasses` voor responsive sizing (§4 spec). Body-layout intern is custom (gegroepeerde secties in plaats van form-fields) want het is een hybride detail+edit-view, niet een klassiek form.
## Bewust NIET in v1
- ❌ **Klassiek save-dan-sluit-form** — blur-save is bewust gekozen omdat de gebruiker tussendoor de plan-tekst herziet terwijl Claude bezig is.
- ❌ **Dirty-close-guard** — niet relevant zonder klassiek submit-form; wijzigingen worden direct gepersisteerd.
- ❌ **Cmd/Ctrl+Enter shortcut** — geen submit, dus n.v.t.
- ❌ **422-fieldErrors** — fine-grained PATCH-route geeft simpele 200/400/403; geen veldgewijze rendering nodig in deze UX.
## Gerelateerde bestanden
- `components/solo/task-detail-dialog.tsx` — implementatie
- `app/api/tasks/[id]/route.ts` — PATCH-handler
- `stores/solo-store.ts` — client-state