@fraziym/axoniz 0.1.0

package/dist/web/static/js/assistant.js

@@ -0,0 +1,475 @@
+// Personal Assistant — sidebar entry, settings modal, and chat-header extras.
+//
+// The Assistant is just a specially-flagged CrewMember whose pinned Session
+// lives alongside normal chats. The sidebar button resolves the per-user
+// singleton via /api/assistant/session and hands it to selectSession() so we
+// reuse the full existing chat render path.
+
+import uiModule from './ui.js';
+import { selectSession } from './sessions.js';
+import { sortModelIds } from './modelSort.js';
+
+const API = '/api/assistant';
+
+let _cachedSettings = null;   // most recent GET /api/assistant/settings payload
+let _modalEl = null;
+
+async function _fetchJSON(url, opts = {}) {
+  const res = await fetch(url, { credentials: 'same-origin', ...opts });
+  if (!res.ok) throw new Error(`${url} → ${res.status}`);
+  return res.json();
+}
+
+export async function openAssistantChat() {
+  try {
+    const info = await _fetchJSON(`${API}/session`);
+    if (!info?.session_id) {
+      uiModule.showToast('Assistant session unavailable');
+      return;
+    }
+    await selectSession(info.session_id);
+    // Refresh settings cache so the header buttons / gear act on fresh data.
+    _cachedSettings = null;
+  } catch (e) {
+    console.error('openAssistantChat failed:', e);
+    uiModule.showToast('Could not open assistant');
+  }
+}
+
+async function _getSettings(force = false) {
+  if (!force && _cachedSettings) return _cachedSettings;
+  _cachedSettings = await _fetchJSON(`${API}/settings`);
+  return _cachedSettings;
+}
+
+async function _saveSettings(payload) {
+  const res = await fetch(`${API}/settings`, {
+    method: 'PATCH',
+    credentials: 'same-origin',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  });
+  if (!res.ok) throw new Error(`PATCH ${API}/settings → ${res.status}`);
+  _cachedSettings = await res.json();
+  return _cachedSettings;
+}
+
+async function _listTimezones() {
+  try {
+    const { timezones } = await _fetchJSON(`${API}/available-timezones`);
+    return timezones || ['UTC'];
+  } catch {
+    return ['UTC'];
+  }
+}
+
+async function _runCheckInNow(taskId) {
+  try {
+    await fetch(`${API}/run/${encodeURIComponent(taskId)}`, {
+      method: 'POST',
+      credentials: 'same-origin',
+    });
+    uiModule.showToast('Check-in running…');
+  } catch (e) {
+    console.error(e);
+    uiModule.showToast('Could not run check-in');
+  }
+}
+
+// ── Settings modal ─────────────────────────────────────────────────────────
+
+function _closeModal() {
+  if (_modalEl) {
+    _modalEl.classList.add('hidden');
+    _modalEl.style.display = '';
+  }
+}
+
+function _ensureModalEl() {
+  if (_modalEl) return _modalEl;
+  const modal = document.createElement('div');
+  modal.id = 'assistant-settings-modal';
+  modal.className = 'modal hidden';
+  modal.innerHTML = `
+    <div class="modal-content" style="max-width:640px;width:96%;">
+      <div class="modal-header">
+        <h4>
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align:-2px;margin-right:6px;"><circle cx="12" cy="8" r="4"/><path d="M4 21a8 8 0 0 1 16 0"/></svg>
+          Assistant settings
+        </h4>
+        <button class="close-btn" id="assistant-settings-close">✖</button>
+      </div>
+      <div class="modal-body" id="assistant-settings-body">
+        <div class="hwfit-loading">Loading…</div>
+      </div>
+    </div>`;
+  document.body.appendChild(modal);
+  modal.querySelector('#assistant-settings-close').addEventListener('click', _closeModal);
+  modal.addEventListener('click', (e) => {
+    if (e.target === modal) _closeModal();
+  });
+  _modalEl = modal;
+  return modal;
+}
+
+function _esc(s) {
+  return (s || '').replace(/[&<>"']/g, (c) => ({
+    '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;',
+  }[c]));
+}
+
+// Tool groups for the tool selector UI
+const TOOL_GROUPS = {
+  'Email': ['list_emails', 'read_email', 'send_email', 'reply_to_email', 'archive_email', 'delete_email', 'mark_email_read'],
+  'Calendar & Notes': ['manage_calendar', 'manage_notes', 'manage_tasks'],
+  'Knowledge': ['web_search', 'read_file', 'manage_memory', 'manage_rag', 'search_chats'],
+  'Code': ['bash', 'python', 'write_file'],
+  'Documents': ['create_document', 'edit_document', 'update_document', 'suggest_document'],
+  'AI & Models': ['chat_with_model', 'second_opinion', 'ask_teacher', 'pipeline', 'list_models', 'generate_image'],
+  'System': ['manage_session', 'manage_endpoints', 'manage_mcp', 'manage_settings', 'manage_skills', 'manage_webhooks', 'manage_tokens', 'manage_documents', 'create_session', 'list_sessions', 'send_to_session', 'ui_control'],
+};
+
+async function _fetchEndpoints() {
+  try {
+    const eps = await _fetchJSON('/api/model-endpoints');
+    return Array.isArray(eps) ? eps : [];
+  } catch { return []; }
+}
+
+function _renderSettingsBody(body, data, tzList) {
+  const crew = data.crew || {};
+  const checkIns = data.check_ins || [];
+  const enabledTools = new Set(crew.enabled_tools || []);
+  const tzOptions = tzList.map((z) =>
+    `<option value="${_esc(z)}"${z === crew.timezone ? ' selected' : ''}>${_esc(z)}</option>`
+  ).join('');
+  const checkInsHTML = checkIns.map((c) => `
+    <div class="assistant-checkin-row" data-task-id="${_esc(c.id)}">
+      <div class="assistant-checkin-head">
+        <input type="checkbox" class="assistant-checkin-enabled" ${c.enabled ? 'checked' : ''} title="Enable this check-in" />
+        <input type="text" class="assistant-checkin-name" value="${_esc(c.name)}" placeholder="Name" />
+        <input type="time" class="assistant-checkin-time" value="${_esc(c.scheduled_time || '')}" />
+        <button type="button" class="assistant-checkin-run" title="Run now">Run now</button>
+      </div>
+      <textarea class="assistant-checkin-prompt" rows="3" placeholder="Prompt for this check-in">${_esc(c.prompt || '')}</textarea>
+      <div class="assistant-checkin-meta">
+        ${c.next_run ? `next run: ${_esc(c.next_run)}` : ''}
+        ${c.last_run ? ` · last run: ${_esc(c.last_run)}` : ''}
+        ${typeof c.run_count === 'number' ? ` · ${c.run_count} runs` : ''}
+      </div>
+    </div>`).join('');
+
+  // Tool selector grouped by category
+  let toolsHTML = '';
+  for (const [group, tools] of Object.entries(TOOL_GROUPS)) {
+    toolsHTML += `<div class="assistant-tool-group"><span class="assistant-tool-group-label">${_esc(group)}</span>`;
+    for (const t of tools) {
+      const checked = enabledTools.has(t) ? ' checked' : '';
+      const label = t.replace(/_/g, ' ');
+      toolsHTML += `<label class="assistant-tool-item"><input type="checkbox" class="assistant-tool-cb" value="${_esc(t)}"${checked} /><span>${_esc(label)}</span></label>`;
+    }
+    toolsHTML += '</div>';
+  }
+
+  body.innerHTML = `
+    <div class="assistant-settings-form">
+      <label class="assistant-field">
+        <span>Name</span>
+        <input type="text" id="assistant-name" value="${_esc(crew.name)}" placeholder="Assistant" />
+      </label>
+      <div class="assistant-field">
+        <span style="display:flex;align-items:center;gap:8px;">Personality
+          <select id="assistant-character-pick" style="font-size:11px;padding:1px 6px;border:1px solid var(--border);border-radius:3px;background:var(--bg);color:var(--fg);max-width:180px;">
+            <option value="">-- pick from persona --</option>
+          </select>
+        </span>
+        <textarea id="assistant-personality" rows="6" placeholder="Describe the assistant's personality, tone, and behavior...">${_esc(crew.personality || '')}</textarea>
+      </div>
+      <div class="assistant-field-row">
+        <label class="assistant-field">
+          <span>Timezone</span>
+          <select id="assistant-timezone">
+            <option value=""${!crew.timezone ? ' selected' : ''}>(default -- UTC)</option>
+            ${tzOptions}
+          </select>
+        </label>
+      </div>
+      <div class="assistant-field-row">
+        <label class="assistant-field" style="flex:1;">
+          <span>Model endpoint</span>
+          <select id="assistant-endpoint" style="width:100%;">
+            <option value="">(loading...)</option>
+          </select>
+        </label>
+        <label class="assistant-field" style="flex:1;">
+          <span>Model</span>
+          <select id="assistant-model" style="width:100%;">
+            <option value="${_esc(crew.model || '')}">${_esc(crew.model || '(default)')}</option>
+          </select>
+        </label>
+      </div>
+      <div class="assistant-field">
+        <span style="display:flex;align-items:center;gap:8px;">Tools
+          <button type="button" id="assistant-tools-all" class="assistant-tools-toggle" style="font-size:10px;opacity:0.5;cursor:pointer;background:none;border:1px solid var(--border);border-radius:3px;padding:1px 6px;">all</button>
+          <button type="button" id="assistant-tools-none" class="assistant-tools-toggle" style="font-size:10px;opacity:0.5;cursor:pointer;background:none;border:1px solid var(--border);border-radius:3px;padding:1px 6px;">none</button>
+        </span>
+        <div class="assistant-tools-grid" id="assistant-tools-grid">
+          ${toolsHTML}
+        </div>
+      </div>
+      <div class="assistant-checkins">
+        <h5>Daily check-ins</h5>
+        ${checkInsHTML || '<div style="opacity:0.6;">No check-ins configured.</div>'}
+      </div>
+      <div class="assistant-settings-actions">
+        <button type="button" class="cal-btn" id="assistant-settings-cancel">Cancel</button>
+        <button type="button" class="cal-btn cal-btn-primary" id="assistant-settings-save">Save</button>
+      </div>
+    </div>
+  `;
+
+  // ── Populate model/endpoint dropdowns ──
+  const epSelect = body.querySelector('#assistant-endpoint');
+  const modelSelect = body.querySelector('#assistant-model');
+  _fetchEndpoints().then(endpoints => {
+    let epHTML = '<option value="">(use session default)</option>';
+    for (const ep of endpoints) {
+      if (!ep.is_enabled) continue;
+      const url = ep.base_url || '';
+      const name = ep.name || url;
+      const sel = (crew.endpoint_url && url.includes(crew.endpoint_url.replace('/v1', '').replace(/\/$/, ''))) ? ' selected' : '';
+      epHTML += `<option value="${_esc(url)}"${sel}>${_esc(name)}</option>`;
+    }
+    epSelect.innerHTML = epHTML;
+    // When endpoint changes, load its models
+    epSelect.addEventListener('change', async () => {
+      const url = epSelect.value;
+      if (!url) { modelSelect.innerHTML = '<option value="">(default)</option>'; return; }
+      const ep = endpoints.find(e => e.base_url === url);
+      if (!ep) return;
+      modelSelect.innerHTML = '<option value="">loading...</option>';
+      try {
+        const models = await _fetchJSON(`/api/model-endpoints/${ep.id}/models`);
+        let mHTML = '';
+        const modelIds = (models.models || models || []).map(m => typeof m === 'string' ? m : (m.id || m.name || '')).filter(Boolean);
+        for (const mid of sortModelIds(modelIds)) {
+          const sel = mid === crew.model ? ' selected' : '';
+          mHTML += `<option value="${_esc(mid)}"${sel}>${_esc(mid.split('/').pop())}</option>`;
+        }
+        modelSelect.innerHTML = mHTML || '<option value="">(no models)</option>';
+      } catch { modelSelect.innerHTML = '<option value="">(failed)</option>'; }
+    });
+    // Trigger initial model load if endpoint is pre-selected
+    if (epSelect.value) epSelect.dispatchEvent(new Event('change'));
+  });
+
+  // ── Tool toggle buttons ──
+  body.querySelector('#assistant-tools-all')?.addEventListener('click', () => {
+    body.querySelectorAll('.assistant-tool-cb').forEach(cb => { cb.checked = true; });
+  });
+  body.querySelector('#assistant-tools-none')?.addEventListener('click', () => {
+    body.querySelectorAll('.assistant-tool-cb').forEach(cb => { cb.checked = false; });
+  });
+
+  // ── Character picker — populate from presets + templates ──
+  const charPick = body.querySelector('#assistant-character-pick');
+  const personalityEl = body.querySelector('#assistant-personality');
+  if (charPick && personalityEl) {
+    (async () => {
+      try {
+        const [presetsRaw, templates] = await Promise.all([
+          _fetchJSON('/api/presets').catch(() => ({})),
+          _fetchJSON('/api/presets/templates').catch(() => []),
+        ]);
+        // Presets API returns a dict keyed by preset ID, not an array
+        const allPresets = [];
+        if (presetsRaw && typeof presetsRaw === 'object' && !Array.isArray(presetsRaw)) {
+          for (const [key, val] of Object.entries(presetsRaw)) {
+            if (val && typeof val === 'object' && val.system_prompt) {
+              allPresets.push({ ...val, _key: key });
+            }
+          }
+        } else if (Array.isArray(presetsRaw)) {
+          allPresets.push(...presetsRaw);
+        }
+        const allTemplates = Array.isArray(templates) ? templates : [];
+        let opts = '<option value="">-- pick from persona --</option>';
+        if (allPresets.length) {
+          opts += '<optgroup label="Presets">';
+          for (const p of allPresets) {
+            if (!p.system_prompt) continue;
+            const name = p.character_name || p.name || p._key || 'Unnamed';
+            opts += `<option value="preset:${_esc(p._key || p.name || '')}">${_esc(name)}</option>`;
+          }
+          opts += '</optgroup>';
+        }
+        if (allTemplates.length) {
+          opts += '<optgroup label="Personas">';
+          for (const t of allTemplates) {
+            if (!t.system_prompt && !t.personality) continue;
+            const name = t.character_name || t.name || 'Unnamed';
+            opts += `<option value="template:${_esc(t.id || t.name || '')}">${_esc(name)}</option>`;
+          }
+          opts += '</optgroup>';
+        }
+        charPick.innerHTML = opts;
+        charPick._presets = allPresets;
+        charPick._templates = allTemplates;
+      } catch {}
+    })();
+    charPick.addEventListener('change', () => {
+      const val = charPick.value;
+      if (!val) return;
+      const [type, id] = val.split(':', 2);
+      let prompt = '';
+      let name = '';
+      if (type === 'preset') {
+        const p = (charPick._presets || []).find(x => (x._key || x.name || x.id) === id);
+        if (p) { prompt = p.system_prompt || p.personality || ''; name = p.character_name || p.name || p._key || ''; }
+      } else if (type === 'template') {
+        const t = (charPick._templates || []).find(x => (x.id || x.name) === id);
+        if (t) { prompt = t.system_prompt || t.personality || ''; name = t.character_name || t.name || ''; }
+      }
+      if (prompt) personalityEl.value = prompt;
+      const nameEl = body.querySelector('#assistant-name');
+      if (name && nameEl) nameEl.value = name;
+      charPick.selectedIndex = 0;
+    });
+  }
+
+  // ── Event wiring ──
+  body.querySelector('#assistant-settings-cancel').addEventListener('click', _closeModal);
+  body.querySelector('#assistant-settings-save').addEventListener('click', async () => {
+    const selectedTools = [];
+    body.querySelectorAll('.assistant-tool-cb:checked').forEach(cb => selectedTools.push(cb.value));
+    const payload = {
+      name: body.querySelector('#assistant-name').value.trim(),
+      personality: body.querySelector('#assistant-personality').value,
+      timezone: body.querySelector('#assistant-timezone').value || null,
+      model: body.querySelector('#assistant-model').value || null,
+      endpoint_url: body.querySelector('#assistant-endpoint').value || null,
+      enabled_tools: selectedTools,
+      check_ins: Array.from(body.querySelectorAll('.assistant-checkin-row')).map((row) => ({
+        id: row.dataset.taskId,
+        name: row.querySelector('.assistant-checkin-name').value.trim(),
+        scheduled_time: row.querySelector('.assistant-checkin-time').value,
+        prompt: row.querySelector('.assistant-checkin-prompt').value,
+        enabled: row.querySelector('.assistant-checkin-enabled').checked,
+      })),
+    };
+    try {
+      await _saveSettings(payload);
+      uiModule.showToast('Assistant settings saved');
+      _closeModal();
+    } catch (e) {
+      console.error(e);
+      uiModule.showToast('Save failed');
+    }
+  });
+  body.querySelectorAll('.assistant-checkin-run').forEach((btn) => {
+    btn.addEventListener('click', async (e) => {
+      e.stopPropagation();
+      const row = btn.closest('.assistant-checkin-row');
+      if (!row?.dataset.taskId) return;
+      const taskId = row.dataset.taskId;
+      btn.disabled = true;
+      btn.textContent = 'Running...';
+      await _runCheckInNow(taskId);
+      _closeModal();
+      // Poll until done, then navigate to assistant chat
+      const sid = _cachedSettings?.crew?.session_id;
+      const _poll = setInterval(async () => {
+        try {
+          const res = await fetch(`${API}/run-status/${encodeURIComponent(taskId)}`, { credentials: 'same-origin' });
+          if (!res.ok) return;
+          const data = await res.json();
+          if (data.status === 'done' || data.status === 'error') {
+            clearInterval(_poll);
+            // Hard navigate to force full reload of the session
+            if (sid) {
+              window.location.href = window.location.pathname + '#' + sid;
+              window.location.reload();
+            }
+          }
+        } catch {}
+      }, 2000);
+      setTimeout(() => clearInterval(_poll), 90000);
+    });
+  });
+}
+
+export async function openAssistantSettings() {
+  const modal = _ensureModalEl();
+  modal.classList.remove('hidden');
+  modal.style.display = 'flex';
+  const body = modal.querySelector('#assistant-settings-body');
+  body.innerHTML = '<div class="hwfit-loading">Loading…</div>';
+  try {
+    const [data, tzList] = await Promise.all([_getSettings(true), _listTimezones()]);
+    _renderSettingsBody(body, data, tzList);
+  } catch (e) {
+    console.error(e);
+    body.innerHTML = '<div style="padding:12px;opacity:0.6;">Could not load assistant settings.</div>';
+  }
+}
+
+// Sidebar wiring removed — Assistant chat + settings now live as
+// Activity / Settings tabs inside the Tasks modal (see tasks.js). The
+// exports below are still used by tasks.js to surface those views.
+
+// ── Chat-header affordances when the assistant session is active ───────────
+
+async function _ensureHeaderAffordances(sessionId) {
+  try {
+    const settings = await _getSettings();
+    if (settings?.crew?.session_id !== sessionId) return;
+  } catch {
+    return;
+  }
+  const headerRight = document.querySelector('.chat-header-right, #chat-header .actions, .chat-header');
+  if (!headerRight) return;
+  if (headerRight.querySelector('#assistant-header-gear')) return;
+  const gear = document.createElement('button');
+  gear.id = 'assistant-header-gear';
+  gear.type = 'button';
+  gear.title = 'Assistant settings';
+  gear.className = 'chat-header-btn';
+  gear.innerHTML = '<svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>';
+  gear.addEventListener('click', openAssistantSettings);
+  headerRight.appendChild(gear);
+}
+
+// Run a short polling check after session loads so we can add the gear button
+// once the chat header DOM is in place. Fire-and-forget.
+function _watchForAssistantActivation() {
+  let retries = 0;
+  const interval = setInterval(async () => {
+    retries += 1;
+    const activeSessionId = window.sessionModule?.getActiveSession?.()?.id
+      || document.body.dataset.activeSessionId
+      || null;
+    if (activeSessionId) {
+      await _ensureHeaderAffordances(activeSessionId);
+    }
+    if (retries > 120) clearInterval(interval); // ~2 minutes
+  }, 1000);
+}
+
+// ── Boot ───────────────────────────────────────────────────────────────────
+
+function _boot() {
+  _watchForAssistantActivation();
+}
+
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', _boot);
+} else {
+  _boot();
+}
+
+const assistantModule = {
+  openAssistantChat,
+  openAssistantSettings,
+};
+
+export default assistantModule;

package/dist/web/static/js/calendar/reminders.js

@@ -0,0 +1,114 @@
+// static/js/calendar/reminders.js
+//
+// Browser-notification poller for calendar reminder notes. Self-contained:
+// module-private `_notifFired` Set tracks which note IDs we've already
+// notified, persisted to localStorage. Polls `/api/notes?label=calendar`
+// every 60 seconds and fires a Notification + toast for any note whose
+// `due_date` is in the past but within the staleness window.
+//
+// `start()` kicks off the poll loop + permission request. Call once from
+// the calendar's entry module.
+
+import uiModule from '../ui.js';
+
+const API_BASE = window.location.origin;
+
+let _notifFired = new Set(JSON.parse(localStorage.getItem('cal-notif-fired') || '[]'));
+
+// Compute a fresh, system-clock-accurate notification body. Tries the
+// note's `event_dtstart` first (set by _createEventReminder); falls back
+// to scrubbing stale time tokens out of items[0].text so legacy
+// reminders don't show "in 29 min" at 9pm.
+function _formatReminderBody(note) {
+  const dtstartRaw = note.event_dtstart || note.eventDtstart || null;
+  if (dtstartRaw) {
+    const start = new Date(dtstartRaw);
+    if (!isNaN(start.getTime())) {
+      const now = new Date();
+      const mins = Math.round((start - now) / 60000);
+      const when = start.toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' });
+      let when2 = '';
+      const sameDay = start.toDateString() === now.toDateString();
+      if (!sameDay) when2 = ' ' + start.toLocaleDateString([], { month: 'short', day: 'numeric' });
+      if (mins >= 1 && mins <= 60) return `Starts in ${mins} min (${when}${when2})`;
+      if (mins === 0) return `Starting now (${when}${when2})`;
+      if (mins > 60) {
+        const h = Math.round(mins / 60);
+        return `Starts in ${h} hour${h === 1 ? '' : 's'} (${when}${when2})`;
+      }
+      if (mins >= -60) return `Started ${Math.abs(mins)} min ago (${when}${when2})`;
+      return `Was scheduled for ${when}${when2}`;
+    }
+  }
+  // Legacy notes (no event_dtstart). Scrub stale relative-time strings.
+  let body = (note.items || []).map(i => i.text).join('\n') || note.content || '';
+  body = body.replace(/\bin\s+\d+\s*(min|minute|hour|hr|day)s?\b/gi, '').trim();
+  body = body.replace(/\(\s*\d{1,2}:\d{2}\s*\)/g, '').trim();
+  body = body.replace(/\s{2,}/g, ' ');
+  return body;
+}
+
+// Only fire a reminder if `due` was within this many minutes BEFORE now.
+// Stops a fresh browser (empty `cal-notif-fired` localStorage) from spamming
+// every 2-week-old reminder on first poll. Anything older is silently
+// marked fired so it doesn't keep getting picked up.
+const _REMINDER_STALENESS_MIN = 5;
+
+async function _pollReminders() {
+  try {
+    const res = await fetch(`${API_BASE}/api/notes?label=calendar`, { credentials: 'same-origin' });
+    if (!res.ok) return;
+    const notes = await res.json();
+    const now = new Date();
+    const stalenessMs = _REMINDER_STALENESS_MIN * 60 * 1000;
+    for (const note of notes) {
+      if (!note.due_date || _notifFired.has(note.id)) continue;
+      const due = new Date(note.due_date);
+      if (isNaN(due)) continue;
+      if (due > now) continue; // not yet due
+      const ageMs = now - due;
+      if (ageMs > stalenessMs) {
+        // Too old to fire — mark as seen so we don't recheck every minute.
+        _notifFired.add(note.id);
+        continue;
+      }
+      _notifFired.add(note.id);
+      const body = _formatReminderBody(note);
+      fetch(`${API_BASE}/api/notes/fire-reminder`, {
+        method: 'POST',
+        credentials: 'same-origin',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          note_id: note.id,
+          title: note.title || 'Calendar Reminder',
+          body,
+        }),
+      }).catch(() => {});
+      if ('Notification' in window && Notification.permission === 'granted') {
+        new Notification(note.title || 'Calendar Reminder', {
+          body,
+          icon: '/static/favicon.png',
+          tag: `cal-remind-${note.id}`,
+        });
+      }
+      if (uiModule.showToast) uiModule.showToast((note.title || 'Calendar Reminder') + (body ? ' — ' + body : ''));
+    }
+    // Persist fired set (keep last 200)
+    const arr = [..._notifFired].slice(-200);
+    localStorage.setItem('cal-notif-fired', JSON.stringify(arr));
+  } catch (_) {}
+}
+
+let _started = false;
+
+// Idempotent: safe to call multiple times. Kicks off permission request
+// and the 60s poll loop on first call.
+export function startReminderPoll() {
+  if (_started) return;
+  _started = true;
+  if ('Notification' in window && Notification.permission === 'default') {
+    Notification.requestPermission();
+  }
+  _pollReminders();
+  setInterval(_pollReminders, 60000);
+}