Added the visual briefing assistant (#893)

app/MindWork AI Studio/Assistants/VisualBriefing/VisualBriefingAssistant.razor.Validation.cs

@@ -0,0 +1,144 @@
+using AIStudio.Provider;
+using AIStudio.Settings;
+using AIStudio.Tools.Rust;
+
+using ProviderSettings = AIStudio.Settings.Provider;
+
+namespace AIStudio.Assistants.VisualBriefing;
+
+public partial class VisualBriefingAssistant
+{
+    /// <summary>Gets whether the briefing contains at least one actual source-material file.</summary>
+    /// <remarks>
+    /// This deliberately reads the stored manifest instead of the editor state: a build always runs
+    /// against what the store accepted, and the store drops attachments whose file disappeared before
+    /// the save. Every path that changes sources therefore has to save with a reload, otherwise this
+    /// check keeps reporting the state from before the change.
+    /// </remarks>
+    private bool HasSourceMaterial => this.selectedBriefing?.Sources.Any(source => source.Kind is VisualBriefingSourceKind.SOURCE_MATERIAL) == true;
+
+    /// <summary>Gets whether any stored source reaches the model as an image.</summary>
+    /// <remarks>
+    /// Both source kinds can end up as an image: source preparation converts every visual asset into an
+    /// image attachment, and a source material file is attached as it is, where the attachment type is
+    /// derived from the file extension alone. Checking the extension therefore covers both, and it
+    /// matches the rule the attachment control already applies while a file is being added.
+    /// </remarks>
+    private bool HasImageSources => this.selectedBriefing?.Sources.Any(source => FileTypes.IsAllowedPath(source.Path, FileTypes.IMAGE)) == true;
+
+    /// <summary>Gets all current field, source, and revision issues shown below the actions.</summary>
+    /// <remarks>
+    /// This is the complete list for the user. The generate buttons disable themselves from the same
+    /// two building blocks, so a listed issue and a blocked button can no longer contradict each other.
+    /// Only the MudBlazor field messages stay out of that gate: they arrive one validation pass late,
+    /// which would make the buttons flicker, and the validators behind them are evaluated directly by
+    /// FieldIssues anyway.
+    /// </remarks>
+    private IReadOnlyList<string> ValidationIssues
+    {
+        get
+        {
+            List<string> issues = [.. this.formIssues, .. this.FieldIssues, .. this.SourceIssues];
+
+            if (this.selectedBriefing is { Versions.Count: > 0 } && !this.SelectedVersionSupportsEdits)
+                issues.Add(T("This version has no compatible semantic artifacts. Rebuild the briefing instead."));
+
+            return [.. issues.Where(issue => !string.IsNullOrWhiteSpace(issue)).Distinct(StringComparer.Ordinal)];
+        }
+    }
+
+    /// <summary>Gets the field issues that block generation regardless of the edit mode.</summary>
+    private IReadOnlyList<string> FieldIssues
+    {
+        get
+        {
+            List<string> issues = [];
+
+            AddIssue(issues, this.ValidateProjectName(this.editor.Name));
+            AddIssue(issues, this.ValidateProvider(this.editor.Provider));
+            AddIssue(issues, this.ValidateCustomTargetLanguage(this.editor.CustomTargetLanguage));
+            AddIssue(issues, this.ValidateCustomProtectionLevel(this.editor.CustomProtectionLevel));
+
+            return issues;
+        }
+    }
+
+    /// <summary>Gets the issues with the stored sources, which block only the modes that read them.</summary>
+    /// <remarks>
+    /// The image check belongs here rather than to the fields, even though it depends on the selected
+    /// model: it only matters for the modes that hand the sources to the model at all. Changing just the
+    /// design reuses the stored evidence and sends no attachments, which is the same distinction the
+    /// build orchestrator makes before it runs source preparation.
+    /// </remarks>
+    private IReadOnlyList<string> SourceIssues
+    {
+        get
+        {
+            if (this.selectedBriefing is null)
+                return [];
+
+            List<string> issues = [];
+            if (!this.HasSourceMaterial)
+                issues.Add(T("Please add at least one source material file."));
+
+            // A model can be selected long after the images were attached, so the capability that was
+            // checked while attaching them has to be checked again here:
+            if (this.HasImageSources && this.editor.Provider != ProviderSettings.NONE && !this.editor.Provider.SupportsImageInput())
+                issues.Add(T("Images are not supported by the selected provider and model. Select a model with image support, or remove the image sources."));
+
+            foreach (var source in this.selectedBriefing.Sources)
+            {
+                var fileName = Path.GetFileName(source.Path);
+                switch (source.Status)
+                {
+                    case VisualBriefingSourceStatus.UNREACHABLE:
+                        issues.Add(string.Format(T("The source '{0}' is no longer reachable. Restore or relink it."), fileName));
+                        break;
+
+                    case VisualBriefingSourceStatus.TRANSCRIPT_OUTDATED:
+                        issues.Add(string.Format(T("The transcript for '{0}' is missing or outdated. Transcribe the media source again."), fileName));
+                        break;
+                }
+            }
+
+            return issues;
+        }
+    }
+
+    /// <summary>Validates the briefing name.</summary>
+    private string? ValidateProjectName(string name) => string.IsNullOrWhiteSpace(name) ? T("Please provide a briefing name.") : null;
+
+    /// <summary>Validates the selected generation provider.</summary>
+    private string? ValidateProvider(ProviderSettings value) =>
+        value == ProviderSettings.NONE || value.UsedLLMProvider is LLMProviders.NONE
+            ? T("Please select a provider.")
+            : null;
+
+    /// <summary>Validates the free-form target language when Other is selected.</summary>
+    private string? ValidateCustomTargetLanguage(string language) =>
+        this.editor.TargetLanguage is CommonLanguages.OTHER && string.IsNullOrWhiteSpace(language)
+            ? T("Please provide a custom target language.")
+            : null;
+
+    /// <summary>Validates the free-form protection level when Other is selected.</summary>
+    private string? ValidateCustomProtectionLevel(string level) =>
+        this.editor.ProtectionLevel is VisualBriefingProtectionLevel.OTHER && string.IsNullOrWhiteSpace(level)
+            ? T("Please provide a custom protection level.")
+            : null;
+
+    /// <summary>Revalidates after a conditional Other field has been added or removed.</summary>
+    private Task ScheduleFormValidation()
+    {
+        this.formValidationPending = true;
+        this.StateHasChanged();
+        
+        return Task.CompletedTask;
+    }
+
+    /// <summary>Adds one optional validation message.</summary>
+    private static void AddIssue(ICollection<string> issues, string? issue)
+    {
+        if (!string.IsNullOrWhiteSpace(issue))
+            issues.Add(issue);
+    }
+}