mud_server.axis.migration_file_loader
=====================================

.. py:module:: mud_server.axis.migration_file_loader

.. autoapi-nested-parse::

   Migration file-backed resolution grammar loader.

   This module is intentionally outside the canonical runtime contract.

   Use cases:
   1. Migration/testing workflows that still validate YAML grammar fixtures.
   2. Transitional tooling that reads ``policies/axis/resolution.yaml`` from disk.

   Non-goals:
   1. Runtime policy resolution for world startup. Canonical runtime reads
      activated DB policy payloads and parses them via
      ``mud_server.axis.grammar.parse_resolution_grammar_payload``.



Functions
---------

.. autoapisummary::

   mud_server.axis.migration_file_loader.load_resolution_grammar


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

.. py:function:: load_resolution_grammar(world_root)

   Load and validate a migration file-backed resolution grammar payload.

   :param world_root: World package root. The loader expects the grammar file at
                      ``<world_root>/policies/axis/resolution.yaml``.

   :returns: Parsed immutable ``ResolutionGrammar``.

   :raises FileNotFoundError: If the expected file path does not exist.
   :raises ValueError: If YAML content is invalid for the grammar schema.