Add a Home entry point to the AI briefing screen

ios/Runner.xcodeproj/xcshareddata/xcschemes/OpenStrapWatch Watch App.xcscheme

@@ -47,7 +47,6 @@
             BuildableIdentifier = "primary"
             BlueprintIdentifier = "53962EBD2FF6EF790061A61B"
             BuildableName = "OpenStrapWatch Watch App.app"
-            BlueprintName = "OpenStrapWatch Watch App"
             ReferencedContainer = "container:Runner.xcodeproj">
          </BuildableReference>
       </BuildableProductRunnable>
@@ -64,7 +63,6 @@
             BuildableIdentifier = "primary"
             BlueprintIdentifier = "53962EBD2FF6EF790061A61B"
             BuildableName = "OpenStrapWatch Watch App.app"
-            BlueprintName = "OpenStrapWatch Watch App"
             ReferencedContainer = "container:Runner.xcodeproj">
          </BuildableReference>
       </BuildableProductRunnable>

lib/ai/briefing.dart

@@ -97,6 +97,27 @@ class Briefing {
   }
 }
 
+/// Resolves which period's briefing an entry point meaning "today's
+/// briefing" (Home's link row, a generic notification tap) should actually
+/// show, per [currentBriefingPeriod]'s own documented fallback: past 17:00 it
+/// returns [BriefingPeriod.evening] even when nothing has been written there
+/// yet, "falling back to the cached morning one until [it] exists."
+///
+/// [current] is [BriefingStore.read] for [period]; [morningFallback] is the
+/// same for [BriefingPeriod.morning] — passed in rather than read here so
+/// this stays a pure function, testable without touching SharedPreferences.
+({BriefingPeriod period, Briefing? briefing}) resolveBriefingToShow(
+  BriefingPeriod period,
+  Briefing? current,
+  Briefing? morningFallback,
+) {
+  if (current != null) return (period: period, briefing: current);
+  if (morningFallback != null) {
+    return (period: BriefingPeriod.morning, briefing: morningFallback);
+  }
+  return (period: period, briefing: null);
+}
+
 /// Per-day+period briefing cache + the journal "done for today" flag.
 class BriefingStore {
   BriefingStore._();

lib/l10n/app_en.arb

@@ -7445,6 +7445,14 @@
   "@homeBreakdownSubtitle": {
     "description": "Link row subtitle under the breakdown-of-your-day title."
   },
+  "homeBriefingTitle": "Briefing",
+  "@homeBriefingTitle": {
+    "description": "Link row title under Today's plan: opens the AI briefing screen. Constant regardless of morning/evening period."
+  },
+  "homeBriefingSubtitleEmpty": "Tap to write today's summary",
+  "@homeBriefingSubtitleEmpty": {
+    "description": "Link row subtitle under the briefing title when nothing has been generated for today yet."
+  },
   "homeIllnessRedTitle": "Several nights in a row are away from your normal",
   "@homeIllnessRedTitle": {
     "description": "Illness watch headline when several nights in a row are away from baseline (red state)."

lib/ui2/screens/home_screen.dart

@@ -32,6 +32,8 @@ import 'package:flutter/material.dart';
 import 'package:lucide_icons_flutter/lucide_icons.dart';
 import 'package:provider/provider.dart';
 
+import '../../ai/briefing.dart'
+    show Briefing, BriefingPeriod, BriefingStore, currentBriefingPeriod, resolveBriefingToShow;
 import '../../data/day_label.dart' show todayLabel, calendarDaysBetween;
 import '../../data/db.dart' show DbRebuild;
 import '../../data/journal_fields.dart' show formatMinuteOfDay;
@@ -46,6 +48,7 @@ import '../activity/day_strain.dart' show DayStrainDetail;
 import '../profile/devices.dart' show formatDayTime;
 import '../profile/profile.dart';
 import '../ui2.dart';
+import 'ai_briefing.dart' show AiBriefingScreen;
 import 'coach.dart';
 import 'day_timeline.dart' show DayTimelineScreen;
 import 'metric_detail.dart';
@@ -2049,24 +2052,78 @@ class _HomeScreenState extends State<HomeScreen> with RevisionReload {
           false));
     }
 
-    if (rows.isEmpty) {
-      return StatusCard.forMetric(l?.homeNoPlanTitle ?? 'No plan for today yet', d.sleepNeedMin,
-              // "none are established yet" is the COLD-START reason, and it is
-              // a wrong answer when the baselines exist and are being withheld.
-              why: d.insightsStale != null
-                  ? (l?.homeNoPlanWhyStale ?? 'The cross-day rollup they come from is being rebuilt.')
-                  : (l?.homeNoPlanWhyNone ?? 'None are established yet.')) ??
-          const SizedBox.shrink();
-    }
+    final planBody = rows.isEmpty
+        ? StatusCard.forMetric(l?.homeNoPlanTitle ?? 'No plan for today yet', d.sleepNeedMin,
+                // "none are established yet" is the COLD-START reason, and it
+                // is a wrong answer when the baselines exist and are being
+                // withheld.
+                why: d.insightsStale != null
+                    ? (l?.homeNoPlanWhyStale ?? 'The cross-day rollup they come from is being rebuilt.')
+                    : (l?.homeNoPlanWhyNone ?? 'None are established yet.')) ??
+            const SizedBox.shrink()
+        : Surface(
+            pad: const EdgeInsets.symmetric(horizontal: S.x4, vertical: S.x2),
+            child: Column(children: [
+              for (var i = 0; i < rows.length; i++) ...[
+                if (i > 0) Divider(color: p.line, height: 1),
+                rows[i],
+              ],
+            ]),
+          );
 
-    return Surface(
-      pad: const EdgeInsets.symmetric(horizontal: S.x4, vertical: S.x2),
-      child: Column(children: [
-        for (var i = 0; i < rows.length; i++) ...[
-          if (i > 0) Divider(color: p.line, height: 1),
-          rows[i],
-        ],
-      ]),
+    return Column(children: [
+      planBody,
+      const SizedBox(height: S.x3),
+      _briefingDoor(c, d),
+    ]);
+  }
+
+  /// The only quick way into [AiBriefingScreen] used to be the notification
+  /// that fires when a briefing is ready — dismiss or miss it, and the
+  /// screen was two non-obvious taps deep behind Coach's overflow menu
+  /// instead (see EDGE-14). Shown unconditionally, not gated on AI/BYOK
+  /// being configured: the screen itself already has a graceful
+  /// "no model set up" state with its own way to fix that, so gating here
+  /// would just duplicate that door rather than simplify anything.
+  /// Re-run on every call rather than cached by the caller: Home is kept
+  /// alive by the shell's `IndexedStack` (see revision.dart), so a build can
+  /// sit for hours without rerunning. Resolving once at build time and
+  /// capturing the result in the row's `onTap` closure would let a stale
+  /// morning/evening decision — or a briefing written in the background
+  /// after that build — survive across the 17:00 boundary until Home
+  /// happens to rebuild for an unrelated reason.
+  ({BriefingPeriod period, Briefing? briefing}) _resolveBriefingNow(HomeData d) {
+    final period = currentBriefingPeriod(DateTime.now());
+    return resolveBriefingToShow(
+      period,
+      BriefingStore.read(period, day: d.dayId),
+      BriefingStore.read(BriefingPeriod.morning, day: d.dayId),
+    );
+  }
+
+  Widget _briefingDoor(BuildContext c, HomeData d) {
+    final l = AppLocalizations.of(c);
+    final cached = _resolveBriefingNow(d).briefing;
+    return detailLinkRow(
+      c,
+      LucideIcons.sparkles,
+      l?.homeBriefingTitle ?? 'Briefing',
+      cached?.oneLiner ?? (l?.homeBriefingSubtitleEmpty ?? 'Tap to write today\'s summary'),
+      () async {
+        // Resolved fresh at tap time via _resolveBriefingNow, not read from
+        // the value above — see that method's doc for why.
+        //
+        // Writing a briefing (BriefingStore.write, in briefing_engine.dart)
+        // does not bump AppState.insightsRevision, so RevisionReload's
+        // automatic reload never fires for it — awaiting the route and
+        // reloading on return is the only way this row picks up a briefing
+        // written during the visit instead of showing stale/empty text until
+        // some UNRELATED revision bump happens to refresh Home.
+        final screen = AiBriefingScreen(period: _resolveBriefingNow(d).period);
+        await Navigator.of(c).push(
+            themedRoute<void>((_) => screen, name: screen.runtimeType.toString()));
+        if (mounted) reload();
+      },
     );
   }
 

test/resolve_briefing_to_show_test.dart

@@ -0,0 +1,59 @@
+// resolveBriefingToShow backs the Home "Briefing" link row (see EDGE-14 /
+// PR #447). currentBriefingPeriod documents that past 17:00 it returns
+// `evening` even before the evening recap exists, "falling back to the
+// cached morning one until [it] exists" — a contract the row's first version
+// did not honor: it just opened whatever currentBriefingPeriod said, so
+// after 5pm with no evening sweep written yet it showed the generic "tap to
+// write" prompt and opened an empty evening screen instead of the morning
+// briefing already sitting in cache (Sourcery finding on PR #447).
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:openstrap_edge/ai/briefing.dart';
+
+Briefing _briefing(BriefingPeriod period, String oneLiner) => Briefing(
+      day: '2026-09-20',
+      period: period,
+      oneLiner: oneLiner,
+      breakdownMd: '',
+      generatedAtMs: 0,
+      inputs: const {},
+    );
+
+void main() {
+  test('morning, before 17:00: the morning briefing is used as-is', () {
+    final morning = _briefing(BriefingPeriod.morning, 'slept well');
+    final result =
+        resolveBriefingToShow(BriefingPeriod.morning, morning, morning);
+    expect(result.period, BriefingPeriod.morning);
+    expect(result.briefing, morning);
+  });
+
+  test('evening, recap already written: the evening briefing is used', () {
+    final morning = _briefing(BriefingPeriod.morning, 'slept well');
+    final evening = _briefing(BriefingPeriod.evening, 'good day overall');
+    final result =
+        resolveBriefingToShow(BriefingPeriod.evening, evening, morning);
+    expect(result.period, BriefingPeriod.evening);
+    expect(result.briefing, evening);
+  });
+
+  test(
+      'evening, recap not written yet, morning cached: falls back to the '
+      'morning briefing', () {
+    final morning = _briefing(BriefingPeriod.morning, 'slept well');
+    final result =
+        resolveBriefingToShow(BriefingPeriod.evening, null, morning);
+    expect(result.period, BriefingPeriod.morning,
+        reason: 'currentBriefingPeriod documents this exact fallback');
+    expect(result.briefing, morning);
+  });
+
+  test('evening, neither written yet: stays on evening with nothing cached',
+      () {
+    final result = resolveBriefingToShow(BriefingPeriod.evening, null, null);
+    expect(result.period, BriefingPeriod.evening,
+        reason: 'the destination screen\'s own "write one now" state should '
+            'open for the period the user actually asked about');
+    expect(result.briefing, isNull);
+  });
+}