fix(gendoc): log skipped assemblies in FailureBehavior.Continue

FirstClassErrors.GenDoc.UnitTests/SolutionErrorDocumentationGeneratorTests.cs

@@ -73,6 +73,34 @@ public void AMissingAssemblyIsSkippedWhenContinuing() {
         Check.That(result).IsEmpty();
     }
 
+    [Fact(DisplayName = "A skipped assembly is logged as a warning (never silent) when the failure behavior is Continue.")]
+    public void ASkippedAssemblyIsLoggedWhenContinuing() {
+        // Setup
+        RecordingGenerationLogger logger = new();
+        SolutionGenerationOptions options = new() {
+            FailureBehavior = FailureBehavior.Continue,
+            Logger          = logger
+        };
+
+        // Exercise
+        SolutionErrorDocumentationGenerator.GetErrorDocumentationFromAssemblies(new[] { "this-assembly-does-not-exist.dll" }, options);
+
+        // Verify: the skipped assembly leaves a warning trace mentioning the missing file.
+        Check.That(logger.Warnings).HasSize(1);
+        Check.That(logger.Warnings[0]).Contains("this-assembly-does-not-exist.dll");
+    }
+
+    private sealed class RecordingGenerationLogger : IGenerationLogger {
+
+        public List<string> Warnings { get; } = new();
+
+        public void Info(string    message) { }
+        public void Warning(string message) { Warnings.Add(message); }
+        public void Error(string   message) { }
+        public void Debug(string   message) { }
+
+    }
+
     [Fact(DisplayName = "A missing assembly aborts when the failure behavior is Stop.")]
     public void AMissingAssemblyAbortsWhenStopping() {
         // Setup

FirstClassErrors.GenDoc/SolutionErrorDocumentationGenerator.cs

@@ -350,7 +350,15 @@ private static ProcessResult RunProcess(string fileName, string arguments, strin
     }
 
     private static void HandleFailure(SolutionGenerationOptions options, string message, Exception? ex = null) {
-        if (options.FailureBehavior == FailureBehavior.Continue) { return; }
+        if (options.FailureBehavior == FailureBehavior.Continue) {
+            // In Continue mode the failure is swallowed so the generation proceeds with the remaining assemblies, but it
+            // must never be silent: log it as a warning (with the exception detail when present) so the skipped assembly
+            // leaves a trace the caller can diagnose.
+            options.Logger.Warning(ex is not null ? $"{message} {ex}" : message);
+
+            return;
+        }
+
         if (ex is not null) { throw new SolutionDocumentationGenerationException(message, ex); }
 
         throw new SolutionDocumentationGenerationException(message);