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 oncetask kiln:applyre-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
- F21.5 first, on
feature/release-8. It retires the self-hosted index before the cutover, so the cutover carries no index. - F16.3 as kiln's S7.2.4 rehearsal, on
feature/kiln-cutover, merged intofeature/release-8oncetask kiln:applyre-renders with no change (revised 2026-11-12: no longer waits for kiln'sv0.1.0tag; revised 2026-11-13: merged locally, not by pull request #30). It cuts pykit over onto kiln and addsrn-forge-authto the kiln config. kiln must render the release behaviour F21.3 built inmain.yml. S16.3.2 closes on the release's run onmain. - 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.
- 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.0tag exists. - Owner decision, 2026-11-12: the cutover merges on
[kiln] ref = "feature/v1"oncetask kiln:applyre-renders with no change; the release no longer waits for kiln'sv0.1.0tag. - Owner decision, 2026-10-31:
alembicis approved as the only dependency ofrn-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-8ahead ofkiln init, replacing branchfeature/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 intofeature/release-8with a merge commit; pull request #30 is closed unmerged, and thefeature/release-8→mainpull 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:generateleaves 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.