nx_docstage.nx

nx_docstage.nx -- DID THE THING WE SHIPPED GET WRITTEN DOWN ANYWHERE? (DM8, devmgmt rung.) The adoption gap this closes is not "no docs" -- it is that NOBODY MEASURES whether a shipped symbol ever reaches a surface another seat can retrieve. A capability that exists and is unfindable is a retrieval failure, and the estate's own record says the same doctrine got written four times because nobody looked first. DOCUMENTED = the symbol appears as an EXACT TOKEN in at least one file under the configured doc roots (compare matrix / plan / watch rows, the doc library, or -- when a caller passes its own roots -- a memory tree). EXACT TOKEN, NOT SUBSTRING, AND THAT IS THE WHOLE BAR. The accept rule is ZERO FALSE DOCUMENTED, and a substring search reports `nx_dora` as documented because `nx_dora_page` is mentioned somewhere. So a hit counts only when the character before AND after are non-identifier bytes. This is deliberately NOT a fork of nx_absent: that organ answers "is this substring absent, and was the search complete", which is a DIFFERENT QUESTION -- and a ruler whose subject does not match the question it is asked is the defect this estate finds most often. The coverage half of nx_absent's contract is reproduced here honestly instead: every cap sets a flag and the flag decides the verdict. THREE STATES, because presence and absence do not need the same evidence: DOCUMENTED -- at least one exact-token witness. ONE WITNESS IS ENOUGH, so this verdict stands even when coverage was partial. UNDOCUMENTED -- zero witnesses AND coverage_complete=1. An absence claim needs the whole corpus. UNMEASURED -- zero witnesses and coverage was NOT complete, or no root could be read at all. "I could not look" is not "it is not written down", and collapsing those two is how a reporting stage starts lying in the safe-sounding direction. Exit: 0 DOCUMENTED, 1 UNDOCUMENTED, 3 UNMEASURED. Callers that are report-only IGNORE the code and print the line -- a pre-flight that can refuse gets disabled, one that only informs survives. nx_docstage <symbol> [roots-conf] license_tier: ORIGINAL Read-only. No hw writes (Rule 26).