# One

> Compose, build, ship, and operate glass-box systems from shared semantics and polyglot implementations.

Status: End-product architecture documentation.
Architecture version: 0.2.0-architecture.
Package version: 0.1.0.
Documentation revision: `2a10d9ab772f0319fd63da36c54e1c29ce82fb9f`.
Source: https://github.com/muijf/one.

## Documentation

- [One](/one.md): A semantic systems language and glass-box platform for complete polyglot products.
- [End-product walkthrough](/one/start/quickstart.md): Follow one application from declaration through inspection and apply.
- [How One works](/one/start/how-one-works.md): Understand ownership, lowering, roots, evidence, and explicit authority.
- [.one source files](/one/language/one-files.md): Combine isolated semantic and executable sections in one bounded source envelope.
- [System IDL](/one/language/system-idl.md): Declare stable meaning and governed intent without executing application code.
- [Executable sections](/one/language/executable-sections.md): Use native One, Rust, Python, TypeScript, and other admitted languages without grammar union.
- [Custom semantics](/one/language/custom-semantics.md): Publish independently owned semantic domains, mappings, implementations, and providers.
- [Schemas & contracts](/one/build/schemas-and-contracts.md): Own bounded data, operations, effects, compatibility, and language projections.
- [Services & topology](/one/build/services-and-topology.md): Compose components while keeping local and remote realizations honest.
- [State & data](/one/build/state-and-data.md): Separate semantic data from physical layouts, engines, and placement.
- [Workflows & effects](/one/build/workflows-and-effects.md): Model durable coordination, retries, compensation, and unknown outcomes.
- [Experience & frontends](/one/build/experience.md): Define product experience independently of renderer, framework, and delivery target.
- [Roots & planning](/one/compose/roots-and-planning.md): Compute exact per-root closure and select one inspectable physical plan.
- [Providers & adapters](/one/compose/providers-and-adapters.md): Select removable realizations and adapt foreign systems at narrow boundaries.
- [Interoperability](/one/compose/interoperability.md): Connect languages and systems through OCS, explicit mappings, ABIs, and protocols.
- [Authority & security](/one/govern/authority-and-security.md): Keep requirements, grants, tokens, enforcement, trust, and secrets distinct.
- [Testing & evidence](/one/govern/testing-and-evidence.md): Prove contracts with owned tests, conformance, replay, and bounded evidence.
- [Build & artifacts](/one/ship/build-and-artifacts.md): Materialize exact per-root artifacts with hermetic actions and provenance.
- [Deploy & apply](/one/ship/deploy-and-apply.md): Review immutable plans and reconcile them without replanning or widening authority.
- [Observe & operate](/one/ship/observe-and-operate.md): Correlate signals, causal facts, receipts, reconciliation, and forward rollback.
- [CLI model](/one/reference/cli.md): Use the small universal command vocabulary and contract-derived domain operations.
- [Architecture map](/one/reference/architecture.md): Find the canonical owner for every semantic and operational responsibility.
- [Glossary](/one/reference/glossary.md): Use One's key terms precisely.