# saydofs/omega-research-pack architecture

> Architecture diagram of the GitHub repository saydofs/omega-research-pack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saydofs/omega-research-pack
- Repository: https://github.com/saydofs/omega-research-pack

## Overview

Omega Research Pack v4 is a research prototype for computing trajectory-based Omega measures and exploring their use in history-bound key evolution. Its main workflow processes numeric time-series data through robust metric calibration and Omega state updates; those states can feed a calibrated projection and evolving key. Separate scripts provide CSV sensor feature extraction, temporal forecasting comparisons, and adversarial simulations. The graph reflects the sampled implementation and documented capabilities; it does not treat research outputs or security claims as production guarantees.

Main entry points: [`benchmark_real.py`](https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py) (Temporal Benchmark), [`attack_suite_v4.py`](https://github.com/saydofs/omega-research-pack/blob/main/attack_suite_v4.py) (Attack Simulations), [`omega_v4.py`](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py) (Omega Core), [`sensor_csv_adapter.py`](https://github.com/saydofs/omega-research-pack/blob/main/sensor_csv_adapter.py) (CSV Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Data Ingestion"]
  node_csv_adapter["CSV Adapter"]
end

subgraph group_core["Omega Core"]
  node_robust_metric["Robust Metric<br/>[omega_v4.py]"]
  node_omega_core["Omega Core<br/>[omega_v4.py]"]
  node_omega_state["Omega State<br/>[omega_v4.py]"]
end

subgraph group_keys["Life-Key Research"]
  node_projector["Calibrated Projector<br/>[omega_v4.py]"]
  node_hkdf["HKDF Functions<br/>[omega_v4.py]"]
  node_life_key["Life-Key Evolution<br/>[omega_v4.py]"]
  node_authentication["Key Authentication<br/>[omega_v4.py]"]
end

subgraph group_evaluation["Evaluation"]
  node_benchmark["Temporal Benchmark<br/>[benchmark_real.py]"]
  node_benchmark_data["Local Datasets<br/>[benchmark_real.py]"]
  node_ridge["Ridge Evaluation<br/>[benchmark_real.py]"]
  node_attack_suite["Attack Simulations<br/>[attack_suite_v4.py]"]
end

node_researcher(("Researcher"))
node_sensor_data["Sensor CSV"]

node_researcher -->|"runs extraction"| node_csv_adapter
node_sensor_data -->|"reads rows"| node_csv_adapter
node_csv_adapter -->|"fits training data"| node_robust_metric
node_csv_adapter -->|"updates trajectory"| node_omega_core
node_omega_core -->|"measures distance"| node_robust_metric
node_omega_core -->|"returns metrics"| node_omega_state
node_researcher -->|"runs benchmark"| node_benchmark
node_benchmark -->|"loads datasets"| node_benchmark_data
node_benchmark -->|"fits metric"| node_robust_metric
node_benchmark -->|"builds features"| node_omega_core
node_benchmark -->|"evaluates forecasts"| node_ridge
node_researcher -->|"runs simulations"| node_attack_suite
node_attack_suite -->|"calibrates metric"| node_robust_metric
node_attack_suite -->|"updates trajectories"| node_omega_core
node_attack_suite -->|"compares projections"| node_projector
node_attack_suite -->|"simulates evolution"| node_life_key
node_life_key -->|"encodes state"| node_projector
node_life_key -->|"derives key"| node_hkdf
node_life_key -->|"authenticates payload"| node_authentication

click node_csv_adapter "https://github.com/saydofs/omega-research-pack/blob/main/sensor_csv_adapter.py"
click node_robust_metric "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_omega_core "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_omega_state "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_projector "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_hkdf "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_life_key "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_authentication "https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py"
click node_benchmark "https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py"
click node_benchmark_data "https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py"
click node_ridge "https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py"
click node_attack_suite "https://github.com/saydofs/omega-research-pack/blob/main/attack_suite_v4.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_csv_adapter toneBlue
class node_robust_metric,node_omega_core,node_omega_state toneAmber
class node_projector,node_hkdf,node_life_key,node_authentication toneMint
class node_benchmark,node_benchmark_data,node_ridge,node_attack_suite toneRose
class node_researcher,node_sensor_data toneIndigo
```

## Components

### Data Ingestion

- [CSV Adapter](https://github.com/saydofs/omega-research-pack/blob/main/sensor_csv_adapter.py): `sensor_csv_adapter.py`

### Omega Core

- [Robust Metric](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`
- [Omega Core](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`
- [Omega State](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`

### Life-Key Research

- [Calibrated Projector](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`
- [HKDF Functions](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`
- [Life-Key Evolution](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`
- [Key Authentication](https://github.com/saydofs/omega-research-pack/blob/main/omega_v4.py): `omega_v4.py`

### Evaluation

- [Temporal Benchmark](https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py): `benchmark_real.py`
- [Local Datasets](https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py): `benchmark_real.py`
- [Ridge Evaluation](https://github.com/saydofs/omega-research-pack/blob/main/benchmark_real.py): `benchmark_real.py`
- [Attack Simulations](https://github.com/saydofs/omega-research-pack/blob/main/attack_suite_v4.py): `attack_suite_v4.py`

### Other components

- **Researcher**
- **Sensor CSV**

## Connections

- Researcher → CSV Adapter: runs extraction (evidence: `README.md`)
- Sensor CSV → CSV Adapter: reads rows (evidence: `sensor_csv_adapter.py`)
- CSV Adapter → Robust Metric: fits training data (evidence: `sensor_csv_adapter.py`)
- CSV Adapter → Omega Core: updates trajectory (evidence: `sensor_csv_adapter.py`)
- Omega Core → Robust Metric: measures distance (evidence: `omega_v4.py`)
- Omega Core → Omega State: returns metrics (evidence: `omega_v4.py`)
- Researcher → Temporal Benchmark: runs benchmark (evidence: `README.md`)
- Temporal Benchmark → Local Datasets: loads datasets (evidence: `benchmark_real.py`)
- Temporal Benchmark → Robust Metric: fits metric (evidence: `benchmark_real.py`)
- Temporal Benchmark → Omega Core: builds features (evidence: `benchmark_real.py`)
- Temporal Benchmark → Ridge Evaluation: evaluates forecasts (evidence: `benchmark_real.py`)
- Researcher → Attack Simulations: runs simulations (evidence: `README.md`)
- Attack Simulations → Robust Metric: calibrates metric (evidence: `attack_suite_v4.py`)
- Attack Simulations → Omega Core: updates trajectories (evidence: `attack_suite_v4.py`)
- Attack Simulations → Calibrated Projector: compares projections (evidence: `attack_suite_v4.py`)
- Attack Simulations → Life-Key Evolution: simulates evolution (evidence: `attack_suite_v4.py`)
- Life-Key Evolution → Calibrated Projector: encodes state (evidence: `omega_v4.py`)
- Life-Key Evolution → HKDF Functions: derives key (evidence: `omega_v4.py`)
- Life-Key Evolution → Key Authentication: authenticates payload (evidence: `omega_v4.py`)
