cadrumo.application.operations.persistence.events module¶

Ordered, presentation-free event contracts for supervised operations.

class OperationPhaseEvent(**data)[source]¶

Bases: _OperationEventBase

Record an operation phase transition at one durable event sequence.

Parameters:: data (Any)

kind: Literal[OperationEventKind.PHASE]¶

phase_code: OperationEventCode¶

class OperationProgressEvent(**data)[source]¶

Bases: _OperationEventBase

Record bounded progress for one operation revision.

Parameters:: data (Any)

kind: Literal[OperationEventKind.PROGRESS]¶

completed: NonNegativeInt¶

total: Annotated[int, Field(gt=0)]¶

unit_code: OperationEventCode | None¶

class OperationLogRecord(**data)[source]¶

Bases: _OperationEventBase

Structured log event carrying no prose or exception payload.

Parameters:: data (Any)

kind: Literal[OperationEventKind.LOG]¶

severity: OperationLogSeverity¶

diagnostic_ref: OperationDiagnosticReference | None¶

class OperationEffectEvent(**data)[source]¶

Bases: _OperationEventBase

Record the externally visible effect reached by an operation.

Parameters:: data (Any)

kind: Literal[OperationEventKind.EFFECT]¶

effect: OperationEffect¶

class OperationNoticeEvent(**data)[source]¶

Bases: _OperationEventBase

Stable notice identity; localized message text is a projection.

Parameters:: data (Any)

kind: Literal[OperationEventKind.NOTICE]¶

notice_code: OperationEventCode¶

class OperationReconciliationEvent(**data)[source]¶

Bases: _OperationEventBase

One credential-free durable classification of startup reconciliation.

Parameters:: data (Any)

kind: Literal[OperationEventKind.RECONCILIATION]¶

outcome: OperationReconciliationOutcome¶

lease_evidence_ref: ContentDigest¶

class OperationDiagnosticEvent(**data)[source]¶

Bases: _OperationEventBase

Reference existing redacted diagnostics without duplicating capture.

Parameters:: data (Any)

kind: Literal[OperationEventKind.DIAGNOSTIC]¶

diagnostic_ref: OperationDiagnosticReference¶

class OperationInteractionEvent(**data)[source]¶

Bases: _OperationEventBase

Safe lifecycle fact that identifies a pending or consumed interaction.

Parameters:: data (Any)

kind: Literal[OperationEventKind.INTERACTION]¶

interaction_id: Hex64Str¶

class OperationTerminalEvent(**data)[source]¶

Bases: _OperationEventBase

Record the terminal receipt that settles an operation.

Parameters:: data (Any)

kind: Literal[OperationEventKind.TERMINAL]¶

receipt: OperationTerminalReceipt¶