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/pages/request/CommitmentsRequest.dart

@@ -0,0 +1,21 @@
+import 'PageAndSort.dart';
+
+class CommitmentsRequest {
+  PageAndSort? query;
+
+  /// ISO day the plan is being requested for; empty means today.
+  String day;
+
+  /// Filter by status name; empty means all.
+  String status;
+
+  CommitmentsRequest({this.query, this.day = "", this.status = ""});
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['query'] = query?.toJson();
+    data['day'] = day;
+    data['status'] = status;
+    return data;
+  }
+}

frontend/lib/Grounded/about/external/data/pages/request/HistoryRequest.dart

@@ -0,0 +1,14 @@
+import 'PageAndSort.dart';
+
+/// Every list endpoint takes this shape. Never inline flat sort/page fields.
+class HistoryRequest {
+  PageAndSort? query;
+
+  HistoryRequest({this.query});
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['query'] = query?.toJson();
+    return data;
+  }
+}

frontend/lib/Grounded/about/external/data/pages/request/PageAndSort.dart

@@ -0,0 +1,17 @@
+import 'Pageable.dart';
+import 'Sort.dart';
+
+class PageAndSort {
+  Sort? sort;
+
+  Pageable? page;
+
+  PageAndSort({this.sort, this.page});
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['sort'] = sort?.toJson();
+    data['page'] = page?.toJson();
+    return data;
+  }
+}

frontend/lib/Grounded/about/external/data/pages/request/Pageable.dart

@@ -0,0 +1,20 @@
+class Pageable {
+  int offset;
+
+  int pageNumber;
+
+  int pageSize;
+
+  int paged;
+
+  Pageable(this.offset, this.pageNumber, this.pageSize, this.paged);
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['offset'] = offset;
+    data['pageNumber'] = pageNumber;
+    data['pageSize'] = pageSize;
+    data['paged'] = paged;
+    return data;
+  }
+}

frontend/lib/Grounded/about/external/data/pages/request/Sort.dart

@@ -0,0 +1,14 @@
+class Sort {
+  String direction;
+
+  String field;
+
+  Sort(this.direction, this.field);
+
+  Map<String, dynamic> toJson() {
+    final Map<String, dynamic> data = <String, dynamic>{};
+    data['direction'] = direction;
+    data['field'] = field;
+    return data;
+  }
+}

frontend/lib/Grounded/about/external/data/pages/response/CommitmentEventPage.dart

@@ -0,0 +1,47 @@
+import '../../CommitmentEvent.dart';
+
+class CommitmentEventPage {
+  int number;
+
+  int size;
+
+  int totalElements;
+
+  int totalPages;
+
+  int numberOfElements;
+
+  bool first;
+
+  bool last;
+
+  List<CommitmentEvent> content;
+
+  CommitmentEventPage({
+    this.number = 0,
+    this.size = 0,
+    this.totalElements = 0,
+    this.totalPages = 0,
+    this.numberOfElements = 0,
+    this.first = true,
+    this.last = true,
+    List<CommitmentEvent>? content,
+  }) : content = content ?? <CommitmentEvent>[];
+
+  factory CommitmentEventPage.fromJson(Map<String, dynamic> json) {
+    return CommitmentEventPage(
+      number: json['number'] ?? 0,
+      size: json['size'] ?? 0,
+      totalElements: json['totalElements'] ?? 0,
+      totalPages: json['totalPages'] ?? 0,
+      numberOfElements: json['numberOfElements'] ?? 0,
+      first: json['first'] ?? true,
+      last: json['last'] ?? true,
+      content: json['content'] == null
+          ? <CommitmentEvent>[]
+          : (json['content'] as List)
+              .map((item) => CommitmentEvent.fromJson(item))
+              .toList(),
+    );
+  }
+}

frontend/lib/Grounded/about/external/data/pages/response/CommitmentPage.dart

@@ -0,0 +1,47 @@
+import '../../Commitment.dart';
+
+class CommitmentPage {
+  int number;
+
+  int size;
+
+  int totalElements;
+
+  int totalPages;
+
+  int numberOfElements;
+
+  bool first;
+
+  bool last;
+
+  List<Commitment> content;
+
+  CommitmentPage({
+    this.number = 0,
+    this.size = 0,
+    this.totalElements = 0,
+    this.totalPages = 0,
+    this.numberOfElements = 0,
+    this.first = true,
+    this.last = true,
+    List<Commitment>? content,
+  }) : content = content ?? <Commitment>[];
+
+  factory CommitmentPage.fromJson(Map<String, dynamic> json) {
+    return CommitmentPage(
+      number: json['number'] ?? 0,
+      size: json['size'] ?? 0,
+      totalElements: json['totalElements'] ?? 0,
+      totalPages: json['totalPages'] ?? 0,
+      numberOfElements: json['numberOfElements'] ?? 0,
+      first: json['first'] ?? true,
+      last: json['last'] ?? true,
+      content: json['content'] == null
+          ? <Commitment>[]
+          : (json['content'] as List)
+              .map((item) => Commitment.fromJson(item))
+              .toList(),
+    );
+  }
+}

frontend/lib/Grounded/about/external/data/pages/response/SessionLogPage.dart

@@ -0,0 +1,47 @@
+import '../../SessionLog.dart';
+
+class SessionLogPage {
+  int number;
+
+  int size;
+
+  int totalElements;
+
+  int totalPages;
+
+  int numberOfElements;
+
+  bool first;
+
+  bool last;
+
+  List<SessionLog> content;
+
+  SessionLogPage({
+    this.number = 0,
+    this.size = 0,
+    this.totalElements = 0,
+    this.totalPages = 0,
+    this.numberOfElements = 0,
+    this.first = true,
+    this.last = true,
+    List<SessionLog>? content,
+  }) : content = content ?? <SessionLog>[];
+
+  factory SessionLogPage.fromJson(Map<String, dynamic> json) {
+    return SessionLogPage(
+      number: json['number'] ?? 0,
+      size: json['size'] ?? 0,
+      totalElements: json['totalElements'] ?? 0,
+      totalPages: json['totalPages'] ?? 0,
+      numberOfElements: json['numberOfElements'] ?? 0,
+      first: json['first'] ?? true,
+      last: json['last'] ?? true,
+      content: json['content'] == null
+          ? <SessionLog>[]
+          : (json['content'] as List)
+              .map((item) => SessionLog.fromJson(item))
+              .toList(),
+    );
+  }
+}