Skip to content

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 --check and uv run pyright pass. Each PLE1205 is a real fix or a per-line noqa with the reason (for example, a verboselogs method ruff cannot see); none is a blanket ignore.
  • The floors in the root dev group 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.md has 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 pyright and sh docs/_update_board.sh --check pass.