Git (Submodule) Assistant

Monitors the currently checked-out git branch against a configurable list of protected branch names (e.g., 'master', 'main', 'production') and emits VS Code notifications when the user switches to or is working on a protected branch. Uses git state polling integrated with VS Code's git extension to read the current HEAD branch and compares it against user-defined protection rules stored in extension settings. Allows users to switch branches directly from the notification UI without leaving the editor.

Intercepts VS Code closure via keyboard shortcut (`Ctrl+Q` on Windows/Linux, `Cmd+Q` on macOS) and checks for unpushed commits in the current branch by querying git state through VS Code's git extension. If unpushed commits are detected, displays a modal dialog offering options to push commits before closing or force-close without pushing. Uses VS Code's `onBeforeShutdown` lifecycle hook to block closure until the user makes an explicit choice.

Detects when a commit is created in the current branch (via git state polling or VS Code git extension events) and immediately displays a notification prompting the user to push the commit to the remote repository. Includes an optional auto-push feature that can be configured to automatically push commits without user interaction, or can be set to notification-only mode where the user must manually trigger the push.

Runs a background polling loop (at configurable intervals, triggered on VS Code startup and periodically thereafter) that executes `git fetch` to check if the remote repository has new commits that the local branch is behind on. When out-of-sync status is detected, displays a notification to the user. Includes an optional auto-fetch feature that automatically runs `git fetch` when the workspace has no local uncommitted changes, reducing the need for manual fetch commands.

Detects when a git repository contains submodule definitions (via `.gitmodules` file or git config) and automatically runs `git submodule init` and `git submodule update` commands to initialize and populate submodule directories. Runs on workspace open or when submodule configuration changes are detected, ensuring submodules are ready for use without requiring manual terminal commands.

Monitors submodule state and automatically runs `git submodule update` to pull the latest commits from submodule remote repositories at configurable intervals or when submodule configuration changes are detected. Can be configured to run only when the workspace has no local changes (conservative mode) or more aggressively on a fixed schedule.

Implements a background polling mechanism that periodically queries git repository state (current branch, unpushed commits, remote sync status, submodule state) by invoking git commands through VS Code's git extension API. Integrates with VS Code lifecycle events (workspace open, shutdown, focus change) to trigger state checks at appropriate times and coordinate with other extension capabilities. Polling interval is configurable to balance responsiveness against resource usage.

Provides a settings UI integrated with VS Code's standard settings panel that allows users to enable/disable individual extension features (branch protection, unpushed commit prevention, post-commit notifications, remote sync, submodule management) and configure parameters like protected branch names, polling intervals, and auto-fix behavior. Settings are stored in VS Code's `settings.json` and are scoped to workspace or user level.

Hooks into VS Code's keyboard shortcut system to intercept the standard editor close shortcut (`Ctrl+Q` on Windows/Linux, `Cmd+Q` on macOS) and routes it through the extension's `onBeforeShutdown` lifecycle handler. This allows the extension to perform checks (e.g., unpushed commits) and display dialogs before allowing the editor to close, effectively creating a custom shutdown workflow.