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
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

View File

@@ -0,0 +1,39 @@
/// Configurable limits with sane defaults. These are the dials the user is
/// allowed to turn — everything else about enforcement is fixed.
class Thresholds {
/// Hard cap on unresolved overdue items.
static const int maxOpenOverdue = 5;
/// After this, a task cannot be deferred again — only completed or
/// explicitly abandoned.
static const int maxDeferralsPerTask = 2;
/// Minimum excuse length. Free text, no template buttons; the friction is
/// the point.
static const int minExcuseLength = 15;
/// Standing thresholds on the debt score.
static const double warnedThreshold = 12;
static const double groundedThreshold = 30;
static const double lockdownThreshold = 60;
/// Missed non-negotiables that force Grounded regardless of score.
static const int nonNegotiableMissesForGrounded = 3;
/// Amnesty tokens granted per month.
static const int amnestyTokensPerMonth = 3;
/// Capacity check headroom — plan against 85% of what you historically get
/// done, not 100%.
static const double capacityHeadroom = 0.85;
/// Days after which an untouched elective auto-archives.
static const int electiveArchiveDays = 21;
/// Snooze tax: each snooze shortens the next interval instead of extending
/// it, and the third becomes a full-screen alarm.
static const List<int> snoozeLadderMinutes = <int>[10, 5, 2];
/// Minutes a push can go unacknowledged before SMS fallback fires.
static const int smsFallbackMinutes = 20;
}