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,93 @@
import '../../about/external/data/Commitment.dart';
import '../../about/external/data/pages/request/CommitmentsRequest.dart';
import '../../about/external/data/pages/request/PageAndSort.dart';
import '../../about/external/data/pages/request/Pageable.dart';
import '../../about/external/data/pages/request/Sort.dart';
import '../../about/external/data/pages/response/CommitmentPage.dart';
import '../../about/external/initial/CommitmentRequest.dart';
import '../../about/internal/application/CapacityProfile.dart';
import '../../utils/CapacityEngine.dart';
import '../parent/ParentViewModel.dart';
import 'ConnectNewCommitment.dart';
class ViewNewCommitment extends ParentViewModel {
ConnectNewCommitment connection;
ViewNewCommitment(super.context, this.connection);
/// Surfaces the learned multiplier for the category so the estimate field
/// can show what the app actually expects, rather than silently overriding.
void resolveMultiplier(String category) async {
final CapacityProfile profile =
await getDataManager().getCapacityProfile();
connection.onMultiplierResolved(profile.multiplierFor(category));
}
/// The capacity gate. Chronic overdue is usually overcommitment misdiagnosed
/// as laziness, so the plan is checked against what history says actually
/// gets done before anything is accepted.
void save(CommitmentRequest request, Commitment candidate) async {
if (!await hasNetwork(() => save(request, candidate))) return;
showLoading("Checking your day");
try {
final DateTime day = candidate.dueStart ?? DateTime.now();
final response = await getDataManager().getTodayPlan(CommitmentsRequest(
day: day.toIso8601String(),
query: PageAndSort(
sort: Sort('asc', 'dueStart'),
page: Pageable(0, 0, 100, 0),
),
));
final CommitmentPage page = CommitmentPage.fromJson(response.data);
final CapacityProfile profile =
await getDataManager().getCapacityProfile();
final List<Commitment> proposed = <Commitment>[
...page.content,
candidate,
];
final CapacityVerdict verdict =
CapacityEngine.check(proposed, profile, day.weekday);
if (verdict.blocked) {
closeLoading();
connection.onCapacityBlocked(verdict);
return;
}
await getDataManager().saveCommitmentEntry(request);
closeLoading();
connection.onSaved();
} catch (e) {
handleError(
e, () => save(request, candidate), () => dismissError(), "Retry");
}
}
/// Saving past a capacity block, which is only reachable after the user has
/// seen exactly how much they are over by.
void saveAnyway(CommitmentRequest request) async {
if (!await hasNetwork(() => saveAnyway(request))) return;
showLoading("Saving");
try {
await getDataManager().saveCommitmentEntry(request);
closeLoading();
connection.onSaved();
} catch (e) {
handleError(e, () => saveAnyway(request), () => dismissError(), "Retry");
}
}
}