# FUM Variant Progression Map

This document describes the three repository states preserved inside the FUM generation.

## 01 — FUM Demo

**Role:** earliest integrated proof-of-concept.

**Primary executable:** `variants/01_FUM_Demo/demo.py`

**Core surfaces:**

- `fum_core.py` — graph/network substrate and neuron-level state;
- `fum_sie.py` — Demo-era Self-Improvement Engine;
- `fum_plasticity.py` — structural-plasticity logic;
- `fum_tda.py` — topological analysis interface;
- `grid_world.py` — changing environment;
- `visualizer.py` and preserved figures — visualization/evidence surfaces;
- `src/` — vendored mathematical/analysis utilities.

This repository state is valuable because it puts several mechanisms into one small system that can be perturbed directly.

## 02 — early FUM tests

**Role:** mechanism isolation, validation, and discovery workbench.

**Primary runner:** `variants/02_early_FUM_tests/main.py`

Important branches include:

- `SIE_Analysis/` — explicit SIE stability simulation and analysis;
- `Knowledge_Graph_Analysis/` — topology/KG experiments;
- `FUM_Demo/` — expanded FUM implementation with additional mechanisms;
- `Emergent_Neurons/` — visual experimental artifacts;
- `Plots/` — includes FUM Void Debt modulation work;
- `Docs/` — contemporaneous interpretation and research context;
- `Justification/` — novelty/justification material.

Compared with Variant 01, this state exposes more mechanisms individually and turns them into testable research questions rather than keeping everything inside one demonstration loop.

## 03 — Fully Unified Model

**Role:** architecture consolidation and implementation/training frontier.

**Primary reading surface:** `variants/03_Fully_Unified_Model/How_It_Works/0_Table_of_Contents.md`

Important branches include:

- `How_It_Works/` — complete architecture walkthrough;
- `Fully_Unified_Model.pdf` — preserved model writeup;
- `mathematical_frameworks/` — SIE/KG analysis material carried into the consolidated architecture;
- `_FUM_Training/` — model, I/O, tests, GPU/HIP source, configurations, and training scaffold;
- `planning_outlines/` — development/scaling plans.

This state is not simply a more polished copy of the Demo. It captures the point where the FUM program became a much broader architecture with a dedicated training/scaling plan.

## Cross-variant continuity

| Thread | FUM Demo | early FUM tests | Fully Unified Model |
|---|---|---|---|
| SIE | integrated modulation | isolated stability / multi-objective analysis | first-class architecture + mathematical framework |
| Graph structure | active network substrate | explicit KG/TDA analysis | Unified Knowledge Graph |
| Plasticity | STDP + structural rewiring | homeostasis, VGSP/REVGSP-era experiments, persistence | integrated neural/structural plasticity design |
| TDA | runtime diagnostic | dedicated validation surface | architecture-level topology/knowledge-graph reasoning |
| Training | compact online simulation | mechanism experiments + expanded demo | dedicated training/scaling scaffold |
| Void Dynamics bridge | not yet the organizing frame | explicit Void Debt / Void Dynamics discovery material | immediate pre-FUVDM architecture |

## Generation boundary

These three states belong to **FUM**.

The next generation is **FUVDM — Fully Unified Void Dynamics Model**. FUVDM is intentionally not folded into this repository even where vocabulary or mechanisms have ancestry in FUM.