feat: require Python 3.12

[Jammy2211]

Overview

Raise PyAutoLens's supported Python floor to 3.12 as the final core-library leg of the ecosystem migration. Keep optional-extra propagation and all behavior-driven dependency pins intact, while removing stale test commentary tied to the retired 3.9/3.10 matrix.

Plan

• Raise package metadata and classifiers to Python 3.12/3.13.
• Preserve the complete dependency and optional-extra structure unchanged.
• Update the repository floor contract and version-neutralize two optional-JAX skip explanations.
• Census metadata, CI, docs, source, and tests for remaining live below-floor support assumptions.
• Validate on Python 3.12 and 3.13, inspect built-wheel metadata, run the ecosystem smoke surface, and require independent review plus the Heart gate before shipping.

Detailed implementation plan

Affected Repositories

• PyAutoLens (primary)

Branch Survey

Repository	Current Branch	Dirty?
./PyAutoLens	main	clean

Suggested branch: feature/python-312-floor

Implementation Steps

1. Update pyproject.toml to require Python 3.12 and retain only the Python 3.12/3.13 classifiers. Do not alter dependencies, pins, or the jax, coolest, optional, docs, test, and dev extra topology.
2. Update AGENTS.md so the documented repository floor matches the package metadata.
3. In test_autolens/potential_correction/test_iterative_interferometer.py and test_fit_interferometer.py, retain the missing-JAX skip behavior but remove explanations tied to the retired Python 3.9/3.10 matrix; describe the actual optional-dependency condition instead.
4. Search live packaging, CI, docs, source, and tests for remaining pre-3.12 support claims or interpreter compatibility branches. Leave published JOSS papers and historical provenance untouched; leave coordinated release and final last-compatible pip wording to the existing Phase 3/6 tasks.
5. Run the full PyAutoLens suite on Python 3.12 and 3.13, build and inspect wheel metadata, then run the six-workspace smoke surface against the fully migrated local upstream chain.
6. Obtain Claude Opus 5 CLEAN and an admissible PyAutoHeart verdict on the exact tree before delegating mechanical shipping.

Key Files

• pyproject.toml — Python floor and classifiers.
• AGENTS.md — repository support guidance.
• test_autolens/potential_correction/test_iterative_interferometer.py — version-neutral optional-JAX test rationale.
• test_autolens/potential_correction/test_fit_interferometer.py — version-neutral optional-JAX test rationale.

Original Prompt

Click to expand starting prompt

Python 3.12 floor — Phase 1E: PyAutoLens

Type: feature
Target: PyAutoLens
Difficulty: small
Autonomy: supervised
Priority: high
Status: formalised

Parent: python_312_floor_phase_1_core.md
Depends on: python_312_floor_phase_1d_galaxy.md

Scope

In @PyAutoLens, raise metadata/classifiers to 3.12/3.13 and update the
AGENTS.md floor contract. Preserve optional-extra propagation and all
behavior-driven dependency pins. Validate on Python 3.12 and 3.13.

[Jammy2211]

Phase 1E validation checkpoint

• Product diff remains exactly four files: pyproject.toml, AGENTS.md, and two version-wording-only optional-JAX test comments/reasons. git diff --check passes.
• Live census is clean below 3.12. The only remaining pre-floor text is the protected historical JOSS paper and the coordinated-release installation wording owned by Phases 3/6.
• Python 3.12: 488 passed.
• Python 3.13: 488 passed.
• Wheel: Requires-Python: >=3.12; classifiers 3.12/3.13 only; dependencies and every extra remain unchanged.
• Six-workspace smoke: 61 pass, 3 configured skips, 0 failures, 1 timeout. The sole timeout is the previously accepted exact case autolens_workspace_test/imaging/subhalo_recovery.py; its isolated rerun also reached 300.13s with no traceback (only normal imaging output and the existing convolution warning). Euclid full_model.py passed concurrently in 169.47s.

Proceeding to immutable formal + Claude Opus review; no merge unless that exact reviewed tree remains unchanged and all PR checks are green.

[Jammy2211]

Independent review + Heart gate

• Immutable review head: 83b157014 (base 0612f3e0357b), byte-identical to the proposed four-file product tree.
• PyAuto formal ReviewSurface: 1 commit, 4 files, 9 insertions / 16 deletions; packaging/config risk inspected.
• Local Claude Opus 5, maximum effort: CLEAN. It parsed metadata, AST-compared both test files, verified the 3.12/3.13 thin CI callers, and found no missed live compatibility scaffolding. Its only note is the already-owned Phase 3/6 PyPI fallback-history item (PyAutoMind commit e2acf4a), explicitly not a defect of this diff.
• Refreshed PyAutoHeart: YELLOW 65, no RED, and the exact acknowledged launch set is unchanged (13 historical workspace failures; 33 stale parked scripts; 6 manifest mismatches; release rehearsal stale after the migrated library heads).

Ship is authorized under the campaign contract. The implementation commit must reproduce review tree 83b157014 exactly; merge remains gated on unchanged PR head plus every GitHub check green.

[Jammy2211]

Phase 1E merged

• PR: feat: require Python 3.12 #664
• Reviewed/merged implementation head: 5b42f3e42667ef13c8610469775ec7fc6b559742
• Merge commit: b40fb0ba6281eb868151f76226f5420a08ba44e7
• Final gate: Claude Opus 5 CLEAN on tree-identical review commit 83b157014; all 5 GitHub checks green (docs plus duplicate push/PR Python 3.12 and 3.13 jobs); server-side head unchanged at merge.
• Canonical PyAutoLens main fast-forwarded clean to the merge commit.

Issue #663 remains open by policy; issue closure is a separate explicit human action. No release was performed.

[Jammy2211]

Phase 1E merged unchanged as PyAutoLens#664 (b40fb0b), CI 5/5 green on the reviewed head. python-312-floor arc complete (record: PyAutoMind/complete/2026/07/python-312-floor.md; parent PyAutoNerves#142 closed). Closing on the same 2026-07-30 human cleanup authorization.