nx_asset_catalog.nx

nx_asset_catalog.nx -- UNIVERSAL ORGANIZATION TOOLING arc, R1. Turns the R0 content-addressed asset RECORDS (nx_asset_record) into an actual CATALOG: the single source-of-truth inventory (org_research.tsv CONFIRMED dam-ssot-catalog) with ingest / list / get-by-CID, IDEMPOTENT re-ingest, and DEDUP-by-CID (content-addressed-dedup: identical content -> exactly ONE record, never a second copy). This is PURE COMPOSITION -- zero new storage/identity: * record identity + bytes -> nx_asset_record (ar_cid -> the record's CID = its catalog key) * durable append-only KV -> nx_seg_store (ss_open snapshot + ss_hget / ss_begin+ss_add+ ss_commit), same store the records already use THE CATALOG = the set of record CIDs held in ONE seg_store. Membership/order is tracked by a single reserved index key whose value is the newline-joined list of member CIDs (one append per NEW record). Because seg_store is content-addressed + last-writer-wins per key: * a record is stored under its CID -> re-storing identical bytes is a no-op by content * the index key (CAT_IDX) is re-committed -> the newest segment shadows the old list so DEDUP and IDEMPOTENCE both fall out of the substrate, and ADDITIVE law #13 holds (a DUP writes nothing; the prior record + index history stay on disk, never deleted). LAWS: #9 single responsibility (each cat_* does ONE thing); #10 idempotent (re-ingest == DUP, count unchanged); #13 additive (dedup COLLAPSES to one record, never destroys history); #15 DRY (composes R0 + the store, no copied boilerplate). No hardware/persistent-firmware writes (#26). API: cat_ingest(prefix, bytes, n, out2) -> 0 ok / <0 err; out2[0]=status (CAT_NEW|CAT_DUP), out2[1]=unused; the record's CID is written into `cidout` via the cat_ingest_cid variant (see below). cat_get(prefix, cid, ptrout, lenout) -> 1 found / 0 tombstoned / -1 absent (ss_hget semantics) cat_list(prefix, out_cids, cap) -> count of CIDs written into out_cids[] (ptrs to NUL-term) cat_count(prefix) -> number of records in the catalog (>=0) license_tier: ORIGINAL