NERVE — Network Earnings & Risk Visibility Engine

Model Evolution — The Full Story (v1 to v14-AI)

14 iterations over 5 phases. Each version solved a specific problem but revealed the next one. This is the reasoning behind every change.

Phase 1: Foundation (v1–v4) — "Can we see the problem?"

Phase 2: Prediction (v5–v8) — "Can we predict?"

Phase 3: Statistical Rigor (v9–v11) — "Can we trust it?"

Phase 4: Hybrid Intelligence (v12–v13) — "Catch what slopes can't"

🤖 Phase 5: v14-AI — AI-Augmented Analytics Platform

v14-AI extends the v13 prediction model with a conversational AI layer powered by Claude Sonnet 4.6 (tool-use architecture). The prediction model remains unchanged — v14-AI adds intelligence on top.

All 12 AI Tools

UX Features

⚡ Performance Metrics

🏗 Architecture Overview

Authentication (Midway SSO)

Compute & Storage

Domain & DNS

📊 Architecture Diagram

End-to-End System Flow

flowchart LR
    subgraph Browser["Browser — nerve.parp.amazon.dev"]
        direction TB
        SSO["SSO Check
Cognito + Federate
→ Midway"]
        UI["20 HTML Pages
DataTables, Chart.js
Leaflet Maps"]
        CHAT["AI Chat Panel
Progressive render
Sparklines, Notes"]
    end

    subgraph Hosting["Static Hosting"]
        AMP["AWS Amplify
dpgfi1rgq3n2n
staging branch"]
        S3H["S3: project-nerve
dashboard files
nerve_chat_data.js"]
    end

    subgraph AI["AI Engine (us-east-2)"]
        direction TB
        APIG["API Gateway
HTTPS POST
/summary"]
        LAM["Lambda
nerve-ai-summary
5GB, 5min"]
        BED["Bedrock
Claude Sonnet 4.6
Tool-Use API"]
        S3D["S3
nerve_full_data.csv
26,167 × 60+ cols"]
        DDB["DynamoDB
nerve-ai-memory
nerve-ai-pins
nerve-ai-notes"]
    end

    subgraph Automation["Scheduled Jobs"]
        ALERTS["nerve-daily-alerts
Lambda 1GB, 2min
→ SNS Email"]
        REPORT["nerve-weekly-report
Lambda 2GB, 3min
Monday 9AM ET"]
    end

    Browser -->|"Static files"| Hosting
    CHAT -->|"HTTPS POST"| APIG
    APIG --> LAM
    LAM -->|"Load data"| S3D
    LAM -->|"12 tools"| BED
    LAM -->|"Read/Write"| DDB
    LAM -.->|"Trigger"| ALERTS
    LAM -.->|"Trigger"| REPORT

    style Browser fill:#f0f9ff,stroke:#3b82f6
    style Hosting fill:#f0fdf4,stroke:#059669
    style AI fill:#fff7ed,stroke:#f97316
    style Automation fill:#faf5ff,stroke:#7c3aed

Authentication Flow

flowchart LR
    A["User visits
nerve.parp.amazon.dev"] --> B{"Token in
sessionStorage?"}
    B -->|No| C["Redirect →
Cognito Hosted UI"]
    C --> D["Federate OIDC
idp-integ.federate"]
    D --> E["Midway
Authentication"]
    E --> F["Auth Code
returned to page"]
    F --> G["Exchange code
for id_token"]
    G --> H["Store token
sessionStorage"]
    H --> I["Page loads
✅ Authenticated"]
    B -->|Yes| I

    style A fill:#f0f9ff,stroke:#3b82f6
    style I fill:#f0fdf4,stroke:#059669
    style E fill:#fef3c7,stroke:#d97706

AI Query Processing

flowchart TD
    Q["User asks question"] --> EX["Extract KIDs/names
from question text"]
    EX --> CTX["Build context:
page, locker data,
conversation history"]
    CTX --> SEND["POST to Lambda
via API Gateway"]
    SEND --> LOAD["Load nerve_full_data.csv
(cached on warm start)"]
    LOAD --> TOOLS["Claude selects tool:
filter_lockers, get_locker,
simulate_scenario, etc."]
    TOOLS --> EXEC["Execute tool against
26K dataset in memory"]
    EXEC --> RESP["Format response
with real data"]
    RESP --> RENDER["Progressive rendering
(typewriter effect)"]
    RENDER --> CHART{"Response has
1-3 KIDs?"}
    CHART -->|Yes| SPARK["Render inline
sparkline chart"]
    CHART -->|No| DONE["Display final
markdown response"]
    SPARK --> DONE

    style Q fill:#f0f9ff,stroke:#3b82f6
    style TOOLS fill:#fff7ed,stroke:#f97316
    style DONE fill:#f0fdf4,stroke:#059669

Deployment Pipeline

flowchart LR
    A["python
refresh_all_v14.py"] --> B["Merlon Auth
+ STS verify"]
    B --> C["Steps 1-6
Data Pipeline
~6 min"]
    C --> D["Step 7
Generate Dashboard
20 HTML pages"]
    D --> E["Step 8
S3 sync +
CSV upload"]
    E --> F["Step 9
Amplify Deploy
(auto-stop stuck)"]
    F --> G["Step 10
Lambda Deploy
code + config"]
    G --> H["Step 11
Trigger Alerts
+ Weekly Report"]
    H --> I["✅ LIVE
nerve.parp.amazon.dev"]

    style A fill:#1e3a5f,stroke:#1e3a5f,color:#fff
    style I fill:#059669,stroke:#059669,color:#fff