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/RoutineChain.dart

@@ -0,0 +1,97 @@
+/// An ordered sequence where the chain, not the step, is the unit of
+/// completion. Breaking mid-way logs partial.
+class RoutineChain {
+  String? id;
+
+  String title;
+
+  List<RoutineStep> steps;
+
+  /// Index of the step reached when the chain last broke; -1 when clean.
+  int lastBreakIndex;
+
+  RoutineChain({
+    this.id,
+    this.title = "",
+    List<RoutineStep>? steps,
+    this.lastBreakIndex = -1,
+  }) : steps = steps ?? <RoutineStep>[];
+
+  factory RoutineChain.fromJson(Map<String, dynamic> json) {
+    return RoutineChain(
+      id: json['id'],
+      title: json['title'] ?? "",
+      steps: json['steps'] == null
+          ? <RoutineStep>[]
+          : (json['steps'] as List)
+              .map((item) => RoutineStep.fromJson(item))
+              .toList(),
+      lastBreakIndex: json['lastBreakIndex'] ?? -1,
+    );
+  }
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['id'] = id;
+    data['title'] = title;
+    data['steps'] = steps.map((item) => item.toJson()).toList();
+    data['lastBreakIndex'] = lastBreakIndex;
+    return data;
+  }
+
+  int get completedSteps {
+    return steps.where((step) => step.completed).length;
+  }
+
+  /// 0..1 — a partially run chain is recorded as partial, not as done.
+  double get partialCompletion {
+    if (steps.isEmpty) {
+      return 0;
+    }
+    return completedSteps / steps.length;
+  }
+
+  bool get complete {
+    return steps.isNotEmpty && completedSteps == steps.length;
+  }
+}
+
+class RoutineStep {
+  String? id;
+
+  String title;
+
+  int order;
+
+  int timerSeconds;
+
+  bool completed;
+
+  RoutineStep({
+    this.id,
+    this.title = "",
+    this.order = 0,
+    this.timerSeconds = 0,
+    this.completed = false,
+  });
+
+  factory RoutineStep.fromJson(Map<String, dynamic> json) {
+    return RoutineStep(
+      id: json['id'],
+      title: json['title'] ?? "",
+      order: json['order'] ?? 0,
+      timerSeconds: json['timerSeconds'] ?? 0,
+      completed: json['completed'] ?? false,
+    );
+  }
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['id'] = id;
+    data['title'] = title;
+    data['order'] = order;
+    data['timerSeconds'] = timerSeconds;
+    data['completed'] = completed;
+    return data;
+  }
+}