Freshness diagnostics API, UI trust notes, mission control/stats updates, and deploy scripts.

Made-with: Cursor

docs/STRUCTURE.md

@@ -1,13 +1,18 @@
 # Monorepo Structure
 
+> Historical note: this file still reflects the earlier static-SPA-oriented
+> layout. The canonical live frontend is now the Next app in `frontend/src/`,
+> deployed via `./scripts/deploy-next-frontend-to-vmid5000.sh`.
+
 ## Directory Overview
 
 ### `/frontend`
 Frontend application code.
 
-- **`public/`**: Static HTML, CSS, JavaScript files served directly
-  - `index.html`: Main explorer interface
-- **`src/`**: Source files (if using build tools like webpack, vite, etc.)
+- **`public/`**: Compatibility/reference static assets
+  - `index.html`: Historical static explorer interface
+  - `explorer-spa.js`: Historical extracted SPA script
+- **`src/`**: Canonical Next.js frontend source
 - **`assets/`**: Images, fonts, and other static assets
 
 ### `/backend`
@@ -19,7 +24,8 @@ Backend services (if needed for future enhancements).
 ### `/scripts`
 Deployment and utility scripts.
 
-- **`deploy.sh`**: Deploy explorer to production
+- **`deploy-next-frontend-to-vmid5000.sh`**: Canonical frontend deploy
+- **`deploy.sh`**: Deprecated static deploy shim
 - **`test.sh`**: Test explorer functionality
 
 ### `/docs`
@@ -65,7 +71,7 @@ explorer-monorepo/
 
 ### Frontend Changes
 
-1. Edit `frontend/public/index.html` directly (current approach)
+1. Edit `frontend/src/` for the live frontend (current approach)
 2. Or set up build tools in `frontend/src/` for compiled output
 
 ### Backend Changes
@@ -77,4 +83,3 @@ explorer-monorepo/
 
 1. Add docs to `docs/` directory
 2. Update README.md as needed
-