docs(rate-of-closure): restore the handoff doc to the current-state policy

[dieterolson]

CLAUDE.md caps handoff documents at 150 lines and keeps history in git. src/rate_of_closure/AGENT_HANDOFF.md had grown to 2,205 lines across 140 dated entries.

This is the same drift the root handoff already recorded and corrected for itself — its do-not list now reads "It grew to 2,708 lines that way, 18x over the policy limit." The per-tool doc never got that treatment.

What changed

The 140 entries move verbatim to docs/agent_handoff_archive/2026-08_rate_of_closure_handoff_log.md, following the existing root-log archive convention and header, so no provenance is lost.

The live document becomes 103 lines of current state, weighted toward what actually cost time to rediscover this week:

• the PyQt6 entry point and window title the UpstreamDrift launcher manifest depends on, and where the React mirror and each swing_sim package live

• why Rate of Closure remainder: club builder, impact tensor, flight, multi-view workspace, ground and web companion (consolidates 43 PRs) #4466 cannot be merged by any strategy — with the measurement, not the assertion:

  strategy	result
  -X theirs	47 failed / 40 errors
  -X ours	19 collection errors

  The post-squash merge-base predates src/rate_of_closure/, so all 281 overlapping files are both-added conflicts with no common ancestor.

• the four files where the source branch is older than main and would silently revert shipped work if taken wholesale: test_wind.py (1e-12 tolerance, Wind turbulence hash is not cross-platform reproducible, weakening the PyQt6/React parity fixture #4513), flight.ts (+31/−107), plotting/render.py (13 test failures), and 16 of variation's files

• what remains of Rate of Closure remainder: club builder, impact tensor, flight, multi-view workspace, ground and web companion (consolidates 43 PRs) #4466 by area, including that application and web_authority import each other and must land together

• local-environment traps: mypy 1.13 crashing on Python 3.13 for multi-file sets, the two-tier tools_core capability, and PowerShell rewrites normalising SPEC.md to CRLF

Why this matters

This session began by reading a handoff doc that described a PR stack closed two days earlier, and planned against it. The doc is the first thing an agent reads; when it is a 2,205-line append-only log, the current state is unfindable.

No source or test behaviour changes. SPEC 1.17.18.

🤖 Generated with Claude Code

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.