Docs/System model

System model

The Substrate is Lamarck's durable public contract. System modules implement, protect, and operate it.

Current contractLast updated July 17, 2026

This page names the major ownership boundaries. It deliberately leaves manifest fields, OAuth flows, and SQL policy to their module documentation.

The public contract

The Substrate is the part of Lamarck that survives changes in implementation. Timeline preserves Events. System Shape describes the current Sources, Apps, Documents, and Tables.

Its technical contract includes stable identity, durable representation, provenance, mutation rules, and workspace materialization. A different Shell or runtime must still preserve those contracts.

The machinery

ModuleRelationship to the Substrate
App RuntimeTurns an App package into isolated UI, service, and job workloads.
Connector RuntimeTurns a trusted Connector package and configuration into a Source.
CredentialSupplies external credentials without making them part of the Substrate.
Authority & GuardDerives identity, authorizes operations, and audits durable mutations.
Control PlaneOwns runtime configuration, lifecycle, supervision, and system.db.
InterfacesLets people, Apps, tools, and AI operate the same bounded system.

Cross-module invariants

  • Modules may change without silently changing the durable Substrate contract.
  • Runtime state in system.db is not personal Timeline data.
  • Credentials are secret control state, not Documents, Tables, or Events.
  • Every durable managed mutation reaches the Substrate through an authenticated, authorized interface.
  • Interfaces do not gain authority merely by presenting the same data differently.
NextThe Substrate contract