docs: python3=3.11 default (3.12 available) + image-render on FreeBSD #10

Merged
clawdie merged 3 commits from docs/python-coexistence-pillow into main 2026-06-21 10:14:44 +02:00
Owner

Aligns the toolchain + capability docs with the operator decision to make python3 = 3.11 (FreeBSD's PYTHON_DEFAULT), with python3.12 available for apps needing newer. Pillow then just works on python3 (py311-pillow), so the prior 3.12-floor / py312-pillow explanation collapses.

  • TOOLCHAIN.md: table + decision flipped to 3.11-default and trimmed (supersedes the 17.jun.2026 3.12-floor decision).
  • CAPABILITY-ROUTING.md: trimmed the Pillow rationale; image-render/screenshot on the FreeBSD operator image via py311-pillow (clawdie-iso #85).
  • HOST-MATRIX.md: trimmed the operator-image note.

prettier + layered_soul validate clean.

🤖 Generated with Claude Code

Aligns the toolchain + capability docs with the operator decision to make `python3` = **3.11** (FreeBSD's `PYTHON_DEFAULT`), with `python3.12` available for apps needing newer. Pillow then just works on `python3` (`py311-pillow`), so the prior 3.12-floor / py312-pillow explanation collapses. - **TOOLCHAIN.md:** table + decision flipped to 3.11-default and trimmed (supersedes the 17.jun.2026 3.12-floor decision). - **CAPABILITY-ROUTING.md:** trimmed the Pillow rationale; image-render/screenshot on the FreeBSD operator image via py311-pillow (clawdie-iso #85). - **HOST-MATRIX.md:** trimmed the operator-image note. prettier + layered_soul validate clean. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
clawdie added 1 commit 2026-06-21 09:44:57 +02:00
Reconcile the toolchain + capability docs with clawdie-iso #84 (FreeBSD
PYTHON_DEFAULT=3.11):

- TOOLCHAIN.md: the FreeBSD column claimed `py312-*` flavors; reality is
  python312 (app) + python311 (pkg default, transitive), with py311-* prebuilt
  and py312-* absent in the quarterly repo. Added the 3.11/3.12 coexistence note
  ("3.12 floor" = floor for our code, not a ban on the base's 3.11).
- CAPABILITY-ROUTING.md: corrected the imprecise "Pillow dropped on FreeBSD"
  rationale. The blocker was the missing py312-pillow flavor, not Pillow itself;
  the prebuilt py311-pillow is available, so image-render can be restored on
  FreeBSD via 3.11. Clarified screenshot also needs a display (XFCE operator
  image yes, headless osa no → image-render only there).

prettier + layered_soul validate clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
claude-domedog added 1 commit 2026-06-21 09:58:58 +02:00
Follow-on to clawdie-iso #85 (py311-pillow + join-hive capability detection):
the operator image now advertises image-render and screenshot, so the
capability is no longer Linux/domedog-only. Update the CAPABILITY-ROUTING worked
example and the HOST-MATRIX capability note accordingly.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
claude-domedog added 1 commit 2026-06-21 10:12:38 +02:00
Per operator decision: stop fighting FreeBSD's PYTHON_DEFAULT=3.11 — python3 is
3.11 everywhere, python3.12 stays available for apps needing newer. This makes
Pillow trivial (py311-pillow imports on python3), so the prior "3.12 floor +
py312-pillow absent + run on 3.11 explicitly" explanation collapses.

- TOOLCHAIN.md: table row + decision section flipped to 3.11-default and cut to a
  few lines (supersedes the 17.jun.2026 "3.12 floor" decision); symlink note now
  says build.sh points python3 at 3.11.
- CAPABILITY-ROUTING.md: trimmed the osa line + worked example — image-render via
  py311-pillow on python3, no version gymnastics.
- HOST-MATRIX.md: trimmed the operator-image image-render/screenshot note.

prettier + layered_soul validate clean. Dates in edited blocks use EU format.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
clawdie changed title from docs: python 3.11/3.12 coexistence + correct Pillow rationale to docs: python3=3.11 default (3.12 available) + image-render on FreeBSD 2026-06-21 10:13:56 +02:00
clawdie merged commit e2395c691a into main 2026-06-21 10:14:44 +02:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: clawdie/layered-soul#10
No description provided.