feat: pause Today during mobile Insights (Closes #1082)

frontend/dashboard.js

@@ -254,16 +254,14 @@
     root: qs('#insights-sheet'),
     launcher: qs('#open-insights'),
     closeButton: qs('#close-insights'),
+
     dock: qs('#mobile-task-dock'),
     hud: qs('[data-mobile-today-hud]'),
     backgrounds: [qs('header'), qs('#my-work')],
-    menu: qs('.app-menu'),
     history: window.history,
-    location: window.location,
-    eventTarget: window,
     mediaQuery: window.matchMedia('(max-width: 600px)'),
+    detour:() => timerView,
   });
-  mobileInsights.start();
   qs('#empty-work-find').addEventListener('click', () => qs('#find-work').click());
   qs('#empty-work-create').addEventListener('click', () => qs('#new-issue').click());
   let liveMode = true;
@@ -1841,7 +1839,8 @@
     onReopen: identity => {
       taskOverlayHistory.leave();
       selectTodayWork();
-      workSession.reopen(todayMyWork.find(item => todayWork.identity(item) === identity));
+      const item = [...todayMyWork, ...activeMyWork].find(item => todayWork.identity(item) === identity);
+      if (!workSession.reopen(item)) workSession.resume(item);
     },
     onResume: identity => {
       selectTodayWork();
@@ -1854,6 +1853,7 @@
     },
     onCapture:() => openCreateIssueSheet(),
   });
+  mobileInsights.start();
   todaySessionSync = attachTodaySessionHandoff({
     fetchJson:fetchReviewJson, storage:localStorage, timer, qs,
     items:() => [...todayMyWork, ...activeMyWork],

frontend/index.html

@@ -309,6 +309,10 @@
       <div><h2 id="insights-heading">Insights</h2><p class="small muted">Context, activity, live signals, and workspace tools.</p></div>
       <button id="close-insights" type="button">Close</button>
     </div>
+    <aside class="today-detour-interruption" data-today-detour role="status" aria-live="polite" hidden>
+      <strong data-today-detour-label>Today paused</strong>
+      <button data-return-from-detour type="button">Return to Today</button>
+    </aside>
   <aside class="sidebar">
     <details class="panel stack" data-panel-key="context" open>
       <summary><h2>Context &amp; view</h2></summary>

frontend/mobile-insights.js

@@ -3,8 +3,11 @@
   else root.createMobileInsights = factory;
 })(typeof self !== 'undefined' ? self : this, function (o) {
   const route = '#/insights';
+  const events = o.eventTarget || self;
+  const location = o.location || self.location;
   let active = false;
   let previous = '#/my-work';
+  let retries = 0;
 
   function attr(element, name, value) {
     if (value === null) element.removeAttribute(name);
@@ -12,7 +15,14 @@
   }
 
   function render(open, focus = false) {
+    const wasActive = active;
     active = Boolean(open && o.mediaQuery.matches);
+    const detour = active ? o.detour?.() : null;
+    const started = detour?.beginDetour('insights');
+    if (detour && !started && retries++ < 40) setTimeout(sync, 250);
+    else if (started && retries) { retries = 0; setTimeout(sync, 500); }
+    else retries = 0;
+    if (wasActive && !active) o.detour?.()?.finishDetour();
     attr(o.root, 'data-mobile-open', active ? 'true' : null);
     attr(o.root, 'role', active ? 'dialog' : null);
     attr(o.root, 'aria-modal', active ? 'true' : null);
@@ -26,20 +36,21 @@
   }
 
   function url(hash) {
-    return (o.location.pathname || '') + (o.location.search || '') + hash;
+    return (location.pathname || '') + (location.search || '') + hash;
   }
 
   function open() {
     if (!o.mediaQuery.matches || active) return false;
-    previous = o.location.hash && o.location.hash !== route ? o.location.hash : '#/my-work';
-    if (o.menu) o.menu.open = false;
+    previous = location.hash && location.hash !== route ? location.hash : '#/my-work';
+    const menu = o.menu || o.launcher.closest?.('details');
+    if (menu) menu.open = false;
     o.history.pushState({ ...(o.history.state || {}), mobileInsights:true, previousHash:previous }, '', url(route));
     render(true);
     return true;
   }
 
   function sync() {
-    render(o.location.hash === route, active && o.location.hash !== route);
+    render(location.hash === route, active && location.hash !== route);
   }
 
   function close() {
@@ -55,12 +66,23 @@
     return true;
   }
 
+  function returnToToday() {
+    if (!active) return false;
+    const state = { ...(o.history.state || {}) };
+    delete state.mobileInsights;
+    delete state.previousHash;
+    o.history.replaceState(state, '', url(previous));
+    render(false);
+    return true;
+  }
+
   function start() {
     o.launcher.addEventListener('click', open);
     o.closeButton.addEventListener('click', close);
-    o.eventTarget.addEventListener('popstate', sync);
-    o.eventTarget.addEventListener('hashchange', sync);
-    o.eventTarget.addEventListener('keydown', event => {
+    (o.returnButton || o.root.querySelector?.('[data-return-from-detour]'))?.addEventListener('click', returnToToday);
+    events.addEventListener('popstate', sync);
+    events.addEventListener('hashchange', sync);
+    events.addEventListener('keydown', event => {
       if (active && event.key === 'Escape') {
         event.preventDefault?.();
         close();
@@ -70,5 +92,5 @@
     sync();
   }
 
-  return { start, open, close, current:() => active };
+  return { start, open, close, sync, current:() => active };
 });

frontend/today-timer.js

@@ -57,7 +57,7 @@ function createTodayTimer({ storage, getLogin, now = () => Date.now(), onChange
   const validDetour = state => {
     const pending = state.detour_interruption;
     return pending && typeof pending.identity === 'string' && pending.identity &&
-      typeof pending.resume === 'boolean' && ['find', 'queues'].includes(pending.reason) ?
+      typeof pending.resume === 'boolean' && ['find', 'queues', 'insights'].includes(pending.reason) ?
       { identity:pending.identity, resume:pending.resume, reason:pending.reason } : null;
   };
   const validBreak = state => {
@@ -289,7 +289,7 @@ function createTodayTimer({ storage, getLogin, now = () => Date.now(), onChange
       return write(state) ? { identity:pending.identity, resumed } : null;
     },
     beginDetour(reason) {
-      if (!['find', 'queues'].includes(reason)) return null;
+      if (!['find', 'queues', 'insights'].includes(reason)) return null;
       const state = read();
       const existing = validDetour(state);
       if (existing) return existing;