feat(04-01): add Phase 4 models, interfaces, BulkOperationRunner, and test scaffolds

- Install CsvHelper 33.1.0 and Microsoft.Graph 5.74.0 (main + test projects)
- Add 14 core model/enum files (BulkOperationResult, BulkMemberRow, BulkSiteRow, TransferJob, FolderStructureRow, SiteTemplate, SiteTemplateOptions, TemplateLibraryInfo, TemplateFolderInfo, TemplatePermissionGroup, ConflictPolicy, TransferMode, CsvValidationRow)
- Add 6 service interfaces (IFileTransferService, IBulkMemberService, IBulkSiteService, ITemplateService, IFolderStructureService, ICsvValidationService)
- Add BulkOperationRunner with continue-on-error and cancellation support
- Add BulkResultCsvExportService stub (compile-ready)
- Add test scaffolds: BulkOperationRunnerTests (5 passing), BulkResultCsvExportServiceTests (2 passing), CsvValidationServiceTests (6 skipped), TemplateRepositoryTests (4 skipped)

SharepointToolbox/Services/BulkOperationRunner.cs

@@ -0,0 +1,36 @@
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services;
+
+public static class BulkOperationRunner
+{
+    /// <summary>
+    /// Runs a bulk operation with continue-on-error semantics, per-item result tracking,
+    /// and cancellation support. OperationCanceledException propagates immediately.
+    /// </summary>
+    public static async Task<BulkOperationSummary<TItem>> RunAsync<TItem>(
+        IReadOnlyList<TItem> items,
+        Func<TItem, int, CancellationToken, Task> processItem,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct)
+    {
+        var results = new List<BulkItemResult<TItem>>();
+        for (int i = 0; i < items.Count; i++)
+        {
+            ct.ThrowIfCancellationRequested();
+            progress.Report(new OperationProgress(i + 1, items.Count, $"Processing {i + 1}/{items.Count}..."));
+            try
+            {
+                await processItem(items[i], i, ct);
+                results.Add(BulkItemResult<TItem>.Success(items[i]));
+            }
+            catch (OperationCanceledException) { throw; }
+            catch (Exception ex)
+            {
+                results.Add(BulkItemResult<TItem>.Failed(items[i], ex.Message));
+            }
+        }
+        progress.Report(new OperationProgress(items.Count, items.Count, "Complete."));
+        return new BulkOperationSummary<TItem>(results);
+    }
+}

SharepointToolbox/Services/Export/BulkResultCsvExportService.cs

@@ -0,0 +1,40 @@
+using System.Globalization;
+using System.IO;
+using System.Text;
+using CsvHelper;
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services.Export;
+
+public class BulkResultCsvExportService
+{
+    public string BuildFailedItemsCsv<T>(IReadOnlyList<BulkItemResult<T>> failedItems)
+    {
+        using var writer = new StringWriter();
+        using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
+
+        csv.WriteHeader<T>();
+        csv.WriteField("Error");
+        csv.WriteField("Timestamp");
+        csv.NextRecord();
+
+        foreach (var item in failedItems.Where(r => !r.IsSuccess))
+        {
+            csv.WriteRecord(item.Item);
+            csv.WriteField(item.ErrorMessage);
+            csv.WriteField(item.Timestamp.ToString("o"));
+            csv.NextRecord();
+        }
+
+        return writer.ToString();
+    }
+
+    public async Task WriteFailedItemsCsvAsync<T>(
+        IReadOnlyList<BulkItemResult<T>> failedItems,
+        string filePath,
+        CancellationToken ct)
+    {
+        var content = BuildFailedItemsCsv(failedItems);
+        await System.IO.File.WriteAllTextAsync(filePath, content, new UTF8Encoding(true), ct);
+    }
+}

SharepointToolbox/Services/IBulkMemberService.cs

@@ -0,0 +1,14 @@
+using Microsoft.SharePoint.Client;
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services;
+
+public interface IBulkMemberService
+{
+    Task<BulkOperationSummary<BulkMemberRow>> AddMembersAsync(
+        ClientContext ctx,
+        string clientId,
+        IReadOnlyList<BulkMemberRow> rows,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct);
+}

SharepointToolbox/Services/IBulkSiteService.cs

@@ -0,0 +1,13 @@
+using Microsoft.SharePoint.Client;
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services;
+
+public interface IBulkSiteService
+{
+    Task<BulkOperationSummary<BulkSiteRow>> CreateSitesAsync(
+        ClientContext adminCtx,
+        IReadOnlyList<BulkSiteRow> rows,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct);
+}

SharepointToolbox/Services/ICsvValidationService.cs

@@ -0,0 +1,12 @@
+using System.IO;
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services;
+
+public interface ICsvValidationService
+{
+    List<CsvValidationRow<T>> ParseAndValidate<T>(Stream csvStream) where T : class;
+    List<CsvValidationRow<BulkMemberRow>> ParseAndValidateMembers(Stream csvStream);
+    List<CsvValidationRow<BulkSiteRow>> ParseAndValidateSites(Stream csvStream);
+    List<CsvValidationRow<FolderStructureRow>> ParseAndValidateFolders(Stream csvStream);
+}

SharepointToolbox/Services/IFileTransferService.cs

@@ -0,0 +1,18 @@
+using Microsoft.SharePoint.Client;
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services;
+
+public interface IFileTransferService
+{
+    /// <summary>
+    /// Transfers files/folders from source to destination.
+    /// Returns per-item results (file paths as string items).
+    /// </summary>
+    Task<BulkOperationSummary<string>> TransferAsync(
+        ClientContext sourceCtx,
+        ClientContext destCtx,
+        TransferJob job,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct);
+}

SharepointToolbox/Services/IFolderStructureService.cs

@@ -0,0 +1,14 @@
+using Microsoft.SharePoint.Client;
+using SharepointToolbox.Core.Models;
+
+namespace SharepointToolbox.Services;
+
+public interface IFolderStructureService
+{
+    Task<BulkOperationSummary<string>> CreateFoldersAsync(
+        ClientContext ctx,
+        string libraryTitle,
+        IReadOnlyList<FolderStructureRow> rows,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct);
+}

SharepointToolbox/Services/ITemplateService.cs

@@ -0,0 +1,22 @@
+using Microsoft.SharePoint.Client;
+using SharepointToolbox.Core.Models;
+using ModelSiteTemplate = SharepointToolbox.Core.Models.SiteTemplate;
+
+namespace SharepointToolbox.Services;
+
+public interface ITemplateService
+{
+    Task<ModelSiteTemplate> CaptureTemplateAsync(
+        ClientContext ctx,
+        SiteTemplateOptions options,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct);
+
+    Task<string> ApplyTemplateAsync(
+        ClientContext adminCtx,
+        ModelSiteTemplate template,
+        string newSiteTitle,
+        string newSiteAlias,
+        IProgress<OperationProgress> progress,
+        CancellationToken ct);
+}