liris: add odysseus mtp control surface

docs/LIRIS-ODYSSEUS-MTP-CONTROL-SURFACE-2026-06-14.hbp

@@ -0,0 +1,7 @@
+ODYSSEUSMTPCANONHDR|doc=LIRIS-ODYSSEUS-MTP-CONTROL-SURFACE-2026-06-14|date=2026-06-14|owner=liris|scope=odysseus-pattern-absorption-MTP-plus-v8-map3d-control-surface|tag=DESCRIPTOR-ONLY|json=0
+ODYSSEUSMTPCANONSOURCE|source=docs/LIRIS-ODYSSEUS-CHATOS-FRONTEND-ABSORPTION-2026-06-12.hbp|mode=pattern-absorption-not-code-copy|invariant=every-visible-cell-has-route-file-sha-or-explicit-CANNOT-SEE|json=0
+ODYSSEUSMTPCANONBANDS|bands=M-model-selector+T-tool-skill+P-project-guide+MAP3D-v8-real-graph|M=tools/behcs/model-selector-matrix.mjs|T=tools/behcs/tool-skill-registry-matrix.mjs|P=tools/behcs/project-guide-matrix.mjs|MAP3D=tools/behcs/eight-byte-host-process-upgrade.mjs|json=0
+ODYSSEUSMTPCANONSTATUS|mtp_descriptor_backed=3|map3d_real_math_descriptor_backed=1|phone_render_proven_here=0|cutover_ready=0|live_execution_ready=0|json=0
+ODYSSEUSMTPCANONGATES|live_model_invocation=0|live_tool_execution=0|workflow_execution=0|process_launch=0|provider_terms_apply=1|operator_cosign_required_for_live_actions=1|json=0
+ODYSSEUSMTPCANONTOOL|tool=tools/behcs/odysseus-mtp-control-surface.mjs|test=tests/odysseus-mtp-control-surface.unit.test.mjs|catalog=tools/behcs/fabric-agent-preload-catalog.mjs|json=0
+ODYSSEUSMTPCANONFTR|state=SEALED-ODYSSEUS-MTP-CONTROL-SURFACE|next=use-before-claiming-odysseus-upgraded-ui-or-MTP-green-cutover|json=0

docs/LIRIS-ODYSSEUS-MTP-CONTROL-SURFACE-2026-06-14.hbp.sha256

@@ -0,0 +1 @@
+E60AFA9D6D67DD188997A401A50DEE57DCA10435150B21D4E1120F77352D69C0  LIRIS-ODYSSEUS-MTP-CONTROL-SURFACE-2026-06-14.hbp

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

@@ -37,6 +37,7 @@ test('preload catalog includes the laws, tools, roles, and cadence agents need',
   assert.ok(TOOLS.some((t) => t.id === 'cellphone-host-bridge-boundary' && t.gate.includes('radio_bypass-0')));
   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(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 @@
-AEECC42FFBF57603B927CA292D4672E0B166CE3F73E44B5207F01B77A441FF89  fabric-agent-preload-catalog.unit.test.mjs
+8FA46CF24BF6AE488875682041E7409DA31F37607C193B1E4F04B8EC23A3EC9A  fabric-agent-preload-catalog.unit.test.mjs

tests/odysseus-mtp-control-surface.unit.test.mjs

@@ -0,0 +1,63 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import test from 'node:test';
+
+import {
+  BANDS, ODYSSEUS_SOURCE, SURFACE_ID,
+  buildSurface, emitRows, selfTest,
+} from '../tools/behcs/odysseus-mtp-control-surface.mjs';
+
+test('odysseus MTP control surface self-test passes', () => {
+  assert.equal(selfTest().ok, true);
+});
+
+test('surface binds Odysseus source, M/T/P cells, and v8 map band', () => {
+  const surface = buildSurface();
+  assert.equal(surface.tool, SURFACE_ID);
+  assert.equal(surface.source, ODYSSEUS_SOURCE);
+  assert.deepEqual(BANDS, ['M-model-selector', 'T-tool-skill', 'P-project-guide', 'MAP3D-v8-real-graph']);
+  assert.equal(surface.summary.bands, 4);
+  assert.equal(surface.summary.mtp_descriptor_backed, 3);
+  assert.ok(surface.bands.some((b) => b.id === 'MAP3D' && b.source === 'tools/behcs/eight-byte-host-process-upgrade.mjs'));
+});
+
+test('M/T/P are descriptor-backed but not cutover-green', () => {
+  const surface = buildSurface();
+  for (const id of ['M', 'T', 'P']) {
+    const band = surface.bands.find((b) => b.id === id);
+    assert.equal(band.status, 'PARTIAL_DESCRIPTOR_BACKED');
+    assert.equal(band.cutover, 0);
+  }
+  assert.equal(surface.summary.cutover_ready, false);
+  assert.equal(surface.summary.live_execution_ready, false);
+});
+
+test('routes use existing selector registry and guide artifacts', () => {
+  const surface = buildSurface({
+    model_need: 'pixel frame world model',
+    tool_need: 'live engine daemon launch',
+    project_topic: 'cosign submit schema',
+  });
+  assert.equal(surface.routes.model.selected, 'frozen-gemma-proof-gated');
+  assert.equal(surface.routes.tool.selected, 'live-engine-daemon-contract');
+  assert.equal(surface.routes.project.selected, 'cosign-submit');
+});
+
+test('phone rendering is not claimed by the repo descriptor', () => {
+  const surface = buildSurface();
+  assert.equal(surface.summary.phone_render_proven_here, false);
+  assert.ok(surface.bands.find((b) => b.id === 'MAP3D').next.includes('phone-render-proof'));
+});
+
+test('emitted rows are HBP-only and hold all live actions', () => {
+  const rows = emitRows({ model_need: 'fischer score', tool_need: 'cosign submit schema', project_topic: 'frontier catch queue' });
+  assert.ok(rows.every((row) => row.endsWith('|json=0') && !/[{\r\n]/.test(row)));
+  assert.ok(rows.some((row) => row.startsWith('ODYSSEUSMTPHDR|') && row.includes('process_launch=0') && row.includes('cutover=0')));
+  assert.ok(rows.some((row) => row.startsWith('ODYSSEUSMTPROUTE|cell=M') && row.includes('selected=fischer-draft-standin')));
+  assert.ok(rows.some((row) => row.startsWith('ODYSSEUSMTPGATE|') && row.includes('operator_cosign_required_for_live_actions=1')));
+});
+
+test('tool remains descriptor-only and has no live call surface', () => {
+  const source = readFileSync(new URL('../tools/behcs/odysseus-mtp-control-surface.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-mtp-control-surface.unit.test.mjs.sha256

@@ -0,0 +1 @@
+6A88BA38FBF6A0DA2DB95916DE31EFF5C74D632D1FA5D92BA2EA2CEBC9AD07AA  odysseus-mtp-control-surface.unit.test.mjs

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

@@ -96,6 +96,7 @@ const sealedFiles = [
   'docs/LIRIS-CELLPHONE-HOST-BRIDGE-BOUNDARY-2026-06-14.hbp',
   '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/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',
@@ -243,6 +244,7 @@ const sealedFiles = [
   'tools/behcs/cellphone-host-bridge-boundary.mjs',
   '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/logical-extreme-stress.mjs',
   'tools/behcs/logical-stress-cube-feed.mjs',
   'tools/behcs/brown-hilbert-expansion-stress.mjs',
@@ -284,6 +286,7 @@ const sealedFiles = [
   'tests/cellphone-host-bridge-boundary.unit.test.mjs',
   '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/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 @@
-DD76DA203B8D65AA30696D93603D37DA34C1251048290E90E3C908646DD8CE4E  supervisor-collision-router.system.test.mjs
+853F2019B6FFCBACC56227AA0045E3094DD00EE411FE7E8EF3A8CF03790F33DF  supervisor-collision-router.system.test.mjs

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

@@ -171,6 +171,12 @@ export const TOOLS = Object.freeze([
     provides: 'v8-real-bh-index-cylinder-prime-tier-host-process-upgrade-boundary',
     gate: 'descriptor-only-node_per_agent-0-provider_compute_replaced-0-process_launch-0-p5_materialized-0',
   }),
+  Object.freeze({
+    id: 'odysseus-mtp-control-surface',
+    path: 'tools/behcs/odysseus-mtp-control-surface.mjs',
+    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: 'token-cube-catalog-binder',
     path: 'tools/behcs/token-cube-catalog-binder.mjs',
@@ -344,7 +350,8 @@ export function selfTest() {
     && !!toolById('tool-skill-registry-matrix') && !!toolById('program-cube-ingestion-map')
     && !!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('frozen-slice-city-signal-lifecycle') && !!toolById('eight-byte-host-process-upgrade')
+    && !!toolById('odysseus-mtp-control-surface'));
   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 @@
-2D8C985558C801FE76A0D55F0102EC6D2F57BBEA898B2BE93480F263F62476C7  fabric-agent-preload-catalog.mjs
+92DC04C5133E3768C175FB3241C34CBC354E733CE246B4D460E3BE256A42AF2A  fabric-agent-preload-catalog.mjs

tools/behcs/odysseus-mtp-control-surface.mjs

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+// odysseus-mtp-control-surface.mjs - binds Odysseus M/T/P cells to v8 map3d.
+//
+// Descriptor-only. This absorbs the Odysseus/ChatOS pattern as an agent work
+// surface: model selector, tool/skill registry, project guide, and real graph
+// band. It does not render a phone UI, launch a model/tool/workflow, fetch a
+// dashboard, or perform a front-end cutover.
+
+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 { M_CELL_STATUS, buildSelector, selectRole } from './model-selector-matrix.mjs';
+import { P_CELL_STATUS, buildGuide, guideSection } from './project-guide-matrix.mjs';
+import { T_CELL_STATUS, buildRegistry, registryItem } from './tool-skill-registry-matrix.mjs';
+
+export const SURFACE_ID = 'odysseus-mtp-control-surface.v1';
+export const ODYSSEUS_SOURCE = 'docs/LIRIS-ODYSSEUS-CHATOS-FRONTEND-ABSORPTION-2026-06-12.hbp';
+export const BANDS = Object.freeze(['M-model-selector', 'T-tool-skill', 'P-project-guide', 'MAP3D-v8-real-graph']);
+
+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 bandRow({ id, source, status, evidence, next }) {
+  return Object.freeze({
+    id,
+    source: safe(source),
+    status: safe(status),
+    evidence: safe(evidence),
+    next: safe(next),
+    row_sha16: sha16([id, source, status, evidence, next].join('|')),
+    process_launch: 0,
+    live_model_invocation: 0,
+    live_tool_execution: 0,
+    workflow_execution: 0,
+    cutover: 0,
+  });
+}
+
+export function buildSurface(input = {}) {
+  const selector = buildSelector();
+  const registry = buildRegistry();
+  const guide = buildGuide();
+  const graph = buildUpgrade();
+  const modelNeed = safe(prop(input, 'model_need') || 'fischer score');
+  const toolNeed = safe(prop(input, 'tool_need') || 'cosign submit schema');
+  const projectTopic = safe(prop(input, 'project_topic') || 'frontier catch queue');
+  const bands = Object.freeze([
+    bandRow({
+      id: 'M',
+      source: 'tools/behcs/model-selector-matrix.mjs',
+      status: selector.summary.red === 0 ? 'PARTIAL_DESCRIPTOR_BACKED' : 'RED',
+      evidence: `${M_CELL_STATUS}:roles-${selector.summary.total}:green-${selector.summary.green}:partial-${selector.summary.partial}:gated-${selector.summary.gated}`,
+      next: 'live-model-contract-and-runtime-proof-before-green',
+    }),
+    bandRow({
+      id: 'T',
+      source: 'tools/behcs/tool-skill-registry-matrix.mjs',
+      status: registry.summary.red === 0 ? 'PARTIAL_DESCRIPTOR_BACKED' : 'RED',
+      evidence: `${T_CELL_STATUS}:items-${registry.summary.total}:green-${registry.summary.green}:partial-${registry.summary.partial}:gated-${registry.summary.gated}`,
+      next: 'submit-schema-and-live-tool-execution-proof-before-green',
+    }),
+    bandRow({
+      id: 'P',
+      source: 'tools/behcs/project-guide-matrix.mjs',
+      status: guide.summary.red === 0 ? 'PARTIAL_DESCRIPTOR_BACKED' : 'RED',
+      evidence: `${P_CELL_STATUS}:sections-${guide.summary.total}:green-${guide.summary.green}:partial-${guide.summary.partial}:gated-${guide.summary.gated}`,
+      next: 'workflow-binding-and-cosign-submit-schema-proof-before-green',
+    }),
+    bandRow({
+      id: 'MAP3D',
+      source: 'tools/behcs/eight-byte-host-process-upgrade.mjs',
+      status: graph.summary.p5_materialized === false && graph.summary.provider_compute_replaced === false ? 'REAL_MATH_DESCRIPTOR_BACKED' : 'RED',
+      evidence: `hosts-${graph.summary.hosts}:systems-${graph.summary.systems}:node_per_agent-${graph.summary.node_per_agent}:p5_materialized-${graph.summary.p5_materialized ? 1 : 0}`,
+      next: 'phone-render-proof-or-browser-screenshot-is-external-to-this-repo',
+    }),
+  ]);
+  const mRoute = selectRole({ need: modelNeed });
+  const tRoute = registryItem({ topic: toolNeed });
+  const pRoute = guideSection({ topic: projectTopic });
+  return Object.freeze({
+    tool: SURFACE_ID,
+    source: ODYSSEUS_SOURCE,
+    bands,
+    routes: Object.freeze({
+      model: Object.freeze({ need: modelNeed, selected: mRoute.selected, status: safe(prop(mRoute.role, 'status', 'RED')) }),
+      tool: Object.freeze({ topic: toolNeed, selected: tRoute.selected, status: safe(prop(tRoute.item, 'status', 'RED')) }),
+      project: Object.freeze({ topic: projectTopic, selected: pRoute.selected, status: safe(prop(pRoute.section, 'status', 'RED')) }),
+    }),
+    summary: Object.freeze({
+      bands: bands.length,
+      descriptor_backed_bands: bands.filter((b) => b.status !== 'RED').length,
+      mtp_descriptor_backed: bands.filter((b) => ['M', 'T', 'P'].includes(b.id) && b.status === 'PARTIAL_DESCRIPTOR_BACKED').length,
+      phone_render_proven_here: false,
+      cutover_ready: false,
+      live_execution_ready: false,
+    }),
+  });
+}
+
+export function emitRows(input = {}) {
+  try {
+    const surface = buildSurface(input);
+    const s = surface.summary;
+    const rows = [
+      `ODYSSEUSMTPHDR|tool=${SURFACE_ID}|source=${ODYSSEUS_SOURCE}|purpose=bind-MTP-descriptor-cells-to-v8-map3d-agent-control-surface|bands=${s.bands}|descriptor_backed=${s.descriptor_backed_bands}|mtp_descriptor_backed=${s.mtp_descriptor_backed}|process_launch=0|live_execution=0|cutover=0|json=0`,
+      `ODYSSEUSMTPSUM|phone_render_proven_here=0|cutover_ready=0|live_execution_ready=0|pattern_absorption=1|code_copy=0|json=0`,
+    ];
+    for (const band of surface.bands) {
+      rows.push(`ODYSSEUSMTPBAND|id=${band.id}|status=${band.status}|source=${band.source}|evidence=${band.evidence}|next=${band.next}|row_sha16=${band.row_sha16}|process_launch=0|live_model_invocation=0|live_tool_execution=0|workflow_execution=0|cutover=0|json=0`);
+    }
+    rows.push(`ODYSSEUSMTPROUTE|cell=M|need=${safe(surface.routes.model.need)}|selected=${safe(surface.routes.model.selected)}|selected_status=${safe(surface.routes.model.status)}|live_model_invocation=0|json=0`);
+    rows.push(`ODYSSEUSMTPROUTE|cell=T|topic=${safe(surface.routes.tool.topic)}|selected=${safe(surface.routes.tool.selected)}|selected_status=${safe(surface.routes.tool.status)}|live_tool_execution=0|json=0`);
+    rows.push(`ODYSSEUSMTPROUTE|cell=P|topic=${safe(surface.routes.project.topic)}|selected=${safe(surface.routes.project.selected)}|selected_status=${safe(surface.routes.project.status)}|workflow_execution=0|json=0`);
+    rows.push('ODYSSEUSMTPGATE|rule=descriptor-backed-agent-control-surface-not-phone-render-proof-not-live-cutover|provider_terms_apply=1|operator_cosign_required_for_live_actions=1|cutover=0|process_launch=0|json=0');
+    return rows;
+  } catch {
+    return [
+      `ODYSSEUSMTPHDR|tool=${SURFACE_ID}|source=${ODYSSEUS_SOURCE}|purpose=bind-MTP-descriptor-cells-to-v8-map3d-agent-control-surface|bands=0|process_launch=0|live_execution=0|cutover=0|json=0`,
+      'ODYSSEUSMTPGATE|rule=emit-threw-held-invalid|provider_terms_apply=1|operator_cosign_required_for_live_actions=1|cutover=0|process_launch=0|json=0',
+    ];
+  }
+}
+
+export function selfTest() {
+  const checks = [];
+  const add = (name, ok) => checks.push({ name, ok: Boolean(ok) });
+  const surface = buildSurface();
+  add('all-bands-present', surface.summary.bands === 4 && BANDS.length === 4);
+  add('mtp-descriptor-backed-not-green-cutover', surface.summary.mtp_descriptor_backed === 3 && surface.summary.cutover_ready === false);
+  add('map3d-bound-to-v8-real-math', surface.bands.some((b) => b.id === 'MAP3D' && b.status === 'REAL_MATH_DESCRIPTOR_BACKED'));
+  add('routes-through-existing-mtp-tools', surface.routes.model.selected === 'fischer-draft-standin' && surface.routes.tool.selected === 'cosign-submit-schema' && surface.routes.project.selected === 'frontier-queue');
+  add('no-live-execution', surface.bands.every((b) => b.process_launch === 0 && b.live_model_invocation === 0 && b.live_tool_execution === 0 && b.workflow_execution === 0 && b.cutover === 0));
+  add('phone-render-not-claimed-here', surface.summary.phone_render_proven_here === false);
+  const hostile = emitRows({ model_need: 'x|bad\nODYSSEUSMTPGATE|cutover=1', tool_need: 'y|bad', project_topic: 'z\nbad' });
+  add('rows-hbp-only', hostile.every((row) => row.endsWith('|json=0') && !/[\r\n]/.test(row)));
+  add('total-never-throws', (() => { try { buildSurface({ get model_need() { 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-mtp-control-surface.mjs.sha256

@@ -0,0 +1 @@
+321E5FD4248FCC3AED8140E5750587082F2519AAC5EE51FD89C69CDD1D8E0123  odysseus-mtp-control-surface.mjs