Module Reference

Modules live under js/. At the time of this docs move, the app tree has 332 top-level JavaScript modules. This page is a guided implementation map, not a promise that every small hook/delegate/helper file has its own long section. Grouped by layer — lower layers have no dependencies on higher ones.

Layer 1 — Foundation

`schema.js`

The single source of truth for all biomarker definitions. No runtime logic — pure data. Key exports:

MARKER_SCHEMA — nested object: { categoryKey: { label, icon, markers: { markerKey: { name, unit, refMin, refMax, refMin_f, refMax_f, desc } } } }. Categories include biochemistry, hormones, electrolytes, lipids, hematology, differential, thyroid, proteins, vitamins, diabetes, inflammation, fattyAcids, calculatedRatios, and others
UNIT_CONVERSIONS — keyed by "category.markerKey": { type: 'multiply', factor, unit } for EU→US conversions
OPTIMAL_RANGES — keyed by "category.markerKey": { optimalMin, optimalMax, optimalMin_f?, optimalMax_f? }
PHASE_RANGES — keyed by "category.markerKey": { menstrual: { min, max }, follicular: {...}, ovulatory: {...}, luteal: {...} } — covers hormones.estradiol, hormones.progesterone, hormones.lh, and hormones.fsh
SPECIALTY_MARKER_DEFS — re-exported from adapters.js as ADAPTER_MARKERS. Used by migrateProfileData() and buildMarkerReference()
CHIP_COLORS — status → CSS color string
MODEL_PRICING — AI model pricing metadata, keyed by provider/model

Window exports: none

`adapters.js`

Parser adapter registry for specialty lab detection and normalization. Single source of truth for all specialty marker definitions (OAT, fatty acids, Metabolomix+, BioStarks). Key exports:

ADAPTER_MARKERS — flat object keyed by "category.markerKey": { name, unit, refMin, refMax, categoryLabel, icon, group, singlePoint? } (217 entries). Re-exported from schema.js as SPECIALTY_MARKER_DEFS
getAllAdapterMarkers() — returns merged marker map from all registered adapters
detectProduct(fileName, pdfText) — runs all adapter detect() functions, returns { adapter, product: { prefix, label } } or null
normalizeWithAdapter(adapter, markers, fileName, pdfText, product) — dispatches to adapter.normalize() for post-AI marker key/category rewriting
getAdapterByTestType(testType) — looks up adapter by AI-returned test type string

Adapter registry: array of { id, testTypes[], markers, detect?, normalize? }:

fattyAcids — 29 markers, detects Spadia/ZinZino/OmegaQuant by filename/text, normalizes to product-prefixed categories under “Fatty Acids” sidebar group
metabolomix — no unique markers (reuses OAT + FA), detects Genova Metabolomix+ reports, routes FA add-on markers to metabolomixFA prefix
oat — 165 markers, no detect/normalize (AI handles OAT categorization directly)
biostarks — 23 markers, detects BioStarks dried blood spot reports by filename/text, normalizes specialty markers (amino acids, serum FA, intracellular minerals, hormones, vitamins) while passing standard blood markers through to schema categories (hybrid import)

Window exports: none

`constants.js`

Static arrays and string constants used across modules. Key exports:

CHAT_PERSONALITIES — array of { id, name, icon, promptText } for the 3 built-in personalities
CHAT_SYSTEM_PROMPT — the base system prompt string injected into all AI chat requests
COUNTRY_LATITUDES — { countryCode: latitudeBand } (~70 countries, 5 bands: arctic/north/temperate/subtropical/tropical)
FAKE_DATA — synthetic name/address/DOB data for PII obfuscation
Per-card option arrays: SLEEP_DURATIONS, SLEEP_QUALITIES, SLEEP_SCHEDULES, SLEEP_ISSUES, SLEEP_ENVIRONMENTS, SLEEP_PRACTICES, LIGHT_AM, LIGHT_DAYTIME, LIGHT_UV, LIGHT_EVENING, LIGHT_SCREEN, LIGHT_TECH_ENV, LIGHT_COLD, LIGHT_GROUNDING, LIGHT_MEAL_TIMING, STRESS_LEVELS, STRESS_SOURCES, STRESS_MANAGEMENT, ENV_SETTING, ENV_CLIMATE, ENV_WATER, ENV_WATER_CONCERNS, ENV_EMF, ENV_EMF_MITIGATION, ENV_HOME_LIGHT, ENV_AIR, ENV_TOXINS, ENV_BUILDING, LOVE_STATUS, LOVE_RELATIONSHIP, LOVE_SATISFACTION, LOVE_LIBIDO, LOVE_FREQUENCY, LOVE_ORGASM, LOVE_CONCERNS, PERIOD_SYMPTOMS, DIET_TYPES, DIET_RESTRICTIONS, DIET_PATTERNS, EXERCISE_FREQUENCIES, EXERCISE_TYPES, EXERCISE_INTENSITIES, EXERCISE_DAILY_MOVEMENT

Window exports: none

`state.js`

Single shared mutable state object. Import state to read or write. No logic. Key exports:

state — the mutable singleton:

{
  chartInstances: {},        // Chart.js instances by element id
  markerRegistry: {},        // runtime marker lookup cache
  importedData: {            // all user data for the active profile
    entries: [],             // lab results: [{ date, markers: { "cat.key": value } }]
    notes: [],               // [{ date, text }]
    supplements: [],         // supplement timeline entries
    healthGoals: [],         // [{ text, severity }]
    diagnoses: null,         // { conditions: [{ name, severity, since? }], note }
    diet: null,              // structured meal object
    exercise: null,          // structured exercise object
    sleepRest: null,         // structured sleep object
    lightCircadian: null,    // structured light/circadian object
    stress: null,            // structured stress object
    loveLife: null,          // structured relationship/sexual health object
    environment: null,       // structured environment object
    interpretiveLens: '',    // freetext string
    contextNotes: '',        // freetext string
    menstrualCycle: null,    // { cycleLength, periodLength, regularity, flow, periods[] }
    customMarkers: {}        // { "cat.key": { name, unit, refMin, refMax, categoryLabel } }
  },
  unitSystem: 'EU',          // 'EU' | 'US'
  currentProfile: 'default', // active profile id
  profiles: null,            // loaded profiles array
  profileSex: null,          // 'male' | 'female' | null
  profileDob: null,          // 'YYYY-MM-DD' | null
  chatHistory: [],           // current thread messages
  chatThreads: [],           // thread index array
  currentThreadId: null,
  currentChatPersonality: 'default',
  dateRangeFilter: 'all',    // 'all' | '6m' | '1y' | '2y'
  rangeMode: 'optimal',      // 'optimal' | 'reference'
  suppOverlayMode: 'off',    // 'off' | 'on'
  noteOverlayMode: 'off',
  phaseOverlayMode: 'off',
  compareDate1: null,
  compareDate2: null,
}

window._labState = state is set for debugging in the browser console. Window exports: none (state is accessed via import)

`utils.js`

Shared pure utility functions. Key exports:

escapeHTML(str) — escapes <>&"' for safe innerHTML insertion
hashString(str) — djb2 hash, returns integer
getStatus(value, refMin, refMax) — 'normal' | 'high' | 'low' | 'missing'. Returns 'normal' when refs are null
formatValue(value, unit) — formats a numeric value with appropriate decimal places
showNotification(message, type) — toast notification ('info' | 'success' | 'error' | 'warning')
showConfirmDialog(message) — returns Promise<boolean>, styled confirm dialog
linearRegression(points) — { slope, intercept, r2 } from [{ x, y }] array
hasCardContent(obj) — generic empty-card gate: returns true if any field has content (strings non-empty, arrays non-empty, note trimmed). Used by buildLabContext() for 7 context card gates
bindModalSyncRefresh(opts) / bindDetailModalSyncRefresh(kind, refresh) / bindDetachedModalSyncRefresh(opts) — shared labcharts-sync-applied modal refresh bindings with dirty-form guards and scroll restoration

Window exports: showNotification, showConfirmDialog, setDebugMode, setPIIReviewEnabled, hasCardContent

Layer 2 — Core Services

Shared modal backdrop, focus-trap, and body-scroll lock helpers. Owns the cross-module scroll-lock registry used by Light & Sun modals; sun.js re-exports the legacy names for compatibility. Key exports:

wireBackdropClose(overlay, closeFn?) / _wireBackdropClose(overlay, closeFn?) — backdrop click close wiring with inside-click guard
trapModalFocus(overlay) — locks background scroll, restores focus/overflow on removal, and handles Escape close

Window exports: none directly; sun.js still exposes compatibility globals.

`theme.js`

Theme management and Chart.js color helpers. Key exports:

getTheme() / setTheme(theme) / toggleTheme() — 'dark' | 'light'; setTheme sets data-theme on <html>
getChartColors() — reads live CSS custom properties and returns a chart color config object
formatDateLabel(dateStr) — formats ISO date for chart x-axis
getTimeFormat() / setTimeFormat(fmt) — '24h' | '12h', stored in labcharts-time-format
formatTime(timeStr) — formats a 24h time string for display using the active format
parseTimeInput(input) — accepts both '14:30' and '2:30 PM', always returns 24h format

Window exports: toggleTheme

`hardware.js`

GPU detection and model fitness advisor for Local AI settings. Pure functions, no DOM manipulation. Key exports:

detectHardware() — async, returns { gpu: { name, vram, unified, renderer, source }, ram: { gb, source }, cpuThreads }. GPU detected via WebGL WEBGL_debug_renderer_info matched against 75-entry GPU_DB (Apple Silicon M1–M4, NVIDIA RTX 30/40/50, AMD RX 6000/7000, Intel Arc, Vega)
assessModel(modelObj, hardware) — returns { tier, badge, vramNeeded, label } where tier is 'fits' / 'tight' / 'toobig' / 'unknown'
assessFitness(modelName) — rates a model for getbased lab analysis: { tier, note } where tier is 'recommended' / 'capable' / 'underpowered' / 'inadequate'. Benchmarked against Sonnet 4.6
getBestModel(modelDetails, hardware) — picks the highest-fitness installed model that fits in VRAM
getUpgradeSuggestion(modelDetails, hardware) — returns a pull recommendation if no installed model is “recommended” tier
saveHardwareOverride(vram) / getHardwareOverride() — manual VRAM override in localStorage

Window exports: none (imported by settings.js)

`api.js`

AI provider routing and model management. All AI calls flow through callClaudeAPI. Key exports:

callClaudeAPI(opts) — main router: delegates to the active provider based on getAIProvider()
callOpenRouterAPI(opts) — OpenRouter via callOpenAICompatibleAPI
callRoutstrAPI(opts) — Routstr via callOpenAICompatibleAPI
callPPQAPI(opts) — PPQ via callOpenAICompatibleAPI
callVeniceAPI(opts) — Venice AI via callOpenAICompatibleAPI
callOpenAICompatibleLocalAPI(opts) — Local AI via shared callOpenAICompatibleAPI helper
callOpenAICompatibleAPI(endpoint, key, model, providerName, opts, extraHeaders) — shared OpenAI-format helper
getAIProvider() / setAIProvider(provider) — 'openrouter' | 'routstr' | 'ppq' | 'venice' | 'ollama' (internal key for Local)
hasAIProvider() — returns true if any provider is configured; gates all 7 AI features
getOpenRouterModel(), getRoutstrModel(), getPPQModel(), getVeniceModel(), getOllamaMainModel()
fetchOpenRouterModels(), fetchRoutstrModels(), fetchPPQModels(), fetchVeniceModels() — dynamic model lists
getModelPricing(modelId) — checks dynamic OpenRouter pricing cache, falls back to MODEL_PRICING
OPENROUTER_CURATED — whitelist of latest-gen medically capable models (prefix-matched)
OPENROUTER_EXCLUDE — blocklist filtering codex/audio/image/oss variants

Window exports: getRoutstrNodeUrl (used by settings UI for node URL access)

`api-transport.js`

Shared AI API transport helpers used by api.js. Key exports:

fetchWithRetry(url, options, config) — wraps fetch with request timeout, transient network retry, and 429 backoff
createProxyFetch(shouldUseProxy) — builds the Custom API proxy fetch wrapper
readWithStallTimeout(reader, label) — guards streaming readers from hanging between chunks
STREAM_STALL_TIMEOUT_MS, FETCH_REQUEST_TIMEOUT_MS, AI_IMPORT_REQUEST_TIMEOUT_MS — public timeout constants re-exported by api.js

Window exports: none

`cashu-wallet.js`

In-app Cashu eCash wallet for decentralized AI payments. Proofs stored in IndexedDB, BIP-39 seed encrypted in localStorage. Key exports:

getMintUrl() / setMintUrl(url) — configured Cashu mint
generateWalletSeed() — creates 12-word BIP-39 mnemonic
restoreWalletFromSeed(mnemonic) — restores proofs from mint via batchRestore
getWalletBalance() — sum of unspent proofs for current mint
createFundingInvoice(amountSats) / checkFundingStatus(quoteId) — Lightning deposit flow
receiveToken(tokenString) — deposit a Cashu token
depositToNode(nodeUrl, amountSats, existingKey) — swap proofs for a node session key
sendAsToken(amountSats) — withdraw as shareable Cashu token
createWithdrawQuote(bolt11) / executeWithdraw(quoteId) — Lightning withdrawal
withdrawToAddress(address, amountSats) — LNURL-pay withdrawal
recoverPendingDeposit() / recoverPendingWithdraw() — failed operation recovery
exportWallet() / importWallet(tokenString) — backup/restore
getFeePct() — current fee percentage (0 during beta)

Window exports: all functions prefixed with cashu (e.g., cashuGetBalance, cashuDepositToNode)

`nostr-discovery.js`

Discovers Routstr AI nodes via Nostr relays (Kind 38421 events). Key exports:

discoverNodes(forceRefresh) — queries relays in parallel, deduplicates, health-checks, returns sorted node array
getSelectedNodeUrl() / setSelectedNodeUrl(url) — persisted node selection
clearNodeCache() — force re-discovery on next call

Window exports: nostrDiscoverNodes, nostrGetSelectedNode, nostrSetSelectedNode, nostrClearNodeCache

Layer 3 — Data & Profile

`profile.js`

Profile lifecycle and settings persistence. Key exports:

profileStorageKey(profileId, suffix) — builds labcharts-{profileId}-{suffix}
createDefaultProfileData() — returns the empty importedData shape used for new/metadata-only profile sync
loadProfiles() / saveProfiles() — profile index CRUD
switchProfile(profileId) — loads importedData from localStorage for the given profile
deleteProfile(profileId) — removes all keys for the profile
migrateProfileData() — upgrades legacy field formats on load (old sleepCircadian → sleepRest + lightCircadian, old fieldExperts/fieldLens → interpretiveLens, initializes missing fields with null)
getProfileLocation() / setProfileLocation(country, zip) — country+ZIP storage
getLatitudeFromLocation() — looks up latitude band from COUNTRY_LATITUDES
renderProfileDropdown() — renders the profile selector UI

Window exports: openProfileEditor, switchProfile, deleteProfile, addProfile, saveProfile

`data.js`

The central data pipeline. Every view gets its data from getActiveData(). Key exports:

getActiveData() — deep-clones MARKER_SCHEMA, merges custom markers, applies sex-specific ranges, populates values[] arrays from importedData.entries, computes ratios + PhenoAge + cycle phases, applies unit conversion. Returns data object with { dates[], dateLabels[], categories, phaseLabels? }
saveImportedData() — persists state.importedData to localStorage (or encrypted store), triggers backup
buildMarkerReference() — compact JSON of all known markers for AI system prompts (PDF import)
filterDatesByRange(data) — applies state.dateRangeFilter to dates + values arrays in-place
registerRefreshCallback(fn) — registers the refresh function from app-event-listeners.js
getFocusCardFingerprint() — djb2 hash of all entries + all 9 context cards + sex + DOB
Compatibility re-exports from marker-analysis.js keep existing window.* helper access stable.

Window exports: saveImportedData, clearAllData (via export.js), filterDatesByRange

`marker-analysis.js`

Read-only marker range, status, and trend helpers. This module owns pure marker analysis so chart, dashboard, AI context, and export code do not need to import the storage/sync-heavy data.js when they only need derived marker calculations. Key exports:

getEffectiveRange(marker) — returns { min, max } respecting state.rangeMode
getEffectiveRangeForDate(marker, dateIndex) — phase-aware range lookup; falls back to getEffectiveRange()
getPhaseRefEnvelope(marker) — widest span across all cycle phases for chart ref bands
getLatestValueIndex(values) — index of the latest non-null marker value
countFlagged(markers) / getAllFlaggedMarkers(data) — out-of-range marker helpers
statusIcon(status) — status-to-symbol mapping used by category cards
detectTrendAlerts(data) — sudden-change (25% of ref range, 2+ values) and linear-regression (slope >0.02, R²>0.5 for 4+ points) alerts
getKeyTrendMarkers(filteredData) — dashboard key-trend selection

Window exports: none directly; data.js keeps compatibility exports.

`pii.js`

Two-path PII obfuscation for PDF text before AI submission, with streaming review modal. Key exports:

sanitizeWithOllamaStreaming(pdfText, onChunk, signal) — preferred path: SSE streaming via OpenAI-compatible API, calls onChunk(delta) per token, supports AbortSignal
sanitizeWithOllama(pdfText) — non-streaming path: same endpoint, used when review is disabled
obfuscatePDFText(pdfText) — regex fallback: label-based + pattern-based replacement, returns { obfuscated, original, replacements }
reviewPIIBeforeSend(originalText, { obfuscatedText, streamFn }) — review modal: streaming mode (pass streamFn) or static mode (pass obfuscatedText). Returns edited text or 'cancel'
checkOllamaPII() — checks PII server availability via /v1/models
getOllamaConfig() / saveOllamaConfig(config) — local AI config: { url, model, apiKey }
showPIIDiffViewer(original, obfuscated, replacements) — debug diff viewer (requires labcharts-debug flag)

Window exports: setOllamaPIIModel

`image-utils.js`

Shared image utilities for chat attachments and PDF image fallback. Key exports:

resizeImage(file, maxDim?, quality?) — resizes an image to fit within maxDim pixels (default 1024), returns { base64, mediaType, width, height, origWidth, origHeight, quality_warnings }
isValidImageType(type) — validates MIME type against image/(jpeg|png|gif|webp)
formatImageBlock(base64, mediaType, provider) — returns a provider-specific image content block (type:'image_url' for OpenAI-compatible providers)
buildVisionContent(imageBlocks, text, provider) — assembles a content array with image blocks + text block

Internal:

analyzeImageQuality(ctx, width, height) — canvas-based pixel sampling (~100k samples): brightness (dark/overexposed) + Laplacian variance (blur detection). Returns string[] warnings

Window exports: resizeImage, isValidImageType, formatImageBlock, buildVisionContent

Layer 4 — Domain Modules

`charts.js`

Chart.js configuration and all custom plugins. Key exports:

createLineChart(canvasId, marker, data, phaseLabels?) — creates a Chart.js line chart with all plugins applied
destroyAllCharts() — destroys all instances in state.chartInstances to prevent memory leaks
Five Chart.js plugins (registered globally):
- refBandPlugin — shaded reference range band
- optimalBandPlugin — green dashed optimal range band
- noteAnnotationPlugin — yellow dot annotations at note dates with hover tooltips
- supplementBarPlugin — colored timeline bars for supplements
- phaseBandPlugin — cycle phase vertical shading (menstrual=red, follicular=blue, ovulatory=purple, luteal=yellow, 8% opacity)

Window exports: none

`notes.js`

Standalone note management (independent of lab entries). Key exports:

openNoteEditor(date?) — opens the note editor modal, pre-filled if date provided
saveNote() — saves the current editor content to importedData.notes
deleteNote(date) — removes a note by date

Window exports: openNoteEditor, saveNote, deleteNote

`supplements.js`

Supplement and medication timeline, editor, ingredient tracking, and AI impact analysis. Key exports:

openSupplementsEditor(index?) — opens the supplement editor modal
saveSupplement(idx) — persists current form state to importedData.supplements
deleteSupplement(idx) — removes by index
renderSupplementsSection() — dashboard timeline bars
renderSupplementImpact(supp, editIdx) — per-supp impact card (shimmer → cached AI summary)
computeSupplementImpact(supp, markerKey, ...) — before/after mean comparison for one marker
computeAllImpacts(supp, data) — impact vectors across all markers, sorted by |pctChange|
parseAmount(str) — extract {value, unit} from “890mg” / “5,4 mg” / “500 IU” (handles comma decimals)
effectiveTimesPerDay(ing, supp) — row override wins, else supp-level default
ingredientDailyTotal(ing, supp) — computed amount × effectiveTimesPerDay

Ingredient data model: each supp has an optional outer timesPerDay (default multiplier); each ingredient row has {name, amount, timesPerDay?} where timesPerDay is an optional per-row override. Daily total = amount × (row.timesPerDay ?? supp.timesPerDay). Impact cache: per-supp cache in labcharts-{profileId}-suppImpact keyed by supp name with a fingerprint that includes dosage, outer timesPerDay, per-ingredient fields, periods, and lab dates — any edit auto-invalidates only that supp’s cache entry. Concurrent renders are coalesced via a 50ms debounced queue (scheduleAnalyze → flushAnalyses).

`cycle.js`

Menstrual cycle tracking, helpers, and dashboard rendering. Key exports:

getCyclePhase(dateStr, mc) — { cycleDay, phase, phaseName } for a date against a cycle object
getNextBestDrawDate(mc) — next early follicular window (days 3–5)
getBloodDrawPhases(mc, dates) — maps lab dates to phases
calculateCycleStats(periods) — auto-computes { cycleLength, periodLength, regularity } from period log
detectPerimenopausePattern(mc, dob) — flags perimenopause pattern (age 35+, 4+ periods, 2+ of 4 indicators)
detectCycleIronAlerts(mc, data) — cross-references heavy flow with ferritin/hemoglobin/iron
openMenstrualCycleEditor() — opens the cycle editor modal
saveMenstrualCycle() — saves to importedData.menstrualCycle, triggers cycle tour
renderMenstrualCycleSection(data) — renders the full cycle dashboard section
startCycleTour(auto) — triggers the 8-step cycle spotlight tour

Window exports: openMenstrualCycleEditor, saveMenstrualCycle, addPeriod, deletePeriod, startCycleTour

`context-cards.js`

Lifestyle context card rendering plus AI health dots, Interpretive Lens / Knowledge Base dashboard rows, dashboard CTA pills, context change history, and legacy compatibility exports for summary/editor helpers. Key exports:

renderProfileContextCards(data) — renders the 3-column context card grid on the dashboard
renderInterpretiveLensSection() — renders the lens row (when set) + KB status row (when configured) + AI personalize CTA pill + Data protection CTA pill
renderKnowledgeBaseSection() — pure-render helper for the KB status row (returns '' when no library configured)
renderDataProtectionCta(stateOverride?) — pure render of the data-protection pill; accepts an explicit state override for testability
openPersonalizeAIPicker() — 2-card picker (Lens / Knowledge Base) shown when both are unset
openDataProtectionPicker() — 3-card picker (Encryption / Sync / Auto-backup) with configured cards grayed out
triggerDNAFilePicker() — programmatic file input trigger that routes through window.handleDNAFile; used by the genetics empty-state stub
loadContextHealthDots() — async; fetches AI health ratings for stale cards (per-card fingerprint caching)
getCardFingerprint(key) — djb2 hash of lab data + card data + sex + DOB for cache invalidation
Per-card editor functions: openDiagnosesEditor, openDietEditor, openExerciseEditor, openSleepEditor, openLightEditor, openStressEditor, openLoveLifeEditor, openEnvironmentEditor, openHealthGoalsEditor; Medical History helpers are compatibility re-exports from context-card-medical-history-editor.js, and lifestyle/simple editors are compatibility re-exports from context-card-lifestyle-editors.js
Per-card save functions: saveDiagnoses, saveDiet, saveExercise, saveSleep, saveLight, saveStress, saveLoveLife, saveEnvironment, saveHealthGoals; saveDiagnoses is a compatibility re-export from context-card-medical-history-editor.js, and lifestyle/simple saves are compatibility re-exports from context-card-lifestyle-editors.js
selectCtxOption(el, group, multi) — compatibility re-export from context-card-editor-ui.js
getSelectedOption(group) — reads selected value from a .ctx-btn-group
Summary helpers such as getDietSummary() and getEnvironmentSummary() — compatibility re-exports from context-card-summaries.js
debounceContextNotes() — auto-saves the free-form context notes textarea
recordChange(field) — snapshots a context field and appends a timestamped entry to importedData.changeHistory (dedup: same-day overwrite, identical skip, 200 cap)

Window exports: all open/save functions, selectCtxOption, addCondition, deleteCondition, addGoal, deleteGoal, syncDiagnosesNote, openInterpretiveLensEditor, saveInterpretiveLens, renderKnowledgeBaseSection, openPersonalizeAIPicker, openDataProtectionPicker, triggerDNAFilePicker

`context-card-summaries.js`

Context card metadata, filled-state checks, dashboard summary strings, and the EMF assessment launcher/summary. Kept side-effect-light so card rendering, chat/onboarding callers, and tests can share one source of truth without pulling in every editor modal. Key exports: CONTEXT_CARD_KEYS, getContextCardDefs(), isContextFilled(key), getConditionsSummary(), getDietSummary(), getExerciseSummary(), getSleepSummary(), getLightCircadianSummary(), getStressSummary(), getLoveLifeSummary(), getEnvironmentSummary(), getGoalsSummary(), getEMFAssessments(), renderEMFAssessmentLauncher(). Window exports: none directly; legacy globals are assigned by context-cards.js.

`context-card-editor-ui.js`

Shared context editor modal shell and field-control render/read helpers used by the 9 card editors. Key exports: renderContextEditorModal(), renderSelectField(), selectCtxOption(), getSelectedOption(), renderTagsField(), toggleCtxTag(), getSelectedTags(), renderNoteField(), contextEditorActions(). Window exports: none directly; legacy globals are assigned by context-cards.js.

`context-card-medical-history-editor.js`

Medical History editor module for personal conditions and family history. Owns the condition autocomplete, relative allowlist, add/delete flows, modal rendering, note sync, and save/clear handlers for importedData.diagnoses. Key exports: configureMedicalHistoryEditor(), openDiagnosesEditor(), renderDiagnosesModal(), filterConditionSuggestions(), selectConditionSuggestion(), closeSuggestionsOnClickOutside(), syncDiagnosesNote(), addCondition(), editCondition(), cancelConditionEdit(), deleteCondition(), addFamilyHistoryEntry(), editFamilyHistoryEntry(), cancelFamilyHistoryEdit(), deleteFamilyHistoryEntry(), filterFamilyConditionSuggestions(), selectFamilyConditionSuggestion(), saveDiagnoses(), closeDiagnoses(), clearDiagnoses(). Window exports: none directly; legacy globals are assigned by context-cards.js.

`context-card-lifestyle-editors.js`

Lifestyle/simple context editors for Diet & Digestion, Sleep & Rest, Light & Circadian, Exercise, Stress, Love Life, Environment, Health Goals, Interpretive Lens, and the diet contaminant modal. Uses configureLifestyleContextEditors() so context-cards.js remains the owner of recordChange() and saveAndRefresh() while the editor module owns modal rendering and save/clear handlers. Key exports: configureLifestyleContextEditors(), renderDietContaminantsBadge(), openDietEditor(), saveDiet(), clearDiet(), openSleepRestEditor(), saveSleepRest(), clearSleepRest(), openLightCircadianEditor(), saveLightCircadian(), clearLightCircadian(), openExerciseEditor(), saveExercise(), clearExercise(), openStressEditor(), saveStress(), clearStress(), openLoveLifeEditor(), saveLoveLife(), clearLoveLife(), openEnvironmentEditor(), saveEnvironment(), clearEnvironment(), openHealthGoalsEditor(), renderHealthGoalsModal(), addHealthGoal(), deleteHealthGoal(), closeHealthGoals(), clearHealthGoals(), openInterpretiveLensEditor(), saveInterpretiveLens(), clearInterpretiveLens(), showDietContaminantsModal(). Window exports: none directly; legacy globals are assigned by context-cards.js.

Layer 5 — Feature Modules

`dna.js`

DNA raw data import: client-side parser, storage, dashboard section, AI context assembly. Key exports:

detectDNAFile(text) — detects format from file header: 'ancestry' | '23andme' | 'livingdna' | 'csv' | null
isDNAFile(file) — checks filename patterns for known DNA providers
isDNAFileByContent(file) — async, reads first 500 bytes to detect DNA format by content
parseDNAFile(file) — async, runs Web Worker parser, matches against data/snp-health.json (41 SNPs), resolves APOE haplotype, returns enriched matches with effect/note per genotype
saveGeneticsData(profileData, result) — stores matched SNPs + APOE in importedData.genetics
deleteGeneticsData(profileData) — removes genetics data
buildGeneticsContext(genetics, activeMarkerKeys) — serializes genetics for AI context, filtered to SNPs relevant to active markers
renderGeneticsSection() — full genetics interpretation section for classic/mobile dashboard contexts; returns an in-context “Add your DNA data” empty-state stub (wired to triggerDNAFilePicker) when no SNPs/mtDNA exist
handleDNAFile(file) — full import flow: parse → preview modal → confirm → save

Supports: AncestryDNA (2-column alleles), 23andMe, MyHeritage, FTDNA, Living DNA. Genotype reversal handles strand ambiguity (CT ↔ TC). Window exports: isDNAFile, isDNAFileByContent, handleDNAFile, confirmDNAImport, closeDNAImportPreview, deleteGeneticsData, _buildGeneticsContext, _getRelevantSNPs

`pdf-import.js`

PDF/image/text-to-lab-data import pipeline and confirm/save merge logic. Key exports:

extractPDFText(file) — pdf.js text extraction with x/y coordinates, returns page-aware formatted text
parseLabPDFWithAI(pdfText) — sends text + buildMarkerReference() to AI; maps lab results to marker keys
handleImageFile(file) — imports lab reports from JPG/PNG/WebP images via AI image pipeline
handleBatchPDFs(files) — sequential multi-file import with per-file confirm/skip
showImportPreview(parsed) — re-export from pdf-import-review.js
confirmImport(parsed) — merges parsed data into importedData.entries
setupDropZone() — legacy eager drop-zone binding retained for compatibility; page shells use import-drop-zone.js so the PDF import module stays lazy-loaded

Window exports: confirmImport, skipImport, importNextPDF, syncImportStatusFab, handleImportStatusClick, isImportRunning

`pdf-import-preflight.js`

Pre-AI import checks for duplicate PDF hashes, previous-model mismatch prompts, and unsupported specialty-test warnings. Key exports:

runPreflightChecks(pdfText, fileName) — returns false when the user cancels before token-spending import work starts
normalizeImportModelId(id) — shared model ID canonicalization for cross-provider import mismatch checks

Window exports: none directly; pdf-import.js calls this during PDF/batch import.

`pdf-import-progress.js`

Import progress bar, header import-button status, and batch progress rendering. Key exports:

showImportProgress(step, fileName) / hideImportProgress(reason) — render and clear the import progress UI
showBatchImportProgress(step, fileName, current, total) — render per-file batch progress
updateImportProgressPct(pct) — streaming AI progress update hook
syncImportStatusFab() / handleImportStatusClick() / isImportRunning() — status bridge used by pdf-import.js window exports; the legacy function name now syncs the header import button

Window exports: via pdf-import.js

`pdf-import-marker-normalization.js`

Shared AI marker normalization for PDF text import and image import. Key exports:

normalizeParsedImportMarkers(parsed, options) — sanitizes AI marker keys, runs product/test-type adapters, applies specialty guard rules, reconciles marker mappings, and returns { testType, markers }

Window exports: none directly; pdf-import.js calls this after AI JSON parsing.

`pdf-import-persistence.js`

Durable imported-data persistence helpers for PDF import flows. Key exports:

snapshotImportedData() / restoreImportedDataSnapshot(snapshot) — rollback guard used when durable import saves fail
refreshImportedDataViews() — rebuilds sidebar/header and restores the current route after imported data changes
removeImportedEntry(date) / renameImportedEntryDate(oldDate) — entry delete and date-edit mutations with tombstones, immediate sync save, rollback, and success refresh

Window exports: via pdf-import.js

`pdf-import-review.js`

Import review modal rendering and interaction state. Key exports:

showImportPreview(parsed) — modal with matched, new custom, unmatched, and excluded marker rows
applyManualImportDate(date) — updates pending review date and confirm button state
mapUnmatchedMarkerInput(input) / toggleImportRow(button) — review-row mapping and exclusion controls
getPendingImport() / getExcludedImportIndices() — narrow state access used by confirmImport()
showImportPreviewAsync(result, current, total) — batch import preview promise bridge

Window exports: via pdf-import.js

`import-drop-zone.js`

Lazy drop-zone event binding shared by Dashboard, Labs, and mobile dashboard shells. It imports loadPdfImport() from import-loader.js, classifies dropped files only after interaction, and routes JSON, lab PDFs/images, text imports, and DNA files to the same handlers used by the file input path. Key exports:

setupDropZone() — idempotently binds click, drag, and drop handlers to #drop-zone

`import-file-input.js`

Lazy file-picker import binding for the hidden #pdf-input. It shares loadPdfImport() with the drop-zone path, classifies files on change, clears stale selections on failure, and routes JSON, lab PDFs/images, text imports, and DNA files through the import/DNA handlers exposed on window. Key exports:

bindImportFileInput() — idempotently binds #pdf-input change handling and document-level drag/drop prevention
handleImportInputChange(e) — routes one file-picker change event through the lazy import classifier

`export.js`

Data export, import, and reset. Key exports:

exportToJSON() — exports v2 JSON for the current profile: { version: 2, exportedAt, entries, notes, diagnoses, diet, exercise, sleepRest, lightCircadian, stress, loveLife, environment, interpretiveLens, healthGoals, contextNotes, menstrualCycle, customMarkers, supplements }
buildClientExportObject(profileId, includeChat?) — module-only helper that returns the reusable v2 single-profile export object used by JSON export and encrypted profile sharing. It includes profile metadata, labs, context, supplements, genetics, biometrics, marker notes, wearables summaries/preferences, and Light/Sun data, while excluding OAuth/wearable connection credentials and raw per-device wearable rows
exportClientJSON(profileId) — exports a single client’s data (used from Client List ⋮ menu)
exportAllDataJSON() — exports a full database bundle with all profiles, chat threads, custom personalities, and settings
buildAllDataBundle() — builds the bundle object used by both exportAllDataJSON() and folder backup
importFromJSON(file) — merges entries by date, deduplicates notes, overwrites context fields, merges healthGoals by text. Auto-detects database bundles and handles multi-profile merge
exportToPDF() — generates a printable PDF report with all data, charts, and context cards
clearAllData() — confirms and wipes all imported data for the current profile

Window exports: exportToJSON, exportDataJSON, exportClientJSON, exportAllDataJSON, importFromJSON, exportToPDF, clearAllData

Encrypted single-profile share links. The module creates a profile export through the module-only buildClientExportObject() helper, encrypts it in the browser with a password, posts only the ciphertext envelope to /api/share, and imports shared profiles from #share/{id} deep links after local password decryption. Shared envelopes require at least 100,000 PBKDF2-SHA256 iterations; the normal generated value is 600,000. Key exports:

createProfileShare({ profileId, password, expiresDays }) — builds, encrypts, uploads, and records a managed share link for one profile
encryptProfileShareEnvelope(exportObj, secret, options?) / decryptProfileShareEnvelope(envelope, secret) — AES-256-GCM envelope helpers using PBKDF2-SHA256
generateProfileSharePassword() — generates a user-copyable random password
buildProfileShareUrl(id) / parseProfileShareIdFromLocation(loc?) — link construction and deep-link parsing
openProfileShareModal(profileId?) / openSharedProfileImportModal(id) — create/load modal entry points
handleProfileShareDeepLink() / initProfileShareLinks() — startup hash handling for shared links

Storage: active links created in the current browser are tracked in localStorage under getbased-profile-shares-v1. Records store share metadata and the management token needed to stop sharing; they do not store the profile password or plaintext profile data. Window exports: openProfileShareModal, closeProfileShareModal, openSharedProfileImportModal, createProfileShare, deleteProfileShareEnvelope, encryptProfileShareEnvelope, decryptProfileShareEnvelope, parseProfileShareIdFromLocation, buildProfileShareUrl

`chat.js`

Chat public barrel and startup entry point. Importing this module installs chat-window-bindings.js for legacy inline handlers, then re-exports the public chat helpers from the feature modules. Per-marker/correlation prompt builders live in chat-marker-prompts.js; direct send/streaming and image send integration live in chat-send.js; chat transcript rendering lives in chat-render.js; empty/onboarding message states live in chat-empty-state.js; chat-first onboarding handlers and provider quiz helpers live in chat-onboarding.js; multi-persona discussion exports live in chat-discussion.js, with public user-action handlers in chat-discussion-flow.js, callback bridging in chat-discussion-callbacks.js, cleanup/completion helpers in chat-discussion-lifecycle.js, round turn execution helpers in chat-discussion-turns.js, persona/thread state helpers in chat-discussion-state.js, round execution in chat-discussion-round-runner.js, round prompt helpers in chat-discussion-round-prompts.js, round API request helpers in chat-discussion-round-request.js, thread-bound round persistence in chat-discussion-round-state.js, live round message DOM helpers in chat-discussion-round-view.js, persona picker controls in chat-discussion-picker.js, and Discuss button/continue controls in chat-discussion-ui.js; panel chrome lives in chat-panel.js; FAB nudge state lives in chat-nudge.js; personality selection and custom persona editing live in chat-personalities.js; current-thread history persistence lives in chat-history.js; message action bars live in chat-actions.js; chat image attachment state lives in chat-images.js; thread index storage and rail rendering live in chat-threads.js; thread rail message search and match highlighting live in chat-thread-search.js. Key exports:

sendChatMessage() — re-exported from chat-send.js for existing callers
renderChatMessages() — re-exported from chat-render.js for existing callers
askAIAboutMarker(markerKey) — re-exported from chat-marker-prompts.js; opens chat with a marker-specific prompt
askAIAboutCorrelations() — re-exported from chat-marker-prompts.js; opens chat with a selected-marker correlation prompt
Thread management: createNewThread(), loadThread(id), deleteThread(id), renameThread(id)

Window exports: sendChatMessage, setChatPersonality, openChatPanel, closeChatPanel, createNewThread, loadThread, deleteThread, renameThread, generateCustomPersonality, saveCustomPersonality, askAIAboutMarker, addImageAttachment, toggleHDMode

`chat-window-bindings.js`

Chat callback wiring and legacy window.* compatibility exports. Owns _resumeAI, configures chat-discussion.js, chat-onboarding.js, and chat-panel.js callbacks, and exposes the chat handlers needed by inline HTML and cross-module window.fn() call sites. Key exports: none; loaded for side effects by chat.js. Window exports: sendChatMessage, renderChatMessages, setChatPersonality, openChatPanel, closeChatPanel, discussion handlers, onboarding handlers, summary handlers, action-bar handlers, and per-marker Ask AI handlers.

`chat-marker-prompts.js`

Per-marker and selected-correlation chat prompt builders. Owns askAIAboutMarker() and askAIAboutCorrelations(), including phase-aware marker values, effective reference ranges, latest status, and trend text before opening the chat panel with a prefilled prompt. Key exports: askAIAboutMarker, askAIAboutCorrelations Window exports: assigned by chat-window-bindings.js for existing inline Ask AI buttons.

`chat-send.js`

Direct chat send and streaming state. Owns sendChatMessage(), Enter-key handling, stop-button abort state, send-button icon mode, typewriter trickle, image attachment payload injection, API message assembly, usage footnotes, live EMF/product recommendation injection, and partial-message persistence on abort. It is imported by chat.js, which re-exports its public entry points and passes its typewriter/abort helpers to chat-discussion.js. Key exports: sendChatMessage, handleChatKeydown, isChatStreaming, createTypewriter, getChatAbortController, setChatAbortController, setSendButtonMode, updateSendButtonState Window exports: updateSendButtonState is assigned by this module for chat-images.js; other user-facing handlers are assigned by chat-window-bindings.js.

`chat-render.js`

Chat transcript rendering. Owns renderChatMessages() for persisted messages, lens-source disclosure rendering, assistant footnotes, image badges, EMF hints, and persisted recommendation sections. It delegates empty chat and onboarding states to chat-empty-state.js and keeps rendering details out of the chat window wiring module. Key exports: renderChatMessages, _getNoDataPrompts, _renderLensSources Window exports: renderChatMessages is assigned by chat-window-bindings.js for existing inline handlers and cross-module callbacks.

`chat-empty-state.js`

Empty chat and chat-first onboarding message composition. Owns the profile setup bubble, paused-AI prompt, explicit provider quiz entry state, no-lab optional setup cards, no-data prompt selection, and the default empty prompt buttons used before a real thread has messages. Key exports: renderEmptyChatState, _getNoDataPrompts Window exports: none; called by chat-render.js.

`chat-panel.js`

Chat panel chrome and entry-state helpers. Owns open/close/fullscreen behavior, persisted fullscreen preference, web-search toggle persistence/visibility, and composer disabled state. It imports thread/history/personality helpers directly, delegates FAB nudge dismissal to chat-nudge.js, and receives the active-discussion restore callback through configureChatPanel() to avoid importing chat-discussion.js. Key exports: configureChatPanel, toggleChatPanel, toggleChatFullscreen, openChatPanel, closeChatPanel, updateChatInputState, getChatWebSearchEnabled, setChatWebSearchEnabled, refreshWebSearchToggle; also re-exports setChatNudge and updateChatNudge from chat-nudge.js for compatibility. Window exports: assigned by chat-window-bindings.js for existing inline handlers and cross-module callbacks.

`chat-nudge.js`

Chat FAB nudge badge state. Owns nudge stage persistence, per-profile dismissal, badge/pulse DOM updates, and the profile/API/data/context card readiness check used by startup, settings, onboarding, DNA import, and panel-open flows. Key exports: setChatNudge, dismissCurrentChatNudge, updateChatNudge Window exports: assigned by chat-window-bindings.js for existing inline handlers and cross-module callbacks.

`chat-onboarding.js`

Chat-first onboarding helpers. Owns the provider quiz render helper, onboarding progress crumbs, profile/location/cycle/supplement handlers, lab-import CTA behavior, context-card nudge callback, and prompt CTA helper. It receives renderChatMessages, sendChatMessage, closeChatPanel, and nudge callbacks from chat-window-bindings.js through configureChatOnboarding() so it can update the shared chat UI without importing chat UI modules directly. Key exports: configureChatOnboarding, useChatPrompt, requestOnboardingLabImportProvider, startOnboardingLabImport, _renderOnboardCrumbs, _renderProviderQuiz, _countFilledCards, setChatProfileSex, saveChatProfile, saveChatLocation, onboardHeightUnitChanged, saveChatPeriod, addChatSupplement, removeChatSupplement, setProviderQuizBranch, backToProviderQuiz, skipProviderSetup, skipOnboardingExtras, showCycleNoMensesOptions, showCyclePeriodEntry, saveCycleStatus, _updatePeriodBtn, onContextCardSaved Window exports: assigned by chat-window-bindings.js for existing inline handlers and context-cards.js callbacks.

`chat-discussion.js`

Multi-persona discussion public barrel. Re-exports discussion flow handlers from chat-discussion-flow.js, callback configuration from chat-discussion-callbacks.js, UI compatibility helpers from chat-discussion-ui.js, and persona/thread state helpers from chat-discussion-state.js. Key exports: configureChatDiscussion, getThreadPersonaCount, updateDiscussButton, getCurrentDiscussionState, sendDiscussionUserTurn, restoreDiscussionContinuePrompt, showDiscussContinuePrompt, removeDiscussContinuePrompt, cleanupDiscussionState, startDiscussion, startDiscussionFromPicker, continueDiscussion, endDiscussion Window exports: assigned by chat-window-bindings.js for existing inline handlers and chat-threads.js callbacks.

`chat-discussion-flow.js`

Multi-persona discussion public user-action handlers. Owns manual-message entry, Continue, Discuss, and picker-start actions. It delegates cleanup/completion to chat-discussion-lifecycle.js, turn execution to chat-discussion-turns.js, and picker/prompt DOM through chat-discussion-ui.js. Key exports: sendDiscussionUserTurn, restoreDiscussionContinuePrompt, showDiscussContinuePrompt, cleanupDiscussionState, startDiscussion, startDiscussionFromPicker, continueDiscussion, endDiscussion Window exports: none directly; chat-discussion.js re-exports the public handlers and chat-window-bindings.js assigns the compatibility handlers.

`chat-discussion-lifecycle.js`

Discussion cleanup and completion helpers. Owns active-discussion restore, continuation prompt persistence, transient UI cleanup, explicit end lifecycle, original-persona restore, Discuss button/header refresh, and post-round Continue prompt handoff. Key exports: restoreDiscussionContinuePrompt, showDiscussContinuePrompt, cleanupDiscussionState, endDiscussion, finishDiscussionRound Window exports: none directly; chat-discussion-flow.js re-exports the public lifecycle handlers.

`chat-discussion-turns.js`

Discussion turn execution helpers. Owns continuation round dispatch, first debate turn dispatch, single joined-persona turn dispatch, joined-persona marker insertion, thread-bound discussion state persistence, and round completion handoff. Key exports: runDiscussionContinuation, runSingleDiscussionTurn, runDiscussion Window exports: none.

`chat-discussion-callbacks.js`

Discussion callback bridge. Owns configureChatDiscussion() and the callback wrappers that let discussion rounds reuse chat-send streaming state, send-button mode, transcript rendering, and typewriter behavior without importing chat-send.js. Key exports: configureChatDiscussion, getChatAbortController, setChatAbortController, renderChatMessages, setSendButtonMode, createDiscussionTypewriter Window exports: none directly; chat-discussion.js re-exports configureChatDiscussion for chat-window-bindings.js.

`chat-discussion-round-runner.js`

Discussion round execution loop. Owns per-persona iteration, streaming API calls, abort-controller/send-button state, auto-message insertion, typewriter updates, final assistant message persistence, usage footnotes, and modal-aware round error rendering. Key exports: runDiscussionRound Window exports: none.

`chat-discussion-round-prompts.js`

Discussion round prompt helpers. Owns the default follow-up prompt, initial-analysis prompt, joined-persona prompt, auto-message shape, joined-persona marker shape, and the first-turn versus rebuttal prompt selection logic. Key exports: DEFAULT_DISCUSS_PROMPT, INITIAL_DISCUSS_PROMPT, DISCUSSION_JOIN_PROMPT, hasExistingDiscussionResponses, getDiscussionPromptText, buildDiscussionAutoMessage, buildDiscussionJoinMessage Window exports: none.

`chat-discussion-round-request.js`

Discussion round API request helpers. Owns lab-context and lens enrichment, active personality prompt assembly, provider/model/web-search snapshots, tagged history messages, assistant message metadata, and usage tracking for multi-persona rounds. Key exports: buildDiscussionRoundRequest, buildDiscussionAssistantMessage, trackDiscussionUsage Window exports: none.

`chat-discussion-round-state.js`

Thread-bound discussion round persistence helpers. Owns origin-thread activity checks, discussion metadata writes, active-thread repaint handoff, and off-thread history persistence during streaming rounds. Key exports: isRoundThreadActive, persistDiscussionThreadState, renderRoundMessages, saveRoundChatHistory Window exports: none.

`chat-discussion-round-view.js`

Live discussion round DOM helpers. Owns typing indicators, persona labels, streamed assistant message nodes, final markdown replacement, usage footnotes, and active-thread-only error rendering for multi-persona rounds. Key exports: createDiscussionTypingIndicator, createDiscussionPersonaLabel, appendRoundPersonaLabel, createDiscussionAiMessage, renderFinalDiscussionMessage, appendDiscussionUsageFootnote, renderDiscussionRoundError Window exports: none.

`chat-discussion-ui.js`

Multi-persona discussion button and continuation prompt controls. Owns the Discuss button visibility/add-persona state and transient state handoff used by continueDiscussion() and endDiscussion(). Re-exports picker helpers from chat-discussion-picker.js so existing discussion flow imports stay stable. Key exports: updateDiscussButton, showDiscussContinuePrompt, removeDiscussContinuePrompt, removeDiscussPersonaPicker, readDiscussPersonaPickerSelection, showDiscussPersonaPicker Window exports: none directly; chat-discussion.js wraps/re-exports public controls and chat-window-bindings.js assigns the compatibility handlers.

`chat-discussion-picker.js`

Multi-persona discussion picker controls. Owns persona picker markup, active-persona locking, checkbox limiting, and picker selection reads. Key exports: removeDiscussPersonaPicker, readDiscussPersonaPickerSelection, showDiscussPersonaPicker Window exports: none.

`chat-discussion-state.js`

Multi-persona discussion state helpers. Owns per-thread active discussion detection, history fallback persona collection, current-thread lookup, unique assistant-persona counts, and current-thread discussion lifecycle metadata. Key exports: getThreadPersonaCount, collectDiscussionPersonas, getCurrentThread, clearCurrentDiscussionThreadState, reopenCurrentDiscussionThread, getCurrentDiscussionState Window exports: none directly; chat-discussion.js re-exports the public count/state helpers and chat-window-bindings.js assigns them.

`chat-personalities.js`

Chat personality storage, personality picker rendering, custom persona editor, AI-powered persona generation, and chat header title/model status. The module imports thread index helpers directly and calls back to window.renderChatMessages?.() for the two places that need to repaint chat content without creating a chat.js import cycle. Key exports: getActivePersonality, getCustomPersonalities, saveCustomPersonalities, getCustomPersonality, getCustomPersonalityText, pickPersonaIcon, setChatPersonality, loadChatPersonality, updateChatHeaderTitle, updateChatHeaderModel, updateSummaryButton, updatePersonalityBar, togglePersonalityBar, generateCustomPersonality, saveCustomPersonality, startNewCustomPersonality, editCustomPersonality, deleteCustomPersonality, autoResizePersonaTextarea, markPersonalityDirty, snapshotPersonalityClean Window exports: assigned by chat-window-bindings.js for existing inline handlers and cross-module callbacks.

`chat-history.js`

Thread-aware chat message persistence and clearing. The module owns the legacy storage key helper, encrypted/plain thread message load/save, thread metadata updates, saved-summary cleanup, and the clear-history confirmation flow. It uses window.renderChatMessages?.() and window.updateDiscussButton?.() callbacks for repaint/discussion hooks that would otherwise create a chat.js import cycle. Key exports: getChatStorageKey, loadChatHistory, saveChatHistory, clearChatHistory Window exports: assigned by chat-window-bindings.js for existing inline handlers and chat-threads.js callbacks.

`chat-thread-search.js`

Thread rail message-content search and match highlighting. It owns the debounced per-thread content search, encrypted/plain message reads, result rendering, cache invalidation, jump-to-result behavior, and in-message mark/highlight cleanup while receiving thread key, rail render, and switch callbacks from chat-threads.js. Key exports: configureChatThreadSearch, filterThreadList, invalidateThreadContentCache, jumpToSearchResult Window exports: re-exported and assigned by chat-threads.js for existing inline handlers.

`chat-actions.js`

Chat message action bar rendering and message-level handlers. The module owns Regenerate, Copy, and context-details toggle behavior while calling back to window.renderChatMessages?.(), window.sendChatMessage?.(), and window.isChatStreaming?.() to avoid importing the streaming/rendering module. Key exports: buildActionBar, regenerateLastMessage, copyMessage, toggleContextDetails Window exports: assigned by the module directly and re-exported by chat.js for existing inline handlers.

`chat-icons.js`

Shared chat SVG icon strings and icon-button DOM helper extracted from chat.js. Keeps action buttons and streaming send/stop button state changes using the same symbols without keeping SVG construction code in the chat orchestration module. Key exports: CHAT_ICON_COPY, CHAT_ICON_REFRESH, CHAT_ICON_EDIT, CHAT_ICON_X, setIconButtonContent Window exports: none

`chat-attestation.js`

Venice E2EE attestation display helpers shared by the chat header and assistant-message cost footnotes. Keeps lock glyph, attestation tooltip, and verified/failed mark formatting out of the chat orchestration module. Key exports: attestationTooltip, e2eeLockHTML, e2eeLockFootnote Window exports: none

`chat-continuation.js`

Response limit detection and automatic continuation wrapper for chat and discussion calls. Centralizes token-headroom constants, incomplete-response heuristics, continuation prompt construction, and usage merging. Key exports: CHAT_RESPONSE_MAX_TOKENS, callChatAPIWithContinuation, isAIResponseTruncated, responseLimitNote Window exports: none

`chat-prompt-context.js`

Pure prompt/message helpers shared by direct chat sends and multi-persona discussion rounds. Centralizes persona prompt additions, cross-persona API-message tagging, web-search/E2EE system hints, system-prompt assembly, and persisted lens-source serialization. Key exports: buildPersonalityPrompt, buildMultiPersonaInstruction, buildTaggedChatMessages, buildWebSearchHint, buildChatSystemPrompt, serializeLensSources, attachLensSources Window exports: none

`chat-summaries.js`

Conversation summary generation, saved-summary profile storage, and summary modal actions extracted from chat.js. Key exports: summarizeThread, renderSavedSummaries, viewSavedSummary, deleteSavedSummary, closeSummaryModal, copySummary, downloadSummary, printSummary Window exports: assigned by chat-window-bindings.js for existing inline handlers.

`settings.js`

Settings modal shell with profile, display, AI, privacy, data, wearables, and Agent Access tabs. Delegates AI provider panels to provider-panels.js, wearables rows to wearables-settings-panel.js, sync controls to settings-sync-panel.js, and Agent Access rendering/actions to settings-agent-access-panel.js. Key exports:

openSettingsModal() / closeSettingsModal()
initSettingsModelFetch() — fetches model lists for all providers on modal open
saveProfileSettings() — saves sex, DOB, location from the Profile section
setUnitSystem(system) — 'EU' | 'US'

Window exports: openSettingsModal, closeSettingsModal, saveProfileSettings, setUnitSystem, setAIProvider, startTour

`settings-sync-panel.js`

Settings subpanel module for cross-device sync. Owns the Settings → Data sync section, sync setup/restore modal, mnemonic and relay controls, and delegates Settings → Agent Access rendering/actions to settings-agent-access-panel.js. Key exports:

renderSyncSection() — renders the Settings → Data sync panel
renderMessengerSection() — compatibility export that renders the Settings → Agent Access panel through settings-agent-access-panel.js
hydrateSettingsSyncPanel() — loads mnemonic and relay status after the settings modal is painted
showSyncSetupModal() — opens the cross-device sync setup wizard directly; used by the dashboard data-protection picker

Window exports: showSyncSetupModal, toggleSync, toggleMnemonicVisibility, copyMnemonic, saveSyncRelay, openRestoreMnemonicDialog, closeRestoreMnemonicDialog, confirmRestoreMnemonic, closeSyncSetup, syncSetupNew, syncSetupRestore, syncSetupBack, syncSetupDoRestore, syncSetupDone, toggleMessenger, toggleMessengerToken, copyMessengerToken, regenerateMessengerToken

`settings-agent-access-panel.js`

Settings → Agent Access renderer and action handler. It owns the enable/disable state, synced Agent Access metadata, read-only relay token display, local context-key display, wearable daily-series window, and the one-paste setup-command builder for supported MCP clients. Key exports:

renderMessengerSection() — renders the Agent Access settings panel, including the target-client chip group
buildAgentAccessSetupCommand(client) — builds the private gbsetup_v1_... bootstrap command for hermes, openclaw, claude-code, claude-desktop, cursor, cline, or codex
handleMessengerAction(action, el) — delegated action handler for enabling, regenerating, copying secrets, copying setup commands, and series-window changes
toggleMessengerToken() / copyMessengerToken() / regenerateMessengerToken() — compatibility actions for legacy window bindings

`feedback.js`

In-app feedback modal. Key exports:

openFeedbackModal() / closeFeedbackModal()
submitFeedback() — validates and submits feedback (bug report or feature request)

Window exports: openFeedbackModal, closeFeedbackModal, submitFeedback

`nav.js`

Sidebar navigation, profile switcher, and mobile sidebar shell. Key exports:

buildSidebar(data) - renders Home, Lenses, Tools, and lab category navigation with marker counts
filterSidebar() - filters lab categories and keeps top-level app routes visible during search
toggleNavGroup(groupId) - expands/collapses sidebar category groups
renderProfileDropdown() / renderProfileButton() - profile switcher UI
openRecommendationsFromSidebar() - compatibility helper that routes to the dedicated recommendations page

Window exports: buildSidebar, filterSidebar, toggleNavGroup, renderProfileDropdown, renderProfileButton, toggleMobileSidebar, closeMobileSidebar, openRecommendationsFromSidebar

Layer 6 — Orchestration

`views-router.js`

Route validation, per-profile last-view persistence, mobile tab sync handoff, and element-anchor scroll preservation. views.js creates the concrete navigator by passing render handlers into createNavigate(). Key exports:

createNavigate({ routeHandlers, syncMobileBottomNav }) — builds the app-level navigate() function without importing page renderers
getInitialView() — restores the active profile’s last valid route, falling back to dashboard
isKnownRoute(route, data?) — validates fixed routes and data-backed lab category routes

`lens-pages.js`

Dedicated page renderers for Labs, Genome, Body, Insight, and Recommendations. The module receives dashboard, recommendation, and lens shell helper functions from views.js through createLensPageHandlers() so page rendering can move out of the main views module without creating new import cycles. Key exports:

createLensPageHandlers(deps) — returns showLabs, showGenomeLens, showBodyLens, showInsightLens, and showRecommendations

`dashboard-page-view.js`

Dashboard route shell and page-level dashboard orchestration. dashboard-view-composition.js creates it with createDashboardPageView() after wiring dashboard widget renderers, controls, and registry helpers, so the dashboard route can live outside the main compatibility module without importing the widget control layer directly. Key exports:

createDashboardPageView(deps) — returns showDashboard(data?); owns the populated dashboard shell, empty welcome/demo state, import drop-zone setup calls, mobile dashboard handoff, focus-card hydration, context-dot hydration, and first-visit tour triggers

`dashboard-view-composition.js`

Dashboard route, widget, mobile handoff, marker-modal, and lens-shell composition wiring. views.js creates this layer once and keeps compatibility facades, while this module wires dashboard-page-view.js, dashboard-widgets.js, dashboard-widget-controls.js, dashboard-widget-renderers.js, and mobile dashboard dependencies together. Key exports:

createDashboardViewComposition(deps) — returns showDashboard, dashboard widget control handlers, recommendation helpers, and dashboard render helpers needed by lens pages and recommendation actions

`lens-page-shell.js`

Shared lens page chrome and ordering helpers used by views.js and lens-pages.js. The module owns lens headers, reorderable page widget wrappers, per-profile lens widget order persistence, page-section move controls, dashboard add/remove toggles, and the delegated action attributes/listener used by shared lens chrome. Key exports:

configureLensPageShell(deps) — injects dashboard widget visibility helpers without importing dashboard modules directly
renderLensHeader(title, subtitle, actions?) — renders the shared lens page header
renderLensPageWidgets(route, widgets) / renderLensWidget(...) — render reorderable page widgets and their chrome
moveLensPageWidget(route, id, direction) — persists per-profile page section order and refreshes the active route
lensPageActionAttrs(action, attrs?) — builds escaped data-lens-page-* attributes consumed by the shared delegated click listener

`dashboard-widgets.js`

Dashboard widget registry and persistence helpers. dashboard-view-composition.js supplies renderer functions from dashboard-widget-renderers.js to createDashboardWidgetRegistry() so widget metadata, defaults, availability gates, per-profile widget preferences, custom marker widget IDs, and visible-entry generation can live outside the main views module. Key exports:

createDashboardWidgetRegistry(renderers, opts?) — returns dashboard widget definitions plus preference/order helpers
DASHBOARD_WIDGET_SOURCE_ORDER — Lens/source ordering for the widget picker
DASHBOARD_WIDGET_DEFAULT_IDS — new-profile dashboard default order
DASHBOARD_MANUAL_BIOMETRIC_METRICS and dashboardBiometricSelectionKey() — biometrics widget selection helpers

Dashboard widget picker, widget chrome, layout actions, and drag/reorder controls. dashboard-view-composition.js creates the control layer with registry, marker, and biometrics dependencies; views.js re-exports the public handlers for existing window.* integrations. Key exports:

createDashboardWidgetControls(deps) — returns render helpers and dashboard widget action handlers

Dashboard widget body renderers and shared recommendation helpers. dashboard-view-composition.js creates the renderer layer with Light helper and mobile-summary dependencies, then passes the returned renderers to dashboard-widgets.js, dashboard-widget-controls.js, and lens-pages.js. Key exports:

createDashboardWidgetRenderers(deps) — returns dashboard body renderers, dashboard context builders, biometrics helpers, custom marker renderer support, and recommendation helper functions

`category-view-renderers.js`

Category chart card, table, heatmap, and fatty-acid profile renderers. category-page-view.js calls these helpers for category route content, while views.js imports and re-exports them so existing module and window.* integrations stay stable. Key exports:

renderChartCard(id, marker, dateLabels) — renders one category/dashboard marker card and registers it for the detail modal
renderTableView(cat, dateLabels, categoryKey, dates) / renderHeatmapView(cat, dateLabels, dates, categoryKey) — render category table shells with empty-value add affordances
renderFattyAcidsView(cat, categoryKey) / renderFattyAcidsCharts(cat) — render the single-date fatty-acid profile cards and bar chart

`category-page-view.js`

Category route shell and view-mode orchestration. The module owns showCategory(), switchView(), category card sorting, range-toggle order preservation, chart hydration, and chart-card recommendation loading. It depends on category-view-renderers.js for HTML fragments and keeps views.js as a thin router/compatibility facade. Key exports:

showCategory(categoryKey, data?) — renders the category header, view tabs, date/layer controls, chart grid, empty marker affordances, and saved table/heatmap mode
switchView(view, categoryKey, btn) — switches between chart, table, and heatmap modes, updates tab ARIA state, destroys stale charts, and rehydrates charts when needed

`category-customization.js`

Category and marker display override helpers. The module owns category rename, marker rename/revert, the emoji picker, and category icon override persistence while views.js keeps compatibility exports and injects navigation via configureCategoryCustomization(). Key exports:

configureCategoryCustomization(deps) — injects the app-level navigate() function without importing views.js
renameCategory(categoryKey) / renameMarker(id) / revertMarkerName(id) — persist display-name overrides into importedData.categoryLabels and importedData.markerLabels
showEmojiPicker(anchorEl, callback, opts?) — shared category/custom-marker emoji picker used by category views and the marker creation modal
changeCategoryIcon(categoryKey) — persists importedData.categoryIcons overrides and mirrors custom marker category icon metadata

`views.js`

Tool page routing and compatibility exports. Dashboard composition lives in dashboard-view-composition.js; dashboard route shell lives in dashboard-page-view.js; dashboard widget body renderers live in dashboard-widget-renderers.js; recommendation action handlers live in recommendation-actions.js; category route orchestration lives in category-page-view.js; category card/table/heatmap renderers live in category-view-renderers.js; category display overrides live in category-customization.js; the Light page shell lives in light-page-view.js; Light channel pills and drill-down panels live in light-channel-view.js; shared lens page chrome lives in lens-page-shell.js; public navigation and lens page functions remain exported here for compatibility, backed by views-router.js and delegated to route modules where applicable. Key exports:

navigate(section, params) — router facade created from views-router.js; calls the appropriate render function
showDashboard(data?) - compatibility facade backed by dashboard-view-composition.js and dashboard-page-view.js; renders the customizable widget dashboard whose default widget order starts with Biological Coherence, Current Focus, Current Priority, Quick Markers, Key Trends, Recommended Next Steps, Profile Context, Biometrics Overview, Biological Age, Metabolic Flexibility, and Cycle when available
showLabs(data?), showGenomeLens(), showBodyLens(), showInsightLens(data?), showRecommendations(data?) - compatibility facades delegated to lens-pages.js
showCategory(categoryKey, data?) - compatibility facade imported from category-page-view.js
showLight(data?), renderLightTodayStrip(), renderLightChannelsLive() - compatibility facades imported from light-page-view.js
showCompare(data?) / showCorrelations(data?) - focused tool pages
Dashboard widget controls: compatibility facades backed by dashboard-widget-controls.js, including openDashboardWidgetPicker(), toggleDashboardOrganizeMode(), resetDashboardWidgets(), clearDashboardWidgets(), addDashboardWidgetFromLens(), and removeDashboardWidgetFromLens()
showDetailModal(markerKey, data?) — opens the marker detail modal

Window exports: navigate, showDashboard, showLabs, showGenomeLens, showBodyLens, showInsightLens, showRecommendations, showLight, showCategory, showDetailModal, dashboard widget controls, and recommendation page helpers (openRecommendationDetail, discussRecommendation, saveRecommendation, dismissRecommendation)

`recommendation-actions.js`

Recommendation modal and action handlers shared by dashboard cards and the Recommendations page. It keeps option-detail rendering, chat prompts, saved/bookmarked state, and dismissed state out of the main route facade. Key exports:

createRecommendationActions(deps) — returns openRecommendationDetail(), discussRecommendation(), saveRecommendation(), and dismissRecommendation()

`light-page-view.js`

Light & Sun page shell, Light Today strip, dashboard Light channel pills, Light session log actions, page widget assembly, and async population of page-only Light workbench sections. It imports shared lens chrome from lens-page-shell.js, condition rendering from light-conditions-now.js, session history from light-sessions-view.js, and channel rows/suggestions from light-channel-view.js. Key exports:

showLight(data?) — renders the reorderable Light & Sun page widgets
renderLightTodayStrip() — legacy compact Light strip used by embedded/welcome surfaces
renderLightChannelsLive() — refreshes the live channel-pills slot after session updates
renderDashboardLightChannelPills() / renderLightSessionLogActions() — dashboard widget helper bodies shared through dashboard-widget-renderers.js
_expandLightToolsSection() — compatibility handler for expanding the collapsed Light tools placeholder

`light-channel-view.js`

Light channel pill rows, seven-day sparklines, dashboard-to-Light channel navigation, per-channel drill-down panels, citations, source mix, and channel suggestions. light-page-view.js imports the render helpers; views.js keeps the legacy window._toggleChannelDetail / window._openChannelOnLightPage wiring for inline handlers and dashboard widgets. Key exports:

mergeTotals(a, b) — combines sun and device channel totals
renderChannelPills(totals7d, totals30d) — renders the interactive Light page channel row and detail slot
_toggleChannelDetail(channelKey) / _openChannelOnLightPage(channelKey) — compatibility handlers for expanding channel detail panels
renderSuggestion(totals7d) — fallback channel-guidance copy when AI synthesis is unavailable

`main.js`

Thin module entry point. Imports startup feature side effects, then starts the startup orchestrator. Responsibilities:

Imports app-feature-modules.js for startup-loaded feature side effects and window exports
Calls startApp() from startup-orchestrator.js

Window exports: none (all exports come from other modules)

`app-feature-modules.js`

Startup-loaded feature side-effect imports extracted from main.js. This module preserves the previous feature import order while keeping main.js focused on startup orchestration. Foundation/privacy imports are grouped behind app-foundation-modules.js; the Health & Data feature cluster is grouped behind app-health-data-modules.js; the Light & Sun feature cluster is grouped behind app-light-sun-modules.js; the import/export feature cluster is grouped behind app-data-io-modules.js; the AI/chat/settings feature cluster is grouped behind app-ai-interaction-modules.js; the UI shell feature cluster is grouped behind app-ui-shell-modules.js. Key exports: none Window exports: none directly; imported feature modules attach their existing compatibility handlers.

`app-foundation-modules.js`

Startup-loaded foundation/privacy side-effect imports extracted from app-feature-modules.js. This module preserves the previous schema/constants/utils/pii import order while keeping the top-level feature list as named startup clusters. Key exports: none Window exports: none directly; imported foundation modules attach their existing compatibility handlers.

`app-health-data-modules.js`

Startup-loaded Health & Data feature side-effect imports extracted from app-feature-modules.js. This module preserves the previous charts/notes/supplements/recommendations/cycle/context/DNA/wearables import order while keeping the top-level feature list easier to scan. Key exports: none Window exports: none directly; imported Health & Data modules attach their existing compatibility handlers.

`app-light-sun-modules.js`

Startup-loaded Light & Sun feature side-effect imports extracted from app-feature-modules.js. This module preserves the previous Light & Sun import order while keeping the top-level feature list easier to scan. Key exports: none Window exports: none directly; imported Light & Sun modules attach their existing compatibility handlers.

`app-data-io-modules.js`

Startup-loaded import/export feature side-effect imports extracted from app-feature-modules.js. This module owns the compatibility startup load for data export/import handlers while keeping the top-level feature list as named startup clusters. Key exports: none Window exports: none directly; imported data I/O modules attach their existing compatibility handlers.

`app-ai-interaction-modules.js`

Startup-loaded AI/chat/settings feature side-effect imports extracted from app-feature-modules.js. This module preserves the previous chat/image/settings/lens/provider helper import order while keeping the top-level feature list easier to scan. Key exports: none Window exports: none directly; imported AI interaction modules attach their existing compatibility handlers.

`app-ui-shell-modules.js`

Startup-loaded UI shell feature side-effect imports extracted from app-feature-modules.js. This module preserves the previous feedback/tour/touch-tooltip/client-list/views import order while keeping the top-level feature list easier to scan. Key exports: none Window exports: none directly; imported UI shell modules attach their existing compatibility handlers.

`startup-orchestrator.js`

Startup global wiring and phase ordering. Runs once, installs app-wide startup hooks, and registers the DOMContentLoaded startup sequence. Responsibilities:

Sets the _getActiveProfileId startup global
Installs lazy EMF window handlers through emf-facade.js
Installs app-wide event and refresh wiring through app-event-listeners.js
Delegates encryption, backup, and meteo bootstrap to startup-foundation.js
Initializes startup profile data
Delegates startup service boot and post-profile maintenance to startup-maintenance.js
Delegates wearable/OpenRouter callback routing to startup-oauth-callbacks.js
Delegates first-render UI bootstrap to startup-ui.js

Key exports:

startApp() — idempotently installs startup globals/listeners and registers the startup sequence

Window exports: _getActiveProfileId

`emf-facade.js`

Lazy window facade for the EMF assessment module extracted from main.js. It installs async window.* handlers for EMF editor and assessment actions, then imports emf.js on first use and replaces the facade handlers with the real module exports. Key exports:

EMF_LAZY_WINDOW_FUNCTIONS — list of EMF window handlers covered by the lazy facade
installEMFLazyFacade() — installs lazy handlers during app startup

Window exports: EMF handler names from EMF_LAZY_WINDOW_FUNCTIONS

`startup-foundation.js`

Blocking startup foundation extracted from main.js: encryption unlock, decrypted meteo config cache hydration, cross-tab broadcast setup, and folder backup handle restoration. Key exports:

initializeStartupFoundation() — runs the blocking security/storage bootstrap before wearable services or profile data load

Window exports: none

`startup-profile.js`

Profile startup bootstrap extracted from main.js: legacy v1 profile migration, encrypted profile-cache warmup, active-profile imported-data load, and unit/sex/range/DOB display state. Key exports:

initializeProfileData() — creates the default profile for legacy users, migrates old imported data through encrypted storage, warms the profile cache, sets state.currentProfile, and loads active imported data before OAuth callbacks can persist profile-scoped data
applyProfileDisplayState() — applies saved units/range mode plus sex/DOB metadata to state and the startup toggle controls

Window exports: none

`startup-oauth-callbacks.js`

Startup OAuth callback routing extracted from main.js. Wearable callbacks run first after profile load; if they do not consume the URL code, OpenRouter OAuth handles the same ?code=/state pair. Key exports:

handleStartupOAuthCallbacks() — delegates wearable OAuth callback handling, exchanges OpenRouter codes with state verification, stores the OpenRouter key, switches the active AI provider, and opens chat after init

Window exports: none

`startup-maintenance.js`

Non-blocking startup maintenance extracted from main.js: wearable runtime config/scheduler boot, sun session self-heal, light-device preset hydration, and legacy biometrics migration. Key exports:

initializeStartupServices() — starts wearable runtime config loading and scheduler setup before profile data loads
runPostProfileStartupMaintenance() — schedules post-profile maintenance jobs without blocking OAuth callbacks or first render

Window exports: none

`startup-ui.js`

First-render UI bootstrap extracted from main.js: profile display state, theme, footer version, sidebar, sync indicator, initial navigation, deferred sync/catalog warmup, changelog, startup nudges, deferred settings/chat opens, header chrome, chat attachment handlers, and file-picker import binding. Key exports:

renderStartupUI() — runs the initial UI render and schedules non-blocking startup UI work after profile/OAuth startup completes

Window exports: none

`app-event-listeners.js`

App-wide browser event wiring that used to live in main.js: modal wheel guards, backdrop click handling, global role-button keyboard activation, Escape/Tab modal behavior, app shortcuts, and the registerRefreshCallback() bridge back into navigate(state.currentView || 'dashboard'). Key exports:

installGlobalEventListeners() — idempotently installs document-level modal, keyboard, shortcut, and click handlers
registerAppRefreshCallback() — registers the data refresh callback that rebuilds sidebar state and re-renders the active route

`tour.js`

Generic spotlight tour engine plus the app tour and cycle tour configurations. Key exports:

runTour(steps, storageKey, auto) — generic engine: creates #tour-overlay, #tour-spotlight, #tour-tooltip; filters steps with missing targets; navigates with Back/Next/Skip/Done
startTour(auto) — launches the 7-step app tour (auto=true checks completion flag first)
startCycleTour(auto) — launches the 8-step cycle-specific tour
endTour() — removes tour DOM elements, stores completion flag
CYCLE_TOUR_STEPS — array of 8 step configs for the cycle tour

Window exports: startTour, startCycleTour, endTour

`changelog.js`

What’s New modal triggered on version bump so users see what changed after each PWA update. Key exports:

APP_VERSION — number matching the SW cache version (e.g., 53)
openChangelog(showAll) — renders and shows the modal; showAll=true shows all entries, false shows latest 3
closeChangelog() — hides modal, marks current version as seen in localStorage
maybeShowChangelog() — auto-trigger: shows modal if labcharts-changelog-seen !== APP_VERSION

Window exports: openChangelog, closeChangelog, maybeShowChangelog

`client-list.js`

Client List modal for managing multiple profiles. Key exports:

openClientListModal() / closeClientListModal() — modal lifecycle
renderClientList(query?, sortBy?) — renders searchable, sortable profile list with inline create/edit form
Per-profile actions: archive, flag, pin, delete, per-client export

Window exports: openClientListModal, closeClientListModal, createClientInline, saveClientInline, toggleArchiveClient, toggleFlagClient, togglePinClient, deleteClient, exportClientJSON

`recommendations.js`

Supplement, lifestyle, light-device, and EMF affiliate recommendations driven by a lazy-loaded catalog. Region-aware: products + URLs + coupons are filtered by user country via a single hierarchy chain (CZ → EU → INTL etc.). The global Recommendations page is rendered by lens-pages.js, while dashboard-widgets.js registers the dashboard surface and dashboard-widget-renderers.js owns its dashboard renderer; this module owns catalog loading, slot rendering, disclosure state, product filtering, and DNA/wearable slot helpers. Key exports:

loadCatalog() — lazy-loads data/recommendations.json on first call
getUserRegion() — derives region code (CZ/SK/DE/AT/EU/US/INTL) from profile country
regionLookupChain(region) — returns the lookup chain (most-specific → INTL); used by both product visibility filter and per-region map resolution
getProductsForSlot(catalog, slotKey, region) — region-filtered products
_resolveCouponForRegion, _resolveHomepageForRegion, _resolveProductUrlForRegion — pick from per-region maps using the chain
_addUTMParams(url, content, campaign) — partner-dashboard attribution
renderRecommendationSection(slotKey, opts) — renders the “What can help” section in the detail modal
renderEMFMeterRecs(catalog, opts) / renderEMFMitigationRecs(catalog, tags, opts) — EMF panel surfaces

Window exports: none (called via imports from views.js, chat.js, context-cards.js)

`crypto.js`

Data encryption at rest and cross-tab sync. Key exports:

encryptedSetItem(key, value) / encryptedGetItem(key) — AES-256-GCM via PBKDF2 passphrase
getEncryptionEnabled() / setEncryptionEnabled(bool) — encryption toggle
validatePassphrase(p) — checks 4 strength rules (8+ chars, lowercase, uppercase, special), returns { valid, message }
broadcastDataChanged(profileId) — BroadcastChannel message for multi-tab sync
SENSITIVE_PATTERNS — array of localStorage key pattern strings that get encrypted

Window exports: setEncryptionEnabled, changePassphrase, exportBackup, importBackup

`backup.js`

IndexedDB auto-backup, folder backup via File System Access API, and backup restore. Extracted from crypto.js. Key exports:

scheduleAutoBackup() — debounced 60s trigger; saves up to 5 snapshots to IndexedDB + writes to folder backup if configured
buildBackupSnapshot() — captures all importedData + per-profile preferences
loadBackupSnapshots() — async; populates the Backup & Restore section with IndexedDB snapshots
restoreAutoBackup(id) — writes snapshot to localStorage, reloads
saveFolderBackup(snapshot) — writes getbased-backup-latest.json + daily dated snapshot to user-selected folder via File System Access API

Window exports: restoreAutoBackup, pickBackupFolder, showBackupReminder

`lab-context.js`

Central AI context serializer. Extracted from chat.js. Key exports:

buildLabContext() — serializes all lab entries + all 9 context cards + interpretiveLens + contextNotes + cycle data + notes into a structured AI context string

Window exports: buildLabContext

`markdown.js`

Block-aware markdown parser for chat rendering. Extracted from chat.js. Key exports:

renderMarkdown(text) — block-aware parser: headings, lists, code blocks, HR, paragraphs + inline formatting

Window exports: renderMarkdown

`provider-panels.js`

AI provider settings behavior for the settings modal. Owns provider selection, key validation flows, provider model dropdown refresh, balances, and local-model advisor wiring. Imports provider-panel-renderers.js for provider-specific Settings → AI panel markup. Key exports:

renderAIProviderPanel(provider) — returns the active provider configuration panel HTML
switchAIProvider(provider) — persists provider choice and refreshes the settings panel
Provider key/model helpers for Venice, OpenRouter, Routstr, PPQ, Custom API, and local OpenAI-compatible servers

Window exports: provider panel handlers used by Settings HTML onclick attributes, including imported Routstr wallet handlers from provider-wallet-panels.js

`provider-panel-renderers.js`

Provider-specific Settings → AI panel markup for OpenRouter, Routstr, Venice, PPQ, Custom, and Local AI. Keeps static panel HTML and cached-model select markup separate from provider validation, balance polling, and local-model advisor behavior. Window exports: none directly. renderAIProviderPanel() is re-exported and attached to window by provider-panels.js.

`provider-wallet-panels.js`

Routstr/Cashu wallet UI and node funding actions used inside the Routstr provider panel. Extracted from provider-panels.js so wallet deposit, withdrawal, seed backup/restore, mint switching, and node deposit/refund behavior are isolated from general provider key/model rendering. Key exports:

configureRoutstrWalletPanels(callbacks) — injects provider-panel callbacks without introducing a circular module import
routstrWalletActionButtons(active) / buildRoutstrNodeActions(nodeUrl, hasKey, active) — render the wallet and node action controls used by the Routstr panel
doRoutstrWalletFund() / doRoutstrNodeDeposit() / doRoutstrNodeWithdraw() / withdraw and restore helpers — Cashu wallet and Routstr node action handlers

Window exports: exported through provider-panels.js for legacy inline handlers.

`provider-qr.js`

Shared QR-code loader for provider payment surfaces. Key exports:

ensureQRCode() — lazy-loads /vendor/qrcode-generator.js and returns the global qrcode factory

`lens.js`

Knowledge Base / Interpretive Lens — RAG endpoint config + multi-query rewrite + dedicated modal. Two backends under one UI: 'in-browser' (transformers.js + OPFS via lens-local.js) and 'external-server' (user-configured URL + Bearer key). Key exports:

hasLens() — true when a lens is configured AND has indexed content
queryLens(hint, opts?) — single-query retrieval; routes to in-browser worker or remote server based on backend
queryLensMulti(hint, opts?) — multi-query orchestrator: rewrites the query into N=3 paraphrases via the active LLM, fans out to queryLens for each, fuses results with reciprocal-rank scoring (k=60). Falls back to single-query when no AI provider, when rewrite fails, when query is <3 words, or when the toggle is off
getLensConfig() / saveLensConfig(partial) / getLensKey() / saveLensKey(key)
getLensSummary() — synchronous status object {configured, backend, displayName, docCount, chunkCount, multiQueryOn, aiAvailable} used by the dashboard KB row
openKnowledgeBaseModal() / closeKnowledgeBaseModal() — dedicated modal that wraps renderCustomLensSection(). Replaces the previous Settings → AI inline section
buildLensSnippet(chunks, sourceName) — formats retrieved chunks for AI prompt injection
testLensConnection() / clearLensCache()
renderCustomLensSection() — full settings markup (URL/key inputs, backend toggle, library picker, ingest UI, multi-query toggle); rendered inside the KB modal
_resetRewriteCache() / _fuseChunksRRFForTest() / _dedupeQueriesForTest() — test surface

Window exports: hasLens, queryLens, queryLensMulti, buildLensSnippet, testLensConnection, clearLensCache, openKnowledgeBaseModal, closeKnowledgeBaseModal, plus all the in-modal save/toggle/library handlers

`wearable-adapters.js`

Canonical wearable-metric registry + per-vendor adapter registry. Source of truth for OAuth client IDs, redirect URIs, scopes, and metric → endpoint mappings. Key exports:

ADAPTERS — array of {id, displayName, authType, oauth?, apiHost?, metrics, accountInfo?} for the 8 supported sources (Oura / Withings / Ultrahuman / WHOOP / Fitbit / Polar / Apple Health / manual)
CANONICAL_METRICS — {id: {label, sub, unit, worseWhen}} for every metric the strip can render
DEFAULT_METRIC_ORDER — preferred order when multiple sources contribute
adapterById(id) / visibleAdapters(connectedIds) / adapterSupportsMetric(adapterId, metricId) / metricsForSources(sourceIds) / canonicalMetric(id)
applyOAuthOverrides(map) — merges a {adapterId: clientId} map into the runtime override store; called from loadWearableRuntimeConfig()
getOAuthClientId(adapterOrId) — returns the runtime override if set, falling back to the adapter’s hardcoded oauth.clientId. Every consumer reads through this helper so self-host overrides apply uniformly
_resetOAuthOverrides() — test surface

Window exports: none

`wearables-connect.js`

Connect/disconnect/backfill orchestration. OAuth dispatch table, scheduled stale-source sync, runtime config bootstrap. Key exports:

OAUTH_DISPATCH — {adapterId: {begin, isCallback, complete, withFreshToken, fetchAccountInfo, fetchRange, displayName, postConnect?, commitAfterWrite?}} — generic OAuth orchestration table
beginConnectOAuth(adapterId) — kicks off the auth flow; reads clientId via getOAuthClientId(adapter)
handleOAuthCallbackOnLoad() — runs via startup-oauth-callbacks.js init; reads pending.clientId from sessionStorage (set at begin time, NOT from runtime config)
getConnection(adapterId) / listConnectedSources() / disconnectAdapter(adapterId)
syncNow(adapterId, opts?) / forceBackfill(adapterId, days)
initWearableScheduler() — visibility-change + 6h interval poll; awaits runtimeConfigReady() before first sync to prevent race against override fetch
loadWearableRuntimeConfig() — POSTs {wearable_runtime_config: true} to /api/proxy, applies the returned *_CLIENT_ID overrides via applyOAuthOverrides. Memoized as a promise raced against a 1.5s soft timeout

Window exports: none

Wearables vendor adapters

Each connected source ships as a pair: wearables-<vendor>.js (read API) + wearables-<vendor>-auth.js (OAuth dance). Apple Health and Manual skip the auth half — Apple is file-import only, Manual is fully local. Tokens never leave the device; sync-payload.js strips wearableConnections from the synced payload (and again on pull as defense-in-depth). OAuth2 (server-side secret): wearables-oura.js + …-oura-auth.js, …-withings.js + …-withings-auth.js, …-ultrahuman.js + …-ultrahuman-auth.js, …-polar.js + …-polar-auth.js. Secrets live in .env.local + /api/proxy. OAuth2 PKCE (no secret): wearables-whoop.js + …-whoop-auth.js, wearables-fitbit.js + …-fitbit-auth.js. Code verifier + S256 challenge per the IETF spec. No OAuth: wearables-apple-health.js (file-import — parseAppleHealthXml reads the export.xml from a Health zip), wearables-manual.js (logManualMetric / logManualBP + MANUAL_TAGS whitelist for what users can log by hand). L1 storage + summary derivation: wearables-store.js (per-profile IndexedDB at labcharts-wearables-{profileId}; two-phase upsertDailyBatch), wearables-summary.js (L2 derivation; vendor sources read a 90-day window, while sparse manual rows read all history so older hand-entered BP/pulse/weight entries stay visible; write gate — 5% d7 shift / trend flip / 14d force-refresh / source flip / metric removal triggers). UI surface: wearables.js (dashboard strip, source picker, reorder mode, empty-card manual-log forms, and legacy window facade), wearables-detail-modal.js (metric detail modal, Chart.js series, manual-entry list/add/delete, focus trap, EMF sleep nudge), wearables-formatters.js (shared value/date formatting), wearables-manual-form-ui.js (shared manual chip/note form snippets), wearables-settings-panel.js (Settings → Wearables rows, connect/sync/backfill/disconnect actions, Apple Health file-import UI, manual-source counts/delete action, strip visibility toggle), brand-assets.js (per-vendor logo registry — iconLight/Dark for in-app rows, signInLight/Dark for landing-site Connect buttons, mono SVG fallback while a vendor logo is gated).

Knowledge Base in-browser stack

lens.js is the dispatcher; the 4 sibling lens-local-* modules are the in-browser implementation. The dispatcher routes between in-browser and external-server backends per the user’s selection.

lens-local.js — main-thread shell: spawns a module worker, posts ingest/query/list/activate/delete messages, exposes a Promise-based API to lens.js.
lens-local-worker.js — module worker. Loads transformers.js (currently from jsdelivr — see update-vendor.sh notes), runs WebGPU embedding when available with WASM fallback, owns OPFS persistence (FileSystemSyncAccessHandle), library CRUD, MMR re-rank (λ named MMR_LAMBDA), per-library model selection from a 4-model catalog.
lens-local-utils.js — pure helpers: chunkText, mmrSelect, hashing, vector-pack helpers. Importable from both threads.
lens-local-parsers.js — main-thread document parsers (PDF via pdfjs-loader.js, DOCX via mammoth, ZIP via JSZip, plus plain text/markdown/CSV).

Other recently-extracted modules

Not separately documented because their exports are best read from source — kept thin on purpose.

chat-images.js — image attachment lifecycle (getPendingAttachments, clearAttachments, etc.). Owns the _pendingAttachments queue. Extracted from chat.js in v1.21.9.
chat-threads.js — conversation thread CRUD, list rendering, autoname, onChatSaved debounce trigger. Extracted in v1.21.9.
markdown.js — XSS-safe markdown rendering (applyInlineMarkdown for spans, renderMarkdown for full blocks). 34 dedicated XSS test assertions.
lab-context.js — lab-data → AI-prompt context assembly; memoized via fingerprint that includes wearable summary, change history, and all 9 context cards.
provider-panels.js — Settings → AI provider behavior, validation, balances, dropdown refresh, globals.
provider-panel-renderers.js — Settings → AI per-provider panel markup (Venice / OpenRouter / Routstr / PPQ / Local AI / Custom).
pdfjs-loader.js — cached dynamic import of vendored pdf.js ESM. Pins isEvalSupported: false defense-in-depth on every getDocument call.
sun-body-silhouette.js — anatomical sun-session body-region picker, stock-figure region-map hit testing, and async selection overlay. Re-exported by sun.js for compatibility.
sun-active-session.js — quick-log/start modal, live active-session ticker, Simpson live-dose integration, and active-session compatibility handlers. Dependency-injected from sun.js so persistence and hydration stay in the owner module.
sun-session-ui.js — saved sun-session row/detail rendering, detailed past-session modal, channel chips, delete, and edit-duration UI. Dependency-injected from sun.js so storage, hydration, and dose math stay in the owning module.
light-device-setup-modal.js — add-device preset picker, custom-device form, and URL/photo AI spec extraction. Dependency-injected from light-devices.js so device persistence and channel defaults stay in the owning module.
light-device-session-modal.js — log/start light therapy device session modal; dependency-injected from light-devices.js so session persistence and active timer state stay in the owning module.
light-env-audits.js — saved Light Environment snapshots, audit comparison renderer, and audit-specific window handlers. Dependency-injected from light-env.js so rooms/screens remain owned by the environment module.
light-env-evening.js — canonical room after-sunset exposure helpers; normalizes legacy boolean room rows to numeric eveningHoursAfterSunset while leaving screen eveningUseAfterSunset numeric.
light-tool-camera.js / light-tool-camera-modals.js — shared camera lock, row-banding, aiming guides, lux calibration, and the camera-backed Light tool modal flows. Dependency-injected from light-tools.js so measurement persistence stays in the owning module.
supplement-warnings.js / food-contaminants.js — keyword scanners that build “harm flag” lists for the AI context.
emf.js — Baubiologie SBM-2015 EMF assessment as a sub-module of the Environment context card.
sync.js — Public sync entry/barrel; exports sync lifecycle, actions, diagnostics, relay, identity, and cutover APIs while delegating dependency wiring to sync-configure.js.
sync-configure.js — Sync subsystem dependency wiring; configures relay health, push/pull/subscription/tombstone/diagnostic/UI/action/recovery/reconcile modules and browser window bindings.
sync-push.js — outbound profile push path, in-flight push watchdog, Phase 2 drift auto-revert, and Evolu profileData insert/update.
sync-push-deltas.js — push-side per-row delta planning/application; walks DELTA_ARRAYS/MAPS/SCALARS before blob writes, advances snapshots after onComplete, and records delta telemetry.
sync-pull.js — inbound pull orchestration and row loop; delegates one-time cleanup, active-profile UI refresh, and rebroadcast scheduling to helper modules.
sync-pull-merge.js — pull row recovery/dedupe, importedData blob/per-row merge, wearable-token preservation, metadata-only genetics blob protection, and profile metadata merge helpers.
sync-pull-maintenance.js — pull-path one-time migrations such as stale -sync-hash localStorage cleanup.
sync-pull-active-refresh.js — active-profile in-memory update, migration, chat reload, sidebar rebuild, current-view refresh, toast, and sync-applied event after a pull.
sync-pull-rebroadcast.js — pull-side rebroadcast gating, budget checks, push-pending guard, and delayed active-profile push scheduling.
data-merge.js — importedData blob merge helpers, shared record freshness comparison, tombstone state merge, and sync-aware array mutation helpers (appendImportedArrayItem, replaceImportedArrayItem, deleteImportedArrayItem, deleteImportedArrayItems, clearImportedArray) used by feature modules so identity edits/deletes record the right tombstones before the next sync push.
sync-cutover.js — readiness-gated Phase 2 lean-sync cutover enable/disable bridge over payload flags and delta readiness.
sync-delta.js — per-row CRDT delta facade; config fan-out, apply helpers, and compatibility re-exports for planners, snapshots, merge, telemetry, and readiness.
sync-delta-planners.js — push-side planner facade; configures shared planner dependency context and compatibility re-exports for array/map/scalar planners.
sync-delta-planner-context.js — shared Evolu/itemRow query dependency access for push-side delta planners.
sync-delta-array-planner.js — push-side array planner; diffs array items against snapshots and emits itemRow insert/update/tombstone ops with tombstone-storm protection.
sync-delta-map-planner.js — push-side keyed-map planner; diffs keyed objects against snapshots, preserves original raw keys in payloads, and guards genetics SNP empty-map races.
sync-delta-scalar-planner.js — push-side scalar planner; handles singleton fields, most-recent canonical row selection, and null-transition tombstones.
sync-delta-snapshot.js — delta snapshot keying, reads, plannedAt-gated writes, and snapshot clear helpers.
sync-delta-merge.js — pull-side itemRow grouping and merge-shape dispatch into importedData after blob merge.
sync-delta-merge-shapes.js — pull-side row overlay facade; compatibility re-exports for array/map/scalar merge helpers.
sync-delta-row-codec.js — shared itemRow payload decoder for pull-side delta merge helpers, including gzip envelope handling.
sync-delta-array-merge.js — pull-side array row overlay helper; owns item tombstones, nested-path writes, dedupe, composite caps, and pull delta telemetry.
sync-delta-map-merge.js — pull-side keyed-map row overlay helper; owns raw-key preservation, synth-id tombstones, proto guards, nested-path writes, and pull delta telemetry.
sync-delta-scalar-merge.js — pull-side scalar row overlay helper; owns singleton LWW selection, null tombstones, dotted-path writes, genetics SNP preservation, and pull delta telemetry.
sync-delta-registry.js — delta registry facade; compatibility re-exports for surfaces, per-surface config, and identity helpers.
sync-delta-surfaces.js — DELTA_ARRAYS/MAPS/SCALARS importedData surface lists for per-row sync.
sync-delta-surface-config.js — per-surface itemId/keyId overrides for array/map delta planners and pull overlays.
sync-delta-id.js — shared per-row identity helpers, stable hash, allowlist guard, and proto-pollution key rejection.
sync-delta-observability.js — delta observability facade; compatibility re-exports for telemetry, pull snapshots, readiness, and injected Evolu query access.
sync-delta-observability-context.js — shared Evolu/itemRow query dependency access for delta observability helpers.
sync-delta-pull-snapshot.js — in-memory pull-side row-count snapshots for Sync Diagnose delta replication checks.
sync-delta-telemetry.js — per-push delta telemetry storage, aggregation, reset, and latest pull-snapshot reporting.
sync-delta-readiness.js — Phase 2 cutover readiness checks across array/map/scalar delta surfaces.
sync-apply.js — inbound sync apply helpers for AI provider settings and display prefs, with compatibility re-exports for chat apply helpers.
sync-chat-apply.js — inbound chat thread/message application, chat delete tombstones, and local freshness locks that protect just-edited local chat from stale remote rows.
sync-tombstones.js — remote profile delete propagation helpers, inbound tombstone application, batched-delete quarantine, and apply/reject pending tombstone actions for Settings.
sync-messenger.js — Agent Access token/context-key helpers, owner-bound encrypted context writes, revoke helpers, and debounced lab-context push to the Agent Access context gateway.
sync-environment.js — relay URL selection, relay connectivity probing, and browser capability checks for Evolu sync.
sync-identity.js — BIP-39/QR lazy loaders plus mnemonic read/restore helpers for Evolu owner identity.
sync-diagnostics.js — Evolu diagnostics facade; stable exports for configuration, row snapshots, and copy-text formatting.
sync-diagnostics-context.js — Injected Evolu/query/subscription state accessors for sync diagnostics.
sync-diagnostics-snapshot.js — Evolu row diagnostics snapshot assembly, including live/tombstone rows, active imported counts, delta telemetry, and lean-sync readiness.
sync-diagnostics-text.js — Plain-text Sync Diagnose copy formatting for support/debug handoff.
sync-diagnose-ui.js — Sync Diagnose modal lifecycle, copy snapshot handling, and compatibility re-exports for Diagnose action handlers.
sync-diagnose-render.js — Pure Sync Diagnose panel/table markup for identity, relay health, relay storage, delta telemetry, lean-sync readiness, and local Evolu rows.
sync-diagnose-actions.js — Sync Diagnose action facade; keeps the public imports stable while delegating to focused action modules.
sync-diagnose-actions-context.js — Shared injected dependencies for Diagnose actions, including sync enable/restore, push, cutover toggles, and modal refresh.
sync-diagnose-relay-actions.js — Sync Diagnose relay storage refresh and self-serve compaction handlers.
sync-diagnose-identity-actions.js — Sync Diagnose identity rotation modal, BIP-39 mnemonic generation, QR display, copy fallback, and local apply flow.
sync-diagnose-cutover-actions.js — Sync Diagnose telemetry reset plus lean-sync enable/backfill/disable handlers.
sync-actions.js — user-triggered sync actions, all-profile initial push, and compatibility re-exports for save hooks and storage cleanup.
sync-save-hooks.js — save/chat/profile-metadata debounce hooks, AI-setting push scheduling, per-profile timer cleanup, and profile importedData reads for initial push.
sync-storage-cleanup.js — emergency sync storage compaction; clears model-list caches, trims oversized changeHistory, saves the active profile, and reports freed bytes.
sync-ui.js — header sync badge, popover rendering, status subscription, and activity-log copy helpers.
sync-payload-collectors.js — Local AI/chat/display settings collection for sync payloads, including synced setting allowlists and chat thread tombstone keys.
sync-payload.js — Evolu wire-payload helpers; outbound envelope assembly, Phase 2 cutover payload shape, gzip envelope handling, inbound payload parsing, and local-only data stripping for wearable credentials and SNP map rows.
sync-relay-health.js — Evolu relay helper boundary; client-side quota estimate, signed /self/owner-storage and /self/compact-owner calls, and push-landed health verdict for the silent-reject detector.
sync-state.js — in-memory sync status pub-sub, header badge display-state derivation, recent sync activity ring buffer, and per-profile rebroadcast budget guard.

Architecture

Cross-module patterns

​Module Reference

​Layer 1 — Foundation

​schema.js

​adapters.js

​constants.js

​state.js

​utils.js

​Layer 2 — Core Services

​modal-lifecycle.js

​theme.js

​hardware.js

​api.js

​api-transport.js

​cashu-wallet.js

​nostr-discovery.js

​Layer 3 — Data & Profile

​profile.js

​data.js

​marker-analysis.js

​pii.js

​image-utils.js

​Layer 4 — Domain Modules

​charts.js

​notes.js

​supplements.js

​cycle.js

​context-cards.js

​context-card-summaries.js

​context-card-editor-ui.js

​context-card-medical-history-editor.js

​context-card-lifestyle-editors.js

​Layer 5 — Feature Modules

​dna.js

​pdf-import.js

​pdf-import-preflight.js

​pdf-import-progress.js

​pdf-import-marker-normalization.js

​pdf-import-persistence.js

​pdf-import-review.js

​import-drop-zone.js

​import-file-input.js

​export.js

​profile-share.js

​chat.js

​chat-window-bindings.js

​chat-marker-prompts.js

​chat-send.js

​chat-render.js

​chat-empty-state.js

​chat-panel.js

​chat-nudge.js

​chat-onboarding.js

​chat-discussion.js

​chat-discussion-flow.js

​chat-discussion-lifecycle.js

​chat-discussion-turns.js

​chat-discussion-callbacks.js

​chat-discussion-round-runner.js

​chat-discussion-round-prompts.js

​chat-discussion-round-request.js

​chat-discussion-round-state.js

​chat-discussion-round-view.js

​chat-discussion-ui.js

​chat-discussion-picker.js

​chat-discussion-state.js

​chat-personalities.js

​chat-history.js

​chat-thread-search.js

​chat-actions.js

​chat-icons.js

​chat-attestation.js

​chat-continuation.js

​chat-prompt-context.js

​chat-summaries.js

​settings.js

​settings-sync-panel.js

​settings-agent-access-panel.js

​feedback.js

​nav.js

​Layer 6 — Orchestration

Module Reference

Layer 1 — Foundation

`schema.js`

`adapters.js`

`constants.js`

`state.js`

`utils.js`

Layer 2 — Core Services

`modal-lifecycle.js`

`theme.js`

`hardware.js`

`api.js`

`api-transport.js`

`cashu-wallet.js`

`nostr-discovery.js`

Layer 3 — Data & Profile

`profile.js`

`data.js`

`marker-analysis.js`

`pii.js`

`image-utils.js`

Layer 4 — Domain Modules

`charts.js`

`notes.js`

`supplements.js`

`cycle.js`

`context-cards.js`

`context-card-summaries.js`

`context-card-editor-ui.js`

`context-card-medical-history-editor.js`

`context-card-lifestyle-editors.js`

Layer 5 — Feature Modules

`dna.js`

`pdf-import.js`

`pdf-import-preflight.js`

`pdf-import-progress.js`

`pdf-import-marker-normalization.js`

`pdf-import-persistence.js`

`pdf-import-review.js`

`import-drop-zone.js`

`import-file-input.js`

`export.js`

`profile-share.js`

`chat.js`

`chat-window-bindings.js`

`chat-marker-prompts.js`

`chat-send.js`

`chat-render.js`

`chat-empty-state.js`

`chat-panel.js`

`chat-nudge.js`

`chat-onboarding.js`

`chat-discussion.js`

`chat-discussion-flow.js`

`chat-discussion-lifecycle.js`

`chat-discussion-turns.js`

`chat-discussion-callbacks.js`

`chat-discussion-round-runner.js`

`chat-discussion-round-prompts.js`

`chat-discussion-round-request.js`

`chat-discussion-round-state.js`

`chat-discussion-round-view.js`

`chat-discussion-ui.js`

`chat-discussion-picker.js`

`chat-discussion-state.js`

`chat-personalities.js`

`chat-history.js`

`chat-thread-search.js`

`chat-actions.js`

`chat-icons.js`

`chat-attestation.js`

`chat-continuation.js`

`chat-prompt-context.js`

`chat-summaries.js`

`settings.js`

`settings-sync-panel.js`

`settings-agent-access-panel.js`

`feedback.js`

`nav.js`

Layer 6 — Orchestration