Skip to content

MonzaTech/sentinel-grid

Repository files navigation

Sentinel Grid

AI-Powered Infrastructure Defense System - Predicting cascade failures 48 hours in advance

Tests TypeScript License

Sentinel Grid is a digital immune system for critical infrastructure. It uses AI-powered predictive analytics to detect infrastructure failures before they happen, enabling autonomous mitigation and maintaining cryptographic audit trails for regulatory compliance.

Features

  • 48-Hour Predictions - AI detects failure patterns before they cascade
  • Autonomous Mitigation - Automated response reduces incident impact by 60%+
  • Blockchain Anchoring - Immutable audit trail for NERC CIP compliance
  • Real-time Dashboard - Live monitoring of 200+ infrastructure nodes
  • 85-95% Accuracy - Military-grade prediction precision

Quick Start

One-Command Demo

# Clone and run
git clone https://github.com/monzatech/sentinel-grid.git
cd sentinel-grid
./demo/demo.sh

Manual Setup

# 1. Install dependencies
npm install

# 2. Build all packages
npm run build

# 3. Start backend (Terminal 1)
npm run dev:backend

# 4. Start frontend (Terminal 2)
npm run dev:frontend

# 5. Open dashboard
open http://localhost:3000

Packages

Package Description Lines Tests
@sentinel-grid/predictive-engine Core AI simulation & prediction 2,395 62
@sentinel-grid/backend Express + WebSocket API 3,869 29
@sentinel-grid/frontend React dashboard 2,795 -
Total ~9,000 91

Demo

Investor Demo (90 seconds)

./demo/demo.sh

This runs a guided walkthrough showing:

  1. Infrastructure monitoring dashboard
  2. AI pattern detection
  3. Cyber attack threat scenario
  4. Cascade failure simulation
  5. Autonomous mitigation
  6. Blockchain audit anchoring
  7. Performance metrics

Demo Options

./demo/demo.sh --fast        # 2x speed
./demo/demo.sh --no-frontend # Terminal only
./demo/demo.sh --record      # Recording mode hints

Validation

./demo/validate.sh  # Check everything is ready

Architecture

+-------------------------------------------------------------------+
|                         Frontend (React)                           |
|              Dashboard - Charts - Controls - Alerts                |
+-------------------------------+-----------------------------------+
                                | WebSocket + REST
+-------------------------------v-----------------------------------+
|                      Backend (Express + WS)                        |
|         REST API - WebSocket - Simulation Service                  |
+-------------------------------+-----------------------------------+
                                |
+-------------------------------v-----------------------------------+
|                    Predictive Engine (Core)                        |
|    Simulation - Pattern Detection - Predictions - Alerts           |
+-------------------------------+-----------------------------------+
                                |
         +--------------+-------+-------+--------------+
         v              v               v              v
   +-----------+  +-----------+  +-----------+  +-----------+
   |   IPFS    |  |  Base L2  |  | Optimism  |  |  SQLite   |
   |  Storage  |  |  Anchor   |  |  Anchor   |  |   Audit   |
   +-----------+  +-----------+  +-----------+  +-----------+

API Endpoints

System

GET  /api/system/state     # Current system state
GET  /api/system/health    # Health check
GET  /api/system/metrics   # Prometheus metrics
POST /api/system/start     # Start simulation
POST /api/system/stop      # Stop simulation
POST /api/system/reset     # Reset to initial state

Nodes

GET  /api/nodes            # List all nodes
GET  /api/nodes/:id        # Single node details
GET  /api/nodes/summary    # Statistics
GET  /api/nodes/critical   # Critical nodes only

Predictions

GET  /api/predictions          # Current predictions
GET  /api/predictions/patterns # Detected patterns
GET  /api/predictions/accuracy # Model metrics

Simulation

POST   /api/simulate/cascade   # Trigger cascade failure
POST   /api/simulate/threat    # Deploy threat
DELETE /api/simulate/threat    # Clear threat
POST   /api/simulate/scenario  # Run scenario

Actions

POST /api/actions/mitigate          # Mitigate single node
POST /api/actions/mitigate/batch    # Mitigate multiple
POST /api/actions/mitigate/critical # Mitigate all critical

WebSocket

ws://localhost:4000/ws/updates

Events: tick, predictions, alert, cascade, mitigation

Testing

# All tests
npm test --workspaces

# Individual packages
npm test --workspace=packages/predictive-engine  # 62 tests
npm test --workspace=packages/backend            # 29 tests

# With coverage
npm test -- --coverage

Docker

# Build and run
docker-compose up --build

# With local blockchain
docker-compose --profile full up --build

Project Structure

sentinel-grid/
├── packages/
│   ├── predictive-engine/    # Core AI engine
│   │   ├── src/
│   │   │   ├── types.ts
│   │   │   ├── SeededRandom.ts
│   │   │   ├── SimulationEngine.ts
│   │   │   ├── PredictiveEngine.ts
│   │   │   └── AlertManager.ts
│   │   └── tests/
│   │
│   ├── backend/              # API server
│   │   ├── src/
│   │   │   ├── routes/
│   │   │   ├── services/
│   │   │   ├── websocket/
│   │   │   └── db/
│   │   └── tests/
│   │
│   └── frontend/             # React dashboard
│       └── src/
│           ├── components/
│           ├── hooks/
│           └── services/
│
├── demo/
│   ├── demo.sh              # Demo launcher
│   ├── investor-demo.ts     # 90-second walkthrough
│   ├── validate.sh          # Pre-demo checks
│   └── DEMO_SCRIPT.md       # Talking points
│
└── docker-compose.yml

Target Markets

  • Power Utilities - Grid operators, transmission companies
  • Military/Defense - AFRL HUSTLE Accelerator partner
  • Data Centers - Hyperscale and enterprise
  • Telecommunications - Network infrastructure
  • Water/Utilities - Municipal infrastructure

Business Model

  • SaaS Subscription - $2,500-10,000/month based on monitored nodes
  • Infrastructure Reports - $10,000-15,000 per assessment
  • Enterprise Deployment - Custom pricing

Compliance

  • NERC CIP (Critical Infrastructure Protection)
  • SOC 2 Type II
  • FedRAMP (in progress)
  • NIST Cybersecurity Framework

Contact

Monza Tech LLC

Registrations:

  • SAM.gov Registered
  • Florida Incorporated

Programs:

  • AFRL HUSTLE Defense Accelerator
  • NEXT-HI Innovation Program

License

MIT 2024 Monza Tech LLC


Sentinel Grid - See the Future. Protect the Grid.

About

Demo

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors