Bogieflow Research Paper (TRB 2027 draft)

Climate-Fused Multi-Agent Digital Twin for Predictive Track-Bed Maintenance in Monsoon Rail Corridors. Author: Hansraj Tiwari. Simulation-validated reference architecture.

v1.7.0 — Real-data ML model card

Summary

• Ground ML training in Open-Meteo + CWRU data with synthetic fallback
• GET /api/model/card with CV metrics and honesty badges
• ModelCardPanel on Overview
• Docker build fetches datasets and trains automatically

Live

• Frontend: https://bogieflow.vercel.app
• Backend: https://bogie-flow.onrender.com

v1.6.1

Elegant black-and-white ink & paper UI theme rebrand, overview split layout, simulated field sensors integration, and test suite expansion (91 Vitest tests).

v1.6.0

Bogie Flow v1.6.0

Repository polish release for FAR AWAY 2026 hackathon judging.

Highlights

• README storefront: badges (Pytest 42, Vitest 65), features grid, screenshot gallery, architecture diagram, honesty box, quickstart, deploy guide
• Visual assets: six PNG screenshots (four views + impact + explain) and assets/social-preview.png
• Community health: CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, SUPPORT, CITATION.cff, Dependabot, issue/PR templates
• CI: concurrency cancellation on main CI workflow; fork-safe PR review guards
• Guide UX: corridor guide launcher (chat vs walkthrough) and redesigned status bar

Run locally

git clone https://github.com/Stormynubee/Faraway2026Japan.git
cd Faraway2026Japan
python -m pip install -r requirements.txt
npm install
npm run dev:all

Open http://localhost:5173

Motion demo

Use assets/demo.mp4 locally or trigger a scenario inject from the Overview scenario menu.

Tests

• python -m pytest tests/ -q — 42 tests
• npm run test — 65 tests

v1.5.4 - Self-healing demo and non-blocking chat

Simulation decay restores segments after monsoon inject; ticket dedup with cooldown and auto-close; deterministic anomaly inject; lazy risk model cache; guide chat runs in threadpool; activeRiskIndex recomputed from segment max.

v1.5.3 - Env-driven CORS and health alias

ALLOWED_ORIGINS env for CORS, /api/health alias with segments count, pytest CORS tests, .env.example deployment vars.

v1.5.2 - Deployment-safe frontend networking

Add config.js apiUrl/wsUrl helpers, refactor all fetch and WebSocket callers, remove hardcoded localhost:8000 in production, 6 Vitest cases.

v1.5.1: Gemini Guide Chat Backend

Summary

• POST /api/guide/chat powered by Google Gemini (gemini-3.1-flash-lite default)
• Loads secrets from .env via server/env.py (.env.example committed; .env gitignored)
• Python guide unit tests for Gemini payload helpers

Setup

Copy .env.example to .env and set GUIDE_AI_API_KEY from Google AI Studio.

Test plan

• pytest tests/test_guide.py passes
• Guide chat returns AI answers when key is configured

v1.5.0: Interactive Corridor Guide

Summary

• Animated Guide FAB (Framer Motion) with chat panel and typing indicator
• 12-step spotlight tour across Overview, Analysis, Maintenance, and Climate
• Hybrid local knowledge base (guideKnowledge.js + guideChat.js)

Test plan

• npm test — guideChat tests pass
• Tour Next/Back/Skip highlights correct data-guide targets

v1.4.0: Overview Layout and Plain Language

Summary

• Calm instrument Overview: corridor command dock, briefing panel, ops strip
• Segment strip and metric bar layout polish; sparkline clipping fix
• Central uiCopy.js plain-language labels (technical detail preserved)

Test plan

• Overview grid scrolls without fighting corridor scrub
• Simulation inject and briefing actions work