cadrumo.domain.transactions.errors module

Canonical domain exceptions for cadrumo.domain.transactions.

exception TransactionError(message=None, *, context=None, translated_message=None)[source]

Bases: CadrumoError

Base error for every transaction-catalogue failure.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception TransactionCatalogueError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised when a transaction catalogue is invalid or inconsistent.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception TransactionPersistenceError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionCatalogueError

Raised when catalogue persistence cannot be completed.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception StoredTransactionDriftError(bucket_id, error)[source]

Bases: TransactionPersistenceError

Raised when a persisted transaction catalogue fails schema validation on load.

Mirrors StoredProfileDriftError: the catalogue was valid when written; schema evolution or an out-of-band edit caused the on-disk envelope payload to drift from the current TransactionCatalogue schema. The original pydantic.ValidationError is preserved on original_exception so callers can inspect the typed field errors without losing the deserialization detail.

Variables:

  • bucket_id – Identifier of the bucket whose catalogue drifted.

  • original_exception – The underlying pydantic.ValidationError.

Parameters:

  • bucket_id (str)

  • error (ValidationError)

Return type:

None

code
exception LedgerStorageError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionPersistenceError

Raised when bucket-scoped ledger storage cannot be resolved or used.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception LedgerNoActiveBucketError(message=None, *, context=None, translated_message=None)[source]

Bases: LedgerStorageError

Raised when a ledger operation requires an active profile bucket.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception TransactionNotFoundError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionCatalogueError

Raised when a catalogue lookup targets a missing transaction.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception TransactionIdPrefixError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionCatalogueError

Raised when a transaction-id prefix matches zero or multiple transactions.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception LLMClassifierError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised when an LLM classification attempt fails.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception TransactionValidationError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised on invalid transaction field values.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception LedgerLinkError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised when linking a ledger transaction to a modelo binding fails.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception LedgerCheckError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised when a ledger consistency check surfaces a blocking finding.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception LedgerPreflightError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised when ledger preflight rejects a modelo run as un-fileable.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code
exception ClassificationRuleError(message=None, *, context=None, translated_message=None)[source]

Bases: TransactionError

Raised when a ledger classification rule is invalid.

Pydantic field validators translate this registered failure to ValueError at their narrow protocol boundary.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • translated_message (str | None)

Return type:

None

code