feat: review Today work at day rollover (Closes #603)

frontend/dashboard.css

@@ -120,7 +120,8 @@ textarea { resize: vertical; min-height: 120px; }
 .plan-today-panel { box-sizing:border-box; width:min(620px,100%); height:100%; overflow:auto; overflow-x:hidden; padding:18px; background:#0b1526; border-left:1px solid #2a496e; }
 .plan-today-header { display:flex; align-items:flex-start; justify-content:space-between; gap:12px; }
 .plan-today-header h2, .plan-today-header p { margin-top:0; }
-.plan-today-header button, .plan-today-list button, .plan-today-candidates button { min-height:44px; }
+.plan-today-header button { min-width:44px; min-height:44px; }
+.plan-today-list button, .plan-today-candidates button { min-height:44px; }
 .plan-today-capacity { position:sticky; top:0; z-index:2; margin:8px 0; padding:10px 12px; border:1px solid #31577f; border-radius:10px; background:#10233a; font-weight:700; }
 .plan-today-available { display:flex; align-items:center; justify-content:space-between; gap:12px; margin:10px 0; font-weight:700; }
 .plan-today-available span { display:flex; align-items:center; gap:6px; }

frontend/dashboard.js

@@ -165,7 +165,9 @@
   let activeMyWork = [];
   let laterMyWork = [];
   let todayMyWork = [];
+  let rolloverReviewPlan = null;
   const outboxCoordinator = createOutboxCoordinator({ storage: localStorage });
+  const todayRollover = createTodayRollover();
   const todayWork = createTodayWork({
     storage: localStorage,
     getLogin: () => planningOwnerLogin,
@@ -186,6 +188,20 @@
         capacity_minutes: plan.capacity_minutes ?? null,
         estimates: plan.estimates || {},
       });
+      const reviewState = todayRollover.reviewState(plan);
+      if (!['stale', 'legacy'].includes(reviewState)) {
+        rolloverReviewPlan = null;
+        qs('#plan-today').textContent = 'Plan Today';
+        return;
+      }
+      rolloverReviewPlan = plan;
+      qs('#plan-today').textContent = 'Review new day';
+      qs('#my-work-action-status').textContent = 'Review yesterday’s unfinished work before starting today.';
+      const marker = `stackchain.today-rollover-reviewed.v1.${encodeURIComponent(planningOwnerLogin)}.${todayRollover.localDate()}`;
+      if (!localStorage.getItem(marker)) {
+        localStorage.setItem(marker, '1');
+        setTimeout(() => openPlanToday(qs('#plan-today')), 0);
+      }
     },
     onStatus: (state, detail = {}) => {
       const status = qs('#today-sync-status');
@@ -1424,9 +1440,20 @@
     const capacityAware = !Array.isArray(plan);
     const ids = capacityAware ? plan.ids : plan;
     const previous = todayWork.read();
-    const operations = previous.map(id => ['remove', id]).concat(ids.map(id => ['add', id]));
-    if (!operations.every(([action, id]) => todaySync.enqueue(action, id))) return false;
-    if (capacityAware && !todaySync.enqueueConfiguration(plan.capacity_minutes, plan.estimates)) return false;
+    if (rolloverReviewPlan) {
+      const operation = todayRollover.operation({
+        operation_id: 'pending', base_revision: rolloverReviewPlan.revision,
+        selected_ids: ids, capacity_minutes: plan.capacity_minutes, estimates: plan.estimates,
+      });
+      if (!todaySync.enqueueRollover(operation)) return false;
+      rolloverReviewPlan = null;
+      qs('#plan-today').textContent = 'Plan Today';
+      qs('#plan-today-title').textContent = 'Plan Today';
+    } else {
+      const operations = previous.map(id => ['remove', id]).concat(ids.map(id => ['add', id]));
+      if (!operations.every(([action, id]) => todaySync.enqueue(action, id))) return false;
+      if (capacityAware && !todaySync.enqueueConfiguration(plan.capacity_minutes, plan.estimates)) return false;
+    }
     if (!todayWork.replace(ids)) return false;
     if (capacityAware && !todayWork.replacePlanning(plan)) return false;
     todayRecapView.completeReplan();
@@ -1690,6 +1717,7 @@
       return;
     }
     if (trigger) planTodayTrigger = trigger;
+    qs('#plan-today-title').textContent = rolloverReviewPlan ? 'New day review' : 'Plan Today';
     if (actualMinutes) pendingPlanActualMinutes = actualMinutes;
     if (navigate) {
       taskOverlayHistory.open('plan-today');

frontend/index.html

@@ -858,6 +858,7 @@
 <script src="static/plan-today.js"></script>
 <script src="static/plan-today-preview.js"></script>
 <script src="static/today-sync.js"></script>
+<script src="static/today-rollover.js"></script>
 <script src="static/update-ownership.js"></script>
 <script src="static/later-work.js"></script>
 <script src="static/later-sync.js"></script>

frontend/service-worker.js

@@ -1,6 +1,6 @@
 const BASE = new URL('./', self.location.href).pathname;
 importScripts(BASE + 'static/background-issue-sync.js');
-const CACHE = 'stackchain-dashboard-shell-v92';
+const CACHE = 'stackchain-dashboard-shell-v93';
 const OFFLINE_LEASE_URL = new URL(BASE + '__offline-session-lease', self.location.origin).href;
 const OUTAGE_STATUSES = new Set([500, 502, 503, 504]);
 const NAVIGATION_TIMEOUT_MS = self.__STACKCHAIN_NAVIGATION_TIMEOUT_MS || 4000;
@@ -40,6 +40,7 @@ const SHELL = [
   BASE + 'static/plan-today.js',
   BASE + 'static/plan-today-preview.js',
   BASE + 'static/today-sync.js',
+  BASE + 'static/today-rollover.js',
   BASE + 'static/update-ownership.js',
   BASE + 'static/later-work.js',
   BASE + 'static/later-sync.js',

frontend/today-rollover.js

@@ -0,0 +1,38 @@
+function createTodayRollover(options = {}) {
+  const now = options.now || (() => new Date());
+  const resolvedTimeZone = options.resolvedTimeZone || (() =>
+    Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC');
+
+  function timeZone() {
+    return options.timeZone?.() || resolvedTimeZone();
+  }
+
+  function localDate() {
+    if (options.localDate) return options.localDate();
+    const parts = new Intl.DateTimeFormat('en-CA', {
+      timeZone: timeZone(), year: 'numeric', month: '2-digit', day: '2-digit',
+    }).formatToParts(now());
+    const value = Object.fromEntries(parts.map(part => [part.type, part.value]));
+    return `${value.year}-${value.month}-${value.day}`;
+  }
+
+  function reviewState(plan) {
+    if (!Array.isArray(plan?.ids) || !plan.ids.length) return 'empty';
+    if (!plan.plan_date) return 'legacy';
+    return plan.plan_date === localDate() ? 'current' : 'stale';
+  }
+
+  function operation({ operation_id, base_revision, selected_ids, capacity_minutes, estimates = {} }) {
+    const ids = [...new Set((selected_ids || []).filter(id => typeof id === 'string' && id))];
+    const selected = new Set(ids);
+    return {
+      operation_id, action: 'rollover', item_id: 'plan', base_revision,
+      plan_date: localDate(), timezone: timeZone(), ids, capacity_minutes,
+      estimates: Object.fromEntries(Object.entries(estimates).filter(([id]) => selected.has(id))),
+    };
+  }
+
+  return { localDate, timeZone, reviewState, operation };
+}
+
+if (typeof module !== 'undefined' && module.exports) module.exports = createTodayRollover;

frontend/today-sync.js

@@ -55,20 +55,22 @@ function createTodaySync({ storage, getLogin, fetchJson, onRemoteIds, onRemotePl
   function adopt(plan, broadcast = true) {
     if (!Number.isInteger(plan?.revision) || !Array.isArray(plan?.ids)) return false;
     if (plan.revision < savedRevision()) return false;
+    const snapshot = {
+      revision: plan.revision, ids: plan.ids,
+      capacity_minutes: plan.capacity_minutes ?? null, estimates: plan.estimates || {},
+    };
+    if (plan.plan_date) {
+      snapshot.plan_date = plan.plan_date;
+      snapshot.timezone = plan.timezone || null;
+    }
     try {
-      storage?.setItem(snapshotKey(), JSON.stringify({
-        revision: plan.revision, ids: plan.ids,
-        capacity_minutes: plan.capacity_minutes ?? null, estimates: plan.estimates || {},
-      }));
+      storage?.setItem(snapshotKey(), JSON.stringify(snapshot));
     } catch (_error) {
       // A storage quota failure must not prevent the current tab from using server truth.
     }
     onRemoteIds?.(plan.ids);
     onRemotePlan?.(plan);
-    if (broadcast) channel?.postMessage({
-      revision: plan.revision, ids: plan.ids,
-      capacity_minutes: plan.capacity_minutes ?? null, estimates: plan.estimates || {},
-    });
+    if (broadcast) channel?.postMessage(snapshot);
     return true;
   }
 
@@ -129,7 +131,7 @@ function createTodaySync({ storage, getLogin, fetchJson, onRemoteIds, onRemotePl
             ? record.operation.base_revision : Math.max(0, savedRevision()),
         }))
         .filter(operation => operation && typeof operation.operation_id === 'string' &&
-          ['add', 'remove', 'move', 'configure'].includes(operation.action) && typeof operation.item_id === 'string');
+          ['add', 'remove', 'move', 'configure', 'rollover'].includes(operation.action) && typeof operation.item_id === 'string');
     } catch (_error) {
       return [];
     }
@@ -201,6 +203,26 @@ function createTodaySync({ storage, getLogin, fetchJson, onRemoteIds, onRemotePl
     }
   }
 
+  function enqueueRollover(proposed) {
+    if (!proposed || proposed.action !== 'rollover') return false;
+    const operation = {
+      ...proposed, operation_id: operationId(), base_revision: Math.max(0, savedRevision()),
+    };
+    const storageKey = key();
+    if (!storageKey || !storage) return false;
+    const recordKey = storageKey + '.operation.' + encodeURIComponent(operation.operation_id);
+    try {
+      storage.setItem(recordKey, JSON.stringify({ operation, queued_at: now() }));
+      knownOperationKeys.add(recordKey);
+      coordinator?.notify('today');
+      onStatus?.('pending');
+      return true;
+    } catch (_error) {
+      onStatus?.('error');
+      return false;
+    }
+  }
+
   function migrate(ids) {
     const storageKey = key();
     if (!storageKey || !storage) return false;
@@ -281,7 +303,7 @@ function createTodaySync({ storage, getLogin, fetchJson, onRemoteIds, onRemotePl
     if (change.queue === 'today' && pending().length) flush();
   });
 
-  return { enqueue, enqueueConfiguration, migrate, flush, pending, startLifecycle };
+  return { enqueue, enqueueConfiguration, enqueueRollover, migrate, flush, pending, startLifecycle };
 }
 
 if (typeof module !== 'undefined' && module.exports) module.exports = createTodaySync;