Alpha/GroundedHelper
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Grounded Flutter frontend

Browse Source 
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
This commit is contained in:
alvocool
2026-07-27 09:11:17 +03:00
commit 16bff634b5
315 changed files with 19132 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
frontend/lib/Grounded/see/live/ConnectLiveTask.dart Normal file
View File

@@ -0,0 +1,8 @@
abstract class ConnectLiveTask {
void onCompleted();
/// Completion attempted before the required foreground time was reached.
void onTooEarly(int secondsRemaining);
void onAbandoned();
}

18
frontend/lib/Grounded/see/live/LiveTask.dart Normal file
View File

@@ -0,0 +1,18 @@
import 'package:flutter/material.dart';
import '../../about/external/data/Commitment.dart';
import 'LiveTaskState.dart';
class LiveTask extends StatefulWidget {
/// The commitment being run.
final Commitment commitment;
/// The goal it belongs to, shown as context in the runner and the ongoing
/// notification.
final String goalTitle;
const LiveTask({super.key, required this.commitment, this.goalTitle = ""});
@override
State<LiveTask> createState() => LiveTaskState();
}

456
frontend/lib/Grounded/see/live/LiveTaskState.dart Normal file
View File

@@ -0,0 +1,456 @@
import 'dart:async';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:stacked/stacked.dart';
import '../../about/external/data/LiveSession.dart';
import '../../about/internal/application/CommitmentClass.dart';
import '../../about/internal/application/NotificationType.dart';
import '../../about/internal/application/ProofType.dart';
import '../../about/internal/application/TextType.dart';
import '../../designs/Component.dart';
import '../../designs/buttons/Buttons.dart';
import '../../designs/input/InputFields.dart';
import '../../designs/text/Text.dart';
import '../../utils/Colors.dart';
import '../../utils/CommonUtils.dart';
import '../../utils/Validators.dart';
import 'ConnectLiveTask.dart';
import 'LiveTask.dart';
import 'ViewLiveTask.dart';
/// The full-screen runner. Deliberately the only thing on screen: a task you
/// are running is not a row in a list, it is the thing you are doing.
class LiveTaskState extends State<LiveTask>
with WidgetsBindingObserver
implements ConnectLiveTask {
ViewLiveTask? _model;
late LiveSession _session;
Timer? _ticker;
/// Drives the display only. The elapsed value itself is derived from
/// wall-clock, so a throttled ticker during screen-off cannot lose time.
int _tick = 0;
@override
void initState() {
super.initState();
WidgetsBinding.instance.addObserver(this);
_session = LiveSession(
commitmentId: widget.commitment.id ?? "",
title: widget.commitment.title,
goalTitle: widget.goalTitle,
startedAt: DateTime.now(),
requiredSeconds: widget.commitment.proofType == ProofType.Timer
? widget.commitment.proofTimerMinutes * 60
: 0,
);
_session.resume();
}
@override
Widget build(BuildContext context) {
return ViewModelBuilder<ViewLiveTask>.reactive(
viewModelBuilder: () => ViewLiveTask(context, this),
onViewModelReady: (viewModel) {
_model = viewModel;
_initiate();
},
builder: (context, viewModel, child) => PopScope(
// Leaving mid-run is a decision, not a back gesture.
canPop: false,
onPopInvokedWithResult: (didPop, result) {
if (!didPop) {
_onRequestExit();
}
},
child: AnnotatedRegion<SystemUiOverlayStyle>(
value: SystemUiOverlayStyle.light,
child: Scaffold(
backgroundColor: colorPrimaryDark,
body: SafeArea(child: _runnerView()),
),
),
),
);
}
void _initiate() {
_startTicker();
_model?.publishSession(_session);
}
void _startTicker() {
_ticker?.cancel();
_ticker = Timer.periodic(const Duration(seconds: 1), (timer) {
if (!mounted) {
return;
}
setState(() {
_tick = _tick + 1;
});
// Refresh the lock-screen notification every 5s rather than every tick,
// so the ongoing notification stays current without thrashing.
if (_tick % 5 == 0 && _session.running) {
_model?.publishSession(_session);
}
});
}
/// Backgrounding pauses the clock — that is what makes Timer proof mean
/// something. The count is kept and shown rather than hidden.
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
if (state == AppLifecycleState.resumed) {
if (!_session.running) {
setState(() {
_session.resume();
});
_model?.publishSession(_session);
}
return;
}
if (state == AppLifecycleState.paused ||
state == AppLifecycleState.hidden) {
if (_session.running) {
setState(() {
_session.pause();
_session.backgroundedCount = _session.backgroundedCount + 1;
});
_model?.publishSession(_session);
}
}
}
// ── Handlers ──────────────────────────────────────────────────────────────
void _onTogglePause() {
setState(() {
if (_session.running) {
_session.pause();
} else {
_session.resume();
}
});
_model?.publishSession(_session);
}
void _onFinish() {
_model?.complete(widget.commitment, _session);
}
void _onRequestExit() {
_model?.showApplicationNotification(
NotificationType.warning,
"Leave this running?",
_session.satisfied()
? "You have met the requirement. You can finish it properly instead of walking away."
: "You are ${formatClock(_session.remainingSeconds())} short. Leaving now logs nothing.",
true,
true,
null,
action: "Leave anyway",
positiveAction: () {
Navigator.pop(context);
_model?.clearSession();
Navigator.pop(context, false);
},
);
}
void _onAbandon() {
final TextEditingController reason = TextEditingController();
final GlobalKey<FormState> formKey = GlobalKey<FormState>();
showModalBottomSheet(
context: context,
isScrollControlled: true,
backgroundColor: Colors.transparent,
barrierColor: colorBlack.withValues(alpha: 0.7),
builder: (BuildContext sheetContext) {
return Padding(
padding: EdgeInsets.only(
bottom: MediaQuery.of(sheetContext).viewInsets.bottom,
),
child: Container(
decoration: BoxDecoration(
color: colorSheetBackground,
borderRadius: const BorderRadius.only(
topLeft: Radius.circular(28),
topRight: Radius.circular(28),
),
),
child: SingleChildScrollView(
padding: const EdgeInsets.fromLTRB(24, 24, 24, 32),
child: Form(
key: formKey,
child: Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
text("ABANDONING MID-RUN", 9, TextType.Bold,
color: colorStandingLockdown, letterSpacing: 1.2),
const SizedBox(height: 10),
text(widget.commitment.title, 24, TextType.Light,
color: colorPrimaryDark, height: 1.2),
const SizedBox(height: 16),
inputField(
"Reason",
reason,
hint: "Why is this stopping here?",
validator: Validators.excuse,
maxLines: 3,
),
const SizedBox(height: 20),
destructiveButton("Abandon", () {
if (formKey.currentState?.validate() != true) {
return;
}
Navigator.pop(sheetContext);
_model?.abandon(widget.commitment, reason.text.trim());
}),
const SizedBox(height: 8),
Center(
child: textButton("Keep going",
() => Navigator.pop(sheetContext), textSize: 13),
),
],
),
),
),
),
);
},
);
}
// ── Views ─────────────────────────────────────────────────────────────────
Widget _runnerView() {
final bool timed = _session.requiredSeconds > 0;
final bool satisfied = _session.satisfied();
return Padding(
padding: const EdgeInsets.symmetric(horizontal: 28, vertical: 20),
child: Column(
mainAxisSize: MainAxisSize.max,
crossAxisAlignment: CrossAxisAlignment.stretch,
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
_runnerHeader(),
_runnerClock(timed, satisfied),
_runnerControls(timed, satisfied),
],
),
);
}
Widget _runnerHeader() {
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Row(
children: [
Container(
width: 7,
height: 7,
decoration: BoxDecoration(
color: _session.running ? colorPositive : colorWarning,
shape: BoxShape.circle,
),
),
const SizedBox(width: 8),
text(
_session.running ? "IN PROGRESS" : "PAUSED",
9,
TextType.Bold,
color: colorWhite.withValues(alpha: 0.55),
letterSpacing: 1.4,
),
],
),
iconButton(
Icon(CupertinoIcons.xmark,
size: 15, color: colorWhite.withValues(alpha: 0.7)),
_onRequestExit,
),
],
),
const SizedBox(height: 28),
if (widget.goalTitle.isNotEmpty) ...[
text(widget.goalTitle.toUpperCase(), 10, TextType.Bold,
color: colorWhite.withValues(alpha: 0.40), letterSpacing: 1.4),
const SizedBox(height: 10),
],
text(widget.commitment.title, 34, TextType.Light,
color: colorWhite, height: 1.15),
const SizedBox(height: 16),
Row(
children: [
pill(
classLabel(widget.commitment.commitmentClass),
colorWhite,
colorWhite.withValues(alpha: 0.12),
textSize: 9,
),
const SizedBox(width: 8),
pill(
proofLabel(widget.commitment.proofType),
colorWhite.withValues(alpha: 0.75),
colorWhite.withValues(alpha: 0.08),
textSize: 9,
),
],
),
],
);
}
Widget _runnerClock(bool timed, bool satisfied) {
final int elapsed = _session.elapsedSeconds();
return Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.center,
children: [
text(
timed ? (satisfied ? "REQUIREMENT MET" : "REMAINING") : "ELAPSED",
9,
TextType.Bold,
color: satisfied
? colorPositive
: colorWhite.withValues(alpha: 0.40),
letterSpacing: 1.6,
),
const SizedBox(height: 18),
text(
timed && !satisfied
? formatClock(_session.remainingSeconds())
: formatClock(elapsed),
78,
TextType.Light,
color: colorWhite,
height: 1.0,
),
if (timed) ...[
const SizedBox(height: 28),
meter(
_session.progress(),
fill: satisfied ? colorPositive : colorWhite,
track: colorWhite.withValues(alpha: 0.12),
height: 5,
),
const SizedBox(height: 14),
text(
satisfied
? "You can finish this now."
: "Leaving the app pauses the clock.",
12,
TextType.Regular,
color: colorWhite.withValues(alpha: 0.45),
align: TextAlign.center,
),
],
if (_session.backgroundedCount > 0) ...[
const SizedBox(height: 18),
pill(
"Left ${_session.backgroundedCount}×",
colorWarning,
colorWarning.withValues(alpha: 0.12),
textSize: 9,
),
],
],
);
}
Widget _runnerControls(bool timed, bool satisfied) {
return Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
roundedCornerButton(
satisfied || !timed ? "Finish" : "Finish early",
_onFinish,
background: satisfied || !timed ? colorWhite : colorWhite.withValues(alpha: 0.14),
foreground: satisfied || !timed ? colorPrimaryDark : colorWhite,
icon: CupertinoIcons.checkmark,
),
const SizedBox(height: 10),
outlinedActionButton(
_session.running ? "Pause" : "Resume",
_onTogglePause,
foreground: colorWhite,
icon: _session.running
? CupertinoIcons.pause_fill
: CupertinoIcons.play_fill,
),
const SizedBox(height: 6),
Center(
child: textButton(
"Abandon this",
_onAbandon,
textSize: 12,
color: colorWhite.withValues(alpha: 0.45),
),
),
],
);
}
// ── ConnectLiveTask ───────────────────────────────────────────────────────
@override
void onCompleted() {
_model?.showApplicationNotification(
NotificationType.success,
widget.commitment.wouldBeLate ? "Late complete" : "Done",
widget.commitment.wouldBeLate
? "Recorded as a late complete — the window had already closed."
: "${formatClock(_session.elapsedSeconds())} of focused work, recorded.",
true,
true,
() {
Navigator.pop(context, true);
},
);
}
@override
void onTooEarly(int secondsRemaining) {
_model?.showApplicationNotification(
NotificationType.warning,
"Not yet",
"${formatClock(secondsRemaining)} still to go. The timer is the proof — finishing early would just be the checkbox again.",
true,
true,
null,
);
}
@override
void onAbandoned() {
Navigator.pop(context, true);
}
@override
void dispose() {
_ticker?.cancel();
WidgetsBinding.instance.removeObserver(this);
_model?.clearSession();
super.dispose();
}
}

75
frontend/lib/Grounded/see/live/ViewLiveTask.dart Normal file
View File

@@ -0,0 +1,75 @@
import '../../about/external/data/Commitment.dart';
import '../../about/external/data/LiveSession.dart';
import '../../about/external/initial/AbandonRequest.dart';
import '../../about/external/initial/CompletionRequest.dart';
import '../../configs/NotificationServiceConfig.dart';
import '../parent/ParentViewModel.dart';
import 'ConnectLiveTask.dart';
class ViewLiveTask extends ParentViewModel {
ConnectLiveTask connection;
ViewLiveTask(super.context, this.connection);
/// Mirrors the live state into the ongoing notification, so the run is
/// visible and controllable from the lock screen.
void publishSession(LiveSession session) {
LocalNotificationEngine.showSessionNotification(session);
}
void clearSession() {
LocalNotificationEngine.cancelSessionNotification();
}
/// Completion is refused until the foreground requirement is actually met.
/// The timer is the proof, so it cannot be talked past.
void complete(Commitment commitment, LiveSession session) async {
if (!session.satisfied()) {
connection.onTooEarly(session.remainingSeconds());
return;
}
if (!await hasNetwork(() => complete(commitment, session))) return;
showLoading("Recording");
try {
await getDataManager().completeCommitmentEntry(CompletionRequest(
commitmentId: commitment.id ?? "",
proofType: commitment.proofType.name,
timerSeconds: session.elapsedSeconds(),
));
clearSession();
closeLoading();
connection.onCompleted();
} catch (e) {
handleError(e, () => complete(commitment, session), () => dismissError(),
"Retry");
}
}
void abandon(Commitment commitment, String reason) async {
if (!await hasNetwork(() => abandon(commitment, reason))) return;
showLoading("Recording");
try {
await getDataManager().abandonCommitmentEntry(AbandonRequest(
commitmentId: commitment.id ?? "",
reason: reason,
));
clearSession();
closeLoading();
connection.onAbandoned();
} catch (e) {
handleError(
e, () => abandon(commitment, reason), () => dismissError(), "Retry");
}
}
}