npm - privateboard - Versions diffs - 0.1.38 → 0.1.41 - Mend

privateboard 0.1.38 → 0.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

package/dist/boot.js +327 -50
package/dist/boot.js.map +1 -1
package/dist/cli.js +327 -50
package/dist/cli.js.map +1 -1
package/dist/server.js +201 -40
package/dist/server.js.map +1 -1
package/dist/version.d.ts +1 -1
package/dist/version.js +1 -1
package/dist/version.js.map +1 -1
package/package.json +1 -1
package/public/__avatar3d_test.html +156 -0
package/public/agent-overlay.css +14 -6
package/public/agent-overlay.js +6 -6
package/public/agent-profile.css +9 -12
package/public/agent-profile.js +91 -38
package/public/app.js +471 -528
package/public/avatar-3d-snap.js +205 -0
package/public/avatar-3d.js +836 -0
package/public/avatar-customizer.html +274 -0
package/public/avatar3d-editor.css +240 -0
package/public/avatar3d-editor.js +484 -0
package/public/avatars/3d/chair.png +0 -0
package/public/avatars/3d/first-principles.png +0 -0
package/public/avatars/3d/historian.png +0 -0
package/public/avatars/3d/long-horizon.png +0 -0
package/public/avatars/3d/phenomenologist.png +0 -0
package/public/avatars/3d/socrates.png +0 -0
package/public/avatars/3d/user-empathy.png +0 -0
package/public/avatars/3d/value-investor.png +0 -0
package/public/core-avatars.js +86 -0
package/public/home-3d-loader.js +15 -4
package/public/home-3d-mock.js +25 -14
package/public/home.html +78 -16
package/public/i18n.js +8 -4
package/public/icons/avatar_1779855104027.glb +0 -0
package/public/icons/logo.png +0 -0
package/public/icons/new-style.glb +0 -0
package/public/icons/new-style2.glb +0 -0
package/public/icons/new-style3.glb +0 -0
package/public/icons/new-style4.glb +0 -0
package/public/icons/new-style5.glb +0 -0
package/public/icons/new-style6.glb +0 -0
package/public/icons/office.glb +0 -0
package/public/icons/stuff.glb +0 -0
package/public/index.html +169 -141
package/public/magazine.html +1 -1
package/public/new-agent.js +46 -20
package/public/newspaper.html +1 -1
package/public/office-viewer.html +340 -0
package/public/ppt.html +1 -1
package/public/stuff-viewer.html +330 -0
package/public/thread.css +16 -15
package/public/user-settings.css +7 -31
package/public/user-settings.js +75 -89
package/public/vendor/BufferGeometryUtils.js +1434 -0
package/public/vendor/DRACOLoader.js +739 -0
package/public/vendor/GLTFLoader.js +4860 -0
package/public/vendor/RoomEnvironment.js +185 -0
package/public/vendor/SkeletonUtils.js +496 -0
package/public/vendor/draco/draco_decoder.js +34 -0
package/public/vendor/draco/draco_decoder.wasm +0 -0
package/public/vendor/draco/draco_encoder.js +33 -0
package/public/vendor/draco/draco_wasm_wrapper.js +117 -0
package/public/vendor/meshopt_decoder.module.js +196 -0
package/public/voice-3d-banner.js +19 -7
package/public/voice-3d.js +1407 -432
package/public/voice-replay.js +21 -0
package/public/avatar-skill.js +0 -629
package/public/avatars/chair-blink.svg +0 -1
package/public/avatars/chair.svg +0 -1
package/public/avatars/first-principles.svg +0 -1
package/public/avatars/historian.svg +0 -1
package/public/avatars/long-horizon.svg +0 -1
package/public/avatars/phenomenologist.svg +0 -1
package/public/avatars/socrates.svg +0 -1
package/public/avatars/user-empathy.svg +0 -1
package/public/avatars/value-investor.svg +0 -1
package/public/icons/folded-sidebar.png +0 -0

package/dist/version.d.ts CHANGED Viewed

@@ -12,6 +12,6 @@
  * number ends up surfaced in the user-facing footer or banner. Keep
  * this file as the canonical source — every callsite reads from here.
  */
-declare const VERSION = "0.1.38";
+declare const VERSION = "0.1.41";
 export { VERSION };

package/dist/version.js CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // src/version.ts
-var VERSION = "0.1.38";
+var VERSION = "0.1.41";
 export {
   VERSION
 };

package/dist/version.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/version.ts"],"sourcesContent":["/*\n Single source of truth for the app version.\n \n Imported by `cli.ts` (CLI banner / `--version`), `server.ts` (the\n * `/health` payload + the `/api/version` endpoint), and bundled into\n * the frontend via the version endpoint. Bump alongside `package.json`\n * on every release — the existing `npm version <patch\|minor\|major>`\n * + commit pattern updates package.json automatically; this file\n * needs the matching manual bump.\n \n If two strings drift (bumped one but not the other), the wrong\n * number ends up surfaced in the user-facing footer or banner. Keep\n * this file as the canonical source — every callsite reads from here.\n */\nexport const VERSION = \"0.1.38\";\n"],"mappings":";;;AAcO,IAAM,UAAU;","names":[]}
1	+ {"version":3,"sources":["../src/version.ts"],"sourcesContent":["/*\n Single source of truth for the app version.\n \n Imported by `cli.ts` (CLI banner / `--version`), `server.ts` (the\n * `/health` payload + the `/api/version` endpoint), and bundled into\n * the frontend via the version endpoint. Bump alongside `package.json`\n * on every release — the existing `npm version <patch\|minor\|major>`\n * + commit pattern updates package.json automatically; this file\n * needs the matching manual bump.\n \n If two strings drift (bumped one but not the other), the wrong\n * number ends up surfaced in the user-facing footer or banner. Keep\n * this file as the canonical source — every callsite reads from here.\n */\nexport const VERSION = \"0.1.41\";\n"],"mappings":";;;AAcO,IAAM,UAAU;","names":[]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "privateboard",
-  "version": "0.1.38",
+  "version": "0.1.41",
   "description": "PrivateBoard · your private board meeting, on call. Local-first, multi-agent thinking amplifier.",
   "type": "module",
   "main": "electron-entry.cjs",

package/public/__avatar3d_test.html ADDED Viewed

@@ -0,0 +1,156 @@
+<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>avatar3d test</title>
+<style>
+  html,body{margin:0;height:100%;background:#1a1a1a;overflow:hidden}
+  #status{position:fixed;top:8px;left:10px;color:#9fe;font:12px/1.5 monospace;z-index:9;white-space:pre-wrap;max-width:92vw}
+  #panel{position:fixed;top:8px;right:10px;z-index:9;background:rgba(0,0,0,.55);border:1px solid #444;border-radius:8px;padding:10px 12px;color:#cde;font:11px/1.6 monospace;width:230px}
+  #panel label{display:block;margin:6px 0 2px}
+  #panel input[type=range]{width:100%}
+  #panel b{color:#9fe}
+  #copy{margin-top:8px;width:100%;padding:5px;background:#2a3340;color:#cde;border:1px solid #556;border-radius:5px;cursor:pointer;font:11px monospace}
+</style>
+</head><body>
+<div id="status">booting…</div>
+<!-- Live brightness controls · drag to taste, then read the values off
+     the readout (or click "复制参数") and tell me — I'll bake them into
+     the room. -->
+<div id="panel">
+  <label>曝光 exposure · <b id="vExp">0.70</b></label>
+  <input type="range" id="exp" min="0.2" max="1.4" step="0.01" value="0.70">
+  <label>环境强度 envIntensity · <b id="vEnv">0.35</b></label>
+  <input type="range" id="env" min="0" max="1.5" step="0.01" value="0.35">
+  <label>主光 key · <b id="vKey">0.70</b></label>
+  <input type="range" id="key" min="0" max="3" step="0.01" value="0.70">
+  <button id="copy">复制参数</button>
+</div>
+<!-- Classic script FIRST · catches module/import/protocol failures that a
+     top-level `import` would otherwise swallow into the console only. -->
+<script>
+  window.__setStatus = function (msg, isErr) {
+    var el = document.getElementById("status");
+    if (!el) return;
+    el.textContent = msg;
+    el.style.color = isErr ? "#f88" : "#9fe";
+  };
+  if (location.protocol === "file:") {
+    window.__setStatus("⚠ 你是用 file:// 打开的 — 模块和 GLB 都加载不了。\n请在【运行中的 app】里访问 http://localhost:<端口>/__avatar3d_test.html", true);
+  }
+  window.addEventListener("error", function (e) {
+    // Resource (script/module) load failures arrive here as ErrorEvents.
+    var what = e.message || (e.target && (e.target.src || e.target.href)) || "unknown";
+    window.__setStatus("JS/资源错误: " + what, true);
+  }, true);
+  window.addEventListener("unhandledrejection", function (e) {
+    var r = e.reason; window.__setStatus("未处理的 Promise 拒绝: " + ((r && r.message) || r), true);
+  });
+  setTimeout(function () {
+    var el = document.getElementById("status");
+    if (el && /booting|importing|loading|building/i.test(el.textContent)) {
+      window.__setStatus(el.textContent + "\n（>6s 仍未完成 — 打开 DevTools Console 看具体报错）", true);
+    }
+  }, 6000);
+</script>
+<script type="module">
+  const S = window.__setStatus;
+  (async () => {
+    try {
+      // Step 0 · is the GLB even reachable on this server? (isolates
+      // "asset not served" from "module failed to load".)
+      S("检查 GLB 可达性…");
+      const GLB = "/icons/avatar_1779855104027.glb";
+      const head = await fetch(GLB, { method: "GET", headers: { Range: "bytes=0-0" } }).catch((e) => ({ ok: false, status: "fetch失败 " + e.message }));
+      if (!head.ok && head.status !== 206 && head.status !== 200) {
+        S("GLB 拿不到: " + GLB + " → " + head.status + "（文件没被服务?）", true);
+        return;
+      }
+      S("加载 three…");
+      const THREE = await import("/vendor/three.module.min.js");
+      S("加载 OrbitControls…");
+      const { OrbitControls } = await import("/vendor/OrbitControls.js");
+      const { RoomEnvironment } = await import("/vendor/RoomEnvironment.js");
+      S("加载 avatar-3d skill…");
+      const av = await import("/avatar-3d.js");
+      const renderer = new THREE.WebGLRenderer({ antialias: true, preserveDrawingBuffer: true });
+      renderer.setSize(innerWidth, innerHeight);
+      renderer.setPixelRatio(Math.min(devicePixelRatio, 2));
+      renderer.shadowMap.enabled = true;
+      renderer.shadowMap.type = THREE.PCFSoftShadowMap;
+      // ACES tone mapping + sRGB output · the standard "make PBR look
+      // good" pair. Without tone mapping the env reflections clip / look
+      // flat; with it skin + hair get that soft filmic sheen.
+      renderer.toneMapping = THREE.ACESFilmicToneMapping;
+      renderer.toneMappingExposure = 0.7;
+      document.body.appendChild(renderer.domElement);
+      const scene = new THREE.Scene();
+      scene.background = new THREE.Color(0x222428);
+      const camera = new THREE.PerspectiveCamera(35, innerWidth / innerHeight, 0.1, 100);
+      camera.position.set(1.6, 1.7, 3.0);
+      const controls = new OrbitControls(camera, renderer.domElement);
+      controls.target.set(0, 0.9, 0);
+      controls.update();
+      // Image-based lighting · a PMREM-filtered procedural RoomEnvironment
+      // is what gives the materials real reflections / gloss (no HDRI
+      // file needed). This is the single biggest lever for "光泽 / 质感".
+      const pmrem = new THREE.PMREMGenerator(renderer);
+      scene.environment = pmrem.fromScene(new RoomEnvironment(), 0.04).texture;
+      // RoomEnvironment is studio-bright · dim its contribution so it
+      // lights + reflects without washing the skin out. Keeps the gloss
+      // shape (reflections) while pulling overall exposure down.
+      scene.environmentIntensity = 0.35;
+      // The env map already provides ambient fill, so direct lights stay
+      // modest · a strong key + rim on top of IBL blew the faces out to
+      // pure white. One soft key for shape + a faint rim for separation.
+      scene.add(new THREE.HemisphereLight(0xffffff, 0x33384a, 0.18));
+      const dir = new THREE.DirectionalLight(0xffffff, 0.7);
+      dir.position.set(3, 6, 4); dir.castShadow = true; scene.add(dir);
+      const rim = new THREE.DirectionalLight(0xbfd4ff, 0.3);
+      rim.position.set(-4, 3, -3); scene.add(rim);
+      const ground = new THREE.Mesh(
+        new THREE.CircleGeometry(2.4, 48),
+        new THREE.MeshStandardMaterial({ color: 0x33363c, roughness: 1 }),
+      );
+      ground.rotation.x = -Math.PI / 2; ground.receiveShadow = true; scene.add(ground);
+      renderer.setAnimationLoop(() => { controls.update(); renderer.render(scene, camera); });
+      // Live brightness sliders → renderer / scene / key-light.
+      const $ = (id) => document.getElementById(id);
+      const wire = (id, vid, fn, fmt) => {
+        const el = $(id); const lab = $(vid);
+        const upd = () => { const v = parseFloat(el.value); fn(v); lab.textContent = fmt(v); };
+        el.addEventListener("input", upd); upd();
+      };
+      wire("exp", "vExp", (v) => { renderer.toneMappingExposure = v; }, (v) => v.toFixed(2));
+      wire("env", "vEnv", (v) => { scene.environmentIntensity = v; }, (v) => v.toFixed(2));
+      wire("key", "vKey", (v) => { dir.intensity = v; }, (v) => v.toFixed(2));
+      $("copy").addEventListener("click", () => {
+        const t = `exposure=${$("exp").value} envIntensity=${$("env").value} key=${$("key").value}`;
+        navigator.clipboard && navigator.clipboard.writeText(t);
+        $("copy").textContent = "已复制: " + t;
+      });
+      S("下载 + 解析 GLB…");
+      await av.loadAvatar3D(GLB);
+      S("生成 avatar 实例…");
+      const seeds = ["yang-tianzhen", "socrates", "first-principles"];
+      seeds.forEach((seed, i) => {
+        const a = av.buildAvatar3D(seed, { height: 1.7 });
+        a.position.x = (i - 1) * 1.1;
+        a.rotation.y = 0;
+        scene.add(a);
+      });
+      S("✓ 加载完成 · " + seeds.length + " 个 avatar（拖动可旋转）");
+    } catch (e) {
+      S("ERROR: " + (e && e.stack ? e.stack : (e && e.message) || e), true);
+    }
+  })();
+</script>
+</body></html>

package/public/agent-overlay.css CHANGED Viewed

@@ -113,13 +113,10 @@ img[data-agent]:hover { filter: brightness(1.15); }
   border-bottom: 0.5px dashed var(--line-bright);
 }
 .agent-card-avatar {
-  width: 68px;
-  height: 68px;
-  background: var(--panel-2);
-  border: 0.5px solid var(--line-bright);
-  padding: 5px;
+  width: 72px;
+  height: 72px;
+  margin: -10px 0 10px;
   display: block;
-  image-rendering: pixelated;
 }
 .agent-card-id .name {
   font-size: 18px;
@@ -528,6 +525,17 @@ img[data-agent]:hover { filter: brightness(1.15); }
   border-color: var(--lime-dim);
 }
+/* Hide the secondary voice-block sections inside the agent overlay.
+   The same renderVoiceBlock() is shared with the full agent-profile
+   page (where these stay visible); the overlay is meant to be a
+   quick read-only summary, not a place to type a preview line, run
+   a multi-minute clone job, or tune speed / pitch / timbre sliders.
+   Scope by parent so the profile page is untouched. */
+.agent-overlay .ap-voice-section:has(> .ap-voice-forge),
+.agent-overlay .ap-voice-section:has(.ap-voice-preview-text),
+.agent-overlay .ap-voice-section:has(.ap-voice-emotion-row),
+.agent-overlay .ap-voice-section:has(.ap-voice-advanced) { display: none; }
 @media (max-width: 600px) {
   .agent-overlay { padding: 12px; }
   .agent-card-head { grid-template-columns: auto 1fr; gap: 12px; padding: 14px 14px 12px; }

package/public/agent-overlay.js CHANGED Viewed

@@ -39,7 +39,7 @@
       name: "Socrates",
       role: "The Skeptic",
       handle: "@socrates",
-      avatar: "avatars/socrates.svg",
+      avatar: "avatars/3d/socrates.png",
       lens: "Won't let any sentence pass without unpacking its assumptions three layers deep. Treats every word as a contract that must be defined before reasoning can begin.",
       traits: ["probing", "definitional", "patient", "rarely concedes"],
       memory: [
@@ -63,7 +63,7 @@
       name: "First Principles",
       role: "Causal Reasoning",
       handle: "@first_p",
-      avatar: "avatars/first-principles.svg",
+      avatar: "avatars/3d/first-principles.png",
       lens: "Strips problems to their primitives. Refuses to reason in the middle layer where most thinking dies. Will rebuild the argument from physics if necessary.",
       traits: ["reductive", "literal", "cold", "physics-first"],
       memory: [
@@ -87,7 +87,7 @@
       name: "Value Investor",
       role: "Pattern Recognition",
       handle: "@value_inv",
-      avatar: "avatars/value-investor.svg",
+      avatar: "avatars/3d/value-investor.png",
       lens: "Reads every judgment through a ten-year lens. Pattern recognition trained on twenty years of market history. Sees what's already been tried — and how it ended.",
       traits: ["historical", "skeptical of hype", "long-horizon", "selectively quiet"],
       memory: [
@@ -111,7 +111,7 @@
       name: "User-Empathy",
       role: "Empathy Lens",
       handle: "@user_e",
-      avatar: "avatars/user-empathy.svg",
+      avatar: "avatars/3d/user-empathy.png",
       lens: "Asks why anyone would actually use this — never lets a feature pass without a real-person scenario. Holds the room accountable to people who aren't in it.",
       traits: ["narrative", "scenario-driven", "warm", "uncompromising"],
       memory: [
@@ -135,7 +135,7 @@
       name: "Long Horizon",
       role: "Historical Lens",
       handle: "@long_h",
-      avatar: "avatars/long-horizon.svg",
+      avatar: "avatars/3d/long-horizon.png",
       lens: "Reads everything on a hundred-year scale. Knows which patterns repeat and which never do. Treats the present as a single frame in a much longer film.",
       traits: ["macro", "civilizational", "calm", "rare interjector"],
       memory: [
@@ -159,7 +159,7 @@
       name: "Phenomenologist",
       role: "Experience-First · Intern",
       handle: "@phen",
-      avatar: "avatars/phenomenologist.svg",
+      avatar: "avatars/3d/phenomenologist.png",
       lens: "Begins from experience itself, without imposing structure. Currently on probation — has to earn a permanent seat, or step back to observer.",
       traits: ["unstructured", "first-person", "uneven", "promising"],
       memory: [

package/public/agent-profile.css CHANGED Viewed

@@ -1635,17 +1635,13 @@
 }
 .ap-avatar {
   position: relative;
-  width: 76px;
-  height: 76px;
-  margin-top: -46px;
+  width: 96px;
+  height: 96px;
+  /* Straddles the 84px cover · margin-top scaled with the size bump
+     (was 76px/-46px) so the avatar keeps the same ~60% overlap into
+     the cover and ~40% dropping into the body row. */
+  margin-top: -58px;
   margin-bottom: 0;
-  border-radius: 50%;
-  background: var(--panel-2);
-  /* Ring color follows the page bg so the avatar reads as separated
-     from the cover gradient on every theme · in light themes the ring
-     is white against the gray cover; in dark themes the ring is the
-     near-black bg against the panel-toned cover. */
-  border: 4px solid var(--bg);
   overflow: hidden;
   display: flex;
   align-items: center;
@@ -1657,8 +1653,9 @@
   width: 100%;
   height: 100%;
   object-fit: cover;
-  image-rendering: pixelated;
-  image-rendering: crisp-edges;
+  /* The 3D-avatar portrait is a smooth downscaled PNG · keep it smooth
+     (pixelated would render it blocky at this size). */
+  image-rendering: auto;
 }
 /* Text column · sits to the right of the avatar in the same row,
    so name + meta read as one tight identifier block. */

package/public/agent-profile.js CHANGED Viewed

@@ -43,7 +43,7 @@
     /* ════════════════════════════════════ SOCRATES ════════════════════════════════════ */
     "socrates": {
       name: "Socrates", role: "The Skeptic", handle: "@socrates",
-      avatar: "avatars/socrates.svg", status: "active", tenure: "core · 4 yr",
+      avatar: "avatars/3d/socrates.png", status: "active", tenure: "core · 4 yr",
       coverQuote: "won't let any sentence pass",
       meta: { creator: "@Kay", joined: "2024-04-01" },
       bio: [
@@ -114,7 +114,7 @@
     /* ════════════════════════════════════ FIRST PRINCIPLES ════════════════════════════ */
     "first-principles": {
       name: "First Principles", role: "Causal Reasoning", handle: "@first_p",
-      avatar: "avatars/first-principles.svg", status: "active", tenure: "core · 4 yr",
+      avatar: "avatars/3d/first-principles.png", status: "active", tenure: "core · 4 yr",
       coverQuote: "what's the smallest unit?",
       meta: { creator: "@Kay", joined: "2024-04-01" },
       bio: [
@@ -177,7 +177,7 @@
     /* ════════════════════════════════════ VALUE INVESTOR ════════════════════════════ */
     "value-investor": {
       name: "Value Investor", role: "Pattern Recognition", handle: "@value_inv",
-      avatar: "avatars/value-investor.svg", status: "active", tenure: "core · 3 yr",
+      avatar: "avatars/3d/value-investor.png", status: "active", tenure: "core · 3 yr",
       coverQuote: "who's tried this before?",
       meta: { creator: "@Kay", joined: "2024-08-14" },
       bio: [
@@ -242,7 +242,7 @@
     /* ════════════════════════════════════ USER-EMPATHY ════════════════════════════════ */
     "user-empathy": {
       name: "User-Empathy", role: "Empathy Lens", handle: "@user_e",
-      avatar: "avatars/user-empathy.svg", status: "active", tenure: "core · 2 yr",
+      avatar: "avatars/3d/user-empathy.png", status: "active", tenure: "core · 2 yr",
       coverQuote: "name one user who'd reach for it",
       meta: { creator: "@Kay", joined: "2024-11-02" },
       bio: [
@@ -306,7 +306,7 @@
     /* ════════════════════════════════════ LONG HORIZON ════════════════════════════════ */
     "long-horizon": {
       name: "Long Horizon", role: "Historical Lens", handle: "@long_h",
-      avatar: "avatars/long-horizon.svg", status: "active", tenure: "core · 2 yr",
+      avatar: "avatars/3d/long-horizon.png", status: "active", tenure: "core · 2 yr",
       coverQuote: "this is the cycle's mid-point",
       meta: { creator: "@Kay", joined: "2025-01-22" },
       bio: [
@@ -368,7 +368,7 @@
     /* ════════════════════════════════════ PHENOMENOLOGIST ═══════════════════════════ */
     "phenomenologist": {
       name: "Phenomenologist", role: "Experience-First", handle: "@phen",
-      avatar: "avatars/phenomenologist.svg", status: "intern", tenure: "intern · trial",
+      avatar: "avatars/3d/phenomenologist.png", status: "intern", tenure: "intern · trial",
       coverQuote: "what is it like, actually?",
       meta: { creator: "@Kay", joined: "2026-03-08" },
       bio: [
@@ -760,39 +760,81 @@
     return tag.toUpperCase().slice(0, 8);
   }
-  /* Per-agent rules (visual only · localStorage). */
+  /* Per-agent rules · PERSISTED SERVER-SIDE (agent.userRules) so the
+     orchestrator can inject them into the director's turn prompt. (They
+     used to be localStorage-only / "visual" — which is why a rule like
+     "不要谈及范冰冰" had zero effect: it never reached the model.)
+     A per-slug working copy backs the inputs for snappy editing; changes
+     debounce-flush to PATCH /api/agents/:id. */
   const RULES_MAX = 5;
-  function rulesKey(slug) { return "boardroom.agent.rules." + slug; }
-  function rulesForAgent(slug) {
-    try {
-      const raw = localStorage.getItem(rulesKey(slug));
-      if (raw) {
-        const arr = JSON.parse(raw);
-        if (Array.isArray(arr)) return arr;
+  const _rules = Object.create(null);        // slug -> string[] working copy
+  const _rulesTimer = Object.create(null);   // slug -> debounce timer
+  function _legacyRulesKey(slug) { return "boardroom.agent.rules." + slug; }
+  function _liveAgentFor(slug) {
+    return (window.app && window.app.agentsById) ? window.app.agentsById[slug] : null;
+  }
+  // Seed the working copy once per slug: prefer the server value
+  // (agent.userRules); else migrate any legacy localStorage rules up to
+  // the server so a user who set rules in the old "visual-only" era
+  // doesn't lose them (and they start actually working).
+  function seedRules(slug) {
+    if (_rules[slug]) return _rules[slug];
+    const live = _liveAgentFor(slug);
+    let arr = (live && Array.isArray(live.userRules)) ? live.userRules.slice() : [];
+    if (arr.length === 0) {
+      try {
+        const raw = localStorage.getItem(_legacyRulesKey(slug));
+        if (raw) {
+          const a = JSON.parse(raw);
+          if (Array.isArray(a)) {
+            const legacy = a.map((x) => String(x).trim()).filter((x) => x.length > 0);
+            if (legacy.length > 0) { arr = legacy; _rules[slug] = arr; persistRules(slug); }
+          }
+        }
+      } catch (e) { /* */ }
+    }
+    _rules[slug] = arr;
+    return _rules[slug];
+  }
+  function rulesForAgent(slug) { return seedRules(slug); }
+  function _cleanRules(slug) {
+    return (_rules[slug] || []).map((x) => String(x).trim()).filter((x) => x.length > 0).slice(0, RULES_MAX);
+  }
+  function persistRules(slug) {
+    const arr = _cleanRules(slug);
+    const live = _liveAgentFor(slug);
+    if (live) live.userRules = arr.slice();   // optimistic
+    fetch("/api/agents/" + encodeURIComponent(slug), {
+      method: "PATCH",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ userRules: arr }),
+    }).then((r) => (r.ok ? r.json() : null)).then((updated) => {
+      if (updated && Array.isArray(updated.userRules) && live) {
+        live.userRules = updated.userRules.slice();
       }
-    } catch (e) { /* */ }
-    return [];
+      try { localStorage.removeItem(_legacyRulesKey(slug)); } catch (e) { /* */ }
+    }).catch(() => { /* offline · working copy keeps the edit */ });
   }
-  function setRulesFor(slug, arr) {
-    try { localStorage.setItem(rulesKey(slug), JSON.stringify(arr)); } catch (e) { /* */ }
+  function persistRulesSoon(slug) {
+    if (_rulesTimer[slug]) clearTimeout(_rulesTimer[slug]);
+    _rulesTimer[slug] = setTimeout(() => { _rulesTimer[slug] = null; persistRules(slug); }, 600);
   }
   function addRuleFor(slug) {
-    const rules = rulesForAgent(slug);
+    const rules = seedRules(slug);
     if (rules.length >= RULES_MAX) return;
-    rules.push("");
-    setRulesFor(slug, rules);
+    rules.push("");   // empty rows aren't persisted until typed into
   }
   function setRuleAt(slug, idx, body) {
-    const rules = rulesForAgent(slug);
+    const rules = seedRules(slug);
     if (idx < 0 || idx >= rules.length) return;
     rules[idx] = body;
-    setRulesFor(slug, rules);
+    persistRulesSoon(slug);
   }
   function removeRuleFor(slug, idx) {
-    const rules = rulesForAgent(slug);
+    const rules = seedRules(slug);
     if (idx < 0 || idx >= rules.length) return;
     rules.splice(idx, 1);
-    setRulesFor(slug, rules);
+    persistRules(slug);   // immediate on remove
   }
   function repaintProfileRules(slug) {
     const card = document.querySelector(`.ap-card[data-ap-card-slug="${slug}"]`);
@@ -1123,8 +1165,9 @@
   /** Render the RULES block · editable list of numbered constraints.
    *  Mirrors the new-agent overlay UX: each row is a numbered input
    *  with a trailing remove button; an "add rule" button below the
-   *  list (hidden when the cap of 5 is reached). All mutations
-   *  persist immediately via setRulesFor. */
+   *  list (hidden when the cap of 5 is reached). Mutations persist
+   *  server-side via PATCH /api/agents/:id (see setRuleAt / removeRuleFor)
+   *  so the orchestrator injects them into the director's prompt. */
   function renderRulesBlock(slug) {
     return `<div class="ap-rules-block" data-ap-rules-block data-slug="${escape(slug)}">${renderRulesInner(slug)}</div>`;
   }
@@ -2402,6 +2445,11 @@
           <span class="ap-id-menu-mark">◆</span>
           <span>Regenerate 8-bit avatar</span>
         </button>`);
+      parts.push(`
+        <button type="button" class="ap-id-menu-item" data-ap-menu-action="edit-avatar3d">
+          <span class="ap-id-menu-mark">◈</span>
+          <span>Customize 3D avatar</span>
+        </button>`);
     }
     // Persona MD download · only present for Full-mode agents (those
     // built via the deep persona-builder pipeline). Their `personaSpec`
@@ -2440,17 +2488,19 @@
     if (el) el.remove();
   }
-  /** Generate a fresh 8-bit SVG and persist it as the agent's
+  /** Render a fresh 3D voxel portrait and persist it as the agent's
    *  avatar. Updates the live store so subsequent renders use the
-   *  new image, then repaints the profile in place. Seeded directors
-   *  fall back to a localStorage override (the server only stores
-   *  user-created agents). */
+   *  new image, then repaints the profile in place. Uses the shared
+   *  Avatar3DSnap helper (same pipeline the agent-profile capture
+   *  and home / new-agent flows go through) — no more 8-bit SVG.
+   *  Seeded directors fall back to a localStorage override (the
+   *  server only stores user-created agents). */
   async function regenerateProfileAvatar(slug) {
-    const skill = window.AvatarSkill;
-    if (!skill) return;
-    const seed = skill.randomSeed();
-    const svg = skill.generate(seed);
-    const dataUrl = "data:image/svg+xml;utf8," + encodeURIComponent(svg);
+    const snap = window.Avatar3DSnap;
+    if (!snap || typeof snap.generate !== "function") return;
+    const seed = snap.randomSeed();
+    const dataUrl = await snap.generate(seed);
+    if (!dataUrl) return;
     const live = window.app && window.app.agentsById ? window.app.agentsById[slug] : null;
     if (live) {
       try {
@@ -4358,6 +4408,9 @@
         e.preventDefault();
         closeProfileIdMenu();
         if (action === "regen-avatar" && slug) regenerateProfileAvatar(slug);
+        if (action === "edit-avatar3d" && slug && typeof window.openAvatar3DEditor === "function") {
+          window.openAvatar3DEditor(slug);
+        }
         if (action === "delete" && slug && window.app && typeof window.app.deleteAgent === "function") {
           // deleteAgent handles confirm + DELETE call + closes the
           // profile + refreshes the sidebar. No-op for seed/chair
@@ -5050,8 +5103,8 @@
       }
     });
-    // Rules · persist edits as the user types (debounce-free; the
-    // payload is small and writes go to localStorage).
+    // Rules · persist edits as the user types · setRuleAt debounce-
+    // flushes to PATCH /api/agents/:id so the orchestrator picks them up.
     document.addEventListener("input", (e) => {
       const ri = e.target.closest("[data-ap-rule-input]");
       if (!ri) return;