[v0.1.2] 2025-09-18

🎉PyPI package distribution should now be working for all integrated plug-ins 🎉

*Enhanced Build System and GPU Runtime Detection*
- Added robust GPU runtime detection with fail-fast behavior and comprehensive error reporting
- Enhanced wheel building infrastructure with improved GitHub Actions workflows and timeout management
- **Build System**: Improved plugin dependency resolution with explicit user request tracking
- **Context API**: Enhanced error handling with consistent RuntimeError exceptions and better UUID validation
- **RadiationModel**: Expanded camera system integration with comprehensive GPU capability detection
- **Testing**: Added pytest markers for GPU-specific tests and enhanced cross-platform test coverage

Author: bnbailey-psl

.github/workflows/build-wheels.yml

@@ -45,7 +45,7 @@ jobs:
       - name: Build PyHelios with all plugins (GPU included)
         run: |
           # Build with all available plugins including GPU-accelerated ones
-          ./build_scripts/build_helios --clean --plugins radiation,visualizer,weberpenntree
+          ./build_scripts/build_helios --clean
       
       - name: Check plugin status
         run: |

.github/workflows/pytest-linux-gpu.yaml

@@ -23,17 +23,16 @@ jobs:
 
     - name: Install Helios dependencies
       run: |
-        cd helios-core
-        chmod +x utilities/dependencies.sh
-        bash utilities/dependencies.sh VIS
+        sudo apt-get update
+        sudo apt-get install -y libomp-dev libx11-dev xorg-dev libgl1-mesa-dev libglu1-mesa-dev libxrandr-dev python3-dev pybind11-dev
         
     - name: Install build dependencies only
       run: |
         python -m pip install --upgrade pip
         
     - name: Build native libraries
       run: |
-        python build_scripts/build_helios.py --buildmode release --plugins visualizer,weberpenntree --verbose
+        python build_scripts/build_helios.py --buildmode release --nogpu --verbose
         
     - name: Upload build artifacts
       uses: actions/upload-artifact@v4

.github/workflows/pytest-linux.yml

@@ -31,7 +31,7 @@ jobs:
         
     - name: Build native libraries
       run: |
-        python build_scripts/build_helios.py --buildmode release --plugins visualizer,weberpenntree --verbose
+        python build_scripts/build_helios.py --buildmode release --nogpu --verbose
         
     - name: Upload build artifacts
       uses: actions/upload-artifact@v4

.github/workflows/pytest-macos.yml

@@ -32,7 +32,7 @@ jobs:
       env:
         CMAKE_RC_COMPILER: ""
       run: |
-        python build_scripts/build_helios.py --buildmode release --plugins visualizer,weberpenntree --verbose
+        python build_scripts/build_helios.py --buildmode release --nogpu --verbose
         
     - name: Upload build artifacts
       uses: actions/upload-artifact@v4
@@ -67,7 +67,12 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -e .[dev]
-        
+        # Remove pytest-forked on Windows (doesn't support fork())
+        pip uninstall -y pytest-forked
+
     - name: Run pytest
       run: |
-        pytest -v
+        # Create Windows-compatible pytest.ini without --forked flag
+        (Get-Content pytest.ini) -replace '    --forked', '' | Set-Content pytest-windows.ini
+        # Run pytest with Windows-compatible configuration
+        pytest -c pytest-windows.ini -v

.github/workflows/pytest-windows.yml

@@ -2,6 +2,39 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## MANDATORY WORKFLOW - FOLLOW EVERY SESSION
+
+### 1. Start Every Session
+- **TodoWrite**: Create todo list for complex/multi-step tasks (3+ steps or non-trivial tasks)
+- **Memory Check**: Search memory for relevant prior knowledge using `mcp__memory__search_nodes`
+- **Sub-Agent Selection**: Choose appropriate sub-agent(s) based on task type (see Sub-Agents section)
+
+### 2. During Work
+- **TodoWrite**: Update progress frequently - mark tasks in_progress and completed immediately
+- **Memory Capture**: For any technical discoveries, solutions, or architectural insights, IMMEDIATELY document in memory using MCP tools
+
+### 3. End Every Session
+- **Memory Documentation**: MANDATORY - Create memory entities for:
+  - Technical issues discovered and their solutions
+  - Design decisions made or conventions established
+  - Architectural insights about PyHelios systems
+  - Integration patterns or debugging approaches
+- **TodoWrite**: Mark final tasks as completed, clean up stale items
+- **Verification**: Confirm all memory writes were successful
+
+### 4. Memory Guidelines
+**When to write memory (REQUIRED):**
+- New technical problems discovered and solved
+- Plugin integration insights or patterns
+- Testing architecture discoveries (like ctypes contamination)
+- Build system or configuration changes
+- Performance insights or optimization approaches
+
+**How to write memory:**
+- Use `mcp__memory__create_entities` with specific entityType (technical_issue, solution, architecture, etc.)
+- Create meaningful relations with `mcp__memory__create_relations`
+- Write detailed observations that future sessions can reference
+
 ## Sub-Agents
 
 - Make sure to familiarize yourself with the available sub-agents (@.claude/agents/) and use them efficiently:

CLAUDE.md

@@ -13,9 +13,15 @@ include pyproject.toml
 include requirements*.txt
 include pytest.ini
 
+# Include stub file for platform-specific wheels
+include pyhelios/_stub.c
+
 # Include native libraries that get built
 recursive-include pyhelios/plugins *.dll *.so *.dylib
 
+# Include PyHelios assets for wheel packaging
+recursive-include pyhelios/assets *
+
 # Exclude test and development files
 recursive-exclude tests *
 recursive-exclude .github *