Gordon Lam

This commit introduces a **new capability** for AI agents to discover and explore Windows desktop APIs by adding the **`winmd-api-search` skill**. This **feature** includes a C# **cache generator** (`scripts/cache-generator/Program.cs`) that parses WinMD files from sources like the Windows SDK, NuGet packages, and project outputs into a local JSON cache. A companion **PowerShell query engine** (`scripts/Invoke-WinMdQuery.ps1`) allows searching this metadata for types, members, enums, and namespaces. This system provides comprehensive API surface details for Windows Platform SDK, WinAppSDK/WinUI, and other WinMDs, enabling efficient, offline querying of Windows API metadata for AI agents.

This commit **fixes a regression** within the **Settings UI localization** by reintroducing the `Default_Language` option. It **restores the missing resource string** in `src/settings-ui/Settings.UI/Strings/en-us/Resources.resw` and **corrects a case mismatch** for the `Default_Language` key in `src/settings-ui/Settings.UI/ViewModels/GeneralViewModel.cs`. This **critical bug fix** resolves an issue where the default language option was incorrectly removed due to a prior latent bug and an erroneous tool-assisted removal. The change prevents potential crashes and ensures proper display of localization settings, improving the robustness of the **settings-ui** module's internationalization capabilities.

This commit **refactors** the **Settings UI** by changing data binding modes from `OneWay` to `OneTime` for various controls within `CheckUpdateControl.xaml` and `ShortcutConflictWindow.xaml`. This **fixes build warnings** (WMC1506) that occurred when `OneWay` bindings were used without notification support, and **improves performance** by preventing unnecessary UI updates. The change ensures that components like the dashboard update checker and shortcut conflict resolution windows are more efficient and contribute to a cleaner build process.

This commit **refactors** asynchronous methods across several modules to introduce **WinRT coroutine support** and address build warnings with VS2026. It replaces `std::future` with `IAsyncOperation` or `wil::task` in the **updating** subsystem (for version checks, downloads, and uninstallation), `HttpClient`, and the **ZoomIt** module, utilizing `co_await` for enhanced async handling. The change also **removes the deprecated `/await` compiler option** from project files, streamlining the build process and improving compatibility. This **maintenance** work ensures better performance and future-proofs the application's asynchronous operations.

This commit introduces a **new capability** to the **Advanced Paste** module, enabling users to **automatically copy the current selection** when triggering a custom action hotkey. This **feature addition** streamlines the workflow by eliminating the need for a separate manual copy operation, significantly boosting user productivity. The implementation involves adding a new `AutoCopySelectionForCustomActionHotkey` setting to the backend logic in `dllmain.cpp` and `AdvancedPasteProperties.cs`, along with corresponding updates to the **settings UI** in `AdvancedPastePage.xaml` and `AdvancedPasteViewModel.cs` for user configuration. This ensures that a single hotkey press can now perform both the copy and the advanced paste action.

This commit introduces **Claude Code support** by establishing symbolic links from a new `.claude/` directory to existing **GitHub Copilot configuration files** and directories. This **chore** enables Claude Code to reuse established AI contributor guidance, agents, prompts, instructions, and skills, such as those found in `.github/copilot-instructions.md` and `.github/agents/`. The change ensures a single source of truth for AI tooling configurations, preventing duplication and streamlining maintenance for both **Claude Code** and **GitHub Copilot**. This integration primarily affects **AI tooling configuration** and requires specific Git settings for Windows users to properly handle the symlinks.

This commit **updates the developer documentation** for the **Advanced Paste module**, specifically clarifying the behavior of the **Paste with AI** feature. It adds a new section to `doc/devdocs/modules/advancedpaste.md` explaining that the `ShowCustomPreview` setting **does not consume additional AI credits**, as the preview utilizes a locally cached response from the initial API call. This **documentation update** addresses user concerns regarding AI quota usage and enhances understanding of the feature's implementation.

This **documentation update** for the **Advanced Paste** feature's **Out-of-Box Experience (OOBE)** description within the **settings UI** corrects outdated information regarding its AI capabilities. The text in `Oobe_AdvancedPaste.Description` now accurately states that it is an **opt-in AI feature** supporting **online or local language model endpoints**, removing the previous exclusive requirement for an OpenAI API key. This **maintenance** task also standardizes casing for "Markdown" and "JSON", improving clarity and preventing user confusion about the feature's flexible AI integration. The change is reflected in the `Resources.resw` localization file.

This commit introduces a **new capability** to the **AI agent's prompt system** by adding the `fix-pr-active-comments.prompt.md` file. This new prompt enables the agent to address active pull request comments with **scoped, simple fixes**, significantly enhancing its utility in PR review workflows. Concurrently, it performs **maintenance** by removing outdated references to the 'GPT-5.1-Codex-Max' model from various prompt files, streamlining the overall prompt configuration within the `.github/prompts` directory.

This commit **fixes a bug** in the **Peek** module that caused the `Space` key to trigger an error window and steal focus during operations like **file renaming**, search, or address bar typing. It prevents the `Peek` window from showing an error when `CurrentItem` is null, restoring the original behavior where it would silently return without interference. This change, primarily affecting `src/modules/peek/Peek.UI/PeekXAML/MainWindow.xaml.cs`, ensures that user input is not interrupted by the `Peek` functionality. The **bug fix** addresses an unintended side effect introduced by a previous change related to virtual folders, significantly improving the user experience during critical file system interactions.

This commit introduces significant **enhancements** to the project's **release notes generation process** and implements new **GitHub issue management tools**. It refines workflow documentation and adds PowerShell scripts within `.github/skills/release-note-generation` for automating PR diffing, grouping, and milestone assignment. Concurrently, a new **Model Context Protocol (MCP) server** in `tools/mcp/github-artifacts` provides capabilities to download and extract images and attachments directly from GitHub issues. This **new capability** is integrated into updated issue review prompts and supported by new `FixIssue` and `PlanIssue` agent definitions, streamlining automated issue analysis and resolution. The overall **maintenance and documentation update** aims to improve automation, clarity, and efficiency in project workflows.

This commit performs **maintenance** by **pinning the `SixLabors.ImageSharp` package to version `2.1.12`**. This action is a **bug fix** that **restores critical image processing functionality** and applies necessary patches. Specifically, it resolves compatibility issues with the `CoenM.ImageSharp.ImageHash` package, ensuring the stability and correct operation of features relying on these **image manipulation libraries**.

This commit performs **maintenance and documentation updates** to enhance the consistency and quality of AI-assisted content generation. It **synchronizes and clarifies AI prompts** for commit titles and PR summaries, specifically expanding `.github/prompts/create-commit-title.prompt.md` with detailed Conventional Commit guidance and ensuring `.github/prompts/create-pr-summary.prompt.md` reuses these rules. Furthermore, **VS Code Copilot chat settings** are added in `.vscode/settings.json` to direct review, commit, and PR generation to these repository-specific prompt files. This **improves the developer experience** by standardizing AI-generated commit messages and PR descriptions.

This commit **refactors and consolidates AI-related documentation** by introducing a new top-level `AGENTS.md` and a structured `.github/instructions` directory, replacing older scattered guidance. It provides dedicated instructions for various **development areas** like pipelines, common libraries, and UI components, enhancing clarity for contributors. Additionally, it performs **maintenance** by standardizing the YAML frontmatter and adding headings across all built-in **prompt files** (e.g., `create-commit-title.prompt.md`), ensuring consistent metadata and improved readability for AI prompts. This change streamlines access to development guidelines and improves the maintainability of AI-driven features.

This commit **streamlines the build process** and **updates AI agent configurations** across the repository. It introduces new **VSCode build tasks** in `.vscode/tasks.json` and enhances `tools/build/build.ps1` with a `-Path` parameter, providing more flexible and quick project builds. Additionally, all **AI agent prompt files** in `.github/prompts/` are updated to use the `GPT-5.1-Codex-Max` model and have their metadata syntax corrected, improving AI assistance consistency. Finally, **developer documentation** in `.github/copilot-instructions.md` is clarified regarding code style enforcement. This work represents a combination of **maintenance**, **refactoring**, and **new capabilities** to improve developer tooling and AI integration.

This commit **optimizes memory allocation** and processing logic within the **PowerRename utility**. It **refactors** the `s_fileOpWorkerThread` function in `PowerRenameManager.cpp` by introducing a pre-pass to determine the actual maximum path depth among all items. This ensures the internal depth-based processing matrix is sized appropriately, avoiding over-allocation based on total item count. The updated logic, which now iterates from the maximum depth down to zero, results in **more efficient memory usage** and guarantees **correct processing order** for items, especially beneficial for deeply nested file structures.

This commit introduces **new tooling infrastructure** to significantly enhance GitHub PR and issue management efficiency. It adds **PowerShell scripts** in `.github/review-tools/` for **incremental PR review**, enabling reviewers to focus only on changes between iterations, and **AI prompt templates** in `.github/prompts/` to guide structured PR and issue reviews, as well as issue fixes. This **new capability** streamlines the review process, leverages AI for better context, and improves the overall development workflow for maintainers and contributors.

This commit **refactors** the **NuGet package management** for the `Microsoft.CommandPalette.Extensions` and `PowerRenameUILib` projects, migrating them from the legacy `packages.config` system to the modern `PackageReference` style. This **modernization** simplifies dependency declarations directly within the `.vcxproj` files and removes outdated build configurations. Concurrently, the `Microsoft.CommandPalette.Extensions.Toolkit.csproj` is updated to explicitly include and copy the native implementation DLL and WinMD files to its output directory. This change streamlines dependency management and aligns the projects with current best practices for C++/WinRT development.

This commit **re-enables centralized NuGet package management** for C++ projects, migrating several **PowerToys modules** to use `PackageReference` style dependency management. It introduces an MSBuild target, `EnsureNuGetRestoreForVcxproj`, into affected `vcxproj` files to automatically restore NuGet packages when building inside Visual Studio. This **refactoring** improves the **build system's reliability** for modules like `MeasureToolCore`, `FindMyMouse`, `Microsoft.Terminal.UI`, `PowerRenameUI`, and the `runner` project. The change standardizes how C++ projects manage their NuGet dependencies, preventing common build issues and enhancing the **developer experience**.

This commit performs a **dependency upgrade**, primarily updating the **Microsoft Windows App SDK** packages to version 1.8.3 across the project. This **maintenance** task ensures the application benefits from the latest features and bug fixes provided by the SDK. Specifically, `Directory.Packages.props` is updated for `Microsoft.WindowsAppSDK`, `Foundation`, `AI`, and `Runtime` packages. Additionally, the `src/modules/powerrename/PowerRenameUILib/PowerRenameUI.vcxproj` file is modified to add and set the `WindowsAppSDKVerifyTransitiveDependencies` property to `false`, addressing a specific project configuration for the **PowerRenameUI** module.