feat: Add version metadata to engines and improve version parsing

- Add version, required_core_version, and required_sdk_version to all engines (cx_freeze, nuitka, pyinstaller)
- Improve parse_version() to support '1.0.0+' format (+ means 'or higher')
- Support multiple version formats: '1.0.0', '1.0.0+', '1.0.0-beta', '1.0.0+build123'
- Update bcasl validator and Base.py with improved version parsing
- Clarify version compatibility semantics (>= greater than or equal)
- All compatibility checks now use consistent >= semantics across engines and plugins

Author: PyCompiler ARK++

Core/engines_loader/validator.py

@@ -39,9 +39,29 @@ class EngineCompatibilityCheckResult:
 
 
 def parse_version(version_string: str) -> Tuple[int, int, int]:
-    """Parse a version string into (major, minor, patch)."""
+    """
+    Parse a version string into (major, minor, patch).
+    
+    Supports formats:
+    - "1.0.0" -> (1, 0, 0)
+    - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+    - "1.0.0-beta" -> (1, 0, 0)
+    - "1.0.0+build123" -> (1, 0, 0)
+    """
     try:
-        parts = version_string.strip().split("+")[0].split("-")[0].split(".")
+        # Remove leading/trailing whitespace
+        s = version_string.strip()
+        
+        # Handle "1.0.0+" format (+ at the end means "or higher")
+        # We just strip it since our comparison logic already uses >= semantics
+        if s.endswith("+"):
+            s = s[:-1].strip()
+        
+        # Remove build metadata and pre-release identifiers
+        s = s.split("+")[0].split("-")[0]
+        
+        # Parse major.minor.patch
+        parts = s.split(".")
         major = int(parts[0]) if len(parts) > 0 else 0
         minor = int(parts[1]) if len(parts) > 1 else 0
         patch = int(parts[2]) if len(parts) > 2 else 0
@@ -57,6 +77,10 @@ def check_engine_compatibility(
 ) -> EngineCompatibilityCheckResult:
     """
     Check if an engine is compatible with the current system versions.
+    
+    Compatibility check uses >= (greater than or equal) semantics:
+    - If engine requires Core 1.0.0, it accepts Core 1.0.0, 1.0.1, 1.1.0, 2.0.0, etc.
+    - If engine requires SDK 1.0.0, it accepts SDK 1.0.0, 1.0.1, 1.1.0, 2.0.0, etc.
 
     Args:
         engine_class: CompilerEngine class
@@ -74,15 +98,15 @@ def check_engine_compatibility(
     required_core_version = getattr(engine_class, "required_core_version", "1.0.0")
     required_sdk_version = getattr(engine_class, "required_sdk_version", "1.0.0")
 
-    # Check Core compatibility
+    # Check Core compatibility: current >= required (accept equal or higher versions)
     current_core = parse_version(core_version)
     required_core = parse_version(required_core_version)
     if current_core < required_core:
         missing_requirements.append(
             f"Core >= {required_core_version} (current: {core_version})"
         )
 
-    # Check Engine SDK compatibility
+    # Check Engine SDK compatibility: current >= required (accept equal or higher versions)
     current_sdk = parse_version(engine_sdk_version)
     required_sdk = parse_version(required_sdk_version)
     if current_sdk < required_sdk:

ENGINES/cx_freeze/engine.py

@@ -36,6 +36,9 @@
 class CxFreezeEngine(CompilerEngine):
     id = "cx_freeze"
     name = "cx_Freeze"
+    version: str = "1.0.0"
+    required_core_version: str = "1.0.0"
+    required_sdk_version: str = "1.0.0"
 
     def _resolve_venv_root(self, gui) -> Optional[str]:
         try:

ENGINES/nuitka/engine.py

@@ -35,6 +35,9 @@
 class NuitkaEngine(CompilerEngine):
     id = "nuitka"
     name = "Nuitka"
+    version: str = "1.0.0"
+    required_core_version: str = "1.0.0"
+    required_sdk_version: str = "1.0.0"
 
     def preflight(self, gui, file: str) -> bool:
         # System deps (engine-owned)

ENGINES/pyinstaller/engine.py

@@ -34,6 +34,9 @@
 class PyInstallerEngine(CompilerEngine):
     id = "pyinstaller"
     name = "PyInstaller"
+    version: str = "1.0.0"
+    required_core_version: str = "1.0.0"
+    required_sdk_version: str = "1.0.0"
 
     def _resolve_venv_root(self, gui) -> Optional[str]:
         try:

bcasl/Base.py

@@ -171,6 +171,12 @@ def get_compatibility_info(self) -> dict[str, str]:
     def is_compatible_with_bcasl(self, bcasl_version: str) -> bool:
         """Check if plugin is compatible with given BCASL version.
         
+        Supports version formats:
+        - "1.0.0" -> (1, 0, 0)
+        - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+        - "1.0.0-beta" -> (1, 0, 0)
+        - "1.0.0+build123" -> (1, 0, 0)
+        
         Args:
             bcasl_version: BCASL version string to check against
             
@@ -179,7 +185,11 @@ def is_compatible_with_bcasl(self, bcasl_version: str) -> bool:
         """
         def parse_version(v: str) -> tuple:
             try:
-                parts = v.strip().split("+")[0].split("-")[0].split(".")
+                s = v.strip()
+                if s.endswith("+"):
+                    s = s[:-1].strip()
+                s = s.split("+")[0].split("-")[0]
+                parts = s.split(".")
                 major = int(parts[0]) if len(parts) > 0 else 0
                 minor = int(parts[1]) if len(parts) > 1 else 0
                 patch = int(parts[2]) if len(parts) > 2 else 0
@@ -194,6 +204,12 @@ def parse_version(v: str) -> tuple:
     def is_compatible_with_core(self, core_version: str) -> bool:
         """Check if plugin is compatible with given Core version.
         
+        Supports version formats:
+        - "1.0.0" -> (1, 0, 0)
+        - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+        - "1.0.0-beta" -> (1, 0, 0)
+        - "1.0.0+build123" -> (1, 0, 0)
+        
         Args:
             core_version: Core version string to check against
             
@@ -202,7 +218,11 @@ def is_compatible_with_core(self, core_version: str) -> bool:
         """
         def parse_version(v: str) -> tuple:
             try:
-                parts = v.strip().split("+")[0].split("-")[0].split(".")
+                s = v.strip()
+                if s.endswith("+"):
+                    s = s[:-1].strip()
+                s = s.split("+")[0].split("-")[0]
+                parts = s.split(".")
                 major = int(parts[0]) if len(parts) > 0 else 0
                 minor = int(parts[1]) if len(parts) > 1 else 0
                 patch = int(parts[2]) if len(parts) > 2 else 0
@@ -217,6 +237,12 @@ def parse_version(v: str) -> tuple:
     def is_compatible_with_plugins_sdk(self, sdk_version: str) -> bool:
         """Check if plugin is compatible with given Plugins SDK version.
         
+        Supports version formats:
+        - "1.0.0" -> (1, 0, 0)
+        - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+        - "1.0.0-beta" -> (1, 0, 0)
+        - "1.0.0+build123" -> (1, 0, 0)
+        
         Args:
             sdk_version: Plugins SDK version string to check against
             
@@ -225,7 +251,11 @@ def is_compatible_with_plugins_sdk(self, sdk_version: str) -> bool:
         """
         def parse_version(v: str) -> tuple:
             try:
-                parts = v.strip().split("+")[0].split("-")[0].split(".")
+                s = v.strip()
+                if s.endswith("+"):
+                    s = s[:-1].strip()
+                s = s.split("+")[0].split("-")[0]
+                parts = s.split(".")
                 major = int(parts[0]) if len(parts) > 0 else 0
                 minor = int(parts[1]) if len(parts) > 1 else 0
                 patch = int(parts[2]) if len(parts) > 2 else 0
@@ -240,6 +270,12 @@ def parse_version(v: str) -> tuple:
     def is_compatible_with_bc_plugin_context(self, context_version: str) -> bool:
         """Check if plugin is compatible with given BcPluginContext version.
         
+        Supports version formats:
+        - "1.0.0" -> (1, 0, 0)
+        - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+        - "1.0.0-beta" -> (1, 0, 0)
+        - "1.0.0+build123" -> (1, 0, 0)
+        
         Args:
             context_version: BcPluginContext version string to check against
             
@@ -248,7 +284,11 @@ def is_compatible_with_bc_plugin_context(self, context_version: str) -> bool:
         """
         def parse_version(v: str) -> tuple:
             try:
-                parts = v.strip().split("+")[0].split("-")[0].split(".")
+                s = v.strip()
+                if s.endswith("+"):
+                    s = s[:-1].strip()
+                s = s.split("+")[0].split("-")[0]
+                parts = s.split(".")
                 major = int(parts[0]) if len(parts) > 0 else 0
                 minor = int(parts[1]) if len(parts) > 1 else 0
                 patch = int(parts[2]) if len(parts) > 2 else 0
@@ -263,6 +303,12 @@ def parse_version(v: str) -> tuple:
     def is_compatible_with_general_context(self, context_version: str) -> bool:
         """Check if plugin is compatible with given GeneralContext version.
         
+        Supports version formats:
+        - "1.0.0" -> (1, 0, 0)
+        - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+        - "1.0.0-beta" -> (1, 0, 0)
+        - "1.0.0+build123" -> (1, 0, 0)
+        
         Args:
             context_version: GeneralContext version string to check against
             
@@ -271,7 +317,11 @@ def is_compatible_with_general_context(self, context_version: str) -> bool:
         """
         def parse_version(v: str) -> tuple:
             try:
-                parts = v.strip().split("+")[0].split("-")[0].split(".")
+                s = v.strip()
+                if s.endswith("+"):
+                    s = s[:-1].strip()
+                s = s.split("+")[0].split("-")[0]
+                parts = s.split(".")
                 major = int(parts[0]) if len(parts) > 0 else 0
                 minor = int(parts[1]) if len(parts) > 1 else 0
                 patch = int(parts[2]) if len(parts) > 2 else 0

bcasl/validator.py

@@ -42,9 +42,29 @@ class CompatibilityCheckResult:
 
 
 def parse_version(version_string: str) -> Tuple[int, int, int]:
-    """Parse a version string into (major, minor, patch)."""
+    """
+    Parse a version string into (major, minor, patch).
+    
+    Supports formats:
+    - "1.0.0" -> (1, 0, 0)
+    - "1.0.0+" -> (1, 0, 0) [+ means "or higher"]
+    - "1.0.0-beta" -> (1, 0, 0)
+    - "1.0.0+build123" -> (1, 0, 0)
+    """
     try:
-        parts = version_string.strip().split("+")[0].split("-")[0].split(".")
+        # Remove leading/trailing whitespace
+        s = version_string.strip()
+        
+        # Handle "1.0.0+" format (+ at the end means "or higher")
+        # We just strip it since our comparison logic already uses >= semantics
+        if s.endswith("+"):
+            s = s[:-1].strip()
+        
+        # Remove build metadata and pre-release identifiers
+        s = s.split("+")[0].split("-")[0]
+        
+        # Parse major.minor.patch
+        parts = s.split(".")
         major = int(parts[0]) if len(parts) > 0 else 0
         minor = int(parts[1]) if len(parts) > 1 else 0
         patch = int(parts[2]) if len(parts) > 2 else 0