nx_mccabe_lib.nx

nx_mccabe_lib.nx -- CYCLOMATIC COMPLEXITY FOR NISHILANG. Closes seq251. WHY THIS EXISTS. nx_cwe_scan grades this estate against ISO/IEC 5055, and its own output has carried the hole since the day it shipped: "iso5055_factors":{"covered_of_4":3,"gap":["Maintainability -- needs cyclomatic/Halstead complexity, filed seq251"]}. The estate identified its own conformance gap, FILED it, and then nobody built it. This is that build. THE MAPPING, STATED SO NOBODY HAS TO GUESS IT. McCabe 1976 defines v(G) = e - n + 2p over the control-flow graph of a single procedure with one entry and one exit; for one connected procedure (p=1) that reduces to DECISION POINTS + 1, which is the form computed here. This TRANSFERS CLEANLY -- it needs a procedure with branching, not classes, not inheritance, not packages. It is not a re-target and not an analogue. Decision points counted, and this list IS the mapping: if, while, for, and each short-circuit operator (&& and ||), each of which adds an independent path. `else` is NOT counted -- it is the other side of a predicate already counted. `else if` IS counted, via its own `if`. COMMENTS AND STRING LITERALS ARE SKIPPED, AND THAT IS THE WHOLE BALLGAME. Measured on this very corpus before the organ existed: the first three `&&` occurrences found by a naive text search were all inside COMMENTS, and one more was a lexer emitting the token as data. A SCANNER THAT DOES NOT SKIP COMMENTS MEASURES THE DOCUMENTATION, NOT THE CODE -- the estate already paid for that law once (readOnly 15.5->32.5%). NO CAP. The body is read with sys_read_file, which sizes its buffer from the file itself and cannot short-read, so there is no truncation to declare and no guessed ceiling to tune. NO THRESHOLD IS INVENTED HERE. The organ publishes the DISTRIBUTION and derives its own percentiles from the CDF. The one bar it names -- 10 -- is CITED from McCabe 1976 and formalised in NIST SP 500-235, and is reported as "above the cited limit", never as a pass or a fail. AN UNCALIBRATED CLASSIFIER MUST REPORT NUMBERS, NEVER VERDICTS. license_tier: ORIGINAL LIBRARY -- no main. nx_mccabe.nx and nx_mccabe_gate.nx both consume it, so the census and its gate share ONE ruler by construction and cannot drift apart.