@dgpholdings/greatoak-shared 1.2.92 → 1.2.94

package/dist/types/goalFeature/goalJourney.js

@@ -0,0 +1,595 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAL_PHASE_HINTS = exports.DAYS_PER_WEEK_OPTIONS = exports.RECENCY_CREDIT = exports.PHASE_ENTRY_CREDIT = exports.GOAL_CATEGORY_DISPLAY = exports.GOAL_DISPLAY = exports.INTENT_DISPLAY = exports.PHASE_DISPLAY = exports.TRAINING_PHASES = exports.GOAL_TO_AI_FITNESS_GOAL = exports.GOAL_SESSION_INTENTS = exports.USER_FITNESS_GOALS = void 0;
+exports.derivePhase = derivePhase;
+exports.USER_FITNESS_GOALS = [
+    // Appearance
+    "lose_weight",
+    "build_muscle",
+    "lean_and_toned",
+    "glutes_and_legs",
+    // Performance
+    "get_stronger",
+    "boost_endurance",
+    "athletic_performance",
+    // Health
+    "general_fitness",
+    "posture_and_back",
+    "stress_relief",
+    "rehabilitation",
+    // Focused
+    "core_strength",
+    "mobility_flexibility",
+];
+// The canonical weekly template per goal (7 slots, Mon→Sun)
+// Phase-aware structures live in the app layer, not shared
+// This is the "default" / Phase 2-3 reference structure
+exports.GOAL_SESSION_INTENTS = {
+    lose_weight: [
+        "cardio",
+        "full-body",
+        "rest",
+        "cardio",
+        "full-body",
+        "cardio",
+        "rest",
+    ],
+    build_muscle: ["push", "pull", "legs", "rest", "upper", "lower", "rest"],
+    lean_and_toned: [
+        "full-body",
+        "cardio",
+        "full-body",
+        "rest",
+        "full-body",
+        "cardio",
+        "rest",
+    ],
+    glutes_and_legs: ["legs", "upper", "legs", "rest", "legs", "cardio", "rest"],
+    get_stronger: ["push", "pull", "legs", "rest", "push", "pull", "rest"],
+    boost_endurance: [
+        "cardio",
+        "legs",
+        "cardio",
+        "upper",
+        "cardio",
+        "full-body",
+        "rest",
+    ],
+    athletic_performance: [
+        "legs",
+        "upper",
+        "cardio",
+        "core",
+        "full-body",
+        "rest",
+        "rest",
+    ],
+    general_fitness: [
+        "full-body",
+        "rest",
+        "full-body",
+        "cardio",
+        "full-body",
+        "rest",
+        "rest",
+    ],
+    posture_and_back: [
+        "pull",
+        "core",
+        "mobility",
+        "pull",
+        "core",
+        "mobility",
+        "rest",
+    ],
+    stress_relief: [
+        "cardio",
+        "mobility",
+        "full-body",
+        "rest",
+        "cardio",
+        "mobility",
+        "rest",
+    ],
+    rehabilitation: [
+        "mobility",
+        "core",
+        "mobility",
+        "rest",
+        "mobility",
+        "core",
+        "rest",
+    ],
+    core_strength: ["core", "pull", "legs", "core", "push", "rest", "rest"],
+    mobility_flexibility: [
+        "mobility",
+        "full-body",
+        "mobility",
+        "rest",
+        "mobility",
+        "full-body",
+        "rest",
+    ],
+};
+exports.GOAL_TO_AI_FITNESS_GOAL = {
+    lose_weight: "fat_loss",
+    build_muscle: "hypertrophy",
+    lean_and_toned: "fat_loss",
+    glutes_and_legs: "hypertrophy",
+    get_stronger: "strength",
+    boost_endurance: "endurance",
+    athletic_performance: "sport_performance",
+    general_fitness: "general_fitness",
+    posture_and_back: "strength",
+    stress_relief: "general_fitness",
+    rehabilitation: "rehabilitation",
+    core_strength: "core_strength",
+    mobility_flexibility: "mobility",
+};
+// Foundation → Momentum → Push → Peak
+exports.TRAINING_PHASES = [
+    "foundation",
+    "momentum",
+    "push",
+    "peak",
+];
+exports.PHASE_DISPLAY = {
+    foundation: {
+        nameKey: "goalPhase.foundation.name",
+        nameEn: "Foundation",
+        subtitleKey: "goalPhase.foundation.subtitle",
+        subtitleEn: "Build the base",
+        purposeKey: "goalPhase.foundation.purpose",
+        purposeEn: "Preparing your joints, learning movement patterns, and building the work capacity for what's ahead. Every great physique starts here — don't skip it.",
+        durationKey: "goalPhase.foundation.duration",
+        durationEn: "Weeks 1–2",
+        weekRange: [1, 2],
+        intensityPercent: 40,
+    },
+    momentum: {
+        nameKey: "goalPhase.momentum.name",
+        nameEn: "Momentum",
+        subtitleKey: "goalPhase.momentum.subtitle",
+        subtitleEn: "Volume builds here",
+        purposeKey: "goalPhase.momentum.purpose",
+        purposeEn: "Your body has adapted. Now we increase the work. Splits begin, sessions get more specific. This is where the habit locks in.",
+        durationKey: "goalPhase.momentum.duration",
+        durationEn: "Weeks 3–5",
+        weekRange: [3, 5],
+        intensityPercent: 60,
+    },
+    push: {
+        nameKey: "goalPhase.push.name",
+        nameEn: "Push",
+        subtitleKey: "goalPhase.push.subtitle",
+        subtitleEn: "This is where change happens",
+        purposeKey: "goalPhase.push.purpose",
+        purposeEn: "Goal-specific intensity. Your muscles are conditioned — now we challenge them. Expect to feel this one.",
+        durationKey: "goalPhase.push.duration",
+        durationEn: "Weeks 6–8",
+        weekRange: [6, 8],
+        intensityPercent: 80,
+    },
+    peak: {
+        nameKey: "goalPhase.peak.name",
+        nameEn: "Peak",
+        subtitleKey: "goalPhase.peak.subtitle",
+        subtitleEn: "Maximum output",
+        purposeKey: "goalPhase.peak.purpose",
+        purposeEn: "Highest specificity to your goal. You have earned this — now execute. A deload is built into the final week.",
+        durationKey: "goalPhase.peak.duration",
+        durationEn: "Weeks 9+",
+        weekRange: [9, 99],
+        intensityPercent: 95,
+    },
+};
+exports.INTENT_DISPLAY = {
+    push: {
+        labelKey: "sessionIntent.push.label",
+        labelEn: "Push Day",
+        shortLabelKey: "sessionIntent.push.shortLabel",
+        shortLabelEn: "Push",
+        emoji: "💪",
+    },
+    pull: {
+        labelKey: "sessionIntent.pull.label",
+        labelEn: "Pull Day",
+        shortLabelKey: "sessionIntent.pull.shortLabel",
+        shortLabelEn: "Pull",
+        emoji: "🔗",
+    },
+    legs: {
+        labelKey: "sessionIntent.legs.label",
+        labelEn: "Leg Day",
+        shortLabelKey: "sessionIntent.legs.shortLabel",
+        shortLabelEn: "Legs",
+        emoji: "🦵",
+    },
+    lower: {
+        labelKey: "sessionIntent.lower.label",
+        labelEn: "Lower Body",
+        shortLabelKey: "sessionIntent.lower.shortLabel",
+        shortLabelEn: "Lower",
+        emoji: "🦵",
+    },
+    upper: {
+        labelKey: "sessionIntent.upper.label",
+        labelEn: "Upper Body",
+        shortLabelKey: "sessionIntent.upper.shortLabel",
+        shortLabelEn: "Upper",
+        emoji: "💪",
+    },
+    core: {
+        labelKey: "sessionIntent.core.label",
+        labelEn: "Core & Abs",
+        shortLabelKey: "sessionIntent.core.shortLabel",
+        shortLabelEn: "Core",
+        emoji: "⚡",
+    },
+    cardio: {
+        labelKey: "sessionIntent.cardio.label",
+        labelEn: "Cardio",
+        shortLabelKey: "sessionIntent.cardio.shortLabel",
+        shortLabelEn: "Cardio",
+        emoji: "🏃",
+    },
+    strength: {
+        labelKey: "sessionIntent.strength.label",
+        labelEn: "Strength",
+        shortLabelKey: "sessionIntent.strength.shortLabel",
+        shortLabelEn: "Strength",
+        emoji: "🏋️",
+    },
+    fatburn: {
+        labelKey: "sessionIntent.fatburn.label",
+        labelEn: "Fat Burn",
+        shortLabelKey: "sessionIntent.fatburn.shortLabel",
+        shortLabelEn: "Burn",
+        emoji: "🔥",
+    },
+    mobility: {
+        labelKey: "sessionIntent.mobility.label",
+        labelEn: "Mobility",
+        shortLabelKey: "sessionIntent.mobility.shortLabel",
+        shortLabelEn: "Mobility",
+        emoji: "🧘",
+    },
+    "full-body": {
+        labelKey: "sessionIntent.fullBody.label",
+        labelEn: "Full Body",
+        shortLabelKey: "sessionIntent.fullBody.shortLabel",
+        shortLabelEn: "Full",
+        emoji: "⭐",
+    },
+    rest: {
+        labelKey: "sessionIntent.rest.label",
+        labelEn: "Rest Day",
+        shortLabelKey: "sessionIntent.rest.shortLabel",
+        shortLabelEn: "Rest",
+        emoji: "😴",
+    },
+};
+exports.GOAL_DISPLAY = {
+    // ── Appearance ────────────────────────────────────────────────────────────
+    lose_weight: {
+        nameKey: "userGoal.loseWeight.name",
+        nameEn: "Lose Weight",
+        descriptionKey: "userGoal.loseWeight.description",
+        descriptionEn: "Burn fat and drop weight through cardio and full-body training.",
+        taglineKey: "userGoal.loseWeight.tagline",
+        taglineEn: "Every session burns, every week counts.",
+        emoji: "🔥",
+        category: "appearance",
+    },
+    build_muscle: {
+        nameKey: "userGoal.buildMuscle.name",
+        nameEn: "Build Muscle",
+        descriptionKey: "userGoal.buildMuscle.description",
+        descriptionEn: "Add size and strength with structured push, pull, and leg splits.",
+        taglineKey: "userGoal.buildMuscle.tagline",
+        taglineEn: "Progressive overload. Every rep builds the next.",
+        emoji: "💪",
+        category: "appearance",
+    },
+    lean_and_toned: {
+        nameKey: "userGoal.leanAndToned.name",
+        nameEn: "Get Lean & Toned",
+        descriptionKey: "userGoal.leanAndToned.description",
+        descriptionEn: "Burn fat while preserving muscle for a lean, defined look.",
+        taglineKey: "userGoal.leanAndToned.tagline",
+        taglineEn: "Defined. Lean. Confident.",
+        emoji: "✨",
+        category: "appearance",
+    },
+    glutes_and_legs: {
+        nameKey: "userGoal.glutesAndLegs.name",
+        nameEn: "Grow Glutes & Legs",
+        descriptionKey: "userGoal.glutesAndLegs.description",
+        descriptionEn: "Build powerful glutes and legs with targeted lower-body training.",
+        taglineKey: "userGoal.glutesAndLegs.tagline",
+        taglineEn: "Strong legs carry everything.",
+        emoji: "🦵",
+        category: "appearance",
+    },
+    // ── Performance ───────────────────────────────────────────────────────────
+    get_stronger: {
+        nameKey: "userGoal.getStronger.name",
+        nameEn: "Get Stronger",
+        descriptionKey: "userGoal.getStronger.description",
+        descriptionEn: "Build real-world strength through compound lifts and progressive overload.",
+        taglineKey: "userGoal.getStronger.tagline",
+        taglineEn: "Lift more. Be more.",
+        emoji: "🏋️",
+        category: "performance",
+    },
+    boost_endurance: {
+        nameKey: "userGoal.boostEndurance.name",
+        nameEn: "Build Endurance",
+        descriptionKey: "userGoal.boostEndurance.description",
+        descriptionEn: "Increase stamina and cardiovascular capacity through progressive cardio and leg work.",
+        taglineKey: "userGoal.boostEndurance.tagline",
+        taglineEn: "Go further. Last longer.",
+        emoji: "🏃",
+        category: "performance",
+    },
+    athletic_performance: {
+        nameKey: "userGoal.athleticPerformance.name",
+        nameEn: "Athletic Performance",
+        descriptionKey: "userGoal.athleticPerformance.description",
+        descriptionEn: "Train like an athlete — explosive power, speed, agility, and conditioning.",
+        taglineKey: "userGoal.athleticPerformance.tagline",
+        taglineEn: "Train hard. Perform harder.",
+        emoji: "⚡",
+        category: "performance",
+    },
+    // ── Health ────────────────────────────────────────────────────────────────
+    general_fitness: {
+        nameKey: "userGoal.generalFitness.name",
+        nameEn: "Stay Active & Healthy",
+        descriptionKey: "userGoal.generalFitness.description",
+        descriptionEn: "A balanced mix of strength, cardio, and mobility for a healthy, active lifestyle.",
+        taglineKey: "userGoal.generalFitness.tagline",
+        taglineEn: "Move well. Feel well. Live well.",
+        emoji: "🌟",
+        category: "health",
+    },
+    posture_and_back: {
+        nameKey: "userGoal.postureAndBack.name",
+        nameEn: "Fix Posture & Back",
+        descriptionKey: "userGoal.postureAndBack.description",
+        descriptionEn: "Strengthen the posterior chain and core to fix posture and eliminate back pain.",
+        taglineKey: "userGoal.postureAndBack.tagline",
+        taglineEn: "Stand tall. Move pain-free.",
+        emoji: "🧍",
+        category: "health",
+    },
+    stress_relief: {
+        nameKey: "userGoal.stressRelief.name",
+        nameEn: "Reduce Stress",
+        descriptionKey: "userGoal.stressRelief.description",
+        descriptionEn: "Use movement to reset your mind — cardio endorphins and mobility to decompress.",
+        taglineKey: "userGoal.stressRelief.tagline",
+        taglineEn: "Move it out. Breathe it out.",
+        emoji: "🧘",
+        category: "health",
+    },
+    rehabilitation: {
+        nameKey: "userGoal.rehabilitation.name",
+        nameEn: "Recover from Injury",
+        descriptionKey: "userGoal.rehabilitation.description",
+        descriptionEn: "Gentle, progressive sessions to rebuild strength and movement after injury.",
+        taglineKey: "userGoal.rehabilitation.tagline",
+        taglineEn: "Slow and steady. Built to last.",
+        emoji: "🩹",
+        category: "health",
+    },
+    // ── Focused ───────────────────────────────────────────────────────────────
+    core_strength: {
+        nameKey: "userGoal.coreStrength.name",
+        nameEn: "Build a Strong Core",
+        descriptionKey: "userGoal.coreStrength.description",
+        descriptionEn: "Develop deep core stability and strength — the foundation of every movement.",
+        taglineKey: "userGoal.coreStrength.tagline",
+        taglineEn: "Strong core. Strong everything.",
+        emoji: "🎯",
+        category: "focused",
+    },
+    mobility_flexibility: {
+        nameKey: "userGoal.mobilityFlexibility.name",
+        nameEn: "Improve Flexibility",
+        descriptionKey: "userGoal.mobilityFlexibility.description",
+        descriptionEn: "Increase range of motion and joint health through consistent mobility work.",
+        taglineKey: "userGoal.mobilityFlexibility.tagline",
+        taglineEn: "Move freely. Age well.",
+        emoji: "🌀",
+        category: "focused",
+    },
+};
+exports.GOAL_CATEGORY_DISPLAY = {
+    appearance: {
+        labelKey: "goalCategory.appearance.label",
+        labelEn: "Appearance",
+    },
+    performance: {
+        labelKey: "goalCategory.performance.label",
+        labelEn: "Performance",
+    },
+    health: {
+        labelKey: "goalCategory.health.label",
+        labelEn: "Health & Wellbeing",
+    },
+    focused: {
+        labelKey: "goalCategory.focused.label",
+        labelEn: "Focused Training",
+    },
+};
+// ---------------------------------------------------------------------------
+// derivePhase — pure helper
+// Shared between Lambda and client — lives here so neither duplicates it
+// ---------------------------------------------------------------------------
+exports.PHASE_ENTRY_CREDIT = {
+    sedentary: 0,
+    "lightly-active": 0,
+    "moderately-active": 6, // enters Momentum directly
+    "very-active": 12, // enters Push directly
+};
+exports.RECENCY_CREDIT = {
+    sedentary: 0,
+    "lightly-active": 0,
+    "moderately-active": 4,
+    "very-active": 8,
+};
+/**
+ * Derive training phase from time + volume + recency.
+ * All three must pass — week count alone is NOT sufficient.
+ * A user doing 12 sessions over one year has not built a training base.
+ *
+ * On goal start day (no sessions yet), pass:
+ *   totalSessions = PHASE_ENTRY_CREDIT[user.fitnessLevel]
+ *   sessionsInLast4Weeks = RECENCY_CREDIT[user.fitnessLevel]
+ */
+function derivePhase(weekNumber, totalSessions, sessionsInLast4Weeks) {
+    // Foundation → needs minimum 2 weeks, 6 sessions, 1 session/week pace
+    if (weekNumber < 2 || totalSessions < 6 || sessionsInLast4Weeks < 4)
+        return "foundation";
+    // Momentum → needs 6 weeks, 12 sessions, ~1.5 sessions/week pace
+    if (weekNumber < 6 || totalSessions < 12 || sessionsInLast4Weeks < 6)
+        return "momentum";
+    // Push → needs 9 weeks, 20 sessions, ~2 sessions/week pace
+    if (weekNumber < 9 || totalSessions < 20 || sessionsInLast4Weeks < 8)
+        return "push";
+    return "peak";
+}
+exports.DAYS_PER_WEEK_OPTIONS = [2, 3, 4, 5];
+exports.GOAL_PHASE_HINTS = {
+    lose_weight: {
+        // "Build the cardio habit"
+        foundation: "goalPhaseHint.loseWeight.foundation.buildCardioHabit",
+        // "Intensity picks up"
+        momentum: "goalPhaseHint.loseWeight.momentum.intensityPicksUp",
+        // "Fat burning at its best"
+        push: "goalPhaseHint.loseWeight.push.fatBurningAtBest",
+        // "Final push to your goal"
+        peak: "goalPhaseHint.loseWeight.peak.finalPushToGoal",
+    },
+    build_muscle: {
+        // "Learn the fundamental movements"
+        foundation: "goalPhaseHint.buildMuscle.foundation.learnFundamentalMovements",
+        // "Volume increases, splits begin"
+        momentum: "goalPhaseHint.buildMuscle.momentum.volumeIncreaseSplitsBegin",
+        // "Real muscle growth happens here"
+        push: "goalPhaseHint.buildMuscle.push.realMuscleGrowthHappensHere",
+        // "Push to your peak output"
+        peak: "goalPhaseHint.buildMuscle.peak.pushToPeakOutput",
+    },
+    lean_and_toned: {
+        // "Start moving consistently"
+        foundation: "goalPhaseHint.leanAndToned.foundation.startMovingConsistently",
+        // "Splits begin, cardio added"
+        momentum: "goalPhaseHint.leanAndToned.momentum.splitsBeginCardioAdded",
+        // "Definition starts to show"
+        push: "goalPhaseHint.leanAndToned.push.definitionStartsToShow",
+        // "Your best shape yet"
+        peak: "goalPhaseHint.leanAndToned.peak.yourBestShapeYet",
+    },
+    glutes_and_legs: {
+        // "Learn hip-hinge and squat patterns"
+        foundation: "goalPhaseHint.glutesAndLegs.foundation.learnHipHingeSquatPatterns",
+        // "Volume builds in lower body"
+        momentum: "goalPhaseHint.glutesAndLegs.momentum.volumeBuildsLowerBody",
+        // "Legs up to 3 times per week"
+        push: "goalPhaseHint.glutesAndLegs.push.legsThreeTimesPerWeek",
+        // "Maximum lower body output"
+        peak: "goalPhaseHint.glutesAndLegs.peak.maximumLowerBodyOutput",
+    },
+    get_stronger: {
+        // "Master the big compound lifts"
+        foundation: "goalPhaseHint.getStronger.foundation.masterBigCompoundLifts",
+        // "Load increases week on week"
+        momentum: "goalPhaseHint.getStronger.momentum.loadIncreasesWeekOnWeek",
+        // "Heavy compound focus"
+        push: "goalPhaseHint.getStronger.push.heavyCompoundFocus",
+        // "Strength peak — test your limits"
+        peak: "goalPhaseHint.getStronger.peak.strengthPeakTestYourLimits",
+    },
+    boost_endurance: {
+        // "Build base aerobic fitness"
+        foundation: "goalPhaseHint.boostEndurance.foundation.buildBaseAerobicFitness",
+        // "Duration and distance increase"
+        momentum: "goalPhaseHint.boostEndurance.momentum.durationDistanceIncrease",
+        // "High volume cardio sessions"
+        push: "goalPhaseHint.boostEndurance.push.highVolumeCardioSessions",
+        // "Peak cardiovascular output"
+        peak: "goalPhaseHint.boostEndurance.peak.peakCardiovascularOutput",
+    },
+    athletic_performance: {
+        // "Movement quality comes first"
+        foundation: "goalPhaseHint.athleticPerformance.foundation.movementQualityFirst",
+        // "Power and speed sessions begin"
+        momentum: "goalPhaseHint.athleticPerformance.momentum.powerSpeedSessionsBegin",
+        // "Sport specific intensity"
+        push: "goalPhaseHint.athleticPerformance.push.sportSpecificIntensity",
+        // "Peak athletic output"
+        peak: "goalPhaseHint.athleticPerformance.peak.peakAthleticOutput",
+    },
+    general_fitness: {
+        // "Build the habit"
+        foundation: "goalPhaseHint.generalFitness.foundation.buildTheHabit",
+        // "Add more variety"
+        momentum: "goalPhaseHint.generalFitness.momentum.addMoreVariety",
+        // "Consistent challenge"
+        push: "goalPhaseHint.generalFitness.push.consistentChallenge",
+        // "Sustained healthy output"
+        peak: "goalPhaseHint.generalFitness.peak.sustainedHealthyOutput",
+    },
+    posture_and_back: {
+        // "Activate neglected muscles"
+        foundation: "goalPhaseHint.postureAndBack.foundation.activateNeglectedMuscles",
+        // "Posterior chain strengthens"
+        momentum: "goalPhaseHint.postureAndBack.momentum.posteriorChainStrengthens",
+        // "Pull heavy split begins"
+        push: "goalPhaseHint.postureAndBack.push.pullHeavySplitBegins",
+        // "Posture transformation complete"
+        peak: "goalPhaseHint.postureAndBack.peak.postureTransformationComplete",
+    },
+    stress_relief: {
+        // "Low pressure movement"
+        foundation: "goalPhaseHint.stressRelief.foundation.lowPressureMovement",
+        // "Rhythm and routine develop"
+        momentum: "goalPhaseHint.stressRelief.momentum.rhythmAndRoutineDevelop",
+        // "Endorphin peak"
+        push: "goalPhaseHint.stressRelief.push.endorphinPeak",
+        // "Sustained stress release"
+        peak: "goalPhaseHint.stressRelief.peak.sustainedStressRelease",
+    },
+    rehabilitation: {
+        // "Safe mobility work only"
+        foundation: "goalPhaseHint.rehabilitation.foundation.safeMobilityWorkOnly",
+        // "Strength carefully reintroduced"
+        momentum: "goalPhaseHint.rehabilitation.momentum.strengthCarefullyReintroduced",
+        // "Full movement patterns restored"
+        push: "goalPhaseHint.rehabilitation.push.fullMovementPatternsRestored",
+        // "Back to full function"
+        peak: "goalPhaseHint.rehabilitation.peak.backToFullFunction",
+    },
+    core_strength: {
+        // "Core activation patterns"
+        foundation: "goalPhaseHint.coreStrength.foundation.coreActivationPatterns",
+        // "Volume and difficulty rise"
+        momentum: "goalPhaseHint.coreStrength.momentum.volumeAndDifficultyRise",
+        // "Heavy compound core work"
+        push: "goalPhaseHint.coreStrength.push.heavyCompoundCoreWork",
+        // "Maximum core output"
+        peak: "goalPhaseHint.coreStrength.peak.maximumCoreOutput",
+    },
+    mobility_flexibility: {
+        // "Daily mobility habit"
+        foundation: "goalPhaseHint.mobilityFlexibility.foundation.dailyMobilityHabit",
+        // "Range of motion grows"
+        momentum: "goalPhaseHint.mobilityFlexibility.momentum.rangeOfMotionGrows",
+        // "Full body flexibility"
+        push: "goalPhaseHint.mobilityFlexibility.push.fullBodyFlexibility",
+        // "Elite movement quality"
+        peak: "goalPhaseHint.mobilityFlexibility.peak.eliteMovementQuality",
+    },
+};

package/dist/types/goalFeature/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./goalJourney";
+export type * from "./TApiGoalContextRes";
+export * from "./utilGoal";

package/dist/types/goalFeature/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// shared/src/types/goalFeature/index.ts
+__exportStar(require("./goalJourney"), exports);
+__exportStar(require("./utilGoal"), exports);

package/dist/types/goalFeature/utilGoal.d.ts

@@ -0,0 +1,22 @@
+import { TMuscleFatigueResult } from "../../utils";
+import { TSessionIntent } from "./goalJourney";
+import { TGoalContext, TGoalProfile, TIntentRecommendation } from "./TApiGoalContextRes";
+export declare function resolveGoalContext(goalProfile: TGoalProfile, recentSessions: {
+    intentId: TSessionIntent | undefined;
+    createdAt: string;
+}[], now?: Date): TGoalContext | null;
+/**
+ * Recommend the next session intent.
+ *
+ * Decision pipeline (strict priority):
+ *   1. GLOBAL RECOVERY   avgFatigue > 72              → "mobility"
+ *   2. RETURNING USER    gap >= 7 days                → first non-rest slot
+ *   3. GAP BRIDGE        gap 3-7 days                 → most overdue slot
+ *   4. STRUCTURE FOLLOW  gap < 3 days                 → next slot (circular)
+ *   5. MUSCLE OVERRIDE   cluster fatigue > 65         → highest-readiness alt
+ *
+ * Output is always a valid TWorkoutIntent.
+ * Never outputs: "rest", "arms", "back", "unstructured".
+ * rationale is an i18n key — resolve via t() on the FE.
+ */
+export declare function recommendNextIntent(fatigue: TMuscleFatigueResult, goalContext: TGoalContext): TIntentRecommendation;