mixle.experimental.graduation moduleΒΆ

Verified graduation records for mechanisms living in mixle.experimental.

A mechanism can graduate only when a digest-verified, matched-compute baseline comparison beats the baseline and a digest-verified misfit measurement stays within its declared threshold. Empty mappings and unverified observations are not evidence.

class BaselineComparisonReceipt(mechanism_name, metric, mechanism_value, baseline_value, matched_flops, lower_is_better, observed_at, producer, artifact_ref, digest, schema_version='mixle.graduation.baseline/v1')[source]

Bases: object

Matched-compute comparison against the declared graduation baseline.

Parameters:

  • mechanism_name (str)

  • metric (str)

  • mechanism_value (float)

  • baseline_value (float)

  • matched_flops (float)

  • lower_is_better (bool)

  • observed_at (str)

  • producer (str)

  • artifact_ref (str)

  • digest (str)

  • schema_version (str)

verify()[source]

Independently verify receipt integrity.

Return type:

bool

class MisfitReceipt(mechanism_name, metric, value, threshold, observed_at, producer, artifact_ref, digest, schema_version='mixle.graduation.misfit/v1')[source]

Bases: object

Measured mechanism error and its graduation threshold.

Parameters:
verify()[source]

Independently verify receipt integrity.

Return type:

bool

class ExperimentalMechanism(name, graduated=False, baseline_receipt=None, misfit_receipt=None)[source]

Bases: object

One entry in the experimental-mechanism graduation ledger.

Parameters:

  • name (str)

  • graduated (bool)

  • baseline_receipt (BaselineComparisonReceipt | None)

  • misfit_receipt (MisfitReceipt | None)

is_eligible()[source]

Whether verified receipts prove both graduation gates.

Return type:

bool

exception DuplicateMechanismError[source]

Bases: ValueError

A different mechanism attempted to replace an existing registry identity.

REGISTRY = _GraduationRegistry(_mechanisms={})

The process-wide graduation ledger. Track-E items register their ExperimentalMechanism here.