sima-cli 2.1.10__tar.gz → 2.1.11__tar.gz

{sima_cli-2.1.10/sima_cli.egg-info → sima_cli-2.1.11}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: sima-cli
-Version: 2.1.10
+Version: 2.1.11
 Summary: CLI tool for SiMa Developer Portal to download models, firmware, and apps.
-Home-page: https://developer.sima.ai/
+Home-page: https://community.sima.ai/
 Author: SiMa.ai
 Author-email: "Sima.ai" <support@sima.ai>
 License: MIT
-Project-URL: Homepage, https://developer.sima.ai/
+Project-URL: Homepage, https://community.sima.ai/
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 3 - Alpha
@@ -41,12 +41,12 @@ Dynamic: requires-python
 [![Python 3.12](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.12&label=python%203.12)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![Python 3.13](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.13&label=python%203.13)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![Python 3.14](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.14&label=python%203.14)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
-[![E2E macOS](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(macOS%20CLI%20only)&label=e2e%20macOS&logo=apple&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E macOS](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(macOS)&label=e2e%20macOS&logo=apple&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![E2E Windows](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Windows)&label=e2e%20Windows&logo=windows&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![E2E Ubuntu x86](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20x86)&label=e2e%20Ubuntu%20x86&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![E2E Ubuntu ARM64](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20ARM64)&label=e2e%20Ubuntu%20ARM64&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 
-`sima-cli` is the command-line interface for SiMa developer workflows. It handles authentication, SDK container setup, DevKit updates, package installation, artifact downloads, Model Zoo/App Zoo access, and related development utilities.
+`sima-cli` is the command-line interface for SiMa developer workflows. Use it to authenticate, set up SDK containers, update DevKits, install packages, download artifacts, and access Model Zoo and App Zoo content.
 
 ## Documentation
 
@@ -59,16 +59,45 @@ Use the generated docs for detailed options, arguments, subcommands, and full he
 
 ## Installation
 
-Install the latest `main` build:
+For most users, install the latest official release from the public installer URL for your operating system.
+
+### Linux, macOS, and DevKit
+
+Run the installer from a terminal:
+
+```bash
+curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash
+```
+
+After installation, open a new terminal or reload your shell profile, then verify the install:
 
 ```bash
-curl -fsSL https://artifacts.sima-neat.com/tools/sima-cli-install.py -o sima-cli-install.py
-python3 sima-cli-install.py main latest
+sima-cli --version
+```
+
+### Windows PowerShell
+
+Download and run the Windows installer from PowerShell:
+
+```powershell
+Invoke-WebRequest https://artifacts.neat.sima.ai/sima-cli/windows.bat -OutFile windows.bat
+.\windows.bat
 ```
 
-Install interactively:
+After installation, open a new Command Prompt or PowerShell window, then verify the install:
+
+```powershell
+sima-cli --version
+```
+
+### Advanced: choose a branch or release
+
+Use `install.py` only when you need to choose a specific tested branch build or release instead of installing the latest official PyPI release.
+
+On Linux, macOS, or DevKit:
 
 ```bash
+curl -fsSL https://artifacts.neat.sima.ai/sima-cli/install.py -o sima-cli-install.py
 python3 sima-cli-install.py
 ```
 
@@ -82,10 +111,19 @@ python3 sima-cli-install.py v2.1.6 latest
 On Windows PowerShell:
 
 ```powershell
-Invoke-WebRequest https://artifacts.sima-neat.com/tools/sima-cli-install.py -OutFile sima-cli-install.py
-python .\sima-cli-install.py main latest
+Invoke-WebRequest https://artifacts.neat.sima.ai/sima-cli/install.py -OutFile sima-cli-install.py
+python .\sima-cli-install.py
 ```
 
+To install a specific branch or release:
+
+```powershell
+python .\sima-cli-install.py feature/my-branch latest
+python .\sima-cli-install.py v2.1.6 latest
+```
+
+Release tags such as `v2.1.6` install from public PyPI. Branch names install tested artifacts from `artifacts.neat.sima.ai/sima-cli`.
+
 Public PyPI releases can also be installed directly:
 
 ```bash
@@ -96,15 +134,15 @@ pip install sima-cli
 
 ```bash
 sima-cli --help
+sima-cli --version
 sima-cli login
-sima-cli version
 ```
 
 Use `--internal` or `SIMA_CLI_INTERNAL=1` when internal Artifactory resources are required:
 
 ```bash
 sima-cli --internal login
-SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.1 sdk-extensions/model
+SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.2 tools/model-compiler/amd64
 ```
 
 ## Common Workflows
@@ -116,10 +154,13 @@ sima-cli sdk setup
 sima-cli sdk neat
 ```
 
-Install a package from metadata:
+Install Model Compiler from package metadata:
 
 ```bash
-sima-cli install -v 2.1.1 sdk-extensions/model
+# amd64 host
+sima-cli install -v 2.1.2 tools/model-compiler/amd64
+# arm64 host
+sima-cli install -v 2.1.2 tools/model-compiler/arm64
 ```
 
 Download or install Neat artifacts:
@@ -165,7 +206,6 @@ sima-cli appzoo list
 | `sima-cli selfupdate` | Update sima-cli manually. | [docs](docs/sima-cli/commands/sima-cli-selfupdate.md) |
 | `sima-cli serial` | Connect to the UART serial console of a DevKit. | [docs](docs/sima-cli/commands/sima-cli-serial.md) |
 | `sima-cli update` | Update a SiMa DevKit or remote device. | [docs](docs/sima-cli/commands/sima-cli-update.md) |
-| `sima-cli version` | Show the installed CLI version. | [docs](docs/sima-cli/commands/sima-cli-version.md) |
 
 ## Development
 

{sima_cli-2.1.10 → sima_cli-2.1.11}/README.md

@@ -7,12 +7,12 @@
 [![Python 3.12](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.12&label=python%203.12)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![Python 3.13](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.13&label=python%203.13)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![Python 3.14](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=Compatibility%20Python%203.14&label=python%203.14)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
-[![E2E macOS](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(macOS%20CLI%20only)&label=e2e%20macOS&logo=apple&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
+[![E2E macOS](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(macOS)&label=e2e%20macOS&logo=apple&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![E2E Windows](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Windows)&label=e2e%20Windows&logo=windows&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![E2E Ubuntu x86](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20x86)&label=e2e%20Ubuntu%20x86&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 [![E2E Ubuntu ARM64](https://img.shields.io/github/actions/workflow/status/sima-neat/sima-cli/vulcan-ci.yml?branch=main&job=E2E%20Install%20(Ubuntu%20ARM64)&label=e2e%20Ubuntu%20ARM64&logo=ubuntu&logoColor=white)](https://github.com/sima-neat/sima-cli/actions/workflows/vulcan-ci.yml)
 
-`sima-cli` is the command-line interface for SiMa developer workflows. It handles authentication, SDK container setup, DevKit updates, package installation, artifact downloads, Model Zoo/App Zoo access, and related development utilities.
+`sima-cli` is the command-line interface for SiMa developer workflows. Use it to authenticate, set up SDK containers, update DevKits, install packages, download artifacts, and access Model Zoo and App Zoo content.
 
 ## Documentation
 
@@ -25,16 +25,45 @@ Use the generated docs for detailed options, arguments, subcommands, and full he
 
 ## Installation
 
-Install the latest `main` build:
+For most users, install the latest official release from the public installer URL for your operating system.
+
+### Linux, macOS, and DevKit
+
+Run the installer from a terminal:
+
+```bash
+curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash
+```
+
+After installation, open a new terminal or reload your shell profile, then verify the install:
 
 ```bash
-curl -fsSL https://artifacts.sima-neat.com/tools/sima-cli-install.py -o sima-cli-install.py
-python3 sima-cli-install.py main latest
+sima-cli --version
+```
+
+### Windows PowerShell
+
+Download and run the Windows installer from PowerShell:
+
+```powershell
+Invoke-WebRequest https://artifacts.neat.sima.ai/sima-cli/windows.bat -OutFile windows.bat
+.\windows.bat
 ```
 
-Install interactively:
+After installation, open a new Command Prompt or PowerShell window, then verify the install:
+
+```powershell
+sima-cli --version
+```
+
+### Advanced: choose a branch or release
+
+Use `install.py` only when you need to choose a specific tested branch build or release instead of installing the latest official PyPI release.
+
+On Linux, macOS, or DevKit:
 
 ```bash
+curl -fsSL https://artifacts.neat.sima.ai/sima-cli/install.py -o sima-cli-install.py
 python3 sima-cli-install.py
 ```
 
@@ -48,10 +77,19 @@ python3 sima-cli-install.py v2.1.6 latest
 On Windows PowerShell:
 
 ```powershell
-Invoke-WebRequest https://artifacts.sima-neat.com/tools/sima-cli-install.py -OutFile sima-cli-install.py
-python .\sima-cli-install.py main latest
+Invoke-WebRequest https://artifacts.neat.sima.ai/sima-cli/install.py -OutFile sima-cli-install.py
+python .\sima-cli-install.py
 ```
 
+To install a specific branch or release:
+
+```powershell
+python .\sima-cli-install.py feature/my-branch latest
+python .\sima-cli-install.py v2.1.6 latest
+```
+
+Release tags such as `v2.1.6` install from public PyPI. Branch names install tested artifacts from `artifacts.neat.sima.ai/sima-cli`.
+
 Public PyPI releases can also be installed directly:
 
 ```bash
@@ -62,15 +100,15 @@ pip install sima-cli
 
 ```bash
 sima-cli --help
+sima-cli --version
 sima-cli login
-sima-cli version
 ```
 
 Use `--internal` or `SIMA_CLI_INTERNAL=1` when internal Artifactory resources are required:
 
 ```bash
 sima-cli --internal login
-SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.1 sdk-extensions/model
+SIMA_CLI_INTERNAL=1 sima-cli install -v 2.1.2 tools/model-compiler/amd64
 ```
 
 ## Common Workflows
@@ -82,10 +120,13 @@ sima-cli sdk setup
 sima-cli sdk neat
 ```
 
-Install a package from metadata:
+Install Model Compiler from package metadata:
 
 ```bash
-sima-cli install -v 2.1.1 sdk-extensions/model
+# amd64 host
+sima-cli install -v 2.1.2 tools/model-compiler/amd64
+# arm64 host
+sima-cli install -v 2.1.2 tools/model-compiler/arm64
 ```
 
 Download or install Neat artifacts:
@@ -131,7 +172,6 @@ sima-cli appzoo list
 | `sima-cli selfupdate` | Update sima-cli manually. | [docs](docs/sima-cli/commands/sima-cli-selfupdate.md) |
 | `sima-cli serial` | Connect to the UART serial console of a DevKit. | [docs](docs/sima-cli/commands/sima-cli-serial.md) |
 | `sima-cli update` | Update a SiMa DevKit or remote device. | [docs](docs/sima-cli/commands/sima-cli-update.md) |
-| `sima-cli version` | Show the installed CLI version. | [docs](docs/sima-cli/commands/sima-cli-version.md) |
 
 ## Development
 

{sima_cli-2.1.10 → sima_cli-2.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sima-cli"
-version = "2.1.10"
+version = "2.1.11"
 description = "CLI tool for SiMa Developer Portal to download models, firmware, and apps."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -37,7 +37,7 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://developer.sima.ai/"
+Homepage = "https://community.sima.ai/"
 
 [project.scripts]
 sima-cli = "sima_cli.cli:main"

{sima_cli-2.1.10 → sima_cli-2.1.11}/setup.cfg

@@ -5,7 +5,7 @@ author_email = support@sima.ai
 description = CLI tool for SiMa Developer Portal to download models, firmware, and apps.
 long_description = file: README.md
 long_description_content_type = text/markdown
-url = https://developer.sima.ai/
+url = https://community.sima.ai/
 license = MIT
 classifiers = 
 	Programming Language :: Python :: 3

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/__version__.py

@@ -1,2 +1,2 @@
 # sima_cli/__version__.py
-__version__ = "2.1.10"
+__version__ = "2.1.11"

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/app_zoo/commands.py

@@ -1,9 +1,31 @@
 
 import click
+from rich.console import Console
+from rich.panel import Panel
 
 from sima_cli.app_zoo.app import list_apps, download_app, describe_app, clone_apps
+from sima_cli.utils.deprecation import should_show_post_neat_ga_deprecation_notice
 from sima_cli.utils.tag import resolve_version
 
+console = Console()
+
+
+def show_appzoo_deprecation_notice() -> None:
+    if not should_show_post_neat_ga_deprecation_notice():
+        return
+
+    console.print(
+        Panel(
+            "[yellow]App Zoo is compatible with legacy Palette SDKs and will be deprecated soon.[/yellow]\n\n"
+            "Use https://developer.sima.ai/examples to access current example applications.",
+            title="App Zoo Deprecation Notice",
+            border_style="yellow",
+            style="yellow",
+            expand=False,
+        )
+    )
+
+
 @click.group()
 @click.option(
     "-v", "--ver", "--version",
@@ -15,6 +37,7 @@ from sima_cli.utils.tag import resolve_version
 def appzoo(ctx, ver):
     """Access sample apps from the App Zoo."""
     ctx.ensure_object(dict)
+    show_appzoo_deprecation_notice()
     internal = ctx.obj.get("internal", False)
     if not internal:
         ver = resolve_version(ver)
@@ -71,4 +94,3 @@ def register_appzoo_commands(main):
         register_appzoo_commands(main)
     """
     main.add_command(appzoo)
-

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/auth/auth0.py

@@ -32,8 +32,8 @@ USERINFO_AUDIENCE = PROD_USERINFO_AUDIENCE
 LATEST_EULA_GRANT = "LatestEULA"
 DOC_ACCESS_GRANT = "DocsAccess"
 DOC_ACCESS_GRANT_ALIASES = (DOC_ACCESS_GRANT, "DocAccess")
-PROD_DISCOURSE_URL = "https://developer.sima.ai/login"
-STAGING_DISCOURSE_URL = "https://discourse-dev.sima.ai/login"
+PROD_DISCOURSE_URL = "https://community.sima.ai/login"
+STAGING_DISCOURSE_URL = "https://community-dev.sima.ai/login"
 
 # ─────────────────────────────────────────────
 # Configuration loader

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/auth/devportal.py

@@ -40,15 +40,14 @@ HOST_DOCKER_CONTEXTS_DIR = os.path.join(os.path.expanduser("~"), ".docker", "con
 # Detect staging or production environment
 is_staging = False
 if os.getenv("USE_STAGING_DEV_PORTAL", "false").lower() in ("1", "true", "yes"):
-    DEV_PORTAL = "https://discourse-dev.sima.ai"
+    DEV_PORTAL = "https://community-dev.sima.ai"
     DOCS_PORTAL = "https://docs-dev.sima.ai"
     is_staging = True
 else:
-    DEV_PORTAL = "https://developer.sima.ai"
+    DEV_PORTAL = "https://community.sima.ai"
     DOCS_PORTAL = "https://docs.sima.ai"
 
 # Derived endpoints
-LOGIN_URL = f"{DEV_PORTAL}/session"
 DEV_PORTAL_LOGIN_URL = f"{DEV_PORTAL}/login"
 DUMMY_CHECK_URL = f"{DOCS_PORTAL}/pkg_downloads/validation"
 ACCESS_REQUEST_FORM_URL = "https://www2.sima.ai/l/1041271/2025-05-05/37bndg"

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/cli.py

@@ -82,6 +82,7 @@ def _rerun_current_command() -> None:
 # Entry point for the CLI tool using Click's command group decorator
 @click.group(context_settings=dict(help_option_names=["-h", "--help", "-?"], max_content_width=120))
 @click.option('-i', '--internal', is_flag=True, help="Use internal Artifactory resources, Authorized Sima employees only")
+@click.version_option(version=f"{__version__}", message="SiMa CLI version: %(version)s")
 @click.pass_context
 def main(ctx, internal):
     """
@@ -143,14 +144,6 @@ def login(ctx):
     internal = ctx.obj.get("internal", False)
     perform_login.login("internal" if internal else "external")
 
-# ----------------------
-# Version Command
-# ----------------------
-@main.command(name="version")
-def version_cmd():
-    """Show the version of the CLI tool."""
-    click.echo(f"SiMa CLI version: {__version__}")
-
 # ----------------------
 # Logout Command
 # ----------------------

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/data/resources_public.yaml

@@ -1,5 +1,5 @@
 artifactory:
-  url: "https://developer.sima.ai"
+  url: "https://community.sima.ai"
 
 auth:
   auth_url: "/login"
@@ -18,4 +18,4 @@ auth-dev:
   client-id: Rjrv1TXE5VWjMmCmWyT6OmLYEN1K5AIS
 
 download:
-  download_url: "https://docs.sima.ai/pkg_downloads/"
+  download_url: "https://docs.sima.ai/pkg_downloads/"

sima_cli-2.1.11/sima_cli/install/compatibility.py

@@ -0,0 +1,161 @@
+import re
+from typing import Dict, List, Optional, Sequence
+
+
+VALID_OS = {"linux", "windows", "mac", "ubuntu"}
+VALID_PLATFORM_TYPES = {"board", "palette", "host"}
+
+_COMPATIBLE_NAME_RE = re.compile(r"^[A-Za-z0-9_.-]+$")
+_VERSION_RE = r"v?\d+(?:\.\d+)*"
+_VERSION_CLAUSE_RE = re.compile(r"^(>=|<=|==|=|>|<)?\s*({})$".format(_VERSION_RE))
+
+
+def _split_csv(value: str) -> List[str]:
+    return [item.strip() for item in value.split(",") if item.strip()]
+
+
+def _version_tuple(version: str) -> tuple:
+    normalized = version.strip()
+    if normalized.startswith("v"):
+        normalized = normalized[1:]
+    return tuple(int(part) for part in normalized.split("."))
+
+
+def _pad_versions(left: tuple, right: tuple) -> tuple:
+    length = max(len(left), len(right))
+    return left + (0,) * (length - len(left)), right + (0,) * (length - len(right))
+
+
+def normalize_version_spec(spec: str) -> str:
+    if not isinstance(spec, str) or not spec.strip():
+        raise ValueError("version spec must be a non-empty string")
+
+    clauses = []
+    for raw_clause in spec.split(","):
+        clause = raw_clause.strip()
+        if not clause:
+            raise ValueError("version spec contains an empty clause")
+        match = _VERSION_CLAUSE_RE.fullmatch(clause)
+        if not match:
+            raise ValueError(
+                "invalid version spec '{}'; expected versions like 2.1.1, ==2.1.1, "
+                ">=2.1.0, or >=2.1.0,<=2.1.2".format(spec)
+            )
+        op, version = match.groups()
+        clauses.append("{}{}".format(op or "", version))
+
+    return ",".join(clauses)
+
+
+def validate_version_spec(spec: str) -> None:
+    normalize_version_spec(spec)
+
+
+def normalize_exact_version(version: str) -> str:
+    if not isinstance(version, str) or not version.strip():
+        raise ValueError("version must be a non-empty string")
+    normalized = version.strip()
+    if not re.fullmatch(_VERSION_RE, normalized):
+        raise ValueError("invalid exact version '{}'; expected a version like 2.0.0".format(version))
+    return normalized
+
+
+def version_matches(version: str, spec: str) -> bool:
+    normalized_spec = normalize_version_spec(spec)
+    current = _version_tuple(version)
+
+    for clause in normalized_spec.split(","):
+        match = _VERSION_CLAUSE_RE.fullmatch(clause)
+        if not match:
+            return False
+        op, target_value = match.groups()
+        op = op or "=="
+        target = _version_tuple(target_value)
+        left, right = _pad_versions(current, target)
+
+        if op in ("=", "=="):
+            clause_matches = left == right
+        elif op == ">":
+            clause_matches = left > right
+        elif op == ">=":
+            clause_matches = left >= right
+        elif op == "<":
+            clause_matches = left < right
+        elif op == "<=":
+            clause_matches = left <= right
+        else:
+            clause_matches = False
+
+        if not clause_matches:
+            return False
+
+    return True
+
+
+def parse_host_platform_specs(host_platforms: Optional[Sequence[str]]) -> List[Dict]:
+    platforms = []
+    for raw_spec in host_platforms or []:
+        os_values = []
+        seen = set()
+        for value in _split_csv(raw_spec):
+            os_value = value.lower()
+            if os_value not in VALID_OS:
+                raise ValueError(
+                    "invalid host platform OS '{}'; supported values are {}".format(
+                        value, ", ".join(sorted(VALID_OS))
+                    )
+                )
+            if os_value not in seen:
+                seen.add(os_value)
+                os_values.append(os_value)
+        if not os_values:
+            raise ValueError("host platform spec must include at least one OS")
+        platforms.append({"type": "host", "os": os_values})
+    return platforms
+
+
+def parse_board_platform_spec(spec: str) -> Dict:
+    if not isinstance(spec, str) or not spec.strip():
+        raise ValueError("board platform spec must be a non-empty string")
+
+    raw_compat, separator, raw_version_spec = spec.strip().partition("@")
+    compatible_with = []
+    seen = set()
+    for value in _split_csv(raw_compat):
+        if not _COMPATIBLE_NAME_RE.fullmatch(value):
+            raise ValueError(
+                "invalid board compatibility target '{}'; use letters, numbers, dots, underscores, or hyphens".format(
+                    value
+                )
+            )
+        if value not in seen:
+            seen.add(value)
+            compatible_with.append(value)
+
+    if not compatible_with:
+        raise ValueError("board platform spec must include at least one compatibility target")
+
+    platform = {"type": "board", "compatible_with": compatible_with}
+    if separator:
+        platform["version"] = normalize_version_spec(raw_version_spec)
+    return platform
+
+
+def parse_board_platform_specs(board_platforms: Optional[Sequence[str]]) -> List[Dict]:
+    return [parse_board_platform_spec(spec) for spec in board_platforms or []]
+
+
+def build_platform_specs(
+    host_platforms: Optional[Sequence[str]] = None,
+    board_platforms: Optional[Sequence[str]] = None,
+    palette_platform: Optional[str] = None,
+) -> List[Dict]:
+    platforms = []
+    platforms.extend(parse_host_platform_specs(host_platforms))
+    platforms.extend(parse_board_platform_specs(board_platforms))
+    if palette_platform is not None:
+        platform = {"type": "palette"}
+        if palette_platform:
+            platform["version"] = normalize_exact_version(palette_platform)
+        platforms.append(platform)
+    return platforms

{sima_cli-2.1.10 → sima_cli-2.1.11}/sima_cli/install/metadata_installer.py

@@ -28,6 +28,7 @@ from sima_cli.utils.disk import check_disk_space
 from sima_cli.utils.env import get_environment_type, get_exact_devkit_type, get_sima_build_version
 from sima_cli.download.downloader import download_file_from_url
 from sima_cli.install.metadata_validator import validate_metadata, MetadataValidationError
+from sima_cli.install.compatibility import version_matches
 from sima_cli.install.metadata_info import print_metadata_summary, parse_size_string_to_bytes
 from sima_cli.utils.container_registries import install_from_cr
 from sima_cli.install.registry import PackageRegistry
@@ -1114,6 +1115,19 @@ def _compare_versions(current: str, condition: str) -> bool:
         return cur <= target
     return False
 
+
+def _get_palette_sdk_version(release_file: Path = Path("/etc/sdk-release")) -> str:
+    try:
+        content = release_file.read_text(encoding="utf-8")
+    except OSError:
+        return ""
+
+    match = re.search(r"^SDK Version\s*=\s*(\S+)", content, flags=re.MULTILINE)
+    if not match:
+        return ""
+    return match.group(1).split("_", 1)[0].strip()
+
+
 def _is_platform_compatible(metadata: dict, force: bool = False) -> bool:
     """
     Determines if the current environment is compatible with the package metadata.
@@ -1169,7 +1183,17 @@ def _is_platform_compatible(metadata: dict, force: bool = False) -> bool:
     for platform_entry in platforms:
         platform_type = platform_entry.get("type")
         if (platform_type, env_type, env_subtype) == ("palette", "sdk", "palette"):
-            return True
+            compatible_palette_version = platform_entry.get("version", "")
+            if not compatible_palette_version:
+                return True
+            palette_sdk_version = _get_palette_sdk_version()
+            if palette_sdk_version and version_matches(palette_sdk_version, compatible_palette_version):
+                return True
+            click.echo(
+                f"❌ Palette SDK version {palette_sdk_version or 'unknown'} is not compatible. "
+                f"Required: {compatible_palette_version}"
+            )
+            continue
         if platform_type != env_type:
             continue
 
@@ -1179,10 +1203,10 @@ def _is_platform_compatible(metadata: dict, force: bool = False) -> bool:
             if env_subtype not in compat and exact_devkit_type not in compat:
                 continue
             else:
-                compatible_board_version = platform_entry.get('version', '')
-                # If version field exists in metadata then check if the board is running compatible version
+                compatible_board_version = platform_entry.get("version", "")
+                # If version field exists in metadata then check if the board is running compatible version.
                 if len(compatible_board_version) > 0:
-                    if board_ver == compatible_board_version:
+                    if board_ver and version_matches(board_ver, compatible_board_version):
                         return True
                 else:
                     # otherwise return true as it's generally compatible