sequince.steps.mutation.adaptive.policies.base
==============================================

.. py:module:: sequince.steps.mutation.adaptive.policies.base

.. autoapi-nested-parse::

   Policies for choosing mutation budgets from completed metrics.



Classes
-------

.. autoapisummary::

   sequince.steps.mutation.adaptive.policies.base.MutationStepPolicy
   sequince.steps.mutation.adaptive.policies.base.FunctionalMutationStepPolicy


Module Contents
---------------

.. py:class:: MutationStepPolicy

   Bases: :py:obj:`Protocol`


   Choose mutation budgets at completed-block boundaries.


   .. py:method:: initialise(*, initial_steps, context)

      Choose the budget for the first adaptive iteration.



   .. py:method:: update(*, current_steps, metrics, context)

      Choose the proposed budget for the next outer iteration.



.. py:class:: FunctionalMutationStepPolicy

   Bases: :py:obj:`MutationStepPolicy`, :py:obj:`Protocol`


   Pure, traceable extension of the eager budget policy.

   Return scalar integer arrays matching the input budget's dtype and device.
   Do not mutate the policy or inputs, convert arrays to host values, or
   change carry structure. Methods return decisions only; validate static
   configuration on the host.


   .. py:method:: validate_functional_configuration()

      Reject static settings unsupported by functional decisions.



   .. py:method:: initialise_functional(*, initial_steps, context)

      Choose the first budget without modifying any inputs.



   .. py:method:: update_functional(*, current_steps, metrics, context)

      Choose a pending budget from completed-block metrics.



