VS Code extension: Auto-restore on workspace open and config change

extension/package.json

@@ -196,6 +196,12 @@
         "title": "%command.configureLaunchJson%",
         "category": "Aspire"
       },
+      {
+        "command": "aspire-vscode.restore",
+        "enablement": "workspaceFolderCount > 0",
+        "title": "%command.restore%",
+        "category": "Aspire"
+      },
       {
         "command": "aspire-vscode.settings",
         "title": "%command.settings%",
@@ -700,6 +706,12 @@
           "default": true,
           "description": "%configuration.aspire.enableGutterDecorations%",
           "scope": "window"
+        },
+        "aspire.enableAutoRestore": {
+          "type": "boolean",
+          "default": true,
+          "description": "%configuration.aspire.enableAutoRestore%",
+          "scope": "window"
         }
       }
     },

extension/package.nls.json

@@ -17,6 +17,7 @@
 	"command.deploy": "Deploy app",
 	"command.do": "Execute pipeline step (aspire do)",
 	"command.configureLaunchJson": "Configure launch.json file",
+  "command.restore": "Restore packages",
 	"command.settings": "Extension settings",
 	"command.openLocalSettings": "Open local Aspire settings",
 	"command.openGlobalSettings": "Open global Aspire settings",
@@ -39,6 +40,7 @@
   "configuration.aspire.globalAppHostsPollingInterval": "Polling interval in milliseconds for fetching all running apphosts (used in global view). Minimum: 1000.",
   "configuration.aspire.enableCodeLens": "Show CodeLens actions (state, restart, stop, logs) inline above resource declarations in apphost files.",
   "configuration.aspire.enableGutterDecorations": "Show colored status dots in the editor gutter next to resource declarations in apphost files.",
+  "configuration.aspire.enableAutoRestore": "Automatically run 'aspire restore' when the workspace opens and whenever aspire.config.json changes (e.g. after switching git branches). Keeps integration packages in sync and prevents editor errors.",
   "command.runAppHost": "Run Aspire apphost",
 	"command.debugAppHost": "Debug Aspire apphost",
 	"aspire-vscode.strings.noCsprojFound": "No apphost found in the current workspace.",
@@ -117,6 +119,12 @@
   "aspire-vscode.strings.selectDirectoryTitle": "Select directory",
   "aspire-vscode.strings.selectFileTitle": "Select file",
   "aspire-vscode.strings.enterPipelineStep": "Enter the pipeline step to execute",
+  "aspire-vscode.strings.runningAspireRestore": "Running aspire restore on {0} ...",
+  "aspire-vscode.strings.runningAspireRestoreProgress": "Running aspire restore ({0}/{1} projects) ...",
+  "aspire-vscode.strings.aspireRestoreCompleted": "Aspire restore completed for {0}.",
+  "aspire-vscode.strings.aspireRestoreAllCompleted": "Aspire restore completed",
+  "aspire-vscode.strings.aspireRestoreFailed": "aspire restore failed for {0}: {1}",
+  "aspire-vscode.strings.aspireRestoreFailedStatusBar": "Aspire restore failed (click to retry)",
   "aspire-vscode.strings.appHostSourceNotFound": "Could not determine the AppHost source file to open.",
   "aspire-vscode.strings.appHostSourceOpenFailed": "Failed to open AppHost source file: {0}",
   "viewsContainers.aspirePanel.title": "Aspire",

extension/src/extension.ts

@@ -25,6 +25,7 @@ import { settingsCommand } from './commands/settings';
 import { openLocalSettingsCommand, openGlobalSettingsCommand } from './commands/openSettings';
 import { checkCliAvailableOrRedirect, checkForExistingAppHostPathInWorkspace } from './utils/workspace';
 import { AspireEditorCommandProvider } from './editor/AspireEditorCommandProvider';
+import { AspirePackageRestoreProvider } from './utils/AspirePackageRestoreProvider';
 import { AspireAppHostTreeProvider } from './views/AspireAppHostTreeProvider';
 import { AppHostDataRepository } from './views/AppHostDataRepository';
 import { installCliStableCommand, installCliDailyCommand, verifyCliInstalledCommand } from './commands/walkthroughCommands';
@@ -195,6 +196,21 @@ export async function activate(context: vscode.ExtensionContext) {
       // any user-visible errors should be handled within checkForExistingAppHostPathInWorkspace.
     });
   }
+
+  // Auto-restore: run `aspire restore` on workspace open and when aspire.config.json changes
+  const packageRestoreProvider = new AspirePackageRestoreProvider(terminalProvider);
+  context.subscriptions.push(packageRestoreProvider);
+  void packageRestoreProvider.activate().catch(err => {
+    extensionLogOutputChannel.warn(`Auto-restore activation failed: ${String(err)}`);
+  });
+
+  const restoreCommandRegistration = vscode.commands.registerCommand('aspire-vscode.restore', () => {
+    void packageRestoreProvider.retryRestore().catch(err => {
+      extensionLogOutputChannel.warn(`Manual restore failed: ${String(err)}`);
+    });
+  });
+  context.subscriptions.push(restoreCommandRegistration);
+
   // Return exported API for tests or other extensions
   return {
     rpcServerInfo: rpcServer.connectionInfo,

extension/src/loc/strings.ts

@@ -99,6 +99,12 @@ export const openCliInstallInstructions = vscode.l10n.t('See CLI installation in
 export const cliNotAvailable = vscode.l10n.t('Aspire CLI is not available on PATH. Please install it and restart VS Code.');
 export const cliFoundAtDefaultPath = (path: string) => vscode.l10n.t('Aspire CLI found at {0}. The extension will use this path.', path);
 export const selectDirectoryTitle = vscode.l10n.t('Select directory');
+export const runningAspireRestore = (configPath: string) => vscode.l10n.t('Running aspire restore on {0} ...', configPath);
+export const runningAspireRestoreProgress = (completed: number, total: number) => vscode.l10n.t('Running aspire restore ({0}/{1} projects) ...', completed, total);
+export const aspireRestoreCompleted = (configPath: string) => vscode.l10n.t('Aspire restore completed for {0}.', configPath);
+export const aspireRestoreAllCompleted = vscode.l10n.t('Aspire restore completed');
+export const aspireRestoreFailed = (configPath: string, error: string) => vscode.l10n.t('aspire restore failed for {0}: {1}', configPath, error);
+export const aspireRestoreFailedStatusBar = vscode.l10n.t('Aspire restore failed (click to retry)');
 export const selectFileTitle = vscode.l10n.t('Select file');
 export const enterPipelineStep = vscode.l10n.t('Enter the pipeline step to execute');
 export const appHostSourceNotFound = vscode.l10n.t('Could not determine the AppHost source file to open.');