code wiki / _hdl_build / nx_clarity.nx

nx_clarity.nx

buildroot/runtime/_hdl_build/nx_clarity.nx

2112 B35 linesdepth 3pulls 4 transitivereach 3 importersview sourcekind library
docsdependenciesstructsconstsfunctions

about

nx_clarity.nx -- CLARITY = human-comprehension efficiency (operator 2026-06-22: "efficiency is energy clarity aka can a person understand all those"). Efficiency isn't only machine cost (bytes/requests/ENERGY) -- it's whether a PERSON can understand the thing without a manual; unclear output wastes human energy, so it's inefficient. This measures "can a person understand all those" for any text/output, customer-facing OR internal: readable sentences + self-describing words (not cryptic codes) + scannable structure. REUSE: nx_brand_voice (bv_longest_sentence_words). license_tier: ORIGINAL

dependencies 3 imports · 3 importers

nx_syscalls.nx nx_brand_voice.nx nx_brand_tokens.nx nx_clarity.nx nx_clarity_gate.nx nx_clarity_test.nx nx_internal_sweep_gate.nx

imports: nx_syscalls.nxnx_brand_voice.nxnx_brand_tokens.nx

imported by: nx_clarity_gate.nxnx_clarity_test.nxnx_internal_sweep_gate.nx

structs

none

consts

none

functions

12func cl_word_count(text: *u8, n: i64) -> i64
called by 3: cl_self_describingmainsweep_one
26func cl_self_describing(text: *u8, n: i64) -> i64 { if cl_word_count(text, n) >= 3 { return 1 } return 0 }
called by 2: cl_can_understandmain calls 1: cl_word_count
28func cl_readable(text: *u8, n: i64, max: i64) -> i64 { if bv_longest_sentence_words(text, n) <= max { return 1 } return 0 }
called by 1: cl_can_understand calls 1: bv_longest_sentence_words
30func cl_structured(html: *u8, n: i64) -> i64 { if bt_find(html, n, "<h1" as *u8, 3) >= 0 { return 1 } if bt_find(html, n, "<h2" as *u8, 3) >= 0 { return 1 } return 0 }
called by 1: main calls 1: bt_find
32func cl_can_understand(text: *u8, n: i64, max: i64) -> i64
called by 1: main calls 2: cl_readablecl_self_describing