nx_entity_lib.nx

nx_entity_lib.nx -- ENTITY MANAGEMENT: capitalisation table arithmetic and corporate-authority limits. The Carta/Athennian-class category we had at zero. A cap table is not a spreadsheet, it is a set of hard corporate-law constraints, and two of them are violated constantly. u2605OVER-ISSUANCE IS VOID, NOT AN OVERDRAFT. A corporation may not issue more shares than its charter AUTHORISES. Shares purportedly issued beyond that number are void -- not "issued pending an amendment", not a rounding problem to fix at the next raise. A cap table that simply shows a larger issued figure is asserting something the corporation had no power to do, so this refuses rather than reports. u2605OWNERSHIP DEPENDS ENTIRELY ON THE BASIS, AND THE BASIS IS USUALLY UNSTATED. The same holder is a different percentage on an OUTSTANDING basis than on a FULLY DILUTED basis (which counts the option pool, warrants and convertibles). Founders hear the outstanding number, investors model the diluted one, and the gap is where disputes live. Both are computed here, separately and explicitly named -- there is deliberately no single "ownership" function to call by accident. Percentages are in PER MILLE (0..1000) to stay in integer arithmetic; a permille figure is exact where a truncated percent would silently lose sub-1% holders. u2605FAIL-CLOSED: a zero or negative denominator yields ENT_UNKNOWN, never zero percent. "0% owned" and "we cannot compute this" are different answers. STRUCTURE: pure decision core, zero I/O. license_tier: ORIGINAL LIB.