Azure
diff --git a/‎.vscode/settings.json‎
Lines changed: 5 additions & 1 deletion b/‎.vscode/settings.json‎
Lines changed: 5 additions & 1 deletion
diff --git a/‎ext/vscode/.github/copilot-instructions.md‎
Lines changed: 196 additions & 0 deletions b/‎ext/vscode/.github/copilot-instructions.md‎
Lines changed: 196 additions & 0 deletions
diff --git a/‎ext/vscode/.gitignore‎
Lines changed: 3 additions & 0 deletions b/‎ext/vscode/.gitignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎ext/vscode/.vscode/cspell-dictionary.txt‎
Lines changed: 28 additions & 0 deletions b/‎ext/vscode/.vscode/cspell-dictionary.txt‎
Lines changed: 28 additions & 0 deletions
diff --git a/‎ext/vscode/.vscodeignore‎
Lines changed: 3 additions & 0 deletions b/‎ext/vscode/.vscodeignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎ext/vscode/AGENTS.md‎
Lines changed: 69 additions & 0 deletions b/‎ext/vscode/AGENTS.md‎
Lines changed: 69 additions & 0 deletions
@@ -1,4 +1,8 @@
 {
   "cSpell.import": ["cspell.yaml"],
-  "go.testFlags": ["-timeout", "30m"]
+  "go.testFlags": [
+    "-timeout",
+    "30m"
+  ],
+  "aspire.enableSettingsFileCreationPromptOnStartup": false
 }
@@ -0,0 +1,196 @@
+# 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" --config .vscode/cspell.yaml`
+   - Checks for spelling errors in source code
+   - Add technical terms to `.vscode/cspell-dictionary.txt` if needed
+
+3. **Unit Tests**: `npm run unit-test`
+   - Runs fast unit tests without full VS Code integration
+   - All tests must pass before committing
+   - **IMPORTANT**: If you modify existing code, ensure related tests still pass
+   - **IMPORTANT**: If you add new functionality, add corresponding unit tests
+
+### Pre-Commit Checklist
+✅ Run `npm run lint` and fix all issues
+✅ Run `npx cspell "src/**/*.ts" --config .vscode/cspell.yaml` and fix spelling errors
+✅ Run `npm run unit-test` and ensure all 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
+
+### Copyright Headers
+All TypeScript source files MUST include the Microsoft copyright header at the very top of the file:
+```typescript
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+```
+
+### 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
+
+### User Interface Best Practices
+- All user-facing strings shown in the UI, error messages, etc. must use `vscode.l10n.t()`
+- All user-facing strings in package.json must be extracted into package.nls.json
+- Instead of `vscode.window.showQuickPick`, use `IActionContext.ui.showQuickPick`
+- Instead of `vscode.window.showInputBox`, use `IActionContext.ui.showInputBox`
+- The same applies for `showWarningMessage`, `showOpenDialog`, and `showWorkspaceFolderPick`
+- FileSystemWatchers are a scarce resource on some systems - consolidate into shared watchers when possible
+
+## 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)
@@ -110,3 +110,6 @@ node_modules
 package.nls.*.json
 *.vsix
 *.zip
+
+# Source maps
+*.js.map
@@ -13,3 +13,31 @@ 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
+networkidle
+qbsearch
+mystorageacct
+aiapps
+itemprop
@@ -1,8 +1,11 @@
 .azure-pipelines
 .eslintignore
 eslint.config.mjs
+.github/**
 .vscode/**
 .vscode-test/**
+FEATURE_IDEAS.md
+TESTING_GUIDE.md
 node_modules/**
 !node_modules/vscode-nls
 out/**
 
@@ -0,0 +1,69 @@
+# Agent Development Guide
+
+A file for [guiding coding agents](https://agents.md/).
+
+## Commands
+
+- **Install dependencies:** `npm install`
+- **Build:** `npm run build`
+- **Lint:** `npm run lint`
+- **Spell Check:** `npx cspell "src/**/*.ts" --config .vscode/cspell.yaml`
+- **Unit Tests:** `npm run unit-test`
+- **Watch mode:** `npm run watch`
+- **Package extension:** `npm run package`
+
+## Directory Structure
+
+- 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/`
+- Constants: `src/constants/`
+- Services: `src/services/`
+
+## Pre-Commit Checklist
+
+**IMPORTANT**: Always run these checks before committing to avoid pipeline failures:
+
+1. Run `npm run lint` and fix all issues
+2. Run `npx cspell "src/**/*.ts" --config .vscode/cspell.yaml` and fix spelling errors
+3. Run `npm run unit-test` and ensure all tests pass
+4. Update README.md if functionality changed
+5. Verify no merge conflict markers in code
+
+**Testing Requirements**:
+- If you modify existing code, ensure related tests still pass
+- If you add new functionality, add corresponding unit tests
+- Add new words to `.vscode/cspell-dictionary.txt` if cspell flags valid technical terms
+
+## Code Conventions
+
+### Copyright Headers
+All TypeScript source files MUST include the Microsoft copyright header:
+```typescript
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+```
+
+### Localization
+- All user-facing strings shown in the UI, error messages, etc. must use `vscode.l10n.t()`
+- All user-facing strings in package.json must be extracted into package.nls.json
+
+### UI Best Practices
+- Instead of `vscode.window.showQuickPick`, use `IActionContext.ui.showQuickPick`
+- Instead of `vscode.window.showInputBox`, use `IActionContext.ui.showInputBox`
+- Same for `showWarningMessage`, `showOpenDialog`, and `showWorkspaceFolderPick`
+
+### Resource Management
+- FileSystemWatchers are a scarce resource on some systems - use the shared `FileSystemWatcherService`
+- Dispose resources properly using `vscode.Disposable` pattern
+- Use `ExtensionContext.subscriptions` for cleanup
+
+### Testing
+- Use Mocha for test framework
+- Use Chai for assertions
+- Mock VS Code APIs using Sinon
+- Keep tests focused and isolated
+- Use `UserCancelledError` from `@microsoft/vscode-azext-utils` for testing user cancellation scenarios
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,8 @@`
`1`	`1`	`{`
`2`	`2`	`"cSpell.import": ["cspell.yaml"],`
`3`		`- "go.testFlags": ["-timeout", "30m"]`
	`3`	`+ "go.testFlags": [`
	`4`	`+ "-timeout",`
	`5`	`+ "30m"`
	`6`	`+ ],`
	`7`	`+ "aspire.enableSettingsFileCreationPromptOnStartup": false`
`4`	`8`	`}`