Skip to content

docs: state the observed preflight step count and how to recount it - #1031

Merged
thekevinscott merged 1 commit into
mainfrom
claude/1025-preflight-pair-count
Sep 4, 2026
Merged

thekevinscott merged 1 commit into
mainfrom
claude/1025-preflight-pair-count

Conversation

@thekevinbot

Copy link
Copy Markdown
Collaborator

Fixes #1025

Three places quoted "40 pairs", a number that predates #973 and #1019. Each now states what it counts and points at the command that recounts it, so the next drift is self-correcting.

Observed count

Run on origin/main at 06ef38a, in a clean worktree:

just preflight --dry-run | grep -c '^==>'   # 50
just preflight --dry-run | grep -c '^SKIP'  # 3

53 pairs total across 8 scan roots in 6 workflows: 50 runnable steps (42 gate invocations + 8 python drift guards: uv-sync and declared-deps across four python roots) plus 3 packaging pairs reported SKIP. The 8 roots are python-sdk, typescript-sdk, rust, rust-python-binding, rust-napi-binding, internals-checks, internals-distcheck, plugins-embeddings. one-function-per-file appears in five of them, which is #1019's contribution.

Changes

  • justfile preflight comment: 50 steps, with the breakdown and the recount command.
  • AGENTS.md: same number, flagged as a snapshot, same recount command.
  • agents/reference/testing-gates.md: drops the derived "other 34 pairs" (also stale) rather than replacing it with another number that will rot; keeps the historical "6 pairs across 3 roots" for what the four hand-written recipes covered, and points at the recount command for today's size.

E2E Verification

N/A - docs/lint/typo only

Changelog / Migrations

  • Not required -- docs-only, no packages/** or plugins/** source touched (skip-changelog trailer on the commit as a belt-and-braces).
  • Migration fragment not required -- no API or behavior change.

The three places quoting 40 pairs predate #973 and #1019. The dry-run
matrix now emits 50 '==>' steps (42 gate invocations + 8 python drift
guards) plus 3 SKIPped packaging pairs, so each site now names what it
counts and points at 'just preflight --dry-run | grep -c "^==>"'.

skip-changelog: docs-only, no package source touched
@thekevinscott
thekevinscott merged commit 6233a6c into main Sep 4, 2026
1 check passed
@thekevinscott
thekevinscott deleted the claude/1025-preflight-pair-count branch September 4, 2026 20:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: preflight pair count is stale in three places

2 participants