Skip to content

docs: document the append spot-check's second blind spot (#66) - #68

Merged
inth3shadows merged 2 commits into
mainfrom
docs/append-spot-check-blind-spot-66
Aug 14, 2026
Merged

docs: document the append spot-check's second blind spot (#66)#68
inth3shadows merged 2 commits into
mainfrom
docs/append-spot-check-blind-spot-66

Conversation

@inth3shadows

Copy link
Copy Markdown
Owner

Summary

  • journeys/testgraph.json's spot_checks.append passes today, but not for the reason it claims to check: the caller edges it counts on ledger.py:append are fabricated by a codegraph resolver bug, not the two real callers (record.py:add_outcome, hook.py:log_invocation).
  • Adds a second blind-spot paragraph to the registry's note, alongside the existing alias blind spot, documenting the root cause, the measured edge counts, and that a fix exists (uncommitted upstream, pushed to a fork branch) but isn't deployed to the codegraph build this machine runs.
  • Full root-cause writeup: CodeGraph: ledger.append has zero real inbound call edges; unrelated list.append() calls false-positive-link to it instead #66

Test plan

  • python3 -m pytest tests/test_registries.py -q — 6 passed
  • python3 -m pytest tests/ -q — 251 passed
  • JSON validated (python3 -c "import json; json.load(open('journeys/testgraph.json'))")

journeys/testgraph.json's spot_checks.append passes today, but not for the
reason it claims to: the 5+ caller edges it counts are all fabricated by a
codegraph resolver bug, not the two real callers (record.py:add_outcome,
hook.py:log_invocation). Records the root cause, the measured edge counts,
and that a fix exists but isn't deployed to the codegraph build in use, so
the spot-check should be treated as unreliable until a release picks it up.
Named one example plus "five more" (6 total), but the actual non-identifier-
receiver .append() call sites this paragraph describes number 7 across
export.py/db.py/propose.py/select.py — matching the paragraph's own "7
fabricated edges, measured" figure. Caught by code review.
@inth3shadows
inth3shadows merged commit a00c75c into main Aug 14, 2026
1 check passed
@inth3shadows
inth3shadows deleted the docs/append-spot-check-blind-spot-66 branch August 14, 2026 18:24
@inth3shadows
inth3shadows restored the docs/append-spot-check-blind-spot-66 branch August 14, 2026 18:27
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