nx_compare_cite.nx

nx_compare_cite.nx -- CITE A /compare ROW IN ONE PUBLISH: the ref row AND its inline mark, or neither. WHY (operator, 2026-09-02: "this should be capabilities that the nishi team and estate and ecosystem have"). A citation on a /compare board is TWO writes in TWO files -- a `ref|key|...` row in <dom>.refs and a `[@key]` mark inside one matrix row's note -- and nx_compare_refs_gate refuses the board when either half is missing (UNCITED when the row lands without its mark, UNRESOLVED-MARK when the mark lands without its row). Measured the day this was written: fifteen refs landed as one edit and five marks then had to be placed by five sequential compare-and-swap edits, each a separate transport round-trip, each a chance to half-land. The estate had a GATE for citations (nx_compare_refs_gate), a FORMAT PRECHECK (nx_atlas_cite) and a VERIFIER (nx_cite_lib) -- and no WRITER. This is the writer. WHAT IT REFUSES BY CONSTRUCTION (the fabrication class the refs law names): * the pin is COMPUTED from the mirror file, never typed -- a reference whose mirror is absent cannot be cited at all (REFUSED-MIRROR-ABSENT), so "a reference you did not fetch" cannot enter a register. * the target row is named by its LABEL PREFIX and must match EXACTLY ONE matrix row (0 -> ROW-NOT-FOUND, 2+ -> ROW-AMBIGUOUS with the count), so a mark can never land on the wrong row. * a pipe inside any prose field is refused (the row grammar has exactly 9 fields). * both files are re-written whole under nx_atomic_publish's compare-and-swap with the sha256 THIS run read (composed: forked, never re-implemented), so a concurrent editor is refused, never clobbered. * ORDER: refs first, then the mark. A ref without its mark is the gate's UNCITED class (named, and this organ is idempotent so a re-run adds the missing half); a mark without its ref would DANGLE. * IDEMPOTENT: key present AND mark present -> ALREADY-CITED, exit 0, nothing written. TREE RESOLUTION is composed from nx_comparetree_lib in PUBLISHED order (buildroot first, the tree the page renders from; the authored tree second), the same order the referee reads .matrix and .refs. usage: nx_compare_cite <domain> <key> <row-label-prefix> <cite> <url> <mirror> <class> <grounds> nx_compare_cite @<specfile> (8 lines in the same order -- the argv-mangling-safe form the memory rail already uses; CRLF tolerated) receipt (last line, positional): CITED | ALREADY-CITED | REFUSED-<reason> | PARTIAL-refs-published-mark-refused exit: 0 cited or already | 2 usage | 3 field refused (pipe, empty, non-http url) | 4 mirror absent 5 refs or matrix file unresolvable | 6 row not found or ambiguous | 7 refs publish refused 8 mark publish refused after the ref landed (re-run: idempotent, it adds only the mark) license_tier: ORIGINAL No hw writes (Rule 26). expect_exit: 0