nx_metric_ledger.nx

nx_metric_ledger.nx -- RETURN-AND-REPORT primitive (operator 2026-07-03: "on everything we do on the nishi ecosystem teams apis etc it should be a feedback loop with return and report as a key part so that we always know if we are moving toward more or less performance and quality"). Every organ that measures ANYTHING calls ml_report(name, value, dir, unit, src): 1. appends `METRIC <name> t_us=<t> value=<v> unit=<u> src=<s>` to knowledge/status/nx_metric_ledger.log 2. scans backward for the PREVIOUS row of the same metric 3. prints + returns the TREND: BETTER / WORSE / FLAT / NEW (dir: +1 higher-is-better, -1 lower-is-better) So every run of every measuring organ answers "are we moving toward more or less performance/quality" mechanically -- no one has to remember to compare. Append-only (rule #13); the ledger IS the history. Returns: 2=BETTER 1=FLAT 0=NEW -1=WORSE (callers may gate on WORSE = regression trap). No main logic beyond a compile smoke; the gate is nx_metric_ledger_gate. license_tier: ORIGINAL