refactor: framework updates and structure enhancements

.github/workflows/cd.yaml

@@ -28,14 +28,19 @@ jobs:
         run: |
           git checkout -B ${{ github.ref_name }} ${{ github.sha }}
 
+      - name: Setup | Install tomli_w for sync_dependencies.py
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install --upgrade tomli_w  # sync script uses tomllib+tomli_w
+
       - name: Setup | Sync Dependencies
         run: |
-          python -m pip install --upgrade toml
           python scripts/sync_dependencies.py
 
+      # Upgraded python-semantic-release v9.12.0 -> v10.6.1
       - name: Action | Semantic Version Release
         id: release
-        uses: python-semantic-release/python-semantic-release@v9.12.0
+        uses: python-semantic-release/python-semantic-release@v10.6.1
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           git_committer_name: "github-actions"
@@ -55,8 +60,10 @@ jobs:
         with:
             password: ${{ secrets.PYPI_API_TOKEN }}
 
+      # Upgraded python-semantic-release/publish-action v9.8.9 -> v10.6.1
+      # Kept in lock-step with the main semantic-release action (same major version).
       - name: Publish | Upload to GitHub Release Assets
-        uses: python-semantic-release/publish-action@v9.8.9
+        uses: python-semantic-release/publish-action@v10.6.1
         if: steps.release.outputs.released == 'true'
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/tests.yaml

@@ -13,18 +13,21 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]  # Updated
 
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5 
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        python -m pip install flake8 pytest
+        # Pin flake8 and pytest versions so CI lint behavior is reproducible.
+        # flake8>=7.1.2: E9/F63/F7/F82 rules used below stable across 7.x line.
+        # pytest>=9.0.3 matches the dev extra pin in pyproject.toml.
+        python -m pip install "flake8>=7.1.2,<8" "pytest>=9.0.3,<10"
         if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
     - name: Lint with flake8
       run: |

primisai/__init__.py

@@ -1 +1,19 @@
+import logging as _logging
+
 __version__ = "0.8.1"
+
+_logger = _logging.getLogger("primisai")
+if not _logger.handlers:
+    _handler = _logging.StreamHandler()
+    _handler.setFormatter(
+        _logging.Formatter("%(name)s — %(levelname)s — %(message)s")
+    )
+    _logger.addHandler(_handler)
+    if _logger.level == _logging.NOTSET:
+        _logger.setLevel(_logging.INFO)
+    # Make sure sub-loggers (e.g. "primisai.nexus.core.supervisor") propagate
+    # up to this handler instead of being lost.
+    _logger.propagate = False
+del _handler
+del _logger
+del _logging