feat: add max session time setting and auto-pause functionality for Pomodoro sessions

Author: murdercode

src/core/pomodoro-timer.js

@@ -30,6 +30,8 @@ export class PomodoroTimer {
         this.currentSessionElapsedTime = 0; // Actual elapsed time for current session (in seconds)
         this.lastCompletedSessionTime = 0; // Time of the last completed session for undo functionality
         this.sessionCompletedButNotSaved = false; // Flag to track if session completed but not saved yet
+        this.maxSessionTime = 120 * 60 * 1000; // Default 2 hours in milliseconds
+        this.maxSessionTimeReached = false; // Flag to track if max session time was reached
 
         // Timer accuracy tracking (for background throttling fix)
         this.timerStartTime = null; // When the timer was started (Date.now())
@@ -667,6 +669,9 @@ export class PomodoroTimer {
                 }
             }
 
+            // Check if max session time has been reached
+            this.checkMaxSessionTime();
+
             this.updateDisplay();
 
             // Warning when less than 2 minutes remaining
@@ -696,6 +701,35 @@ export class PomodoroTimer {
         }
     }
 
+    checkMaxSessionTime() {
+        // Only check during focus sessions and if a session is active
+        if (this.currentMode !== 'focus' || !this.sessionStartTime || this.maxSessionTimeReached) {
+            return;
+        }
+
+        const now = Date.now();
+        const sessionElapsed = now - this.sessionStartTime;
+
+        // Check if session has exceeded max time
+        if (sessionElapsed >= this.maxSessionTime) {
+            this.maxSessionTimeReached = true;
+            this.pauseTimer();
+            
+            // Show notification
+            const maxTimeInMinutes = Math.floor(this.maxSessionTime / (60 * 1000));
+            NotificationUtils.showNotificationPing(
+                `Session automatically paused after ${maxTimeInMinutes} minutes. Take a break! 🛑`,
+                'warning'
+            );
+            
+            // Show desktop notification if enabled
+            NotificationUtils.showDesktopNotification(
+                'Session Time Limit Reached',
+                `Your session has been automatically paused after ${maxTimeInMinutes} minutes. Consider taking a break!`
+            );
+        }
+    }
+
     pauseTimer() {
         if (this.isRunning) {
             this.isRunning = false;
@@ -748,6 +782,7 @@ export class PomodoroTimer {
         this.sessionStartTime = null;
         this.currentSessionElapsedTime = 0;
         this.sessionCompletedButNotSaved = false; // Reset flag
+        this.maxSessionTimeReached = false; // Reset max session time flag
 
         // Reset timer accuracy tracking
         this.timerStartTime = null;
@@ -1022,6 +1057,7 @@ export class PomodoroTimer {
         this.sessionStartTime = null;
         this.currentSessionElapsedTime = 0;
         this.sessionCompletedButNotSaved = false; // Reset flag
+        this.maxSessionTimeReached = false; // Reset max session time flag
 
         // Reset timer accuracy tracking
         this.timerStartTime = null;
@@ -1617,6 +1653,7 @@ export class PomodoroTimer {
         this.currentSessionElapsedTime = 0;
         this.lastCompletedSessionTime = 0;
         this.sessionCompletedButNotSaved = false; // Reset flag
+        this.maxSessionTimeReached = false; // Reset max session time flag
 
         // Reset timer accuracy tracking
         this.timerStartTime = null;
@@ -2148,6 +2185,9 @@ export class PomodoroTimer {
         }
 
         this.totalSessions = settings.timer.total_sessions;
+        
+        // Update max session time (convert from minutes to milliseconds)
+        this.maxSessionTime = (settings.timer.max_session_time || 120) * 60 * 1000;
 
         // If timer is not running, update current time remaining
         if (!this.isRunning) {
@@ -2231,6 +2271,7 @@ export class PomodoroTimer {
         this.sessionStartTime = null;
         this.currentSessionElapsedTime = 0;
         this.lastCompletedSessionTime = 0;
+        this.maxSessionTimeReached = false; // Reset max session time flag
 
         // Reset timer accuracy tracking
         this.timerStartTime = null;

src/index.html

@@ -543,6 +543,12 @@ <h3 class="section-header">Timer Durations</h3>
                 <input type="number" id="total-sessions" min="1" max="20" value="10">
                 <p class="setting-description">Number of focus sessions to complete each day</p>
               </div>
+
+              <div class="setting-item">
+                <label for="max-session-time">Max Session Time (minutes):</label>
+                <input type="number" id="max-session-time" min="30" max="480" value="120">
+                <p class="setting-description">Maximum time per session before auto-pause (default: 2 hours)</p>
+              </div>
             </div>
           </div>
 

src/managers/settings-manager.js

@@ -99,7 +99,8 @@ export class SettingsManager {
                 break_duration: 5,
                 long_break_duration: 20,
                 total_sessions: 10,
-                weekly_goal_minutes: 125
+                weekly_goal_minutes: 125,
+                max_session_time: 120 // 2 hours in minutes
             },
             notifications: {
                 desktop_notifications: true,
@@ -133,6 +134,12 @@ export class SettingsManager {
         document.getElementById('break-duration').value = this.settings.timer.break_duration;
         document.getElementById('long-break-duration').value = this.settings.timer.long_break_duration;
         document.getElementById('total-sessions').value = this.settings.timer.total_sessions;
+        
+        // Populate max session time
+        const maxSessionTimeField = document.getElementById('max-session-time');
+        if (maxSessionTimeField) {
+            maxSessionTimeField.value = this.settings.timer.max_session_time || 120;
+        }
 
         // Populate weekly goal
         const weeklyGoalField = document.getElementById('weekly-goal-minutes');
@@ -421,6 +428,12 @@ export class SettingsManager {
             this.settings.timer.break_duration = parseInt(document.getElementById('break-duration').value);
             this.settings.timer.long_break_duration = parseInt(document.getElementById('long-break-duration').value);
             this.settings.timer.total_sessions = parseInt(document.getElementById('total-sessions').value);
+            
+            // Max session time setting
+            const maxSessionTimeField = document.getElementById('max-session-time');
+            if (maxSessionTimeField) {
+                this.settings.timer.max_session_time = parseInt(maxSessionTimeField.value) || 120;
+            }
 
             // Appearance settings
             const themeSelect = document.getElementById('theme-select');
@@ -527,7 +540,8 @@ export class SettingsManager {
             'break-duration',
             'long-break-duration',
             'total-sessions',
-            'weekly-goal-minutes'
+            'weekly-goal-minutes',
+            'max-session-time'
         ];
 
         // Appearance settings
@@ -629,6 +643,12 @@ export class SettingsManager {
             this.settings.timer.long_break_duration = parseInt(document.getElementById('long-break-duration').value);
             this.settings.timer.total_sessions = parseInt(document.getElementById('total-sessions').value);
 
+            // Max session time setting
+            const maxSessionTimeField = document.getElementById('max-session-time');
+            if (maxSessionTimeField) {
+                this.settings.timer.max_session_time = parseInt(maxSessionTimeField.value) || 120;
+            }
+
             // Weekly goal setting
             const weeklyGoalField = document.getElementById('weekly-goal-minutes');
             if (weeklyGoalField) {

src/utils/theme-loader.js

@@ -39,7 +39,7 @@ class ThemeLoader {
         // that gets updated by the build process or manually maintained
 
         // This could be enhanced to use a build-time script that generates this list
-                                                                                                                                                                                                                                const knownThemes = [
+                                                                                                                                                                                                                                                                const knownThemes = [
             'espresso.css',
             'pipboy.css',
             'pommodore64.css'