Structural Roadmap
Unified Quant Model

Autonomous Perception, Decision, and Verification Engine

This document serves as the definitive technical and tactical manual for the Integrated Order Flow Engine. It defines how the system perceives market physics, how it classifies trade opportunities, and how it verifies institutional traps in real-time.

Traditional technical analysis relies on static labels (Support/Resistance). The v4.0 Engine replaces labels with Physics. It treats every price level as a physical object with mass, density, and structural integrity.

The goal is to determine if a level will Absorb (Bounce) or Shatter (Break) by measuring the raw energy of the order flow hitting it.

Every level (GEX, G-Flip, Session Highs, etc.) is fed through a machine-learning Sigmoid curve to calculate its Armor Class. This is driven by four dynamic pillars:

• Empirical Mass (Synthetic Order Book): * Tracks actual traded volume and delta at specific price bins.
• Applies a 5-second exponential decay to ensure only "fresh" liquidity is valued.
• Structural Gravity (Cluster Density): * Measures the mathematical overlap of multiple algorithmic models.
• Higher gravity increases the level's "weight" in the probability matrix.
• Reinforcement Learning (Reputation Ledger): * A persistent memory of how the market treated this level recently.
• Levels that hold are rewarded (+Rep); levels that fail are punished (-Rep).
• Test Fatigue (Saturation): * Tracks the number of times price has "chipped" at the wall.
• Armor integrity degrades with every successive touch.

• 🛡️ TITANIUM (Prob < 35%): High conviction. Massive liquidity. Expect a hard rejection.
• 🧱 CONCRETE (Prob 36-60%): Standard structure. Requires tape confirmation.
• 🧊 GLASS (Prob 61-80%): Weak. High fatigue. High probability of failure.
• 💨 AIR (Prob > 80%): Zero resistance. Likely a liquidity vacuum.

The Decision Engine acts as the "Brain." It does not just look at the level; it looks at how price is arriving at the level to classify the trade.

• 🟢 FADE: Triggered when price approaches a Titanium/Concrete wall with slowing velocity.
• *Logic:* "The wall is stronger than the approach energy."
• 🔴 BREAKOUT: Triggered when price approaches a Glass/Air level with high velocity and aligned Delta.
• *Logic:* "The approach energy will shatter the wall."
• ⚠️ NO TRADE: Triggered by conflicting data or extreme counter-trend volatility.
• *Logic:* "The risk-to-reward ratio is mathematically unviable."

This is the "Trap vs. Real" detector. When price crosses a level, the engine enters a 5-second Micro-State analysis window.

• Acceptance: Does price hold territory beyond the wall for $>3$ seconds?
• Follow-Through: Does Delta continue to expand in the direction of the break?
• Reclaim Speed: Does price "snap back" across the line within the window?

• 🚀 REAL BREAKOUT: Acceptance confirmed. The wall is officially broken. Follow momentum.
• 🚨 TRAP DETECTED: Price breached the level to hunt stops but reclaimed it instantly. Fade Hard. This is the highest-probability reversal setup.

The interface is designed for high-speed "Glance-Trading."

• LEVEL NAME: The structural source of the level.
• PRICE: The exact coordinate of the wall.
• DIST: Distance from current price (scaled for asset volatility).
• TACTICAL ACTION: The Command Center. Displays FADE, BREAKOUT, ANALYZING, or TRAP alerts.
• ARMOR CLASS: The physical grade from Titanium to Air.
• PROBABILITY: The magnetic pull ($0-100\%$) based on current flow.

The engine generates precise entry and exit parameters scaled to the instrument (e.g., NQ has wider parameters than ES).

• Entry (E): Front-runs walls for Fades; waits for confirmation for Breakouts.
• Stop (S): Placed behind the structural armor to avoid "noise" liquidations.
• Target (T): Set at the next major liquidity node in the Roadmap.

• Neural Vault: Syncs all trade grades to the gemini-2.5-pro model to refine win-rate baselines and adapt to "Aggressive Bullish" or "Bearish" market regimes.
• Daily Reset: At 00:00, the system purges Order Book, Fatigue, and Reputation data. This ensures today's trades are judged solely on today's liquidity, preventing "data baggage" from yesterday's session.
• Session Persistence: All ML data is saved to localStorage in real-time. If the browser or engine restarts, the "memory" of the day's battles is instantly restored.

When the opening bell rings and the first few thousand contracts start hitting the tape, your dashboard is going to transform from a static list of prices into a high-speed execution command center.

Here is exactly what you will see on your screen in the heat of the session:

The "Structural Roadmap" will now look like a professional quant terminal. You won't have to squint at numbers; you’ll be scanning for Tactical Action colors.

• LEVEL NAME: You’ll see your G-Flip, Session Highs, and AI Targets.
• PRICE: The hard math coordinates.
• DIST: Counting down in real-time as price approaches a wall.
• TACTICAL ACTION: This is the center of the engine. It will be alive with colored "pills" telling you exactly what to do.
• ARMOR CLASS: You’ll see levels upgrade from 💨 AIR to 🧱 CONCRETE or 🛡️ TITANIUM as institutional volume builds up at those prices.
• PROBABILITY: The bar chart on the right will grow and shrink, showing you where the "magnetic pull" of the market is strongest.

When price starts moving toward a level (let's say a Titanium wall), here is the visual sequence you’ll experience:

As price gets within the "Approach Zone," the Tactical Action column will trigger:

• Visual: A Blue or Orange pill appears.
• Text: FADE ➔ E: 5104.25 | S: 5107.00
• The Logic: The engine has calculated that the wall is strong enough to reject the current velocity. It’s giving you your orders before price even touches the line.

If price slams into that level and crosses it:

• Visual: The prediction disappears. The cell turns Pulsing Purple.
• Text: ⚡ ANALYZING BREACH...
• The Logic: The engine has entered the 5-second Telemetry Window. It is currently measuring the Delta, the speed of the tape, and whether the sellers are exhausting. It is "holding its breath" so you don't chase a fake move.

After 5 seconds of analysis, the purple pulse will resolve into one of two high-visibility alerts:

• The Real Breakout: A Bright Green pill: 🚀 REAL BREAKOUT. The engine confirmed acceptance. This is your signal to ride the momentum.
• The Liquidity Trap: A Glowing Red pill: 🚨 TRAP: FADE HARD. This is the "Quant Edge." The engine detected that the breach was a fake-out. It will play a voice alert: *"Warning. Level breached but reclaimed. Liquidity trap detected."*

You will see the Armor Class column change dynamically.

• Early in the morning, most levels might be 🧊 GLASS.
• As the "Whales" start parking limit orders at a specific price, you will see that level "harden" on your screen, turning into 🧱 CONCRETE and then 🛡️ TITANIUM.
• If price hits a level three times and fails to break, you’ll see the AC Score drop and the Fatigue increase, warning you that the wall is about to crumble.

If you are watching NQ, the "DIST" numbers and the entry/stop offsets will look much wider (e.g., a 20-point buffer). If you switch to ES, everything will immediately tighten up to 4-point buffers. The UI will feel "heavier" or "lighter" depending on which instrument's physics you are currently trading.

In short: You are going to see a dashboard that stops asking you to guess and starts giving you verified, time-stamped instructions based on the raw physics of the tape.