fix: improve checkpoint error handling and race condition

- Show user-friendly notification when nested git repos prevent checkpoint initialization
- Fix race condition in Task.ts where checkpoint restoration overlapped with first user message
- Add proper i18n translations for all checkpoint error messages
- Move error display logic to ShadowCheckpointService for better separation of concerns
- Prevent checkpoint errors from disrupting the user experience

Author: daniel-lxs

src/core/checkpoints/index.ts

@@ -169,16 +169,6 @@ async function checkGitInstallation(
 			log(`[Task#getCheckpointService] initShadowGit -> ${err.message}`)
 			task.enableCheckpoints = false
 			task.checkpointServiceInitializing = false
-
-			// If the error is due to nested git repositories, show a user-friendly message
-			// but don't prevent the task from continuing
-			if (err.message?.includes("nested git repositories")) {
-				await vscode.window.showWarningMessage(
-					"Checkpoints are disabled because nested git repositories were detected in the workspace. The task will continue without checkpoint support.",
-					"OK",
-				)
-				// Task can continue without checkpoints
-			}
 		}
 	} catch (err) {
 		log(`[Task#getCheckpointService] Unexpected error during Git check: ${err.message}`)

src/core/task/Task.ts

@@ -1664,6 +1664,9 @@ export class Task extends EventEmitter<TaskEvents> implements TaskLike {
 		// Don't await this - let it run in the background so task can continue even if it fails
 		getCheckpointService(this).catch((error) => {
 			console.log(`[Task#initiateTaskLoop] Checkpoint service initialization failed: ${error.message}`)
+			// Explicitly set the flags to prevent race conditions
+			this.enableCheckpoints = false
+			this.checkpointServiceInitializing = false
 			// Task continues without checkpoints
 		})
 

src/i18n/locales/ca/common.json

@@ -29,6 +29,7 @@
 		"checkpoint_timeout": "Timed out when attempting to restore checkpoint.",
 		"checkpoint_failed": "Failed to restore checkpoint.",
 		"git_not_installed": "Git is required for the checkpoints feature. Please install Git to enable checkpoints.",
+		"nested_git_repos_detected": "Checkpoints are disabled because nested git repositories were detected in the workspace. To use checkpoints, please remove or relocate nested git repositories.",
 		"no_workspace": "Please open a project folder first",
 		"update_support_prompt": "Failed to update support prompt",
 		"reset_support_prompt": "Failed to reset support prompt",