@jossuealcala/madre 0.2.3 → 0.3.1

package/public/app.js

@@ -45,6 +45,7 @@ const PLACEHOLDERS = {
   ghost: 'Off the record. Ask anything; nothing is saved, nobody else will remember it.',
   control: 'Control armed. Say what to change in the project; every action runs without asking.',
   expendable: 'Type here, human. MOTHER is listening.',
+  memory: 'Ask what the room remembers. @madre answers from memory with citations; it does not act.',
 };
 let winkTimer = null;
 const LINE_PX = 21;
@@ -63,7 +64,9 @@ const state = {
   budget: null,
   timeouts: {},
   seen: new Set(),
-  userMessages: new Map(), // messageId -> { text, target }
+  userMessages: new Map(),
+  ratings: new Map(),        // messageId → good | bad, from the ledger
+  ratingNodes: new Map(),    // messageId → the buttons of that bubble // messageId -> { text, target }
   lastSequence: 0,
   lastSender: null,        // for iMessage-style grouping of consecutive bubbles
   failures: [],            // recorded conditions for MU/TH/UR
@@ -727,6 +730,11 @@ function renderPicker() {
     const text = paint(el('span', 'pick-label'), current.id);
     text.append('to ');
     text.append(el('b', null, `@${current.id}`));
+    if (current.local) {
+      const note = el('span', 'pick-note', 'memory · answers & asks the crew · never writes');
+      note.title = '@madre runs on this machine and speaks for what the room remembers. "@madre, ask the crew …" opens a round with every agent online. To change files, write to a CLI agent.';
+      text.append(note);
+    }
     const modeChip = el('button', `mode-chip m${state.mode}`);
     modeChip.type = 'button';
     modeChip.append(el('b', null, `#${state.mode}`), `${MODES[state.mode].label} ▾`);
@@ -1053,7 +1061,7 @@ function renderAssistantMessage(event) {
   bubble.append(renderMarkdown(text));
   if (originalText) bubble.append(ashOriginal(originalText, ashCode));
   if (event.payload.artifacts?.length) bubble.append(artifactTiles(event.payload.artifacts));
-  bubble.append(bubbleActions({ text: originalText ?? text, sender, sequence: event.sequence }));
+  bubble.append(bubbleActions({ text: originalText ?? text, sender, sequence: event.sequence, messageId: delegated ? null : messageId }));
   col.append(bubble);
   const stamp = el('div', 'stamp');
   stamp.id = `usage-${messageId}`;
@@ -1076,7 +1084,27 @@ function iconButton(svg, title, className) {
   button.innerHTML = svg;
   return button;
 }
-function bubbleActions({ text, sender, sequence }) {
+const ICON_GOOD = '<svg viewBox="0 0 16 16" aria-hidden="true"><path d="M5.5 7.5v5.5H3.2a.7.7 0 0 1-.7-.7V8.2a.7.7 0 0 1 .7-.7h2.3Zm0 0 2.6-4.6a1.3 1.3 0 0 1 2.4.8L10 6.8h2.6a1.3 1.3 0 0 1 1.3 1.5l-.8 3.9a1.3 1.3 0 0 1-1.3 1H5.5" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linejoin="round"/></svg>';
+const ICON_BAD = '<svg viewBox="0 0 16 16" aria-hidden="true"><path d="M10.5 8.5V3H12.8a.7.7 0 0 1 .7.7v4.1a.7.7 0 0 1-.7.7h-2.3Zm0 0-2.6 4.6a1.3 1.3 0 0 1-2.4-.8L6 9.2H3.4a1.3 1.3 0 0 1-1.3-1.5l.8-3.9A1.3 1.3 0 0 1 4.2 3h6.3" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linejoin="round"/></svg>';
+// The human's verdict on a reply. Saved in the ledger; the dataset drops what is marked bad.
+function ratingButtons(messageId, sender) {
+  const good = iconButton(ICON_GOOD, 'Good reply · keep it for MADRE AI', 'rate good');
+  const bad = iconButton(ICON_BAD, 'Bad reply · keep it out of the dataset', 'rate bad');
+  const apply = (rating) => { good.classList.toggle('on', rating === 'good'); bad.classList.toggle('on', rating === 'bad'); };
+  apply(state.ratings.get(messageId) ?? null);
+  const send = async (rating) => {
+    const current = state.ratings.get(messageId) ?? null;
+    const next = current === rating ? 'none' : rating;
+    try {
+      const payload = await fetch('/api/messages/rate', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ messageId, rating: next }) }).then((response) => response.json());
+      if (payload.error) throw new Error(payload.error);
+    } catch (error) { toast(`Rating was not saved: ${error.message}`); }
+  };
+  good.addEventListener('click', (event) => { event.stopPropagation(); void send('good'); });
+  bad.addEventListener('click', (event) => { event.stopPropagation(); void send('bad'); });
+  return { good, bad, apply, sender };
+}
+function bubbleActions({ text, sender, sequence, messageId = null }) {
   const bar = el('div', 'bubble-actions');
   const copy = iconButton(ICON_COPY, 'Copy this reply', 'copy');
   copy.addEventListener('click', async (event) => {
@@ -1096,6 +1124,11 @@ function bubbleActions({ text, sender, sequence }) {
     const rect = reply.getBoundingClientRect();
     showReplyMenu({ text, sender, sequence }, rect.left, rect.bottom + 6);
   });
+  if (messageId && sender !== 'madre') {
+    const rating = ratingButtons(messageId, sender);
+    state.ratingNodes.set(messageId, rating);
+    bar.append(rating.good, rating.bad);
+  }
   bar.append(copy, reply);
   return bar;
 }
@@ -1245,6 +1278,20 @@ function renderThinking(event) {
 }
 
 // The archivist reports: which agent read which stretch of the room and how many notes it kept.
+// privacy · @agent · 2 private terms replaced with [ENTIDAD-ORG]
+function renderPrivacy(event) {
+  const node = el('div', 'system memory privacy');
+  if (event.type === 'privacy.purged') {
+    const { events, entries, memories } = event.payload;
+    node.append('privacy · ', el('b', 'who', 'PURGE'), ` · ${events} event${events === 1 ? '' : 's'} · ${entries} indexed exchange${entries === 1 ? '' : 's'} · ${memories} memor${memories === 1 ? 'y' : 'ies'} rewritten with the marker`);
+    return node;
+  }
+  const { agent, hits, marker } = event.payload;
+  node.style.setProperty('--agent', agentColor(agent));
+  node.append('privacy · ', el('b', 'who', `@${agent}`), ` · ${hits} private term${hits === 1 ? '' : 's'} replaced with ${marker}`);
+  return node;
+}
+
 function renderDistilled(event) {
   const { agent, added, considered, fromSequence, throughSequence, remaining, error, skipped, total, next } = event.payload;
   const node = el('div', `system memory${error ? ' warn' : ''}`);
@@ -1769,8 +1816,26 @@ function renderEventNode(event) {
     case 'message.failed': state.running.delete(event.payload.messageId); updateStopAll(); node = renderFailure(event); break;
     case 'handoff.created': node = renderHandoff(event); break;
     case 'memory.distilled': node = renderDistilled(event); break;
+    case 'message.rated': { const { messageId: rated, rating } = event.payload; if (rating === 'none') state.ratings.delete(rated); else state.ratings.set(rated, rating); state.ratingNodes.get(rated)?.apply(rating === 'none' ? null : rating); return; }
+    case 'privacy.redacted': node = renderPrivacy(event); break;
+    case 'privacy.purged': node = renderPrivacy(event); break;
+    case 'privacy.warning': if (!replaying) toast(`MU/TH/UR › your message carries ${event.payload.hits} private term${event.payload.hits === 1 ? '' : 's'}. Agents will read it as you wrote it; their replies are guarded.`); return;
     case 'memory.forgotten': node = renderForgotten(event); break;
     case 'memory.noted': attachMemoryHint(event); return;
+    case 'dataset.exported': return;
+    case 'agents.updated': {
+      for (const agent of event.payload.agents ?? []) {
+        const known = state.agents.get(agent.id);
+        state.agents.set(agent.id, { ...(known ?? { tokens: 0, rawTokens: 0, windowMs: null, rollsOverAt: null, officialPercent: null, officialResetAt: null, officialWindows: null }), ...agent });
+        const option = [...els.target.options].find((item) => item.value === agent.id);
+        if (agent.ready && !option) els.target.add(new Option(agent.label, agent.id));
+        if (!agent.ready && option) option.remove();
+      }
+      for (const id of event.payload.removed ?? []) { state.agents.delete(id); [...els.target.options].find((item) => item.value === id)?.remove(); }
+      renderAgents(); renderPicker(); renderOnboarding();
+      if (!replaying && event.payload.reason) toast(`MU/TH/UR › ${event.payload.reason}`);
+      return;
+    }
     case 'mother.alert': node = renderMotherAlert(event); break;
     case 'sentinel.report': state.reports.set(event.payload.id, { ...event.payload }); if (!replaying) { renderMotherSentinel(); toast(`MU/TH/UR › ${event.payload.kind === 'crash' ? 'a crash' : 'an unknown condition'} was recorded by the sentinel. Open MU/TH/UR to report it.`); } return;
     case 'sentinel.sent': { const report = state.reports.get(event.payload.id); if (report) report.sent = { ok: event.payload.ok, status: event.payload.status ?? null, error: event.payload.error ?? null, at: event.timestamp }; if (!replaying) renderMotherSentinel(); return; }
@@ -2322,7 +2387,8 @@ function updateCrewLabel() {
           : state.expendable ? 'CREW · EXPENDABLE ›' : 'HUMAN ›';
 }
 function updatePlaceholder() {
-  els.input.placeholder = state.mode === 3 ? PLACEHOLDERS.control : state.mode === 0 ? PLACEHOLDERS.ghost : state.create ? PLACEHOLDERS.create : (state.ashCode && state.ashCodeInstalled) ? PLACEHOLDERS.order : state.expendable ? PLACEHOLDERS.expendable : PLACEHOLDERS.plain;
+  const local = Boolean(state.agents.get(els.target.value)?.local);
+  els.input.placeholder = state.mode === 3 ? PLACEHOLDERS.control : state.mode === 0 ? PLACEHOLDERS.ghost : local ? PLACEHOLDERS.memory : state.create ? PLACEHOLDERS.create : (state.ashCode && state.ashCodeInstalled) ? PLACEHOLDERS.order : state.expendable ? PLACEHOLDERS.expendable : PLACEHOLDERS.plain;
 }
 function setOrder937(on, { wink = false } = {}) {
   state.ashCode = on;
@@ -2633,6 +2699,8 @@ function renderMotherRecorded() {
       jump.type = 'button';
       jump.addEventListener('click', () => {
         mother.input.value = '';
+        // Choosing a fix from the log is a request to see it: the list opens and stays open.
+        try { localStorage.setItem('pulse.mother.known', 'expanded'); } catch { /* no storage */ }
         renderMotherKnown(CONDITIONS, new Set(matches.map((item) => item.id)), failure.agent);
         document.getElementById(`mother-${condition.id}`)?.scrollIntoView({ behavior: 'smooth', block: 'center' });
       });
@@ -2645,7 +2713,23 @@ function renderMotherRecorded() {
 
 function renderMotherKnown(list = CONDITIONS, hits = new Set(), agent = null) {
   mother.known.replaceChildren();
-  mother.known.append(el('h3', null, `KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[mother.platform].label.toUpperCase()} / ${PLATFORMS[mother.platform].shell.toUpperCase()}`));
+  let collapsed = false;
+  try { collapsed = localStorage.getItem('pulse.mother.known') === 'collapsed'; } catch { /* no storage */ }
+  // An inquiry that narrowed the list, or a fix chosen from the log, always shows its answer, whatever the stored state.
+  if (list.length !== CONDITIONS.length || hits.size) collapsed = false;
+  const head = el('h3', 'toggle');
+  const headButton = el('button', null, `KNOWN CONDITIONS · ${list.length} OF ${CONDITIONS.length} · ${PLATFORMS[mother.platform].label.toUpperCase()} / ${PLATFORMS[mother.platform].shell.toUpperCase()}`);
+  headButton.type = 'button';
+  headButton.setAttribute('aria-expanded', String(!collapsed));
+  headButton.append(el('span', 'caret', collapsed ? '▸ EXPAND' : '▾ COLLAPSE'));
+  headButton.addEventListener('click', () => {
+    try { localStorage.setItem('pulse.mother.known', collapsed ? 'expanded' : 'collapsed'); } catch { /* no storage */ }
+    renderMotherKnown(list, hits, agent);
+  });
+  head.append(headButton);
+  mother.known.append(head);
+  mother.known.classList.toggle('collapsed', collapsed);
+  if (collapsed) return;
   const grid = el('div', 'mother-grid');
   const ordered = [...list].sort((a, b) => Number(hits.has(b.id)) - Number(hits.has(a.id)));
   for (const condition of ordered) grid.append(conditionCard(condition, { hit: hits.has(condition.id), agent: agent && condition.perAgent ? agent : null, hintAgent: agent }));
@@ -2813,6 +2897,61 @@ function builtinCard(item) {
   for (const line of item.creates ?? []) list.append(el('li', null, line));
   for (const line of item.requires ?? []) list.append(el('li', null, `requires ${line}`));
   card.append(list);
+  if (item.id === 'ollama') {
+    const info = item.ollama ?? { running: false, models: [], settings: {} };
+    const status = el('dl', 'ollama-status');
+    const put = (k, v) => { status.append(el('dt', null, k), el('dd', null, v)); };
+    put('SERVER', info.running ? `running · ${info.host}` : 'not running');
+    put('EMBEDDINGS', info.embedModel ? `${info.embedModel}${info.settings.embeddings === false ? ' · off' : ''}` : 'no embedding model');
+    put('ARCHIVIST', info.chatModel ? `${info.chatModel}${info.settings.archivist === false ? ' · off' : ''}` : 'no chat model');
+    if (info.models?.length) put('MODELS', info.models.map((model) => model.name).join(', '));
+    card.append(status);
+    const actions = el('div', 'actions');
+    const recheck = el('button', null, 'RECHECK');
+    recheck.type = 'button';
+    recheck.addEventListener('click', async () => { recheck.disabled = true; await fetch('/api/ollama/probe', { method: 'POST' }).catch(() => null); await refreshModules(); });
+    actions.append(recheck);
+    if (info.running) {
+      const toggle = el('button', on ? null : 'primary', info.settings.enabled === false ? 'ENABLE OLLAMA' : 'DISABLE OLLAMA');
+      toggle.type = 'button';
+      toggle.addEventListener('click', async () => {
+        toggle.disabled = true;
+        try {
+          const response = await fetch('/api/extensions/ollama/install', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' });
+          const result = await response.json().catch(() => ({}));
+          if (!response.ok) throw new Error(result.error ?? `HTTP ${response.status}`);
+          toast(result.enabled ? 'MU/TH/UR › OLLAMA ON · memory embeds and distils on this machine.' : 'MU/TH/UR › OLLAMA OFF · back to the providers.');
+          await refreshModules();
+        } catch (error) { toast(`Ollama could not change state: ${error.message}`); toggle.disabled = false; }
+      });
+      actions.append(toggle);
+      for (const [role, model, present] of [['embeddings', item.recommended?.embed ?? 'nomic-embed-text', Boolean(info.embedModel)], ['archivist', item.recommended?.chat ?? 'qwen2.5:3b', Boolean(info.chatModel)], ['agent', item.recommended?.chat ?? 'qwen2.5:3b', Boolean(info.chatModel)]]) {
+        if (present) {
+          const box = el('label', 'toggle');
+          const input = el('input'); input.type = 'checkbox'; input.checked = info.settings[role] !== false;
+          input.addEventListener('change', async () => { input.disabled = true; await fetch('/api/ollama/settings', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ [role]: input.checked }) }).catch(() => null); await refreshModules(); });
+          box.append(input, role === 'agent' ? '@MADRE IN THE ROOM' : role.toUpperCase());
+          actions.append(box);
+        } else {
+          const pull = el('button', 'primary', `PULL ${model}`);
+          pull.type = 'button';
+          pull.title = `Download ${model} into Ollama for ${role}`;
+          pull.addEventListener('click', async () => {
+            pull.disabled = true;
+            const response = await fetch('/api/ollama/pull', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ model }) });
+            const result = await response.json().catch(() => ({}));
+            if (!response.ok) { toast(`MU/TH/UR › ${result.error ?? 'could not pull'}`); pull.disabled = false; }
+            else toast(`MU/TH/UR › pulling ${model}; progress shows in the room.`);
+          });
+          actions.append(pull);
+        }
+      }
+    } else {
+      card.append(el('p', 'confirm', 'Start Ollama (the app, or `ollama serve` in a terminal), then RECHECK. Without it the room keeps using its providers.'));
+    }
+    card.append(actions);
+    return card;
+  }
   if (item.id === 'ripley') {
     const actions = el('div', 'actions');
     const toggle = el('button', on ? null : 'primary', on ? 'DISABLE RIPLEY' : 'ENABLE RIPLEY');
@@ -3385,6 +3524,161 @@ function renderSettings() {
     save.disabled = false;
   });
   section.append(form);
+
+  // MEMORY: who distils, with whom, how often, where it embeds, how much recall a turn gets. Saves as you change it.
+  const mem = data.settings.memory;
+  if (mem) {
+    section.append(el('h3', null, `MEMORY · ${mem.stats ? `${mem.stats.entries} EXCHANGES · ${mem.stats.memories} MEMORIES · ${mem.stats.pending} WAITING` : 'NO INDEX'}`));
+    section.append(el('p', 'note', 'THE ARCHIVIST READS WHAT NOBODY HAS DISTILLED AND KEEPS THE FEW NOTES WORTH REMEMBERING. THE CHEAPEST ALLOWED AGENT GOES FIRST; A LOCAL MODEL COSTS NOTHING AND KEEPS EVERYTHING ON THIS MACHINE.'));
+    const mform = el('form', 'room-form memory-form');
+    const save = async (memoryPatch, describe) => { try { await saveSettingNow({ memory: memoryPatch }, describe); await loadSettings(); } catch (error) { toast(`Memory setting was not saved: ${error.message}`); } };
+    const field = (labelText, node) => { const label = el('label'); label.append(labelText); label.append(node); return label; };
+    const archivist = el('select');
+    for (const [value, text] of [['auto', 'AUTO · cheapest allowed'], ...mem.candidates.map((c) => [c.id, `@${c.id}${c.local ? ` · ${c.label}` : ''}`])]) { const option = el('option', null, text); option.value = value; if (value === mem.archivist) option.selected = true; archivist.append(option); }
+    archivist.addEventListener('change', () => save({ archivist: archivist.value }, archivist.value === 'auto' ? 'archivist: the cheapest allowed agent goes first.' : `archivist: @${archivist.value} distils first.`));
+    mform.append(field('ARCHIVIST', archivist));
+    const every = el('input'); every.type = 'number'; every.min = '1'; every.step = '1'; every.value = String(mem.every);
+    wireInstantNumber(every, { min: 1, toPatch: (value) => ({ memory: { every: value } }), describe: (value) => `distil every ${value} exchange${value === 1 ? '' : 's'}.` });
+    mform.append(field('DISTIL EVERY · EXCHANGES', every));
+    const idle = el('input'); idle.type = 'number'; idle.min = '1'; idle.step = '1'; idle.value = String(mem.idleMinutes);
+    wireInstantNumber(idle, { min: 1, toPatch: (value) => ({ memory: { idleMinutes: value } }), describe: (value) => `or after ${value} quiet minute${value === 1 ? '' : 's'}.` });
+    mform.append(field('OR AFTER · QUIET MINUTES', idle));
+    const share = el('input'); share.type = 'number'; share.min = '0'; share.max = '60'; share.step = '5'; share.value = String(Math.round(mem.recallShare * 100));
+    wireInstantNumber(share, { min: 0, toPatch: (value) => ({ memory: { recallShare: Math.min(60, value) / 100 } }), describe: (value) => `recall may take ${Math.min(60, value)}% of each turn's context.` });
+    mform.append(field('RECALL · % OF CONTEXT', share));
+    const embed = el('select');
+    const embedOptions = [['auto', 'AUTO · Ollama if running, else Gemini'], ['ollama', `OLLAMA · local${mem.ollama.embedModel ? ` · ${mem.ollama.embedModel}` : ' · no model yet'}`], ['gemini', 'GEMINI · needs your key'], ['off', 'OFF · words only']];
+    for (const [value, text] of embedOptions) { const option = el('option', null, text); option.value = value; if (value === (mem.embedProvider ?? data.config?.memory?.embedProvider ?? 'auto')) option.selected = true; embed.append(option); }
+    embed.addEventListener('change', () => save({ embedProvider: embed.value }, `embeddings: ${embed.options[embed.selectedIndex].textContent.toLowerCase()}.`));
+    const embedLabel = field(`EMBEDDINGS · NOW ${mem.embedder ? mem.embedder.toUpperCase() : 'OFF'}`, embed);
+    mform.append(embedLabel);
+    const who = el('div', 'full');
+    who.append(el('span', 'note', 'MAY DISTIL:'));
+    const allowed = new Set(mem.archivists ?? mem.candidates.map((c) => c.id));
+    for (const candidate of mem.candidates) {
+      const toggle = el('label', 'toggle');
+      const box = el('input'); box.type = 'checkbox'; box.checked = allowed.has(candidate.id);
+      box.addEventListener('change', () => {
+        if (box.checked) allowed.add(candidate.id); else allowed.delete(candidate.id);
+        if (!allowed.size) { box.checked = true; allowed.add(candidate.id); toast('MU/TH/UR › someone has to keep the archive.'); return; }
+        void save({ archivists: allowed.size === mem.candidates.length ? [] : [...allowed] }, `archivists: ${[...allowed].map((id) => `@${id}`).join(', ')}.`);
+      });
+      toggle.append(box, `@${candidate.id.toUpperCase()}${candidate.local ? ' · LOCAL · FREE' : ''}`);
+      who.append(toggle);
+    }
+    mform.append(who);
+    // The dataset behind MADRE AI: export what the room kept, train outside, @madre picks the result up.
+    const dataset = el('div', 'full dataset-row');
+    const exportButton = el('button', null, 'EXPORT DATASET');
+    exportButton.type = 'button';
+    exportButton.title = 'Write train.jsonl and valid.jsonl next to the ledger, redacted, in chat format for mlx-lm';
+    const datasetNote = el('span', 'note', 'LOADING…');
+    const showDataset = (payload) => {
+      const d = payload?.dataset;
+      const r = payload?.readiness;
+      const live = r ? `${r.pairs} / ${r.target} CLEAN PAIRS${r.ready ? ' · READY TO TRAIN' : ''} · ${r.turns} TURNS · ${r.delegated} DELEGATED · ${r.notes} NOTES${r.good ? ` · ${r.good} RATED GOOD` : ''}${r.bad ? ` · ${r.bad} DROPPED AS BAD` : ''}` : '';
+      const exported = d ? `LAST EXPORT ${new Date(d.exportedAt).toLocaleString()} · TRAIN ${d.train} · VALID ${d.valid}` : 'NOT EXPORTED YET';
+      const trained = payload?.trained ? `TRAINED MODEL ${payload.trained.toUpperCase()} IN USE` : 'NO TRAINED MODEL YET · SEE docs/training';
+      datasetNote.textContent = [live, exported, trained].filter(Boolean).join(' · ');
+    };
+    fetch('/api/dataset').then((response) => response.json()).then(showDataset).catch(() => { datasetNote.textContent = 'DATASET UNAVAILABLE'; });
+    exportButton.addEventListener('click', async () => {
+      exportButton.disabled = true;
+      try { const payload = await fetch('/api/dataset', { method: 'POST' }).then((response) => response.json()); showDataset(payload); toast(`MU/TH/UR › dataset exported: ${payload.dataset.pairs} pairs in ${payload.dir}`); }
+      catch (error) { toast(`Dataset export failed: ${error.message}`); }
+      finally { exportButton.disabled = false; }
+    });
+    dataset.append(exportButton, datasetNote);
+    mform.append(dataset);
+    // TRAIN: the recipe, with this room's paths and this project's model name filled in. Training runs outside MADRE.
+    const train = el('div', 'full train-card');
+    const trainHead = el('div', 'train-head', 'TRAIN MADRE AI · LOCAL, WITH MLX ON APPLE SILICON · NOTHING LEAVES THIS MACHINE');
+    const trainNote = el('p', 'note', 'EXPORT THE DATASET FIRST. EACH STEP IS ONE COMMAND FOR YOUR TERMINAL; COPY, RUN, COME BACK. WHEN THE MODEL EXISTS IN OLLAMA, @MADRE SWITCHES TO IT AT THE NEXT RECHECK AND EVERY AGENT IS TOLD TO ASK IT FIRST.');
+    const steps = el('ol', 'train-steps');
+    train.append(trainHead, trainNote, steps);
+    const renderTraining = (payload) => {
+      const t = payload?.training;
+      steps.replaceChildren();
+      if (!t) { steps.append(el('li', null, 'TRAINING INFO UNAVAILABLE')); return; }
+      const quote = (path) => `"${path.replace(/\/$/, '')}"`;
+      const items = [
+        ['ONCE · A PYTHON ENVIRONMENT WITH MLX-LM', 'python3 -m venv ~/.madre-train && source ~/.madre-train/bin/activate && pip install mlx-lm'],
+        [`TRAIN THE LORA · BASE ${t.baseModel} FOR ${t.memoryGb} GB`, `source ~/.madre-train/bin/activate && bash ${quote(`${t.recipeDir}train.sh`)} ${quote(t.roomDir)} ${t.baseModel}`],
+        ['FUSE THE ADAPTER INTO THE BASE', `source ~/.madre-train/bin/activate && cd ${quote(t.roomDir)} && mlx_lm.fuse --model ${t.baseModel} --adapter-path adapters --save-path fused`],
+        [`REGISTER IN OLLAMA AS ${t.modelName}`, `cd ${quote(t.roomDir)} && cp ${quote(`${t.recipeDir}Modelfile`)} . && ollama create ${t.modelName} -f Modelfile`],
+      ];
+      for (const [label, command] of items) {
+        const li = el('li');
+        const head = el('div', 'train-step-label', label);
+        const row = el('div', 'update-command');
+        const code = el('code', null, command);
+        const copy = el('button', null, 'COPY'); copy.type = 'button';
+        copy.addEventListener('click', async () => { try { await navigator.clipboard.writeText(command); copy.textContent = 'COPIED'; setTimeout(() => { copy.textContent = 'COPY'; }, 1400); } catch { toast('MU/TH/UR › select the command and copy it.'); } });
+        row.append(code, copy);
+        li.append(head, row);
+        steps.append(li);
+      }
+      steps.append(el('li', 'note', `QWEN NEEDS A GGUF BEFORE OLLAMA READS IT: ${quote(`${t.recipeDir}README.md`)} · SECTION 3 HAS THE TWO LINES. THEN ASK @MADRE TEN THINGS THE ROOM DECIDED AND FIVE IT NEVER DISCUSSED BEFORE TRUSTING IT.`));
+    };
+    fetch('/api/dataset').then((response) => response.json()).then(renderTraining).catch(() => renderTraining(null));
+    mform.append(train);
+    if (mem.envWins) mform.append(el('span', 'note full', 'ENVIRONMENT VARIABLES ARE SET FOR MEMORY; THEY WIN OVER THESE VALUES ON THE NEXT LAUNCH.'));
+    mform.addEventListener('submit', (event) => event.preventDefault());
+    section.append(mform);
+  }
+
+  // PRIVACY: terms that never travel through the room. Replaced at every hop: agent replies,
+  // the index, the notes, the dataset. PURGE does the same to what the room already holds.
+  const priv = data.settings.privacy;
+  if (priv) {
+    section.append(el('h3', null, `PRIVACY · ${priv.terms.length ? `${priv.terms.length} PRIVATE TERM${priv.terms.length === 1 ? '' : 'S'}` : 'NO PRIVATE TERMS'}`));
+    section.append(el('p', 'note', 'AN AGENT\'S OWN CONFIGURATION CAN LEAK INTO ITS REPLY: A COMPANY, A BRAND, A DOMAIN. NAME THEM HERE AND MADRE REPLACES THEM BEFORE THE LEDGER, THE ARCHIVIST, THE OTHER AGENTS OR THE DATASET SEE THEM. THE TERMS STAY IN CONFIG.JSON; THE ROOM ONLY EVER RECORDS HOW MANY.'));
+    const pform = el('form', 'room-form privacy-form');
+    const field = (labelText, node) => { const label = el('label'); label.append(labelText); label.append(node); return label; };
+    const terms = el('textarea'); terms.rows = 3; terms.value = priv.terms.join('\n'); terms.placeholder = 'one term per line · a company, a brand, a domain, a name'; terms.spellcheck = false;
+    const marker = el('input'); marker.value = priv.marker; marker.maxLength = 40; marker.spellcheck = false;
+    const exposure = el('span', 'note full', 'CHECKING THE ROOM…');
+    const purge = el('button', null, 'PURGE ROOM');
+    purge.type = 'button';
+    purge.title = 'Replace every private term already in the ledger, the index and the memories with the marker. Asks for the project designation.';
+    const showExposure = (payload) => {
+      const x = payload?.exposure;
+      if (!x) { exposure.textContent = ''; return; }
+      const total = x.events + x.entries + x.memories;
+      exposure.textContent = !payload.terms?.length ? 'WRITE THE TERMS FIRST.' : total ? `STILL IN THE ROOM: ${x.events} EVENT${x.events === 1 ? '' : 'S'} · ${x.entries} INDEXED EXCHANGE${x.entries === 1 ? '' : 'S'} · ${x.memories} MEMOR${x.memories === 1 ? 'Y' : 'IES'} · PURGE REPLACES THEM.` : 'THE ROOM IS CLEAN: NO PRIVATE TERM IN THE LEDGER, THE INDEX OR THE MEMORIES.';
+      purge.disabled = !payload.terms?.length || !total;
+    };
+    const savePrivacy = async (patch, describe) => {
+      try {
+        const payload = await fetch('/api/privacy', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(patch) }).then((response) => response.json());
+        if (payload.error) throw new Error(payload.error);
+        terms.value = payload.terms.join('\n'); marker.value = payload.marker; showExposure(payload);
+        toast(`MU/TH/UR › ${describe(payload)}`);
+      } catch (error) { toast(`Privacy setting was not saved: ${error.message}`); }
+    };
+    terms.addEventListener('change', () => savePrivacy({ terms: terms.value.split('\n') }, (payload) => `${payload.terms.length} private term${payload.terms.length === 1 ? '' : 's'} guarded from now on.`));
+    marker.addEventListener('change', () => savePrivacy({ marker: marker.value }, (payload) => `private terms appear as ${payload.marker}.`));
+    pform.append(field('PRIVATE TERMS · ONE PER LINE', terms));
+    pform.append(field('REPLACED WITH', marker));
+    const row = el('div', 'full dataset-row');
+    purge.addEventListener('click', async () => {
+      const designation = window.prompt('PURGE ROOM · Every private term already recorded becomes the marker, in the ledger, the index and the memories. This cannot be undone. Type the project designation to confirm:');
+      if (designation === null) return;
+      purge.disabled = true;
+      try {
+        const payload = await fetch('/api/privacy/purge', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ designation }) }).then((response) => response.json());
+        if (payload.error) throw new Error(payload.error);
+        toast(`MU/TH/UR › purged: ${payload.purged.events} events · ${payload.purged.entries} exchanges · ${payload.purged.memories} memories. Reloading.`);
+        setTimeout(() => location.reload(), 1600);
+      } catch (error) { toast(`Purge did not run: ${error.message}`); purge.disabled = false; }
+    });
+    row.append(purge, exposure);
+    pform.append(row);
+    if (priv.envWins) pform.append(el('span', 'note full', 'PULSE_PRIVATE_TERMS IS SET; THOSE TERMS ARE ADDED TO THIS LIST ON EVERY LAUNCH.'));
+    pform.addEventListener('submit', (event) => event.preventDefault());
+    section.append(pform);
+    fetch('/api/privacy').then((response) => response.json()).then(showExposure).catch(() => { exposure.textContent = 'EXPOSURE CHECK UNAVAILABLE'; });
+  }
 }
 
 // Save one setting the moment it changes, the way the scope boxes do; the
@@ -4194,6 +4488,60 @@ document.querySelector('#nostromo-forget')?.addEventListener('click', async (eve
 });
 
 
+/* ---------- Release channel: is there a newer MADRE? A pill in the bar, the command in MU/TH/UR. ---------- */
+
+const updateUI = { section: document.querySelector('#mother-update'), pill: document.querySelector('#update-pill'), info: null, timer: null };
+async function loadVersion({ force = false } = {}) {
+  try {
+    updateUI.info = await fetch(`/api/version${force ? '?force=1' : ''}`).then((response) => response.json());
+  } catch { updateUI.info = null; }
+  renderUpdate();
+  clearTimeout(updateUI.timer);
+  updateUI.timer = setTimeout(() => void loadVersion(), 60 * 60 * 1000);
+  updateUI.timer?.unref?.();   // a browser ignores this; the smoke test's Node must not stay alive for it
+}
+function renderUpdate() {
+  const info = updateUI.info;
+  const pill = updateUI.pill;
+  if (pill) {
+    pill.hidden = !info?.available;
+    if (info?.available) { pill.replaceChildren(el('span', 'stop-all-glyph update-glyph'), `${info.latest} AVAILABLE`); pill.title = `MADRE ${info.latest} is on npm · you run ${info.current} · open MU/TH/UR for the command`; }
+  }
+  const section = updateUI.section;
+  if (!section) return;
+  section.replaceChildren();
+  if (!info) { section.append(el('h3', null, 'RELEASE CHANNEL · UNAVAILABLE')); return; }
+  const when = info.checkedAt ? new Date(info.checkedAt).toLocaleString() : null;
+  section.append(el('h3', null, info.available ? `RELEASE CHANNEL · ${info.latest} AVAILABLE · YOU RUN ${info.current}` : `RELEASE CHANNEL · MADRE ${info.current}${info.latest ? ' · UP TO DATE' : info.enabled ? ' · NPM NOT REACHED YET' : ' · CHECK OFF'}`));
+  if (info.available) {
+    section.append(el('p', 'note', `A NEWER MADRE IS ON NPM. THIS COPY RUNS ${info.install === 'npx' ? 'FROM THE NPX CACHE' : info.install === 'project' ? 'FROM THIS PROJECT\'S NODE_MODULES' : info.install === 'global' ? 'AS A GLOBAL INSTALL' : 'FROM SOURCE'}; STOP THE ROOM, RUN THIS IN YOUR TERMINAL, START AGAIN. MADRE NEVER UPDATES ITSELF WHILE YOU WORK.`));
+    const row = el('div', 'update-command');
+    const code = el('code', null, info.command);
+    const copy = el('button', null, 'COPY');
+    copy.type = 'button';
+    copy.addEventListener('click', async () => { try { await navigator.clipboard.writeText(info.command); copy.textContent = 'COPIED'; setTimeout(() => { copy.textContent = 'COPY'; }, 1400); } catch { toast('MU/TH/UR › select the command and copy it.'); } });
+    row.append(code, copy);
+    section.append(row);
+    if (info.release) { const link = el('a', 'update-link', `WHAT ${info.latest} SHIPS ↗`); link.href = info.release; link.target = '_blank'; link.rel = 'noopener noreferrer'; section.append(link); }
+  } else {
+    section.append(el('p', 'note', `MADRE ASKS NPM FOR THE LATEST VERSION ONCE A DAY: THE PACKAGE NAME TRAVELS, NOTHING ELSE, THE SAME REQUEST NPX MAKES.${when ? ` LAST CHECK ${when.toUpperCase()}.` : ''}`));
+  }
+  const controls = el('div', 'sentinel-controls');
+  const toggle = el('label', 'toggle');
+  const box = el('input'); box.type = 'checkbox'; box.checked = Boolean(info.enabled); box.disabled = Boolean(info.envWins);
+  box.addEventListener('change', async () => {
+    box.disabled = true;
+    try { await fetch('/api/updates/settings', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ check: box.checked }) }); toast(`MU/TH/UR › release channel ${box.checked ? 'on: one check a day' : 'off: no request leaves for npm'}.`); await loadVersion(); }
+    catch (error) { toast(`Setting was not saved: ${error.message}`); box.disabled = false; }
+  });
+  toggle.append(box, `CHECK NPM FOR NEW VERSIONS ONCE A DAY${info.envWins ? ' · SET BY PULSE_UPDATE_CHECK' : ''}`);
+  controls.append(toggle);
+  if (info.enabled) { const now = el('button', null, 'CHECK NOW'); now.type = 'button'; now.addEventListener('click', () => void loadVersion({ force: true })); controls.append(now); }
+  section.append(controls);
+}
+updateUI.pill?.addEventListener('click', () => { document.querySelector('#mother-button')?.click(); updateUI.section?.scrollIntoView({ block: 'start', behavior: 'smooth' }); });
+void loadVersion();
+
 /* ---------- MU/TH/UR: the sentinel. Unknown conditions and crashes, redacted, ready to report. ---------- */
 
 const sentinelUI = { section: document.querySelector('#mother-sentinel'), settings: null, feedbackUrl: null, loaded: false };

package/public/brands.js

@@ -47,6 +47,24 @@ export const BRANDS = {
   },
 };
 
+BRANDS.madre = {
+  label: 'MADRE',
+  vendor: 'the room · local',
+  color: '#9bff66',
+  colorLight: '#2f8a1c',
+  ink: '#0a1405',
+  mark: () => glyph('<path d="M4 16 H11 L13 16 L15 9 L18 23 L20 16 L22 16 L23.5 13 L25 16 H28" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'),
+};
+
+BRANDS.ollama = {
+  label: 'Ollama',
+  vendor: 'local',
+  color: '#E6E6E6',
+  colorLight: '#3A3A3A',
+  ink: '#111111',
+  mark: () => glyph('<circle cx="16" cy="16" r="9" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="12.5" cy="15" r="1.6" fill="currentColor"/><circle cx="19.5" cy="15" r="1.6" fill="currentColor"/>'),
+};
+
 export const fallbackBrand = (id) => ({
   label: id,
   vendor: '',

package/public/index.html

@@ -23,6 +23,7 @@
         <div id="connection" class="connection" data-state="connecting" title="Live updates">
           <span class="connection-dot"></span><span class="connection-label">connecting</span>
         </div>
+        <button id="update-pill" class="stop-all update-pill" type="button" hidden title="A newer MADRE is on npm"></button>
         <button id="stop-all" class="stop-all" type="button" title="STOPALL · halt every plan and every agent turn" hidden>
           <span class="stop-all-glyph" aria-hidden="true"></span>STOP ALL
         </button>
@@ -74,6 +75,7 @@
               <button id="mother-close" class="mother-close" type="button">END SESSION ×</button>
             </span>
           </header>
+          <section id="mother-update" class="mother-section update"></section>
           <section id="mother-settings" class="mother-section settings" hidden></section>
           <section id="mother-sentinel" class="mother-section sentinel"></section>
           <pre id="mother-boot" class="mother-boot" aria-live="polite"></pre>