# c4us4l1ty/holonomy architecture

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

- Interactive diagram: https://gitdiagram.com/c4us4l1ty/holonomy
- Repository: https://github.com/c4us4l1ty/holonomy

## Overview

The active workspace is a Rust/Linux application centered on secure document handling; comments describe a fixed-size encrypted `.wavefunction` container, a syscall jail, and memory protection. The tree also contains `H2/`, explicitly marked as a superseded, excluded stack, so it is not treated as part of the current runtime. With no README and limited source excerpts, the graph emphasizes documented crate responsibilities and only the internal links visible in the source index or excerpts.

Main entry points: [`crates/holonomy-jail/src/lib.rs`](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/lib.rs) (Process jail), [`crates/holonomy-assets/src/lib.rs`](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/lib.rs) (Font assets), [`crates/holonomy-assets/src/box_drawing.rs`](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/box_drawing.rs) (Box drawing), [`H2/crates/holonomy-shell/src/export/worker.rs`](https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/worker.rs) (Export worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_document["Document runtime"]
  node_app["Application entry<br/>[main.rs]"]
  node_core[("Document core<br/>[store.rs]")]
end

subgraph group_security["Security boundary"]
  node_container["Encrypted container<br/>[lib.rs]"]
  node_crypto["Cryptography<br/>[envelope.rs]"]
  node_secure["Protected memory<br/>[lib.rs]"]
  node_jail["Process jail<br/>[lib.rs]"]
  node_census["Syscall census<br/>[census.rs]"]
  node_seccomp["Seccomp filter<br/>[mod.rs]"]
  node_syscalltable["Syscall allowlist<br/>[table.rs]"]
  node_tripwire["Tripwire handling<br/>[tripwire.rs]"]
end

subgraph group_presentation["Rendering and assets"]
  node_assets["Font assets<br/>[lib.rs]"]
  node_atlas["Glyph atlas<br/>[atlas.rs]"]
  node_boxdrawing["Box drawing<br/>[box_drawing.rs]"]
  node_metrics["Font metrics<br/>[metric.rs]"]
  node_text["Text editor<br/>[editor.rs]"]
  node_geometry["Text geometry<br/>[lines.rs]"]
  node_fenwick["Height index<br/>[fenwick.rs]"]
  node_render["Render tree<br/>[tree.rs]"]
  node_damage["Damage tracking<br/>[damage.rs]"]
end

subgraph group_platform["Input and export"]
  node_input["Input events<br/>[keymap.rs]"]
  node_display["Display interface<br/>[lib.rs]"]
  node_export["Document export<br/>[pdf.rs]"]
  node_shellworker["Export worker<br/>[worker.rs]"]
  node_progress["Export progress<br/>[progress.rs]"]
  node_world["Export layout<br/>[world.rs]"]
end

node_container -->|"uses AEAD"| node_crypto
node_secure -->|"registers memory"| node_jail
node_jail -->|"includes"| node_census
node_jail -->|"includes"| node_seccomp
node_jail -->|"includes"| node_tripwire
node_seccomp -->|"uses table"| node_syscalltable
node_census -->|"names syscalls"| node_syscalltable
node_tripwire -->|"uses registry"| node_jail
node_assets -->|"builds atlas"| node_atlas
node_assets -->|"adds glyphs"| node_boxdrawing
node_assets -->|"uses metrics"| node_metrics
node_boxdrawing -->|"packs glyphs"| node_atlas
node_boxdrawing -->|"uses metrics"| node_metrics
node_geometry -->|"uses index"| node_fenwick
node_render -->|"uses tracking"| node_damage
node_export -.->|"runs layout"| node_shellworker
node_shellworker -->|"reports phases"| node_progress
node_shellworker -->|"uses layout"| node_world

click node_app "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy/src/main.rs"
click node_core "https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-core/src/store.rs"
click node_container "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-container/src/lib.rs"
click node_crypto "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-crypto/src/envelope.rs"
click node_secure "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-secure/src/lib.rs"
click node_jail "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/lib.rs"
click node_census "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/census.rs"
click node_seccomp "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/seccomp/mod.rs"
click node_syscalltable "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/seccomp/table.rs"
click node_tripwire "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/tripwire.rs"
click node_assets "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/lib.rs"
click node_atlas "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/atlas.rs"
click node_boxdrawing "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/box_drawing.rs"
click node_metrics "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/metric.rs"
click node_text "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-text/src/editor.rs"
click node_geometry "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-geometry/src/lines.rs"
click node_fenwick "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-geometry/src/fenwick.rs"
click node_render "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-render/src/tree.rs"
click node_damage "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-render/src/damage.rs"
click node_input "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-input/src/keymap.rs"
click node_display "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-display/src/lib.rs"
click node_export "https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-export/src/pdf.rs"
click node_shellworker "https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/worker.rs"
click node_progress "https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/progress.rs"
click node_world "https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/world.rs"

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_app,node_core toneBlue
class node_container,node_crypto,node_secure,node_jail,node_census,node_seccomp,node_syscalltable,node_tripwire toneAmber
class node_assets,node_atlas,node_boxdrawing,node_metrics,node_text,node_geometry,node_fenwick,node_render,node_damage toneMint
class node_input,node_display,node_export,node_shellworker,node_progress,node_world toneRose
```

## Components

### Document runtime

- [Application entry](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy/src/main.rs): `crates/holonomy/src/main.rs`
- [Document core](https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-core/src/store.rs): `H2/crates/holonomy-core/src/store.rs`

### Security boundary

- [Encrypted container](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-container/src/lib.rs): `crates/holonomy-container/src/lib.rs`
- [Cryptography](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-crypto/src/envelope.rs): `crates/holonomy-crypto/src/envelope.rs`
- [Protected memory](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-secure/src/lib.rs): `crates/holonomy-secure/src/lib.rs`
- [Process jail](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/lib.rs): `crates/holonomy-jail/src/lib.rs`
- [Syscall census](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/census.rs): `crates/holonomy-jail/src/census.rs`
- [Seccomp filter](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/seccomp/mod.rs): `crates/holonomy-jail/src/seccomp/mod.rs`
- [Syscall allowlist](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/seccomp/table.rs): `crates/holonomy-jail/src/seccomp/table.rs`
- [Tripwire handling](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-jail/src/tripwire.rs): `crates/holonomy-jail/src/tripwire.rs`

### Rendering and assets

- [Font assets](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/lib.rs): `crates/holonomy-assets/src/lib.rs`
- [Glyph atlas](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/atlas.rs): `crates/holonomy-assets/src/atlas.rs`
- [Box drawing](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/box_drawing.rs): `crates/holonomy-assets/src/box_drawing.rs`
- [Font metrics](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-assets/src/metric.rs): `crates/holonomy-assets/src/metric.rs`
- [Text editor](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-text/src/editor.rs): `crates/holonomy-text/src/editor.rs`
- [Text geometry](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-geometry/src/lines.rs): `crates/holonomy-geometry/src/lines.rs`
- [Height index](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-geometry/src/fenwick.rs): `crates/holonomy-geometry/src/fenwick.rs`
- [Render tree](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-render/src/tree.rs): `crates/holonomy-render/src/tree.rs`
- [Damage tracking](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-render/src/damage.rs): `crates/holonomy-render/src/damage.rs`

### Input and export

- [Input events](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-input/src/keymap.rs): `crates/holonomy-input/src/keymap.rs`
- [Display interface](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-display/src/lib.rs): `crates/holonomy-display/src/lib.rs`
- [Document export](https://github.com/c4us4l1ty/holonomy/blob/main/crates/holonomy-export/src/pdf.rs): `crates/holonomy-export/src/pdf.rs`
- [Export worker](https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/worker.rs): `H2/crates/holonomy-shell/src/export/worker.rs`
- [Export progress](https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/progress.rs): `H2/crates/holonomy-shell/src/export/progress.rs`
- [Export layout](https://github.com/c4us4l1ty/holonomy/blob/main/H2/crates/holonomy-shell/src/export/world.rs): `H2/crates/holonomy-shell/src/export/world.rs`

## Connections

- Encrypted container → Cryptography: uses AEAD (evidence: `crates/holonomy-container/src/lib.rs`)
- Protected memory → Process jail: registers memory (evidence: `crates/holonomy-secure/src/lib.rs`)
- Process jail → Syscall census: includes (evidence: `crates/holonomy-jail/src/lib.rs`)
- Process jail → Seccomp filter: includes (evidence: `crates/holonomy-jail/src/lib.rs`)
- Process jail → Tripwire handling: includes (evidence: `crates/holonomy-jail/src/lib.rs`)
- Seccomp filter → Syscall allowlist: uses table (evidence: `crates/holonomy-jail/src/seccomp/mod.rs`)
- Syscall census → Syscall allowlist: names syscalls (evidence: `crates/holonomy-jail/src/census.rs`)
- Tripwire handling → Process jail: uses registry (evidence: `crates/holonomy-jail/src/tripwire.rs`)
- Font assets → Glyph atlas: builds atlas (evidence: `crates/holonomy-assets/src/lib.rs`)
- Font assets → Box drawing: adds glyphs (evidence: `crates/holonomy-assets/src/lib.rs`)
- Font assets → Font metrics: uses metrics (evidence: `crates/holonomy-assets/src/lib.rs`)
- Box drawing → Glyph atlas: packs glyphs (evidence: `crates/holonomy-assets/src/box_drawing.rs`)
- Box drawing → Font metrics: uses metrics (evidence: `crates/holonomy-assets/src/box_drawing.rs`)
- Text geometry → Height index: uses index (evidence: `crates/holonomy-geometry/src/lines.rs`)
- Render tree → Damage tracking: uses tracking (evidence: `crates/holonomy-render/src/tree.rs`)
- Document export → Export worker: runs layout
- Export worker → Export progress: reports phases (evidence: `H2/crates/holonomy-shell/src/export/worker.rs`)
- Export worker → Export layout: uses layout (evidence: `H2/crates/holonomy-shell/src/export/worker.rs`)
