nx_trap_syscall_emit.nx

nx_trap_syscall_emit.nx -- the TRAP+SYSCALL emitter (K-R1 of the kernel-up ladder). A NEW kernel syscall surface IS A SPEC FILE: reads (banner, 8x `sys <name> <a7> <emit>`, out) DATA and AUTHORS a bare-metal rv64 flat image for qemu-virt whose trap vector dispatches an 8-syscall mini-surface. The trap dispatch IS a STATE_MACHINE (shape 18 / pe13) instance: read a7, branch to the matching per-syscall handler row, emit that syscall's transcript byte to the UART, advance mepc+4, mret. exit (a7=93) writes the SiFive finisher = clean halt. Zero hand-written machine code per surface; the emitter is a tiny rv64 encoder (the few forms a trap surface needs: auipc/lui/addi/sb/sw + B-type branch + jal + csrrw/csrrs + ecall + mret) and the IMAGE + the GOLDEN transcript are TABLE-COMPUTED from the spec, byte-reproducibly. nx_trap_syscall_emit <specpath> -> writes the flat image to the spec's `out` and the table-computed golden transcript to <out>.golden VERDICT log -> knowledge/status/trap_syscall.log (TRAPEMIT rows, the gate's evidence). Sovereign: syscalls only, no gcc/.sh. license_tier: ORIGINAL