# 42pizzapirates/archify architecture

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

- Interactive diagram: https://gitdiagram.com/42pizzapirates/archify
- Repository: https://github.com/42pizzapirates/archify

## Overview

Archify turns an agent-authored, typed JSON diagram into a validated, self-contained interactive artifact. The main path runs from the authoring agent through the command-line loading and validation layer to a type-specific renderer; users then inspect, trace, guide, and export the result. Separate capabilities include architecture-delta comparison and preview/open workflows. The README documents product capabilities; the source index and excerpts support the implementation links shown. Viewer modules are grouped by capability because their wiring was not sampled.

Main entry points: [`archify/renderers/shared/cli.mjs`](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/cli.mjs) (Diagram CLI), [`archify/renderers/shared/geometry.mjs`](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/geometry.mjs) (Shared geometry), [`archify/bin/archify.mjs`](https://github.com/42pizzapirates/archify/blob/main/archify/bin/archify.mjs) (Archify command), [`archify/renderers/architecture/render-architecture.mjs`](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/architecture/render-architecture.mjs) (Architecture renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Authoring and runtime"]
  node_cli["Diagram CLI<br/>[cli.mjs]"]
  node_main["Archify command<br/>[archify.mjs]"]
  node_preview["Live preview<br/>[preview.mjs]"]
  node_open["Open artifact<br/>[open-artifact.mjs]"]
  node_visual["Visual checks<br/>[visual-check.mjs]"]
  node_artifact["HTML artifact<br/>[cli.mjs]"]
end

subgraph group_render["Diagram rendering"]
  node_architecture["Architecture renderer"]
  node_workflow["Workflow renderer"]
  node_sequence["Sequence renderer"]
  node_dataflow["Dataflow renderer"]
  node_lifecycle["Lifecycle renderer"]
end

subgraph group_viewer["Interactive review"]
  node_search["Node search<br/>[node-finder.js]"]
  node_trace["Route and reach<br/>[route-probe.js]"]
  node_lens["Role comparison<br/>[semantic-lens.js]"]
  node_stories["Guided stories<br/>[guided-views.js]"]
  node_export["Artifact export<br/>[export.js]"]
end

subgraph group_support["Evidence and comparison"]
  node_validators["Schema validation<br/>[validator.mjs]"]
  node_repository["Source evidence"]
  node_brand["Brand marks<br/>[brand-marks.mjs]"]
  node_geometry["Shared geometry<br/>[geometry.mjs]"]
  node_delta["Architecture delta"]
end

node_agent(("Agent author"))

node_agent -->|"provides typed JSON"| node_cli
node_cli -->|"validates schema"| node_validators
node_cli -->|"verifies sources"| node_repository
node_cli -->|"prepares marks"| node_brand
node_cli -->|"renders architecture"| node_architecture
node_cli -->|"renders workflow"| node_workflow
node_cli -->|"renders sequence"| node_sequence
node_cli -->|"renders dataflow"| node_dataflow
node_cli -->|"renders lifecycle"| node_lifecycle
node_cli -->|"writes HTML"| node_artifact
node_architecture -->|"uses geometry"| node_geometry
node_workflow -->|"uses geometry"| node_geometry
node_sequence -->|"uses geometry"| node_geometry
node_dataflow -->|"uses geometry"| node_geometry
node_lifecycle -->|"uses geometry"| node_geometry
node_main -->|"offers opening"| node_open
node_main -->|"offers preview"| node_preview
node_main -->|"offers checks"| node_visual
node_artifact -->|"supports search"| node_search
node_artifact -->|"supports route tracing"| node_trace
node_artifact -->|"supports role comparison"| node_lens
node_artifact -->|"supports guided stories"| node_stories
node_artifact -->|"supports export"| node_export
node_agent -->|"compares snapshots"| node_delta

click node_cli "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/cli.mjs"
click node_main "https://github.com/42pizzapirates/archify/blob/main/archify/bin/archify.mjs"
click node_preview "https://github.com/42pizzapirates/archify/blob/main/archify/bin/preview.mjs"
click node_open "https://github.com/42pizzapirates/archify/blob/main/archify/bin/open-artifact.mjs"
click node_visual "https://github.com/42pizzapirates/archify/blob/main/archify/bin/visual-check.mjs"
click node_architecture "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/architecture/render-architecture.mjs"
click node_workflow "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/workflow/workflow-compiler.mjs"
click node_sequence "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/sequence/render-sequence.mjs"
click node_dataflow "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/dataflow/render-dataflow.mjs"
click node_lifecycle "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/lifecycle/render-lifecycle.mjs"
click node_validators "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/validator.mjs"
click node_repository "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/repository-evidence.mjs"
click node_brand "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/brand-marks.mjs"
click node_geometry "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/geometry.mjs"
click node_delta "https://github.com/42pizzapirates/archify/blob/main/archify/delta/architecture-delta.mjs"
click node_artifact "https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/cli.mjs"
click node_search "https://github.com/42pizzapirates/archify/blob/main/viewer/node-finder.js"
click node_trace "https://github.com/42pizzapirates/archify/blob/main/viewer/route-probe.js"
click node_lens "https://github.com/42pizzapirates/archify/blob/main/viewer/semantic-lens.js"
click node_stories "https://github.com/42pizzapirates/archify/blob/main/viewer/guided-views.js"
click node_export "https://github.com/42pizzapirates/archify/blob/main/viewer/export.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_cli,node_main,node_preview,node_open,node_visual,node_artifact toneBlue
class node_architecture,node_workflow,node_sequence,node_dataflow,node_lifecycle toneAmber
class node_search,node_trace,node_lens,node_stories,node_export toneMint
class node_validators,node_repository,node_brand,node_geometry,node_delta toneRose
class node_agent toneIndigo
```

## Components

### Authoring and runtime

- [Diagram CLI](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/cli.mjs): `archify/renderers/shared/cli.mjs`
- [Archify command](https://github.com/42pizzapirates/archify/blob/main/archify/bin/archify.mjs): `archify/bin/archify.mjs`
- [Live preview](https://github.com/42pizzapirates/archify/blob/main/archify/bin/preview.mjs): `archify/bin/preview.mjs`
- [Open artifact](https://github.com/42pizzapirates/archify/blob/main/archify/bin/open-artifact.mjs): `archify/bin/open-artifact.mjs`
- [Visual checks](https://github.com/42pizzapirates/archify/blob/main/archify/bin/visual-check.mjs): `archify/bin/visual-check.mjs`
- [HTML artifact](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/cli.mjs): `archify/renderers/shared/cli.mjs`

### Diagram rendering

- [Architecture renderer](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/architecture/render-architecture.mjs): `archify/renderers/architecture/render-architecture.mjs`
- [Workflow renderer](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/workflow/workflow-compiler.mjs): `archify/renderers/workflow/workflow-compiler.mjs`
- [Sequence renderer](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/sequence/render-sequence.mjs): `archify/renderers/sequence/render-sequence.mjs`
- [Dataflow renderer](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/dataflow/render-dataflow.mjs): `archify/renderers/dataflow/render-dataflow.mjs`
- [Lifecycle renderer](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/lifecycle/render-lifecycle.mjs): `archify/renderers/lifecycle/render-lifecycle.mjs`

### Interactive review

- [Node search](https://github.com/42pizzapirates/archify/blob/main/viewer/node-finder.js): `viewer/node-finder.js`
- [Route and reach](https://github.com/42pizzapirates/archify/blob/main/viewer/route-probe.js): `viewer/route-probe.js`
- [Role comparison](https://github.com/42pizzapirates/archify/blob/main/viewer/semantic-lens.js): `viewer/semantic-lens.js`
- [Guided stories](https://github.com/42pizzapirates/archify/blob/main/viewer/guided-views.js): `viewer/guided-views.js`
- [Artifact export](https://github.com/42pizzapirates/archify/blob/main/viewer/export.js): `viewer/export.js`

### Evidence and comparison

- [Schema validation](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/validator.mjs): `archify/renderers/shared/validator.mjs`
- [Source evidence](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/repository-evidence.mjs): `archify/renderers/shared/repository-evidence.mjs`
- [Brand marks](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/brand-marks.mjs): `archify/renderers/shared/brand-marks.mjs`
- [Shared geometry](https://github.com/42pizzapirates/archify/blob/main/archify/renderers/shared/geometry.mjs): `archify/renderers/shared/geometry.mjs`
- [Architecture delta](https://github.com/42pizzapirates/archify/blob/main/archify/delta/architecture-delta.mjs): `archify/delta/architecture-delta.mjs`

### Other components

- **Agent author**

## Connections

- Agent author → Diagram CLI: provides typed JSON (evidence: `README.md`)
- Diagram CLI → Schema validation: validates schema (evidence: `archify/renderers/shared/cli.mjs`)
- Diagram CLI → Source evidence: verifies sources (evidence: `archify/renderers/shared/cli.mjs`)
- Diagram CLI → Brand marks: prepares marks (evidence: `archify/renderers/shared/cli.mjs`)
- Diagram CLI → Architecture renderer: renders architecture (evidence: `README.md`)
- Diagram CLI → Workflow renderer: renders workflow (evidence: `README.md`)
- Diagram CLI → Sequence renderer: renders sequence (evidence: `README.md`)
- Diagram CLI → Dataflow renderer: renders dataflow (evidence: `README.md`)
- Diagram CLI → Lifecycle renderer: renders lifecycle (evidence: `README.md`)
- Diagram CLI → HTML artifact: writes HTML (evidence: `archify/renderers/shared/cli.mjs`)
- Architecture renderer → Shared geometry: uses geometry (evidence: `archify/renderers/architecture/render-architecture.mjs`)
- Workflow renderer → Shared geometry: uses geometry (evidence: `archify/renderers/workflow/workflow-compiler.mjs`)
- Sequence renderer → Shared geometry: uses geometry (evidence: `archify/renderers/sequence/render-sequence.mjs`)
- Dataflow renderer → Shared geometry: uses geometry (evidence: `archify/renderers/dataflow/render-dataflow.mjs`)
- Lifecycle renderer → Shared geometry: uses geometry (evidence: `archify/renderers/lifecycle/render-lifecycle.mjs`)
- Archify command → Open artifact: offers opening (evidence: `archify/bin/archify.mjs`)
- Archify command → Live preview: offers preview (evidence: `archify/bin/archify.mjs`)
- Archify command → Visual checks: offers checks (evidence: `archify/bin/archify.mjs`)
- HTML artifact → Node search: supports search (evidence: `README.md`)
- HTML artifact → Route and reach: supports route tracing (evidence: `README.md`)
- HTML artifact → Role comparison: supports role comparison (evidence: `README.md`)
- HTML artifact → Guided stories: supports guided stories (evidence: `README.md`)
- HTML artifact → Artifact export: supports export (evidence: `README.md`)
- Agent author → Architecture delta: compares snapshots (evidence: `README.md`)
