mixle.maturity module

Machine-readable API maturity registry (worklist A1.2).

docs/maturity.rst describes, in prose, how mature each public surface is. This is the machine-readable mirror of that map: a single source of truth a tool (or the API manifest, worklist A1.6) can query to learn the maturity tier of any dotted module name. The three tiers match the deprecation policy in docs/support-policy.rst (worklist A1.5):

• STABLE – covered by the compatibility policy; changes follow the deprecation lifecycle.

• PROVISIONAL – usable and tested, but signatures/defaults may still change within a minor release.

• EXPERIMENTAL – no compatibility guarantee (only mixle.experimental).

maturity_of() resolves a dotted name by longest matching prefix. mixle.stats is provisional by default; only individually reviewed statistical modules are stable. mixle.inference.estimation overrides the provisional mixle.inference tier, while mixle.inference.production remains provisional. Surfaces not listed default to DEFAULT_MATURITY (PROVISIONAL) – the conservative choice: a surface makes no stability promise until it is explicitly recorded as stable.

class Maturity(*values)

Bases: StrEnum

API maturity tier. String-valued so it serializes as its name in JSON manifests.

maturity_of(name)

Return the Maturity tier of a dotted module name (longest-prefix match; default provisional).

Parameters:

name (str)

Return type:

Maturity

status_of(name)

Return the human status label for a dotted module name, mirroring docs/maturity.rst.

Parameters:

name (str)

Return type:

str