Release 6 — kit upgrades for kiln
| Status | shipped |
| Start Date | 2026-10-18 |
| Finish Date | 2026-10-25 |
The kit becomes fast and complete enough that kiln deletes its own copies
(E18), and the rn-forge-*
packages depend on each other by version range
(E19):
- Template rendering, the generation engine and the state store move to commons, so an application gets them without the CLI and installer layers (F18.1).
- Generators render artifacts from a table, and previews diff a plan (F18.2).
- YAML loads through libyaml, and plain TOML through
tomllib(F18.3). - Markdown structure gets a CommonMark parser (F18.4).
- pykit publishes a static PEP 503 index of the files already on GitHub Releases, and every internal requirement becomes a range resolved from it (F19.1–F19.3).
The cut re-tags every package that depends on commons once, on ranges. After it, an additive release of a package needs no release of the packages that depend on it. kiln's adoption of this release is kiln's own work; pykit's cutover onto kiln is Release 7.
Back to releases · Release runbook
Entry criteria
- Release 5 is shipped.
Scope
| Feature | Epic | State |
|---|---|---|
| F18.1 — Templates, generation and state move to commons | E18 | Closed |
| F18.2 — Templated artifacts and plan diffs | E18 | Closed |
| F18.3 — Fast, complete document reads and writes | E18 | Closed |
| F18.4 — Markdown structure | E18 | Closed |
| F19.1 — How packages find each other by version | E19 | Closed |
| F19.2 — The package index | E19 | Closed |
| F19.3 — Internal requirements become ranges | E19 | Closed |
Order
- F18.1 first. S18.1.1 and S18.1.2 move the code that F18.2 builds on; S18.1.3 fixes the contracts around it.
- F18.2, F18.3 and F18.4 in any order, in parallel.
- F19.1 at any point: the decision, and ADR-0004's revision.
- F19.2 after F19.1. Its index first deploys on the cut's push to
main. - F19.3 last, at the cut. It sets every range and re-tags every dependent, taking over F18.5's re-tag.
Decisions
- ADR-0002, amended 2026-10-24: rule 3 keeps only the command-line and installation layers in tooling; templates, generation and state are placed by rule 1, in commons.
- ADR-0004, revised 2026-10-25 (S19.1.1): packages declare each other by range, and pykit publishes an index.
- Owner decision, 2026-10-24: E18 and E19 ship together in this release, so dependents are re-tagged once, on ranges. F18.5 is removed. The kiln cutover and authentication move to Release 7.
- Owner decision, 2026-10-24: E19's range check and index publish live in files
pykit owns, which
main.ymlreferences now and kiln's generated CI references after the cutover. Ranges do not wait on kiln.
Breaking changes
-
rn-forge-tooling0.3.0 removes three modules; the names inside them are unchanged:Removed Import from rn_forge.tooling.templatesrn_forge.commons.text.templates, withrn-forge-commons[templates]rn_forge.tooling.generationrn_forge.commons.generationrn_forge.tooling.statern_forge.commons.fs.state, orrn_forge.commonsTooling no longer depends on
jinja2. -
DocumentUtils.readtreats a path that exists but is not a file as missing, instead of failing to read it. -
Plain YAML loads follow libyaml. Output and loaded values are unchanged, and libyaml's error messages differ from the pure parser's.
-
Each package's metadata requires its rn-forge dependencies by name and range. A consumer that declares the index, or pins every rn-forge package it uses by direct URL at its root, installs as before. A consumer that relied on a package's own git-URL requirements to pull in its dependencies must do one of the two.
Progress
Shipped 2026-10-25. Every feature in scope is closed, and E18 and E19 are
closed. The
push to main at
merge commit 9557668 passed every verify, postgres, smoke and suite job plus
import-boundaries, internal-ranges, external-install, docs and the Sonar
gate, and published the nine versions below. The docs job deployed the index,
and F19.2's and F19.3's by-name installs from it pass, which closed S19.2.2 and
S19.3.2.
Commits
Commits whose subject names a scope ID, newest first:
Exit criteria
- Every feature on this page's Scope is
Closed. - ADR-0004's revision is accepted.
docs/_update_board.sh --checkpasses.- The main CI, including
rn-forge-devops requirementsand the Sonar gate, passes on the release's version bumps. - F19.3's by-name install from the live index passes.
Shipped
The nine packages below were tagged and published by
run 40242764571.
Each package's docs site serves the new version as latest. A project outside
the workspace that declares https://rn-forge.github.io/pykit/simple/ locks
every package below by name from the index and imports rn_forge.tooling,
rn_forge.django, rn_forge.fastapi, rn_forge.sqlalchemy,
rn_forge.data.pandas and rn_forge.commons.generation (F19.3).
| Deliverable | Version | Tag | Commit | Verification |
|---|---|---|---|---|
rn-forge-commons |
0.7.0 |
rn-forge-commons-v0.7.0 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-cli |
0.1.1 |
rn-forge-cli-v0.1.1 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-tooling |
0.3.0 |
rn-forge-tooling-v0.3.0 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-web |
0.2.1 |
rn-forge-web-v0.2.1 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-data |
0.1.1 |
rn-forge-data-v0.1.1 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-sqlalchemy |
0.2.1 |
rn-forge-sqlalchemy-v0.2.1 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-django |
0.5.1 |
rn-forge-django-v0.5.1 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-fastapi |
0.3.2 |
rn-forge-fastapi-v0.3.2 |
9557668 |
published; external-install and docs passed; by name from the index |
rn-forge-devops |
0.3.0 |
rn-forge-devops-v0.3.0 |
9557668 |
published; external-install and docs passed |