Files
alvocool 16bff634b5 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
2026-07-27 09:11:17 +03:00

73 lines
2.1 KiB
Dart

/// A recurring excuse plus the pattern the app confronts you with, e.g.
/// "Too tired has appeared 14 times this month, 11 of them on gym days,
/// 9 of them after 7pm. Consider moving gym to morning."
class ExcuseCluster {
String? id;
String label;
int occurrences;
/// Weekday histogram (1 = Monday) — where this excuse concentrates.
Map<int, int> byWeekday;
/// Hour-of-day histogram — when it concentrates.
Map<int, int> byHour;
/// The category this excuse most often attaches to.
String dominantCategory;
/// The confrontation copy rendered to the user.
String insight;
ExcuseCluster({
this.id,
this.label = "",
this.occurrences = 0,
Map<int, int>? byWeekday,
Map<int, int>? byHour,
this.dominantCategory = "",
this.insight = "",
}) : byWeekday = byWeekday ?? <int, int>{},
byHour = byHour ?? <int, int>{};
factory ExcuseCluster.fromJson(Map<String, dynamic> json) {
final Map<int, int> weekdays = <int, int>{};
if (json['byWeekday'] != null) {
(json['byWeekday'] as Map<String, dynamic>).forEach((key, value) {
weekdays[int.tryParse(key) ?? 1] = value ?? 0;
});
}
final Map<int, int> hours = <int, int>{};
if (json['byHour'] != null) {
(json['byHour'] as Map<String, dynamic>).forEach((key, value) {
hours[int.tryParse(key) ?? 0] = value ?? 0;
});
}
return ExcuseCluster(
id: json['id'],
label: json['label'] ?? "",
occurrences: json['occurrences'] ?? 0,
byWeekday: weekdays,
byHour: hours,
dominantCategory: json['dominantCategory'] ?? "",
insight: json['insight'] ?? "",
);
}
Map<String, dynamic> toJson() {
final Map<String, dynamic> data = <String, dynamic>{};
data['id'] = id;
data['label'] = label;
data['occurrences'] = occurrences;
data['byWeekday'] =
byWeekday.map((key, value) => MapEntry(key.toString(), value));
data['byHour'] = byHour.map((key, value) => MapEntry(key.toString(), value));
data['dominantCategory'] = dominantCategory;
data['insight'] = insight;
return data;
}
}