--- page_id: curated-versioning type: context-page schema_version: 1 template_id: curated-knowledge template_version: template-0.1.0 title: Version Management slug: curated-versioning route: /librelane-and-tooling/version-management section: reference access: public summary: PDK and toolchain transitions, template releases, pins, and local-versus-CI comparison. status: published asset_base: . home_href: / md_url: /librelane-and-tooling/version-management.md toc_enabled: true talk_enabled: false agent_view_enabled: true copy_buttons_enabled: true footer_enabled: true search_indexed: true tags: [wafer-space, knowledge-base, curated] last_updated: 2026-08-19 talk_url: /librelane-and-tooling/version-management.talk.md talk_route: /librelane-and-tooling/version-management/talk --- # Version Management ## 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](/evidence/i-information/questions/threads/gf180mcud-lvs-check-error-layout-cell-pin-orde#message-1433880759130783755) ([Discord](https://discord.com/channels/1361349522684510449/1433688821479772180/1433880759130783755)) - **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](/evidence/designing/project-template#message-1509176448223674489) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1509176448223674489)) - **Confirmed release — 2026-06-03:** Template 1.5.0 used the `open_pdks` PDK managed by Ciel. [Evidence](/evidence/designing/project-template#message-1511722026648338514) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1511722026648338514)) - **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](/evidence/i-information/questions/threads/gf180mcud-lvs-check-error-layout-cell-pin-orde#message-1433880759130783755) ([Discord](https://discord.com/channels/1361349522684510449/1433688821479772180/1433880759130783755)) [Replacement](/evidence/designing/project-template#message-1509176448223674489) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1509176448223674489)) ## Dated release notes - **2026-03-26 — Template 1.4.0:** moved to LibreLane 3.0. [Evidence](/evidence/designing/project-template#message-1486728700518203616) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1486728700518203616)) - **2026-06-06 — Template 1.5.1:** automatically fetched a new PDK when its pinned hash changed. [Evidence](/evidence/designing/project-template#message-1512840413877239878) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1512840413877239878)) - **2026-06-08 — Template 1.5.2:** added Magic `locking disable` to prevent file-descriptor exhaustion. [Evidence](/evidence/designing/project-template#message-1513546884726259844) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1513546884726259844)) - **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](/evidence/designing/project-template#message-1517130928248586290) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1517130928248586290)) - **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](/evidence/designing/project-template#message-1526579676183662662) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1526579676183662662)) ## 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](/evidence/designing/project-template#message-1512840413877239878) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1512840413877239878)) [Mismatch evidence](/evidence/designing/project-template/threads/only-thing-i-can-think-of-is-the-nix#message-1512912751641628845) ([Discord](https://discord.com/channels/1361349522684510449/1512739634692489366/1512912751641628845)) 2. If local output differs from CI, compare `flake.nix` and `flake.lock`. Test the unmodified template before changing the design. [Evidence](/evidence/designing/project-template/threads/only-thing-i-can-think-of-is-the-nix#message-1512740258649870336) ([Discord](https://discord.com/channels/1361349522684510449/1512739634692489366/1512740258649870336)) 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](/evidence/designing/project-template/threads/only-thing-i-can-think-of-is-the-nix#message-1512740258649870336) ([Discord](https://discord.com/channels/1361349522684510449/1512739634692489366/1512740258649870336)) ## 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](/evidence/designing/project-template#message-1526579676183662662) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1526579676183662662)) ## Related pages - [LibreLane and Tooling](/librelane-and-tooling) - [Digital Design](/digital-design) - [Tool Failures](/troubleshooting/tool-failures) - [Precheck and Signoff](/submission-procedures/precheck-and-signoff) - [RTL, Synthesis, and Simulation](/digital-design/rtl-synthesis-and-simulation) ## Sources - `1433880759130783755` — 2025-10-31T18:10:13.193+00:00 — Leo Moser (mole99) (@mole99) — old fork requirement. [Evidence](/evidence/i-information/questions/threads/gf180mcud-lvs-check-error-layout-cell-pin-orde#message-1433880759130783755) ([Discord](https://discord.com/channels/1361349522684510449/1433688821479772180/1433880759130783755)) - `1509176448223674489` — 2026-05-27T12:48:24.399+00:00 — Leo Moser (mole99) (@mole99) — upstreaming and Ciel transition. [Evidence](/evidence/designing/project-template#message-1509176448223674489) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1509176448223674489)) - `1511722026648338514` — 2026-06-03T13:23:37.59+00:00 — Leo Moser (mole99) (@mole99) — Template 1.5.0 with `open_pdks`. [Evidence](/evidence/designing/project-template#message-1511722026648338514) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1511722026648338514)) - `1486728700518203616` — 2026-03-26T14:09:04.287+00:00 — Leo Moser (mole99) (@mole99) — LibreLane 3.0. [Evidence](/evidence/designing/project-template#message-1486728700518203616) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1486728700518203616)) - `1512840413877239878` — 2026-06-06T15:27:41.884+00:00 — Leo Moser (mole99) (@mole99) — automatic PDK fetch after pin change. [Evidence](/evidence/designing/project-template#message-1512840413877239878) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1512840413877239878)) - `1513546884726259844` — 2026-06-08T14:14:57.66+00:00 — Leo Moser (mole99) (@mole99) — Magic locking fix. [Evidence](/evidence/designing/project-template#message-1513546884726259844) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1513546884726259844)) - `1517130928248586290` — 2026-06-18T11:36:40.224+00:00 — Leo Moser (mole99) (@mole99) — CoB offset and golden-mask fixes. [Evidence](/evidence/designing/project-template#message-1517130928248586290) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1517130928248586290)) - `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](/evidence/designing/project-template#message-1526579676183662662) ([Discord](https://discord.com/channels/1361349522684510449/1423348662318272592/1526579676183662662)) - `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](/evidence/designing/project-template/threads/only-thing-i-can-think-of-is-the-nix#message-1512740258649870336) ([Discord](https://discord.com/channels/1361349522684510449/1512739634692489366/1512740258649870336)) [Evidence 2](/evidence/designing/project-template/threads/only-thing-i-can-think-of-is-the-nix#message-1512912751641628845) ([Discord](https://discord.com/channels/1361349522684510449/1512739634692489366/1512912751641628845))