Skip to content

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/upgrade until 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:

git log --format='%h %ad %s' --date=short -E --grep='[FS](8\.1|9\.[0-9])'
  • d4525a8 2026-09-26 Add S9.8.4 scaffold test for a Django project; fix DRF 3.18 batch errors
  • 5f8af12 2026-09-26 Add S9.8.3 scaffold test for a FastAPI service
  • 30ac67f 2026-09-26 Add S9.8.2 scaffold test for a tool lifecycle
  • 7240631 2026-09-26 Close F9.1 and S9.9.4; add S9.8.1 scaffold test
  • 359ad1f 2026-09-26 Mark S9.3.3 done; restore main-only pull-request trigger
  • 55f6897 2026-09-26 Mark S9.7.1 done after clean-install check
  • a1116cc 2026-09-26 Build docs with --strict in CI (S9.2.1)
  • e945ec1 2026-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