MeridiansMeridians

Diagrams

Visual explanations and diagrams.

System diagrams

How the whole app connects, verified against code. Companion to the generated file map. Each diagram is single-purpose and tagged by kind — read the one you need, not a wall.

Three tracks:

  • [Concept] — what the system is (the models you reason with).
  • [Flow] — how work moves (pipelines, state machines, request paths).
  • [UI] — what you see (surface layouts and their component trees).

The whole map in one file: generated ALL.md — every diagram below concatenated in this README's order, generated by npm run gen:diagrams (do not hand-edit). Use it to paste the entire system into a model or to review the shape of everything at once; the single-purpose files stay the thing a human reads. npm run gen:diagrams:mermaid writes the graphs-only variant.

Concepts — the models

DiagramThe idea
Three layers of opinionThreads (settled) · Streams (present) · Positions (the live forward read)
Domain spineSystem · World · Fate — the measured substrate opinion is held over
Projection anatomyReading · Reasoning Graph · Signal — how a live forward read is anchored and re-priced
Phase graphThe descriptive working model creativity inherits — one opt-in lever, uniform reach, evidence surfaces excluded
Entity Interpretation Graphfoundation — evidence profile → selected ordered context → situated action field, with Will attributable but unstored
The Program loopResearch → Opinion → Merge → Position — the machine that keeps all three current
Forces — derivationswhat is computed on read vs stored — pure derivations over the spine
AI model routingtier · category · profile — how a call picks its model, and how the fleet re-tunes
Platform modelTwo products · three authorities (platform role / entitlement / people) · one host-agnostic daemon
Worlddirection — Domain + Scenario → preserved branch states → parallel, clocked, multi-camera worlds driven through MCP

Flows — how work moves

DiagramThe path
Access gatewho gets in, and to what — the decision ladder
Navigationthe page graph + the deep-link lifecycle (routes.ts → useUrlIntent → navigateTo → stage history)
Reducer taxonomyone writer, 22 slices, 247 actions — the single-writer terminus + ACTION_META
Operation lifecyclea Tier-2 op from dispatch → streamed events → commit + nextMoves
Schedulercadence → armed timer → gates (week / spend / serial / concurrency) → fired run
Onboarding6-step stepper → background runner → live Constellation
Domain creationthree on-ramps → one canonical Domain record
Human loopOrient → Judge → Steer → Learn → Refine over the Program
Gameplay loopcurrent loop audit → nested training loop → proof ladder from remembered Domain to trained agency
Stream lifecycleevidence-gathering lifecycle through Merge to canon
Position lifecyclelive Position re-pricing, re-grounding, and retirement
Directive lifecyclestaged human intent through a later Program run
Maintenance runone converter → the research run (Firecrawl → priors)
Research pipelinethe ONE Research driver (op + dashboard via ResearchPort) → Firecrawl → Articles → priors → brief/refine/monitor/tutor
Extraction pipelinecorpus → chunk → concurrent extraction → re-extract Fate / System → domain
Reasoning graph enginethree entry points → inference-over-substrate graph → sequential path
Merge resolutionmature Streams → proposal → Merge → Reasoning Graph → new Arc
Story pipelineProgram events → registry → editorial → projection → feed
Sync protocolmaster ⇄ clients — relayed pushes, echo suppression, catch-up
MCP action chainshow an AI navigates the tool surface by affordance — the record chain and the central-plane chain
MCP affordance mapgenerated — the whole tool graph drawn at three altitudes (realm → group → tool)
MCP runtimestdio + HTTP relay, session auth, Director attribution, and the one-writer terminus
Engine pipelineUI → engine/AI → canonical record → cache (one writer)
Scenario loopthe game state machine, its engine data-flow, and how to drive the game headless over MCP
Cache coherencehydrate / adopt / live — the disposable-cache invariant
Hosted sign-inone gateway session across each instance's own domain
Release & deploysource → CI → the 3 deploy targets → image maintenance → fleet roll
Weekly updatethe Friday GitHub business-summary CI pipeline

Not yet diagrammed (deliberately): World's concrete runtime—turn cadence, per-seat context, information propagation, economies, and scoring—remains product direction. The maintained World diagram maps the concept; the Gameplay loop maps the progression hypothesis without pretending those World mechanics ship. A concrete runtime flow lands when the first build establishes a real path.

UI — what you see

DiagramThe surface
Home consoleGatewayShell regions — spine + home tabs
Gateway public surfaceslanding reveal, public routes, plans, account handoff, and MCP setup
Gateway admin consoleGatewayConsoleShell — role-aware Users · Fleet · Devices · Account · Domain
Auth & access surfacesAuthShell — sign-in, Director welcome, MCP credential setup
Workspace shellWorkspaceShell regions — the cockpit around the Stage
Center viewsSectionRail → StageBar → stageView → component
Inspectorthe right UtilityRail / UtilityPanel and its detail bodies
Domain settingsDomainSettingsModal tabs — Direction (AI profiles) · Style · POV · Audio
Onboarding workspacesidebar progress rail → 6-step container → per-draft switcher
Extraction jobsExtractionShell — jobs list → live detail → new-job setup
ConstellationConstellationShell tabs — the portfolio container
TopBar & run surfacesmenus · modals · capture / generate / explore / review
Mobilethe separate focused path — workspace · constellation · home
Scenario UIthe poker-table layout + component tree