# chasehendrick/genchase architecture

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

- Interactive diagram: https://gitdiagram.com/chasehendrick/genchase
- Repository: https://github.com/chasehendrick/genchase

## Overview

GENChase is a browser-based scientific generative-art and print studio alongside a research workspace containing simulations, verification code, and papers. The main user workflow is to choose a scientific pattern system, run it from a seed and settings, preserve that recipe, and export a print-sized plate. The README documents these studio capabilities and the breadth of the research; source excerpts provide additional detail on the validator and selected proof modules. Many research directories are unsampled, so their internal execution links are not inferred.

Main entry points: [`src/shared/engine.js`](https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js) (Browser Studio), [`apps/validate/jobs.js`](https://github.com/chasehendrick/genchase/blob/main/apps/validate/jobs.js) (Job Runner), [`apps/validate/server.js`](https://github.com/chasehendrick/genchase/blob/main/apps/validate/server.js) (Validation App), [`papers/cardiac-rings/code/fourier/branch.py`](https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/branch.py) (Cardiac Proofs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_studio["Art Studio"]
  node_studio["Browser Studio<br/>[engine.js]"]
  node_systems["Pattern Systems<br/>[arago.js]"]
  node_systems_catalog["Additional Systems"]
  node_recipes["Seeded Recipes<br/>[engine.js]"]
  node_plate["Print Export<br/>[engine.js]"]
end

subgraph group_validation["Validation"]
  node_validator_ui["Validation App<br/>[server.js]"]
  node_job_modes["Art Job Modes<br/>[art-tabs.js]"]
  node_job_runner["Job Runner<br/>[jobs.js]"]
  node_sharing["Result Sharing<br/>[share.js]"]
  node_commands["Job Commands<br/>[commands.js]"]
end

subgraph group_research["Research Papers"]
  node_cardiac["Cardiac Proofs<br/>[branch.py]"]
  node_hh["HH Dynamics"]
  node_neural_pulses["Neural Pulse Proofs"]
  node_vortex["Vortex Mathematics"]
  node_other_papers["Other Papers"]
  node_cardiac_model["TP06 Model<br/>[tp06_18d.py]"]
  node_fourier_eval["Fourier Evaluation<br/>[fourier_eval.py]"]
  node_arb_model["Arb Model<br/>[arbmodel.py]"]
end

subgraph group_math["Research Workspace"]
  node_research_code["Research Programs"]
end

node_artist(("Artist"))

node_artist -->|"opens"| node_studio
node_studio -->|"loads selected"| node_systems
node_studio -->|"loads selected"| node_systems_catalog
node_artist -->|"sets seed and settings"| node_recipes
node_studio -->|"saves recipe"| node_recipes
node_studio -->|"exports print"| node_plate
node_validator_ui -->|"offers modes"| node_job_modes
node_validator_ui -->|"routes jobs"| node_job_runner
node_validator_ui -->|"routes sharing"| node_sharing
node_job_runner -->|"uses commands"| node_commands
node_job_runner -->|"uses tab rules"| node_job_modes
node_job_runner -->|"starts automatic share"| node_sharing
node_cardiac -->|"uses model"| node_cardiac_model
node_cardiac -->|"uses Arb model"| node_arb_model
node_cardiac -->|"uses evaluation"| node_fourier_eval
node_hh -.->|"supports research archive"| node_other_papers
node_research_code -.->|"supports research archive"| node_other_papers

click node_studio "https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js"
click node_systems "https://github.com/chasehendrick/genchase/blob/main/src/modules/arago.js"
click node_systems_catalog "https://github.com/chasehendrick/genchase/blob/main/src/modules/cgl-hofstadter-scars-caustics-smectic-hl-phyllotaxis.js"
click node_recipes "https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js"
click node_plate "https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js"
click node_validator_ui "https://github.com/chasehendrick/genchase/blob/main/apps/validate/server.js"
click node_job_modes "https://github.com/chasehendrick/genchase/blob/main/apps/validate/art-tabs.js"
click node_job_runner "https://github.com/chasehendrick/genchase/blob/main/apps/validate/jobs.js"
click node_sharing "https://github.com/chasehendrick/genchase/blob/main/apps/validate/share.js"
click node_cardiac "https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/branch.py"
click node_hh "https://github.com/chasehendrick/genchase/blob/main/papers/hh-dynamics/code/certify_bistability.py"
click node_neural_pulses "https://github.com/chasehendrick/genchase/tree/main/papers/nf-pulse/code"
click node_vortex "https://github.com/chasehendrick/genchase/blob/main/papers/minimal-winding/code/certify_pipeline.py"
click node_other_papers "https://github.com/chasehendrick/genchase/tree/main/papers"
click node_research_code "https://github.com/chasehendrick/genchase/tree/main/research"
click node_cardiac_model "https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/model/tp06_18d.py"
click node_fourier_eval "https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/fourier_eval.py"
click node_arb_model "https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/arbmodel.py"
click node_commands "https://github.com/chasehendrick/genchase/blob/main/apps/validate/commands.js"

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_studio,node_systems,node_systems_catalog,node_recipes,node_plate toneBlue
class node_validator_ui,node_job_modes,node_job_runner,node_sharing,node_commands toneAmber
class node_cardiac,node_hh,node_neural_pulses,node_vortex,node_other_papers,node_cardiac_model,node_fourier_eval,node_arb_model toneMint
class node_research_code toneRose
class node_artist toneIndigo
```

## Components

### Art Studio

- [Browser Studio](https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js): `src/shared/engine.js`
- [Pattern Systems](https://github.com/chasehendrick/genchase/blob/main/src/modules/arago.js): `src/modules/arago.js`
- [Additional Systems](https://github.com/chasehendrick/genchase/blob/main/src/modules/cgl-hofstadter-scars-caustics-smectic-hl-phyllotaxis.js): `src/modules/cgl-hofstadter-scars-caustics-smectic-hl-phyllotaxis.js`
- [Seeded Recipes](https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js): `src/shared/engine.js`
- [Print Export](https://github.com/chasehendrick/genchase/blob/main/src/shared/engine.js): `src/shared/engine.js`

### Validation

- [Validation App](https://github.com/chasehendrick/genchase/blob/main/apps/validate/server.js): `apps/validate/server.js`
- [Art Job Modes](https://github.com/chasehendrick/genchase/blob/main/apps/validate/art-tabs.js): `apps/validate/art-tabs.js`
- [Job Runner](https://github.com/chasehendrick/genchase/blob/main/apps/validate/jobs.js): `apps/validate/jobs.js`
- [Result Sharing](https://github.com/chasehendrick/genchase/blob/main/apps/validate/share.js): `apps/validate/share.js`
- [Job Commands](https://github.com/chasehendrick/genchase/blob/main/apps/validate/commands.js): `apps/validate/commands.js`

### Research Papers

- [Cardiac Proofs](https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/branch.py): `papers/cardiac-rings/code/fourier/branch.py`
- [HH Dynamics](https://github.com/chasehendrick/genchase/blob/main/papers/hh-dynamics/code/certify_bistability.py): `papers/hh-dynamics/code/certify_bistability.py`
- [Neural Pulse Proofs](https://github.com/chasehendrick/genchase/tree/main/papers/nf-pulse/code): `papers/nf-pulse/code`
- [Vortex Mathematics](https://github.com/chasehendrick/genchase/blob/main/papers/minimal-winding/code/certify_pipeline.py): `papers/minimal-winding/code/certify_pipeline.py`
- [Other Papers](https://github.com/chasehendrick/genchase/tree/main/papers): `papers`
- [TP06 Model](https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/model/tp06_18d.py): `papers/cardiac-rings/code/model/tp06_18d.py`
- [Fourier Evaluation](https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/fourier_eval.py): `papers/cardiac-rings/code/fourier/fourier_eval.py`
- [Arb Model](https://github.com/chasehendrick/genchase/blob/main/papers/cardiac-rings/code/fourier/arbmodel.py): `papers/cardiac-rings/code/fourier/arbmodel.py`

### Research Workspace

- [Research Programs](https://github.com/chasehendrick/genchase/tree/main/research): `research`

### Other components

- **Artist**

## Connections

- Artist → Browser Studio: opens (evidence: `README.md`)
- Browser Studio → Pattern Systems: loads selected (evidence: `README.md`)
- Browser Studio → Additional Systems: loads selected (evidence: `README.md`)
- Artist → Seeded Recipes: sets seed and settings (evidence: `README.md`)
- Browser Studio → Seeded Recipes: saves recipe (evidence: `README.md`)
- Browser Studio → Print Export: exports print (evidence: `README.md`)
- Validation App → Art Job Modes: offers modes (evidence: `apps/validate/server.js`)
- Validation App → Job Runner: routes jobs (evidence: `apps/validate/server.js`)
- Validation App → Result Sharing: routes sharing (evidence: `apps/validate/server.js`)
- Job Runner → Job Commands: uses commands (evidence: `apps/validate/jobs.js`)
- Job Runner → Art Job Modes: uses tab rules (evidence: `apps/validate/jobs.js`)
- Job Runner → Result Sharing: starts automatic share (evidence: `apps/validate/server.js`)
- Cardiac Proofs → TP06 Model: uses model (evidence: `papers/cardiac-rings/code/fourier/branch.py`)
- Cardiac Proofs → Arb Model: uses Arb model (evidence: `papers/cardiac-rings/code/fourier/branch.py`)
- Cardiac Proofs → Fourier Evaluation: uses evaluation (evidence: `papers/cardiac-rings/code/fourier/branch.py`)
- HH Dynamics → Other Papers: supports research archive (evidence: `papers/hh-dynamics/code/certify_bistability.py`)
- Research Programs → Other Papers: supports research archive
