synabun 2.0.0 → 2.0.7

package/neural-interface/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neural-memory-interface",
-  "version": "2.0.0",
+  "version": "2.0.7",
   "private": true,
   "description": "Private local SynaBun interface for memory visualization and multi-agent workflows",
   "license": "Apache-2.0",
@@ -17,7 +17,6 @@
   "scripts": {
     "start": "node server.js",
     "dev": "node --watch server.js",
-    "test": "node --test tests/*.test.mjs",
     "build:vendor": "node scripts/build-vendor.mjs",
     "postinstall": "node scripts/rebuild-pty.js && node scripts/build-vendor.mjs"
   },
@@ -52,6 +51,18 @@
     "tar": "^7.5.19"
   },
   "devDependencies": {
+    "@codemirror/autocomplete": "6.20.3",
+    "@codemirror/commands": "6.11.1",
+    "@codemirror/language": "6.13.1",
+    "@codemirror/language-data": "6.5.2",
+    "@codemirror/legacy-modes": "6.5.5",
+    "@codemirror/lint": "6.9.7",
+    "@codemirror/merge": "6.12.2",
+    "@codemirror/search": "6.7.2",
+    "@codemirror/state": "6.7.6",
+    "@codemirror/view": "6.43.14",
+    "@lezer/highlight": "1.2.5",
+    "@replit/codemirror-indentation-markers": "6.5.3",
     "esbuild": "^0.28.1",
     "three": "0.169.0"
   }

package/neural-interface/public/index.html

@@ -5,6 +5,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
 <title>SynApp</title>
 <meta name="theme-color" content="#0e0e10">
+<!-- Inside the SynaBun desktop app the navbar is the window's title bar (shared/desktop-titlebar.js). -->
+<meta name="synabun-titlebar" content="navbar">
 <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
 <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
 <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">

package/neural-interface/public/index2d.html

@@ -5,6 +5,8 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
 <title>SynApp</title>
 <meta name="theme-color" content="#0e0e10">
+<!-- Inside the SynaBun desktop app the navbar is the window's title bar (shared/desktop-titlebar.js). -->
+<meta name="synabun-titlebar" content="navbar">
 <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
 <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
 <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">

package/neural-interface/public/install-app.html

@@ -11,21 +11,24 @@
   <link rel="stylesheet" href="/shared/pwa-install.css">
 </head>
 <body id="pwa-install">
-  <main aria-labelledby="install-title">
+  <!-- Hidden until pwa-install-page.js knows what this browser gets: the wizard or the main UI (Chrome or Edge
+       sent here by the launcher), one button (asked for from the Apps menu), or one plain instruction. -->
+  <main aria-labelledby="install-title" hidden>
     <img src="/icon-192.png" width="48" height="48" alt="SynaBun">
     <h1 id="install-title">Install SynaBun as an app</h1>
     <p id="install-intro">The server is running in the background. Confirm installation once in your browser to give SynaBun its own app window.</p>
-    <ol>
-      <li id="install-chromium">Chrome or Edge: choose Install as App below, or the browser's Install app menu.</li>
-      <li id="install-safari">Safari on macOS: choose File → Add to Dock. Keep the name SynaBun.</li>
-    </ol>
+    <p id="install-chromium" hidden>Chrome or Edge: choose Install as App below, or the browser's Install app menu.</p>
+    <p id="install-safari" hidden>Safari on macOS: choose File → Add to Dock. Keep the name SynaBun.</p>
+    <p id="install-other" hidden>SynaBun installs as an app from Chrome, Edge, or Safari on macOS. Open it in one of them to install.</p>
     <p id="install-later">After installation, reopen the native SynaBun launcher. It starts or reuses the server and opens your installed PWA. Closing the app window leaves the server running. Use Apps → Stop Server to stop it.</p>
     <div class="actions">
-      <button id="install-button" type="button">Install as App</button>
+      <button id="install-button" type="button" hidden>Install as App</button>
       <a id="install-continue" href="/">Continue to SynaBun</a>
     </div>
     <p id="install-status" role="status" aria-live="polite"></p>
   </main>
+  <!-- Should the script never answer, the page and its way on still show. -->
+  <script>setTimeout(() => { document.querySelector('main').hidden = false; }, 4000);</script>
   <script type="module" src="/shared/pwa-install-page.js"></script>
 </body>
 </html>

package/neural-interface/public/offline.html

@@ -511,6 +511,12 @@
   const hasBridge = typeof createStartBridge === 'function';
   const windows = hasBridge ? isWindowsPlatform(navigator) : /Win/.test(navigator.platform);
   const mac = hasBridge ? isMacPlatform(navigator) : /Mac/.test(navigator.platform);
+  // Inside the SynaBun desktop app (its preload puts window.synabunDesktop on every page of its server) the app
+  // starts and restarts the server itself: no Start button and no command to type, one sentence instead, and the
+  // page reconnects when the server is back. The sentence is DESKTOP_COPY.offline.hint of
+  // shared/desktop-update-view.js, written out here because this page can load nothing.
+  const desktopApp = !!(window.synabunDesktop && window.synabunDesktop.updates);
+  const DESKTOP_HINT = 'The SynaBun app restarts its server by itself. If it stays offline, quit SynaBun and open it again.';
 
   // --- Commands to type instead ---
   const commands = hasBridge
@@ -578,7 +584,16 @@
     setTimeout(() => location.reload(), delay);
   }
 
-  if (!hasBridge) {
+  if (desktopApp) {
+    $('start').hidden = true;
+    $('manual').hidden = true;
+    $('subtext').textContent = DESKTOP_HINT;
+    const interval = setInterval(async () => {
+      if (!(await serverAnswers())) return;
+      clearInterval(interval);
+      reconnect(150);
+    }, 3000);
+  } else if (!hasBridge) {
     // An older server served this page without the bridge: commands and reconnect only.
     const interval = setInterval(async () => {
       if (!(await serverAnswers())) return;
@@ -614,7 +629,8 @@
     function render(snap) {
       const view = startStatusView(snap, { platform });
       $('mascot').setAttribute('data-state', view.mascot);
-      $('heading').textContent = headings[view.mascot][0];
+      // A restart read from the supervisor's report names itself (view.heading).
+      $('heading').textContent = view.heading ? START_COPY[view.heading] : headings[view.mascot][0];
       $('subtext').textContent = headings[view.mascot][1];
       startBtn.disabled = view.busy || view.state === 'online';
       startLabel.textContent = labels[view.button];
@@ -622,7 +638,7 @@
       const line = say(view.headline);
       if (startStatus.textContent !== line) startStatus.textContent = line;
       $('startElapsed').textContent = view.elapsed;
-      $('startElapsed').setAttribute('aria-label', view.elapsed ? START_COPY.elapsedLabel + ': ' + view.elapsed : '');
+      $('startElapsed').setAttribute('aria-label', view.elapsed ? START_COPY[view.elapsedLabel] + ': ' + view.elapsed : '');
       $('startHint').textContent = say(view.hint);
       $('startTrail').replaceChildren(...view.trail.map((row) => {
         const item = document.createElement('li');

package/neural-interface/public/onboarding.html

@@ -3,10 +3,13 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
+<!-- Inside the SynaBun desktop app this page lays out its own top (shared/desktop-titlebar-page.js). -->
+<meta name="synabun-titlebar" content="page">
 <title>Setup - SynaBun</title>
 <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
 <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
 <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
+<link rel="manifest" href="/manifest.json">
 <style>
   *, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
 
@@ -51,6 +54,15 @@
     justify-content: center;
   }
 
+  /* ── Inside the SynaBun desktop app (shared/desktop-titlebar-page.js): the window has no native title bar, and a
+     strip along the top drags it. The logo keeps its click, and on macOS clears the traffic lights. ── */
+  .ob-logo { -webkit-app-region: no-drag; }
+  html.desktop-titlebar--darwin .ob-logo { left: calc(env(titlebar-area-x, 86px) + 12px) !important; }
+  /* The Details areas (desktop app): what the wizard checked and what this copy has, in the build output's box. */
+  .ob-details { margin-top: 12px; }
+  .ob-details .mcp-other-header:focus-visible { outline: 1px solid var(--accent-border); outline-offset: -1px; }
+  .ob-details .terminal { margin: 0; max-height: 200px; word-break: break-word; user-select: text; }
+
   /* Background canvas */
   #bgCanvas {
     position: fixed;
@@ -1067,7 +1079,7 @@
 
 <canvas id="bgCanvas"></canvas>
 
-<a href="https://synabun.ai" target="_blank" rel="noopener" style="position:fixed;top:24px;left:28px;z-index:10;opacity:0.4;transition:opacity 0.2s;" onmouseenter="this.style.opacity='0.7'" onmouseleave="this.style.opacity='0.4'">
+<a href="https://synabun.ai" target="_blank" rel="noopener" class="ob-logo" style="position:fixed;top:24px;left:28px;z-index:10;opacity:0.4;transition:opacity 0.2s;" onmouseenter="this.style.opacity='0.7'" onmouseleave="this.style.opacity='0.4'">
   <img src="synabun.png?v=2" alt="SynaBun" style="height:34px;width:auto;">
 </a>
 
@@ -1136,6 +1148,16 @@
       <h2>Environment Check</h2>
       <p class="subtitle">Verifying your system has everything SynaBun needs.</p>
       <ul class="dep-list" id="depList"></ul>
+      <!-- Desktop app: the commands the check ran and what they answered (shared/install-details-view.js). -->
+      <div class="mcp-other-section ob-details" id="envDetails" hidden>
+        <div class="mcp-other-header" id="envDetailsHeader" role="button" tabindex="0" aria-expanded="false" aria-controls="envDetailsBody">
+          <span>Details</span>
+          <svg class="mcp-other-chevron" viewBox="0 0 24 24" width="14" height="14" aria-hidden="true"><polyline points="6 9 12 15 18 9" fill="none" stroke="currentColor" stroke-width="2"/></svg>
+        </div>
+        <div class="mcp-other-body" id="envDetailsBody" style="display:none;">
+          <div class="terminal" id="envDetailsLog" role="log"></div>
+        </div>
+      </div>
     </div>
 
     <!-- Step 2: Memory Name & Location -->
@@ -1191,6 +1213,16 @@
       </div>
       <div class="terminal" id="buildOutput" style="display:none"></div>
       <button class="action-btn" id="buildBtn">Install & Build</button>
+      <!-- Desktop app: what this copy came with, every dependency with its version (shared/install-details-view.js). -->
+      <div class="mcp-other-section ob-details" id="installDetails" hidden>
+        <div class="mcp-other-header" id="installDetailsHeader" role="button" tabindex="0" aria-expanded="false" aria-controls="installDetailsBody">
+          <span>Details</span>
+          <svg class="mcp-other-chevron" viewBox="0 0 24 24" width="14" height="14" aria-hidden="true"><polyline points="6 9 12 15 18 9" fill="none" stroke="currentColor" stroke-width="2"/></svg>
+        </div>
+        <div class="mcp-other-body" id="installDetailsBody" style="display:none;">
+          <div class="terminal" id="installDetailsLog" role="log"></div>
+        </div>
+      </div>
     </div>
 
     <!-- Step 4: Add Projects -->
@@ -1412,6 +1444,21 @@ import { fetchRulesStatus, fetchRulesTextWithFallback, installRules, installAllR
 import {
   describeRulesHost, describeRulesInstall, describeRulesInstallAll, describeRulesInPlace, rulesInstallPlan, catalogueTranslator,
 } from './shared/settings/settings-rules.js';
+// Install as an app: the wizard has no step for it. The browser's own dialog opens once, from a click that
+// moves the wizard on anyway (the welcome choices, Next), and the wizard never reads the answer. Also import-free.
+import { initPwaInstall, isStandalone, offerPwaInstallOnce } from './shared/pwa-install.js';
+import { isDesktopApp } from './shared/desktop-bridge.js';
+// The desktop app: no native title bar (a strip along the top drags the window), and Details areas under the
+// environment check and the install step. Both import-free; neither does anything in a browser.
+import { initDesktopPageTitleBar } from './shared/desktop-titlebar-page.js';
+import { environmentLines, installLines } from './shared/install-details-view.js';
+
+initDesktopPageTitleBar();
+
+// Chrome and Edge hand the page their install event when it can be installed; Safari and Firefox have none.
+// The SynaBun desktop app is its own window: it never asks for the event, so offerPwaInstallOnce() has none
+// to open there.
+if (!isStandalone() && !isDesktopApp()) initPwaInstall();
 
 // ═══════════════════════════════════════════
 // STATE
@@ -1538,6 +1585,7 @@ function updateNav() {
 $prevBtn.addEventListener('click', () => goToStep(currentStep - 1));
 $nextBtn.addEventListener('click', () => {
   if (validateStep(currentStep)) {
+    offerPwaInstallOnce(); // first, while the click still counts as the user's: see pwa-install.js
     goToStep(currentStep + 1);
   }
 });
@@ -1821,11 +1869,14 @@ function renderHappyBun() {}
 
   // Fresh Install → proceed to step 1
   document.getElementById('choiceFreshInstall').addEventListener('click', () => {
+    offerPwaInstallOnce();
     goToStep(1);
   });
 
-  // Restore → show restore panel
+  // Restore → show restore panel. A restore never passes Next, so this is its click for the browser's
+  // install dialog; the file picker opens on a later click of its own.
   document.getElementById('choiceRestore').addEventListener('click', () => {
+    offerPwaInstallOnce();
     $choices.style.display = 'none';
     $restorePanel.style.display = 'block';
     requestAnimationFrame(() => {
@@ -2141,10 +2192,63 @@ async function onDepsStep() {
       detail.innerHTML = `${dep.detail} &mdash; <a href="${dep.url}" target="_blank" rel="noopener">Download \u2197</a>`;
     }
   }
+  showDetails('envDetails', environmentLines, 1);
 }
 
 function wait(ms) { return new Promise(r => setTimeout(r, ms)); }
 
+// ═══════════════════════════════════════════
+// DETAILS (desktop app): what the wizard checked and what this copy has
+// ═══════════════════════════════════════════
+// GET /api/setup/install-details, read once; open by default, collapsible. An npm or Git install shows none.
+
+const SHOW_DETAILS = isDesktopApp();
+let installDetailsRequest = null;
+function loadInstallDetails() {
+  if (!installDetailsRequest) {
+    installDetailsRequest = fetch('/api/setup/install-details')
+      .then(res => (res.ok ? res.json() : Promise.reject(new Error(`the server answered ${res.status}`))))
+      .catch((error) => { installDetailsRequest = null; throw error; });
+  }
+  return installDetailsRequest;
+}
+
+function openDetails(prefix, stepIndex, open) {
+  const section = document.getElementById(prefix);
+  section.classList.toggle('open', open);
+  document.getElementById(`${prefix}Body`).style.display = open ? '' : 'none';
+  document.getElementById(`${prefix}Header`).setAttribute('aria-expanded', String(open));
+  requestAnimationFrame(() => resizeViewport(stepIndex));
+}
+
+function wireDetails(prefix, stepIndex) {
+  const header = document.getElementById(`${prefix}Header`);
+  const toggle = () => openDetails(prefix, stepIndex, !document.getElementById(prefix).classList.contains('open'));
+  header.addEventListener('click', toggle);
+  header.addEventListener('keydown', (event) => {
+    if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); toggle(); }
+  });
+}
+wireDetails('envDetails', 1);
+wireDetails('installDetails', 3);
+
+async function showDetails(prefix, linesOf, stepIndex) {
+  if (!SHOW_DETAILS) return;
+  const section = document.getElementById(prefix);
+  const log = document.getElementById(`${prefix}Log`);
+  const first = section.hidden;
+  section.hidden = false;
+  if (first) openDetails(prefix, stepIndex, true);
+  log.textContent = 'Reading what this copy has\u2026';
+  try {
+    const lines = linesOf(await loadInstallDetails());
+    log.textContent = lines.length ? lines.join('\n') : 'Nothing to show.';
+  } catch (err) {
+    log.textContent = `Could not read the details: ${err.message}`;
+  }
+  resizeViewport(stepIndex);
+}
+
 // ═══════════════════════════════════════════
 // STEP 3: Install & Build
 // ═══════════════════════════════════════════
@@ -2214,6 +2318,7 @@ async function onBuildStep() {
       $btn.textContent = 'Already Done';
       $btn.classList.add('success');
       $btn.disabled = true;
+      showDetails('installDetails', installLines, 3);
       return;
     }
   } catch {}

package/neural-interface/public/shared/account-i18n.js

@@ -0,0 +1,7 @@
+// Hands the page's translator to account-view.js (`accounts.*` in i18n/*.json).
+// Browser-only: i18n.js reads the page's storage, so node tests load
+// account-view.js without it and get the English.
+import { t } from './i18n.js';
+import { setAccountTranslator } from './account-view.js';
+
+setAccountTranslator((key, params) => t(`accounts.${key}`, params));