liris: add odysseus scientific 3d field

docs/LIRIS-ODYSSEUS-SCIENTIFIC-3D-FIELD-2026-06-14.hbp

@@ -0,0 +1,7 @@
+ODYSCI3DCANONHDR|doc=LIRIS-ODYSSEUS-SCIENTIFIC-3D-FIELD-2026-06-14|date=2026-06-14|owner=liris|scope=odysseus-mtp-scientific-3d-pid-field-for-acer-cross-check|tag=DESCRIPTOR-ONLY|json=0
+ODYSCI3DCANONMATH|source=tools/behcs/pre-existence-graph-exporter.mjs|formula=bh_index-sector*3072+lane*1024+glyph|cylinder_phase=bh_index-mod-6|cylinder_ring=floor-bh_index-div-6|distance=abs-delta-bh_index|json=0
+ODYSCI3DCANONVIEW|viewer=reports/odysseus-mtp-scientific-3d.html|shows=real-coordinate-voxels+host-PID-descriptor-voxels+six-cylinder-phases+prime-cube-anchors+watcher-lanes+coordinate-table|json=0
+ODYSCI3DCANONEVENTS|event_feed=deterministic-coordinate-replay-manifest|not_live_pid_telemetry=1|not_nanosecond_process-tracking=1|process_launch=0|json=0
+ODYSCI3DCANONACER|cross_check=run-tools/behcs/odysseus-scientific-3d-field.mjs-and-compare-ODYSCI3D-rows|acer_may_add=live-telemetry-contract-or-phone-render-needs-after-attack|json=0
+ODYSCI3DCANONGATE|provider_terms_apply=1|device_effect=0|cutover=0|process_launch=0|phone_render_not_claimed_by-this-descriptor=1|json=0
+ODYSCI3DCANONFTR|status=SEALED-SCIENTIFIC-3D-FIELD-DESCRIPTOR|next=acer-cross-check-then-add-live-telemetry-needs-if-real|json=0

docs/LIRIS-ODYSSEUS-SCIENTIFIC-3D-FIELD-2026-06-14.hbp.sha256

@@ -0,0 +1 @@
+7BC2E390AE502A2E041BB4A572F51BF519B6E2DFC33E8C3D98CE6A8D19426F01  LIRIS-ODYSSEUS-SCIENTIFIC-3D-FIELD-2026-06-14.hbp

reports/odysseus-mtp-scientific-3d.html.sha256

@@ -0,0 +1 @@
+DF0D4FB43018B7C49EB1B4CF1B07F699AB7348421A362FAA10DE94A0D3FF4E20  odysseus-mtp-scientific-3d.html

tests/fabric-agent-preload-catalog.unit.test.mjs

@@ -38,6 +38,7 @@ test('preload catalog includes the laws, tools, roles, and cadence agents need',
   assert.ok(TOOLS.some((t) => t.id === 'frozen-slice-city-signal-lifecycle' && t.gate.includes('measured_200ns-0')));
   assert.ok(TOOLS.some((t) => t.id === 'eight-byte-host-process-upgrade' && t.gate.includes('provider_compute_replaced-0')));
   assert.ok(TOOLS.some((t) => t.id === 'odysseus-mtp-control-surface' && t.gate.includes('phone_render_proven_here-0')));
+  assert.ok(TOOLS.some((t) => t.id === 'odysseus-scientific-3d-field' && t.gate.includes('live_pid_telemetry-0')));
   assert.ok(ROLES.some((r) => r.id === 'flywheel' && r.must_do.includes('compare-to-acer-local-truth')));
   assert.ok(WORKFLOW.join('-').includes('memory-index-plan'));
   assert.equal(toolById('token-cube-catalog-binder').gate, 'mint-write-live-DEFER_TO_OPERATOR');

tests/fabric-agent-preload-catalog.unit.test.mjs.sha256

@@ -1 +1 @@
-8FA46CF24BF6AE488875682041E7409DA31F37607C193B1E4F04B8EC23A3EC9A  fabric-agent-preload-catalog.unit.test.mjs
+5B5B2E6BD8D80657AF30E1541A14B2DF2B852C150567C97B637089C3312E4B49  fabric-agent-preload-catalog.unit.test.mjs

tests/odysseus-scientific-3d-field.unit.test.mjs

@@ -0,0 +1,53 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import test from 'node:test';
+
+import {
+  DEFAULT_FIELD_NODES, FIELD_ID, VIEWER_REPORT,
+  buildScientificField, emitRows, selfTest,
+} from '../tools/behcs/odysseus-scientific-3d-field.mjs';
+
+test('odysseus scientific 3D field self-test passes', () => {
+  assert.equal(selfTest().ok, true);
+});
+
+test('field uses real BH coordinates from the pre-existence graph', () => {
+  const field = buildScientificField();
+  assert.equal(field.tool, FIELD_ID);
+  assert.equal(field.viewer_report, VIEWER_REPORT);
+  assert.equal(field.summary.nodes, DEFAULT_FIELD_NODES);
+  assert.equal(field.summary.phases, 6);
+  assert.ok(field.coordinates.every((n) => n.bh_index === n.sector * 3072 + n.lane * 1024 + n.glyph));
+  assert.ok(field.coordinates.every((n) => n.cylinder_phase === n.bh_index % 6));
+  assert.ok(field.coordinates.every((n) => n.cylinder_ring === Math.floor(n.bh_index / 6)));
+});
+
+test('host PID descriptors are plotted separately from potential field voxels', () => {
+  const field = buildScientificField();
+  assert.deepEqual(new Set(field.hosts.map((h) => h.agent_type)), new Set(['LOGICAL-WAVE', 'FROZEN-BRAIN', 'REAL-FREE']));
+  assert.ok(field.hosts.every((h) => h.host_handle_bytes === 8 && h.node_per_agent === 0 && h.process_launch === 0));
+  assert.ok(field.coordinates.every((n) => n.triad_state === 'POTENTIAL' && n.process_launch === 0));
+});
+
+test('coordinate event replay is explicitly not live nanosecond telemetry', () => {
+  const field = buildScientificField({ nodes: 64, frames: 16 });
+  assert.equal(field.summary.live_pid_telemetry, false);
+  assert.equal(field.summary.coordinate_replay_only, true);
+  assert.equal(field.replay.length, 16);
+  assert.ok(field.replay.every((e) => e.kind === 'COORDINATE_REPLAY_NOT_LIVE_TELEMETRY'));
+  assert.ok(field.replay.every((e) => e.live_pid_telemetry === 0 && e.process_launch === 0));
+});
+
+test('emitted rows are HBP-only and cross-checkable by Acer', () => {
+  const rows = emitRows({ nodes: 64, frames: 16 });
+  assert.ok(rows.every((row) => row.endsWith('|json=0') && !/[{\r\n]/.test(row)));
+  assert.ok(rows.some((row) => row.startsWith('ODYSCI3DMATH|') && row.includes('bh_index=sector*3072+lane*1024+glyph')));
+  assert.ok(rows.some((row) => row.startsWith('ODYSCI3DHOST|') && row.includes('host_handle_bytes=8')));
+  assert.ok(rows.some((row) => row.startsWith('ODYSCI3DEVENT|') && row.includes('live_pid_telemetry=0')));
+  assert.ok(rows.some((row) => row.startsWith('ODYSCI3DGATE|') && row.includes('not-live-nanosecond-PID-telemetry')));
+});
+
+test('tool stays descriptor-only and does not launch UI or devices', () => {
+  const source = readFileSync(new URL('../tools/behcs/odysseus-scientific-3d-field.mjs', import.meta.url), 'utf8');
+  assert.doesNotMatch(source, /from ['"]node:fs['"]|child_process|\bexecFile\b|\bexecSync\b|\bspawn\(|\bfetch\(|Invoke-WebRequest|Start-Process|node:http|node:net|createWriteStream/);
+});

tests/odysseus-scientific-3d-field.unit.test.mjs.sha256

@@ -0,0 +1 @@
+747C213D830CC34F57105AEBCF2FCC60CDE80CF5F44695568A63844178468D83  odysseus-scientific-3d-field.unit.test.mjs

tests/supervisor-collision-router.system.test.mjs

@@ -97,6 +97,7 @@ const sealedFiles = [
   'docs/LIRIS-FROZEN-SLICE-CITY-SIGNAL-LIFECYCLE-2026-06-14.hbp',
   'docs/LIRIS-EIGHT-BYTE-HOST-PROCESS-UPGRADE-2026-06-14.hbp',
   'docs/LIRIS-ODYSSEUS-MTP-CONTROL-SURFACE-2026-06-14.hbp',
+  'docs/LIRIS-ODYSSEUS-SCIENTIFIC-3D-FIELD-2026-06-14.hbp',
   'docs/ACER-SLICE-ENGINE-LIVE-CRANK-RECEIPT-2026-06-13.hbp',
   'docs/LIRIS-ROUTE-HEALTH-BASELINE-2026-06-13.hbp',
   'docs/ACER-ROUTE-HEALTH-CROSS-VANTAGE-2026-06-13.hbp',
@@ -245,6 +246,7 @@ const sealedFiles = [
   'tools/behcs/frozen-slice-city-signal-lifecycle.mjs',
   'tools/behcs/eight-byte-host-process-upgrade.mjs',
   'tools/behcs/odysseus-mtp-control-surface.mjs',
+  'tools/behcs/odysseus-scientific-3d-field.mjs',
   'tools/behcs/logical-extreme-stress.mjs',
   'tools/behcs/logical-stress-cube-feed.mjs',
   'tools/behcs/brown-hilbert-expansion-stress.mjs',
@@ -287,6 +289,7 @@ const sealedFiles = [
   'tests/frozen-slice-city-signal-lifecycle.unit.test.mjs',
   'tests/eight-byte-host-process-upgrade.unit.test.mjs',
   'tests/odysseus-mtp-control-surface.unit.test.mjs',
+  'tests/odysseus-scientific-3d-field.unit.test.mjs',
   'tests/logical-extreme-stress.unit.test.mjs',
   'tests/logical-stress-cube-feed.unit.test.mjs',
   'tests/brown-hilbert-expansion-stress.unit.test.mjs',

tests/supervisor-collision-router.system.test.mjs.sha256

@@ -1 +1 @@
-853F2019B6FFCBACC56227AA0045E3094DD00EE411FE7E8EF3A8CF03790F33DF  supervisor-collision-router.system.test.mjs
+AEE67D564FBA535D768DC9B098593298258C2025AD810A5F8723371B2D167319  supervisor-collision-router.system.test.mjs

tools/behcs/fabric-agent-preload-catalog.mjs

@@ -177,6 +177,12 @@ export const TOOLS = Object.freeze([
     provides: 'odysseus-pattern-MTP-descriptor-backed-control-surface-plus-v8-map3d-band',
     gate: 'descriptor-only-live_execution-0-cutover-0-phone_render_proven_here-0',
   }),
+  Object.freeze({
+    id: 'odysseus-scientific-3d-field',
+    path: 'tools/behcs/odysseus-scientific-3d-field.mjs',
+    provides: 'scientific-3d-PID-coordinate-field-with-real-BH-coordinates-and-cross-check-replay',
+    gate: 'descriptor-only-process_launch-0-live_pid_telemetry-0-device_effect-0',
+  }),
   Object.freeze({
     id: 'token-cube-catalog-binder',
     path: 'tools/behcs/token-cube-catalog-binder.mjs',
@@ -351,7 +357,7 @@ export function selfTest() {
     && !!toolById('agent-cost-layer-boundary') && !!toolById('triad-host-router-gulp-pipeline')
     && !!toolById('pid-emitter-cost-envelope') && !!toolById('cellphone-host-bridge-boundary')
     && !!toolById('frozen-slice-city-signal-lifecycle') && !!toolById('eight-byte-host-process-upgrade')
-    && !!toolById('odysseus-mtp-control-surface'));
+    && !!toolById('odysseus-mtp-control-surface') && !!toolById('odysseus-scientific-3d-field'));
   add('slice-engine-law-preloaded', LAWS.some((law) => law.startsWith('slice-engine-law-'))
     && emitPreloadRows().some((row) => row.startsWith('FABPRELOADSLICEENGINE|')));
   add('emitters-pipe-hookwall-gnn', EMITTERS.some((e) => e.id === 'hookwall') && EMITTERS.some((e) => e.id === 'gnn-edge'));

tools/behcs/fabric-agent-preload-catalog.mjs.sha256

@@ -1 +1 @@
-92DC04C5133E3768C175FB3241C34CBC354E733CE246B4D460E3BE256A42AF2A  fabric-agent-preload-catalog.mjs
+8F1B63CE7891284CD55F8F7EA9071CEEBEF4D94C922EFB711DEC078F1AA154BE  fabric-agent-preload-catalog.mjs

tools/behcs/odysseus-scientific-3d-field.mjs

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+// odysseus-scientific-3d-field.mjs - cross-checkable scientific 3D PID field.
+//
+// Descriptor-only. This binds the Odysseus/MTP control surface to the real
+// pre-existence coordinate graph for a scientific viewer: sector/lane/glyph,
+// bh_index, mod-6 cylinders, watcher lanes, prime-cube anchors, and host PID
+// descriptors. It does not claim live nanosecond telemetry, spawn processes,
+// open a browser, or run the phone UI.
+
+import { createHash } from 'node:crypto';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { buildUpgrade } from './eight-byte-host-process-upgrade.mjs';
+import { buildSurface } from './odysseus-mtp-control-surface.mjs';
+import { PRIME_CUBE_PRIMES, PRIME_CUBES, runExporter } from './pre-existence-graph-exporter.mjs';
+
+export const FIELD_ID = 'odysseus-scientific-3d-field.v1';
+export const DEFAULT_FIELD_NODES = 512;
+export const DEFAULT_EVENT_FRAMES = 96;
+export const VIEWER_REPORT = 'reports/odysseus-mtp-scientific-3d.html';
+
+const sha16 = (text) => createHash('sha256').update(String(text), 'utf8').digest('hex').slice(0, 16);
+const isObj = (x) => x !== null && typeof x === 'object';
+const safe = (x) => String(x ?? '').replace(/[|\r\n]/g, '_').replace(/[^A-Za-z0-9._:/+@=()-]+/g, '-').replace(/^-|-$/g, '') || 'empty';
+const prop = (obj, key, fallback = '') => {
+  try { return isObj(obj) ? obj[key] : fallback; } catch { return fallback; }
+};
+
+function toCount(value, fallback, min = 1, max = 4096) {
+  const n = Number.parseInt(String(value ?? fallback), 10);
+  if (!Number.isFinite(n)) return fallback;
+  return Math.max(min, Math.min(max, n));
+}
+
+function coordinateRow(node) {
+  return Object.freeze({
+    name: safe(node.name),
+    pid: safe(node.pid),
+    sector: node.sector,
+    lane: node.lane,
+    glyph: node.glyph_binding,
+    bh_index: node.bh_index,
+    cylinder_phase: node.cylinder_phase,
+    cylinder_ring: node.cylinder_ring,
+    prime_band: node.prime_band,
+    prime_cube: node.prime_cube,
+    watcher_lane: safe(node.watcher_lane),
+    triad_state: safe(node.triad_state),
+    process_launch: 0,
+  });
+}
+
+function hostRow(host) {
+  return Object.freeze({
+    name: safe(host.name),
+    pid: safe(host.pid),
+    sha16: safe(host.sha16),
+    agent_type: safe(host.agent_type),
+    sector: host.sector,
+    lane: host.lane,
+    glyph: host.glyph,
+    bh_index: host.bh_index,
+    cylinder_phase: host.cylinder_phase,
+    cylinder_ring: host.cylinder_ring,
+    watcher: safe(host.watcher),
+    shape: safe(host.yin_yang_shape),
+    host_handle_bytes: host.host_handle_bytes,
+    node_per_agent: 0,
+    process_launch: 0,
+  });
+}
+
+function eventFrame(node, previous, index) {
+  const current = coordinateRow(node);
+  const prior = previous ? coordinateRow(previous) : current;
+  const delta = Math.abs(current.bh_index - prior.bh_index);
+  return Object.freeze({
+    index,
+    event_id: sha16([FIELD_ID, current.pid, index].join('|')),
+    kind: 'COORDINATE_REPLAY_NOT_LIVE_TELEMETRY',
+    pid: current.pid,
+    bh_index: current.bh_index,
+    cylinder_phase: current.cylinder_phase,
+    watcher_lane: current.watcher_lane,
+    delta_bh_index: delta,
+    triad_state: current.triad_state,
+    process_launch: 0,
+    live_pid_telemetry: 0,
+  });
+}
+
+export function buildScientificField(options = {}) {
+  const nodes = toCount(prop(options, 'nodes'), DEFAULT_FIELD_NODES, 6, 4096);
+  const frames = toCount(prop(options, 'frames'), DEFAULT_EVENT_FRAMES, 1, nodes);
+  const prefix = safe(prop(options, 'prefix') || 'SCI-PID');
+  const prex = runExporter({ nodes, prefix });
+  const upgrade = buildUpgrade();
+  const surface = buildSurface();
+  const coordinates = prex.nodes.map(coordinateRow);
+  const hosts = upgrade.hosts.map(hostRow);
+  const replay = coordinates.slice(0, frames).map((node, i) => eventFrame(node, coordinates[i - 1], i));
+  const phases = new Set(coordinates.map((n) => n.cylinder_phase));
+  const watchers = new Set(coordinates.map((n) => n.watcher_lane));
+  return Object.freeze({
+    tool: FIELD_ID,
+    viewer_report: VIEWER_REPORT,
+    coordinate_contract: Object.freeze({
+      source: 'tools/behcs/pre-existence-graph-exporter.mjs',
+      formula: 'bh_index=sector*3072+lane*1024+glyph',
+      cylinder_phase: 'bh_index-mod-6',
+      cylinder_ring: 'floor-bh_index-div-6',
+      distance: 'abs-delta-bh_index',
+      state: 'POTENTIAL-coordinate-field-not-live-process',
+    }),
+    prime_cube_primes: PRIME_CUBE_PRIMES,
+    prime_cubes: PRIME_CUBES,
+    coordinates: Object.freeze(coordinates),
+    hosts: Object.freeze(hosts),
+    replay: Object.freeze(replay),
+    summary: Object.freeze({
+      nodes: coordinates.length,
+      hosts: hosts.length,
+      phases: phases.size,
+      watchers: watchers.size,
+      lane_counts: prex.summary.lane_counts.join(','),
+      mtp_descriptor_backed: surface.summary.mtp_descriptor_backed,
+      process_launch: 0,
+      live_pid_telemetry: false,
+      coordinate_replay_only: true,
+    }),
+  });
+}
+
+export function emitRows(options = {}) {
+  try {
+    const field = buildScientificField(options);
+    const rows = [
+      `ODYSCI3DHDR|tool=${FIELD_ID}|viewer=${VIEWER_REPORT}|nodes=${field.summary.nodes}|hosts=${field.summary.hosts}|phases=${field.summary.phases}|watchers=${field.summary.watchers}|mtp_descriptor_backed=${field.summary.mtp_descriptor_backed}|process_launch=0|live_pid_telemetry=0|json=0`,
+      `ODYSCI3DMATH|formula=${field.coordinate_contract.formula}|cylinder_phase=${field.coordinate_contract.cylinder_phase}|cylinder_ring=${field.coordinate_contract.cylinder_ring}|distance=${field.coordinate_contract.distance}|state=${field.coordinate_contract.state}|json=0`,
+      `ODYSCI3DPRIMES|prime_cube_primes=${field.prime_cube_primes.join('+')}|prime_cubes=${field.prime_cubes.join('+')}|json=0`,
+    ];
+    for (const host of field.hosts) {
+      rows.push(`ODYSCI3DHOST|name=${host.name}|agent_type=${host.agent_type}|pid_sha16=${host.sha16}|sector=${host.sector}|lane=${host.lane}|glyph=${host.glyph}|bh_index=${host.bh_index}|phase=${host.cylinder_phase}|ring=${host.cylinder_ring}|watcher=${host.watcher}|shape=${host.shape}|host_handle_bytes=${host.host_handle_bytes}|node_per_agent=0|process_launch=0|json=0`);
+    }
+    for (const node of field.coordinates.slice(0, 18)) {
+      rows.push(`ODYSCI3DCOORD|name=${node.name}|pid_sha16=${sha16(node.pid)}|sector=${node.sector}|lane=${node.lane}|glyph=${node.glyph}|bh_index=${node.bh_index}|phase=${node.cylinder_phase}|ring=${node.cylinder_ring}|prime_band=${node.prime_band}|prime_cube=${node.prime_cube}|watcher=${node.watcher_lane}|triad_state=${node.triad_state}|process_launch=0|json=0`);
+    }
+    for (const event of field.replay.slice(0, 12)) {
+      rows.push(`ODYSCI3DEVENT|index=${event.index}|event_id=${event.event_id}|kind=${event.kind}|pid_sha16=${sha16(event.pid)}|bh_index=${event.bh_index}|phase=${event.cylinder_phase}|watcher=${event.watcher_lane}|delta_bh_index=${event.delta_bh_index}|triad_state=${event.triad_state}|process_launch=0|live_pid_telemetry=0|json=0`);
+    }
+    rows.push('ODYSCI3DGATE|rule=scientific-viewer-plots-real-coordinate-field-and-deterministic-replay-only-not-live-nanosecond-PID-telemetry|provider_terms_apply=1|process_launch=0|device_effect=0|cutover=0|json=0');
+    return rows;
+  } catch {
+    return [
+      `ODYSCI3DHDR|tool=${FIELD_ID}|viewer=${VIEWER_REPORT}|nodes=0|hosts=0|phases=0|watchers=0|process_launch=0|live_pid_telemetry=0|json=0`,
+      'ODYSCI3DGATE|rule=emit-threw-held-invalid|provider_terms_apply=1|process_launch=0|device_effect=0|cutover=0|json=0',
+    ];
+  }
+}
+
+export function selfTest() {
+  const checks = [];
+  const add = (name, ok) => checks.push({ name, ok: Boolean(ok) });
+  const field = buildScientificField();
+  add('uses-real-preexistence-coordinate-volume', field.summary.nodes === DEFAULT_FIELD_NODES && field.coordinates.every((n) => n.bh_index === n.sector * 3072 + n.lane * 1024 + n.glyph));
+  add('six-cylinder-phases-present', field.summary.phases === 6 && field.coordinates.every((n) => n.cylinder_phase === n.bh_index % 6 && n.cylinder_ring === Math.floor(n.bh_index / 6)));
+  add('rule-of-three-watchers-present', field.summary.watchers === 3 && field.coordinates.some((n) => n.watcher_lane === 'hookwall') && field.coordinates.some((n) => n.watcher_lane === 'gnn') && field.coordinates.some((n) => n.watcher_lane === 'shannon'));
+  add('host-descriptors-are-separate-and-held', field.hosts.length === 3 && field.hosts.every((h) => h.host_handle_bytes === 8 && h.node_per_agent === 0 && h.process_launch === 0));
+  add('replay-is-not-live-telemetry', field.summary.coordinate_replay_only === true && field.summary.live_pid_telemetry === false && field.replay.every((e) => e.kind === 'COORDINATE_REPLAY_NOT_LIVE_TELEMETRY' && e.live_pid_telemetry === 0 && e.process_launch === 0));
+  add('odysseus-mtp-bound', field.summary.mtp_descriptor_backed === 3);
+  add('prime-cube-anchors-bound', field.prime_cube_primes.length === 11 && field.prime_cubes.includes(13 ** 3) && field.prime_cubes.includes(131 ** 3));
+  add('rows-hbp-only', emitRows({ prefix: 'bad|prefix\nODYSCI3DGATE|process_launch=1' }).every((row) => row.endsWith('|json=0') && !/[\r\n{]/.test(row)));
+  add('total-never-throws', (() => { try { buildScientificField({ get nodes() { throw new Error('boom'); } }); emitRows(null); return true; } catch { return false; } })());
+  return { ok: checks.every((c) => c.ok), checks };
+}
+
+const isMain = process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1]);
+if (isMain) {
+  if (process.argv[2] === '--self-test') {
+    const r = selfTest();
+    for (const c of r.checks) console.log(`${c.ok ? 'PASS' : 'FAIL'} ${c.name}`);
+    process.exit(r.ok ? 0 : 1);
+  }
+  for (const row of emitRows()) console.log(row);
+}

tools/behcs/odysseus-scientific-3d-field.mjs.sha256

@@ -0,0 +1 @@
+3D7BBE4023C77AC53244C1A6756BA11B310D75A12D070FEB3A9DAAF9A42B9F04  odysseus-scientific-3d-field.mjs