ChronosMesh is an enterprise-grade Neuro-Symbolic Multi-Echelon Supply-Chain Digital Twin and Exact Mixed-Integer Linear Programming (MILP) Rerouting Engine. It bridges unstructured geopolitical/logistics disruption advisories and mathematically certified multi-corridor procurement allocations across multi-tier manufacturing networks (SAP S/4HANA PP/MM & global industrial OEM topologies).
Core Architectural Thesis: Generative models excel at translating noisy maritime, weather, and customs bulletins into structured shock hypotheses—but LLMs cannot solve NP-hard fixed-charge network-flow problems without violating flow conservation, supplier capacities, or anti-concentration mandates. ChronosMesh isolates unstructured parsing behind a typed
ShockConstraintPatchboundary and solves rerouting via an exact Two-Phase Tableau Simplex + Best-First Branch-and-Bound MILP engine, evaluated with a500-trial Conditional Value-at-Risk (CVaR95) Monte Carlo simulation over a synthetic disruption model.

flowchart LR
subgraph Ingestion["1. Unstructured Disruption Layer"]
ADV["Maritime / Foundry / Tariff\nDisruption Advisories"] --> PARSER["Neuro-Symbolic Signal Parser\n(Typed ShockConstraintPatch)"]
end
subgraph Twin["2. Multi-Echelon Supply-Chain Digital Twin"]
DAG["4-Tier Diamond BOM Graph\n(Tier-3 Silicon -> Final Assembly)"]
SS["Joint Stochastic Safety Stock\nz * sqrt(mu_L*sigma_D^2 + mu_D^2*sigma_L^2)"]
REI["MIT Simchi-Levi Contagion\n(TTR vs TTS Revenue-at-Risk)"]
DAG --> SS --> REI
end
subgraph OR["3. Exact Operations Research Core"]
MILP["Fixed-Charge Multi-Sourcing MILP\n(Two-Phase Simplex + Bland's Rule + B&B)"]
PARETO["3-Objective Pareto Frontier\n(Landed Cost x Lead-Time x Scope-3 CO2e)"]
CVAR["Monte Carlo Tail-Risk Engine\n(VaR95 & Expected Shortfall CVaR95)"]
MILP --> PARETO
MILP --> CVAR
end
PARSER --> Twin
PARSER --> MILP
REI --> MILP
PARETO --> API["FastAPI REST + React Control Tower\n& Downstream ERP Saga Execution"]
src/chronos_mesh/optimizer/milp_solver.py)
nodes_explored, zero optimality gap certificate).Hypothesis property-based testing against an exhaustive $2^m$ brute-force enumeration oracle (tests/test_milp_properties.py).TTR vs TTS Contagion (src/chronos_mesh/graph/topology.py)
POWERTRAIN-ECU-X9 -> MCU-MODULE-A1 + VALVE-DRIVER-B2 -> WAFER-DIE-7NM).TTR) vs. Time-to-Survive (TTS) per facility to quantify exact stockout gaps and downstream Revenue-at-Risk (RaR).src/chronos_mesh/optimizer/pareto_planner.py)
$), SLA Lead-Time Penalty (days), and Scope-3 Freight Emissions (kg CO2e) (CFO, Balanced Ops, Expedited SLA Recovery, and Low-Carbon ESG Net-Zero).VaR95 & CVaR95 Expected Shortfall) (src/chronos_mesh/risk/montecarlo.py)
500–2,000 trials, proving dramatic tail-loss compression over single-sourced baselines.ui/ + src/chronos_mesh/api/app.py)
TTR vs TTS exposure badges, lane split visualization, Pareto regime comparison, and interactive Monte Carlo CVaR95 stress testing.Red Sea Blockade + Kaohsiung 55% Fab Outage, 1,100 ECU Units)| Selected Lane | Mode | Units Shipped | Lead Time | Landed Cost | Scope-3 Carbon |
|---|---|---|---|---|---|
LANE-TW-CAPE-OCEAN |
Ocean (Cape of Good Hope) | 335.0 |
40.0 d |
$51,998.00 |
2,043.5 kg |
LANE-KR-EUR-RAIL |
Trans-Eurasian Rail (65% cap active) |
715.0 |
15.0 d |
$107,745.00 |
8,222.5 kg |
LANE-DE-TRUCK-EXPRESS |
European Dual-Source Truck | 50.0 |
1.5 d |
$10,150.00 |
155.0 kg |
| Certified Global Optimum | 13 B&B Nodes (11.53 ms) |
1,100 / 1,100 |
22.00 d avg |
$169,893.00 |
10,421.0 kg |
chronos pareto)| Executive Regime | Total Landed Cost | Weighted Lead Time | Scope-3 Carbon | MILP Solve Time |
|---|---|---|---|---|
| Cost-Minimizing CFO Regime | $170,825.00 |
10.28 days |
9,416.0 kg CO2e |
4.46 ms |
| Balanced Operations Regime | $192,325.00 |
2.86 days |
18,350.0 kg CO2e |
2.86 ms |
| Expedited SLA Recovery Regime | $200,945.00 |
2.39 days |
23,000.0 kg CO2e |
4.63 ms |
| Low-Carbon ESG Net-Zero Regime | $172,550.00 |
8.86 days |
8,450.0 kg CO2e |
3.21 ms |
500 Correlated Monte Carlo Trials)| Metric | Fragile Single-Source Baseline | ChronosMesh MILP Resilient | Improvement |
|---|---|---|---|
| Mean Total Cost | $484,880.74 |
$198,511.92 |
-59.1% |
95% Value-at-Risk (VaR95) |
$1,131,581.74 |
$212,883.18 |
-81.2% |
95% Expected Shortfall (CVaR95) |
$1,150,872.53 |
$213,810.26 |
-$937,062.27 (-81.4%) |
| Demand Fill-Rate Service Level | 62.70% |
100.00% |
+37.30 pp |
# 1. Clone & install deterministic environment (Python 3.12 + uv)
git clone https://github.com/nagarjunak-pixel/chronos-mesh.git
cd chronos-mesh
uv sync --all-extras
# 2. Run MIT Simchi-Levi TTR/TTS contagion + exact MILP rerouting demo
uv run chronos demo
# 3. Sweep the 3-objective (Cost / Lead-Time / Carbon) Pareto frontier
uv run chronos pareto
# 4. Run 500-trial Monte Carlo VaR95 & CVaR95 tail-risk proof
uv run chronos montecarlo --trials 500
# 5. Launch FastAPI Digital-Twin API + built React Control Tower on http://127.0.0.1:8010
cd ui && npm ci && npm run build && cd ..
uv run chronos serve --port 8010
uv run ruff check src tests
uv run mypy src
uv run pytest --cov=chronos_mesh --cov-fail-under=95
98.37% line coverage across src/chronos_mesh (mypy --strict clean across all 15 modules).tests/test_milp_properties.py: Uses Hypothesis to generate randomized fixed-charge integer/binary allocation matrices and verifies that our Two-Phase Simplex + Branch-and-Bound solver achieves the exact same global objective as exhaustive $2^m$ enumeration, while preserving flow conservation ($\sum_e x_e + u = D$) and anti-concentration bounds across all disrupted topologies.MILP, BOM, TTR/TTS, CVaR95)ChronosMesh serves as Pillar 2 (Neuro-Symbolic Operations Research & Decision Intelligence) in a cohesive 3-system enterprise architecture:
aegis-runtime — Zero-Trust Agentic Control Plane, .aegis AST Policy Compiler, & Cryptographic ERP Saga Engine (executes ChronosMesh’s certified PO reallocations transactionally).chronos-mesh — Multi-Echelon Supply-Chain Digital Twin, Exact Branch-and-Bound MILP Solver, & CVaR95 Risk Engine.prism-gate — High-Throughput Multi-Tenant AI Inference Gateway, Speculative Cascade Router, & Statistical Drift (PSI/JSD) Plane.Released under the MIT License.
Built by Nagarjuna Reddy Kamireddy (Nagarjuna Kamireddy / Nagarjuna K) — Lead AI Architect, GenAI & Agentic AI Lead, and Corporate AI Trainer (20+ years across Enterprise Data, SAP HANA & Production AI; AWS Certified Solutions Architect – Professional & NVIDIA-Certified Professional: Agentic AI).
llms-full.txt · LinkedIn