Internal
========

.. admonition:: Audience
   :class: warning

   This section is intended for **power users and extenders**. Symbols
   here are not part of the supported public surface and may change
   without notice. Two subtrees are excluded entirely:

   - ``pytyche.research.*`` — alternative implementations kept for
     diagnostic / comparison value (already excluded from pyright).
   - ``pytyche.bcf.cpu_gfr`` — StochTree CPU backend used for cross-
     validation and bench work only; not a user runtime or extender
     hook.

   For the curated user-facing surface, see :doc:`public`.

.. Exclusion mechanism: we list packages and modules explicitly here
   rather than using a single ``pytyche.*`` recursive root, because
   ``autosummary :recursive:`` has no native exclude flag. The two
   excluded subtrees (``pytyche.research`` and ``pytyche.bcf.cpu_gfr``)
   are omitted by virtue of not being listed; everything else is rooted
   at its top-level package or, for ``pytyche.bcf``, expanded one level
   to drop ``cpu_gfr``.

Top-level package
-----------------

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.contracts
   pytyche.metrics
   pytyche.summarize
   pytyche.validation
   pytyche.visual_confidence

BCF subpackage
--------------

Submodules of ``pytyche.bcf`` listed explicitly so we can omit
``pytyche.bcf.cpu_gfr`` (the parent package's stub would otherwise pull
it in via package walk). The ``pytyche.bcf.hurdle`` and
``pytyche.bcf.diagnostics`` subpackages are listed recursively.

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.bcf.binary
   pytyche.bcf.config
   pytyche.bcf.continuous
   pytyche.bcf.diagnostics
   pytyche.bcf.gfr
   pytyche.bcf.kernels
   pytyche.bcf.lml
   pytyche.bcf.preprocess
   pytyche.bcf.hurdle

Calibration
-----------

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.calibrate

Generators
----------

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.generators

Diagnostics
-----------

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.diagnostics

Comparison
----------

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.compare

Experiments
-----------

.. autosummary::
   :toctree: _autosummary
   :recursive:

   pytyche.experiments