cadrumo.core.corpus_manifest.errors module

Typed error hierarchy for corpus-manifest validation.

Defines the leaf exceptions raised by the corpus-manifest loader and verifier. All inherit from core.errors.hierarchy.CadrumoError so any caller catching the framework’s base error type also catches manifest failures.

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

Bases: CadrumoError

Base error for any failure in corpus-manifest parsing or validation.

Concrete failure modes derive from this class; callers can catch CorpusManifestError to handle every manifest failure uniformly, or catch a leaf such as CorpusManifestTamperError to react to a specific condition.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

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

Bases: CorpusManifestError

Raised when a manifest’s self-attesting digest does not match its body.

Indicates the manifest body has been edited without recomputing the embedded checksum — usually a sign of corruption or tampering rather than legitimate drift between the manifest and the on-disk corpus.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

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

Bases: CorpusManifestError

Base error for corpus bundle build/verify failures.

Raised for structural bundle problems (not a zip archive, missing or structurally invalid embedded manifest, unsupported manifest version).

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

code