# jennifer-214/graveyard architecture

> Architecture diagram of the GitHub repository jennifer-214/graveyard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jennifer-214/graveyard
- Repository: https://github.com/jennifer-214/graveyard

## Overview

This archive contains inactive projects; the available tree is concentrated on FoxML_Core, research-grade cross-sectional ML infrastructure with deterministic operation and fingerprint lineage. Its principal workflow is preparing market data, training and evaluating models, then using predictions in live trading or backtests. A dashboard exposes operational, model, and trading views, while MCP server packages provide tool interfaces. The sampled source confirms the live engine’s orchestration role and backtest integration; many other connections below reflect module responsibilities visible in the tree, not inspected call sites.

Main entry points: [`FoxML_Core/LIVE_TRADING/engine/trading_engine.py`](https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/LIVE_TRADING/engine/trading_engine.py) (Trading engine), [`FoxML_Core/TRAINING/orchestration`](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/orchestration) (Training orchestration), [`FoxML_Core/LIVE_TRADING/backtest/engine.py`](https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/LIVE_TRADING/backtest/engine.py) (Backtesting), [`FoxML_Core/MCP_SERVERS`](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS) (MCP tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_config["Configuration"]
  node_feature["Feature processing"]
  node_targets["Target generation"]
  node_barrier["Barrier pipeline"]
end

subgraph group_training["Model research"]
  node_loading["Data loading"]
  node_preprocessing["Preprocessing"]
  node_training_pipeline["Training orchestration"]
  node_models["Model training"]
  node_ranking["Feature ranking"]
  node_decision_engine["Research decisions<br/>[decision_engine.py]"]
  node_lineage["Run lineage"]
end

subgraph group_trading["Trading runtime"]
  node_live_engine["Trading engine<br/>[trading_engine.py]"]
  node_prediction["Prediction"]
  node_gating["Trade gating"]
  node_sizing_risk["Sizing and risk"]
  node_brokers["Broker adapters"]
  node_market_data["Market data"]
  node_backtest["Backtesting<br/>[engine.py]"]
end

subgraph group_interfaces["User interfaces"]
  node_dashboard["Operations dashboard"]
  node_dashboard_bridge["Dashboard bridge"]
end

subgraph group_tooling["Tool services"]
  node_mcp["MCP tools"]
  node_artifact_tools["Artifact tools"]
  node_config_tools["Config tools"]
end

node_researcher(("Researcher / operator"))
node_market_service(("Market / broker services"))

node_researcher -->|"sets options"| node_config
node_loading -->|"prepares data"| node_preprocessing
node_preprocessing -->|"supplies inputs"| node_training_pipeline
node_training_pipeline -->|"orchestrates training"| node_models
node_training_pipeline -->|"coordinates selection"| node_ranking
node_training_pipeline -->|"records provenance"| node_lineage
node_training_pipeline -->|"supports decisions"| node_decision_engine
node_researcher -->|"starts processing"| node_barrier
node_barrier -->|"generates labels"| node_targets
node_feature -->|"provides features"| node_training_pipeline
node_live_engine -->|"coordinates prediction"| node_prediction
node_live_engine -->|"coordinates gating"| node_gating
node_live_engine -->|"coordinates sizing"| node_sizing_risk
node_live_engine -->|"obtains market data"| node_market_data
node_live_engine -->|"executes trades"| node_brokers
node_market_service -.->|"supplies quotes"| node_market_data
node_brokers -.->|"submits orders"| node_market_service
node_backtest -->|"runs cycles"| node_live_engine
node_backtest -->|"loads history"| node_market_data
node_backtest -->|"simulates execution"| node_brokers
node_researcher -->|"monitors runtime"| node_dashboard
node_dashboard -->|"requests live data"| node_dashboard_bridge
node_researcher -->|"invokes tools"| node_mcp
node_mcp -->|"dispatches artifact tools"| node_artifact_tools
node_mcp -->|"dispatches config tools"| node_config_tools

click node_config "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/CONFIG"
click node_feature "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DATA_PROCESSING/features"
click node_targets "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DATA_PROCESSING/targets"
click node_barrier "https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/DATA_PROCESSING/pipeline/barrier_pipeline.py"
click node_loading "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/data/loading"
click node_preprocessing "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/data/preprocessing"
click node_training_pipeline "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/orchestration"
click node_models "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/model_fun"
click node_ranking "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/ranking"
click node_decision_engine "https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/TRAINING/decisioning/decision_engine.py"
click node_lineage "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/orchestration/utils"
click node_live_engine "https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/LIVE_TRADING/engine/trading_engine.py"
click node_prediction "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/prediction"
click node_gating "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/gating"
click node_sizing_risk "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/sizing"
click node_brokers "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/brokers"
click node_market_data "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/data"
click node_backtest "https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/LIVE_TRADING/backtest/engine.py"
click node_dashboard "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DASHBOARD/dashboard/src"
click node_dashboard_bridge "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DASHBOARD/bridge"
click node_mcp "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS"
click node_artifact_tools "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS/foxml_artifact"
click node_config_tools "https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS/foxml_config"

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_config,node_feature,node_targets,node_barrier toneBlue
class node_loading,node_preprocessing,node_training_pipeline,node_models,node_ranking,node_decision_engine,node_lineage toneAmber
class node_live_engine,node_prediction,node_gating,node_sizing_risk,node_brokers,node_market_data,node_backtest toneMint
class node_dashboard,node_dashboard_bridge toneRose
class node_mcp,node_artifact_tools,node_config_tools,node_researcher,node_market_service toneIndigo
```

## Components

### Data preparation

- [Configuration](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/CONFIG): `FoxML_Core/CONFIG`
- [Feature processing](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DATA_PROCESSING/features): `FoxML_Core/DATA_PROCESSING/features`
- [Target generation](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DATA_PROCESSING/targets): `FoxML_Core/DATA_PROCESSING/targets`
- [Barrier pipeline](https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/DATA_PROCESSING/pipeline/barrier_pipeline.py): `FoxML_Core/DATA_PROCESSING/pipeline/barrier_pipeline.py`

### Model research

- [Data loading](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/data/loading): `FoxML_Core/TRAINING/data/loading`
- [Preprocessing](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/data/preprocessing): `FoxML_Core/TRAINING/data/preprocessing`
- [Training orchestration](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/orchestration): `FoxML_Core/TRAINING/orchestration`
- [Model training](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/model_fun): `FoxML_Core/TRAINING/model_fun`
- [Feature ranking](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/ranking): `FoxML_Core/TRAINING/ranking`
- [Research decisions](https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/TRAINING/decisioning/decision_engine.py): `FoxML_Core/TRAINING/decisioning/decision_engine.py`
- [Run lineage](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/TRAINING/orchestration/utils): `FoxML_Core/TRAINING/orchestration/utils`

### Trading runtime

- [Trading engine](https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/LIVE_TRADING/engine/trading_engine.py): `FoxML_Core/LIVE_TRADING/engine/trading_engine.py`
- [Prediction](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/prediction): `FoxML_Core/LIVE_TRADING/prediction`
- [Trade gating](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/gating): `FoxML_Core/LIVE_TRADING/gating`
- [Sizing and risk](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/sizing): `FoxML_Core/LIVE_TRADING/sizing`
- [Broker adapters](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/brokers): `FoxML_Core/LIVE_TRADING/brokers`
- [Market data](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/LIVE_TRADING/data): `FoxML_Core/LIVE_TRADING/data`
- [Backtesting](https://github.com/jennifer-214/graveyard/blob/main/FoxML_Core/LIVE_TRADING/backtest/engine.py): `FoxML_Core/LIVE_TRADING/backtest/engine.py`

### User interfaces

- [Operations dashboard](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DASHBOARD/dashboard/src): `FoxML_Core/DASHBOARD/dashboard/src`
- [Dashboard bridge](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/DASHBOARD/bridge): `FoxML_Core/DASHBOARD/bridge`

### Tool services

- [MCP tools](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS): `FoxML_Core/MCP_SERVERS`
- [Artifact tools](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS/foxml_artifact): `FoxML_Core/MCP_SERVERS/foxml_artifact`
- [Config tools](https://github.com/jennifer-214/graveyard/tree/main/FoxML_Core/MCP_SERVERS/foxml_config): `FoxML_Core/MCP_SERVERS/foxml_config`

### Other components

- **Researcher / operator**
- **Market / broker services**

## Connections

- Researcher / operator → Configuration: sets options
- Data loading → Preprocessing: prepares data
- Preprocessing → Training orchestration: supplies inputs
- Training orchestration → Model training: orchestrates training
- Training orchestration → Feature ranking: coordinates selection
- Training orchestration → Run lineage: records provenance
- Training orchestration → Research decisions: supports decisions
- Researcher / operator → Barrier pipeline: starts processing
- Barrier pipeline → Target generation: generates labels
- Feature processing → Training orchestration: provides features
- Trading engine → Prediction: coordinates prediction
- Trading engine → Trade gating: coordinates gating
- Trading engine → Sizing and risk: coordinates sizing
- Trading engine → Market data: obtains market data
- Trading engine → Broker adapters: executes trades
- Market / broker services → Market data: supplies quotes
- Broker adapters → Market / broker services: submits orders
- Backtesting → Trading engine: runs cycles
- Backtesting → Market data: loads history
- Backtesting → Broker adapters: simulates execution
- Researcher / operator → Operations dashboard: monitors runtime
- Operations dashboard → Dashboard bridge: requests live data
- Researcher / operator → MCP tools: invokes tools
- MCP tools → Artifact tools: dispatches artifact tools
- MCP tools → Config tools: dispatches config tools