Public

Version Management

PDK and toolchain transitions, template releases, pins, and local-versus-CI comparison.

Scope

This page records the PDK and toolchain transition, important project-template releases, and the method for comparing local and CI builds.

PDK transition

  • Confirmed historical fact — 2025-10-31: The precheck and template then required the wafer-space/gf180mcu PDK fork. Evidence (Discord)
  • Confirmed replacement — 2026-05-27: wafer.space changes had been upstreamed into open_pdks; the template was moving to Ciel and adding community IP support. Evidence (Discord)
  • Confirmed release — 2026-06-03: Template 1.5.0 used the open_pdks PDK managed by Ciel. Evidence (Discord)
  • Obsolete guidance: Use of the old wafer.space fork is not current guidance for a new design after this transition. Keep its old pin only when reproducing an old run. Old requirement (Discord) Replacement (Discord)

Dated release notes

  • 2026-03-26 — Template 1.4.0: moved to LibreLane 3.0. Evidence (Discord)
  • 2026-06-06 — Template 1.5.1: automatically fetched a new PDK when its pinned hash changed. Evidence (Discord)
  • 2026-06-08 — Template 1.5.2: added Magic locking disable to prevent file-descriptor exhaustion. Evidence (Discord)
  • 2026-06-18 — Template 1.5.3 and Precheck 1.7.0: fixed a 0.5 um CoB pad offset and added a golden pad-mask check. Evidence (Discord)
  • 2026-07-14 — Template 1.5.8 and Precheck 1.7.2: fixed a critical buffer problem in gf180mcu_as_sc_mcu7t3v3 and a text-ID issue; affected 3.3 V library users were told to rebuild. Evidence (Discord)

Reproducibility procedure

  1. Record the project-template tag, flake.nix, flake.lock, PDK hash, LibreLane commit, tool versions, precheck image/tag, and final GDS hash. This is an inferred record set from version-mismatch failures and release changes, not a quoted policy. Release evidence (Discord) Mismatch evidence (Discord)
  2. If local output differs from CI, compare flake.nix and flake.lock. Test the unmodified template before changing the design. Evidence (Discord)
  3. Run nix flake update only when intentionally changing the pinned inputs, then commit the new lock with the result. The command was proposed during the recorded mismatch investigation. Evidence (Discord)

Open question

The archive does not name one current version set after 2026-07-14. Treat these as dated releases and read the pins in the selected template before building. Evidence (Discord)

Sources

  • 1433880759130783755 — 2025-10-31T18:10:13.193+00:00 — Leo Moser (mole99) (@mole99) — old fork requirement. Evidence (Discord)
  • 1509176448223674489 — 2026-05-27T12:48:24.399+00:00 — Leo Moser (mole99) (@mole99) — upstreaming and Ciel transition. Evidence (Discord)
  • 1511722026648338514 — 2026-06-03T13:23:37.59+00:00 — Leo Moser (mole99) (@mole99) — Template 1.5.0 with open_pdks. Evidence (Discord)
  • 1486728700518203616 — 2026-03-26T14:09:04.287+00:00 — Leo Moser (mole99) (@mole99) — LibreLane 3.0. Evidence (Discord)
  • 1512840413877239878 — 2026-06-06T15:27:41.884+00:00 — Leo Moser (mole99) (@mole99) — automatic PDK fetch after pin change. Evidence (Discord)
  • 1513546884726259844 — 2026-06-08T14:14:57.66+00:00 — Leo Moser (mole99) (@mole99) — Magic locking fix. Evidence (Discord)
  • 1517130928248586290 — 2026-06-18T11:36:40.224+00:00 — Leo Moser (mole99) (@mole99) — CoB offset and golden-mask fixes. Evidence (Discord)
  • 1526579676183662662 — 2026-07-14T13:22:37.281+00:00 — Leo Moser (mole99) (@mole99) — Template 1.5.8, Precheck 1.7.2, the critical 3.3 V SCL buffer fix, and the text-ID fix. Evidence (Discord)
  • 1512740258649870336 — 2026-06-06T08:49:43.017+00:00 — Leo Moser (mole99) (@mole99); 1512912751641628845 — 2026-06-06T20:15:08.551+00:00 — RebelMike (@rebelmike) — Nix and CI comparison. Evidence 1 (Discord) Evidence 2 (Discord)