How frisco-deng/moradins-forge works
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: App.tsx Routes · moradin_forge.py Forge Onboarding CLI · tracker-context.tsx Tracker State · loaders.ts API Loaders
Components 20
Workspace Onboarding
- Forge Onboarding CLI
scripts/moradin_forge.py - Workstation Planning
scripts/moradin_workstation.py - Public Export
scripts/public_export.py
Tooling Installation
- Tooling Suite
scripts/moradin_tooling_suite.py
Air-Gap Installation
- Air-Gap Workflow
scripts/moradin_airgap.py
Forge UI
- UI Bootstrap
dev_tracker/ui/src/main.tsx - Routes
dev_tracker/ui/src/App.tsx - Workspace Shell
dev_tracker/ui/src/layout/AppShell.tsx - Project Overview
dev_tracker/ui/src/pages/OverviewPage.tsx - Project Builder
dev_tracker/ui/src/pages/ProjectBuilderPage.tsx - Review Hub
dev_tracker/ui/src/pages/ReviewHubPage.tsx - Documentation Views
dev_tracker/ui/src/pages/DocsPage.tsx - Deployment Workspace
dev_tracker/ui/src/pages/DeployMapPage.tsx
UI Data Layer
- Tracker State
dev_tracker/ui/src/lib/tracker-context.tsx - API Loaders
dev_tracker/ui/src/lib/loaders.ts - Data Contracts
dev_tracker/ui/src/lib/contracts.ts - Assistant Activity
dev_tracker/ui/src/lib/assistant-activity.ts
Other components
- User
- Coding Agent
- Forge API
Connections 20
- User → Tooling Suite: approves plan
README.md - User → Forge Onboarding CLI: approves workspaces
README.md - Coding Agent → Forge Onboarding CLI: onboards repositories
README.md - Forge Onboarding CLI → Workstation Planning: uses helpers
scripts/moradin_forge.py - Forge Onboarding CLI → Tooling Suite: uses tooling
scripts/moradin_forge.py - Forge Onboarding CLI → Public Export: exports data
scripts/public_export.py - User → Air-Gap Workflow: runs offline steps
README.md - UI Bootstrap → Routes: renders
dev_tracker/ui/src/main.tsx - UI Bootstrap → Tracker State: provides state
dev_tracker/ui/src/main.tsx - Routes → Deployment Workspace: routes to
dev_tracker/ui/src/App.tsx - Routes → Project Builder: routes to
dev_tracker/ui/src/App.tsx - Routes → Review Hub: routes to
dev_tracker/ui/src/App.tsx - Routes → Documentation Views: routes to
dev_tracker/ui/src/App.tsx - Workspace Shell → API Loaders: loads activity
dev_tracker/ui/src/layout/AppShell.tsx - Tracker State → API Loaders: loads snapshots
dev_tracker/ui/src/lib/tracker-context.tsx - API Loaders → Forge API: fetches data
dev_tracker/ui/src/lib/loaders.ts - Project Overview → Tracker State: reads state
dev_tracker/ui/src/pages/OverviewPage.tsx - Project Builder → Tracker State: reads state
dev_tracker/ui/src/pages/ProjectBuilderPage.tsx - Project Builder → Assistant Activity: signals runs
dev_tracker/ui/src/pages/ProjectBuilderPage.tsx - Review Hub → API Loaders: runs assistant
dev_tracker/ui/src/pages/ReviewHubPage.tsx