# frisco-deng/moradins-forge architecture

> Architecture diagram of the GitHub repository frisco-deng/moradins-forge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/frisco-deng/moradins-forge
- Repository: https://github.com/frisco-deng/moradins-forge

## Overview

Moradin’s Forge is a consent-gated workstation tooling installer and repository-onboarding guide, with an accompanying UI for project tracking, deployment planning, reviews, and documentation. The documented user path is to approve and run installation, then have an agent discover only approved workspaces and review proposed guidance-file changes. The UI’s sampled entrypoint and state layer show route composition and snapshot loading; the README documents the installer and air-gap paths. Some UI pages and backend implementation are unsampled, so their internal connections are not inferred.

Main entry points: [`dev_tracker/ui/src/App.tsx`](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/App.tsx) (Routes), [`scripts/moradin_forge.py`](https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_forge.py) (Forge Onboarding CLI), [`dev_tracker/ui/src/lib/tracker-context.tsx`](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/tracker-context.tsx) (Tracker State), [`dev_tracker/ui/src/lib/loaders.ts`](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/loaders.ts) (API Loaders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_onboard["Workspace Onboarding"]
  node_forge_cli["Forge Onboarding CLI<br/>[moradin_forge.py]"]
  node_workstation["Workstation Planning"]
  node_export["Public Export<br/>[public_export.py]"]
end

subgraph group_install["Tooling Installation"]
  node_tool_suite["Tooling Suite"]
end

subgraph group_offline["Air-Gap Installation"]
  node_airgap["Air-Gap Workflow<br/>[moradin_airgap.py]"]
end

subgraph group_ui["Forge UI"]
  node_ui_entry["UI Bootstrap<br/>[main.tsx]"]
  node_router["Routes<br/>[App.tsx]"]
  node_app_shell["Workspace Shell<br/>[AppShell.tsx]"]
  node_overview["Project Overview<br/>[OverviewPage.tsx]"]
  node_builder["Project Builder"]
  node_review_hub["Review Hub<br/>[ReviewHubPage.tsx]"]
  node_docs_pages["Documentation Views<br/>[DocsPage.tsx]"]
  node_deploy_pages["Deployment Workspace<br/>[DeployMapPage.tsx]"]
end

subgraph group_ui_core["UI Data Layer"]
  node_tracker["Tracker State"]
  node_loaders["API Loaders<br/>[loaders.ts]"]
  node_contracts["Data Contracts<br/>[contracts.ts]"]
  node_assistant_activity["Assistant Activity"]
end

node_user(("User"))
node_agent(("Coding Agent"))
node_api["Forge API"]

node_user -.->|"approves plan"| node_tool_suite
node_user -.->|"approves workspaces"| node_forge_cli
node_agent -.->|"onboards repositories"| node_forge_cli
node_forge_cli -->|"uses helpers"| node_workstation
node_forge_cli -->|"uses tooling"| node_tool_suite
node_forge_cli -->|"exports data"| node_export
node_user -.->|"runs offline steps"| node_airgap
node_ui_entry -->|"renders"| node_router
node_ui_entry -->|"provides state"| node_tracker
node_router -->|"routes to"| node_deploy_pages
node_router -->|"routes to"| node_builder
node_router -.->|"routes to"| node_review_hub
node_router -.->|"routes to"| node_docs_pages
node_app_shell -->|"loads activity"| node_loaders
node_tracker -->|"loads snapshots"| node_loaders
node_loaders -->|"fetches data"| node_api
node_overview -->|"reads state"| node_tracker
node_builder -->|"reads state"| node_tracker
node_builder -->|"signals runs"| node_assistant_activity
node_review_hub -->|"runs assistant"| node_loaders

click node_forge_cli "https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_forge.py"
click node_workstation "https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_workstation.py"
click node_export "https://github.com/frisco-deng/moradins-forge/blob/main/scripts/public_export.py"
click node_tool_suite "https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_tooling_suite.py"
click node_airgap "https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_airgap.py"
click node_ui_entry "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/main.tsx"
click node_router "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/App.tsx"
click node_app_shell "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/layout/AppShell.tsx"
click node_overview "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/OverviewPage.tsx"
click node_builder "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/ProjectBuilderPage.tsx"
click node_review_hub "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/ReviewHubPage.tsx"
click node_docs_pages "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/DocsPage.tsx"
click node_deploy_pages "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/DeployMapPage.tsx"
click node_tracker "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/tracker-context.tsx"
click node_loaders "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/loaders.ts"
click node_contracts "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/contracts.ts"
click node_assistant_activity "https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/assistant-activity.ts"

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_forge_cli,node_workstation,node_export,node_user toneBlue
class node_tool_suite toneAmber
class node_airgap,node_api toneMint
class node_ui_entry,node_router,node_app_shell,node_overview,node_builder,node_review_hub,node_docs_pages,node_deploy_pages toneRose
class node_tracker,node_loaders,node_contracts,node_assistant_activity,node_agent toneIndigo
```

## Components

### Workspace Onboarding

- [Forge Onboarding CLI](https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_forge.py): `scripts/moradin_forge.py`
- [Workstation Planning](https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_workstation.py): `scripts/moradin_workstation.py`
- [Public Export](https://github.com/frisco-deng/moradins-forge/blob/main/scripts/public_export.py): `scripts/public_export.py`

### Tooling Installation

- [Tooling Suite](https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_tooling_suite.py): `scripts/moradin_tooling_suite.py`

### Air-Gap Installation

- [Air-Gap Workflow](https://github.com/frisco-deng/moradins-forge/blob/main/scripts/moradin_airgap.py): `scripts/moradin_airgap.py`

### Forge UI

- [UI Bootstrap](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/main.tsx): `dev_tracker/ui/src/main.tsx`
- [Routes](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/App.tsx): `dev_tracker/ui/src/App.tsx`
- [Workspace Shell](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/layout/AppShell.tsx): `dev_tracker/ui/src/layout/AppShell.tsx`
- [Project Overview](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/OverviewPage.tsx): `dev_tracker/ui/src/pages/OverviewPage.tsx`
- [Project Builder](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/ProjectBuilderPage.tsx): `dev_tracker/ui/src/pages/ProjectBuilderPage.tsx`
- [Review Hub](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/ReviewHubPage.tsx): `dev_tracker/ui/src/pages/ReviewHubPage.tsx`
- [Documentation Views](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/DocsPage.tsx): `dev_tracker/ui/src/pages/DocsPage.tsx`
- [Deployment Workspace](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/pages/DeployMapPage.tsx): `dev_tracker/ui/src/pages/DeployMapPage.tsx`

### UI Data Layer

- [Tracker State](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/tracker-context.tsx): `dev_tracker/ui/src/lib/tracker-context.tsx`
- [API Loaders](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/loaders.ts): `dev_tracker/ui/src/lib/loaders.ts`
- [Data Contracts](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/contracts.ts): `dev_tracker/ui/src/lib/contracts.ts`
- [Assistant Activity](https://github.com/frisco-deng/moradins-forge/blob/main/dev_tracker/ui/src/lib/assistant-activity.ts): `dev_tracker/ui/src/lib/assistant-activity.ts`

### Other components

- **User**
- **Coding Agent**
- **Forge API**

## Connections

- User → Tooling Suite: approves plan (evidence: `README.md`)
- User → Forge Onboarding CLI: approves workspaces (evidence: `README.md`)
- Coding Agent → Forge Onboarding CLI: onboards repositories (evidence: `README.md`)
- Forge Onboarding CLI → Workstation Planning: uses helpers (evidence: `scripts/moradin_forge.py`)
- Forge Onboarding CLI → Tooling Suite: uses tooling (evidence: `scripts/moradin_forge.py`)
- Forge Onboarding CLI → Public Export: exports data (evidence: `scripts/public_export.py`)
- User → Air-Gap Workflow: runs offline steps (evidence: `README.md`)
- UI Bootstrap → Routes: renders (evidence: `dev_tracker/ui/src/main.tsx`)
- UI Bootstrap → Tracker State: provides state (evidence: `dev_tracker/ui/src/main.tsx`)
- Routes → Deployment Workspace: routes to (evidence: `dev_tracker/ui/src/App.tsx`)
- Routes → Project Builder: routes to (evidence: `dev_tracker/ui/src/App.tsx`)
- Routes → Review Hub: routes to (evidence: `dev_tracker/ui/src/App.tsx`)
- Routes → Documentation Views: routes to (evidence: `dev_tracker/ui/src/App.tsx`)
- Workspace Shell → API Loaders: loads activity (evidence: `dev_tracker/ui/src/layout/AppShell.tsx`)
- Tracker State → API Loaders: loads snapshots (evidence: `dev_tracker/ui/src/lib/tracker-context.tsx`)
- API Loaders → Forge API: fetches data (evidence: `dev_tracker/ui/src/lib/loaders.ts`)
- Project Overview → Tracker State: reads state (evidence: `dev_tracker/ui/src/pages/OverviewPage.tsx`)
- Project Builder → Tracker State: reads state (evidence: `dev_tracker/ui/src/pages/ProjectBuilderPage.tsx`)
- Project Builder → Assistant Activity: signals runs (evidence: `dev_tracker/ui/src/pages/ProjectBuilderPage.tsx`)
- Review Hub → API Loaders: runs assistant (evidence: `dev_tracker/ui/src/pages/ReviewHubPage.tsx`)
