feat(swift): implementeer intent detection & action parsing (E3.S4)

Epic 3 Story 4 compleet: AI action objects worden geparsed en gevalideerd.

E3.S4 - Intent Detection in Response (5 SP)
- Action parser met JSON extraction uit markdown code blocks
- Zod validatie voor action schema (intent, entities, confidence, artifact)
- Confidence-based artifact opening (≥0.7 threshold)
- Visual feedback met action badges in chat messages
- Console logging voor debugging

Nieuwe Components:
- lib/swift/action-parser.ts (149 regels)
  - parseActionFromResponse(): Extract & validate JSON actions
  - extractJsonBlock(): Regex matching voor ```json blocks
  - removeJsonBlocks(): Clean text zonder JSON
  - shouldOpenArtifact(): Confidence check (≥0.7)
  - getConfidenceLabel(): "Zeer zeker", "Redelijk zeker", etc.
  - validateArtifactType(): Intent/artifact type matching

Components Updated:
- components/swift/chat/chat-panel.tsx
  - Action parsing in onDone callback
  - setPendingAction voor artifact opening (E3.S6)
  - Console logging: "[ChatPanel] Action detected"

- components/swift/chat/chat-message.tsx
  - Action badge met Sparkles icon
  - Intent label (Dagnotitie, Patiënt zoeken, Overdracht)
  - CheckCircle icon voor high confidence (≥0.7)
  - Confidence label display

- stores/swift-store.ts
  - updateLastMessage(): Optional action parameter
  - Type-safe action assignment (null/undefined handling)

Features:
- JSON extraction via regex: /```json\s*\n([\s\S]*?)\n```/
- Zod schema: type, intent, entities, confidence, artifact
- Confidence thresholds: >0.9, 0.7-0.9, 0.5-0.7, <0.5
- Visual feedback: Sparkles + CheckCircle icons
- Cleaned text content (JSON removed from display)
- Action stored in message.action en pendingAction state

Action Schema:
```typescript
{
  type: "action",
  intent: "dagnotitie" | "zoeken" | "overdracht" | "unknown",
  entities: {
    patientName?: string,
    patientId?: string,
    category?: "medicatie" | "adl" | "gedrag" | "incident" | "observatie",
    content?: string,
    query?: string
  },
  confidence: number, // 0-1
  artifact?: {
    type: BlockType,
    prefill: Record<string, any>
  }
}
```

Build Status:
-  pnpm build succesvol (geen type errors)
- Alleen bekende warnings (Supabase realtime, useCallback)

Voortgang: 46 SP / 85 SP (54%) - E3.S4 compleet

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
colinislit
2025-12-27 16:11:43 +01:00
parent 8efac8483f
commit 9b85448a43
11 changed files with 496 additions and 29 deletions

View File

@@ -221,13 +221,13 @@ const useChatStore = create<ChatState>((set) => ({
| E0 | Pre-work & Planning | Design tokens, component audit, system prompt | ✅ **Compleet** | 3/3 | 5 SP | Docs aangemaakt |
| E1 | Foundation - Split-screen | Layout naar 40/60 split | ✅ **Compleet** | 3/3 | 12 SP | E1.S1 geskipt (geen feature flag) |
| E2 | Chat Panel & Messages | Chat UI zonder AI | ✅ **Compleet** | 5/5 | 13 SP | Scrolling, input, shortcuts |
| E3 | Chat API & Medical Scribe | AI conversatie werkend | ⏳ In Progress | 3/6 | 21 SP | Medical scribe prompt v1.0 |
| E3 | Chat API & Medical Scribe | AI conversatie werkend | ⏳ In Progress | 4/6 | 21 SP | Intent detection parsing |
| E4 | Artifact Area & Tabs | Meerdere artifacts mogelijk | ⏳ To Do | 0/4 | 13 SP | Week 5 |
| E5 | AI-Filtering & Polish | Psychiater filtering, polish | ⏳ To Do | 0/5 | 13 SP | Week 6 |
| E6 | Testing & Refinement | QA, bugs, performance | ⏳ To Do | 0/4 | 8 SP | Week 7-8 |
**Totaal:** 31 stories, **85 Story Points** (~7 weken à 12 SP/week)
**Voortgang:** ✅ 14/31 stories compleet (41 SP / 85 SP = **48%**)
**Voortgang:** ✅ 15/31 stories compleet (46 SP / 85 SP = **54%**)
**Belangrijk:**
- ⚠️ Voer niet in 1x het volledige plan uit. Bouw per epic en per story.
@@ -409,7 +409,7 @@ const MESSAGE_STYLES = {
| E3.S1 | Chat API endpoint skeleton | `/api/swift/chat` route met SSE setup | ✅ **Compleet** | E2.S5 | 3 |
| E3.S2 | Streaming response logic | Claude API streaming werkt, chunks naar frontend | ✅ **Compleet** | E3.S1 | 5 |
| E3.S3 | Medical scribe system prompt | Prompt met role, intents, examples, Nederlands | ✅ **Compleet** | E3.S2 | 3 |
| E3.S4 | Intent detection in response | AI genereert action objects (intent + entities) | | E3.S3 | 5 |
| E3.S4 | Intent detection in response | AI genereert action objects (intent + entities) | ✅ **Compleet** | E3.S3 | 5 |
| E3.S5 | Frontend streaming handling | useChatStream hook, message chunks renderen | ⏳ | E3.S4 | 3 |
| E3.S6 | Artifact opening from chat | Action object opent juiste block met prefill | ⏳ | E3.S5 | 2 |
@@ -553,11 +553,29 @@ export function useChatStream() {
- ✅ 4 voorbeelden: dagnotitie, zoeken, verduidelijking, onduidelijke intent
- ✅ Build succesvol zonder type errors
**Deliverables (E3.S4 compleet):**
- ✅ `lib/swift/action-parser.ts` (149 regels) — JSON action parser met Zod validatie
- ✅ `parseActionFromResponse()` — Extract JSON from ```json code blocks
- ✅ `extractJsonBlock()` — Markdown code block regex matching
- ✅ `removeJsonBlocks()` — Clean text content zonder JSON
- ✅ `shouldOpenArtifact()` — Confidence threshold check (≥0.7)
- ✅ `getConfidenceLabel()` — User-friendly labels (Zeer zeker, Redelijk zeker, etc.)
- ✅ `validateArtifactType()` — Intent/artifact type matching validation
- ✅ ChatPanel: Action parsing in onDone callback
- ✅ ChatPanel: setPendingAction voor artifact opening (E3.S6)
- ✅ ChatMessage: Action badge met intent + confidence indicator
- ✅ Store: updateLastMessage met optional action parameter
- ✅ Action schema validation: intent, entities, confidence, artifact
- ✅ Visual feedback: Sparkles icon, CheckCircle voor high confidence
- ✅ Console logging voor debugging action detection
- ✅ Build succesvol zonder type errors
**Git Commits:**
- `a51acf6` — E3.S1 & E3.S2 (Chat API + Claude streaming)
- (to be committed) — E3.S3 (Medical scribe system prompt v1.0)
- `8efac84` — E3.S3 (Medical scribe system prompt v1.0)
- (to be committed) — E3.S4 (Intent detection in response)
**Remaining:** E3.S4-E3.S6 voor intent detection parsing, frontend handling, en artifact opening
**Remaining:** E3.S5-E3.S6 voor frontend streaming polish en artifact opening
---

163
docs/templates/commit_template.md vendored Normal file
View File

@@ -0,0 +1,163 @@
# 📝 Commit Message Template
**Doel:** Consistente commit messages voor een begrijpelijke projectgeschiedenis.
**Tip:** Blijf compact - body en footer zijn optioneel, alleen toevoegen als het nodig is voor duidelijkheid.
---
## Structuur
```
<type>(<scope>): <subject>
<body>
<footer>
```
**Voorbeeld:**
```
feat(epd): voeg AI-samenvatting toe aan intakeverslag
Voegt een nieuwe knop toe in de rich text editor die de intake
automatisch samenvat met behulp van de AI API.
Closes #123
```
---
## Types
| Type | Beschrijving | Voorbeeld |
|------|--------------|-----------|
| `feat` | Nieuwe functionaliteit | `feat(epd): voeg behandelplan editor toe` |
| `fix` | Bug fix | `fix(auth): corrigeer redirect loop` |
| `docs` | Documentatie | `docs: update API documentatie` |
| `style` | Code formatting | `style: format code met prettier` |
| `refactor` | Code refactoring | `refactor(api): herstructureer error handling` |
| `perf` | Performance verbetering | `perf(db): optimaliseer query met index` |
| `test` | Tests | `test: voeg unit tests toe` |
| `chore` | Build/tooling | `chore: update dependencies` |
| `ci` | CI/CD | `ci: voeg GitHub Actions toe` |
| `build` | Build systeem | `build: configureer webpack` |
| `revert` | Revert commit | `revert: revert "feat: voeg X toe"` |
---
## Scopes
- `epd` - EPD features
- `auth` - Authenticatie/autor-isatie
- `api` - API endpoints
- `ui` - UI componenten
- `db` - Database migraties
- `docs` - Documentatie
- `swift` - Swift medical scribe
- `behandelplan` - Behandelplan
- `verpleegrapportage` - Verpleegrapportage
---
## Subject Regels
- ✅ Imperatief ("voeg toe", niet "toegevoegd")
- ✅ Maximaal 50 karakters
- ✅ Geen punt aan het einde
- ✅ Begin met kleine letter
- ✅ Beschrijf **wat**, niet **waarom**
**Goed:** `feat(epd): voeg AI-samenvatting toe`
**Slecht:** `feat(epd): Voeg AI-samenvatting toe.` ← hoofdletter en punt
---
## Body (Optioneel)
**Tip:** Alleen toevoegen als de subject regel niet voldoende duidelijkheid geeft.
- Scheid van subject met lege regel
- Maximaal 72 karakters per regel
- Leg uit **waarom** en **hoe** (alleen indien nodig)
- Beschrijf edge cases indien relevant
- **Blijf compact** - vaak is alleen de subject regel voldoende
---
## Footer (Optioneel)
- `Closes #123` - Sluit issue automatisch
- `Fixes #456` - Fix issue
- `BREAKING CHANGE: beschrijving` - Breaking change
---
## Voorbeelden
### Feature
```
feat(swift): voeg voice commands toe
Voegt spraakherkenning toe voor commando's tijdens dicteren.
Ondersteunt "nieuwe sectie", "opslaan", en "annuleren".
Closes #234
```
### Bug Fix
```
fix(behandelplan): corrigeer opslaan leefgebieden scores
Het opslaan faalde wanneer er geen vorige scores waren.
Toegevoegd: check voor null/undefined waarden.
Fixes #567
```
### Breaking Change
```
feat(auth): migreer naar Supabase Auth v2
BREAKING CHANGE: `loginUser()` vervangen door `signInWithPassword()`
Migratie:
- Vervang `loginUser(email, password)` met `signInWithPassword(email, password)`
- Update imports van `@/lib/auth` naar `@/lib/auth/client`
Closes #890
```
---
## Tips
**✅ Do's:**
- Wees specifiek: `fix(epd): corrigeer null pointer` > `fix: bug fix`
- Gebruik scope voor duidelijkheid
- Verwijs naar issues met `Closes #123`
- Gebruik imperatief
- **Blijf compact** - vaak is alleen `type(scope): subject` voldoende
**❌ Don'ts:**
- Geen vage beschrijvingen (`fix: stuff`)
- Geen emoji's in commit message
- Geen verleden tijd ("voegde toe")
- Geen meerdere wijzigingen in één commit
---
## Git Configuratie
```bash
# Lokaal
git config commit.template .gitmessage
# Globaal
git config --global commit.template .gitmessage
```
Gebruik: `git commit` (zonder `-m`) opent editor met template.
---
**Zie `.gitmessage` voor de Git template.**