@bobfrankston/rmfmail 1.2.316 → 1.2.318

package/client/components/calendar-sidebar.ts

@@ -16,12 +16,12 @@
 
 import {
     getPrimaryAccount,
-    getCalendarEvents, getCalendars, createCalendarEvent, refreshCalendarNow,
+    getCalendarEvents, getCalendars, createCalendarEvent, deleteCalendarEvent, refreshCalendarNow,
     getTasks, createTask, updateTask, deleteTask,
     reauthGoogleScopes,
     getSettings, saveSettings,
 } from "../lib/api-client.js";
-import { showContextMenu, confirmAt } from "./context-menu.js";
+import { showContextMenu, confirmAt, type MenuItem } from "./context-menu.js";
 
 const SIDEBAR_PREF = "mailx-calendar-sidebar-on";
 const SHOW_RECURRING_PREF = "mailx-cal-show-recurring";
@@ -60,6 +60,23 @@ const HOLIDAY_HORIZON_MS = 14 * 86400_000;
 let viewYear = new Date().getFullYear();
 let viewMonth = new Date().getMonth();
 let viewDay = new Date().getDate();
+/** True once the reader steps to another day with ‹ ›; "Today" clears it.
+ *  While false the view FOLLOWS the calendar date: the app runs for days,
+ *  and the date above was fixed when this module loaded (Bob 2026-09-10:
+ *  "it is still showing me yesterday's calendar"). */
+let viewPinned = false;
+function followToday(): void {
+    if (viewPinned) return;
+    const t = new Date();
+    viewYear = t.getFullYear(); viewMonth = t.getMonth(); viewDay = t.getDate();
+}
+/** Re-render at the next local midnight, then re-arm. A setInterval would
+ *  drift; computing the next midnight each time lands on it exactly. */
+function armMidnightRollover(): void {
+    const now = new Date();
+    const next = new Date(now.getFullYear(), now.getMonth(), now.getDate() + 1, 0, 0, 5);
+    window.setTimeout(() => { void refresh(); armMidnightRollover(); }, next.getTime() - now.getTime());
+}
 let lastEvents: CalEvent[] = [];
 /** Overdue tasks (due before today, not completed) — pinned to the top of
  *  the calendar list. Cached so renderEvents() can be re-run on a calendar
@@ -78,7 +95,19 @@ interface CalInfo {
     name: string;
     color: string;
     primary: boolean;
+    /** Google's accessRole; owner and writer can take a new event. */
+    accessRole?: string;
+}
+
+/** Calendars a new event can be saved to, personal first. */
+function writableCalendars(list: CalInfo[]): CalInfo[] {
+    return list
+        .filter(c => c.accessRole === "owner" || c.accessRole === "writer")
+        .sort((a, b) => (a.primary ? 0 : 1) - (b.primary ? 0 : 1) || a.name.localeCompare(b.name));
 }
+/** The calendar the last event was saved to — a per-machine convenience,
+ *  so a run of entries on a shared calendar does not mean re-picking it. */
+const LAST_CALENDAR_PREF = "mailx.calendar.lastCreateCalendar";
 
 /** Selected Google calendars, by id. The primary calendar is also keyed
  *  under the literal "primary" so legacy/stale rows (whose `calendar_id`
@@ -176,7 +205,7 @@ async function renderCalendarList(): Promise<void> {
             // Personal first, then alphabetical.
             const sorted = [...list].sort((a, b) =>
                 (a.primary ? 0 : 1) - (b.primary ? 0 : 1) || a.name.localeCompare(b.name));
-            host.innerHTML = sorted.map(c => `<label class="cal-side-cal-row" title="${escapeHtml(c.name)}">
+            host.innerHTML = sorted.map(c => `<label class="cal-side-cal-row" title="${escapeHtml(c.name)} — untick to hide its events in this list. Which calendars are listed is set in Google Calendar: the ones selected there appear; use Refresh after changing it.">
                 <input type="checkbox" class="cal-side-cal-check" data-cal-id="${escapeHtml(c.id)}" ${hiddenCalendars.has(c.id) ? "" : "checked"}>
                 ${calIconHtml(c)}
                 <span class="cal-side-cal-name">${escapeHtml(c.name)}</span>
@@ -436,7 +465,9 @@ function renderEvents(events: CalEvent[]): void {
                 <span class="cal-side-event-title cal-side-event-holiday-title" title="${escapeHtml(e.title)}">${calIconHtml(info)} ${escapeHtml(e.title)}</span>
             </div>`;
         } else {
-            const titleAttr = link ? 'title="Click to open in Google Calendar"' : "";
+            const titleAttr = link
+                ? 'title="Click to open in Google Calendar to edit it. Right-click for more."'
+                : 'title="Saved in rmfmail, syncing to Google — it can be opened there once it has synced. Right-click to delete."';
             html += `<div class="cal-side-event" data-id="${e.id}"${recurAttr} data-link="${escapeHtml(link)}" ${titleAttr}>
                 ${calIconHtml(info)}
                 <span class="cal-side-event-time">${escapeHtml(formatTime(e))}</span>
@@ -482,16 +513,38 @@ function renderEvents(events: CalEvent[]): void {
         el.addEventListener("contextmenu", (e) => {
             e.preventDefault();
             const link = el.dataset.link;
-            const items = [];
+            const uuid = el.dataset.id || "";
+            const title = el.querySelector(".cal-side-event-title")?.textContent?.trim() || "this event";
+            const items: MenuItem[] = [];
             if (link) items.push({
-                label: "View in browser",
+                label: `Edit "${title}" in Google Calendar`,
                 action: () => openInBrowser(link),
             });
             items.push({
                 label: "Open Google Calendar",
                 action: () => openInBrowser("https://calendar.google.com/"),
             });
-            if (items.length > 0) showContextMenu(e.clientX, e.clientY, items, { editTarget: e.target });
+            if (uuid) {
+                items.push({ label: "", action: () => {}, separator: true });
+                items.push({
+                    label: `Delete "${title}"`,
+                    tooltip: "Removes it from your calendar in rmfmail now and from Google when it syncs.",
+                    action: async () => {
+                        if (!await confirmAt(e.clientX, e.clientY, `Delete "${title}"`)) return;
+                        try {
+                            await deleteCalendarEvent(uuid);
+                            const st = document.getElementById("status-sync");
+                            if (st) st.textContent = `Deleted event: ${title}`;
+                            await refresh();
+                        } catch (err: any) {
+                            const st = document.getElementById("status-sync");
+                            if (st) st.textContent = `Couldn't delete "${title}": ${err?.message || err}`;
+                            console.error("[calendar] delete failed:", err);
+                        }
+                    },
+                });
+            }
+            showContextMenu(e.clientX, e.clientY, items, { editTarget: e.target });
         });
     });
 }
@@ -595,6 +648,7 @@ async function renderTasks(prefetched?: any[]): Promise<void> {
 }
 
 async function refresh(): Promise<void> {
+    followToday();
     renderHead();
     const from = new Date(viewYear, viewMonth, viewDay);
     // A throw here (IPC reject, daemon not ready) must NOT leave the
@@ -630,12 +684,15 @@ async function refresh(): Promise<void> {
 /** Open the natural-language new-event modal. The user types a free-form
  *  description ("Lunch with John tomorrow at noon at Joe's"); we send it
  *  to aiTransform with action=extractEvent, get back structured fields
- *  (title/start/end/location/notes), and open Google Calendar's
- *  create-event URL with those fields pre-filled. The user reviews / edits
- *  / saves in Google's UI — that path keeps mailx out of the
- *  event-editor business and gets all the niceties (recurrence, guests,
- *  conferencing) for free. If AI is disabled or extraction fails, the raw
- *  text becomes the title and Google's own quick-add parser takes over. */
+ *  (title/start/end/location/notes), and SAVE them — a local row at once,
+ *  pushed to Google by the store-sync queue — exactly as the sidebar's
+ *  task editor does. Until 2026-09-10 this opened Google Calendar's
+ *  create page in the browser instead, and the reader had to save it
+ *  there, in whatever Google account the browser was signed into (Bob:
+ *  "add an event puts me into Google Calendar. It should just save the
+ *  event because I can easily edit it later"). If AI is disabled or the
+ *  parse fails, the dialog says so and offers "Create as text": the raw
+ *  text becomes the title of an all-day event today, to be edited. */
 function openNewEventDialog(): void {
     const backdrop = document.createElement("div");
     backdrop.className = "mailx-modal-backdrop";
@@ -650,7 +707,7 @@ function openNewEventDialog(): void {
 
     const hint = document.createElement("div");
     hint.style.cssText = "font-size:0.9em;color:var(--color-text-muted);";
-    hint.textContent = "Describe the event in plain English — AI extracts the details and opens Google Calendar to confirm.";
+    hint.textContent = "Describe the event in plain English — AI extracts the details and saves it to your calendar. Edit it afterwards if it needs adjusting.";
 
     const ta = document.createElement("textarea");
     ta.style.cssText = "width:100%;min-height:120px;font:inherit;padding:8px;border-radius:4px;border:1px solid var(--color-border, #ccc);box-sizing:border-box;resize:vertical;";
@@ -659,6 +716,36 @@ function openNewEventDialog(): void {
     const status = document.createElement("div");
     status.style.cssText = "min-height:1.2em;font-size:0.85em;color:var(--color-text-muted);";
 
+    // Which calendar. Offered only when Google says more than one can take
+    // an event (Bob 2026-09-10: "I want to start making more use of shared
+    // calendars"); with one there is nothing to choose and the row is not
+    // shown. The list is the one the sidebar already enumerated; fetched
+    // here only if the sidebar has not loaded it yet.
+    const calRow = document.createElement("label");
+    calRow.style.cssText = "display:flex;align-items:center;gap:8px;font-size:0.9em;";
+    calRow.title = "The calendar this event is saved to. Only calendars you can write to are listed; to add or share a calendar, do that in Google Calendar and press Refresh.";
+    const calSelect = document.createElement("select");
+    calSelect.style.cssText = "flex:1;font:inherit;padding:4px;";
+    calRow.append("Calendar", calSelect);
+    calRow.hidden = true;
+    const fillCalendars = (list: CalInfo[]) => {
+        const writable = writableCalendars(list);
+        calSelect.innerHTML = "";
+        let last = "";
+        try { last = localStorage.getItem(LAST_CALENDAR_PREF) || ""; } catch { /* per-viewer convenience only */ }
+        for (const c of writable) {
+            const opt = document.createElement("option");
+            opt.value = c.id;
+            opt.textContent = c.primary ? `${c.name} (personal)` : c.name;
+            if (c.id === last || (!last && c.primary)) opt.selected = true;
+            calSelect.append(opt);
+        }
+        calRow.hidden = writable.length < 2;
+    };
+    if (calendarList.length) fillCalendars(calendarList);
+    else getCalendars().then(list => { calendarList = list as CalInfo[]; fillCalendars(calendarList); })
+        .catch((e: any) => console.warn("[calendar] calendar list for the picker failed:", e?.message || e));
+
     const btnRow = document.createElement("div");
     btnRow.style.cssText = "display:flex;gap:8px;justify-content:flex-end;";
 
@@ -671,7 +758,7 @@ function openNewEventDialog(): void {
     createBtn.style.cssText = "padding:6px 14px;font-weight:500;";
 
     btnRow.append(cancelBtn, createBtn);
-    panel.append(heading, hint, ta, status, btnRow);
+    panel.append(heading, hint, ta, calRow, status, btnRow);
     backdrop.append(panel);
     document.body.append(backdrop);
     setTimeout(() => ta.focus(), 0);
@@ -727,117 +814,84 @@ function openNewEventDialog(): void {
             }
         }
 
-        // Build Google Calendar's create-event URL(s) — one per extracted
-        // event (the text may describe several). Always opens in browser
-        // for the user to confirm/edit/save. We never write to the local
-        // store from this path — the round-trip back via Google Calendar
-        // sync keeps state consistent and avoids duplicate events.
-        const api = (window as any).mailxapi;
+        // Save each extracted event (the text may describe several) as a
+        // local row; the store-sync queue pushes it to Google and binds the
+        // provider id when that lands. Local-first: the row is in the
+        // sidebar before Google has heard of it. The saved title is named
+        // in the status line, never "saved" alone.
         const targets = events.length ? events : [null];
-        // The page opens in the browser's DEFAULT Google account, which need
-        // not be the one mailx's calendar reads (Bob 2026-09-10: "I just used
-        // the add event but don't see them on Google calendar"). authuser=
-        // names the account, so the event lands where the sidebar looks.
-        let authuser = "";
-        try { authuser = String((await getPrimaryAccount("calendar"))?.email || ""); }
-        catch (e: any) { console.warn("[calendar] primary account lookup failed, opening without authuser:", e?.message || e); }
+        const saved: string[] = [];
+        const calendarId = calSelect.value || "primary";
+        const calendarName = calSelect.selectedOptions[0]?.textContent || "";
+        try { localStorage.setItem(LAST_CALENDAR_PREF, calendarId); } catch { /* per-viewer convenience only */ }
         for (const ev of targets) {
-            const url = buildGoogleEventUrl(ev, text, authuser);
-            if (api?.openExternal) api.openExternal(url);
-            else window.open(url, "_blank");
+            const row = { ...eventToLocalRow(ev, text), calendarId };
+            try {
+                await createCalendarEvent(row);
+                saved.push(row.title);
+            } catch (e: any) {
+                // Stop at the first failure and leave the dialog open with the
+                // reason: a silent partial save is worse than none.
+                status.textContent = `Couldn't save "${row.title}": ${e?.message || e}`;
+                createBtn.disabled = false;
+                cancelBtn.disabled = false;
+                return;
+            }
         }
-        armPostCreateRefresh();
         close();
+        const st = document.getElementById("status-sync");
+        const where = calendarName && !calRow.hidden ? ` to ${calendarName}` : "";
+        if (st) st.textContent = saved.length === 1 ? `Saved event${where}: ${saved[0]}` : `Saved ${saved.length} events${where}: ${saved.join("; ")}`;
+        await refresh();
     });
 }
 
-/** After handing an event to Google Calendar in the browser, pull it back
- *  as soon as it can exist: the next time this window regains focus (the
- *  reader saved in the browser and came back), and on a short schedule in
- *  case the browser sits on another monitor and focus never moves. Each
- *  pull goes through refreshCalendarNow, which has its own 20 s floor and
- *  emits calendarUpdated when rows changed — the sidebar re-renders from
- *  that event, not from here. Disarms after the window; a second create
- *  re-arms. (Bob 2026-09-10: "creating an event should trigger an
- *  immediate update for the calendar view".) */
-const POST_CREATE_REFRESH_DELAYS_MS = [45_000, 120_000, 300_000];
-let postCreateTimers: number[] = [];
-let postCreateFocusHandler: (() => void) | null = null;
-function armPostCreateRefresh(): void {
-    disarmPostCreateRefresh();
-    const pull = async (why: string) => {
-        try {
-            const r = await refreshCalendarNow();
-            if (!r?.ok) console.log(`[calendar] post-create refresh (${why}) not started: ${r?.reason || "unknown"}`);
-        } catch (e: any) {
-            console.warn(`[calendar] post-create refresh (${why}) failed:`, e?.message || e);
-        }
-    };
-    postCreateFocusHandler = () => { void pull("window focus"); };
-    window.addEventListener("focus", postCreateFocusHandler);
-    postCreateTimers = POST_CREATE_REFRESH_DELAYS_MS.map((ms, i) => window.setTimeout(() => {
-        void pull(`${ms / 1000} s after create`);
-        if (i === POST_CREATE_REFRESH_DELAYS_MS.length - 1) disarmPostCreateRefresh();
-    }, ms));
-}
-function disarmPostCreateRefresh(): void {
-    for (const t of postCreateTimers) window.clearTimeout(t);
-    postCreateTimers = [];
-    if (postCreateFocusHandler) window.removeEventListener("focus", postCreateFocusHandler);
-    postCreateFocusHandler = null;
+/** The extracted event (wall-clock ISO strings in its own zone) as the
+ *  row createCalendarEvent takes (epoch ms). A null event — "Create as
+ *  text" — becomes an all-day event today titled with the raw text. */
+function eventToLocalRow(event: any, fallbackText: string): { title: string; startMs: number; endMs: number; allDay: boolean; location?: string; notes?: string } {
+    const startOfToday = new Date(); startOfToday.setHours(0, 0, 0, 0);
+    if (!event?.startISO) {
+        return { title: (event?.title || fallbackText).slice(0, 200), startMs: startOfToday.getTime(), endMs: startOfToday.getTime() + 86400_000, allDay: true };
+    }
+    const allDay = !!event.allDay || !event.startISO.includes("T");
+    const startMs = allDay ? new Date(event.startISO.slice(0, 10) + "T00:00:00").getTime() : wallClockToMs(event.startISO, event.timeZone);
+    let endMs: number;
+    if (event.endISO) endMs = allDay ? new Date(event.endISO.slice(0, 10) + "T00:00:00").getTime() : wallClockToMs(event.endISO, event.timeZone);
+    else endMs = startMs + (allDay ? 86400_000 : 3600_000);
+    // An all-day end is exclusive; the extractor may hand back the same day
+    // for start and end, which would be a zero-length event.
+    if (allDay && endMs <= startMs) endMs = startMs + 86400_000;
+    return { title: event.title || fallbackText.slice(0, 200), startMs, endMs, allDay, location: event.location || undefined, notes: event.notes || undefined };
 }
 
-/** Compose Google Calendar's "render?action=TEMPLATE" URL with extracted
- *  fields. When `event` is null we still produce a useful URL — the raw
- *  description goes into `text=` (becomes the title) and Google's UI lets
- *  the user fill in dates manually. Times are emitted in compact form
- *  without `Z` so Google interprets them in the user's calendar timezone. */
-function buildGoogleEventUrl(event: any, fallbackText: string, authuser = ""): string {
-    const base = "https://calendar.google.com/calendar/render?action=TEMPLATE";
-    const params: string[] = [];
-    // Which Google account the page opens in — the one mailx's calendar
-    // reads, not whichever the browser signed in last (2026-09-10).
-    if (authuser) params.push(`authuser=${encodeURIComponent(authuser)}`);
-    const fmt = (iso: string): string => {
-        // ISO "2026-05-06T12:00:00" → "20260506T120000". Google accepts
-        // local-naive times in this form.
-        const m = iso.match(/(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?)?/);
-        if (!m) return "";
-        const [, y, mo, d, hh, mm, ss] = m;
-        const date = `${y}${mo}${d}`;
-        if (!hh) return date; // all-day form: dates=YYYYMMDD/YYYYMMDD
-        return `${date}T${hh}${mm}${ss || "00"}`;
-    };
-
-    if (event?.title) params.push(`text=${encodeURIComponent(event.title)}`);
-    else params.push(`text=${encodeURIComponent(fallbackText.slice(0, 200))}`);
-
-    if (event?.startISO) {
-        const startFmt = fmt(event.startISO);
-        // For all-day events Google wants `dates=YYYYMMDD/YYYYMMDD` where
-        // the end date is exclusive (next day). For timed events it's
-        // `YYYYMMDDTHHMMSS/YYYYMMDDTHHMMSS`. Default end = +1h timed,
-        // +1 day all-day.
-        if (event.allDay) {
-            const startDate = new Date(event.startISO + (event.startISO.includes("T") ? "" : "T00:00:00"));
-            const endDate = new Date(startDate.getTime() + 86400_000);
-            const endFmt = `${endDate.getFullYear()}${String(endDate.getMonth() + 1).padStart(2, "0")}${String(endDate.getDate()).padStart(2, "0")}`;
-            params.push(`dates=${startFmt}/${endFmt}`);
-        } else {
-            const endFmt = event.endISO
-                ? fmt(event.endISO)
-                : fmt(new Date(new Date(event.startISO).getTime() + 3600_000).toISOString().slice(0, 19));
-            params.push(`dates=${startFmt}/${endFmt}`);
+/** Epoch ms for a wall-clock ISO string ("2026-09-12T09:00:00") read in
+ *  `timeZone` — an invite that says "9am Kuala Lumpur" stays 9am there.
+ *  Without a zone the string is read as local time, which is what
+ *  `new Date(iso)` does for an offset-less string. */
+function wallClockToMs(iso: string, timeZone?: string): number {
+    const local = new Date(iso).getTime();
+    if (!timeZone) return local;
+    try {
+        // Offset of the zone at that instant: format the local guess back in
+        // the zone, and the difference is the correction. Two passes settle a
+        // guess that straddles a DST change.
+        let ms = local;
+        for (let i = 0; i < 2; i++) {
+            const parts = new Intl.DateTimeFormat("en-US", { timeZone, hourCycle: "h23", year: "numeric", month: "2-digit", day: "2-digit", hour: "2-digit", minute: "2-digit", second: "2-digit" })
+                .formatToParts(new Date(ms)).reduce((o, p) => (o[p.type] = p.value, o), {} as Record<string, string>);
+            const asIfLocal = new Date(`${parts.year}-${parts.month}-${parts.day}T${parts.hour}:${parts.minute}:${parts.second}`).getTime();
+            ms += local - asIfLocal;
         }
+        return ms;
+    } catch (e: any) {
+        console.warn(`[calendar] unknown time zone "${timeZone}", reading the time as local:`, e?.message || e);
+        return local;
     }
-    if (event?.location) params.push(`location=${encodeURIComponent(event.location)}`);
-    if (event?.notes) params.push(`details=${encodeURIComponent(event.notes)}`);
-    // Times above are wall-clock in the event's own zone (an invite that says
-    // "9am Kuala Lumpur" stays 9am); ctz tells Google which zone that is.
-    if (event?.timeZone) params.push(`ctz=${encodeURIComponent(event.timeZone)}`);
-    return `${base}&${params.join("&")}`;
 }
 
+
+
 /** Show the sidebar (called from the View menu toggle). Idempotent. */
 export async function showCalendarSidebar(): Promise<void> {
     const el = document.getElementById("calendar-sidebar");
@@ -877,9 +931,22 @@ export function initCalendarSidebar(): void {
         (el as any).__wired = true;
         el.addEventListener("click", fn);
     };
-    wireOnce("cal-side-prev", () => { const d = new Date(viewYear, viewMonth, viewDay - 1); viewYear = d.getFullYear(); viewMonth = d.getMonth(); viewDay = d.getDate(); refresh(); });
-    wireOnce("cal-side-next", () => { const d = new Date(viewYear, viewMonth, viewDay + 1); viewYear = d.getFullYear(); viewMonth = d.getMonth(); viewDay = d.getDate(); refresh(); });
-    wireOnce("cal-side-today", () => { const t = new Date(); viewYear = t.getFullYear(); viewMonth = t.getMonth(); viewDay = t.getDate(); refresh(); });
+    wireOnce("cal-side-prev", () => { viewPinned = true; const d = new Date(viewYear, viewMonth, viewDay - 1); viewYear = d.getFullYear(); viewMonth = d.getMonth(); viewDay = d.getDate(); refresh(); });
+    wireOnce("cal-side-next", () => { viewPinned = true; const d = new Date(viewYear, viewMonth, viewDay + 1); viewYear = d.getFullYear(); viewMonth = d.getMonth(); viewDay = d.getDate(); refresh(); });
+    wireOnce("cal-side-today", () => { viewPinned = false; followToday(); refresh(); });
+    if (!(window as any).__mailxCalRolloverArmed) {
+        (window as any).__mailxCalRolloverArmed = true;
+        armMidnightRollover();
+        // Coming back to mailx from elsewhere — Google Calendar in the
+        // browser, most likely — pull what changed there. The daemon's 20 s
+        // floor turns a flapping window into at most one call per 20 s.
+        window.addEventListener("focus", () => {
+            if (!isCalendarSidebarOn()) return;
+            void refreshCalendarNow().then(r => {
+                if (!r?.ok && r?.reason && !/refreshed \d+ s ago/.test(r.reason)) console.log(`[calendar] focus refresh not started: ${r.reason}`);
+            }).catch((e: any) => console.warn("[calendar] focus refresh failed:", e?.message || e));
+        });
+    }
     wireOnce("cal-side-new", () => { openNewEventDialog(); });
     wireOnce("cal-side-new-task", async () => {
         const title = prompt("Task title:");
@@ -918,7 +985,16 @@ export function initCalendarSidebar(): void {
         try {
             // Also re-enumerate calendars — the user may have selected /
             // deselected one in Google since the sidebar opened.
-            await Promise.all([renderCalendarList(), refresh()]);
+            // refreshCalendarNow is what makes this button honest: refresh()
+            // alone re-reads local rows, and the daemon's 5-minute throttle
+            // turned "Refresh events from Google" into a no-op most of the
+            // time (Bob 2026-09-10: "still showing me yesterday's calendar").
+            // Its emit re-renders the list when the pull changes anything.
+            const [, , pulled] = await Promise.all([renderCalendarList(), refresh(), refreshCalendarNow()]);
+            if (!pulled?.ok) {
+                const st = document.getElementById("status-sync");
+                if (st) st.textContent = `Calendar not pulled from Google: ${pulled?.reason || "unknown"}`;
+            }
         } finally {
             setTimeout(() => {
                 btn?.classList.remove("cal-side-refreshing");

package/client/index.html

@@ -908,14 +908,14 @@
 
     <aside class="calendar-sidebar" id="calendar-sidebar" hidden aria-label="Calendar sidebar">
         <header class="cal-side-head">
-            <button class="cal-side-nav" id="cal-side-prev" title="Previous">‹</button>
+            <button class="cal-side-nav" id="cal-side-prev" title="Previous day. The list then stays on that day until you press Today.">‹</button>
             <span class="cal-side-date" id="cal-side-date"></span>
-            <button class="cal-side-nav" id="cal-side-today" title="Today">○</button>
-            <button class="cal-side-nav" id="cal-side-next" title="Next">›</button>
+            <button class="cal-side-nav" id="cal-side-today" title="Back to today. The list follows the date on its own unless you have stepped to another day.">○</button>
+            <button class="cal-side-nav" id="cal-side-next" title="Next day. The list then stays on that day until you press Today.">›</button>
         </header>
         <div class="cal-side-actions">
-            <button class="cal-side-new" id="cal-side-new" title="New event">＋ New event</button>
-            <button class="cal-side-new" id="cal-side-refresh-events" title="Refresh events from Google">↻</button>
+            <button class="cal-side-new" id="cal-side-new" title="New event: describe it in plain English and it is saved to your calendar. Click an event to edit it in Google Calendar; right-click to delete it.">＋ New event</button>
+            <button class="cal-side-new" id="cal-side-refresh-events" title="Pull events and the calendar list from Google now. Otherwise they refresh every 5 minutes and whenever this window regains focus.">↻</button>
             <label class="cal-side-opt" title="Include expanded instances of recurring events">
                 <input type="checkbox" id="cal-side-show-recurring" checked> Show recurring
             </label>
@@ -925,7 +925,7 @@
         </div>
         <!-- One checkbox per Google-selected calendar, generated at runtime
              by renderCalendarList(). Uncheck to hide that calendar in mailx. -->
-        <div class="cal-side-calendars" id="cal-side-calendars"></div>
+        <div class="cal-side-calendars" id="cal-side-calendars" title="Your Google calendars. Untick one to hide its events here; add or remove calendars in Google Calendar itself."></div>
         <div class="cal-side-body" id="cal-side-body">
             <div class="cal-side-empty">Loading…</div>
         </div>

package/npmchanges.md

@@ -1829,3 +1829,78 @@ self-spoof findings 35 before v1.2.314, 20 after it, 15 now. The 15 that
 remain are the sextortion, "failed to deliver", NDA-review and
 document-share phishes the check exists for. mailx-types 0.1.91.
 
+## v1.2.316 — 2026-09-10
+
+New event: spelling suggestions, the right Google account, and a prompt refresh
+
+Three from Bob 2026-09-10 on the calendar sidebar's New event dialog.
+
+"Spelling correct didn't work." The main window's right-click handler
+replaced the native WebView2 menu with mailx's Cut/Copy/Paste block on
+every surface — and Chromium's spelling suggestions and "Add to
+dictionary" exist only in the native menu, unreachable from JS. A word in
+the New event box was underlined with no menu that could fix it. Plain
+text controls (TEXTAREA, text-like INPUT) now keep the native menu, which
+already carries Cut/Copy/Paste/Select all for a text field; everything
+else is unchanged. (msger's compose items — Bold, Italic, View source —
+also appear on those fields via its IsEditable gate and forward to the
+compose frame, which is a no-op outside compose; cosmetic, noted.)
+
+"I just used the add event but don't see them on Google calendar." The
+dialog opens Google Calendar's create page in the browser, which signs in
+as the browser's DEFAULT Google account, not necessarily the one mailx's
+calendar reads. The URL now carries authuser=<primary calendar account
+email> so the event lands where the sidebar looks.
+
+"Creating an event should trigger an immediate update for the calendar
+view." The reader saves the event in the browser; mailx only learned of
+it at the next 5-minute throttled refresh. New refreshCalendarNow IPC
+(service, jsonrpc, mailxapi.js, api-client, MailxApi, Android stub that
+says ok:false) rewinds the throttle once and goes through
+getCalendarEvents, so the in-flight dedup and the calendarUpdated emit
+stay in one place; a 20 s floor of its own keeps it from reopening the
+quota hole the throttle closed. The sidebar arms it after a create: on
+the next window focus, and at 45 s / 2 min / 5 min in case the browser
+sits on another monitor. mailx-types 0.1.93, mailx-service 0.1.36,
+mailx-store-web 0.1.114.
+
+## v1.2.317 — 2026-09-10
+
+Calendar sidebar: New event saves here, the list follows the date, Refresh pulls
+
+Four from Bob 2026-09-10, all in the calendar sidebar.
+
+"Add an event puts me into Google Calendar. It should just save the event
+because I can easily edit it later." The New event dialog now saves each
+extracted event as a local row through createCalendarEvent — the IPC and
+the store-sync push to Google existed since the two-way cache and nothing
+called them — and the sidebar shows it at once; Google gets it from the
+queue. The status line names what was saved. "Create as text" (AI parse
+failed) becomes an all-day event today titled with the text. Wall-clock
+times in a named zone are converted properly (wallClockToMs), so a "9am
+Kuala Lumpur" invite stays 9am there. buildGoogleEventUrl, the authuser
+work from v1.2.316 and the post-create refresh timers are gone with the
+page they served.
+
+"It is still showing me yesterday's calendar." The view date was fixed
+when the module loaded and never moved. It now follows the calendar date
+unless the reader has stepped to another day with ‹ › (Today clears
+that), and re-renders at local midnight.
+
+"Still showing…" had a second cause: the Refresh button said "from
+Google" and only re-read local rows — the daemon's 5-minute throttle made
+it a no-op most of the time. It now calls refreshCalendarNow (v1.2.316)
+and reports when nothing was pulled and why. The window's focus does the
+same, so an edit made in Google Calendar shows on coming back to rmfmail.
+
+"How do I edit the calendar list? Perhaps more tooltip help would be
+useful?" Every control in the sidebar header now says what it does and
+what it does not: the calendar rows say that unticking hides a calendar
+here while the list itself is the calendars selected in Google Calendar;
+the ‹ › buttons say the list then stays on that day; New event says it
+saves and how to edit. Event rows: click opens the event in Google
+Calendar to edit; a just-saved row says it is syncing and cannot be
+opened there yet; right-click offers Edit "‹title›" in Google Calendar
+and Delete "‹title›" (local-first, queued to Google), with confirmAt at
+the pointer.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/rmfmail",
-  "version": "1.2.316",
+  "version": "1.2.318",
   "description": "Local-first email client with IMAP sync and standalone native app",
   "type": "module",
   "main": "bin/mailx.js",
@@ -34,8 +34,8 @@
   "dependencies": {
     "@bobfrankston/iflow-direct": "^0.1.68",
     "@bobfrankston/mailx-host": "^0.1.15",
-    "@bobfrankston/mailx-imap": "^0.1.180",
-    "@bobfrankston/mailx-store-web": "^0.1.114",
+    "@bobfrankston/mailx-imap": "^0.1.181",
+    "@bobfrankston/mailx-store-web": "^0.1.115",
     "@bobfrankston/mailx-sync": "^0.1.29",
     "@bobfrankston/miscinfo": "^1.0.21",
     "@bobfrankston/msger": "^0.1.431",
@@ -119,8 +119,8 @@
     "dependencies": {
       "@bobfrankston/iflow-direct": "^0.1.68",
       "@bobfrankston/mailx-host": "^0.1.15",
-      "@bobfrankston/mailx-imap": "^0.1.180",
-      "@bobfrankston/mailx-store-web": "^0.1.114",
+      "@bobfrankston/mailx-imap": "^0.1.181",
+      "@bobfrankston/mailx-store-web": "^0.1.115",
       "@bobfrankston/mailx-sync": "^0.1.29",
       "@bobfrankston/miscinfo": "^1.0.21",
       "@bobfrankston/msger": "^0.1.431",

package/packages/mailx-imap/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bobfrankston/mailx-imap",
-  "version": "0.1.181",
+  "version": "0.1.182",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bobfrankston/mailx-imap",
-      "version": "0.1.181",
+      "version": "0.1.182",
       "license": "ISC",
       "dependencies": {
         "@bobfrankston/iflow-direct": "^0.1.27",

package/packages/mailx-imap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-imap",
-  "version": "0.1.181",
+  "version": "0.1.182",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",

package/packages/mailx-service/google-sync.d.ts

@@ -72,6 +72,11 @@ export interface GCalendarListEntry {
      *  `reminders.useDefault === true`. Each entry is `{ method, minutes }`;
      *  client carries only the minutes for popup reminders. */
     defaultReminderMinutes: number[];
+    /** Google's accessRole: "owner" | "writer" | "reader" | "freeBusyReader".
+     *  Only the first two can take a new event — the New event dialog
+     *  offers those (Bob 2026-09-10: "when creating an event I should be
+     *  able to specify which calendar"). */
+    accessRole: string;
 }
 export declare function listCalendars(tokenProvider: TokenProvider): Promise<GCalendarListEntry[]>;
 export declare function createCalendarEvent(tokenProvider: TokenProvider, event: any, calendarId?: string): Promise<GCalEvent>;