code wiki / _hdl_build / nx_spore_manifest_gate.nx
nx_spore_manifest_gate.nx source
↩ module page · 208 lines · 10338 B
1// nx_spore_manifest_gate.nx -- X-SEED-001 / V-SPORE manifest: the GERMINATION MANIFEST
2// (the seed body, "the .torrent of the organism"). Generalizes the proven single-piece
3// germination (V-SPORE-1, nx_spore_germ_gate) to a LAYERED, MULTI-piece, content-addressed seed:
4// PACK -- FNV-1a each piece's source bytes; EMIT germination_manifest.tsv
5// (id <tab> source <tab> hash <tab> layer <tab> kat_expect) = a real persisted seed.
6// GERMINATE -- in LAYER order, per piece: re-read source (received), FNV-1a, verify == packed
7// hash (INTEGRITY), materialize, REBUILD via the sovereign toolchain, run -> exit
8// == kat_expect (BEHAVIOR/KAT). ADMIT iff both.
9// NEG -- one piece tampered (a byte flipped) -> hash mismatch -> REJECTED, never built.
10// READ-BACK -- re-read the emitted manifest; data-row count must == piece count (seed persisted).
11// verdict GREEN iff ADMIT-ALL + NEG-REJECT + ROWS==N.
12//
13// HONEST scope: verification uses the in-run packed hashes + a persisted-manifest read-back;
14// full content-addressing FROM the persisted manifest (re-parse the recorded hash) and
15// AUTO-DERIVING the piece set from the capability registry/lineage (X-SEED-001 full) are next rungs.
16//
17// Build/run (from nxc2 cwd): _offc/nx_sov_build_run.elf nx_spore_manifest_gate
18// genealogy_id: nishi_spore_seed_portability_charter (X-SEED-001 / V-SPORE manifest)
19
20import "nx_syscalls.nx"
21import "nx_gate_verdict.nx"
22
23const GERM_FNV_OFFSET: i64 = 0 - 3750763034362895579 // 0xcbf29ce484222325
24const GERM_FNV_PRIME: i64 = 1099511628211 // 0x100000001b3
25const MAN_PATH: *u8 = "knowledge/registry/germination_manifest.tsv"
26const N_PIECES: i64 = 2
27
28func germ_hash(buf: *u8, len: i64) -> i64 {
29 var h: i64 = GERM_FNV_OFFSET
30 var i: i64 = 0
31 while i < len { h = h ^ (buf[i] as i64); h = h * GERM_FNV_PRIME; i = i + 1 }
32 return h
33}
34func g_slen(s: *u8) -> i64 { var n: i64 = 0; while s[n] != (0 as u8) { n = n + 1 } return n }
35func g_puts(s: *u8) -> i64 { sys_write(1, s, g_slen(s)); return 0 }
36func g_puts_fd(fd: i64, s: *u8) -> i64 { sys_write(fd, s, g_slen(s)); return 0 }
37func g_tab(fd: i64) -> i64 { let t: *u8 = sys_mmap(8); t[0] = 9; sys_write(fd, t, 1); return 0 }
38func g_putn(fd: i64, v: i64) -> i64 {
39 let bb: *u8 = sys_mmap(28)
40 var m: i64 = v
41 if m < 0 { m = 0 - m; sys_write(fd, "-" as *u8, 1) }
42 let t: *u8 = sys_mmap(28)
43 var k: i64 = 0
44 if m == 0 { t[0] = 48; k = 1 }
45 while m > 0 { t[k] = 48 + (m % 10); m = m / 10; k = k + 1 }
46 var i: i64 = 0
47 while i < k { bb[i] = t[k - 1 - i]; i = i + 1 }
48 sys_write(fd, bb, k)
49 return 0
50}
51// fork + optional redirect + execve; parent waits; 128+sig on signal-death (no fake success).
52func g_run(path: *u8, argv: *i64, redir_out: i64, redir_err: i64) -> i64 {
53 let pid: i64 = sys_fork()
54 if pid == 0 {
55 if redir_out >= 0 { sys_dup3(redir_out, 1, 0) }
56 if redir_err >= 0 { sys_dup3(redir_err, 2, 0) }
57 sys_execve(path, argv, 0 as *i64)
58 sys_exit(127)
59 }
60 let st: *i64 = sys_mmap(16) as *i64
61 sys_wait4(pid, st, 0)
62 let sig: i64 = st[0] & 0x7f
63 if sig != 0 { return 128 + sig }
64 return (st[0] >> 8) & 0xff
65}
66// rebuild+run a materialized piece by basename via the sovereign lane; returns its run-exit.
67func g_rebuild_run(basename: *u8) -> i64 {
68 let builder: *u8 = "_offc/nx_sov_build_run.elf" as *u8
69 let a: *i64 = sys_mmap(32) as *i64
70 a[0] = builder as i64
71 a[1] = basename as i64
72 a[2] = 0
73 return g_run(builder, a, 0 - 1, 0 - 1)
74}
75// one manifest row: id \t source \t hash \t layer \t kat \n
76func g_man_row(fd: i64, id: *u8, src: *u8, hash: i64, layer: i64, kat: i64) -> i64 {
77 g_puts_fd(fd, id); g_tab(fd)
78 g_puts_fd(fd, src); g_tab(fd)
79 g_putn(fd, hash); g_tab(fd)
80 g_putn(fd, layer); g_tab(fd)
81 g_putn(fd, kat); sys_write(fd, "\n" as *u8, 1)
82 return 0
83}
84
85func main() -> i64 {
86 g_puts("================================================================\n" as *u8)
87 g_puts(" GERMINATION MANIFEST -- layered multi-piece seed: pack -> emit ->\n" as *u8)
88 g_puts(" germinate each (hash+rebuild+KAT) in layer order; tamper rejected.\n" as *u8)
89 g_puts("================================================================\n" as *u8)
90
91 // ---- inline piece table (the seed's pieces; layer = hardware-up order, pre-sorted) ----
92 let ids: *i64 = sys_mmap(8 * N_PIECES) as *i64
93 let srcs: *i64 = sys_mmap(8 * N_PIECES) as *i64
94 let scratches: *i64 = sys_mmap(8 * N_PIECES) as *i64
95 let bases: *i64 = sys_mmap(8 * N_PIECES) as *i64
96 let layers: *i64 = sys_mmap(8 * N_PIECES) as *i64
97 let kats: *i64 = sys_mmap(8 * N_PIECES) as *i64
98 let hashes: *i64 = sys_mmap(8 * N_PIECES) as *i64
99
100 ids[0] = ("nx_exit42" as *u8) as i64
101 srcs[0] = ("runtime/nx_exit42.nx" as *u8) as i64
102 scratches[0] = ("runtime/_germ_man_nx_exit42.nx" as *u8) as i64
103 bases[0] = ("_germ_man_nx_exit42" as *u8) as i64
104 layers[0] = 0; kats[0] = 42
105
106 ids[1] = ("nx_kat_add7" as *u8) as i64
107 srcs[1] = ("runtime/nx_kat_add7.nx" as *u8) as i64
108 scratches[1] = ("runtime/_germ_man_nx_kat_add7.nx" as *u8) as i64
109 bases[1] = ("_germ_man_nx_kat_add7" as *u8) as i64
110 layers[1] = 1; kats[1] = 7
111
112 // ---- PACK: FNV-1a each source, emit germination_manifest.tsv ----
113 g_puts("\n [PACK] hash sources -> emit manifest\n" as *u8)
114 let mfd: i64 = sys_openat_wr(MAN_PATH, 0x1a4)
115 if mfd < 0 { g_puts(" FAIL: cannot write manifest\n" as *u8); sys_exit(10); return 10 }
116 g_puts_fd(mfd, "# germination_manifest.tsv -- AUTHORED by nx_spore_manifest_gate (PACK). cols: id <tab> source <tab> hash <tab> layer <tab> kat_expect\n" as *u8)
117 var i: i64 = 0
118 while i < N_PIECES {
119 let lenp: *i64 = sys_mmap(8) as *i64
120 let b: *u8 = sys_read_file((srcs[i]) as *u8, lenp)
121 let n: i64 = *lenp
122 if (b as i64) == 0 { g_puts(" FAIL: unreadable source\n" as *u8); sys_close(mfd); sys_exit(11); return 11 }
123 if n <= 0 { g_puts(" FAIL: empty source\n" as *u8); sys_close(mfd); sys_exit(11); return 11 }
124 hashes[i] = germ_hash(b, n)
125 g_man_row(mfd, (ids[i]) as *u8, (srcs[i]) as *u8, hashes[i], layers[i], kats[i])
126 g_puts(" packed " as *u8); g_puts((ids[i]) as *u8); g_puts(" layer=" as *u8); g_putn(1, layers[i]); g_puts(" bytes=" as *u8); g_putn(1, n); g_puts("\n" as *u8)
127 i = i + 1
128 }
129 sys_close(mfd)
130 g_puts(" manifest -> " as *u8); g_puts(MAN_PATH); g_puts("\n" as *u8)
131
132 // ---- GERMINATE in layer order: integrity -> materialize -> rebuild -> KAT ----
133 g_puts("\n [GERMINATE] layer-ordered\n" as *u8)
134 var admitted: i64 = 0
135 i = 0
136 while i < N_PIECES {
137 g_puts(" piece " as *u8); g_puts((ids[i]) as *u8); g_puts(" (layer " as *u8); g_putn(1, layers[i]); g_puts("): " as *u8)
138 let lenp: *i64 = sys_mmap(8) as *i64
139 let recv: *u8 = sys_read_file((srcs[i]) as *u8, lenp)
140 let n: i64 = *lenp
141 let rh: i64 = germ_hash(recv, n)
142 if rh != hashes[i] {
143 g_puts("INTEGRITY mismatch -> REJECT (never built)\n" as *u8)
144 } else {
145 let wfd: i64 = sys_openat_wr((scratches[i]) as *u8, 0x1a4)
146 if wfd < 0 {
147 g_puts("materialize FAIL\n" as *u8)
148 } else {
149 sys_write(wfd, recv, n)
150 sys_close(wfd)
151 let rc: i64 = g_rebuild_run((bases[i]) as *u8)
152 g_puts("germ_rc=" as *u8); g_putn(1, rc); g_puts(" (kat=" as *u8); g_putn(1, kats[i]); g_puts(") " as *u8)
153 if rc == kats[i] { admitted = admitted + 1; g_puts("ADMIT\n" as *u8) } else { g_puts("REJECT(kat)\n" as *u8) }
154 }
155 }
156 i = i + 1
157 }
158
159 // ---- NEGATIVE control: tamper piece 0's received bytes -> integrity reject ----
160 g_puts("\n [NEG] tamper " as *u8); g_puts((ids[0]) as *u8); g_puts(": " as *u8)
161 var neg_reject: i64 = 0
162 let lp: *i64 = sys_mmap(8) as *i64
163 let ob: *u8 = sys_read_file((srcs[0]) as *u8, lp)
164 let on: i64 = *lp
165 let cor: *u8 = sys_mmap(on + 16)
166 var c: i64 = 0
167 while c < on { cor[c] = ob[c]; c = c + 1 }
168 cor[0] = (cor[0] ^ 1) as u8
169 if germ_hash(cor, on) != hashes[0] { neg_reject = 1; g_puts("hash MISMATCH -> REJECTED pre-build\n" as *u8) } else { g_puts("collision?! gate broken\n" as *u8) }
170
171 // ---- READ-BACK: the emitted manifest persisted with N data rows ----
172 let rbp: *i64 = sys_mmap(8) as *i64
173 let mb: *u8 = sys_read_file(MAN_PATH, rbp)
174 let mn: i64 = *rbp
175 var nl: i64 = 0
176 var j: i64 = 0
177 while j < mn { if mb[j] == (10 as u8) { nl = nl + 1 } j = j + 1 }
178 let data_rows: i64 = nl - 1 // minus the # header line
179 g_puts("\n [READ-BACK] manifest data rows=" as *u8); g_putn(1, data_rows); g_puts(" (expect " as *u8); g_putn(1, N_PIECES); g_puts(")\n" as *u8)
180
181 // ---- VERDICT (sealed): GREEN iff exactly the known answer ----
182 var green: i64 = 1
183 if admitted != N_PIECES { green = 0 }
184 if neg_reject != 1 { green = 0 }
185 if data_rows != N_PIECES { green = 0 }
186
187 let lfd: i64 = sys_openat_append("knowledge/status/spore_germ.log" as *u8, 0x1a4)
188 if lfd >= 0 {
189 g_puts_fd(lfd, "SPOREMANIFEST-GATE epoch=" as *u8); g_putn(lfd, sys_now_realtime_sec())
190 g_puts_fd(lfd, " pieces=" as *u8); g_putn(lfd, N_PIECES)
191 g_puts_fd(lfd, " admitted=" as *u8); g_putn(lfd, admitted)
192 g_puts_fd(lfd, " neg_reject=" as *u8); g_putn(lfd, neg_reject)
193 g_puts_fd(lfd, " manifest_rows=" as *u8); g_putn(lfd, data_rows)
194 if green == 1 { g_puts_fd(lfd, " verdict=GREEN\n" as *u8) } else { g_puts_fd(lfd, " verdict=RED\n" as *u8) }
195 sys_close(lfd)
196 }
197
198 g_puts("----------------------------------------------------------------\n" as *u8)
199 // MIGRATED onto nx_gate_verdict by nx_gate_dry_apply (D001, minimal form): every check
200 // row above is untouched, so the PASS/FAIL vector cannot change; only the hand-rolled
201 // verdict emission is replaced by the ONE shared base class. Proven by nx_gate_migrate verify.
202 let ctr__dry: *i64 = gv_ctr()
203 ctr__dry[0] = green
204 ctr__dry[1] = 1
205 let rc__dry: i64 = gv_verdict("SPORE-MANIFEST-GATE" as *u8, ctr__dry, "a layered multi-piece seed was emitted; every piece" as *u8)
206 sys_exit(rc__dry)
207 return rc__dry
208}