Skip to content

Release 8 — kiln adoption and local-first extraction

Status shipped
Start Date 2026-10-29
Finish Date 2026-11-14

pykit cuts over onto kiln's python-lib archetype (F16.3, E16), with every package already published to PyPI by Release 7. It also moves Apollo's generic plumbing into the packages that own its neighbours (F17.1 to F17.5, E17), and adds log redaction and server-sent events (F6.1 and F6.2, E6).

Back to releases · Release runbook

Entry criteria

  • Release 7 is shipped.
  • For F16.3 only: the work runs first as kiln's S7.2.4 rehearsal from kiln feature/v1, and the cutover merges once task kiln:apply re-renders with no change at the configured [kiln] ref. kiln F6.7, F6.8 and F6.9 are closed.

Scope

Feature Epic State
F6.1 — Structured-log secret redaction E6 Closed
F6.2 — Server-sent events E6 Closed
F16.3 — Cut over onto kiln E16 Closed
F16.7 — Instruction files follow kiln's standard E16 Closed
F17.1 — Problem rows from an exception hierarchy E17 Closed
F17.2 — Single-owner thread actor E17 Closed
F17.3 — TaskPool.map_settled E17 Closed
F17.4 — SQLite engine and embedded migrations E17 Closed
F17.5 — Safe filesystem mutation E17 Closed
F18.6 — Cache Markdown structure by text E18 Closed
F18.7 — A managed block's end marker can sit at a different indent E18 Closed
F21.5 — Retire the self-hosted index E21 Closed

Order

  1. F21.5 first, on feature/release-8. It retires the self-hosted index before the cutover, so the cutover carries no index.
  2. F16.3 as kiln's S7.2.4 rehearsal, on feature/kiln-cutover, merged into feature/release-8 once task kiln:apply re-renders with no change (revised 2026-11-12: no longer waits for kiln's v0.1.0 tag; revised 2026-11-13: merged locally, not by pull request #30). It cuts pykit over onto kiln and adds rn-forge-auth to the kiln config. kiln must render the release behaviour F21.3 built in main.yml. S16.3.2 closes on the release's run on main.
  3. F17.1, F17.2, F17.3, F17.5, F17.4 do not wait for kiln. F17.2 comes before F17.3, whose guide names the actor rule.
  4. F6.1 and F6.2 do not wait for kiln, or for each other.

Decisions

  • Owner decision, 2026-10-29: the kiln cutover (F16.3) and F16.6 move here from Release 7, which publishes every package to PyPI so kiln can ship its release 1.
  • Owner decision, 2026-10-31: F17.1 to F17.5 join this release and F16.3 and F16.6 stay, so the release cannot ship until kiln's v0.1.0 tag exists.
  • Owner decision, 2026-11-12: the cutover merges on [kiln] ref = "feature/v1" once task kiln:apply re-renders with no change; the release no longer waits for kiln's v0.1.0 tag.
  • Owner decision, 2026-10-31: alembic is approved as the only dependency of rn-forge-sqlalchemy[migrations] (S17.4.1).
  • Owner decision, 2026-10-31: F6.1 and F6.2 join this release, and F16.3 and F16.6 stay in it.
  • Owner decision, 2026-11-03: F21.5 joins this release and lands before F16.3.
  • Owner decision, 2026-11-03: S16.3.3 converts the docs to kiln's format on feature/release-8 ahead of kiln init, replacing branch feature/kiln-docs-model.
  • Owner decision, 2026-11-13: F16.6 is removed. S16.3.4 moved the planner to kiln's kiln-devops, so its outputs are kiln's to retire.
  • Owner decision, 2026-11-13: F16.3's stories close on feature/kiln-cutover, which merges locally into feature/release-8 with a merge commit; pull request #30 is closed unmerged, and the feature/release-8 → main pull request ships the release.

Commits

Commits whose subject names a scope ID, newest first:

git log --format='%h %ad %s' --date=short -E --grep='F16\.[36]|S16\.[36]\.|F21\.5|S21\.5\.|F17\.[1-5]|S17\.[1-5]\.|F6\.[12]|S6\.[12]\.'

Exit criteria

  • Every feature on this page's Scope is Closed.
  • task docs:generate leaves the working tree unchanged.
  • The main CI, including the Sonar gate, passes on the release's version bumps.

Shipped

Shipped 2026-11-14. Every feature in scope is closed. The pull requests #31 and #34 merged into main, and run 43591842240 at 637a7df passed every job, including plan (task ci:internal-ranges), umbrella (task ci:release:umbrella) and integration (rn-forge-auth), which started the keycloak service beside redis. main.yml no longer exists.

PyPI serves these versions, each with an rn-forge-<package>-v<version> tag and a GitHub release:

Package Version
rn-forge-commons 0.9.0
rn-forge-auth 0.1.1
rn-forge-cli 0.1.3
rn-forge-data 0.1.3
rn-forge-devops 0.4.0
rn-forge-django 0.6.1
rn-forge-fastapi 0.4.1
rn-forge-sqlalchemy 0.2.3
rn-forge-tooling 0.3.2
rn-forge-web 0.3.1

Each package's docs are served at https://rn-forge.github.io/pykit/packages/rn-forge-<package>/latest/, the root site returns 200, and https://rn-forge.github.io/pykit/simple/ returns 404.

Known issue. The umbrella step did not create release-8, which was still planned on main. It created tags and GitHub releases release-1 to release-5, all at 637a7df, for releases that had never been tagged, and GitHub marks "Release 5" as Latest. release-6 (ed566a0) and release-7 (63495d8) were untouched. Moving or deleting the tags is the owner's; the cause is in kiln's kiln-devops umbrella.