Initial commit: Grounded Flutter frontend

A to-do app that doesn't believe you — an enforcement layer rather than a
neutral ledger.

Architecture ported from Autoreceptives/Frontend/Receptive: stacked MVVM with
the mandatory 4-file screen pattern, one ParentViewModel owning the loading /
network / error overlays and the handleError decision tree, one AppDataManager
gateway, dio comms carrying the three identity headers, secure storage with
random-suffixed keys, and a single-chokepoint Navigator. Package root and Dart
package name are both Grounded; org is nya.

The enforcement engine, one unit per formula in utils/:

- DebtEngine      w(class) x severity(d) x decay(t), sublinear severity so old
                  misses cannot swamp the score; abandonment 2x with 30-day
                  decay immunity; late complete retains 30%
- StandingEngine  Good -> Warned -> Grounded -> Lockdown, derived not set;
                  Grounded replaces home with the overdue queue
- CapacityEngine  blocks over-scheduling against p50 of historically completed
                  minutes, with a learned per-category estimation multiplier
- IntegrityEngine session integrity, weekly volume, plyometric contact ceiling
                  and enforced recovery gaps
- ExcuseAnalyser  on-device excuse clustering plus the confrontation copy
- GuardrailEngine distress detection and rationed amnesty
- ToneEngine      all enforcement copy, so the tone cap lives in one place

CommitmentEvent is append-only and is the source of truth rather than the
status field, which is what makes honest history and excuse analysis possible.

Goals contain commitments via parentId, and a task can be run from a
full-screen runner that derives elapsed time from wall-clock so screen-off
cannot lose time. Backgrounding pauses the clock and is counted. The runner is
mirrored into an ongoing notification, with alarm-class full-screen intents
reserved for non-negotiables.

Design language, fonts, icon and native splash are in place; Mason bricks are
retargeted to this project and verified end-to-end.

flutter analyze lib/ reports no errors.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Mfu2gQLSFN21YRBcU2NrTt

frontend/lib/Grounded/about/external/data/LiveSession.dart

@@ -0,0 +1,118 @@
+/// A task actively being run. This is what the full-screen runner and the
+/// ongoing notification are both driven from.
+class LiveSession {
+  String commitmentId;
+
+  String title;
+
+  String goalTitle;
+
+  /// Wall-clock start of the run.
+  DateTime startedAt;
+
+  /// Seconds of *foreground* work accumulated. Backgrounding the app stops
+  /// this accruing — that is the whole point of Timer proof.
+  int accumulatedSeconds;
+
+  /// When the current active stretch began; null while paused.
+  DateTime? resumedAt;
+
+  /// Seconds required before the run counts as proof.
+  int requiredSeconds;
+
+  /// How many times the user left the app mid-run. Surfaced afterwards rather
+  /// than hidden, because leaving repeatedly is the behaviour worth seeing.
+  int backgroundedCount;
+
+  LiveSession({
+    this.commitmentId = "",
+    this.title = "",
+    this.goalTitle = "",
+    required this.startedAt,
+    this.accumulatedSeconds = 0,
+    this.resumedAt,
+    this.requiredSeconds = 0,
+    this.backgroundedCount = 0,
+  });
+
+  factory LiveSession.fromJson(Map<String, dynamic> json) {
+    return LiveSession(
+      commitmentId: json['commitmentId'] ?? "",
+      title: json['title'] ?? "",
+      goalTitle: json['goalTitle'] ?? "",
+      startedAt: DateTime.tryParse(json['startedAt'] ?? "") ?? DateTime.now(),
+      accumulatedSeconds: json['accumulatedSeconds'] ?? 0,
+      resumedAt: DateTime.tryParse(json['resumedAt'] ?? ""),
+      requiredSeconds: json['requiredSeconds'] ?? 0,
+      backgroundedCount: json['backgroundedCount'] ?? 0,
+    );
+  }
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['commitmentId'] = commitmentId;
+    data['title'] = title;
+    data['goalTitle'] = goalTitle;
+    data['startedAt'] = startedAt.toIso8601String();
+    data['accumulatedSeconds'] = accumulatedSeconds;
+    data['resumedAt'] = resumedAt?.toIso8601String();
+    data['requiredSeconds'] = requiredSeconds;
+    data['backgroundedCount'] = backgroundedCount;
+    return data;
+  }
+
+  bool get running {
+    return resumedAt != null;
+  }
+
+  /// Foreground seconds as of now, including the stretch in progress. This is
+  /// derived from wall-clock rather than counted by the ticker, so the value
+  /// stays correct across a screen-off period where timers are throttled.
+  int elapsedSeconds({DateTime? now}) {
+    if (resumedAt == null) {
+      return accumulatedSeconds;
+    }
+    final DateTime moment = now ?? DateTime.now();
+    return accumulatedSeconds + moment.difference(resumedAt!).inSeconds;
+  }
+
+  int remainingSeconds({DateTime? now}) {
+    final int remaining = requiredSeconds - elapsedSeconds(now: now);
+    return remaining > 0 ? remaining : 0;
+  }
+
+  /// 0..1 toward the requirement.
+  double progress({DateTime? now}) {
+    if (requiredSeconds <= 0) {
+      return 0;
+    }
+    final double value = elapsedSeconds(now: now) / requiredSeconds;
+    return value > 1 ? 1 : value;
+  }
+
+  /// The requirement has been met — completion is now allowed.
+  bool satisfied({DateTime? now}) {
+    if (requiredSeconds <= 0) {
+      return true;
+    }
+    return elapsedSeconds(now: now) >= requiredSeconds;
+  }
+
+  /// Pause and bank the stretch that just ended.
+  void pause({DateTime? now}) {
+    if (resumedAt == null) {
+      return;
+    }
+    final DateTime moment = now ?? DateTime.now();
+    accumulatedSeconds =
+        accumulatedSeconds + moment.difference(resumedAt!).inSeconds;
+    resumedAt = null;
+  }
+
+  void resume({DateTime? now}) {
+    if (resumedAt != null) {
+      return;
+    }
+    resumedAt = now ?? DateTime.now();
+  }
+}