Miscellaneous improvements: testing, documentation, and code quality

.claude/settings.json

@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pnpm :*)",
+      "Bash(git :*)",
+      "Bash(gh :*)",
+      "Bash(mkdir:*)"
+    ],
+    "deny": [
+      "Bash(git push --force:*)",
+      "Bash(git reset --hard:*)",
+      "Bash(git clean:*)",
+      "Bash(git branch -D:*)",
+      "Bash(gh repo delete:*)",
+      "Bash(gh pr merge:*)",
+      "Bash(gh release delete:*)",
+      "Bash(pnpm publish:*)"
+    ],
+    "ask": [
+      "Bash(git commit)"
+    ]
+  }
+}

.claude/tasks/01-documentation.md

@@ -0,0 +1,215 @@
+---
+title: Documentation Tasks
+category: documentation
+priority: low
+total_tasks: 7
+estimated_time: 45min
+status: pending
+created: 2025-11-06
+---
+
+# 📚 Documentation Tasks
+
+Tasks to align documentation with actual implementation.
+
+---
+
+## Task 1: Fix /src/api Architecture Documentation
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~5 min
+**File:** `CLAUDE.md`
+
+### Problem
+- Documentation mentions `/src/api` directory for "API integration and data fetching"
+- This directory doesn't exist
+- API calls are actually handled in `/src/hooks/useChatWebhook.ts`
+
+### Action
+Remove or update the `/src/api` reference in CLAUDE.md line 40.
+
+**Option A:** Remove the line
+**Option B:** Update to:
+```markdown
+- `/src/hooks`: Custom React hooks including API integration (useChatWebhook)
+```
+
+### Files to modify
+- `CLAUDE.md` (line 40)
+
+---
+
+## Task 2: Fix biome.json JSX Runtime Configuration
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~2 min
+**File:** `biome.json`
+
+### Problem
+- `biome.json` line 16 sets `"jsxRuntime": "reactClassic"`
+- Project uses React 19 with automatic JSX transformation
+- Causes inconsistency with tsconfig `"jsx": "react-jsx"`
+
+### Action
+Update `biome.json` line 16:
+
+```json
+"jsxRuntime": "transparent"
+```
+
+Or remove the setting entirely to use default.
+
+### Files to modify
+- `biome.json` (line 16)
+
+---
+
+## Task 3: Update pnpm Version
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~1 min
+**File:** `CLAUDE.md`
+
+### Problem
+- Documentation states `pnpm v10.6.3`
+- Actual version is `pnpm v10.14.0`
+
+### Action
+Update CLAUDE.md line 15:
+
+```markdown
+- **Package Manager**: pnpm v10.14.0
+```
+
+### Files to modify
+- `CLAUDE.md` (line 15)
+
+---
+
+## Task 4: Document Missing Folders
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~5 min
+**File:** `CLAUDE.md`
+
+### Problem
+Actual project structure has folders not documented:
+- `/src/domain` - Contains entities (Message, Roles enum)
+- `/src/lib` - Utility functions (utils.ts with `cn()` helper)
+- `/src/contexts` - Empty folder
+
+### Action
+Add to CLAUDE.md "Architecture Notes" section:
+
+```markdown
+- Project structure:
+  - `/src/components`: React components
+  - `/src/hooks`: Custom React hooks
+  - `/src/domain`: Domain entities and types
+  - `/src/lib`: Utility functions and helpers
+  - `/src/contexts`: React contexts (currently empty)
+```
+
+### Files to modify
+- `CLAUDE.md` (lines 39-41)
+
+---
+
+## Task 5: Update Naming Convention Documentation
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~3 min
+**File:** `CLAUDE.md`
+
+### Problem
+- Documentation says: "Types/Interfaces: PascalCase with prefix (IUser, TConfig)"
+- Actual codebase uses: `ChatContainerProps`, `WebhookResponse` (no I/T prefix)
+- Uses "Props" suffix pattern instead
+
+### Action
+Update CLAUDE.md line 21:
+
+```markdown
+- **Naming Conventions**:
+  - Components: PascalCase
+  - Functions/Variables: camelCase
+  - Types/Interfaces: PascalCase (Props suffix for component props)
+  - Example: `ChatContainerProps`, `WebhookResponse`
+```
+
+### Files to modify
+- `CLAUDE.md` (line 21)
+
+---
+
+## Task 6: Document Key Dependencies
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~10 min
+**File:** `CLAUDE.md`
+
+### Problem
+Important dependencies are used but not documented:
+- `react-markdown` + `remark-gfm` - Markdown rendering
+- `react-syntax-highlighter` - Code block syntax highlighting
+- `lucide-react` - Icon library
+- `class-variance-authority` - Component variants (used by shadcn)
+
+### Action
+Add new section in CLAUDE.md after "UI Components":
+
+```markdown
+- **Additional Libraries**:
+  - `react-markdown` + `remark-gfm`: Markdown rendering with GitHub flavored syntax
+  - `react-syntax-highlighter`: Code block highlighting in chat messages
+  - `lucide-react`: Icon library for UI elements
+  - `class-variance-authority`: Component variant utilities
+```
+
+### Files to modify
+- `CLAUDE.md` (add after line 30)
+
+---
+
+## Task 7: Decide on Empty /src/contexts Folder
+
+**Status:** 🔲 Pending
+**Priority:** 🟢 Low
+**Time:** ~2 min
+**File:** File system
+
+### Problem
+- `/src/contexts` folder exists but is completely empty
+- Not documented in CLAUDE.md
+- Unclear if it's intentional or leftover
+
+### Action
+**Option A:** Remove the folder if not needed:
+```bash
+rm -rf src/contexts
+```
+
+**Option B:** Keep and document intent in CLAUDE.md
+
+**Option C:** Add a README.md inside explaining it's reserved for future use
+
+### Files to modify
+- Either delete `src/contexts/` or document it
+
+---
+
+## Checklist
+
+- [ ] Task 1: Fix /src/api documentation
+- [ ] Task 2: Fix biome.json jsxRuntime
+- [ ] Task 3: Update pnpm version
+- [ ] Task 4: Document missing folders
+- [ ] Task 5: Update naming conventions
+- [ ] Task 6: Document key dependencies
+- [ ] Task 7: Handle empty contexts folder