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
457 lines
14 KiB
Dart
457 lines
14 KiB
Dart
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();
|
||
}
|
||
}
|