Skip to content

Record 2026-08-26 in SESSION-NOTES.md - #39

Merged
reissjason merged 2 commits into
masterfrom
docs/session-notes-aug-26
Aug 26, 2026
Merged

Record 2026-08-26 in SESSION-NOTES.md#39
reissjason merged 2 commits into
masterfrom
docs/session-notes-aug-26

Conversation

@reissjason

@reissjason reissjason commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

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-docs root 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, the metadata enrichment 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 HEAD returned 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

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; 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:

  1. The cross-reference fix was wrong by one, and my own checker agreed — both assumed one included file equals one numbered section. Only the PDF's table of contents disagreed.
  2. I then verified that correction against a PDF five weeks stale.
  3. Two guard simulations reported success against guards that were working — neither sed created the condition claimed.
  4. A table cell with an unescaped underscore broke a PDF build with ! Missing $ inserted. and no line number, which pandoc -t latex cannot reproduce.
  5. 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.
  6. 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 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. Our wot-td.md still 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.py reads this file and asserts the corrected transform conclusion is still present. It is not free prose. That test is green (35 passed).

Verified

  • pytest tests/ -q → 2819 passed / 4 skipped
  • make docs-index-check → up to date

🤖 Generated with Claude Code

reissjason and others added 2 commits August 26, 2026 12:46
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
reissjason force-pushed the docs/session-notes-aug-26 branch from 06ad659 to e8a58a2 Compare August 26, 2026 19:37
@reissjason
reissjason merged commit a348706 into master Aug 26, 2026
5 checks passed
@reissjason
reissjason deleted the docs/session-notes-aug-26 branch August 26, 2026 20:08
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.

1 participant