Skip to content

feat(arch): add Flatcar-to-FSDK version parity matrix (#142) - #148

Open
kylerankin wants to merge 5 commits into
projectbluefin:mainfrom
kylerankin:arch/flatcar-fsdk-parity-matrix
Open

kylerankin wants to merge 5 commits into
projectbluefin:mainfrom
kylerankin:arch/flatcar-fsdk-parity-matrix

Conversation

@kylerankin

@kylerankin kylerankin commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Closes #142.

Produces the Flatcar-to-FSDK version parity matrix for Bluefin Server's
design-phase-2 "version audit" instead of hand-maintaining it.

What

arch/parity/generate-parity-matrix.py reads the Flatcar 4593.2.5 release
artifacts and the freedesktop-sdk 26.08 pin snapshot, resolves every
substituted component's Flatcar version from the SPDX SBOM, compares it
against the FSDK pin, and emits:

  • arch/parity/flatcar-to-fsdk-parity-matrix.md — checked-in matrix with a
    gap column and ordering guidance (load-bearing / important / deferred).
  • arch/parity/flatcar-to-fsdk-parity-matrix.csv — same rows with per-row
    Flatcar-source citations and the FSDK element path.
  • arch/parity/fsdk-versions.json — the FSDK 26.08 pin snapshot.

Every row cites its Flatcar source and its FSDK element path; re-run the
script to refresh after a Flatcar bump or FSDK update.

Notes

  • The Flatcar release artifacts under data/flatcar/4593.2.5/ are vendored
    because no network fetch is available here; committing them keeps the
    generator reproducible.
  • Generator is covered by tests/unit/test_generate_parity_matrix.py
    (just test-unit).

— hive: backend=pi model=lemonade/Ornith-1.5-35B-A3B-GGUF-Q6_K pi=0.84.1

kylerankin and others added 5 commits September 14, 2026 09:51
…luefin#142)

Generate the parity matrix from Flatcar 4593.2.5 release artifacts and the
freedesktop-sdk 26.08 pin snapshot instead of hand-maintaining it. The
generator resolves each substituted component's Flatcar version from the
SPDX SBOM, compares it against the FSDK pin, and emits a checked-in
markdown matrix plus a CSV with per-row Flatcar-source citations and
ordering guidance.

- arch/parity/generate-parity-matrix.py: matrix generator (SBOM-driven)
- arch/parity/flatcar-to-fsdk-parity-matrix.{md,csv}: checked-in output
- arch/parity/fsdk-versions.json: FSDK 26.08 pin snapshot
- data/flatcar/4593.2.5/: vendored Flatcar release artifacts (no network
  fetch available; committed so the generator is reproducible)
- tests/unit/test_generate_parity_matrix.py: generator tests

Assisted-by: Ornith via pi
Signed-off-by: kylerankin <kylerankin@users.noreply.github.com>
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.

arch: produce the Flatcar-to-FSDK parity matrix

2 participants