feat(plugins): implement automatic plugin downloading and document it

Author: DotDev262

docs/modules/plugins.md

@@ -178,3 +178,12 @@ extensions:
   test-echo:
     message: 'Hello from Python Plugin!'
 ```
+
+---
+
+## Plugin Auto-Discovery & Download
+
+WinHome makes it seamless to use plugins without having to manually copy files:
+- **On-Demand Auto-Download**: If you define an extension or top-level plugin in your `config.yaml` that is not present in `%LOCALAPPDATA%\WinHome\plugins`, WinHome will automatically download the missing plugin from GitHub and extract it into your local directory at runtime.
+- **Auto-Installation of Target Apps**: By using the `-i` or `--auto-install-apps` CLI flag, WinHome will check if the target applications (e.g. VLC, chezmoi, or Git) for your active plugins are installed. If they are missing, it will automatically install them using their default package manager (such as `winget`, `scoop`, or `choco`) before applying your configuration.
+

src/Engine.cs

@@ -95,6 +95,16 @@ public async Task RunAsync(Configuration config, bool dryRun, string? profileNam
     {
       _logger.LogInfo($"--- WinHome v{config.Version} ---");
 
+      // Ensure all configured plugins are downloaded/available locally
+      var configuredPluginNames = config.Apps.Select(a => a.Manager)
+          .Concat(new[] { "vim", "vscode", "obsidian", "ohmyposh" }.Where(_ => config.Vim != null || config.Vscode != null || config.Obsidian != null || config.Ohmyposh != null))
+          .Concat(config.Extensions.Keys)
+          .Where(name => !string.IsNullOrEmpty(name))
+          .Distinct(StringComparer.OrdinalIgnoreCase)
+          .ToList();
+
+      await _pluginManager.EnsurePluginsInstalledAsync(configuredPluginNames);
+
       // Load Plugins
       var plugins = _pluginManager.DiscoverPlugins().ToList();
       var loggedPlugins = new HashSet<string>(StringComparer.OrdinalIgnoreCase);

src/Interfaces/IPluginManager.cs

@@ -9,5 +9,7 @@ public interface IPluginManager
     IEnumerable<PluginManifest> DiscoverPlugins();
     /// <summary>Ensures the required runtime is installed for the given plugin.</summary>
     Task EnsureRuntimeAsync(PluginManifest plugin);
+    /// <summary>Downloads and installs missing plugins from the remote pack.</summary>
+    Task EnsurePluginsInstalledAsync(IEnumerable<string> configuredPluginNames);
   }
 }

src/Services/Plugins/PluginManager.cs

@@ -118,5 +118,92 @@ public async Task EnsureRuntimeAsync(PluginManifest plugin)
           break;
       }
     }
+
+    /// <summary>Downloads and installs missing plugins from the remote repository archive.</summary>
+    public async Task EnsurePluginsInstalledAsync(IEnumerable<string> configuredPluginNames)
+    {
+      if (!Directory.Exists(_pluginsDir))
+      {
+        Directory.CreateDirectory(_pluginsDir);
+      }
+
+      var missingPlugins = configuredPluginNames.Where(name =>
+      {
+        var manifestPath = Path.Combine(_pluginsDir, name, "plugin.yaml");
+        return !File.Exists(manifestPath);
+      }).ToList();
+
+      if (!missingPlugins.Any())
+      {
+        return;
+      }
+
+      _logger.LogInfo($"[PluginManager] Missing local plugins: {string.Join(", ", missingPlugins)}. Downloading fresh plugin pack from GitHub...");
+
+      try
+      {
+        using var client = new System.Net.Http.HttpClient();
+        client.DefaultRequestHeaders.UserAgent.ParseAdd("WinHome-CLI");
+
+        var zipUrl = "https://github.com/DotDev262/WinHome/archive/refs/heads/main.zip";
+        var tempZipPath = Path.Combine(Path.GetTempPath(), $"winhome-plugins-{Guid.NewGuid()}.zip");
+
+        using (var response = await client.GetAsync(zipUrl))
+        {
+          response.EnsureSuccessStatusCode();
+          using (var fs = new FileStream(tempZipPath, FileMode.Create, FileAccess.Write, FileShare.None))
+          {
+            await response.Content.CopyToAsync(fs);
+          }
+        }
+
+        var tempExtractPath = Path.Combine(Path.GetTempPath(), $"winhome-extract-{Guid.NewGuid()}");
+        System.IO.Compression.ZipFile.ExtractToDirectory(tempZipPath, tempExtractPath);
+
+        var extractedPluginsDir = Path.Combine(tempExtractPath, "WinHome-main", "plugins");
+        if (Directory.Exists(extractedPluginsDir))
+        {
+          foreach (var dir in Directory.GetDirectories(extractedPluginsDir))
+          {
+            var pluginName = Path.GetFileName(dir);
+            var targetDir = Path.Combine(_pluginsDir, pluginName);
+            if (Directory.Exists(targetDir))
+            {
+              Directory.Delete(targetDir, true);
+            }
+            CopyDirectory(dir, targetDir);
+          }
+          _logger.LogSuccess("[PluginManager] Plugin pack downloaded and extracted successfully.");
+        }
+        else
+        {
+          _logger.LogError("[PluginManager] Failed to locate plugins folder in downloaded archive.");
+        }
+
+        try
+        {
+          File.Delete(tempZipPath);
+          Directory.Delete(tempExtractPath, true);
+        }
+        catch { /* ignored */ }
+      }
+      catch (Exception ex)
+      {
+        _logger.LogError($"[PluginManager] Failed to download plugin pack: {ex.Message}");
+      }
+    }
+
+    private static void CopyDirectory(string sourceDir, string destinationDir)
+    {
+      Directory.CreateDirectory(destinationDir);
+      foreach (var file in Directory.GetFiles(sourceDir))
+      {
+        File.Copy(file, Path.Combine(destinationDir, Path.GetFileName(file)), true);
+      }
+      foreach (var subDir in Directory.GetDirectories(sourceDir))
+      {
+        CopyDirectory(subDir, Path.Combine(destinationDir, Path.GetFileName(subDir)));
+      }
+    }
   }
 }