Skip to main content
Glossary | ESSOne line for each term the ESS documentation uses, with the page that defines it.ESSreferenceessreferenceadopterdevelopertry-spec-driven-developmentreference

Glossary

Each term has one line here and a link to the page that defines it. The linked page is the authority; this list only helps you find it.

TermMeaningDefined in
ActorWho may invoke which commands.The model
Aggregate viewA view with group_by: that reports counts, sums and extremes over one entity's rows.Aggregate views
Ambient preconditionA command every command of the system runs inside, such as an open session.Ambient preconditions
Authored scenarioA conformance scenario a person wrote as an ess-scenario/* document, joined to a suite only when --scenarios names it.Author scenarios
BindingAn event-to-command reaction across contexts, including what happens when it fails.Bindings
CommandThe only way state changes; it declares its input and its outcomes.The model
Compiled model (IR)The normalized intermediate representation every name resolves in; compiling the same source twice gives the same bytes.The pipeline
ComponentA unit of ownership over domains, which can become a module or a process without changing what it owns.Logical, interface and delivery owners
Concurrent historyA recorded run of several clients, with each call's invoke and return instants, checked against the model.Check a concurrent history
ConsistencyA view's declaration of whether a generated assertion reads it immediately or eventually.View consistency
ConversionA declared reason for a binding to carry a value from one context's type into another's.Conversions
Declared coverageAn opt-in suite form that retains its declared scope, the selected scenarios and every refusal, so a report can qualify what it covers.Declared coverage
Deliverable descriptorAn ess-component/1 document naming a deliverable's source paths and release units.Component delivery
DigestA hash identifying only the bytes its producer defines; several digest kinds exist.Which digest is this?
DispositionWhat synthesis does with one capability: generate it, name it as an obligation, or refuse it with a reason.The synthesis plan
Display nameThe human-readable name generated documentation and a UI show.Names
DomainOne bounded context: its types, entities, commands, events, errors and views.Layout
EntityIdentity-bearing state with a lifecycle, invariants and declared relations.The model
EntrypointOne physical way into an implementation, an argv or an HTTP(S) URL, recorded in a realization.Record a realization
ErrorA declared domain refusal.The model
EventA fact a command's outcome emits.The model
ExplorerSeeded random command sequences run against your target and checked after every step.Explore
Format versionThe number in format: that moves when meaning, identity or the persisted shape changes.Format version history
GuardA predicate on an outcome that decides when that branch is taken.Guards and outcome selection
ImpactWhat a semantic delta invalidates: constructs, generated artifacts or suite scenarios.Find the work owed again
Interpreted targetThe built-in target that runs a suite against the specification itself.Run a supported target
InvariantA rule on a type or entity that travels into every projection.Invariants
LocatorThe name anything outside the specification uses to point at a construct.Names
MutantA copy of the specification with one rule changed, used to test whether a suite notices.Mutation audit
Normalization recipeAn ess-normalization/* document naming the ordered stages that turn external input into model values.Explicit normalization
ObligationA capability the specification does not fully determine, implemented by hand in a realization.Realizations
OutcomeOne declared result of a command, including each refusal branch.Declared outcomes
PredicateA condition over facts, written as a compact string or a structured mapping.Predicates
ProjectionA generated artifact derived from the compiled model: documentation, site, JSON Schema, OpenAPI or AsyncAPI.Projections
Qualified nameThe dotted name only the specification itself uses, such as billing.invoice.CreateInvoice.Names
ReachWhere a component's callers are: in_process, network or command_line.Reach, entrypoints and identity
RealizationA document naming the immutable artifacts that implement an exact specification and how they are entered.Record a realization
ReportThe standalone record of what a run's scenarios observed against a named target and specification digest.What the report proves
ScenarioOne semantic check in a suite: steps against a target and the result they require.The conformance suite
Semantic deltaWhat moved in meaning between two revisions of a specification.Compare revisions
SuiteThe deterministic set of scenarios a specification requires of an implementation.Synthesize a suite
SurvivorA mutant no scenario notices: a declared rule the suite does not pin down.Mutation audit
Synthesis planThe language-neutral plan that gives every capability of a specification one disposition.The synthesis plan
SystemThe root of a specification: its name, version and domains.The model
TargetThe implementation a suite runs against, built in or your own.Runners and reports
TopologyEach component's runtime requirements: replica bounds, statefulness and required resources.The model
Value expressionA payload: or sets: value taken from more than the input or a literal.Value expressions
ViewA read model: what it shows, filtered by what.The model
Wire nameThe name HTTP paths, topics and generated JSON use.Names