How j33v4nz/ggl works
Chronos Coastal is a coastal-flood scenario workspace: users select a corridor and hazard inputs, run a simulation, inspect infrastructure and route impacts, and prepare or review advisories. The Python service coordinates hydrology, grid, logistics, agent analysis, and operations; a React dashboard presents the results. The hosted worker provides a browser-demo adapter for screening calculations. README-documented forecast, satellite, advisory-delivery, and evaluation capabilities are included. Some relationships rely on the README or SOURCE INDEX rather than complete source excerpts; uncertain implementation links are omitted.
Main entry points: operations.py Operations and advisories · main.py Simulation API · App.jsx Scenario dashboard · bus.py Tactical event bus
Components 26
User workspace
- Scenario dashboard
frontend/src/App.jsx - Operations dashboard
frontend/src/CoastalDashboard.jsx - Inspection and model checks
frontend/src/components/GeminiInspectorModal.jsx
Scenario modeling
- Corridors and assets
backend/app/dataset.py - Simulation API
backend/app/main.py - Compound hydrology
backend/app/hydro_engine.py - Power cascade
backend/app/grid_engine.py - Route clearance
backend/app/logistics_engine.py - Scenario simulation
backend/app/simulation.py
Agents and analysis
- Composite map tiles
backend/app/map_generator.py - Site inspection
backend/app/swarm/vision_agent.py - Tactical event bus
backend/app/swarm/bus.py - Scenario agents
backend/app/swarm/hydro_agent.py - Incident action plan
backend/app/swarm/apex_agent.py - Model diagnostics
backend/app/evals/runner.py - Gemini vision service
Operations and records
- Operations and advisories
backend/app/operations.py - Snapshots and receipts
backend/app/storage.py - Open-Meteo forecasts
- Earth Engine observations
- In-app test inbox
- Advisory webhook
Hosted demo
- Hosted request adapter
worker/index.mjs - Hosted screening engine
worker/engine.mjs - Session-scoped D1
Other components
- Workspace user
Connections 35
- Workspace user → Scenario dashboard: sets scenario
frontend/src/App.jsx - Scenario dashboard → Simulation API: requests simulation
frontend/src/App.jsx - Scenario dashboard → Tactical event bus: receives events
README.md - Scenario dashboard → Inspection and model checks: opens inspection
frontend/src/App.jsx - Simulation API → Scenario simulation: runs scenario
README.md - Simulation API → Tactical event bus: streams events
README.md - Simulation API → Operations and advisories: routes operations
README.md - Simulation API → Site inspection: requests inspection
backend/app/main.py - Simulation API → Model diagnostics: runs diagnostics
backend/app/main.py - Scenario simulation → Compound hydrology: computes water levels
backend/app/simulation.py - Scenario simulation → Power cascade: evaluates grid
backend/app/simulation.py - Scenario simulation → Route clearance: evaluates routes
backend/app/simulation.py - Compound hydrology → Corridors and assets: reads corridor inputs
backend/app/hydro_engine.py - Power cascade → Corridors and assets: reads corridor assets
backend/app/grid_engine.py - Route clearance → Compound hydrology: uses hydrology
backend/app/logistics_engine.py - Route clearance → Corridors and assets: reads route data
backend/app/logistics_engine.py - Site inspection → Composite map tiles: generates inspection tile
backend/app/swarm/vision_agent.py - Site inspection → Gemini vision service: requests analysis
backend/app/swarm/vision_agent.py - Site inspection → Tactical event bus: publishes findings
backend/app/swarm/vision_agent.py - Scenario agents → Tactical event bus: publishes messages
backend/app/swarm/hydro_agent.py - Incident action plan → Tactical event bus: uses agent messages
backend/app/swarm/apex_agent.py - Operations dashboard → Operations and advisories: uses operations service
- Operations and advisories → Compound hydrology: runs scenario model
backend/app/operations.py - Operations and advisories → Power cascade: runs grid model
backend/app/operations.py - Operations and advisories → Route clearance: runs route model
backend/app/operations.py - Operations and advisories → Snapshots and receipts: persists records
backend/app/operations.py - Operations and advisories → Open-Meteo forecasts: loads forecasts
README.md - Operations and advisories → Earth Engine observations: loads observations
README.md - Operations and advisories → In-app test inbox: delivers reviewed draft
README.md - Operations and advisories → Advisory webhook: dispatches advisory
README.md - Inspection and model checks → Simulation API: requests inspection and checks
- Workspace user → Operations dashboard: reviews operations
- Hosted request adapter → Hosted screening engine: runs screening calculations
worker/index.mjs - Hosted request adapter → Session-scoped D1: persists session records
README.md - Scenario dashboard → Hosted request adapter: uses hosted demo
README.md