Skip to main content

Release Notes 1.0.2

Release date: 2026-04-19

Highlights​

  • Model-by-model capability handling is more explicit and more trustworthy across the families touched on this branch.
  • Branch-wide strict typing debt was driven to zero without leaning on suppressions.
  • The macOS build contract is now explicit: uv is the runtime path, and Nix is the tooling and validation path.

Model Support And Runtime Notes​

  • Added explicit runtime notes and public behavior docs for DeepSeek V3.2.
  • Promoted DeepSeek V3.2 trusted quantizations from implicit family fallback behavior to explicit declared model-card support.
  • Landed thinking/runtime support work across GPT-OSS, Nemotron, Qwen 3.5, Llama Nemotron Nano, and Gemma 4 on this branch.

Reliability And Typing​

  • Reduced branch-wide basedpyright to 0 errors.
  • Tightened production typing around API config handling, model optimization, MLX generation, native vision, parser chaining, and warmup behavior.
  • Reworked unrealistic tests to use more faithful typed helpers and test doubles instead of relying on loose Any-shaped assumptions.
  • Fixed a real download-path regression and a Python/Rust NetworkingHandle constructor compatibility issue surfaced by full validation.

Build And Tooling​

  • Removed the stale Darwin Nix MLX source-build override that no longer matched Skulk's official uv runtime path.
  • Documented that Skulk's macOS runtime follows the official mlx + mlx-metal wheel stack under uv.
  • Kept Nix for reproducible nix fmt, nix develop, and nix flake check workflows.

UI And Docs​

  • Updated the README logo image.
  • Added build/runtime documentation so the uv versus Nix responsibilities are clear.
  • Introduced a release-notes workflow for Skulk going forward, with both a repo changelog and public docs entry.

Validation Snapshot​

  • uv run basedpyright passed with 0 errors, 0 warnings, 0 notes
  • uv run ruff check passed
  • uv run pytest passed with 516 passed, 1 skipped, 158 deselected
  • nix fmt ran successfully after the Nix/uv unification changes
  • nix flake show --no-write-lock-file now evaluates cleanly on Apple Silicon with the unified contract