Release 1 — the first coordinated tags
| Status | shipped |
| Finish Date | 2026-09-28 |
pykit's first coordinated set of package tags. The only tags that exist today
are single-package tags for rn-forge-commons and rn-forge-django, up to
v0.2.2.
Back to releases · Release runbook
Entry criteria
- The owner approves the scope below; F9.4 selected all seven packages and left F6.1 and F6.2 out.
- Until the tag cut, pykit stays installable outside the workspace through branch pins (F9.7, ADR-0004).
Scope
| Feature | Epic | State |
|---|---|---|
| F9.1 — Add SQLAlchemy CI coverage | E9 | Closed |
| F9.2 — Build documentation strictly in CI | E9 | Closed |
| F9.3 — Record the release mechanism | E9 | Closed |
| F9.4 — Select release-1's scope | E9 | Closed |
| F9.5 — Prove external installability | E9 | Closed |
| F9.6 — Cut package tags | E9 | Closed |
| F9.7 — Interim branch pins | E9 | Closed |
| F9.8 — Accept packages in scaffolded applications | E9 | Closed |
| F9.9 — Publish each package's documentation | E9 | Closed |
Done before this release
The tags also carry these epics, done before release-1 was planned. They predate the story taxonomy.
| Epic | Delivered | Implemented |
|---|---|---|
| E1 — Foundation and boundaries | Commons runtime foundation; the rn-forge-cli/rn-forge-tooling split |
2026-09-09 to 2026-09-16 |
| E2 — HTTP contract | The framework-neutral HTTP contract in rn-forge-web |
2026-09-12 to 2026-09-22 |
| E3 — Framework adapters | Django and FastAPI bindings of the web contract; the FastAPI application layer | 2026-09-12 to 2026-09-22 |
| E4 — Standards re-baseline | Standards and native-framework decisions across web, Django, FastAPI and SQLAlchemy | 2026-09-22 to 2026-09-23 |
| E5 — Tool lifecycle | Install, upgrade and doctor lifecycle in rn-forge-tooling |
2026-09-14 to 2026-09-22 |
| E10 — Documentation refactor | Docs moved from dated plans to architecture, specs, decisions and release pages | 2026-09-24 to 2026-09-26 |
Decisions
- ADR-0009 — added: each package publishes its own versioned docs (S9.9.1).
- ADR-0004 — updated: internal pins name
feature/upgradeuntil the tag cut (F9.7).
Breaking changes
None: release-1 is the first coordinated tag set, so there is no earlier tagged API to break.
Progress
S9.7.2 restored tag pins. The owner approved the release on 2026-09-27. The
merge to main confirmed F9.2, and every package job succeeded, cutting all
seven tags and their GitHub Releases (S9.6.1, F9.6). All seven versioned docs
sites and the root site are live. F9.5's external-install CI job (S9.5.1) was
verified via workflow_dispatch runs against all seven release-1 tags before
merge, each installing and importing cleanly from its Git URL outside the
workspace; it now runs on every push to main. All of release-1's scope is
Closed.
Commits
Commits whose subject names a scope ID, newest first:
d4525a82026-09-26 Add S9.8.4 scaffold test for a Django project; fix DRF 3.18 batch errors5f8af122026-09-26 Add S9.8.3 scaffold test for a FastAPI service30ac67f2026-09-26 Add S9.8.2 scaffold test for a tool lifecycle72406312026-09-26 Close F9.1 and S9.9.4; add S9.8.1 scaffold test359ad1f2026-09-26 Mark S9.3.3 done; restore main-only pull-request trigger55f68972026-09-26 Mark S9.7.1 done after clean-install checka1116cc2026-09-26 Build docs with --strict in CI (S9.2.1)e945ec12026-09-26 Scope CI package jobs to changes and dependencies (S9.3.3)
F9.4, S9.3.1–S9.3.2 and S9.9.1–S9.9.3 landed in 472bfa4 and 3aba88f, before
commit subjects named IDs.
Exit criteria
- F9.6 and F9.5 hold: every selected package's tag and GitHub Release exist, and each installs from its tag outside the workspace.
- F9.9 holds: every selected package's versioned docs site is live.
- The shipped table below lists each package, its version, tag and commit, and the install result.
Shipped
| Package | Version | Tag | Commit | Install |
|---|---|---|---|---|
rn-forge-commons |
0.5.0 |
rn-forge-commons-v0.5.0 |
f3d1757 |
pass |
rn-forge-cli |
0.1.0 |
rn-forge-cli-v0.1.0 |
f3d1757 |
pass |
rn-forge-tooling |
0.2.0 |
rn-forge-tooling-v0.2.0 |
f3d1757 |
pass |
rn-forge-web |
0.1.0 |
rn-forge-web-v0.1.0 |
f3d1757 |
pass |
rn-forge-django |
0.3.0 |
rn-forge-django-v0.3.0 |
f3d1757 |
pass |
rn-forge-fastapi |
0.1.0 |
rn-forge-fastapi-v0.1.0 |
f3d1757 |
pass |
rn-forge-sqlalchemy |
0.1.0 |
rn-forge-sqlalchemy-v0.1.0 |
f3d1757 |
pass |