jpremill/clarity-helper
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
clarity-helper/CHANGELOG.md
T
jpremill 1feea40684 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
2026-09-29 23:35:05 -04:00

4.7 KiB
Raw Permalink Blame History

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
Reference in new issue View Git Blame Copy Permalink