Five Pillars

SENSE, DECIDE, EXECUTE, GOVERN, IMPROVE — the operating model for Commerce Chain.

SENSE

Detect demand and supply events with typed contracts. OSS primitives include LoopDefinition, domain event IDs, and demand-signal loops (dcm.demand-signal).

id: dcm.demand-signal
states: [OPEN, SIGNAL_RECEIVED, EVALUATED, TRIGGERED, CLOSED]

DECIDE

Decision loops model recommendation boundaries and actor roles (human, automation, ai-agent, system). Use loop transition evidence to keep recommendation rationale inspectable.

EXECUTE

Execution loops in SCM/DCM drive concrete actions (reserve stock, ship line, credit return). Adapter contracts in @commerce-chain/adapters map those transitions to ERP/WMS/TMS actions.

id: close_fulfillment
from: SHIPPED
to: CLOSED
triggeredBy: dcm.orders.order_line_shipped.v1

GOVERN

Runtime and module guards enforce policy. Built-in runtime guard exports include confidence-threshold, human-only, and evidence-required.

guards:
  - id: approval_obtained
  - id: actor_has_permission

IMPROVE

Closed loops emit learning signals with predicted, actual, and delta fields. LearningSignal includes loopId, aggregateId, outcomeId, and metric identifiers for feedback analytics.