@sunsteel/contracts 0.40.0 → 0.42.0

package/dist/index.cjs

@@ -22,6 +22,11 @@ var index_exports = {};
 __export(index_exports, {
   ACHIEVEMENT_CATEGORIES: () => ACHIEVEMENT_CATEGORIES,
   ACHIEVEMENT_DEFINITIONS: () => ACHIEVEMENT_DEFINITIONS,
+  COMEBACK_MIN_INACTIVE_DAYS: () => COMEBACK_MIN_INACTIVE_DAYS,
+  COMEBACK_RECOGNITION_LIMIT: () => COMEBACK_RECOGNITION_LIMIT,
+  COMEBACK_REQUIRED_ACTIVE_DAYS: () => COMEBACK_REQUIRED_ACTIVE_DAYS,
+  COMEBACK_SESSION_LOOKBACK: () => COMEBACK_SESSION_LOOKBACK,
+  COMEBACK_WINDOW_DAYS: () => COMEBACK_WINDOW_DAYS,
   EXERCISE_EQUIPMENT: () => EXERCISE_EQUIPMENT,
   EXERCISE_MECHANICS: () => EXERCISE_MECHANICS,
   FOLLOW_SUGGESTIONS_DEFAULT_LIMIT: () => FOLLOW_SUGGESTIONS_DEFAULT_LIMIT,
@@ -62,6 +67,7 @@ __export(index_exports, {
   SCHEDULE_MOVE_MAX_DAYS: () => SCHEDULE_MOVE_MAX_DAYS,
   SCHEDULE_OVERRIDES_MAX_RANGE_DAYS: () => SCHEDULE_OVERRIDES_MAX_RANGE_DAYS,
   SCHEDULE_OVERRIDE_KINDS: () => SCHEDULE_OVERRIDE_KINDS,
+  SCHEDULE_SKIP_PAST_DAYS: () => SCHEDULE_SKIP_PAST_DAYS,
   SESSION_SHARE_DEFAULT_FIELDS: () => SESSION_SHARE_DEFAULT_FIELDS,
   SESSION_SHARE_FIELDS: () => SESSION_SHARE_FIELDS,
   SESSION_SHARE_MAX_ACTIVE_LINKS: () => SESSION_SHARE_MAX_ACTIVE_LINKS,
@@ -357,6 +363,11 @@ var RENAISSANCE_RANK_DEFINITIONS = [
     minimumActiveWeeks: 52
   }
 ];
+var COMEBACK_MIN_INACTIVE_DAYS = 14;
+var COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
+var COMEBACK_WINDOW_DAYS = 14;
+var COMEBACK_SESSION_LOOKBACK = 500;
+var COMEBACK_RECOGNITION_LIMIT = 20;
 
 // src/routine.ts
 var ROUTINE_SCHEDULE_MODES = ["WEEKLY", "ROTATION"];
@@ -387,8 +398,9 @@ var ROUTINE_VERSION_NAME_MAX = 60;
 var ROUTINE_VERSION_KINDS = ["SAVED", "BEFORE_RESTORE"];
 
 // src/schedule.ts
-var SCHEDULE_OVERRIDE_KINDS = ["MOVE"];
+var SCHEDULE_OVERRIDE_KINDS = ["MOVE", "SKIP"];
 var SCHEDULE_MOVE_MAX_DAYS = 6;
+var SCHEDULE_SKIP_PAST_DAYS = 6;
 var SCHEDULE_OVERRIDES_MAX_RANGE_DAYS = 62;
 
 // src/workout.ts
@@ -430,6 +442,11 @@ var PLATEAU_MIN_SESSIONS_MAX = 8;
 0 && (module.exports = {
   ACHIEVEMENT_CATEGORIES,
   ACHIEVEMENT_DEFINITIONS,
+  COMEBACK_MIN_INACTIVE_DAYS,
+  COMEBACK_RECOGNITION_LIMIT,
+  COMEBACK_REQUIRED_ACTIVE_DAYS,
+  COMEBACK_SESSION_LOOKBACK,
+  COMEBACK_WINDOW_DAYS,
   EXERCISE_EQUIPMENT,
   EXERCISE_MECHANICS,
   FOLLOW_SUGGESTIONS_DEFAULT_LIMIT,
@@ -470,6 +487,7 @@ var PLATEAU_MIN_SESSIONS_MAX = 8;
   SCHEDULE_MOVE_MAX_DAYS,
   SCHEDULE_OVERRIDES_MAX_RANGE_DAYS,
   SCHEDULE_OVERRIDE_KINDS,
+  SCHEDULE_SKIP_PAST_DAYS,
   SESSION_SHARE_DEFAULT_FIELDS,
   SESSION_SHARE_FIELDS,
   SESSION_SHARE_MAX_ACTIVE_LINKS,

package/dist/index.d.cts

@@ -1097,6 +1097,35 @@ interface AchievementCategoryProgress {
     nextMilestone: AchievementDefinition | null;
     remaining: number;
 }
+/**
+ * ACH-05 recognises a return only after the athlete has rebuilt a small,
+ * recovery-compatible pattern. The break is counted as full local calendar
+ * days without a completed session; repeated sessions on one date count once.
+ */
+declare const COMEBACK_MIN_INACTIVE_DAYS = 14;
+declare const COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
+declare const COMEBACK_WINDOW_DAYS = 14;
+declare const COMEBACK_SESSION_LOOKBACK = 500;
+declare const COMEBACK_RECOGNITION_LIMIT = 20;
+interface ComebackRecognition {
+    id: string;
+    inactiveDays: number;
+    returnedAt: IsoDateString;
+    recognizedAt: IsoDateString;
+    sourceSessionId: string;
+    activeDays: number;
+    /** Inclusive local-calendar span from the return through recognition. */
+    windowDays: number;
+}
+interface ComebackRecognitionSummary {
+    minimumInactiveDays: number;
+    requiredActiveDays: number;
+    windowDays: number;
+    /** Most recent first, capped by COMEBACK_RECOGNITION_LIMIT. */
+    recognitions: ComebackRecognition[];
+    /** True when older completed-session events fell outside the bounded scan. */
+    historyTruncated: boolean;
+}
 /** Stable successful response of GET /achievements. */
 interface AchievementsResponse {
     analyticsReady: boolean;
@@ -1105,6 +1134,7 @@ interface AchievementsResponse {
     achievements: EarnedAchievement[];
     rank: RenaissanceRankProgress | null;
     milestoneProgress: AchievementCategoryProgress[];
+    comeback: ComebackRecognitionSummary | null;
 }
 
 /**
@@ -1295,14 +1325,19 @@ interface RestoreRoutineVersionResponse {
 type CalendarDate = string;
 /**
  * The schedule-instance model: per-date overrides of a routine's plan. MOVE
- * puts one weekly occurrence on another date (SCHED-04); SCHED-05 adds its
- * own kinds. Overrides are kept by calendar date, not by routine day, because
- * routine edits replace the days.
+ * puts one weekly occurrence on another date (SCHED-04); SKIP marks it
+ * skipped on purpose (SCHED-05). Overrides are kept by calendar date, not by
+ * routine day, because routine edits replace the days.
  */
-declare const SCHEDULE_OVERRIDE_KINDS: readonly ["MOVE"];
+declare const SCHEDULE_OVERRIDE_KINDS: readonly ["MOVE", "SKIP"];
 type ScheduleOverrideKind = (typeof SCHEDULE_OVERRIDE_KINDS)[number];
 /** A move goes at most this many days before or after the planned date. */
 declare const SCHEDULE_MOVE_MAX_DAYS = 6;
+/**
+ * SCHED-05: a skip can explain a planned day up to this many days back;
+ * ahead, any planned day can be skipped.
+ */
+declare const SCHEDULE_SKIP_PAST_DAYS = 6;
 /** Overrides are read for at most this many days at once. */
 declare const SCHEDULE_OVERRIDES_MAX_RANGE_DAYS = 62;
 interface ScheduleOverride {
@@ -1311,7 +1346,7 @@ interface ScheduleOverride {
     /** The planned date this override changes. */
     date: CalendarDate;
     kind: ScheduleOverrideKind;
-    /** MOVE: the date the occurrence now falls on. */
+    /** MOVE: the date the occurrence now falls on; null for SKIP. */
     toDate: CalendarDate | null;
     createdAt: IsoDateString;
 }
@@ -1332,5 +1367,13 @@ interface MoveOccurrenceRequest {
     date: CalendarDate;
     toDate: CalendarDate;
 }
+/**
+ * `PUT /schedule/overrides/skip`: marks one occurrence skipped. A moved
+ * occurrence is skipped as a whole; undoing is `DELETE` like a move.
+ */
+interface SkipOccurrenceRequest {
+    routineId: string;
+    date: CalendarDate;
+}
 
-export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, type CalendarDate, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MoveOccurrenceRequest, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_MIN_SESSIONS_MAX, PLATEAU_MIN_SESSIONS_MIN, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauPreferences, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, ROUTINE_DAYS_MAX, ROUTINE_DAY_NAME_MAX, ROUTINE_SCHEDULE_MODES, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse, routineDayLabel };
+export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, COMEBACK_MIN_INACTIVE_DAYS, COMEBACK_RECOGNITION_LIMIT, COMEBACK_REQUIRED_ACTIVE_DAYS, COMEBACK_SESSION_LOOKBACK, COMEBACK_WINDOW_DAYS, type CalendarDate, type ComebackRecognition, type ComebackRecognitionSummary, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MoveOccurrenceRequest, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_MIN_SESSIONS_MAX, PLATEAU_MIN_SESSIONS_MIN, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauPreferences, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, ROUTINE_DAYS_MAX, ROUTINE_DAY_NAME_MAX, ROUTINE_SCHEDULE_MODES, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SCHEDULE_SKIP_PAST_DAYS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type SkipOccurrenceRequest, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse, routineDayLabel };

package/dist/index.d.ts

@@ -1097,6 +1097,35 @@ interface AchievementCategoryProgress {
     nextMilestone: AchievementDefinition | null;
     remaining: number;
 }
+/**
+ * ACH-05 recognises a return only after the athlete has rebuilt a small,
+ * recovery-compatible pattern. The break is counted as full local calendar
+ * days without a completed session; repeated sessions on one date count once.
+ */
+declare const COMEBACK_MIN_INACTIVE_DAYS = 14;
+declare const COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
+declare const COMEBACK_WINDOW_DAYS = 14;
+declare const COMEBACK_SESSION_LOOKBACK = 500;
+declare const COMEBACK_RECOGNITION_LIMIT = 20;
+interface ComebackRecognition {
+    id: string;
+    inactiveDays: number;
+    returnedAt: IsoDateString;
+    recognizedAt: IsoDateString;
+    sourceSessionId: string;
+    activeDays: number;
+    /** Inclusive local-calendar span from the return through recognition. */
+    windowDays: number;
+}
+interface ComebackRecognitionSummary {
+    minimumInactiveDays: number;
+    requiredActiveDays: number;
+    windowDays: number;
+    /** Most recent first, capped by COMEBACK_RECOGNITION_LIMIT. */
+    recognitions: ComebackRecognition[];
+    /** True when older completed-session events fell outside the bounded scan. */
+    historyTruncated: boolean;
+}
 /** Stable successful response of GET /achievements. */
 interface AchievementsResponse {
     analyticsReady: boolean;
@@ -1105,6 +1134,7 @@ interface AchievementsResponse {
     achievements: EarnedAchievement[];
     rank: RenaissanceRankProgress | null;
     milestoneProgress: AchievementCategoryProgress[];
+    comeback: ComebackRecognitionSummary | null;
 }
 
 /**
@@ -1295,14 +1325,19 @@ interface RestoreRoutineVersionResponse {
 type CalendarDate = string;
 /**
  * The schedule-instance model: per-date overrides of a routine's plan. MOVE
- * puts one weekly occurrence on another date (SCHED-04); SCHED-05 adds its
- * own kinds. Overrides are kept by calendar date, not by routine day, because
- * routine edits replace the days.
+ * puts one weekly occurrence on another date (SCHED-04); SKIP marks it
+ * skipped on purpose (SCHED-05). Overrides are kept by calendar date, not by
+ * routine day, because routine edits replace the days.
  */
-declare const SCHEDULE_OVERRIDE_KINDS: readonly ["MOVE"];
+declare const SCHEDULE_OVERRIDE_KINDS: readonly ["MOVE", "SKIP"];
 type ScheduleOverrideKind = (typeof SCHEDULE_OVERRIDE_KINDS)[number];
 /** A move goes at most this many days before or after the planned date. */
 declare const SCHEDULE_MOVE_MAX_DAYS = 6;
+/**
+ * SCHED-05: a skip can explain a planned day up to this many days back;
+ * ahead, any planned day can be skipped.
+ */
+declare const SCHEDULE_SKIP_PAST_DAYS = 6;
 /** Overrides are read for at most this many days at once. */
 declare const SCHEDULE_OVERRIDES_MAX_RANGE_DAYS = 62;
 interface ScheduleOverride {
@@ -1311,7 +1346,7 @@ interface ScheduleOverride {
     /** The planned date this override changes. */
     date: CalendarDate;
     kind: ScheduleOverrideKind;
-    /** MOVE: the date the occurrence now falls on. */
+    /** MOVE: the date the occurrence now falls on; null for SKIP. */
     toDate: CalendarDate | null;
     createdAt: IsoDateString;
 }
@@ -1332,5 +1367,13 @@ interface MoveOccurrenceRequest {
     date: CalendarDate;
     toDate: CalendarDate;
 }
+/**
+ * `PUT /schedule/overrides/skip`: marks one occurrence skipped. A moved
+ * occurrence is skipped as a whole; undoing is `DELETE` like a move.
+ */
+interface SkipOccurrenceRequest {
+    routineId: string;
+    date: CalendarDate;
+}
 
-export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, type CalendarDate, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MoveOccurrenceRequest, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_MIN_SESSIONS_MAX, PLATEAU_MIN_SESSIONS_MIN, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauPreferences, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, ROUTINE_DAYS_MAX, ROUTINE_DAY_NAME_MAX, ROUTINE_SCHEDULE_MODES, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse, routineDayLabel };
+export { ACHIEVEMENT_CATEGORIES, ACHIEVEMENT_DEFINITIONS, type AchievementCategory, type AchievementCategoryProgress, type AchievementDefinition, type AchievementUnlockedEventPayload, type AchievementsResponse, type Brand, COMEBACK_MIN_INACTIVE_DAYS, COMEBACK_RECOGNITION_LIMIT, COMEBACK_REQUIRED_ACTIVE_DAYS, COMEBACK_SESSION_LOOKBACK, COMEBACK_WINDOW_DAYS, type CalendarDate, type ComebackRecognition, type ComebackRecognitionSummary, type CreateRoutineDayInput, type CreateRoutineExerciseInput, type CreateRoutineRequest, type CreateRoutineVersionRequest, type CreateSessionShareRequest, EXERCISE_EQUIPMENT, EXERCISE_MECHANICS, type EarnedAchievement, type EarnedPersonalRecord, type Exercise, type ExerciseEquipment, type ExerciseId, type ExerciseMechanic, type ExercisePerformanceHistoryQuery, type ExercisePerformanceHistoryResponse, type ExercisePerformancePrescription, type ExercisePerformancePrescriptionSet, type ExercisePerformanceSession, type ExercisePerformanceSet, type ExercisePerformanceSummary, type ExercisePlateau, type ExerciseStrengthSummary, type ExerciseStrengthTrendPoint, type ExerciseStrengthTrendQuery, type ExerciseStrengthTrendResponse, FOLLOW_SUGGESTIONS_DEFAULT_LIMIT, FOLLOW_SUGGESTIONS_MAX_LIMIT, FOLLOW_SUGGESTION_REASONS, type FinishStatus, type FinishWorkoutRequest, type FinishWorkoutResponse, type FollowSuggestion, type FollowSuggestionReason, type FollowSuggestionsResponse, type IsoDateString, type ListSessionsParams, MEASURABLE_GOALS_MAX, MEASURABLE_GOAL_DIRECTIONS, MEASURABLE_GOAL_TYPES, MOVEMENT_PATTERNS, MUSCLE_GROUPS, type MeasurableGoal, type MeasurableGoalDirection, type MeasurableGoalExercise, type MeasurableGoalInput, type MeasurableGoalType, type MoveOccurrenceRequest, type MovementPattern, type MuscleGroup, type MuscleGroupHeatmapQuery, type MuscleGroupHeatmapResponse, type MuscleGroupHeatmapValue, type MuscleGroupHeatmapWeek, type MuscleVolumeTrendSeries, PLATEAU_MIN_DAYS_SINCE_BEST, PLATEAU_MIN_SESSIONS, PLATEAU_MIN_SESSIONS_MAX, PLATEAU_MIN_SESSIONS_MIN, PLATEAU_RECENT_DAYS, PLATEAU_WINDOW_DAYS, PREFERRED_TRAINING_STYLE_VALUES, PROFILE_BIO_MAX_LENGTH, PROFILE_FAVORITE_EXERCISES_MAX, PROFILE_LOCATION_MAX_LENGTH, PROFILE_TRAINING_DISCIPLINES_MAX, PROFILE_TRAINING_GOALS_MAX, PROFILE_VISIBILITY_VALUES, PROGRESSION_SCHEMES, PROGRESS_TIMELINE_EVENT_TYPES, type PaginatedResponse, type PersonalGoalProgress, type PersonalGoalsResponse, type PersonalRecordEntry, type PersonalRecordKind, type PlatePairInventory, type PlateauPreferences, type PlateauSet, type PlateausResponse, type PreferredTrainingStyle, type PreviousPerformanceResponse, type PreviousSessionRecap, type PreviousSetPerformance, type ProfileDiscoverySettings, type ProfileFavoriteExercise, type ProfilePrivacySettings, type ProfileViewerAccess, type ProfileVisibility, type ProgressTimelineEventType, type ProgressTimelineItem, type ProgressTimelinePersonalRecordItem, type ProgressTimelineProgressionItem, type ProgressTimelineQuery, type ProgressTimelineRecordPerformance, type ProgressTimelineRecordReason, type ProgressTimelineResponse, type ProgressTimelineSessionContext, type ProgressionChange, type ProgressionRule, type ProgressionScheme, type ProgressionSetChange, type PublicBodyMetrics, type PublicTrainingSummary, type PublicUserProfile, RELATIONSHIP_LIST_DEFAULT_LIMIT, RELATIONSHIP_LIST_KINDS, RELATIONSHIP_LIST_MAX_LIMIT, RENAISSANCE_RANK_DEFINITIONS, REP_TYPES, RESERVED_USERNAMES, ROUTINE_DAYS_MAX, ROUTINE_DAY_NAME_MAX, ROUTINE_SCHEDULE_MODES, ROUTINE_VERSIONS_MAX, ROUTINE_VERSION_KINDS, ROUTINE_VERSION_NAME_MAX, type RecentActivityEntry, type RelationshipListKind, type RelationshipListQuery, type RelationshipListResponse, type RelationshipMember, type RenaissanceRankDefinition, type RenaissanceRankProgress, type RepType, type ReplaceMeasurableGoalsRequest, type ReplaceTrainingLocationsRequest, type RestoreRoutineVersionResponse, type Routine, type RoutineDay, type RoutineDayId, type RoutineExercise, type RoutineId, type RoutineScheduleMode, type RoutineSet, type RoutineVersion, type RoutineVersionDay, type RoutineVersionExercise, type RoutineVersionKind, type RoutineVersionSetup, type RoutineVersionsResponse, SCHEDULE_MOVE_MAX_DAYS, SCHEDULE_OVERRIDES_MAX_RANGE_DAYS, SCHEDULE_OVERRIDE_KINDS, SCHEDULE_SKIP_PAST_DAYS, SESSION_SHARE_DEFAULT_FIELDS, SESSION_SHARE_FIELDS, SESSION_SHARE_MAX_ACTIVE_LINKS, SEXES, STARRED_EXERCISES_MAX, type ScheduleOverride, type ScheduleOverrideKind, type ScheduleOverridesQuery, type ScheduleOverridesResponse, type SessionComparisonExercise, type SessionComparisonQuery, type SessionComparisonResponse, type SessionComparisonRoutineDay, type SessionComparisonSession, type SessionComparisonSet, type SessionExerciseSubstitution, type SessionRecapRecord, type SessionShare, type SessionShareField, type SessionShareListResponse, type SetAccountTimeZoneRequest, type SetLog, type Sex, type SharedSessionOwner, type SharedSessionRecap, type SkipOccurrenceRequest, type StarredExercise, type StarredExercisesResponse, type StartWorkoutRequest, type StartWorkoutResponse, type StreakMilestoneEventPayload, type SubstituteSessionExerciseRequest, type SubstituteSessionExerciseResponse, type SupabaseAuthResponse, type SupabaseAuthUser, type SupabaseMigrationResponse, TRAINING_DISCIPLINE_VALUES, TRAINING_EVENT_TYPES, TRAINING_EXPERIENCE_LEVEL_VALUES, TRAINING_GOAL_VALUES, type TrainingDiscipline, type TrainingEventType, type TrainingExperienceLevel, type TrainingGoal, type TrainingIdentity, type TrainingLocationPreference, type TrainingLocationPreferenceInput, USERNAME_MAX_LENGTH, USERNAME_MIN_LENGTH, USERNAME_PATTERN_SOURCE, type UpdateProfileDiscoveryRequest, type UpdateProfilePrivacyRequest, type UpdateProfileRequest, type UpdateRoutineRequest, type UpsertSetLogRequest, type UpsertSetLogResponse, type UserId, type UserProfile, type UserSearchResponse, type VolumeTrendPoint, type VolumeTrendQuery, type VolumeTrendResponse, type VolumeTrendSeries, WEIGHT_UNITS, WORKOUT_SESSION_STATUSES, type WeightUnit, type WorkoutAnalyticsStatus, type WorkoutProgressQuery, type WorkoutProgressResponse, type WorkoutSession, type WorkoutSessionId, type WorkoutSessionListResponse, type WorkoutSessionRecap, type WorkoutSessionSnapshotV1, type WorkoutSessionStatus, type WorkoutSessionSummary, type WorkoutStatsQuery, type WorkoutStatsResponse, routineDayLabel };

package/dist/index.js

@@ -275,6 +275,11 @@ var RENAISSANCE_RANK_DEFINITIONS = [
     minimumActiveWeeks: 52
   }
 ];
+var COMEBACK_MIN_INACTIVE_DAYS = 14;
+var COMEBACK_REQUIRED_ACTIVE_DAYS = 3;
+var COMEBACK_WINDOW_DAYS = 14;
+var COMEBACK_SESSION_LOOKBACK = 500;
+var COMEBACK_RECOGNITION_LIMIT = 20;
 
 // src/routine.ts
 var ROUTINE_SCHEDULE_MODES = ["WEEKLY", "ROTATION"];
@@ -305,8 +310,9 @@ var ROUTINE_VERSION_NAME_MAX = 60;
 var ROUTINE_VERSION_KINDS = ["SAVED", "BEFORE_RESTORE"];
 
 // src/schedule.ts
-var SCHEDULE_OVERRIDE_KINDS = ["MOVE"];
+var SCHEDULE_OVERRIDE_KINDS = ["MOVE", "SKIP"];
 var SCHEDULE_MOVE_MAX_DAYS = 6;
+var SCHEDULE_SKIP_PAST_DAYS = 6;
 var SCHEDULE_OVERRIDES_MAX_RANGE_DAYS = 62;
 
 // src/workout.ts
@@ -347,6 +353,11 @@ var PLATEAU_MIN_SESSIONS_MAX = 8;
 export {
   ACHIEVEMENT_CATEGORIES,
   ACHIEVEMENT_DEFINITIONS,
+  COMEBACK_MIN_INACTIVE_DAYS,
+  COMEBACK_RECOGNITION_LIMIT,
+  COMEBACK_REQUIRED_ACTIVE_DAYS,
+  COMEBACK_SESSION_LOOKBACK,
+  COMEBACK_WINDOW_DAYS,
   EXERCISE_EQUIPMENT,
   EXERCISE_MECHANICS,
   FOLLOW_SUGGESTIONS_DEFAULT_LIMIT,
@@ -387,6 +398,7 @@ export {
   SCHEDULE_MOVE_MAX_DAYS,
   SCHEDULE_OVERRIDES_MAX_RANGE_DAYS,
   SCHEDULE_OVERRIDE_KINDS,
+  SCHEDULE_SKIP_PAST_DAYS,
   SESSION_SHARE_DEFAULT_FIELDS,
   SESSION_SHARE_FIELDS,
   SESSION_SHARE_MAX_ACTIVE_LINKS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sunsteel/contracts",
-  "version": "0.40.0",
+  "version": "0.42.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ezee969/sunsteel-contracts.git"