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

tests/test_comment_next.py

@@ -303,4 +303,4 @@ async def test_unread_update_offers_reply_mark_read_and_next_independent_of_toda
     assert '.update-reply-actions { display:grid; grid-template-columns:repeat(2,minmax(0,1fr));' in html
     assert '.update-reply-actions button { min-height:44px;' in html
     worker = (Path(__file__).parents[1] / "frontend" / "service-worker.js").read_text()
-    assert "stackchain-dashboard-shell-v117" in worker
+    assert "stackchain-dashboard-shell-v118" in worker

tests/test_later_sync.py

@@ -435,5 +435,5 @@ async def test_dashboard_syncs_every_later_change_and_exposes_account_status():
 def test_later_sync_ships_atomically_in_the_offline_shell():
     source = (Path(__file__).parents[1] / "frontend" / "service-worker.js").read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/later-sync.js'" in source

tests/test_markdown_renderer.py

@@ -256,4 +256,4 @@ def test_markdown_work_bodies_are_mobile_safe_block_containers():
     assert ".markdown-content { min-width:0; max-width:100%; overflow-wrap:anywhere;" in css
     assert ".markdown-content pre { max-width:100%; overflow-x:auto;" in css
     assert ".markdown-content a { min-height:44px;" in css
-    assert "stackchain-dashboard-shell-v117" in worker
+    assert "stackchain-dashboard-shell-v118" in worker

tests/test_mobile_composer_integration.py

@@ -45,7 +45,7 @@ def test_offline_shell_contains_every_local_dashboard_runtime_asset():
     shell_assets = set(re.findall(r"BASE \+ '([^']+)'", worker.split("async function sessionCsrf", 1)[0]))
 
     assert local_assets <= shell_assets, f"Offline shell is missing: {sorted(local_assets - shell_assets)}"
-    assert "stackchain-dashboard-shell-v117" in worker
+    assert "stackchain-dashboard-shell-v118" in worker
 
 
 def test_all_conversation_composers_offer_accessible_mobile_mentions():

tests/test_mobile_device_setup.py

@@ -223,7 +223,7 @@ def test_mobile_dashboard_mounts_phone_safe_device_setup_flow():
     assert "promptStorage:localStorage" in dashboard
     assert "pushControllerReady.then(ensureDeviceSetup)" in dashboard
     assert "BASE + 'static/mobile-device-setup.js'" in worker
-    assert "stackchain-dashboard-shell-v117" in worker
+    assert "stackchain-dashboard-shell-v118" in worker
     assert ".device-setup-panel" in css
     assert ".device-readiness-card" in css
     assert "overflow-x:hidden" in css

tests/test_mobile_insights.py

@@ -174,5 +174,5 @@ async def test_mobile_home_progressively_discloses_secondary_panels_as_insights(
 def test_mobile_insights_rolls_into_the_offline_shell():
     worker = (CONTROLLER.parent / "service-worker.js").read_text()
 
-    assert "stackchain-dashboard-shell-v117" in worker
+    assert "stackchain-dashboard-shell-v118" in worker
     assert "BASE + 'static/mobile-insights.js'" in worker

tests/test_mobile_start_day.py

@@ -110,6 +110,42 @@ process.stdout.write(JSON.stringify({{blocked, handed, opened, handoffs}}));
     assert output["handoffs"] == ["agenda"]
 
 
+def test_prepare_today_counts_each_work_identity_in_only_its_highest_priority_phase():
+    script = f"""
+const createStartDay = require({json.dumps(str(START_DAY))});
+const agendaUpdate = {{kind:'issue', key:'lab#1'}};
+const attentionUpdate = {{kind:'pull', key:'lab#2'}};
+const filed = {{kind:'issue', key:'lab#3'}};
+const delivery = {{outbox_id:'draft-4'}};
+const controller = createStartDay({{
+  getCounts: () => ({{today:2}}),
+  getPhaseItems: () => ({{
+    delivery:[delivery],
+    agenda:[agendaUpdate],
+    attention:[agendaUpdate, attentionUpdate],
+    update:[agendaUpdate, attentionUpdate],
+    filed:[filed],
+  }}),
+  openQueue: () => {{}},
+}});
+process.stdout.write(JSON.stringify(controller.briefing()));
+"""
+
+    output = run_node(script)
+    assert output == {
+        "total": 4,
+        "next": "delivery",
+        "label": "Review Delivery",
+        "summary": "1 delivery needs action before Today · 3 other items · 2 planned",
+        "phases": [
+            {"name": "delivery", "label": "Delivery recovery", "count": 1},
+            {"name": "agenda", "label": "Agenda", "count": 1},
+            {"name": "attention", "label": "Attention", "count": 1},
+            {"name": "filed", "label": "Filed", "count": 1},
+        ],
+    }
+
+
 def test_start_day_view_renders_refreshed_phases_and_launches_primary_action():
     script = f"""
 const createStartDay = require({json.dumps(str(START_DAY))});
@@ -322,4 +358,24 @@ async def test_dashboard_wires_thumb_safe_start_day_briefing_into_offline_mobile
     assert ".mobile-start-day-finish { min-height:44px;" in html
     assert "max-width:100%; overflow-wrap:anywhere;" in html
     assert "BASE + 'static/mobile-start-day.js'" in service_worker
-    assert "stackchain-dashboard-shell-v117" in service_worker
+    assert "stackchain-dashboard-shell-v118" in service_worker
+
+
+@pytest.mark.anyio
+async def test_primary_mobile_work_action_opens_a_unique_item_prepare_today_briefing():
+    html = await dashboard()
+
+    assert "getPreparationState: () => mobileStartDay.state()" in html
+    assert "prepareToday: openMobileStartDay" in html
+    assert "function openMobileStartDay()" in html
+    assert "qs('#mobile-queue-heading').textContent = state.active ? 'Resume Prepare Today' : 'Prepare Today';" in html
+    assert "qs('#mobile-queue-sheet').showModal();" in html
+    assert "qs('#mobile-start-day-action').focus();" in html
+    assert "let mobilePreparationItems = {};" in html
+    assert "getPhaseItems: () => mobilePreparationItems" in html
+    assert "mobilePreparationItems = {" in html
+    assert "delivery:draftInbox.partition(lastDrafts).deliveries" in html
+    assert "agenda:agendaMyWork(activeMyWork)" in html
+    assert "attention:activeMyWork.filter(item => item.needs_attention)" in html
+    assert "update:activeMyWork.filter(item => item.has_update)" in html
+    assert "filed:activeMyWork.filter(item => item.is_filed)" in html

tests/test_mobile_task_dock.py

@@ -85,6 +85,37 @@ process.stdout.write(JSON.stringify({{modes, calls}}));
     }
 
 
+def test_mobile_work_entry_opens_prepare_today_before_direct_queue_work():
+    script = f"""
+const createEntry = require({json.dumps(str(ENTRY))});
+const calls = [];
+const state = {{active:true, preparation:{{active:false, next:'attention'}}}};
+const entry = createEntry({{
+  isTodayActive: () => state.active,
+  isTodayResumable: () => false,
+  getTodayCount: () => 0,
+  getEligibleCount: () => 3,
+  getPreparationState: () => state.preparation,
+  queueLauncher: {{recommend: () => ({{name:'attention'}}), open: name => calls.push('queue:' + name)}},
+  continueToday: () => calls.push('continue'),
+  prepareToday: () => calls.push('prepare'),
+  planToday: () => calls.push('plan'),
+  findWork: () => calls.push('find'),
+}});
+const modes = [entry.open()];
+state.active = false; modes.push(entry.open());
+state.preparation.active = true; modes.push(entry.open());
+process.stdout.write(JSON.stringify({{modes, calls}}));
+"""
+    result = subprocess.run(["node", "-e", script], capture_output=True, text=True)
+
+    assert result.returncode == 0, result.stderr
+    assert json.loads(result.stdout) == {
+        "modes": ["continue", "prepare", "prepare-resume"],
+        "calls": ["continue", "prepare", "prepare"],
+    }
+
+
 def test_mobile_work_entry_plans_eligible_work_before_find_fallback():
     script = f"""
 const createEntry = require({json.dumps(str(ENTRY))});
@@ -651,6 +682,28 @@ process.stdout.write(JSON.stringify(labels));
     }
 
 
+def test_mobile_task_dock_labels_prepare_today_as_the_primary_action():
+    script = f"""
+const createDock = require({json.dumps(str(DOCK))});
+const work = {{attributes: {{}}, setAttribute(name, value) {{ this.attributes[name] = value; }}}};
+const workLabel = {{textContent:''}};
+const dock = createDock({{nav:{{}}, buttons:{{work}}, workLabel}});
+const labels = {{}};
+for (const mode of ['prepare','prepare-resume']) {{
+  dock.updateWork(mode);
+  labels[mode] = [workLabel.textContent, work.attributes['aria-label']];
+}}
+process.stdout.write(JSON.stringify(labels));
+"""
+    result = subprocess.run(["node", "-e", script], capture_output=True, text=True)
+
+    assert result.returncode == 0, result.stderr
+    assert json.loads(result.stdout) == {
+        "prepare": ["Prepare", "Prepare Today"],
+        "prepare-resume": ["Resume prep", "Resume preparation"],
+    }
+
+
 @pytest.mark.anyio
 async def test_dashboard_renders_accessible_mobile_queue_completion_handoff():
     html = await dashboard()

tests/test_plan_today.py

@@ -410,7 +410,7 @@ async def test_plan_today_wires_cancel_back_and_success_through_overlay_history(
 def test_plan_today_controller_is_available_in_the_offline_shell():
     source = SERVICE_WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/plan-today.js'" in source
     assert "BASE + 'static/plan-today-readiness.js'" in source
     assert "BASE + 'static/plan-today-preview.js'" in source

tests/test_service_worker.py

@@ -165,13 +165,13 @@ async function dispatchPush(payload) {{
 def test_offline_activation_migration_rolls_the_shell_cache():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
 
 
 def test_resumable_today_session_ships_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/my-work.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
     assert "BASE + 'static/dashboard.css'" in source
@@ -180,7 +180,7 @@ def test_resumable_today_session_ships_in_a_new_offline_shell():
 def test_mobile_conversation_photo_bundles_roll_the_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/dashboard.js'" in source
     assert "BASE + 'static/authored-outbox.js'" in source
     assert "BASE + 'static/background-issue-sync.js'" in source
@@ -189,7 +189,7 @@ def test_mobile_conversation_photo_bundles_roll_the_offline_shell():
 def test_photo_metadata_sanitizer_rolls_the_cached_optimizer_atomically():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/issue-evidence-review.js'" in source
     assert "BASE + 'static/issue-attachment.js'" in source
 
@@ -197,14 +197,14 @@ def test_photo_metadata_sanitizer_rolls_the_cached_optimizer_atomically():
 def test_ownership_exit_runtime_rolls_the_offline_shell_cache():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/dashboard.js'" in source
 
 
 def test_offline_review_next_ships_today_completion_atomically():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/today-completion.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
 
@@ -212,7 +212,7 @@ def test_offline_review_next_ships_today_completion_atomically():
 def test_duplicate_aware_capture_ships_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/create-issue-sheet.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
 
@@ -220,7 +220,7 @@ def test_duplicate_aware_capture_ships_in_a_new_offline_shell():
 def test_inline_checklist_step_flow_rolls_the_offline_shell_atomically():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/issue-sheet.js'" in source
     assert "BASE + 'static/checklist-conflict.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
@@ -230,14 +230,14 @@ def test_inline_checklist_step_flow_rolls_the_offline_shell_atomically():
 def test_exact_later_picker_ships_atomically_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/later-picker.js'" in source
 
 
 def test_navigation_deadline_ships_in_a_new_shell_cache():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/dashboard.css'" in source
     assert "BASE + 'static/dashboard.js'" in source
     assert "BASE + 'static/install-app.js'" in source
@@ -246,21 +246,21 @@ def test_navigation_deadline_ships_in_a_new_shell_cache():
 def test_today_convergence_ships_in_a_new_shell_cache():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/today-sync.js'" in source
 
 
 def test_mobile_search_viewport_ships_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/mobile-search-viewport.js'" in source
 
 
 def test_update_ownership_flow_ships_atomically_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/update-ownership.js'" in source
 
 
@@ -930,7 +930,7 @@ def test_one_session_bound_csrf_proof_is_reused_for_a_background_drain():
 def test_queue_today_ships_atomically_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/queue-today.js'" in source
 
 

tests/test_today_readiness.py

@@ -221,7 +221,7 @@ async def test_today_blocker_opens_existing_preview_and_preserves_readiness_gate
 def test_readiness_runtime_is_available_in_offline_shell():
     service_worker = SERVICE_WORKER.read_text()
 
-    assert "const CACHE = 'stackchain-dashboard-shell-v117';" in service_worker
+    assert "const CACHE = 'stackchain-dashboard-shell-v118';" in service_worker
     assert "BASE + 'static/today-readiness.js'" in service_worker
 
 

tests/test_today_sync.py

@@ -127,7 +127,7 @@ sync.enqueueConfiguration(120, {{'issue:r:1:':60}});
 def test_inflight_today_drain_ships_in_a_new_offline_shell():
     source = (Path(__file__).parents[1] / "frontend" / "service-worker.js").read_text()
 
-    assert "stackchain-dashboard-shell-v117" in source
+    assert "stackchain-dashboard-shell-v118" in source
     assert "BASE + 'static/today-sync.js'" in source