# floatingpragma/observer-patch-holography architecture

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

- Interactive diagram: https://gitdiagram.com/floatingpragma/observer-patch-holography
- Repository: https://github.com/floatingpragma/observer-patch-holography

## Overview

Observer Patch Holography is a research program that reconstructs physical structures from bounded observers, their records, and consensus. The README describes a conceptual route from observer consistency through spacetime, fields, quantum structure and matter to constants and empirical tests; the tree contains separate research lanes rather than one demonstrated runtime pipeline. The graph preserves these major branches. Some subsystem paths are exact directories because their implementation was not sampled, so uncertain implementation-level links are omitted.

Main entry points: [`code/consensus`](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/consensus) (Consensus reconstruction), [`code/geometry`](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/geometry) (Observer geometry), [`code/a5_closure`](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/a5_closure) (Gauge classification), [`code/particles/calibration`](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/particles/calibration) (Particle calibration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_consensus["Observer consensus"]
  node_consensus["Consensus reconstruction"]
  node_routes["Paired source routes<br/>[routes.py]"]
  node_history["Checkpoint histories<br/>[pipeline.py]"]
  node_refinement["Routing refinement<br/>[storage.py]"]
end

subgraph group_spacetime["Spacetime and fields"]
  node_causality["Causal refinement"]
  node_geometry["Observer geometry"]
  node_electromagnetism["Electromagnetic fields"]
end

subgraph group_quantum["Quantum and matter"]
  node_laws["Thermodynamic laws"]
  node_quantum["Quantum transport"]
  node_gauge["Gauge classification"]
  node_matter["Matter construction"]
  node_particle["Particle calibration"]
  node_ibm["IBM quantum lane"]
end

subgraph group_constants["Constants and tests"]
  node_pclosure["Pixel fixed point"]
  node_cosmology["Capacity cosmology"]
  node_ledger["Prediction ledger"]
  node_lattice["Lattice calculations"]
end

node_researcher(("Researcher"))

node_researcher -->|"studies"| node_consensus
node_consensus -->|"constructs routes"| node_routes
node_consensus -->|"reconstructs histories"| node_history
node_consensus -->|"refines records"| node_refinement
node_consensus -->|"constrains geometry"| node_causality
node_consensus -->|"supports reconstruction"| node_geometry
node_geometry -->|"supports field theory"| node_electromagnetism
node_consensus -->|"motivates repair laws"| node_laws
node_consensus -->|"supports probabilities"| node_quantum
node_consensus -->|"constrains symmetry"| node_gauge
node_gauge -->|"classifies matter grammar"| node_matter
node_matter -->|"supports physical predictions"| node_particle
node_consensus -->|"sets closure target"| node_pclosure
node_consensus -->|"sets capacity target"| node_cosmology
node_particle -->|"compares predictions"| node_ledger
node_cosmology -->|"records comparisons"| node_ledger
node_researcher -->|"examines calculations"| node_lattice
node_researcher -.->|"runs hardware studies"| node_ibm

click node_consensus "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/consensus"
click node_routes "https://github.com/floatingpragma/observer-patch-holography/blob/main/code/source_native_programs/routes.py"
click node_history "https://github.com/floatingpragma/observer-patch-holography/blob/main/code/source_checkpoint_selection/pipeline.py"
click node_refinement "https://github.com/floatingpragma/observer-patch-holography/blob/main/code/source_routing_refinement/storage.py"
click node_causality "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/causal_refinement"
click node_geometry "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/geometry"
click node_electromagnetism "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/electromagnetism"
click node_laws "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/elementary_laws"
click node_quantum "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/m1_quantum_transport"
click node_gauge "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/a5_closure"
click node_matter "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/a5_closure"
click node_particle "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/particles/calibration"
click node_pclosure "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/P_derivation"
click node_cosmology "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/cosmology"
click node_ledger "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/cosmology/postdiction_ledger"
click node_lattice "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/particles/hadron"
click node_ibm "https://github.com/floatingpragma/observer-patch-holography/tree/main/code/ibm_quantum_cloud/programs"

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_consensus,node_routes,node_history,node_refinement toneBlue
class node_causality,node_geometry,node_electromagnetism toneAmber
class node_laws,node_quantum,node_gauge,node_matter,node_particle,node_ibm toneMint
class node_pclosure,node_cosmology,node_ledger,node_lattice toneRose
class node_researcher toneIndigo
```

## Components

### Observer consensus

- [Consensus reconstruction](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/consensus): `code/consensus`
- [Paired source routes](https://github.com/floatingpragma/observer-patch-holography/blob/main/code/source_native_programs/routes.py): `code/source_native_programs/routes.py`
- [Checkpoint histories](https://github.com/floatingpragma/observer-patch-holography/blob/main/code/source_checkpoint_selection/pipeline.py): `code/source_checkpoint_selection/pipeline.py`
- [Routing refinement](https://github.com/floatingpragma/observer-patch-holography/blob/main/code/source_routing_refinement/storage.py): `code/source_routing_refinement/storage.py`

### Spacetime and fields

- [Causal refinement](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/causal_refinement): `code/causal_refinement`
- [Observer geometry](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/geometry): `code/geometry`
- [Electromagnetic fields](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/electromagnetism): `code/electromagnetism`

### Quantum and matter

- [Thermodynamic laws](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/elementary_laws): `code/elementary_laws`
- [Quantum transport](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/m1_quantum_transport): `code/m1_quantum_transport`
- [Gauge classification](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/a5_closure): `code/a5_closure`
- [Matter construction](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/a5_closure): `code/a5_closure`
- [Particle calibration](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/particles/calibration): `code/particles/calibration`
- [IBM quantum lane](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/ibm_quantum_cloud/programs): `code/ibm_quantum_cloud/programs`

### Constants and tests

- [Pixel fixed point](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/P_derivation): `code/P_derivation`
- [Capacity cosmology](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/cosmology): `code/cosmology`
- [Prediction ledger](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/cosmology/postdiction_ledger): `code/cosmology/postdiction_ledger`
- [Lattice calculations](https://github.com/floatingpragma/observer-patch-holography/tree/main/code/particles/hadron): `code/particles/hadron`

### Other components

- **Researcher**

## Connections

- Researcher → Consensus reconstruction: studies
- Consensus reconstruction → Paired source routes: constructs routes
- Consensus reconstruction → Checkpoint histories: reconstructs histories
- Consensus reconstruction → Routing refinement: refines records
- Consensus reconstruction → Causal refinement: constrains geometry
- Consensus reconstruction → Observer geometry: supports reconstruction
- Observer geometry → Electromagnetic fields: supports field theory
- Consensus reconstruction → Thermodynamic laws: motivates repair laws
- Consensus reconstruction → Quantum transport: supports probabilities
- Consensus reconstruction → Gauge classification: constrains symmetry
- Gauge classification → Matter construction: classifies matter grammar
- Matter construction → Particle calibration: supports physical predictions
- Consensus reconstruction → Pixel fixed point: sets closure target
- Consensus reconstruction → Capacity cosmology: sets capacity target
- Particle calibration → Prediction ledger: compares predictions
- Capacity cosmology → Prediction ledger: records comparisons
- Researcher → Lattice calculations: examines calculations
- Researcher → IBM quantum lane: runs hardware studies