Release v0.4.1: Core Stability, Type Refinery & Isolated Stochastic Engine

[rannd1nt]

Overview

Version 0.4.1 is a stabilization and refinement release. It addresses critical recursion bugs, tightens algebraic semantics, and introduces isolated state mechanics for stochastic physics alongside improved IDE type hinting.

Bug Fixes (Core Reliability)

• fix(base): resolve Ouroboros RecursionError via thread-local cycle detector.
• fix(base): enforce strict SemanticMismatchError on invert (~) for anonymous units.
• fix(dataset): fix f_locals stack depth and implement ragged boolean masking.
• fix(engine): inject active_context to .to() preventing Currency/Mach amnesia during conversions.
• fix(build): add missing packaging dependency to pyproject.toml.

Features & Refactors (DX & Stochastic Engine)

• refactor(typing): separated _typing.py from compat.py for cleaner dependency resolution.
• feat(typing): introduced comprehensive .pyi stub files for base and random to provide "Blue Variable" callable hints without polluting runtime code.
• feat(random): overhauled phaethon.random to use an isolated RandomState engine (default_rng).
• feat(random): added physics-aware discrete distributions and manipulations (randint, choice, shuffle, permutation).

Chore & Documentation

• chore(docs): synchronized .readthedocs.yaml and injected [imaging] dependency to restore og:image SEO social cards on RTD production.
• docs(compute): updated Scientific Compute documentation with comprehensive guides for the new stochastic engine and linear algebra properties.