Pumas Library v0.4.0

Pumas Library 0.4.0 is a reliability and platform-hardening release focused on
making the desktop app, launcher workflows, bindings, and core library behavior much more dependable across Linux, Windows, and macOS.

Compared with 0.3.0, this release brings a stronger cross-platform desktop
workflow, a more resilient model-library core, better packaging and update
behavior, and significantly improved CI and contributor ergonomics.

Highlights

• Added a shared cross-platform launcher core for Bash and PowerShell with one
  consistent lifecycle contract
• Added bounded --release-smoke verification for release-facing desktop startup checks
• Added GitHub release detection and download prompts in the desktop updater flow
• Added packaged-app recovery for missing library detection, including persistent
• library-root selection
• Added C# UniFFI smoke coverage and packaging scripts for native/bindings
  release artifacts

Core Library Improvements

• Improved primary/client dispatch behavior so multiple processes can share one library more safely
• Hardened reconciliation and startup behavior to reduce unnecessary churn, stale
  state, and repair loops
• Improved canonical path handling and library-root normalization across
  platforms
• Improved model classification, task projection, and binding authority handling
• Added persisted metadata evidence to make download placement and local
  reclassification more reliable
• Added migration dry-run and audit tooling for library maintenance and metadata
  inspection

Desktop and Frontend Improvements

• Refined the desktop shell with better default window sizing and header behavior
• Improved packaged desktop startup and launcher-root discovery behavior
• Expanded model metadata editing and notes support
• Improved import, migration-report, mapping-preview, download, and version-
  management flows
• Refactored large frontend surfaces into smaller components and hooks with
  substantially better test coverage

Tooling, Packaging, and CI

• Moved workspace tooling to a pinned pnpm/Corepack ownership model
• Modernized CI bootstrap and workflow behavior for current GitHub Actions/
  runtime expectations
• Added stronger launcher verification paths in CI, including release-smoke
  coverage
• Improved release packaging for desktop artifacts and generated native/bindings
  artifacts
• Updated contributor, launcher, release, and repo documentation to reflect the
  current architecture and workflows

Stability Fixes

• Fixed UniFFI download request drift that was breaking pumas-uniffi builds
• Fixed Linux CI Electron startup issues under sandboxed runners
• Fixed macOS and Windows path-identity issues in Rust test expectations
• Fixed registry/test isolation issues that caused cross-test interference
• Fixed packaged-launch and shortcut issues that could break release usability
• Fixed Tokio example runtime configuration so documented examples compile with
  the pinned workspace features

Change Scope

From v0.3.0 to v0.4.0, the codebase changed substantially:

• 270 files changed
• 42,127 insertions
• 25,827 deletions

This release is less about one single headline feature and more about making
Pumas Library feel like a more coherent, release-ready platform: better startup
behavior, better desktop packaging, better update paths, stronger bindings
validation, and more trustworthy cross-platform workflows.