Core Modules
============

Top-level modules that provide the CLI framework: entry point, dependency
injection, output handling, exception hierarchy, and logging configuration.

Entry Point
-----------

The CLI entry point with centralized exception handling.

.. automodule:: kelvin.sdk.main
    :members:
    :undoc-members:
    :show-inheritance:

CLI Group
---------

The root Click group definition and global options.

.. automodule:: kelvin.sdk.cli_group
    :members:
    :undoc-members:
    :show-inheritance:

Services Container
------------------

Dependency injection container with lazy service initialization.
The container also exposes the :class:`~kelvin.sdk.output.Output` service
for controlling CLI output behavior (JSON vs interactive mode, progress
indicators, user confirmations).

.. automodule:: kelvin.sdk.container
    :members:
    :show-inheritance:

.. autoclass:: kelvin.sdk.output.Output
    :members:
    :show-inheritance:
    :no-index:

Exceptions
----------

Shared exception hierarchy for the CLI.

.. automodule:: kelvin.sdk.exceptions
    :members:
    :undoc-members:
    :show-inheritance:

Logging
-------

Structured logging configuration using structlog and stdlib logging.

.. automodule:: kelvin.sdk.logging
    :members:
    :undoc-members:
    :show-inheritance: