1
85%
main: 85%

Ran 08 May 2026 12:22PM UTC

Files 138

Run time 5s

Badge

Embed ▾

Committed 08 May 2026 11:27AM UTC coverage: 82.387% (+0.2%) from 82.19%

Job # 1794.1

Build Type

push

travis-ci

Committed by

thoni56

Commit Message

[docs][principles] Add What Reparse Cleans section

Closes a missing piece in the principles chapter: there is no current
section that explains what removeReferenceableItemsForFile actually
strips when a CU is reparsed, and what it leaves behind. The new section
sits between Minimal Reparse Set and Preserve Parsed Work — natural
progression: when to reparse, which files to reparse, what reparse
cleans, what to persist.

The section opens by naming the gap explicitly (CU reparse does not
strip references contributed at included-file positions), explains why
it is invisible most of the time (dedup keyed on identity, not
position), describes when it surfaces (included file content shifts),
notes which cases the existing pass machinery covers self-healingly and
which case escapes (a CU outside the request's web with a stale
included-file reference; snapshot reload across sessions), and outlines
the candidate direction for closing the gap (strip the transitive
include closure of the CU being reparsed before the parse runs) along
with two verification points (macro expansions in headers; multi-pass
preprocessor handling).

Doubles as the design rationale for whatever fix lands here.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Coverage Stats

16877 of 20485 relevant lines covered (82.39%)

14951936.65 hits per line

thoni56 / c-xrefactory / 1794 / 1
85%
main: 85%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Source Files on job 1794.1

thoni56 / c-xrefactory / 1794 / 1 85% main: 85%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Source Files on job 1794.1

thoni56 / c-xrefactory / 1794 / 1
85%
main: 85%

README BADGES
x