Release v1.0.8: Timer Accuracy Fix

.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm run build:*)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

.gitignore

@@ -18,3 +18,7 @@ Thumbs.db
 
 # Obsidian
 data.json
+
+# Development/Documentation (not for distribution)
+RELEASE-GUIDE.md
+.claude/

README.md

@@ -4,7 +4,7 @@ A powerful task management and focus timer plugin for [Obsidian](https://obsidia
 
 ![Focus Task Banner](https://img.shields.io/badge/Obsidian-Plugin-7c3aed?style=for-the-badge&logo=obsidian&logoColor=white)
 ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
-![Version](https://img.shields.io/badge/Version-1.0.6-blue?style=for-the-badge)
+![Version](https://img.shields.io/badge/Version-1.0.8-blue?style=for-the-badge)
 
 ## 🎯 Overview
 
@@ -49,7 +49,7 @@ Focus Task brings the power of time-boxed task management directly into your Obs
 - **Daily Note Logging**: Automatically log completed tasks to your daily notes with timestamps and performance metrics
 
 ### 🎨 User Experience
-- **Status Bar Timer**: timer that stays visible while you work
+- **Status Bar Timer**: Timer that stays visible while you work
 - **Celebration Messages**: Fun, randomized messages when you complete tasks
 - **Sound Notifications**: Audio alerts for timer completion and task completion
 - **Keyboard Shortcuts**: Quick access to common actions
@@ -66,8 +66,11 @@ Focus Task brings the power of time-boxed task management directly into your Obs
 ### Manual Installation
 1. Download the latest release from the [releases page](https://git.cribdev.com/crib/focus-task/releases)
 2. Extract the files to your vault's `.obsidian/plugins/focus-task/` folder
-3. Reload Obsidian
-4. Enable the plugin in Settings → Community Plugins
+3. **⚠️ IMPORTANT**: When updating, do NOT replace or delete the existing `data.json` file - this contains all your tasks, settings, and progress!
+4. Reload Obsidian
+5. Enable the plugin in Settings → Community Plugins
+
+> **Note**: Only copy the three plugin files (`main.js`, `manifest.json`, `styles.css`) when updating. Your `data.json` file stores all your tasks and settings and should never be replaced.
 
 ### Building from Source
 ```bash

main.js

@@ -595,6 +595,9 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
     const loaded = await this.loadData();
     this.data = Object.assign({}, DEFAULT_DATA, (loaded == null ? void 0 : loaded.data) || {});
     this.settings = Object.assign({}, DEFAULT_SETTINGS, (loaded == null ? void 0 : loaded.settings) || {});
+    if (!this.settings.lists || this.settings.lists.length === 0) {
+      this.settings.lists = DEFAULT_SETTINGS.lists;
+    }
     this.focusSecondsToday = (this.data.totalFocusMinutesToday || 0) * 60;
   }
   async saveAllData() {
@@ -711,38 +714,10 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
   // ============ Timer Management ============
   // Sync timer based on timestamp when app returns from background
   syncTimerFromTimestamp() {
-    if (!this.isTimerRunning || this.timerStartTimestamp === 0)
+    if (!this.isTimerRunning)
       return;
-    const now = Date.now();
-    const elapsedMs = now - this.timerStartTimestamp;
-    const elapsedSeconds = Math.floor(elapsedMs / 1e3);
-    if (this.isBreakMode) {
-      this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
-      if (this.currentTimerSeconds <= 0) {
-        this.handlePomodoroEnd();
-      }
-    } else {
-      const task = this.data.tasks.find((t) => t.id === this.activeTaskId);
-      if (!task)
-        return;
-      if (this.pausedTimeRemaining > 0) {
-        this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
-        this.secondsWorkedOnCurrentTask += elapsedSeconds;
-        task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-        this.focusSecondsToday += elapsedSeconds;
-        if (this.currentTimerSeconds <= 0) {
-          this.handlePomodoroEnd();
-        }
-      } else {
-        this.currentTimerSeconds += elapsedSeconds;
-        this.secondsWorkedOnCurrentTask += elapsedSeconds;
-        task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-        this.focusSecondsToday += elapsedSeconds;
-      }
-    }
     this.updateStatusBar();
     this.updateTimerDisplay();
-    this.saveAllData();
   }
   startTimer(taskId) {
     const task = this.data.tasks.find((t) => t.id === taskId);
@@ -757,16 +732,23 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
     this.secondsWorkedOnCurrentTask = task.actualMinutes * 60;
     this.timerStartTimestamp = Date.now();
     this.pausedTimeRemaining = 0;
+    const initialSecondsWorked = this.secondsWorkedOnCurrentTask;
+    let alertShown = false;
     this.refreshView();
     this.updateStatusBar();
     this.timerInterval = window.setInterval(() => {
-      this.currentTimerSeconds++;
-      this.secondsWorkedOnCurrentTask++;
+      const now = Date.now();
+      const elapsedMs = now - this.timerStartTimestamp;
+      const elapsedSeconds = Math.floor(elapsedMs / 1e3);
+      this.currentTimerSeconds = elapsedSeconds;
+      this.secondsWorkedOnCurrentTask = initialSecondsWorked + elapsedSeconds;
       task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-      this.focusSecondsToday++;
+      const newFocusSeconds = Math.floor((this.data.totalFocusMinutesToday || 0) * 60) + elapsedSeconds;
+      this.focusSecondsToday = newFocusSeconds;
       this.updateStatusBar();
       this.updateTimerDisplay();
-      if (this.currentTimerSeconds === task.estimatedMinutes * 60) {
+      if (!alertShown && this.currentTimerSeconds >= task.estimatedMinutes * 60) {
+        alertShown = true;
         if (this.settings.enableSounds) {
           this.playAlertSound();
         }
@@ -785,17 +767,25 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
     this.isBreakMode = false;
     this.currentTimerSeconds = this.settings.pomodoroWorkMinutes * 60;
     this.isTimerRunning = true;
-    this.secondsWorkedOnCurrentTask = task.actualMinutes * 60;
+    this.secondsWorkedOnCurrentTask = Math.floor(task.actualMinutes * 60);
     this.timerStartTimestamp = Date.now();
     this.pausedTimeRemaining = this.currentTimerSeconds;
+    const initialSecondsWorked = this.secondsWorkedOnCurrentTask;
     this.refreshView();
     this.updateStatusBar();
     this.timerInterval = window.setInterval(() => {
-      this.currentTimerSeconds--;
+      const now = Date.now();
+      const elapsedMs = now - this.timerStartTimestamp;
+      const elapsedSeconds = Math.floor(elapsedMs / 1e3);
+      this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
       if (!this.isBreakMode) {
-        this.secondsWorkedOnCurrentTask++;
-        task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-        this.focusSecondsToday++;
+        this.secondsWorkedOnCurrentTask = initialSecondsWorked + elapsedSeconds;
+        const actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
+        if (task.actualMinutes !== actualMinutes) {
+          task.actualMinutes = actualMinutes;
+        }
+        const newFocusSeconds = Math.floor((this.data.totalFocusMinutesToday || 0) * 60) + elapsedSeconds;
+        this.focusSecondsToday = newFocusSeconds;
       }
       this.updateStatusBar();
       this.updateTimerDisplay();
@@ -845,7 +835,10 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
     this.refreshView();
     if (!this.timerInterval) {
       this.timerInterval = window.setInterval(() => {
-        this.currentTimerSeconds--;
+        const now = Date.now();
+        const elapsedMs = now - this.timerStartTimestamp;
+        const elapsedSeconds = Math.floor(elapsedMs / 1e3);
+        this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
         this.updateStatusBar();
         this.updateTimerDisplay();
         if (this.currentTimerSeconds <= 0) {
@@ -865,12 +858,17 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
       this.isTimerRunning = true;
       this.timerStartTimestamp = Date.now();
       const task = this.data.tasks.find((t) => t.id === this.activeTaskId);
+      const initialSecondsWorked = this.secondsWorkedOnCurrentTask;
       this.timerInterval = window.setInterval(() => {
-        this.currentTimerSeconds--;
+        const now = Date.now();
+        const elapsedMs = now - this.timerStartTimestamp;
+        const elapsedSeconds = Math.floor(elapsedMs / 1e3);
+        this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
         if (task && !this.isBreakMode) {
-          this.secondsWorkedOnCurrentTask++;
+          this.secondsWorkedOnCurrentTask = initialSecondsWorked + elapsedSeconds;
           task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-          this.focusSecondsToday++;
+          const newFocusSeconds = Math.floor((this.data.totalFocusMinutesToday || 0) * 60) + elapsedSeconds;
+          this.focusSecondsToday = newFocusSeconds;
         }
         this.updateStatusBar();
         this.updateTimerDisplay();
@@ -893,6 +891,7 @@ var FocusTaskPlugin = class extends import_obsidian3.Plugin {
       const task = this.data.tasks.find((t) => t.id === this.activeTaskId);
       if (task) {
         task.isActive = false;
+        task.actualMinutes = 0;
       }
     }
     this.isTimerRunning = false;

manifest.json

@@ -1,7 +1,7 @@
 {
   "id": "focus-task",
   "name": "Focus Task",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "minAppVersion": "0.15.0",
   "description": "A Blitzit-inspired task management and focus timer plugin. Plan your day, track time with Pomodoro technique, and crush your tasks with satisfying checkoffs.",
   "author": "Crib",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "focus-task",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "A Blitzit-inspired task management and focus timer plugin for Obsidian",
   "main": "main.js",
   "scripts": {

src/main.ts

@@ -116,8 +116,17 @@ export default class FocusTaskPlugin extends Plugin {
 
 	async loadAllData() {
 		const loaded = await this.loadData();
+
+		// Merge loaded data with defaults (defaults first, then override with loaded)
+		// This ensures new fields get default values even for existing installs
 		this.data = Object.assign({}, DEFAULT_DATA, loaded?.data || {});
 		this.settings = Object.assign({}, DEFAULT_SETTINGS, loaded?.settings || {});
+
+		// Ensure lists array exists and has at least the default lists
+		if (!this.settings.lists || this.settings.lists.length === 0) {
+			this.settings.lists = DEFAULT_SETTINGS.lists;
+		}
+
 		// Initialize seconds from stored minutes
 		this.focusSecondsToday = (this.data.totalFocusMinutesToday || 0) * 60;
 	}
@@ -264,49 +273,14 @@ export default class FocusTaskPlugin extends Plugin {
 
 	// Sync timer based on timestamp when app returns from background
 	syncTimerFromTimestamp() {
-		if (!this.isTimerRunning || this.timerStartTimestamp === 0) return;
+		// Since all intervals now calculate from timestamps directly,
+		// we just need to trigger an update when coming back to foreground
+		if (!this.isTimerRunning) return;
 
-		const now = Date.now();
-		const elapsedMs = now - this.timerStartTimestamp;
-		const elapsedSeconds = Math.floor(elapsedMs / 1000);
-
-		if (this.isBreakMode) {
-			// Break mode: countdown timer
-			this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
-
-			if (this.currentTimerSeconds <= 0) {
-				this.handlePomodoroEnd();
-			}
-		} else {
-			// Work mode: check if it's pomodoro (countdown) or stopwatch (count up)
-			const task = this.data.tasks.find(t => t.id === this.activeTaskId);
-			if (!task) return;
-
-			if (this.pausedTimeRemaining > 0) {
-				// Pomodoro countdown mode
-				this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
-
-				// Update actual minutes worked
-				this.secondsWorkedOnCurrentTask += elapsedSeconds;
-				task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-				this.focusSecondsToday += elapsedSeconds;
-
-				if (this.currentTimerSeconds <= 0) {
-					this.handlePomodoroEnd();
-				}
-			} else {
-				// Stopwatch count up mode
-				this.currentTimerSeconds += elapsedSeconds;
-				this.secondsWorkedOnCurrentTask += elapsedSeconds;
-				task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-				this.focusSecondsToday += elapsedSeconds;
-			}
-		}
-
-		// Update displays
+		// The interval will automatically calculate correct values on next tick
+		// Just update the display immediately to show current state
 		this.updateStatusBar();
 		this.updateTimerDisplay();
-		this.saveAllData();
 	}
 
 	startTimer(taskId: string) {
@@ -328,25 +302,39 @@ export default class FocusTaskPlugin extends Plugin {
 		this.timerStartTimestamp = Date.now();
 		this.pausedTimeRemaining = 0; // 0 indicates stopwatch mode
 
+		// Store initial values
+		const initialSecondsWorked = this.secondsWorkedOnCurrentTask;
+		let alertShown = false;
+
 		// Full refresh to show the active task card
 		this.refreshView();
 		this.updateStatusBar();
 
 		// Start interval (count up mode - stopwatch)
 		this.timerInterval = window.setInterval(() => {
-			this.currentTimerSeconds++;
-			this.secondsWorkedOnCurrentTask++;
+			// Calculate elapsed time from timestamp
+			const now = Date.now();
+			const elapsedMs = now - this.timerStartTimestamp;
+			const elapsedSeconds = Math.floor(elapsedMs / 1000);
+
+			// Update timer (count up)
+			this.currentTimerSeconds = elapsedSeconds;
+
+			// Update actual time worked
+			this.secondsWorkedOnCurrentTask = initialSecondsWorked + elapsedSeconds;
 			task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
 
-			// Track focus time
-			this.focusSecondsToday++;
+			// Update focus time
+			const newFocusSeconds = Math.floor((this.data.totalFocusMinutesToday || 0) * 60) + elapsedSeconds;
+			this.focusSecondsToday = newFocusSeconds;
 
 			// Light update - only timer display, no full refresh
 			this.updateStatusBar();
 			this.updateTimerDisplay();
 
-			// Check if over estimate
-			if (this.currentTimerSeconds === task.estimatedMinutes * 60) {
+			// Check if over estimate (only alert once)
+			if (!alertShown && this.currentTimerSeconds >= task.estimatedMinutes * 60) {
+				alertShown = true;
 				if (this.settings.enableSounds) {
 					this.playAlertSound();
 				}
@@ -369,24 +357,41 @@ export default class FocusTaskPlugin extends Plugin {
 		this.isTimerRunning = true;
 
 		// Initialize from existing actual time to preserve progress across breaks
-		this.secondsWorkedOnCurrentTask = task.actualMinutes * 60;
+		// Store as seconds for precision
+		this.secondsWorkedOnCurrentTask = Math.floor(task.actualMinutes * 60);
 
 		// Set timestamp for background tracking (pomodoro countdown mode)
 		this.timerStartTimestamp = Date.now();
 		this.pausedTimeRemaining = this.currentTimerSeconds;
 
+		// Store the initial seconds worked to calculate delta
+		const initialSecondsWorked = this.secondsWorkedOnCurrentTask;
+
 		// Full refresh to show the active task card
 		this.refreshView();
 		this.updateStatusBar();
 
 		this.timerInterval = window.setInterval(() => {
-			this.currentTimerSeconds--;
+			// Calculate elapsed time from timestamp (more accurate than counting ticks)
+			const now = Date.now();
+			const elapsedMs = now - this.timerStartTimestamp;
+			const elapsedSeconds = Math.floor(elapsedMs / 1000);
+
+			// Update countdown timer
+			this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
 
 			if (!this.isBreakMode) {
-				this.secondsWorkedOnCurrentTask++;
-				task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-				// Increment focus time by 1 second
-				this.focusSecondsToday++;
+				// Update actual time worked based on real elapsed time
+				this.secondsWorkedOnCurrentTask = initialSecondsWorked + elapsedSeconds;
+				const actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
+
+				if (task.actualMinutes !== actualMinutes) {
+					task.actualMinutes = actualMinutes;
+				}
+
+				// Update focus time based on elapsed seconds
+				const newFocusSeconds = Math.floor((this.data.totalFocusMinutesToday || 0) * 60) + elapsedSeconds;
+				this.focusSecondsToday = newFocusSeconds;
 			}
 
 			// Light update - only timer display, no full refresh
@@ -461,7 +466,14 @@ export default class FocusTaskPlugin extends Plugin {
 
 		if (!this.timerInterval) {
 			this.timerInterval = window.setInterval(() => {
-				this.currentTimerSeconds--;
+				// Calculate elapsed time from timestamp
+				const now = Date.now();
+				const elapsedMs = now - this.timerStartTimestamp;
+				const elapsedSeconds = Math.floor(elapsedMs / 1000);
+
+				// Update countdown timer
+				this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
+
 				// Light update - only timer display
 				this.updateStatusBar();
 				this.updateTimerDisplay();
@@ -488,14 +500,28 @@ export default class FocusTaskPlugin extends Plugin {
 			this.timerStartTimestamp = Date.now();
 			const task = this.data.tasks.find(t => t.id === this.activeTaskId);
 
+			// Store initial values for resume
+			const initialSecondsWorked = this.secondsWorkedOnCurrentTask;
+
 			this.timerInterval = window.setInterval(() => {
-				this.currentTimerSeconds--;
+				// Calculate elapsed time from timestamp
+				const now = Date.now();
+				const elapsedMs = now - this.timerStartTimestamp;
+				const elapsedSeconds = Math.floor(elapsedMs / 1000);
+
+				// Update timer (countdown from paused position)
+				this.currentTimerSeconds = Math.max(0, this.pausedTimeRemaining - elapsedSeconds);
+
 				if (task && !this.isBreakMode) {
-					this.secondsWorkedOnCurrentTask++;
+					// Update actual time worked
+					this.secondsWorkedOnCurrentTask = initialSecondsWorked + elapsedSeconds;
 					task.actualMinutes = Math.floor(this.secondsWorkedOnCurrentTask / 60);
-					// Track focus time
-					this.focusSecondsToday++;
+
+					// Update focus time
+					const newFocusSeconds = Math.floor((this.data.totalFocusMinutesToday || 0) * 60) + elapsedSeconds;
+					this.focusSecondsToday = newFocusSeconds;
 				}
+
 				// Light update - only timer display
 				this.updateStatusBar();
 				this.updateTimerDisplay();
@@ -523,6 +549,9 @@ export default class FocusTaskPlugin extends Plugin {
 			const task = this.data.tasks.find(t => t.id === this.activeTaskId);
 			if (task) {
 				task.isActive = false;
+				// Reset actual time when manually stopping (not after a break)
+				// This allows starting fresh next time
+				task.actualMinutes = 0;
 			}
 		}
 

versions.json

@@ -1,5 +1,7 @@
 {
   "1.0.4": "0.15.0",
   "1.0.5": "0.15.0",
-  "1.0.6": "0.15.0"
+  "1.0.6": "0.15.0",
+  "1.0.7": "0.15.0",
+  "1.0.8": "0.15.0"
 }