nx_charmem.nx

buildroot/runtime/nx_charmem.nx

19378 B490 linesdepth 3pulls 3 transitivereach 0 importersview sourcekind tool

docs dependencies structs consts functions

about

nx_charmem.nx -- SOVEREIGN CHARACTER MEMORY (the Nomi/Replika-class relationship state, in Nishi). Operator 2026-08-05: "SQLite-backed character memory (affection/trust/drift/learned user preferences), we want in nishi sota." DESIGN: EVENT-SOURCED, APPEND-ONLY (rule 13 -- history is sacred). The Python original mutates SQLite rows; this organ never mutates anything: every interaction APPENDS one line to knowledge/status/charmem_<char>.jrnl and current state is a FOLD over the journal at read time. That buys what the mutable version cannot: full audit (why is affection 72? read the lines), time-travel debugging, and no lost-update races between writers. event <char> <kind> <args...> append one event. kinds: aff|trust|intim|excit <+/-N> relationship metric delta (fold clamps to 0..100) mood <word> current mood (latest wins) pref <key>=<value> learned user preference (latest value per key wins) mem <imp 1-9> <text...> an important memory with importance weight state <char> fold -> metrics, mood, counts (machine-parseable line) ctx <char> fold -> the LLM-ready system-prompt block (top prefs+memories) selftest <char> hermetic assertions on a throwaway fixture journal Char names sanitize to [a-z0-9_] max 32 (boundary defense: the name builds a path). license_tier: ORIGINAL module: nishi-core.companion.charmem

dependencies 2 imports · 0 importers

imports: nx_syscalls.nxnx_lane_conf.nx

imported by: nobody (leaf or entry point)

call flow from main pre-order; caps 40 nodes / depth 6 declared; ↻ = already shown

structs

none

consts

25	const CM_BUF: i64 = 1048576
26	const CM_LINE: i64 = 4096
27	const CM_PREF_MAX: i64 = 64
28	const CM_MEM_MAX: i64 = 256
30	const CM_CTX_PREFS: i64 = 6
31	const CM_CTX_MEMS: i64 = 6
32	const CM_DEF_AFF: i64 = 50
33	const CM_DEF_TRUST: i64 = 50
34	const CM_DEF_INTIM: i64 = 30
35	const CM_DEF_EXCIT: i64 = 50

functions

37	func cm_def(slot: i64) -> i64 called by 2: cm_fold cm_selftest calls 1: lc_write_lane
44	func cm_len(s: *u8) -> i64 { var n: i64=0; while s[n]!=(0 as u8){n=n+1} return n } called by 1: cm_w
45	func cm_w(s: *u8) -> i64 { sys_write(1, s, cm_len(s)); return 0 } called by 3: cm_event cm_selftest main calls 2: sys_write cm_len
46	func cm_cat(dst: u8, off: i64, s: u8) -> i64 { var i: i64=0; while s[i]!=(0 as u8){dst[off+i]=s[i];i=i+1} return off+i } called by 4: cm_path cm_event cm_state cm_ctx
47	func cm_u(dst: *u8, off: i64, v: i64) -> i64 called by 5: cm_u cm_event cm_state cm_ctx cm_selftest calls 2: cm_u sys_mmap
57	func cm_eq(a: u8, b: u8) -> i64 called by 5: cm_kind cm_fold cm_ctx cm_selftest main
67	func cm_int(s: u8, pi: i64) -> i64 called by 2: cm_fold cm_ctx
83	func cm_clamp(v: i64) -> i64 { if v<0 { return 0 } if v>100 { return 100 } return v } called by 2: cm_fold cm_selftest
88	func cm_eol(buf: *u8, idx: i64) -> i64 called by 2: cm_fold cm_ctx
99	func cm_line_copy(buf: u8, idx: i64, dst: u8, cap: i64) -> i64 called by 2: cm_fold cm_ctx
116	func cm_sane(s: u8, out: u8) -> i64 called by 2: cm_selftest main
133	func cm_path(char: u8, out: u8) -> i64 called by 3: cm_event cm_fold cm_selftest calls 1: cm_cat
141	func cm_now() -> i64 { let ts: i64=sys_mmap(16) as i64; ts[0]=0; sys_clock_gettime_real(ts); return ts[0] } called by 1: cm_event calls 2: sys_mmap sys_clock_gettime_real
144	func cm_kind(k: *u8) -> i64 called by 2: cm_event cm_fold calls 1: cm_eq
156	func cm_event(char: u8, argc: i64, argv: i64) -> i64 called by 2: cm_selftest main calls 10: cm_kind cm_w sys_mmap cm_path cm_u cm_now+4
194	func cm_fold(char: u8, m: i64, moodbuf: u8, buf: u8) -> i64 called by 3: cm_state cm_ctx cm_selftest calls 12: cm_def sys_mmap cm_path sys_openat_rd sys_read sys_close+6
253	func cm_state(char: *u8) -> i64 called by 1: main calls 5: sys_mmap cm_fold cm_cat cm_u sys_write
276	func cm_ctx(char: *u8) -> i64 called by 1: main calls 10: sys_mmap cm_fold cm_int cm_eq cm_cat cm_eol+4
400	func cm_file_size(path: *u8) -> i64 called by 1: cm_selftest calls 3: sys_openat_rd sys_lseek sys_close
408	func cm_selftest(char: *u8) -> i64 called by 1: main calls 14: sys_mmap cm_path sys_openat_wr sys_close cm_fold cm_def+8
471	func main(argc: i64, argv: *i64) -> i64 calls 8: cm_w sys_mmap cm_sane cm_eq cm_event cm_state+2