Skip to content

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

  1. 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.
  2. F18.2, F18.3 and F18.4 in any order, in parallel.
  3. F19.1 at any point: the decision, and ADR-0004's revision.
  4. F19.2 after F19.1. Its index first deploys on the cut's push to main.
  5. 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.yml references now and kiln's generated CI references after the cutover. Ranges do not wait on kiln.

Breaking changes

  • rn-forge-tooling 0.3.0 removes three modules; the names inside them are unchanged:

    Removed Import from
    rn_forge.tooling.templates rn_forge.commons.text.templates, with rn-forge-commons[templates]
    rn_forge.tooling.generation rn_forge.commons.generation
    rn_forge.tooling.state rn_forge.commons.fs.state, or rn_forge.commons

    Tooling no longer depends on jinja2.

  • DocumentUtils.read treats 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:

git log --format='%h %ad %s' --date=short -E --grep='E1[89]|F1[89]\.|S1[89]\.'

Exit criteria

  • Every feature on this page's Scope is Closed.
  • ADR-0004's revision is accepted.
  • docs/_update_board.sh --check passes.
  • The main CI, including rn-forge-devops requirements and 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