datex-studio-cli 0.1.0__py3-none-any.whl

datex_studio_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,172 @@
+Metadata-Version: 2.4
+Name: datex-studio-cli
+Version: 0.1.0
+Summary: CLI for Datex Studio low-code platform, designed for LLM-based AI agents
+Project-URL: Homepage, https://github.com/datex/datex-studio-cli
+Project-URL: Documentation, https://github.com/datex/datex-studio-cli
+Project-URL: Repository, https://github.com/datex/datex-studio-cli
+Author: Datex
+License-Expression: MIT
+Keywords: ai,cli,datex,llm,low-code
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: markdownify>=0.13.0
+Requires-Dist: msal>=1.28.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Datex Studio CLI (`dxs`)
+
+Command-line interface for Datex Studio low-code platform, designed for LLM-based AI agents.
+
+## Installation
+
+```bash
+# Using uv
+uv pip install datex-studio-cli
+
+# Using pip
+pip install datex-studio-cli
+```
+
+## Quick Start
+
+```bash
+# Authenticate with Azure Entra
+dxs auth login
+
+# View commit history
+dxs source log --repo 10
+
+# View configuration history
+dxs source history userGrid --branch 100
+
+# View current locks
+dxs source locks --repo 10
+```
+
+## Output Formats
+
+The CLI supports multiple output formats optimized for LLM consumption:
+
+```bash
+# YAML (default)
+dxs source log --repo 10
+
+# JSON
+dxs source log --repo 10 --output json
+
+# CSV
+dxs source log --repo 10 --output csv
+```
+
+## Configuration
+
+Configuration is stored in `~/.datex/config.yaml`. You can also use environment variables:
+
+```bash
+# Set via environment
+export DXS_API_BASE_URL=https://api.datex.io
+export DXS_DEFAULT_BRANCH=100
+export DXS_DEFAULT_REPO=10
+
+# Set via CLI
+dxs config set api_base_url https://api.datex.io
+dxs config set default_branch 100
+dxs config set default_repo 10
+
+# View configuration
+dxs config list
+```
+
+## Commands
+
+### Authentication
+
+- `dxs auth login` - Authenticate with Azure Entra
+- `dxs auth logout` - Clear stored credentials
+- `dxs auth status` - Show authentication status
+
+### Configuration
+
+- `dxs config get <key>` - Get a configuration value
+- `dxs config set <key> <value>` - Set a configuration value
+- `dxs config list` - List all configuration values
+
+### Source Control
+
+- `dxs source log` - Show commit history
+- `dxs source history <ref>` - Show configuration version history
+- `dxs source diff` - Show pending changes (draft vs last commit)
+- `dxs source changes` - Show pending changes in detail
+- `dxs source locks` - Show current lock status
+- `dxs source deps` - Show configuration dependencies
+- `dxs source compare` - Compare two branches
+
+### Exploration
+
+- `dxs source explore info` - Show application overview
+- `dxs source explore configs` - List all configurations
+- `dxs source explore config <ref>` - View a specific configuration
+- `dxs source explore summary <ref>` - Show structural summary
+- `dxs source explore trace <ref>` - Show configuration dependencies
+
+### Branch & Repository Management
+
+- `dxs source branch list` - List branches
+- `dxs source branch show <id>` - Show branch details
+- `dxs source repo list` - List repositories
+- `dxs source repo show <id>` - Show repository details
+
+### Integrations
+
+- `dxs devops workitem <id>` - Get Azure DevOps work item
+- `dxs crm case <id>` - Get Dynamics CRM case
+- `dxs organization list` - List organizations
+- `dxs marketplace list` - List marketplace applications
+- `dxs api <method> <url>` - Make raw API requests
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/datex/datex-studio-cli.git
+cd datex-studio-cli
+uv venv
+source .venv/bin/activate
+uv pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint and format
+ruff check .
+ruff format .
+
+# Type check
+mypy src/dxs
+```
+
+## License
+
+MIT

datex_studio_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,52 @@
+dxs/__init__.py,sha256=VLIgLaa6Kk-6jlKx1nyDVDpx1GUkNsSNCzqDjtFlns4,119
+dxs/__main__.py,sha256=sTUiT2X1UXIQgcHsEg5205ixvuL0HH1tgWDPUONm3cI,124
+dxs/cli.py,sha256=xyyNDp7GxMnz1XIT2YrxkzBtuAc6nuQmqt-f0_jAk4Y,11447
+dxs/commands/__init__.py,sha256=gQ6tnU0Rvm0-ESWFUBU-KDl5dpNOpUTG509hXOQQjwY,27
+dxs/commands/api.py,sha256=3Bd-V8ODYyLSsmWVquRaoaV_czcL04FYA3pHUoTdVsY,4252
+dxs/commands/auth.py,sha256=mXIhulkv0vjQtA6CCQPgEpXpSl529fN9deko9btmG2Q,15620
+dxs/commands/branch.py,sha256=J2At2sf2Ee7MKeSm8vpMeDqB3jAqFjXzp2Yh3HrjaWA,27626
+dxs/commands/config.py,sha256=5xKoqlfeh6Mi-wSnfwQcjY8XO82Dd1k9HG2qWHhjwP0,3083
+dxs/commands/crm.py,sha256=f6iWrGybECMiUWtvjyNXe-C3KI-s2e2wfrFXhja_2No,37383
+dxs/commands/devops.py,sha256=atBjDFIQEgodNxWugeGLk8x5qC2xxJFy-x4cFtOlano,6712
+dxs/commands/document.py,sha256=91aVlCxD8jx9TUl-mXUTdXMeU-QnjT35tPb7c6ve3NU,71692
+dxs/commands/explore.py,sha256=yVOrzefRQp9cfVC3blBiVefKQbADi6sjtOf9HO-4p7U,109455
+dxs/commands/marketplace.py,sha256=Tls6hHlwBpCNTl7G3AX58YY7I6L0aL9L1VChOAfHroc,5852
+dxs/commands/organization.py,sha256=CqY0b_yk2r5Nk-hjmPstp22QtEq1jUHVHAUs2wh0_Dk,3914
+dxs/commands/repo.py,sha256=TjcWyX4w8C28MvDv32XhNbSw9pNqySYAkcL-oBXM2r0,14550
+dxs/commands/source.py,sha256=7U2kO7VNzwDooJHRqZIIMq9AYe0C40QZNtSOaeiPPsI,101477
+dxs/core/__init__.py,sha256=h1U1ZDndn5rm37vqUOoykW3Simq7L_7JYwLJgXwjSTk,74
+dxs/core/cache.py,sha256=AKrTDfWLbdCS6XHc9RiClf7dcRLM_bxQZKK_Z3cQKLI,17966
+dxs/core/graph.py,sha256=E9DJgesWUKeWzQmJhnL-pr4YnpCTlXgIAZbDv07pI-I,16356
+dxs/core/responses.py,sha256=hUjPi4wj2QcnivGXNsdAc1h_ZhlvniafWJ7CUumWDK4,4379
+dxs/core/api/__init__.py,sha256=E76O7fwyVHOBETT2AsyPu8Zt62uVuhNSjMnrtiZuMZQ,1747
+dxs/core/api/client.py,sha256=1UCOGnWQ3AoebS1lWYZ943pvbx1ysR98qhHWbx87Qpg,10654
+dxs/core/api/endpoints.py,sha256=HNbdQ_bTEwg49cSUMI4JrLZEEBzAd-c5M32KIM0aODc,8224
+dxs/core/api/models.py,sha256=AVAr-JIX93qw9zHxSbOp35ao72BCEaPyn0uge9hS1zc,16793
+dxs/core/auth/__init__.py,sha256=K8lK4mtVkAPu2nTzzX1YprDbs57lNK5IYgX-JejxNFU,351
+dxs/core/auth/decorators.py,sha256=1aqqCL4W6Ri_lTfXK1wJbHhyzkzmipIoOd4PRMGV9ro,3309
+dxs/core/auth/msal_client.py,sha256=KZI2N1YtFFPQBxNl_gsFkNUow-UaiimKDxX-iT0MUOg,16909
+dxs/core/auth/token_cache.py,sha256=mJfM8R9Ffsqyv_q3uo3JpggAqRkV3-CDhQpFaFLOf6k,6792
+dxs/core/devops/__init__.py,sha256=h4mZoir7gOau3YEP1ktEQStxqur_uGvDMQeu-sGotR8,211
+dxs/core/devops/client.py,sha256=PKlV0PKgAAodCyOB3_-VPVkv4WHZQg5zOQ5k6l1r-ls,11817
+dxs/core/devops/models.py,sha256=plCXk04WFMOZJBUS1xzTc1jWUeSRFjdxOaNEsr_Mxw8,4343
+dxs/core/dynamics/__init__.py,sha256=IsVDv6hzJzFn-WMUKgNMHN5d6gKrc9Fu2JTCaws5sGQ,149
+dxs/core/dynamics/client.py,sha256=e9H7gbIsxONZ_o_3L6sevOqJ-j_9W3w5JJ14YI6xwaA,22764
+dxs/core/output/__init__.py,sha256=EYlkM_-fimMtsPdynkq9jwaZm9OXrk4VziwrEsUK5sE,205
+dxs/core/output/csv_fmt.py,sha256=ALfNJkhKfOQJDK0j3efJD6YFtxR9IhC-9p_5Uw_gxTw,3334
+dxs/core/output/formatter.py,sha256=dIuzvw1_X1ZibSNMkfsNZ0_v52T3hwZ-yoR8XjzvSek,4558
+dxs/core/output/json_fmt.py,sha256=ah3ZE8HMkjOAsj442XKeAjUYwSut7-a_MKiMDWCwzUM,959
+dxs/core/output/yaml_fmt.py,sha256=pLV9ez1Mr6cjFYe6CQYukXVC5iJ0w3932REik5g1IAw,2553
+dxs/models/__init__.py,sha256=Olg44Lfn1NJZ590xdEv7rZrS47PxSUnCXo9pOnSJm1s,41
+dxs/utils/__init__.py,sha256=wRNc4MzgJTitIJJuUOMwoQH4_EjQ_4y_5UwMWAidXxk,1065
+dxs/utils/click_options.py,sha256=XeYc4JPnrofNzZv3DLFL0t7MYHz3D1D8EziP5LgtCiM,4850
+dxs/utils/config.py,sha256=nbR2SA2YURPrE2DUe-EDOAVgeYQ0TWwAcQ0eFKpH8VI,6505
+dxs/utils/errors.py,sha256=4KS3BnzF3ZTFpbbNSwHeaCmj3pCKMtJw20vo4HDYH_o,3725
+dxs/utils/filtering.py,sha256=LNy0B-pyQBtYILk-77ojnCSVXtBgZ0R2-lZ4hOfYDw0,6348
+dxs/utils/paths.py,sha256=V5HqDQVF-rfE3OSMMPNVlvOEHJgfQwJ7lsUyuMK7CtE,992
+dxs/utils/resolvers.py,sha256=X2hUBVbf-us1jQtsdlZsXnfIqBWRoHMBGHIAduge_ik,7360
+dxs/utils/responses.py,sha256=jZXWfCfSYFsgqU5RwJ_2_9sKgsbrtTuQAJ9nhxgPrwM,3165
+dxs/utils/sorting.py,sha256=Oo2THyTy-Km3NpLJtNSCxnsYPi4nMADDLvJd3gRw6y4,3142
+datex_studio_cli-0.1.0.dist-info/METADATA,sha256=dnRaVpE-8r2zKSkVSEIqMCfcfHrS5LOcoLmwTCFVYwc,4545
+datex_studio_cli-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+datex_studio_cli-0.1.0.dist-info/entry_points.txt,sha256=uczHmv1ThDdaldnjFMPBCCBTqLgnWToIbW4RSX-gAFk,37
+datex_studio_cli-0.1.0.dist-info/RECORD,,

datex_studio_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

datex_studio_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dxs = dxs.cli:main

dxs/__init__.py

@@ -0,0 +1,4 @@
+"""Datex Studio CLI - Command-line interface for Datex Studio platform."""
+
+__version__ = "0.1.0"
+__app_name__ = "dxs"

dxs/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running dxs as a module: python -m dxs"""
+
+from dxs.cli import cli
+
+if __name__ == "__main__":
+    cli()

dxs/cli.py

@@ -0,0 +1,381 @@
+"""Main CLI entry point for Datex Studio CLI."""
+
+import sys
+from typing import Any
+
+import click
+
+from dxs import __app_name__, __version__
+from dxs.core.output import OutputFormat, format_error, format_output
+from dxs.utils.config import get_settings
+from dxs.utils.errors import DxsError
+
+# Fields to strip from author objects in concise mode
+_AUTHOR_VERBOSE_FIELDS = {"id", "organizationId", "externalId", "hasManagementAccess"}
+
+
+def _strip_concise(data: Any, parent_key: str | None = None) -> Any:
+    """Strip null values and verbose metadata from data for concise output.
+
+    Args:
+        data: Data to strip (dict, list, or other).
+        parent_key: The key of the parent that contains this data.
+
+    Returns:
+        Data with nulls and verbose fields removed.
+    """
+    if isinstance(data, dict):
+        result = {}
+        for key, value in data.items():
+            # Skip null values
+            if value is None:
+                continue
+            # Skip verbose author fields only within author objects
+            if parent_key == "author" and key in _AUTHOR_VERBOSE_FIELDS:
+                continue
+            # Recursively process nested structures, passing the key as context
+            result[key] = _strip_concise(value, parent_key=key)
+        return result
+    elif isinstance(data, list):
+        return [_strip_concise(item, parent_key=parent_key) for item in data]
+    else:
+        return data
+
+
+class DxsContext:
+    """Shared context passed to all commands."""
+
+    def __init__(self) -> None:
+        self.output_format: OutputFormat = OutputFormat.YAML
+        self.verbose: bool = False
+        self.quiet: bool = False
+        self.concise: bool = True  # Concise output is default
+        self.org: str | None = None
+        self.env: str | None = None
+        self.branch: int | None = None
+        self.repo: int | None = None
+        self.save_path: str | None = None
+        self.force_overwrite: bool = False
+        self.explicit_output_format: bool = False
+
+    def output(self, data: Any, include_metadata: bool = True) -> None:
+        """Output data in the configured format.
+
+        Args:
+            data: Data to output.
+            include_metadata: Include timestamp and version metadata.
+        """
+        from dxs.core.output.formatter import detect_format_from_extension
+
+        # Determine format: --output flag > file extension > default
+        if self.save_path and not self.explicit_output_format:
+            output_format = detect_format_from_extension(self.save_path, self.output_format)
+        else:
+            output_format = self.output_format
+
+        formatted = format_output(data, output_format, include_metadata, self.concise)
+
+        # Save to file if requested (suppresses stdout)
+        if self.save_path:
+            self._save_to_file(formatted)
+            return
+
+        click.echo(formatted)
+
+    def _save_to_file(self, content: str) -> None:
+        """Save content to file with overwrite protection.
+
+        Args:
+            content: Formatted content to save.
+
+        Raises:
+            ValidationError: If file exists and force_overwrite is False.
+            DxsError: If file write fails.
+        """
+        from pathlib import Path
+
+        from dxs.utils.errors import ValidationError
+
+        path = Path(self.save_path)
+
+        if path.exists() and not self.force_overwrite:
+            raise ValidationError(
+                message=f"File '{self.save_path}' already exists",
+                code="DXS-FILE-001",
+                suggestions=[
+                    "Use --force flag to overwrite the file",
+                    "Specify a different filename with --save",
+                ],
+            )
+
+        path.parent.mkdir(parents=True, exist_ok=True)
+
+        try:
+            path.write_text(content, encoding="utf-8")
+            self.debug(f"Output saved to: {self.save_path}")
+        except OSError as e:
+            raise DxsError(
+                code="DXS-FILE-002",
+                message=f"Failed to write file '{self.save_path}': {e}",
+            ) from e
+
+    def output_error(self, error: DxsError | Exception) -> None:
+        """Output an error in the configured format.
+
+        Args:
+            error: Error to output.
+        """
+        formatted = format_error(error, self.output_format)
+        click.echo(formatted, err=True)
+
+    def log(self, message: str) -> None:
+        """Log a message (respects quiet flag).
+
+        Args:
+            message: Message to log.
+        """
+        if not self.quiet:
+            click.echo(message, err=True)
+
+    def debug(self, message: str) -> None:
+        """Log a debug message (only in verbose mode).
+
+        Args:
+            message: Debug message to log.
+        """
+        if self.verbose:
+            click.echo(f"[DEBUG] {message}", err=True)
+
+
+# Create a pass decorator for the context
+pass_context = click.make_pass_decorator(DxsContext, ensure=True)
+
+
+# Global options shared across all commands
+CONTEXT_SETTINGS = {
+    "help_option_names": ["-h", "--help"],
+    "max_content_width": 120,
+}
+
+
+class DxsGroup(click.Group):
+    """Custom Group that shows global options in subcommand help."""
+
+    def format_options(self, ctx: click.Context, formatter: click.HelpFormatter) -> None:
+        """Write options to the formatter, including global options."""
+        # First write local options
+        super().format_options(ctx, formatter)
+
+        # Then add global options section if we have a parent
+        if ctx.parent is not None:
+            # Get global options from the root command
+            root_ctx = ctx
+            while root_ctx.parent is not None:
+                root_ctx = root_ctx.parent
+
+            if root_ctx.command and hasattr(root_ctx.command, "params"):
+                global_opts = []
+                for param in root_ctx.command.params:
+                    if isinstance(param, click.Option):
+                        record = param.get_help_record(ctx)
+                        if record:
+                            global_opts.append(record)
+
+                if global_opts:
+                    with formatter.section("Global Options"):
+                        formatter.write_dl(global_opts)
+
+
+@click.group(cls=DxsGroup, context_settings=CONTEXT_SETTINGS)
+@click.version_option(version=__version__, prog_name=__app_name__)
+@click.option(
+    "-o",
+    "--org",
+    type=str,
+    envvar="DXS_ORG",
+    help="Organization ID (overrides default)",
+)
+@click.option(
+    "-e",
+    "--env",
+    type=str,
+    envvar="DXS_ENV",
+    help="Environment ID (overrides default)",
+)
+@click.option(
+    "-b",
+    "--branch",
+    type=int,
+    envvar="DXS_BRANCH",
+    help="Branch ID (overrides default)",
+)
+@click.option(
+    "-r",
+    "--repo",
+    type=int,
+    envvar="DXS_REPO",
+    help="Repository ID (overrides default)",
+)
+@click.option(
+    "-O",
+    "--output",
+    "output_format",
+    type=click.Choice(["yaml", "json", "csv"], case_sensitive=False),
+    default=None,
+    help="Output format (default: yaml)",
+)
+@click.option(
+    "-v",
+    "--verbose",
+    is_flag=True,
+    default=False,
+    help="Enable verbose output (show progress messages)",
+)
+@click.option(
+    "-f",
+    "--full",
+    is_flag=True,
+    default=False,
+    help="Show full output including null values and verbose metadata",
+)
+@click.option(
+    "-s",
+    "--save",
+    "save_path",
+    type=click.Path(dir_okay=False, writable=True, path_type=str),
+    default=None,
+    help="Save output to file (format auto-detected from extension)",
+)
+@click.option(
+    "--force",
+    "force_overwrite",
+    is_flag=True,
+    default=False,
+    help="Force overwrite existing file when using --save",
+)
+@click.pass_context
+def cli(
+    ctx: click.Context,
+    org: str | None,
+    env: str | None,
+    branch: int | None,
+    repo: int | None,
+    output_format: str | None,
+    verbose: bool,
+    full: bool,
+    save_path: str | None,
+    force_overwrite: bool,
+) -> None:
+    """Datex Studio CLI - Command-line interface for Datex Studio platform.
+
+    Designed for LLM-based AI agents. Use --output yaml (default) or --output json
+    for structured, parseable responses.
+
+    \b
+    Examples:
+        dxs auth login
+        dxs source log --repo 10
+        dxs source history userGrid --branch 100
+        dxs config list
+
+    \b
+    Environment Variables:
+        DXS_ORG         Default organization ID
+        DXS_ENV         Default environment ID
+        DXS_BRANCH      Default branch ID
+        DXS_REPO        Default repository ID
+
+    \b
+    Configuration:
+        Settings are stored in ~/.datex/config.yaml
+        Credentials are stored in ~/.datex/credentials.yaml
+    """
+    # Initialize context
+    ctx.ensure_object(DxsContext)
+    dxs_ctx: DxsContext = ctx.obj
+
+    # Load settings
+    settings = get_settings()
+
+    # Set output format (CLI flag > env var > config > default)
+    if output_format:
+        dxs_ctx.output_format = OutputFormat(output_format.lower())
+        dxs_ctx.explicit_output_format = True
+    elif settings.default_output_format:
+        dxs_ctx.output_format = OutputFormat(settings.default_output_format.lower())
+
+    # Set verbosity (quiet by default for LLM agents, --verbose enables log output)
+    dxs_ctx.verbose = verbose
+    dxs_ctx.quiet = not verbose
+    # Concise output is default; --full disables it
+    dxs_ctx.concise = not full
+
+    # Set save options
+    dxs_ctx.save_path = save_path
+    dxs_ctx.force_overwrite = force_overwrite
+
+    # Set context values (CLI flag > env var > config)
+    dxs_ctx.org = org or settings.default_org
+    dxs_ctx.env = env or settings.default_env
+    dxs_ctx.branch = branch or settings.default_branch
+    dxs_ctx.repo = repo or settings.default_repo
+
+
+# Error handler decorator
+def handle_errors(f):
+    """Decorator to handle errors and output them in the configured format."""
+
+    @click.pass_context
+    def wrapper(ctx: click.Context, *args, **kwargs):
+        dxs_ctx: DxsContext = ctx.obj
+        try:
+            return ctx.invoke(f, *args, **kwargs)
+        except DxsError as e:
+            dxs_ctx.output_error(e)
+            sys.exit(1)
+        except click.ClickException:
+            # Let Click handle its own exceptions
+            raise
+        except Exception as e:
+            dxs_ctx.output_error(e)
+            sys.exit(1)
+
+    return wrapper
+
+
+# Import and register command groups
+# These imports are here to avoid circular imports
+def register_commands() -> None:
+    """Register all command groups with the CLI."""
+    from dxs.commands import api, auth, config, crm, devops, marketplace, organization, source
+
+    cli.add_command(api.api)
+    cli.add_command(auth.auth)
+    cli.add_command(config.config)
+    cli.add_command(crm.crm)
+    cli.add_command(devops.devops)
+    cli.add_command(marketplace.marketplace)
+    cli.add_command(organization.organization)
+    cli.add_command(source.source)
+    # branch and repo are registered as subcommands of source in source.py
+
+
+# Register commands when module loads
+register_commands()
+
+
+# Main entry point
+def main() -> None:
+    """Main entry point for the CLI."""
+    try:
+        cli()
+    except DxsError as e:
+        # Get the output format from context or default to YAML
+        output_format = OutputFormat.YAML
+        formatted = format_error(e, output_format)
+        click.echo(formatted, err=True)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

dxs/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""