Changelog

All notable changes to Pocket Gull are documented here. Format follows Keep a Changelog.

v1.2.0 — 2026-07-22

10 Standardized Clinical & Life Sovereignty Assessment Instruments, Dynamic 3D Paradigm Synchronization & Rice Papercraft Theme

Added

  • [Clinical / Assessments] 10 Standardized Clinical & Life Sovereignty Assessment Instruments (clinical-assessments.service.ts & clinical-assessments-suite.component.ts):
    1. 🧠 PHQ-9: 9-item Patient Health Questionnaire for depression severity (0–27).
    2. ⚡ GAD-7: 7-item Generalized Anxiety Disorder scale with 0.1 Hz vagal resonance biofeedback integration (0–21).
    3. 🌙 ISI: 7-item Insomnia Severity Index with CBT-I sleep restriction directives (0–28).
    4. 🛡️ C-SSRS: 6-question Columbia Suicide Screener with automatic HIGH RISK Sentinel Safety Alerts & 988 Lifeline routing (0–16).
    5. 🩺 ROS-14: 14-System Review of Systems intake inventory spanning all major organ systems.
    6. 🫀 PHQ-15: 15-item Somatic Symptom Scale evaluating physical distress & autonomic dysregulation (0–30).
    7. 🤝 PRAPARE: Social Determinants of Health (SDOH) protocol automatically exporting ICD-10 Z-codes (Z59.8 Housing, Z59.41 Food Insecurity, Z59.82 Transportation, Z59.6 Financial Strain, Z60.2 Isolation).
    8. 🧘 AYURVEDA: 6-vector Samskrita Tridosha Inventory calculating Vata, Pitta, & Kapha balances and Agni metabolic fire types (Samagni, Vishamagni, Mandagni, Tikshnagni).
    9. 🌿 TCM: Traditional Chinese Medicine Shi Wen (Ten Questions) 6-vector inventory calculating Qi, Blood, Yin, Yang, Cold, & Heat Ba Gang patterns.
    10. 🌱 GROW_THYSELF: 5-domain Life Sovereignty & Epigenetic Flourishing inventory assessing Purpose/Ikigai, Somatic Sovereignty, Epigenetic Gut Vitality, Relational Depth, & Cognitive Agency.
  • [3D Body Viewer / Paradigms] Dynamic Paradigm-Driven 3D Viewport Synchronization (body-viewer.component.ts & body-3d-viewer.component.ts):
    • Selecting 🩺 Western switches 3D WebGL viewport to Allopathic Organs.
    • Selecting 🌿 Eastern TCM renders 3D Jing-Luo meridians & 12 Acupoints (GV-20 Baihui, CV-17 Danzhong, ST-36 Zusanli).
    • Selecting 🧘 Ayurvedic renders 3D Sushumna Lotus Chakras (Sahasrara, Ajna, Anahata, Manipura).
  • [3D UX / Interactivity] Interactive 3D Raycast Tooltips & Quick Data Entry Overlay Card:
    • Hovering over 3D nodes renders a floating Raycast Tooltip displaying part icon, paradigm badge, and recorded pain scores.
    • Clicking any 3D node opens a Quick Data Entry Card with pain slider (0–10), symptom notes, and direct intake navigation.
  • [UI / Themes] Default Rice Papercraft Theme: Applied tactile rice paper background texture (/images/rice_paper_texture.png) and soft organic off-white warm aesthetics (#FAF8F5).

v1.1.0-rc3 — 2026-07-21

Sentinel Triage Priority Sorting, 60fps 3D Patient Slide-in Transition, Geo-Sentinel Surveillance & FHIR R4 Bundle Export

Added

  • [3D Anatomy] 60fps High-Speed Patient Slide-in Transition (body-3d-viewer.component.ts): Selecting a patient triggers a smooth 3D slide-in animation (position.x interpolates from -3.5m to center 0.0m), instantly updating pain heatmaps and anatomical focus.
  • [Triage / Roster] Urgency Priority Patient Dropdown Sorting (patient-dropdown.component.ts): Automatically sorts patient roster by Triage Urgency Score so Level 1 Emergency Resuscitation & Level 2 Emergent patients appear at the very top.
  • [Public Health] Geo-Sentinel Outbreak Viewpoint Deck (sentinel-triage.component.ts): Added 3 international surveillance modes (Global 🌎 WHO, Regional 🌍 PAHO, Domestic 🇺🇸 CDC/NHI) with real-time AI Containment directives.
  • [FHIR R4 / Export] FHIR R4 Bundle Serialization & 1-Click Export (export.service.ts): Added exportPatientToFhirJson() creating HIPAA-compliant FHIR Patient, Observation (vitals & pain scores), and DiagnosticReport resources.

v1.1.0-rc2 — 2026-07-21

Patient Health Trajectory Storybook, 4 Adaptive Cognitive Reading Modes & Dedicated AI Mind-State Synthesizer

Added

  • [Narrative / Literacy] Interactive Patient Health Trajectory Storybook (patient-health-trajectory-storybook.component.ts): Built 4-chapter hardcover storybook (“The Health Story of Patient”) covering Ancestral Origins, Diagnostic Turning Point, Therapeutic Quest, and Future Vitality Horizon.
  • [Accessibility / UX] 4 Adaptive Cognitive Reading Modes: Added 1-tap reading mode switching:
    1. 📜 Classic Literary Reader: Serif typography with drop-cap chapter headers and warm paper aesthetics.
    2. ⚡ Bionic Speed Reader: Highlighting initial letters of key clinical terms for accelerated visual cognitive processing.
    3. 🧩 Dyslexic Accessible: OpenDyslexic weighted font styling with increased line height (leading-loose) and letter spacing (tracking-wide).
    4. 🎧 Audiobook Narrator: Web Speech API speech synthesis narration paired with 528 Hz / 432 Hz Solfeggio soundscape background tones.
  • [Mind-State / AI] Dedicated Mind-State Prescription Synthesizer (mood-consciousness-matrix.component.ts): Added 1-click dedicated AI suggestion cards for EEG brainwave entrainment, nootropic culinary recipes, and TCM/Ayurvedic multi-paradigm alignment.
  • [Navigation / UX] Multi-Touchpoint Patient Storybook Access: Embedded Storybook directly in Patient Education lens, Summary Overview lens, and Instant Patient Action Suite top bar.

v1.1.0-rc1 — 2026-07-21

3-Act Clinical Storybook Narrative Arc, Pixel 9 Pro Touch Snap Carousel & Instant Patient Action Suite

Added

  • [Narrative / UX] 3-Act Clinical Storybook Narrative Arc (analysis-report.component.ts & clinical-act-lens-mapper.service.ts): Re-organized analysis engine output into a theatrical 3-Act narrative structure (Act I: Inciting Incident & Triage, Act II: Diagnostic Turning Point & Probing, Act III: Therapeutic Resolution & Quest Map).
  • [Mobile / Touch] Pixel 9 Pro Touch Snap Lens Carousel (analysis-report.component.ts): Added touch-first horizontal snap strip (snap-x snap-mandatory), 32px circular scroll chevrons, dynamic pagination dot indicators (● ○ ○ ○ ○ ○ ○ ○ ○), and 1-tap mobile paradigm quick selector pills (🔵 Western, 🟢 Eastern TCM, 🟡 Ayurvedic).
  • [Interactivity / Patient] Instant Patient Action Suite (instant-patient-action-suite.component.ts): Integrated 4-7-8 bio-breathing visual pacer, 60s vagus nerve cooling countdown timer, anti-inflammatory elixir recipe builder, service pet co-regulation soundboard, and live bio-feedback health simulator into the Analysis Lens view.
  • [Patient State / Persistence] Live 3D Model Replica Switching & 1-Second Autosaving (patient-management.service.ts): Standardized 3D body viewer updates upon patient selection and implemented 1-second debounced auto-saving plus beforeunload window persistence.

v1.0.0-rc12 — 2026-07-21

7-Day Chrono Weekly Meal Planner, Geolocational Micro-Climate Relocation Engine, KSS Acronym Expansion & PhysioNet 2026 Dataset Integration

Added

  • [Nutrition / Chrono] 7-Day Chrono Weekly Meal Planner (chrono-weekly-meal-planner.component.ts): 7-day circadian calendar (Monday–Sunday) with regional ingredient sourcing filters (Pacific Northwest, Mediterranean, Asian, Nordic), prep time complexity filters (Snacks <5m, Quick <15m, Full Course 30m+), and 1-click Care Plan prescribing capabilities.
  • [Geolocational / SDOH] Geolocational Micro-Climate & Relocation Engine (geolocational-health-relocation.component.ts): Analyzes US Census ACS data, EPA Air Quality Index (AQI), Walkability Scores, and Blue Zone Longevity indices to prescribe therapeutic relocation micro-climates (Desert Hot Springs CA, San Luis Obispo CA, Sequim WA, Loma Linda CA, Nicoya Costa Rica) and geolocational hobbies (Shinrin-yoku, Geothermal Mineral Hydrotherapy, Citrus Permaculture).
  • [Health Literacy / KSS] KSS-Driven Medical Acronym Expansion Engine (acronym-expander.service.ts & acronym-expander.pipe.ts): Automatically expands 40+ clinical medical acronyms (e.g., COPD → Chronic Obstructive Pulmonary Disease (COPD)) and provides interactive <abbr> tooltips when Karolinska Sleepiness Scale (KSS) score ≥ 5 or in simplified cognitive modes.
  • [Patient Dataset / PhysioNet] Complete Roster Data Completeness & PhysioNet 2026 Scenarios (src/mock-patients/): Updated all 13 patient records with full vitals (bp, hr, temp, spO2, weight, height, vitD3, magnesium, b12, zinc), oxidative stress markers, antioxidant metrics, diagnostic scans, and dedicated PhysioNet 2026 Challenge scenarios across all 7 lenses.
  • [Export / Literacy] Cognitive Level OpenDyslexic PDF Exporting (export.service.ts & care-plan-print-preview.component.ts): Added Health Literacy Export Badges and OpenDyslexic typography CSS overrides (line-height: 1.95, letter-spacing: 0.05em) to printed PDF reports.

v1.0.0-rc10 — 2026-07-21

PhysioNet Electrophysiology Lens, 7-Sec Origami Unfolding Animation, Brand Icon Standardization & Pacific Coast Viewport

Added

  • [Clinical / Telemetry] PhysioNet 2026 Digital Signal & Electrophysiology Lens (📡 PhysioNet Waveforms): Added a 7th clinical lens in clinical-intelligence.service.ts, analysis-report.component.ts, clinical-prompts.ts, and demo-data.ts. Ingests high-frequency EDF/PhysioNet waveform metrics: QRS interval duration (92 ms), neutral ST-segment deviation (+0.04 mV), Fridericia QTc prolongation risk (418 ms), and HRV spectral power density (LF/HF ratio 1.08).
  • [UI / Animation] 7-Second Origami Unfolding & Glowing Papercraft Heart: Added a 7-second traditional origami unfolding animation sequence to secure-splash.component.ts featuring staggered paper crease rotations and a glowing papercraft heart emergence with radiant warm aura at the 4.5s mark.
  • [Design / Branding] Signature Origami Seagull Icon Standardization: Standardized the signature origami seagull logo in full brand color palette (Teal #3ebc9e, Coral #ef6658, White paper #ffffff, Amber beak #faa63b) across index.html favicons, Docs portal (DocsLayout.astro), guided walkthrough tour modal (walkthrough-tour.component.ts), and PDF stationery letterheads (export.service.ts).
  • [UI / UX] Pacific Coast 56% Sandy Beach & Breezy Sand Gusts: Re-proportioned splash dune height to 56%, bound daily SVG beach gesture guides (todayBeachItem().svgGuide) using DomSanitizer.bypassSecurityTrustHtml(), added horizontal sand particle gust animations (@keyframes breezy-sand), and mimicked local time-of-day sky gradients.
  • [UI / UX] Walkthrough Tour Real-time Window Scroll & Spotlight Tracking: Added passive scroll event listeners to window and multi-frame post-scroll re-measurements (150ms, 400ms) in walkthrough-tour.component.ts to ensure spotlight masks remain anchored accurately during smooth scroll transitions.
  • [Audio] Default Muted Audio Entrainment: Removed automatic AVS soundscape autostart triggers from splash drawing gestures to ensure audio is strictly off by default until explicitly toggled.
  • [Security / Repo] Trained Model & Physio Dataset Git Exclusions: Added PhysioNet dataset formats (*.edf, *.mat, *.dat, *.hea, *.atr, *.rec) and trained model weights (*.onnx, *.safetensors, *.pt, *.pth, *.pkl, *.joblib, *.h5, *.ckpt) to .gitignore and .gcloudignore.

v1.0.0-rc9 — 2026-07-21

3D Anatomical Search, Viewport-Contextual CMP Telemetry, Global Multilingual Research Alignment & FHIR 7 Architecture

Added

  • [3D Anatomy / UI] Anatomical Search & Auto-Camera Tracking: Top-left search bar with quick system filter pills (Head/Neuro, Organs, Limbs/Spine). Selecting search results triggers smooth focusOnPart(id) camera target interpolation onto 3D organ meshes.
  • [Clinical / Telemetry] Viewport-Contextual CMP Lab Panels: Isolated organ-specific metabolic panels (ICmpLabs: Troponin, ALT/AST, eGFR, Creatinine, Fasting Glucose) and one-tap symptom shortcuts tailored to the currently targeted organ system.
  • [Docs / Architecture] HL7 FHIR Evolution Strategy (R4 → R5 → R6 → FHIR 7): Comprehensive roadmap for event-driven telemetry (FHIR R5 SubscriptionTopic), AI inference provenance (FHIR R6 DeviceMetric), and multi-agent AI co-pilot traces with zero-copy federated graphs (FHIR 7).
  • [Internationalization] Global Clinical & Research Language Alignment: Realigned care plan exports to focus on global medical research exchanges (Spanish, German, French, Japanese, Hindi). Replaced Mandarin button and provider types across all AI engines.

v1.0.0-rc8 — 2026-07-16

Dynamic Mock Assessments & Fallback Roster Synchronization

Added

  • [Demo Mode] Dynamic Mock Clinical Assessments: Tailored mock clinical western, TCM, and Ayurvedic reports dynamically to demographics, vitals, issues, and goals.
  • [Demo Mode] Fallback Mock Patient Synchronization: Unified the frontend MOCK_PATIENTS fallback list with the backend data/patients.json database, ensuring William Henderson and all other patients load with complete clinical profiles offline or during database seeding.
  • [UI / UX] Double-Click Task Bracketing: Cyclic validation state machine (Normal -> Added -> Removed -> Normal) implemented on care plan summary nodes with immediate visual highlighting (green checkmarks for approved, red crosses for excluded).
  • [Sentinel Integration] Active Roster Outbreak Highlighting: High-priority amber outlines, custom Initials Avatar overrides, and dedicated 🔦 Sentinel tags added for outbreak/epidemiological threat patient profiles.
  • [Sentinel Integration] Split-Screen Cost-Benefit Matrix: Introduced a dynamic split-screen containment paradigm (👤 Individual Health vs 🔦 Community Containment) for Sentinel patients, allowing a clean contrast of individual treatments against quarantine and prophylaxis strategies.
  • [Demo Mode] Chat Mock Fallbacks: Local intercept of voice/text consult queries when in Demo Mode to return high-fidelity mock clinical responses and resolve API key authentication failures.
  • [Theme & UI] Theme Query Parameter: Added ?theme= URL query parameter check on app startup (e.g., ?theme=dark) to facilitate automation audits, E2E testing, and direct theme linking in src/services/theme.service.ts.
  • [CI/CD] Security Audit Artifacts: Configured the GitHub Actions workflow to export NPM audit results to a JSON file and upload them as workflow artifacts instead of letting minor warnings fail build runs.

Changed

  • [Typography] App-Wide 12px Font Normalization: Normalised all templates and styles globally, replacing all sub-12px typography overrides (text-[8px], text-[9px], text-[10px], text-[11px]) with a minimum of text-[12px] across 29 component files.
  • [UI / Print] High-Fidelity Print Exports: Enhanced print CSS (@media print) using print-color-adjust: exact !important to force the preservation of clinical branding colors, highlights, and borders.

v1.0.0-rc7 — 2026-06-28

Companion App Lint Hardening & Mocked Widget Test Suite

Fixed

  • [Linter] Unnecessary Underscores (provider_dashboard.dart): Fixed unnecessary multiple underscores (__) in separatorBuilder for ListView.separated to satisfy the unnecessary_underscores lint rule.

Added

  • [Testing] Mocked Widget Test Suite (provider_app): Replaced the boilerplate counter widget test with a fully mocked, robust integration test in widget_test.dart using package:http/testing and http.runWithClient to mock API responses and verify patient directory loading and detail screen navigation.

Changed

  • [Safety] Safety Threshold Hardening: Upgraded safety settings filters in src/server.ts, src/server/genkit.ts, and src/services/verify-ai.service.ts from BLOCK_MEDIUM_AND_ABOVE to BLOCK_LOW_AND_ABOVE across harassment, hate speech, sexual content, and dangerous content categories, enforcing the highest safety standard for clinical apps.

v1.0.0-rc6 — 2026-06-14

CodeQL Security Hardening (Full Remediation) & Rate Limiting

Fixed

  • [CodeQL] SSRF Critical × 5 (dicom.ts): Added sanitiseDicomParam() (allowlist: [a-zA-Z0-9._-]) and validateDicomUid() (digits and dots only, per DICOM standard) helpers. All five DICOM route handlers (/studies, /rendered, /store, /raw, /delete) now sanitise every user-provided query param before URL construction — no raw req.query value ever reaches fetch().
  • [CodeQL] SSRF (server.ts): Sanitised projectId + location Vertex AI URL construction with char-allowlist regex; rawModel is strictly allowlisted via normalizeAndValidateModel().
  • [CodeQL] Missing Rate Limiting × 4 (server.ts): Replaced custom in-memory rateLimiter() with express-rate-limit’s rateLimit() on all flagged file-system-accessing routes.
  • [CodeQL] Path Traversal × 2 (server.ts /docs/study): Removed custom resolve()-based path handler entirely. /docs/study is now served exclusively via express.static(studyDocsRoot) — no user-controlled value reaches any file path computation.
  • [CodeQL] Clear-Text Logging (phi_compliance_scanner.py): Discarded the tainted regex match tuple element with _ and removed it from every print() format string. Only violation type, file path, line number, and description are logged — no sensitive match data reaches any log sink.
  • [Pre-emptive] DICOM Router Rate Limiting: Applied express-rate-limit at the dicomRouter level (60 req/min per IP) covering all DICOM proxy routes.
  • [Pre-emptive] Healthcare Router Rate Limiting: Applied express-rate-limit at the healthcareRouter level (30 req/min per IP) covering all FHIR and Healthcare API proxy routes.

v1.0.0-rc5 — 2026-06-14

Documentation Sync, Build Hardening & Security Patch

Added

  • angular.json CommonJS Allowlist: Added @google-cloud/vertexai and @google-cloud/vertexai/build/src/resources/index.js to allowedCommonJsDependencies to suppress recurring build-time optimization warnings from @genkit-ai/vertexai.

Changed

  • Documentation Sync: Rewrote README.md with categorized features (Security, AI, Clinical UX, Data), updated architecture diagram to show Vertex AI Enterprise and WebSocket proxy, and corrected the pocketgall.app URL typo.
  • DESIGN.md Squadron Expansion: Added three new Gull Squadron personas — Stratosphere (Vertex AI Enterprise layer), Relay (WebSocket live proxy), and Samaritan (Good Samaritan emergency care mode).
  • angular.json Host Cleanup: Removed three stale Cloud Run hostnames (pocket-gall-444980566010, understory-315235665910, pocket-gall-315235665910) from allowedHosts.

Fixed

  • qs Security Patch: Pinned qs transitive dependency to >=6.15.2 via package.json overrides, patching GHSA-q8mj-m7cp-5q26 (DoS via qs.stringify on null entries in comma-format arrays).

v1.0.0-rc4 — 2026-06-14

Vertex AI Enterprise Migration, Secure Bidirectional Live Proxy, & CodeQL Security Hardening

Added

  • Vertex AI Enterprise Migration: Upgraded the AI intelligence layer from the developer Gemini API to regional Google Cloud Vertex AI Enterprise, implementing automatic Google Application Default Credentials (ADC) token resolution, regional endpoints, and custom safety thresholds.
  • Bidirectional WebSocket Live Proxy: Implemented a secure WebSocket proxy route (/ws/gemini-live) on the Express server featuring recursive camelCase to snake_case translations and setup model resource path rewrites to support full-duplex live audio streaming over Vertex AI.
  • Lightweight API Rate Limiting: Built a custom, in-memory IP-based rate limiter middleware (rateLimiter) to mitigate denial-of-service and resource exhaustion on file-accessing routes.

Changed

  • Improved Custom Search Engine: Updated the Google Custom/Programmable Search Engine (CSE) script config in search.html to load a new instance (648e5d0ad53ae49a6) providing wider clinical and medical school domain indexing.

Security / Fixed

  • CodeQL SSRF Remediation: Patched Server-Side Request Forgery vulnerabilities in stream/chat endpoints by adding strict model selection validation (normalizeAndValidateModel).
  • CodeQL Path Traversal Protection: Guarded the study docs static router against directory escape by using path.resolve and strict parent-directory containment verification.
  • CodeQL Clear-Text Logging Fix: Redacted matching secrets and PII values in phi_compliance_scanner.py console logs to prevent exposure in CI workflows.

v1.0.0-rc3 — 2026-06-08

Porkbun DNS Automation, Enterprise EHR Blueprints & Security Hardening

Added

  • Porkbun DNS Automation: Integrated automated Porkbun API sync helper (scripts/update-porkbun-dns.js) to handle lifecycle mapping of the live Cloud Run custom domains (pocketgull.app and subdomains).
  • Scaling & Valuation Architectural Blueprints: Added complete operational manuals and diagrams for hospital-grade deployment (docs/valuation_and_positioning.md and docs/study/src/pages/positioning.mdx), detailing BigQuery telemetry partitioning/clustering strategies, Vertex AI context caching/cost management, and OpenEMR/OpenMRS FHIR database bridging.
  • Custom JSON Security Auditing CLI: Built scripts/security-audit.mjs to automatically verify sub-dependency vulnerability status during build/CI checkpoints.

Fixed

  • Windows Unicode Pre-Commit Compatibility: Modified scripts/phi_compliance_scanner.py to suppress non-ASCII console emojis, resolving execution and file check crashes on Windows environments using default CP1252 shell encodings.
  • Doc Path Resolution: Corrected file path references in husky pre-commit check tasks (scripts/pre-commit-check.cjs).

Security

  • Sub-Project Dependency Remediation: Resolved 11 medium/high risk vulnerabilities in pocketgull_api sub-project lockfile, applying strict version overrides for uuid and protobufjs.

v1.0.0-rc2 — 2026-05-22

Live Voice Barge-In, Emergency Care Mode, Draw-to-Unlock & Philosophy Dashboards

Added

  • Client-Side Speech & Interruption Barge-in: Implemented local onspeechstart barge-in interruption tuning across the clinical dialog and main voice assistant panels, allowing instant audio muting and queue clearing when the clinician begins speaking or typing.
  • Real-Time Voice Consult: Integrated the AdkLiveService directly into the focused recommendations/claims dialog (NodeAgentDialogComponent) with amplitude-responsive recording visualizers, local Speech-to-Text feedback, and graceful lifecycle teardowns.
  • Multi-Paradigm Philosophy Dashboards: Added full system support for selecting Western, Eastern, Ayurvedic, or “Grow Thy Self” longevity medicine paradigms. Includes automated report regeneration and a secular translation engine mapping 13 world philosophies into psychological and physiological domains.
  • Good Samaritan Emergency Care: Engineered an offline emergency override mode featuring a 110 BPM chest-compression metronome, basic life support (BLS) safety-gated Gemini Nano local routing (window.ai), local FHIR-compliant EMT QR code serialization (lean-qr), and global telemetry (OTel) suppression.
  • Draw-to-Unlock Secure Gateway: Replaced the legacy numeric PIN code screen with a premium Canvas drawing pad verifying a smiley face gesture pattern, with multi-stroke verification windows and an invisible E2E test bypass hook.
  • Shift-Left Pre-Commit Hook: Introduced a husky pre-commit pipeline that checks TypeScript types, runs Vitest unit tests, scans markdown image file references, and blocks staged commits containing credential or API key leaks.
  • Multi-Vendor GPU Telemetry: Implemented Windows CIM/WMI adapters querying AMD/Intel/NVIDIA graphics, macOS system profiles, unified memory estimation, and dynamic WebGPU routing recommendations.

v1.0.0-rc1 — 2026-05-19

Security Hardening, PQC Cryptography & Enterprise Connectors

Added

  • Security Hardening & MFA Gateways: Added robust Firebase Google Login flow configurations including domain whitelists and multi-factor authentication (MFA) parameters.
  • Tink Envelope Cryptography & PQC: Integrated Google Tink AEAD cryptographic envelopment for local patient records and added Quantum-Safe Cryptography Kyber/Dilithium transport protocol fallbacks for HIPAA transit compliance.
  • WebMCP Schema Mapping: Registered WebMCP (Model Context Protocol) standards schemas to allow seamless integrations of external clinical knowledge databases.
  • 3D Anatomical Extensions: Enabled pluggable mesh loaders (GLTF, USDZ, OBJ) on the Three.js viewport for customized skeletal modeling.
  • Multi-Cloud Enterprise Connectors: Documented and verified identity sync wrappers for Windows Active Directory (AD FS) and envelope encryption bridges for AWS KMS.
  • Sentinel Gamification & Cognitive Triage: Integrated a clinician alertness and fatigue-tracking dashboard to monitor practitioner cognitive load in high-stress triage environments.

v0.10.0 — 2026-05-20

Secure Delegation Codes, Gesture Unlock & Expanded Animal Protocols

Added

  • Secure Delegation Access Codes: Replaced the public patient dropdown menu in the companion patient_app with a secure access code text field, preventing HIPAA/privacy exposure of the patient directory.
  • Practitioner Delegation Display: Added a dedicated DELEGATION CODE label on the provider’s patient_detail_screen so practitioners can securely communicate delegation credentials to patients.
  • Gesture-Based Clinical Unlock: Designed and implemented a canvas-based draw-unlock mechanism using a gesture recognizer (smiley face template matching) to replace legacy PIN code fields with an elegant gesture gateway on the Secure Splash screen.
  • Expanded Animal Comfort Protocols: Integrated additional high-fidelity auditory protocols for Orca Whales/Dolphins, Parrots/Crows, and Peregrine Falcons, along with dedicated custom SVG visual icons, custom binaural pulse sweeps, and responsive clinical warnings.

Fixed

  • CommonJS Build Warnings: Configured angular.json to allow CommonJS sub-dependencies of @google-cloud/bigquery (@google-cloud/common, @google-cloud/paginator, @google-cloud/promisify, @google-cloud/precise-date, big.js, extend, stream-events, and duplexify), eliminating build-time optimization warnings.
  • Contrast Accessibility Specificity: Strengthened light-mode text readability and color contrast metrics, removed visual text shadows, and stabilized post-animation text styling to fully comply with WCAG AA guidelines.
  • CSS String Escape Warning: Corrected unescaped slash characters within CSS selectors inside the component template string to resolve the Angular compiler syntax warnings.

v0.9.0 — 2026-05-18

Multilingual Care Plans & Orthomolecular Profiling

Added

  • Multilingual & Pediatric Care Plans: Expanded the translateReadingLevel infrastructure across all providers to support Spanish, German, French, Mandarin, Dyslexia, and Pediatric formats.
  • Security & Red Teaming Framework: Implemented SECURITY.md and a Vitest automated red-teaming suite (tests/safety.spec.ts) to actively verify Gemini BLOCK_MEDIUM_AND_ABOVE safety boundaries.
  • Transparency Metadata: Added humans.txt, robots.txt, llms.txt, and sources.txt to the public directory for AI indexing and human attribution.
  • Cloud Build Integration: Created cloudbuild.yaml to automate Docker builds and Google Cloud Run deployment pipelines.
  • Advanced Clinical Mock Data: Expanded MOCK_PATIENTS with updated 2026 timestamps, Orthomolecular Biomarkers, and dedicated Pediatric and Multilingual test profiles.
  • Animal Comfort Protocols: Engineered a Web Audio API synthesizer (PetAuditoryService) within the Care Plan Export module to generate species-specific soothing frequencies (Feline Purr at 25Hz, Canine Heartbeat at 60 BPM) for pets left home during hospitalizations.

v0.8.0 — 2026-05-18

Hemi-Sync Audio Engine, Athletic AVS & Real-Time DSP Pipeline

Added

  • Multi-Layer Hemi-Sync Audio Engine: Upgraded GlobalAvsService to a high-fidelity 4-oscillator engine supporting phase-locked frequency entrainment and a clinical-grade Pink Noise synthesizer.
  • Athletic Enhancement AVS: Implemented AthleticProtocolService and UI toggles to provide specialized AVS protocols (Priming, Flow, Recovery, Phase-Shift) for athletic performance and recovery.
  • Real-Time DSP Pipeline: Fleshed out the FastAPI sidecar to process real-time HDF5 ECG streams using SciPy to extract HRV (RMSSD) and respiratory frequency metrics.
  • Philips Hue Local Relay Proxy: Added a local hue-relay.js Node proxy to resolve HTTPS mixed-content restrictions when the PWA communicates with local Philips Hue hubs.

v0.7.0 — 2026-05-17

Circadian UI, KSS Gateway, DOC Protocols & Philips Hue Sync

Added

  • Circadian UI & AVS Coregulation: Replaced static UI themes with a continuous, hardware-accelerated circadian CSS variable system (CircadianSleepinessService) that smoothly transitions ambient UI colors based on the time of day.
  • KSS Readiness Gateway: Integrated the 9-point Karolinska Sleepiness Scale (KSS) into the secure splash screen, allowing manual readiness overrides of the circadian theme.
  • DOC Stimulation Protocols: Implemented DocProtocolService to provide structured auditory and vibroacoustic stimulation guidelines for Disorders of Consciousness (Coma, VS/UWS, MCS).
  • PWA Gemini Nano Integration: Upgraded HybridProvider to route chat and conversational queries to Chrome’s on-device window.ai Nano model when offline or for token-saving local execution.
  • Philips Hue & Ambient Lighting Sync: Created AmbientLightingService to mathematically sync the application’s real-time circadian HSL themes with physical Philips Hue smart lights via the local network.

v0.6.0 — 2026-05-17

Monorepo Env Fallback & Three.js / OHIF Upgrades

Added

  • Monorepo Env Fallback: Server-side fetchGeminiApiKey() now searches pocketgull_api/.env.local and pocketgull_api/.env as fallback sources, eliminating the need for a separate .env.local in the Angular root during local development.

Changed

  • THREE.Clock → THREE.Timer: Migrated Body3DViewerComponent from deprecated THREE.Clock to THREE.Timer (timer.update() + timer.getElapsed()), resolving the Three.js r183 deprecation warning.
  • OHIF Viewer: Replaced non-functional OHIF iframe (blocked by X-Frame-Options: DENY on viewer.ohif.org) with a polished launch card that opens OHIF in a new tab, preserving the StudyInstanceUIDs deep-link query param.
  • Production Source Maps: Set sourceMap: false in the production Angular build config to eliminate build-time warnings caused by malformed control characters in @angular/platform-server’s init.mjs.map (upstream Angular packaging bug).

Fixed

  • Schema Validation: Removed unsupported server property from angular.json sourceMap object, resolving SchemaValidationException on npm run build.
  • Debug Log Noise: Removed verbose console.log pointerdown/pointerup events from Body3DViewerComponent interaction handlers.

v0.5.0 — 2026-03-16

Origami Seagull Branding, Domain Launch & Print Preview Refactor

Added

  • Branding Update: Replaced application logos with the new origami seagull design in the header and splash screen.
  • Domain Configuration: Mapped custom domains pocketgull.app and www.pocketgull.app to the live Cloud Run service.
  • COCOMO II Estimation: Updated the effort estimation script to calculate KSLOC dynamically and added an estimate-effort npm script.
  • Lighthouse Audit Script: Added an npm script to easily run Lighthouse accessibility and performance audits.

Changed

  • Print Preview Refactoring: Implemented a modular print strategy allowing user-selected inclusions (analysis, original text), improved translation error handling, and updated the UI controls for cognitive levels.
  • Codebase Cleanup: Removed remaining references to legacy internal terms (“Cerebella” and “Orthomolecular”).

Fixed

  • Translation Reversion: Fixed a bug where textual translations were reverting unexpectedly in the print preview modal.
  • Security Headers: Improved server security headers by explicitly setting Strict-Transport-Security, Cross-Origin-Opener-Policy, and X-Frame-Options.

v0.4.0 — 2026-03-12

Genkit Integration, Core Medical Services & SSR Architecture

Added

  • Genkit Integration: Introduced Genkit capabilities and mock data generation for enhanced clinical intelligence features.
  • Core Medical Services: Implemented core services for Pocket Gull, including patient state management and clinical intelligence.
  • SSR Deployment Architecture: Established Angular SSR server with PubMed API proxies, Gemini API key management, and Docker/GCP Cloud Run deployment configurations.
  • Lighthouse Performance Auditing: Integrated automated performance benchmarking and reporting.
  • Research Tools: Registered research and bookmark tools.
  • Expanded Patient Data: Added a new global sentinel patient to the default dataset.
  • AI Reading Level Translation: Introduced medical summary translation controls for simplified and dyslexia-friendly text.
  • Origami Splash Screen: Added a new animated Pocket splash screen.
  • LLM Discoverability File: Added llms.txt to help AI agents consume project documentation.
  • Pocket Gull UI Components: Created new core shared components (Badge, Button, Card, Input) aligned with the new branding.
  • New Medical Components: Added Medical3DViewerComponent and PatientScansComponent to handle advanced clinical imagery.

Changed

  • UI & Layout Refinements: Expanded assessment panel width and enforced pocketgull.app domain redirection.
  • Rebranding: Officially renamed the application from Understory to Pocket Gull.
  • Mobile Responsiveness: Upgraded to dvh (dynamic viewport height) units for robust mobile layout calculation and refined rich media card parsing.
  • Voice Assistant Redesign: Redesigned the voice assistant transcript display with new model message bubbles and rich media card styling.
  • Removed Legacy Features: Removed old “philosophical export modes”.
  • Domain Redirection: Implemented legacy domain redirection.

Fixed

  • WebGL SSR Crash: Safeguarded Body3DViewerComponent from crashing during Server-Side Rendering (SSR) by verifying window execution context before WebGL initialization.
  • 2D SVG Interactivity: Recovered 2D SVG layer interactivity and purged unused typography footprint.
  • 3D Viewer Anatomy Views: Restored missing skin, muscle, skeleton, and mind multi-layer anatomy views.
  • Dark Mode Persistence: Restored SSR ThemeService for reliable dark mode state management.
  • Layout Rendering: Resolved vertical frame split issues.
  • Markdown Rendering: Fixed mermaid node label rendering issues for GitHub by quoting slashes correctly.
  • Live Agent Bug: Fixed bug to auto-send live agent prompt.

v0.3.0 — 2026-03-03

Context-Aware AI Chat, 3D Medical Viewer & Scans Library

Added

  • Context-Aware AI Chat: Integrated recent node-specific discussions directly into the AI’s conversational memory, enhancing the relevance of “Live Consult” responses.
  • Inline Node Agent Queries: Added ability to seamlessly launch AI inquiries directly from individual paragraphs and list items within the analysis report.
  • 3D Medical Interactive Viewer: Integrated a robust ThreeJS-powered 3D model viewer for enhanced anatomical visualization.
  • Scans & Diagnostics Library: Added a visual gallery component to the patient history for managing and displaying diagnostic imagery like MRIs and X-Rays.
  • Evidence Focus Iconography: Introduced a custom “Interrobang” clinical icon for the Evidence Focus feature, replacing generic indicators.

Changed

  • Application Rename: Renamed the application from Understory to Pocket Gull across the entire codebase.
  • Node Toolbar Accessibility: Increased touch target padding and visual persistence delays on the summary node toolbar to dramatically improve mobile and touch interactions.

v0.2.0 — 2026-02-28

SSR Architecture, Smartwatch Optimization & Printable Stationery

Added

  • Offline Printable Stationery: CSS Grid-optimized, multi-page physical printouts featuring Halftone body maps for visual pain hotspot diagnosis.
  • Smartwatch Optimization: Responsive UI scaling down to extremely constrained viewports (e.g., Pixel Watch 2 at 286px width).
  • Box Breathing UX: 16-second box breathing visual animations integrated into primary intake text areas to promote practitioner mindfulness.

Changed

  • Server-Side Rendering (SSR): Transitioned architecture to Angular SSR for performance optimization.
  • Mobile Navigation: Implemented tabbed view-switching (Tasks / Analysis) optimized for constrained mobile environments.

Fixed

  • SSR Build Stability: Resolved “no exports” optimization bailouts caused by unresolved TypeScript properties in PatientStateService.
  • Mobile Scrolling: Fixed mobile page scrolling flow by removing forced height constraints.
  • UI Clipping: Fixed horizontal/vertical clipping of action buttons and contents in the analysis report.
  • Type Safety: Ensured strict type checking and proper exports for patient history and summary models across services.

v0.1.0 — 2026-02-22

Initial Release · Gemini Live Agent Challenge

Added

  • Care Plan Recommendation Engine: A structured AI analysis module categorizing recommendations into Overview, Interventions, Monitoring, and Education.
  • Task Bracketing System: Interactive UI allowing clinicians to Accept, Reject, or Modify AI-generated interventions before finalizing.
  • Live Voice Consult (Aura): An integrated voice assistant agent for real-time collaboration on patient strategies. Includes a dedicated chat interface with speech-to-text integration.
  • 3D Body Viewer Integration: Visual anatomical mapping tools to correlate physical symptoms with digital chart records.
  • Automated Clinical Task Extraction: Parses unstructured clinical notes into actionable checklist items.
  • Biometric Telemetry Visualization: Chart.js integration providing retrospective trend analysis for patient blood pressure and pain metrics.
  • Preview & Print Final Care Plan: A dedicated modal to review, edit, and print the finalized patient care strategy before charting.

Changed

  • Re-architected core layouts for a responsive 3-column split view (Medical Chart, Intake Flow, and Analysis/Voice Assistant).
  • Optimized client-side payload delivery via Express compression (Gzip/Brotli) and structural font preconnections.
  • Upgraded UI interactions with modern Tailwind aesthetics, smooth transitions, and dynamic hover states across all components.

Fixed

  • Addressed infinite reactivity loops within the Intake Form component upon body part selection.
  • Corrected Voice Assistant triggering bugs preventing the component from rendering on mobile and desktop viewports.
  • Handled improper API Key rejection formatting from the Gemini API service, surfacing graceful UI alerts instead of silent failures.

Infrastructure

  • Express.js backend on Google Cloud Run with SSR + hydration.
  • Automated deployment via scripts/deploy.sh.
  • Lighthouse score: 100/100 (Performance, Accessibility, Best Practices, SEO).

Documentation

  • Astro-powered docs site with 8 pages.
  • AI-powered DocNode evidence drill-down (Gemini API).
  • Version selector and prev/next navigation.