fix oobe open button

.github/actions/spell-check/expect.txt

@@ -32,7 +32,6 @@ advfirewall
 AFeature
 affordances
 AFX
-agentskills
 AGGREGATABLE
 AHK
 AHybrid
@@ -65,9 +64,6 @@ apidl
 APIENTRY
 APIIs
 Apm
-APMPOWERSTATUSCHANGE
-APMRESUMEAUTOMATIC
-APMRESUMESUSPEND
 APPBARDATA
 APPEXECLINK
 appext
@@ -103,6 +99,7 @@ ASYNCWINDOWPLACEMENT
 ASYNCWINDOWPOS
 atl
 ATRIOX
+ATX
 aumid
 authenticode
 AUTOBUDDY
@@ -209,7 +206,6 @@ certmgr
 cfp
 CHANGECBCHAIN
 changecursor
-checkmarks
 CHILDACTIVATE
 CHILDWINDOW
 CHOOSEFONT
@@ -219,7 +215,6 @@ CIELCh
 cim
 CImage
 cla
-claude
 CLASSDC
 classmethod
 CLASSNOTAVAILABLE
@@ -297,6 +292,7 @@ cpcontrols
 cph
 cplusplus
 CPower
+cppcoreguidelines
 cpptools
 cppvsdbg
 cppwinrt
@@ -325,7 +321,7 @@ CURRENTDIR
 CURSORINFO
 cursorpos
 CURSORSHOWING
-cursorwrap
+CURSORWRAP
 customaction
 CUSTOMACTIONTEST
 CUSTOMFORMATPLACEHOLDER
@@ -1040,7 +1036,6 @@ mmi
 mmsys
 mobileredirect
 mockapi
-modelcontextprotocol
 MODALFRAME
 MODESPRUNED
 MONITORENUMPROC
@@ -1349,7 +1344,6 @@ Pomodoro
 Popups
 POPUPWINDOW
 POSITIONITEM
-POWERBROADCAST
 POWERRENAMECONTEXTMENU
 powerrenameinput
 POWERRENAMETEST
@@ -1738,7 +1732,6 @@ STICKYKEYS
 sticpl
 storelogo
 stprintf
-streamable
 streamjsonrpc
 STRINGIZE
 stringtable
@@ -1964,7 +1957,6 @@ visualeffects
 vkey
 vmovl
 VMs
-vnd
 vorrq
 VOS
 vpaddlq

.github/agents/FixIssue.agent.md

@@ -1,92 +0,0 @@
----
-description: 'Implements fixes for GitHub issues based on implementation plans'
-name: 'FixIssue'
-tools: ['read', 'edit', 'search', 'execute', 'agent', 'usages', 'problems', 'changes', 'testFailure', 'github/*', 'github.vscode-pull-request-github/*']
-argument-hint: 'GitHub issue number (e.g., #12345)'
-infer: true
----
-
-# FixIssue Agent
-
-You are an **IMPLEMENTATION AGENT** specialized in executing implementation plans to fix GitHub issues.
-
-## Identity & Expertise
-
-- Expert at translating plans into working code
-- Deep knowledge of PowerToys codebase patterns and conventions
-- Skilled at writing tests, handling edge cases, and validating builds
-- You follow plans precisely while handling ambiguity gracefully
-
-## Goal
-
-For the given **issue_number**, execute the implementation plan and produce:
-1. Working code changes applied directly to the repository
-2. `Generated Files/issueFix/{{issue_number}}/pr-description.md` — PR-ready description
-3. `Generated Files/issueFix/{{issue_number}}/manual-steps.md` — Only if human action needed
-
-## Core Directive
-
-**Follow the implementation plan in `Generated Files/issueReview/{{issue_number}}/implementation-plan.md` as the single source of truth.**
-
-If the plan doesn't exist, invoke PlanIssue agent first via `runSubagent`.
-
-## Working Principles
-
-- **Plan First**: Read and understand the entire implementation plan before coding
-- **Validate Always**: For each change: Edit → Build → Verify → Commit. Never proceed if build fails.
-- **Atomic Commits**: Each commit must be self-contained, buildable, and meaningful
-- **Ask, Don't Guess**: When uncertain, insert `// TODO(Human input needed): <question>` and document in manual-steps.md
-
-## Strategy
-
-**Core Loop** — For every unit of work:
-1. **Edit**: Make focused changes to implement one logical piece
-2. **Build**: Run `tools\build\build.cmd` and check for exit code 0
-3. **Verify**: Use `problems` tool for lint/compile errors; run relevant tests
-4. **Commit**: Only after build passes — use `.github/prompts/create-commit-title.prompt.md`
-
-Never skip steps. Never commit broken code. Never proceed if build fails.
-
-**Feature-by-Feature E2E**: For big scenarios with multiple features, complete each feature end-to-end before moving to the next:
-- Settings UI → Functionality → Logging → Tests (for Feature 1)
-- Then repeat for Feature 2
-- Benefits: Each feature is self-contained, testable, easier to review, can ship incrementally
-
-**Large Changes** (3+ files or cross-module):
-- Use `tools\build\New-WorktreeFromBranch.ps1` for isolated worktrees
-- Create separate branches per feature (e.g., `issue/{{issue_number}}-export`, `issue/{{issue_number}}-import`)
-- Merge feature branches back after each is validated
-
-**Recovery**: If implementation goes wrong:
-- Create a checkpoint branch before risky changes
-- On failure: branch from last known-good state, cherry-pick working changes, abandon broken branch
-- For complex changes, consider multiple smaller PRs
-
-## Guidelines
-
-**DO**:
-- Follow the plan exactly
-- Validate build before every commit — **NEVER commit broken code**
-- Use `.github/prompts/create-commit-title.prompt.md` for commit messages
-- Add comprehensive tests for changed behavior
-- Use worktrees for large changes (3+ files or cross-module)
-- Document deviations from plan
-
-**DON'T**:
-- Implement everything in a single massive commit
-- Continue after a failed build without fixing
-- Make drive-by refactors outside issue scope
-- Skip tests for behavioral changes
-- Add noisy logs in hot paths
-- Break IPC/JSON contracts without updating both sides
-- Introduce dependencies without documenting in NOTICE.md
-
-## References
-
-- [Build Guidelines](../../tools/build/BUILD-GUIDELINES.md) — Build commands and validation
-- [Coding Style](../../doc/devdocs/development/style.md) — Formatting and conventions
-- [AGENTS.md](../../AGENTS.md) — Full contributor guide
-
-## Parameter
-
-- **issue_number**: Extract from `#123`, `issue 123`, or plain number. If missing, ask user.

.github/agents/PlanIssue.agent.md

@@ -1,65 +0,0 @@
----
-description: 'Analyzes GitHub issues to produce overview and implementation plans'
-name: 'PlanIssue'
-tools: ['execute', 'read', 'edit', 'search', 'web', 'github/*', 'agent', 'github-artifacts/*', 'todo']
-argument-hint: 'GitHub issue number (e.g., #12345)'
-handoffs:
-  - label: Start Implementation
-    agent: FixIssue
-    prompt: 'Fix issue #{{issue_number}} using the implementation plan'
-  - label: Open Plan in Editor
-    agent: agent
-    prompt: 'Open Generated Files/issueReview/{{issue_number}}/overview.md and implementation-plan.md'
-    showContinueOn: false
-    send: true
-infer: true
----
-
-# PlanIssue Agent
-
-You are a **PLANNING AGENT** specialized in analyzing GitHub issues and producing comprehensive planning documentation.
-
-## Identity & Expertise
-
-- Expert at issue triage, priority scoring, and technical analysis
-- Deep knowledge of PowerToys architecture and codebase patterns
-- Skilled at breaking down problems into actionable implementation steps
-- You research thoroughly before planning, gathering 80% confidence before drafting
-
-## Goal
-
-For the given **issue_number**, produce two deliverables:
-1. `Generated Files/issueReview/{{issue_number}}/overview.md` — Issue analysis with scoring
-2. `Generated Files/issueReview/{{issue_number}}/implementation-plan.md` — Technical implementation plan
-Above is the core interaction with the end user. If you cannot produce the files above, you fail the task. Each time, you must check whether the files exist or have been modified by the end user, without assuming you know their contents.
-3. `Generated Files/issueReview/{{issue_number}}/logs/**` — logs for your diagnostic of root cause, research steps, and reasoning
-
-## Core Directive
-
-**Follow the template in `.github/prompts/review-issue.prompt.md` exactly.** Read it first, then apply every section as specified.
-
-- Fetch issue details: reactions, comments, linked PRs, images, logs
-- Search related code and similar past fixes
-- Ask clarifying questions when ambiguous
-- Identify subject matter experts via git history
-
-<stopping_rules>
-You are a PLANNING agent, NOT an implementation agent.
-
-STOP if you catch yourself:
-- Writing code or editing source files outside `Generated Files/issueReview/`
-- Making assumptions without researching
-- Skipping the scoring/assessment phase
-
-Plans describe what the USER or FixIssue agent will execute later.
-</stopping_rules>
-
-## References
-
-- [Review Issue Prompt](../.github/prompts/review-issue.prompt.md) — Template for plan structure
-- [Architecture Overview](../../doc/devdocs/core/architecture.md) — System design context
-- [AGENTS.md](../../AGENTS.md) — Full contributor guide
-
-## Parameter
-
-- **issue_number**: Extract from `#123`, `issue 123`, or plain number. If missing, ask user.

.github/copilot-instructions.md

@@ -6,8 +6,15 @@ description: 'PowerToys AI contributor guidance'
 
 Concise guidance for AI contributions. For complete details, see [AGENTS.md](../AGENTS.md).
 
+## Quick Reference
+
+- **Build**: `tools\build\build-essentials.cmd` (first time), then `tools\build\build.cmd`
+- **Tests**: Find `<Product>*UnitTests` project, build it, run via VS Test Explorer
+- **Exit code 0 = success** – do not proceed if build fails
+
 ## Key Rules
 
+- One terminal per operation (build → test)
 - Atomic PRs: one logical change, no drive-by refactors
 - Add tests when changing behavior
 - Keep hot paths quiet (no logging in hooks/tight loops)
@@ -32,5 +39,7 @@ These are auto-applied based on file location:
 
 ## Detailed Documentation
 
+- [AGENTS.md](../AGENTS.md) – Full contributor guide
+- [Build Guidelines](../tools/build/BUILD-GUIDELINES.md)
 - [Architecture](../doc/devdocs/core/architecture.md)
 - [Coding Style](../doc/devdocs/development/style.md)

.github/instructions/agent-skills.instructions.md

@@ -1,261 +0,0 @@
----
-description: 'Guidelines for creating high-quality Agent Skills for GitHub Copilot'
-applyTo: '**/.github/skills/**/SKILL.md, **/.claude/skills/**/SKILL.md'
----
-
-# Agent Skills File Guidelines
-
-Instructions for creating effective and portable Agent Skills that enhance GitHub Copilot with specialized capabilities, workflows, and bundled resources.
-
-## What Are Agent Skills?
-
-Agent Skills are self-contained folders with instructions and bundled resources that teach AI agents specialized capabilities. Unlike custom instructions (which define coding standards), skills enable task-specific workflows that can include scripts, examples, templates, and reference data.
-
-Key characteristics:
-- **Portable**: Works across VS Code, Copilot CLI, and Copilot coding agent
-- **Progressive loading**: Only loaded when relevant to the user's request
-- **Resource-bundled**: Can include scripts, templates, examples alongside instructions
-- **On-demand**: Activated automatically based on prompt relevance
-
-## Directory Structure
-
-Skills are stored in specific locations:
-
-| Location | Scope | Recommendation |
-|----------|-------|----------------|
-| `.github/skills/<skill-name>/` | Project/repository | Recommended for project skills |
-| `.claude/skills/<skill-name>/` | Project/repository | Legacy, for backward compatibility |
-| `~/.github/skills/<skill-name>/` | Personal (user-wide) | Recommended for personal skills |
-| `~/.claude/skills/<skill-name>/` | Personal (user-wide) | Legacy, for backward compatibility |
-
-Each skill **must** have its own subdirectory containing at minimum a `SKILL.md` file.
-
-## Required SKILL.md Format
-
-### Frontmatter (Required)
-
-```yaml
----
-name: webapp-testing
-description: Toolkit for testing local web applications using Playwright. Use when asked to verify frontend functionality, debug UI behavior, capture browser screenshots, check for visual regressions, or view browser console logs. Supports Chrome, Firefox, and WebKit browsers.
-license: Complete terms in LICENSE.txt
----
-```
-
-| Field | Required | Constraints |
-|-------|----------|-------------|
-| `name` | Yes | Lowercase, hyphens for spaces, max 64 characters (e.g., `webapp-testing`) |
-| `description` | Yes | Clear description of capabilities AND use cases, max 1024 characters |
-| `license` | No | Reference to LICENSE.txt (e.g., `Complete terms in LICENSE.txt`) or SPDX identifier |
-
-### Description Best Practices
-
-**CRITICAL**: The `description` field is the PRIMARY mechanism for automatic skill discovery. Copilot reads ONLY the `name` and `description` to decide whether to load a skill. If your description is vague, the skill will never be activated.
-
-**What to include in description:**
-1. **WHAT** the skill does (capabilities)
-2. **WHEN** to use it (specific triggers, scenarios, file types, or user requests)
-3. **Keywords** that users might mention in their prompts
-
-**Good description:**
-```yaml
-description: Toolkit for testing local web applications using Playwright. Use when asked to verify frontend functionality, debug UI behavior, capture browser screenshots, check for visual regressions, or view browser console logs. Supports Chrome, Firefox, and WebKit browsers.
-```
-
-**Poor description:**
-```yaml
-description: Web testing helpers
-```
-
-The poor description fails because:
-- No specific triggers (when should Copilot load this?)
-- No keywords (what user prompts would match?)
-- No capabilities (what can it actually do?)
-
-### Body Content
-
-The body contains detailed instructions that Copilot loads AFTER the skill is activated. Recommended sections:
-
-| Section | Purpose |
-|---------|---------|
-| `# Title` | Brief overview of what this skill enables |
-| `## When to Use This Skill` | List of scenarios (reinforces description triggers) |
-| `## Prerequisites` | Required tools, dependencies, environment setup |
-| `## Step-by-Step Workflows` | Numbered steps for common tasks |
-| `## Troubleshooting` | Common issues and solutions table |
-| `## References` | Links to bundled docs or external resources |
-
-## Bundling Resources
-
-Skills can include additional files that Copilot accesses on-demand:
-
-### Supported Resource Types
-
-| Folder | Purpose | Loaded into Context? | Example Files |
-|--------|---------|---------------------|---------------|
-| `scripts/` | Executable automation that performs specific operations | When executed | `helper.py`, `validate.sh`, `build.ts` |
-| `references/` | Documentation the AI agent reads to inform decisions | Yes, when referenced | `api_reference.md`, `schema.md`, `workflow_guide.md` |
-| `assets/` | **Static files used AS-IS** in output (not modified by the AI agent) | No | `logo.png`, `brand-template.pptx`, `custom-font.ttf` |
-| `templates/` | **Starter code/scaffolds that the AI agent MODIFIES** and builds upon | Yes, when referenced | `viewer.html` (insert algorithm), `hello-world/` (extend) |
-
-### Directory Structure Example
-
-```
-.github/skills/my-skill/
-├── SKILL.md              # Required: Main instructions
-├── LICENSE.txt           # Recommended: License terms (Apache 2.0 typical)
-├── scripts/              # Optional: Executable automation
-│   ├── helper.py         # Python script
-│   └── helper.ps1        # PowerShell script
-├── references/           # Optional: Documentation loaded into context
-│   ├── api_reference.md
-│   ├── step1-setup.md     # Detailed workflow (>3 steps)
-│   └── step2-deployment.md
-├── assets/               # Optional: Static files used AS-IS in output
-│   ├── baseline.png      # Reference image for comparison
-│   └── report-template.html
-└── templates/            # Optional: Starter code the AI agent modifies
-    ├── scaffold.py       # Code scaffold the AI agent customizes
-    └── config.template   # Config template the AI agent fills in
-```
-
-> **LICENSE.txt**: When creating a skill, download the Apache 2.0 license text from https://www.apache.org/licenses/LICENSE-2.0.txt and save as `LICENSE.txt`. Update the copyright year and owner in the appendix section.
-
-### Assets vs Templates: Key Distinction
-
-**Assets** are static resources **consumed unchanged** in the output:
-- A `logo.png` that gets embedded into a generated document
-- A `report-template.html` copied as output format
-- A `custom-font.ttf` applied to text rendering
-
-**Templates** are starter code/scaffolds that **the AI agent actively modifies**:
-- A `scaffold.py` where the AI agent inserts logic
-- A `config.template` where the AI agent fills in values based on user requirements
-- A `hello-world/` project directory that the AI agent extends with new features
-
-**Rule of thumb**: If the AI agent reads and builds upon the file content → `templates/`. If the file is used as-is in output → `assets/`.
-
-### Referencing Resources in SKILL.md
-
-Use relative paths to reference files within the skill directory:
-
-```markdown
-## Available Scripts
-
-Run the [helper script](./scripts/helper.py) to automate common tasks.
-
-See [API reference](./references/api_reference.md) for detailed documentation.
-
-Use the [scaffold](./templates/scaffold.py) as a starting point.
-```
-
-## Progressive Loading Architecture
-
-Skills use three-level loading for efficiency:
-
-| Level | What Loads | When |
-|-------|------------|------|
-| 1. Discovery | `name` and `description` only | Always (lightweight metadata) |
-| 2. Instructions | Full `SKILL.md` body | When request matches description |
-| 3. Resources | Scripts, examples, docs | Only when Copilot references them |
-
-This means:
-- Install many skills without consuming context
-- Only relevant content loads per task
-- Resources don't load until explicitly needed
-
-## Content Guidelines
-
-### Writing Style
-
-- Use imperative mood: "Run", "Create", "Configure" (not "You should run")
-- Be specific and actionable
-- Include exact commands with parameters
-- Show expected outputs where helpful
-- Keep sections focused and scannable
-
-### Script Requirements
-
-When including scripts, prefer cross-platform languages:
-
-| Language | Use Case |
-|----------|----------|
-| Python | Complex automation, data processing |
-| pwsh | PowerShell Core scripting |
-| Node.js | JavaScript-based tooling |
-| Bash/Shell | Simple automation tasks |
-
-Best practices:
-- Include help/usage documentation (`--help` flag)
-- Handle errors gracefully with clear messages
-- Avoid storing credentials or secrets
-- Use relative paths where possible
-
-### When to Bundle Scripts
-
-Include scripts in your skill when:
-- The same code would be rewritten repeatedly by the agent
-- Deterministic reliability is critical (e.g., file manipulation, API calls)
-- Complex logic benefits from being pre-tested rather than generated each time
-- The operation has a self-contained purpose that can evolve independently
-- Testability matters — scripts can be unit tested and validated
-- Predictable behavior is preferred over dynamic generation
-
-Scripts enable evolution: even simple operations benefit from being implemented as scripts when they may grow in complexity, need consistent behavior across invocations, or require future extensibility.
-
-### Security Considerations
-
-- Scripts rely on existing credential helpers (no credential storage)
-- Include `--force` flags only for destructive operations
-- Warn users before irreversible actions
-- Document any network operations or external calls
-
-## Common Patterns
-
-### Parameter Table Pattern
-
-Document parameters clearly:
-
-```markdown
-| Parameter | Required | Default | Description |
-|-----------|----------|---------|-------------|
-| `--input` | Yes | - | Input file or URL to process |
-| `--action` | Yes | - | Action to perform |
-| `--verbose` | No | `false` | Enable verbose output |
-```
-
-## Validation Checklist
-
-Before publishing a skill:
-
-- [ ] `SKILL.md` has valid frontmatter with `name` and `description`
-- [ ] `name` is lowercase with hyphens, ≤64 characters
-- [ ] `description` clearly states **WHAT** it does, **WHEN** to use it, and relevant **KEYWORDS**
-- [ ] Body includes when to use, prerequisites, and step-by-step workflows
-- [ ] SKILL.md body kept under 500 lines (split large content into `references/` folder)
-- [ ] Large workflows (>5 steps) split into `references/` folder with clear links from SKILL.md
-- [ ] Scripts include help documentation and error handling
-- [ ] Relative paths used for all resource references
-- [ ] No hardcoded credentials or secrets
-
-## Workflow Execution Pattern
-
-When executing multi-step workflows, create a TODO list where each step references the relevant documentation:
-
-```markdown
-## TODO
-- [ ] Step 1: Configure environment - see [workflow-setup.md](./references/workflow-setup.md#environment)
-- [ ] Step 2: Build project - see [workflow-setup.md](./references/workflow-setup.md#build)
-- [ ] Step 3: Deploy to staging - see [workflow-deployment.md](./references/workflow-deployment.md#staging)
-- [ ] Step 4: Run validation - see [workflow-deployment.md](./references/workflow-deployment.md#validation)
-- [ ] Step 5: Deploy to production - see [workflow-deployment.md](./references/workflow-deployment.md#production)
-```
-
-This ensures traceability and allows resuming workflows if interrupted.
-
-## Related Resources
-
-- [Agent Skills Specification](https://agentskills.io/)
-- [VS Code Agent Skills Documentation](https://code.visualstudio.com/docs/copilot/customization/agent-skills)
-- [Reference Skills Repository](https://github.com/anthropics/skills)
-- [Awesome Copilot Skills](https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md)

.github/instructions/common-libraries.instructions.md

@@ -0,0 +1,61 @@
+---
+description: 'Guidelines for shared libraries including logging, IPC, settings, DPI, telemetry, and utilities consumed by multiple modules'
+applyTo: 'src/common/**'
+---
+
+# Common Libraries – Shared Code Guidance
+
+Guidelines for modifying shared code in `src/common/`. Changes here can have wide-reaching impact across the entire PowerToys codebase.
+
+## Scope
+
+- Logging infrastructure (`src/common/logger/`)
+- IPC primitives and named pipe utilities
+- Settings serialization and management
+- DPI awareness and scaling utilities
+- Telemetry helpers
+- General utilities (JSON parsing, string helpers, etc.)
+
+## Guidelines
+
+### API Stability
+
+- Avoid breaking public headers/APIs; if changed, search & update all callers
+- Coordinate ABI-impacting struct/class layout changes; keep binary compatibility
+- When modifying public interfaces, grep the entire codebase for usages
+
+### Performance
+
+- Watch perf in hot paths (hooks, timers, serialization)
+- Avoid avoidable allocations in frequently called code
+- Profile changes that touch performance-sensitive areas
+
+### Dependencies
+
+- Ask before adding third-party deps or changing serialization formats
+- New dependencies must be MIT-licensed or approved by PM team
+- Add any new external packages to `NOTICE.md`
+
+### Logging
+
+- C++ logging uses spdlog (`Logger::info`, `Logger::warn`, `Logger::error`, `Logger::debug`)
+- Initialize with `init_logger()` early in startup
+- Keep hot paths quiet – no logging in tight loops or hooks
+
+## Acceptance Criteria
+
+- No unintended ABI breaks
+- No noisy logs in hot paths
+- New non-obvious symbols briefly commented
+- All callers updated when interfaces change
+
+## Code Style
+
+- **C++**: Follow `.clang-format` in `src/`; use Modern C++ patterns per C++ Core Guidelines
+- **C#**: Follow `src/.editorconfig`; enforce StyleCop.Analyzers
+
+## Validation
+
+- Build: `tools\build\build.cmd` from `src/common/` folder
+- Verify no ABI breaks: grep for changed function/struct names across codebase
+- Check logs: ensure no new logging in performance-critical paths

.github/instructions/runner-settings-ui.instructions.md

@@ -0,0 +1,68 @@
+---
+description: 'Guidelines for Runner and Settings UI components that communicate via named pipes and manage module lifecycle'
+applyTo: 'src/runner/**,src/settings-ui/**'
+---
+
+# Runner & Settings UI – Core Components Guidance
+
+Guidelines for modifying the Runner (tray/module loader) and Settings UI (configuration app). These components communicate via Windows Named Pipes using JSON messages.
+
+## Runner (`src/runner/`)
+
+### Scope
+
+- Module bootstrap, hotkey management, settings bridge, update/elevation handling
+
+### Guidelines
+
+- If IPC/JSON contracts change, mirror updates in `src/settings-ui/**`
+- Keep module discovery in `src/runner/main.cpp` in sync when adding/removing modules
+- Keep startup lean: avoid blocking/network calls in early init path
+- Preserve GPO & elevation behaviors; confirm no regression in policy handling
+- Ask before modifying update workflow or elevation logic
+
+### Acceptance Criteria
+
+- Stable startup, consistent contracts, no unnecessary logging noise
+
+## Settings UI (`src/settings-ui/`)
+
+### Scope
+
+- WinUI/WPF UI, communicates with Runner over named pipes; manages persisted settings schema
+
+### Guidelines
+
+- Don't break settings schema silently; add migration when shape changes
+- If IPC/JSON contracts change, align with `src/runner/**` implementation
+- Keep UI responsive: marshal to UI thread for UI-bound operations
+- Reuse existing styles/resources; avoid duplicate theme keys
+- Add/adjust migration or serialization tests when changing persisted settings
+
+### Acceptance Criteria
+
+- Schema integrity preserved, responsive UI, consistent contracts, no style duplication
+
+## Shared Concerns
+
+### IPC Contract Changes
+
+When modifying the JSON message format between Runner and Settings UI:
+
+1. Update both `src/runner/` and `src/settings-ui/` in the same PR
+2. Preserve backward compatibility where possible
+3. Add migration logic for settings schema changes
+4. Test both directions of communication
+
+### Code Style
+
+- **C++ (Runner)**: Follow `.clang-format` in `src/`
+- **C# (Settings UI)**: Follow `src/.editorconfig`, use StyleCop.Analyzers
+- **XAML**: Use XamlStyler or run `.\.pipelines\applyXamlStyling.ps1 -Main`
+
+## Validation
+
+- Build Runner: `tools\build\build.cmd` from `src/runner/`
+- Build Settings UI: `tools\build\build.cmd` from `src/settings-ui/`
+- Test IPC: Launch both Runner and Settings UI, verify communication works
+- Schema changes: Run serialization tests if settings shape changed

.github/instructions/typescript-mcp-server.instructions.md

@@ -1,228 +0,0 @@
----
-description: 'Instructions for building Model Context Protocol (MCP) servers using the TypeScript SDK'
-applyTo: '**/*.ts, **/*.js, **/package.json'
----
-
-# TypeScript MCP Server Development
-
-## Instructions
-
-- Use the **@modelcontextprotocol/sdk** npm package: `npm install @modelcontextprotocol/sdk`
-- Import from specific paths: `@modelcontextprotocol/sdk/server/mcp.js`, `@modelcontextprotocol/sdk/server/stdio.js`, etc.
-- Use `McpServer` class for high-level server implementation with automatic protocol handling
-- Use `Server` class for low-level control with manual request handlers
-- Use **zod** for input/output schema validation: `npm install zod@3`
-- Always provide `title` field for tools, resources, and prompts for better UI display
-- Use `registerTool()`, `registerResource()`, and `registerPrompt()` methods (recommended over older APIs)
-- Define schemas using zod: `{ inputSchema: { param: z.string() }, outputSchema: { result: z.string() } }`
-- Return both `content` (for display) and `structuredContent` (for structured data) from tools
-- For HTTP servers, use `StreamableHTTPServerTransport` with Express or similar frameworks
-- For local integrations, use `StdioServerTransport` for stdio-based communication
-- Create new transport instances per request to prevent request ID collisions (stateless mode)
-- Use session management with `sessionIdGenerator` for stateful servers
-- Enable DNS rebinding protection for local servers: `enableDnsRebindingProtection: true`
-- Configure CORS headers and expose `Mcp-Session-Id` for browser-based clients
-- Use `ResourceTemplate` for dynamic resources with URI parameters: `new ResourceTemplate('resource://{param}', { list: undefined })`
-- Support completions for better UX using `completable()` wrapper from `@modelcontextprotocol/sdk/server/completable.js`
-- Implement sampling with `server.server.createMessage()` to request LLM completions from clients
-- Use `server.server.elicitInput()` to request additional user input during tool execution
-- Enable notification debouncing for bulk updates: `debouncedNotificationMethods: ['notifications/tools/list_changed']`
-- Dynamic updates: call `.enable()`, `.disable()`, `.update()`, or `.remove()` on registered items to emit `listChanged` notifications
-- Use `getDisplayName()` from `@modelcontextprotocol/sdk/shared/metadataUtils.js` for UI display names
-- Test servers with MCP Inspector: `npx @modelcontextprotocol/inspector`
-
-## Best Practices
-
-- Keep tool implementations focused on single responsibilities
-- Provide clear, descriptive titles and descriptions for LLM understanding
-- Use proper TypeScript types for all parameters and return values
-- Implement comprehensive error handling with try-catch blocks
-- Return `isError: true` in tool results for error conditions
-- Use async/await for all asynchronous operations
-- Close database connections and clean up resources properly
-- Validate input parameters before processing
-- Use structured logging for debugging without polluting stdout/stderr
-- Consider security implications when exposing file system or network access
-- Implement proper resource cleanup on transport close events
-- Use environment variables for configuration (ports, API keys, etc.)
-- Document tool capabilities and limitations clearly
-- Test with multiple clients to ensure compatibility
-
-## Common Patterns
-
-### Basic Server Setup (HTTP)
-```typescript
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import express from 'express';
-
-const server = new McpServer({
-    name: 'my-server',
-    version: '1.0.0'
-});
-
-const app = express();
-app.use(express.json());
-
-app.post('/mcp', async (req, res) => {
-    const transport = new StreamableHTTPServerTransport({
-        sessionIdGenerator: undefined,
-        enableJsonResponse: true
-    });
-    
-    res.on('close', () => transport.close());
-    
-    await server.connect(transport);
-    await transport.handleRequest(req, res, req.body);
-});
-
-app.listen(3000);
-```
-
-### Basic Server Setup (stdio)
-```typescript
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-
-const server = new McpServer({
-    name: 'my-server',
-    version: '1.0.0'
-});
-
-// ... register tools, resources, prompts ...
-
-const transport = new StdioServerTransport();
-await server.connect(transport);
-```
-
-### Simple Tool
-```typescript
-import { z } from 'zod';
-
-server.registerTool(
-    'calculate',
-    {
-        title: 'Calculator',
-        description: 'Perform basic calculations',
-        inputSchema: { a: z.number(), b: z.number(), op: z.enum(['+', '-', '*', '/']) },
-        outputSchema: { result: z.number() }
-    },
-    async ({ a, b, op }) => {
-        const result = op === '+' ? a + b : op === '-' ? a - b : 
-                      op === '*' ? a * b : a / b;
-        const output = { result };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output) }],
-            structuredContent: output
-        };
-    }
-);
-```
-
-### Dynamic Resource
-```typescript
-import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
-
-server.registerResource(
-    'user',
-    new ResourceTemplate('users://{userId}', { list: undefined }),
-    {
-        title: 'User Profile',
-        description: 'Fetch user profile data'
-    },
-    async (uri, { userId }) => ({
-        contents: [{
-            uri: uri.href,
-            text: `User ${userId} data here`
-        }]
-    })
-);
-```
-
-### Tool with Sampling
-```typescript
-server.registerTool(
-    'summarize',
-    {
-        title: 'Text Summarizer',
-        description: 'Summarize text using LLM',
-        inputSchema: { text: z.string() },
-        outputSchema: { summary: z.string() }
-    },
-    async ({ text }) => {
-        const response = await server.server.createMessage({
-            messages: [{
-                role: 'user',
-                content: { type: 'text', text: `Summarize: ${text}` }
-            }],
-            maxTokens: 500
-        });
-        
-        const summary = response.content.type === 'text' ? 
-            response.content.text : 'Unable to summarize';
-        const output = { summary };
-        return {
-            content: [{ type: 'text', text: JSON.stringify(output) }],
-            structuredContent: output
-        };
-    }
-);
-```
-
-### Prompt with Completion
-```typescript
-import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
-
-server.registerPrompt(
-    'review',
-    {
-        title: 'Code Review',
-        description: 'Review code with specific focus',
-        argsSchema: {
-            language: completable(z.string(), value => 
-                ['typescript', 'python', 'javascript', 'java']
-                    .filter(l => l.startsWith(value))
-            ),
-            code: z.string()
-        }
-    },
-    ({ language, code }) => ({
-        messages: [{
-            role: 'user',
-            content: {
-                type: 'text',
-                text: `Review this ${language} code:\n\n${code}`
-            }
-        }]
-    })
-);
-```
-
-### Error Handling
-```typescript
-server.registerTool(
-    'risky-operation',
-    {
-        title: 'Risky Operation',
-        description: 'An operation that might fail',
-        inputSchema: { input: z.string() },
-        outputSchema: { result: z.string() }
-    },
-    async ({ input }) => {
-        try {
-            const result = await performRiskyOperation(input);
-            const output = { result };
-            return {
-                content: [{ type: 'text', text: JSON.stringify(output) }],
-                structuredContent: output
-            };
-        } catch (err: unknown) {
-            const error = err as Error;
-            return {
-                content: [{ type: 'text', text: `Error: ${error.message}` }],
-                isError: true
-            };
-        }
-    }
-);
-```

.github/prompts/review-issue.prompt.md

@@ -15,14 +15,8 @@ For **#{{issue_number}}** produce:
 Figure out required inputs {{issue_number}} from the invocation context; if anything is missing, ask for the value or note it as a gap.
 
 # CONTEXT (brief)
-Ground evidence using `gh issue view {{issue_number}} --json number,title,body,author,createdAt,updatedAt,state,labels,milestone,reactions,comments,linkedPullRequests`, download images via MCP `github_issue_images` to better understand the issue context. Finally, use MCP `github_issue_attachments` to download logs with parameter `extractFolder` as `Generated Files/issueReview/{{issue_number}}/logs`, and analyze the downloaded logs if available to identify relevant issues. Locate the source code in the current workspace (use `rg`/`git grep` as needed). Link related issues and PRs.
-
-## When to call MCP tools
-If the following MCP "github-artifacts" tools are available in the environment, use them:
-- `github_issue_images`: use when the issue/PR likely contains screenshots or other visual evidence (UI bugs, glitches, design problems).
-- `github_issue_attachments`: use when the issue/PR mentions attached ZIPs (PowerToysReport_*.zip, logs.zip, debug.zip) or asks to analyze logs/diagnostics. Always provide `extractFolder` as `Generated Files/issueReview/{{issue_number}}/logs`
-
-If these tools are not available (not listed by the runtime), start the MCP server "github-artifacts" first.
+Ground evidence using `gh issue view {{issue_number}} --json number,title,body,author,createdAt,updatedAt,state,labels,milestone,reactions,comments,linkedPullRequests`, and download images to better understand the issue context.
+Locate source code in the current workspace; feel free to use `rg`/`git grep`. Link related issues and PRs.
 
 # OVERVIEW.MD
 ## Summary

.github/skills/release-note-generation/LICENSE.txt

@@ -1,201 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to the Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright 2026 Microsoft Corporation
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.

.github/skills/release-note-generation/SKILL.md

@@ -1,132 +0,0 @@
----
-name: release-note-generation
-description: Toolkit for generating PowerToys release notes from GitHub milestone PRs or commit ranges. Use when asked to create release notes, summarize milestone PRs, generate changelog, prepare release documentation, request Copilot reviews for PRs, update README for a new release, manage PR milestones, or collect PRs between commits/tags. Supports PR collection by milestone or commit range, milestone assignment, grouping by label, summarization with external contributor attribution, and README version bumping.
-license: Complete terms in LICENSE.txt
----
-
-# Release Note Generation Skill
-
-Generate professional release notes for PowerToys milestones by collecting merged PRs, requesting Copilot code reviews, grouping by label, and producing user-facing summaries.
-
-## Output Directory
-
-All generated artifacts are placed under `Generated Files/ReleaseNotes/` at the repository root (gitignored).
-
-```
-Generated Files/ReleaseNotes/
-├── milestone_prs.json           # Raw PR data from GitHub
-├── sorted_prs.csv               # Sorted PR list with Copilot summaries
-├── prs_with_milestone.csv       # Milestone assignment tracking
-├── grouped_csv/                 # PRs grouped by label (one CSV per label)
-├── grouped_md/                  # Generated markdown summaries per label
-└── v{VERSION}-release-notes.md  # Final consolidated release notes
-```
-
-## When to Use This Skill
-
-- Generate release notes for a milestone
-- Summarize PRs merged in a release
-- Request Copilot reviews for milestone PRs
-- Assign milestones to PRs missing them
-- Collect PRs between two commits/tags
-- Update README.md for a new version
-
-## Prerequisites
-
-- GitHub CLI (`gh`) installed and authenticated
-- MCP Server: github-mcp-server installed
-- GitHub Copilot code review enabled for the org/repo
-
-## Required Variables
-
-⚠️ **Before starting**, confirm `{{ReleaseVersion}}` with the user. If not provided, **ASK**: "What release version are we generating notes for? (e.g., 0.98)"
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `{{ReleaseVersion}}` | Target release version | `0.98` |
-
-## Workflow Overview
-
-```
-┌────────────────────────────────┐
-│ 1.1 Collect PRs (stable range) │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 1.2 Assign Milestones           │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 2.1–2.4 Label PRs (auto+human)  │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 3.1 Request Reviews (Copilot)  │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 3.2 Refresh PR data             │
-│ (CopilotSummary)                │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 3.3 Group by label              │
-│ (grouped_csv)                   │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 4.1 Summarize (grouped_md)      │
-└────────────────────────────────┘
-              ↓
-┌────────────────────────────────┐
-│ 4.2 Final notes (v{VERSION}.md) │
-└────────────────────────────────┘
-```
-
-| Step | Action | Details |
-|------|--------|---------|
-| 1.1 | Collect PRs | From previous release tag on `stable` branch → `sorted_prs.csv` |
-| 1.2 | Assign Milestones | Ensure all PRs have correct milestone |
-| 2.1–2.4 | Label PRs | Auto-suggest + human label low-confidence |
-| 3.1–3.3 | Reviews & Grouping | Request Copilot reviews → refresh → group by label |
-| 4.1–4.2 | Summaries & Final | Generate grouped summaries, then consolidate |
-
-## Detailed workflow docs
-
-Do not read all steps at once—only read the step you are executing.
-
-- [Step 1: Collection & Milestones](./references/step1-collection.md)
-- [Step 2: Labeling PRs](./references/step2-labeling.md)
-- [Step 3: Reviews & Grouping](./references/step3-review-grouping.md)
-- [Step 4: Summarization](./references/step4-summarization.md)
-
-
-## Available Scripts
-
-| Script | Purpose |
-|--------|---------|
-| [dump-prs-since-commit.ps1](./scripts/dump-prs-since-commit.ps1) | Fetch PRs between commits/tags |
-| [group-prs-by-label.ps1](./scripts/group-prs-by-label.ps1) | Group PRs into CSVs |
-| [collect-or-apply-milestones.ps1](./scripts/collect-or-apply-milestones.ps1) | Assign milestones |
-| [diff_prs.ps1](./scripts/diff_prs.ps1) | Incremental PR diff |
-
-## References
-
-- [Sample Output](./references/SampleOutput.md) - Example summary formatting
-- [Detailed Instructions](./references/Instruction.md) - Legacy full documentation
-
-## Conventions
-
-- **Terminal usage**: Disabled by default; only run scripts when user explicitly requests
-- **Batch generation**: Generate ALL grouped_md files in one pass, then human reviews
-- **PR order**: Preserve order from `sorted_prs.csv` in all outputs
-- **Label filtering**: Keeps `Product-*`, `Area-*`, `GitHub*`, `*Plugin`, `Issue-*`
-
-## Troubleshooting
-
-| Issue | Solution |
-|-------|----------|
-| `gh` command not found | Install GitHub CLI and add to PATH |
-| No PRs returned | Verify milestone title matches exactly |
-| Empty CopilotSummary | Request Copilot reviews first, then re-run dump |
-| Many unlabeled PRs | Return to labeling step before grouping |

.github/skills/release-note-generation/references/SampleOutput.md

@@ -1,9 +0,0 @@
- - Added mouse button actions so you can choose what left, right, or middle click does. Thanks [@PesBandi](https://github.com/PesBandi)!  
-
- - Aligned window styling with current Windows theme for a cleaner look. Thanks [@sadirano](https://github.com/sadirano)!  
-
- - Ensured screen readers are notified when the selected item in the list changes for better accessibility.
-
- - Implemented configurable UI test pipeline that can use pre-built official releases instead of building everything from scratch, reducing test execution time from 2+ hours.
-
- - Fixed Alt+Left Arrow navigation not working when search box contains text. Thanks [@jiripolasek](https://github.com/jiripolasek)!  

.github/skills/release-note-generation/references/step1-collection.md

@@ -1,143 +0,0 @@
-# Step 1: Collection and Milestones
-
-## 1.0 To-do
-- 1.0.1 Generate MemberList.md (REQUIRED)
-- 1.1 Collect PRs
-- 1.2 Assign Milestones (REQUIRED)
-
-## Required Variables
-
-⚠️ **Before starting**, confirm these values with the user:
-
-| Variable | Description | Example |
-|----------|-------------|---------|
-| `{{ReleaseVersion}}` | Target release version | `0.97` |
-| `{{PreviousReleaseTag}}` | Previous release tag from releases page | `v0.96.1` |
-
-**If user hasn't specified `{{ReleaseVersion}}`, ASK:** "What release version are we generating notes for? (e.g., 0.97)"
-
-**`{{PreviousReleaseTag}}` is derived from the releases page, not user input.** Use the latest published release tag (top of the page). You will use its tag name and tag commit SHA in Step 1.
-
----
-
-## 1.0.1 Generate MemberList.md (REQUIRED)
-
-Create `Generated Files/ReleaseNotes/MemberList.md` from the **PowerToys core team** section in [COMMUNITY.md](../../../COMMUNITY.md).
-
-Rules:
-- One GitHub username per line, **no** `@` prefix.
-- Use the usernames exactly as listed in the core team section.
-- Do not include former team members or other sections.
-
-Example (format only):
-```
-example-user
-another-user
-```
-
----
-
-## 1.1 Collect PRs
-
-### 1.1.1 Get the previous release commit
-
-1. Open the [PowerToys releases page](https://github.com/microsoft/PowerToys/releases/)
-2. Find the latest release (e.g., v0.96.1, which should be at the top)
-3. Set `{{PreviousReleaseTag}}` to that tag name (e.g., `v0.96.1`)
-4. Copy the full tag commit SHA as `{{SHALastRelease}}`
-
-
-**If the release SHA is not in your branch history:** Use the helper script to find an equivalent commit on the target branch by matching the commit title:
-
-```powershell
-pwsh ./.github/skills/release-note-generation/scripts/find-commit-by-title.ps1 `
-    -Commit '{{SHALastRelease}}' `
-    -Branch 'stable'
-```
-
-### 1.1.2 Run collection script against stable branch
-
-```powershell
-# Collect PRs from previous release to current HEAD of stable branch
-pwsh ./.github/skills/release-note-generation/scripts/dump-prs-since-commit.ps1 `
-    -StartCommit '{{SHALastRelease}}' `
-    -Branch 'stable' `
-    -OutputDir 'Generated Files/ReleaseNotes'
-```
-
-**Parameters:**
-- `-StartCommit` - Previous release tag or commit SHA (exclusive)
-- `-Branch` - Always use `stable` branch, not `main` (script uses `origin/stable` as the end ref)
-- `-EndCommit` - Optional override if you need a custom end ref
-- `-OutputDir` - Output directory for generated files
-
-**Reliability check:** If the script reports “No commits found”, the stable branch has not moved since the last release. In that case, either:
-- Confirm this is expected and stop (no new release notes), or
-- Re-run against `main` to gather pending changes for the next release cycle.
-
-The script detects both merge commits (`Merge pull request #12345`) and squash commits (`Feature (#12345)`).
-
-**Output** (in `Generated Files/ReleaseNotes/`):
-- `milestone_prs.json` - raw PR data
-- `sorted_prs.csv` - sorted PR list with columns: Id, Title, Labels, Author, Url, Body, CopilotSummary, NeedThanks
-
----
-
-## 1.2 Assign Milestones (REQUIRED)
-
-**Before generating release notes**, ensure all collected PRs have the correct milestone assigned.
-
-⚠️ **CRITICAL:** Do NOT proceed to labeling until all PRs have milestones assigned.
-
-### 1.2.1 Check current milestone status (dry run)
-
-```powershell
-# Dry run first to see what would be changed:
-pwsh ./.github/skills/release-note-generation/scripts/collect-or-apply-milestones.ps1 `
-    -InputCsv 'Generated Files/ReleaseNotes/sorted_prs.csv' `
-    -OutputCsv 'Generated Files/ReleaseNotes/prs_with_milestone.csv' `
-    -DefaultMilestone 'PowerToys {{ReleaseVersion}}' `
-    -ApplyMissing -WhatIf
-```
-
-This queries GitHub for each PR's current milestone and shows which PRs would be updated.
-
-### 1.2.2 Apply milestones to PRs missing them
-
-```powershell
-# Apply for real:
-pwsh ./.github/skills/release-note-generation/scripts/collect-or-apply-milestones.ps1 `
-    -InputCsv 'Generated Files/ReleaseNotes/sorted_prs.csv' `
-    -OutputCsv 'Generated Files/ReleaseNotes/prs_with_milestone.csv' `
-    -DefaultMilestone 'PowerToys {{ReleaseVersion}}' `
-    -ApplyMissing
-```
-
-**Script Behavior:**
-- Queries each PR's current milestone from GitHub
-- PRs that already have a milestone are **skipped** (not overwritten)
-- PRs missing a milestone get the default milestone applied
-- Outputs `prs_with_milestone.csv` with (Id, Milestone) columns
-- Produces summary: `Updated=X Skipped=Y Failed=Z`
-
-**Validation:** After assignment, all PRs in `prs_with_milestone.csv` should have the target milestone.
-
----
-
-## Additional Commands
-
-### Collect milestones only (no changes to GitHub)
-```powershell
-pwsh ./.github/skills/release-note-generation/scripts/collect-or-apply-milestones.ps1 `
-    -InputCsv 'Generated Files/ReleaseNotes/sorted_prs.csv' `
-    -OutputCsv 'Generated Files/ReleaseNotes/prs_with_milestone.csv'
-```
-
-### Local assignment only (fill blanks in CSV, no GitHub changes)
-```powershell
-pwsh ./.github/skills/release-note-generation/scripts/collect-or-apply-milestones.ps1 `
-    -InputCsv 'Generated Files/ReleaseNotes/sorted_prs.csv' `
-    -OutputCsv 'Generated Files/ReleaseNotes/prs_with_milestone.csv' `
-    -DefaultMilestone 'PowerToys {{ReleaseVersion}}' `
-    -LocalAssign
-```

.github/skills/release-note-generation/references/step2-labeling.md

@@ -1,131 +0,0 @@
-# Step 2: Label Unlabeled PRs
-
-## 2.0 To-do
-- 2.1 Identify unlabeled PRs (Agent Mode)
-- 2.2 Suggest labels (Agent Mode)
-- 2.3 Human label low-confidence PRs
-- 2.4 Recheck labels, delete Unlabeled.csv, and re-collect
-
-**Before grouping**, ensure all PRs have appropriate labels for categorization.
-
-⚠️ **CRITICAL:** Do NOT proceed to grouping until all PRs have labels assigned. PRs without labels will end up in `Unlabeled.csv` and won't appear in the correct release note sections.
-
-## 2.1 Identify unlabeled PRs (Agent Mode)
-
-Read `sorted_prs.csv` and identify PRs with empty or missing `Labels` column.
-
-For each unlabeled PR, analyze:
-- **Title** - Often contains module name or feature
-- **Body** - PR description with context
-- **CopilotSummary** - AI-generated summary of changes
-
-## 2.2 Suggest labels (Agent Mode)
-
-For each unlabeled PR, suggest an appropriate label based on the content analysis.
-
-**Output:** Create `Generated Files/ReleaseNotes/prs_label_review.md` with the following format:
-
-```markdown
-# PR Label Review
-
-Generated: YYYY-MM-DD HH:mm:ss
-
-## Summary
-- Total unlabeled PRs: X
-- High confidence: X
-- Medium confidence: X  
-- Low confidence: X
-
----
-
-## PRs Needing Review (sorted by confidence, low first)
-
-| PR | Title | Suggested Label | Confidence | Reason |
-|----|-------|-----------------|------------|--------|
-| [#12347](url) | Some generic fix | ??? | Low | Unclear from content |
-| [#12346](url) | Update dependencies | `Area-Build` | Medium | Body mentions NuGet packages |
-```
-
-Sort by confidence (low first) so human reviews uncertain ones first.
-
-After writing `prs_label_review.md`, **generate `prs_to_label.csv`, apply labels, and re-run collection** so the CSV/labels stay in sync:
-
-```powershell
-# Generate CSV from suggestions (agent)
-# Apply labels
-pwsh ./.github/skills/release-note-generation/scripts/apply-labels.ps1 `
-    -InputCsv 'Generated Files/ReleaseNotes/prs_to_label.csv'
-
-# Refresh collection
-pwsh ./.github/skills/release-note-generation/scripts/dump-prs-since-commit.ps1 `
-    -StartCommit '{{PreviousReleaseTag}}' -Branch 'stable' `
-    -OutputDir 'Generated Files/ReleaseNotes'
-```
-
-## 2.3 Human label low-confidence PRs
-
-Ask the human to label **low-confidence** PRs directly (in GitHub). Skip any they decide not to label.
-
-## 2.4 Recheck labels, delete Unlabeled.csv, and re-collect
-
-Recheck that all PRs now have labels. Delete `Unlabeled.csv` (if present), then re-run the collection script to update `sorted_prs.csv`:
-
-```powershell
-# Remove stale unlabeled output if it exists
-Remove-Item 'Generated Files/ReleaseNotes/Unlabeled.csv' -ErrorAction SilentlyContinue
-```
-
-```powershell
-pwsh ./.github/skills/release-note-generation/scripts/dump-prs-since-commit.ps1 `
-    -StartCommit '{{PreviousReleaseTag}}' -Branch 'stable' `
-    -OutputDir 'Generated Files/ReleaseNotes'
-```
-
----
-
-## Common Label Mappings
-
-| Keywords/Patterns | Suggested Label |
-| ----------------- | --------------- |
-| Advanced Paste, AP, clipboard, paste | `Product-Advanced Paste` |
-| CmdPal, Command Palette, cmdpal | `Product-Command Palette` |
-| FancyZones, zones, layout | `Product-FancyZones` |
-| ZoomIt, zoom, screen annotation | `Product-ZoomIt` |
-| Settings, settings-ui, Quick Access, flyout | `Product-Settings` |
-| Installer, setup, MSI, MSIX, WiX | `Area-Setup/Install` |
-| Build, pipeline, CI/CD, msbuild | `Area-Build` |
-| Test, unit test, UI test, fuzz | `Area-Tests` |
-| Localization, loc, translation, resw | `Area-Localization` |
-| Foundry, AI, LLM | `Product-Advanced Paste` (AI features) |
-| Mouse Without Borders, MWB | `Product-Mouse Without Borders` |
-| PowerRename, rename, regex | `Product-PowerRename` |
-| Peek, preview, file preview | `Product-Peek` |
-| Image Resizer, resize | `Product-Image Resizer` |
-| LightSwitch, theme, dark mode | `Product-LightSwitch` |
-| Quick Accent, accent, diacritics | `Product-Quick Accent` |
-| Awake, keep awake, caffeine | `Product-Awake` |
-| ColorPicker, color picker, eyedropper | `Product-ColorPicker` |
-| Hosts, hosts file | `Product-Hosts` |
-| Keyboard Manager, remap | `Product-Keyboard Manager` |
-| Mouse Highlighter | `Product-Mouse Highlighter` |
-| Mouse Jump | `Product-Mouse Jump` |
-| Find My Mouse | `Product-Find My Mouse` |
-| Mouse Pointer Crosshairs | `Product-Mouse Pointer Crosshairs` |
-| Shortcut Guide | `Product-Shortcut Guide` |
-| Text Extractor, OCR, PowerOCR | `Product-Text Extractor` |
-| Workspaces | `Product-Workspaces` |
-| File Locksmith | `Product-File Locksmith` |
-| Crop And Lock | `Product-CropAndLock` |
-| Environment Variables | `Product-Environment Variables` |
-| New+ | `Product-New+` |
-
-## Label Filtering Rules
-
-The grouping script keeps labels matching these patterns:
-- `Product-*`
-- `Area-*`
-- `GitHub*`
-- `*Plugin`
-- `Issue-*`
-
-Other labels are ignored for grouping purposes.

.github/skills/release-note-generation/references/step3-review-grouping.md

@@ -1,37 +0,0 @@
-# Step 3: Copilot Reviews and Grouping
-
-## 3.0 To-do
-- 3.1 Request Copilot Reviews (Agent Mode)
-- 3.2 Refresh PR Data
-- 3.3 Group PRs by Label
-
-## 3.1 Request Copilot Reviews (Agent Mode)
-
-Use MCP tools to request Copilot reviews for all PRs in `Generated Files/ReleaseNotes/sorted_prs.csv`:
-
-- Use `mcp_github_request_copilot_review` for each PR ID
-- Do NOT generate or run scripts for this step
-
----
-
-## 3.2 Refresh PR Data
-
-Re-run the collection script to capture Copilot review summaries into the `CopilotSummary` column:
-
-```powershell
-pwsh ./.github/skills/release-note-generation/scripts/dump-prs-since-commit.ps1 `
-    -StartCommit '{{PreviousReleaseTag}}' -Branch 'stable' `
-    -OutputDir 'Generated Files/ReleaseNotes'
-```
-
----
-
-## 3.3 Group PRs by Label
-
-```powershell
-pwsh ./.github/skills/release-note-generation/scripts/group-prs-by-label.ps1 -CsvPath 'Generated Files/ReleaseNotes/sorted_prs.csv' -OutDir 'Generated Files/ReleaseNotes/grouped_csv'
-```
-
-Creates `Generated Files/ReleaseNotes/grouped_csv/` with one CSV per label combination.
-
-**Validation:** The `Unlabeled.csv` file should be minimal (ideally empty). If many PRs remain unlabeled, return to Step 2 (see [step2-labeling.md](./step2-labeling.md)).

.github/skills/release-note-generation/references/step4-summarization.md

@@ -1,88 +0,0 @@
-# Step 4: Summaries and Final Release Notes
-
-## 4.0 To-do
-- 4.1 Generate Summary Markdown (Agent Mode)
-- 4.2 Produce Final Release Notes File
-
-## 4.1 Generate Summary Markdown (Agent Mode)
-
-For each CSV in `Generated Files/ReleaseNotes/grouped_csv/`, create a markdown file in `Generated Files/ReleaseNotes/grouped_md/`.
-
-⚠️ **IMPORTANT:** Generate **ALL** markdown files first. Do NOT pause between files or ask for feedback during generation. Complete the entire batch, then human reviews afterwards.
-
-### Structure per file
-
-**1. Bullet list** - one concise, user-facing line per PR:
-- Use the “Verb-ed + Scenario + Impact” sentence structure—make readers think, “That’s exactly what I need” or “Yes, that’s an awesome fix.”; The "impact" can be end-user focused (written to convey user excitement) or technical (performance/stability) when user-facing impact is minimal.
-- If nothing special on impact or unclear impact, mark as needing human summary
-- Source from Title, Body, and CopilotSummary (prefer CopilotSummary when available)
-- If the column `NeedThanks` in CSV is `True`, append: `Thanks [@Author](https://github.com/Author)!`
-- Do NOT include PR numbers in bullet lines
-- Do NOT mention “security” or “privacy” issues, since these are not known and could be leveraged by attackers in earlier versions. Instead, describe the user-facing scenario, usage, or impact.
-- If confidence < 70%, write: `Human Summary Needed: <PR full link>`
-
-**See [SampleOutput.md](./SampleOutput.md) for examples of well-written bullet summaries.**
-
-**2. Three-column table** (same PR order):
-- Column 1: Concise summary (same as bullet)
-- Column 2: PR link `[#ID](URL)`
-- Column 3: Confidence level (High/Medium/Low)
-
-### Review Process (AFTER all files generated)
-
-- Human reviews each `grouped_md/*.md` file and requests rewrites as needed
-- Human may say "rewrite Product-X" or "combine these bullets"—apply changes to that specific file
-- Do NOT interrupt generation to ask for feedback
-
----
-
-## 4.2 Produce Final Release Notes File
-
-Once all `grouped_md/*.md` files are reviewed and approved, consolidate into a single release notes file.
-
-**Output:** `Generated Files/ReleaseNotes/v{{ReleaseVersion}}-release-notes.md`
-
-### Structure
-
-**1. Highlights section** (top):
-- 8-12 bullets covering the most user-visible features and impactful fixes
-- Pattern: `**Module**: brief description`
-- Avoid internal refactors; focus on what users will notice
-
-**2. Module sections** (alphabetical order):
-- One section per product (Advanced Paste, Awake, Command Palette, etc.)
-- Migrate bullet summaries from the approved `grouped_md/Product-*.md` files
-- One section 'Development' for all the rest summaries from the approved `grouped_md/Area-*.md` files
-- Re-review E2E, group release improvements by section, and move the most important items to the top of each section.
-Some items in the Development section may overlap and should be moved to the Module section where more applicable.
-
-### Example Final Structure
-
-```markdown
-# PowerToys v{{ReleaseVersion}} Release Notes
-
-## Highlights
-
-- **Command Palette**: Added theme customization and drag-and-drop support
-- **Advanced Paste**: Image input for AI, color detection in clipboard history
-- **FancyZones**: New CLI tool for command-line layout management
-...
-
----
-
-## Advanced Paste
-
-- Wrapped paste option lists in a single ScrollViewer
-- Added image input handling for AI-powered transformations
-...
-
-## Awake
-
-- Fixed timed mode expiration. Thanks [@daverayment](https://github.com/daverayment)!
-...
-
----
-
-## Development
-...
-```

.github/skills/release-note-generation/scripts/apply-labels.ps1

@@ -1,90 +0,0 @@
-<#
-.SYNOPSIS
-    Apply labels to PRs from a CSV file.
-
-.DESCRIPTION
-    Reads a CSV with Id and Label columns and applies the specified label to each PR via GitHub CLI.
-    Supports dry-run mode to preview changes before applying.
-
-.PARAMETER InputCsv
-    CSV file with Id and Label columns. Default: prs_to_label.csv
-
-.PARAMETER Repo
-    GitHub repository (owner/name). Default: microsoft/PowerToys
-
-.PARAMETER WhatIf
-    Dry run - show what would be applied without making changes.
-
-.EXAMPLE
-    pwsh ./apply-labels.ps1 -InputCsv 'Generated Files/ReleaseNotes/prs_to_label.csv'
-
-.EXAMPLE
-    pwsh ./apply-labels.ps1 -InputCsv 'Generated Files/ReleaseNotes/prs_to_label.csv' -WhatIf
-
-.NOTES
-    Requires: gh CLI authenticated with repo write access.
-    
-    Input CSV format:
-    Id,Label
-    12345,Product-Advanced Paste
-    12346,Product-Settings
-#>
-[CmdletBinding()] param(
-    [Parameter(Mandatory=$false)][string]$InputCsv = 'prs_to_label.csv',
-    [Parameter(Mandatory=$false)][string]$Repo = 'microsoft/PowerToys',
-    [switch]$WhatIf
-)
-
-$ErrorActionPreference = 'Stop'
-
-function Write-Info($m){ Write-Host "[info] $m" -ForegroundColor Cyan }
-function Write-Warn($m){ Write-Host "[warn] $m" -ForegroundColor Yellow }
-function Write-Err($m){ Write-Host "[error] $m" -ForegroundColor Red }
-function Write-OK($m){ Write-Host "[ok] $m" -ForegroundColor Green }
-
-if (-not (Get-Command gh -ErrorAction SilentlyContinue)) { Write-Err "GitHub CLI 'gh' not found in PATH"; exit 1 }
-if (-not (Test-Path -LiteralPath $InputCsv)) { Write-Err "Input CSV not found: $InputCsv"; exit 1 }
-
-$rows = Import-Csv -LiteralPath $InputCsv
-if (-not $rows) { Write-Info "No rows in CSV."; exit 0 }
-
-$firstCols = $rows[0].PSObject.Properties.Name
-if (-not ($firstCols -contains 'Id' -and $firstCols -contains 'Label')) { 
-    Write-Err "CSV must contain 'Id' and 'Label' columns"; exit 1 
-}
-
-Write-Info "Processing $($rows.Count) label assignments..."
-if ($WhatIf) { Write-Warn "DRY RUN - no changes will be made" }
-
-$applied = 0
-$skipped = 0
-$failed = 0
-
-foreach ($row in $rows) {
-    $id = $row.Id
-    $label = $row.Label
-    
-    if ([string]::IsNullOrWhiteSpace($id) -or [string]::IsNullOrWhiteSpace($label)) {
-        Write-Warn "Skipping row with empty Id or Label"
-        $skipped++
-        continue
-    }
-    
-    if ($WhatIf) {
-        Write-Info "Would apply label '$label' to PR #$id"
-        $applied++
-        continue
-    }
-    
-    try {
-        gh pr edit $id --repo $Repo --add-label $label 2>&1 | Out-Null
-        Write-OK "Applied '$label' to PR #$id"
-        $applied++
-    } catch {
-        Write-Warn "Failed to apply label to PR #${id}: $_"
-        $failed++
-    }
-}
-
-Write-Info ""
-Write-Info "Summary: Applied=$applied Skipped=$skipped Failed=$failed"

.github/skills/release-note-generation/scripts/collect-or-apply-milestones.ps1

@@ -1,172 +0,0 @@
-<#
-.SYNOPSIS
-    Collect existing PR milestones or (optionally) assign/apply a milestone to missing PRs in one script.
-
-.DESCRIPTION
-    This unified script merges the behaviors of the previous add-milestone-column (collector) and
-    set-milestones-missing (remote updater) scripts.
-
-    Modes (controlled by switches):
-      1. Collect (default)  – For each PR Id in the input CSV, queries GitHub for the current milestone and
-                              outputs a two-column CSV (Id,Milestone) leaving blanks where none are set.
-      2. LocalAssign        – Same as Collect, but for rows that end up blank assigns the value of -DefaultMilestone
-                              in memory (does NOT touch GitHub). Useful for quickly preparing a fully populated CSV.
-      3. ApplyMissing       – After determining which PRs have no milestone, call GitHub API to set their milestone
-                              to -DefaultMilestone. Requires milestone to already exist (open). Network + write.
-
-    You can combine LocalAssign and ApplyMissing: the remote update uses the existing live state; LocalAssign only
-    affects the output CSV/pipeline objects.
-
-.PARAMETER InputCsv
-    Source CSV with at least an Id column. Default: sorted_prs.csv
-
-.PARAMETER OutputCsv
-    Destination CSV for collected (and optionally locally assigned) milestones. Default: prs_with_milestone.csv
-
-.PARAMETER Repo
-    GitHub repository (owner/name). Default: microsoft/PowerToys
-
-.PARAMETER DefaultMilestone
-    Milestone title used when -LocalAssign or -ApplyMissing is specified. Default: 'PowerToys 0.97'
-
-.PARAMETER Offline
-    Skip ALL GitHub lookups / updates. Implies Collect-only with all Milestone cells blank (unless LocalAssign).
-
-.PARAMETER LocalAssign
-    Populate empty Milestone cells in the output with -DefaultMilestone (does not modify GitHub).
-
-.PARAMETER ApplyMissing
-    For PRs which currently have no milestone (live on GitHub), set them to -DefaultMilestone via Issues API.
-
-.PARAMETER WhatIf
-    Dry run for ApplyMissing: show intended remote changes without performing PATCH requests.
-
-.EXAMPLE
-    # Collect only
-    pwsh ./collect-or-apply-milestones.ps1
-
-.EXAMPLE
-    # Collect and fill blanks locally in the output only
-    pwsh ./collect-or-apply-milestones.ps1 -LocalAssign
-
-.EXAMPLE
-    # Collect and remotely apply milestone to missing PRs
-    pwsh ./collect-or-apply-milestones.ps1 -ApplyMissing
-
-.EXAMPLE
-    # Dry run remote application
-    pwsh ./collect-or-apply-milestones.ps1 -ApplyMissing -WhatIf
-
-.EXAMPLE
-    # Offline local assignment
-    pwsh ./collect-or-apply-milestones.ps1 -Offline -LocalAssign -DefaultMilestone 'PowerToys 0.96'
-
-.NOTES
-    Requires gh CLI unless -Offline AND -ApplyMissing not specified.
-    Remote apply path queries milestones to resolve numeric ID.
-#>
-[CmdletBinding()] param(
-    [Parameter(Mandatory=$false)][string]$InputCsv = 'sorted_prs.csv',
-    [Parameter(Mandatory=$false)][string]$OutputCsv = 'prs_with_milestone.csv',
-    [Parameter(Mandatory=$false)][string]$Repo = 'microsoft/PowerToys',
-    [Parameter(Mandatory=$false)][string]$DefaultMilestone = 'PowerToys 0.97',
-    [switch]$Offline,
-    [switch]$LocalAssign,
-    [switch]$ApplyMissing,
-    [switch]$WhatIf
-)
-
-$ErrorActionPreference = 'Stop'
-function Write-Info($m){ Write-Host "[info] $m" -ForegroundColor Cyan }
-function Write-Warn($m){ Write-Host "[warn] $m" -ForegroundColor Yellow }
-function Write-Err($m){ Write-Host "[error] $m" -ForegroundColor Red }
-
-if (-not (Test-Path -LiteralPath $InputCsv)) { Write-Err "Input CSV not found: $InputCsv"; exit 1 }
-$rows = Import-Csv -LiteralPath $InputCsv
-if (-not $rows) { Write-Warn "Input CSV has no rows."; @() | Export-Csv -NoTypeInformation -LiteralPath $OutputCsv; exit 0 }
-if (-not ($rows[0].PSObject.Properties.Name -contains 'Id')) { Write-Err "Input CSV missing 'Id' column."; exit 1 }
-
-$needGh = (-not $Offline) -and ($ApplyMissing -or -not $Offline)
-if ($needGh -and -not (Get-Command gh -ErrorAction SilentlyContinue)) { Write-Err "GitHub CLI 'gh' not found. Use -Offline or install gh."; exit 1 }
-
-# Step 1: Collect current milestone titles
-$milestoneCache = @{}
-$collected = New-Object System.Collections.Generic.List[object]
-$idx = 0
-foreach ($row in $rows) {
-    $idx++
-    $id = $row.Id
-    if (-not $id) { Write-Warn "Row $idx missing Id; skipping"; continue }
-    $ms = ''
-    if (-not $Offline) {
-        if ($milestoneCache.ContainsKey($id)) { $ms = $milestoneCache[$id] }
-        else {
-            try {
-                $json = gh pr view $id --repo $Repo --json milestone 2>$null | ConvertFrom-Json
-                if ($json -and $json.milestone -and $json.milestone.title) { $ms = $json.milestone.title }
-            } catch {
-                Write-Warn "Failed to fetch PR #$id milestone: $_"
-            }
-            $milestoneCache[$id] = $ms
-        }
-    }
-    $collected.Add([PSCustomObject]@{ Id = $id; Milestone = $ms }) | Out-Null
-}
-
-# Step 2: Remote apply (if requested)
-$applySummary = @()
-if ($ApplyMissing) {
-    if ($Offline) { Write-Err "Cannot use -ApplyMissing with -Offline."; exit 1 }
-    Write-Info "Resolving milestone id for '$DefaultMilestone' ..."
-    $milestonesRaw = gh api repos/$Repo/milestones --paginate --jq '.[] | {number,title,state}'
-    $msObj = $milestonesRaw | ConvertFrom-Json | Where-Object { $_.title -eq $DefaultMilestone -and $_.state -eq 'open' } | Select-Object -First 1
-    if (-not $msObj) { Write-Err "Milestone '$DefaultMilestone' not found/open."; exit 1 }
-    $msNumber = $msObj.number
-    $targets = $collected | Where-Object { [string]::IsNullOrWhiteSpace($_.Milestone) }
-    Write-Info ("ApplyMissing: {0} PR(s) without milestone." -f $targets.Count)
-    foreach ($t in $targets) {
-        $id = $t.Id
-        try {
-            # Verify still missing live
-            $current = gh pr view $id --repo $Repo --json milestone --jq '.milestone.title // ""'
-            if ($current) {
-                $applySummary += [PSCustomObject]@{ Id=$id; Action='Skip (already has)'; Milestone=$current; Status='OK' }
-                continue
-            }
-            if ($WhatIf) {
-                $applySummary += [PSCustomObject]@{ Id=$id; Action='Would set'; Milestone=$DefaultMilestone; Status='DRY RUN' }
-                continue
-            }
-            gh api -X PATCH -H 'Accept: application/vnd.github+json' repos/$Repo/issues/$id -f milestone=$msNumber | Out-Null
-            $applySummary += [PSCustomObject]@{ Id=$id; Action='Set'; Milestone=$DefaultMilestone; Status='OK' }
-            # Reflect in collected object for CSV output if not LocalAssign already doing so
-            $t.Milestone = $DefaultMilestone
-        } catch {
-            $errText = $_ | Out-String
-            $applySummary += [PSCustomObject]@{ Id=$id; Action='Failed'; Milestone=$DefaultMilestone; Status=$errText.Trim() }
-            Write-Warn ("Failed to set milestone for PR #{0}: {1}" -f $id, ($errText.Trim()))
-        }
-    }
-}
-
-# Step 3: Local assignment (purely for output) AFTER remote so remote actual result not overwritten accidentally
-if ($LocalAssign) {
-    foreach ($item in $collected) {
-        if ([string]::IsNullOrWhiteSpace($item.Milestone)) { $item.Milestone = $DefaultMilestone }
-    }
-}
-
-# Step 4: Export CSV
-$collected | Export-Csv -LiteralPath $OutputCsv -NoTypeInformation -Encoding UTF8
-Write-Info ("Wrote collected CSV -> {0}" -f (Resolve-Path -LiteralPath $OutputCsv))
-
-# Step 5: Summaries
-if ($ApplyMissing) {
-    $updated = ($applySummary | Where-Object { $_.Action -eq 'Set' }).Count
-    $skipped = ($applySummary | Where-Object { $_.Action -like 'Skip*' }).Count
-    $failed  = ($applySummary | Where-Object { $_.Action -eq 'Failed' }).Count
-    Write-Info ("ApplyMissing summary: Updated={0} Skipped={1} Failed={2}" -f $updated, $skipped, $failed)
-}
-
-# Emit objects (final collected set)
-return $collected

.github/skills/release-note-generation/scripts/diff_prs.ps1

@@ -1,100 +0,0 @@
-<#
-.SYNOPSIS
-    Produce an incremental PR CSV containing rows present in a newer full export but absent from a baseline export.
-
-.DESCRIPTION
-    Compares two previously generated sorted PR CSV files (same schema). Any row whose key column value
-    (defaults to 'Number') does not exist in the baseline file is emitted to a new incremental CSV, preserving
-    the original column order. If no new rows are found, an empty CSV (with headers when determinable) is written.
-
-.PARAMETER BaseCsv
-    Path to the baseline (earlier) PR CSV.
-
-.PARAMETER AllCsv
-    Path to the newer full PR CSV containing superset (or equal set) of rows.
-
-.PARAMETER OutCsv
-    Path to write the incremental CSV containing only new rows.
-
-.PARAMETER Key
-    Column name used as unique identifier (defaults to 'Number'). Must exist in both CSVs.
-
-.EXAMPLE
-    pwsh ./diff_prs.ps1 -BaseCsv sorted_prs_prev.csv -AllCsv sorted_prs.csv -OutCsv sorted_prs_incremental.csv
-
-.NOTES
-    Requires: PowerShell 7+, both CSVs with identical column schemas.
-    Exit code 0 on success (even if zero incremental rows). Throws on missing files.
-#>
-
-[CmdletBinding()] param(
-    [Parameter(Mandatory=$false)][string]$BaseCsv = "./sorted_prs_93_round1.csv",
-    [Parameter(Mandatory=$false)][string]$AllCsv  = "./sorted_prs.csv",
-    [Parameter(Mandatory=$false)][string]$OutCsv  = "./sorted_prs_93_incremental.csv",
-    [Parameter(Mandatory=$false)][string]$Key     = "Number"
-)
-
-Set-StrictMode -Version Latest
-$ErrorActionPreference = 'Stop'
-
-function Write-Info($m) { Write-Host "[info] $m" -ForegroundColor Cyan }
-function Write-Warn($m) { Write-Host "[warn] $m" -ForegroundColor Yellow }
-
-if (-not (Test-Path -LiteralPath $BaseCsv)) { throw "Base CSV not found: $BaseCsv" }
-if (-not (Test-Path -LiteralPath $AllCsv)) { throw "All CSV not found: $AllCsv" }
-
-# Load CSVs
-$baseRows = Import-Csv -LiteralPath $BaseCsv
-$allRows  = Import-Csv -LiteralPath $AllCsv
-
-if (-not $baseRows) { Write-Warn "Base CSV has no rows." }
-if (-not $allRows)  { Write-Warn "All CSV has no rows." }
-
-# Validate key presence
-if ($baseRows -and -not ($baseRows[0].PSObject.Properties.Name -contains $Key)) { throw "Key column '$Key' not found in base CSV." }
-if ($allRows  -and -not ($allRows[0].PSObject.Properties.Name -contains $Key))  { throw "Key column '$Key' not found in all CSV." }
-
-# Build a set of existing keys from base
-$set = New-Object 'System.Collections.Generic.HashSet[string]'
-foreach ($row in $baseRows) {
-    $val = [string]($row.$Key)
-    if ($null -ne $val) { [void]$set.Add($val) }
-}
-
-# Filter rows in AllCsv whose key is not in base (these are the new / incremental rows)
-$incremental = @()
-foreach ($row in $allRows) {
-    $val = [string]($row.$Key)
-    if (-not $set.Contains($val)) { $incremental += $row }
-}
-
-# Preserve column order from the All CSV
-$columns = @()
-if ($allRows.Count -gt 0) {
-    $columns = $allRows[0].PSObject.Properties.Name
-}
-
-try {
-    if ($incremental.Count -gt 0) {
-        if ($columns.Count -gt 0) {
-            $incremental | Select-Object -Property $columns | Export-Csv -LiteralPath $OutCsv -NoTypeInformation -Encoding UTF8
-        } else {
-            $incremental | Export-Csv -LiteralPath $OutCsv -NoTypeInformation -Encoding UTF8
-        }
-    } else {
-        # Write an empty CSV with headers if we know them (facilitates downstream tooling expecting header row)
-        if ($columns.Count -gt 0) {
-            $obj = [PSCustomObject]@{}
-            foreach ($c in $columns) { $obj | Add-Member -NotePropertyName $c -NotePropertyValue $null }
-            $obj | Select-Object -Property $columns | Export-Csv -LiteralPath $OutCsv -NoTypeInformation -Encoding UTF8
-        } else {
-            '' | Out-File -LiteralPath $OutCsv -Encoding UTF8
-        }
-    }
-    Write-Info ("Incremental rows: {0}" -f $incremental.Count)
-    Write-Info ("Output: {0}" -f (Resolve-Path -LiteralPath $OutCsv))
-}
-catch {
-    Write-Host "[error] Failed writing output CSV: $_" -ForegroundColor Red
-    exit 1
-}

.github/skills/release-note-generation/scripts/dump-prs-since-commit.ps1

@@ -1,344 +0,0 @@
-<#
-.SYNOPSIS
-    Export merged PR metadata between two commits (exclusive start, inclusive end) to JSON and CSV.
-
-.DESCRIPTION
-    Identifies merge/squash commits reachable from EndCommit but not StartCommit, extracts PR numbers,
-    queries GitHub for metadata plus (optionally) Copilot review/comment summaries, filters labels, then
-    emits a JSON artifact and a sorted CSV (first label alphabetical).
-
-.PARAMETER StartCommit
-    Exclusive starting commit (SHA, tag, or ref). Commits AFTER this one are considered.
-
-.PARAMETER EndCommit
-    Inclusive ending commit (SHA, tag, or ref). If not provided, uses origin/<Branch> when Branch is set; otherwise uses HEAD.
-
-.PARAMETER Repo
-    GitHub repository (owner/name). Default: microsoft/PowerToys.
-
-.PARAMETER OutputCsv
-    Destination CSV path. Default: sorted_prs.csv.
-
-.PARAMETER OutputJson
-    Destination JSON path containing raw PR objects. Default: milestone_prs.json.
-
-.EXAMPLE
-    pwsh ./dump-prs-since-commit.ps1 -StartCommit 0123abcd -Branch stable
-
-.EXAMPLE
-    pwsh ./dump-prs-since-commit.ps1 -StartCommit 0123abcd -EndCommit 89ef7654 -OutputCsv delta.csv
-
-.NOTES
-    Requires: git, gh (authenticated). No Set-StrictMode to keep parity with existing release scripts.
-#>
-[CmdletBinding()]
-param(
-    [Parameter(Mandatory = $true)][string]$StartCommit,  # exclusive start (commits AFTER this one)
-    [string]$EndCommit,
-    [string]$Branch,
-    [string]$Repo = "microsoft/PowerToys",
-    [string]$OutputDir,
-    [string]$OutputCsv = "sorted_prs.csv",
-    [string]$OutputJson = "milestone_prs.json"
-)
-
-<#
-.SYNOPSIS
-    Dump merged PR information whose merge commits are reachable from EndCommit but not from StartCommit.
-.DESCRIPTION
-    Uses git rev-list to compute commits in the (StartCommit, EndCommit] range, extracts PR numbers from merge commit messages,
-    queries GitHub (gh CLI) for details, then outputs a CSV.
-
-    PR merge commit messages in PowerToys generally contain patterns like:
-        Merge pull request #12345 from ...
-
-.EXAMPLE
-    pwsh ./dump-prs-since-commit.ps1 -StartCommit 0123abcd -Branch stable
-
-.EXAMPLE
-    pwsh ./dump-prs-since-commit.ps1 -StartCommit 0123abcd -EndCommit 89ef7654 -OutputCsv changes.csv
-
-.NOTES
-    Requires: gh CLI authenticated; git available in working directory (must be inside PowerToys repo clone).
-    CopilotSummary behavior:
-      - Attempts to locate the latest GitHub Copilot authored review (preferred).
-      - If no review is found, lazily fetches PR comments to look for a Copilot-authored comment.
-      - Normalizes whitespace and strips newlines. Empty when no Copilot activity detected.
-      - Run with -Verbose to see whether the summary came from a 'review' or 'comment' source.
-#>
-
-function Write-Info($msg) { Write-Host $msg -ForegroundColor Cyan }
-function Write-Warn($msg) { Write-Host $msg -ForegroundColor Yellow }
-function Write-Err($msg) { Write-Host $msg -ForegroundColor Red }
-function Write-DebugMsg($msg) { if ($PSBoundParameters.ContainsKey('Verbose') -or $VerbosePreference -eq 'Continue') { Write-Host "[VERBOSE] $msg" -ForegroundColor DarkGray } }
-
-# Load member list from Generated Files/ReleaseNotes/MemberList.md (internal team - no thanks needed)
-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$repoRoot = Resolve-Path (Join-Path $scriptDir "..\..\..\..")
-$defaultMemberListPath = Join-Path $repoRoot "Generated Files\ReleaseNotes\MemberList.md"
-$memberListPath = $defaultMemberListPath
-if ($OutputDir) {
-    $memberListFromOutputDir = Join-Path $OutputDir "MemberList.md"
-    if (Test-Path $memberListFromOutputDir) {
-        $memberListPath = $memberListFromOutputDir
-    }
-}
-$memberList = @()
-if (Test-Path $memberListPath) {
-    $memberListContent = Get-Content $memberListPath -Raw
-    # Extract usernames - skip markdown code fence lines, get all non-empty lines
-    $memberList = ($memberListContent -split "`n") | Where-Object { $_ -notmatch '^\s*```' -and $_.Trim() -ne '' } | ForEach-Object { $_.Trim() }
-    if (-not $memberList -or $memberList.Count -eq 0) {
-        Write-Err "MemberList.md is empty at $memberListPath"
-        exit 1
-    }
-    Write-DebugMsg "Loaded $($memberList.Count) members from MemberList.md"
-} else {
-    Write-Err "MemberList.md not found at $memberListPath"
-    exit 1
-}
-
-# Validate we are in a git repo
-#if (-not (Test-Path .git)) {
-#    Write-Err "Current directory does not appear to be the root of a git repository."
-#    exit 1
-#}
-
-# Resolve output directory (if specified)
-if ($OutputDir) {
-    if (-not (Test-Path $OutputDir)) {
-        New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
-    }
-    if (-not [System.IO.Path]::IsPathRooted($OutputCsv)) {
-        $OutputCsv = Join-Path $OutputDir $OutputCsv
-    }
-    if (-not [System.IO.Path]::IsPathRooted($OutputJson)) {
-        $OutputJson = Join-Path $OutputDir $OutputJson
-    }
-}
-
-# Resolve commits
-try {
-    if ($Branch) {
-        Write-Info "Fetching latest '$Branch' from origin (with tags)..."
-        git fetch origin $Branch --tags | Out-Null
-        if ($LASTEXITCODE -ne 0) { throw "git fetch origin $Branch --tags failed" }
-    }
-
-    $startSha = (git rev-parse --verify $StartCommit) 2>$null
-    if (-not $startSha) { throw "StartCommit '$StartCommit' not found" }
-    if ($Branch) {
-        $branchRef = $Branch
-        $branchSha = (git rev-parse --verify $branchRef) 2>$null
-        if (-not $branchSha) {
-            $branchRef = "origin/$Branch"
-            $branchSha = (git rev-parse --verify $branchRef) 2>$null
-        }
-        if (-not $branchSha) { throw "Branch '$Branch' not found" }
-        if (-not $PSBoundParameters.ContainsKey('EndCommit') -or [string]::IsNullOrWhiteSpace($EndCommit)) {
-            $EndCommit = $branchRef
-        }
-    }
-    if (-not $PSBoundParameters.ContainsKey('EndCommit') -or [string]::IsNullOrWhiteSpace($EndCommit)) {
-        $EndCommit = "HEAD"
-    }
-    $endSha = (git rev-parse --verify $EndCommit) 2>$null
-    if (-not $endSha) { throw "EndCommit '$EndCommit' not found" }
-}
-catch {
-    Write-Err $_
-    exit 1
-}
-
-Write-Info "Collecting commits between $startSha..$endSha (excluding start, including end)."
-    # Get list of commits reachable from end but not from start.
-    # IMPORTANT: In PowerShell, the .. operator creates a numeric/char range. If $startSha and $endSha look like hex strings,
-    # `$startSha..$endSha` must be passed as a single string argument.
-    $rangeArg = "$startSha..$endSha"
-    $commitList = git rev-list $rangeArg
-
-# Normalize list (filter out empty strings)
-$normalizedCommits = $commitList | Where-Object { $_ -and $_.Trim() -ne '' }
-$commitCount = ($normalizedCommits | Measure-Object).Count
-Write-DebugMsg ("Raw commitList length (including blanks): {0}" -f (($commitList | Measure-Object).Count))
-Write-DebugMsg ("Normalized commit count: {0}" -f $commitCount)
-if ($commitCount -eq 0) {
-    Write-Warn "No commits found in specified range ($startSha..$endSha)."; exit 0
-}
-Write-DebugMsg ("First 5 commits: {0}" -f (($normalizedCommits | Select-Object -First 5) -join ', '))
-
-<#
-    Extract PR numbers from commits.
-    Patterns handled:
-      1. Merge commits:   'Merge pull request #12345 from ...'
-      2. Squash commits:  'Some feature change (#12345)' (GitHub default squash format)
-    We collect both. If a commit matches both (unlikely), it's deduped later.
-#>
-# Extract PR numbers from merge or squash commits
-$mergeCommits = @()
-foreach ($c in $normalizedCommits) {
-    $subject = git show -s --format=%s $c
-    $matched = $false
-    # Pattern 1: Traditional merge commit
-    if ($subject -match 'Merge pull request #([0-9]+) ') {
-        $prNumber = [int]$matches[1]
-        $mergeCommits += [PSCustomObject]@{ Sha = $c; Pr = $prNumber; Subject = $subject; Pattern = 'merge' }
-        Write-DebugMsg "Matched merge PR #$prNumber in commit $c"
-        $matched = $true
-    }
-    # Pattern 2: Squash merge subject line with ' (#12345)' at end (allow possible whitespace before paren)
-    if ($subject -match '\(#([0-9]+)\)$') {
-        $prNumber2 = [int]$matches[1]
-        # Avoid duplicate object if pattern 1 already captured same number for same commit
-        if (-not ($mergeCommits | Where-Object { $_.Sha -eq $c -and $_.Pr -eq $prNumber2 })) {
-            $mergeCommits += [PSCustomObject]@{ Sha = $c; Pr = $prNumber2; Subject = $subject; Pattern = 'squash' }
-            Write-DebugMsg "Matched squash PR #$prNumber2 in commit $c"
-        }
-        $matched = $true
-    }
-    if (-not $matched) {
-        Write-DebugMsg "No PR pattern in commit $c : $subject"
-    }
-}
-
-if (-not $mergeCommits -or $mergeCommits.Count -eq 0) {
-    Write-Warn "No merge commits with PR numbers found in range."; exit 0
-}
-
-# Deduplicate PR numbers (in case of revert or merges across branches)
-$prNumbers = $mergeCommits | Select-Object -ExpandProperty Pr -Unique | Sort-Object
-Write-Info ("Found {0} unique PRs: {1}" -f $prNumbers.Count, ($prNumbers -join ', '))
-Write-DebugMsg ("Total merge commits examined: {0}" -f $mergeCommits.Count)
-
-# Query GitHub for each PR
-$prDetails = @()
-function Get-CopilotSummaryFromPrJson {
-    param(
-        [Parameter(Mandatory=$true)]$PrJson,
-        [switch]$VerboseMode
-    )
-    # Returns a hashtable with Summary and Source keys.
-    $result = @{ Summary = ""; Source = "" }
-    if (-not $PrJson) { return $result }
-
-    $candidateAuthors = @(
-        'github-copilot[bot]', 'github-copilot', 'copilot'
-    )
-
-    # 1. Reviews (preferred) – pick the LONGEST valid Copilot body, not the most recent
-    $reviews = $PrJson.reviews
-    if ($reviews) {
-        $copilotReviews = $reviews | Where-Object {
-            ($candidateAuthors -contains $_.author.login -or $_.author.login -like '*copilot*') -and $_.body -and $_.body.Trim() -ne ''
-        }
-        if ($copilotReviews) {
-            $longest = $copilotReviews | Sort-Object { $_.body.Length } -Descending | Select-Object -First 1
-            if ($longest) {
-                $body = $longest.body
-                $norm = ($body -replace "`r", '') -replace "`n", ' '
-                $norm = $norm -replace '\s+', ' '
-                $result.Summary = $norm
-                $result.Source = 'review'
-                if ($VerboseMode) { Write-DebugMsg "Selected Copilot review length=$($body.Length) (longest)." }
-                return $result
-            }
-        }
-    }
-
-    # 2. Comments fallback (some repos surface Copilot summaries as PR comments rather than review objects)
-    if ($null -eq $PrJson.comments) {
-        try {
-            # Lazy fetch comments only if needed
-            $commentsJson = gh pr view $PrJson.number --repo $Repo --json comments 2>$null | ConvertFrom-Json
-            if ($commentsJson -and $commentsJson.comments) {
-                $PrJson | Add-Member -NotePropertyName comments -NotePropertyValue $commentsJson.comments -Force
-            }
-        } catch {
-            if ($VerboseMode) { Write-DebugMsg "Failed to fetch comments for PR #$($PrJson.number): $_" }
-        }
-    }
-    if ($PrJson.comments) {
-        $copilotComments = $PrJson.comments | Where-Object {
-            ($candidateAuthors -contains $_.author.login -or $_.author.login -like '*copilot*') -and $_.body -and $_.body.Trim() -ne ''
-        }
-        if ($copilotComments) {
-            $longestC = $copilotComments | Sort-Object { $_.body.Length } -Descending | Select-Object -First 1
-            if ($longestC) {
-                $body = $longestC.body
-                $norm = ($body -replace "`r", '') -replace "`n", ' '
-                $norm = $norm -replace '\s+', ' '
-                $result.Summary = $norm
-                $result.Source = 'comment'
-                if ($VerboseMode) { Write-DebugMsg "Selected Copilot comment length=$($body.Length) (longest)." }
-                return $result
-            }
-        }
-    }
-
-    return $result
-}
-
-foreach ($pr in $prNumbers) {
-    Write-Info "Fetching PR #$pr ..."
-    try {
-        # Include comments only if Verbose asked; if not, we lazily pull when reviews are missing
-        $fields = 'number,title,labels,author,url,body,reviews'
-        if ($PSBoundParameters.ContainsKey('Verbose')) { $fields += ',comments' }
-        $json = gh pr view $pr --repo $Repo --json $fields 2>$null | ConvertFrom-Json
-        if ($null -eq $json) { throw "Empty response" }
-
-        $copilot = Get-CopilotSummaryFromPrJson -PrJson $json -VerboseMode:($PSBoundParameters.ContainsKey('Verbose'))
-        if ($copilot.Summary -and $copilot.Source -and $PSBoundParameters.ContainsKey('Verbose')) {
-            Write-DebugMsg "Copilot summary source=$($copilot.Source) chars=$($copilot.Summary.Length)"
-        } elseif (-not $copilot.Summary) {
-            Write-DebugMsg "No Copilot summary found for PR #$pr"
-        }
-
-        # Filter labels
-        $filteredLabels = $json.labels | Where-Object {
-            ($_.name -like "Product-*") -or 
-            ($_.name -like "Area-*") -or 
-            ($_.name -like "GitHub*") -or 
-            ($_.name -like "*Plugin") -or 
-            ($_.name -like "Issue-*")
-        }
-        $labelNames = ($filteredLabels | ForEach-Object { $_.name }) -join ", "
-
-        $bodyValue = if ($json.body) { ($json.body -replace "`r", '') -replace "`n", ' ' } else { '' }
-        $bodyValue = $bodyValue -replace '\s+', ' '
-
-        # Determine if author needs thanks (not in member list)
-        $authorLogin = $json.author.login
-        $needThanks = $true
-        if ($memberList.Count -gt 0 -and $authorLogin) {
-            $needThanks = -not ($memberList -contains $authorLogin)
-        }
-
-        $prDetails += [PSCustomObject]@{
-            Id = $json.number
-            Title = $json.title
-            Labels = $labelNames
-            Author = $authorLogin
-            Url = $json.url
-            Body = $bodyValue
-            CopilotSummary = $copilot.Summary
-            NeedThanks = $needThanks
-        }
-    }
-    catch {
-        $err = $_
-        Write-Warn ("Failed to fetch PR #{0}: {1}" -f $pr, $err)
-    }
-}
-
-if (-not $prDetails) { Write-Warn "No PR details fetched."; exit 0 }
-
-# Sort by Labels like original script (first label alphabetical)
-$sorted = $prDetails | Sort-Object { ($_.Labels -split ',')[0] }
-
-# Output JSON raw (optional)
-$sorted | ConvertTo-Json -Depth 6 | Out-File -Encoding UTF8 $OutputJson
-
-Write-Info "Saving CSV to $OutputCsv ..."
-$sorted | Export-Csv $OutputCsv -NoTypeInformation
-Write-Host "✅ Done. Generated $($prDetails.Count) PR rows." -ForegroundColor Green

.github/skills/release-note-generation/scripts/find-commit-by-title.ps1

@@ -1,80 +0,0 @@
-<#
-.SYNOPSIS
-    Find a commit on a branch that has the same subject line as a reference commit.
-
-.DESCRIPTION
-    Given a commit SHA (often from a release tag) and a branch name, this script
-    resolves the reference commit's subject, then searches the branch history for
-    commits with the exact same subject line. Useful when the release tag commit
-    is not reachable from your current branch history.
-
-.PARAMETER Commit
-    The reference commit SHA or ref (e.g., v0.96.1 or a full SHA).
-
-.PARAMETER Branch
-    The branch to search (e.g., stable or main). Defaults to stable.
-
-.PARAMETER RepoPath
-    Path to the local repo. Defaults to current directory.
-
-.EXAMPLE
-    pwsh ./find-commit-by-title.ps1 -Commit b62f6421845f7e5c92b8186868d98f46720db442 -Branch stable
-#>
-[CmdletBinding()]
-param(
-    [Parameter(Mandatory = $true)][string]$Commit,
-    [string]$Branch = "stable",
-    [string]$RepoPath = "."
-)
-
-function Write-Info($msg) { Write-Host $msg -ForegroundColor Cyan }
-function Write-Err($msg) { Write-Host $msg -ForegroundColor Red }
-
-Push-Location $RepoPath
-try {
-    Write-Info "Fetching latest '$Branch' from origin (with tags)..."
-    git fetch origin $Branch --tags | Out-Null
-    if ($LASTEXITCODE -ne 0) { throw "git fetch origin $Branch --tags failed" }
-
-    $commitSha = (git rev-parse --verify $Commit) 2>$null
-    if (-not $commitSha) { throw "Commit '$Commit' not found" }
-
-    $subject = (git show -s --format=%s $commitSha) 2>$null
-    if (-not $subject) { throw "Unable to read subject for '$commitSha'" }
-
-    $branchRef = $Branch
-    $branchSha = (git rev-parse --verify $branchRef) 2>$null
-    if (-not $branchSha) {
-        $branchRef = "origin/$Branch"
-        $branchSha = (git rev-parse --verify $branchRef) 2>$null
-    }
-    if (-not $branchSha) { throw "Branch '$Branch' not found" }
-
-    Write-Info "Reference commit: $commitSha"
-    Write-Info "Reference title:  $subject"
-    Write-Info "Searching branch: $branchRef"
-
-    $matches = git log $branchRef --format="%H|%s" | Where-Object { $_ -match '\|' }
-    $results = @()
-    foreach ($line in $matches) {
-        $parts = $line -split '\|', 2
-        if ($parts.Count -eq 2 -and $parts[1] -eq $subject) {
-            $results += [PSCustomObject]@{ Sha = $parts[0]; Title = $parts[1] }
-        }
-    }
-
-    if (-not $results -or $results.Count -eq 0) {
-        Write-Info "No matching commit found on $branchRef for the given title."
-        exit 0
-    }
-
-    Write-Info ("Found {0} matching commit(s):" -f $results.Count)
-    $results | ForEach-Object { Write-Host ("{0}  {1}" -f $_.Sha, $_.Title) }
-}
-catch {
-    Write-Err $_
-    exit 1
-}
-finally {
-    Pop-Location
-}

.github/skills/release-note-generation/scripts/group-prs-by-label.ps1

@@ -1,85 +0,0 @@
-<#
-.SYNOPSIS
-    Group PR rows by their Labels column and emit per-label CSV files.
-
-.DESCRIPTION
-    Reads a milestone PR CSV (usually produced by dump-prs-information / dump-prs-since-commit scripts),
-    splits rows by label list, normalizes/sorts individual labels, and writes one CSV per unique label combination.
-    Each output preserves the original row ordering within that subset and column order from the source.
-
-.PARAMETER CsvPath
-    Input CSV containing PR rows with a 'Labels' column (comma-separated list).
-
-.PARAMETER OutDir
-    Output directory to place grouped CSVs (created if missing). Default: 'grouped_csv'.
-
-.NOTES
-    Label combinations are joined using ' | ' when multiple labels present. Filenames are sanitized (invalid characters,
-    whitespace collapsed) and truncated to <= 120 characters.
-#>
-param(
-    [string]$CsvPath = "sorted_prs.csv",
-    [string]$OutDir = "grouped_csv"
-)
-
-$ErrorActionPreference = 'Stop'
-
-function Write-Info($msg) { Write-Host "[info] $msg" -ForegroundColor Cyan }
-function Write-Warn($msg) { Write-Host "[warn] $msg" -ForegroundColor Yellow }
-
-if (-not (Test-Path -LiteralPath $CsvPath)) { throw "CSV not found: $CsvPath" }
-
-Write-Info "Reading CSV: $CsvPath"
-$rows = Import-Csv -LiteralPath $CsvPath
-Write-Info ("Loaded {0} rows" -f $rows.Count)
-
-function ConvertTo-SafeFileName {
-    [CmdletBinding()]
-    param(
-        [Parameter(Mandatory=$true)][string]$Name
-    )
-    if ([string]::IsNullOrWhiteSpace($Name)) { return 'Unnamed' }
-    $s = $Name -replace '[<>:"/\\|?*]', '-'             # invalid path chars
-    $s = $s -replace '\s+', '-'                          # spaces to dashes
-    $s = $s -replace '-{2,}', '-'                         # collapse dashes
-    $s = $s.Trim('-')
-    if ($s.Length -gt 120) { $s = $s.Substring(0,120).Trim('-') }
-    if ([string]::IsNullOrWhiteSpace($s)) { return 'Unnamed' }
-    return $s
-}
-
-# Build groups keyed by normalized, sorted label combinations. Preserve original CSV row order.
-$groups = @{}
-foreach ($row in $rows) {
-    $labelsRaw = $row.Labels
-    if ([string]::IsNullOrWhiteSpace($labelsRaw)) {
-        $labelParts = @('Unlabeled')
-    } else {
-        $parts = $labelsRaw -split ',' | ForEach-Object { $_.Trim() } | Where-Object { $_ }
-        if (-not $parts -or $parts.Count -eq 0) { $labelParts = @('Unlabeled') }
-        else { $labelParts = $parts | Sort-Object }
-    }
-
-    $key = ($labelParts -join ' | ')
-    if (-not $groups.ContainsKey($key)) { $groups[$key] = New-Object System.Collections.ArrayList }
-    [void]$groups[$key].Add($row)
-}
-
-if (-not (Test-Path -LiteralPath $OutDir)) {
-    Write-Info "Creating output directory: $OutDir"
-    New-Item -ItemType Directory -Path $OutDir | Out-Null
-}
-
-Write-Info ("Generating {0} grouped CSV file(s) into: {1}" -f $groups.Count, $OutDir)
-
-foreach ($key in $groups.Keys) {
-    $labelParts = if ($key -eq 'Unlabeled') { @('Unlabeled') } else { $key -split '\s\|\s' }
-    $safeName = ($labelParts | ForEach-Object { ConvertTo-SafeFileName -Name $_ }) -join '-'
-    $filePath = Join-Path $OutDir ("$safeName.csv")
-
-    # Keep same columns and order
-    $groups[$key] | Export-Csv -LiteralPath $filePath -NoTypeInformation -Encoding UTF8
-}
-
-Write-Info "Done. Sample output files:"
-Get-ChildItem -LiteralPath $OutDir | Select-Object -First 10 Name | Format-Table -HideTableHeaders

.gitignore

@@ -359,4 +359,3 @@ src/common/Telemetry/*.etl
 
 # PowerToysInstaller Build Temp Files
 installer/*/*.wxs.bk
-/src/modules/awake/.claude

.pipelines/v2/templates/job-build-project.yml

@@ -504,14 +504,6 @@ jobs:
         Remove-Item -Force -Recurse "$(JobOutputDirectory)/_appx" -ErrorAction:Ignore
       displayName: Re-pack the new CmdPal package after signing
 
-    - pwsh: |
-        $testsPath = "$(Build.SourcesDirectory)/$(BuildPlatform)/$(BuildConfiguration)/tests"
-        if (Test-Path $testsPath) {
-            Remove-Item -Path $testsPath -Recurse -Force
-            Write-Host "Removed tests folder to reduce signing workload: $testsPath"
-        }
-      displayName: Remove tests folder before signing
-
     - template: steps-esrp-signing.yml
       parameters:
         displayName: Sign Core PowerToys

.vscode/mcp.json

@@ -1,13 +0,0 @@
-{
-  "servers": {
-    "github-artifacts": {
-      "command": "node",
-      "args": [
-        "tools/mcp/github-artifacts/launch.js"
-      ],
-      "env": {
-        "GITHUB_TOKEN": "${env:GITHUB_TOKEN}"
-      }
-    }
-  }
-}

AGENTS.md

@@ -0,0 +1,165 @@
+---
+description: 'Top-level AI contributor guidance for developing PowerToys - a collection of Windows productivity utilities'
+applyTo: '**'
+---
+
+# PowerToys – AI Contributor Guide
+
+This is the top-level guidance for AI contributions to PowerToys. Keep changes atomic, follow existing patterns, and cite exact paths in PRs.
+
+## Overview
+
+PowerToys is a set of utilities for power users to tune and streamline their Windows experience.
+
+| Area | Location | Description |
+|------|----------|-------------|
+| Runner | `src/runner/` | Main executable, tray icon, module loader, hotkey management |
+| Settings UI | `src/settings-ui/` | WinUI/WPF configuration app communicating via named pipes |
+| Modules | `src/modules/` | Individual PowerToys utilities (each in its own subfolder) |
+| Common Libraries | `src/common/` | Shared code: logging, IPC, settings, DPI, telemetry, utilities |
+| Build Tools | `tools/build/` | Build scripts and automation |
+| Documentation | `doc/devdocs/` | Developer documentation |
+| Installer | `installer/` | WiX-based installer projects |
+
+For architecture details and module types, see [Architecture Overview](doc/devdocs/core/architecture.md).
+
+## Conventions
+
+For detailed coding conventions, see:
+- [Coding Guidelines](doc/devdocs/development/guidelines.md) – Dependencies, testing, PR management
+- [Coding Style](doc/devdocs/development/style.md) – Formatting, C++/C#/XAML style rules
+- [Logging](doc/devdocs/development/logging.md) – C++ spdlog and C# Logger usage
+
+### Component-Specific Instructions
+
+These instruction files are automatically applied when working in their respective areas:
+- [Runner & Settings UI](.github/instructions/runner-settings-ui.instructions.md) – IPC contracts, schema migrations
+- [Common Libraries](.github/instructions/common-libraries.instructions.md) – ABI stability, shared code guidelines
+
+## Build
+
+### Prerequisites
+
+- Visual Studio 2022 17.4+
+- Windows 10 1803+ (April 2018 Update or newer)
+- Initialize submodules once: `git submodule update --init --recursive`
+
+### Build Commands
+
+| Task | Command |
+|------|---------|
+| First build / NuGet restore | `tools\build\build-essentials.cmd` |
+| Build current folder | `tools\build\build.cmd` |
+| Build with options | `build.ps1 -Platform x64 -Configuration Release` |
+
+### Build Discipline
+
+1. One terminal per operation (build → test). Do not switch or open new ones mid-flow
+2. After making changes, `cd` to the project folder that changed (`.csproj`/`.vcxproj`)
+3. Use scripts to build: `tools/build/build.ps1` or `tools/build/build.cmd`
+4. For first build or missing NuGet packages, run `build-essentials.cmd` first
+5. **Exit code 0 = success; non-zero = failure** – treat this as absolute
+6. On failure, read the errors log: `build.<config>.<platform>.errors.log`
+7. Do not start tests or launch Runner until the build succeeds
+
+### Build Logs
+
+Located next to the solution/project being built:
+- `build.<configuration>.<platform>.errors.log` – errors only (check this first)
+- `build.<configuration>.<platform>.all.log` – full log
+- `build.<configuration>.<platform>.trace.binlog` – for MSBuild Structured Log Viewer
+
+For complete details, see [Build Guidelines](tools/build/BUILD-GUIDELINES.md).
+
+## Tests
+
+### Test Discovery
+
+- Find test projects by product code prefix (e.g., `FancyZones`, `AdvancedPaste`)
+- Look for sibling folders or 1-2 levels up named `<Product>*UnitTests` or `<Product>*UITests`
+
+### Running Tests
+
+1. **Build the test project first**, wait for exit code 0
+2. Run via VS Test Explorer (`Ctrl+E, T`) or `vstest.console.exe` with filters
+3. **Avoid `dotnet test`** in this repo – use VS Test Explorer or vstest.console.exe
+
+### Test Types
+
+| Type | Requirements | Setup |
+|------|--------------|-------|
+| Unit Tests | Standard dev environment | None |
+| UI Tests | WinAppDriver v1.2.1, Developer Mode | Install from [WinAppDriver releases](https://github.com/microsoft/WinAppDriver/releases/tag/v1.2.1) |
+| Fuzz Tests | OneFuzz, .NET 8 | See [Fuzzing Tests](doc/devdocs/tools/fuzzingtesting.md) |
+
+### Test Discipline
+
+1. Add or adjust tests when changing behavior
+2. If tests skipped, state why (e.g., comment-only change, string rename)
+3. New modules handling file I/O or user input **must** implement fuzzing tests
+
+### Special Requirements
+
+- **Mouse Without Borders**: Requires 2+ physical computers (not VMs)
+- **Multi-monitor utilities**: Test with 2+ monitors, different DPI settings
+
+For UI test setup details, see [UI Tests](doc/devdocs/development/ui-tests.md).
+
+## Boundaries
+
+### Ask for Clarification When
+
+- Ambiguous spec after scanning relevant docs
+- Cross-module impact (shared enum/struct) is unclear
+- Security, elevation, or installer changes involved
+- GPO or policy handling modifications needed
+
+### Areas Requiring Extra Care
+
+| Area | Concern | Reference |
+|------|---------|-----------|
+| `src/common/` | ABI breaks | [Common Libraries Instructions](.github/instructions/common-libraries.instructions.md) |
+| `src/runner/`, `src/settings-ui/` | IPC contracts, schema | [Runner & Settings UI Instructions](.github/instructions/runner-settings-ui.instructions.md) |
+| Installer files | Release impact | Careful review required |
+| Elevation/GPO logic | Security | Confirm no regression in policy handling |
+
+### What NOT to Do
+
+- Don't merge incomplete features into main (use feature branches)
+- Don't break IPC/JSON contracts without updating both runner and settings-ui
+- Don't add noisy logs in hot paths
+- Don't introduce third-party deps without PM approval and `NOTICE.md` update
+
+## Validation Checklist
+
+Before finishing, verify:
+
+- [ ] Build clean with exit code 0
+- [ ] Tests updated and passing locally
+- [ ] No unintended ABI breaks or schema changes
+- [ ] IPC contracts consistent between runner and settings-ui
+- [ ] New dependencies added to `NOTICE.md`
+- [ ] PR is atomic (one logical change), with issue linked
+
+## Documentation Index
+
+### Core Architecture
+- [Architecture Overview](doc/devdocs/core/architecture.md)
+- [Runner](doc/devdocs/core/runner.md)
+- [Settings System](doc/devdocs/core/settings/readme.md)
+- [Module Interface](doc/devdocs/modules/interface.md)
+
+### Development
+- [Coding Guidelines](doc/devdocs/development/guidelines.md)
+- [Coding Style](doc/devdocs/development/style.md)
+- [Logging](doc/devdocs/development/logging.md)
+- [UI Tests](doc/devdocs/development/ui-tests.md)
+- [Fuzzing Tests](doc/devdocs/tools/fuzzingtesting.md)
+
+### Build & Tools
+- [Build Guidelines](tools/build/BUILD-GUIDELINES.md)
+- [Tools Overview](doc/devdocs/tools/readme.md)
+
+### Instructions (Auto-Applied)
+- [Runner & Settings UI](.github/instructions/runner-settings-ui.instructions.md)
+- [Common Libraries](.github/instructions/common-libraries.instructions.md)

DATA_AND_PRIVACY.md

@@ -30,11 +30,7 @@ _If you want to find diagnostic data events in the source code, these two links
 - [C++ events](https://github.com/search?q=repo%3Amicrosoft%2FPowerToys+ProjectTelemetryPrivacyDataTag&type=code)
 
 ### General
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -47,18 +43,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.GeneralSettingsChanged</td>
     <td>Logs changes made to general settings within PowerToys.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.Install_Fail</td>
-    <td>Triggered when the PowerToys installation process encounters an error and fails to complete.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.Repair_Cancel</td>
-    <td>Triggered when a PowerToys repair operation is cancelled by the user before completion.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.Repair_Fail</td>
-    <td>Triggered when the PowerToys repair operation fails to complete successfully due to an error.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.Runner_Launch</td>
     <td>Indicates when the PowerToys Runner is launched.</td>
@@ -75,18 +59,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.ScoobeStartedEvent</td>
     <td>Triggered when SCOOBE (Secondary Out-of-box experience) starts.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.ShortcutConflictControlClickedEvent</td>
-    <td>Triggered when a user clicks on the Shortcut Conflict Control button in the PowerToys Settings UI Dashboard.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.ShortcutConflictDetectedEvent</td>
-    <td>Triggered when keyboard shortcut conflicts are detected in the PowerToys Settings UI Dashboard.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.ShortcutConflictResolvedEvent</td>
-    <td>Triggered when a keyboard shortcut conflict is resolved in the PowerToys Settings UI.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.TrayFlyoutActivatedEvent</td>
     <td>Indicates when the tray flyout menu is activated.</td>
@@ -95,42 +67,18 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.TrayFlyoutModuleRunEvent</td>
     <td>Logs when a utility from the tray flyout menu is run.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.UnInstall_Cancel</td>
-    <td>Triggered when the PowerToys uninstallation process is cancelled by the user before completion.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.UnInstall_Fail</td>
-    <td>Triggered when the PowerToys uninstallation process fails to complete successfully due to an error. </td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.Uninstall_Success</td>
     <td>Logs when PowerToys is successfully uninstalled (who would do such a thing!).</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.UpdateCheck_Completed</td>
-    <td>Logs when an auto-update check completes, including success status, whether an update is available, and version information.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.UpdateDownload_Completed</td>
-    <td>Logs when an update download completes, including success status and version.</td>
-  </tr>
 </table>
 
 ### OOBE (Out-of-box experience)
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.OobeModuleRunEvent</td>
-    <td>Triggered when a user clicks to run or launch a PowerToys module directly from the OOBE (out-of-box experience) interface.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.OobeSectionEvent</td>
     <td>Occurs when OOBE is shown to the user.</td>
@@ -143,18 +91,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.OobeStartedEvent</td>
     <td>Indicates when the out-of-box experience has been initiated.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.OobeVariantAssignmentEvent</td>
-    <td>This event logs A/B testing assignments for experimental features, helping track which users are in control or alternate groups for feature experiments. </td>
-  </tr>
 </table>
 
 ### Advanced Paste
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -222,11 +162,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Always on Top
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -246,11 +182,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Awake
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -278,11 +210,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Color Picker
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -299,14 +227,18 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.ColorPicker_Settings</td>
     <td>Triggered when the settings for the Color Picker are accessed or modified.</td>
   </tr>
+  <tr>
+    <td>Microsoft.PowerToys.ColorPickerCancelledEvent</td>
+    <td>Occurs when a color picking action is cancelled by the user.</td>
+  </tr>
+  <tr>
+    <td>Microsoft.PowerToys.ColorPickerShowEvent</td>
+    <td>Triggered when the Color Picker UI is displayed on the screen.</td>
+  </tr>  
 </table>
 
 ### Command Not Found
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -319,6 +251,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.CmdNotFoundInstallEvent</td>
     <td>Triggered when a Command Not Found is installed.</td>
   </tr>
+  <tr>
+    <td>Microsoft.PowerToys.CmdNotFoundInstanceCreatedEvent</td>
+    <td>Occurs when an instance of a Command Not Found is created.</td>
+  </tr>
   <tr>
     <td>Microsoft.PowerToys.CmdNotFoundUninstallEvent</td>
     <td>Triggered when Command Not Found is uninstalled after being previously installed.</td>
@@ -327,11 +263,7 @@ _If you want to find diagnostic data events in the source code, these two links
 
 ### Command Palette
 
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -395,11 +327,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Crop And Lock
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -408,26 +336,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.CropAndLock_ActivateReparent</td>
     <td>Triggered when the cropping interface is activated for reparenting the cropped content.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.CropAndLock_ActivateScreenshot</td>
-    <td>Triggered when the screenshot mode is activated in Crop and Lock.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.CropAndLock_ActivateThumbnail</td>
     <td>Occurs when the thumbnail view for cropped content is activated.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.CropAndLock_CreateReparentWindow</td>
-    <td>Triggered when a reparent window is created in Crop and Lock mode.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.CropAndLock_CreateScreenshotWindow</td>
-    <td>Triggered when a screenshot window is created in Crop and Lock mode.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.CropAndLock_CreateThumbnailWindow</td>
-    <td>Triggered when a thumbnail window is created in Crop and Lock mode.<-/td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.CropAndLock_EnableCropAndLock</td>
     <td>Triggered when Crop and Lock is enabled.</td>
@@ -438,28 +350,8 @@ _If you want to find diagnostic data events in the source code, these two links
   </tr>  
 </table>
 
-### Cursor Wrap
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
-  <tr>
-    <th>Event Name</th>
-    <th>Description</th>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.CursorWrap_EnableCursorWrap</td>
-    <td>Triggered when Cursor Wrap is enabled or disabled.</td>
-  </tr>
-</table>
-
 ### Environment Variables
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -487,11 +379,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### FancyZones
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -508,10 +396,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.FancyZones_EnableFancyZones</td>
     <td>Occurs when FancyZones is enabled.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FancyZones_Error</td>
-    <td>Triggered when an error occurs within the FancyZones module. This event logs critical errors to help diagnose and troubleshoot issues with FancyZones functionality, such as failures to set up Windows hooks or other system-level operations required for window management.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.FancyZones_KeyboardSnapWindowToZone</td>
     <td>Triggered when a window is snapped to a zone using the keyboard.</td>
@@ -524,6 +408,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.FancyZones_MoveOrResizeStarted</td>
     <td>Triggered when a window move or resize action is initiated.</td>
   </tr>
+  <tr>
+    <td>Microsoft.PowerToys.FancyZones_MoveSizeEnd</td>
+    <td>Occurs when the moving or resizing of a window has ended.</td>
+  </tr>
   <tr>
     <td>Microsoft.PowerToys.FancyZones_OnKeyDown</td>
     <td>Triggered when a key is pressed down while interacting with zones.</td>
@@ -536,6 +424,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.FancyZones_Settings</td>
     <td>Triggered when FancyZones settings are accessed or modified.</td>
   </tr>
+  <tr>
+    <td>Microsoft.PowerToys.FancyZones_SettingsChanged</td>
+    <td>Occurs when there is a change in the FancyZones settings.</td>
+  </tr>
   <tr>
     <td>Microsoft.PowerToys.FancyZones_SnapNewWindowIntoZone</td>
     <td>Triggered when a new window is snapped into a zone.</td>
@@ -556,50 +448,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.FancyZones_CLICommand</td>
     <td>Triggered when a FancyZones CLI command is executed, logging the command name and success status.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FancyZonesEditorStartEvent</td>
-    <td>Triggered when the FancyZones Editor application starts. This logs the initialization of the editor UI, which is used to create and configure custom zone layouts.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FancyZonesEditorStartFinishEvent</td>
-    <td>Triggered when the FancyZones Editor has completed loading and is ready for user interaction.</td>
-  </tr>
-</table>
-
-### File Locksmith
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
-  <tr>
-    <th>Event Name</th>
-    <th>Description</th>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FileLocksmith_EnableFileLocksmith</td>
-    <td>Triggered when File Locksmith is enabled.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FileLocksmith_Invoked</td>
-    <td>Occurs when File Locksmith is invoked.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FileLocksmith_InvokedRet</td>
-    <td>Triggered when File Locksmith invocation returns a result.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.FileLocksmith_QueryContextMenuError</td>
-    <td>Occurs when there is an error querying the context menu for File Locksmith.</td>
-  </tr>
 </table>
 
 ### FileExplorerAddOns
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -636,10 +488,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.MarkdownFilePreviewed</td>
     <td>Triggered when a Markdown file is previewed in File Explorer.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.MarkdownFilePreviewError</td>
-    <td>Triggered when there is an error previewing a Markdown file in File Explorer.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.PdfFileHandlerLoaded</td>
     <td>Occurs when a PDF file handler is loaded.</td>
@@ -648,10 +496,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.PdfFilePreviewed</td>
     <td>Triggered when a PDF file is previewed in File Explorer.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.PdfFilePreviewError</td>
-    <td>Triggered when there is an error previewing a PDF file in File Explorer.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.PowerPreview_Enabled</td>
     <td>Occurs when preview is enabled.</td>
@@ -668,10 +512,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_InitSet__ErrorLoadingFile</td>
     <td>Triggered when there is an error loading a file during Tweak UI settings initialization.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_SetConfig__InvalidJSONGiven</td>
-    <td>Triggered when invalid JSON is provided to the Power Preview settings configuration</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_SuccessfullyUpdatedSettings</td>
     <td>Occurs when the Tweak UI settings for Power Preview are successfully updated.</td>
@@ -680,10 +520,6 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.QoiFilePreviewed</td>
     <td>Triggered when a QOI file is previewed in File Explorer.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.QoiFilePreviewError</td>
-    <td>Triggered when there is an error previewing a QOI (Quite OK Image) file in File Explorer.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.SvgFileHandlerLoaded</td>
     <td>Occurs when an SVG file handler is loaded.</td>
@@ -698,12 +534,32 @@ _If you want to find diagnostic data events in the source code, these two links
   </tr>
 </table>
 
+### File Locksmith
+<table style="width:100%">
+  <tr>
+    <th>Event Name</th>
+    <th>Description</th>
+  </tr>
+  <tr>
+    <td>Microsoft.PowerToys.FileLocksmith_EnableFileLocksmith</td>
+    <td>Triggered when File Locksmith is enabled.</td>
+  </tr>
+  <tr>
+    <td>Microsoft.PowerToys.FileLocksmith_Invoked</td>
+    <td>Occurs when File Locksmith is invoked.</td>
+  </tr>
+  <tr>
+    <td>Microsoft.PowerToys.FileLocksmith_InvokedRet</td>
+    <td>Triggered when File Locksmith invocation returns a result.</td>
+  </tr>
+  <tr>
+    <td>Microsoft.PowerToys.FileLocksmith_QueryContextMenuError</td>
+    <td>Occurs when there is an error querying the context menu for File Locksmith.</td>
+  </tr>
+</table>
+
 ### Find My Mouse
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -714,16 +570,12 @@ _If you want to find diagnostic data events in the source code, these two links
   </tr>
   <tr>
     <td>Microsoft.PowerToys.FindMyMouse_MousePointerFocused</td>
-    <td>Occurs when the mouse pointer is focused using Find My Mouse, including the activation method (double-tap left/right Ctrl, shake mouse, or shortcut).</td>
+    <td>Occurs when the mouse pointer is focused using Find My Mouse.</td>
   </tr>
 </table>
 
 ### Hosts File Editor
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -740,22 +592,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.HostsFileEditorOpenedEvent</td>
     <td>Fires when Hosts File Editor is opened.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.HostEditorStartEvent</td>
-    <td>Triggered when the Hosts File Editor application starts. This logs the initialization of the Hosts File Editor UI with a timestamp.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.HostEditorStartFinishEvent</td>
-    <td>Triggered when the Hosts File Editor has completed loading and is ready for user interaction.</td>
-  </tr>
 </table>
 
 ### Image Resizer
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -772,18 +612,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.ImageResizer_InvokedRet</td>
     <td>Fires when the Image Resizer operation is completed and returns a result.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.ImageResizer_QueryContextMenuError</td>
-    <td>Triggered when there is an error querying the context menu for Image Resizer.</td>
-  </tr>
 </table>
 
 ### Keyboard Manager
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -796,22 +628,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapCount</td>
     <td>Logs the number of application-specific shortcut remaps configured by the user.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToKeyRemapInvoked</td>
-    <td>Logs each instance when an application-specific shortcut-to-key remap is used.</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToShortcutRemapInvoked</td>
     <td>Logs each instance when an application-specific shortcut-to-shortcut remap is used.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.KeyboardManager_Error</td>
-    <td>Triggered when an error occurs in Keyboard Manager. This logs the error code, error message, and the method name where the error occurred.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.KeyboardManager_ErrorSendingKeyAndShortcutRemapLoadedConfiguration</td>
-    <td>Triggered when there is an error sending remapping configuration telemetry. This occurs when Keyboard Manager fails to report the loaded key and shortcut remap configurations</td>
-  </tr>
   <tr>
     <td>Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToKeyRemapInvoked</td>
     <td>Logs the daily count of application-specific shortcut-to-key remaps executed by the user.</td>
@@ -875,11 +695,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Light Switch
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -903,11 +719,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Mouse Highlighter
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -920,18 +732,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.MouseHighlighter_StartHighlightingSession</td>
     <td>Occurs when a new highlighting session is started.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.MouseHighlighter_StartSpotlightSession</td>
-    <td>Triggered when a spotlight session is started in Mouse Highlighter. This occurs when the user activates the spotlight mode.</td>
-  </tr>
 </table>
 
 ### Mouse Jump
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -955,11 +759,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Mouse Pointer Crosshairs
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -975,11 +775,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Mouse Without Borders
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1031,11 +827,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### New+
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1067,11 +859,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Peek
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1104,18 +892,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.Peek_Settings</td>
     <td>Triggered when the settings for Peek are modified.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.Peek_SpaceModeEnabled</td>
-    <td>Triggered when the Space key activation mode is enabled or disabled in Peek</td>
-  </tr>
 </table>
 
 ### PowerRename
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1147,11 +927,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### PowerToys Run
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1192,14 +968,14 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.RunPluginsSettingsEvent</td>
     <td>Triggered when the settings for PowerToys Run plugins are accessed or modified.</td>
   </tr>
+  <tr>
+    <td>Microsoft.PowerToys.WindowWalker_EnableWindowWalker</td>
+    <td>Triggered when the Window Walker plugin is enabled.</td>
+  </tr>
 </table>
 
 ### Quick Accent
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1215,11 +991,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Registry Preview
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1232,22 +1004,10 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Microsoft.PowerToys.RegistryPreview_EnableRegistryPreview</td>
     <td>Occurs when Registry Preview is enabled.</td>
   </tr>
-  <tr>
-    <td>Microsoft.PowerToys.RegistryPreviewEditorStartEvent</td>
-    <td>Triggered when the Registry Preview application starts. This logs the initialization of the Registry Preview UI with a timestamp.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.RegistryPreviewEditorStartFinishEvent</td>
-    <td>Triggered when the Registry Preview application has completed loading and is ready for user interaction.</td>
-  </tr>
 </table>
 
 ### Screen Ruler
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1267,11 +1027,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Shortcut Guide
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1287,11 +1043,7 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Text Extractor
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
@@ -1315,15 +1067,15 @@ _If you want to find diagnostic data events in the source code, these two links
 </table>
 
 ### Workspaces
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>
   </tr>
+  <tr>
+    <td>Microsoft.PowerToys.Projects_CLIUsage</td>
+    <td>Logs usage of command-line arguments for launching apps.</td>
+  </tr>
   <tr>
     <td>Microsoft.PowerToys.Workspaces_CreateEvent</td>
     <td>Triggered when a new workspace is created.</td>
@@ -1345,21 +1097,13 @@ _If you want to find diagnostic data events in the source code, these two links
     <td>Triggered when a workspace is launched.</td>
   </tr>
   <tr>
-    <td>Microsoft.PowerToys.WorkspacesEditorStartEvent</td>
-    <td>Triggered when the Workspaces Editor application starts. This logs the initialization of the Workspaces Editor UI with a timestamp.</td>
-  </tr>
-  <tr>
-    <td>Microsoft.PowerToys.WorkspacesEditorStartFinishEvent</td>
-    <td>Triggered when the Workspaces Editor has completed loading and is ready for user interaction.</td>
+    <td>Microsoft.PowerToys.Workspaces_Settings</td>
+    <td>Logs changes to workspaces settings.</td>
   </tr>
 </table>
 
 ### ZoomIt
-<table style="width:100%; table-layout:fixed">
-  <colgroup>
-    <col style="width:40%">
-    <col style="width:60%">
-  </colgroup>
+<table style="width:100%">
   <tr>
     <th>Event Name</th>
     <th>Description</th>

Directory.Packages.props

@@ -26,7 +26,7 @@
     <PackageVersion Include="CommunityToolkit.WinUI.Converters" Version="8.2.250402" />
     <PackageVersion Include="CommunityToolkit.WinUI.Extensions" Version="8.2.250402" />
     <PackageVersion Include="CommunityToolkit.WinUI.UI.Controls.DataGrid" Version="7.1.2" />
-    <PackageVersion Include="CommunityToolkit.Labs.WinUI.Controls.MarkdownTextBlock" Version="0.1.260116-build.2514" />
+    <PackageVersion Include="CommunityToolkit.Labs.WinUI.Controls.MarkdownTextBlock" Version="0.1.251002-build.2316" />
     <PackageVersion Include="ControlzEx" Version="6.0.0" />
     <PackageVersion Include="HelixToolkit" Version="2.24.0" />
     <PackageVersion Include="HelixToolkit.Core.Wpf" Version="2.24.0" />
@@ -63,7 +63,7 @@
     <PackageVersion Include="Microsoft.SemanticKernel.Connectors.MistralAI" Version="1.66.0-alpha" />
     <PackageVersion Include="Microsoft.SemanticKernel.Connectors.Ollama" Version="1.66.0-alpha" />
     <PackageVersion Include="Microsoft.Toolkit.Uwp.Notifications" Version="7.1.2" />
-    <PackageVersion Include="Microsoft.Web.WebView2" Version="1.0.3405.78" />
+    <PackageVersion Include="Microsoft.Web.WebView2" Version="1.0.3179.45" />
     <!-- Package Microsoft.Win32.SystemEvents added as a hack for being able to exclude the runtime assets so they don't conflict with 8.0.1. This is a dependency of System.Drawing.Common but the 8.0.1 version wasn't published to nuget. -->
     <PackageVersion Include="Microsoft.Win32.SystemEvents" Version="9.0.10" />
     <PackageVersion Include="Microsoft.WindowsPackageManager.ComInterop" Version="1.10.340" />
@@ -77,8 +77,10 @@
     <PackageVersion Include="Microsoft.Windows.CsWinRT" Version="2.2.0" />
     <PackageVersion Include="Microsoft.Windows.ImplementationLibrary" Version="1.0.231216.1"/>
     <PackageVersion Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.6901" />
-    <PackageVersion Include="Microsoft.WindowsAppSDK" Version="2.0.0-experimental4" />
-    <PackageVersion Include="Microsoft.WindowsAppSDK.AI" Version="2.0.130-experimental" />
+    <PackageVersion Include="Microsoft.WindowsAppSDK" Version="1.8.251106002" />
+    <PackageVersion Include="Microsoft.WindowsAppSDK.Foundation" Version="1.8.251104000" />
+    <PackageVersion Include="Microsoft.WindowsAppSDK.AI" Version="1.8.39" />
+    <PackageVersion Include="Microsoft.WindowsAppSDK.Runtime" Version="1.8.251106002" />
     <PackageVersion Include="Microsoft.Xaml.Behaviors.WinUI.Managed" Version="2.0.9" />
     <PackageVersion Include="Microsoft.Xaml.Behaviors.Wpf" Version="1.1.39" />
     <PackageVersion Include="ModernWpfUI" Version="0.9.4" />

PowerToys.slnx

@@ -665,7 +665,6 @@
     </Project>
   </Folder>
   <Folder Name="/modules/LightSwitch/">
-    <Project Path="src/modules/LightSwitch/LightSwitchLib/LightSwitchLib.vcxproj" Id="79267138-2895-4346-9021-21408d65379f" />
     <Project Path="src/modules/LightSwitch/LightSwitchModuleInterface/LightSwitchModuleInterface.vcxproj" Id="38177d56-6ad1-4adf-88c9-2843a7932166" />
     <Project Path="src/modules/LightSwitch/LightSwitchService/LightSwitchService.vcxproj" Id="08e71c67-6a7e-4ca1-b04e-2fb336410bac" />
   </Folder>

README.md

@@ -48,22 +48,22 @@ But to get started quickly, choose one of the installation methods below:
 <details open>
 <summary><strong>Download .exe from GitHub</strong></summary>
 <br/>
-Go to the <a href="https://aka.ms/installPowerToys">PowerToys GitHub releases</a>, click Assets to reveal the downloads, and choose the installer that matches your architecture and install scope. For most devices, that's the x64 per-user installer.
+Go to the [PowerToys GitHub releases][github-release-link], click Assets to reveal the downloads, and choose the installer that matches your architecture and install scope. For most devices, that's the x64 per-user installer.
 
 <!-- items that need to be updated release to release -->
 [github-next-release-work]: https://github.com/microsoft/PowerToys/issues?q=is%3Aissue+milestone%3A%22PowerToys+0.97%22
 [github-current-release-work]: https://github.com/microsoft/PowerToys/issues?q=is%3Aissue+milestone%3A%22PowerToys+0.96%22
-[ptUserX64]: https://github.com/microsoft/PowerToys/releases/download/v0.97.0/PowerToysUserSetup-0.97.0-x64.exe 
-[ptUserArm64]: https://github.com/microsoft/PowerToys/releases/download/v0.97.0/PowerToysUserSetup-0.97.0-arm64.exe 
-[ptMachineX64]: https://github.com/microsoft/PowerToys/releases/download/v0.97.0/PowerToysSetup-0.97.0-x64.exe 
-[ptMachineArm64]: https://github.com/microsoft/PowerToys/releases/download/v0.97.0/PowerToysSetup-0.97.0-arm64.exe
+[ptUserX64]: https://github.com/microsoft/PowerToys/releases/download/v0.96.1/PowerToysUserSetup-0.96.1-x64.exe 
+[ptUserArm64]: https://github.com/microsoft/PowerToys/releases/download/v0.96.1/PowerToysUserSetup-0.96.1-arm64.exe 
+[ptMachineX64]: https://github.com/microsoft/PowerToys/releases/download/v0.96.1/PowerToysSetup-0.96.1-x64.exe 
+[ptMachineArm64]: https://github.com/microsoft/PowerToys/releases/download/v0.96.1/PowerToysSetup-0.96.1-arm64.exe
  
 |  Description   | Filename |
 |----------------|----------|
-| Per user - x64       | [PowerToysUserSetup-0.97.0-x64.exe][ptUserX64] |
-| Per user - ARM64     | [PowerToysUserSetup-0.97.0-arm64.exe][ptUserArm64] |
-| Machine wide - x64   | [PowerToysSetup-0.97.0-x64.exe][ptMachineX64] |
-| Machine wide - ARM64 | [PowerToysSetup-0.97.0-arm64.exe][ptMachineArm64] |
+| Per user - x64       | [PowerToysUserSetup-0.96.1-x64.exe][ptUserX64] |
+| Per user - ARM64     | [PowerToysUserSetup-0.96.1-arm64.exe][ptUserArm64] |
+| Machine wide - x64   | [PowerToysSetup-0.96.1-x64.exe][ptMachineX64] |
+| Machine wide - ARM64 | [PowerToysSetup-0.96.1-arm64.exe][ptMachineArm64] |
 
 </details>
 
@@ -83,7 +83,7 @@ You can easily install PowerToys from the Microsoft Store:
 <details>
 <summary><strong>WinGet</strong></summary>
 <br/>
-Download PowerToys from <a href="https://github.com/microsoft/winget-cli#installing-the-client">WinGet</a>. Updating PowerToys via winget will respect the current PowerToys installation scope. To install PowerToys, run the following command from the command line / PowerShell:
+Download PowerToys from [WinGet][winget-link]. Updating PowerToys via winget will respect the current PowerToys installation scope. To install PowerToys, run the following command from the command line / PowerShell:
 
 *User scope installer [default]*
 ```powershell
@@ -99,197 +99,138 @@ winget install --scope machine Microsoft.PowerToys -s winget
 <details>
 <summary><strong>Other methods</strong></summary>
 <br/>
-There are <a href="https://learn.microsoft.com/windows/powertoys/install#community-driven-install-tools">community driven install methods</a> such as Chocolatey and Scoop. If these are your preferred install solutions, you can find the install instructions there.
+There are [community driven install methods](./doc/unofficialInstallMethods.md) such as Chocolatey and Scoop. If these are your preferred install solutions, you can find the install instructions there.
 </details>
 
 ## ✨ What's new
-**Version 0.97 (January 2026)**
+**Version 0.96 (November 2025)**
 
 For an in-depth look at the latest changes, visit the [Windows Command Line blog](https://aka.ms/powertoys-releaseblog).
 
 **✨ Highlights**
-- **Command Palette**: Major expansion with PowerToys extension (Windows 11 only), Remote Desktop built-in extension, theme customization, drag-and-drop support, fallback ranking controls, sections/separators for pages, pinyin Chinese matching, and many UX refinements.
-- **Settings**: Quick Access flyout is now a standalone process for significantly faster startup, theme-adaptive tray icon, AOT serialization, and multiple UI/accessibility fixes
-- **CursorWrap (New!)**: New mouse utility that lets your cursor wrap around screen edges, making multi-monitor navigation faster and more seamless.
-- **Advanced Paste**: Image input for AI, color detection in clipboard history, Foundry Local improvements, Azure AI icons, and multiple bug fixes
-- **CLI Support Expanded**: FancyZones, Image Resizer, and File Locksmith can now be controlled from the command line for layout management, batch image resizing, and file lock inspection.
-- **LightSwitch**: Added support for automatically following Windows Night Light mode.
-- **Release Experience & Quality**: Refreshed "What’s new" dialog, plus many performance improvements, stability fixes, and refinements across PowerToys.
+ - Advanced Paste now supports multiple online and on-device AI model providers: Azure OpenAI, OpenAI, Google Gemini, Mistral, Foundry Local and Ollama.
+ - Command Palette received extensive improvements including file search filters, better clipboard history metadata, context-menu styling, and dozens of bug fixes and enhancements.
+ - PowerRename can now extract and use photo metadata (EXIF, XMP) in renaming patterns like `%Camera`, `%Lens`, and `%ExposureTime`.
 
-## Advanced Paste
+### Advanced Paste
+ - Advanced Paste now lets you connect to multiple AI providers instead of being limited to a single OpenAI provider. See [Advanced Paste documentation](https://learn.microsoft.com/windows/powertoys/advanced-paste) for usage.
 
-- Added hex color previews in clipboard history. Thanks [@crramirez](https://github.com/crramirez)!
-- Added automatic placeholder endpoints when required fields are left empty.
-- Fixed a grammar issue in the AI settings description. Thanks [@erik-anderson](https://github.com/erik-anderson)!
-- Fixed loading order so custom action hotkeys are read correctly.
-- Updated Advanced Paste descriptions to reflect support for online and local models.
-- Fixed clipboard history item selection so it doesn’t duplicate entries.
-- Prevented placeholder endpoints from being saved for providers that don’t need them.
-- Added image input support for AI transforms and improved clipboard change tracking.
+### Awake
+ - The Awake countdown timer now stays accurate over long periods. Thanks [@daverayment](https://github.com/daverayment)!
+ - Fixed Awake context menu positioning. The fix removed the conversion of the mouse cursor from screen to client-window coordinates, instead using the raw screen coordinates returned by GetCursorPos; the context menu now appears at the correct screen position. Thanks [@lzandman](https://github.com/lzandman)!
 
-## Awake
+### Command Palette
+ - The search field in context menus now matches the look of the Command Palette, with a smoke backdrop and improved padding.
+ - Fallback items such as math calculations or the Run command now appear in results more quickly. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Ensured the command bar updates correctly after navigating to another page and commands are displayed correctly. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - The Command Palette settings page has been reorganized. Activation-key options are grouped under an expander and extension settings are framed for improved readability.
+ - When you modify a command, its alias, hotkey, and tags now update in the top-level list, keeping the displayed information in sync. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Press `Ctrl + ,` to open Command Palette settings from anywhere. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - You can use `Page Up` and `Page Down` to navigate the list while focus is in the search box. Thanks [@samrueby](https://github.com/samrueby)!
+ - Fixed an issue where the search box could disappear when navigating pages. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Ensured search text is selected when *Go home when activated* and *Highlight search on activate* are both enabled. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Fixed an issue where Command Palette window occasionally appeared on the taskbar under certain Windows settings. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Ensured that labels and icons of list items and menu items update when they change. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Fixed visibility of list filters when navigating to a content page. Thanks [@DevLGuilherme](https://github.com/DevLGuilherme)!
+ - Added search to the extension list and a link to extensions on the Microsoft Store. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Added options to open the Command Palette window at its last position or re-center it.
+ - The Command Palette now remembers its window size after restarting.
+ - Added a global error handler that logs fatal errors and provides feedback when unexpected failures force Command Palette to close. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Fixed forms and extension settings not showing on some machines due to a missing VC++ runtime.
+ - Restored ranking of fallback commands for built-in extensions (Sleep, Shutdown, Windows settings, Web search, etc.). Thanks [@jiripolasek](https://github.com/jiripolasek).
+ - Improved and unified labels and texts across the application!
+ - Maintainance: Resolved numerous build warnings in Command Palette projects; no user-visible impact. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Maintainance: Fixed a logging issue so exception messages are properly recorded instead of placeholder text, improving troubleshooting. Thanks [@jiripolasek](https://github.com/jiripolasek)!
 
-- Fixed Awake CLI so help, errors, and logs appear correctly in the console. Thanks [@daverayment](https://github.com/daverayment)!
+### Command Palette Extensions
+ - Bookmarks: Added hints about bookmark placeholders to the Add/Edit Bookmark form. — Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Bookmarks: Improved migration of bookmarks from older versions and fixed an issue where aliases or keyboard shortcuts could be lost after restart. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Clipboard history: Items shown in Command Palette’s clipboard history now include helpful metadata. For example, image items show dimensions, text files show names and sizes, web links include page titles, and text entries display word counts. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - File search: Added filter buttons to show *all items*, *files only*, or *folders only*. Selecting a filter adds `kind:folders` or `kind:not folders` to narrow results.
+ - System commands: Replaced the `:red_circle:` placeholder with an actual red-circle emoji so the correct icon appears in the UI. Thanks [@samrueby](https://github.com/samrueby)!
+ - WinGet: Search performance feels more responsive because typed input is now processed via a task queue rather than complex cancellation tokens!
+ - Window Walker: UWP apps no longer show a "not responding" label when suspended. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Window Walker: Now displays the actual icon of each window rather than using the process icon, improving recognition of PWAs and Python GUIs. Thanks [@Lee-WonJun](https://github.com/Lee-WonJun)!
+- Windows Terminal profiles: Fixed a rare crash in the Windows Terminal extension when the `LOCALAPPDATA` environment variable was missing. The path is now retrieved via a reliable API. Thanks [@jiripolasek](https://github.com/jiripolasek)!
 
-## Command Palette
+### Find My Mouse
+ - Activating Find My Mouse no longer makes the cursor change to the busy (hourglass) icon or steals focus from your active application.
 
-- Fixed background image loading in BlurImageControl. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Fixed SDK packaging paths and added a CI SDK build stage.
-- Aligned naming and spell-checking with .NET conventions. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added drag-and-drop support for Command Palette items. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added a PowerToys Command Palette extension to discover and launch PowerToys utilities.
-- Fixed grid view bindings and layout issues. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Fixed a line-break issue in RDC extension toast messages. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Made the Settings button text localizable. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Hid the RDC fallback on the home page and fixed MSTSC working directory handling. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Optimized result list merging for better performance. Thanks [@daverayment](https://github.com/daverayment)!
-- Added Small/Medium/Large detail sizes in the extensions API. Thanks [@DevLGuilherme](https://github.com/DevLGuilherme)!
-- Hid fallback commands on the home page when no query is entered. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added back navigation support in the Settings window. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added a Command Palette solution filter. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Updated Extension SDK documentation links to Microsoft Learn. Thanks [@RubenFricke](https://github.com/RubenFricke)!
-- Added a custom search engine URL setting for Web Search. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added pinyin matching for Chinese input. Thanks [@frg2089](https://github.com/frg2089)!
-- Bumped Command Palette version to 0.8.
-- Removed subtitles from built-in top-level commands. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Refined separator styling in the details pane. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added a built-in Remote Desktop extension.
-- Added a Peek command to the Indexer extension.
-- Improved default browser detection using the Windows Shell API. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added Escape key behavior options. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added theme and background customization options. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Improved WinGet package app matching. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added an auto-return-home delay setting. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added fallback ranking and global results settings.
-- Removed the selection indicator in the context menu list. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added a developer ribbon with build and log info. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Updated the “Learn more” string for Command Palette. Thanks [@pratnala](https://github.com/pratnala)!
-- Added arrow-key navigation for grid views. Thanks [@samrueby](https://github.com/samrueby)!
-- Fixed version display when running unpackaged. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added a native debugging launch profile. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Reduced redundant property change notifications in the SDK. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Improved section readability and accessibility. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Made gallery spacing uniform. Thanks [@jiripolasek](https://github.com/jiripolasek)!
-- Added sections and separators for list and grid pages. Thanks [@DevLGuilherme](https://github.com/DevLGuilherme)!
+### Hosts File Editor
+ - Added customizable backup settings allowing users to configure backup frequency, location, and auto-deletion policies. Thanks [@davidegiacometti](https://github.com/davidegiacometti)!
 
-## Crop & Lock
+### Image Resizer
+ - Fixed settings consistency during batch resize operations by capturing settings once before processing. Thanks [@daverayment](https://github.com/daverayment)!
 
-- Added a screenshot mode that freezes a cropped region into its own window. Thanks [@fm-sys](https://github.com/fm-sys)!
+### Light Switch
+- Introduced new UI to allow users to manually enter their latitude and longitude in Sunrise to Sunset mode.
+- Refactored service with cleaner state management for stability.
+- Removed logs from every tick, only logging key events to largely reduce log size.
 
-## Cursor Wrap
+### Mouse Pointer Crosshairs
+ - Enabled switching between Mouse Pointer Crosshairs and Gliding Cursor modes. Thanks [@mikehall-ms](https://github.com/mikehall-ms)!
 
-- Improved Cursor Wrap behavior on multi-monitor setups by wrapping only at outer edges. Thanks [@mikehall-ms](https://github.com/mikehall-ms)!
+### Mouse Without Borders
+ - Added horizontal scrolling support. Thanks [@MasonBergstrom](https://github.com/MasonBergstrom)!
 
-## FancyZones
+### Peek
+- Fixed media files remaining locked after preview window closes. Thanks [@daverayment](https://github.com/daverayment)!
+- Added a command-line interface for file previewing. See the [Peek documentation](https://learn.microsoft.com/windows/powertoys/peek) for usage. Thanks [@prochan2](https://github.com/prochan2)!
 
-- Fixed editor overlay positioning on mixed-DPI multi-monitor setups. Thanks [@Memphizzz](https://github.com/Memphizzz)!
-- Added a FancyZones CLI for command-line layout management.
+### PowerRename
+- PowerRename no longer crashes due to a missing resources file.
+- Added photo metadata extraction support using EXIF and XMP for pattern-based renaming with camera info, GPS coordinates, and date taken. See [PowerRename Documentation](https://learn.microsoft.com/en-us/windows/powertoys/powerrename).
 
-## File Locksmith
+### PowerToys Run
+ - Added retry logic with exponential backoff to handle DWM composition errors during theme changes. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+ - Updated OneNote icons to reflect new Microsoft 365 design. Thanks [@trevorNgo](https://github.com/trevorNgo)!
 
-- Added a File Locksmith CLI for querying, waiting on, or killing file locks.
+ ### Quick Accent
+ - Added diameter symbol (⌀) for Shift+O in Special Characters mode, thanks to [@anselumjuju](https://github.com/anselumjuju)!
 
-## Find My Mouse
+### Zoomit
+ - Smoothed out zoom-animation in ZoomIt by coalescing mouse-move and timer events, thanks to [@foxmsft](https://github.com/foxmsft)!
+ - Enabled GIF support for ZoomIt, thanks to [@MarioHewardt](https://github.com/MarioHewardt)!
+ - Fixed spelling mistakes, and refactored some literal strings to string constants, thanks to [@lzandman](https://github.com/lzandman)!
+ - Fixed inaccurate "actual size" screenshots in ZoomIt and resolves a GDI handle leak, improving capture fidelity and long-session stability. thanks to [@daverayment](https://github.com/daverayment)!
 
-- Improved spotlight edge rendering for clearer Find My Mouse visuals.
-- Added telemetry to track how Find My Mouse is triggered.
+### Settings
+- Fixed title bar overlapping issue at smaller window sizes.
+- Refined shortcut control visual design with improved consistency and spacing.
+- Added dashboard utilities sorting by name or status.
+- Made update notification InfoBar in flyout clickable for direct navigation to update page.
+- Expanded installation instructions by default in README.
+- Improved accessibility for shortcut conflict button with static resource-based automation properties.
+- Added ScrollViewer to Command Palette page in PowerToys Settings. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+- Fixed module list glitches and Sort Status checkmark issue. Thanks [@daverayment](https://github.com/daverayment)!
 
-## Image Resizer
-
-- Fixed Fill mode cropping when Shrink Only is enabled. Thanks [@daverayment](https://github.com/daverayment)!
-- Added a dedicated Image Resizer CLI for scripted resizing.
-
-## Light Switch
-
-- Added telemetry events for Light Switch usage and settings changes.
-- Added a Follow Night Light mode to sync theme changes with Night Light.
-- Clarified LightSwitchService and LightSwitchStateManager roles in docs.
-- Added a Quick Access dashboard button to toggle Light Switch quickly.
-- Ensured Light Switch honors GPO policy states with clear status messaging.
-
-## Mouse Without Borders
-
-- Continued refactoring Mouse Without Borders by splitting the large Common class into focused components. Thanks [@mikeclayton](https://github.com/mikeclayton)!
-- Completed the Common class refactor with Core and IPC helper extraction. Thanks [@mikeclayton](https://github.com/mikeclayton)!
-
-## Peek
-
-- Hardened Peek previews with strict resource filtering and safer external link warnings.
-- Improved SVG preview compatibility by rendering via WebView2.
-
-## PowerRename
-
-- Added HEIF/AVIF EXIF metadata extraction and extension status guidance for related previews.
-- Fixed undefined behavior in file time handling. Thanks [@safocl](https://github.com/safocl)!
-- Optimized memory allocation for depth-based rename processing.
-- Fixed Unicode normalization and non‑breaking space matching. Thanks [@daverayment](https://github.com/daverayment)!
-- Fixed date token replacements followed by capital letters. Thanks [@daverayment](https://github.com/daverayment)!
-
-## PowerToys Run Plugins
-
-- Fixed a plugin name typo and added Project Launcher to the third‑party list. Thanks [@artickc](https://github.com/artickc)!
-- Added the Open With Antigravity plugin to the third‑party list. Thanks [@artickc](https://github.com/artickc)!
-
-## PowerToys Run
-
-- Avoided unnecessary hotkey conflict checks when settings change.
-- Added QuickAI to the third-party PowerToys Run plugin list. Thanks [@ruslanlap](https://github.com/ruslanlap)!
-
-## Quick Accent
-
-- Added localized quotation marks to Quick Accent. Thanks [@warquys](https://github.com/warquys)!
-- Fixed duplicate and redundant characters in Quick Accent sets. Thanks [@noraa-junker](https://github.com/noraa-junker)!
-- Fixed DPI positioning issues for Quick Accent on mixed-DPI setups. Thanks [@noraa-junker](https://github.com/noraa-junker)!
-
-## Settings
-
-- Added a new tray icon that adapts to theme changes. Thanks [@HO-COOH](https://github.com/HO-COOH)!
-- Centralized module enable/disable logic for cleaner Settings UI updates.
-- Simplified Settings utilities by removing ISettingsUtils/ISettingsPath interfaces. Thanks [@noraa-junker](https://github.com/noraa-junker)!
-- Improved Settings UI consistency and disabled-state visuals.
-- Added semantic headings to the Dashboard for better accessibility.
-- Introduced Quick Access as a standalone host with updated Settings integration.
-- Fixed Dashboard toggle flicker and sort menu checkmarks. Thanks [@daverayment](https://github.com/daverayment)!
-- Added Native AOT-compatible settings serialization.
-- Standardized mouse tool description text. Thanks [@daverayment](https://github.com/daverayment)!
-- Added a global SettingsUtils singleton to reduce repeated initialization.
-
-## Development
-
-- Fixed broken devdocs links to the coding style guide. Thanks [@RubenFricke](https://github.com/RubenFricke)!
-- Migrated main and installer solutions to .slnx for improved build tooling.
-- Restored local installer builds after the WiX v5 upgrade with signing and versioning fixes.
-- Added incremental review tooling and structured AI prompts for PR/issue reviews.
-- Documented bot commands and cleaned up devdocs structure. Thanks [@noraa-junker](https://github.com/noraa-junker)!
-- Updated WinAppSDK pipeline defaults to 1.8 and fixed restore handling.
-- Updated the COMMUNITY list to reflect current roles.
-- Maintained community member ordering and added a new entry.
-- Re-enabled centralized PackageReference for native projects with VS auto-restore.
-- Disabled MSBuild caching by default in CI to avoid build instability.
-- Updated the latest WinAppSDK daily pipeline for split-dependency restores.
-- Suppressed experimental build warnings and aligned WrapPanel stretch handling.
-- Reordered the spell-check expect list for consistent automation.
-- Migrated native projects to centralized PackageReference management.
-- Cleaned spell-check dictionary entries and capitalization.
-- Synced commit/PR prompts and wired VS Code to repo prompt files.
-- Added VS Code build tasks and improved build script path handling.
-- Updated Windows App SDK package versions in central package management.
-- Migrated cmdpal extension native project to PackageReference and fixed outputs.
-- Reverted PackageReference changes back to packages.config where needed.
-- Bypassed a release version check for a failing DLL to keep pipelines green.
-- Consolidated Copilot instructions and fixed prompt frontmatter.
-- Added signing entries for new Quick Access binaries and CLI version metadata.
-- Fixed install scope detection to avoid mixed per-user/per-machine installs.
-- Added a Module Loader tool to quickly test PowerToys modules without full builds. Thanks [@mikehall-ms](https://github.com/mikehall-ms)!
-- Added update telemetry to understand auto-update checks and downloads.
-- Updated the telemetry package for new compliance requirements. Thanks [@carlos-zamora](https://github.com/carlos-zamora)!
-- Documented missing telemetry events in DATA_AND_PRIVACY.
-- Fixed UI test pipeline restores for .slnx solutions.
-- Added UI automation coverage for Advanced Paste clipboard history flows.
-- Stabilized FancyZones UI tests with more reliable selectors and screen recordings.
+### Development
+- Fixed accessibility by associating controls with labels for screen readers.
+- Added accessible name to Shortcut Conflicts button for screen readers.
+- Excluded TitleBars from tab navigation across multiple utilities. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+- Migrated build infrastructure from Windows Server 2019 to Server 2022 with improved failure logging and predictable NuGet package paths.
+- Configured build agents to use larger P: drive for release builds to address disk space constraints.
+- Enhanced DSC v3 support by organizing resource manifests in a dedicated subfolder with PATH configuration.
+- Reduced installer bundle size by 6-7MB through centralized Hybrid CRT configuration across all C++ projects.
+- Updated .NET packages to version 9.0.10 for security fixes. Thanks [@snickler](https://github.com/snickler)!
+- Fixed spell check dictionary entries for consistency.
+- Restored accidentally deleted NuGet configuration file for Command Palette extensions.
+- Fixed package identity build by updating AppxManifest entry points to use PowerShell Core.
+- Optimized CI pipeline by replacing file copy operations with hard links and moves, reducing build time and disk usage by 10-15GB.
+- Updated Copilot guidance and PR prompt workflow.
+- Included high-volume bugs in issue template header. Thanks [@daverayment](https://github.com/daverayment)!
+- Fixed incorrect HRESULT logging for inner exceptions. Thanks [@jiripolasek](https://github.com/jiripolasek)!
+- Introduced shared sparse package identity for PowerToys Win32 components to enable access to Windows platform APIs.
+- Consolidated installer builds to produce both machine and user installers simultaneously, reducing build time and complexity.
+- Migrated exclusively to WiX v5 installer infrastructure, removing legacy WiX v3 support.
+- Temporarily removed PowerToys installer path from PATH environment variable to prevent application crashes.
+- Added complete OCR UI test coverage with automated tests for activation, settings, language selection, and text extraction.
+- Fixed test input for drive path normalization in bookmark resolver unit tests.
+- Fixed Peek UI tests by restoring Ctrl+Space activation shortcut for test scenarios.
+- Hided apps in PowerToys.SpareApps package from Start Menu. Thanks [@jiripolasek](https://github.com/jiripolasek)!
 
 ## 🛣️ Roadmap 
-We are planning some nice new features and improvements for the next releases – PowerDisplay, Command Palette improvements and a brand-new Shortcut Guide experience! Stay tuned for [v0.97][github-next-release-work]!
+We are planning some nice new features and improvements for the next releases – a revamped Keyboard Manager UI, custom endpoint and local model support for Advanced Paste, Command Palette improvements and a brand-new Shortcut Guide experience! Stay tuned for [v0.96][github-next-release-work]!
 
 ## ❤️ PowerToys Community 
 The PowerToys team is extremely grateful to have the [support of an amazing active community][community-link]. The work you do is incredibly important. PowerToys wouldn't be nearly what it is today without your help filing bugs, updating documentation, guiding the design, or writing features. We want to say thank you and take time to recognize your work. Your contributions and feedback improve PowerToys month after month!

SEMANTIC_SEARCH_API_SUMMARY.md

@@ -1,244 +0,0 @@
-# Windows App SDK Semantic Search API 总结
-
-## 1. 环境与依赖
-
-| 项目 | 版本/值 |
-|------|---------|
-| **Windows App SDK** | `2.0.0-experimental3` |
-| **.NET** | `net9.0-windows10.0.26100.0` |
-| **AI Search NuGet** | `Microsoft.WindowsAppSDK.AI` (2.0.57-experimental) |
-| **命名空间** | `Microsoft.Windows.AI.Search.Experimental.AppContentIndex` |
-| **应用类型** | WinUI 3 MSIX 打包应用 |
-
----
-
-## 2. 核心 API
-
-### 2.1 索引管理
-```csharp
-// 创建/打开索引
-var result = AppContentIndexer.GetOrCreateIndex("indexName");
-if (result.Succeeded) {
-    _indexer = result.Indexer;
-    // result.Status: CreatedNew | OpenedExisting
-}
-
-// 等待索引能力就绪
-await _indexer.WaitForIndexCapabilitiesAsync();
-
-// 等待索引空闲（建索引完成）
-await _indexer.WaitForIndexingIdleAsync(TimeSpan.FromSeconds(120));
-
-// 清理
-_indexer.RemoveAll();  // 删除所有索引
-_indexer.Remove(id);   // 删除单个
-_indexer.Dispose();
-```
-
-### 2.2 添加内容到索引
-```csharp
-// 索引文本 → 自动建立 TextLexical + TextSemantic 索引
-IndexableAppContent textContent = AppManagedIndexableAppContent.CreateFromString(id, text);
-_indexer.AddOrUpdate(textContent);
-
-// 索引图片 → 自动建立 ImageSemantic + ImageOcr 索引
-IndexableAppContent imageContent = AppManagedIndexableAppContent.CreateFromBitmap(id, softwareBitmap);
-_indexer.AddOrUpdate(imageContent);
-```
-
-### 2.3 查询
-```csharp
-// 文本查询
-TextQueryOptions options = new TextQueryOptions {
-    Language = "en-US",                          // 可选
-    MatchScope = QueryMatchScope.Unconstrained,  // 匹配范围
-    TextMatchType = TextLexicalMatchType.Fuzzy   // Fuzzy | Exact
-};
-AppIndexTextQuery query = _indexer.CreateTextQuery(searchText, options);
-IReadOnlyList<TextQueryMatch> matches = query.GetNextMatches(5);
-
-// 图片查询
-ImageQueryOptions imgOptions = new ImageQueryOptions {
-    MatchScope = QueryMatchScope.Unconstrained,
-    ImageOcrTextMatchType = TextLexicalMatchType.Fuzzy
-};
-AppIndexImageQuery imgQuery = _indexer.CreateImageQuery(searchText, imgOptions);
-IReadOnlyList<ImageQueryMatch> imgMatches = imgQuery.GetNextMatches(5);
-```
-
-### 2.4 能力检查（只读）
-```csharp
-IndexCapabilities capabilities = _indexer.GetIndexCapabilities();
-
-bool textLexicalOK = capabilities.GetCapabilityState(IndexCapability.TextLexical)
-    .InitializationStatus == IndexCapabilityInitializationStatus.Initialized;
-bool textSemanticOK = capabilities.GetCapabilityState(IndexCapability.TextSemantic)
-    .InitializationStatus == IndexCapabilityInitializationStatus.Initialized;
-bool imageSemanticOK = capabilities.GetCapabilityState(IndexCapability.ImageSemantic)
-    .InitializationStatus == IndexCapabilityInitializationStatus.Initialized;
-bool imageOcrOK = capabilities.GetCapabilityState(IndexCapability.ImageOcr)
-    .InitializationStatus == IndexCapabilityInitializationStatus.Initialized;
-```
-
----
-
-## 3. 四种索引能力
-
-| 能力 | 说明 | 触发方式 |
-|------|------|----------|
-| `TextLexical` | 词法/关键词搜索 | CreateFromString() 自动 |
-| `TextSemantic` | AI 语义搜索 (Embedding) | CreateFromString() 自动 |
-| `ImageSemantic` | 图像语义搜索 | CreateFromBitmap() 自动 |
-| `ImageOcr` | 图片 OCR 文字搜索 | CreateFromBitmap() 自动 |
-
----
-
-## 4. 可控选项（有限）
-
-### TextQueryOptions
-| 属性 | 类型 | 说明 |
-|------|------|------|
-| `Language` | string | 查询语言（可选，如 "en-US"）|
-| `MatchScope` | QueryMatchScope | Unconstrained / Region / ContentItem |
-| `TextMatchType` | TextLexicalMatchType | **Fuzzy** / Exact（仅影响 Lexical）|
-
-### ImageQueryOptions
-| 属性 | 类型 | 说明 |
-|------|------|------|
-| `MatchScope` | QueryMatchScope | Unconstrained / Region / ContentItem |
-| `ImageOcrTextMatchType` | TextLexicalMatchType | **Fuzzy** / Exact（仅影响 OCR）|
-
-### 枚举值说明
-
-**QueryMatchScope:**
-- `Unconstrained` - 无约束，同时使用 Lexical + Semantic
-- `Region` - 限制在特定区域
-- `ContentItem` - 限制在单个内容项
-
-**TextLexicalMatchType:**
-- `Fuzzy` - 模糊匹配，允许拼写错误、近似词
-- `Exact` - 精确匹配，必须完全一致
-
----
-
-## 5. 关键限制 ⚠️
-
-| 限制 | 说明 |
-|------|------|
-| **不能单独指定 Semantic/Lexical** | 系统自动同时使用所有可用能力 |
-| **Fuzzy/Exact 只影响 Lexical** | 对 Semantic 搜索无效 |
-| **能力检查是只读的** | `GetIndexCapabilities()` 只能查看，不能控制 |
-| **无相似度阈值** | 不能设置 Semantic 匹配的阈值 |
-| **无结果排序控制** | 无法指定按相关度或其他方式排序 |
-| **语言需手动传** | 不会自动检测，需开发者指定 |
-| **无相关度分数** | 查询结果不返回匹配分数 |
-
----
-
-## 6. 典型使用流程
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                    App 启动时                           │
-├─────────────────────────────────────────────────────────┤
-│ 1. GetOrCreateIndex("name")     // 创建/打开索引        │
-│ 2. WaitForIndexCapabilitiesAsync()  // 等待能力就绪     │
-│ 3. GetIndexCapabilities()        // 检查可用能力        │
-│ 4. IndexAll()                    // 索引所有数据        │
-│    ├─ CreateFromString() × N                           │
-│    └─ CreateFromBitmap() × N                           │
-│ 5. WaitForIndexingIdleAsync()    // 等待索引完成        │
-└─────────────────────────────────────────────────────────┘
-                         ↓
-┌─────────────────────────────────────────────────────────┐
-│                    运行时查询                            │
-├─────────────────────────────────────────────────────────┤
-│ 1. CreateTextQuery(text, options)   // 创建查询         │
-│ 2. query.GetNextMatches(N)          // 获取结果         │
-│ 3. 处理 TextQueryMatch / ImageQueryMatch               │
-└─────────────────────────────────────────────────────────┘
-                         ↓
-┌─────────────────────────────────────────────────────────┐
-│                    App 退出时                           │
-├─────────────────────────────────────────────────────────┤
-│ 1. _indexer.RemoveAll()             // 清理索引         │
-│ 2. _indexer.Dispose()               // 释放资源         │
-└─────────────────────────────────────────────────────────┘
-```
-
----
-
-## 7. 查询结果处理
-
-```csharp
-// 文本查询结果
-foreach (var match in textMatches)
-{
-    if (match.ContentKind == QueryMatchContentKind.AppManagedText)
-    {
-        AppManagedTextQueryMatch textResult = (AppManagedTextQueryMatch)match;
-        string contentId = match.ContentId;      // 内容 ID
-        int offset = textResult.TextOffset;      // 匹配文本偏移
-        int length = textResult.TextLength;      // 匹配文本长度
-    }
-}
-
-// 图片查询结果
-foreach (var match in imageMatches)
-{
-    if (match.ContentKind == QueryMatchContentKind.AppManagedImage)
-    {
-        AppManagedImageQueryMatch imageResult = (AppManagedImageQueryMatch)match;
-        string contentId = imageResult.ContentId;  // 图片 ID
-    }
-}
-```
-
----
-
-## 8. 能力变化监听
-
-```csharp
-// 监听索引能力变化
-_indexer.Listener.IndexCapabilitiesChanged += (indexer, capabilities) =>
-{
-    // 重新检查能力状态，更新 UI
-    LoadAppIndexCapabilities();
-};
-```
-
----
-
-## 9. 结论
-
-这是一个**高度封装的黑盒 API**：
-
-### 优点 ✅
-- 简单易用，几行代码即可实现搜索
-- 自动处理 Lexical + Semantic
-- 支持文本和图片多模态搜索
-- 系统级集成，无需额外部署模型
-
-### 缺点 ❌
-- 无法精细控制搜索类型
-- 不能只用 Semantic Search
-- 选项有限，缺乏高级配置
-- 实验性 API，可能变更
-
-### 替代方案
-**如果需要纯 Semantic Search（向量搜索）**，建议：
-- 直接使用 Embedding 模型生成向量
-- 配合向量数据库（Azure Cosmos DB、FAISS、Qdrant 等）
-
----
-
-## 10. 相关 NuGet 包
-
-```xml
-<PackageReference Include="Microsoft.WindowsAppSDK" Version="2.0.0-experimental3" />
-<PackageReference Include="Microsoft.WindowsAppSDK.AI" Version="2.0.57-experimental" />
-```
-
----
-
-*文档生成日期: 2026-01-21*

doc/devdocs/development/debugging.md

@@ -96,40 +96,3 @@ The Shell Process Debugging Tool is a Visual Studio extension that helps debug m
 - Logs are stored in the local app directory: `%LOCALAPPDATA%\Microsoft\PowerToys`
 - Check Event Viewer for application crashes related to `PowerToys.Settings.exe`
 - Crash dumps can be obtained from Event Viewer
-
-## Troubleshooting Build Errors
-
-### Missing Image Files or Corrupted Build State
-
-If you encounter build errors about missing image files (e.g., `.png`, `.ico`, or other assets), this typically indicates a corrupted build state. To resolve:
-
-1. **Clean the solution in Visual Studio**: Build > Clean Solution
-
-   Or from the command line (Developer Command Prompt for VS 2022):
-   ```pwsh
-   msbuild PowerToys.slnx /t:Clean /p:Platform=x64 /p:Configuration=Debug
-   ```
-
-2. **Delete build output and package folders** from the repository root:
-   - `x64/`
-   - `ARM64/`
-   - `Debug/`
-   - `Release/`
-   - `packages/`
-
-3. **Rebuild the solution**
-
-#### Helper Script
-
-A PowerShell script is available to automate this cleanup:
-
-```pwsh
-.\tools\build\clean-artifacts.ps1
-```
-
-This script will run MSBuild Clean and remove the build folders listed above. Use `-SkipMSBuildClean` if you only want to delete the folders without running MSBuild Clean.
-
-After cleaning, rebuild with:
-```pwsh
-msbuild -restore -p:RestorePackagesConfig=true -p:Platform=x64 -m PowerToys.slnx
-```

doc/devdocs/readme.md

@@ -83,40 +83,14 @@ Once you've discussed your proposed feature/fix/etc. with a team member, and an
 1. A local clone of the PowerToys repository
 1. Enable long paths in Windows (see [Enable Long Paths](https://docs.microsoft.com/windows/win32/fileio/maximum-file-path-limitation#enabling-long-paths-in-windows-10-version-1607-and-later) for details)
 
-### Automated Setup (Recommended)
-
-Run the setup script to automatically configure your development environment:
-
-```powershell
-.\tools\build\setup-dev-environment.ps1
-```
-
-This script will:
-- Enable Windows long path support (requires administrator privileges)
-- Enable Windows Developer Mode (requires administrator privileges)
-- Guide you through installing required Visual Studio components from `.vsconfig`
-- Initialize git submodules
-
-Run with `-Help` to see all available options:
-
-```powershell
-.\tools\build\setup-dev-environment.ps1 -Help
-```
-
-### Manual Setup
-
-If you prefer to set up manually, follow these steps:
-
-#### Install Visual Studio dependencies
+### Install Visual Studio dependencies
 
 1. Open the `PowerToys.slnx` file.
 1. If you see a dialog that says `install extra components` in the solution explorer pane, click `install`
 
-Alternatively, import the `.vsconfig` file from the repository root using Visual Studio Installer to install all required workloads.
+### Get Submodules to compile
 
-#### Get Submodules to compile
-
-We have submodules that need to be initialized before you can compile most parts of PowerToys. This should be a one-time step.
+We have submodules that need to be initialized before you can compile most parts of PowerToys.  This should be a one-time step.
 
 1. Open a terminal
 1. Navigate to the folder you cloned PowerToys to.
@@ -124,32 +98,12 @@ We have submodules that need to be initialized before you can compile most parts
 
 ### Compiling Source Code
 
-#### Using Visual Studio
-
 - Open `PowerToys.slnx` in Visual Studio.
 - In the `Solutions Configuration` drop-down menu select `Release` or `Debug`.
 - From the `Build` menu choose `Build Solution`, or press <kbd>Control</kbd>+<kbd>Shift</kbd>+<kbd>b</kbd> on your keyboard.
 - The build process may take several minutes depending on your computer's performance. Once it completes, the PowerToys binaries will be in your repo under `x64\Release\`.
     - You can run `x64\Release\PowerToys.exe` directly without installing PowerToys, but some modules (i.e. PowerRename, ImageResizer, File Explorer extension etc.) will not be available unless you also build the installer and install PowerToys.
 
-#### Using Command Line
-
-You can also build from the command line using the provided scripts in `tools\build\`:
-
-```powershell
-# Build the full solution (auto-detects platform)
-.\tools\build\build.ps1
-
-# Build with specific configuration
-.\tools\build\build.ps1 -Platform x64 -Configuration Release
-
-# Build only essential projects (runner + settings) for faster iteration
-.\tools\build\build-essentials.ps1
-
-# Build everything including the installer (Release only)
-.\tools\build\build-installer.ps1
-```
-
 ## Compile the installer
 
 Our installer is two parts, an EXE and an MSI.  The EXE (Bootstrapper) contains the MSI and handles more complex installation logic. 

doc/planning/awake.md

@@ -1,5 +1,5 @@
 ---
-last-update: 1-18-2026
+last-update: 7-16-2024
 ---
 
 # PowerToys Awake Changelog
@@ -12,7 +12,6 @@ The build ID moniker is made up of two components - a reference to a [Halo](http
 
 | Build ID                                                           | Build Date        |
 |:-------------------------------------------------------------------|:------------------|
-| [`DIDACT_01182026`](#DIDACT_01182026-january-18-2026)              | January 18, 2026  |
 | [`TILLSON_11272024`](#TILLSON_11272024-november-27-2024)           | November 27, 2024 |
 | [`PROMETHEAN_09082024`](#PROMETHEAN_09082024-september-8-2024)     | September 8, 2024 |
 | [`VISEGRADRELAY_08152024`](#VISEGRADRELAY_08152024-august-15-2024) | August 15, 2024   |
@@ -21,22 +20,6 @@ The build ID moniker is made up of two components - a reference to a [Halo](http
 | [`LIBRARIAN_03202022`](#librarian_03202022-march-20-2022)          | March 20, 2022    |
 | `ARBITER_01312022`                                                 | January 31, 2022  |
 
-### `DIDACT_01182026` (January 18, 2026)
-
->[!NOTE]
->See pull request: [Awake - `DIDACT_01182026`](https://github.com/microsoft/PowerToys/pull/44795)
-
-- [#32544](https://github.com/microsoft/PowerToys/issues/32544) Fixed an issue where Awake settings became non-functional after the PC wakes from sleep. Added `WM_POWERBROADCAST` handling to detect system resume events (`PBT_APMRESUMEAUTOMATIC`, `PBT_APMRESUMESUSPEND`) and re-apply `SetThreadExecutionState` to restore the awake state.
-- [#36150](https://github.com/microsoft/PowerToys/issues/36150) Fixed an issue where Awake would not prevent sleep when AC power is connected. Added `PBT_APMPOWERSTATUSCHANGE` handling to re-apply `SetThreadExecutionState` when the power source changes (AC/battery transitions).
-- Fixed an issue where toggling "Keep screen on" during an active timed session would disrupt the countdown timer. The display setting now updates directly without restarting the timer, preserving the exact remaining time.
-- [#41918](https://github.com/microsoft/PowerToys/issues/41918) Fixed `WM_COMMAND` message processing flaw in `TrayHelper.WndProc` that incorrectly compared enum values against enum count. Added proper bounds checking for custom tray time entries.
-- Investigated [#44134](https://github.com/microsoft/PowerToys/issues/44134) - documented that `ES_DISPLAY_REQUIRED` (used when "Keep display on" is enabled) blocks Task Scheduler idle detection, preventing scheduled maintenance tasks like SSD TRIM. Workaround: disable "Keep display on" or manually run `Optimize-Volume -DriveLetter C -ReTrim`. Additional investigation needed for potential "idle window" feature.
-- [#41738](https://github.com/microsoft/PowerToys/issues/41738) Fixed `--display-on` CLI flag default from `true` to `false` to align with documentation and PowerToys settings behavior. This is a breaking change for scripts relying on the undocumented default.
-- [#41674](https://github.com/microsoft/PowerToys/issues/41674) Fixed silent failure when `SetThreadExecutionState` fails. The monitor thread now handles the return value, logs an error, and reverts to passive mode with updated tray icon.
-- [#38770](https://github.com/microsoft/PowerToys/issues/38770) Fixed tray icon failing to appear after Windows updates. Increased retry attempts and delays for icon Add operations (10 attempts, up to ~15.5 seconds total) while keeping existing fast retry behavior for Update/Delete operations.
-- [#40501](https://github.com/microsoft/PowerToys/issues/40501) Fixed tray icon not disappearing when Awake is disabled. The `SetShellIcon` function was incorrectly requiring an icon for Delete operations, causing the `NIM_DELETE` message to never be sent.
-- [#40659](https://github.com/microsoft/PowerToys/issues/40659) Fixed potential stack overflow crash in EXPIRABLE mode. Added early return after SaveSettings when correcting past expiration times, matching the pattern used by other mode handlers to prevent reentrant execution.
-
 ### `TILLSON_11272024` (November 27, 2024)
 
 >[!NOTE]

doc/specs/common-search-library.md

@@ -1,496 +0,0 @@
-# Common.Search Library Specification
-
-## Overview
-
-本文档描述 `Common.Search` 库的重构设计，目标是提供一个通用的、可插拔的搜索框架，支持多种搜索引擎实现（Fuzzy Match、Semantic Search 等）。
-
-## Goals
-
-1. **解耦** - 搜索引擎与数据源完全解耦
-2. **可插拔** - 支持替换不同的搜索引擎实现
-3. **泛型** - 不绑定特定业务类型（如 SettingEntry）
-4. **可组合** - 支持多引擎组合（即时 Fuzzy + 延迟 Semantic）
-5. **可复用** - 可被 PowerToys 多个模块使用
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                      Consumer (e.g., Settings.UI)               │
-├─────────────────────────────────────────────────────────────────┤
-│  SettingsDataProvider        ← 业务特定的数据加载               │
-│  SettingsSearchService       ← 业务特定的搜索服务               │
-│  SettingEntry : ISearchable  ← 业务实体实现搜索契约             │
-└─────────────────────────────────────────────────────────────────┘
-                              │ uses
-                              ▼
-┌─────────────────────────────────────────────────────────────────┐
-│                      Common.Search (Library)                    │
-├─────────────────────────────────────────────────────────────────┤
-│                                                                 │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │                    Core Abstractions                     │   │
-│  ├─────────────────────────────────────────────────────────┤   │
-│  │  ISearchable              ← 可搜索内容契约               │   │
-│  │  ISearchEngine<T>         ← 搜索引擎接口                 │   │
-│  │  SearchResult<T>          ← 统一结果模型                 │   │
-│  │  SearchOptions            ← 搜索选项                     │   │
-│  └─────────────────────────────────────────────────────────┘   │
-│                                                                 │
-│  ┌─────────────────────────────────────────────────────────┐   │
-│  │                    Implementations                       │   │
-│  ├─────────────────────────────────────────────────────────┤   │
-│  │  FuzzSearch/                                             │   │
-│  │  ├── FuzzSearchEngine<T>  ← 内存 Fuzzy 搜索              │   │
-│  │  ├── StringMatcher        ← 现有的模糊匹配算法           │   │
-│  │  └── MatchResult          ← Fuzzy 匹配结果               │   │
-│  │                                                          │   │
-│  │  SemanticSearch/                                         │   │
-│  │  ├── SemanticSearchEngine ← Windows AI Search 封装       │   │
-│  │  └── SemanticSearchCapabilities                          │   │
-│  │                                                          │   │
-│  │  CompositeSearch/                                        │   │
-│  │  └── CompositeSearchEngine<T> ← 多引擎组合               │   │
-│  └─────────────────────────────────────────────────────────┘   │
-│                                                                 │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-## Core Interfaces
-
-### ISearchable
-
-定义可搜索内容的最小契约。
-
-```csharp
-namespace Common.Search;
-
-/// <summary>
-/// Defines a searchable item that can be indexed and searched.
-/// </summary>
-public interface ISearchable
-{
-    /// <summary>
-    /// Gets the unique identifier for this item.
-    /// </summary>
-    string Id { get; }
-
-    /// <summary>
-    /// Gets the primary searchable text (e.g., title, header).
-    /// </summary>
-    string SearchableText { get; }
-
-    /// <summary>
-    /// Gets optional secondary searchable text (e.g., description).
-    /// Returns null if not available.
-    /// </summary>
-    string? SecondarySearchableText { get; }
-}
-```
-
-### ISearchEngine&lt;T&gt;
-
-搜索引擎核心接口。
-
-```csharp
-namespace Common.Search;
-
-/// <summary>
-/// Defines a pluggable search engine that can index and search items.
-/// </summary>
-/// <typeparam name="T">The type of items to search, must implement ISearchable.</typeparam>
-public interface ISearchEngine<T> : IDisposable
-    where T : ISearchable
-{
-    /// <summary>
-    /// Gets a value indicating whether the engine is ready to search.
-    /// </summary>
-    bool IsReady { get; }
-
-    /// <summary>
-    /// Gets the engine capabilities.
-    /// </summary>
-    SearchEngineCapabilities Capabilities { get; }
-
-    /// <summary>
-    /// Initializes the search engine.
-    /// </summary>
-    Task InitializeAsync(CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Indexes a single item.
-    /// </summary>
-    Task IndexAsync(T item, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Indexes multiple items in batch.
-    /// </summary>
-    Task IndexBatchAsync(IEnumerable<T> items, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Removes an item from the index by its ID.
-    /// </summary>
-    Task RemoveAsync(string id, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Clears all indexed items.
-    /// </summary>
-    Task ClearAsync(CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Searches for items matching the query.
-    /// </summary>
-    Task<IReadOnlyList<SearchResult<T>>> SearchAsync(
-        string query,
-        SearchOptions? options = null,
-        CancellationToken cancellationToken = default);
-}
-```
-
-### SearchResult&lt;T&gt;
-
-统一的搜索结果模型。
-
-```csharp
-namespace Common.Search;
-
-/// <summary>
-/// Represents a search result with the matched item and scoring information.
-/// </summary>
-public sealed class SearchResult<T>
-    where T : ISearchable
-{
-    /// <summary>
-    /// Gets the matched item.
-    /// </summary>
-    public required T Item { get; init; }
-
-    /// <summary>
-    /// Gets the relevance score (higher is more relevant).
-    /// </summary>
-    public required double Score { get; init; }
-
-    /// <summary>
-    /// Gets the type of match that produced this result.
-    /// </summary>
-    public required SearchMatchKind MatchKind { get; init; }
-
-    /// <summary>
-    /// Gets the match details for highlighting (optional).
-    /// </summary>
-    public IReadOnlyList<MatchSpan>? MatchSpans { get; init; }
-}
-
-/// <summary>
-/// Represents a span of matched text for highlighting.
-/// </summary>
-public readonly record struct MatchSpan(int Start, int Length);
-
-/// <summary>
-/// Specifies the kind of match that produced a search result.
-/// </summary>
-public enum SearchMatchKind
-{
-    /// <summary>Exact text match.</summary>
-    Exact,
-
-    /// <summary>Fuzzy/approximate text match.</summary>
-    Fuzzy,
-
-    /// <summary>Semantic/AI-based match.</summary>
-    Semantic,
-
-    /// <summary>Combined match from multiple engines.</summary>
-    Composite,
-}
-```
-
-### SearchOptions
-
-搜索配置选项。
-
-```csharp
-namespace Common.Search;
-
-/// <summary>
-/// Options for configuring search behavior.
-/// </summary>
-public sealed class SearchOptions
-{
-    /// <summary>
-    /// Gets or sets the maximum number of results to return.
-    /// Default is 20.
-    /// </summary>
-    public int MaxResults { get; set; } = 20;
-
-    /// <summary>
-    /// Gets or sets the minimum score threshold (0.0 to 1.0).
-    /// Results below this score are filtered out.
-    /// Default is 0.0 (no filtering).
-    /// </summary>
-    public double MinScore { get; set; } = 0.0;
-
-    /// <summary>
-    /// Gets or sets the language hint for the search (e.g., "en-US").
-    /// </summary>
-    public string? Language { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether to include match spans for highlighting.
-    /// Default is false.
-    /// </summary>
-    public bool IncludeMatchSpans { get; set; } = false;
-}
-```
-
-### SearchEngineCapabilities
-
-引擎能力描述。
-
-```csharp
-namespace Common.Search;
-
-/// <summary>
-/// Describes the capabilities of a search engine.
-/// </summary>
-public sealed class SearchEngineCapabilities
-{
-    /// <summary>
-    /// Gets a value indicating whether the engine supports fuzzy matching.
-    /// </summary>
-    public bool SupportsFuzzyMatch { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine supports semantic search.
-    /// </summary>
-    public bool SupportsSemanticSearch { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine persists the index to disk.
-    /// </summary>
-    public bool PersistsIndex { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine supports incremental indexing.
-    /// </summary>
-    public bool SupportsIncrementalIndex { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine supports match span highlighting.
-    /// </summary>
-    public bool SupportsMatchSpans { get; init; }
-}
-```
-
-## Implementations
-
-### FuzzSearchEngine&lt;T&gt;
-
-基于现有 StringMatcher 的内存搜索引擎。
-
-**特点：**
-- 纯内存，无持久化
-- 即时响应（毫秒级）
-- 支持 match spans 高亮
-- 基于字符的模糊匹配
-
-**Capabilities：**
-```csharp
-new SearchEngineCapabilities
-{
-    SupportsFuzzyMatch = true,
-    SupportsSemanticSearch = false,
-    PersistsIndex = false,
-    SupportsIncrementalIndex = true,
-    SupportsMatchSpans = true,
-}
-```
-
-### SemanticSearchEngine
-
-基于 Windows App SDK AI Search API 的语义搜索引擎。
-
-**特点：**
-- 系统管理的持久化索引
-- AI 驱动的语义理解
-- 需要模型初始化（可能较慢）
-- 可能不可用（依赖系统支持）
-
-**Capabilities：**
-```csharp
-new SearchEngineCapabilities
-{
-    SupportsFuzzyMatch = true,  // API 同时提供 lexical + semantic
-    SupportsSemanticSearch = true,
-    PersistsIndex = true,
-    SupportsIncrementalIndex = true,
-    SupportsMatchSpans = false,  // API 不返回详细位置
-}
-```
-
-**注意：** SemanticSearchEngine 不是泛型的，因为它需要将内容转换为字符串存入系统索引。实现时通过 `ISearchable` 接口提取文本。
-
-### CompositeSearchEngine&lt;T&gt;
-
-组合多个搜索引擎，支持 fallback 和结果合并。
-
-```csharp
-namespace Common.Search;
-
-/// <summary>
-/// A search engine that combines results from multiple engines.
-/// </summary>
-public sealed class CompositeSearchEngine<T> : ISearchEngine<T>
-    where T : ISearchable
-{
-    /// <summary>
-    /// Strategy for combining results from multiple engines.
-    /// </summary>
-    public enum CombineStrategy
-    {
-        /// <summary>Use first ready engine only.</summary>
-        FirstReady,
-
-        /// <summary>Merge results from all ready engines.</summary>
-        MergeAll,
-
-        /// <summary>Use primary, fallback to secondary if primary not ready.</summary>
-        PrimaryWithFallback,
-    }
-}
-```
-
-**典型用法：** Fuzzy 作为即时响应，Semantic 准备好后增强结果。
-
-## Directory Structure
-
-```
-src/common/Common.Search/
-├── Common.Search.csproj
-├── GlobalSuppressions.cs
-├── ISearchable.cs
-├── ISearchEngine.cs
-├── SearchResult.cs
-├── SearchOptions.cs
-├── SearchEngineCapabilities.cs
-├── SearchMatchKind.cs
-├── MatchSpan.cs
-│
-├── FuzzSearch/
-│   ├── FuzzSearchEngine.cs
-│   ├── StringMatcher.cs         (existing)
-│   ├── MatchOption.cs           (existing)
-│   ├── MatchResult.cs           (existing)
-│   └── SearchPrecisionScore.cs  (existing)
-│
-├── SemanticSearch/
-│   ├── SemanticSearchEngine.cs
-│   ├── SemanticSearchCapabilities.cs
-│   └── SemanticSearchAdapter.cs  (adapts ISearchable to Windows API)
-│
-└── CompositeSearch/
-    └── CompositeSearchEngine.cs
-```
-
-## Consumer Usage (Settings.UI)
-
-### SettingEntry 实现 ISearchable
-
-```csharp
-// Settings.UI.Library/SettingEntry.cs
-public struct SettingEntry : ISearchable
-{
-    // Existing properties...
-
-    // ISearchable implementation
-    public string Id => ElementUid ?? $"{PageTypeName}|{ElementName}";
-    public string SearchableText => Header ?? string.Empty;
-    public string? SecondarySearchableText => Description;
-}
-```
-
-### SettingsSearchService
-
-```csharp
-// Settings.UI/Services/SettingsSearchService.cs
-public sealed class SettingsSearchService : IDisposable
-{
-    private readonly ISearchEngine<SettingEntry> _engine;
-
-    public SettingsSearchService(ISearchEngine<SettingEntry> engine)
-    {
-        _engine = engine;
-    }
-
-    public async Task InitializeAsync(IEnumerable<SettingEntry> entries)
-    {
-        await _engine.InitializeAsync();
-        await _engine.IndexBatchAsync(entries);
-    }
-
-    public async Task<List<SettingEntry>> SearchAsync(string query, CancellationToken ct = default)
-    {
-        var results = await _engine.SearchAsync(query, cancellationToken: ct);
-        return results.Select(r => r.Item).ToList();
-    }
-}
-```
-
-### Startup Configuration
-
-```csharp
-// Option 1: Fuzzy only (default, immediate)
-var engine = new FuzzSearchEngine<SettingEntry>();
-
-// Option 2: Semantic only (requires Windows AI)
-var engine = new SemanticSearchAdapter<SettingEntry>("PowerToysSettings");
-
-// Option 3: Composite (best of both worlds)
-var engine = new CompositeSearchEngine<SettingEntry>(
-    primary: new SemanticSearchAdapter<SettingEntry>("PowerToysSettings"),
-    fallback: new FuzzSearchEngine<SettingEntry>(),
-    strategy: CombineStrategy.PrimaryWithFallback
-);
-
-var searchService = new SettingsSearchService(engine);
-await searchService.InitializeAsync(settingEntries);
-```
-
-## Migration Plan
-
-### Phase 1: Core Abstractions
-1. 创建 `ISearchable`, `ISearchEngine<T>`, `SearchResult<T>` 等核心接口
-2. 保持现有 FuzzSearch 代码不变
-
-### Phase 2: FuzzSearchEngine&lt;T&gt;
-1. 创建泛型 `FuzzSearchEngine<T>` 实现
-2. 内部复用现有 `StringMatcher`
-
-### Phase 3: SemanticSearchEngine
-1. 完善现有 `SemanticSearchEngine` 实现
-2. 创建 `SemanticSearchAdapter<T>` 桥接泛型接口
-
-### Phase 4: Settings.UI Migration
-1. `SettingEntry` 实现 `ISearchable`
-2. 创建 `SettingsSearchService`
-3. 迁移 `SearchIndexService` 到新架构
-4. 保持 API 兼容，逐步废弃旧方法
-
-### Phase 5: CompositeSearchEngine (Optional)
-1. 实现组合引擎
-2. 支持 Fuzzy + Semantic 混合搜索
-
-## Open Questions
-
-1. **是否需要支持图片搜索？** 当前 SemanticSearchEngine 支持 `IndexImage`，但 `ISearchable` 只有文本。如果需要图片，可能需要 `IImageSearchable` 扩展。
-
-2. **结果去重策略？** CompositeEngine 合并结果时，同一个 Item 可能被多个引擎匹配，如何去重和合并分数？
-
-3. **异步 vs 同步？** FuzzSearch 完全可以同步执行，但接口统一用 `Task` 是否合适？考虑提供同步重载？
-
-4. **索引更新策略？** 当 Settings 内容变化时（例如用户切换语言），如何高效更新索引？
-
----
-
-*Document Version: 1.0*
-*Last Updated: 2026-01-21*

installer/PowerToysSetupVNext/CmdPal.wxs

@@ -18,7 +18,6 @@
         <RegistryKey Root="$(var.RegistryScope)" Key="Software\Classes\powertoys\components">
           <RegistryValue Type="string" Name="Module_CmdPal" Value="" KeyPath="yes" />
         </RegistryKey>
-        <RemoveFile Id="RemoveOldCmdPalMsix" Name="Microsoft.CmdPal.UI_*.msix" On="install" />
         <?if $(sys.BUILDARCH) = x64 ?>
         <File Id="Microsoft.CmdPal.UI___var.CmdPalVersion_._x64.msix" Source="$(var.CmdPalBuildDir)AppPackages\Microsoft.CmdPal.UI_$(var.CmdPalVersion)_Test\Microsoft.CmdPal.UI_$(var.CmdPalVersion)_x64.msix" />
         <?else?>

src/PackageIdentity/AppxManifest.xml

@@ -29,7 +29,6 @@
   </Resources>
   <Dependencies>
     <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.19000.0" MaxVersionTested="10.0.26226.0" />
-    <PackageDependency Name="Microsoft.WindowsAppRuntime.2.0-experimental3" MinVersion="0.676.658.0" Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" />
   </Dependencies>
   <Capabilities>
     <Capability Name="internetClient" />

src/common/Common.Search/Common.Search.csproj

@@ -4,16 +4,5 @@
 
   <PropertyGroup>
     <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <WarningsNotAsErrors>$(WarningsNotAsErrors);CS8305</WarningsNotAsErrors>
   </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Microsoft.WindowsAppSDK" />
-    <PackageReference Include="Microsoft.WindowsAppSDK.AI" />
-  </ItemGroup>
-
-  <ItemGroup>
-    <ProjectReference Include="..\ManagedCommon\ManagedCommon.csproj" />
-  </ItemGroup>
 </Project>

src/common/Common.Search/FuzzSearch/FuzzSearchEngine`1.cs

@@ -1,306 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-using System.Collections.Concurrent;
-using System.Globalization;
-using System.Text;
-
-namespace Common.Search.FuzzSearch;
-
-/// <summary>
-/// A search engine that uses fuzzy string matching for search.
-/// </summary>
-/// <typeparam name="T">The type of items to search.</typeparam>
-public sealed class FuzzSearchEngine<T> : ISearchEngine<T>
-    where T : ISearchable
-{
-    private readonly object _lockObject = new();
-    private readonly Dictionary<string, T> _itemsById = new();
-    private readonly Dictionary<string, (string PrimaryNorm, string? SecondaryNorm)> _normalizedCache = new();
-    private bool _isReady;
-    private bool _disposed;
-
-    /// <inheritdoc/>
-    public bool IsReady
-    {
-        get
-        {
-            lock (_lockObject)
-            {
-                return _isReady;
-            }
-        }
-    }
-
-    /// <inheritdoc/>
-    public SearchEngineCapabilities Capabilities { get; } = new()
-    {
-        SupportsFuzzyMatch = true,
-        SupportsSemanticSearch = false,
-        PersistsIndex = false,
-        SupportsIncrementalIndex = true,
-        SupportsMatchSpans = true,
-    };
-
-    /// <inheritdoc/>
-    public Task InitializeAsync(CancellationToken cancellationToken = default)
-    {
-        lock (_lockObject)
-        {
-            _isReady = true;
-        }
-
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task IndexAsync(T item, CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(item);
-        ThrowIfDisposed();
-
-        lock (_lockObject)
-        {
-            _itemsById[item.Id] = item;
-            _normalizedCache[item.Id] = (
-                NormalizeString(item.SearchableText),
-                item.SecondarySearchableText != null ? NormalizeString(item.SecondarySearchableText) : null
-            );
-        }
-
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task IndexBatchAsync(IEnumerable<T> items, CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(items);
-        ThrowIfDisposed();
-
-        lock (_lockObject)
-        {
-            foreach (var item in items)
-            {
-                if (cancellationToken.IsCancellationRequested)
-                {
-                    break;
-                }
-
-                _itemsById[item.Id] = item;
-                _normalizedCache[item.Id] = (
-                    NormalizeString(item.SearchableText),
-                    item.SecondarySearchableText != null ? NormalizeString(item.SecondarySearchableText) : null
-                );
-            }
-        }
-
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task RemoveAsync(string id, CancellationToken cancellationToken = default)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(id);
-        ThrowIfDisposed();
-
-        lock (_lockObject)
-        {
-            _itemsById.Remove(id);
-            _normalizedCache.Remove(id);
-        }
-
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task ClearAsync(CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-
-        lock (_lockObject)
-        {
-            _itemsById.Clear();
-            _normalizedCache.Clear();
-        }
-
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task<IReadOnlyList<SearchResult<T>>> SearchAsync(
-        string query,
-        SearchOptions? options = null,
-        CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-
-        if (string.IsNullOrWhiteSpace(query))
-        {
-            return Task.FromResult<IReadOnlyList<SearchResult<T>>>(Array.Empty<SearchResult<T>>());
-        }
-
-        options ??= new SearchOptions();
-        var normalizedQuery = NormalizeString(query);
-
-        List<KeyValuePair<string, T>> snapshot;
-        lock (_lockObject)
-        {
-            if (_itemsById.Count == 0)
-            {
-                return Task.FromResult<IReadOnlyList<SearchResult<T>>>(Array.Empty<SearchResult<T>>());
-            }
-
-            snapshot = _itemsById.ToList();
-        }
-
-        var bag = new ConcurrentBag<SearchResult<T>>();
-        var po = new ParallelOptions
-        {
-            CancellationToken = cancellationToken,
-            MaxDegreeOfParallelism = Math.Max(1, Environment.ProcessorCount - 1),
-        };
-
-        try
-        {
-            Parallel.ForEach(snapshot, po, kvp =>
-            {
-                var (primaryNorm, secondaryNorm) = GetNormalizedTexts(kvp.Key);
-
-                var primaryResult = StringMatcher.FuzzyMatch(normalizedQuery, primaryNorm);
-                double score = primaryResult.Score;
-                List<int>? matchData = primaryResult.MatchData;
-
-                if (!string.IsNullOrEmpty(secondaryNorm))
-                {
-                    var secondaryResult = StringMatcher.FuzzyMatch(normalizedQuery, secondaryNorm);
-                    if (secondaryResult.Success && secondaryResult.Score * 0.8 > score)
-                    {
-                        score = secondaryResult.Score * 0.8;
-                        matchData = null; // Secondary matches don't have primary text spans
-                    }
-                }
-
-                if (score > options.MinScore)
-                {
-                    var result = new SearchResult<T>
-                    {
-                        Item = kvp.Value,
-                        Score = score,
-                        MatchKind = SearchMatchKind.Fuzzy,
-                        MatchSpans = options.IncludeMatchSpans && matchData != null
-                            ? ConvertToMatchSpans(matchData)
-                            : null,
-                    };
-
-                    bag.Add(result);
-                }
-            });
-        }
-        catch (OperationCanceledException)
-        {
-            return Task.FromResult<IReadOnlyList<SearchResult<T>>>(Array.Empty<SearchResult<T>>());
-        }
-
-        var results = bag
-            .OrderByDescending(r => r.Score)
-            .Take(options.MaxResults)
-            .ToList();
-
-        return Task.FromResult<IReadOnlyList<SearchResult<T>>>(results);
-    }
-
-    /// <inheritdoc/>
-    public void Dispose()
-    {
-        if (_disposed)
-        {
-            return;
-        }
-
-        lock (_lockObject)
-        {
-            _itemsById.Clear();
-            _normalizedCache.Clear();
-            _isReady = false;
-        }
-
-        _disposed = true;
-    }
-
-    private (string PrimaryNorm, string? SecondaryNorm) GetNormalizedTexts(string id)
-    {
-        lock (_lockObject)
-        {
-            if (_normalizedCache.TryGetValue(id, out var cached))
-            {
-                return cached;
-            }
-        }
-
-        return (string.Empty, null);
-    }
-
-    private static IReadOnlyList<MatchSpan> ConvertToMatchSpans(List<int> matchData)
-    {
-        if (matchData == null || matchData.Count == 0)
-        {
-            return Array.Empty<MatchSpan>();
-        }
-
-        // Convert individual match indices to spans
-        var spans = new List<MatchSpan>();
-        var sortedIndices = matchData.OrderBy(i => i).ToList();
-
-        int start = sortedIndices[0];
-        int length = 1;
-
-        for (int i = 1; i < sortedIndices.Count; i++)
-        {
-            if (sortedIndices[i] == sortedIndices[i - 1] + 1)
-            {
-                // Consecutive index, extend the span
-                length++;
-            }
-            else
-            {
-                // Gap found, save current span and start new one
-                spans.Add(new MatchSpan(start, length));
-                start = sortedIndices[i];
-                length = 1;
-            }
-        }
-
-        // Add the last span
-        spans.Add(new MatchSpan(start, length));
-
-        return spans;
-    }
-
-    private static string NormalizeString(string? input)
-    {
-        if (string.IsNullOrEmpty(input))
-        {
-            return string.Empty;
-        }
-
-        var normalized = input.ToLowerInvariant().Normalize(NormalizationForm.FormKD);
-        var sb = new StringBuilder(normalized.Length);
-
-        foreach (var c in normalized)
-        {
-            var category = CharUnicodeInfo.GetUnicodeCategory(c);
-            if (category != UnicodeCategory.NonSpacingMark)
-            {
-                sb.Append(c);
-            }
-        }
-
-        return sb.ToString();
-    }
-
-    private void ThrowIfDisposed()
-    {
-        ObjectDisposedException.ThrowIf(_disposed, this);
-    }
-}

src/common/Common.Search/FuzzSearch/StringMatcher.cs

@@ -25,9 +25,9 @@ public class StringMatcher
     /// 6. Move onto the next substring's characters until all substrings are checked.
     /// 7. Consider success and move onto scoring if every char or substring without whitespaces matched
     /// </summary>
-    public static MatchResult FuzzyMatch(string query, string stringToCompare, MatchOption? opt = null)
+    public static MatchResult FuzzyMatch(string query, string stringToCompare, MatchOption opt = null)
     {
-        opt ??= new MatchOption();
+        opt = opt ?? new MatchOption();
 
         if (string.IsNullOrEmpty(stringToCompare))
         {

src/common/Common.Search/GlobalSuppressions.cs

@@ -11,10 +11,6 @@ using System.Diagnostics.CodeAnalysis;
 [assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.MatchResult._rawScore")]
 [assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.StringMatcher._defaultMatchOption")]
 [assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.StringMatcher._instance")]
-[assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.SemanticSearch.SemanticSearchIndex._indexName")]
-[assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.SemanticSearch.SemanticSearchIndex._indexer")]
-[assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.SemanticSearch.SemanticSearchIndex._disposed")]
-[assembly: SuppressMessage("StyleCop.CSharp.NamingRules", "SA1309:Field names should not begin with underscore", Justification = "coding style", Scope = "member", Target = "~F:Common.Search.SemanticSearch.SemanticSearchIndex._capabilities")]
 [assembly: SuppressMessage("StyleCop.CSharp.ReadabilityRules", "SA1101:Prefix local calls with this", Justification = "coding style", Scope = "member", Target = "~M:Common.Search.MatchResult.#ctor(System.Boolean,Common.Search.SearchPrecisionScore)")]
 [assembly: SuppressMessage("StyleCop.CSharp.ReadabilityRules", "SA1101:Prefix local calls with this", Justification = "coding style", Scope = "member", Target = "~M:Common.Search.MatchResult.#ctor(System.Boolean,Common.Search.SearchPrecisionScore,System.Collections.Generic.List{System.Int32},System.Int32)")]
 [assembly: SuppressMessage("Compiler", "CS8618:Non-nullable field must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring as nullable.", Justification = "Coding style", Scope = "member", Target = "~F:Common.Search.StringMatcher._instance")]

src/common/Common.Search/ISearchEngine`1.cs

@@ -1,73 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Defines a pluggable search engine that can index and search items.
-/// </summary>
-/// <typeparam name="T">The type of items to search, must implement ISearchable.</typeparam>
-public interface ISearchEngine<T> : IDisposable
-    where T : ISearchable
-{
-    /// <summary>
-    /// Gets a value indicating whether the engine is ready to search.
-    /// </summary>
-    bool IsReady { get; }
-
-    /// <summary>
-    /// Gets the engine capabilities.
-    /// </summary>
-    SearchEngineCapabilities Capabilities { get; }
-
-    /// <summary>
-    /// Initializes the search engine.
-    /// </summary>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A task representing the async operation.</returns>
-    Task InitializeAsync(CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Indexes a single item.
-    /// </summary>
-    /// <param name="item">The item to index.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A task representing the async operation.</returns>
-    Task IndexAsync(T item, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Indexes multiple items in batch.
-    /// </summary>
-    /// <param name="items">The items to index.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A task representing the async operation.</returns>
-    Task IndexBatchAsync(IEnumerable<T> items, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Removes an item from the index by its ID.
-    /// </summary>
-    /// <param name="id">The ID of the item to remove.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A task representing the async operation.</returns>
-    Task RemoveAsync(string id, CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Clears all indexed items.
-    /// </summary>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A task representing the async operation.</returns>
-    Task ClearAsync(CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// Searches for items matching the query.
-    /// </summary>
-    /// <param name="query">The search query.</param>
-    /// <param name="options">Optional search options.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A list of search results ordered by relevance.</returns>
-    Task<IReadOnlyList<SearchResult<T>>> SearchAsync(
-        string query,
-        SearchOptions? options = null,
-        CancellationToken cancellationToken = default);
-}

src/common/Common.Search/ISearchable.cs

@@ -1,27 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Defines a searchable item that can be indexed and searched.
-/// </summary>
-public interface ISearchable
-{
-    /// <summary>
-    /// Gets the unique identifier for this item.
-    /// </summary>
-    string Id { get; }
-
-    /// <summary>
-    /// Gets the primary searchable text (e.g., title, header).
-    /// </summary>
-    string SearchableText { get; }
-
-    /// <summary>
-    /// Gets optional secondary searchable text (e.g., description).
-    /// Returns null if not available.
-    /// </summary>
-    string? SecondarySearchableText { get; }
-}

src/common/Common.Search/MatchSpan.cs

@@ -1,12 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Represents a span of matched text for highlighting.
-/// </summary>
-/// <param name="Start">The starting index of the match.</param>
-/// <param name="Length">The length of the match.</param>
-public readonly record struct MatchSpan(int Start, int Length);

src/common/Common.Search/SearchEngineCapabilities.cs

@@ -1,36 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Describes the capabilities of a search engine.
-/// </summary>
-public sealed class SearchEngineCapabilities
-{
-    /// <summary>
-    /// Gets a value indicating whether the engine supports fuzzy matching.
-    /// </summary>
-    public bool SupportsFuzzyMatch { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine supports semantic search.
-    /// </summary>
-    public bool SupportsSemanticSearch { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine persists the index to disk.
-    /// </summary>
-    public bool PersistsIndex { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine supports incremental indexing.
-    /// </summary>
-    public bool SupportsIncrementalIndex { get; init; }
-
-    /// <summary>
-    /// Gets a value indicating whether the engine supports match span highlighting.
-    /// </summary>
-    public bool SupportsMatchSpans { get; init; }
-}

src/common/Common.Search/SearchError.cs

@@ -1,134 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Represents an error that occurred during a search operation.
-/// </summary>
-public sealed class SearchError
-{
-    /// <summary>
-    /// Initializes a new instance of the <see cref="SearchError"/> class.
-    /// </summary>
-    /// <param name="code">The error code.</param>
-    /// <param name="message">The error message.</param>
-    /// <param name="details">Optional additional details.</param>
-    /// <param name="exception">Optional exception that caused the error.</param>
-    public SearchError(SearchErrorCode code, string message, string? details = null, Exception? exception = null)
-    {
-        Code = code;
-        Message = message;
-        Details = details;
-        Exception = exception;
-        Timestamp = DateTime.UtcNow;
-    }
-
-    /// <summary>
-    /// Gets the error code.
-    /// </summary>
-    public SearchErrorCode Code { get; }
-
-    /// <summary>
-    /// Gets the error message.
-    /// </summary>
-    public string Message { get; }
-
-    /// <summary>
-    /// Gets additional details about the error.
-    /// </summary>
-    public string? Details { get; }
-
-    /// <summary>
-    /// Gets the exception that caused the error, if any.
-    /// </summary>
-    public Exception? Exception { get; }
-
-    /// <summary>
-    /// Gets the timestamp when the error occurred.
-    /// </summary>
-    public DateTime Timestamp { get; }
-
-    /// <summary>
-    /// Creates an error for initialization failure.
-    /// </summary>
-    /// <param name="indexName">The name of the index.</param>
-    /// <param name="details">Optional details.</param>
-    /// <param name="exception">Optional exception.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError InitializationFailed(string indexName, string? details = null, Exception? exception = null)
-        => new(SearchErrorCode.InitializationFailed, $"Failed to initialize search index '{indexName}'.", details, exception);
-
-    /// <summary>
-    /// Creates an error for indexing failure.
-    /// </summary>
-    /// <param name="contentId">The ID of the content that failed to index.</param>
-    /// <param name="details">Optional details.</param>
-    /// <param name="exception">Optional exception.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError IndexingFailed(string contentId, string? details = null, Exception? exception = null)
-        => new(SearchErrorCode.IndexingFailed, $"Failed to index content '{contentId}'.", details, exception);
-
-    /// <summary>
-    /// Creates an error for search query failure.
-    /// </summary>
-    /// <param name="query">The search query that failed.</param>
-    /// <param name="details">Optional details.</param>
-    /// <param name="exception">Optional exception.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError SearchFailed(string query, string? details = null, Exception? exception = null)
-        => new(SearchErrorCode.SearchFailed, $"Search query '{query}' failed.", details, exception);
-
-    /// <summary>
-    /// Creates an error for engine not ready.
-    /// </summary>
-    /// <param name="operation">The operation that was attempted.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError EngineNotReady(string operation)
-        => new(SearchErrorCode.EngineNotReady, $"Search engine is not ready. Operation '{operation}' cannot be performed.");
-
-    /// <summary>
-    /// Creates an error for capability unavailable.
-    /// </summary>
-    /// <param name="capability">The capability that is unavailable.</param>
-    /// <param name="details">Optional details.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError CapabilityUnavailable(string capability, string? details = null)
-        => new(SearchErrorCode.CapabilityUnavailable, $"Search capability '{capability}' is not available.", details);
-
-    /// <summary>
-    /// Creates an error for timeout.
-    /// </summary>
-    /// <param name="operation">The operation that timed out.</param>
-    /// <param name="timeout">The timeout duration.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError Timeout(string operation, TimeSpan timeout)
-        => new(SearchErrorCode.Timeout, $"Operation '{operation}' timed out after {timeout.TotalSeconds:F1} seconds.");
-
-    /// <summary>
-    /// Creates an error for an unexpected error.
-    /// </summary>
-    /// <param name="operation">The operation that failed.</param>
-    /// <param name="exception">The exception that occurred.</param>
-    /// <returns>A new SearchError instance.</returns>
-    public static SearchError Unexpected(string operation, Exception exception)
-        => new(SearchErrorCode.Unexpected, $"Unexpected error during '{operation}'.", exception.Message, exception);
-
-    /// <inheritdoc/>
-    public override string ToString()
-    {
-        var result = $"[{Code}] {Message}";
-        if (!string.IsNullOrEmpty(Details))
-        {
-            result += $" Details: {Details}";
-        }
-
-        if (Exception != null)
-        {
-            result += $" Exception: {Exception.GetType().Name}: {Exception.Message}";
-        }
-
-        return result;
-    }
-}

src/common/Common.Search/SearchErrorCode.cs

@@ -1,51 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Defines error codes for search operations.
-/// </summary>
-public enum SearchErrorCode
-{
-    /// <summary>
-    /// No error occurred.
-    /// </summary>
-    None = 0,
-
-    /// <summary>
-    /// The search engine failed to initialize.
-    /// </summary>
-    InitializationFailed = 1,
-
-    /// <summary>
-    /// Failed to index content.
-    /// </summary>
-    IndexingFailed = 2,
-
-    /// <summary>
-    /// The search query failed to execute.
-    /// </summary>
-    SearchFailed = 3,
-
-    /// <summary>
-    /// The search engine is not ready to perform the operation.
-    /// </summary>
-    EngineNotReady = 4,
-
-    /// <summary>
-    /// A required capability is not available.
-    /// </summary>
-    CapabilityUnavailable = 5,
-
-    /// <summary>
-    /// The operation timed out.
-    /// </summary>
-    Timeout = 6,
-
-    /// <summary>
-    /// An unexpected error occurred.
-    /// </summary>
-    Unexpected = 99,
-}

src/common/Common.Search/SearchMatchKind.cs

@@ -1,31 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Specifies the kind of match that produced a search result.
-/// </summary>
-public enum SearchMatchKind
-{
-    /// <summary>
-    /// Exact text match.
-    /// </summary>
-    Exact,
-
-    /// <summary>
-    /// Fuzzy/approximate text match.
-    /// </summary>
-    Fuzzy,
-
-    /// <summary>
-    /// Semantic/AI-based match.
-    /// </summary>
-    Semantic,
-
-    /// <summary>
-    /// Combined match from multiple engines.
-    /// </summary>
-    Composite,
-}

src/common/Common.Search/SearchOperationResult.cs

@@ -1,53 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Represents the result of a search operation that may have errors.
-/// </summary>
-public sealed class SearchOperationResult
-{
-    private SearchOperationResult(bool success, SearchError? error = null)
-    {
-        IsSuccess = success;
-        Error = error;
-    }
-
-    /// <summary>
-    /// Gets a value indicating whether the operation was successful.
-    /// </summary>
-    public bool IsSuccess { get; }
-
-    /// <summary>
-    /// Gets a value indicating whether the operation failed.
-    /// </summary>
-    public bool IsFailure => !IsSuccess;
-
-    /// <summary>
-    /// Gets the error if the operation failed, null otherwise.
-    /// </summary>
-    public SearchError? Error { get; }
-
-    /// <summary>
-    /// Creates a successful result.
-    /// </summary>
-    /// <returns>A successful SearchOperationResult.</returns>
-    public static SearchOperationResult Success() => new(true);
-
-    /// <summary>
-    /// Creates a failed result with the specified error.
-    /// </summary>
-    /// <param name="error">The error that caused the failure.</param>
-    /// <returns>A failed SearchOperationResult.</returns>
-    public static SearchOperationResult Failure(SearchError error)
-    {
-        ArgumentNullException.ThrowIfNull(error);
-        return new SearchOperationResult(false, error);
-    }
-
-    /// <inheritdoc/>
-    public override string ToString()
-        => IsSuccess ? "Success" : $"Failure: {Error}";
-}

src/common/Common.Search/SearchOperationResult1.cs

@@ -1,87 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-using System.Diagnostics.CodeAnalysis;
-
-#pragma warning disable SA1649 // File name should match first type name - Generic type file naming convention
-
-namespace Common.Search;
-
-/// <summary>
-/// Represents the result of a search operation that returns a value and may have errors.
-/// </summary>
-/// <typeparam name="T">The type of the result value.</typeparam>
-public sealed class SearchOperationResult<T>
-{
-    private SearchOperationResult(bool success, T? value, SearchError? error)
-    {
-        IsSuccess = success;
-        Value = value;
-        Error = error;
-    }
-
-    /// <summary>
-    /// Gets a value indicating whether the operation was successful.
-    /// </summary>
-    public bool IsSuccess { get; }
-
-    /// <summary>
-    /// Gets a value indicating whether the operation failed.
-    /// </summary>
-    public bool IsFailure => !IsSuccess;
-
-    /// <summary>
-    /// Gets the result value if the operation was successful.
-    /// </summary>
-    public T? Value { get; }
-
-    /// <summary>
-    /// Gets the error if the operation failed, null otherwise.
-    /// </summary>
-    public SearchError? Error { get; }
-
-    /// <summary>
-    /// Gets the value or a default if the operation failed.
-    /// </summary>
-    /// <param name="defaultValue">The default value to return if the operation failed.</param>
-    /// <returns>The value if successful, otherwise the default value.</returns>
-    public T GetValueOrDefault(T defaultValue) => IsSuccess && Value is not null ? Value : defaultValue;
-
-    /// <inheritdoc/>
-    public override string ToString()
-        => IsSuccess ? $"Success: {Value}" : $"Failure: {Error}";
-
-    /// <summary>
-    /// Creates a successful result with the specified value.
-    /// </summary>
-    /// <param name="value">The result value.</param>
-    /// <returns>A successful SearchOperationResult.</returns>
-    [SuppressMessage("Design", "CA1000:Do not declare static members on generic types", Justification = "Factory method pattern is the idiomatic way to create instances of generic result types")]
-    public static SearchOperationResult<T> Success(T value) => new(true, value, null);
-
-    /// <summary>
-    /// Creates a failed result with the specified error.
-    /// </summary>
-    /// <param name="error">The error that caused the failure.</param>
-    /// <returns>A failed SearchOperationResult.</returns>
-    [SuppressMessage("Design", "CA1000:Do not declare static members on generic types", Justification = "Factory method pattern is the idiomatic way to create instances of generic result types")]
-    public static SearchOperationResult<T> Failure(SearchError error)
-    {
-        ArgumentNullException.ThrowIfNull(error);
-        return new SearchOperationResult<T>(false, default, error);
-    }
-
-    /// <summary>
-    /// Creates a failed result with the specified error and a fallback value.
-    /// </summary>
-    /// <param name="error">The error that caused the failure.</param>
-    /// <param name="fallbackValue">A fallback value to use despite the failure.</param>
-    /// <returns>A failed SearchOperationResult with a fallback value.</returns>
-    [SuppressMessage("Design", "CA1000:Do not declare static members on generic types", Justification = "Factory method pattern is the idiomatic way to create instances of generic result types")]
-    public static SearchOperationResult<T> FailureWithFallback(SearchError error, T fallbackValue)
-    {
-        ArgumentNullException.ThrowIfNull(error);
-        return new SearchOperationResult<T>(false, fallbackValue, error);
-    }
-}

src/common/Common.Search/SearchOptions.cs

@@ -1,35 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Options for configuring search behavior.
-/// </summary>
-public sealed class SearchOptions
-{
-    /// <summary>
-    /// Gets or sets the maximum number of results to return.
-    /// Default is 20.
-    /// </summary>
-    public int MaxResults { get; set; } = 20;
-
-    /// <summary>
-    /// Gets or sets the minimum score threshold.
-    /// Results below this score are filtered out.
-    /// Default is 0.0 (no filtering).
-    /// </summary>
-    public double MinScore { get; set; }
-
-    /// <summary>
-    /// Gets or sets the language hint for the search (e.g., "en-US").
-    /// </summary>
-    public string? Language { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether to include match spans for highlighting.
-    /// Default is false.
-    /// </summary>
-    public bool IncludeMatchSpans { get; set; }
-}

src/common/Common.Search/SearchResult`1.cs

@@ -1,33 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search;
-
-/// <summary>
-/// Represents a search result with the matched item and scoring information.
-/// </summary>
-/// <typeparam name="T">The type of the matched item.</typeparam>
-public sealed class SearchResult<T>
-    where T : ISearchable
-{
-    /// <summary>
-    /// Gets the matched item.
-    /// </summary>
-    public required T Item { get; init; }
-
-    /// <summary>
-    /// Gets the relevance score (higher is more relevant).
-    /// </summary>
-    public required double Score { get; init; }
-
-    /// <summary>
-    /// Gets the type of match that produced this result.
-    /// </summary>
-    public required SearchMatchKind MatchKind { get; init; }
-
-    /// <summary>
-    /// Gets the match details for highlighting (optional).
-    /// </summary>
-    public IReadOnlyList<MatchSpan>? MatchSpans { get; init; }
-}

src/common/Common.Search/SemanticSearch/SemanticSearchCapabilities.cs

@@ -1,46 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// Represents the capabilities of the semantic search index.
-/// </summary>
-public class SemanticSearchCapabilities
-{
-    /// <summary>
-    /// Gets or sets a value indicating whether text lexical (keyword) search is available.
-    /// </summary>
-    public bool TextLexicalAvailable { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether text semantic (AI embedding) search is available.
-    /// </summary>
-    public bool TextSemanticAvailable { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether image semantic search is available.
-    /// </summary>
-    public bool ImageSemanticAvailable { get; set; }
-
-    /// <summary>
-    /// Gets or sets a value indicating whether image OCR search is available.
-    /// </summary>
-    public bool ImageOcrAvailable { get; set; }
-
-    /// <summary>
-    /// Gets a value indicating whether any search capability is available.
-    /// </summary>
-    public bool AnyAvailable => TextLexicalAvailable || TextSemanticAvailable || ImageSemanticAvailable || ImageOcrAvailable;
-
-    /// <summary>
-    /// Gets a value indicating whether text search (lexical or semantic) is available.
-    /// </summary>
-    public bool TextSearchAvailable => TextLexicalAvailable || TextSemanticAvailable;
-
-    /// <summary>
-    /// Gets a value indicating whether image search (semantic or OCR) is available.
-    /// </summary>
-    public bool ImageSearchAvailable => ImageSemanticAvailable || ImageOcrAvailable;
-}

src/common/Common.Search/SemanticSearch/SemanticSearchContentKind.cs

@@ -1,21 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// Specifies the kind of content in a semantic search result.
-/// </summary>
-public enum SemanticSearchContentKind
-{
-    /// <summary>
-    /// Text content.
-    /// </summary>
-    Text,
-
-    /// <summary>
-    /// Image content.
-    /// </summary>
-    Image,
-}

src/common/Common.Search/SemanticSearch/SemanticSearchEngine`1.cs

@@ -1,406 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-using ManagedCommon;
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// A semantic search engine that implements the common search interface.
-/// </summary>
-/// <typeparam name="T">The type of items to search.</typeparam>
-public sealed class SemanticSearchEngine<T> : ISearchEngine<T>
-    where T : ISearchable
-{
-    private readonly SemanticSearchIndex _index;
-    private readonly Dictionary<string, T> _itemsById = new();
-    private readonly object _lockObject = new();
-    private bool _disposed;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="SemanticSearchEngine{T}"/> class.
-    /// </summary>
-    /// <param name="indexName">The name of the search index.</param>
-    public SemanticSearchEngine(string indexName)
-    {
-        Logger.LogDebug($"[SemanticSearchEngine] Creating engine. IndexName={indexName}, ItemType={typeof(T).Name}");
-        _index = new SemanticSearchIndex(indexName);
-    }
-
-    /// <inheritdoc/>
-    public bool IsReady => _index.IsInitialized;
-
-    /// <inheritdoc/>
-    public SearchEngineCapabilities Capabilities { get; } = new()
-    {
-        SupportsFuzzyMatch = true,
-        SupportsSemanticSearch = true,
-        PersistsIndex = true,
-        SupportsIncrementalIndex = true,
-        SupportsMatchSpans = false,
-    };
-
-    /// <summary>
-    /// Gets the underlying semantic search capabilities.
-    /// </summary>
-    public SemanticSearchCapabilities? SemanticCapabilities => _index.Capabilities;
-
-    /// <summary>
-    /// Gets the last error that occurred during a search operation, or null if no error occurred.
-    /// </summary>
-    public SearchError? LastError => _index.LastError;
-
-    /// <summary>
-    /// Occurs when the semantic search capabilities change.
-    /// </summary>
-    public event EventHandler<SemanticSearchCapabilities>? CapabilitiesChanged
-    {
-        add => _index.CapabilitiesChanged += value;
-        remove => _index.CapabilitiesChanged -= value;
-    }
-
-    /// <inheritdoc/>
-    public async Task InitializeAsync(CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-        Logger.LogInfo($"[SemanticSearchEngine] InitializeAsync starting. ItemType={typeof(T).Name}");
-        var result = await _index.InitializeAsync().ConfigureAwait(false);
-
-        if (result.IsFailure)
-        {
-            Logger.LogWarning($"[SemanticSearchEngine] InitializeAsync failed. ItemType={typeof(T).Name}, Error={result.Error?.Message}");
-        }
-        else
-        {
-            Logger.LogInfo($"[SemanticSearchEngine] InitializeAsync completed. ItemType={typeof(T).Name}");
-        }
-
-        // Note: We don't throw here to maintain backward compatibility,
-        // but callers can check LastError for details if initialization failed.
-    }
-
-    /// <summary>
-    /// Initializes the search engine and returns the result with error details if any.
-    /// </summary>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public async Task<SearchOperationResult> InitializeWithResultAsync(CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-        return await _index.InitializeAsync().ConfigureAwait(false);
-    }
-
-    /// <inheritdoc/>
-    public Task IndexAsync(T item, CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(item);
-        ThrowIfDisposed();
-
-        var text = BuildSearchableText(item);
-        if (string.IsNullOrWhiteSpace(text))
-        {
-            Logger.LogDebug($"[SemanticSearchEngine] IndexAsync skipped (empty text). Id={item.Id}");
-            return Task.CompletedTask;
-        }
-
-        lock (_lockObject)
-        {
-            _itemsById[item.Id] = item;
-        }
-
-        Logger.LogDebug($"[SemanticSearchEngine] IndexAsync. Id={item.Id}, TextLength={text.Length}");
-
-        // Note: Errors are captured in LastError for external logging
-        _ = _index.IndexText(item.Id, text);
-        return Task.CompletedTask;
-    }
-
-    /// <summary>
-    /// Indexes a single item and returns the result with error details if any.
-    /// </summary>
-    /// <param name="item">The item to index.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public Task<SearchOperationResult> IndexWithResultAsync(T item, CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(item);
-        ThrowIfDisposed();
-
-        var text = BuildSearchableText(item);
-        if (string.IsNullOrWhiteSpace(text))
-        {
-            return Task.FromResult(SearchOperationResult.Success());
-        }
-
-        lock (_lockObject)
-        {
-            _itemsById[item.Id] = item;
-        }
-
-        return Task.FromResult(_index.IndexText(item.Id, text));
-    }
-
-    /// <inheritdoc/>
-    public Task IndexBatchAsync(IEnumerable<T> items, CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(items);
-        ThrowIfDisposed();
-
-        var batch = new List<(string Id, string Text)>();
-
-        lock (_lockObject)
-        {
-            foreach (var item in items)
-            {
-                if (cancellationToken.IsCancellationRequested)
-                {
-                    Logger.LogDebug($"[SemanticSearchEngine] IndexBatchAsync cancelled. ItemsProcessed={batch.Count}");
-                    break;
-                }
-
-                var text = BuildSearchableText(item);
-                if (!string.IsNullOrWhiteSpace(text))
-                {
-                    _itemsById[item.Id] = item;
-                    batch.Add((item.Id, text));
-                }
-            }
-        }
-
-        Logger.LogInfo($"[SemanticSearchEngine] IndexBatchAsync. BatchSize={batch.Count}");
-
-        // Note: Errors are captured in LastError for external logging
-        _ = _index.IndexTextBatch(batch);
-        return Task.CompletedTask;
-    }
-
-    /// <summary>
-    /// Indexes multiple items in batch and returns the result with error details if any.
-    /// </summary>
-    /// <param name="items">The items to index.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public Task<SearchOperationResult> IndexBatchWithResultAsync(IEnumerable<T> items, CancellationToken cancellationToken = default)
-    {
-        ArgumentNullException.ThrowIfNull(items);
-        ThrowIfDisposed();
-
-        var batch = new List<(string Id, string Text)>();
-
-        lock (_lockObject)
-        {
-            foreach (var item in items)
-            {
-                if (cancellationToken.IsCancellationRequested)
-                {
-                    break;
-                }
-
-                var text = BuildSearchableText(item);
-                if (!string.IsNullOrWhiteSpace(text))
-                {
-                    _itemsById[item.Id] = item;
-                    batch.Add((item.Id, text));
-                }
-            }
-        }
-
-        return Task.FromResult(_index.IndexTextBatch(batch));
-    }
-
-    /// <inheritdoc/>
-    public Task RemoveAsync(string id, CancellationToken cancellationToken = default)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(id);
-        ThrowIfDisposed();
-
-        lock (_lockObject)
-        {
-            _itemsById.Remove(id);
-        }
-
-        Logger.LogDebug($"[SemanticSearchEngine] RemoveAsync. Id={id}");
-
-        // Note: Errors are captured in LastError for external logging
-        _ = _index.Remove(id);
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task ClearAsync(CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-
-        int count;
-        lock (_lockObject)
-        {
-            count = _itemsById.Count;
-            _itemsById.Clear();
-        }
-
-        Logger.LogInfo($"[SemanticSearchEngine] ClearAsync. ItemsCleared={count}");
-
-        // Note: Errors are captured in LastError for external logging
-        _ = _index.RemoveAll();
-        return Task.CompletedTask;
-    }
-
-    /// <inheritdoc/>
-    public Task<IReadOnlyList<SearchResult<T>>> SearchAsync(
-        string query,
-        SearchOptions? options = null,
-        CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-
-        if (string.IsNullOrWhiteSpace(query))
-        {
-            Logger.LogDebug($"[SemanticSearchEngine] SearchAsync skipped (empty query).");
-            return Task.FromResult<IReadOnlyList<SearchResult<T>>>(Array.Empty<SearchResult<T>>());
-        }
-
-        options ??= new SearchOptions();
-        Logger.LogDebug($"[SemanticSearchEngine] SearchAsync starting. Query={query}, MaxResults={options.MaxResults}");
-
-        var semanticOptions = new SemanticSearchOptions
-        {
-            MaxResults = options.MaxResults,
-            Language = options.Language,
-            MatchScope = SemanticSearchMatchScope.Unconstrained,
-            TextMatchType = SemanticSearchTextMatchType.Fuzzy,
-        };
-
-        var searchResult = _index.SearchText(query, semanticOptions);
-
-        // Note: Errors are captured in LastError for external logging
-        var matches = searchResult.Value ?? Array.Empty<SemanticSearchResult>();
-        var results = new List<SearchResult<T>>();
-
-        lock (_lockObject)
-        {
-            foreach (var match in matches)
-            {
-                if (_itemsById.TryGetValue(match.ContentId, out var item))
-                {
-                    results.Add(new SearchResult<T>
-                    {
-                        Item = item,
-                        Score = 100.0, // Semantic search doesn't return scores, use fixed value
-                        MatchKind = SearchMatchKind.Semantic,
-                        MatchSpans = null,
-                    });
-                }
-            }
-        }
-
-        Logger.LogDebug($"[SemanticSearchEngine] SearchAsync completed. Query={query}, Matches={matches.Count}, Results={results.Count}");
-        return Task.FromResult<IReadOnlyList<SearchResult<T>>>(results);
-    }
-
-    /// <summary>
-    /// Searches for items matching the query and returns the result with error details if any.
-    /// </summary>
-    /// <param name="query">The search query.</param>
-    /// <param name="options">Optional search options.</param>
-    /// <param name="cancellationToken">Cancellation token.</param>
-    /// <returns>A result containing search results or error details.</returns>
-    public Task<SearchOperationResult<IReadOnlyList<SearchResult<T>>>> SearchWithResultAsync(
-        string query,
-        SearchOptions? options = null,
-        CancellationToken cancellationToken = default)
-    {
-        ThrowIfDisposed();
-
-        if (string.IsNullOrWhiteSpace(query))
-        {
-            return Task.FromResult(SearchOperationResult<IReadOnlyList<SearchResult<T>>>.Success(Array.Empty<SearchResult<T>>()));
-        }
-
-        options ??= new SearchOptions();
-
-        var semanticOptions = new SemanticSearchOptions
-        {
-            MaxResults = options.MaxResults,
-            Language = options.Language,
-            MatchScope = SemanticSearchMatchScope.Unconstrained,
-            TextMatchType = SemanticSearchTextMatchType.Fuzzy,
-        };
-
-        var searchResult = _index.SearchText(query, semanticOptions);
-        var matches = searchResult.Value ?? Array.Empty<SemanticSearchResult>();
-        var results = new List<SearchResult<T>>();
-
-        lock (_lockObject)
-        {
-            foreach (var match in matches)
-            {
-                if (_itemsById.TryGetValue(match.ContentId, out var item))
-                {
-                    results.Add(new SearchResult<T>
-                    {
-                        Item = item,
-                        Score = 100.0,
-                        MatchKind = SearchMatchKind.Semantic,
-                        MatchSpans = null,
-                    });
-                }
-            }
-        }
-
-        if (searchResult.IsFailure)
-        {
-            return Task.FromResult(SearchOperationResult<IReadOnlyList<SearchResult<T>>>.FailureWithFallback(searchResult.Error!, results));
-        }
-
-        return Task.FromResult(SearchOperationResult<IReadOnlyList<SearchResult<T>>>.Success(results));
-    }
-
-    /// <summary>
-    /// Waits for the indexing process to complete.
-    /// </summary>
-    /// <param name="timeout">The maximum time to wait.</param>
-    /// <returns>A task representing the async operation.</returns>
-    public async Task WaitForIndexingCompleteAsync(TimeSpan timeout)
-    {
-        ThrowIfDisposed();
-        await _index.WaitForIndexingCompleteAsync(timeout).ConfigureAwait(false);
-    }
-
-    /// <inheritdoc/>
-    public void Dispose()
-    {
-        if (_disposed)
-        {
-            return;
-        }
-
-        Logger.LogDebug($"[SemanticSearchEngine] Disposing. ItemType={typeof(T).Name}");
-        _index.Dispose();
-
-        lock (_lockObject)
-        {
-            _itemsById.Clear();
-        }
-
-        _disposed = true;
-    }
-
-    private static string BuildSearchableText(T item)
-    {
-        var primary = item.SearchableText ?? string.Empty;
-        var secondary = item.SecondarySearchableText;
-
-        if (string.IsNullOrWhiteSpace(secondary))
-        {
-            return primary;
-        }
-
-        return $"{primary} {secondary}";
-    }
-
-    private void ThrowIfDisposed()
-    {
-        ObjectDisposedException.ThrowIf(_disposed, this);
-    }
-}

src/common/Common.Search/SemanticSearch/SemanticSearchIndex.cs

@@ -1,455 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-using ManagedCommon;
-using Microsoft.Windows.Search.AppContentIndex;
-using Windows.Graphics.Imaging;
-using SearchOperationResult = Common.Search.SearchOperationResult;
-using SearchOperationResultT = Common.Search.SearchOperationResult<System.Collections.Generic.IReadOnlyList<Common.Search.SemanticSearch.SemanticSearchResult>>;
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// A semantic search engine powered by Windows App SDK AI Search APIs.
-/// Provides text and image indexing with lexical and semantic search capabilities.
-/// </summary>
-public sealed class SemanticSearchIndex : IDisposable
-{
-    private readonly string _indexName;
-    private AppContentIndexer? _indexer;
-    private bool _disposed;
-    private SemanticSearchCapabilities? _capabilities;
-
-    /// <summary>
-    /// Initializes a new instance of the <see cref="SemanticSearchIndex"/> class.
-    /// </summary>
-    /// <param name="indexName">The name of the search index.</param>
-    public SemanticSearchIndex(string indexName)
-    {
-        ArgumentException.ThrowIfNullOrWhiteSpace(indexName);
-        _indexName = indexName;
-    }
-
-    /// <summary>
-    /// Gets the last error that occurred during an operation, or null if no error occurred.
-    /// </summary>
-    public SearchError? LastError { get; private set; }
-
-    /// <summary>
-    /// Occurs when the index capabilities change.
-    /// </summary>
-    public event EventHandler<SemanticSearchCapabilities>? CapabilitiesChanged;
-
-    /// <summary>
-    /// Gets a value indicating whether the search engine is initialized.
-    /// </summary>
-    public bool IsInitialized => _indexer != null;
-
-    /// <summary>
-    /// Gets the current index capabilities, or null if not initialized.
-    /// </summary>
-    public SemanticSearchCapabilities? Capabilities => _capabilities;
-
-    /// <summary>
-    /// Initializes the search engine and creates or opens the index.
-    /// </summary>
-    /// <returns>A task that represents the asynchronous operation. Returns a result indicating success or failure with error details.</returns>
-    public async Task<SearchOperationResult> InitializeAsync()
-    {
-        ThrowIfDisposed();
-        LastError = null;
-
-        if (_indexer != null)
-        {
-            Logger.LogDebug($"[SemanticSearchIndex] Already initialized. IndexName={_indexName}");
-            return SearchOperationResult.Success();
-        }
-
-        Logger.LogInfo($"[SemanticSearchIndex] Initializing. IndexName={_indexName}");
-
-        try
-        {
-            var result = AppContentIndexer.GetOrCreateIndex(_indexName);
-            if (!result.Succeeded)
-            {
-                var errorDetails = $"Succeeded={result.Succeeded}, ExtendedError={result.ExtendedError}";
-                Logger.LogError($"[SemanticSearchIndex] GetOrCreateIndex failed. IndexName={_indexName}, {errorDetails}");
-                LastError = SearchError.InitializationFailed(_indexName, errorDetails);
-                return SearchOperationResult.Failure(LastError);
-            }
-
-            _indexer = result.Indexer;
-
-            // Wait for index capabilities to be ready
-            Logger.LogDebug($"[SemanticSearchIndex] Waiting for index capabilities. IndexName={_indexName}");
-            await _indexer.WaitForIndexCapabilitiesAsync();
-
-            // Load capabilities
-            _capabilities = LoadCapabilities();
-            Logger.LogInfo($"[SemanticSearchIndex] Initialized successfully. IndexName={_indexName}, TextLexical={_capabilities.TextLexicalAvailable}, TextSemantic={_capabilities.TextSemanticAvailable}, ImageSemantic={_capabilities.ImageSemanticAvailable}, ImageOcr={_capabilities.ImageOcrAvailable}");
-
-            // Subscribe to capability changes
-            _indexer.Listener.IndexCapabilitiesChanged += OnIndexCapabilitiesChanged;
-
-            return SearchOperationResult.Success();
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] Initialization failed with exception. IndexName={_indexName}", ex);
-            LastError = SearchError.InitializationFailed(_indexName, ex.Message, ex);
-            return SearchOperationResult.Failure(LastError);
-        }
-    }
-
-    /// <summary>
-    /// Waits for the indexing process to complete.
-    /// </summary>
-    /// <param name="timeout">The maximum time to wait for indexing to complete.</param>
-    /// <returns>A task that represents the asynchronous operation.</returns>
-    public async Task WaitForIndexingCompleteAsync(TimeSpan timeout)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-
-        await _indexer!.WaitForIndexingIdleAsync(timeout);
-    }
-
-    /// <summary>
-    /// Gets the current index capabilities.
-    /// </summary>
-    /// <returns>The current capabilities of the search index.</returns>
-    public SemanticSearchCapabilities GetCapabilities()
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-
-        return _capabilities ?? LoadCapabilities();
-    }
-
-    /// <summary>
-    /// Adds or updates text content in the index.
-    /// </summary>
-    /// <param name="id">The unique identifier for the content.</param>
-    /// <param name="text">The text content to index.</param>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public SearchOperationResult IndexText(string id, string text)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-        ArgumentException.ThrowIfNullOrWhiteSpace(id);
-        ArgumentException.ThrowIfNullOrWhiteSpace(text);
-
-        try
-        {
-            var content = AppManagedIndexableAppContent.CreateFromString(id, text);
-            _indexer!.AddOrUpdate(content);
-            return SearchOperationResult.Success();
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] IndexText failed. Id={id}", ex);
-            LastError = SearchError.IndexingFailed(id, ex.Message, ex);
-            return SearchOperationResult.Failure(LastError);
-        }
-    }
-
-    /// <summary>
-    /// Adds or updates multiple text contents in the index.
-    /// </summary>
-    /// <param name="items">A collection of id-text pairs to index.</param>
-    /// <returns>A result indicating success or failure with error details. Contains the first error encountered if any.</returns>
-    public SearchOperationResult IndexTextBatch(IEnumerable<(string Id, string Text)> items)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-        ArgumentNullException.ThrowIfNull(items);
-
-        SearchError? firstError = null;
-
-        foreach (var (id, text) in items)
-        {
-            if (!string.IsNullOrWhiteSpace(id) && !string.IsNullOrWhiteSpace(text))
-            {
-                try
-                {
-                    var content = AppManagedIndexableAppContent.CreateFromString(id, text);
-                    _indexer!.AddOrUpdate(content);
-                }
-                catch (Exception ex)
-                {
-                    Logger.LogError($"[SemanticSearchIndex] IndexTextBatch item failed. Id={id}", ex);
-                    firstError ??= SearchError.IndexingFailed(id, ex.Message, ex);
-                }
-            }
-        }
-
-        if (firstError != null)
-        {
-            LastError = firstError;
-            return SearchOperationResult.Failure(firstError);
-        }
-
-        return SearchOperationResult.Success();
-    }
-
-    /// <summary>
-    /// Adds or updates image content in the index.
-    /// </summary>
-    /// <param name="id">The unique identifier for the image.</param>
-    /// <param name="bitmap">The image bitmap to index.</param>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public SearchOperationResult IndexImage(string id, SoftwareBitmap bitmap)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-        ArgumentException.ThrowIfNullOrWhiteSpace(id);
-        ArgumentNullException.ThrowIfNull(bitmap);
-
-        try
-        {
-            var content = AppManagedIndexableAppContent.CreateFromBitmap(id, bitmap);
-            _indexer!.AddOrUpdate(content);
-            return SearchOperationResult.Success();
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] IndexImage failed. Id={id}", ex);
-            LastError = SearchError.IndexingFailed(id, ex.Message, ex);
-            return SearchOperationResult.Failure(LastError);
-        }
-    }
-
-    /// <summary>
-    /// Removes content from the index by its identifier.
-    /// </summary>
-    /// <param name="id">The unique identifier of the content to remove.</param>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public SearchOperationResult Remove(string id)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-        ArgumentException.ThrowIfNullOrWhiteSpace(id);
-
-        try
-        {
-            _indexer!.Remove(id);
-            return SearchOperationResult.Success();
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] Remove failed. Id={id}", ex);
-            LastError = SearchError.Unexpected("Remove", ex);
-            return SearchOperationResult.Failure(LastError);
-        }
-    }
-
-    /// <summary>
-    /// Removes all content from the index.
-    /// </summary>
-    /// <returns>A result indicating success or failure with error details.</returns>
-    public SearchOperationResult RemoveAll()
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-
-        try
-        {
-            _indexer!.RemoveAll();
-            return SearchOperationResult.Success();
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] RemoveAll failed.", ex);
-            LastError = SearchError.Unexpected("RemoveAll", ex);
-            return SearchOperationResult.Failure(LastError);
-        }
-    }
-
-    /// <summary>
-    /// Searches for text content in the index.
-    /// </summary>
-    /// <param name="searchText">The text to search for.</param>
-    /// <param name="options">Optional search options.</param>
-    /// <returns>A result containing search results or error details.</returns>
-    public SearchOperationResultT SearchText(string searchText, SemanticSearchOptions? options = null)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-        ArgumentException.ThrowIfNullOrWhiteSpace(searchText);
-
-        options ??= new SemanticSearchOptions();
-
-        try
-        {
-            var queryOptions = new TextQueryOptions
-            {
-                MatchScope = ConvertMatchScope(options.MatchScope),
-                TextMatchType = ConvertTextMatchType(options.TextMatchType),
-            };
-
-            if (!string.IsNullOrEmpty(options.Language))
-            {
-                queryOptions.Language = options.Language;
-            }
-
-            var query = _indexer!.CreateTextQuery(searchText, queryOptions);
-            var matches = query.GetNextMatches(options.MaxResults);
-
-            return SearchOperationResultT.Success(ConvertTextMatches(matches));
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] SearchText failed. Query={searchText}", ex);
-            LastError = SearchError.SearchFailed(searchText, ex.Message, ex);
-            return SearchOperationResultT.FailureWithFallback(LastError, Array.Empty<SemanticSearchResult>());
-        }
-    }
-
-    /// <summary>
-    /// Searches for image content in the index using text.
-    /// </summary>
-    /// <param name="searchText">The text to search for in images.</param>
-    /// <param name="options">Optional search options.</param>
-    /// <returns>A result containing search results or error details.</returns>
-    public SearchOperationResultT SearchImages(string searchText, SemanticSearchOptions? options = null)
-    {
-        ThrowIfDisposed();
-        ThrowIfNotInitialized();
-        ArgumentException.ThrowIfNullOrWhiteSpace(searchText);
-
-        options ??= new SemanticSearchOptions();
-
-        try
-        {
-            var queryOptions = new ImageQueryOptions
-            {
-                MatchScope = ConvertMatchScope(options.MatchScope),
-                ImageOcrTextMatchType = ConvertTextMatchType(options.TextMatchType),
-            };
-
-            var query = _indexer!.CreateImageQuery(searchText, queryOptions);
-            var matches = query.GetNextMatches(options.MaxResults);
-
-            return SearchOperationResultT.Success(ConvertImageMatches(matches));
-        }
-        catch (Exception ex)
-        {
-            Logger.LogError($"[SemanticSearchIndex] SearchImages failed. Query={searchText}", ex);
-            LastError = SearchError.SearchFailed(searchText, ex.Message, ex);
-            return SearchOperationResultT.FailureWithFallback(LastError, Array.Empty<SemanticSearchResult>());
-        }
-    }
-
-    /// <inheritdoc/>
-    public void Dispose()
-    {
-        if (_disposed)
-        {
-            return;
-        }
-
-        if (_indexer != null)
-        {
-            _indexer.Listener.IndexCapabilitiesChanged -= OnIndexCapabilitiesChanged;
-            _indexer.Dispose();
-            _indexer = null;
-        }
-
-        _disposed = true;
-    }
-
-    private SemanticSearchCapabilities LoadCapabilities()
-    {
-        var capabilities = _indexer!.GetIndexCapabilities();
-
-        return new SemanticSearchCapabilities
-        {
-            TextLexicalAvailable = IsCapabilityInitialized(capabilities, IndexCapability.TextLexical),
-            TextSemanticAvailable = IsCapabilityInitialized(capabilities, IndexCapability.TextSemantic),
-            ImageSemanticAvailable = IsCapabilityInitialized(capabilities, IndexCapability.ImageSemantic),
-            ImageOcrAvailable = IsCapabilityInitialized(capabilities, IndexCapability.ImageOcr),
-        };
-    }
-
-    private static bool IsCapabilityInitialized(IndexCapabilities capabilities, IndexCapability capability)
-    {
-        var state = capabilities.GetCapabilityState(capability);
-        return state.InitializationStatus == IndexCapabilityInitializationStatus.Initialized;
-    }
-
-    private void OnIndexCapabilitiesChanged(AppContentIndexer indexer, IndexCapabilities capabilities)
-    {
-        _capabilities = LoadCapabilities();
-        Logger.LogInfo($"[SemanticSearchIndex] Capabilities changed. IndexName={_indexName}, TextLexical={_capabilities.TextLexicalAvailable}, TextSemantic={_capabilities.TextSemanticAvailable}, ImageSemantic={_capabilities.ImageSemanticAvailable}, ImageOcr={_capabilities.ImageOcrAvailable}");
-        CapabilitiesChanged?.Invoke(this, _capabilities);
-    }
-
-    private static QueryMatchScope ConvertMatchScope(SemanticSearchMatchScope scope)
-    {
-        return scope switch
-        {
-            SemanticSearchMatchScope.Unconstrained => QueryMatchScope.Unconstrained,
-            SemanticSearchMatchScope.Region => QueryMatchScope.Region,
-            SemanticSearchMatchScope.ContentItem => QueryMatchScope.ContentItem,
-            _ => QueryMatchScope.Unconstrained,
-        };
-    }
-
-    private static TextLexicalMatchType ConvertTextMatchType(SemanticSearchTextMatchType matchType)
-    {
-        return matchType switch
-        {
-            SemanticSearchTextMatchType.Fuzzy => TextLexicalMatchType.Fuzzy,
-            SemanticSearchTextMatchType.Exact => TextLexicalMatchType.Exact,
-            _ => TextLexicalMatchType.Fuzzy,
-        };
-    }
-
-    private static IReadOnlyList<SemanticSearchResult> ConvertTextMatches(IReadOnlyList<TextQueryMatch> matches)
-    {
-        var results = new List<SemanticSearchResult>();
-
-        foreach (var match in matches)
-        {
-            var result = new SemanticSearchResult(match.ContentId, SemanticSearchContentKind.Text);
-
-            if (match.ContentKind == QueryMatchContentKind.AppManagedText &&
-                match is AppManagedTextQueryMatch textMatch)
-            {
-                result.TextOffset = textMatch.TextOffset;
-                result.TextLength = textMatch.TextLength;
-            }
-
-            results.Add(result);
-        }
-
-        return results;
-    }
-
-    private static IReadOnlyList<SemanticSearchResult> ConvertImageMatches(IReadOnlyList<ImageQueryMatch> matches)
-    {
-        var results = new List<SemanticSearchResult>();
-
-        foreach (var match in matches)
-        {
-            var result = new SemanticSearchResult(match.ContentId, SemanticSearchContentKind.Image);
-            results.Add(result);
-        }
-
-        return results;
-    }
-
-    private void ThrowIfDisposed()
-    {
-        ObjectDisposedException.ThrowIf(_disposed, this);
-    }
-
-    private void ThrowIfNotInitialized()
-    {
-        if (_indexer == null)
-        {
-            throw new InvalidOperationException("Search engine is not initialized. Call InitializeAsync() first.");
-        }
-    }
-}

src/common/Common.Search/SemanticSearch/SemanticSearchMatchScope.cs

@@ -1,26 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// Specifies the scope for semantic search matching.
-/// </summary>
-public enum SemanticSearchMatchScope
-{
-    /// <summary>
-    /// No constraints, uses both Lexical and Semantic matching.
-    /// </summary>
-    Unconstrained,
-
-    /// <summary>
-    /// Restrict matching to a specific region.
-    /// </summary>
-    Region,
-
-    /// <summary>
-    /// Restrict matching to a single content item.
-    /// </summary>
-    ContentItem,
-}

src/common/Common.Search/SemanticSearch/SemanticSearchOptions.cs

@@ -1,31 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// Options for configuring semantic search queries.
-/// </summary>
-public class SemanticSearchOptions
-{
-    /// <summary>
-    /// Gets or sets the language for the search query (e.g., "en-US").
-    /// </summary>
-    public string? Language { get; set; }
-
-    /// <summary>
-    /// Gets or sets the match scope for the search.
-    /// </summary>
-    public SemanticSearchMatchScope MatchScope { get; set; } = SemanticSearchMatchScope.Unconstrained;
-
-    /// <summary>
-    /// Gets or sets the text match type for lexical matching.
-    /// </summary>
-    public SemanticSearchTextMatchType TextMatchType { get; set; } = SemanticSearchTextMatchType.Fuzzy;
-
-    /// <summary>
-    /// Gets or sets the maximum number of results to return.
-    /// </summary>
-    public int MaxResults { get; set; } = 10;
-}

src/common/Common.Search/SemanticSearch/SemanticSearchResult.cs

@@ -1,42 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// Represents a search result from the semantic search engine.
-/// </summary>
-public class SemanticSearchResult
-{
-    /// <summary>
-    /// Initializes a new instance of the <see cref="SemanticSearchResult"/> class.
-    /// </summary>
-    /// <param name="contentId">The unique identifier of the matched content.</param>
-    /// <param name="contentKind">The kind of content matched (text or image).</param>
-    public SemanticSearchResult(string contentId, SemanticSearchContentKind contentKind)
-    {
-        ContentId = contentId;
-        ContentKind = contentKind;
-    }
-
-    /// <summary>
-    /// Gets the unique identifier of the matched content.
-    /// </summary>
-    public string ContentId { get; }
-
-    /// <summary>
-    /// Gets the kind of content that was matched.
-    /// </summary>
-    public SemanticSearchContentKind ContentKind { get; }
-
-    /// <summary>
-    /// Gets or sets the text offset where the match was found (for text matches only).
-    /// </summary>
-    public int TextOffset { get; set; }
-
-    /// <summary>
-    /// Gets or sets the length of the matched text (for text matches only).
-    /// </summary>
-    public int TextLength { get; set; }
-}

src/common/Common.Search/SemanticSearch/SemanticSearchTextMatchType.cs

@@ -1,21 +0,0 @@
-// Copyright (c) Microsoft Corporation
-// The Microsoft Corporation licenses this file to you under the MIT license.
-// See the LICENSE file in the project root for more information.
-
-namespace Common.Search.SemanticSearch;
-
-/// <summary>
-/// Specifies the type of text matching for lexical searches.
-/// </summary>
-public enum SemanticSearchTextMatchType
-{
-    /// <summary>
-    /// Fuzzy matching allows spelling errors and approximate words.
-    /// </summary>
-    Fuzzy,
-
-    /// <summary>
-    /// Exact matching requires exact text matches.
-    /// </summary>
-    Exact,
-}

src/common/Themes/theme_listener.cpp

@@ -16,50 +16,13 @@ DWORD WINAPI _checkTheme(LPVOID lpParam)
 
 void ThemeListener::AddChangedHandler(THEME_HANDLE handle)
 {
-    std::lock_guard<std::mutex> lock(handlesMutex);
     handles.push_back(handle);
 }
 
 void ThemeListener::DelChangedHandler(THEME_HANDLE handle)
 {
-    std::lock_guard<std::mutex> lock(handlesMutex);
     auto it = std::find(handles.begin(), handles.end(), handle);
-    if (it != handles.end())
-    {
-        handles.erase(it);
-    }
-}
-
-void ThemeListener::AddAppThemeChangedHandler(THEME_HANDLE handle)
-{
-    std::lock_guard<std::mutex> lock(handlesMutex);
-    appThemeHandles.push_back(handle);
-}
-
-void ThemeListener::DelAppThemeChangedHandler(THEME_HANDLE handle)
-{
-    std::lock_guard<std::mutex> lock(handlesMutex);
-    auto it = std::find(appThemeHandles.begin(), appThemeHandles.end(), handle);
-    if (it != appThemeHandles.end())
-    {
-        appThemeHandles.erase(it);
-    }
-}
-
-void ThemeListener::AddSystemThemeChangedHandler(THEME_HANDLE handle)
-{
-    std::lock_guard<std::mutex> lock(handlesMutex);
-    systemThemeHandles.push_back(handle);
-}
-
-void ThemeListener::DelSystemThemeChangedHandler(THEME_HANDLE handle)
-{
-    std::lock_guard<std::mutex> lock(handlesMutex);
-    auto it = std::find(systemThemeHandles.begin(), systemThemeHandles.end(), handle);
-    if (it != systemThemeHandles.end())
-    {
-        systemThemeHandles.erase(it);
-    }
+    handles.erase(it);
 }
 
 void ThemeListener::CheckTheme()
@@ -85,51 +48,13 @@ void ThemeListener::CheckTheme()
 
             WaitForSingleObject(hEvent, INFINITE);
 
-            auto _appTheme = ThemeHelpers::GetAppTheme();
-            auto _systemTheme = ThemeHelpers::GetSystemTheme();
-            
-            bool appThemeChanged = (AppTheme != _appTheme);
-            bool systemThemeChanged = (SystemTheme != _systemTheme);
-            
-            if (appThemeChanged || systemThemeChanged)
+            auto _theme = ThemeHelpers::GetAppTheme();
+            if (AppTheme != _theme)
             {
-                AppTheme = _appTheme;
-                SystemTheme = _systemTheme;
-                
-                // Copy handlers under lock, then invoke outside lock to avoid deadlock
-                std::vector<THEME_HANDLE> handlesCopy;
-                std::vector<THEME_HANDLE> appThemeHandlesCopy;
-                std::vector<THEME_HANDLE> systemThemeHandlesCopy;
-                
+                AppTheme = _theme;
+                for (int i = 0; i < handles.size(); i++)
                 {
-                    std::lock_guard<std::mutex> lock(handlesMutex);
-                    handlesCopy = handles;
-                    if (appThemeChanged)
-                    {
-                        appThemeHandlesCopy = appThemeHandles;
-                    }
-                    if (systemThemeChanged)
-                    {
-                        systemThemeHandlesCopy = systemThemeHandles;
-                    }
-                }
-                
-                // Call generic handlers (backward compatible)
-                for (const auto& handler : handlesCopy)
-                {
-                    handler();
-                }
-                
-                // Call app theme specific handlers
-                for (const auto& handler : appThemeHandlesCopy)
-                {
-                    handler();
-                }
-                
-                // Call system theme specific handlers
-                for (const auto& handler : systemThemeHandlesCopy)
-                {
-                    handler();
+                    handles[i]();
                 }
             }
         }

src/common/Themes/theme_listener.h

@@ -3,7 +3,6 @@
 #include <windows.h>
 #include <iostream>
 #include <vector>
-#include <mutex>
 
 typedef void (*THEME_HANDLE)();
 DWORD WINAPI _checkTheme(LPVOID lpParam);
@@ -15,7 +14,6 @@ public:
     ThemeListener()
     {
         AppTheme = ThemeHelpers::GetAppTheme();
-        SystemTheme = ThemeHelpers::GetSystemTheme();
         dwThreadHandle = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)_checkTheme, this, 0, &dwThreadId);
     }
     ~ThemeListener()
@@ -25,20 +23,12 @@ public:
     }
 
     Theme AppTheme;
-    Theme SystemTheme;
     void ThemeListener::AddChangedHandler(THEME_HANDLE handle);
     void ThemeListener::DelChangedHandler(THEME_HANDLE handle);
-    void ThemeListener::AddAppThemeChangedHandler(THEME_HANDLE handle);
-    void ThemeListener::DelAppThemeChangedHandler(THEME_HANDLE handle);
-    void ThemeListener::AddSystemThemeChangedHandler(THEME_HANDLE handle);
-    void ThemeListener::DelSystemThemeChangedHandler(THEME_HANDLE handle);
     void CheckTheme();
 
 private:
     HANDLE dwThreadHandle;
     DWORD dwThreadId;
     std::vector<THEME_HANDLE> handles;
-    std::vector<THEME_HANDLE> appThemeHandles;
-    std::vector<THEME_HANDLE> systemThemeHandles;
-    mutable std::mutex handlesMutex;
 };

src/common/utils/package.h

@@ -2,7 +2,6 @@
 
 #include <Windows.h>
 
-#include <algorithm>
 #include <appxpackaging.h>
 #include <exception>
 #include <filesystem>
@@ -338,30 +337,6 @@ namespace package
                     }
                 }
             }
-
-            // Sort by package version in descending order (newest first)
-            std::sort(matchedFiles.begin(), matchedFiles.end(), [](const std::wstring& a, const std::wstring& b) {
-                std::wstring nameA, nameB;
-                PACKAGE_VERSION versionA{}, versionB{};
-
-                bool gotA = GetPackageNameAndVersionFromAppx(a, nameA, versionA);
-                bool gotB = GetPackageNameAndVersionFromAppx(b, nameB, versionB);
-
-                // Files that failed to parse go to the end
-                if (!gotA)
-                    return false;
-                if (!gotB)
-                    return true;
-
-                // Compare versions: Major, Minor, Build, Revision (descending)
-                if (versionA.Major != versionB.Major)
-                    return versionA.Major > versionB.Major;
-                if (versionA.Minor != versionB.Minor)
-                    return versionA.Minor > versionB.Minor;
-                if (versionA.Build != versionB.Build)
-                    return versionA.Build > versionB.Build;
-                return versionA.Revision > versionB.Revision;
-            });
         }
         catch (const std::exception& ex)
         {

src/modules/Hosts/Hosts.UITests/HostsSettingTests.cs

@@ -113,7 +113,7 @@ namespace Hosts.UITests
 
             this.Find<NavigationViewItem>("Hosts File Editor").Click();
 
-            this.Find<ToggleSwitch>("Hosts File Editor").Toggle(true);
+            this.Find<ToggleSwitch>("Enable Hosts File Editor").Toggle(true);
             this.Find<ToggleSwitch>("Launch as administrator").Toggle(launchAsAdmin);
             this.Find<ToggleSwitch>("Show a warning at startup").Toggle(showWarning);
 

src/modules/LightSwitch/LightSwitchLib/LightSwitchLib.vcxproj

@@ -1,123 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <Import Project="..\..\..\..\packages\Microsoft.Windows.CppWinRT.2.0.240111.5\build\native\Microsoft.Windows.CppWinRT.props" Condition="Exists('..\..\..\..\packages\Microsoft.Windows.CppWinRT.2.0.240111.5\build\native\Microsoft.Windows.CppWinRT.props')" />
-  <ItemGroup Label="ProjectConfigurations">
-    <ProjectConfiguration Include="Debug|x64">
-      <Configuration>Debug</Configuration>
-      <Platform>x64</Platform>
-    </ProjectConfiguration>
-    <ProjectConfiguration Include="Release|x64">
-      <Configuration>Release</Configuration>
-      <Platform>x64</Platform>
-    </ProjectConfiguration>
-    <ProjectConfiguration Include="Debug|ARM64">
-      <Configuration>Debug</Configuration>
-      <Platform>ARM64</Platform>
-    </ProjectConfiguration>
-    <ProjectConfiguration Include="Release|ARM64">
-      <Configuration>Release</Configuration>
-      <Platform>ARM64</Platform>
-    </ProjectConfiguration>
-  </ItemGroup>
-  <PropertyGroup Label="Globals">
-    <VCProjectVersion>17.0</VCProjectVersion>
-    <Keyword>Win32Proj</Keyword>
-    <ProjectGuid>{79267138-2895-4346-9021-21408d65379f}</ProjectGuid>
-    <RootNamespace>LightSwitchLib</RootNamespace>
-    <WindowsTargetPlatformVersion>10.0.26100.0</WindowsTargetPlatformVersion>
-    <ProjectName>LightSwitchLib</ProjectName>
-  </PropertyGroup>
-  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Default.props" />
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration">
-    <ConfigurationType>StaticLibrary</ConfigurationType>
-    <UseDebugLibraries>true</UseDebugLibraries>
-    <PlatformToolset>v143</PlatformToolset>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'" Label="Configuration">
-    <ConfigurationType>StaticLibrary</ConfigurationType>
-    <UseDebugLibraries>false</UseDebugLibraries>
-    <PlatformToolset>v143</PlatformToolset>
-    <WholeProgramOptimization>true</WholeProgramOptimization>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|ARM64'" Label="Configuration">
-    <ConfigurationType>StaticLibrary</ConfigurationType>
-    <UseDebugLibraries>true</UseDebugLibraries>
-    <PlatformToolset>v143</PlatformToolset>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|ARM64'" Label="Configuration">
-    <ConfigurationType>StaticLibrary</ConfigurationType>
-    <UseDebugLibraries>false</UseDebugLibraries>
-    <PlatformToolset>v143</PlatformToolset>
-    <WholeProgramOptimization>true</WholeProgramOptimization>
-    <CharacterSet>Unicode</CharacterSet>
-  </PropertyGroup>
-  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
-  <ImportGroup Label="ExtensionSettings">
-  </ImportGroup>
-  <ImportGroup Label="Shared">
-  </ImportGroup>
-  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-  </ImportGroup>
-  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-  </ImportGroup>
-  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Debug|ARM64'">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-  </ImportGroup>
-  <ImportGroup Label="PropertySheets" Condition="'$(Configuration)|$(Platform)'=='Release|ARM64'">
-    <Import Project="$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props" Condition="exists('$(UserRootDir)\Microsoft.Cpp.$(Platform).user.props')" Label="LocalAppDataPlatform" />
-  </ImportGroup>
-  <PropertyGroup Label="UserMacros" />
-  <PropertyGroup>
-    <OutDir>..\..\..\..\$(Platform)\$(Configuration)\$(MSBuildProjectName)\</OutDir>
-  </PropertyGroup>
-  <ItemDefinitionGroup>
-    <ClCompile>
-      <WarningLevel>Level3</WarningLevel>
-      <SDLCheck>true</SDLCheck>
-      <PreprocessorDefinitions>_LIB;%(PreprocessorDefinitions)</PreprocessorDefinitions>
-      <ConformanceMode>true</ConformanceMode>
-      <PrecompiledHeader>Use</PrecompiledHeader>
-      <PrecompiledHeaderFile>pch.h</PrecompiledHeaderFile>
-      <AdditionalIncludeDirectories>
-        ./;
-        ..\..\..\common;
-        ..\..\..\common\logger;
-        ..\..\..\common\utils;
-        ..\..\..\..\deps\spdlog\include;
-        %(AdditionalIncludeDirectories)
-      </AdditionalIncludeDirectories>
-    </ClCompile>
-    <Link>
-      <SubSystem>Windows</SubSystem>
-      <GenerateDebugInformation>true</GenerateDebugInformation>
-    </Link>
-  </ItemDefinitionGroup>
-  <ItemGroup>
-    <ClInclude Include="pch.h" />
-    <ClInclude Include="ThemeHelper.h" />
-  </ItemGroup>
-  <ItemGroup>
-    <ClCompile Include="pch.cpp">
-      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">Create</PrecompiledHeader>
-      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Debug|ARM64'">Create</PrecompiledHeader>
-      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Release|x64'">Create</PrecompiledHeader>
-      <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Release|ARM64'">Create</PrecompiledHeader>
-    </ClCompile>
-    <ClCompile Include="ThemeHelper.cpp" />
-  </ItemGroup>
-  <ItemGroup>
-    <ProjectReference Include="..\..\..\common\logger\logger.vcxproj">
-      <Project>{d9b8fc84-322a-4f9f-bbb9-20915c47ddfd}</Project>
-    </ProjectReference>
-  </ItemGroup>
-  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
-  <Import Project="..\..\..\..\deps\spdlog.props" />
-  <ImportGroup Label="ExtensionTargets">
-    <Import Project="..\..\..\..\packages\Microsoft.Windows.CppWinRT.2.0.240111.5\build\native\Microsoft.Windows.CppWinRT.targets" Condition="Exists('..\..\..\..\packages\Microsoft.Windows.CppWinRT.2.0.240111.5\build\native\Microsoft.Windows.CppWinRT.targets')" />
-  </ImportGroup>
-</Project>

src/modules/LightSwitch/LightSwitchLib/LightSwitchLib.vcxproj.filters

@@ -1,33 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
-  <ItemGroup>
-    <Filter Include="Source Files">
-      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
-      <Extensions>cpp;c;cc;cxx;c++;cppm;ixx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
-    </Filter>
-    <Filter Include="Header Files">
-      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
-      <Extensions>h;hh;hpp;hxx;h++;hm;inl;inc;ipp;xsd</Extensions>
-    </Filter>
-    <Filter Include="Resource Files">
-      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
-      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms</Extensions>
-    </Filter>
-  </ItemGroup>
-  <ItemGroup>
-    <ClInclude Include="pch.h">
-      <Filter>Header Files</Filter>
-    </ClInclude>
-    <ClInclude Include="ThemeHelper.h">
-      <Filter>Header Files</Filter>
-    </ClInclude>
-  </ItemGroup>
-  <ItemGroup>
-    <ClCompile Include="pch.cpp">
-      <Filter>Source Files</Filter>
-    </ClCompile>
-    <ClCompile Include="ThemeHelper.cpp">
-      <Filter>Source Files</Filter>
-    </ClCompile>
-  </ItemGroup>
-</Project>

src/modules/LightSwitch/LightSwitchLib/ThemeHelper.h

@@ -1,10 +0,0 @@
-#pragma once
-
-inline constexpr wchar_t PERSONALIZATION_REGISTRY_PATH[] = L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize";
-inline constexpr wchar_t NIGHT_LIGHT_REGISTRY_PATH[] = L"Software\\Microsoft\\Windows\\CurrentVersion\\CloudStore\\Store\\DefaultAccount\\Current\\default$windows.data.bluelightreduction.bluelightreductionstate\\windows.data.bluelightreduction.bluelightreductionstate";
-
-void SetSystemTheme(bool isLight);
-void SetAppsTheme(bool isLight);
-bool GetCurrentSystemTheme();
-bool GetCurrentAppsTheme();
-bool IsNightLightEnabled();

src/modules/LightSwitch/LightSwitchLib/pch.cpp

@@ -1 +0,0 @@
-#include "pch.h"

src/modules/LightSwitch/LightSwitchLib/pch.h

@@ -1,5 +0,0 @@
-#pragma once
-
-#define WIN32_LEAN_AND_MEAN             // Exclude rarely-used stuff from Windows headers
-#include <windows.h>
-#include <vector>

src/modules/LightSwitch/LightSwitchModuleInterface/ExportedFunctions.cpp

@@ -1,22 +0,0 @@
-#include "pch.h"
-#include "ThemeHelper.h"
-
-extern "C" __declspec(dllexport) void __cdecl LightSwitch_SetSystemTheme(bool isLight)
-{
-    SetSystemTheme(isLight);
-}
-
-extern "C" __declspec(dllexport) void __cdecl LightSwitch_SetAppsTheme(bool isLight)
-{
-    SetAppsTheme(isLight);
-}
-
-extern "C" __declspec(dllexport) bool __cdecl LightSwitch_GetCurrentSystemTheme()
-{
-    return GetCurrentSystemTheme();
-}
-
-extern "C" __declspec(dllexport) bool __cdecl LightSwitch_GetCurrentAppsTheme()
-{
-    return GetCurrentAppsTheme();
-}

src/modules/LightSwitch/LightSwitchModuleInterface/LightSwitchModuleInterface.vcxproj

@@ -166,17 +166,17 @@
   </ItemDefinitionGroup>
   <ItemDefinitionGroup>
     <ClCompile>
-      <AdditionalIncludeDirectories>..\LightSwitchLib;..\..\..\common\inc;..\..\..\common\Telemetry;..\..\;..\..\..\;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
+      <AdditionalIncludeDirectories>..\..\..\common\inc;..\..\..\common\Telemetry;..\..\;..\..\..\;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
     </ClCompile>
   </ItemDefinitionGroup>
   <ItemGroup>
     <ClInclude Include="pch.h" />
     <ClInclude Include="resource.h" />
+    <ClInclude Include="ThemeHelper.h" />
     <ClInclude Include="trace.h" />
   </ItemGroup>
   <ItemGroup>
     <ClCompile Include="dllmain.cpp" />
-    <ClCompile Include="ExportedFunctions.cpp" />
     <ClCompile Include="pch.cpp">
       <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">Create</PrecompiledHeader>
       <PrecompiledHeader Condition="'$(Configuration)|$(Platform)'=='Release|x64'">Create</PrecompiledHeader>
@@ -187,6 +187,7 @@
       <PrecompiledHeaderFile Condition="'$(Configuration)|$(Platform)'=='Debug|ARM64'">pch.h</PrecompiledHeaderFile>
       <PrecompiledHeaderFile Condition="'$(Configuration)|$(Platform)'=='Release|ARM64'">pch.h</PrecompiledHeaderFile>
     </ClCompile>
+    <ClCompile Include="ThemeHelper.cpp" />
     <ClCompile Include="trace.cpp" />
   </ItemGroup>
   <ItemGroup>
@@ -202,9 +203,6 @@
     <ProjectReference Include="..\..\..\common\SettingsAPI\SettingsAPI.vcxproj">
       <Project>{6955446d-23f7-4023-9bb3-8657f904af99}</Project>
     </ProjectReference>
-    <ProjectReference Include="..\LightSwitchLib\LightSwitchLib.vcxproj">
-      <Project>{79267138-2895-4346-9021-21408d65379f}</Project>
-    </ProjectReference>
   </ItemGroup>
   <ItemGroup>
     <None Include="packages.config" />

src/modules/LightSwitch/LightSwitchModuleInterface/ThemeHelper.cpp

@@ -0,0 +1,106 @@
+#include "pch.h"
+#include <windows.h>
+#include "ThemeHelper.h"
+
+// Controls changing the themes.
+static void ResetColorPrevalence()
+{
+    HKEY hKey;
+    if (RegOpenKeyEx(HKEY_CURRENT_USER,
+                     L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize",
+                     0,
+                     KEY_SET_VALUE,
+                     &hKey) == ERROR_SUCCESS)
+    {
+        DWORD value = 0; // back to default value
+        RegSetValueEx(hKey, L"ColorPrevalence", 0, REG_DWORD, reinterpret_cast<const BYTE*>(&value), sizeof(value));
+        RegCloseKey(hKey);
+
+        SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 0, reinterpret_cast<LPARAM>(L"ImmersiveColorSet"), SMTO_ABORTIFHUNG, 5000, nullptr);
+
+        SendMessageTimeout(HWND_BROADCAST, WM_THEMECHANGED, 0, 0, SMTO_ABORTIFHUNG, 5000, nullptr);
+
+        SendMessageTimeout(HWND_BROADCAST, WM_DWMCOLORIZATIONCOLORCHANGED, 0, 0, SMTO_ABORTIFHUNG, 5000, nullptr);
+    }
+}
+
+void SetAppsTheme(bool mode)
+{
+    HKEY hKey;
+    if (RegOpenKeyEx(HKEY_CURRENT_USER,
+                     L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize",
+                     0,
+                     KEY_SET_VALUE,
+                     &hKey) == ERROR_SUCCESS)
+    {
+        DWORD value = mode;
+        RegSetValueEx(hKey, L"AppsUseLightTheme", 0, REG_DWORD, reinterpret_cast<const BYTE*>(&value), sizeof(value));
+        RegCloseKey(hKey);
+
+        SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 0, reinterpret_cast<LPARAM>(L"ImmersiveColorSet"), SMTO_ABORTIFHUNG, 5000, nullptr);
+
+        SendMessageTimeout(HWND_BROADCAST, WM_THEMECHANGED, 0, 0, SMTO_ABORTIFHUNG, 5000, nullptr);
+    }
+}
+
+void SetSystemTheme(bool mode)
+{
+    HKEY hKey;
+    if (RegOpenKeyEx(HKEY_CURRENT_USER,
+                     L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize",
+                     0,
+                     KEY_SET_VALUE,
+                     &hKey) == ERROR_SUCCESS)
+    {
+        DWORD value = mode;
+        RegSetValueEx(hKey, L"SystemUsesLightTheme", 0, REG_DWORD, reinterpret_cast<const BYTE*>(&value), sizeof(value));
+        RegCloseKey(hKey);
+
+        if (mode) // if are changing to light mode
+        {
+            ResetColorPrevalence();
+        }
+
+        SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 0, reinterpret_cast<LPARAM>(L"ImmersiveColorSet"), SMTO_ABORTIFHUNG, 5000, nullptr);
+
+        SendMessageTimeout(HWND_BROADCAST, WM_THEMECHANGED, 0, 0, SMTO_ABORTIFHUNG, 5000, nullptr);
+    }
+}
+
+bool GetCurrentSystemTheme()
+{
+    HKEY hKey;
+    DWORD value = 1; // default = light
+    DWORD size = sizeof(value);
+
+    if (RegOpenKeyEx(HKEY_CURRENT_USER,
+                     L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize",
+                     0,
+                     KEY_READ,
+                     &hKey) == ERROR_SUCCESS)
+    {
+        RegQueryValueEx(hKey, L"SystemUsesLightTheme", nullptr, nullptr, reinterpret_cast<LPBYTE>(&value), &size);
+        RegCloseKey(hKey);
+    }
+
+    return value == 1; // true = light, false = dark
+}
+
+bool GetCurrentAppsTheme()
+{
+    HKEY hKey;
+    DWORD value = 1;
+    DWORD size = sizeof(value);
+
+    if (RegOpenKeyEx(HKEY_CURRENT_USER,
+                     L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize",
+                     0,
+                     KEY_READ,
+                     &hKey) == ERROR_SUCCESS)
+    {
+        RegQueryValueEx(hKey, L"AppsUseLightTheme", nullptr, nullptr, reinterpret_cast<LPBYTE>(&value), &size);
+        RegCloseKey(hKey);
+    }
+
+    return value == 1; // true = light, false = dark
+}

src/modules/LightSwitch/LightSwitchModuleInterface/ThemeHelper.h

@@ -0,0 +1,5 @@
+#pragma once
+void SetSystemTheme(bool dark);
+void SetAppsTheme(bool dark);
+bool GetCurrentSystemTheme();
+bool GetCurrentAppsTheme();

src/modules/LightSwitch/LightSwitchService/LightSwitchService.vcxproj

@@ -55,7 +55,6 @@
       <PreprocessorDefinitions>%(PreprocessorDefinitions)</PreprocessorDefinitions>
       <AdditionalIncludeDirectories>
         ./../;
-        ..\LightSwitchLib;
         ..\..\..\common;
         ..\..\..\common\logger;
         ..\..\..\common\utils;
@@ -79,6 +78,7 @@
     <ClCompile Include="LightSwitchStateManager.cpp" />
     <ClCompile Include="NightLightRegistryObserver.cpp" />
     <ClCompile Include="SettingsConstants.cpp" />
+    <ClCompile Include="ThemeHelper.cpp" />
     <ClCompile Include="ThemeScheduler.cpp" />
     <ClCompile Include="trace.cpp" />
     <ClCompile Include="WinHookEventIDs.cpp" />
@@ -93,6 +93,7 @@
     <ClInclude Include="NightLightRegistryObserver.h" />
     <ClInclude Include="SettingsConstants.h" />
     <ClInclude Include="SettingsObserver.h" />
+    <ClInclude Include="ThemeHelper.h" />
     <ClInclude Include="ThemeScheduler.h" />
     <ClInclude Include="trace.h" />
     <ClInclude Include="WinHookEventIDs.h" />
@@ -110,9 +111,6 @@
     <ProjectReference Include="..\..\..\common\Telemetry\EtwTrace\EtwTrace.vcxproj">
       <Project>{8f021b46-362b-485c-bfba-ccf83e820cbd}</Project>
     </ProjectReference>
-    <ProjectReference Include="..\LightSwitchLib\LightSwitchLib.vcxproj">
-      <Project>{79267138-2895-4346-9021-21408d65379f}</Project>
-    </ProjectReference>
   </ItemGroup>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
   <Import Project="..\..\..\..\deps\spdlog.props" />
@@ -120,4 +118,4 @@
     <Import Project="..\..\..\..\packages\Microsoft.Windows.ImplementationLibrary.1.0.231216.1\build\native\Microsoft.Windows.ImplementationLibrary.targets" Condition="Exists('..\..\..\..\packages\Microsoft.Windows.ImplementationLibrary.1.0.231216.1\build\native\Microsoft.Windows.ImplementationLibrary.targets')" />
     <Import Project="..\..\..\..\packages\Microsoft.Windows.CppWinRT.2.0.240111.5\build\native\Microsoft.Windows.CppWinRT.targets" Condition="Exists('..\..\..\..\packages\Microsoft.Windows.CppWinRT.2.0.240111.5\build\native\Microsoft.Windows.CppWinRT.targets')" />
   </ImportGroup>
-</Project>
+</Project>

src/modules/LightSwitch/LightSwitchService/SettingsConstants.h

@@ -12,3 +12,6 @@ enum class SettingId
     ChangeSystem,
     ChangeApps
 };
+
+constexpr wchar_t PERSONALIZATION_REGISTRY_PATH[] = L"Software\\Microsoft\\Windows\\CurrentVersion\\Themes\\Personalize";
+constexpr wchar_t NIGHT_LIGHT_REGISTRY_PATH[] = L"Software\\Microsoft\\Windows\\CurrentVersion\\CloudStore\\Store\\DefaultAccount\\Current\\default$windows.data.bluelightreduction.bluelightreductionstate\\windows.data.bluelightreduction.bluelightreductionstate";

src/modules/LightSwitch/LightSwitchService/ThemeHelper.cpp

@@ -1,6 +1,9 @@
-#include "pch.h"
-#include "ThemeHelper.h"
+#include <windows.h>
+#include <logger/logger_settings.h>
 #include <logger/logger.h>
+#include <utils/logger_helper.h>
+#include "ThemeHelper.h"
+#include <SettingsConstants.h>
 
 // Controls changing the themes.
 
@@ -60,7 +63,7 @@ void SetSystemTheme(bool mode)
         if (mode) // if are changing to light mode 
         {
             ResetColorPrevalence();
-            Logger::info(L"[LightSwitchLib] Reset ColorPrevalence to default when switching to light mode.");
+            Logger::info(L"[LightSwitchService] Reset ColorPrevalence to default when switching to light mode.");
         }
 
         SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 0, reinterpret_cast<LPARAM>(L"ImmersiveColorSet"), SMTO_ABORTIFHUNG, 5000, nullptr);
@@ -133,4 +136,4 @@ bool IsNightLightEnabled()
 
     RegCloseKey(hKey);
     return data[23] == 0x10 && data[24] == 0x00;
-}
+}

src/modules/LightSwitch/LightSwitchService/ThemeHelper.h

@@ -0,0 +1,6 @@
+#pragma once
+void SetSystemTheme(bool dark);
+void SetAppsTheme(bool dark);
+bool GetCurrentSystemTheme();
+bool GetCurrentAppsTheme();
+bool IsNightLightEnabled();

src/modules/LightSwitch/Tests/LightSwitch.UITests/LightSwitch.UITests.csproj

@@ -18,16 +18,5 @@
   <ItemGroup>
 	  <PackageReference Include="MSTest" />
 	  <ProjectReference Include="..\..\..\..\common\UITestAutomation\UITestAutomation.csproj" />
-	  <ProjectReference Include="..\..\..\..\common\ManagedCommon\ManagedCommon.csproj">
-	    <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
-	  </ProjectReference>
-	  <ProjectReference Include="..\..\LightSwitchModuleInterface\LightSwitchModuleInterface.vcxproj">
-	    <ReferenceOutputAssembly>false</ReferenceOutputAssembly>
-	  </ProjectReference>
   </ItemGroup>
-
-  <Target Name="CopyNativeDll" AfterTargets="Build">
-    <Copy SourceFiles="$(SolutionDir)$(Platform)\$(Configuration)\PowerToys.LightSwitchModuleInterface.dll" DestinationFolder="$(OutputPath)" SkipUnchangedFiles="true" Condition="Exists('$(SolutionDir)$(Platform)\$(Configuration)\PowerToys.LightSwitchModuleInterface.dll')" />
-    <Copy SourceFiles="$(SolutionDir)$(Platform)\$(Configuration)\LightSwitchLib\LightSwitchLib.lib" DestinationFolder="$(OutputPath)" SkipUnchangedFiles="true" Condition="Exists('$(SolutionDir)$(Platform)\$(Configuration)\LightSwitchLib\LightSwitchLib.lib')" ContinueOnError="true" />
-  </Target>
 </Project>

src/modules/LightSwitch/Tests/LightSwitch.UITests/TestHelper.cs

@@ -5,7 +5,6 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using System.Runtime.InteropServices;
 using System.Threading.Tasks;
 using System.Windows.Forms;
 using Microsoft.PowerToys.UITest;
@@ -18,20 +17,6 @@ namespace LightSwitch.UITests
     {
         private static readonly string[] ShortcutSeparators = { " + ", "+", " " };
 
-        [DllImport("PowerToys.LightSwitchModuleInterface.dll", CallingConvention = CallingConvention.Cdecl)]
-        private static extern void LightSwitch_SetSystemTheme(bool isLight);
-
-        [DllImport("PowerToys.LightSwitchModuleInterface.dll", CallingConvention = CallingConvention.Cdecl)]
-        private static extern void LightSwitch_SetAppsTheme(bool isLight);
-
-        [DllImport("PowerToys.LightSwitchModuleInterface.dll", CallingConvention = CallingConvention.Cdecl)]
-        [return: MarshalAs(UnmanagedType.I1)]
-        private static extern bool LightSwitch_GetCurrentSystemTheme();
-
-        [DllImport("PowerToys.LightSwitchModuleInterface.dll", CallingConvention = CallingConvention.Cdecl)]
-        [return: MarshalAs(UnmanagedType.I1)]
-        private static extern bool LightSwitch_GetCurrentAppsTheme();
-
         /// <summary>
         /// Performs common test initialization: navigate to settings, enable toggle, verify shortcut
         /// </summary>
@@ -142,7 +127,8 @@ namespace LightSwitch.UITests
         /// <param name="testBase">The test base instance</param>
         public static void CleanupTest(UITestBase testBase)
         {
-            CloseLightSwitch(testBase);
+            // TODO: Make sure the task kills?
+            // CloseLightSwitch(testBase);
 
             // Ensure we're attached to settings after cleanup
             try
@@ -155,51 +141,6 @@ namespace LightSwitch.UITests
             }
         }
 
-        /// <summary>
-        /// Switch to white/light theme for both system and apps
-        /// </summary>
-        /// <param name="testBase">The test base instance</param>
-        public static void CloseLightSwitch(UITestBase testBase)
-        {
-            // Kill LightSwitch process before setting themes
-            KillLightSwitchProcess();
-
-            // Set both themes to light (white)
-            SetSystemTheme(true);
-            SetAppsTheme(true);
-        }
-
-        /// <summary>
-        /// Kill the LightSwitch service process if it's running
-        /// </summary>
-        private static void KillLightSwitchProcess()
-        {
-            try
-            {
-                var processes = System.Diagnostics.Process.GetProcessesByName("PowerToys.LightSwitchService");
-                foreach (var process in processes)
-                {
-                    try
-                    {
-                        process.Kill();
-                        process.WaitForExit(2000);
-                    }
-                    catch
-                    {
-                        // Ignore errors killing individual processes
-                    }
-                    finally
-                    {
-                        process.Dispose();
-                    }
-                }
-            }
-            catch
-            {
-                // Ignore errors enumerating processes
-            }
-        }
-
         /// <summary>
         /// Perform a update time test operation
         /// </summary>
@@ -467,22 +408,24 @@ namespace LightSwitch.UITests
         /* Helpers */
         private static int GetSystemTheme()
         {
-            return LightSwitch_GetCurrentSystemTheme() ? 1 : 0;
+            using var key = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Themes\Personalize");
+            if (key is null)
+            {
+                return 1;
+            }
+
+            return (int)key.GetValue("SystemUsesLightTheme", 1);
         }
 
         private static int GetAppsTheme()
         {
-            return LightSwitch_GetCurrentAppsTheme() ? 1 : 0;
-        }
+            using var key = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Themes\Personalize");
+            if (key is null)
+            {
+                return 1;
+            }
 
-        private static void SetSystemTheme(bool isLight)
-        {
-            LightSwitch_SetSystemTheme(isLight);
-        }
-
-        private static void SetAppsTheme(bool isLight)
-        {
-            LightSwitch_SetAppsTheme(isLight);
+            return (int)key.GetValue("AppsUseLightTheme", 1);
         }
 
         private static string GetHelpTextValue(string helpText, string key)

src/modules/MouseUtils/CursorWrap/CursorWrapTests/Capture-MonitorLayout.ps1

@@ -7,62 +7,22 @@
     Queries Windows for all connected monitors and saves their configuration
     (position, size, DPI, primary status) to a JSON file that can be used
     for testing the CursorWrap module.
-    
-    By default, potentially identifying information (computer name, user name,
-    device names) is anonymized to protect privacy when sharing layout files.
 
 .PARAMETER OutputPath
-    Path where the JSON file will be saved. Default: cursorwrap_monitor_layout.json
-
-.PARAMETER AddUserMachineNames
-    Include computer name and user name in the output. By default these are
-    blank to protect privacy when sharing layout files.
-
-.PARAMETER AddDeviceNames
-    Include device names (e.g., \\.\DISPLAY1) in the output. By default these
-    are anonymized to "DISPLAY1", "DISPLAY2", etc. to reduce fingerprinting.
-
-.PARAMETER Help
-    Show this help message and exit.
+    Path where the JSON file will be saved. Default: monitor_layout.json
 
 .EXAMPLE
     .\Capture-MonitorLayout.ps1
-    Captures layout with privacy-safe defaults (no user/machine names).
     
 .EXAMPLE
     .\Capture-MonitorLayout.ps1 -OutputPath "my_setup.json"
-    Saves to a custom filename.
-
-.EXAMPLE
-    .\Capture-MonitorLayout.ps1 -AddUserMachineNames
-    Includes computer name and user name in the output.
-
-.EXAMPLE
-    .\Capture-MonitorLayout.ps1 -AddUserMachineNames -AddDeviceNames
-    Includes all identifying information (useful for personal debugging).
 #>
 
 param(
     [Parameter(Mandatory=$false)]
-    [string]$OutputPath = "cursorwrap_monitor_layout.json",
-    
-    [Parameter(Mandatory=$false)]
-    [switch]$AddUserMachineNames,
-    
-    [Parameter(Mandatory=$false)]
-    [switch]$AddDeviceNames,
-    
-    [Parameter(Mandatory=$false)]
-    [Alias("h", "?")]
-    [switch]$Help
+    [string]$OutputPath = "$($env:USERNAME)_monitor_layout.json"
 )
 
-# Show help if requested
-if ($Help) {
-    Get-Help $MyInvocation.MyCommand.Path -Detailed
-    exit 0
-}
-
 # Add Windows Forms for screen enumeration
 Add-Type -AssemblyName System.Windows.Forms
 
@@ -177,20 +137,12 @@ function Capture-MonitorLayout {
     
     $screens = [System.Windows.Forms.Screen]::AllScreens
     $monitors = @()
-    $monitorIndex = 1
-
+    
     foreach ($screen in $screens) {
         $isPrimary = $screen.Primary
         $bounds = $screen.Bounds
         $dpi = Get-MonitorDPI -Screen $screen
         
-        # Anonymize device name by default to reduce fingerprinting
-        $deviceName = if ($AddDeviceNames) {
-            $screen.DeviceName
-        } else {
-            "DISPLAY$monitorIndex"
-        }
-        
         $monitor = [ordered]@{
             left = $bounds.Left
             top = $bounds.Top
@@ -201,11 +153,10 @@ function Capture-MonitorLayout {
             dpi = $dpi
             scaling_percent = [math]::Round(($dpi / 96.0) * 100, 0)
             primary = $isPrimary
-            device_name = $deviceName
+            device_name = $screen.DeviceName
         }
         
         $monitors += $monitor
-        $monitorIndex++
         
         # Display info
         $primaryTag = if ($isPrimary) { " [PRIMARY]" } else { "" }
@@ -219,11 +170,11 @@ function Capture-MonitorLayout {
         Write-Host "  Bounds: [$($bounds.Left), $($bounds.Top), $($bounds.Right), $($bounds.Bottom)]"
     }
     
-    # Create output object with privacy-safe defaults
+    # Create output object
     $output = [ordered]@{
         captured_at = (Get-Date -Format "yyyy-MM-ddTHH:mm:sszzz")
-        computer_name = if ($AddUserMachineNames) { $env:COMPUTERNAME } else { "" }
-        user_name = if ($AddUserMachineNames) { $env:USERNAME } else { "" }
+        computer_name = $env:COMPUTERNAME
+        user_name = $env:USERNAME
         monitor_count = $monitors.Count
         monitors = $monitors
     }
@@ -249,22 +200,10 @@ try {
     Write-Host "`n" + ("=" * 80)
     Write-Host "SUMMARY" -ForegroundColor Cyan
     Write-Host ("=" * 80)
-    if ($layout.computer_name) {
-        Write-Host "Configuration Name: $($layout.computer_name)"
-    }
+    Write-Host "Configuration Name: $($layout.computer_name)"
     Write-Host "Captured: $($layout.captured_at)"
     Write-Host "Monitors: $($layout.monitor_count)"
     
-    # Privacy notice
-    if (-not $AddUserMachineNames -or -not $AddDeviceNames) {
-        Write-Host "`nPrivacy: " -NoNewline -ForegroundColor Yellow
-        $privacyNotes = @()
-        if (-not $AddUserMachineNames) { $privacyNotes += "user/machine names excluded" }
-        if (-not $AddDeviceNames) { $privacyNotes += "device names anonymized" }
-        Write-Host ($privacyNotes -join ", ") -ForegroundColor Yellow
-        Write-Host "  Use -AddUserMachineNames and/or -AddDeviceNames to include." -ForegroundColor DarkGray
-    }
-    
     # Calculate desktop dimensions
     $widths = @($layout.monitors | ForEach-Object { $_.width })
     $heights = @($layout.monitors | ForEach-Object { $_.height })

src/modules/MouseUtils/FindMyMouse/dllmain.cpp

@@ -238,30 +238,12 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
 {
     auto settingsObject = settings.get_raw_json();
     FindMyMouseSettings findMyMouseSettings;
-
-    if (!settingsObject.GetView().Size())
-    {
-        Logger::info("Find My Mouse settings are empty");
-        m_findMyMouseSettings = findMyMouseSettings;
-        return;
-    }
-
-    // Early exit if no properties object exists
-    if (!settingsObject.HasKey(JSON_KEY_PROPERTIES))
-    {
-        Logger::info("Find My Mouse settings have no properties");
-        m_findMyMouseSettings = findMyMouseSettings;
-        return;
-    }
-
-    auto properties = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES);
-
-    // Parse Activation Method
-    if (properties.HasKey(JSON_KEY_ACTIVATION_METHOD))
+    if (settingsObject.GetView().Size())
     {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_ACTIVATION_METHOD);
+            // Parse Activation Method
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_ACTIVATION_METHOD);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value < static_cast<int>(FindMyMouseActivationMethod::EnumElements) && value >= 0)
             {
@@ -284,50 +266,34 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Activation Method from settings. Will use default value");
         }
-    }
-
-    // Parse Include Win Key
-    if (properties.HasKey(JSON_KEY_INCLUDE_WIN_KEY))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_INCLUDE_WIN_KEY);
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_INCLUDE_WIN_KEY);
             findMyMouseSettings.includeWinKey = jsonPropertiesObject.GetNamedBoolean(JSON_KEY_VALUE);
         }
         catch (...)
         {
             Logger::warn("Failed to get 'include windows key with ctrl' setting");
         }
-    }
-
-    // Parse Do Not Activate On Game Mode
-    if (properties.HasKey(JSON_KEY_DO_NOT_ACTIVATE_ON_GAME_MODE))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_DO_NOT_ACTIVATE_ON_GAME_MODE);
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_DO_NOT_ACTIVATE_ON_GAME_MODE);
             findMyMouseSettings.doNotActivateOnGameMode = jsonPropertiesObject.GetNamedBoolean(JSON_KEY_VALUE);
         }
         catch (...)
         {
             Logger::warn("Failed to get 'do not activate on game mode' setting");
         }
-    }
-
-    // Colors + legacy overlay opacity migration
-    // Desired behavior:
-    //  - Old schema: colors stored as RGB (no alpha) + separate overlay_opacity (0-100). We should migrate by applying that opacity as alpha.
-    //  - New schema: colors stored as ARGB (alpha embedded). Ignore overlay_opacity even if still present.
-    int legacyOverlayOpacity = -1;
-    bool backgroundColorHadExplicitAlpha = false;
-    bool spotlightColorHadExplicitAlpha = false;
-
-    // Parse Legacy Overlay Opacity (may not exist in newer settings)
-    if (properties.HasKey(JSON_KEY_OVERLAY_OPACITY))
-    {
+        // Colors + legacy overlay opacity migration
+        // Desired behavior:
+        //  - Old schema: colors stored as RGB (no alpha) + separate overlay_opacity (0-100). We should migrate by applying that opacity as alpha.
+        //  - New schema: colors stored as ARGB (alpha embedded). Ignore overlay_opacity even if still present.
+        int legacyOverlayOpacity = -1;
+        bool backgroundColorHadExplicitAlpha = false;
+        bool spotlightColorHadExplicitAlpha = false;
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_OVERLAY_OPACITY);
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_OVERLAY_OPACITY);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0 && value <= 100)
             {
@@ -336,16 +302,11 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         }
         catch (...)
         {
-            // overlay_opacity may have invalid data
+            // overlay_opacity may not exist anymore
         }
-    }
-
-    // Parse Background Color
-    if (properties.HasKey(JSON_KEY_BACKGROUND_COLOR))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_BACKGROUND_COLOR);
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_BACKGROUND_COLOR);
             auto backgroundColorStr = (std::wstring)jsonPropertiesObject.GetNamedString(JSON_KEY_VALUE);
             uint8_t a = 255, r, g, b;
             bool parsed = false;
@@ -372,14 +333,9 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize background color from settings. Will use default value");
         }
-    }
-
-    // Parse Spotlight Color
-    if (properties.HasKey(JSON_KEY_SPOTLIGHT_COLOR))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_SPOTLIGHT_COLOR);
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_SPOTLIGHT_COLOR);
             auto spotlightColorStr = (std::wstring)jsonPropertiesObject.GetNamedString(JSON_KEY_VALUE);
             uint8_t a = 255, r, g, b;
             bool parsed = false;
@@ -406,14 +362,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize spotlight color from settings. Will use default value");
         }
-    }
-
-    // Parse Spotlight Radius
-    if (properties.HasKey(JSON_KEY_SPOTLIGHT_RADIUS))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_SPOTLIGHT_RADIUS);
+            // Parse Spotlight Radius
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_SPOTLIGHT_RADIUS);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0)
             {
@@ -428,14 +380,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Spotlight Radius from settings. Will use default value");
         }
-    }
-
-    // Parse Animation Duration
-    if (properties.HasKey(JSON_KEY_ANIMATION_DURATION_MS))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_ANIMATION_DURATION_MS);
+            // Parse Animation Duration
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_ANIMATION_DURATION_MS);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0)
             {
@@ -450,14 +398,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Animation Duration from settings. Will use default value");
         }
-    }
-
-    // Parse Spotlight Initial Zoom
-    if (properties.HasKey(JSON_KEY_SPOTLIGHT_INITIAL_ZOOM))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_SPOTLIGHT_INITIAL_ZOOM);
+            // Parse Spotlight Initial Zoom
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_SPOTLIGHT_INITIAL_ZOOM);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0)
             {
@@ -472,14 +416,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Spotlight Initial Zoom from settings. Will use default value");
         }
-    }
-
-    // Parse Excluded Apps
-    if (properties.HasKey(JSON_KEY_EXCLUDED_APPS))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_EXCLUDED_APPS);
+            // Parse Excluded Apps
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_EXCLUDED_APPS);
             std::wstring apps = jsonPropertiesObject.GetNamedString(JSON_KEY_VALUE).c_str();
             std::vector<std::wstring> excludedApps;
             auto excludedUppercase = apps;
@@ -501,14 +441,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Excluded Apps from settings. Will use default value");
         }
-    }
-
-    // Parse Shaking Minimum Distance
-    if (properties.HasKey(JSON_KEY_SHAKING_MINIMUM_DISTANCE))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_SHAKING_MINIMUM_DISTANCE);
+            // Parse Shaking Minimum Distance
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_SHAKING_MINIMUM_DISTANCE);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0)
             {
@@ -523,14 +459,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Shaking Minimum Distance from settings. Will use default value");
         }
-    }
-
-    // Parse Shaking Interval Milliseconds
-    if (properties.HasKey(JSON_KEY_SHAKING_INTERVAL_MS))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_SHAKING_INTERVAL_MS);
+            // Parse Shaking Interval Milliseconds
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_SHAKING_INTERVAL_MS);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0)
             {
@@ -545,14 +477,10 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Shaking Interval Milliseconds from settings. Will use default value");
         }
-    }
-
-    // Parse Shaking Factor
-    if (properties.HasKey(JSON_KEY_SHAKING_FACTOR))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_SHAKING_FACTOR);
+            // Parse Shaking Factor
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_SHAKING_FACTOR);
             int value = static_cast<int>(jsonPropertiesObject.GetNamedNumber(JSON_KEY_VALUE));
             if (value >= 0)
             {
@@ -567,14 +495,11 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Shaking Factor from settings. Will use default value");
         }
-    }
 
-    // Parse HotKey
-    if (properties.HasKey(JSON_KEY_ACTIVATION_SHORTCUT))
-    {
         try
         {
-            auto jsonPropertiesObject = properties.GetNamedObject(JSON_KEY_ACTIVATION_SHORTCUT);
+            // Parse HotKey
+            auto jsonPropertiesObject = settingsObject.GetNamedObject(JSON_KEY_PROPERTIES).GetNamedObject(JSON_KEY_ACTIVATION_SHORTCUT);
             auto hotkey = PowerToysSettings::HotkeyObject::from_json(jsonPropertiesObject);
             m_hotkey = HotkeyEx();
             if (hotkey.win_pressed())
@@ -603,15 +528,18 @@ void FindMyMouse::parse_settings(PowerToysSettings::PowerToyValues& settings)
         {
             Logger::warn("Failed to initialize Activation Shortcut from settings. Will use default value");
         }
-    }
 
-    if (!m_hotkey.modifiersMask)
+        if (!m_hotkey.modifiersMask)
+        {
+            Logger::info("Using default Activation Shortcut");
+            m_hotkey.modifiersMask = MOD_SHIFT | MOD_WIN;
+            m_hotkey.vkCode = 0x46; // F key
+        }
+    }
+    else
     {
-        Logger::info("Using default Activation Shortcut");
-        m_hotkey.modifiersMask = MOD_SHIFT | MOD_WIN;
-        m_hotkey.vkCode = 0x46; // F key
+        Logger::info("Find My Mouse settings are empty");
     }
-
     m_findMyMouseSettings = findMyMouseSettings;
 }
 

src/modules/MouseUtils/MouseUtils.UITests/FindMyMouseTests.cs

@@ -456,11 +456,10 @@ namespace MouseUtils.UITests
             var groupAppearanceBehavior = foundCustom.Find(By.AccessibilityId(MouseUtilsSettings.AccessibilityIds.FindMyMouseAppearanceBehavior));
             if (groupAppearanceBehavior != null)
             {
-                var expandState = groupAppearanceBehavior.Selected;
-                if (!expandState)
+                // groupAppearanceBehavior.Click();
+                if (foundCustom.FindAll(By.AccessibilityId(MouseUtilsSettings.AccessibilityIds.FindMyMouseOverlayOpacity)).Count == 0)
                 {
                     groupAppearanceBehavior.Click();
-                    Task.Delay(500).Wait();
                 }
 
                 // Set the BackGround color
@@ -542,6 +541,15 @@ namespace MouseUtils.UITests
                 Task.Delay(500).Wait();
                 spotlightColorButton.Click(false, 500, 1500);
 
+                // Set the overlay opacity to overlayOpacity%
+                var overlayOpacitySlider = foundCustom.Find<Slider>(By.AccessibilityId(MouseUtilsSettings.AccessibilityIds.FindMyMouseOverlayOpacity));
+                Assert.IsNotNull(overlayOpacitySlider);
+                Assert.IsNotNull(settings.OverlayOpacity);
+                int overlayOpacityValue = int.Parse(settings.OverlayOpacity, CultureInfo.InvariantCulture);
+                overlayOpacitySlider.QuickSetValue(overlayOpacityValue);
+                Assert.AreEqual(settings.OverlayOpacity, overlayOpacitySlider.Text);
+                Task.Delay(1000).Wait();
+
                 // Set the Fade Initial zoom to 0
                 var spotlightInitialZoomSlider = foundCustom.Find<Slider>(By.AccessibilityId(MouseUtilsSettings.AccessibilityIds.FindMyMouseSpotlightZoom));
                 Assert.IsNotNull(spotlightInitialZoomSlider);
@@ -584,7 +592,7 @@ namespace MouseUtils.UITests
             // Assert.IsNull(animationDisabledWarning);
             if (foundElements.Count != 0)
             {
-                var openSettingsLink = foundCustom.Find<Element>("Open animation settings");
+                var openSettingsLink = foundCustom.Find<Element>("Open settings");
                 Assert.IsNotNull(openSettingsLink);
                 openSettingsLink.Click(false, 500, 3000);
 

src/modules/MouseUtils/MouseUtils.UITests/util/MouseUtilsSettings.cs

@@ -32,6 +32,7 @@ namespace MouseUtils.UITests
             public const string FindMyMouseExcludedApps = "MouseUtils_FindMyMouseExcludedAppsId";
             public const string FindMyMouseBackgroundColor = "MouseUtils_FindMyMouseBackgroundColorId";
             public const string FindMyMouseSpotlightColor = "MouseUtils_FindMyMouseSpotlightColorId";
+            public const string FindMyMouseOverlayOpacity = "MouseUtils_FindMyMouseOverlayOpacityId";
             public const string FindMyMouseSpotlightZoom = "MouseUtils_FindMyMouseSpotlightZoomId";
             public const string FindMyMouseSpotlightRadius = "MouseUtils_FindMyMouseSpotlightRadiusId";
             public const string FindMyMouseAnimationDuration = "MouseUtils_FindMyMouseAnimationDurationId";
@@ -71,10 +72,10 @@ namespace MouseUtils.UITests
 
         private static readonly Dictionary<MouseUtils, string> MouseUtilUIToggleMap = new()
         {
-            [MouseUtils.MouseHighlighter] = @"Mouse Highlighter",
-            [MouseUtils.FindMyMouse] = @"Find My Mouse",
-            [MouseUtils.MousePointerCrosshairs] = @"Mouse Pointer Crosshairs",
-            [MouseUtils.MouseJump] = @"Mouse Jump",
+            [MouseUtils.MouseHighlighter] = @"Enable Mouse Highlighter",
+            [MouseUtils.FindMyMouse] = @"Enable Find My Mouse",
+            [MouseUtils.MousePointerCrosshairs] = @"Enable Mouse Pointer Crosshairs",
+            [MouseUtils.MouseJump] = @"Enable Mouse Jump",
         };
 
         public static string GetMouseUtilUIName(MouseUtils element)

src/modules/Workspaces/WorkspacesEditorUITest/WorkspacesSettingsTests.cs

@@ -57,7 +57,7 @@ public class WorkspacesSettingsTests : UITestBase
         GoToSettingsPageAndEnable();
 
         // Find the enable toggle
-        var enableToggle = Find<ToggleSwitch>("Workspaces");
+        var enableToggle = Find<ToggleSwitch>("Enable Workspaces");
         Assert.IsNotNull(enableToggle, "Enable Workspaces toggle should exist");
 
         Assert.IsTrue(enableToggle.IsOn, "Enable Workspaces toggle should be in the 'on' state");
@@ -80,7 +80,7 @@ public class WorkspacesSettingsTests : UITestBase
     public void TestLaunchEditorByActivationShortcut()
     {
         // Ensure module is enabled
-        var enableToggle = Find<ToggleSwitch>("Workspaces");
+        var enableToggle = Find<ToggleSwitch>("Enable Workspaces");
         if (!enableToggle.IsOn)
         {
             enableToggle.Click();
@@ -109,7 +109,7 @@ public class WorkspacesSettingsTests : UITestBase
     public void TestDisabledModuleDoesNotLaunchByShortcut()
     {
         // Disable the module
-        var enableToggle = Find<ToggleSwitch>("Workspaces");
+        var enableToggle = Find<ToggleSwitch>("Enable Workspaces");
         if (enableToggle.IsOn)
         {
             enableToggle.Click();
@@ -131,7 +131,7 @@ public class WorkspacesSettingsTests : UITestBase
         RestartScopeExe();
         NavigateToWorkspacesSettings();
 
-        enableToggle = Find<ToggleSwitch>("Workspaces");
+        enableToggle = Find<ToggleSwitch>("Enable Workspaces");
         if (!enableToggle.IsOn)
         {
             enableToggle.Click();
@@ -174,7 +174,7 @@ public class WorkspacesSettingsTests : UITestBase
 
         this.Find<NavigationViewItem>("Workspaces").Click();
 
-        var enableButton = this.Find<ToggleSwitch>("Workspaces");
+        var enableButton = this.Find<ToggleSwitch>("Enable Workspaces");
         Assert.IsNotNull(enableButton, "Enable Workspaces toggle should exist");
 
         if (!enableButton.IsOn)

src/modules/alwaysontop/AlwaysOnTop/AlwaysOnTop.cpp

@@ -153,21 +153,9 @@ LRESULT AlwaysOnTop::WndProc(HWND window, UINT message, WPARAM wparam, LPARAM lp
 {
     if (message == WM_HOTKEY)
     {
-        int hotkeyId = static_cast<int>(wparam);
         if (HWND fw{ GetForegroundWindow() })
         {
-            if (hotkeyId == static_cast<int>(HotkeyId::Pin))
-            {
-                ProcessCommand(fw);
-            }
-            else if (hotkeyId == static_cast<int>(HotkeyId::IncreaseOpacity))
-            {
-                AdjustTransparency(fw, Settings::transparencyStep);
-            }
-            else if (hotkeyId == static_cast<int>(HotkeyId::DecreaseOpacity))
-            {
-                AdjustTransparency(fw, -Settings::transparencyStep);
-            }
+            ProcessCommand(fw);
         }
     }
     else if (message == WM_PRIV_SETTINGS_CHANGED)
@@ -203,11 +191,6 @@ void AlwaysOnTop::ProcessCommand(HWND window)
                 m_topmostWindows.erase(iter);
             }
 
-            // Restore transparency when unpinning
-            RemoveTransparency(window);
-            m_windowOriginalLayeredState.erase(window);
-            m_windowTransparency.erase(window);
-
             Trace::AlwaysOnTop::UnpinWindow();
         }
     }
@@ -217,7 +200,6 @@ void AlwaysOnTop::ProcessCommand(HWND window)
         {
             soundType = Sound::Type::On;
             AssignBorder(window);
-            
             Trace::AlwaysOnTop::PinWindow();
         }
     }
@@ -287,22 +269,11 @@ void AlwaysOnTop::RegisterHotkey() const
 {
     if (m_useCentralizedLLKH)
     {
-        // All hotkeys are handled by centralized LLKH
         return;
     }
 
-    // Register hotkeys only when not using centralized LLKH
     UnregisterHotKey(m_window, static_cast<int>(HotkeyId::Pin));
-    UnregisterHotKey(m_window, static_cast<int>(HotkeyId::IncreaseOpacity));
-    UnregisterHotKey(m_window, static_cast<int>(HotkeyId::DecreaseOpacity));
-
-    // Register pin hotkey
     RegisterHotKey(m_window, static_cast<int>(HotkeyId::Pin), AlwaysOnTopSettings::settings().hotkey.get_modifiers(), AlwaysOnTopSettings::settings().hotkey.get_code());
-
-    // Register transparency hotkeys using the same modifiers as the pin hotkey
-    UINT modifiers = AlwaysOnTopSettings::settings().hotkey.get_modifiers();
-    RegisterHotKey(m_window, static_cast<int>(HotkeyId::IncreaseOpacity), modifiers, VK_OEM_PLUS);
-    RegisterHotKey(m_window, static_cast<int>(HotkeyId::DecreaseOpacity), modifiers, VK_OEM_MINUS);
 }
 
 void AlwaysOnTop::RegisterLLKH()
@@ -314,8 +285,6 @@ void AlwaysOnTop::RegisterLLKH()
 	
     m_hPinEvent = CreateEventW(nullptr, false, false, CommonSharedConstants::ALWAYS_ON_TOP_PIN_EVENT);
     m_hTerminateEvent = CreateEventW(nullptr, false, false, CommonSharedConstants::ALWAYS_ON_TOP_TERMINATE_EVENT);
-    m_hIncreaseOpacityEvent = CreateEventW(nullptr, false, false, CommonSharedConstants::ALWAYS_ON_TOP_INCREASE_OPACITY_EVENT);
-    m_hDecreaseOpacityEvent = CreateEventW(nullptr, false, false, CommonSharedConstants::ALWAYS_ON_TOP_DECREASE_OPACITY_EVENT);
 
     if (!m_hPinEvent)
     {
@@ -329,54 +298,30 @@ void AlwaysOnTop::RegisterLLKH()
         return;
     }
 
-    if (!m_hIncreaseOpacityEvent)
-    {
-        Logger::warn(L"Failed to create increaseOpacityEvent. {}", get_last_error_or_default(GetLastError()));
-    }
-
-    if (!m_hDecreaseOpacityEvent)
-    {
-        Logger::warn(L"Failed to create decreaseOpacityEvent. {}", get_last_error_or_default(GetLastError()));
-    }
-
-    HANDLE handles[4] = { m_hPinEvent,
-                          m_hTerminateEvent,
-                          m_hIncreaseOpacityEvent,
-                          m_hDecreaseOpacityEvent };
+    HANDLE handles[2] = { m_hPinEvent,
+                          m_hTerminateEvent };
 
     m_thread = std::thread([this, handles]() {
         MSG msg;
         while (m_running)
         {
-            DWORD dwEvt = MsgWaitForMultipleObjects(4, handles, false, INFINITE, QS_ALLINPUT);
+            DWORD dwEvt = MsgWaitForMultipleObjects(2, handles, false, INFINITE, QS_ALLINPUT);
             if (!m_running)
             {
                 break;
             }
             switch (dwEvt)
             {
-            case WAIT_OBJECT_0: // Pin event
+            case WAIT_OBJECT_0:
                 if (HWND fw{ GetForegroundWindow() })
                 {
                     ProcessCommand(fw);
                 }
                 break;
-            case WAIT_OBJECT_0 + 1: // Terminate event
+            case WAIT_OBJECT_0 + 1:
                 PostThreadMessage(m_mainThreadId, WM_QUIT, 0, 0);
                 break;
-            case WAIT_OBJECT_0 + 2: // Increase opacity event
-                if (HWND fw{ GetForegroundWindow() })
-                {
-                    AdjustTransparency(fw, Settings::transparencyStep);
-                }
-                break;
-            case WAIT_OBJECT_0 + 3: // Decrease opacity event
-                if (HWND fw{ GetForegroundWindow() })
-                {
-                    AdjustTransparency(fw, -Settings::transparencyStep);
-                }
-                break;
-            case WAIT_OBJECT_0 + 4: // Message queue
+            case WAIT_OBJECT_0 + 2:
                 if (PeekMessageW(&msg, nullptr, 0, 0, PM_REMOVE))
                 {
                     TranslateMessage(&msg);
@@ -425,13 +370,9 @@ void AlwaysOnTop::UnpinAll()
         {
             Logger::error(L"Unpinning topmost window failed");
         }
-        // Restore transparency when unpinning all
-        RemoveTransparency(topWindow);
     }
 
     m_topmostWindows.clear();
-    m_windowTransparency.clear();
-    m_windowOriginalLayeredState.clear();
 }
 
 void AlwaysOnTop::CleanUp()
@@ -515,8 +456,6 @@ void AlwaysOnTop::HandleWinHookEvent(WinHookEvent* data) noexcept
     for (const auto window : toErase)
     {
         m_topmostWindows.erase(window);
-        m_windowTransparency.erase(window);
-        m_windowOriginalLayeredState.erase(window);
     }
 
     switch (data->event)
@@ -617,182 +556,4 @@ void AlwaysOnTop::RefreshBorders()
             }
         }
     }
-}
-
-// Transparency adjustment methods
-HWND AlwaysOnTop::GetTransparencyTarget(HWND window)
-{
-    if (!window || !IsWindow(window))
-    {
-        return nullptr;
-    }
-
-    // Only allow transparency adjustment on tracked/pinned windows
-    if (!IsTracked(window) && !IsPinned(window))
-    {
-        return nullptr;
-    }
-
-    // Use GA_ROOTOWNER to get the root owner window
-    HWND targetWindow = GetAncestor(window, GA_ROOTOWNER);
-    if (!targetWindow)
-    {
-        targetWindow = window;
-    }
-
-    // Filter out desktop, shell, invisible windows
-    if (targetWindow == GetDesktopWindow() || targetWindow == GetShellWindow())
-    {
-        return nullptr;
-    }
-    if (!IsWindowVisible(targetWindow))
-    {
-        return nullptr;
-    }
-
-    return targetWindow;
-}
-
-void AlwaysOnTop::AdjustTransparency(HWND window, int delta)
-{
-    HWND targetWindow = GetTransparencyTarget(window);
-    if (!targetWindow)
-    {
-        return;
-    }
-
-    auto it = m_windowTransparency.find(targetWindow);
-    int currentTransparency = (it != m_windowTransparency.end()) ? it->second : Settings::maxTransparencyPercentage;
-    int newTransparency = (std::max)(Settings::minTransparencyPercentage, 
-                                     (std::min)(Settings::maxTransparencyPercentage, currentTransparency + delta));
-
-    if (newTransparency != currentTransparency)
-    {
-        SetTransparency(targetWindow, newTransparency);
-
-        if (AlwaysOnTopSettings::settings().enableSound)
-        {
-            m_sound.Play(delta > 0 ? Sound::Type::IncreaseOpacity : Sound::Type::DecreaseOpacity);
-        }
-
-        Logger::trace(L"Transparency adjusted to {}%", newTransparency);
-    }
-}
-
-void AlwaysOnTop::SetTransparency(HWND window, int percentage)
-{
-    if (!window || !IsWindow(window))
-    {
-        return;
-    }
-    
-    percentage = (std::max)(Settings::minTransparencyPercentage, 
-                            (std::min)(Settings::maxTransparencyPercentage, percentage));
-
-    m_windowTransparency[window] = percentage;
-
-    if (percentage == Settings::maxTransparencyPercentage)
-    {
-        RemoveTransparency(window);
-        return;
-    }
-
-    LONG exStyle = GetWindowLong(window, GWL_EXSTYLE);
-    bool isCurrentlyLayered = (exStyle & WS_EX_LAYERED) != 0;
-
-    // Cache original state on first transparency application
-    if (m_windowOriginalLayeredState.find(window) == m_windowOriginalLayeredState.end())
-    {
-        WindowLayeredState state;
-        state.hadLayeredStyle = isCurrentlyLayered;
-        
-        if (isCurrentlyLayered)
-        {
-            BYTE alpha = 255;
-            COLORREF colorKey = 0;
-            DWORD flags = 0;
-            if (GetLayeredWindowAttributes(window, &colorKey, &alpha, &flags))
-            {
-                state.originalAlpha = alpha;
-                state.usedColorKey = (flags & LWA_COLORKEY) != 0;
-                state.colorKey = colorKey;
-            }
-            else
-            {
-                Logger::warn(L"GetLayeredWindowAttributes failed for layered window, skipping");
-                return;
-            }
-        }
-        m_windowOriginalLayeredState[window] = state;
-    }
-
-    // Clear WS_EX_LAYERED first to ensure SetLayeredWindowAttributes works
-    if (isCurrentlyLayered)
-    {
-        SetWindowLong(window, GWL_EXSTYLE, exStyle & ~WS_EX_LAYERED);
-        SetWindowPos(window, nullptr, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED);
-        exStyle = GetWindowLong(window, GWL_EXSTYLE);
-    }
-
-    BYTE alphaValue = static_cast<BYTE>((255 * percentage) / 100);
-    SetWindowLong(window, GWL_EXSTYLE, exStyle | WS_EX_LAYERED);
-    SetLayeredWindowAttributes(window, 0, alphaValue, LWA_ALPHA);
-}
-
-void AlwaysOnTop::RemoveTransparency(HWND window)
-{
-    if (!window || !IsWindow(window))
-    {
-        return;
-    }
-
-    LONG exStyle = GetWindowLong(window, GWL_EXSTYLE);
-    auto it = m_windowOriginalLayeredState.find(window);
-    
-    if (it != m_windowOriginalLayeredState.end())
-    {
-        const auto& originalState = it->second;
-        
-        if (originalState.hadLayeredStyle)
-        {
-            // Window originally had WS_EX_LAYERED - restore original attributes
-            // Clear and re-add to ensure clean state
-            if (exStyle & WS_EX_LAYERED)
-            {
-                SetWindowLong(window, GWL_EXSTYLE, exStyle & ~WS_EX_LAYERED);
-                exStyle = GetWindowLong(window, GWL_EXSTYLE);
-            }
-            SetWindowLong(window, GWL_EXSTYLE, exStyle | WS_EX_LAYERED);
-            
-            // Restore original alpha and/or color key
-            DWORD flags = LWA_ALPHA;
-            if (originalState.usedColorKey)
-            {
-                flags |= LWA_COLORKEY;
-            }
-            SetLayeredWindowAttributes(window, originalState.colorKey, originalState.originalAlpha, flags);
-            SetWindowPos(window, nullptr, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED);
-        }
-        else
-        {
-            // Window originally didn't have WS_EX_LAYERED - remove it completely
-            if (exStyle & WS_EX_LAYERED)
-            {
-                SetLayeredWindowAttributes(window, 0, 255, LWA_ALPHA);
-                SetWindowLong(window, GWL_EXSTYLE, exStyle & ~WS_EX_LAYERED);
-                SetWindowPos(window, nullptr, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED);
-            }
-        }
-        
-        m_windowOriginalLayeredState.erase(it);
-    }
-    else
-    {
-        // Fallback: no cached state, just remove layered style
-        if (exStyle & WS_EX_LAYERED)
-        {
-            SetLayeredWindowAttributes(window, 0, 255, LWA_ALPHA);
-            SetWindowLong(window, GWL_EXSTYLE, exStyle & ~WS_EX_LAYERED);
-        }
-    }
 }

src/modules/alwaysontop/AlwaysOnTop/AlwaysOnTop.h

@@ -10,7 +10,6 @@
 
 #include <common/hooks/WinHookEvent.h>
 #include <common/notifications/NotificationUtil.h>
-#include <common/utils/window.h>
 
 class AlwaysOnTop : public SettingsObserver
 {
@@ -39,8 +38,6 @@ private:
     enum class HotkeyId : int
     {
         Pin = 1,
-        IncreaseOpacity = 2,
-        DecreaseOpacity = 3,
     };
 
     static inline AlwaysOnTop* s_instance = nullptr;
@@ -51,21 +48,8 @@ private:
     HWND m_window{ nullptr };
     HINSTANCE m_hinstance;
     std::map<HWND, std::unique_ptr<WindowBorder>> m_topmostWindows{};
-    std::map<HWND, int> m_windowTransparency{}; // Track transparency per window (20-100)
-    
-    // Store original window layered state for proper restoration
-    struct WindowLayeredState {
-        bool hadLayeredStyle = false;
-        BYTE originalAlpha = 255;
-        bool usedColorKey = false;
-        COLORREF colorKey = 0;
-    };
-    std::map<HWND, WindowLayeredState> m_windowOriginalLayeredState{};
-    
     HANDLE m_hPinEvent;
     HANDLE m_hTerminateEvent;
-    HANDLE m_hIncreaseOpacityEvent;
-    HANDLE m_hDecreaseOpacityEvent;
     DWORD m_mainThreadId;
     std::thread m_thread;
     const bool m_useCentralizedLLKH;
@@ -94,12 +78,6 @@ private:
     bool AssignBorder(HWND window);
     void RefreshBorders();
 
-    // Transparency methods
-    HWND GetTransparencyTarget(HWND window);
-    void AdjustTransparency(HWND window, int delta);
-    void SetTransparency(HWND window, int percentage);
-    void RemoveTransparency(HWND window);
-
     virtual void SettingsUpdate(SettingId type) override;
 
     static void CALLBACK WinHookProc(HWINEVENTHOOK winEventHook,

src/modules/awake/Awake.ModuleServices/AwakeService.cs

@@ -5,7 +5,6 @@
 using System.Diagnostics;
 using System.Text.Json;
 using Common.UI;
-using ManagedCommon;
 using Microsoft.PowerToys.Settings.UI.Library;
 using PowerToys.ModuleContracts;
 
@@ -83,9 +82,10 @@ public sealed class AwakeService : ModuleServiceBase, IAwakeService
         return UpdateSettingsAsync(
             settings =>
             {
+                var totalMinutes = Math.Min(minutes, int.MaxValue);
                 settings.Properties.Mode = AwakeMode.TIMED;
-                settings.Properties.IntervalHours = (uint)(minutes / 60);
-                settings.Properties.IntervalMinutes = (uint)(minutes % 60);
+                settings.Properties.IntervalHours = (uint)(totalMinutes / 60);
+                settings.Properties.IntervalMinutes = (uint)(totalMinutes % 60);
             },
             cancellationToken);
     }
@@ -130,9 +130,8 @@ public sealed class AwakeService : ModuleServiceBase, IAwakeService
         {
             return Process.GetProcessesByName("PowerToys.Awake").Length > 0;
         }
-        catch (Exception ex)
+        catch
         {
-            Logger.LogError($"Failed to check Awake process status: {ex.Message}");
             return false;
         }
     }
@@ -144,9 +143,8 @@ public sealed class AwakeService : ModuleServiceBase, IAwakeService
             var settingsUtils = SettingsUtils.Default;
             return settingsUtils.GetSettingsOrDefault<AwakeSettings>(AwakeSettings.ModuleName);
         }
-        catch (Exception ex)
+        catch
         {
-            Logger.LogError($"Failed to read Awake settings: {ex.Message}");
             return null;
         }
     }

src/modules/awake/Awake/Core/Constants.cs

@@ -17,6 +17,6 @@ namespace Awake.Core
         // Format of the build ID is: CODENAME_MMDDYYYY, where MMDDYYYY
         // is representative of the date when the last change was made before
         // the pull request is issued.
-        internal const string BuildId = "DIDACT_01182026";
+        internal const string BuildId = "TILLSON_11272024";
     }
 }

src/modules/awake/Awake/Core/ExtensionMethods.cs

@@ -22,13 +22,14 @@ namespace Awake.Core
 
         public static string ToHumanReadableString(this TimeSpan timeSpan)
         {
-            // Format as H:MM:SS or M:SS depending on total hours
-            if (timeSpan.TotalHours >= 1)
-            {
-                return $"{(int)timeSpan.TotalHours}:{timeSpan.Minutes:D2}:{timeSpan.Seconds:D2}";
-            }
+            // Get days, hours, minutes, and seconds from the TimeSpan
+            int days = timeSpan.Days;
+            int hours = timeSpan.Hours;
+            int minutes = timeSpan.Minutes;
+            int seconds = timeSpan.Seconds;
 
-            return $"{timeSpan.Minutes}:{timeSpan.Seconds:D2}";
+            // Format the string based on the presence of days, hours, minutes, and seconds
+            return $"{days:D2}{Properties.Resources.AWAKE_LABEL_DAYS} {hours:D2}{Properties.Resources.AWAKE_LABEL_HOURS} {minutes:D2}{Properties.Resources.AWAKE_LABEL_MINUTES} {seconds:D2}{Properties.Resources.AWAKE_LABEL_SECONDS}";
         }
     }
 }

src/modules/awake/Awake/Core/Manager.cs

@@ -37,7 +37,7 @@ namespace Awake.Core
 
         internal static SettingsUtils? ModuleSettings { get; set; }
 
-        internal static AwakeMode CurrentOperatingMode { get; private set; }
+        private static AwakeMode CurrentOperatingMode { get; set; }
 
         private static bool IsDisplayOn { get; set; }
 
@@ -54,12 +54,11 @@ namespace Awake.Core
         private static readonly CompositeFormat AwakeHour = CompositeFormat.Parse(Resources.AWAKE_HOUR);
         private static readonly CompositeFormat AwakeHours = CompositeFormat.Parse(Resources.AWAKE_HOURS);
         private static readonly BlockingCollection<ExecutionState> _stateQueue;
-        private static CancellationTokenSource _monitorTokenSource;
-        private static IDisposable? _timerSubscription;
+        private static CancellationTokenSource _tokenSource;
 
         static Manager()
         {
-            _monitorTokenSource = new CancellationTokenSource();
+            _tokenSource = new CancellationTokenSource();
             _stateQueue = [];
             ModuleSettings = SettingsUtils.Default;
         }
@@ -69,36 +68,18 @@ namespace Awake.Core
             Thread monitorThread = new(() =>
             {
                 Thread.CurrentThread.IsBackground = false;
-                try
+                while (true)
                 {
-                    while (!_monitorTokenSource.Token.IsCancellationRequested)
-                    {
-                        ExecutionState state = _stateQueue.Take(_monitorTokenSource.Token);
+                    ExecutionState state = _stateQueue.Take();
 
-                        Logger.LogInfo($"Setting state to {state}");
+                    Logger.LogInfo($"Setting state to {state}");
 
-                        if (!SetAwakeState(state))
-                        {
-                            Logger.LogError($"Failed to set execution state to {state}. Reverting to passive mode.");
-                            CurrentOperatingMode = AwakeMode.PASSIVE;
-                            SetModeShellIcon();
-                        }
-                    }
-                }
-                catch (OperationCanceledException)
-                {
-                    Logger.LogInfo("Monitor thread received cancellation signal. Exiting gracefully.");
+                    SetAwakeState(state);
                 }
             });
             monitorThread.Start();
         }
 
-        internal static void StopMonitor()
-        {
-            _monitorTokenSource.Cancel();
-            _monitorTokenSource.Dispose();
-        }
-
         internal static void SetConsoleControlHandler(ConsoleEventHandler handler, bool addHandler)
         {
             Bridge.SetConsoleCtrlHandler(handler, addHandler);
@@ -129,9 +110,8 @@ namespace Awake.Core
                 ExecutionState stateResult = Bridge.SetThreadExecutionState(state);
                 return stateResult != 0;
             }
-            catch (Exception ex)
+            catch
             {
-                Logger.LogError($"Failed to set awake state to {state}: {ex.Message}");
                 return false;
             }
         }
@@ -143,34 +123,26 @@ namespace Awake.Core
                 : ExecutionState.ES_SYSTEM_REQUIRED | ExecutionState.ES_CONTINUOUS;
         }
 
-        /// <summary>
-        /// Re-applies the current awake state after a power event.
-        /// Called when WM_POWERBROADCAST indicates system wake or power source change.
-        /// </summary>
-        internal static void ReapplyAwakeState()
-        {
-            if (CurrentOperatingMode == AwakeMode.PASSIVE)
-            {
-                // No need to reapply in passive mode
-                return;
-            }
-
-            Logger.LogInfo($"Power event received. Reapplying awake state for mode: {CurrentOperatingMode}");
-            _stateQueue.Add(ComputeAwakeState(IsDisplayOn));
-        }
-
         internal static void CancelExistingThread()
         {
-            Logger.LogInfo("Canceling existing timer and resetting state...");
+            Logger.LogInfo("Ensuring the thread is properly cleaned up...");
 
-            // Reset the thread state.
+            // Reset the thread state and handle cancellation.
             _stateQueue.Add(ExecutionState.ES_CONTINUOUS);
 
-            // Dispose the timer subscription to stop any running timer.
-            _timerSubscription?.Dispose();
-            _timerSubscription = null;
+            if (_tokenSource != null)
+            {
+                _tokenSource.Cancel();
+                _tokenSource.Dispose();
+            }
+            else
+            {
+                Logger.LogWarning("Token source is null.");
+            }
 
-            Logger.LogInfo("Timer subscription disposed.");
+            _tokenSource = new CancellationTokenSource();
+
+            Logger.LogInfo("New token source and thread token instantiated.");
         }
 
         internal static void SetModeShellIcon(bool forceAdd = false)
@@ -181,25 +153,25 @@ namespace Awake.Core
             switch (CurrentOperatingMode)
             {
                 case AwakeMode.INDEFINITE:
-                    string pidLine = ProcessId == 0
+                    string processText = ProcessId == 0
                         ? string.Empty
-                        : $"\nPID: {ProcessId}";
-                    iconText = $"{Constants.FullAppName}\n{Resources.AWAKE_TRAY_TEXT_INDEFINITE}\n{Resources.AWAKE_TRAY_DISPLAY}: {ScreenStateString}{pidLine}";
+                        : $" - {Resources.AWAKE_TRAY_TEXT_PID_BINDING}: {ProcessId}";
+                    iconText = $"{Constants.FullAppName} [{Resources.AWAKE_TRAY_TEXT_INDEFINITE}{processText}][{ScreenStateString}]";
                     icon = TrayHelper.IndefiniteIcon;
                     break;
 
                 case AwakeMode.PASSIVE:
-                    iconText = $"{Constants.FullAppName}\n{Resources.AWAKE_SCREEN_OFF}";
+                    iconText = $"{Constants.FullAppName} [{Resources.AWAKE_TRAY_TEXT_OFF}]";
                     icon = TrayHelper.DisabledIcon;
                     break;
 
                 case AwakeMode.EXPIRABLE:
-                    iconText = $"{Constants.FullAppName}\n{Resources.AWAKE_TRAY_UNTIL} {ExpireAt:MMM d, h:mm tt}\n{Resources.AWAKE_TRAY_DISPLAY}: {ScreenStateString}";
+                    iconText = $"{Constants.FullAppName} [{Resources.AWAKE_TRAY_TEXT_EXPIRATION}][{ScreenStateString}][{ExpireAt:yyyy-MM-dd HH:mm:ss}]";
                     icon = TrayHelper.ExpirableIcon;
                     break;
 
                 case AwakeMode.TIMED:
-                    iconText = $"{Constants.FullAppName}\n{Resources.AWAKE_TRAY_TEXT_TIMED}\n{Resources.AWAKE_TRAY_DISPLAY}: {ScreenStateString}";
+                    iconText = $"{Constants.FullAppName} [{Resources.AWAKE_TRAY_TEXT_TIMED}][{ScreenStateString}]";
                     icon = TrayHelper.TimedIcon;
                     break;
             }
@@ -308,8 +280,9 @@ namespace Awake.Core
 
             TimeSpan remainingTime = expireAt - DateTimeOffset.Now;
 
-            _timerSubscription = Observable.Timer(remainingTime).Subscribe(
-                _ => HandleTimerCompletion("expirable"));
+            Observable.Timer(remainingTime).Subscribe(
+                _ => HandleTimerCompletion("expirable"),
+                _tokenSource.Token);
         }
 
         internal static void SetTimedKeepAwake(uint seconds, bool keepDisplayOn = true, [CallerMemberName] string callerName = "")
@@ -327,8 +300,6 @@ namespace Awake.Core
                     TimeSpan timeSpan = TimeSpan.FromSeconds(seconds);
 
                     uint totalHours = (uint)timeSpan.TotalHours;
-
-                    // Round up partial minutes to prevent timer from expiring before intended duration
                     uint remainingMinutes = (uint)Math.Ceiling(timeSpan.TotalMinutes % 60);
 
                     bool settingsChanged = currentSettings.Properties.Mode != AwakeMode.TIMED ||
@@ -365,7 +336,7 @@ namespace Awake.Core
 
             var targetExpiryTime = DateTimeOffset.Now.AddSeconds(seconds);
 
-            _timerSubscription = Observable.Interval(TimeSpan.FromSeconds(1))
+            Observable.Interval(TimeSpan.FromSeconds(1))
                 .Select(_ => targetExpiryTime - DateTimeOffset.Now)
                 .TakeWhile(remaining => remaining.TotalSeconds > 0)
                 .Subscribe(
@@ -375,11 +346,12 @@ namespace Awake.Core
 
                         TrayHelper.SetShellIcon(
                             TrayHelper.WindowHandle,
-                            $"{Constants.FullAppName}\n{remainingTimeSpan.ToHumanReadableString()} {Resources.AWAKE_TRAY_REMAINING}\n{Resources.AWAKE_TRAY_DISPLAY}: {ScreenStateString}",
+                            $"{Constants.FullAppName} [{Resources.AWAKE_TRAY_TEXT_TIMED}][{ScreenStateString}][{remainingTimeSpan.ToHumanReadableString()}]",
                             TrayHelper.TimedIcon,
                             TrayIconAction.Update);
                     },
-                    () => HandleTimerCompletion("timed"));
+                    () => HandleTimerCompletion("timed"),
+                    _tokenSource.Token);
         }
 
         /// <summary>
@@ -412,16 +384,6 @@ namespace Awake.Core
         {
             SetPassiveKeepAwake(updateSettings: false);
 
-            // Stop the monitor thread gracefully
-            StopMonitor();
-
-            // Dispose the timer subscription
-            _timerSubscription?.Dispose();
-            _timerSubscription = null;
-
-            // Dispose tray icons
-            TrayHelper.DisposeIcons();
-
             if (TrayHelper.WindowHandle != IntPtr.Zero)
             {
                 // Delete the icon.
@@ -534,21 +496,15 @@ namespace Awake.Core
                     AwakeSettings currentSettings = ModuleSettings!.GetSettings<AwakeSettings>(Constants.AppName) ?? new AwakeSettings();
                     currentSettings.Properties.KeepDisplayOn = !currentSettings.Properties.KeepDisplayOn;
 
-                    // For TIMED mode: update state directly without restarting timer
-                    // This preserves the existing timer Observable subscription and targetExpiryTime
+                    // We want to make sure that if the display setting changes (e.g., through the tray)
+                    // then we do not reset the counter from zero. Because the settings are only storing
+                    // hours and minutes, we round up the minutes value up when changes occur.
                     if (CurrentOperatingMode == AwakeMode.TIMED && TimeRemaining > 0)
                     {
-                        // Update internal state
-                        IsDisplayOn = currentSettings.Properties.KeepDisplayOn;
+                        TimeSpan timeSpan = TimeSpan.FromSeconds(TimeRemaining);
 
-                        // Update execution state without canceling timer
-                        _stateQueue.Add(ComputeAwakeState(IsDisplayOn));
-
-                        // Save settings - ProcessSettings will skip reinitialization
-                        // since we're already in TIMED mode
-                        ModuleSettings!.SaveSettings(JsonSerializer.Serialize(currentSettings), Constants.AppName);
-
-                        return;
+                        currentSettings.Properties.IntervalHours = (uint)timeSpan.TotalHours;
+                        currentSettings.Properties.IntervalMinutes = (uint)Math.Ceiling(timeSpan.TotalMinutes % 60);
                     }
 
                     ModuleSettings!.SaveSettings(JsonSerializer.Serialize(currentSettings), Constants.AppName);

src/modules/awake/Awake/Core/Native/Constants.cs

@@ -15,12 +15,6 @@ namespace Awake.Core.Native
         internal const int WM_DESTROY = 0x0002;
         internal const int WM_LBUTTONDOWN = 0x0201;
         internal const int WM_RBUTTONDOWN = 0x0204;
-        internal const uint WM_POWERBROADCAST = 0x0218;
-
-        // Power Broadcast Event Types
-        internal const int PBT_APMRESUMEAUTOMATIC = 0x0012;
-        internal const int PBT_APMRESUMESUSPEND = 0x0007;
-        internal const int PBT_APMPOWERSTATUSCHANGE = 0x000A;
 
         // Menu Flags
         internal const uint MF_BYPOSITION = 1024;

src/modules/awake/Awake/Core/Threading/SingleThreadSynchronizationContext.cs

@@ -11,7 +11,7 @@ namespace Awake.Core.Threading
 {
     internal sealed class SingleThreadSynchronizationContext : SynchronizationContext
     {
-        private readonly Queue<(SendOrPostCallback Callback, object? State)?> queue = new();
+        private readonly Queue<Tuple<SendOrPostCallback, object?>?> queue = new();
 
         public override void Post(SendOrPostCallback d, object? state)
         {
@@ -19,7 +19,7 @@ namespace Awake.Core.Threading
 
             lock (queue)
             {
-                queue.Enqueue((d, state));
+                queue.Enqueue(Tuple.Create(d, state));
                 Monitor.Pulse(queue);
             }
         }
@@ -28,7 +28,7 @@ namespace Awake.Core.Threading
         {
             while (true)
             {
-                (SendOrPostCallback Callback, object? State)? work;
+                Tuple<SendOrPostCallback, object?>? work;
                 lock (queue)
                 {
                     while (queue.Count == 0)
@@ -46,7 +46,7 @@ namespace Awake.Core.Threading
 
                 try
                 {
-                    work.Value.Callback(work.Value.State);
+                    work.Item1(work.Item2);
                 }
                 catch (Exception e)
                 {

src/modules/awake/Awake/Core/TrayHelper.cs

@@ -45,26 +45,12 @@ namespace Awake.Core
         internal static readonly Icon IndefiniteIcon = new(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Assets/Awake/indefinite.ico"));
         internal static readonly Icon DisabledIcon = new(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Assets/Awake/disabled.ico"));
 
-        private const int TrayIconId = 1000;
-
         static TrayHelper()
         {
             TrayMenu = IntPtr.Zero;
             WindowHandle = IntPtr.Zero;
         }
 
-        /// <summary>
-        /// Disposes of all icon resources to prevent GDI handle leaks.
-        /// </summary>
-        internal static void DisposeIcons()
-        {
-            DefaultAwakeIcon?.Dispose();
-            TimedIcon?.Dispose();
-            ExpirableIcon?.Dispose();
-            IndefiniteIcon?.Dispose();
-            DisabledIcon?.Dispose();
-        }
-
         private static void ShowContextMenu(IntPtr hWnd)
         {
             if (TrayMenu == IntPtr.Zero)
@@ -186,11 +172,7 @@ namespace Awake.Core
 
         internal static void SetShellIcon(IntPtr hWnd, string text, Icon? icon, TrayIconAction action = TrayIconAction.Add, [CallerMemberName] string callerName = "")
         {
-            // For Delete operations, we don't need an icon - only hWnd is required
-            // For Add/Update operations, we need both hWnd and icon
-            bool canProceed = hWnd != IntPtr.Zero && (action == TrayIconAction.Delete || icon != null);
-
-            if (canProceed)
+            if (hWnd != IntPtr.Zero && icon != null)
             {
                 int message = Native.Constants.NIM_ADD;
 
@@ -213,7 +195,7 @@ namespace Awake.Core
                     {
                         CbSize = Marshal.SizeOf<NotifyIconData>(),
                         HWnd = hWnd,
-                        UId = TrayIconId,
+                        UId = 1000,
                         UFlags = Native.Constants.NIF_ICON | Native.Constants.NIF_TIP | Native.Constants.NIF_MESSAGE,
                         UCallbackMessage = (int)Native.Constants.WM_USER,
                         HIcon = icon?.Handle ?? IntPtr.Zero,
@@ -226,54 +208,29 @@ namespace Awake.Core
                     {
                         CbSize = Marshal.SizeOf<NotifyIconData>(),
                         HWnd = hWnd,
-                        UId = TrayIconId,
+                        UId = 1000,
                         UFlags = 0,
                     };
                 }
 
-                // Retry configuration based on action type
-                // Add operations need longer delays as Explorer may still be initializing after Windows updates
-                int maxRetryAttempts;
-                int baseDelayMs;
-
-                if (action == TrayIconAction.Add)
-                {
-                    maxRetryAttempts = 10;
-                    baseDelayMs = 500;  // 500, 1000, 2000, 2000, 2000... (capped)
-                }
-                else
-                {
-                    maxRetryAttempts = 3;
-                    baseDelayMs = 100;  // 100, 200, 400 (existing behavior)
-                }
-
-                const int maxDelayMs = 2000;  // Cap delay at 2 seconds
-
-                for (int attempt = 1; attempt <= maxRetryAttempts; attempt++)
+                for (int attempt = 1; attempt <= 3; attempt++)
                 {
                     if (Bridge.Shell_NotifyIcon(message, ref _notifyIconData))
                     {
-                        if (attempt > 1)
-                        {
-                            Logger.LogInfo($"Successfully set shell icon on attempt {attempt}. Action: {action}");
-                        }
-
                         break;
                     }
                     else
                     {
                         int errorCode = Marshal.GetLastWin32Error();
-                        Logger.LogInfo($"Could not set the shell icon. Action: {action}, error code: {errorCode}, attempt: {attempt}/{maxRetryAttempts}. HIcon handle is {icon?.Handle} and HWnd is {hWnd}. Invoked by {callerName}.");
+                        Logger.LogInfo($"Could not set the shell icon. Action: {action}, error code: {errorCode}. HIcon handle is {icon?.Handle} and HWnd is {hWnd}. Invoked by {callerName}.");
 
-                        if (attempt == maxRetryAttempts)
+                        if (attempt == 3)
                         {
-                            Logger.LogError($"Failed to change tray icon after {maxRetryAttempts} attempts. Action: {action} and error code: {errorCode}. Invoked by {callerName}.");
+                            Logger.LogError($"Failed to change tray icon after 3 attempts. Action: {action} and error code: {errorCode}. Invoked by {callerName}.");
                             break;
                         }
 
-                        // Exponential backoff with cap
-                        int delayMs = Math.Min(baseDelayMs * (1 << (attempt - 1)), maxDelayMs);
-                        Thread.Sleep(delayMs);
+                        Thread.Sleep(100);
                     }
                 }
 
@@ -284,7 +241,7 @@ namespace Awake.Core
             }
             else
             {
-                Logger.LogInfo($"Cannot set the shell icon - parent window handle is zero{(action != TrayIconAction.Delete && icon == null ? " or icon is not available" : string.Empty)}. Text: {text} Action: {action}");
+                Logger.LogInfo($"Cannot set the shell icon - parent window handle is zero or icon is not available. Text: {text} Action: {action}");
             }
         }
 
@@ -323,9 +280,11 @@ namespace Awake.Core
                     Bridge.PostQuitMessage(0);
                     break;
                 case Native.Constants.WM_COMMAND:
-                    long targetCommandValue = wParam.ToInt64() & 0xFFFF;
+                    int trayCommandsSize = Enum.GetNames<TrayCommands>().Length;
 
-                    switch (targetCommandValue)
+                    long targetCommandIndex = wParam.ToInt64() & 0xFFFF;
+
+                    switch (targetCommandIndex)
                     {
                         case (uint)TrayCommands.TC_EXIT:
                             {
@@ -341,7 +300,7 @@ namespace Awake.Core
 
                         case (uint)TrayCommands.TC_MODE_INDEFINITE:
                             {
-                                AwakeSettings settings = Manager.ModuleSettings!.GetSettings<AwakeSettings>(Constants.AppName) ?? new AwakeSettings();
+                                AwakeSettings settings = Manager.ModuleSettings!.GetSettings<AwakeSettings>(Constants.AppName);
                                 Manager.SetIndefiniteKeepAwake(keepDisplayOn: settings.Properties.KeepDisplayOn);
                                 break;
                             }
@@ -354,43 +313,23 @@ namespace Awake.Core
 
                         default:
                             {
-                                // Custom tray time commands start at TC_TIME and increment by 1 for each entry.
-                                // Check if this command falls within the custom time range.
-                                if (targetCommandValue >= (uint)TrayCommands.TC_TIME)
+                                if (targetCommandIndex >= trayCommandsSize)
                                 {
-                                    AwakeSettings settings = Manager.ModuleSettings!.GetSettings<AwakeSettings>(Constants.AppName) ?? new AwakeSettings();
+                                    AwakeSettings settings = Manager.ModuleSettings!.GetSettings<AwakeSettings>(Constants.AppName);
                                     if (settings.Properties.CustomTrayTimes.Count == 0)
                                     {
                                         settings.Properties.CustomTrayTimes.AddRange(Manager.GetDefaultTrayOptions());
                                     }
 
-                                    int index = (int)targetCommandValue - (int)TrayCommands.TC_TIME;
-
-                                    if (index >= 0 && index < settings.Properties.CustomTrayTimes.Count)
-                                    {
-                                        uint targetTime = settings.Properties.CustomTrayTimes.Values.Skip(index).First();
-                                        Manager.SetTimedKeepAwake(targetTime, keepDisplayOn: settings.Properties.KeepDisplayOn);
-                                    }
-                                    else
-                                    {
-                                        Logger.LogError($"Custom tray time index {index} is out of range. Available entries: {settings.Properties.CustomTrayTimes.Count}");
-                                    }
+                                    int index = (int)targetCommandIndex - (int)TrayCommands.TC_TIME;
+                                    uint targetTime = settings.Properties.CustomTrayTimes.ElementAt(index).Value;
+                                    Manager.SetTimedKeepAwake(targetTime, keepDisplayOn: settings.Properties.KeepDisplayOn);
                                 }
 
                                 break;
                             }
                     }
 
-                    break;
-                case Native.Constants.WM_POWERBROADCAST:
-                    int eventType = wParam.ToInt32();
-                    if (eventType == Native.Constants.PBT_APMRESUMEAUTOMATIC ||
-                        eventType == Native.Constants.PBT_APMRESUMESUSPEND ||
-                        eventType == Native.Constants.PBT_APMPOWERSTATUSCHANGE)
-                    {
-                        Manager.ReapplyAwakeState();
-                    }
-
                     break;
                 default:
                     if (message == _taskbarCreatedMessage)
@@ -418,7 +357,7 @@ namespace Awake.Core
                     }
                     catch (Exception e)
                     {
-                        Logger.LogError($"Error in tray thread execution: {e.Message}");
+                        Console.WriteLine("Error: " + e.Message);
                     }
                 },
                 null);
@@ -500,11 +439,9 @@ namespace Awake.Core
         private static void CreateAwakeTimeSubMenu(Dictionary<string, uint> trayTimeShortcuts, bool isChecked = false)
         {
             nint awakeTimeMenu = Bridge.CreatePopupMenu();
-            int i = 0;
-            foreach (var shortcut in trayTimeShortcuts)
+            for (int i = 0; i < trayTimeShortcuts.Count; i++)
             {
-                Bridge.InsertMenu(awakeTimeMenu, (uint)i, Native.Constants.MF_BYPOSITION | Native.Constants.MF_STRING, (uint)TrayCommands.TC_TIME + (uint)i, shortcut.Key);
-                i++;
+                Bridge.InsertMenu(awakeTimeMenu, (uint)i, Native.Constants.MF_BYPOSITION | Native.Constants.MF_STRING, (uint)TrayCommands.TC_TIME + (uint)i, trayTimeShortcuts.ElementAt(i).Key);
             }
 
             Bridge.InsertMenu(TrayMenu, 0, Native.Constants.MF_BYPOSITION | Native.Constants.MF_POPUP | (isChecked ? Native.Constants.MF_CHECKED : Native.Constants.MF_UNCHECKED), (uint)awakeTimeMenu, Resources.AWAKE_KEEP_ON_INTERVAL);

src/modules/awake/Awake/Program.cs

@@ -39,20 +39,18 @@ namespace Awake
 
         private static FileSystemWatcher? _watcher;
         private static SettingsUtils? _settingsUtils;
-        private static EventWaitHandle? _exitEventHandle;
-        private static RegisteredWaitHandle? _registeredWaitHandle;
 
         private static bool _startedFromPowerToys;
 
         public static Mutex? LockMutex { get; set; }
 
-        private static ConsoleEventHandler? _handler;
+#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
+        private static ConsoleEventHandler _handler;
         private static SystemPowerCapabilities _powerCapabilities;
+#pragma warning restore CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
 
         private static async Task<int> Main(string[] args)
         {
-            Logger.InitializeLogger(Path.Combine("\\", Core.Constants.AppName, "Logs"));
-
             var rootCommand = BuildRootCommand();
 
             Bridge.AttachConsole(Core.Native.Constants.ATTACH_PARENT_PROCESS);
@@ -75,6 +73,8 @@ namespace Awake
 
             LockMutex = new Mutex(true, Core.Constants.AppName, out bool instantiated);
 
+            Logger.InitializeLogger(Path.Combine("\\", Core.Constants.AppName, "Logs"));
+
             try
             {
                 string appLanguage = LanguageHelper.LoadLanguage();
@@ -140,7 +140,7 @@ namespace Awake
                 IsRequired = false,
             };
 
-            Option<bool> displayOption = new(_aliasesDisplayOption, () => false, Resources.AWAKE_CMD_HELP_DISPLAY_OPTION)
+            Option<bool> displayOption = new(_aliasesDisplayOption, () => true, Resources.AWAKE_CMD_HELP_DISPLAY_OPTION)
             {
                 Arity = ArgumentArity.ZeroOrOne,
                 IsRequired = false,
@@ -235,23 +235,10 @@ namespace Awake
         private static void Exit(string message, int exitCode)
         {
             _etwTrace?.Dispose();
-            DisposeFileSystemWatcher();
-            _registeredWaitHandle?.Unregister(null);
-            _exitEventHandle?.Dispose();
             Logger.LogInfo(message);
             Manager.CompleteExit(exitCode);
         }
 
-        private static void DisposeFileSystemWatcher()
-        {
-            if (_watcher != null)
-            {
-                _watcher.EnableRaisingEvents = false;
-                _watcher.Dispose();
-                _watcher = null;
-            }
-        }
-
         private static bool ProcessExists(int processId)
         {
             if (processId <= 0)
@@ -265,15 +252,8 @@ namespace Awake
                 using var p = Process.GetProcessById(processId);
                 return !p.HasExited;
             }
-            catch (ArgumentException)
+            catch
             {
-                // Process with the specified ID is not running
-                return false;
-            }
-            catch (InvalidOperationException ex)
-            {
-                // Process has exited or cannot be accessed
-                Logger.LogInfo($"Process {processId} cannot be accessed: {ex.Message}");
                 return false;
             }
         }
@@ -302,13 +282,12 @@ namespace Awake
             // Start the monitor thread that will be used to track the current state.
             Manager.StartMonitor();
 
-            _exitEventHandle = new EventWaitHandle(false, EventResetMode.ManualReset, PowerToys.Interop.Constants.AwakeExitEvent());
-            _registeredWaitHandle = ThreadPool.RegisterWaitForSingleObject(
-                _exitEventHandle,
-                (state, timedOut) => Exit(Resources.AWAKE_EXIT_SIGNAL_MESSAGE, 0),
-                null,
-                Timeout.Infinite,
-                executeOnlyOnce: true);
+            EventWaitHandle eventHandle = new(false, EventResetMode.ManualReset, PowerToys.Interop.Constants.AwakeExitEvent());
+            new Thread(() =>
+            {
+                WaitHandle.WaitAny([eventHandle]);
+                Exit(Resources.AWAKE_EXIT_SIGNAL_MESSAGE, 0);
+            }).Start();
 
             if (usePtConfig)
             {
@@ -453,7 +432,7 @@ namespace Awake
         {
             Manager.AllocateConsole();
 
-            _handler = new ConsoleEventHandler(ExitHandler);
+            _handler += new ConsoleEventHandler(ExitHandler);
             Manager.SetConsoleControlHandler(_handler, true);
 
             Trace.Listeners.Add(new ConsoleTraceListener());
@@ -549,11 +528,6 @@ namespace Awake
                         {
                             settings.Properties.ExpirationDateTime = DateTimeOffset.Now.AddMinutes(5);
                             _settingsUtils.SaveSettings(JsonSerializer.Serialize(settings), Core.Constants.AppName);
-
-                            // Return here - the FileSystemWatcher will re-trigger ProcessSettings
-                            // with the corrected expiration time, which will then call SetExpirableKeepAwake.
-                            // This matches the pattern used by mode setters (e.g., SetExpirableKeepAwake line 292).
-                            return;
                         }
 
                         Manager.SetExpirableKeepAwake(settings.Properties.ExpirationDateTime, settings.Properties.KeepDisplayOn);

src/modules/awake/Awake/Properties/Resources.Designer.cs

@@ -60,6 +60,15 @@ namespace Awake.Properties {
             }
         }
         
+        /// <summary>
+        ///   Looks up a localized string similar to Checked.
+        /// </summary>
+        internal static string AWAKE_CHECKED {
+            get {
+                return ResourceManager.GetString("AWAKE_CHECKED", resourceCulture);
+            }
+        }
+        
         /// <summary>
         ///   Looks up a localized string similar to Specifies whether Awake will be using the PowerToys configuration file for managing the state..
         /// </summary>
@@ -231,6 +240,42 @@ namespace Awake.Properties {
             }
         }
         
+        /// <summary>
+        ///   Looks up a localized string similar to d.
+        /// </summary>
+        internal static string AWAKE_LABEL_DAYS {
+            get {
+                return ResourceManager.GetString("AWAKE_LABEL_DAYS", resourceCulture);
+            }
+        }
+        
+        /// <summary>
+        ///   Looks up a localized string similar to h.
+        /// </summary>
+        internal static string AWAKE_LABEL_HOURS {
+            get {
+                return ResourceManager.GetString("AWAKE_LABEL_HOURS", resourceCulture);
+            }
+        }
+        
+        /// <summary>
+        ///   Looks up a localized string similar to m.
+        /// </summary>
+        internal static string AWAKE_LABEL_MINUTES {
+            get {
+                return ResourceManager.GetString("AWAKE_LABEL_MINUTES", resourceCulture);
+            }
+        }
+        
+        /// <summary>
+        ///   Looks up a localized string similar to s.
+        /// </summary>
+        internal static string AWAKE_LABEL_SECONDS {
+            get {
+                return ResourceManager.GetString("AWAKE_LABEL_SECONDS", resourceCulture);
+            }
+        }
+        
         /// <summary>
         ///   Looks up a localized string similar to {0} minute.
         /// </summary>
@@ -275,16 +320,7 @@ namespace Awake.Properties {
                 return ResourceManager.GetString("AWAKE_SCREEN_ON", resourceCulture);
             }
         }
-
-        /// <summary>
-        ///   Looks up a localized string similar to Screen.
-        /// </summary>
-        internal static string AWAKE_TRAY_DISPLAY {
-            get {
-                return ResourceManager.GetString("AWAKE_TRAY_DISPLAY", resourceCulture);
-            }
-        }
-
+        
         /// <summary>
         ///   Looks up a localized string similar to Expiring.
         /// </summary>
@@ -293,7 +329,7 @@ namespace Awake.Properties {
                 return ResourceManager.GetString("AWAKE_TRAY_TEXT_EXPIRATION", resourceCulture);
             }
         }
-
+        
         /// <summary>
         ///   Looks up a localized string similar to Indefinite.
         /// </summary>
@@ -302,7 +338,7 @@ namespace Awake.Properties {
                 return ResourceManager.GetString("AWAKE_TRAY_TEXT_INDEFINITE", resourceCulture);
             }
         }
-
+        
         /// <summary>
         ///   Looks up a localized string similar to Passive.
         /// </summary>
@@ -311,31 +347,31 @@ namespace Awake.Properties {
                 return ResourceManager.GetString("AWAKE_TRAY_TEXT_OFF", resourceCulture);
             }
         }
-
+        
         /// <summary>
-        ///   Looks up a localized string similar to Timed.
+        ///   Looks up a localized string similar to Bound to.
+        /// </summary>
+        internal static string AWAKE_TRAY_TEXT_PID_BINDING {
+            get {
+                return ResourceManager.GetString("AWAKE_TRAY_TEXT_PID_BINDING", resourceCulture);
+            }
+        }
+        
+        /// <summary>
+        ///   Looks up a localized string similar to Interval.
         /// </summary>
         internal static string AWAKE_TRAY_TEXT_TIMED {
             get {
                 return ResourceManager.GetString("AWAKE_TRAY_TEXT_TIMED", resourceCulture);
             }
         }
-
+        
         /// <summary>
-        ///   Looks up a localized string similar to Until.
+        ///   Looks up a localized string similar to Unchecked.
         /// </summary>
-        internal static string AWAKE_TRAY_UNTIL {
+        internal static string AWAKE_UNCHECKED {
             get {
-                return ResourceManager.GetString("AWAKE_TRAY_UNTIL", resourceCulture);
-            }
-        }
-
-        /// <summary>
-        ///   Looks up a localized string similar to remaining.
-        /// </summary>
-        internal static string AWAKE_TRAY_REMAINING {
-            get {
-                return ResourceManager.GetString("AWAKE_TRAY_REMAINING", resourceCulture);
+                return ResourceManager.GetString("AWAKE_UNCHECKED", resourceCulture);
             }
         }
     }

src/modules/awake/Awake/Properties/Resources.resx

@@ -117,6 +117,9 @@
   <resheader name="writer">
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
+  <data name="AWAKE_CHECKED" xml:space="preserve">
+    <value>Checked</value>
+  </data>
   <data name="AWAKE_EXIT" xml:space="preserve">
     <value>Exit</value>
   </data>
@@ -155,6 +158,9 @@
     <value>Off (keep using the selected power plan)</value>
     <comment>Don't keep the system awake, use the selected system power plan</comment>
   </data>
+  <data name="AWAKE_UNCHECKED" xml:space="preserve">
+    <value>Unchecked</value>
+  </data>
   <data name="AWAKE_CMD_HELP_CONFIG_OPTION" xml:space="preserve">
     <value>Specifies whether Awake will be using the PowerToys configuration file for managing the state.</value>
   </data>
@@ -189,11 +195,31 @@
     <value>Passive</value>
   </data>
   <data name="AWAKE_TRAY_TEXT_TIMED" xml:space="preserve">
-    <value>Timed</value>
+    <value>Interval</value>
+  </data>
+  <data name="AWAKE_LABEL_DAYS" xml:space="preserve">
+    <value>d</value>
+    <comment>Used to display number of days in the system tray tooltip.</comment>
+  </data>
+  <data name="AWAKE_LABEL_HOURS" xml:space="preserve">
+    <value>h</value>
+    <comment>Used to display number of hours in the system tray tooltip.</comment>
+  </data>
+  <data name="AWAKE_LABEL_MINUTES" xml:space="preserve">
+    <value>m</value>
+    <comment>Used to display number of minutes in the system tray tooltip.</comment>
+  </data>
+  <data name="AWAKE_LABEL_SECONDS" xml:space="preserve">
+    <value>s</value>
+    <comment>Used to display number of seconds in the system tray tooltip.</comment>
   </data>
   <data name="AWAKE_CMD_PARENT_PID_OPTION" xml:space="preserve">
     <value>Uses the parent process as the bound target - once the process terminates, Awake stops.</value>
   </data>
+  <data name="AWAKE_TRAY_TEXT_PID_BINDING" xml:space="preserve">
+    <value>Bound to</value>
+    <comment>Describes the process ID Awake is bound to when running.</comment>
+  </data>
   <data name="AWAKE_SCREEN_ON" xml:space="preserve">
     <value>On</value>
   </data>
@@ -209,16 +235,4 @@
   <data name="AWAKE_EXIT_BIND_TO_SELF_FAILURE_MESSAGE" xml:space="preserve">
     <value>Exiting because the provided process ID is Awake's own.</value>
   </data>
-  <data name="AWAKE_TRAY_DISPLAY" xml:space="preserve">
-    <value>Screen</value>
-    <comment>Label for the screen/display line in tray tooltip.</comment>
-  </data>
-  <data name="AWAKE_TRAY_UNTIL" xml:space="preserve">
-    <value>Until</value>
-    <comment>Label for expiration mode showing end date/time.</comment>
-  </data>
-  <data name="AWAKE_TRAY_REMAINING" xml:space="preserve">
-    <value>remaining</value>
-    <comment>Suffix for timed mode showing time remaining, e.g. "1:30:00 remaining".</comment>
-  </data>
 </root>

src/modules/awake/README.md

@@ -1,168 +0,0 @@
-# PowerToys Awake Module
-
-A PowerToys utility that prevents Windows from sleeping and/or turning off the display.
-
-**Author:** [Den Delimarsky](https://den.dev)
-
-## Resources
-
-- [Awake Website](https://awake.den.dev) - Official documentation and guides
-- [Microsoft Learn Documentation](https://learn.microsoft.com/windows/powertoys/awake) - Usage instructions and feature overview
-- [GitHub Issues](https://github.com/microsoft/PowerToys/issues?q=is%3Aissue+label%3AProduct-Awake) - Report bugs or request features
-
-## Overview
-
-The Awake module consists of three projects:
-
-| Project | Purpose |
-|---------|---------|
-| `Awake/` | Main WinExe application with CLI support |
-| `Awake.ModuleServices/` | Service layer for PowerToys integration |
-| `AwakeModuleInterface/` | C++ native module bridge |
-
-## How It Works
-
-The module uses the Win32 `SetThreadExecutionState()` API to signal Windows that the system should remain awake:
-
-- `ES_SYSTEM_REQUIRED` - Prevents system sleep
-- `ES_DISPLAY_REQUIRED` - Prevents display sleep
-- `ES_CONTINUOUS` - Maintains state until explicitly changed
-
-## Operating Modes
-
-| Mode | Description |
-|------|-------------|
-| **PASSIVE** | Normal power behavior (off) |
-| **INDEFINITE** | Keep awake until manually stopped |
-| **TIMED** | Keep awake for a specified duration |
-| **EXPIRABLE** | Keep awake until a specific date/time |
-
-## Command-Line Usage
-
-Awake can be run standalone with the following options:
-
-```
-PowerToys.Awake.exe [options]
-
-Options:
-  -c, --use-pt-config    Use PowerToys configuration file
-  -d, --display-on       Keep display on (default: false)
-  -t, --time-limit       Time limit in seconds
-  -p, --pid              Process ID to bind to
-  -e, --expire-at        Expiration date/time
-  -u, --use-parent-pid   Bind to parent process
-```
-
-### Examples
-
-Keep system awake indefinitely:
-```powershell
-PowerToys.Awake.exe
-```
-
-Keep awake for 1 hour with display on:
-```powershell
-PowerToys.Awake.exe --time-limit 3600 --display-on
-```
-
-Keep awake until a specific time:
-```powershell
-PowerToys.Awake.exe --expire-at "2024-12-31 23:59:59"
-```
-
-Keep awake while another process is running:
-```powershell
-PowerToys.Awake.exe --pid 1234
-```
-
-## Architecture
-
-### Design Highlights
-
-1. **Pure Win32 API for Tray UI** - No WPF/WinForms dependencies, keeping the binary small. Uses direct `Shell_NotifyIcon` API for tray icon management.
-
-2. **Reactive Extensions (Rx.NET)** - Used for timed operations via `Observable.Interval()` and `Observable.Timer()`. File system watching uses 25ms throttle to debounce rapid config changes.
-
-3. **Custom SynchronizationContext** - Queue-based message dispatch ensures tray operations run on a dedicated thread for thread-safe UI updates.
-
-4. **Dual-Mode Operation**
-   - Standalone: Command-line arguments only
-   - Integrated: PowerToys settings file + process binding
-
-5. **Process Binding** - The `--pid` parameter keeps the system awake only while a target process runs, with auto-exit when the parent PowerToys runner terminates.
-
-## Key Files
-
-| File | Purpose |
-|------|---------|
-| `Program.cs` | Entry point & CLI parsing |
-| `Core/Manager.cs` | State orchestration & power management |
-| `Core/TrayHelper.cs` | System tray UI management |
-| `Core/Native/Bridge.cs` | Win32 P/Invoke declarations |
-| `Core/Threading/SingleThreadSynchronizationContext.cs` | Threading utilities |
-
-## Building
-
-### Prerequisites
-
-- Visual Studio 2022 with C++ and .NET workloads
-- Windows SDK 10.0.26100.0 or later
-
-### Build Commands
-
-From the `src/modules/awake` directory:
-
-```powershell
-# Using the build script
-.\scripts\Build-Awake.ps1
-
-# Or with specific configuration
-.\scripts\Build-Awake.ps1 -Configuration Debug -Platform x64
-```
-
-Or using MSBuild directly:
-
-```powershell
-msbuild Awake\Awake.csproj /p:Configuration=Release /p:Platform=x64
-```
-
-## Dependencies
-
-- **System.CommandLine** - Command-line parsing
-- **System.Reactive** - Rx.NET for timer management
-- **PowerToys.ManagedCommon** - Shared PowerToys utilities
-- **PowerToys.Settings.UI.Lib** - Settings integration
-- **PowerToys.Interop** - Native interop layer
-
-## Configuration
-
-When running with PowerToys (`--use-pt-config`), settings are stored in:
-```
-%LOCALAPPDATA%\Microsoft\PowerToys\Awake\settings.json
-```
-
-## Known Limitations
-
-### Task Scheduler Idle Detection ([#44134](https://github.com/microsoft/PowerToys/issues/44134))
-
-When "Keep display on" is enabled, Awake uses the `ES_DISPLAY_REQUIRED` flag which blocks Windows Task Scheduler from detecting the system as idle. This prevents scheduled maintenance tasks (like SSD TRIM, disk defragmentation, and other idle-triggered tasks) from running.
-
-Per [Microsoft's documentation](https://learn.microsoft.com/en-us/windows/win32/taskschd/task-idle-conditions):
-
-> "An exception would be for any presentation type application that sets the ES_DISPLAY_REQUIRED flag. This flag forces Task Scheduler to not consider the system as being idle, regardless of user activity or resource consumption."
-
-**Workarounds:**
-
-1. **Disable "Keep display on"** - With this setting off, Awake only uses `ES_SYSTEM_REQUIRED` which still prevents sleep but allows Task Scheduler to detect idle state.
-
-2. **Manually run maintenance tasks** - For example, to run TRIM manually:
-   ```powershell
-   # Run as Administrator
-   Optimize-Volume -DriveLetter C -ReTrim -Verbose
-   ```
-
-## Telemetry
-
-The module emits telemetry events for:
-- Keep-awake mode changes (indefinite, timed, expirable, passive)
-- Privacy-compliant event tagging via `Microsoft.PowerToys.Telemetry`

src/modules/awake/scripts/Build-Awake.ps1

@@ -1,456 +0,0 @@
-<#
-.SYNOPSIS
-    Builds the PowerToys Awake module.
-
-.DESCRIPTION
-    This script builds the Awake module and its dependencies using MSBuild.
-    It automatically locates the Visual Studio installation and uses the
-    appropriate MSBuild version.
-
-.PARAMETER Configuration
-    The build configuration. Valid values are 'Debug' or 'Release'.
-    Default: Release
-
-.PARAMETER Platform
-    The target platform. Valid values are 'x64' or 'ARM64'.
-    Default: x64
-
-.PARAMETER Clean
-    If specified, cleans the build output before building.
-
-.PARAMETER Restore
-    If specified, restores NuGet packages before building.
-
-.EXAMPLE
-    .\Build-Awake.ps1
-    Builds Awake in Release configuration for x64.
-
-.EXAMPLE
-    .\Build-Awake.ps1 -Configuration Debug
-    Builds Awake in Debug configuration for x64.
-
-.EXAMPLE
-    .\Build-Awake.ps1 -Clean -Restore
-    Cleans, restores packages, and builds Awake.
-
-.EXAMPLE
-    .\Build-Awake.ps1 -Platform ARM64
-    Builds Awake for ARM64 architecture.
-#>
-
-[CmdletBinding()]
-param(
-    [ValidateSet('Debug', 'Release')]
-    [string]$Configuration = 'Release',
-
-    [ValidateSet('x64', 'ARM64')]
-    [string]$Platform = 'x64',
-
-    [switch]$Clean,
-
-    [switch]$Restore
-)
-
-# Force UTF-8 output for Unicode characters
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-$OutputEncoding = [System.Text.Encoding]::UTF8
-
-$ErrorActionPreference = 'Stop'
-$script:StartTime = Get-Date
-
-# Get script directory and project paths
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ModuleDir = Split-Path -Parent $ScriptDir
-$RepoRoot = Resolve-Path (Join-Path $ModuleDir "..\..\..") | Select-Object -ExpandProperty Path
-$AwakeProject = Join-Path $ModuleDir "Awake\Awake.csproj"
-$ModuleServicesProject = Join-Path $ModuleDir "Awake.ModuleServices\Awake.ModuleServices.csproj"
-
-# ============================================================================
-# Modern UI Components
-# ============================================================================
-
-$script:Colors = @{
-    Primary   = "Cyan"
-    Success   = "Green"
-    Error     = "Red"
-    Warning   = "Yellow"
-    Muted     = "DarkGray"
-    Accent    = "Magenta"
-    White     = "White"
-}
-
-# Box drawing characters (not emojis)
-$script:UI = @{
-    BoxH   = [char]0x2500  # Horizontal line
-    BoxV   = [char]0x2502  # Vertical line
-    BoxTL  = [char]0x256D  # Top-left corner (rounded)
-    BoxTR  = [char]0x256E  # Top-right corner (rounded)
-    BoxBL  = [char]0x2570  # Bottom-left corner (rounded)
-    BoxBR  = [char]0x256F  # Bottom-right corner (rounded)
-    TreeL  = [char]0x2514  # Tree last item
-    TreeT  = [char]0x251C  # Tree item
-}
-
-# Braille spinner frames (the npm-style spinner)
-$script:SpinnerFrames = @(
-    [char]0x280B,  # ⠋
-    [char]0x2819,  # ⠙
-    [char]0x2839,  # ⠹
-    [char]0x2838,  # ⠸
-    [char]0x283C,  # ⠼
-    [char]0x2834,  # ⠴
-    [char]0x2826,  # ⠦
-    [char]0x2827,  # ⠧
-    [char]0x2807,  # ⠇
-    [char]0x280F   # ⠏
-)
-
-function Get-ElapsedTime {
-    $elapsed = (Get-Date) - $script:StartTime
-    if ($elapsed.TotalSeconds -lt 60) {
-        return "$([math]::Round($elapsed.TotalSeconds, 1))s"
-    } else {
-        return "$([math]::Floor($elapsed.TotalMinutes))m $($elapsed.Seconds)s"
-    }
-}
-
-function Write-Header {
-    Write-Host ""
-    Write-Host "   Awake Build" -ForegroundColor $Colors.White
-    Write-Host "   $Platform / $Configuration" -ForegroundColor $Colors.Muted
-    Write-Host ""
-}
-
-function Write-Phase {
-    param([string]$Name)
-    Write-Host ""
-    Write-Host "   $Name" -ForegroundColor $Colors.Accent
-    Write-Host ""
-}
-
-function Write-Task {
-    param([string]$Name, [switch]$Last)
-    $tree = if ($Last) { $UI.TreeL } else { $UI.TreeT }
-    Write-Host "   $tree$($UI.BoxH)$($UI.BoxH) " -NoNewline -ForegroundColor $Colors.Muted
-    Write-Host $Name -NoNewline -ForegroundColor $Colors.White
-}
-
-function Write-TaskStatus {
-    param([string]$Status, [string]$Time, [switch]$Failed)
-    if ($Failed) {
-        Write-Host " FAIL" -ForegroundColor $Colors.Error
-    } else {
-        Write-Host " " -NoNewline
-        Write-Host $Status -NoNewline -ForegroundColor $Colors.Success
-        if ($Time) {
-            Write-Host " ($Time)" -ForegroundColor $Colors.Muted
-        } else {
-            Write-Host ""
-        }
-    }
-}
-
-function Write-BuildTree {
-    param([string[]]$Items)
-    $count = $Items.Count
-    for ($i = 0; $i -lt $count; $i++) {
-        $isLast = ($i -eq $count - 1)
-        $tree = if ($isLast) { $UI.TreeL } else { $UI.TreeT }
-        Write-Host "      $tree$($UI.BoxH) " -NoNewline -ForegroundColor $Colors.Muted
-        Write-Host $Items[$i] -ForegroundColor $Colors.Muted
-    }
-}
-
-function Write-SuccessBox {
-    param([string]$Time, [string]$Output, [string]$Size)
-
-    $width = 44
-    $lineChar = [string]$UI.BoxH
-    $line = $lineChar * ($width - 2)
-
-    Write-Host ""
-    Write-Host "   $($UI.BoxTL)$line$($UI.BoxTR)" -ForegroundColor $Colors.Success
-
-    # Title row
-    $title = "  BUILD SUCCESSFUL"
-    $titlePadding = $width - 2 - $title.Length
-    Write-Host "   $($UI.BoxV)" -NoNewline -ForegroundColor $Colors.Success
-    Write-Host $title -NoNewline -ForegroundColor $Colors.White
-    Write-Host (" " * $titlePadding) -NoNewline
-    Write-Host "$($UI.BoxV)" -ForegroundColor $Colors.Success
-
-    # Empty row
-    Write-Host "   $($UI.BoxV)" -NoNewline -ForegroundColor $Colors.Success
-    Write-Host (" " * ($width - 2)) -NoNewline
-    Write-Host "$($UI.BoxV)" -ForegroundColor $Colors.Success
-
-    # Time row
-    $timeText = "  Completed in $Time"
-    $timePadding = $width - 2 - $timeText.Length
-    Write-Host "   $($UI.BoxV)" -NoNewline -ForegroundColor $Colors.Success
-    Write-Host $timeText -NoNewline -ForegroundColor $Colors.Muted
-    Write-Host (" " * $timePadding) -NoNewline
-    Write-Host "$($UI.BoxV)" -ForegroundColor $Colors.Success
-
-    # Output row
-    $outText = "  Output: $Output ($Size)"
-    if ($outText.Length -gt ($width - 2)) {
-        $outText = $outText.Substring(0, $width - 5) + "..."
-    }
-    $outPadding = $width - 2 - $outText.Length
-    if ($outPadding -lt 0) { $outPadding = 0 }
-    Write-Host "   $($UI.BoxV)" -NoNewline -ForegroundColor $Colors.Success
-    Write-Host $outText -NoNewline -ForegroundColor $Colors.Muted
-    Write-Host (" " * $outPadding) -NoNewline
-    Write-Host "$($UI.BoxV)" -ForegroundColor $Colors.Success
-
-    Write-Host "   $($UI.BoxBL)$line$($UI.BoxBR)" -ForegroundColor $Colors.Success
-    Write-Host ""
-}
-
-function Write-ErrorBox {
-    param([string]$Message)
-
-    $width = 44
-    $lineChar = [string]$UI.BoxH
-    $line = $lineChar * ($width - 2)
-
-    Write-Host ""
-    Write-Host "   $($UI.BoxTL)$line$($UI.BoxTR)" -ForegroundColor $Colors.Error
-    $title = "  BUILD FAILED"
-    $titlePadding = $width - 2 - $title.Length
-    Write-Host "   $($UI.BoxV)" -NoNewline -ForegroundColor $Colors.Error
-    Write-Host $title -NoNewline -ForegroundColor $Colors.White
-    Write-Host (" " * $titlePadding) -NoNewline
-    Write-Host "$($UI.BoxV)" -ForegroundColor $Colors.Error
-    Write-Host "   $($UI.BoxBL)$line$($UI.BoxBR)" -ForegroundColor $Colors.Error
-    Write-Host ""
-}
-
-# ============================================================================
-# Build Functions
-# ============================================================================
-
-function Find-MSBuild {
-    $vsWherePath = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe"
-
-    if (Test-Path $vsWherePath) {
-        $vsPath = & $vsWherePath -latest -requires Microsoft.Component.MSBuild -property installationPath
-        if ($vsPath) {
-            $msbuildPath = Join-Path $vsPath "MSBuild\Current\Bin\MSBuild.exe"
-            if (Test-Path $msbuildPath) {
-                return $msbuildPath
-            }
-        }
-    }
-
-    $commonPaths = @(
-        "${env:ProgramFiles}\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin\MSBuild.exe",
-        "${env:ProgramFiles}\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\MSBuild.exe",
-        "${env:ProgramFiles}\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe",
-        "${env:ProgramFiles}\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe"
-    )
-
-    foreach ($path in $commonPaths) {
-        if (Test-Path $path) {
-            return $path
-        }
-    }
-
-    throw "MSBuild not found. Please install Visual Studio 2022."
-}
-
-function Invoke-BuildWithSpinner {
-    param(
-        [string]$TaskName,
-        [string]$MSBuildPath,
-        [string[]]$Arguments,
-        [switch]$ShowProjects,
-        [switch]$IsLast
-    )
-
-    $taskStart = Get-Date
-    $isInteractive = [Environment]::UserInteractive -and -not [Console]::IsOutputRedirected
-
-    # Only write initial task line in interactive mode (will be overwritten by spinner)
-    if ($isInteractive) {
-        Write-Task $TaskName -Last:$IsLast
-        Write-Host " " -NoNewline
-    }
-
-    # Start MSBuild process
-    $psi = New-Object System.Diagnostics.ProcessStartInfo
-    $psi.FileName = $MSBuildPath
-    $psi.Arguments = $Arguments -join " "
-    $psi.UseShellExecute = $false
-    $psi.RedirectStandardOutput = $true
-    $psi.RedirectStandardError = $true
-    $psi.CreateNoWindow = $true
-    $psi.WorkingDirectory = $RepoRoot
-
-    $process = New-Object System.Diagnostics.Process
-    $process.StartInfo = $psi
-
-    # Collect output asynchronously
-    $outputBuilder = [System.Text.StringBuilder]::new()
-    $errorBuilder = [System.Text.StringBuilder]::new()
-
-    $outputHandler = {
-        if (-not [String]::IsNullOrEmpty($EventArgs.Data)) {
-            $Event.MessageData.AppendLine($EventArgs.Data)
-        }
-    }
-
-    $outputEvent = Register-ObjectEvent -InputObject $process -EventName OutputDataReceived -Action $outputHandler -MessageData $outputBuilder
-    $errorEvent = Register-ObjectEvent -InputObject $process -EventName ErrorDataReceived -Action $outputHandler -MessageData $errorBuilder
-
-    $process.Start() | Out-Null
-    $process.BeginOutputReadLine()
-    $process.BeginErrorReadLine()
-
-    # Animate spinner while process is running
-    $frameIndex = 0
-
-    while (-not $process.HasExited) {
-        if ($isInteractive) {
-            $frame = $script:SpinnerFrames[$frameIndex]
-            Write-Host "`r   $($UI.TreeL)$($UI.BoxH)$($UI.BoxH) $TaskName $frame " -NoNewline
-            $frameIndex = ($frameIndex + 1) % $script:SpinnerFrames.Count
-        }
-        Start-Sleep -Milliseconds 80
-    }
-
-    $process.WaitForExit()
-
-    Unregister-Event -SourceIdentifier $outputEvent.Name
-    Unregister-Event -SourceIdentifier $errorEvent.Name
-    Remove-Job -Name $outputEvent.Name -Force -ErrorAction SilentlyContinue
-    Remove-Job -Name $errorEvent.Name -Force -ErrorAction SilentlyContinue
-
-    $exitCode = $process.ExitCode
-    $output = $outputBuilder.ToString() -split "`n"
-    $errors = $errorBuilder.ToString()
-
-    $taskElapsed = (Get-Date) - $taskStart
-    $elapsed = "$([math]::Round($taskElapsed.TotalSeconds, 1))s"
-
-    # Write final status line
-    $tree = if ($IsLast) { $UI.TreeL } else { $UI.TreeT }
-    if ($isInteractive) {
-        Write-Host "`r" -NoNewline
-    }
-    Write-Host "   $tree$($UI.BoxH)$($UI.BoxH) " -NoNewline -ForegroundColor $Colors.Muted
-    Write-Host $TaskName -NoNewline -ForegroundColor $Colors.White
-
-    if ($exitCode -ne 0) {
-        Write-TaskStatus "FAIL" -Failed
-        Write-Host ""
-        foreach ($line in $output) {
-            if ($line -match "error\s+\w+\d*:") {
-                Write-Host "      x $line" -ForegroundColor $Colors.Error
-            }
-        }
-        return @{ Success = $false; Output = $output; ExitCode = $exitCode }
-    }
-
-    Write-TaskStatus "done" $elapsed
-
-    # Show built projects
-    if ($ShowProjects) {
-        $projects = @()
-        foreach ($line in $output) {
-            if ($line -match "^\s*(\S+)\s+->\s+(.+)$") {
-                $project = $Matches[1]
-                $fileName = Split-Path $Matches[2] -Leaf
-                $projects += "$project -> $fileName"
-            }
-        }
-        if ($projects.Count -gt 0) {
-            Write-BuildTree $projects
-        }
-    }
-
-    return @{ Success = $true; Output = $output; ExitCode = 0 }
-}
-
-# ============================================================================
-# Main
-# ============================================================================
-
-# Verify project exists
-if (-not (Test-Path $AwakeProject)) {
-    Write-Host ""
-    Write-Host "   x Project not found: $AwakeProject" -ForegroundColor $Colors.Error
-    exit 1
-}
-
-$MSBuild = Find-MSBuild
-
-# Display header
-Write-Header
-
-# Build arguments base
-$BaseArgs = @(
-    "/p:Configuration=$Configuration",
-    "/p:Platform=$Platform",
-    "/v:minimal",
-    "/nologo",
-    "/m"
-)
-
-# Clean phase
-if ($Clean) {
-    Write-Phase "Cleaning"
-    $cleanArgs = @($AwakeProject) + $BaseArgs + @("/t:Clean")
-    $result = Invoke-BuildWithSpinner -TaskName "Build artifacts" -MSBuildPath $MSBuild -Arguments $cleanArgs -IsLast
-    if (-not $result.Success) {
-        Write-ErrorBox
-        exit $result.ExitCode
-    }
-}
-
-# Restore phase
-if ($Restore) {
-    Write-Phase "Restoring"
-    $restoreArgs = @($AwakeProject) + $BaseArgs + @("/t:Restore")
-    $result = Invoke-BuildWithSpinner -TaskName "NuGet packages" -MSBuildPath $MSBuild -Arguments $restoreArgs -IsLast
-    if (-not $result.Success) {
-        Write-ErrorBox
-        exit $result.ExitCode
-    }
-}
-
-# Build phase
-Write-Phase "Building"
-
-$hasModuleServices = Test-Path $ModuleServicesProject
-
-# Build Awake
-$awakeArgs = @($AwakeProject) + $BaseArgs + @("/t:Build")
-$result = Invoke-BuildWithSpinner -TaskName "Awake" -MSBuildPath $MSBuild -Arguments $awakeArgs -ShowProjects -IsLast:(-not $hasModuleServices)
-if (-not $result.Success) {
-    Write-ErrorBox
-    exit $result.ExitCode
-}
-
-# Build ModuleServices
-if ($hasModuleServices) {
-    $servicesArgs = @($ModuleServicesProject) + $BaseArgs + @("/t:Build")
-    $result = Invoke-BuildWithSpinner -TaskName "Awake.ModuleServices" -MSBuildPath $MSBuild -Arguments $servicesArgs -ShowProjects -IsLast
-    if (-not $result.Success) {
-        Write-ErrorBox
-        exit $result.ExitCode
-    }
-}
-
-# Summary
-$OutputDir = Join-Path $RepoRoot "$Platform\$Configuration"
-$AwakeDll = Join-Path $OutputDir "PowerToys.Awake.dll"
-$elapsed = Get-ElapsedTime
-
-if (Test-Path $AwakeDll) {
-    $size = "$([math]::Round((Get-Item $AwakeDll).Length / 1KB, 1)) KB"
-    Write-SuccessBox -Time $elapsed -Output "PowerToys.Awake.dll" -Size $size
-} else {
-    Write-SuccessBox -Time $elapsed -Output $OutputDir -Size "N/A"
-}

src/modules/cmdpal/Core/Microsoft.CmdPal.Core.ViewModels/ListViewModel.cs

@@ -486,11 +486,6 @@ public partial class ListViewModel : PageViewModel, IDisposable
     {
         if (!item.SafeSlowInit())
         {
-            // Even if initialization fails, we need to hide any previously shown details
-            DoOnUiThread(() =>
-            {
-                WeakReferenceMessenger.Default.Send<HideDetailsMessage>();
-            });
             return;
         }
 

src/modules/cmdpal/ExtensionTemplate/TemplateCmdPalExtension/Directory.Packages.props

@@ -5,12 +5,12 @@
   <ItemGroup>
     <PackageVersion Include="Microsoft.CommandPalette.Extensions" Version="0.5.250829002" />
     <PackageVersion Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="9.0.0-preview.24508.2" />
-    <PackageVersion Include="Microsoft.Web.WebView2" Version="1.0.3405.78" />
+    <PackageVersion Include="Microsoft.Web.WebView2" Version="1.0.2903.40" />
     <PackageVersion Include="Microsoft.Windows.CsWin32" Version="0.3.183" />
     <PackageVersion Include="Microsoft.Windows.CsWinRT" Version="2.2.0" />
     <PackageVersion Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.4188" />
     <PackageVersion Include="Microsoft.Windows.SDK.BuildTools.MSIX" Version="1.7.20250829.1" />
-    <PackageVersion Include="Microsoft.WindowsAppSDK" Version="2.0.0-experimental3" />
+    <PackageVersion Include="Microsoft.WindowsAppSDK" Version="1.8.250907003" />
     <PackageVersion Include="Shmuelie.WinRTServer" Version="2.1.1" />
     <PackageVersion Include="StyleCop.Analyzers" Version="1.2.0-beta.556" />
     <PackageVersion Include="System.Text.Json" Version="9.0.8" />