feat: pause Today while handling Attention (Closes #595)

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-v90" in worker
+    assert "stackchain-dashboard-shell-v91" in worker

tests/test_frontend_bundle.py

@@ -162,7 +162,7 @@ def test_legacy_cache_marker_is_normalized_out_of_build_identity(tmp_path):
     worker = changed_frontend / "service-worker.js"
     worker.write_text(
         worker.read_text().replace(
-            "const CACHE = 'stackchain-dashboard-shell-v90';",
+            "const CACHE = 'stackchain-dashboard-shell-v91';",
             "const CACHE = 'stackchain-dashboard-shell-v999';",
         )
     )

tests/test_later_sync.py

@@ -347,5 +347,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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/later-sync.js'" in source

tests/test_markdown_renderer.py

@@ -137,4 +137,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-v90" in worker
+    assert "stackchain-dashboard-shell-v91" in worker

tests/test_mobile_composer_integration.py

@@ -41,7 +41,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-v90" in worker
+    assert "stackchain-dashboard-shell-v91" in worker
 
 
 def test_all_conversation_composers_offer_accessible_mobile_mentions():

tests/test_mobile_device_setup.py

@@ -186,7 +186,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-v90" in worker
+    assert "stackchain-dashboard-shell-v91" in worker
     assert ".device-setup-panel" in css
     assert ".device-readiness-card" in css
     assert "overflow-x:hidden" in css

tests/test_mobile_task_dock.py

@@ -215,3 +215,18 @@ async def test_dashboard_renders_and_wires_phone_safe_task_dock():
     assert "draftCount.textContent = sourceDraftCount.textContent" in html
     assert "mobileTaskDock.updateWork(mobileWorkEntry.mode())" in html
     assert "mobileTaskDock.updateAttention(countMyWork(activeMyWork).attention)" in html
+
+
+@pytest.mark.anyio
+async def test_mobile_attention_pauses_today_and_offers_phone_safe_return():
+    html = await dashboard()
+
+    assert 'class="attention-interruption" id="attention-interruption"' in html
+    assert 'id="return-to-today" type="button">Return to Today</button>' in html
+    assert 'if (workSession.checkpointed()) timer.beginAttention();' in html
+    assert 'timer.returnFromAttention()' in html
+    assert "workSession.reopen(item)" in html
+    assert "attentionInterruption.hidden = !pending" in html
+    assert '.attention-interruption:not([hidden]) {' in html
+    assert '.attention-interruption button { min-height:44px;' in html
+    assert 'max-width:100%;' in html

tests/test_my_work.py

@@ -2050,6 +2050,55 @@ process.stdout.write(JSON.stringify({{
     }
 
 
+def test_today_timer_pauses_for_attention_and_restores_only_automatic_running_state():
+    script = f"""
+const createTodayTimer = require({json.dumps(str(TODAY_TIMER))});
+const values = new Map();
+const storage = {{getItem:k=>values.get(k)||null,setItem:(k,v)=>values.set(k,v)}};
+let login = 'timmy';
+let now = 0;
+const timer = createTodayTimer({{storage,getLogin:()=>login,now:()=>now}});
+timer.activate('issue:r:595:');
+now = 60000;
+const entered = timer.beginAttention();
+now = 5 * 60000;
+const duplicate = timer.beginAttention();
+const frozen = timer.snapshot();
+const restored = createTodayTimer({{storage,getLogin:()=>login,now:()=>now}}).attentionInterruption();
+now = 11 * 60000;
+const returned = timer.returnFromAttention();
+now = 12 * 60000;
+const resumed = timer.snapshot();
+timer.pause();
+now = 13 * 60000;
+const enteredPaused = timer.beginAttention();
+now = 20 * 60000;
+const returnedPaused = timer.returnFromAttention();
+const stillPaused = timer.snapshot();
+login = 'alexander';
+const isolated = timer.attentionInterruption();
+process.stdout.write(JSON.stringify({{
+  entered,duplicate,frozen,restored,returned,resumed,
+  enteredPaused,returnedPaused,stillPaused,isolated,
+}}));
+"""
+    result = subprocess.run(["node", "-e", script], capture_output=True, text=True)
+
+    assert result.returncode == 0, result.stderr
+    assert json.loads(result.stdout) == {
+        "entered": {"identity": "issue:r:595:", "resume": True},
+        "duplicate": {"identity": "issue:r:595:", "resume": True},
+        "frozen": {"identity": "issue:r:595:", "elapsed_ms": 60000, "running": False},
+        "restored": {"identity": "issue:r:595:", "resume": True},
+        "returned": {"identity": "issue:r:595:", "resumed": True},
+        "resumed": {"identity": "issue:r:595:", "elapsed_ms": 120000, "running": True},
+        "enteredPaused": {"identity": "issue:r:595:", "resume": False},
+        "returnedPaused": {"identity": "issue:r:595:", "resumed": False},
+        "stillPaused": {"identity": "issue:r:595:", "elapsed_ms": 120000, "running": False},
+        "isolated": None,
+    }
+
+
 def test_today_interruption_prompt_restores_and_resolves_the_pending_mobile_decision():
     script = f"""
 const createTodayTimer = require({json.dumps(str(TODAY_TIMER))});

tests/test_plan_today.py

@@ -332,6 +332,6 @@ 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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/plan-today.js'" in source
     assert "BASE + 'static/plan-today-preview.js'" in source

tests/test_service_worker.py

@@ -135,7 +135,7 @@ async function dispatchPush(payload) {{
 def test_resumable_today_session_ships_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/my-work.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
     assert "BASE + 'static/dashboard.css'" in source
@@ -144,14 +144,14 @@ def test_resumable_today_session_ships_in_a_new_offline_shell():
 def test_ownership_exit_runtime_rolls_the_offline_shell_cache():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v90" in source
+    assert "stackchain-dashboard-shell-v91" 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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/today-completion.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
 
@@ -159,7 +159,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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/create-issue-sheet.js'" in source
     assert "BASE + 'static/dashboard.js'" in source
 
@@ -167,14 +167,14 @@ def test_duplicate_aware_capture_ships_in_a_new_offline_shell():
 def test_exact_later_picker_ships_atomically_in_a_new_offline_shell():
     source = WORKER.read_text()
 
-    assert "stackchain-dashboard-shell-v90" in source
+    assert "stackchain-dashboard-shell-v91" 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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/dashboard.css'" in source
     assert "BASE + 'static/dashboard.js'" in source
     assert "BASE + 'static/install-app.js'" in source
@@ -183,21 +183,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-v90" in source
+    assert "stackchain-dashboard-shell-v91" 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-v90" in source
+    assert "stackchain-dashboard-shell-v91" 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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/update-ownership.js'" in source
 
 
@@ -638,7 +638,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-v90" in source
+    assert "stackchain-dashboard-shell-v91" 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-v90';" in service_worker
+    assert "const CACHE = 'stackchain-dashboard-shell-v91';" 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-v90" in source
+    assert "stackchain-dashboard-shell-v91" in source
     assert "BASE + 'static/today-sync.js'" in source