ml_switcheroo.cli.wizard
========================

.. py:module:: ml_switcheroo.cli.wizard

.. autoapi-nested-parse::

   Interactive Wizard for Semantic Mapping Discovery.
   Updated to support Distributed Semantics (Split Specs/Mappings).

   This module provides the `MappingWizard` class, an interactive CLI tool used
   by developers to categorize unmapped APIs found in a source framework.
   It guides the user through:

   1.  Identifying unknown APIs.
   2.  Assigning them to a Semantic Tier (Math, Neural, Extras).
   3.  Normalizing arguments (e.g. renaming `dim` to `axis`).
   4.  Defining the target mapping (Hub/Spoke split).
   5.  Persisting changes to the JSON knowledge base.



Classes
-------

.. autoapisummary::

   ml_switcheroo.cli.wizard.MappingWizard


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

.. py:class:: MappingWizard(semantics: ml_switcheroo.semantics.manager.SemanticsManager)

   Interactive tool to build robust semantic mappings.


   .. py:attribute:: semantics


   .. py:attribute:: console


   .. py:method:: start(package_name: str) -> None

      Starts the interactive session.

      Scans the target package for APIs not currently present in the
      semantics manager, then iterates through them prompting the user
      for categorization and mapping.

      :param package_name: The python package to inspect (e.g., 'torch').
      :type package_name: str