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,508 @@
import 'package:dio/dio.dart';
import '../about/external/data/pages/request/CommitmentsRequest.dart';
import '../about/external/data/pages/request/HistoryRequest.dart';
import '../about/external/initial/AbandonRequest.dart';
import '../about/external/initial/AmnestyRequest.dart';
import '../about/external/initial/CommitmentRequest.dart';
import '../about/external/initial/CompletionRequest.dart';
import '../about/external/initial/DeferralRequest.dart';
import '../about/external/initial/DeviceRequest.dart';
import '../about/external/initial/GoalRequest.dart';
import '../about/external/initial/IdRequest.dart';
import '../about/external/initial/LoginData.dart';
import '../about/external/initial/ReportCardRequest.dart';
import '../about/external/initial/SessionLogRequest.dart';
import '../about/external/initial/SickModeRequest.dart';
import '../about/external/initial/ToneRequest.dart';
import '../about/internal/application/MeDescription.dart';
import '../about/internal/application/Pair.dart';
import '../configs/Env.dart';
import '../memory/ConnectInternalMemory.dart';
import 'CommsDirections.dart';
import 'ConnectComms.dart';
class Comms implements ConnectComms {
Dio dio = Dio();
ConnectInternalMemory helper;
Comms(this.helper);
/// Builds the identity headers and resolves the URL. Headers are reset on
/// every call so a stale Authorization can never leak into an auth-flow
/// request.
Future<Pair> getRequestHeaders(String url, String urlData) async {
dio.options.headers = <String, dynamic>{};
MeDescription data = await helper.getMyDescription();
if (data.token.isNotEmpty && url != deviceToken) {
dio.options.headers["Authorization"] = "Bearer ${data.token}";
}
if (url == logoutRequest) {
dio.options.headers.remove("Authorization");
}
dio.options.contentType = Headers.jsonContentType;
dio.options.responseType = ResponseType.json;
// The backend identity contract: what = encrypted access code,
// whom = encrypted device id, version = the app build.
dio.options.headers["what"] = data.name;
dio.options.headers["whom"] = data.id;
dio.options.headers["version"] = localisedAppVersion;
return Pair("${_routeFor(url)}$url$urlData", dio.options.headers);
}
/// Auth-flow paths go to Prospect, training paths to Training, everything
/// else to the Discipline service.
String _routeFor(String url) {
if (url == deviceReg ||
url == deviceToken ||
url == loginUser ||
url == logoutRequest ||
url == aboutMe ||
url == accountRecovery ||
url.startsWith('InAugurate/')) {
return prospectRoute;
}
if (url.startsWith('Program/') ||
url.startsWith('Session/') ||
url.startsWith('Metrics/')) {
return trainingRoute;
}
return disciplineRoute;
}
// ── Auth ──────────────────────────────────────────────────────────────────
@override
Future<Response> registerDevice(DeviceRequest request) async {
Pair navigation = await getRequestHeaders(deviceReg, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> registerDeviceToken(String token) async {
Pair navigation = await getRequestHeaders(deviceToken, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: <String, dynamic>{"token": token});
}
@override
Future<Response> login(LoginData request) async {
Pair navigation = await getRequestHeaders(loginUser, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> logout() async {
Pair navigation = await getRequestHeaders(logoutRequest, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
@override
Future<Response> me() async {
Pair navigation = await getRequestHeaders(aboutMe, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
// ── Goals ─────────────────────────────────────────────────────────────────
@override
Future<Response> getMyGoals(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(myGoals, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> saveGoalEntry(GoalRequest request) async {
Pair navigation = await getRequestHeaders(saveGoal, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getGoalTasks(IdRequest request) async {
Pair navigation = await getRequestHeaders(goalTasks, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> archiveGoalEntry(IdRequest request) async {
Pair navigation = await getRequestHeaders(archiveGoal, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Commitments ───────────────────────────────────────────────────────────
@override
Future<Response> getTodayPlan(CommitmentsRequest request) async {
Pair navigation = await getRequestHeaders(todayPlan, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getMyCommitments(CommitmentsRequest request) async {
Pair navigation = await getRequestHeaders(myCommitments, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getOverdueQueue(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(overdueQueue, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> saveCommitmentEntry(CommitmentRequest request) async {
Pair navigation = await getRequestHeaders(saveCommitment, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> updateCommitmentEntry(CommitmentRequest request) async {
Pair navigation = await getRequestHeaders(updateCommitment, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> deleteCommitmentEntry(IdRequest request) async {
Pair navigation = await getRequestHeaders(deleteCommitment, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> completeCommitmentEntry(CompletionRequest request) async {
Pair navigation = await getRequestHeaders(completeCommitment, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> deferCommitmentEntry(DeferralRequest request) async {
Pair navigation = await getRequestHeaders(deferCommitment, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> abandonCommitmentEntry(AbandonRequest request) async {
Pair navigation = await getRequestHeaders(abandonCommitment, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getCommitmentHistory(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(commitmentHistory, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getCommitmentEvents(IdRequest request) async {
Pair navigation = await getRequestHeaders(commitmentEvents, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Capacity ──────────────────────────────────────────────────────────────
@override
Future<Response> checkCapacity(CommitmentsRequest request) async {
Pair navigation = await getRequestHeaders(capacityCheck, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getCapacityProfileEntry() async {
Pair navigation = await getRequestHeaders(capacityProfilePath, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
// ── Debt & standing ───────────────────────────────────────────────────────
@override
Future<Response> getDebtSummary() async {
Pair navigation = await getRequestHeaders(debtSummary, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
@override
Future<Response> getDebtLedger(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(debtLedger, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getDebtTrend(ReportCardRequest request) async {
Pair navigation = await getRequestHeaders(debtTrendPath, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getStanding() async {
Pair navigation = await getRequestHeaders(standingPath, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
@override
Future<Response> getStandingHistory(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(standingHistory, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Excuses ───────────────────────────────────────────────────────────────
@override
Future<Response> getExcuseClusters(ReportCardRequest request) async {
Pair navigation = await getRequestHeaders(excuseClusters, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Proof ─────────────────────────────────────────────────────────────────
@override
Future<Response> uploadPhotoProof(FormData request) async {
Pair navigation = await getRequestHeaders(uploadProofPhoto, "");
dio.options.headers = navigation.value;
dio.options.contentType = Headers.multipartFormDataContentType;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> submitTimerProofEntry(CompletionRequest request) async {
Pair navigation = await getRequestHeaders(submitTimerProof, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> submitLocationProofEntry(CompletionRequest request) async {
Pair navigation = await getRequestHeaders(submitLocationProof, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Guardrails ────────────────────────────────────────────────────────────
@override
Future<Response> spendAmnestyToken(AmnestyRequest request) async {
Pair navigation = await getRequestHeaders(spendAmnesty, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getAmnestyBalance() async {
Pair navigation = await getRequestHeaders(amnestyBalance, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
@override
Future<Response> updateSickMode(SickModeRequest request) async {
Pair navigation = await getRequestHeaders(setSickMode, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> checkDistress() async {
Pair navigation = await getRequestHeaders(distressCheck, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
@override
Future<Response> updateTone(ToneRequest request) async {
Pair navigation = await getRequestHeaders(setTone, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Habits & routines ─────────────────────────────────────────────────────
@override
Future<Response> getMyHabits(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(myHabits, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> saveHabitEntry(Map<String, dynamic> request) async {
Pair navigation = await getRequestHeaders(saveHabit, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> logHabitEntry(IdRequest request) async {
Pair navigation = await getRequestHeaders(logHabit, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getKeystoneHabits() async {
Pair navigation = await getRequestHeaders(keystoneHabits, "");
dio.options.headers = navigation.value;
return await dio.get(navigation.key);
}
@override
Future<Response> getMyRoutines(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(myRoutines, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> logRoutineChainEntry(Map<String, dynamic> request) async {
Pair navigation = await getRequestHeaders(logRoutineChain, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Training ──────────────────────────────────────────────────────────────
@override
Future<Response> getMyPrograms(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(myPrograms, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> saveProgramEntry(Map<String, dynamic> request) async {
Pair navigation = await getRequestHeaders(saveProgram, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> activateProgramEntry(IdRequest request) async {
Pair navigation = await getRequestHeaders(activateProgram, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getProgramSessions(IdRequest request) async {
Pair navigation = await getRequestHeaders(programSessions, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> startSessionEntry(IdRequest request) async {
Pair navigation = await getRequestHeaders(startSession, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> saveSessionLogEntry(SessionLogRequest request) async {
Pair navigation = await getRequestHeaders(saveSessionLog, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getSessionHistory(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(sessionHistory, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getLastSessionFor(IdRequest request) async {
Pair navigation = await getRequestHeaders(lastSessionFor, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getWeeklyVolume(ReportCardRequest request) async {
Pair navigation = await getRequestHeaders(weeklyVolume, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getContactVolume(ReportCardRequest request) async {
Pair navigation = await getRequestHeaders(contactVolume, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getPersonalRecords(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(personalRecords, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Report card ───────────────────────────────────────────────────────────
@override
Future<Response> getWeeklyReportCard(ReportCardRequest request) async {
Pair navigation = await getRequestHeaders(weeklyReportCard, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> getMonthlyReportCard(ReportCardRequest request) async {
Pair navigation = await getRequestHeaders(monthlyReportCard, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
// ── Notifications ─────────────────────────────────────────────────────────
@override
Future<Response> getMyNotifications(HistoryRequest request) async {
Pair navigation = await getRequestHeaders(myNotifications, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
@override
Future<Response> acknowledgeNudgeEntry(IdRequest request) async {
Pair navigation = await getRequestHeaders(acknowledgeNudge, "");
dio.options.headers = navigation.value;
return await dio.post(navigation.key, data: request);
}
}

View File

@@ -0,0 +1,174 @@
import '../configs/Env.dart';
/// The single switch between local and production.
bool isProd = false;
// ── Service routes ────────────────────────────────────────────────────────────
String prospectRoute = isProd
? "$groundedRouteProd/Prospect/"
: "$groundedRouteLocal:40003/Prospect/";
String disciplineRoute = isProd
? "$groundedRouteProd/Discipline/"
: "$groundedRouteLocal:40005/Discipline/";
String trainingRoute = isProd
? "$groundedRouteProd/Training/"
: "$groundedRouteLocal:40004/Training/";
// ── Auth flow (Prospect) ──────────────────────────────────────────────────────
String deviceReg = "Device/NewDevice";
String deviceToken = 'Device/Note';
String loginUser = 'User/Login';
String logoutRequest = 'User/Logout';
String aboutMe = 'User/Me';
String accountRecovery = "User/RecoverRequest";
String inaugurateProspect = 'InAugurate/Prospect';
String inaugurateTerms = 'InAugurate/Terms';
String registerCredentialsLocation = 'InAugurate/UserAndPass';
// ── Goals ─────────────────────────────────────────────────────────────────────
String myGoals = 'Goal/Mine';
String saveGoal = 'Goal/Save';
String goalTasks = 'Goal/Tasks';
String archiveGoal = 'Goal/Archive';
// ── Commitments ───────────────────────────────────────────────────────────────
String myCommitments = 'Commitment/Mine';
String todayPlan = 'Commitment/Today';
String overdueQueue = 'Commitment/Overdue';
String saveCommitment = 'Commitment/Save';
String updateCommitment = 'Commitment/Update';
String deleteCommitment = 'Commitment/Delete';
String completeCommitment = 'Commitment/Complete';
String deferCommitment = 'Commitment/Defer';
String abandonCommitment = 'Commitment/Abandon';
String commitmentHistory = 'Commitment/History';
String commitmentEvents = 'Commitment/Events';
// ── Capacity ──────────────────────────────────────────────────────────────────
String capacityCheck = 'Capacity/Check';
String capacityProfilePath = 'Capacity/Profile';
// ── Debt & standing ───────────────────────────────────────────────────────────
String debtSummary = 'Debt/Summary';
String debtLedger = 'Debt/Ledger';
String debtTrendPath = 'Debt/Trend';
String standingPath = 'Standing/Current';
String standingHistory = 'Standing/History';
// ── Excuses ───────────────────────────────────────────────────────────────────
String excuseClusters = 'Excuse/Clusters';
String excuseInsights = 'Excuse/Insights';
// ── Proof ─────────────────────────────────────────────────────────────────────
String uploadProofPhoto = 'Proof/PhotoUpload';
String submitTimerProof = 'Proof/Timer';
String submitLocationProof = 'Proof/Location';
String requestWitnessProof = 'Proof/Witness';
// ── Guardrails ────────────────────────────────────────────────────────────────
String spendAmnesty = 'Guardrail/Amnesty';
String amnestyBalance = 'Guardrail/AmnestyBalance';
String setSickMode = 'Guardrail/SickMode';
String distressCheck = 'Guardrail/Distress';
String setTone = 'Guardrail/Tone';
// ── Habits & routines ─────────────────────────────────────────────────────────
String myHabits = 'Habit/Mine';
String saveHabit = 'Habit/Save';
String logHabit = 'Habit/Log';
String keystoneHabits = 'Habit/Keystone';
String myRoutines = 'Routine/Mine';
String saveRoutine = 'Routine/Save';
String logRoutineChain = 'Routine/Log';
// ── Training ──────────────────────────────────────────────────────────────────
String myPrograms = 'Program/Mine';
String saveProgram = 'Program/Save';
String activateProgram = 'Program/Activate';
String programSessions = 'Program/Sessions';
String saveSessionTemplate = 'Program/SaveTemplate';
String startSession = 'Session/Start';
String saveSessionLog = 'Session/Save';
String sessionHistory = 'Session/History';
String lastSessionFor = 'Session/Last';
String weeklyVolume = 'Session/WeeklyVolume';
String contactVolume = 'Session/Contacts';
String personalRecords = 'Session/Records';
String bodyMetrics = 'Metrics/Body';
String saveBodyMetric = 'Metrics/SaveBody';
// ── Report card ───────────────────────────────────────────────────────────────
String weeklyReportCard = 'Report/Weekly';
String monthlyReportCard = 'Report/Monthly';
String reportHistory = 'Report/History';
// ── Notifications ─────────────────────────────────────────────────────────────
String myNotifications = 'Notifications/Mine';
String readNotification = 'Notifications/Read';
String acknowledgeNudge = 'Notifications/Acknowledge';
// ── Partners ──────────────────────────────────────────────────────────────────
String myPartners = 'Partner/Mine';
String invitePartner = 'Partner/Invite';
String partnerPolicy = 'Partner/Policy';

View File

@@ -0,0 +1,145 @@
import 'package:dio/dio.dart';
import '../about/external/data/pages/request/CommitmentsRequest.dart';
import '../about/external/data/pages/request/HistoryRequest.dart';
import '../about/external/initial/AbandonRequest.dart';
import '../about/external/initial/AmnestyRequest.dart';
import '../about/external/initial/CommitmentRequest.dart';
import '../about/external/initial/CompletionRequest.dart';
import '../about/external/initial/DeferralRequest.dart';
import '../about/external/initial/DeviceRequest.dart';
import '../about/external/initial/GoalRequest.dart';
import '../about/external/initial/IdRequest.dart';
import '../about/external/initial/LoginData.dart';
import '../about/external/initial/ReportCardRequest.dart';
import '../about/external/initial/SessionLogRequest.dart';
import '../about/external/initial/SickModeRequest.dart';
import '../about/external/initial/ToneRequest.dart';
abstract class ConnectComms {
// ── Auth ────────────────────────────────────────────────────────────────
Future<Response> registerDevice(DeviceRequest request);
Future<Response> registerDeviceToken(String token);
Future<Response> login(LoginData request);
Future<Response> logout();
Future<Response> me();
// ── Goals ───────────────────────────────────────────────────────────────
Future<Response> getMyGoals(HistoryRequest request);
Future<Response> saveGoalEntry(GoalRequest request);
Future<Response> getGoalTasks(IdRequest request);
Future<Response> archiveGoalEntry(IdRequest request);
// ── Commitments ─────────────────────────────────────────────────────────
Future<Response> getTodayPlan(CommitmentsRequest request);
Future<Response> getMyCommitments(CommitmentsRequest request);
Future<Response> getOverdueQueue(HistoryRequest request);
Future<Response> saveCommitmentEntry(CommitmentRequest request);
Future<Response> updateCommitmentEntry(CommitmentRequest request);
Future<Response> deleteCommitmentEntry(IdRequest request);
Future<Response> completeCommitmentEntry(CompletionRequest request);
Future<Response> deferCommitmentEntry(DeferralRequest request);
Future<Response> abandonCommitmentEntry(AbandonRequest request);
Future<Response> getCommitmentHistory(HistoryRequest request);
Future<Response> getCommitmentEvents(IdRequest request);
// ── Capacity ────────────────────────────────────────────────────────────
Future<Response> checkCapacity(CommitmentsRequest request);
Future<Response> getCapacityProfileEntry();
// ── Debt & standing ─────────────────────────────────────────────────────
Future<Response> getDebtSummary();
Future<Response> getDebtLedger(HistoryRequest request);
Future<Response> getDebtTrend(ReportCardRequest request);
Future<Response> getStanding();
Future<Response> getStandingHistory(HistoryRequest request);
// ── Excuses ─────────────────────────────────────────────────────────────
Future<Response> getExcuseClusters(ReportCardRequest request);
// ── Proof ───────────────────────────────────────────────────────────────
Future<Response> uploadPhotoProof(FormData request);
Future<Response> submitTimerProofEntry(CompletionRequest request);
Future<Response> submitLocationProofEntry(CompletionRequest request);
// ── Guardrails ──────────────────────────────────────────────────────────
Future<Response> spendAmnestyToken(AmnestyRequest request);
Future<Response> getAmnestyBalance();
Future<Response> updateSickMode(SickModeRequest request);
Future<Response> checkDistress();
Future<Response> updateTone(ToneRequest request);
// ── Habits & routines ───────────────────────────────────────────────────
Future<Response> getMyHabits(HistoryRequest request);
Future<Response> saveHabitEntry(Map<String, dynamic> request);
Future<Response> logHabitEntry(IdRequest request);
Future<Response> getKeystoneHabits();
Future<Response> getMyRoutines(HistoryRequest request);
Future<Response> logRoutineChainEntry(Map<String, dynamic> request);
// ── Training ────────────────────────────────────────────────────────────
Future<Response> getMyPrograms(HistoryRequest request);
Future<Response> saveProgramEntry(Map<String, dynamic> request);
Future<Response> activateProgramEntry(IdRequest request);
Future<Response> getProgramSessions(IdRequest request);
Future<Response> startSessionEntry(IdRequest request);
Future<Response> saveSessionLogEntry(SessionLogRequest request);
Future<Response> getSessionHistory(HistoryRequest request);
Future<Response> getLastSessionFor(IdRequest request);
Future<Response> getWeeklyVolume(ReportCardRequest request);
Future<Response> getContactVolume(ReportCardRequest request);
Future<Response> getPersonalRecords(HistoryRequest request);
// ── Report card ─────────────────────────────────────────────────────────
Future<Response> getWeeklyReportCard(ReportCardRequest request);
Future<Response> getMonthlyReportCard(ReportCardRequest request);
// ── Notifications ───────────────────────────────────────────────────────
Future<Response> getMyNotifications(HistoryRequest request);
Future<Response> acknowledgeNudgeEntry(IdRequest request);
}