generation
==========

.. py:module:: generation

.. autoapi-nested-parse::

   Generation-domain helpers for the webapp API.

   This module owns class/syllable mapping rules, package option discovery,
   selection statistics, and deterministic sampling behavior used by
   ``/api/generate`` and related generation endpoints.



Functions
---------

.. autoapisummary::

   generation.get_cached_generation_package_options
   generation.clear_generation_package_options_cache


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

.. py:function:: get_cached_generation_package_options(conn, *, db_path)

   Return cached generation package options for one database path.

   :param conn: Open SQLite connection to the target database.
   :param db_path: Filesystem path of the SQLite database.

   :returns: Cached or freshly computed package option payload.


.. py:function:: clear_generation_package_options_cache(db_path = None)

   Clear cached generation package options for one DB or all DBs.

   :param db_path: Optional database path. When omitted, clears all cache entries.