AZD VS Code Extension Updates & Improvements

.vscode/settings.json

@@ -1,4 +1,8 @@
 {
   "cSpell.import": ["cspell.yaml"],
-  "go.testFlags": ["-timeout", "30m"]
+  "go.testFlags": [
+    "-timeout",
+    "30m"
+  ],
+  "aspire.enableSettingsFileCreationPromptOnStartup": false
 }

ext/vscode/.github/copilot-instructions.md

@@ -0,0 +1,186 @@
+# Azure Developer CLI VS Code Extension - Copilot Instructions
+
+## Project Overview
+This is the official Visual Studio Code extension for the Azure Developer CLI (azd). It provides an integrated development experience for building, deploying, and managing Azure applications.
+
+## Core Development Principles
+
+### Documentation
+- **Always keep the [README.md](../README.md) up to date** with any changes to:
+  - Features and functionality
+  - Commands and usage
+  - Configuration options
+  - Installation instructions
+  - Prerequisites
+  - Known issues or limitations
+
+### Code Quality & Testing
+Before submitting any changes or pushing code, **always run the following checks** to avoid pipeline failures:
+
+1. **Linting**: `npm run lint`
+   - Ensures code follows TypeScript and ESLint standards
+   - Fix any linting errors before committing
+
+2. **Spell Check**: `npx cspell "src/**/*.ts"`
+   - Checks for spelling errors in source code
+   - Add technical terms to `.cspell.json` if needed
+
+3. **Unit Tests**: `npm run unit-test`
+   - Runs fast unit tests without full VS Code integration
+   - All tests must pass before committing
+
+4. **CI Test Suite**: `pwsh ./ci-test.ps1` (or `./ci-test.ps1` on Windows)
+   - Runs the full CI test pipeline locally
+   - This is the same test suite that runs in CI/CD
+   - **Must pass before pushing to avoid pipeline failures**
+
+### Pre-Commit Checklist
+✅ Run `npm run lint` and fix all issues
+✅ Run `npx cspell "src/**/*.ts"` and fix spelling errors
+✅ Run `npm run unit-test` and ensure all tests pass
+✅ Run `pwsh ./ci-test.ps1` and verify CI tests pass
+✅ Update [README.md](../README.md) if functionality changed
+✅ Verify merge conflicts are resolved (no `<<<<<<<`, `=======`, `>>>>>>>` markers)
+
+## Code Style & Conventions
+
+### File Organization
+- Extension entry point: `src/extension.ts`
+- Commands: `src/commands/`
+- Language features: `src/language/` (IntelliSense, diagnostics, etc.)
+- Views & tree providers: `src/views/`
+- Utilities: `src/utils/`
+- Tests: `src/test/`
+
+### Naming Conventions
+- Use PascalCase for classes and interfaces
+- Use camelCase for functions, methods, and variables
+- Use descriptive names that clearly indicate purpose
+- Prefix private members with underscore if needed for clarity
+
+### TypeScript Guidelines
+- Use explicit types where possible, avoid `any`
+- Leverage VS Code API types from `vscode` module
+- Use `async/await` for asynchronous operations
+- Handle errors gracefully with try/catch blocks
+
+### Azure YAML Language Features
+When working on `azure.yaml` language support in `src/language/`:
+- Use YAML parser from `yaml` package
+- Provide helpful diagnostics with clear error messages
+- Use `vscode.l10n.t()` for all user-facing strings
+- Test with various `azure.yaml` configurations
+
+### Testing
+- Write unit tests for new features in `src/test/suite/unit/`
+- Use Mocha for test framework
+- Use Chai for assertions
+- Mock VS Code APIs when necessary using Sinon
+- Keep tests focused and isolated
+
+## Common Tasks
+
+### Adding a New Command
+1. Create command handler in `src/commands/`
+2. Register in `src/commands/registerCommands.ts`
+3. Add to `package.json` contributions
+4. Add localized strings to `package.nls.json`
+5. Update README.md with new command documentation
+6. Add tests for the command
+
+### Adding Language Features
+1. Create provider in `src/language/`
+2. Register in `src/language/languageFeatures.ts`
+3. Test with various `azure.yaml` files
+4. Add diagnostics tests in `src/test/suite/unit/`
+
+### Debugging the Extension
+- Press F5 to launch Extension Development Host
+- Set breakpoints in TypeScript source
+- Use Debug Console for logging
+- Check Output > Azure Developer CLI for extension logs
+
+## VS Code Extension APIs
+- Follow [VS Code Extension API](https://code.visualstudio.com/api) best practices
+- Use `@microsoft/vscode-azext-utils` for Azure extension utilities
+- Integrate with Azure Resources API via `@microsoft/vscode-azureresources-api`
+- Use localization with `vscode.l10n.t()` for all user-facing text
+
+## Performance Best Practices
+
+### Activation & Startup
+- **Minimize activation time**: Keep `activate()` function lightweight
+- Use **lazy activation events** - be specific with `activationEvents` in package.json
+- Avoid synchronous file I/O during activation
+- Defer expensive operations until they're actually needed
+- Use `ExtensionContext.subscriptions` for proper cleanup
+
+### Memory Management
+- **Dispose resources properly**: Always dispose of subscriptions, watchers, and providers
+- Use `vscode.Disposable` pattern for all resources that need cleanup
+- Avoid memory leaks by unsubscribing from events when no longer needed
+- Clear caches and collections when they grow too large
+- Use weak references where appropriate
+
+### Asynchronous Operations
+- **Never block the main thread**: Use async/await for all I/O operations
+- Use `Promise.all()` for parallel operations when possible
+- Implement proper cancellation using `CancellationToken`
+- Debounce frequent operations (e.g., text document changes)
+- Use background workers for CPU-intensive tasks
+
+### Tree Views & Data Providers
+- Implement efficient `getChildren()` - return only visible items
+- Cache tree data when appropriate to avoid redundant queries
+- Use `vscode.EventEmitter` efficiently - only fire events when data actually changes
+- Implement `getTreeItem()` to be synchronous and fast
+- Use `collapsibleState` wisely to control initial expansion
+
+### Language Features
+- **Debounce document change events** (see `documentDebounce.ts`)
+- Use incremental parsing when possible
+- Cache parsed ASTs or syntax trees
+- Limit diagnostic computation to visible range when feasible
+- Return early from providers when results aren't needed
+
+### File System Operations
+- Use `vscode.workspace.fs` API for better performance
+- Batch file operations when possible
+- Use `FileSystemWatcher` instead of polling
+- Avoid recursive directory scans in large workspaces
+- Cache file system queries with appropriate invalidation
+
+### Commands & UI
+- Keep command handlers fast and responsive
+- Show progress indicators for long-running operations
+- Use `withProgress()` for operations that take >1 second
+- Provide cancellation support for long operations
+- Avoid multiple sequential `showQuickPick` or `showInputBox` calls
+
+### Extension Size & Bundle
+- Minimize extension bundle size - exclude unnecessary dependencies
+- Use webpack to bundle and tree-shake code
+- Lazy load large dependencies only when needed
+- Consider code splitting for rarely-used features
+- Optimize images and assets
+
+### Best Practices from This Codebase
+- Use `documentDebounce()` utility for text change events (1000ms delay)
+- Leverage `Lazy<T>` and `AsyncLazy<T>` for deferred initialization
+- Implement proper `vscode.Disposable` cleanup in all providers
+- Use telemetry to measure and track performance metrics
+- Follow the patterns in `src/views/` for efficient tree providers
+
+## Build & Package
+- Development build: `npm run dev-build`
+- Production build: `npm run build`
+- Watch mode: `npm run watch`
+- Package extension: `npm run package`
+- CI build: `npm run ci-build`
+- CI package: `npm run ci-package`
+
+## Additional Resources
+- [Azure Developer CLI Documentation](https://learn.microsoft.com/azure/developer/azure-developer-cli/)
+- [VS Code Extension API](https://code.visualstudio.com/api)
+- [Contributing Guide](../CONTRIBUTING.md)
+- [Test Coverage](../TEST_COVERAGE.md)

ext/vscode/.vscode/cspell-dictionary.txt

@@ -13,3 +13,26 @@ containerapp
 staticwebapp
 devcenter
 processutils
+azurecontainerapps
+azurefunctions
+azurestorage
+eastus
+mystorageaccount
+mycosmosdb
+azext
+prerestore
+postrestore
+preprovision
+postprovision
+predeploy
+postdeploy
+invalidhost
+unknownkeyword
+aicollection
+webapps
+reactjs
+azuresql
+azuredb
+retval
+LOCALAPPDATA
+ellismg