nx_jsonl_writer.nx

nx_jsonl_writer.nx -- streaming JSONL output primitive. module: nishi-core.io.jsonl_writer depends: nishi-core.io.json_emit, nishi-core.io.syscalls disk_kb: 4 capability: CORE_IO license_tier: PUBLIC_NISHI_SUBSTRATE genealogy_id: rfc_7464_json_text_sequences + jsonlines_org_jsonl_specification + nishi_catalog_driven_cardinal_2026 Streaming line-delimited JSON output. One JSON object per line + newline terminator. Used by EVERY ingestion adapter for its canonical-record emit path (sources/usda_plants emits one row per PlantProfileResult, sources/kew_sid emits one per species, etc.). Per [[feedback-no-pdfs-no-proprietary-binary-formats]]: JSONL is the canonical open-format exchange format for the nishi data pipeline. Per [[feedback-bits-up-canonical-layer-no-reinventing]]: composes against nx_json_emit (shipped) for object serialization. ===== Output discipline ========================================== One JSON object per line. Line terminator = LF (0x0A). NO CRLF. NO leading whitespace. NO trailing whitespace before LF. NO pretty-print -- each record is one compact object. Round-trips through any RFC 7464 / jsonlines.org consumer. File-path convention (per nishi-library staging layout): nishi-library/staging/sources/<source>/<YYYY-MM-DD>/seq-<NNNNNN>.jsonl Each file caps at MAX_RECORDS_PER_FILE records (default 1000). Writer auto-rotates to next seq file when limit hit.