Record 2026-08-26 in SESSION-NOTES.md - #39
Merged
Conversation
The centre of gravity moved to the specifications, so the RESUME HERE block now names all three repositories and their states rather than only this one. Both spec repos are on a GitLab server that does not accept push options, with no `glab` or API token on the machine, so every merge request has to be opened in a browser - recorded because it is not discoverable and it changes how the work is done. Today in this repo: the three dangling documentation links (#36), two of which had never resolved because their targets exist only on the unmerged `internal-docs` root commit; CR-2026-035, where fixing one stale sentence exposed unreproducible benchmark figures and ten wrong cells in the C feature matrix (#37); and CR-2026-036, the `metadata` enrichment block (#38). In the spec repos: LA-PS had CR-2026-013 and 014 sitting uncommitted on a six-day-old branch while this repo had already shipped both - `expected_warnings` existed in no commit on any branch while nine files here depended on it. Both merged, then CR-2026-036 described the `metadata` block as PS-309 to PS-325. LA-IL gained seven submitted CRs and an editorial pass. Numbers: Python 2706 -> 2819, corpus 1250 -> 1253, encode round-trip 1163 -> 1166, C harness 488 -> 491. **Flagged rather than fixed: the floors were not raised by CR-2026-036.** Decode is 1242 against a floor of 1239 and reference encode is 1166 against `FLOOR_TOTAL = 1163` - three vectors of headroom in each that nothing locks in. Earlier CRs raised floors in the same change that raised counts; this one did not, so an edit that starts losing those three would pass. Left as a decision rather than making it silently. Four mistakes recorded, all the same shape as every one before them - measuring against a model instead of the artifact. The cross-reference fix was wrong by one and my own checker agreed, because both assumed one file equals one section; the PDF's table of contents was the only thing that disagreed. Then I verified the correction against a PDF five weeks stale. Two guard simulations reported success against guards that were in fact working, because the `sed` never created the condition. And a table cell with an unescaped underscore broke a PDF build with `! Missing $ inserted.` and no line number, which `pandoc -t latex` cannot reproduce. Note for anyone editing this file: `tests/test_cr_2026_035_benchmark_flagged_claim.py` reads it and asserts the corrected `transform` conclusion is still present. It is not free prose. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The notes described seven CRTs awaiting review. Six are implemented and merged, so the LA-IL entry, the RESUME HERE row and the pick-up-here section are rewritten. CRT-2026-003 to 007 were submitted and implemented the same day, IL-132 to IL-153, and CRT-2026-008 came out of implementing them: eight identifiers were declared in bold inside the mapping guides while the clause introducing those guides declared them non-normative. Kept and scoped rather than removed, using the per-format claim IL-119 already defines. Two entries added to the mistakes list, which now reads six rather than four, and both are the same shape as the four before them: - I concluded seven identifiers had been withdrawn because they were absent from `spec/`. They were in the companion guides, which that scan could not see. An absence is evidence about where you looked. - I allocated four identifiers over a submitted CR's proposals by taking the next number after the highest in the specification text - the one place a pending proposal is guaranteed not to be. The correction to the retirement record is written up as the more useful entry than the record itself, including that the section now carries a machine-readable line because the prose parser I wrote first read the correction and counted the seven it says are *not* withdrawn. Where to pick up is rewritten around CRT-2026-002, which is now unblocked and has upstream evidence: the events refactor has landed in eclipse-thingweb, whose LoRaWAN converter rejects a Thing Description declaring `properties`. CRP-2026-001 gains a pointer to `MultiTech-Systems/edgex-device-lorawan`, live-verified and running §4b quality, which did not exist when that CR was written. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
reissjason
force-pushed
the
docs/session-notes-aug-26
branch
from
August 26, 2026 19:37
06ad659 to
e8a58a2
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Notes only — one file. Updated after the CRT implementations landed, so it records six implemented CRs rather than seven awaiting review.
What the day was
Prototype (#36, #37, #38): three dangling doc links, two of which had never resolved because their targets exist only on the unmerged
internal-docsroot commit; CR-2026-035, where fixing one stale sentence exposed unreproducible benchmark figures and ten wrong cells in the C feature matrix; CR-2026-036, themetadataenrichment block.LA-PS: CR-2026-013 and CR-2026-014 had been sitting uncommitted on a six-day-old branch while this repo had already shipped both —
git grep expected_warnings HEADreturned nothing on any branch while nine files here depended on it. Then CR-2026-036, PS-309 to PS-325.LA-IL — six CRs implemented, IL-132 to IL-162. CRT-2026-003 through 007 submitted and implemented the same day, then CRT-2026-008 out of implementing them: eight identifiers were declared in bold inside the mapping guides while the clause introducing those guides declared them non-normative. Kept and scoped rather than removed, using the per-format claim IL-119 already defines.
Numbers
Flagged rather than fixed
The floors were not raised by CR-2026-036. Decode is 1242 against a floor of 1239; reference encode is 1166 against
FLOOR_TOTAL = 1163. Three vectors of headroom in each that nothing locks in — an edit that starts losing them would pass. Left as your decision.Six mistakes, all one shape
Measuring against a model instead of the artifact:
sedcreated the condition claimed.! Missing $ inserted.and no line number, whichpandoc -t latexcannot reproduce.spec/. They were in the companion guides, which that scan could not see. An absence is evidence about where you looked.The write-up treats the correction of #5 as the more useful entry than the record it corrected, including that the section now carries a machine-readable line, because the prose parser I wrote first read the correction and counted the seven it says are not withdrawn.
Where it says to pick up
CRT-2026-002, now unblocked with upstream evidence: the events refactor has landed in eclipse-thingweb, whose LoRaWAN converter models uplinks as events and rejects a Thing Description declaring
properties. Ourwot-td.mdstill describes output that converter refuses.CRP-2026-001 gains a pointer to
MultiTech-Systems/edgex-device-lorawan— live-verified uplink and downlink against an MTCAP3, §4b quality working — which did not exist when that CR was written.Note for future editors
tests/test_cr_2026_035_benchmark_flagged_claim.pyreads this file and asserts the correctedtransformconclusion is still present. It is not free prose. That test is green (35 passed).Verified
pytest tests/ -q→ 2819 passed / 4 skippedmake docs-index-check→ up to date🤖 Generated with Claude Code