sima-cli 2.1.5__tar.gz → 2.1.6__tar.gz

{sima_cli-2.1.5/sima_cli.egg-info → sima_cli-2.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sima-cli
-Version: 2.1.5
+Version: 2.1.6
 Summary: CLI tool for SiMa Developer Portal to download models, firmware, and apps.
 Home-page: https://developer.sima.ai/
 Author: SiMa.ai
@@ -152,6 +152,34 @@ sima-cli download <URL> [-d DEST]
 
 ---
 
+## 🔥 Vulcan Artifacts
+
+```bash
+sima-cli vulcan download --env production core main
+```
+
+- Downloads tested artifacts from Vulcan artifact hosting.
+- Environment URLs:
+  - `dev`: `https://artifacts.neat.paconsultings.com`
+  - `staging`: `https://artifacts.stg.neat.sima.ai`
+  - `production`: `https://artifacts.neat.sima.ai`
+- `staging` and `production` are not yet available for Vulcan downloads; use `--env dev` for now.
+- Usage:
+  - `sima-cli vulcan --env {dev|staging|production} download [REPO] [BRANCH_OR_TAG]`
+  - `sima-cli vulcan download --env {dev|staging|production} [REPO] [BRANCH_OR_TAG]`
+  - If `REPO` is omitted, the CLI prompts for a repository.
+  - If `BRANCH_OR_TAG` is omitted, the CLI downloads `branches.json` and prompts for a branch.
+  - For automation, pass both values and add `--json` for structured output.
+- Each download reads `latest.tag`, fetches `manifest.json`, downloads manifest-listed artifacts, and verifies size and SHA256 values when present.
+
+Example:
+
+```bash
+sima-cli vulcan --env dev download internals develop --output ./artifacts --json
+```
+
+---
+
 ## 🔧 Firmware Update
 
 ```bash
@@ -379,10 +407,14 @@ sima-cli packages show <PACKAGE_NAME> [--version VERSION]
 ### Setup SDK
 
 ```bash
-sima-cli sdk setup [--noninteractive] [-y]
+sima-cli sdk setup [--noninteractive] [-y] [--workspace PATH] [--no-model-sdk] [--no-insight] [--minimal]
 ```
 
 - Initialize SDK environment and select components to start.
+- Use `--workspace PATH` to mount a host directory other than `~/workspace` into SDK containers.
+- Use `--no-model-sdk` to skip Model SDK extension setup.
+- Use `--no-insight` to start Neat SDK without Insight UI/video/WebRTC port mappings.
+- Use `--minimal` for CI compilation jobs. It skips optional Neat SDK setup extras, including Insight setup, installing `sima-cli`, Model SDK extensions, and coding agent playbooks inside the container.
 
 ### Start SDK Containers
 

{sima_cli-2.1.5 → sima_cli-2.1.6}/README.md

@@ -118,6 +118,34 @@ sima-cli download <URL> [-d DEST]
 
 ---
 
+## 🔥 Vulcan Artifacts
+
+```bash
+sima-cli vulcan download --env production core main
+```
+
+- Downloads tested artifacts from Vulcan artifact hosting.
+- Environment URLs:
+  - `dev`: `https://artifacts.neat.paconsultings.com`
+  - `staging`: `https://artifacts.stg.neat.sima.ai`
+  - `production`: `https://artifacts.neat.sima.ai`
+- `staging` and `production` are not yet available for Vulcan downloads; use `--env dev` for now.
+- Usage:
+  - `sima-cli vulcan --env {dev|staging|production} download [REPO] [BRANCH_OR_TAG]`
+  - `sima-cli vulcan download --env {dev|staging|production} [REPO] [BRANCH_OR_TAG]`
+  - If `REPO` is omitted, the CLI prompts for a repository.
+  - If `BRANCH_OR_TAG` is omitted, the CLI downloads `branches.json` and prompts for a branch.
+  - For automation, pass both values and add `--json` for structured output.
+- Each download reads `latest.tag`, fetches `manifest.json`, downloads manifest-listed artifacts, and verifies size and SHA256 values when present.
+
+Example:
+
+```bash
+sima-cli vulcan --env dev download internals develop --output ./artifacts --json
+```
+
+---
+
 ## 🔧 Firmware Update
 
 ```bash
@@ -345,10 +373,14 @@ sima-cli packages show <PACKAGE_NAME> [--version VERSION]
 ### Setup SDK
 
 ```bash
-sima-cli sdk setup [--noninteractive] [-y]
+sima-cli sdk setup [--noninteractive] [-y] [--workspace PATH] [--no-model-sdk] [--no-insight] [--minimal]
 ```
 
 - Initialize SDK environment and select components to start.
+- Use `--workspace PATH` to mount a host directory other than `~/workspace` into SDK containers.
+- Use `--no-model-sdk` to skip Model SDK extension setup.
+- Use `--no-insight` to start Neat SDK without Insight UI/video/WebRTC port mappings.
+- Use `--minimal` for CI compilation jobs. It skips optional Neat SDK setup extras, including Insight setup, installing `sima-cli`, Model SDK extensions, and coding agent playbooks inside the container.
 
 ### Start SDK Containers
 

{sima_cli-2.1.5 → sima_cli-2.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sima-cli"
-version = "2.1.5"
+version = "2.1.6"
 description = "CLI tool for SiMa Developer Portal to download models, firmware, and apps."
 readme = "README.md"
 requires-python = ">=3.8"

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/__version__.py

@@ -1,2 +1,2 @@
 # sima_cli/__version__.py
-__version__ = "2.1.5"
+__version__ = "2.1.6"

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/cli.py

@@ -29,6 +29,7 @@ from sima_cli.app_zoo.commands import register_appzoo_commands
 from sima_cli.install.registry import register_packages_commands
 from sima_cli.upgrade.selfupdate import register_selfupdate_command
 from sima_cli.playbooks import register_playbook_commands
+from sima_cli.vulcan import register_vulcan_commands
 
 def _configure_stdio_errors() -> None:
     for stream in (getattr(sys, "stdout", None), getattr(sys, "stderr", None)):
@@ -89,6 +90,7 @@ def main(ctx, internal):
 # ----------------------
 register_sdk_commands(main)
 register_playbook_commands(main)
+register_vulcan_commands(main)
 
 
 # ----------------------

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/sdk/commands.py

@@ -173,8 +173,19 @@ def launch_sdk_tool(tool: str, cmd, ctx):
     is_flag=True,
     help="Skip Model SDK extension setup. Intended for CI installation tests.",
 )
+@click.option(
+    "--minimal",
+    is_flag=True,
+    help="Skip optional Neat SDK container extras for CI compilation jobs.",
+)
+@click.option(
+    "--workspace",
+    type=click.Path(file_okay=False, dir_okay=True),
+    default=None,
+    help="Host workspace directory to mount into SDK containers instead of ~/workspace.",
+)
 @click.pass_context
-def setup(ctx, yes, noninteractive, devkit, no_insight, no_model_sdk):
+def setup(ctx, yes, noninteractive, devkit, no_insight, no_model_sdk, minimal, workspace):
     """Initialize SDK environment and select components to start."""
     devkit_ip = _resolve_devkit_ip(devkit)
     try:
@@ -184,6 +195,8 @@ def setup(ctx, yes, noninteractive, devkit, no_insight, no_model_sdk):
             devkit_ip=devkit_ip,
             no_insight=no_insight,
             no_model_sdk=no_model_sdk,
+            minimal=minimal,
+            workspace=workspace,
         )
     except subprocess.CalledProcessError as e:
         raise click.ClickException(f"SDK setup failed while running: {' '.join(e.cmd)}") from e

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/sdk/install.py

@@ -656,6 +656,8 @@ def setup_and_start(
     devkit_ip: str = "",
     no_insight: bool = False,
     no_model_sdk: bool = False,
+    minimal: bool = False,
+    workspace: Optional[str] = None,
 ):
     """Main entry for SDK setup and container start."""
 
@@ -693,20 +695,29 @@ def setup_and_start(
     # ──────────────────────────────────────────────
     # Start containers
     # ──────────────────────────────────────────────
-    workspace = get_workspace(yes_to_all, noninteractive=noninteractive)
+    workspace = get_workspace(
+        yes_to_all,
+        noninteractive=noninteractive,
+        workspace_override=workspace,
+    )
     uid = os.getuid() if hasattr(os, "getuid") else 900
     gid = os.getgid() if hasattr(os, "getgid") else 900
     devkit_env = _setup_devkit_share(devkit_ip, workspace, selected_images, noninteractive=noninteractive)
-    if no_model_sdk:
+    skip_model_sdk = no_model_sdk or minimal
+    skip_insight = no_insight or minimal
+    if skip_model_sdk:
         sdk_extensions_dir = ""
         if any(is_neat_sdk_image(img) for img in selected_images):
-            click.echo("ℹ️  Skipping Model SDK extension setup because --no-model-sdk was specified.")
+            reason = "--minimal" if minimal else "--no-model-sdk"
+            click.echo(f"ℹ️  Skipping Model SDK extension setup because {reason} was specified.")
     else:
         sdk_extensions_dir = _setup_sdk_extensions(
             selected_images,
             noninteractive=noninteractive,
             yes_to_all=yes_to_all,
         )
+    if minimal and any(is_neat_sdk_image(img) for img in selected_images):
+        click.echo("ℹ️  Skipping Insight setup because --minimal was specified.")
     
     for img in selected_images:
         container_name = sanitize_container_name(img)
@@ -739,13 +750,15 @@ def setup_and_start(
                 sdk_extensions_dir=sdk_extensions_dir,
                 noninteractive=noninteractive,
                 yes_to_all=yes_to_all,
-                no_insight=no_insight,
-                no_model_sdk=no_model_sdk,
+                no_insight=skip_insight,
+                no_model_sdk=skip_model_sdk,
+                minimal=minimal,
             )
         else:
-            if no_insight and is_neat_sdk_image(img):
+            if skip_insight and is_neat_sdk_image(img):
+                option = "--minimal" if minimal else "--no-insight"
                 raise RuntimeError(
-                    "Cannot apply --no-insight to an existing Neat SDK container because Docker "
+                    f"Cannot apply {option} to an existing Neat SDK container because Docker "
                     "port mappings are immutable. Remove and recreate the container when prompted, "
                     f"or run: docker rm -f {existing_container}"
                 )

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/sdk/neat.py

@@ -157,16 +157,16 @@ def allocate_neat_ports(no_insight: bool = False) -> Tuple[Dict, List[str]]:
 
     port_map = {
         "schema": NEAT_PORT_MAP_SCHEMA,
-        "cert": {
-            "mount": "/sdk-cert",
-            "certFile": "/sdk-cert/neat-sdk.pem",
-            "keyFile": "/sdk-cert/neat-sdk-key.pem",
-        },
     }
 
     port_args = []
 
     if not no_insight:
+        port_map["cert"] = {
+            "mount": "/sdk-cert",
+            "certFile": "/sdk-cert/neat-sdk.pem",
+            "keyFile": "/sdk-cert/neat-sdk-key.pem",
+        }
         web_ssh = _allocate_single_port(8022, "tcp", reserved)
         rtsp_tcp = _allocate_single_port(8554, "tcp", reserved)
         main_ui = _allocate_single_port(9900, "tcp", reserved)
@@ -454,11 +454,24 @@ def prepare_neat_container_run(
     yes_to_all: bool = False,
     noninteractive: bool = False,
     no_insight: bool = False,
+    minimal: bool = False,
 ) -> NeatRunConfig:
+    no_insight = no_insight or minimal
     container_dir = Path(workspace) / f".{container_name}"
     config_dir = container_dir / "insight-config"
     cert_dir = container_dir / "sdk-cert"
     port_map, port_args = allocate_neat_ports(no_insight=no_insight)
+    if no_insight:
+        return NeatRunConfig(
+            port_map=port_map,
+            port_args=port_args,
+            config_host_dir="",
+            cert_host_dir="",
+            port_map_host_path="",
+            cert_file_host_path="",
+            key_file_host_path="",
+            webrtc_host_ip="",
+        )
     webrtc_host_ip = _detect_webrtc_host_ip(devkit_env)
     cert_file, key_file = _ensure_certificates(
         cert_dir,
@@ -480,13 +493,16 @@ def prepare_neat_container_run(
 
 
 def append_neat_docker_args(docker_cmd: List[str], config: NeatRunConfig) -> None:
-    docker_cmd.extend(["-e", f"MTX_RTSPTRANSPORTS={NEAT_MEDIAMTX_RTSP_TRANSPORTS}"])
+    if config.port_args or config.config_host_dir:
+        docker_cmd.extend(["-e", f"MTX_RTSPTRANSPORTS={NEAT_MEDIAMTX_RTSP_TRANSPORTS}"])
     if config.webrtc_host_ip:
         docker_cmd.extend(["-e", f"CONTAINER_HOST_IP={config.webrtc_host_ip}"])
     for mapping in config.port_args:
         docker_cmd.extend(["-p", mapping])
-    docker_cmd.extend(["-v", f"{config.config_host_dir}:/home/docker/.insight-config"])
-    docker_cmd.extend(["-v", f"{config.cert_host_dir}:/sdk-cert"])
+    if config.config_host_dir:
+        docker_cmd.extend(["-v", f"{config.config_host_dir}:/home/docker/.insight-config"])
+    if config.cert_host_dir:
+        docker_cmd.extend(["-v", f"{config.cert_host_dir}:/sdk-cert"])
 
 
 def print_neat_setup_summary(config: NeatRunConfig) -> None:
@@ -529,8 +545,10 @@ def print_neat_setup_summary(config: NeatRunConfig) -> None:
         )
     if config.webrtc_host_ip:
         print(f"   iceHost:     {config.webrtc_host_ip}")
-    print(f"   config:      {config.port_map_host_path}")
-    print(f"   certs:       {config.cert_host_dir}")
+    if config.port_map_host_path:
+        print(f"   config:      {config.port_map_host_path}")
+    if config.cert_host_dir:
+        print(f"   certs:       {config.cert_host_dir}")
 
 
 def is_docker_port_collision_error(error_text: str) -> bool:

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/sdk/utils.py

@@ -504,7 +504,7 @@ def get_running_containers():
     return running
 
 
-def get_workspace(yes_to_all=False, noninteractive=False):
+def get_workspace(yes_to_all=False, noninteractive=False, workspace_override=None):
     """
     Determine the workspace:
     - If at least one container is running, read from ~/.simaai/.mount
@@ -515,6 +515,17 @@ def get_workspace(yes_to_all=False, noninteractive=False):
     simaai_dir = os.path.join(home, ".simaai")
     mount_file = os.path.join(simaai_dir, ".mount")
 
+    if workspace_override:
+        workspace = os.path.realpath(os.path.expanduser(workspace_override))
+        if not os.path.isdir(workspace):
+            os.makedirs(workspace, exist_ok=True)
+            print(f"📂 Created workspace: {workspace}")
+        print(f"✅ Workspace set to: {workspace}")
+        os.makedirs(simaai_dir, exist_ok=True)
+        with open(mount_file, "w") as f:
+            f.write(workspace)
+        return workspace
+
     running_containers = get_running_containers()
 
     # Case 1: At least one container running → read workspace
@@ -920,6 +931,7 @@ def configure_container(
     noninteractive=False,
     yes_to_all=False,
     no_model_sdk=False,
+    minimal=False,
 ):
     """
     Configure container user mappings and permissions:
@@ -930,6 +942,7 @@ def configure_container(
       - If configure_network=True, computes and stores .hash for /usr/local/simaai/plugins
     """
     platform_os = check_os()
+    no_model_sdk = no_model_sdk or minimal
 
     # Detect current host user
     if platform_os in ["linux", "macos"]:
@@ -1016,10 +1029,15 @@ def configure_container(
 
     _copy_sima_cli_auth_cache_to_container(sdk_container_name, login_name, uid, gid)
 
-    # Ensure sima-cli is available for the configured default user.
-    ensure_sima_cli_installed(sdk_container_name, login_name)
+    # Ensure sima-cli is available for the configured default user unless this
+    # setup is only preparing a lightweight CI compilation container.
+    if minimal:
+        print("ℹ️  Skipping sima-cli installation because --minimal was specified.")
+    else:
+        ensure_sima_cli_installed(sdk_container_name, login_name)
     if no_model_sdk:
-        print("ℹ️  Skipping Model SDK extension installation because --no-model-sdk was specified.")
+        reason = "--minimal" if minimal else "--no-model-sdk"
+        print(f"ℹ️  Skipping Model SDK extension installation because {reason} was specified.")
     else:
         ensure_model_sdk_extension_installed(
             sdk_container_name,
@@ -1027,7 +1045,10 @@ def configure_container(
             auto_install=(noninteractive or yes_to_all),
         )
     _sync_codex_skills(sdk_container_name, login_name, uid, gid)
-    install_neat_playbooks(sdk_container_name, login_name)
+    if minimal:
+        print("ℹ️  Skipping Neat coding agent playbook installation because --minimal was specified.")
+    else:
+        install_neat_playbooks(sdk_container_name, login_name)
 
     # ---- Optional Network & Syslog Configuration ----
     if configure_network:
@@ -1141,6 +1162,7 @@ def start_docker_container(
     yes_to_all=False,
     no_insight=False,
     no_model_sdk=False,
+    minimal=False,
 ):
     """
     Start a Docker container using an image pulled from either JFrog or AWS ECR.
@@ -1152,6 +1174,7 @@ def start_docker_container(
     # ─────────────────────────────────────────────
     # Generate container name
     # ─────────────────────────────────────────────
+    no_insight = no_insight or minimal
     container_name = sanitize_container_name(image)
     hostname = sanitize_container_hostname(container_name)
     print(f"🚀 Starting container '{container_name}' using image '{image}'")
@@ -1262,6 +1285,7 @@ def start_docker_container(
                 yes_to_all=yes_to_all,
                 noninteractive=noninteractive,
                 no_insight=no_insight,
+                minimal=minimal,
             )
             launch_cmd = list(base_docker_cmd)
             append_neat_docker_args(launch_cmd, neat_run_config)
@@ -1311,6 +1335,7 @@ def start_docker_container(
         noninteractive=noninteractive,
         yes_to_all=yes_to_all,
         no_model_sdk=no_model_sdk,
+        minimal=minimal,
     )
 
     if devkit_env and neat_sdk_image:

{sima_cli-2.1.5 → sima_cli-2.1.6}/sima_cli/update/elxr.py

@@ -4,15 +4,20 @@ from typing import Optional, List, Tuple
 import re
 import os
 import shutil
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
 
 from sima_cli.utils.env import is_devkit_running_elxr
 
 APT_SOURCE_FILE = "/etc/apt/sources.list.d/0000mirror.list"
+BUILDINFO_FILES = ["/etc/build", "/etc/buildinfo"]
 EXTERNAL_REPO_URL = "https://repo.sima.ai/elxr/deb/release"
 INTERNAL_REPO_URL = "http://sw-web.eng.sima.ai/deb/pre-release"
 DEFAULT_REPO_SUITE = "bookworm"
 REPO_COMPONENT = "non-free"
 SIMAAI_OTA_FALLBACK = "/usr/bin/simaai-ota"
+ELXR_UPDATE_DOC_URL = "https://docs.sima.ai/pages/tech-notes/elxr-conversion.html"
 
 
 def _repo_line(repo_url: str, suite: str) -> str:
@@ -181,6 +186,35 @@ def _get_installed_palette_version() -> Optional[str]:
     return version if version else None
 
 
+def _get_installed_elxr_distro_version() -> Optional[str]:
+    """Return ELXR DISTRO_VERSION from /etc/build or /etc/buildinfo, if available."""
+    pattern = re.compile(r"^\s*DISTRO_VERSION\s*=\s*(\S+)\s*$")
+
+    for path in BUILDINFO_FILES:
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                for line in f:
+                    match = pattern.match(line)
+                    if match:
+                        return match.group(1)
+        except OSError:
+            continue
+
+    return None
+
+
+def _is_current_elxr_version(
+    requested_version: str,
+    installed_palette_version: Optional[str],
+    installed_distro_version: Optional[str],
+) -> bool:
+    return requested_version in {
+        version
+        for version in (installed_palette_version, installed_distro_version)
+        if version
+    }
+
+
 def _get_available_palette_versions() -> List[str]:
     """Parse apt policy output and return available simaai-palette-modalix versions."""
     try:
@@ -230,6 +264,37 @@ def _get_available_palette_versions() -> List[str]:
     return versions
 
 
+def _show_unsupported_specific_elxr_update(
+    requested_version: str,
+    current_version: Optional[str] = None,
+    latest_version: Optional[str] = None,
+) -> None:
+    details = [
+        "Updating ELXR to a specific version is not currently supported by `sima-cli update`.",
+        "Downgrades and non-latest upgrade paths are not reliable enough to automate safely.",
+    ]
+    if current_version:
+        details.append(f"Current simaai-palette-modalix version: {current_version}")
+    if requested_version:
+        details.append(f"Requested simaai-palette-modalix version: {requested_version}")
+    if latest_version:
+        details.append(f"Latest available simaai-palette-modalix version: {latest_version}")
+    details.extend([
+        "",
+        "Use `sima-cli update` without a version to update to the latest supported build.",
+        f"For full-system conversion/update guidance, see: {ELXR_UPDATE_DOC_URL}",
+    ])
+
+    Console().print(
+        Panel(
+            Text("\n".join(details), style="yellow"),
+            title="[yellow]Unsupported ELXR Update Path[/yellow]",
+            border_style="yellow",
+            expand=False,
+        )
+    )
+
+
 def print_current_versions():
     p1 = subprocess.Popen(
         ["dpkg", "-l"],
@@ -265,8 +330,6 @@ def update_elxr(version_or_url: Optional[str], internal: bool = False):
 
     print_current_versions()
 
-    from InquirerPy import inquirer
-
     if not _ensure_elxr_repo_channel(internal):
         return
 
@@ -292,6 +355,9 @@ def update_elxr(version_or_url: Optional[str], internal: bool = False):
     # Main interaction loop
     # -----------------------------
     simaai_ota = _resolve_simaai_ota()
+    if version_or_url is None:
+        from InquirerPy import inquirer
+
     while True:
 
         # If user did not pass a version, show the update type menu
@@ -321,6 +387,8 @@ def update_elxr(version_or_url: Optional[str], internal: bool = False):
                 # -----------------------------
                 versions = _get_available_palette_versions()
                 installed_version = _get_installed_palette_version()
+                installed_distro_version = _get_installed_elxr_distro_version()
+                latest_version = versions[0] if versions else None
 
                 if not versions:
                     click.echo("❌ No versions found in APT policy, aborting.")
@@ -346,8 +414,7 @@ def update_elxr(version_or_url: Optional[str], internal: bool = False):
                     click.echo("❌ Update cancelled")
                     return
 
-                # A version was selected
-                if installed_version and selected == installed_version:
+                if _is_current_elxr_version(selected, installed_version, installed_distro_version):
                     same_version_choice = inquirer.select(
                         message=(
                             f"Version {selected} is already running. "
@@ -365,16 +432,55 @@ def update_elxr(version_or_url: Optional[str], internal: bool = False):
 
                     cmd = [simaai_ota, "-f", "-o", "-v", selected]
                     desc = f"Force reinstall specific version {selected}"
-                else:
+                    break
+
+                if latest_version and selected == latest_version:
                     cmd = [simaai_ota, "-f", "-o", "-v", selected]
-                    desc = f"Update to specific version {selected}"
-                break
+                    desc = f"Update to latest version {selected}"
+                    break
+
+                _show_unsupported_specific_elxr_update(
+                    requested_version=selected,
+                    current_version=installed_distro_version or installed_version,
+                    latest_version=latest_version,
+                )
+                warning_choice = inquirer.select(
+                    message="What would you like to do next?",
+                    choices=[
+                        {"name": "⬅️  Back to previous menu", "value": "back"},
+                        {"name": "❌ Cancel", "value": "cancel"},
+                    ],
+                    default="back",
+                ).execute()
+
+                if warning_choice == "cancel":
+                    click.echo("❌ Update cancelled")
+                    return
+
+                continue
 
         else:
             # version_or_url specified by user (non-interactive)
-            cmd = [simaai_ota, "-f", "-o", "-v", version_or_url]
-            desc = f"Update to specific version {version_or_url}"
-            break
+            versions = _get_available_palette_versions()
+            installed_version = _get_installed_palette_version()
+            installed_distro_version = _get_installed_elxr_distro_version()
+            latest_version = versions[0] if versions else None
+            if _is_current_elxr_version(version_or_url, installed_version, installed_distro_version):
+                cmd = [simaai_ota, "-f", "-o", "-v", version_or_url]
+                desc = f"Force reinstall specific version {version_or_url}"
+                break
+
+            if latest_version and version_or_url == latest_version:
+                cmd = [simaai_ota, "-f", "-o", "-v", version_or_url]
+                desc = f"Update to latest version {version_or_url}"
+                break
+
+            _show_unsupported_specific_elxr_update(
+                requested_version=version_or_url,
+                current_version=installed_distro_version or installed_version,
+                latest_version=latest_version,
+            )
+            return
 
     # -----------------------------
     # Execute update

sima_cli-2.1.6/sima_cli/vulcan/__init__.py

@@ -0,0 +1,3 @@
+from .commands import register_vulcan_commands
+
+__all__ = ["register_vulcan_commands"]