feat(gui): add filter improvements, admin dimming, tree auto-sizing, HwInfo dialog

- Fix filter combo: add "Default" and "Errors" filter options with proper logic
- Dim admin-only tweaks when running without elevation (NeedsAdmin + Machine scope)
- Auto-size category tree splitter based on longest node text width
- Add "Hardware Info..." menu item under Help with detailed system info dialog
- Add UpdateAction delegate to TweakDef for package manager update support
- Add Update() method to TweakEngine (falls back to Apply if no UpdateAction)
- Add IsScoopInstalled() to HardwareInfo, extend IsApplicable for Scoop/M365
- Configure CSharpier formatter (.csharpierrc.json, VS Code settings)
- Enhance .env.ps1 with PSReadLine prediction and custom git-aware prompt
- Fix GUI launch.json: switch to integratedTerminal for .env.ps1 sourcing

Author: aeger

.csharpierrc.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://csharpier.com/schemas/v0.29.2/csharpier.schema.json",
+  "printWidth": 150,
+  "useTabs": false,
+  "tabWidth": 4,
+  "endOfLine": "lf"
+}

.env.ps1

@@ -97,4 +97,59 @@ Add-PathEntry "$env:USERPROFILE\.dotnet\tools"
 # ── Mark as loaded ──────────────────────────────────────────────────────────
 $env:REGILATTICE_ENV_LOADED = '1'
 
+# ── Convenience aliases for common project tasks ────────────────────
+if (-not (Get-Alias -Name 'rlbuild' -ErrorAction SilentlyContinue)) {
+    Set-Alias -Name 'rlbuild'  -Value { dotnet build RegiLattice.sln }.GetSteppablePipeline -Option ReadOnly -ErrorAction SilentlyContinue
+}
+function Invoke-RLBuild   { dotnet build RegiLattice.sln @args }
+function Invoke-RLTest    { dotnet test  RegiLattice.sln --logger "console;verbosity=normal" @args }
+function Invoke-RLGui     { dotnet run --project src/RegiLattice.GUI @args }
+function Invoke-RLCli     { dotnet run --project src/RegiLattice.CLI -- @args }
+
+# ── Tab completion for common dotnet arguments ──────────────────────
+$_rlTestProjects = @(
+    'tests/RegiLattice.Core.Tests'
+    'tests/RegiLattice.CLI.Tests'
+    'tests/RegiLattice.GUI.Tests'
+)
+
+Register-ArgumentCompleter -CommandName 'dotnet' -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+    $cmdText = $commandAst.ToString()
+    if ($cmdText -match 'dotnet\s+test\s+') {
+        $_rlTestProjects | Where-Object { $_ -like "$wordToComplete*" } |
+            ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+    }
+}
+
+# ── PSReadLine enhancements (prediction, history search) ────────────
+if (Get-Module -ListAvailable PSReadLine -ErrorAction SilentlyContinue) {
+    Set-PSReadLineOption -PredictionSource HistoryAndPlugin -ErrorAction SilentlyContinue
+    Set-PSReadLineOption -PredictionViewStyle ListView -ErrorAction SilentlyContinue
+    Set-PSReadLineKeyHandler -Key UpArrow   -Function HistorySearchBackward
+    Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward
+    Set-PSReadLineKeyHandler -Key Tab       -Function MenuComplete
+}
+
+# ── Custom prompt with git branch + command timing ──────────────────
+function global:prompt {
+    $exitCode = $LASTEXITCODE
+    $duration = ''
+    if ((Get-History -Count 1 -ErrorAction SilentlyContinue) -is [Microsoft.PowerShell.Commands.HistoryInfo]) {
+        $last = Get-History -Count 1
+        $ms   = ($last.EndExecutionTime - $last.StartExecutionTime).TotalMilliseconds
+        if ($ms -ge 1000) { $duration = " ($([math]::Round($ms / 1000, 1))s)" }
+        elseif ($ms -ge 100) { $duration = " ($([int]$ms)ms)" }
+    }
+    $branch = ''
+    if (Get-Command git -ErrorAction SilentlyContinue) {
+        $b = git rev-parse --abbrev-ref HEAD 2>$null
+        if ($b) { $branch = " ($b)" }
+    }
+    $cwd = (Get-Location).Path -replace [regex]::Escape($HOME), '~'
+    $arrow = if ($exitCode -eq 0 -or $null -eq $exitCode) { "`e[32m❯`e[0m" } else { "`e[31m❯`e[0m" }
+    "`e[36m$cwd`e[33m$branch`e[90m$duration`e[0m`n$arrow "
+}
+
 Write-Host "[.env.ps1] RegiLattice dev environment loaded — $(($env:PATH -split ';').Count) PATH entries" -ForegroundColor DarkCyan
+Write-Host "  Helpers: Invoke-RLBuild, Invoke-RLTest, Invoke-RLGui, Invoke-RLCli" -ForegroundColor DarkGray

.github/instructions/lessons-learned.instructions.md

@@ -4,9 +4,10 @@ applyTo: "**/*.cs,**/tests/**,**/*Tests/**"
 
 # Lessons Learned — RegiLattice Development
 
-> Accumulated hard-won insights from the Python → C# migration and iterative test coverage sprints.
+> Accumulated hard-won insights from the Python → C# migration, test coverage sprints,
+> and the 453-tweak restoration campaign.
 > These rules are **as important as the coding standards** — they prevent recurring mistakes.
-> Last updated: 2025-07-20 (v3.0.0, C# 13 / .NET 10.0-windows)
+> Last updated: 2025-07-21 (v3.1.5, C# 13 / .NET 10.0-windows, 1 882 tweaks, 72 categories)
 
 ---
 
@@ -42,7 +43,7 @@ WinForms controls require a message pump and are fragile in xUnit. Focus tests o
 ## Unique TweakDef IDs — Global Uniqueness Required
 
 `TweakEngine.Register()` throws `ArgumentException` on duplicate IDs.
-Every tweak ID across ALL 71 modules must be globally unique.
+Every tweak ID across ALL 72 modules must be globally unique.
 
 ```csharp
 // ❌ BAD — duplicate ID across modules will throw at registration
@@ -209,6 +210,109 @@ All references to the GitHub account must use `RajwanYair`:
 
 ## Version & Metadata
 
-- Version lives in `.csproj` files — `<Version>3.0.0</Version>`
+- Version lives in `.csproj` files — `<Version>3.1.5</Version>`
 - Do not duplicate version strings — single source of truth per project
 - GitHub URLs: `https://github.com/RajwanYair/RegiLattice`
+
+---
+
+## String Escape Sequences — Always Use Verbatim `@""`
+
+Registry paths and file paths must use verbatim strings to avoid escape sequence errors:
+
+```csharp
+// ✅ GOOD — verbatim string, no escape issues
+RegOp.SetDword(@"HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows Defender", "DisableAntiSpyware", 1)
+
+// ❌ BAD — \S, \P, \W are invalid escape sequences → CS1009
+RegOp.SetDword("HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows Defender", "DisableAntiSpyware", 1)
+```
+
+**Common trap**: When batch-editing tweak files, forgetting the `@` prefix on registry path strings.
+The C# compiler treats `\S`, `\P`, `\W`, `\D`, `\M` etc. as invalid escape sequences.
+
+---
+
+## Duplicate ID Detection — Check Before Adding
+
+When adding tweaks in bulk across multiple modules, duplicates can sneak in:
+
+```csharp
+// chrome.cs already has chrome-disable-translate
+// firefox.cs accidentally also defines chrome-disable-translate → CRASH at RegisterBuiltins()
+```
+
+**Prevention**: Before adding a tweak ID, search the Tweaks/ directory:
+
+```powershell
+Select-String -Pattern '"new-tweak-id"' -Path src/RegiLattice.Core/Tweaks/*.cs
+```
+
+During the 453-tweak restoration, 5 duplicate IDs were found across Chrome.cs and Firefox.cs.
+
+---
+
+## Tuple Deconstruction — Match Return Types Exactly
+
+When calling helper methods, verify the return tuple arity:
+
+```csharp
+// ShellRunner.RunPowerShell returns (int exitCode, string stdout, string stderr)
+
+// ✅ GOOD — deconstruct all 3 values
+var (exitCode, stdout, stderr) = ShellRunner.RunPowerShell(script, dryRun);
+
+// ❌ BAD — CS8132: only deconstructing 2 of 3 values
+var (exitCode, output) = ShellRunner.RunPowerShell(script, dryRun);
+```
+
+---
+
+## Batch Editing Workflow — Verify File Anchors
+
+When making bulk edits across many files (e.g., restoring 453 tweaks):
+
+1. Read the target file first to confirm exact content
+2. Use `multi_replace_string_in_file` for independent edits
+3. After each batch, verify the build: `dotnet build`
+4. Commit per logical phase (e.g., per 10 modules)
+
+**Common trap**: File contents change between sessions (e.g., formatter runs, manual edits).
+Always re-read before editing — never assume content matches what was seen earlier.
+
+---
+
+## SetExpandString and SetQword — Less Common RegOp Factories
+
+`RegOp.SetExpandString` and `RegOp.SetQword` exist but are rarely used.
+When a registry value contains `%SystemRoot%` or other environment variables,
+use `SetExpandString` (REG_EXPAND_SZ), not `SetString` (REG_SZ).
+
+```csharp
+// ✅ GOOD — REG_EXPAND_SZ preserves environment variable expansion
+RegOp.SetExpandString(@"HKLM\...", "ImagePath", @"%SystemRoot%\System32\svchost.exe -k netsvcs")
+
+// ❌ BAD — REG_SZ won't expand %SystemRoot% at runtime
+RegOp.SetString(@"HKLM\...", "ImagePath", @"%SystemRoot%\System32\svchost.exe -k netsvcs")
+```
+
+---
+
+## IsApplicable — Hardware Gating for Tweaks
+
+Tweaks that target specific software (Chrome, Firefox, Java, Docker) or hardware
+(NVIDIA GPU, WSL, Hyper-V) should set `IsApplicable` to grey them out in the GUI:
+
+```csharp
+new TweakDef
+{
+    Id = "chrome-disable-translate",
+    IsApplicable = () => HardwareInfo.IsChromeInstalled(),
+    ApplicabilityNote = "Google Chrome is not installed",
+    ...
+}
+```
+
+`TweakEngine.IsApplicableOnHardware()` checks custom predicates first,
+then auto-detects from category (WSL, Virtualization) and tags (nvidia).
+MainForm caches results in `_inapplicableIds` at startup.

.vscode/extensions.json

@@ -2,6 +2,7 @@
   "recommendations": [
     "ms-dotnettools.csharp",
     "ms-dotnettools.csdevkit",
+    "csharpier.csharpier-vscode",
     "ms-vscode.powershell",
     "github.copilot-chat",
     "redhat.vscode-yaml",

.vscode/launch.json

@@ -6,31 +6,31 @@
       "type": "coreclr",
       "request": "launch",
       "preLaunchTask": "build: Solution (Debug)",
-      "program": "${workspaceFolder}/src/RegiLattice.GUI/bin/x64/Debug/net10.0-windows/RegiLattice.GUI.exe",
+      "program": "${workspaceFolder}/src/RegiLattice.GUI/bin/Debug/net10.0-windows/RegiLattice.GUI.exe",
       "args": [],
       "cwd": "${workspaceFolder}",
       "stopAtEntry": false,
-      "console": "internalConsole",
+      "console": "integratedTerminal",
       "justMyCode": true
     },
     {
       "name": "RegiLattice: GUI (Release)",
       "type": "coreclr",
       "request": "launch",
       "preLaunchTask": "build: Solution (Release)",
-      "program": "${workspaceFolder}/src/RegiLattice.GUI/bin/x64/Release/net10.0-windows/RegiLattice.GUI.exe",
+      "program": "${workspaceFolder}/src/RegiLattice.GUI/bin/Release/net10.0-windows/RegiLattice.GUI.exe",
       "args": [],
       "cwd": "${workspaceFolder}",
       "stopAtEntry": false,
-      "console": "internalConsole",
+      "console": "integratedTerminal",
       "justMyCode": true
     },
     {
       "name": "RegiLattice: CLI (list)",
       "type": "coreclr",
       "request": "launch",
       "preLaunchTask": "build: Solution (Debug)",
-      "program": "${workspaceFolder}/src/RegiLattice.CLI/bin/x64/Debug/net10.0-windows/RegiLattice.dll",
+      "program": "${workspaceFolder}/src/RegiLattice.CLI/bin/Debug/net10.0-windows/RegiLattice.dll",
       "args": ["list"],
       "cwd": "${workspaceFolder}",
       "stopAtEntry": false,
@@ -42,7 +42,7 @@
       "type": "coreclr",
       "request": "launch",
       "preLaunchTask": "build: Solution (Debug)",
-      "program": "${workspaceFolder}/src/RegiLattice.CLI/bin/x64/Debug/net10.0-windows/RegiLattice.dll",
+      "program": "${workspaceFolder}/src/RegiLattice.CLI/bin/Debug/net10.0-windows/RegiLattice.dll",
       "args": ["apply", "${input:tweakId}", "--yes"],
       "cwd": "${workspaceFolder}",
       "stopAtEntry": false,

.vscode/settings.json

@@ -2,7 +2,7 @@
   // ── C# / .NET ───────────────────────────────────────────────────────
   "dotnet.defaultSolution": "RegiLattice.sln",
   "[csharp]": {
-    "editor.defaultFormatter": "ms-dotnettools.csharp",
+    "editor.defaultFormatter": "csharpier.csharpier-vscode",
     "editor.formatOnSave": true
   },
   // ── PowerShell ──────────────────────────────────────────────────────
@@ -51,9 +51,16 @@
     }
   },
   "terminal.integrated.shellIntegration.enabled": true,
+  "terminal.integrated.shellIntegration.decorationsEnabled": "both",
+  "terminal.integrated.shellIntegration.history": 500,
   "terminal.integrated.cwd": "${workspaceFolder}",
   "terminal.integrated.scrollback": 10000,
   "terminal.integrated.enablePersistentSessions": true,
+  "terminal.integrated.commandsToSkipShell": [
+    "workbench.action.terminal.focusFind",
+    "workbench.action.togglePanel"
+  ],
+  "terminal.integrated.enableImages": true,
   // Ensure Copilot chat agent terminals also see dotnet tools
   "github.copilot.chat.terminalChatLocation": "terminal",
   // ── Git ─────────────────────────────────────────────────────────────

src/RegiLattice.Core/Models/TweakDef.cs

@@ -88,6 +88,12 @@ public sealed class TweakDef
     public Action<bool>? RemoveAction { get; init; }
     public Func<bool>? DetectAction { get; init; }
 
+    /// <summary>
+    /// Optional update action for package-manager tweaks (e.g. scoop update, pip upgrade).
+    /// Only meaningful for <see cref="TweakKind.PackageManager"/> tweaks.
+    /// </summary>
+    public Action<bool>? UpdateAction { get; init; }
+
     /// <summary>Override the auto-detected TweakKind (set on tweaks with ApplyAction).</summary>
     public TweakKind? KindHint { get; init; }
 

src/RegiLattice.Core/Services/HardwareInfo.cs

@@ -98,6 +98,83 @@ public static bool HasAmdGpu() =>
     /// <summary>Returns true if Hyper-V is available.</summary>
     public static bool HasHyperVAvailable() => DetectHardware().HasHyperV;
 
+    // ── Software detection (for TweakDef.IsApplicable) ─────────────────
+
+    /// <summary>Returns true if Google Chrome is installed.</summary>
+    public static bool IsChromeInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\chrome.exe",
+            null, null) is not null;
+
+    /// <summary>Returns true if Mozilla Firefox is installed.</summary>
+    public static bool IsFirefoxInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\firefox.exe",
+            null, null) is not null;
+
+    /// <summary>Returns true if Microsoft Edge is installed.</summary>
+    public static bool IsEdgeInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\msedge.exe",
+            null, null) is not null;
+
+    /// <summary>Returns true if Java (JRE/JDK) is installed.</summary>
+    public static bool IsJavaInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Runtime Environment",
+            "CurrentVersion", null) is not null ||
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JDK",
+            "CurrentVersion", null) is not null;
+
+    /// <summary>Returns true if Docker Desktop is installed.</summary>
+    public static bool IsDockerInstalled() =>
+        File.Exists(Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles),
+            "Docker", "Docker", "Docker Desktop.exe"));
+
+    /// <summary>Returns true if Adobe Creative Cloud is installed.</summary>
+    public static bool IsAdobeInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\Adobe Creative Cloud",
+            null, null) is not null ||
+        Directory.Exists(Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles),
+            "Adobe"));
+
+    /// <summary>Returns true if LibreOffice is installed.</summary>
+    public static bool IsLibreOfficeInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\LibreOffice",
+            null, null) is not null;
+
+    /// <summary>Returns true if Microsoft Office is installed.</summary>
+    public static bool IsOfficeInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\ClickToRun",
+            "InstallPath", null) is not null;
+
+    /// <summary>Returns true if RealVNC is installed.</summary>
+    public static bool IsRealVncInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\RealVNC",
+            null, null) is not null;
+
+    /// <summary>Returns true if VS Code is installed.</summary>
+    public static bool IsVsCodeInstalled() =>
+        Microsoft.Win32.Registry.GetValue(
+            @"HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\code.cmd",
+            null, null) is not null ||
+        File.Exists(Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
+            "Programs", "Microsoft VS Code", "Code.exe"));
+
+    /// <summary>Returns true if Scoop package manager is installed.</summary>
+    public static bool IsScoopInstalled() =>
+        Directory.Exists(Path.Combine(
+            Environment.GetFolderPath(Environment.SpecialFolder.UserProfile),
+            "scoop", "shims"));
+
     public static CpuInfo DetectCpu()
     {
         var name = Environment.GetEnvironmentVariable("PROCESSOR_IDENTIFIER") ?? "Unknown";