Alpha/GroundedHelper
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit: Grounded Flutter frontend

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

16
frontend/lib/Grounded/see/training/ConnectTraining.dart Normal file
View File

@@ -0,0 +1,16 @@
import '../../about/external/data/Program.dart';
import '../../about/external/data/SessionLog.dart';
import '../../about/external/data/SessionTemplate.dart';
abstract class ConnectTraining {
void onProgramLoaded(Program program, List<SessionTemplate> sessions);
void onHistoryLoaded(List<SessionLog> sessions);
/// The weekly plyometric contact ceiling has been reached — the app stops
/// you rather than pushing you.
void onContactCeilingReached(int contacts, int ceiling);
/// Not enough recovery since the last hard lower-body session.
void onRecoveryBlocked(int hoursRemaining);
}

10
frontend/lib/Grounded/see/training/Training.dart Normal file
View File

@@ -0,0 +1,10 @@
import 'package:flutter/material.dart';
import 'TrainingState.dart';
class Training extends StatefulWidget {
const Training({super.key});
@override
State<Training> createState() => TrainingState();
}

350
frontend/lib/Grounded/see/training/TrainingState.dart Normal file
View File

@@ -0,0 +1,350 @@
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:stacked/stacked.dart';
import '../../about/external/data/Program.dart';
import '../../about/external/data/SessionLog.dart';
import '../../about/external/data/SessionTemplate.dart';
import '../../about/internal/application/NotificationType.dart';
import '../../about/internal/application/TextType.dart';
import '../../designs/Component.dart';
import '../../designs/Responsive.dart';
import '../../designs/Shell.dart';
import '../../designs/text/Text.dart';
import '../../utils/Colors.dart';
import '../../utils/CommonUtils.dart';
import '../../utils/IntegrityEngine.dart';
import 'ConnectTraining.dart';
import 'Training.dart';
import 'ViewTraining.dart';
class TrainingState extends State<Training> implements ConnectTraining {
ViewTraining? _model;
Program _program = Program();
List<SessionTemplate> _sessions = <SessionTemplate>[];
List<SessionLog> _history = <SessionLog>[];
int _contacts = 0;
bool _ceilingReached = false;
int _recoveryHoursRemaining = 0;
@override
Widget build(BuildContext context) {
return ViewModelBuilder<ViewTraining>.reactive(
viewModelBuilder: () => ViewTraining(context, this),
onViewModelReady: (viewModel) {
_model = viewModel;
_initiate();
},
builder: (context, viewModel, child) => LayoutBuilder(
builder: (BuildContext context, BoxConstraints constraints) {
return Responsive(
mobile: _mobileView(constraints),
tablet: _mobileView(constraints),
desktop: _mobileView(constraints),
);
},
),
);
}
void _initiate() {
_model?.loadProgram();
}
void _onBack() {
Navigator.pop(context);
}
Widget _mobileView(BoxConstraints constraints) {
return Sheet(
eyebrow: _program.name.isEmpty ? "No program" : _program.name,
title: "Training",
onBack: _onBack,
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
mainAxisSize: MainAxisSize.min,
children: [
if (_ceilingReached || _recoveryHoursRemaining > 0) ...[
_stopCard(),
const SizedBox(height: 24),
],
if (_program.id == null)
emptyState(
CupertinoIcons.flame,
"No active program",
"Build a program with sessions, progression rules and scheduled deloads, and missed sessions start feeding your debt.",
)
else ...[
_programCard(),
const SizedBox(height: 28),
sectionBreak("Sessions", caption: "${_sessions.length} per cycle"),
if (_sessions.isEmpty)
text("No sessions defined yet.", 13, TextType.Regular,
color: colorGrey2)
else
..._sessions.map(_sessionRow),
const SizedBox(height: 28),
sectionBreak("Volume", caption: "this week"),
_volumeCard(),
const SizedBox(height: 28),
sectionBreak("Recent", caption: "last sessions"),
if (_history.isEmpty)
text("Nothing logged yet.", 13, TextType.Regular,
color: colorGrey2)
else
..._history.take(5).map(_historyRow),
],
],
),
);
}
/// Plyo and recovery are the two places the app refuses rather than nags.
Widget _stopCard() {
final bool ceiling = _ceilingReached;
return card(
background: colorStandingLockdownBg,
borderColor: colorStandingLockdown.withValues(alpha: 0.25),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Row(
children: [
Icon(CupertinoIcons.hand_raised_fill,
size: 16, color: colorStandingLockdown),
const SizedBox(width: 8),
text(ceiling ? "CONTACT CEILING" : "RECOVERY", 9, TextType.Bold,
color: colorStandingLockdown, letterSpacing: 1.2),
],
),
const SizedBox(height: 12),
text(
ceiling ? "Stop plyometrics this week." : "Not recovered yet.",
22,
TextType.Light,
color: colorPrimaryDark,
),
const SizedBox(height: 10),
text(
ceiling
? "You are at $_contacts of ${_program.weeklyContactCeiling} ground contacts. Connective tissue does not recover on a motivation schedule — this is the one place the app stops you."
: "$_recoveryHoursRemaining hours left before the next hard lower-body session. Training through this is not discipline, it is a shortcut to an injury.",
13,
TextType.Regular,
color: colorGrey2,
height: 1.55,
),
],
),
);
}
Widget _programCard() {
return card(
background: colorPrimaryDark,
borderColor: colorPrimaryDark,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
text("ACTIVE PROGRAM", 9, TextType.Bold,
color: colorWhite.withValues(alpha: 0.45), letterSpacing: 1.2),
const SizedBox(height: 10),
text(_program.name, 24, TextType.Light, color: colorWhite),
const SizedBox(height: 20),
Row(
children: [
Expanded(
child: labelled(
"Weeks",
"${_program.weeks}",
valueSize: 18,
valueColor: colorWhite,
labelColor: colorWhite.withValues(alpha: 0.45),
),
),
Expanded(
child: labelled(
"Per week",
"${_program.sessionsPerWeek}",
valueSize: 18,
valueColor: colorWhite,
labelColor: colorWhite.withValues(alpha: 0.45),
),
),
Expanded(
child: labelled(
"Deloads",
"${_program.deloadWeeks.length}",
valueSize: 18,
valueColor: colorWhite,
labelColor: colorWhite.withValues(alpha: 0.45),
),
),
],
),
],
),
);
}
Widget _sessionRow(SessionTemplate session) {
return Container(
margin: const EdgeInsets.only(bottom: 10),
child: card(
padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 14),
child: Row(
children: [
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
text(session.name, 15, TextType.Medium,
color: colorPrimaryDark),
const SizedBox(height: 6),
text("${session.prescriptions.length} exercises", 11,
TextType.Regular, color: colorGrey2),
],
),
),
if (session.highIntensityLowerBody)
pill("HIGH LOAD", colorStandingWarned, colorStandingWarnedBg,
textSize: 9),
],
),
),
);
}
/// Volume per muscle group, not "you went to the gym".
Widget _volumeCard() {
final Map<String, int> volume =
IntegrityEngine.weeklySetsByMuscleGroup(_history);
if (volume.isEmpty) {
return card(
child: text("No sets logged this week.", 13, TextType.Regular,
color: colorGrey2),
);
}
return card(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: volume.entries.map((entry) {
return Padding(
padding: const EdgeInsets.only(bottom: 12),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
text(entry.key, 13, TextType.Regular,
color: colorPrimaryDark),
text("${entry.value} sets", 12, TextType.Bold,
color: colorGrey2),
],
),
const SizedBox(height: 6),
meter(entry.value / 20),
],
),
);
}).toList(),
),
);
}
Widget _historyRow(SessionLog session) {
final bool watered = session.integrityScore > 0 &&
session.integrityScore < 0.7;
return Container(
margin: const EdgeInsets.only(bottom: 10),
child: card(
padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 14),
child: Row(
children: [
Expanded(
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
text(session.templateName, 14, TextType.Medium,
color: colorPrimaryDark),
const SizedBox(height: 6),
text(
"${formatDate(session.startedAt)} · ${session.sets.length} sets · RPE ${session.sessionRpe.toStringAsFixed(1)}",
11,
TextType.Regular,
color: colorGrey2,
),
],
),
),
if (session.integrityScore > 0)
pill(
"${(session.integrityScore * 100).round()}%",
watered ? colorStandingGrounded : colorPositive,
watered ? colorStandingGroundedBg : colorStandingGoodBg,
textSize: 9,
),
],
),
),
);
}
// ── ConnectTraining ───────────────────────────────────────────────────────
@override
void onProgramLoaded(Program program, List<SessionTemplate> sessions) {
setState(() {
_program = program;
_sessions = sessions;
});
}
@override
void onHistoryLoaded(List<SessionLog> sessions) {
setState(() {
_history = sessions;
});
}
@override
void onContactCeilingReached(int contacts, int ceiling) {
setState(() {
_contacts = contacts;
_ceilingReached = true;
});
_model?.showApplicationNotification(
NotificationType.warning,
"Contact ceiling reached",
"$contacts of $ceiling ground contacts this week. No more plyometrics until it resets.",
true,
true,
null,
);
}
@override
void onRecoveryBlocked(int hoursRemaining) {
setState(() {
_recoveryHoursRemaining = hoursRemaining;
});
}
}

129
frontend/lib/Grounded/see/training/ViewTraining.dart Normal file
View File

@@ -0,0 +1,129 @@
import '../../about/external/data/Program.dart';
import '../../about/external/data/SessionLog.dart';
import '../../about/external/data/SessionTemplate.dart';
import '../../about/external/data/pages/request/HistoryRequest.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/SessionLogPage.dart';
import '../../about/external/initial/IdRequest.dart';
import '../../utils/IntegrityEngine.dart';
import '../../utils/ObjectConvertors.dart';
import '../parent/ParentViewModel.dart';
import 'ConnectTraining.dart';
class ViewTraining extends ParentViewModel {
ConnectTraining connection;
ViewTraining(super.context, this.connection);
void loadProgram() async {
if (!await hasNetwork(() => loadProgram())) return;
showLoading("Loading your program");
try {
final response = await getDataManager().getMyPrograms(HistoryRequest(
query: PageAndSort(
sort: Sort('desc', 'active'),
page: Pageable(0, 0, 20, 0),
),
));
final List<Program> programs = getProgramList(response.data);
final Program active = programs.firstWhere(
(item) => item.active,
orElse: () => programs.isEmpty ? Program() : programs.first,
);
await getDataManager().setActiveProgram(active);
final List<SessionTemplate> sessions = await _loadSessions(active);
closeLoading();
connection.onProgramLoaded(active, sessions);
loadHistory(active);
} catch (e) {
handleError(e, () => loadProgram(), () => dismissError(), "Retry");
}
}
Future<List<SessionTemplate>> _loadSessions(Program program) async {
if (program.id == null) {
return <SessionTemplate>[];
}
final response = await getDataManager()
.getProgramSessions(IdRequest(id: program.id ?? ""));
return getSessionTemplateList(response.data);
}
void loadHistory(Program program) async {
try {
final response = await getDataManager().getSessionHistory(HistoryRequest(
query: PageAndSort(
sort: Sort('desc', 'startedAt'),
page: Pageable(0, 0, 20, 0),
),
));
final SessionLogPage page = SessionLogPage.fromJson(response.data);
connection.onHistoryLoaded(page.content);
_checkLoadCeilings(program, page.content);
} catch (e) {
handleError(e, () => loadHistory(program), () => dismissError(), "Retry");
}
}
/// Plyometrics is the one modality where the app should stop you rather than
/// push you — CNS and connective tissue do not recover on a motivation
/// schedule.
void _checkLoadCeilings(Program program, List<SessionLog> history) {
final DateTime weekStart =
DateTime.now().subtract(Duration(days: DateTime.now().weekday - 1));
final List<SessionLog> thisWeek = history
.where((session) =>
session.startedAt != null &&
session.startedAt!.isAfter(weekStart))
.toList();
final int contacts = IntegrityEngine.weeklyContacts(thisWeek);
if (IntegrityEngine.contactCeilingBreached(
thisWeek, program.weeklyContactCeiling)) {
connection.onContactCeilingReached(
contacts, program.weeklyContactCeiling);
return;
}
_checkRecovery(program, history);
}
void _checkRecovery(Program program, List<SessionLog> history) {
// The most recent hard lower-body session gates the next one.
final List<SessionLog> hard = history
.where((session) => session.sessionRpe >= 8 && session.startedAt != null)
.toList();
if (hard.isEmpty) {
return;
}
final DateTime last = hard.first.startedAt!;
if (IntegrityEngine.recoveredEnough(last, program.lowerBodyRecoveryHours)) {
return;
}
final int elapsed = DateTime.now().difference(last).inHours;
connection.onRecoveryBlocked(program.lowerBodyRecoveryHours - elapsed);
}
}