FEAT NEXUS PRIME

---

🎯 The Mission

NEXUS PRIME is not just an indicator or a bot; it is a Mission-Critical Ecosystem designed for high-frequency data extraction, ML-driven analysis, and autonomous decision-making using the FEAT (Form, Space, Acceleration, Time) methodology.

🎮 Command Center (One-Switch Control)

The entire system lifecycle is controlled via a unified Python Orchestrator:

• nexus.bat: Initializes the "Golden Start".
  1. Bootstraps MetaTrader 5.
  2. Orchestrates Docker Compose (Brain + Dashboard).
  3. Executes Internal Sync Audit.
  4. Runs the War Room Report.
  5. Opens the Visual Interface.
• stop_nexus.bat: Executes a Graceful Shutdown.
  1. Safe Docker teardown (Persistence guaranteed).
  2. Professional MT5 process termination.
• check_system.bat: The Omni-Auditor on demand.

🏗️ Architecture: NEXUS PRIME

The system operates on a decentralized core-peripheral model:

1. THE BRIDGE (MQL5): Native indicators (UnifiedModel_Main.mq5, InstitutionalPVP.mq5) extraction engine with high-performance ZMQ streaming.
2. THE BRAIN (Docker/Python): A specialized MCP Server hosting the ML Engine, Data Collectors, and the RAG Memory (ChromaDB).
3. THE PERSISTENCE (Supabase): Institutional-grade schema for high-frequency tick logging, signal auditing, and model performance tracking.
4. THE VISION (Dashboard): Next.js + Framer Motion visual cockpit for real-time monitoring.

🕵️ Omni-Audit (Self-Healing)

Every component is monitored by the NEXUS Omni-Auditor. If a data blocker is detected (MT5 Offline, ZMQ Latency > 50ms, DB Sync Failed), the system generates a machine-readable REPAIR_REQUEST to trigger autonomous self-healing by the Antigravity Agent.

📊 Institutional Persistence

The database schema (institutional_schema.sql) is designed for senior quantitative analysis:

• market_ticks: Nanosecond-aware price capture.
• feat_signals: Comprehensive audit trail with confidence scores and top-drivers.
• ml_inference_logs: Feature snapshots at the moment of prediction for retrospective learning.
• knowledge_base: RAG persistence for the autonomous agent.

---

⚡ Quick Start (The NEXUS Protocol)

1. Requirements

• Windows 11 (for MT5 Terminal).
• Docker Desktop.
• Python 3.12+.

2. Configuration

Fill your .env with the Supabase credentials and MT5 paths:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-service-role-key
MT5_PATH=C:\Program Files\LiteFinance MT5 Terminal\terminal64.exe

3. Ignition

Run the main orchestrator:

.\nexus.bat

---

📜 Repository Hygiene

This project follows strictly the Saneamiento Protocol:

• No binary files in Git.
• No local logs in Git.
• No environment variables in Git.
• Clean development/production branch harmonization.

---