@dgpholdings/greatoak-shared 1.2.59 → 1.2.61

package/dist/__mocks__/exercises.mock.js

@@ -8,6 +8,7 @@ exports.mockExercisesDictionary = exports.mockExerciseNoGuardrails = exports.moc
 exports.mockExerciseWeightReps = {
     exerciseId: "mock-exercise-weight-reps-123",
     name: "Generic Barbell Squat",
+    status: "active",
     bodyPart: ["Legs"],
     recordType: "weight-reps",
     primaryMuscles: ["quadriceps"],
@@ -56,7 +57,7 @@ exports.mockExerciseWeightReps = {
  * MOCK EXERCISE: Reps-Only
  * Simulates a bodyweight movement (e.g., Push-up).
  */
-exports.mockExerciseRepsOnly = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-reps-only-456", name: "Generic Push-Up", bodyPart: ["Chest", "Core"], recordType: "reps-only", primaryMuscles: ["pectoralis-major"], secondaryMuscles: ["tricep-brachii-lateral", "abs-lower"], trainingTypes: ["body-weight"], timingGuardrails: {
+exports.mockExerciseRepsOnly = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-reps-only-456", name: "Generic Push-Up", status: "active", bodyPart: ["Chest", "Core"], recordType: "reps-only", primaryMuscles: ["pectoralis-major"], secondaryMuscles: ["tricep-brachii-lateral", "abs-lower"], trainingTypes: ["body-weight"], timingGuardrails: {
         type: "reps-only",
         stressRestBonus: 2,
         fatigueMultiplier: 1.05,
@@ -77,7 +78,7 @@ exports.mockExerciseRepsOnly = Object.assign(Object.assign({}, exports.mockExerc
  * MOCK EXERCISE: Duration
  * Simulates an isometric hold (e.g., Plank).
  */
-exports.mockExerciseDuration = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-duration-789", name: "Generic Forearm Plank", bodyPart: ["Core"], recordType: "duration", primaryMuscles: ["abs-lower", "abs-upper"], secondaryMuscles: ["lower-back"], trainingTypes: ["body-weight", "isometric"], timingGuardrails: {
+exports.mockExerciseDuration = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-duration-789", name: "Generic Forearm Plank", status: "active", bodyPart: ["Core"], recordType: "duration", primaryMuscles: ["abs-lower", "abs-upper"], secondaryMuscles: ["lower-back"], trainingTypes: ["body-weight", "isometric"], timingGuardrails: {
         type: "duration",
         stressRestBonus: 3,
         fatigueMultiplier: 1.1,
@@ -98,7 +99,7 @@ exports.mockExerciseDuration = Object.assign(Object.assign({}, exports.mockExerc
  * MOCK EXERCISE: Cardio-Machine
  * Simulates a machine cardio session (e.g., Treadmill).
  */
-exports.mockExerciseCardioMachine = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-cardio-machine-101", name: "Generic Treadmill Run", bodyPart: ["Legs"], recordType: "cardio-machine", primaryMuscles: ["quadriceps", "hamstrings", "calves"], secondaryMuscles: ["glutes-maximus"], trainingTypes: ["cardio"], timingGuardrails: {
+exports.mockExerciseCardioMachine = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-cardio-machine-101", name: "Generic Treadmill Run", status: "active", bodyPart: ["Legs"], recordType: "cardio-machine", primaryMuscles: ["quadriceps", "hamstrings", "calves"], secondaryMuscles: ["glutes-maximus"], trainingTypes: ["cardio"], timingGuardrails: {
         type: "cardio-machine",
         stressRestBonus: 0,
         fatigueMultiplier: 1.0,
@@ -114,7 +115,7 @@ exports.mockExerciseCardioMachine = Object.assign(Object.assign({}, exports.mock
  * MOCK EXERCISE: Cardio-Free
  * Simulates an outdoor/untracked cardio session (e.g., Outdoor Run).
  */
-exports.mockExerciseCardioFree = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-cardio-free-202", name: "Generic Outdoor Jog", bodyPart: ["Legs"], recordType: "cardio-free", primaryMuscles: ["quadriceps", "hamstrings", "calves"], secondaryMuscles: ["glutes-maximus"], trainingTypes: ["cardio"], timingGuardrails: {
+exports.mockExerciseCardioFree = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-cardio-free-202", name: "Generic Outdoor Jog", status: "active", bodyPart: ["Legs"], recordType: "cardio-free", primaryMuscles: ["quadriceps", "hamstrings", "calves"], secondaryMuscles: ["glutes-maximus"], trainingTypes: ["cardio"], timingGuardrails: {
         type: "cardio-free",
         stressRestBonus: 0,
         fatigueMultiplier: 1.0,
@@ -130,7 +131,7 @@ exports.mockExerciseCardioFree = Object.assign(Object.assign({}, exports.mockExe
  * MOCK EXERCISE: No Guardrails
  * Simulates an older DB entry or custom exercise missing guardrails.
  */
-exports.mockExerciseNoGuardrails = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-no-guardrails-303", name: "Legacy Exercise", timingGuardrails: undefined });
+exports.mockExerciseNoGuardrails = Object.assign(Object.assign({}, exports.mockExerciseWeightReps), { exerciseId: "mock-exercise-no-guardrails-303", name: "Legacy Exercise", status: "active", timingGuardrails: undefined });
 /**
  * Helper dictionary containing all mock exercises mapped by their ID.
  */

package/dist/types/TApiAiExerciseAnalysis.d.ts

@@ -0,0 +1,92 @@
+export type TConfidence = "high" | "medium" | null;
+export type TNameReviewStatus = "pending" | "approved";
+export type TQdrantSyncStatus = "pending" | "synced" | "failed";
+export type TAiMuscles = {
+    primary: string[];
+    secondary: string[];
+    stabilizers: string[];
+    stretched: string[];
+};
+export type TAiJointInvolved = {
+    joint: string;
+    action: string;
+    rom_degrees: string;
+    stress_level: string;
+};
+export type TAiDifficulty = {
+    level: string;
+    coordination_demand: string;
+    balance_demand: string;
+    flexibility_demand: string;
+    strength_demand: string;
+};
+export type TAiEquipment = {
+    primary: string;
+    secondary: string[];
+    can_be_done_at_home: boolean;
+    minimal_equipment_alternative: string | null;
+};
+export type TAiSafety = {
+    injury_risk_areas: string[];
+    contraindicated_conditions: string[];
+    common_mistakes: string[];
+    prerequisite_mobility: string[];
+};
+export type TAiEnergyAndLoad = {
+    estimated_met: number;
+    typical_rep_range: string;
+    typical_set_range: string;
+    rest_period_seconds: string;
+    tempo_recommendation: string;
+};
+export type TAiFatigueProfile = {
+    cns_demand: string;
+    local_muscle_fatigue: string;
+    cardiovascular_demand: string;
+    recovery_time_hours: string;
+};
+export type TAiProgrammingContext = {
+    suitable_for_goals: string[];
+    workout_placement: string;
+    pairs_well_with: string[];
+    progressions: string[];
+    regressions: string[];
+};
+export type TAiDemographics = {
+    suitable_for_beginners: boolean;
+    suitable_for_elderly: boolean;
+    suitable_for_prenatal: boolean;
+    suitable_during_rehab: boolean;
+    age_group_notes: string;
+};
+export type TApiAiExerciseAnalysis = {
+    exerciseId: string;
+    isGivenNameConflicting: boolean;
+    exercise_name: string;
+    alternative_names: string[];
+    movement_description: string;
+    movement_pattern: string;
+    exercise_type: string;
+    contraction_type: string;
+    plane_of_motion: string[];
+    kinetic_chain: string;
+    laterality: string;
+    muscles: TAiMuscles;
+    joints_involved: TAiJointInvolved[];
+    difficulty: TAiDifficulty;
+    equipment: TAiEquipment;
+    safety: TAiSafety;
+    energy_and_load: TAiEnergyAndLoad;
+    fatigue_profile: TAiFatigueProfile;
+    programming_context: TAiProgrammingContext;
+    demographics: TAiDemographics;
+    form_notes: string;
+    embedding_text: string;
+    confidence: TConfidence;
+    nameReviewStatus: TNameReviewStatus;
+    qdrantSyncStatus: TQdrantSyncStatus;
+    enrichedAt: string;
+    aiProvider: string;
+    seedVersion: string;
+};
+export type TApiAiMetaListRecord = Pick<TApiAiExerciseAnalysis, "exerciseId" | "isGivenNameConflicting" | "confidence" | "nameReviewStatus">;

package/dist/types/TApiAiExerciseAnalysis.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/TApiExercise.d.ts

@@ -123,6 +123,10 @@ export type TExercise = {
     isFavorite?: boolean;
     scoringSpecialHandling?: "plyometric" | "stretch-mobility" | "continuous-duration" | "loaded-carry";
     isFlaggedCorrection?: boolean;
+    /** True for single-arm / single-leg exercises. The user enters weight per side,
+     *  so the scoring engine doubles it to get total mechanical load. */
+    isUnilateral?: boolean;
+    status: "active" | "inactive" | "archived";
     regressionExerciseId?: string;
     progressionExerciseId?: string;
     bodyweightDependency?: "high" | "medium" | "low" | "none";
@@ -135,9 +139,6 @@ export type TExercise = {
         female: number;
         default: number;
     };
-    /** True for single-arm / single-leg exercises. The user enters weight per side,
-     *  so the scoring engine doubles it to get total mechanical load. */
-    isUnilateral?: boolean;
 };
 export type TBodyPartExercises = Record<TBodyPart, TExercise[]>;
 export type TApiCreateOrUpdateExerciseReq = {

package/dist/types/index.d.ts

@@ -11,3 +11,4 @@ export type * from "./TApiRevenueCat";
 export type * from "./TApiClientProgress";
 export type * from "./TApiProPlan";
 export type * from "./TApiSales";
+export type * from "./TApiAiExerciseAnalysis";

package/dist/utils/scoringWorkout/calculateMuscleFatiue.js

@@ -64,7 +64,7 @@ function calculateMuscleFatigue(sets, exercise, user, timingGuardrails, historic
         return {};
     const fatigueMultiplier = (_a = timingGuardrails === null || timingGuardrails === void 0 ? void 0 : timingGuardrails.fatigueMultiplier) !== null && _a !== void 0 ? _a : constants_1.FALLBACK_FATIGUE_MULTIPLIER;
     // --- Step 1–3: Compute cumulative fatigue stimulus ---
-    const cumulativeFatigue = computeCumulativeFatigue(sets, exercise.difficultyLevel, user, fatigueMultiplier, exercise.scoringSpecialHandling, exercise.isUnilateral);
+    const cumulativeFatigue = computeCumulativeFatigue(sets, exercise.difficultyLevel, user, fatigueMultiplier, exercise.scoringSpecialHandling, exercise.isUnilateral, historicalContext);
     // --- Step 4: Distribute to muscles ---
     const rawMuscleFatigue = distributeFatigueToMuscles(cumulativeFatigue, exercise.primaryMuscles, exercise.secondaryMuscles);
     // --- Step 5: Normalize to 0–100 ---
@@ -88,7 +88,7 @@ function calculateMuscleFatigue(sets, exercise, user, timingGuardrails, historic
  * cardio:             Duration × speed factor (represents sustained effort)
  *   loaded-carry:     Speed factor boosted by carried weight relative to bodyweight
  */
-function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, isUnilateral) {
+function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, isUnilateral, historicalContext) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
     switch (set.type) {
         case "weight-reps": {
@@ -100,15 +100,26 @@ function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, i
         case "reps-only": {
             const reps = (_c = set.reps) !== null && _c !== void 0 ? _c : 0;
             const auxWeightKg = (_d = set.auxWeightKg) !== null && _d !== void 0 ? _d : 0;
-            // Estimate how much bodyweight the exercise loads
-            // difficulty 0 → 0%, difficulty 2 → ~33%, difficulty 4 → 65%
-            const bodyweightLoad = (difficultyLevel / 4) * constants_1.BW_FRACTION_SCALE * user.weightKg;
-            const totalLoad = bodyweightLoad + auxWeightKg;
-            const baseVolume = totalLoad * reps;
-            // Plyometric: impact forces and neuromotor demand exceed simple BW × reps
-            if (scoringSpecialHandling === "plyometric") {
-                return baseVolume * constants_1.PLYOMETRIC_LOAD_MULTIPLIER;
+            // Epley Adaptation (P4-1): when a historical 1RM equivalent is available
+            // (bodyweight × (1 + bestReps/30)), use it to derive relative intensity.
+            // This means a user doing 20/25 max pull-ups scores higher fatigue than a
+            // user doing 20/80 max — identical reps, very different physiological effort.
+            //
+            // Fallback: difficulty-based bodyweight fraction (pre-P4-1 behaviour).
+            // Used when no history exists (first session on this exercise).
+            let effectiveLoad;
+            if ((historicalContext === null || historicalContext === void 0 ? void 0 : historicalContext.estimatedOneRepMax) && user.weightKg > 0 && reps > 0) {
+                const sessionEpley = user.weightKg * (1 + reps / 30);
+                const relativeIntensity = Math.min(1.0, sessionEpley / historicalContext.estimatedOneRepMax);
+                effectiveLoad = relativeIntensity * user.weightKg + auxWeightKg;
+            }
+            else {
+                const bodyweightLoad = (difficultyLevel / 4) * constants_1.BW_FRACTION_SCALE * user.weightKg;
+                effectiveLoad = bodyweightLoad + auxWeightKg;
             }
+            const baseVolume = effectiveLoad * reps;
+            if (scoringSpecialHandling === "plyometric")
+                return baseVolume * constants_1.PLYOMETRIC_LOAD_MULTIPLIER;
             return baseVolume;
         }
         case "duration": {
@@ -176,12 +187,12 @@ function computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, i
  *
  * @returns Single number representing total fatigue stimulus
  */
-function computeCumulativeFatigue(sets, difficultyLevel, user, fatigueMultiplier, scoringSpecialHandling, isUnilateral) {
+function computeCumulativeFatigue(sets, difficultyLevel, user, fatigueMultiplier, scoringSpecialHandling, isUnilateral, historicalContext) {
     let cumulative = 0;
     for (let i = 0; i < sets.length; i++) {
         const set = sets[i];
         // Step 1: Raw volume for this set
-        const volumeLoad = computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, isUnilateral);
+        const volumeLoad = computeVolumeLoad(set, difficultyLevel, user, scoringSpecialHandling, isUnilateral, historicalContext);
         // Step 2: Scale by effort and exercise fatigue multiplier
         const stimulus = volumeLoad * set.effortFraction * fatigueMultiplier;
         // Step 3: Apply diminishing returns decay
@@ -260,9 +271,17 @@ function computeReferenceMax(exerciseType, difficultyLevel, user, muscleGroupFac
             break;
         }
         case "reps-only": {
-            const bodyweightLoad = (difficultyLevel / 4) * constants_1.BW_FRACTION_SCALE * user.weightKg;
-            const typicalAux = 5; // assume up to 5kg aux for reference
-            singleSetMax = (bodyweightLoad + typicalAux) * 15;
+            // Epley Adaptation (P4-1): use the stored 1RM equivalent as the capacity
+            // anchor when available. This means the reference max scales to the
+            // individual's actual strength, not a population-average estimate.
+            if (historicalContext === null || historicalContext === void 0 ? void 0 : historicalContext.estimatedOneRepMax) {
+                singleSetMax = historicalContext.estimatedOneRepMax * constants_1.REFERENCE_MAX_REPS;
+            }
+            else {
+                // Fallback: difficulty-based bodyweight fraction
+                const bodyweightLoad = (difficultyLevel / 4) * constants_1.BW_FRACTION_SCALE * user.weightKg;
+                singleSetMax = (bodyweightLoad + 5) * 15;
+            }
             break;
         }
         case "duration": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dgpholdings/greatoak-shared",
-	"version": "1.2.59",
+	"version": "1.2.61",
 	"description": "Shared TypeScript types and utilities for @dgpholdings projects",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",