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/see/system/sessionexpired/ConnectSessionExpired.dart

@@ -0,0 +1,3 @@
+abstract class ConnectSessionExpired {
+  void launchLogin();
+}

frontend/lib/Grounded/see/system/sessionexpired/SessionExpired.dart

@@ -0,0 +1,10 @@
+import 'package:flutter/material.dart';
+
+import 'SessionExpiredState.dart';
+
+class SessionExpired extends StatefulWidget {
+  const SessionExpired({super.key});
+
+  @override
+  State<SessionExpired> createState() => SessionExpiredState();
+}

frontend/lib/Grounded/see/system/sessionexpired/SessionExpiredState.dart

@@ -0,0 +1,117 @@
+import 'package:flutter/cupertino.dart';
+import 'package:flutter/material.dart';
+import 'package:stacked/stacked.dart';
+
+import '../../../about/internal/application/NavigatorType.dart';
+import '../../../about/internal/application/TextType.dart';
+import '../../../configs/Navigator.dart';
+import '../../../designs/Responsive.dart';
+import '../../../designs/buttons/Buttons.dart';
+import '../../../designs/text/Text.dart';
+import '../../../utils/Colors.dart';
+import '../../login/Login.dart';
+import 'ConnectSessionExpired.dart';
+import 'SessionExpired.dart';
+import 'ViewSessionExpired.dart';
+
+class SessionExpiredState extends State<SessionExpired>
+    implements ConnectSessionExpired {
+  ViewSessionExpired? _model;
+
+  @override
+  Widget build(BuildContext context) {
+    return ViewModelBuilder<ViewSessionExpired>.reactive(
+      viewModelBuilder: () => ViewSessionExpired(context, this),
+      onViewModelReady: (viewModel) {
+        _model = viewModel;
+        _initiate();
+      },
+      builder: (context, viewModel, child) => PopScope(
+        canPop: false,
+        child: Scaffold(
+          backgroundColor: colorPrimaryDark,
+          body: LayoutBuilder(
+            builder: (BuildContext context, BoxConstraints constraints) {
+              return Responsive(
+                mobile: _mobileView(constraints),
+                tablet: _mobileView(constraints),
+                desktop: _mobileView(constraints),
+              );
+            },
+          ),
+        ),
+      ),
+    );
+  }
+
+  void _initiate() {}
+
+  void _onSignIn() {
+    _model?.signOut();
+  }
+
+  Widget _mobileView(BoxConstraints constraints) {
+    return SafeArea(
+      child: Padding(
+        padding: const EdgeInsets.symmetric(horizontal: 28, vertical: 32),
+        child: Column(
+          mainAxisSize: MainAxisSize.max,
+          crossAxisAlignment: CrossAxisAlignment.start,
+          mainAxisAlignment: MainAxisAlignment.spaceBetween,
+          children: [
+            text("GROUNDED", 10, TextType.Bold,
+                color: colorWhite.withValues(alpha: 0.45), letterSpacing: 2.0),
+            Column(
+              mainAxisSize: MainAxisSize.min,
+              crossAxisAlignment: CrossAxisAlignment.start,
+              children: [
+                Container(
+                  width: 60,
+                  height: 60,
+                  alignment: Alignment.center,
+                  decoration: BoxDecoration(
+                    color: colorWhite.withValues(alpha: 0.10),
+                    borderRadius: BorderRadius.circular(18),
+                  ),
+                  child: Icon(CupertinoIcons.lock_fill,
+                      size: 24, color: colorWhite),
+                ),
+                const SizedBox(height: 28),
+                text("SESSION", 10, TextType.Bold,
+                    color: colorWhite.withValues(alpha: 0.45),
+                    letterSpacing: 1.2),
+                const SizedBox(height: 10),
+                text("Your session has ended.", 34, TextType.Light,
+                    color: colorWhite, height: 1.15),
+                const SizedBox(height: 14),
+                text(
+                  "Sign in again to pick up where you left off. Your record is intact — nothing was cleared while you were away.",
+                  14,
+                  TextType.Regular,
+                  color: colorWhite.withValues(alpha: 0.60),
+                  height: 1.55,
+                ),
+              ],
+            ),
+            SizedBox(
+              width: double.infinity,
+              child: roundedCornerButton(
+                "Sign in",
+                _onSignIn,
+                background: colorWhite,
+                foreground: colorPrimaryDark,
+                icon: CupertinoIcons.arrow_right,
+              ),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+
+  @override
+  void launchLogin() {
+    GroundedNavigation()
+        .navigateToPage(NavigatorType.makeNewMain, const Login(), context);
+  }
+}

frontend/lib/Grounded/see/system/sessionexpired/ViewSessionExpired.dart

@@ -0,0 +1,18 @@
+import '../../../about/internal/application/MeDescription.dart';
+import '../../parent/ParentViewModel.dart';
+import 'ConnectSessionExpired.dart';
+
+class ViewSessionExpired extends ParentViewModel {
+  ConnectSessionExpired connection;
+
+  ViewSessionExpired(super.context, this.connection);
+
+  /// Clears the stored session before sending the user back to login, so an
+  /// expired token can never be replayed.
+  void signOut() async {
+    await getDataManager()
+        .setMyDescription(MeDescription(id: "", name: "", token: ""));
+
+    connection.launchLogin();
+  }
+}