← Catalogue
World Models · legacy example

Situation & Condition

This meta-model describes states of affairs that hold over time: a road is closed, a building is condemned, a supply is suspended, a district is under alert. It is the complement of the occurrence model: X1 records the instants at which the world changes, while this model records what holds between those instants, bound to a subject, valued with a status and bounded by a validity interval.

AI YAMLAGENTS.mdSource
IDworld.x4-situation-and-condition
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainevents-phenomena
Tagssituation, condition
Data structure

Bundles and layers

Bundle

state

What holds and how it is valued

Layers

situationCore`: the named state of affairs and its kind · `status`: terms drawn from governed status schemes

Bundle

temporality

When the state holds and how states succeed one another

Layers

interval`: the validity span, possibly open-ended · `succession`: transitions from one status to the next

Bundle

attachment

What the state is about and how far it reaches

Layers

subjectBinding`: the link to the catalogue entity the state holds for · `scope`: the spatial or organizational reach of the state

Findings

Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.

Questions & artifacts

Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.

Service layers

How this specification operates

Dimension & namespace

  • REFERENCE `world.occurrenceEvent` (X1): occurrences are the triggers that open, advance and close situations
  • REFERENCE `world.buildingStructure` (U1): typical built subjects such as condemned or protected structures
  • REFERENCE `world.physicalInfrastructureNetwork` (U3): closures and restrictions on network assets held as situations
  • REFERENCE `world.observedPhenomenon` (X2): persistent phenomena mirrored as situations over an extent
  • REFERENCE `world.person` (H1): personal states such as residency held for a person subject
  • REFERENCE `world.organization` (O1): organizational states such as active or dissolved
  • imports: owl-time (COMPOSE: interval value types for validity spans)
  • imports: iso-8601 (ALIGN: interval and timestamp notation)

Canon, patches & standards

  • REFERENCE `world.occurrenceEvent` (X1): occurrences are the triggers that open, advance and close situations
  • REFERENCE `world.buildingStructure` (U1): typical built subjects such as condemned or protected structures
  • REFERENCE `world.physicalInfrastructureNetwork` (U3): closures and restrictions on network assets held as situations
  • REFERENCE `world.observedPhenomenon` (X2): persistent phenomena mirrored as situations over an extent
  • REFERENCE `world.person` (H1): personal states such as residency held for a person subject
  • REFERENCE `world.organization` (O1): organizational states such as active or dissolved
  • imports: owl-time (COMPOSE: interval value types for validity spans)
  • imports: iso-8601 (ALIGN: interval and timestamp notation)

Artifact formats & serial data

Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.

Policies & accepted processes

  • `statusAttestationContract`: the subject's owner attests the current status to a named relying party
  • `monitoringSubscription`: a consumer is notified on transitions of situations it is entitled to see
  • `historyAccessGrant`: owner-granted access to the full transition history of a situation

Read / add / edit / delete

CRUD procedures and interface bindings are not declared in this legacy version.

Ownership, roles & access

The owner archetype is the subject's owner: whoever holds the S1 ownership of the bound entity stewards situations about it. Attestations, monitoring and history access are all granted by that owner through S2, and every transition is auditable via S4.

Existing assembly

Objects, relationships, events and projections

Objects

  • `situation`: a named state of affairs holding for a subject over an interval; key attributes: situationKind, openedAt, closedAt, currentStatus
  • `subjectBinding`: the link from the situation to the catalogue entity it holds for; key attributes: subjectRef, subjectModel, bindingBasis
  • `statusValue`: a term from a governed status scheme; key attributes: scheme, term, ordering
  • `validityInterval`: the time span over which the situation holds; key attributes: begin, end, openEnded
  • `stateTransition`: the change from one status to the next; key attributes: occurredAt, fromStatus, toStatus, triggerRef
  • `situationScope`: the spatial or organizational reach of the situation; key attributes: scopeKind, scopeRef

Relationships

  • `situation` -> boundTo -> `subjectBinding` (1:1): every situation holds for exactly one bound subject
  • `situation` -> valuedAs -> `statusValue` (n:1): the current status is a term from a declared scheme
  • `situation` -> holdsDuring -> `validityInterval` (1:1): the span of validity, open-ended while the state persists
  • `stateTransition` -> advances -> `situation` (n:1): the ordered history of status changes
  • `stateTransition` -> triggeredBy -> `occurrence` (n:1): X1 occurrences open, advance and close situations
  • `situation` -> scopedBy -> `situationScope` (n:1): where or over whom the state applies

Events

  • `situationOpened`: a state of affairs began to hold for a subject
  • `statusChanged`: the situation moved to a different status term
  • `intervalRevised`: the validity span was corrected on better information
  • `situationClosed`: the state ceased to hold and the interval was sealed
  • `situationBackdated`: a state was recorded retroactively with an earlier begin

Projections

  • `currentStateProjection`: the latest status per subject only; omits history and triggering evidence
  • `stateHistoryProjection`: the full ledger of transitions with triggers; omits unrelated subjects entirely
  • `statusBadgeProjection`: a single flag or grade for display; omits everything else