Skip to content

docs(skill): 410 -- an event that reports a state is not the state - #2978

Merged
gHashTag merged 1 commit into
masterfrom
w799
Aug 30, 2026
Merged

docs(skill): 410 -- an event that reports a state is not the state#2978
gHashTag merged 1 commit into
masterfrom
w799

Conversation

@gHashTag

Copy link
Copy Markdown
Owner

A shared artefact fires "republished elsewhere, your copy is stale". Twice that notification cost a full re-read of a 2,000-line file and found nothing lost — once because the republish it reported was my own, once because the version it named (1788113439-87c9) was an intermediate one my publish had already superseded. The live version when I read it was 1788115237-56b7, and it was mine, byte for byte.

The notification is not wrong. It is a report about a moment, delivered after that moment.

The cheap check, before reading anything in full — line 1 of an artefact fetch is the runtime wrapper and carries the version id; everything after it is the page:

head -1 saved.html | grep -o '_f/[0-9a-f-]*'

then

diff <(tail -n +2 live.html) <(tail -n +2 mine.html) && echo identical

The second printed identical after ninety thousand tokens had already gone into reading the file line by line.

When the two do differ the full read is right, and the merge rules still hold: build on the fetched file, insert rather than replace, and count the headings both ways afterwards. That count is what showed the one deliberate removal in the last merge — a stale option I had just implemented — against 260 headings kept.

Same shape as §400 (tail -N read the wrong section) and §389 (a window read as a lifetime), one level out.

And a second cost, recorded in the section itself: the first attempt to append it used an unquoted heredoc. The text is full of backticks, so the shell ran them as command substitutions, the append never happened, the command hung until it was killed — and git status showed a clean tree. The silent no-op, one layer below the lesson being written.

Refs #2966

🤖 Generated with Claude Code

A shared artefact fires "republished elsewhere, your copy is stale".
Twice that notification cost a full re-read of a 2,000-line file and
found nothing lost: once the republish it reported was my own, and once
the version it named was an intermediate one my publish had already
superseded -- the live version when I read it was mine, byte for byte.

The notification is not wrong. It is a report about a moment, delivered
after that moment.

Two commands settle it before reading anything in full: compare the
version id the fetch returns against the one the notification named (it
is on line 1, the runtime wrapper), and diff the body against your own
copy. The second printed `identical` after ninety thousand tokens had
already gone into reading the file line by line.

When they do differ, the full read is right and the merge rules hold:
build on the fetched file, insert rather than replace, count the headings
both ways afterwards. That count is what showed the single deliberate
removal in the last merge -- a stale option I had just implemented --
against 260 headings kept.

The section nearly went unwritten. The first append used an UNQUOTED
heredoc; the text is full of backticks, the shell ran them as command
substitutions, nothing was written, the command hung until killed, and
`git status` showed a clean tree. The silent no-op one layer below the
lesson being recorded. Quote the delimiter.

Refs #2966

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

📓 NotebookLM Notebook linked to this PR

This notebook contains session context, decisions, and artifacts for this work.

@github-actions

Copy link
Copy Markdown
Contributor

PR Dashboard

Generated at: 2026-08-30 18:54:05 UTC

Summary

Status Count
Total Open PRs 8
PRs with Failing Checks 7
PRs with All Checks Green 1
READY 0
FAILING 7
PENDING 0

Seal Status

  • ⚠️ STALE -- sha256(compiler.rs)=4eccc2f5d228 != manifest seal=87e5cbd3ad94.
    The committed NMSE numbers were certified against an older compiler.rs.
    Run scripts/reseal-check.sh locally for the two-step reseal command (advisory; not a merge gate).

@gHashTag
gHashTag merged commit 09222bf into master Aug 30, 2026
26 checks passed
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