Files
GroundedHelper/frontend/lib/Grounded/comms/ConnectComms.dart
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

146 lines
6.5 KiB
Dart

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);
}