Skip to content

fix(env): revert Docker base to python:3.12 + sync stale 260->263 in CI#13

Merged
MarwaBS merged 1 commit intomainfrom
fix/env-divergence-py312-revert
Apr 20, 2026
Merged

fix(env): revert Docker base to python:3.12 + sync stale 260->263 in CI#13
MarwaBS merged 1 commit intomainfrom
fix/env-divergence-py312-revert

Conversation

@MarwaBS
Copy link
Copy Markdown
Owner

@MarwaBS MarwaBS commented Apr 20, 2026

Two related fixes shipped together:

  1. Reverts the Dependabot-merged Docker base bump from python:3.14 to python:3.12-slim-bookworm. Reason: Step 5 architectural rule chore(ci): bump actions/checkout from 4 to 6 #3 ("what is tested locally = what runs in prod") was broken by the bump — CI test job pins PYTHON_VERSION="3.12" while the production Docker image was running 3.14. Tests would not have caught a future 3.14-only regression. Python 3.14 is brand-new (Oct 2025); conservative choice for a portfolio project is to track 3.12 in both surfaces until 3.14 is the enterprise norm. Aligns with the sibling portfolio projects which also pin 3.12.

  2. Updates two stale "260-test suite" / "260 hermetic tests" comments in .github/workflows/ci.yml to "263" — the actual current count after the README-rewrite PR added 2 new section-heading tests. Same kind of stale-string we caught in the UI footer earlier.

Risk removed: env divergence between CI and prod (the kind of bug that ships silently and only surfaces when a 3.14-specific issue appears, by which point CI confidence is already broken).

Future: when the 3.14 Dependabot PR re-opens, close it with a comment explaining the env-pin policy until 3.14 is mainstream.

Tests: 263 still passing locally.

Two related fixes shipped together:

1. Reverts the Dependabot-merged Docker base bump from python:3.14 to
   python:3.12-slim-bookworm. Reason: Step 5 architectural rule #3
   ("what is tested locally = what runs in prod") was broken by the
   bump — CI test job pins PYTHON_VERSION="3.12" while the production
   Docker image was running 3.14. Tests would not have caught a
   future 3.14-only regression. Python 3.14 is brand-new (Oct 2025);
   conservative choice for a portfolio project is to track 3.12 in
   both surfaces until 3.14 is the enterprise norm. Aligns with the
   sibling portfolio projects which also pin 3.12.

2. Updates two stale "260-test suite" / "260 hermetic tests" comments
   in .github/workflows/ci.yml to "263" — the actual current count
   after the README-rewrite PR added 2 new section-heading tests.
   Same kind of stale-string we caught in the UI footer earlier.

Risk removed: env divergence between CI and prod (the kind of bug
that ships silently and only surfaces when a 3.14-specific issue
appears, by which point CI confidence is already broken).

Future: when the 3.14 Dependabot PR re-opens, close it with a comment
explaining the env-pin policy until 3.14 is mainstream.

Tests: 263 still passing locally.
@MarwaBS MarwaBS merged commit 7f744ee into main Apr 20, 2026
12 checks passed
@MarwaBS MarwaBS deleted the fix/env-divergence-py312-revert branch April 20, 2026 00:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant