synabun 2026.4.26-beta.10 → 2026.4.26-beta.12

package/neural-interface/public/shared/styles.css

@@ -5094,15 +5094,51 @@
   }
   .update-backup-btn:hover { background: rgba(52,199,89,0.16); }
   .update-backup-btn:disabled { opacity: 0.5; pointer-events: none; }
-  .update-backup-status {
-    display: flex;
-    align-items: center;
-    gap: 8px;
+  .update-backup-status {
+    display: flex;
+    align-items: center;
+    gap: 8px;
     font-size: 11px;
     color: var(--t-muted);
-    padding: 4px 0;
-  }
-  .update-backup-icon { font-size: 14px; font-weight: 700; }
+    padding: 4px 0;
+  }
+  .update-run-status {
+    align-items: flex-start;
+    gap: 10px;
+    padding: 10px 12px;
+    border-radius: var(--r-card);
+    border: 1px solid rgba(255,255,255,0.08);
+    background: rgba(255,255,255,0.045);
+    color: var(--t-secondary);
+    font-size: 12px;
+    line-height: 1.4;
+  }
+  .update-run-status .update-backup-icon {
+    flex: 0 0 auto;
+    margin-top: 1px;
+  }
+  .update-run-status strong {
+    display: block;
+    color: var(--t-primary);
+    font-size: 12px;
+    font-weight: 600;
+    margin-bottom: 2px;
+  }
+  .update-run-detail,
+  .update-run-hint {
+    display: block;
+    color: var(--t-muted);
+  }
+  .update-run-hint {
+    margin-top: 5px;
+    opacity: .82;
+  }
+  .update-run-status code {
+    font-family: var(--ff-mono);
+    font-size: 11px;
+    color: var(--t-secondary);
+  }
+  .update-backup-icon { font-size: 14px; font-weight: 700; }
   .update-backup-icon.spin { animation: updateSpin 1s linear infinite; }
   @keyframes updateSpin {
     from { transform: rotate(0deg); }

package/neural-interface/public/shared/ui-update.js

@@ -7,6 +7,7 @@
 import { showUpdateToast } from './ui-tool-updates.js';
 
 const $ = (id) => document.getElementById(id);
+const SYNABUN_GITHUB_URL = 'https://github.com/danilokhury/Synabun';
 
 let _versionData = null;
 let _btnWired = false;
@@ -187,27 +188,37 @@ function openUpdateModal() {
 
   function renderStep3() {
     const installPlan = _versionData.installPlan || {};
-    const canAutoUpdate = installPlan.canAutoUpdate !== false;
-    const installCmd = installPlan.displayCommand || 'npm i -g synabun@latest';
+    const canAutoUpdate = installPlan.canAutoUpdate === true;
+    const repoUrl = installPlan.openUrl || SYNABUN_GITHUB_URL;
+    const installCmd = canAutoUpdate
+      ? (installPlan.displayCommand || 'npm i -g synabun@latest')
+      : repoUrl;
     const installIntro = canAutoUpdate
       ? 'SynaBun will close and run this command in a new terminal window:'
-      : 'GitHub clone detected. Run this command from your cloned SynaBun repository:';
+      : 'This SynaBun install was not detected as an npm install. Open the GitHub repository to update from your checkout or installer:';
+    const title = canAutoUpdate ? 'Run the Update' : 'Update from GitHub';
     const installSource = canAutoUpdate
       ? 'Installing from npm.'
-      : (installPlan.manualHint || 'Restart SynaBun after the GitHub clone update finishes.');
+      : (installPlan.manualHint || 'Open the SynaBun repository for the correct update path.');
     const autoRestartControl = canAutoUpdate ? `
       <label class="update-skip-label" style="margin:14px 0 8px;display:flex;align-items:center;gap:8px;cursor:pointer">
         <input type="checkbox" id="update-auto-restart" checked>
         <span>Relaunch SynaBun after update</span>
       </label>` : '';
+    const manualButton = canAutoUpdate ? `
+        <button class="action-btn action-btn--ghost" id="update-manual" title="Run the command yourself in your own terminal">Manual</button>` : '';
     const updateNowButton = canAutoUpdate ? `
         <button class="action-btn action-btn--primary" id="update-run-now">
           <svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-2px;margin-right:6px"><polyline points="8 17 12 21 16 17"/><line x1="12" y1="12" x2="12" y2="21"/><path d="M20.88 18.09A5 5 0 0 0 18 9h-1.26A8 8 0 1 0 3 16.29"/></svg>
           Update Now
-        </button>` : '';
+        </button>` : `
+        <button class="action-btn action-btn--primary" id="update-run-now" data-url="${esc(repoUrl)}">
+          <svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-2px;margin-right:6px"><path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/></svg>
+          Open GitHub
+        </button>`;
 
     return `
-      <h3 class="update-modal-title">Run the Update</h3>
+      <h3 class="update-modal-title">${title}</h3>
       <p style="font-size:12px;color:var(--t-muted);margin:4px 0 12px">
         ${esc(installIntro)}
       </p>
@@ -227,12 +238,12 @@ function openUpdateModal() {
 
       <div class="tag-delete-modal-actions" style="margin-top:14px;flex-wrap:wrap;gap:8px">
         <button class="action-btn action-btn--ghost" id="update-back">Back</button>
-        <button class="action-btn action-btn--ghost" id="update-manual" title="Run the command yourself in your own terminal">Manual</button>
+        ${manualButton}
         ${updateNowButton}
       </div>
 
       <p id="update-manual-note" style="display:none;font-size:11px;color:var(--t-muted);opacity:.75;margin:10px 0 0">
-        After running the command, restart SynaBun: <code>synabun</code>
+        After running the command, restart SynaBun with <code>synabun</code>.
       </p>`;
   }
 
@@ -298,7 +309,9 @@ function openUpdateModal() {
   }
 
   async function handleRunUpdate() {
-    if (_versionData?.installPlan?.canAutoUpdate === false) return;
+    const installPlan = _versionData?.installPlan || {};
+    const canAutoUpdate = installPlan.canAutoUpdate === true;
+    const repoUrl = installPlan.openUrl || SYNABUN_GITHUB_URL;
 
     const autoRestartCb = overlay.querySelector('#update-auto-restart');
     const autoRestart = !!autoRestartCb?.checked;
@@ -310,16 +323,27 @@ function openUpdateModal() {
     const icon = overlay.querySelector('#update-run-icon');
     const text = overlay.querySelector('#update-run-text');
 
-    if (!runBtn || !backBtn || !manualBtn || !status || !icon || !text) return;
+    if (!runBtn || !backBtn || !status || !icon || !text) return;
+
+    if (!canAutoUpdate) {
+      window.open(repoUrl, '_blank', 'noopener,noreferrer');
+      status.style.display = 'flex';
+      icon.className = 'update-backup-icon';
+      icon.textContent = '↗';
+      icon.style.color = '#4fc3f7';
+      text.innerHTML = `<strong>GitHub repository opened</strong><span class="update-run-detail">Use the repository instructions to update this non-npm installation.</span>`;
+      return;
+    }
 
     runBtn.disabled = true;
     backBtn.disabled = true;
-    manualBtn.disabled = true;
+    if (manualBtn) manualBtn.disabled = true;
     runBtn.innerHTML = '<span class="update-spinner"></span> Launching updater...';
     status.style.display = 'flex';
     icon.className = 'update-backup-icon spin';
     icon.textContent = '⟳';
-    text.textContent = 'Opening updater terminal and shutting down server...';
+    icon.style.color = '';
+    text.innerHTML = '<strong>Launching updater</strong><span class="update-run-detail">Opening a terminal window for the npm update.</span>';
 
     try {
       const res = await fetch('/api/system/run-update', {
@@ -332,12 +356,12 @@ function openUpdateModal() {
         try { const b = await res.json(); msg = b.error || msg; } catch {}
         throw new Error(msg);
       }
-      const body = await res.json();
+      await res.json();
 
       icon.className = 'update-backup-icon';
       icon.textContent = '✓';
       icon.style.color = '#34c759';
-      text.innerHTML = `Updater terminal launched. <strong>This window will go offline.</strong> Watch the new terminal for install progress${autoRestart ? ' — SynaBun relaunches when done.' : '. Run <code>synabun</code> after install completes.'}`;
+      text.innerHTML = `<strong>Updater terminal launched</strong><span class="update-run-detail">SynaBun is shutting down so npm can replace the package. Watch the terminal for install progress${autoRestart ? '; SynaBun will relaunch when it finishes.' : '; run <code>synabun</code> when it finishes.'}</span><span class="update-run-hint">If no terminal window appears, run <code>${esc(installPlan.displayCommand || 'npm i -g synabun@latest')}</code> manually.</span>`;
       runBtn.innerHTML = 'Updater running…';
 
       // Server is shutting down. Optionally redirect to a friendly offline
@@ -351,7 +375,7 @@ function openUpdateModal() {
       text.textContent = 'Failed to launch updater: ' + err.message;
       runBtn.disabled = false;
       backBtn.disabled = false;
-      manualBtn.disabled = false;
+      if (manualBtn) manualBtn.disabled = false;
       runBtn.innerHTML = `<svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-2px;margin-right:6px"><polyline points="8 17 12 21 16 17"/><line x1="12" y1="12" x2="12" y2="21"/><path d="M20.88 18.09A5 5 0 0 0 18 9h-1.26A8 8 0 1 0 3 16.29"/></svg> Retry`;
     }
   }

package/neural-interface/server.js

@@ -1594,11 +1594,15 @@ async function gracefulShutdown(reason = 'shutdown') {
 
   try { closeDb(); } catch {}
 
-  // 5. Belt-and-suspenders: tree-kill THIS process's descendants on Windows.
-  // Synabun spawns CLI links, pty terminals, cloudflare tunnel etc. that may
-  // not be reachable through the registries above. The taskkill /T flag walks
-  // the process tree and terminates every descendant.
-  if (process.platform === 'win32') {
+  // 5. Belt-and-suspenders: tree-kill THIS process's descendants on Windows.
+  // Synabun spawns CLI links, pty terminals, cloudflare tunnel etc. that may
+  // not be reachable through the registries above. The taskkill /T flag walks
+  // the process tree and terminates every descendant.
+  //
+  // Do not run this for click-to-update. The updater terminal is deliberately
+  // launched before this server exits; taskkill /T would kill that brand-new
+  // terminal too, which looks like a brief blink and no update on Windows.
+  if (process.platform === 'win32' && reason !== 'run-update') {
     try {
       // Use spawn(detached) so taskkill survives our own exit and finishes
       // killing children even if we exit before it completes.
@@ -1635,9 +1639,45 @@ app.post('/api/server/shutdown', async (req, res) => {
   }, 200);
 });
 
-function shellSingleQuote(s) {
-  return `'${String(s).replace(/'/g, `'\\''`)}'`;
-}
+function shellSingleQuote(s) {
+  return `'${String(s).replace(/'/g, `'\\''`)}'`;
+}
+
+function collectWindowsDescendantPids(rootPid) {
+  if (process.platform !== 'win32' || !rootPid) return [];
+  try {
+    const script = [
+      `$root=${Number(rootPid)}`,
+      '$procs=Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId',
+      '$seen=@{}',
+      '$front=@($root)',
+      '$out=@()',
+      'while ($front.Count -gt 0) {',
+      '  $next=@()',
+      '  foreach ($p in $procs) {',
+      '    if ($front -contains $p.ParentProcessId -and -not $seen.ContainsKey($p.ProcessId)) {',
+      '      $seen[$p.ProcessId]=$true',
+      '      $out += $p.ProcessId',
+      '      $next += $p.ProcessId',
+      '    }',
+      '  }',
+      '  $front=$next',
+      '}',
+      '$out -join ","',
+    ].join('; ');
+    const result = spawnSync('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script], {
+      encoding: 'utf8',
+      windowsHide: true,
+      timeout: 5000,
+    });
+    const out = result.status === 0 ? String(result.stdout || '').trim() : '';
+    return out
+      ? out.split(',').map(v => Number(v)).filter(pid => Number.isFinite(pid) && pid > 0 && pid !== rootPid)
+      : [];
+  } catch {
+    return [];
+  }
+}
 
 function cleanupOldUpdaterStages(baseDir) {
   try {
@@ -1653,7 +1693,7 @@ function cleanupOldUpdaterStages(baseDir) {
   } catch {}
 }
 
-function stageSynabunUpdater({ installPlan, serverPid, autoRestart }) {
+function stageSynabunUpdater({ installPlan, serverPid, autoRestart, cleanupPids = [] }) {
   const sourceUpdater = resolve(PACKAGE_ROOT, 'updater.mjs');
   if (!existsSync(sourceUpdater)) {
     throw new Error(`updater.mjs not found at ${sourceUpdater}. SynaBun install may be corrupt - reinstall manually: ${installPlan.displayCommand}`);
@@ -1678,20 +1718,22 @@ function stageSynabunUpdater({ installPlan, serverPid, autoRestart }) {
     displayCommand: installPlan.displayCommand,
     source: installPlan.source,
     current: installPlan.current,
-    target: installPlan.target,
-    channel: installPlan.channel,
-  };
+    target: installPlan.target,
+    channel: installPlan.channel,
+    cleanupPids,
+  };
   writeFileSync(payloadPath, JSON.stringify(payload, null, 2) + '\n', 'utf8');
 
-  if (process.platform === 'win32') {
-    writeFileSync(runnerPath, [
-      '@echo off',
-      'setlocal enableextensions',
-      'title SynaBun Updater',
-      'cd /d "%~dp0"',
-      'set "EXIT_CODE=0"',
-      'set "NODE_BIN=node"',
-      'if defined SYNABUN_NODE_BIN set "NODE_BIN=%SYNABUN_NODE_BIN%"',
+  if (process.platform === 'win32') {
+    const nodeBin = String(process.execPath || 'node').replace(/"/g, '');
+    writeFileSync(runnerPath, [
+      '@echo off',
+      'setlocal enableextensions',
+      'title SynaBun Updater',
+      'cd /d "%~dp0"',
+      'set "EXIT_CODE=0"',
+      `set "NODE_BIN=${nodeBin}"`,
+      'if defined SYNABUN_NODE_BIN set "NODE_BIN=%SYNABUN_NODE_BIN%"',
       '"%NODE_BIN%" "%~dp0updater.mjs" --payload "%~dp0payload.json" --no-hold',
       'set "EXIT_CODE=%ERRORLEVEL%"',
       'echo.',
@@ -1750,8 +1792,9 @@ app.post('/api/system/run-update', async (req, res) => {
     }
     if (installPlan.canAutoUpdate === false) {
       return res.status(409).json({
-        error: installPlan.manualHint || `This installation cannot be auto-updated. Run manually: ${installPlan.displayCommand}`,
+        error: installPlan.manualHint || `This installation cannot be auto-updated. Open ${installPlan.openUrl || SYNABUN_GITHUB_REPO_URL}`,
         installPlan,
+        openUrl: installPlan.openUrl || SYNABUN_GITHUB_REPO_URL,
       });
     }
     if (!installPlan.installSpec) {
@@ -1760,19 +1803,20 @@ app.post('/api/system/run-update', async (req, res) => {
 
     const plat = process.platform;
     const serverPid = process.pid;
-    const staged = stageSynabunUpdater({ installPlan, serverPid, autoRestart });
+    const cleanupPids = collectWindowsDescendantPids(serverPid);
+    const staged = stageSynabunUpdater({ installPlan, serverPid, autoRestart, cleanupPids });
 
     let spawned = null;
     let launchError = null;
 
-    if (plat === 'win32') {
-      try {
-        spawned = spawn('powershell.exe', [
-          '-NoProfile',
-          '-ExecutionPolicy', 'Bypass',
-          '-Command',
-          '$p=$env:SYNABUN_UPDATER_RUNNER; $w=$env:SYNABUN_UPDATER_CWD; Start-Process -FilePath $p -WorkingDirectory $w -WindowStyle Normal',
-        ], {
+    if (plat === 'win32') {
+      try {
+        spawned = spawn('powershell.exe', [
+          '-NoProfile',
+          '-ExecutionPolicy', 'Bypass',
+          '-Command',
+          '$p=$env:SYNABUN_UPDATER_RUNNER; $w=$env:SYNABUN_UPDATER_CWD; $cmd=$env:ComSpec; if (-not $cmd) { $cmd="cmd.exe" }; Start-Process -FilePath $cmd -ArgumentList @("/k", "`"$p`"") -WorkingDirectory $w -WindowStyle Normal',
+        ], {
           cwd: staged.stageDir,
           shell: false,
           detached: true,
@@ -10433,7 +10477,7 @@ app.post('/api/search/memories', async (req, res) => {
 // when EITHER source is newer than the installed version (catches one-sided
 // publishes — e.g. release tagged on GitHub before npm publish completes).
 
-let _synabunUpdateCache = {
+let _synabunUpdateCache = {
   current: null,
   installedChannel: 'stable',    // 'stable' | 'prerelease'
   npmLatestStable: null,         // dist-tags.latest
@@ -10447,12 +10491,14 @@ let _synabunUpdateCache = {
   gitUpdateAvailable: false,
   updateAvailable: false,        // npmUpdateAvailable || gitUpdateAvailable
   source: null,                  // 'npm' | 'github' | 'both' | null
-  installPlan: null,             // server-owned npm install target for click-to-update
+  installPlan: null,             // server-owned npm/GitHub action target for click-to-update
   checkedAt: null,
   npmError: null,
-  gitError: null,
-};
-
+  gitError: null,
+};
+
+const SYNABUN_GITHUB_REPO_URL = 'https://github.com/danilokhury/Synabun';
+
 function isSynabunGitHubRemote(remoteText) {
   return /github\.com[:/]danilokhury\/Synabun(?:\.git)?(?:[\s)]|$)/i.test(String(remoteText || ''));
 }
@@ -10504,17 +10550,21 @@ function buildSynabunInstallPlan({ current, installedChannel, latest, updateAvai
   if (!updateAvailable) return null;
 
   const installSource = detectSynabunInstallSource();
-  if (installSource.kind === 'github-clone') {
+  if (installSource.kind !== 'npm-global') {
+    const clonedHint = installSource.kind === 'github-clone'
+      ? 'This SynaBun install is a GitHub checkout. Open the repository to pull or reinstall from the correct source.'
+      : 'This SynaBun install was not detected as npm. Open the repository for the correct update path.';
     return {
-      source: 'github-clone',
+      source: 'github',
       installSource: installSource.kind,
       canAutoUpdate: false,
       current,
       target: latest,
       channel: installedChannel,
-      displayCommand: 'git pull --ff-only',
-      manualCommand: 'git pull --ff-only',
-      manualHint: 'GitHub clone detected. Run this from your cloned SynaBun repository, then restart SynaBun.',
+      displayCommand: SYNABUN_GITHUB_REPO_URL,
+      openUrl: SYNABUN_GITHUB_REPO_URL,
+      manualCommand: installSource.kind === 'github-clone' ? 'git pull --ff-only' : null,
+      manualHint: clonedHint,
       remote: installSource.remote,
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synabun",
-  "version": "2026.4.26-beta.10",
+  "version": "2026.4.26-beta.12",
   "description": "Persistent vector memory for AI assistants",
   "license": "Apache-2.0",
   "author": "The SynaBun Authors",

package/updater.mjs

@@ -20,6 +20,7 @@ const legacyTag = sanitizeTag(args.tag || 'latest');
 const installSpec = sanitizeInstallSpec(payload.installSpec || args['install-spec'] || `synabun@${legacyTag}`);
 const displayCommand = payload.displayCommand || `npm i -g ${installSpec}`;
 const serverPid = toPid(payload.serverPid ?? args.pid);
+const cleanupPids = sanitizePidList(payload.cleanupPids).filter(pid => pid !== serverPid && pid !== process.pid);
 const autoRestart = payload.autoRestart != null ? !!payload.autoRestart : !!args.restart;
 const safeCwd = payload.cwd || process.cwd();
 const noHold = !!args['no-hold'];
@@ -46,8 +47,8 @@ try {
     if (exited) {
       console.log('  Server exited.\n');
     } else {
-      console.warn('  Server still alive after 30s - forcing kill.\n');
-      forceKillTree(serverPid);
+      console.warn('  Server still alive after 30s - forcing server process kill.\n');
+      forceKillPid(serverPid);
       await sleep(1500);
     }
   } else {
@@ -55,7 +56,15 @@ try {
   }
 
   await sleep(1500);
-  if (isWin && serverPid) forceKillTree(serverPid);
+  if (cleanupPids.length) {
+    console.log(`Cleaning up ${cleanupPids.length} pre-existing child process${cleanupPids.length === 1 ? '' : 'es'}...`);
+    for (const pid of cleanupPids) {
+      if (!isPidAlive(pid)) continue;
+      forceKillTree(pid);
+    }
+    await sleep(1000);
+    console.log('  Cleanup complete.\n');
+  }
 
   console.log(`Running: ${displayCommand}\n`);
   console.log(HR);
@@ -143,6 +152,19 @@ function toPid(raw) {
   return Number.isFinite(pid) && pid > 0 ? pid : null;
 }
 
+function sanitizePidList(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  const seen = new Set();
+  for (const item of raw) {
+    const pid = toPid(item);
+    if (!pid || seen.has(pid)) continue;
+    seen.add(pid);
+    out.push(pid);
+  }
+  return out;
+}
+
 async function waitForExit(pid, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
@@ -176,6 +198,20 @@ function forceKillTree(pid) {
   } catch {}
 }
 
+function forceKillPid(pid) {
+  try {
+    if (isWin) {
+      spawnSync('taskkill', ['/pid', String(pid), '/F'], {
+        shell: true,
+        windowsHide: true,
+        stdio: 'ignore',
+      });
+    } else {
+      try { process.kill(pid, 'SIGKILL'); } catch {}
+    }
+  } catch {}
+}
+
 function printFixTips(command) {
   console.error('Common fixes:');
   if (isWin) {