# ca-manmohan/nifty-quad-engine-reversal architecture

> Architecture diagram of the GitHub repository ca-manmohan/nifty-quad-engine-reversal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ca-manmohan/nifty-quad-engine-reversal
- Repository: https://github.com/ca-manmohan/nifty-quad-engine-reversal

## Overview

This repository combines a NIFTY 50 options backtest with a Kaggle actor–critic experiment intended to derive and evaluate a symbolic reversal invariant. The principal workflow is market telemetry and option-contract loading, four setup-specific signal checks, option entry and tranche-based risk management, then trade and performance reporting. The README documents those strategy stages and the research capabilities; sampled source shows portions of their implementation. The Kaggle notebook itself and unsampled strategy code were not inspected, so links for those portions rely on README statements or are omitted.

Main entry points: [`run_quad_engine_reversal_strategy.py`](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py) (Setup Selection), [`data`](https://github.com/ca-manmohan/nifty-quad-engine-reversal/tree/main/data) (Market Telemetry), [`build_kaggle_reversal_limite_notebook.py`](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py) (Notebook Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_strategy["Trading Strategy"]
  node_telemetry[("Market Telemetry")]
  node_contract_cache[("Option Contracts")]
  node_morning["Morning Reversal"]
  node_mid_vwap["Mid VWAP Retest"]
  node_lunch_breakout["Lunch Breakout"]
  node_afternoon_vwap["Afternoon VWAP"]
  node_signal["Setup Selection"]
end

subgraph group_risk["Execution and Audit"]
  node_execution["Option Entry"]
  node_risk_shield["Tranche Risk Shield"]
  node_trade_audit["Trade Accounting"]
  node_scorecards["Performance Scorecards"]
end

subgraph group_research["Symbolic Research"]
  node_notebook_builder["Notebook Builder"]
  node_actor_model["Limite Actor"]
  node_critic_model["Value Critic"]
  node_invariant_eval["Invariant Evaluation"]
  node_research_outputs["Research Plots"]
end

node_trader(("Strategy User"))
node_huggingface(("Hugging Face Hub"))
node_kaggle(("Kaggle GPU"))

node_trader -.->|"supplies inputs"| node_telemetry
node_telemetry -.->|"informs signals"| node_morning
node_telemetry -.->|"informs signals"| node_mid_vwap
node_telemetry -.->|"informs signals"| node_lunch_breakout
node_telemetry -.->|"informs signals"| node_afternoon_vwap
node_morning -->|"checks setup"| node_signal
node_mid_vwap -->|"checks setup"| node_signal
node_lunch_breakout -->|"checks setup"| node_signal
node_afternoon_vwap -.->|"checks setup"| node_signal
node_signal -->|"selects contract"| node_contract_cache
node_signal -->|"triggers entry"| node_execution
node_contract_cache -->|"provides candles"| node_execution
node_execution -->|"manages position"| node_risk_shield
node_risk_shield -->|"records exits"| node_trade_audit
node_trade_audit -->|"aggregates trades"| node_scorecards
node_trader -.->|"requests research"| node_notebook_builder
node_notebook_builder -->|"provisions notebook"| node_kaggle
node_notebook_builder -->|"loads models"| node_huggingface
node_notebook_builder -->|"generates formulas"| node_actor_model
node_notebook_builder -->|"scores traces"| node_critic_model
node_actor_model -.->|"proposes invariant"| node_invariant_eval
node_critic_model -.->|"provides values"| node_invariant_eval
node_invariant_eval -->|"plots results"| node_research_outputs

click node_telemetry "https://github.com/ca-manmohan/nifty-quad-engine-reversal/tree/main/data"
click node_contract_cache "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_morning "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_mid_vwap "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_lunch_breakout "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_afternoon_vwap "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_signal "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_execution "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_risk_shield "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_trade_audit "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_scorecards "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py"
click node_notebook_builder "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py"
click node_invariant_eval "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py"
click node_research_outputs "https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_telemetry,node_contract_cache,node_morning,node_mid_vwap,node_lunch_breakout,node_afternoon_vwap,node_signal,node_trader toneBlue
class node_execution,node_risk_shield,node_trade_audit,node_scorecards toneAmber
class node_notebook_builder,node_actor_model,node_critic_model,node_invariant_eval,node_research_outputs toneMint
class node_huggingface,node_kaggle toneIndigo
```

## Components

### Trading Strategy

- [Market Telemetry](https://github.com/ca-manmohan/nifty-quad-engine-reversal/tree/main/data): `data`
- [Option Contracts](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Morning Reversal](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Mid VWAP Retest](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Lunch Breakout](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Afternoon VWAP](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Setup Selection](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`

### Execution and Audit

- [Option Entry](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Tranche Risk Shield](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Trade Accounting](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`
- [Performance Scorecards](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/run_quad_engine_reversal_strategy.py): `run_quad_engine_reversal_strategy.py`

### Symbolic Research

- [Notebook Builder](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py): `build_kaggle_reversal_limite_notebook.py`
- **Limite Actor**
- **Value Critic**
- [Invariant Evaluation](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py): `build_kaggle_reversal_limite_notebook.py`
- [Research Plots](https://github.com/ca-manmohan/nifty-quad-engine-reversal/blob/main/build_kaggle_reversal_limite_notebook.py): `build_kaggle_reversal_limite_notebook.py`

### Other components

- **Strategy User**
- **Hugging Face Hub**
- **Kaggle GPU**

## Connections

- Strategy User → Market Telemetry: supplies inputs (evidence: `README.md`)
- Market Telemetry → Morning Reversal: informs signals (evidence: `README.md`)
- Market Telemetry → Mid VWAP Retest: informs signals (evidence: `README.md`)
- Market Telemetry → Lunch Breakout: informs signals (evidence: `README.md`)
- Market Telemetry → Afternoon VWAP: informs signals (evidence: `README.md`)
- Morning Reversal → Setup Selection: checks setup (evidence: `run_quad_engine_reversal_strategy.py`)
- Mid VWAP Retest → Setup Selection: checks setup (evidence: `run_quad_engine_reversal_strategy.py`)
- Lunch Breakout → Setup Selection: checks setup (evidence: `run_quad_engine_reversal_strategy.py`)
- Afternoon VWAP → Setup Selection: checks setup (evidence: `README.md`)
- Setup Selection → Option Contracts: selects contract (evidence: `run_quad_engine_reversal_strategy.py`)
- Setup Selection → Option Entry: triggers entry (evidence: `run_quad_engine_reversal_strategy.py`)
- Option Contracts → Option Entry: provides candles (evidence: `run_quad_engine_reversal_strategy.py`)
- Option Entry → Tranche Risk Shield: manages position (evidence: `README.md`)
- Tranche Risk Shield → Trade Accounting: records exits (evidence: `run_quad_engine_reversal_strategy.py`)
- Trade Accounting → Performance Scorecards: aggregates trades (evidence: `run_quad_engine_reversal_strategy.py`)
- Strategy User → Notebook Builder: requests research (evidence: `README.md`)
- Notebook Builder → Kaggle GPU: provisions notebook (evidence: `build_kaggle_reversal_limite_notebook.py`)
- Notebook Builder → Hugging Face Hub: loads models (evidence: `build_kaggle_reversal_limite_notebook.py`)
- Notebook Builder → Limite Actor: generates formulas (evidence: `build_kaggle_reversal_limite_notebook.py`)
- Notebook Builder → Value Critic: scores traces (evidence: `build_kaggle_reversal_limite_notebook.py`)
- Limite Actor → Invariant Evaluation: proposes invariant
- Value Critic → Invariant Evaluation: provides values
- Invariant Evaluation → Research Plots: plots results (evidence: `build_kaggle_reversal_limite_notebook.py`)
