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
111 lines
3.1 KiB
Dart
111 lines
3.1 KiB
Dart
import '../../internal/application/CommitmentClass.dart';
|
|
|
|
/// The container a set of commitments belongs to — "Workout", "Thesis",
|
|
/// "Get the flat sorted". A goal owns its tasks through
|
|
/// [Commitment.parentId]; it never carries debt itself, because debt belongs
|
|
/// to the specific thing you said you would do, not the ambition behind it.
|
|
class Goal {
|
|
String? id;
|
|
|
|
String title;
|
|
|
|
String description;
|
|
|
|
String category;
|
|
|
|
/// The default class inherited by tasks created inside this goal.
|
|
CommitmentClass defaultClass;
|
|
|
|
DateTime? startDate;
|
|
|
|
/// Optional deadline for the goal as a whole.
|
|
DateTime? targetDate;
|
|
|
|
/// Colour accent, stored as a hex string so the goal reads consistently
|
|
/// wherever it appears.
|
|
String colourHex;
|
|
|
|
bool archived;
|
|
|
|
// ── Derived, supplied by the server ─────────────────────────────────────
|
|
|
|
int totalTasks;
|
|
|
|
int completedTasks;
|
|
|
|
int overdueTasks;
|
|
|
|
/// Debt accrued across every task under this goal.
|
|
double debtContribution;
|
|
|
|
Goal({
|
|
this.id,
|
|
this.title = "",
|
|
this.description = "",
|
|
this.category = "",
|
|
this.defaultClass = CommitmentClass.Standard,
|
|
this.startDate,
|
|
this.targetDate,
|
|
this.colourHex = "",
|
|
this.archived = false,
|
|
this.totalTasks = 0,
|
|
this.completedTasks = 0,
|
|
this.overdueTasks = 0,
|
|
this.debtContribution = 0,
|
|
});
|
|
|
|
factory Goal.fromJson(Map<String, dynamic> json) {
|
|
return Goal(
|
|
id: json['id'],
|
|
title: json['title'] ?? "",
|
|
description: json['description'] ?? "",
|
|
category: json['category'] ?? "",
|
|
defaultClass: getCommitmentClass(json['defaultClass']),
|
|
startDate: DateTime.tryParse(json['startDate'] ?? ""),
|
|
targetDate: DateTime.tryParse(json['targetDate'] ?? ""),
|
|
colourHex: json['colourHex'] ?? "",
|
|
archived: json['archived'] ?? false,
|
|
totalTasks: json['totalTasks'] ?? 0,
|
|
completedTasks: json['completedTasks'] ?? 0,
|
|
overdueTasks: json['overdueTasks'] ?? 0,
|
|
debtContribution: (json['debtContribution'] ?? 0).toDouble(),
|
|
);
|
|
}
|
|
|
|
Map<String, dynamic> toJson() {
|
|
final Map<String, dynamic> data = <String, dynamic>{};
|
|
data['id'] = id;
|
|
data['title'] = title;
|
|
data['description'] = description;
|
|
data['category'] = category;
|
|
data['defaultClass'] = defaultClass.name;
|
|
data['startDate'] = startDate?.toIso8601String();
|
|
data['targetDate'] = targetDate?.toIso8601String();
|
|
data['colourHex'] = colourHex;
|
|
data['archived'] = archived;
|
|
return data;
|
|
}
|
|
|
|
/// 0..1 across the goal's tasks.
|
|
double get progress {
|
|
if (totalTasks == 0) {
|
|
return 0;
|
|
}
|
|
return completedTasks / totalTasks;
|
|
}
|
|
|
|
/// A goal is in trouble when a meaningful share of its tasks are past their
|
|
/// windows, not merely because one slipped.
|
|
bool get slipping {
|
|
if (totalTasks == 0) {
|
|
return false;
|
|
}
|
|
return overdueTasks / totalTasks >= 0.34;
|
|
}
|
|
|
|
int get remainingTasks {
|
|
final int remaining = totalTasks - completedTasks;
|
|
return remaining > 0 ? remaining : 0;
|
|
}
|
|
}
|