synabun 2.0.0 → 2.0.5

package/neural-interface/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neural-memory-interface",
-  "version": "2.0.0",
+  "version": "2.0.5",
   "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/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

@@ -614,7 +614,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 +623,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

@@ -7,6 +7,7 @@
 <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; }
 
@@ -1412,6 +1413,12 @@ 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';
+
+// Chrome and Edge hand the page their install event when it can be installed; Safari and Firefox have none.
+if (!isStandalone()) initPwaInstall();
 
 // ═══════════════════════════════════════════
 // STATE
@@ -1538,6 +1545,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 +1829,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(() => {

package/neural-interface/public/shared/agent-runtime-options.js

@@ -130,6 +130,14 @@ export function clampEffortId(effort, ids) {
 
 export const CODEX_EFFORT_VALUE_IDS = EFFORT_LEVELS_BY_PROFILE.codex.map(e => e.id);
 
+// The Claude and Codex lists are asked again once a copy is this old (the server
+// answers from its own discovery cache, so it is a local round trip): a page that
+// stays open for days must not keep the list it loaded with. OpenCode's copy is
+// dropped by its change events instead (`ocp-providers-changed`): its list is large.
+const MODEL_LIST_MAX_AGE_MS = 60_000;
+const _modelListAt = new Map();
+function modelListIsFresh(key) { return Date.now() - (_modelListAt.get(key) || 0) < MODEL_LIST_MAX_AGE_MS; }
+
 const _codexModelsCache = new Map();
 const _codexModelsLoading = new Map();
 let _opencodeModelsCache = null;
@@ -268,7 +276,7 @@ export function mergeCodexModelIds(models = []) {
 
 export async function fetchCodexModels(force = false, accountId = 'default') {
   const account = String(accountId || 'default');
-  if (!force && _codexModelsCache.has(account)) return _codexModelsCache.get(account);
+  if (!force && _codexModelsCache.has(account) && modelListIsFresh(`codex:${account}`)) return _codexModelsCache.get(account);
   if (_codexModelsLoading.has(account)) return _codexModelsLoading.get(account);
   const loading = (async () => {
     try {
@@ -278,6 +286,7 @@ export async function fetchCodexModels(force = false, accountId = 'default') {
       const models = Array.isArray(data?.models) ? data.models : [];
       const normalized = mergeCodexModelOptions(models, { fallback: false });
       _codexModelsCache.set(account, normalized);
+      _modelListAt.set(`codex:${account}`, Date.now());
       return normalized;
     } catch {
       const previous = _codexModelsCache.get(account) || [];
@@ -455,19 +464,25 @@ export async function fetchOpencodeModels(force = false) {
 // Live model list from the installed Claude Code CLI. Falls back to the static
 // list so the picker still renders when the CLI is missing or discovery fails.
 export async function fetchClaudeModels(force = false) {
-  if (!force && _claudeModelsCache && _claudeModelsCache.length) return _claudeModelsCache;
+  if (!force && _claudeModelsCache && _claudeModelsCache.length && modelListIsFresh('claude-code')) return _claudeModelsCache;
   if (_claudeModelsLoading) return _claudeModelsLoading;
+  // A list the CLI verified is never traded for the unverified stand-in: a discovery
+  // that fails once (mid-update, mid-restart) must not strip a working picker.
+  const verified = () => (_claudeModelsCache?.length && _claudeModelsCache.some(m => m.catalogSource !== 'fallback') ? _claudeModelsCache : null);
   _claudeModelsLoading = (async () => {
     try {
       const resp = await fetch(`/api/claude/models${force ? '?refresh=1' : ''}`);
       const data = await resp.json().catch(() => ({}));
       const models = Array.isArray(data?.models) ? data.models : [];
-      _claudeModelsCache = models.length
-        ? models.map(model => ({ ...model, catalogSource: data?.source || 'cli' }))
-        : [...CLAUDE_FALLBACK_MODELS];
+      if (models.length && data?.source !== 'fallback') {
+        _claudeModelsCache = models.map(model => ({ ...model, catalogSource: data?.source || 'cli' }));
+        _modelListAt.set('claude-code', Date.now());
+      } else {
+        _claudeModelsCache = verified() || (models.length ? models.map(model => ({ ...model, catalogSource: 'fallback' })) : [...CLAUDE_FALLBACK_MODELS]);
+      }
       return _claudeModelsCache;
     } catch {
-      _claudeModelsCache = [...CLAUDE_FALLBACK_MODELS];
+      _claudeModelsCache = verified() || [...CLAUDE_FALLBACK_MODELS];
       return _claudeModelsCache;
     } finally {
       _claudeModelsLoading = null;
@@ -585,6 +600,7 @@ export function clearRuntimeOptionCaches() {
   _codexModelsLoading.clear();
   _opencodeModelsCache = null;
   _claudeModelsCache = null;
+  _modelListAt.clear();
   _mcpProfilePresets = null;
   _claudeAccountsCache = null;
   _opencodeAgentsCache = null;

package/neural-interface/public/shared/assistant/asst-automation.js

@@ -0,0 +1,286 @@
+// ═══════════════════════════════════════════
+// SynaBun — Assistant: the automation trace, as words (DOM-free)
+// ═══════════════════════════════════════════
+//
+// One `synabun.automation` event per turn phase (lib/assistant-user-context.js)
+// says what the harness did for the turn: what it put into the brain's context
+// (the standing digest, the per-turn notes, the related memories), what it held
+// back and why, and what it learned from the user's own words afterwards.
+// This module turns one snapshot into the lines asst-render.js draws: nothing
+// here touches the DOM, so it is unit-tested in Node.
+//
+// AUTOMATION_COPY is the English; `assistant.automation.*` in i18n/*.json must
+// equal it (tests/assistant-automation-view.test.mjs).
+
+export const AUTOMATION_EVENT = 'synabun.automation';
+
+export const AUTOMATION_COPY = Object.freeze({
+  title: 'Automation',
+  'sum.turn': '{n} tok this turn',
+  'sum.standing': '{n} standing',
+  'sum.none': 'nothing injected',
+  'state.waiting': 'learning after the reply',
+  'state.running': 'learning…',
+  'state.learned': 'learned 1 thing',
+  'state.confirmed': 'confirmed 1 thing',
+  'state.replaced': 'replaced 1 thing',
+  'group.injected': 'Injected',
+  'group.withheld': 'Withheld',
+  'group.learning': 'Learning',
+  'group.session': 'This conversation',
+  'tier.greeting': 'Greeting',
+  'tier.digest': 'Knowledge digest',
+  'tier.last-thread': 'Last conversation',
+  'tier.environment': 'Environment',
+  'tier.open-item': 'Open item',
+  'tier.cue': 'Knowledge cue',
+  'tier.delta': 'New knowledge',
+  'tier.recall': 'Related memories',
+  'tier.knowledge': 'Knowledge of you',
+  'tier.nudges': 'Recent-interaction nudges',
+  'tier.turn': 'Per-turn notes',
+  tok: '{n} tok',
+  'meta.standing': 'system slot · frozen {time}',
+  'meta.standingRef': 'already in the system slot, not resent',
+  'meta.memories': '{n} memories',
+  'meta.memory': '1 memory',
+  'meta.alreadyPresent': 'already supplied earlier',
+  'meta.budget': 'budget {used}/{max} tok',
+  'meta.greetingWriter': 'said at session open · written ahead by {model}',
+  'meta.greetingFallback': 'said at session open · from the records, no model',
+  'reason.layer-off': 'switched off in Settings',
+  'reason.nothing-known': 'nothing learned yet',
+  'reason.no-recent-thread': 'no recent conversation to mention',
+  'reason.in-greeting': 'already said in the greeting',
+  'reason.budget': 'over the turn budget, kept for a later turn',
+  'reason.not-ranked': 'not ranked relevant by Jev',
+  'reason.in-digest': 'already in the digest',
+  'reason.already-told': 'already told in this conversation',
+  'reason.replaced': 'replaced by a newer statement',
+  'reason.one-per-turn': 'one cue per turn',
+  'reason.unusable': 'no usable statement',
+  'reason.not-delivered': 'the turn ended before the notes could be delivered',
+  'reason.trivial': 'trivial prompt',
+  'reason.pattern': 'a command or an acknowledgement',
+  'reason.judged': 'Jev: memory would not change the reply',
+  'reason.nothing-retrieved': 'nothing relevant found',
+  'reason.disabled': 'automatic recall is off',
+  'reason.error': 'the search failed',
+  'reason.system': 'not a prompt of yours',
+  'learn.waiting': 'Your words are judged once the reply is done.',
+  'learn.running': 'Jev is reading what you typed…',
+  'learn.skipped': 'Not judged: {reason}.',
+  'learn.cues': 'Cue words: {cues}',
+  'learn.judged': 'Jev: lasting signal {p} · {facet} · {scope}',
+  'learn.matched': 'Matches: {statement}',
+  'learn.contradicts': 'Contradicts: {statement}',
+  'learn.created': 'Learned: {statement}',
+  'learn.updated': 'Confirmed (seen {n}×): {statement}',
+  'learn.superseded': 'Replaced “{old}” with: {statement}',
+  'learn.none': 'Nothing stored: {reason}.',
+  'learn.evidence': 'Evidence: “{quote}”',
+  'learn.writer': 'Written by {engine}',
+  'learn.writerOwn': 'Kept as your own sentence ({reason})',
+  'learn.writerKept': 'Statement kept as recorded',
+  'learn.cost': '{requests} Jev requests · {tokens} tok · {cost}',
+  'learn.scope.global': 'all projects',
+  'skip.no-cue': 'no always / never / from-now-on wording',
+  'skip.trivial': 'trivial prompt',
+  'skip.short': 'too short',
+  'skip.origin': 'not typed by you',
+  'skip.untrusted': 'forwarded content',
+  'skip.no-typed-text': 'only attachments or pasted text',
+  'skip.seen': 'the same words were already judged',
+  'skip.gate-cap': 'this conversation reached its limit of judgments',
+  'skip.write-cap': 'this conversation reached its limit of learned facts',
+  'skip.layer-off': 'Knowledge of you is off',
+  'skip.system': 'not a prompt of yours',
+  'none.not-durable': 'not a lasting preference',
+  'none.no-answer': 'Jev did not answer',
+  'none.jev-unavailable': 'Jev is off or has no key',
+  'none.duplicate': 'memory already states this',
+  'none.write-cap': 'this conversation reached its limit of learned facts',
+  'none.no-evidence': 'no sentence carried it',
+  'none.no-statement': 'no usable statement',
+  'none.write-error': 'the memory write failed',
+  'none.no-store': 'memory is not available',
+  'none.error': 'the learning step failed',
+  'writer.unverified': 'the rewrite could not be checked',
+  'writer.not-faithful': 'the rewrite added something',
+  'writer.no-writer': 'no writer model',
+  'writer.writer-cap': 'writer limit reached',
+  'writer.other': 'the writer failed',
+  totals: 'Judged {gate}/{gateCap} · writer {writer}/{writerCap} · learned {writes}/{writeCap} · {tokens} tok injected over {turns} turns · {cost}',
+  open: 'Open memory',
+});
+
+const fill = (text, params) => (params ? String(text).replace(/\{(\w+)\}/g, (_, key) => (params[key] != null ? params[key] : `{${key}}`)) : String(text));
+
+/** The translator: `t(key, params)` when it knows the key, else the English above. */
+export function automationText(t, key, params) {
+  const full = `assistant.automation.${key}`;
+  let value;
+  try { value = typeof t === 'function' ? t(full, params) : undefined; } catch { value = undefined; }
+  if (typeof value === 'string' && value && value !== full) return value;
+  const fallback = AUTOMATION_COPY[key];
+  return fallback == null ? key : fill(fallback, params);
+}
+
+const num = (value) => (Number.isFinite(Number(value)) ? Number(value) : 0);
+
+/** A dollar amount small enough to matter: 5 decimals under a cent, 2 above. */
+export function formatUsd(value) {
+  const n = num(value);
+  if (n <= 0) return '$0';
+  return n < 0.01 ? `$${n.toFixed(5).replace(/0+$/, '').replace(/\.$/, '')}` : `$${n.toFixed(2)}`;
+}
+const pct = (value) => `${Math.round(num(value) * 100)}%`;
+const defaultTime = (iso) => {
+  const ms = Date.parse(iso ?? '');
+  if (!Number.isFinite(ms)) return '';
+  try { return new Date(ms).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }); } catch { return ''; }
+};
+
+function writerLine(tx, learning) {
+  const action = learning.action || {};
+  const writer = learning.writer || {};
+  if (!action.engine) return null;
+  if (action.engine === 'kept') return tx('learn.writerKept');
+  if (action.engine === 'user-sentence') {
+    const code = writer.reason && AUTOMATION_COPY[`writer.${writer.reason}`] ? writer.reason : 'other';
+    return tx('learn.writerOwn', { reason: tx(`writer.${code}`) });
+  }
+  return tx('learn.writer', { engine: writer.verified != null ? `${action.engine} · ${pct(writer.verified)}` : action.engine });
+}
+
+/**
+ * One snapshot → what the trace row shows.
+ * → { traceId, phase, summary, state, tone, groups:[{ key, title, rows:[{ label, meta, text, pre, ids, tone }] }] }
+ *   tone: '' | 'busy' | 'learned'. `pre`: `text` is exact injected text (keep its line breaks).
+ */
+export function automationView(ev = {}, { t = null, formatTime = defaultTime } = {}) {
+  const tx = (key, params) => automationText(t, key, params);
+  const tokens = ev.tokens || {};
+  const injected = Array.isArray(ev.injected) ? ev.injected : [];
+  const withheld = Array.isArray(ev.withheld) ? ev.withheld : [];
+  const learning = ev.learning || {};
+  const totals = ev.totals || {};
+  const tok = (n) => tx('tok', { n: num(n) });
+  const tier = (code) => tx(`tier.${AUTOMATION_COPY[`tier.${code}`] ? code : 'turn'}`);
+
+  // ── the one-line summary ──
+  const turnTokens = num(tokens.turn) + num(tokens.recall);
+  const parts = [];
+  if (turnTokens > 0) parts.push(tx('sum.turn', { n: turnTokens }));
+  if (num(tokens.digest) > 0) parts.push(tx('sum.standing', { n: num(tokens.digest) }));
+  const summary = parts.length ? parts.join(' · ') : tx('sum.none');
+  let state = '';
+  let tone = '';
+  const action = learning.action || null;
+  if (learning.state === 'waiting') { state = tx('state.waiting'); tone = 'busy'; }
+  else if (learning.state === 'running') { state = tx('state.running'); tone = 'busy'; }
+  else if (learning.state === 'done' && action && action.type && action.type !== 'none') {
+    state = tx(action.type === 'update' ? 'state.confirmed' : action.type === 'supersede' ? 'state.replaced' : 'state.learned');
+    tone = 'learned';
+  }
+
+  const groups = [];
+  // ── injected ──
+  const injectedRows = injected.map((item) => {
+    const meta = [tok(item.tokens)];
+    if (item.tier === 'digest') meta.push(item.text ? tx('meta.standing', { time: formatTime(item.frozenAt) }) : tx('meta.standingRef'));
+    // The greeting: who wrote it and what that cost (the records it was built from are the links below it).
+    if (item.tier === 'greeting') {
+      meta.push(item.source === 'writer' ? tx('meta.greetingWriter', { model: item.model || 'Claude' }) : tx('meta.greetingFallback'));
+      if (item.source === 'writer' && Number(item.costUsd) > 0) meta.push(formatUsd(item.costUsd));
+    }
+    if (item.tier === 'recall') {
+      const n = Array.isArray(item.ids) ? item.ids.length : 0;
+      meta.push(n === 1 ? tx('meta.memory') : tx('meta.memories', { n }));
+      if (item.alreadyPresent) meta.push(tx('meta.alreadyPresent'));
+    }
+    return { label: tier(item.tier), meta: meta.filter(Boolean).join(' · '), text: item.text || '', pre: item.tier === 'digest' && !!item.text, ids: item.tier === 'recall' ? [] : (Array.isArray(item.ids) ? item.ids : []), tone: '' };
+  });
+  if (injectedRows.length) {
+    if (num(tokens.budget) > 0) injectedRows.push({ label: tier('turn'), meta: tx('meta.budget', { used: num(tokens.turn), max: num(tokens.budget) }), text: '', pre: false, ids: [], tone: 'muted' });
+    groups.push({ key: 'injected', title: tx('group.injected'), rows: injectedRows });
+  }
+  // ── withheld ──
+  if (withheld.length) {
+    groups.push({
+      key: 'withheld', title: tx('group.withheld'),
+      rows: withheld.map((item) => ({
+        label: tier(item.tier), meta: tx(`reason.${AUTOMATION_COPY[`reason.${item.reason}`] ? item.reason : 'unusable'}`),
+        text: item.text || '', pre: false, ids: Array.isArray(item.ids) ? item.ids : [], tone: 'muted',
+      })),
+    });
+  }
+  // ── learning ──
+  const learnRows = [];
+  const pre = learning.prefilter || {};
+  if (learning.state === 'skipped') {
+    learnRows.push({ label: '', meta: '', text: tx('learn.skipped', { reason: tx(`skip.${AUTOMATION_COPY[`skip.${pre.reason}`] ? pre.reason : 'no-cue'}`) }), pre: false, ids: [], tone: 'muted' });
+  } else if (learning.state === 'waiting' || learning.state === 'running') {
+    if (Array.isArray(pre.cues) && pre.cues.length) learnRows.push({ label: '', meta: '', text: tx('learn.cues', { cues: pre.cues.join(', ') }), pre: false, ids: [], tone: '' });
+    learnRows.push({ label: '', meta: '', text: tx(learning.state === 'waiting' ? 'learn.waiting' : 'learn.running'), pre: false, ids: [], tone: 'muted' });
+  } else if (learning.state === 'done') {
+    const gate = learning.gate || null;
+    if (Array.isArray(pre.cues) && pre.cues.length) learnRows.push({ label: '', meta: '', text: tx('learn.cues', { cues: pre.cues.join(', ') }), pre: false, ids: [], tone: '' });
+    if (gate?.answered) {
+      learnRows.push({ label: '', meta: '', text: tx('learn.judged', { p: pct(gate.durable), facet: gate.facet || '', scope: !gate.scope || gate.scope === 'global' ? tx('learn.scope.global') : gate.scope }), pre: false, ids: [], tone: '' });
+      if (gate.contradicts) learnRows.push({ label: '', meta: pct(gate.contradicts.probability), text: tx('learn.contradicts', { statement: gate.contradicts.statement }), pre: false, ids: [gate.contradicts.id].filter(Boolean), tone: '' });
+      else if (gate.match) learnRows.push({ label: '', meta: pct(gate.match.confidence), text: tx('learn.matched', { statement: gate.match.statement }), pre: false, ids: [gate.match.id].filter(Boolean), tone: '' });
+    }
+    const act = action || { type: 'none', reason: 'error' };
+    if (act.type === 'none') {
+      const code = AUTOMATION_COPY[`none.${act.reason}`] ? act.reason : 'error';
+      const extra = act.reason === 'not-durable' && gate?.durable != null ? ` (${pct(gate.durable)})` : '';
+      learnRows.push({ label: '', meta: '', text: tx('learn.none', { reason: `${tx(`none.${code}`)}${extra}` }), pre: false, ids: [act.duplicateOf].filter(Boolean), tone: 'muted' });
+    } else {
+      const text = act.type === 'update' ? tx('learn.updated', { n: num(act.seen) || 2, statement: act.statement })
+        : act.type === 'supersede' ? tx('learn.superseded', { old: act.replaced || '', statement: act.statement })
+          : tx('learn.created', { statement: act.statement });
+      learnRows.push({ label: '', meta: [act.facet, !act.scope || act.scope === 'global' ? tx('learn.scope.global') : act.scope].filter(Boolean).join(' · '), text, pre: false, ids: [act.memoryId, act.supersedes].filter(Boolean), tone: 'learned' });
+      if (act.evidence) learnRows.push({ label: '', meta: '', text: tx('learn.evidence', { quote: act.evidence }), pre: false, ids: [], tone: '' });
+      const written = writerLine(tx, learning);
+      if (written) learnRows.push({ label: '', meta: '', text: written, pre: false, ids: [], tone: 'muted' });
+    }
+    const cost = learning.cost || {};
+    if (num(cost.jevRequests) > 0 || num(cost.writerUsd) > 0) {
+      const writerTokens = cost.writerTokens ? num(cost.writerTokens.input) + num(cost.writerTokens.output) + num(cost.writerTokens.cacheRead) + num(cost.writerTokens.cacheWrite) : 0;
+      learnRows.push({ label: '', meta: '', text: tx('learn.cost', { requests: num(cost.jevRequests), tokens: num(cost.jevInputTokens) + num(cost.jevOutputTokens) + writerTokens, cost: formatUsd(cost.totalUsd) }), pre: false, ids: [], tone: 'muted' });
+    }
+  }
+  if (learnRows.length) groups.push({ key: 'learning', title: tx('group.learning'), rows: learnRows });
+  // ── session totals ──
+  if (num(totals.turns) > 0) {
+    groups.push({
+      key: 'session', title: tx('group.session'),
+      rows: [{ label: '', meta: '', text: tx('totals', { gate: num(totals.gate), gateCap: num(totals.gateCap), writer: num(totals.writer), writerCap: num(totals.writerCap), writes: num(totals.writes), writeCap: num(totals.writeCap), tokens: num(totals.injectedTokens), turns: num(totals.turns), cost: formatUsd(totals.costUsd) }), pre: false, ids: [], tone: 'muted' }],
+    });
+  }
+  return { traceId: String(ev.traceId || ''), phase: String(ev.phase || 'sent'), title: tx('title'), summary, state, tone, groups };
+}
+
+// ── typed words (the composer) ──────────────────────────────────────────────
+// A paste this long, or this many lines, is text the user did not type
+// (lib/assistant-user-context-budgets.js LEARN.pasteChars / pasteLines): the
+// prompt still carries it, the `typed` text the server may learn from does not.
+export const PASTE_MIN_CHARS = 200;
+export const PASTE_MIN_LINES = 4;
+
+export function isLongPaste(text) {
+  const value = String(text ?? '');
+  if (!value.trim()) return false;
+  return value.length >= PASTE_MIN_CHARS || value.split(/\r\n|\r|\n/).filter((line) => line.trim()).length >= PASTE_MIN_LINES;
+}
+
+/** The composer's text without the long pastes still in it (those edited since count as typed). */
+export function typedText(text, pastes = []) {
+  let out = String(text ?? '').replace(/\r\n?/g, '\n');
+  for (const paste of Array.isArray(pastes) ? pastes : []) {
+    const block = String(paste ?? '').replace(/\r\n?/g, '\n').trim();
+    if (block && out.includes(block)) out = out.split(block).join('\n');
+  }
+  return out.replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n').trim();
+}