chore: finalize Python 3.12 development baseline

Author: vib-tools

.github/CONTRIBUTING.md

@@ -32,7 +32,7 @@ must not be implemented before their ADR or formal approval is complete.
 
 The documented baseline uses:
 
-- Python 3.13+
+- Python 3.12+
 - PySide6
 - uv
 - Hatchling

.github/SUPPORT.md

@@ -26,7 +26,7 @@ The project cannot guarantee support for:
 
 - unpublished or modified forks;
 - unapproved dependencies or architectures;
-- Python versions below 3.13;
+- Python versions below 3.12;
 - unofficial binary distributions;
 - issues without reproducible evidence;
 - production use before a stable release.

.github/workflows/quality.yml

@@ -15,7 +15,7 @@ concurrency:
 
 jobs:
   quality:
-    name: Python 3.13 quality gate
+    name: Python 3.12 quality gate
     runs-on: ubuntu-latest
     timeout-minutes: 30
 
@@ -26,7 +26,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.13"
+          python-version: "3.12"
 
       - name: Set up uv
         uses: astral-sh/setup-uv@v6

.gitignore

@@ -12,6 +12,9 @@ venv/
 env/
 .python-version
 
+# Local replacement and export archives
+/*.zip
+
 # Build and package artifacts
 /build/
 /dist/

CHANGELOG.md

@@ -33,6 +33,9 @@ policy.
 
 ### Fixed
 
+- Normalized the Python 3.12 baseline to the configured Black style, scoped Ruff
+  subprocess exceptions to controlled scripts and tests, ignored local root ZIP exports,
+  and suppressed the non-fatal Windows uv hardlink warning.
 - Replaced zero-byte documentation and repository metadata placeholders with usable
   baseline content.
 - Removed 20 invalid AI renderer citation artifacts from ADR-002, ADR-003 and ADR-004
@@ -91,3 +94,18 @@ No public release was created. Version `0.0.0` remains pre-development metadata.
 - No approved Step 4 file was missing or content-modified in the uploaded replacement.
 - The cleaned tree matched Step 4 exactly before Step 5 changes.
 - No public release was created; package version remains `0.0.0`.
+
+
+## Python 3.12 Baseline Amendment — 2026-07-31
+
+### Changed
+
+- Added ADR-022 and lowered the minimum supported Python runtime from 3.13 to 3.12.
+- Updated package metadata, bootstrap checks, CI, static-analysis targets and documentation.
+- Preserved the historical ADR-001 and ADR-005 decisions with explicit supersession notices.
+- Amended the frozen baseline identifier to `VIBRIX-PREDEV-BASELINE-2026-07-31-PY312`.
+
+### Verification
+
+- No framework feature or public API was added.
+- Canonical structure, import boundaries, forensic invariants, tests and package selection remain unchanged.

CODE_STYLE.md

@@ -6,7 +6,7 @@ workspace.
 
 ## Python Baseline
 
-- Python 3.13 or newer
+- Python 3.12 or newer
 - UTF-8 encoding
 - LF line endings
 - Four spaces for indentation; tabs are not allowed

COMPATIBILITY.md

@@ -9,7 +9,7 @@ baseline, not a guarantee for a published stable release.
 
 | Area | Current Baseline |
 |---|---|
-| Python | 3.13 or newer |
+| Python | 3.12 or newer |
 | UI framework | PySide6 / Qt 6 |
 | Primary operating systems | Windows 10 and Windows 11 |
 | Linux | Future evaluation; not currently guaranteed |
@@ -40,7 +40,7 @@ versions or dependencies.
 
 The project does not currently guarantee:
 
-- Python versions below 3.13;
+- Python versions below 3.12;
 - PyQt, CustomTkinter or other replacement UI foundations;
 - unofficial forks or modified binary distributions;
 - 32-bit targets;

FAQ.md

@@ -18,7 +18,7 @@ announced and documented.
 
 ## Which Python version is required?
 
-The approved baseline is Python 3.13 or newer.
+The approved baseline is Python 3.12 or newer.
 
 ## Which operating systems are supported?
 

README.md

@@ -403,7 +403,7 @@ Vibrix is built entirely on modern, stable and production-ready technologies.
 
 | Layer                | Technology              |
 | -------------------- | ----------------------- |
-| Programming Language | Python 3.13+            |
+| Programming Language | Python 3.12+            |
 | UI Framework         | PySide6 (Qt for Python) |
 | GUI Engine           | Qt 6                    |
 | Icons                | QtAwesome               |
@@ -1083,7 +1083,7 @@ Every source file follows the same engineering standards.
 
 Vibrix adopts:
 
-- Python 3.13+
+- Python 3.12+
 - PEP 8
 - PEP 257
 - Type Hints
@@ -1309,7 +1309,7 @@ pip install vibrix
 
 | Requirement      | Version             |
 | ---------------- | ------------------- |
-| Python           | 3.13+               |
+| Python           | 3.12+               |
 | Qt               | Qt 6                |
 | UI Framework     | PySide6             |
 | Operating System | Windows _(Primary)_ |
@@ -1327,7 +1327,7 @@ Vibrix has completed its controlled pre-development reconciliation and frozen th
 - ✅ Framework vision and philosophy documented
 - ✅ Step 1: missing public, governance and repository documents restored
 - ✅ Step 2: documentation status, index coverage and broken reference artifacts reconciled
-- ✅ Accepted ADR-001 through ADR-021 preserved and architecture baseline reconciled
+- ✅ Accepted ADR-001 through ADR-022 preserved and architecture baseline reconciled
 - ✅ Design and runtime specifications inventoried
 
 ---
@@ -1722,8 +1722,8 @@ only after clean replacement and the mandatory online bootstrap and quality gate
 
 The clean repository tree, all Steps 1–4 changes, documentation index, ADR sequence,
 architecture boundaries, package skeleton, tests, archive safety and reference-image
-inventory were re-audited. Baseline `VIBRIX-PREDEV-BASELINE-2026-07-31` is frozen.
+inventory were re-audited. Baseline `VIBRIX-PREDEV-BASELINE-2026-07-31-PY312` is frozen.
 
-The first implementation task requires a clean baseline replacement, online `uv lock`,
+ADR-022 sets Python 3.12+ as the minimum runtime. The first implementation task requires a clean baseline replacement, online `uv lock`,
 frozen environment sync, complete quality gate and verified package build. The project is
 still version `0.0.0` and is not a stable or supported public release.

ROADMAP.md

@@ -11,6 +11,7 @@ roadmap describes sequence and quality gates; it does not promise release dates.
 - [x] Complete ADR-007 through ADR-021 — Step 3 completed.
 - [x] Establish canonical build, test and CI baseline — Step 4 completed.
 - [x] Perform a second forensic review and freeze an updated baseline — Step 5 completed.
+- [x] Adopt Python 3.12+ through ADR-022 and baseline amendment.
 
 **Exit gate:** one authoritative, internally consistent development baseline.