Features

Every feature in Pocket Gull serves a clinical purpose. Nothing decorative, nothing superfluous.

AI & Voice

Live AI Consult & Multi-Agent Orchestration

Powered by `@google/adk</DocNode> and the <DocNode term="Web Speech API" category="W3C · Web Platform" hint="W3C specification for speech recognition and synthesis in browsers. Chrome implementation by Google." link="https://developer.mozilla.org/en-US/docs/Web/API/Web_Speech_API" linkLabel="MDN Reference →" icon="https://developer.mozilla.org/favicon-48x48.png">Web Speech API</DocNode> via <DocNode term="Vertex AI Enterprise" category="Google Cloud" hint="Google Cloud's enterprise-grade AI platform. Provides regional endpoints, IAM-based authentication (ADC), custom safety thresholds, and SLA-backed infrastructure." link="https://cloud.google.com/vertex-ai" linkLabel="Vertex AI Docs →" icon="https://www.gstatic.com/devrel-devsite/prod/v0e0f589edd85502a40d78d7d0825db8ea5ef3b99ab4070381571c97ab7df9861/cloud/images/favicons/onecloud/favicon.ico">Vertex AI Enterprise</DocNode>. Specialized <DocNode term="LlmAgent" category="Google · Agent Development Kit" hint="Core agent class from @google/adk. Configured with a Gemini model, system prompt, and optional tools. Each focuses on a diagnostic lens." link="https://google.github.io/adk-docs/agents/" linkLabel="Agent Reference →" icon="https://ai.google.dev/favicon.ico">LlmAgent`Google · Agent Development KitOpen-source TypeScript/Python framework for building multi-agent AI systems. Supports LlmAgent, SequentialAgent, and LoopAgent patterns with tool management.ADK Docs →Click to explore with AI experts — each focused on a diagnostic lens (Overview, Interventions, Monitoring, Education) — synthesize clinical data into actionable insights through an interruptible, natural conversational UI.

The system maintains context-aware memory of recently discussed report nodes, enabling inline follow-up queries without re-stating context.

Care Plan Recommendation Engine

A professional clinical analysis engine that synthesizes structured strategies for patient care. Output is organized by diagnostic lens, and each report node supports inline agent queries — click any recommendation to ask the AI directly about it.

Patient Health Trajectory Storybook & Adaptive Cognitive Reading Styles

An interactive 4-chapter hardcover clinical biography (“The Health Story of Patient”) that transforms complex clinical records into a structured narrative arc:

Chapter I: The Ancestral Origin & Initial Baseline: DNA methylation roots (MTHFR/SOD2), baseline hemodynamic posturing, and initial triggers.
Chapter II: The Diagnostic Turning Point: Multi-paradigm lab discoveries, cost-benefit trade-offs, and PhysioNet electrophysiology waveforms.
Chapter III: The Therapeutic Quest & Daily Care: Protocol tiers, 4-7-8 vagal bio-breathing, 7-day chrono-nutrition recipes, and relocation micro-climates.
Chapter IV: The Future Vitality Horizon: Projected 90-day vitality score (91%), milestone retest schedules, and ongoing recovery goals.

Adaptive Cognitive Reading Modes:

📜 Classic Literary Reader: High-contrast serif typography with drop-cap chapter headers and warm paper aesthetics.
⚡ Bionic Speed Reader: Highlighting initial letters of key clinical terms for accelerated visual cognitive processing.
🧩 Dyslexic Accessible: OpenDyslexic weighted font styling with increased line height (leading-loose) and letter spacing (tracking-wide).
🎧 Audiobook Narrator: Web Speech API audio narration paired with 528 Hz / 432 Hz Solfeggio soundscape background tones.

Orthomolecular Profiling & Biomarker Matrix

Automatically extracts and visualizes biochemical markers (e.g., Magnesium, B12, Homocysteine) from the AI-generated functional protocols. The glassmorphic dashboard uses pulsed indicators and semantic color-coding to provide an instant orthomolecular status read.

3-Act Clinical Storybook Narrative Arc

Organizes complex clinical analysis into a theatrical, narrative-driven 3-Act structure:

Act I: The Inciting Incident & Patient Triage: Case presentation, physiological triggers, and initial triage posture.
Act II: The Diagnostic Turning Point & Probing Matrix: Multi-paradigm lab discoveries, cost-benefit trade-offs, and PhysioNet electrophysiology telemetry.
Act III: The Therapeutic Resolution & Quest Map: 3-tiered protocol execution cards, anti-inflammatory recipe elixirs, and time-indexed milestone quest maps (Day 1 → Day 7 → Day 30 → Day 90).

A touch-first mobile lens navigation carousel optimized for smartphone viewports (412px width):

Touch Snap Strip (snap-x snap-mandatory scroll-smooth): Enables fluid horizontal swiping across 9 clinical lenses with 48px minimum touch targets.
Tactile Scroll Chevrons (‹ & ›): 1-tap circular scroll controls for effortless navigation.
Pagination Dot Indicators (● ○ ○ ○ ○ ○ ○ ○ ○): Real-time position tracking with 1-tap lens jumping.
Mobile Paradigm Switcher Pills: Instant 1-tap switching between Western Allopathic (🔵), Eastern TCM (🟢), and Ayurvedic Medicine (🟡).

PhysioNet 2026 Digital Signal & Electrophysiology Lens (`📡 PhysioNet Waveforms`)

High-frequency digital signal & electrophysiology lens ingesting EDF/PhysioNet waveform metrics: QRS interval duration (ms), neutral ST-segment elevation/depression (+0.04 mV), Fridericia QTc prolongation risk (418 ms), and Heart Rate Variability (HRV) spectral power density (LF/HF ratio 1.08, SDNN 58 ms).

Multimodal Clinical & Life Sovereignty Assessment Suite (10 Standardized Instruments)

Pocket Gull features an integrated 10-instrument diagnostic & life sovereignty inventory suite (ClinicalAssessmentsSuiteComponent), combining gold-standard Western validated clinical instruments, ICD-10/Z-code SDOH questionnaires, Eastern pattern diagnostics, and epigenetic flourishing assessments:

PHQ-9 (Patient Health Questionnaire 9): 9-item depression severity scale with score-indexed clinical recommendations (Minimal 0–4, Mild 5–9, Moderate 10–14, Moderately Severe 15–19, Severe 20–27).
GAD-7 (Generalized Anxiety Disorder 7): 7-item anxiety severity scale tied to 0.1 Hz vagal resonance biofeedback protocols (Minimal 0–4, Mild 5–9, Moderate 10–14, Severe 15–21).
ISI (Insomnia Severity Index): 7-item sleep disturbance scale recommending CBT-I sleep restriction & Solfeggio soundscape protocols (No Insomnia 0–7, Subthreshold 8–14, Moderate 15–21, Severe 22–28).
C-SSRS (Columbia Suicide Severity Rating Scale — Screen): 6-question suicide risk screener with automatic HIGH RISK Sentinel Safety Alerts triggering 988 Crisis Lifeline routing.
ROS-14 (14-System Review of Systems Intake): Comprehensive 14-organ-system intake screener logging constitutional, cardiovascular, GI, neuro, psych, and immunological symptom burden.
PHQ-15 (Somatic Symptom Scale): 15-item physical symptom distress inventory assessing autonomic dysregulation and somatoform overlap.
PRAPARE (SDOH Protocol for Responding to & Assessing Patient Assets, Risks, & Experiences): Social Determinants of Health questionnaire automatically exporting FHIR ICD-10 Z-codes (Z59.8 Unstable Housing, Z59.41 Food Insecurity, Z59.82 Transportation, Z59.6 Financial Strain, Z60.2 Social Isolation).
AYURVEDA (Prakriti & Vikriti Tridosha Inventory): 6-vector Samskrita dosha questionnaire calculating Vata, Pitta, and Kapha balances (Samagni, Vishamagni, Mandagni, Tikshnagni).
TCM (Traditional Chinese Medicine Shi Wen 10 Questions): Classical 6-vector questionnaire diagnosing Ba Gang organ patterns (Qi, Blood, Yin, Yang, Cold, Heat).
GROW_THYSELF (Life Sovereignty & Epigenetic Flourishing Inventory): 5-domain life index evaluating Purpose/Ikigai, Somatic Sovereignty, Epigenetic Gut Vitality, Relational Depth, and Cognitive Agency.

Colleague Collaboration Room (TaskFlow)

A real-time multiplayer workspace integrated directly into the patient’s view. Clinicians can share patient states, dictate clinical notes, and chat collaboratively without leaving the active diagnostic session.

Hands-Free Voice Dictation & Controls

Speak the wake word “Gull” followed by actions (e.g., “Gull, highlight head”, “Gull, sync data”) during active dictation. The application intelligently intercepts these commands without modifying the transcript, mapping them directly to UI actions. Clinicians can also use the integrated dictation modal to add tasks or chat messages completely hands-free.

Good Samaritan Emergency Care & Relevancy Architecture

An offline emergency override mode engineered to maximize Information Relevancy when seconds count:

Cognitive Noise Suppression (95% UI Reduction): Completely strips away non-essential UI (historical labs, herbal formulas, multi-tab billing) to present a single, high-contrast emergency card.
Imperative Resuscitation Directives: Replaces complex medical jargon with 5-word physical action imperatives (“PUSH HARD & FAST AT CENTER OF CHEST”, “TILT HEAD BACK, LIFT CHIN”).
Visual & Haptic 110 BPM CPR Metronome: Flashes high-visibility rhythmic cues matching AHA Basic Life Support (BLS) compression rate guidelines.
On-Device Zero-Latency AI (window.ai / Gemini Nano): Operates 100% offline with full OpenTelemetry (OTel) network suppression, guaranteeing zero token latency during cellular blackouts.
EMT Hand-off QR Code Serialization (lean-qr): Encodes emergency vitals, resuscitation timestamps, critical allergies, and anticoagulant warnings into an instant-scannable FHIR R4HL7 InternationalFast Healthcare Interoperability Resources — the current standard for electronic health data exchange.HL7 FHIR R4 →Click to explore with AI Emergency Bundle.

Client-Side Speech Barge-In

Local onspeechstart interruption tuning across all clinical dialog and voice assistant panels. When the clinician begins speaking or typing, audio playback is immediately muted and the response queue is cleared — eliminating the need to wait for the AI to finish speaking before asking a follow-up question.

Cognition & Multilingual Care Plans

Seamlessly translate Care Plans into dyslexia-friendly or pediatric formats, or professionally translate them into Spanish, German, French, Japanese, or Hindi (aligned with global medical research exchange). Outputted to PDF using jsPDFJames Hall · ParallaxClient-side PDF generation library for JavaScript. Created by James Hall. Generates printable clinical stationery and accessible export formats.GitHub →Click to explore with AI with refined Dieter Rams “carousel informatics” typography. Designed for patient-facing communication where reading accessibility and cultural localization is critical.

Visualization

3D Medical Imagery

Precise anatomical selection using a Three.jsRicardo Cabello (mrdoob)JavaScript 3D library built on WebGL. Created by Ricardo Cabello. v0.183 powers the procedural skeletal/surface anatomy with severity particles.threejs.org →Click to explore with AI-powered skeletal and surface model, including detailed procedural spine geometry. Dynamic particle systems highlight diagnostic severity in real-time, giving clinicians an immediate visual read on patient condition.

Scans & Diagnostics Library

An integrated visual gallery within the patient profile for organizing and analyzing medical imagery (MRI, X-Rays). Includes dynamic Wikimedia Commons linking for reference anatomy.

Printable Clinical Stationery

CSS Grid-optimized, multi-page physical printouts featuring Halftone body maps for visual pain hotspot diagnosis. User-selectable toggles control which sections appear: clinical summaries, history, or full records.

Longitudinal Vitals Timelines

Embedded directly within the AI Assessment panel, historical patient vitals (Weight, Systolic BP, Diastolic BP) are dynamically graphed over time using Chart.jsChart.js contributorsSimple yet flexible JavaScript charting libraries for designers & developers.Chart.js Docs →Click to explore with AI. This provides practitioners with immediate longitudinal context without navigating away from the active Care Plan.

Method of Loci (Clinical Memory Palace)

An interactive, 3D-assisted clinical learning tool anchored to the spatial Method of Loci mnemonic framework. Integrated directly within the Patient Analysis Report, this interface allows clinicians to map complex treatment paths, diagnostic criteria, and patient symptoms to interactive visual “loci” nodes in a 3D space, facilitating rapid memory recall and reducing cognitive fatigue during patient consults.

Functional & Mind-State Protocols

Neuro-Consciousness & Mood Optimization Matrix

Targeted mind-state calibration engine organizing interventions into 5 states of consciousness:

⚡ Hyper-Focus & Flow (40 Hz Gamma): Cholinergic & Dopaminergic nootropics, Prefrontal Gamma coherence, L-Theanine & Dark Cacao.
🧘 Meditative Calm (10 Hz Alpha): GABAergic adaptogens, HPA axis cortisol blunting, 0.1 Hz vagal resonant breathing, Ashwagandha KSM-66.
🌙 Deep Rest & Sleep (2 Hz Delta): Glymphatic metabolic waste clearance, Melatonin & Apigenin tart cherry compote, 4 BPM delta entrainment.
🎨 Creative Reverie (6 Hz Theta): Hippocampal-cortical associative crosstalk, Gotu Kola & Lion’s Mane Hericenones brew, 6 Hz Theta entrainment.
🛡️ Anxiolytic Grounding (8 Hz Low Alpha): Amygdala hyper-reactivity buffering, TCM Heart Shen anchoring, Wild Salmon & Reishi Lingzhi soup.

Single-click state prescriptions synchronize AVS brainwave frequencies, vagal breathing cadences, botanical micro-doses, and Gemini bi-directional voice consultation modes.

Care Plan Print Studio & Document Carousel

Replaces raw code dumps with an inline note editor and an interactive 4-page document page thumbnail carousel. Supports section toggle switches (Vitals, Side-by-Side Comparison, AVS Protocols, Chrono-Nutrition, GCN Genomics) and renders a 3-column side-by-side comparative table (🔵 Western Allopathic vs 🟢 Eastern TCM vs 🟡 Ayurvedic Medicine) in printed PDFs.

Encodes patient clinical parameters into a high-contrast QR Code matrix for mobile camera scanning. Features an interactive smartphone mockup with 1-tap meal prescriptions for on-the-fly patient exploration.

Emergency Bypass Rapid Nutritional Triage Telemetry

Real-time osmotic hydration and botanical triage recommendations calculated from vitals readouts (BP ≥ 130/80, HR ≥ 85, SpO2 < 95%), active conditions, and live GPS location telemetry (e.g. Oregon Pacific Coast Buoy 46050) with 1-click triage logging.

Living Apple Lifecycle & Genealogical Root Tree Engine

An interactive visual clinical metaphor rendering patient health as a living procedural apple tree on the Summary Overview screen:

Genealogical Root Tapestry: Deep underground taproots branching into maternal and paternal inherited DNA lineages (🧬 MTHFR C677T, 🧬 ApoE4 Variant, 🧬 Ancestral SOD2 Antioxidant Protection).
5-Stage Apple Lifecycle:
1. 🌸 Blossom Bud: Early clinical target identification.
2. 🍏 Low-Hanging Green Apple: High-feasibility, quick-win intervention (sized larger with ⚡ Quick Win badge on lower branches).
3. 🍎 Crisp Red Apple: Ripe clinical goal ($61% - 99%$).
4. 🧺 Fallen Apple: Goal achieved ($100%$), drops smoothly to the orchard earth floor.
5. 🌿 Sprouted Generational Sapling: Decomposes into rich soil humus and sprouts a mini sapling representing inherited generational health habits!

Lens Innovation Shield & Translational Insight Sparks

A dynamic clinical protection and hypothesis generator dynamically tailored to the currently active clinical lens:

Lens-Tailored Protection Banners: Dynamically renders active clinical shields (Karolinska Cognitive Shield, Autonomic Trauma Safety Shield, Dietary Allergy Shield, UK RIO PubMed Integrity Shield).
Translational Insight Sparks: Interactive drill-down directory proposing cutting-edge research hypotheses (e.g., 0.1 Hz Resonant Breathing & Leukocyte Telomere Horvath Clock Epigenetics, Chrono-Nutrition & GLUT4 Clearance, Anthocyanin Glymphatic Amyloid Clearance).
1-Click PubMed Launch: Direct query generation opening PubMed literature searches for selected insight sparks.

Data & Export

FHIR-Standard Data Portability

Real-time persistence with visual “Saving…” / “Saved ✔” indicators. Patient data is exported via Unicode-safe Base64 encoded FHIR BundlesHL7 InternationalFast Healthcare Interoperability Resources Release 4 — the international standard for electronic health data exchange. Bundles atomically group Patient, Condition, and Observation resources.HL7 FHIR R4 →Click to explore with AI, ensuring interoperability with compliant healthcare systems.

Patient Management System

Full CRUD capabilities for patient records, including historical visit review, permanent record removal, and multi-patient switching via a dropdown selector.

Local-First PWA Architecture

Pocket Gull operates natively as a Progressive Web App (PWA). Under poor or completely offline connectivity, the system automatically degrades gracefully — persisting data flawlessly via localStorage and preserving access to historical records, while providing clear status indicators for temporarily unavailable AI cloud features.

FHIR Import Service

Ingest external healthcare payloads — including Epic/MyChart “Lucy” format — mapping DiagnosticReport, Observation, and Condition FHIR resources into Pocket Gull’s native data models.

UX & Accessibility

Minimalist Dieter Rams Design

A premium, minimalist UI prioritizing clarity, neutrality, and functional excellence. Seamless mobile responsive layouts using 100dvh. Dark-mode agent conversations provide comfortable extended-use scenarios.

7-Second Origami Unfolding & Glowing Papercraft Heart

A buttery 7-second traditional origami unfolding animation sequence for the splash mascot featuring step-by-step crease rotations (tail, wings, head) culminating in a glowing 3D papercraft heart emergence at 4.5s.

Pacific Coast 56% Sandy Beach Viewport & Breezy Sand Gusts

First-person Pacific Coast atmospheric landscape set to 56% dune height with dynamic daily SVG gesture drawing guides, horizontal sand particle gusts (@keyframes breezy-sand), and time-of-day sky color matching.

Smartwatch & Mobile Optimization

Responsive Two-Column Grid UI scaling down to extremely constrained viewports — as small as 286px width (Pixel Watch 2) — for ultra-portable clinical referencing.

Box Breathing UX

Focused 16-second box breathing visual animations integrated into primary intake text areas. Promotes practitioner mindfulness during high-stress clinical encounters.

Interactive Task Bracketing

Rapidly mark up generated care plans using a double-click state machine: Normal → Added → Removed. This is the core human-in-the-loop control mechanism — no AI recommendation proceeds without clinician vetting.

Evidence-Focus Iconography

Custom medical iconography enhances the interactive Task Bracketing and inline chat systems, providing immediate visual context for clinical categories.

Smiley Gesture Authentication & WebAuthn Safeguards

A secure, intuitive access control screen replacing legacy numeric PIN entries. Clinicians draw a “smiley face” gesture on an interactive Canvas interface to unlock the workspace. To maintain multi-platform compatibility, the system features device-supported biometric checks, rendering a WebAuthn biometric unlock option only when the client device supports hardware-level biometric sensors.

AVS (Acoustic/Visual/Sensory) Therapy & Circadian UI

An integrated therapeutic visual entrainment framework designed for clinician grounding and patient stabilization. Incorporates rhythmic box breathing guides and ambient color frequency modulations designed to support circadian entrainment. This feature is integrated natively into the interactive system walkthroughs and user onboarding flows.

Comprehensive Tour Guide

An interactive step-by-step onboarding walkthrough designed for new users. Integrates dynamic element spotlighting and mask overlays to guide clinicians through core capabilities. The tour covers active roster Sentinel alerts, double-click task validation bracketing, and features transition triggers that automatically unfold and activate the Voice Assistant panel when reached.

100/100 Lighthouse & Agentic Accessibility Compliance

Engineered to meet the highest performance and compliance standards, achieving a perfect 100/100 score across all Lighthouse audit categories (Accessibility, Best Practices, SEO, and Agentic Browsing). Optimizations include WCAG AA-compliant color-contrast pairings (removing low-contrast transparencies), screen-reader visible text aria-label alignment, descriptive anchor indexing, and full llms-txt agentic crawler discoverability support.

Research Integration

PubMed E-utilities

Direct integration with NCBI PubMedNIH · National Library of MedicineThe world's largest biomedical literature database. E-utilities provide programmatic access for querying abstracts and metadata.E-utilities Docs →Click to explore with AI for querying peer-reviewed medical literature and abstracts. XML responses are parsed server-side and returned as structured JSON.

Google Programmable Search Engine

Surfaces relevant differential diagnostic information and treatment pathways from indexed medical domains via Google CSEGoogleGoogle Programmable Search Engine — a customizable search engine for specific domains. Renders results in a sandboxed Research Frame.CSE Console →Click to explore with AI. Rendered in a dedicated Research Frame within the application.

All queries sent to external research sources are anonymized and stripped of protected health information (PHI) prior to transmission.

Security & Compliance

Vertex AI Enterprise Migration

The AI intelligence layer runs on regional Google Cloud Vertex AI EnterpriseGoogle CloudGoogle Cloud's enterprise-grade AI platform with IAM/ADC authentication, regional endpoints, custom safety thresholds, and SLA guarantees.Vertex AI Docs →Click to explore with AI, replacing the developer Gemini API. This provides automatic Application Default Credentials (ADC) token resolution, configurable safety thresholds above the default API limits, and enterprise-grade IAM-backed access control.

Tink Envelope Cryptography & Post-Quantum Safeguards

Local patient records are encrypted at rest using Google Tink AEAD cryptographic envelopment. Transport security includes Quantum-Safe Cryptography (QSC) Kyber/Dilithium protocol fallbacks as a HIPAA-compliant future-proofing layer against post-quantum threats.

Smiley Gesture Authentication & WebAuthn

Shift-Left Pre-Commit Security Pipeline

A Husky pre-commit hook runs before every commit: TypeScript type checking, Vitest unit tests, markdown image reference scanning, and a credential/API key leak scanner that blocks commits containing secrets. This enforces security at the point of authorship rather than at deployment.

IP-Based API Rate Limiting

A custom in-memory rateLimiter middleware on the Express backend mitigates denial-of-service and resource exhaustion on patient data and documentation endpoints, without requiring an external service.

CodeQL-Hardened Routes

SSRF Prevention: Strict model selection whitelist (normalizeAndValidateModel) blocks server-side request forgery in stream and chat paths.
Path Traversal Prevention: path.resolve checks with strict parent-directory containment guard the static study docs router.
Clear-Text Logging Redaction: PII and secret values are redacted from all console/CI log outputs in the HIPAA compliance scanner.

📜 Feature Evolution Timeline

v1.2.0 (2026-07-22): 10-instrument Clinical & Life Sovereignty Assessment Suite (ClinicalAssessmentsSuiteComponent), Dynamic 3D Paradigm Viewport Synchronization (Western Organs, TCM Acupoints, Ayurvedic Chakras), Interactive 3D Raycast Tooltips & Quick Data Entry Overlay Card, Default Rice Papercraft design system.
v1.1.0 (2026-07-21): AIGA 2025/2026 Model Augmentation & Telemetry Lens, Physiological Storm De-escalation Shield, Procedural Health Investments QALY Matrix, OSHA Worker Safety & Green Room Lounge, Lewiston-Auburn Foraging & Phytoncide Tracker, WHO ICD-11 Multilingual Health Passport.
v1.0.0-rc12 (2026-07-21): 7-Day Chrono Weekly Meal Planner, Geolocational Micro-Climate Relocation Engine, KSS-Driven Medical Acronym Expansion Engine, OpenDyslexic PDF Exporting.
v1.0.0-rc11 (2026-07-21): Neuro-Consciousness Mood Matrix, Care Plan Print Studio & Document Carousel, Mobile QR Code Engine, Emergency Bypass Triage, Living Patient Health Fruit Tree.
v1.0.0-rc10 (2026-07-21): PhysioNet 2026 Waveform Lens, 7-second origami papercraft unfolding animation, signature origami seagull logo standardization.