F16.2 — pykit passes the shared standard
| State | Closed |
| Parent | E16 |
| Iteration | Release 4 |
| Start Date | 2026-10-15 |
| Closed Date | 2026-10-15 |
| Predecessors | — |
| Source | kiln's pykit-shaped repository run, 2026-10-14 (kiln S6.1.1, second and third runs) |
Stories: 3 Closed
| Story | State | Depends on |
|---|---|---|
| S16.2.1 — The gate passes on current tools | Closed | — |
| S16.2.2 — Markdown is mdformat-clean | Closed | — |
| S16.2.3 — Changelogs follow Keep a Changelog | Closed | — |
kiln built a repository from a fresh python-lib skeleton carrying pykit's
packages, and ran the gate every kiln repository runs. Where pykit failed only
because it differs from the shared standard or from current tools, pykit
changes. Each story is something pykit should do whether or not it adopts kiln.
Context
Outcome: the feature ran first in Release 4 so that the packages E13 and F15.3 moved started lint-clean, mdformat-clean and in Keep a Changelog shape, and those moves never rebased over a reformat. Findings that were kiln's to fix are fixed in kiln, not here.
S16.2.1 — The gate passes on current tools
State: Closed
Outcome: the gate passes on ruff 0.17 and current django-stubs, after
fixing 177 ruff errors and four pyright errors.
Acceptance:
- After
uv lock --upgrade-package ruff --upgrade-package pyright --upgrade-package django-stubs,uv run ruff check,uv run ruff format --checkanduv run pyrightpass. EachPLE1205is a real fix or a per-linenoqawith the reason (for example, averboselogsmethod ruff cannot see); none is a blanket ignore. - The floors in the root
devgroup are raised to the versions the lock now holds.
S16.2.2 — Markdown is mdformat-clean
State: Closed
Outcome: mdformat runs over every Markdown file under the root
.mdformat.toml, which kiln seeds (ADR-0007).
Acceptance:
uv run --group docs mdformat --check .passes.- The strict docs builds still pass.
S16.2.3 — Changelogs follow Keep a Changelog
State: Closed
Outcome: no changelog ends in ## Earlier releases any more.
Acceptance:
- No
CHANGELOG.mdhas a second-level heading other than[Unreleased]or[<version>] - YYYY-MM-DD. The note about releases that predate the file is a paragraph under the oldest version, linking to the GitHub Releases page.
Acceptance
- The gate passes on freshly resolved lint and type tools (S16.2.1).
- Every Markdown file is mdformat-clean (S16.2.2), and every changelog follows Keep a Changelog (S16.2.3).
uv run pytest,uv run lint-imports,uv run pyrightandsh docs/_update_board.sh --checkpass.