feat: workspace version check — compatibility floor + staleness warning (R2)

[Jammy2211]

Overview

R2 of the version-pinning design review (PyAutoLabs/PyAutoBuild#118; task issue #118). check_version() now enforces a compatibility floor instead of exact equality: it raises only when the installed library is older than the minimum version the workspace requires, warns (never raises) when the workspace clone looks stale, and never advises exact == pins (which can point at yanked releases).

Issue: #118 · Design review: PyAutoLabs/PyAutoBuild#118

API Changes

• Behavioral, not structural. check_version(library_version, workspace_root=None) signature and WorkspaceVersionMismatchError are unchanged; downstream import-time calls in autofit/autogalaxy/autolens need no edits.
• New optional workspace config key version.minimum_library_version (floor, bumped deliberately when workspace scripts start needing new API). Legacy version.workspace_version / version.txt are reinterpreted as floors.
• Semantics loosened in one direction only: installed newer than the record now passes (with a git pull warning beyond a 30-day gap) instead of raising; installed older than the floor still raises. Unparseable versions (dev installs) warn instead of raising.
• Advice text rewritten: pip install --upgrade <pkg> / workspace release-tag checkout / bypasses — no == pins anywhere.

Test Results

• test_autoconf/: 117 passed (20 workspace-check tests, 7 new: floor pass/raise, key precedence, 30-day staleness window, unparseable in both directions, no-pin advice).
• Scenario probe: today's real-world broken case (installed 2026.5.29.4, workspace main recording yanked 2026.7.6.649) still correctly raises — the fix for that is the R1 release realignment; the previously-fatal old-clone/newer-library case passes silently; a 60-day gap warns once.

Ship gate

Supervised --auto run; maintainer sign-off + Heart YELLOW acknowledgement (6 reasons: workspace validation not passing / 58 stale parked scripts / autolens_assistant pinned behind / install verification not run / no release validation for current source / PyAutoMind open PR 9d old) given in-session on 2026-07-08 ("continue --auto" following the surfaced sign-off summary).

Downstream

• No workspace edits needed for this to merge; adoption of minimum_library_version in workspace general.yamls is a queued follow-up.
• feat: release stamping slim — wheels+tags only, no daily bump commits (R3-core) PyAutoBuild#120 (release stamping slim) is merge-gated behind this PR so the release that stops writing workspace pins also ships floor semantics.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WGkd3Jf7tjNpWqeU27aShB