viveworker 0.1.4 → 0.1.5

package/README.md

@@ -180,4 +180,4 @@ Planned next steps include:
 
 - Android support
 - Windows support
-- image attachment support from mobile
+- ✅ ~~image attachment support from mobile~~ (Mar 26, 2026)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viveworker",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Local iPhone companion for Codex Desktop approvals, plan checks, questions, and notifications on your LAN.",
   "author": "Yuta Hoshino <hoshino.lireneo@gmail.com>",
   "license": "MIT",

package/scripts/viveworker-bridge.mjs

@@ -267,6 +267,187 @@ function withNotificationIcon(kind, title) {
   return prefix ? `${prefix} ${title}` : title;
 }
 
+function normalizeTimelineOutcome(value) {
+  const normalized = cleanText(value || "").toLowerCase();
+  return ["pending", "approved", "rejected", "implemented", "dismissed", "submitted"].includes(normalized)
+    ? normalized
+    : "";
+}
+
+function inferTimelineOutcome(kind, summary = "", messageText = "") {
+  const normalizedKind = cleanText(kind || "");
+  if (!normalizedKind) {
+    return "";
+  }
+
+  const candidates = [cleanText(summary || ""), cleanText(messageText || "")].filter(Boolean);
+  if (candidates.length === 0) {
+    return "";
+  }
+
+  const startsWithAny = (keys) =>
+    candidates.some((text) => SUPPORTED_LOCALES.some((locale) => keys.some((key) => text.startsWith(t(locale, key)))));
+
+  if (normalizedKind === "approval") {
+    if (startsWithAny(["server.message.approvalAccepted"])) {
+      return "approved";
+    }
+    if (startsWithAny(["server.message.approvalRejected"])) {
+      return "rejected";
+    }
+    return "";
+  }
+
+  if (normalizedKind === "plan") {
+    if (startsWithAny(["server.message.planImplemented"])) {
+      return "implemented";
+    }
+    if (startsWithAny(["server.message.planDismissed"])) {
+      return "dismissed";
+    }
+    return "";
+  }
+
+  if (normalizedKind === "choice") {
+    if (
+      startsWithAny([
+        "server.message.choiceSubmitted",
+        "server.message.choiceSubmittedTest",
+        "server.message.choiceSummarySubmitted",
+        "server.message.choiceSummaryReceivedTest",
+      ])
+    ) {
+      return "submitted";
+    }
+    return "";
+  }
+
+  return "";
+}
+
+function normalizeTimelineFileRefs(rawFileRefs) {
+  if (!Array.isArray(rawFileRefs)) {
+    return [];
+  }
+
+  const deduped = [];
+  const seen = new Set();
+  for (const rawRef of rawFileRefs) {
+    const normalized = cleanTimelineFileRef(rawRef);
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    deduped.push(normalized);
+    if (deduped.length >= 8) {
+      break;
+    }
+  }
+  return deduped;
+}
+
+function cleanTimelineFileRef(value) {
+  let normalized = cleanText(value || "");
+  if (!normalized) {
+    return "";
+  }
+
+  normalized = normalized
+    .replace(/^[`"'([{<]+/u, "")
+    .replace(/[)`"'\]}>.,:;!?]+$/u, "")
+    .replace(/[#:]L?\d+(?::\d+)?$/u, "");
+
+  if (!normalized || /^https?:\/\//iu.test(normalized)) {
+    return "";
+  }
+
+  if (normalized.startsWith("/")) {
+    const segments = normalized.split("/").filter(Boolean);
+    if (segments.length >= 2 && looksLikeFileRefBasename(segments[segments.length - 1])) {
+      return normalized;
+    }
+    return "";
+  }
+
+  if (normalized.includes("/")) {
+    const segments = normalized.split("/").filter(Boolean);
+    if (
+      segments.length >= 2 &&
+      segments.every((segment) => /^[A-Za-z0-9._-]+$/u.test(segment)) &&
+      looksLikeFileRefBasename(segments[segments.length - 1])
+    ) {
+      return normalized;
+    }
+    return "";
+  }
+
+  return looksLikeFileRefBasename(normalized) ? normalized : "";
+}
+
+function looksLikeFileRefBasename(value) {
+  const normalized = cleanText(value || "");
+  if (!normalized || /[\s\\]/u.test(normalized)) {
+    return false;
+  }
+  if (
+    [
+      ".env",
+      ".env.example",
+      ".gitignore",
+      "Dockerfile",
+      "LICENSE",
+      "Makefile",
+      "README.md",
+      "package-lock.json",
+      "package.json",
+      "pnpm-lock.yaml",
+      "tsconfig.json",
+      "vite.config.ts",
+    ].includes(normalized)
+  ) {
+    return true;
+  }
+  return /^(?:\.[A-Za-z0-9_-]+(?:\.[A-Za-z][A-Za-z0-9_-]{0,9})?|[A-Za-z0-9_-][A-Za-z0-9._-]*\.[A-Za-z][A-Za-z0-9_-]{0,9})$/u.test(
+    normalized
+  );
+}
+
+function extractTimelineFileRefs(messageText = "") {
+  const sourceText = String(messageText || "");
+  if (!sourceText) {
+    return [];
+  }
+
+  const refs = [];
+  const pushCandidate = (candidate) => {
+    const normalized = cleanTimelineFileRef(candidate);
+    if (normalized) {
+      refs.push(normalized);
+    }
+  };
+  const collectCandidates = (text) => {
+    for (const candidate of String(text || "").split(/\s+/u)) {
+      pushCandidate(candidate);
+    }
+  };
+
+  for (const match of sourceText.matchAll(/\[[^\]]+\]\((\/[^)\s]+)\)/gu)) {
+    pushCandidate(match[1]);
+  }
+
+  for (const match of sourceText.matchAll(/`([^`\n]+)`/gu)) {
+    collectCandidates(match[1]);
+  }
+
+  collectCandidates(
+    sourceText
+      .replace(/`[^`\n]+`/gu, " ")
+      .replace(/\[[^\]]+\]\(([^)]+)\)/gu, " ")
+  );
+
+  return normalizeTimelineFileRefs(refs);
+}
+
 function handleSignal() {
   runtime.stopping = true;
 }
@@ -304,11 +485,14 @@ function normalizeHistoryItem(raw) {
   const kind = cleanText(raw.kind ?? "");
   const title = cleanText(raw.title ?? "");
   const messageText = normalizeTimelineMessageText(raw.messageText ?? "");
+  const summary = normalizeNotificationText(raw.summary ?? "") || formatNotificationBody(messageText, 100) || "";
   const createdAtMs = Number(raw.createdAtMs) || Date.now();
   if (!stableId || !historyKinds.has(kind) || !title) {
     return null;
   }
 
+  const outcome = normalizeTimelineOutcome(raw.outcome ?? "") || inferTimelineOutcome(kind, summary, messageText);
+
   return {
     stableId,
     token: cleanText(raw.token ?? "") || historyToken(stableId),
@@ -316,9 +500,11 @@ function normalizeHistoryItem(raw) {
     threadId: cleanText(raw.threadId ?? extractConversationIdFromStableId(stableId) ?? ""),
     title,
     threadLabel: cleanText(raw.threadLabel ?? ""),
-    summary: normalizeNotificationText(raw.summary ?? "") || formatNotificationBody(messageText, 100) || "",
+    summary,
     messageText,
     imagePaths: normalizeTimelineImagePaths(raw.imagePaths ?? raw.localImagePaths ?? []),
+    fileRefs: normalizeTimelineFileRefs(raw.fileRefs ?? extractTimelineFileRefs(messageText)),
+    outcome,
     createdAtMs,
     readOnly: raw.readOnly !== false,
     primaryLabel: cleanText(raw.primaryLabel ?? "") || "詳細",
@@ -400,6 +586,7 @@ function normalizeTimelineEntry(raw) {
     "";
   const threadLabel = cleanText(raw.threadLabel ?? "");
   const title = cleanText(raw.title ?? "") || threadLabel || kindTitle(DEFAULT_LOCALE, kind);
+  const outcome = normalizeTimelineOutcome(raw.outcome ?? "") || inferTimelineOutcome(kind, summary, messageText);
 
   return {
     stableId,
@@ -411,6 +598,8 @@ function normalizeTimelineEntry(raw) {
     summary,
     messageText,
     imagePaths: normalizeTimelineImagePaths(raw.imagePaths ?? raw.localImagePaths ?? []),
+    fileRefs: normalizeTimelineFileRefs(raw.fileRefs ?? extractTimelineFileRefs(messageText)),
+    outcome,
     createdAtMs,
     readOnly: raw.readOnly !== false,
     primaryLabel: cleanText(raw.primaryLabel ?? "") || "詳細",
@@ -498,26 +687,48 @@ function recordHistoryItem({ config, runtime, state, item }) {
   return changed;
 }
 
-function recordActionHistoryItem({ config, runtime, state, kind, stableId, token, title, threadLabel = "", messageText, summary }) {
-  return recordHistoryItem({
+function recordActionHistoryItem({
+  config,
+  runtime,
+  state,
+  kind,
+  stableId,
+  token,
+  title,
+  threadLabel = "",
+  messageText,
+  summary,
+  outcome = "",
+}) {
+  const item = {
+    stableId,
+    token,
+    kind,
+    title,
+    threadId: cleanText(extractConversationIdFromStableId(stableId) ?? ""),
+    threadLabel,
+    summary,
+    messageText,
+    outcome,
+    createdAtMs: Date.now(),
+    readOnly: true,
+    primaryLabel: "詳細",
+    tone: "secondary",
+  };
+
+  const historyChanged = recordHistoryItem({
     config,
     runtime,
     state,
-    item: {
-      stableId,
-      token,
-      kind,
-      title,
-      threadId: cleanText(extractConversationIdFromStableId(stableId) ?? ""),
-      threadLabel,
-      summary,
-      messageText,
-      createdAtMs: Date.now(),
-      readOnly: true,
-      primaryLabel: "詳細",
-      tone: "secondary",
-    },
+    item,
+  });
+  const timelineChanged = recordTimelineEntry({
+    config,
+    runtime,
+    state,
+    entry: item,
   });
+  return historyChanged || timelineChanged;
 }
 
 function pendingApprovalStableId(approval) {
@@ -5685,6 +5896,7 @@ function buildCompletedInboxItems(runtime, state, config, locale) {
   const items = normalizeHistoryItems(state.recentHistoryItems ?? runtime.recentHistoryItems, config.maxHistoryItems);
   runtime.recentHistoryItems = items;
   return items
+    .filter((item) => cleanText(item?.kind || "") === "completion")
     .slice()
     .sort((left, right) => Number(right.createdAtMs ?? 0) - Number(left.createdAtMs ?? 0))
     .map((item) => ({
@@ -5694,6 +5906,7 @@ function buildCompletedInboxItems(runtime, state, config, locale) {
       threadLabel: item.threadLabel || "",
       title: item.threadLabel ? formatTitle(kindTitle(locale, item.kind), item.threadLabel) : item.title,
       summary: item.summary,
+      fileRefs: normalizeTimelineFileRefs(item.fileRefs ?? []),
       primaryLabel: t(locale, "server.action.detail"),
       createdAtMs: item.createdAtMs,
     }));
@@ -5724,6 +5937,7 @@ function buildOperationalTimelineEntries(runtime, state, config, locale) {
         title: formatLocalizedTitle(locale, "server.title.approval", approval.threadLabel),
         summary: formatNotificationBody(approval.messageText, 180) || approval.messageText,
         messageText: approval.messageText,
+        outcome: "pending",
         createdAtMs: Number(approval.createdAtMs) || now,
       })
     );
@@ -5746,6 +5960,7 @@ function buildOperationalTimelineEntries(runtime, state, config, locale) {
         title: formatLocalizedTitle(locale, "server.title.plan", planRequest.threadLabel),
         summary: formatNotificationBody(planRequest.messageText, 180) || planRequest.messageText,
         messageText: planRequest.messageText,
+        outcome: "pending",
         createdAtMs: Number(planRequest.createdAtMs) || now,
       })
     );
@@ -5772,6 +5987,7 @@ function buildOperationalTimelineEntries(runtime, state, config, locale) {
         ),
         summary: userInputRequest.notificationText || formatNotificationBody(userInputRequest.messageText, 180),
         messageText: userInputRequest.messageText,
+        outcome: "pending",
         createdAtMs: Number(userInputRequest.createdAtMs) || now,
       })
     );
@@ -5791,6 +6007,7 @@ function buildOperationalTimelineEntries(runtime, state, config, locale) {
         title: historyItem.threadLabel ? formatTitle(kindTitle(locale, historyItem.kind), historyItem.threadLabel) : historyItem.title,
         summary: historyItem.summary,
         messageText: historyItem.messageText,
+        outcome: historyItem.outcome,
         createdAtMs: historyItem.createdAtMs,
       })
     );
@@ -5872,6 +6089,8 @@ function buildTimelineResponse(runtime, state, config, locale) {
     threadLabel: entry.threadLabel,
     summary: entry.summary,
     imageUrls: buildTimelineEntryImageUrls(entry),
+    fileRefs: normalizeTimelineFileRefs(entry.fileRefs ?? []),
+    outcome: entry.outcome || "",
     createdAtMs: entry.createdAtMs,
   }));
 
@@ -6120,6 +6339,7 @@ function buildHistoryDetail(item, locale, runtime = null) {
     threadLabel: item.threadLabel || "",
     createdAtMs: Number(item.createdAtMs) || 0,
     messageHtml: renderMessageHtml(item.messageText, `<p>${escapeHtml(t(locale, "detail.detailUnavailable"))}</p>`),
+    fileRefs: normalizeTimelineFileRefs(item.fileRefs ?? []),
     interruptNotice: interruptedDetailNotice(item.messageText, locale),
     readOnly: true,
     reply: replyEnabled
@@ -6155,6 +6375,7 @@ function buildTimelineMessageDetail(entry, locale, runtime = null) {
     createdAtMs: Number(entry.createdAtMs) || 0,
     messageHtml: renderMessageHtml(entry.messageText, `<p>${escapeHtml(t(locale, "detail.detailUnavailable"))}</p>`),
     imageUrls: buildTimelineEntryImageUrls(entry),
+    fileRefs: normalizeTimelineFileRefs(entry.fileRefs ?? []),
     previousContext: buildInterruptedTimelineContext(runtime, entry, locale),
     interruptNotice: interruptedDetailNotice(entry.messageText, locale),
     readOnly: true,
@@ -6234,6 +6455,7 @@ async function submitGenericUserInputDecision({ config, runtime, state, userInpu
     summary: userInputRequest.testRequest
       ? t(config.defaultLocale, "server.message.choiceSummaryReceivedTest")
       : t(config.defaultLocale, "server.message.choiceSummarySubmitted"),
+    outcome: "submitted",
   }) || stateChanged;
   if (stateChanged) {
     await saveState(config.stateFile, state);
@@ -6659,6 +6881,7 @@ async function handlePlanDecision({ config, runtime, state, planRequest, decisio
     title: planRequest.title,
     messageText: `${planDecisionMessage(decision, config.defaultLocale)}\n\n${planRequest.messageText}`,
     summary: planDecisionMessage(decision, config.defaultLocale),
+    outcome: decision === "implement" ? "implemented" : "dismissed",
   }) || stateChanged;
   if (stateChanged) {
     await saveState(config.stateFile, state);
@@ -6682,6 +6905,7 @@ async function handleNativeApprovalDecision({ config, runtime, state, approval,
     title: approval.title,
     messageText: `${approvalDecisionMessage(decision, config.defaultLocale)}\n\n${approval.messageText}`,
     summary: approvalDecisionMessage(decision, config.defaultLocale),
+    outcome: decision === "accept" ? "approved" : "rejected",
   });
   if (stateChanged) {
     await saveState(config.stateFile, state);

package/web/app.css

@@ -974,6 +974,13 @@ code {
   gap: 0.38rem;
 }
 
+.timeline-thread-filter__row {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 0.6rem;
+  align-items: start;
+}
+
 .timeline-thread-filter__label {
   color: var(--muted);
   font-size: 0.8rem;
@@ -1009,6 +1016,92 @@ code {
   pointer-events: none;
 }
 
+.timeline-kind-filter {
+  position: relative;
+}
+
+.timeline-kind-filter__button {
+  width: 2.72rem;
+  min-width: 2.72rem;
+  min-height: 2.72rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 15px;
+  border: 1px solid rgba(156, 181, 197, 0.14);
+  background: rgba(255, 255, 255, 0.05);
+  color: rgba(236, 248, 255, 0.78);
+  box-shadow: var(--shadow-card);
+}
+
+.timeline-kind-filter__button.is-active {
+  border-color: rgba(104, 211, 164, 0.34);
+  background: rgba(31, 83, 63, 0.46);
+  color: rgba(224, 255, 240, 0.96);
+}
+
+.timeline-kind-filter__button-icon,
+.timeline-kind-filter__option-icon,
+.timeline-kind-filter__option-check {
+  width: 1rem;
+  height: 1rem;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.timeline-kind-filter__button-icon svg,
+.timeline-kind-filter__option-icon svg,
+.timeline-kind-filter__option-check svg {
+  width: 100%;
+  height: 100%;
+}
+
+.timeline-kind-filter__popover {
+  position: absolute;
+  right: 0;
+  top: calc(100% + 0.46rem);
+  z-index: 14;
+  width: min(15rem, calc(100vw - 2.25rem));
+  display: grid;
+  gap: 0.22rem;
+  padding: 0.4rem;
+  border: 1px solid rgba(156, 181, 197, 0.16);
+  border-radius: 18px;
+  background: rgba(15, 23, 31, 0.94);
+  box-shadow: 0 24px 46px rgba(5, 9, 14, 0.34);
+  -webkit-backdrop-filter: blur(24px) saturate(1.08);
+  backdrop-filter: blur(24px) saturate(1.08);
+}
+
+.timeline-kind-filter__option {
+  width: 100%;
+  display: grid;
+  grid-template-columns: auto 1fr auto;
+  gap: 0.62rem;
+  align-items: center;
+  padding: 0.74rem 0.78rem;
+  border: 0;
+  border-radius: 14px;
+  background: transparent;
+  color: var(--text);
+  text-align: left;
+}
+
+.timeline-kind-filter__option.is-selected {
+  background: rgba(255, 255, 255, 0.06);
+}
+
+.timeline-kind-filter__option-label {
+  font-size: 0.9rem;
+  font-weight: 600;
+  line-height: 1.3;
+}
+
+.timeline-kind-filter__option-check {
+  color: rgba(104, 211, 164, 0.94);
+}
+
 .timeline-list {
   display: grid;
   gap: 0.72rem;
@@ -1090,6 +1183,42 @@ code {
   margin-top: 0.08rem;
 }
 
+.timeline-entry__files {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.42rem;
+  margin-top: 0.14rem;
+}
+
+.file-ref-chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.34rem;
+  min-width: 0;
+  padding: 0.4rem 0.56rem;
+  border-radius: 999px;
+  background: rgba(16, 24, 31, 0.72);
+  border: 1px solid rgba(156, 181, 197, 0.12);
+  color: var(--muted);
+  font-size: 0.76rem;
+  line-height: 1.2;
+}
+
+.file-ref-chip__icon {
+  width: 0.82rem;
+  height: 0.82rem;
+  color: rgba(202, 220, 233, 0.72);
+  flex: 0 0 auto;
+}
+
+.file-ref-chip__label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 13.5rem;
+}
+
 .timeline-entry__image-frame {
   display: block;
   border-radius: 14px;
@@ -1463,6 +1592,12 @@ code {
   padding: 0.5rem;
 }
 
+.detail-card--files {
+  margin-top: 0.24rem;
+  gap: 0.62rem;
+  padding: 0.72rem;
+}
+
 .detail-card--reply {
   margin-top: 0.32rem;
   gap: 0.72rem;
@@ -1475,6 +1610,50 @@ code {
   width: 100%;
 }
 
+.detail-files-card__header {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.42rem;
+  font-size: 0.84rem;
+  color: var(--muted);
+}
+
+.detail-files-card__icon {
+  width: 0.92rem;
+  height: 0.92rem;
+  color: rgba(202, 220, 233, 0.72);
+}
+
+.detail-file-grid {
+  display: grid;
+  gap: 0.52rem;
+}
+
+.detail-file-chip {
+  display: grid;
+  gap: 0.14rem;
+  padding: 0.68rem 0.78rem;
+  border-radius: 16px;
+  background:
+    linear-gradient(180deg, rgba(255, 255, 255, 0.04), rgba(255, 255, 255, 0.02)),
+    rgba(10, 17, 22, 0.76);
+  border: 1px solid rgba(156, 181, 197, 0.12);
+}
+
+.detail-file-chip__label {
+  font-size: 0.88rem;
+  line-height: 1.35;
+  color: var(--text);
+  overflow-wrap: anywhere;
+}
+
+.detail-file-chip__path {
+  font-size: 0.76rem;
+  line-height: 1.45;
+  color: var(--muted);
+  overflow-wrap: anywhere;
+}
+
 .detail-image-link {
   display: block;
   padding: 0;

package/web/app.js

@@ -8,6 +8,8 @@ const TIMELINE_MESSAGE_KINDS = new Set(["user_message", "assistant_commentary",
 const TIMELINE_OPERATIONAL_KINDS = new Set(["approval", "plan", "plan_ready", "choice", "completion"]);
 const THREAD_FILTER_INTERACTION_DEFER_MS = 8000;
 const MAX_COMPLETION_REPLY_IMAGE_COUNT = 4;
+const NOTIFICATION_INTENT_CACHE = "viveworker-notification-intent-v1";
+const NOTIFICATION_INTENT_PATH = "/__viveworker_notification_intent__";
 
 const state = {
   session: null,
@@ -21,6 +23,8 @@ const state = {
   detailLoadingItem: null,
   detailOpen: false,
   timelineThreadFilter: "all",
+  timelineKindFilter: "all",
+  timelineKindFilterOpen: false,
   completedThreadFilter: "all",
   settingsSubpage: "",
   settingsScrollState: null,
@@ -86,6 +90,9 @@ async function boot() {
   await registerServiceWorker();
   navigator.serviceWorker?.addEventListener("message", handleServiceWorkerMessage);
   window.addEventListener("resize", handleViewportChange, { passive: true });
+  window.addEventListener("focus", handlePotentialExternalNavigation, { passive: true });
+  window.addEventListener("pageshow", handlePotentialExternalNavigation, { passive: true });
+  document.addEventListener("visibilitychange", handleDocumentVisibilityChange);
 
   await refreshSession();
 
@@ -121,6 +128,7 @@ async function boot() {
     return;
   }
 
+  await consumePendingNotificationIntent();
   await syncDetectedLocalePreference();
   await refreshAuthenticatedState();
   ensureCurrentSelection();
@@ -130,6 +138,10 @@ async function boot() {
     if (!state.session?.authenticated) {
       return;
     }
+    const consumedNotificationIntent = await consumePendingNotificationIntent();
+    if (consumedNotificationIntent) {
+      return;
+    }
     await refreshAuthenticatedState();
     if (!shouldDeferRenderForActiveInteraction()) {
       await renderShell();
@@ -314,6 +326,7 @@ async function refreshInbox() {
 async function refreshTimeline() {
   state.timeline = await apiGet("/api/timeline");
   syncTimelineThreadFilter();
+  syncTimelineKindFilter();
 }
 
 async function refreshDevices() {
@@ -420,10 +433,14 @@ function filteredTimelineEntries() {
   if (!entries.length) {
     return [];
   }
-  if (!state.timelineThreadFilter || state.timelineThreadFilter === "all") {
-    return entries;
+  let filtered = entries;
+  if (state.timelineThreadFilter && state.timelineThreadFilter !== "all") {
+    filtered = filtered.filter((entry) => entry.threadId === state.timelineThreadFilter);
+  }
+  if (!state.timelineKindFilter || state.timelineKindFilter === "all") {
+    return filtered;
   }
-  return entries.filter((entry) => entry.threadId === state.timelineThreadFilter);
+  return filtered.filter((entry) => timelineEntryMatchesKindFilter(entry, state.timelineKindFilter));
 }
 
 function filteredCompletedEntries() {
@@ -448,6 +465,49 @@ function syncTimelineThreadFilter() {
   }
 }
 
+function syncTimelineKindFilter() {
+  const validIds = new Set(timelineKindFilterOptions().map((option) => option.id));
+  if (!state.timelineKindFilter || !validIds.has(state.timelineKindFilter)) {
+    state.timelineKindFilter = "all";
+  }
+}
+
+function timelineKindFilterOptions() {
+  return [
+    { id: "all", label: L("timeline.kindFilter.all"), icon: "filter" },
+    { id: "messages", label: L("timeline.kindFilter.messages"), icon: "timeline" },
+    { id: "approvals", label: L("timeline.kindFilter.approvals"), icon: "approval" },
+    { id: "plans", label: L("timeline.kindFilter.plans"), icon: "plan" },
+    { id: "choices", label: L("timeline.kindFilter.choices"), icon: "choice" },
+    { id: "completions", label: L("timeline.kindFilter.completions"), icon: "completion-item" },
+  ];
+}
+
+function currentTimelineKindFilterOption() {
+  return (
+    timelineKindFilterOptions().find((option) => option.id === state.timelineKindFilter) ||
+    timelineKindFilterOptions()[0]
+  );
+}
+
+function timelineEntryMatchesKindFilter(entry, filterId) {
+  const kind = normalizeClientText(entry?.kind || entry?.item?.kind || "");
+  switch (filterId) {
+    case "messages":
+      return TIMELINE_MESSAGE_KINDS.has(kind);
+    case "approvals":
+      return kind === "approval";
+    case "plans":
+      return kind === "plan" || kind === "plan_ready";
+    case "choices":
+      return kind === "choice";
+    case "completions":
+      return kind === "completion";
+    default:
+      return true;
+  }
+}
+
 function completedThreads() {
   const items = Array.isArray(state.inbox?.completed) ? state.inbox.completed : [];
   if (!items.length) {
@@ -1459,6 +1519,7 @@ function renderTimelineThreadDropdown() {
     inputId: "timeline-thread-select",
     dataAttribute: "data-timeline-thread-select",
     selectedThreadId: state.timelineThreadFilter,
+    controlsHtml: renderTimelineKindFilterControls(),
     threads: threads.map((thread) => ({
       id: thread.id,
       label: dropdownThreadLabel(thread.id, thread.label || ""),
@@ -1475,7 +1536,7 @@ function renderCompletedThreadDropdown() {
   });
 }
 
-function renderThreadDropdown({ inputId, dataAttribute, selectedThreadId, threads }) {
+function renderThreadDropdown({ inputId, dataAttribute, selectedThreadId, threads, controlsHtml = "" }) {
   const options = [
     {
       id: "all",
@@ -1490,24 +1551,72 @@ function renderThreadDropdown({ inputId, dataAttribute, selectedThreadId, thread
   return `
     <div class="timeline-thread-filter">
       <label class="timeline-thread-filter__label" for="${escapeHtml(inputId)}">${escapeHtml(L("timeline.filterLabel"))}</label>
-      <div class="timeline-thread-select-wrap">
-        <select id="${escapeHtml(inputId)}" class="timeline-thread-select" ${dataAttribute}>
-          ${options
-            .map(
-              (thread) => `
-                <option value="${escapeHtml(thread.id)}" ${selectedThreadId === thread.id ? "selected" : ""}>
-                  ${escapeHtml(thread.label)}
-                </option>
-              `
-            )
-            .join("")}
-        </select>
-        <span class="timeline-thread-select__chevron" aria-hidden="true">${renderIcon("chevron-down")}</span>
+      <div class="timeline-thread-filter__row">
+        <div class="timeline-thread-select-wrap">
+          <select id="${escapeHtml(inputId)}" class="timeline-thread-select" ${dataAttribute}>
+            ${options
+              .map(
+                (thread) => `
+                  <option value="${escapeHtml(thread.id)}" ${selectedThreadId === thread.id ? "selected" : ""}>
+                    ${escapeHtml(thread.label)}
+                  </option>
+                `
+              )
+              .join("")}
+          </select>
+          <span class="timeline-thread-select__chevron" aria-hidden="true">${renderIcon("chevron-down")}</span>
+        </div>
+        ${controlsHtml}
       </div>
     </div>
   `;
 }
 
+function renderTimelineKindFilterControls() {
+  const current = currentTimelineKindFilterOption();
+  const options = timelineKindFilterOptions();
+  return `
+    <div class="timeline-kind-filter" data-timeline-kind-filter-root>
+      <button
+        type="button"
+        class="timeline-kind-filter__button ${current.id !== "all" ? "is-active" : ""}"
+        data-timeline-kind-filter-toggle
+        aria-expanded="${state.timelineKindFilterOpen ? "true" : "false"}"
+        aria-label="${escapeHtml(L("timeline.kindFilterButtonLabel"))}"
+      >
+        <span class="timeline-kind-filter__button-icon" aria-hidden="true">${renderIcon(current.icon)}</span>
+      </button>
+      ${
+        state.timelineKindFilterOpen
+          ? `
+            <div class="timeline-kind-filter__popover" role="menu" aria-label="${escapeHtml(L("timeline.kindFilterLabel"))}">
+              ${options
+                .map(
+                  (option) => `
+                    <button
+                      type="button"
+                      class="timeline-kind-filter__option ${option.id === current.id ? "is-selected" : ""}"
+                      data-timeline-kind-filter-option="${escapeHtml(option.id)}"
+                      role="menuitemradio"
+                      aria-checked="${option.id === current.id ? "true" : "false"}"
+                    >
+                      <span class="timeline-kind-filter__option-icon" aria-hidden="true">${renderIcon(option.icon)}</span>
+                      <span class="timeline-kind-filter__option-label">${escapeHtml(option.label)}</span>
+                      <span class="timeline-kind-filter__option-check" aria-hidden="true">${
+                        option.id === current.id ? renderIcon("check") : ""
+                      }</span>
+                    </button>
+                  `
+                )
+                .join("")}
+            </div>
+          `
+          : ""
+      }
+    </div>
+  `;
+}
+
 function renderTimelineEntry(entry, { desktop }) {
   const item = entry.item;
   const kindInfo = kindMeta(item.kind);
@@ -1515,13 +1624,14 @@ function renderTimelineEntry(entry, { desktop }) {
   const kindNameClass = escapeHtml(String(item.kind || "item").replace(/_/gu, "-"));
   const isMessageLike = TIMELINE_MESSAGE_KINDS.has(item.kind) || item.kind === "completion";
   const imageUrls = Array.isArray(item.imageUrls) ? item.imageUrls.filter(Boolean) : [];
+  const fileRefs = normalizeClientFileRefs(item.fileRefs);
   const primaryText = isMessageLike
     ? item.summary || fallbackSummaryForKind(item.kind, entry.status)
     : item.title || L("common.untitledItem");
   const secondaryText = isMessageLike ? "" : item.summary || fallbackSummaryForKind(item.kind, entry.status);
   const threadLabel = timelineEntryThreadLabel(item, isMessageLike);
   const timestampLabel = formatTimelineTimestamp(item.createdAtMs);
-  const statusLabel = isMessageLike ? "" : L("common.actionNeeded");
+  const statusLabel = timelineEntryStatusLabel(item, isMessageLike);
 
   return `
     <button
@@ -1545,12 +1655,42 @@ function renderTimelineEntry(entry, { desktop }) {
         <p class="timeline-entry__title">${escapeHtml(primaryText)}</p>
         ${secondaryText ? `<p class="timeline-entry__summary">${escapeHtml(secondaryText)}</p>` : ""}
         ${renderTimelineEntryImageStrip(imageUrls)}
+        ${renderTimelineEntryFileStrip(fileRefs)}
       </div>
       ${statusLabel ? `<div class="timeline-entry__footer"><span class="timeline-entry__status">${escapeHtml(statusLabel)}</span></div>` : ""}
     </button>
   `;
 }
 
+function timelineEntryStatusLabel(item, isMessageLike) {
+  if (isMessageLike) {
+    return "";
+  }
+
+  const outcome = normalizeClientText(item?.outcome || "");
+  switch (outcome) {
+    case "pending":
+      return L("common.actionNeeded");
+    case "approved":
+      return L("timeline.status.approved");
+    case "rejected":
+      return L("timeline.status.rejected");
+    case "implemented":
+      return L("timeline.status.implemented");
+    case "dismissed":
+      return L("timeline.status.dismissed");
+    case "submitted":
+      return L("timeline.status.submitted");
+    default:
+      break;
+  }
+
+  if (item?.kind === "approval" || item?.kind === "plan" || item?.kind === "plan_ready" || item?.kind === "choice") {
+    return L("common.actionNeeded");
+  }
+  return "";
+}
+
 function renderTimelineEntryImageStrip(imageUrls) {
   if (!Array.isArray(imageUrls) || imageUrls.length === 0) {
     return "";
@@ -1577,6 +1717,28 @@ function renderTimelineEntryImageStrip(imageUrls) {
   `;
 }
 
+function renderTimelineEntryFileStrip(fileRefs) {
+  if (!Array.isArray(fileRefs) || fileRefs.length === 0) {
+    return "";
+  }
+
+  return `
+    <div class="timeline-entry__files" aria-label="${escapeHtml(L("detail.filesTitle"))}">
+      ${fileRefs
+        .slice(0, 4)
+        .map(
+          (fileRef) => `
+            <span class="file-ref-chip" title="${escapeHtml(fileRef)}">
+              <span class="file-ref-chip__icon" aria-hidden="true">${renderIcon("item")}</span>
+              <span class="file-ref-chip__label">${escapeHtml(fileRefLabel(fileRef))}</span>
+            </span>
+          `
+        )
+        .join("")}
+    </div>
+  `;
+}
+
 function timelineEntryThreadLabel(item, isMessage) {
   const threadLabel = resolvedThreadLabel(item.threadId || "", item.threadLabel || "");
   if (!threadLabel) {
@@ -2307,6 +2469,7 @@ function renderStandardDetailDesktop(detail) {
         <div class="detail-body ${spaciousBodyDetail ? "detail-body--message " : ""}markdown">${detail.messageHtml || ""}</div>
       </section>
       ${renderDetailImageGallery(detail)}
+      ${renderDetailFileRefs(detail)}
       ${renderCompletionReplyComposer(detail)}
       ${detail.readOnly ? "" : renderActionButtons(detail.actions || [])}
     </div>
@@ -2328,6 +2491,7 @@ function renderStandardDetailMobile(detail) {
             <div class="detail-body ${spaciousBodyDetail ? "detail-body--message " : ""}markdown">${detail.messageHtml || ""}</div>
           </section>
           ${renderDetailImageGallery(detail, { mobile: true })}
+          ${renderDetailFileRefs(detail, { mobile: true })}
           ${renderCompletionReplyComposer(detail, { mobile: true })}
         </div>
         ${detail.readOnly ? "" : renderActionButtons(detail.actions || [], { mobileSticky: true })}
@@ -2435,6 +2599,34 @@ function renderDetailImageGallery(detail, options = {}) {
   `;
 }
 
+function renderDetailFileRefs(detail, options = {}) {
+  const fileRefs = normalizeClientFileRefs(detail?.fileRefs);
+  if (fileRefs.length === 0) {
+    return "";
+  }
+
+  return `
+    <section class="detail-card detail-card--files ${options.mobile ? "detail-card--mobile" : ""}">
+      <div class="detail-files-card__header">
+        <span class="detail-files-card__icon" aria-hidden="true">${renderIcon("item")}</span>
+        <span>${escapeHtml(L("detail.filesTitle"))}</span>
+      </div>
+      <div class="detail-file-grid">
+        ${fileRefs
+          .map(
+            (fileRef) => `
+              <div class="detail-file-chip" title="${escapeHtml(fileRef)}">
+                <span class="detail-file-chip__label">${escapeHtml(fileRefLabel(fileRef))}</span>
+                <span class="detail-file-chip__path">${escapeHtml(fileRef)}</span>
+              </div>
+            `
+          )
+          .join("")}
+      </div>
+    </section>
+  `;
+}
+
 function renderCompletionReplyComposer(detail, options = {}) {
   if (detail.kind !== "completion" || detail.reply?.enabled !== true) {
     return "";
@@ -3060,6 +3252,27 @@ function bindShellInteractions() {
     select.addEventListener("change", async () => {
       clearThreadFilterInteraction();
       state.timelineThreadFilter = select.value || "all";
+      state.timelineKindFilterOpen = false;
+      alignCurrentItemToVisibleEntries();
+      await renderShell();
+    });
+  }
+
+  for (const button of document.querySelectorAll("[data-timeline-kind-filter-toggle]")) {
+    button.addEventListener("click", async (event) => {
+      event.preventDefault();
+      markThreadFilterInteraction();
+      state.timelineKindFilterOpen = !state.timelineKindFilterOpen;
+      await renderShell();
+    });
+  }
+
+  for (const button of document.querySelectorAll("[data-timeline-kind-filter-option]")) {
+    button.addEventListener("click", async (event) => {
+      event.preventDefault();
+      clearThreadFilterInteraction();
+      state.timelineKindFilter = button.dataset.timelineKindFilterOption || "all";
+      state.timelineKindFilterOpen = false;
       alignCurrentItemToVisibleEntries();
       await renderShell();
     });
@@ -3550,6 +3763,7 @@ function closeSettingsSubpage() {
 
 async function switchTab(tab) {
   state.currentTab = tab;
+  state.timelineKindFilterOpen = false;
   state.pushNotice = "";
   state.pushError = "";
   state.settingsSubpage = "";
@@ -3570,6 +3784,7 @@ function openItem({ kind, token, sourceTab }) {
   const previousItem = state.currentItem ? { ...state.currentItem } : null;
   clearPinnedDetailState();
   const nextTab = sourceTab || tabForItemKind(kind, state.currentTab);
+  state.timelineKindFilterOpen = false;
   if (previousItem && (previousItem.kind !== kind || previousItem.token !== token)) {
     clearChoiceLocalDraftForItem(previousItem);
   }
@@ -4044,6 +4259,8 @@ function renderIcon(name) {
       return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M10.4 13.6 8.3 15.7a3 3 0 0 1-4.2-4.2l2.8-2.8a3 3 0 0 1 4.2 0"/><path d="m13.6 10.4 2.1-2.1a3 3 0 1 1 4.2 4.2l-2.8 2.8a3 3 0 0 1-4.2 0"/><path d="m9.5 14.5 5-5"/></svg>`;
     case "clip":
       return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="m9.5 12.5 5.9-5.9a3 3 0 1 1 4.2 4.2l-7.7 7.7a5 5 0 1 1-7.1-7.1l8.1-8.1"/></svg>`;
+    case "filter":
+      return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.9" stroke-linecap="round" stroke-linejoin="round"><path d="M5 7h14"/><path d="M8 12h8"/><path d="M10.5 17h3"/></svg>`;
     case "check":
       return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"><path d="m6.8 12.5 3.2 3.2 7.2-7.4"/></svg>`;
     case "back":
@@ -4151,9 +4368,31 @@ function handleServiceWorkerMessage(event) {
   const type = event?.data?.type || "";
   if (type === "pushsubscriptionchange") {
     refreshPushStatus().then(renderCurrentSurface).catch(() => {});
+    return;
+  }
+  if (type === "open-target-url" && event?.data?.url) {
+    applyExternalTargetUrl(event.data.url).catch(() => {});
   }
 }
 
+function handlePotentialExternalNavigation() {
+  consumePendingNotificationIntent()
+    .then((consumed) => {
+      if (consumed) {
+        return;
+      }
+      return applyExternalTargetUrl(window.location.href, { allowRefresh: false });
+    })
+    .catch(() => {});
+}
+
+function handleDocumentVisibilityChange() {
+  if (document.visibilityState !== "visible") {
+    return;
+  }
+  handlePotentialExternalNavigation();
+}
+
 async function apiGet(url) {
   const response = await fetch(url, {
     credentials: "same-origin",
@@ -4250,11 +4489,124 @@ function normalizeClientText(value) {
   return String(value ?? "").trim();
 }
 
+function normalizeClientFileRefs(fileRefs) {
+  if (!Array.isArray(fileRefs)) {
+    return [];
+  }
+  const deduped = [];
+  const seen = new Set();
+  for (const fileRef of fileRefs) {
+    const normalized = normalizeClientText(fileRef);
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    deduped.push(normalized);
+    if (deduped.length >= 8) {
+      break;
+    }
+  }
+  return deduped;
+}
+
+function fileRefLabel(fileRef) {
+  const normalized = normalizeClientText(fileRef);
+  if (!normalized) {
+    return "";
+  }
+  const segments = normalized.split("/").filter(Boolean);
+  return segments[segments.length - 1] || normalized;
+}
+
 function parseItemRef(value) {
   const [kind, token] = String(value || "").split(":");
   return kind && token ? { kind, token } : null;
 }
 
+async function applyExternalTargetUrl(urlString, { allowRefresh = true } = {}) {
+  if (!state.session?.authenticated) {
+    return;
+  }
+
+  let nextUrl;
+  try {
+    nextUrl = new URL(urlString, window.location.origin);
+  } catch {
+    return;
+  }
+
+  const itemRef = parseItemRef(nextUrl.searchParams.get("item"));
+  if (!itemRef) {
+    return;
+  }
+
+  const sameItem =
+    Boolean(state.currentItem) &&
+    isSameItemRef(state.currentItem, itemRef) &&
+    (isDesktopLayout() || state.detailOpen);
+  if (sameItem) {
+    if (allowRefresh) {
+      await refreshAuthenticatedState();
+      ensureCurrentSelection();
+      await renderShell();
+    }
+    return;
+  }
+
+  openItem({
+    kind: itemRef.kind,
+    token: itemRef.token,
+    sourceTab: tabForItemKind(itemRef.kind, state.currentTab),
+  });
+  if (isFastPathItemRef(itemRef)) {
+    state.launchItemIntent = {
+      ...itemRef,
+      status: "pending",
+    };
+  }
+  await renderShell();
+
+  if (!allowRefresh) {
+    return;
+  }
+  await refreshAuthenticatedState();
+  ensureCurrentSelection();
+  await renderShell();
+}
+
+async function consumePendingNotificationIntent() {
+  if (!state.session?.authenticated || typeof caches === "undefined") {
+    return false;
+  }
+  let cache;
+  try {
+    cache = await caches.open(NOTIFICATION_INTENT_CACHE);
+  } catch {
+    return false;
+  }
+
+  const request = new Request(NOTIFICATION_INTENT_PATH);
+  const match = await cache.match(request).catch(() => null);
+  if (!match) {
+    return false;
+  }
+
+  let payload = null;
+  try {
+    payload = await match.json();
+  } catch {
+    payload = null;
+  }
+  await cache.delete(request).catch(() => {});
+
+  const url = normalizeClientText(payload?.url || "");
+  if (!url) {
+    return false;
+  }
+  await applyExternalTargetUrl(url, { allowRefresh: true });
+  return true;
+}
+
 function buildAppUrl(nextParams) {
   const query = nextParams.toString();
   return `/app${query ? `?${query}` : ""}`;

package/web/i18n.js

@@ -108,6 +108,7 @@ const translations = {
     "detail.previousMessage": "Previous message",
     "detail.interruptedTask": "Interrupted task",
     "detail.imageAlt": ({ index }) => `Attached image ${index}`,
+    "detail.filesTitle": "Files",
     "detail.turnAbortedNotice": "This task was interrupted.",
     "detail.macOnlyChoice": "Please answer this type of input on the Mac.",
     "detail.detailUnavailable": "Detail not available.",
@@ -167,6 +168,19 @@ const translations = {
     "timeline.allThreads": "All",
     "timeline.unknownThread": "Unknown thread",
     "timeline.filterLabel": "Thread filter",
+    "timeline.status.approved": "Approved",
+    "timeline.status.rejected": "Rejected",
+    "timeline.status.implemented": "Started",
+    "timeline.status.dismissed": "Dismissed",
+    "timeline.status.submitted": "Sent",
+    "timeline.kindFilterLabel": "Event filter",
+    "timeline.kindFilterButtonLabel": "Filter timeline events",
+    "timeline.kindFilter.all": "All events",
+    "timeline.kindFilter.messages": "Messages",
+    "timeline.kindFilter.approvals": "Approvals",
+    "timeline.kindFilter.plans": "Plans",
+    "timeline.kindFilter.choices": "Choices",
+    "timeline.kindFilter.completions": "Completed",
     "settings.intro": "Check pairing, language, install status, and Web Push health for this iPhone.",
     "settings.section.overview": "Quick setup",
     "settings.section.notifications": "Notifications",
@@ -565,6 +579,7 @@ const translations = {
     "detail.previousMessage": "ひとつ前のメッセージ",
     "detail.interruptedTask": "中断されたタスク",
     "detail.imageAlt": ({ index }) => `添付画像 ${index}`,
+    "detail.filesTitle": "関連ファイル",
     "detail.turnAbortedNotice": "タスクを中断しました。",
     "detail.macOnlyChoice": "この種類の入力は Mac で回答してください。",
     "detail.detailUnavailable": "詳細は利用できません。",
@@ -624,6 +639,19 @@ const translations = {
     "timeline.allThreads": "すべて",
     "timeline.unknownThread": "不明なスレッド",
     "timeline.filterLabel": "スレッドフィルター",
+    "timeline.status.approved": "承認済み",
+    "timeline.status.rejected": "拒否済み",
+    "timeline.status.implemented": "実装開始",
+    "timeline.status.dismissed": "見送り",
+    "timeline.status.submitted": "送信済み",
+    "timeline.kindFilterLabel": "イベントフィルター",
+    "timeline.kindFilterButtonLabel": "タイムラインのイベントを絞り込む",
+    "timeline.kindFilter.all": "すべてのイベント",
+    "timeline.kindFilter.messages": "メッセージ",
+    "timeline.kindFilter.approvals": "承認",
+    "timeline.kindFilter.plans": "プラン",
+    "timeline.kindFilter.choices": "選択",
+    "timeline.kindFilter.completions": "完了",
     "settings.intro": "この iPhone のペアリング、言語、インストール状況、Web Push の状態を確認できます。",
     "settings.section.overview": "クイック確認",
     "settings.section.notifications": "通知",

package/web/sw.js

@@ -1,4 +1,6 @@
-const CACHE_NAME = "viveworker-v6";
+const CACHE_NAME = "viveworker-v7";
+const NOTIFICATION_INTENT_CACHE = "viveworker-notification-intent-v1";
+const NOTIFICATION_INTENT_PATH = "/__viveworker_notification_intent__";
 const APP_ASSETS = ["/app.css", "/app.js", "/i18n.js"];
 const APP_ROUTES = new Set(["/", "/app", "/app/"]);
 const CACHED_PATHS = new Set(APP_ASSETS);
@@ -74,6 +76,7 @@ self.addEventListener("push", (event) => {
 });
 
 self.addEventListener("notificationclick", (event) => {
+  event.preventDefault?.();
   event.notification.close();
   const targetUrl = event.notification?.data?.url || "/app";
   event.waitUntil(openTargetWindow(targetUrl));
@@ -85,20 +88,26 @@ self.addEventListener("pushsubscriptionchange", (event) => {
 
 async function openTargetWindow(targetUrl) {
   const target = new URL(targetUrl, self.location.origin);
+  await persistNotificationIntent(target.toString());
   const clients = await self.clients.matchAll({
     type: "window",
     includeUncontrolled: true,
   });
+  broadcastTargetUrl(target.toString(), clients);
 
   const preferredClients = clients
     .slice()
-    .sort((left, right) => scoreClient(right.url) - scoreClient(left.url));
+    .sort((left, right) => scoreClient(right) - scoreClient(left));
 
   for (const client of preferredClients) {
     if (typeof client.focus === "function") {
       if (typeof client.navigate === "function") {
-        await client.navigate(target.toString());
+        await client.navigate(target.toString()).catch(() => {});
       }
+      client.postMessage({
+        type: "open-target-url",
+        url: target.toString(),
+      });
       await client.focus();
       return;
     }
@@ -109,9 +118,9 @@ async function openTargetWindow(targetUrl) {
   }
 }
 
-function scoreClient(urlString) {
+function scoreClient(client) {
   try {
-    const url = new URL(urlString);
+    const url = new URL(client?.url || "");
     let score = 0;
     if (APP_ROUTES.has(url.pathname)) {
       score += 20;
@@ -119,12 +128,50 @@ function scoreClient(urlString) {
     if (url.pathname === "/app" || url.pathname === "/app/") {
       score += 5;
     }
+    if (client?.focused) {
+      score += 4;
+    }
+    if (client?.visibilityState === "visible") {
+      score += 2;
+    }
     return score;
   } catch {
     return 0;
   }
 }
 
+function broadcastTargetUrl(url, clients) {
+  for (const client of clients) {
+    client.postMessage({
+      type: "open-target-url",
+      url,
+    });
+  }
+}
+
+async function persistNotificationIntent(url) {
+  try {
+    const cache = await caches.open(NOTIFICATION_INTENT_CACHE);
+    const request = new Request(NOTIFICATION_INTENT_PATH);
+    const response = new Response(
+      JSON.stringify({
+        url,
+        nonce: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        createdAtMs: Date.now(),
+      }),
+      {
+        headers: {
+          "Content-Type": "application/json",
+          "Cache-Control": "no-store",
+        },
+      }
+    );
+    await cache.put(request, response);
+  } catch {
+    // Best-effort fallback for iOS warm-start notification routing.
+  }
+}
+
 async function notifyClients(type) {
   const clients = await self.clients.matchAll({
     type: "window",