feat(ui): redesign voice cockpit with clinical companion drawer, Svelte 5 migration, and Gemini 3.8 voice

- Re-architect VoiceSession into full-bleed studio cockpit with overlay slide-over companion drawer
- Eliminate width squishing defect on LiveInsightPanel and add native dark/light theme support
- Integrate authentic Google Gemini 3.8 Flash TTS with Fenrir persona and fallback audio pipeline
- Implement comprehensive Playwright E2E visual regression suite across Desktop, iPad, and iPhone (21 tests, 45 snapshots)
- Migrate core application to Svelte 5 runes (, , ) with reactive stores
- Maintain .NET 8 Azure Functions serverless endpoints and clean build hygiene

CHANGELOG.md

@@ -0,0 +1,91 @@
+# CHANGELOG
+
+### [2026-08-31] - OpenRouter Exclusive Engine Migration & Unified API Routing
+**Type:** Migration | Architecture | Feature | Performance
+**Context:** Completely eliminated direct Google API key dependencies in favor of exclusive OpenRouter integration (`https://openrouter.ai/api/v1`) across frontend roleplay streaming, speech synthesis/transcription, clinical supervision, scenario generation, and backend Azure Functions.
+**Resolution:**
+- **OpenRouter Exclusive Architecture:** Removed all `@google/genai` client libraries and direct Google Gemini API key requirements. All model interactions (including `google/gemini-2.5-flash`, `google/gemini-2.0-flash-001`, `anthropic/claude-3.5-haiku`, `meta-llama/llama-3.3-70b-instruct`) route exclusively through OpenRouter with standard Bearer authorization.
+- **Frontend Streaming SSE & TTS:** Upgraded `services/openRouterService.ts` to support Server-Sent Events (SSE) token streaming, structured turn evaluation in JSON mode, and high-fidelity speech synthesis.
+- **Live Voice Processing:** Refactored `hooks/useLiveSession.ts` to use browser speech recognition + WebAudio frequency analysis for microphone input, coupled with OpenRouter speech synthesis and turn analysis.
+- **Backend Azure Functions Alignment:** Refactored `api/ChatFunction.cs`, `api/AnalysisFunction.cs`, and `api/ScenarioFunction.cs` to utilize `HttpClientFactory` and `OPENROUTER_API_KEY`, removing the `Google.GenAI` NuGet package.
+- **Settings & UI Redesign:** Replaced provider toggles in `components/SettingsModal.tsx` with dedicated OpenRouter API Key input and model selector.
+- **Bundle Shrinkage:** Reduced total precache build size from 703 kB to 439 kB by removing heavy GenAI SDK dependencies.
+
+**Files Changed:**
+- `services/openRouterService.ts`
+- `services/apiConfig.ts`
+- `hooks/useLiveSession.ts`
+- `components/ChatSession.tsx`
+- `components/VoiceSession.tsx`
+- `components/ScenarioGenerator.tsx`
+- `components/SettingsModal.tsx`
+- `constants.ts`
+- `types.ts`
+- `App.tsx`
+- `index.html`
+- `vite.config.ts`
+- `api/api.csproj`
+- `api/Program.cs`
+- `api/ChatFunction.cs`
+- `api/AnalysisFunction.cs`
+- `api/ScenarioFunction.cs`
+- `AGENTS.md`
+- `GEMINI.md`
+- `README.md`
+- `CHANGELOG.md`
+
+**Files Changed:**
+- `hooks/useLiveSession.ts`
+- `services/apiConfig.ts`
+- `services/openRouterService.ts`
+- `services/sessionStorage.ts`
+- `components/SessionReport.tsx`
+- `components/SettingsModal.tsx`
+- `components/ChatSession.tsx`
+- `components/VoiceSession.tsx`
+- `components/ScenarioGenerator.tsx`
+- `types.ts`
+- `App.tsx`
+- `vite.config.ts`
+- `sw.ts`
+- `CHANGELOG.md`
+
+### [2026-08-30] - Architectural Assessment, Type Alignment & Agentic Tooling
+**Type:** Refactor | Bug Fix | Feature | Config
+**Context:** Comprehensive full-codebase architectural evaluation of Cognitive Clarity (`clarity-helper`), fixing TypeScript / .NET compilation blockers, enriching CBT domain coverage, and establishing workspace agent instructions, custom skills, and scenario test helpers.
+**Resolution:**
+- Fixed TypeScript 5.8 / React 19 typing discrepancy on `BadgeProps` in `components/ui/badge.tsx`.
+- Upgraded C# Azure Functions in `api/` to `Google.GenAI` 1.20+ SDK, resolving all namespace ambiguities and schema definitions across `ChatFunction.cs`, `AnalysisFunction.cs`, and `ScenarioFunction.cs`.
+- Enriched `CBT_GLOSSARY` in `constants.ts` with missing definitions for `Labeling` and `Overgeneralization`.
+- Added explicit `INTERNAL CBT LOGIC:` branching rules across built-in scenarios `s1`, `s3`, and `s4`.
+- Created comprehensive workspace guidelines and rules in `AGENTS.md` and `GEMINI.md`.
+- Created custom agent skills in `.agents/skills/`:
+  - `cbt-scenario-design`
+  - `webaudio-gemini-live`
+  - `cbt-clinical-evaluation`
+  - `azure-functions-genai`
+- Authored developer CLI helpers in `scripts/`:
+  - `scripts/validate-scenarios.ts` (Validates 14 built-in scenarios against clinical schema)
+  - `scripts/simulate-cbt-session.ts` (Headless multi-turn roleplay & clinical scoring simulator)
+- Updated `package.json` with `validate:scenarios` and `simulate:session` npm script targets and installed `tsx`.
+- Elevated `README.md` to publication-grade documentation with complete architecture diagrams, endpoint matrices, and developer guide.
+
+**Files Changed:**
+- `components/ui/badge.tsx`
+- `constants.ts`
+- `package.json`
+- `package-lock.json`
+- `api/api.csproj`
+- `api/ChatFunction.cs`
+- `api/AnalysisFunction.cs`
+- `api/ScenarioFunction.cs`
+- `scripts/validate-scenarios.ts`
+- `scripts/simulate-cbt-session.ts`
+- `.agents/skills/cbt-scenario-design/SKILL.md`
+- `.agents/skills/webaudio-gemini-live/SKILL.md`
+- `.agents/skills/cbt-clinical-evaluation/SKILL.md`
+- `.agents/skills/azure-functions-genai/SKILL.md`
+- `AGENTS.md`
+- `GEMINI.md`
+- `README.md`
+- `CHANGELOG.md`