From e670f8ae80634d1435ddae3edfe57c676ee0c8dc Mon Sep 17 00:00:00 2001
From: Myron Blair <myronblair@outlook.com>
Date: Wed, 17 Jun 2026 19:12:00 +0000
Subject: [PATCH] docs: add JS file structure after Phase 3 modularization

---
 CLAUDE.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 3024b14..ed4a3a9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -224,7 +224,17 @@ When a PHP endpoint uses `ob_start()` + `header.php` pattern, add `ob_end_clean(
 
 **Cloudflare Rocket Loader:** JARVIS uses `data-cfasync="false"` on every `<script>` tag in `index.html` (including CDN scripts like face-api.js). One untagged script is enough to trigger Rocket Loader's bootstrap, which injects `mainScript.js` and causes `SyntaxError: Identifier 'mainScriptFlag' has already been declared`. `Cache-Control: no-store, no-cache, must-revalidate, no-transform` is set in `index.php` but tag every new script with `data-cfasync="false"` anyway.
 
-**Cloudflare auto-deploy cache problem:** After pushing JS fixes, Cloudflare CDN serves stale cached files even on hard refresh. Bump the `?v=YYYYMMDD` query param on script tags in `index.html` to force a cache miss. Current version param: `?v=20260617`.
+**Cloudflare auto-deploy cache problem:** After pushing JS fixes, Cloudflare CDN serves stale cached files even on hard refresh. Bump the `?v=YYYYMMDD` query param on script tags in `index.html` to force a cache miss. Current version param: `?v=20260617b`.
+
+**JS file structure (as of 2026-06-17):**
+- `assets/js/jarvis-effects.js` — canvas particle effects, sparklines
+- `assets/js/jarvis-overlays.js` — sleep overlay, network map canvas
+- `assets/js/jarvis-app.js` — globals, init, chat, voice, system/network/HA/alerts/weather panels
+- `assets/js/panels/jarvis-arc.js` — Arc Reactor, Intel Protocol, Comms Protocol, Guardian Mode
+- `assets/js/panels/jarvis-agents.js` — Missions, Directives, Memory, Clearance, Agents tab, Sites, Vision Protocol
+- `assets/js/panels/jarvis-assistant.js` — Chat History, Command Palette, Suggestions, Mobile switcher, Topology map
+
+A SyntaxError in any panels/ file breaks only that group — other panels stay functional. `escHtml()` is defined in jarvis-arc.js (loads first) and is global to all subsequent files.
 
 ## GitHub Repos