Platform reference
A conceptual and reference manual for the Fabric platform — ontology-based architecture, agent-native runtime, and the governed mutation pipeline.
@fabricorg/platform is a portable runtime for ontology-based business applications. It owns the mechanics of governed mutation — action lifecycle, policy dispatch, state-machine validation, adapter retry, event append — and nothing else.
Vertical packages (e.g. @repo/lending) plug into that runtime by declaring a FabricModule that registers their object types, actions, policies, state machines, and event types. The host app composes modules at startup.
Why this exists
Most line-of-business apps mix three concerns:
- Ontology — what entities exist, what actions are legal on them, what counts as a state change.
- Mutation orchestration — how a request becomes a write, with auth, validation, retry, and audit.
- Vertical workflow — the actual business logic.
Fabric splits these. The platform owns (2). Modules own (1) and (3). The result: every domain mutation in the system flows through one auditable pipeline, regardless of whether it was triggered by a human in a UI, an AI agent, an external token holder, or a scheduled worker.
How to read these docs
| If you want to… | Start here |
|---|---|
| Understand the architecture | Architecture overview → mutation pipeline |
| Trace what happens when an action is invoked | Action pipeline → triggers → stages |
| Know which entities the platform pre-registers | Entities → built-ins |
| Build a new vertical module | Patterns → vertical extensions and the companion vertical-modules guide |
| Understand how policies gate mutations | Governance → enforcement |
| Look up an event-envelope or projection contract | Reference → event schema, projection mechanics |
The one-line invariant
Actor → ActionInvocation → PolicyEvaluation → StateMachine → Handler/Saga → AdapterInvocation → AssetEvent → ProjectionEvery page in this section is a closer look at one segment of that line.
See also
- Building a vertical module — the companion how-to guide for shipping a new vertical.
@fabricorg/platformREADME — source-of-truth contract surface.