nx_lorebook.nx

nx_lorebook.nx -- THE LOREBOOK PLANE (companionchat CC3): keyed world entries as DATA, injected into the chat turn ONLY when the turn touches one of an entry's trigger terms, under an insertion budget that REFUSES LOUDLY instead of truncating. Rows (knowledge/lorebook.conf -- daemon cwd first, then the nishihost tree, the gen_chat_budget.conf idiom): key|trigger1, trigger2, ...|entry text (# comments and blank lines skipped) @budget N (total bytes the [WORLD] block may carry, header included) A row with fewer than three fields is skipped and COUNTED as malformed, never guessed at. Matching is an ASCII case-insensitive substring of a trimmed trigger inside the user turn (non-ASCII case folding is deliberately not done -- a documented imprecision, not an accident); an entry fires at most once per turn however many of its triggers match; a turn that touches no trigger writes ZERO bytes (the neg-control). When the fired entries would exceed the budget, NOTHING is injected partially: out carries one refusal line naming the bytes wanted and the budget, and stats[LB_ST_REFUSED]=1, so the persona is never silently cut and the caller can log the refusal rather than the model reading half a fact. Contract symbol: em_lorebook (the companionchat.matrix CC3 watch). Composed by nx_companion_mind into the chat turn. stats[]: LB_ST_ROWS parsed rows, LB_ST_MALFORMED, LB_ST_FIRED, LB_ST_WANTED bytes, LB_ST_BUDGET effective, LB_ST_REFUSED 0/1. Gate: nx_lorebook_gate (fixture confs under /tmp/<gate>/, written at run time). license_tier: ORIGINAL