feat: make Prepare Today the primary mobile entry (Closes #1024)

frontend/dashboard.js

@@ -97,6 +97,7 @@
     (authored ? applyAuthoredOutboxResult : applyOutboxResult)(result);
   }
   let mobileQueueCounts = {};
+  let mobilePreparationItems = {};
   const mobileDeliveryRecovery = createMobileDeliveryRecovery({
     getItems: () => draftInbox.partition(lastDrafts).deliveries,
     getIndex: item => lastDrafts.indexOf(item),
@@ -131,21 +132,31 @@
     getCounts: () => mobileQueueCounts,
     openFindWork: () => qs('#find-work').click(),
   });
+  function openMobileStartDay() {
+    const state = mobileStartDay.state();
+    mobileStartDay.render();
+    qs('#mobile-queue-heading').textContent = state.active ? 'Resume Prepare Today' : 'Prepare Today';
+    const sheet = qs('#mobile-queue-sheet');
+    if (!sheet.open) qs('#mobile-queue-sheet').showModal();
+    qs('#mobile-start-day-action').focus();
+  }
   const mobileWorkEntry = createMobileWorkEntry({
     isTodayActive: () => workSession.checkpointed(),
     isTodayResumable: () => workSession.resumable(),
     getTodayCount: () => todayMyWork.length,
     getEligibleCount: () => activeMyWork.length,
+    getPreparationState: () => mobileStartDay.state(),
     queueLauncher: mobileQueueLauncher,
     continueToday: continueTodaySession,
     resumeToday: resumeTodaySession,
     startToday: startTodaySession,
     planToday: () => openPlanToday(mobileTaskButtons.work),
-
+    prepareToday: openMobileStartDay,
     findWork: () => qs('#find-work').click(),
   });
   const mobileStartDay = createMobileStartDay({
     getCounts: () => mobileQueueCounts,
+    getPhaseItems: () => mobilePreparationItems,
     getLogin: () => confirmedOwnerLogin,
     openQueue: name => {
       const sheet = qs('#mobile-queue-sheet');
@@ -3053,6 +3064,13 @@
     counts.later = laterMyWork.length;
     counts.draft = lastDrafts.length;
     counts.delivery = draftInbox.partition(lastDrafts).actionable;
+    mobilePreparationItems = {
+      delivery:draftInbox.partition(lastDrafts).deliveries,
+      agenda:agendaMyWork(activeMyWork),
+      attention:activeMyWork.filter(item => item.needs_attention),
+      update:activeMyWork.filter(item => item.has_update),
+      filed:activeMyWork.filter(item => item.is_filed),
+    };
     if (!launchFilterResolved) {
       selectedWorkFilter = mobileLaunch.chooseFilter({
         saved: savedWorkFilter, today: counts.today, attention: counts.attention,

frontend/mobile-start-day.js

@@ -11,11 +11,44 @@
     ['update', 'Updates'],
     ['filed', 'Filed'],
   ];
+  const anonymousItems = new WeakMap();
+  let anonymousItemSequence = 0;
 
   function count(value) {
     return Math.max(0, Number(value) || 0);
   }
 
+  function itemIdentity(item) {
+    if (item === null || item === undefined) return '';
+    if (typeof item !== 'object') return String(item);
+    const explicit = item.outbox_id || item.id || item.key || item.url;
+    if (explicit !== null && explicit !== undefined && String(explicit)) {
+      return String(item.kind || 'item') + ':' + String(explicit);
+    }
+    if (!anonymousItems.has(item)) anonymousItems.set(item, 'anonymous:' + (++anonymousItemSequence));
+    return anonymousItems.get(item);
+  }
+
+  function reviewPhases(counts) {
+    if (!options.getPhaseItems) {
+      return reviewOrder
+        .map(([name, label]) => ({name, label, count: count(counts[name])}))
+        .filter(phase => phase.count > 0);
+    }
+    const items = options.getPhaseItems() || {};
+    const seen = new Set();
+    return reviewOrder.flatMap(([name, label]) => {
+      let phaseCount = 0;
+      (items[name] || []).forEach(item => {
+        const identity = itemIdentity(item);
+        if (!identity || seen.has(identity)) return;
+        seen.add(identity);
+        phaseCount += 1;
+      });
+      return phaseCount ? [{name, label, count:phaseCount}] : [];
+    });
+  }
+
   function localDay() {
     const now = new Date();
     const pad = value => String(value).padStart(2, '0');
@@ -69,12 +102,10 @@
 
   function briefing() {
     const counts = options.getCounts ? options.getCounts() : {};
-    const phases = reviewOrder
-      .map(([name, label]) => ({name, label, count: count(counts[name])}))
-      .filter(phase => phase.count > 0);
+    const phases = reviewPhases(counts);
     const total = phases.reduce((sum, phase) => sum + phase.count, 0);
     const today = count(counts.today);
-    const delivery = count(counts.delivery);
+    const delivery = phases.find(phase => phase.name === 'delivery')?.count || 0;
     const other = total - delivery;
     const next = phases.length ? phases[0].name : (today ? 'today' : 'find');
     const nextLabel = next === 'delivery' ? 'Review Delivery' :

frontend/mobile-task-dock.js

@@ -66,13 +66,16 @@
   function updateWork(mode) {
     const text = {
       continue:'Continue', resume:'Resume', start:'Start', plan:'Plan', find:'Find',
+      prepare:'Prepare', 'prepare-resume':'Resume prep',
       delivery:'Delivery', attention:'Attention', update:'Updates', agenda:'Agenda', filed:'Filed', later:'Later', draft:'Drafts',
     }[mode] || 'Work';
     const queue = ['Delivery', 'Attention', 'Updates', 'Agenda', 'Filed', 'Later', 'Drafts'].includes(text);
     if (options.workLabel) options.workLabel.textContent = text;
-    if (buttons.work) buttons.work.setAttribute('aria-label', queue
-      ? (mode === 'update' ? 'Resume ' : 'Open ') + text
-      : mode === 'find' ? 'Find work' : text + (mode === 'work' ? '' : ' Today'));
+    const actionLabel = mode === 'prepare' ? 'Prepare Today' :
+      mode === 'prepare-resume' ? 'Resume preparation' :
+      queue ? (mode === 'update' ? 'Resume ' : 'Open ') + text :
+      mode === 'find' ? 'Find work' : text + (mode === 'work' ? '' : ' Today');
+    if (buttons.work) buttons.work.setAttribute('aria-label', actionLabel);
   }
 
   function updateAttention(count) {

frontend/mobile-work-entry.js

@@ -4,6 +4,9 @@
 })(typeof self !== 'undefined' ? self : this, function createMobileWorkEntry(options) {
   function mode() {
     if (options.isTodayActive()) return 'continue';
+    const preparation = options.getPreparationState?.();
+    if (preparation?.active) return 'prepare-resume';
+    if (preparation?.next && !['today', 'find'].includes(preparation.next)) return 'prepare';
     const recommended = options.queueLauncher && options.queueLauncher.recommend();
     if (recommended && !['today', 'find'].includes(recommended.name)) return recommended.name;
     if (options.getTodayCount() > 0 && options.isTodayResumable()) return 'resume';
@@ -15,6 +18,7 @@
   function open() {
     const current = mode();
     if (current === 'continue') options.continueToday();
+    else if (['prepare', 'prepare-resume'].includes(current)) options.prepareToday();
     else if (current === 'resume') options.resumeToday();
     else if (current === 'start') options.startToday();
     else if (current === 'plan') options.planToday();

frontend/service-worker.js

@@ -1,7 +1,7 @@
 const BASE = new URL('./', self.location.href).pathname;
 importScripts(BASE + 'static/private-data-registry.js');
 importScripts(BASE + 'static/background-issue-sync.js');
-const CACHE = 'stackchain-dashboard-shell-v117';
+const CACHE = 'stackchain-dashboard-shell-v118';
 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;