Skip to content
DocumentationArchitecture
On this page

Page resources

Open Markdownllms.txtView source

Last updated

Architecture

One is a composition of isolated systems. Every stable identity, schema, fault, effect, operation, requirement, provider claim, plan node, artifact, grant, observation, and historical fact has one semantic owner.

Semantic flow

The arrows show semantic consumption and lowering, not permission to import a sibling's internals. Cross-system code depends only on public owned contracts.

Eight owned representations

StageOwnerQuestion answered
D-IRKnowledgeWhat accepted declarations were authored?
S-IRKnowledgeWhat is their normalized owner-validated meaning?
R-IRPlanningWhat does this exact root require?
L-IRPlanningWhich provider-independent realization shapes are valid?
P-IRPlanningWhich exact providers, topology, targets, and costs are selected?
A-IRBuildWhich exact actions and artifacts materialize that selection?
DPL-IRDeploymentWhere are artifacts placed and grants bound?
REC-IRDeploymentWhich fenced actions reconcile desired and observed state?

Runtime state and historical facts are not additional planning stages. No earlier record is accepted as later-stage evidence or authority.

Owner map

SystemOwns
Benchmarkcontrolled workloads, environments, measurements, comparison methodology, and governed performance evidence
Foundationstable values, identities, faults, time, events, target and host facts
Resourcesresource identity, lifecycle, ownership, containment, and cleanup
Authoritycapabilities, effects, policy, grants, tokens, trust, identity, and admission
Executionstructured concurrency, tasks, cancellation, deadlines, scheduling, and backpressure
Contractssemantic-domain meta-models, schemas, mappings, OCS, projections, and interoperability
System IDL.one envelope, semantic grammar, implementation framing, parser, formatter, and source maps
Datastate, transactions, queries, layouts, conversions, and data-provider contracts
Communicationinvocation, endpoints, streams, RPC, messaging, delivery, and transport semantics
Componentsoperations, services, jobs, workflows, placement, and component runtime contracts
Compositionapplications, roots, areas, declaration graphs, and per-root semantic closure
Experienceexplicit product-facing places, intents, projections, interaction state, accessibility, localization, and bounded surface contracts
Knowledgesemantic graph, D-IR, S-IR, provenance, explanation, and semantic facts
PlanningR-IR, L-IR, P-IR, provider selection, topology, costs, and inclusion proofs
BuildA-IR, actions, artifacts, CAS, toolchains, provenance, signing, and Build evidence
DeploymentDPL-IR, REC-IR, apply, reconciliation, placement, rollout, and infrastructure lifecycle
Historyimmutable causal facts, replay bounds, compensation, and forward rollback
Observabilityobservations, correlation, budgets, logs, metrics, traces, audits, lineage, and costs
Provider Ecosystemprovider, adapter, semantic, and language-tool supply and governed admission
Developer InterfaceCLI, facade, project tooling, inspection, and automation orchestration

Global invariants

  • One contract has one owner and one current revision line.
  • A digest commits an inspectable owner value; it never substitutes for it.
  • Requirements are not grants, plans are not artifacts, and artifacts are not runtime authority.
  • Closure is independent for every root and deployable.
  • Optional contracts remain inert until explicitly selected for one root.
  • Generated projections are disposable; source contracts and receipts remain.
  • Providers and adapters are removable; contracts never depend on them.
  • Unknown external outcomes are reconciled before unsafe repetition.
  • A missing realization returns typed unsupported, unsatisfied, or missing-evidence output.

Normative source: repository architecture.