From 81a6ce471f28bf6e216f6509cda423585a1da9f3 Mon Sep 17 00:00:00 2001
From: "Martin Hinshelwood nkdAgility.com" <martin@nkdagility.com>
Date: Mon, 16 Sep 2024 00:48:53 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20(MigrationTools.xml):=20update?=
 =?UTF-8?q?=20documentation=20to=20reflect=20latest=20git=20metadata=20?=
 =?UTF-8?q?=F0=9F=92=A1=20(TfsNodeStructureTool.cs):=20add=20warning=20log?=
 =?UTF-8?q?=20when=20node=20structure=20enricher=20is=20disabled?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The documentation is updated to reflect the latest git metadata, including branch, commit, SHA, commit date, and versioning information. This ensures that the documentation is accurate and up-to-date.

A warning log is added to `TfsNodeStructureTool.cs` to notify users when the node structure enricher is disabled. This helps in debugging and ensures users are aware of potential migration errors due to the disabled state.
---
 docs/Reference/Generated/MigrationTools.xml   | 22 +++++++++----------
 .../Tools/TfsNodeStructureTool.cs             |  8 +++++--
 2 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/docs/Reference/Generated/MigrationTools.xml b/docs/Reference/Generated/MigrationTools.xml
index 5536d08e4..95463a30a 100644
--- a/docs/Reference/Generated/MigrationTools.xml
+++ b/docs/Reference/Generated/MigrationTools.xml
@@ -258,37 +258,37 @@
         </member>
         <member name="F:ThisAssembly.Git.Branch">
             <summary>
-            => @"topic/validation-refactor"
+            => @"main"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.Commit">
             <summary>
-            => @"a9e012b0"
+            => @"c1dc8d13"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.Sha">
             <summary>
-            => @"a9e012b05801421a57a109dc86b8827c02524855"
+            => @"c1dc8d13597a011053009949861c3795a12918d7"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.CommitDate">
             <summary>
-            => @"2024-09-15T23:57:44+01:00"
+            => @"2024-09-16T00:32:00+01:00"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.Commits">
             <summary>
-            => @"6"
+            => @"0"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.Tag">
             <summary>
-            => @"v16.0.3-Preview.3-6-ga9e012b0"
+            => @"v16.0.4-Preview.1"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.BaseTag">
             <summary>
-            => @"v16.0.3-Preview.3"
+            => @"v16.0.4-Preview.1"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.BaseVersion.Major">
@@ -303,7 +303,7 @@
         </member>
         <member name="F:ThisAssembly.Git.BaseVersion.Patch">
             <summary>
-            => @"3"
+            => @"4"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.SemVer.Major">
@@ -318,17 +318,17 @@
         </member>
         <member name="F:ThisAssembly.Git.SemVer.Patch">
             <summary>
-            => @"9"
+            => @"4"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.SemVer.Label">
             <summary>
-            => @"Preview.3"
+            => @"Preview.1"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.SemVer.DashLabel">
             <summary>
-            => @"-Preview.3"
+            => @"-Preview.1"
             </summary>
         </member>
         <member name="F:ThisAssembly.Git.SemVer.Source">
diff --git a/src/MigrationTools.Clients.TfsObjectModel/Tools/TfsNodeStructureTool.cs b/src/MigrationTools.Clients.TfsObjectModel/Tools/TfsNodeStructureTool.cs
index bdde0b68f..cfc4f8215 100644
--- a/src/MigrationTools.Clients.TfsObjectModel/Tools/TfsNodeStructureTool.cs
+++ b/src/MigrationTools.Clients.TfsObjectModel/Tools/TfsNodeStructureTool.cs
@@ -103,8 +103,12 @@ public void ValidateAllNodesExistOrAreMapped(TfsProcessor processor, List<WorkIt
         public string GetNewNodeName(string sourceNodePath, TfsNodeStructureType nodeStructureType)
         {
             Log.LogDebug("NodeStructureEnricher.GetNewNodeName({sourceNodePath}, {nodeStructureType})", sourceNodePath, nodeStructureType.ToString());
-
-            var mappers = GetMaps(nodeStructureType);
+            if (!Options.Enabled)
+            {
+                Log.LogWarning("nodeStructureEnricher is disabled! You may get migration errors!");
+                return sourceNodePath;
+            }
+                var mappers = GetMaps(nodeStructureType);
             var lastResortRule = GetLastResortRemappingRule();
 
             Log.LogDebug("NodeStructureEnricher.GetNewNodeName::Mappers", mappers);