@duytransipher/gitnexus 1.2.2 → 1.3.0

package/vendor/GitNexusUnreal/Source/GitNexusUnreal/Private/GitNexusBlueprintAnalyzerCommandlet.cpp

@@ -1,465 +1,930 @@
-#include "GitNexusBlueprintAnalyzerCommandlet.h"
-
-#include "AssetRegistry/AssetRegistryModule.h"
-#include "AssetRegistry/IAssetRegistry.h"
-#include "Blueprint/BlueprintSupport.h"
-#include "Blueprint/UserWidget.h"
-#include "Dom/JsonObject.h"
-#include "EdGraph/EdGraph.h"
-#include "EdGraph/EdGraphNode.h"
-#include "EdGraph/EdGraphPin.h"
-#include "Engine/Blueprint.h"
-#include "K2Node_CallFunction.h"
-#include "K2Node_Event.h"
-#include "Kismet2/BlueprintEditorUtils.h"
-#include "Misc/FileHelper.h"
-#include "Misc/Guid.h"
-#include "Misc/PackageName.h"
-#include "Misc/Paths.h"
-#include "Serialization/JsonReader.h"
-#include "Serialization/JsonSerializer.h"
-#include "UObject/SoftObjectPath.h"
-
-UGitNexusBlueprintAnalyzerCommandlet::UGitNexusBlueprintAnalyzerCommandlet()
-{
-	IsClient = false;
-	IsEditor = true;
-	LogToConsole = true;
-	ShowErrorCount = true;
-}
-
-int32 UGitNexusBlueprintAnalyzerCommandlet::Main(const FString& Params)
-{
-	FString Operation;
-	FString OutputJsonPath;
-	FParse::Value(*Params, TEXT("Operation="), Operation);
-	FParse::Value(*Params, TEXT("OutputJson="), OutputJsonPath);
-
-	if (Operation.IsEmpty() || OutputJsonPath.IsEmpty())
-	{
-		UE_LOG(LogTemp, Error, TEXT("GitNexusBlueprintAnalyzer requires Operation= and OutputJson= parameters."));
-		return 1;
-	}
-
-	if (Operation.Equals(TEXT("SyncAssets"), ESearchCase::IgnoreCase))
-	{
-		return RunSyncAssets(OutputJsonPath);
-	}
-
-	if (Operation.Equals(TEXT("FindNativeBlueprintReferences"), ESearchCase::IgnoreCase))
-	{
-		FString CandidatesJsonPath;
-		FString TargetSymbolKey;
-		FString TargetClassName;
-		FString TargetFunctionName;
-		FParse::Value(*Params, TEXT("CandidatesJson="), CandidatesJsonPath);
-		FParse::Value(*Params, TEXT("TargetSymbolKey="), TargetSymbolKey);
-		FParse::Value(*Params, TEXT("TargetClass="), TargetClassName);
-		FParse::Value(*Params, TEXT("TargetFunction="), TargetFunctionName);
-		return RunFindNativeBlueprintReferences(OutputJsonPath, CandidatesJsonPath, TargetSymbolKey, TargetClassName, TargetFunctionName);
-	}
-
-	if (Operation.Equals(TEXT("ExpandBlueprintChain"), ESearchCase::IgnoreCase))
-	{
-		FString AssetPath;
-		FString ChainAnchorId;
-		FString Direction = TEXT("downstream");
-		int32 MaxDepth = 5;
-		FParse::Value(*Params, TEXT("AssetPath="), AssetPath);
-		FParse::Value(*Params, TEXT("ChainAnchorId="), ChainAnchorId);
-		FParse::Value(*Params, TEXT("Direction="), Direction);
-		FParse::Value(*Params, TEXT("MaxDepth="), MaxDepth);
-		return RunExpandBlueprintChain(OutputJsonPath, AssetPath, ChainAnchorId, Direction, MaxDepth);
-	}
-
-	UE_LOG(LogTemp, Error, TEXT("Unsupported GitNexusBlueprintAnalyzer operation: %s"), *Operation);
-	return 1;
-}
-
-int32 UGitNexusBlueprintAnalyzerCommandlet::RunSyncAssets(const FString& OutputJsonPath)
-{
-	TArray<TSharedPtr<FJsonValue>> AssetValues;
-
-	for (const FAssetData& AssetData : GetAllBlueprintAssets())
-	{
-		UBlueprint* Blueprint = Cast<UBlueprint>(AssetData.GetAsset());
-		if (!Blueprint)
-		{
-			continue;
-		}
-
-		TSharedPtr<FJsonObject> AssetObject = MakeShared<FJsonObject>();
-		AssetObject->SetStringField(TEXT("asset_path"), AssetData.GetSoftObjectPath().ToString());
-
-		if (Blueprint->GeneratedClass)
-		{
-			AssetObject->SetStringField(TEXT("generated_class"), Blueprint->GeneratedClass->GetPathName());
-		}
-
-		if (Blueprint->ParentClass)
-		{
-			AssetObject->SetStringField(TEXT("parent_class"), Blueprint->ParentClass->GetPathName());
-		}
-
-		TArray<TSharedPtr<FJsonValue>> NativeParents;
-		for (UClass* Class = Blueprint->ParentClass; Class; Class = Class->GetSuperClass())
-		{
-			if (Class->ClassGeneratedBy == nullptr)
-			{
-				NativeParents.Add(MakeShared<FJsonValueString>(Class->GetName()));
-			}
-		}
-		AssetObject->SetArrayField(TEXT("native_parents"), NativeParents);
-
-		TArray<FName> Dependencies;
-		IAssetRegistry::GetChecked().GetDependencies(AssetData.PackageName, Dependencies, UE::AssetRegistry::EDependencyCategory::Package);
-		TArray<TSharedPtr<FJsonValue>> DependencyValues;
-		for (const FName& Dependency : Dependencies)
-		{
-			DependencyValues.Add(MakeShared<FJsonValueString>(Dependency.ToString()));
-		}
-		AssetObject->SetArrayField(TEXT("dependencies"), DependencyValues);
-
-		TArray<UEdGraph*> Graphs;
-		CollectBlueprintGraphs(Blueprint, Graphs);
-		TSet<FString> NativeFunctionRefs;
-		for (const UEdGraph* Graph : Graphs)
-		{
-			if (!Graph)
-			{
-				continue;
-			}
-
-			for (const UEdGraphNode* Node : Graph->Nodes)
-			{
-				if (const UK2Node_CallFunction* CallNode = Cast<UK2Node_CallFunction>(Node))
-				{
-					if (const UFunction* TargetFunction = CallNode->GetTargetFunction())
-					{
-						const UClass* OwnerClass = TargetFunction->GetOwnerClass();
-						const FString SymbolKey = OwnerClass
-							? FString::Printf(TEXT("%s::%s"), *OwnerClass->GetName(), *TargetFunction->GetName())
-							: TargetFunction->GetName();
-						NativeFunctionRefs.Add(SymbolKey);
-					}
-				}
-			}
-		}
-
-		TArray<TSharedPtr<FJsonValue>> NativeFunctionRefValues;
-		for (const FString& Ref : NativeFunctionRefs)
-		{
-			NativeFunctionRefValues.Add(MakeShared<FJsonValueString>(Ref));
-		}
-		AssetObject->SetArrayField(TEXT("native_function_refs"), NativeFunctionRefValues);
-
-		AssetValues.Add(MakeShared<FJsonValueObject>(AssetObject));
-	}
-
-	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
-	RootObject->SetNumberField(TEXT("version"), 1);
-	RootObject->SetStringField(TEXT("generated_at"), FDateTime::UtcNow().ToIso8601());
-	RootObject->SetStringField(TEXT("project_path"), FPaths::ConvertRelativePathToFull(FPaths::GetProjectFilePath()));
-	RootObject->SetArrayField(TEXT("assets"), AssetValues);
-
-	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
-}
-
-int32 UGitNexusBlueprintAnalyzerCommandlet::RunFindNativeBlueprintReferences(
-	const FString& OutputJsonPath,
-	const FString& CandidatesJsonPath,
-	const FString& TargetSymbolKey,
-	const FString& TargetClassName,
-	const FString& TargetFunctionName
-)
-{
-	TArray<TSharedPtr<FJsonValue>> ConfirmedReferences;
-	TArray<FString> CandidateAssets = LoadCandidateAssets(CandidatesJsonPath);
-
-	for (const FString& AssetPath : CandidateAssets)
-	{
-		UBlueprint* Blueprint = LoadBlueprintFromAssetPath(AssetPath);
-		if (!Blueprint)
-		{
-			continue;
-		}
-
-		TArray<UEdGraph*> Graphs;
-		CollectBlueprintGraphs(Blueprint, Graphs);
-		for (const UEdGraph* Graph : Graphs)
-		{
-			if (!Graph)
-			{
-				continue;
-			}
-
-			for (const UEdGraphNode* Node : Graph->Nodes)
-			{
-				if (Node && IsTargetFunctionNode(Node, TargetSymbolKey, TargetClassName, TargetFunctionName))
-				{
-					ConfirmedReferences.Add(MakeShared<FJsonValueObject>(BuildReferenceJson(Blueprint, Graph, Node)));
-				}
-			}
-		}
-	}
-
-	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
-	TSharedPtr<FJsonObject> TargetObject = MakeShared<FJsonObject>();
-	TargetObject->SetStringField(TEXT("symbol_key"), TargetSymbolKey);
-	TargetObject->SetStringField(TEXT("class_name"), TargetClassName);
-	TargetObject->SetStringField(TEXT("symbol_name"), TargetFunctionName);
-	RootObject->SetObjectField(TEXT("target_function"), TargetObject);
-	RootObject->SetNumberField(TEXT("candidates_scanned"), CandidateAssets.Num());
-	RootObject->SetArrayField(TEXT("confirmed_references"), ConfirmedReferences);
-
-	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
-}
-
-int32 UGitNexusBlueprintAnalyzerCommandlet::RunExpandBlueprintChain(
-	const FString& OutputJsonPath,
-	const FString& AssetPath,
-	const FString& ChainAnchorId,
-	const FString& Direction,
-	int32 MaxDepth
-)
-{
-	UBlueprint* Blueprint = LoadBlueprintFromAssetPath(AssetPath);
-	if (!Blueprint)
-	{
-		return 1;
-	}
-
-	UEdGraphNode* StartNode = FindNodeByGuid(Blueprint, ChainAnchorId);
-	if (!StartNode)
-	{
-		return 1;
-	}
-
-	TArray<TSharedPtr<FJsonValue>> NodeValues;
-	TSet<FGuid> Visited;
-	TArray<TPair<UEdGraphNode*, int32>> Frontier;
-	Frontier.Add(TPair<UEdGraphNode*, int32>(StartNode, 0));
-	Visited.Add(StartNode->NodeGuid);
-
-	const bool bUpstream = Direction.Equals(TEXT("upstream"), ESearchCase::IgnoreCase);
-
-	while (Frontier.Num() > 0)
-	{
-		const TPair<UEdGraphNode*, int32> Current = Frontier[0];
-		Frontier.RemoveAt(0);
-
-		NodeValues.Add(MakeShared<FJsonValueObject>(BuildChainNodeJson(Current.Key->GetGraph(), Current.Key, Current.Value)));
-		if (Current.Value >= MaxDepth)
-		{
-			continue;
-		}
-
-		for (UEdGraphPin* Pin : Current.Key->Pins)
-		{
-			if (!Pin)
-			{
-				continue;
-			}
-
-			const bool bMatchesDirection = bUpstream ? Pin->Direction == EGPD_Input : Pin->Direction == EGPD_Output;
-			if (!bMatchesDirection)
-			{
-				continue;
-			}
-
-			for (UEdGraphPin* LinkedPin : Pin->LinkedTo)
-			{
-				if (!LinkedPin || !LinkedPin->GetOwningNode())
-				{
-					continue;
-				}
-
-				UEdGraphNode* NextNode = LinkedPin->GetOwningNode();
-				if (Visited.Contains(NextNode->NodeGuid))
-				{
-					continue;
-				}
-
-				Visited.Add(NextNode->NodeGuid);
-				Frontier.Add(TPair<UEdGraphNode*, int32>(NextNode, Current.Value + 1));
-			}
-		}
-	}
-
-	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
-	RootObject->SetArrayField(TEXT("nodes"), NodeValues);
-	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
-}
-
-bool UGitNexusBlueprintAnalyzerCommandlet::WriteJsonToFile(const FString& OutputJsonPath, const TSharedPtr<FJsonObject>& RootObject) const
-{
-	FString JsonText;
-	const TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&JsonText);
-	if (!FJsonSerializer::Serialize(RootObject.ToSharedRef(), Writer))
-	{
-		return false;
-	}
-
-	return FFileHelper::SaveStringToFile(JsonText, *OutputJsonPath);
-}
-
-TArray<FString> UGitNexusBlueprintAnalyzerCommandlet::LoadCandidateAssets(const FString& CandidatesJsonPath) const
-{
-	TArray<FString> Result;
-	if (CandidatesJsonPath.IsEmpty())
-	{
-		return Result;
-	}
-
-	FString RawJson;
-	if (!FFileHelper::LoadFileToString(RawJson, *CandidatesJsonPath))
-	{
-		return Result;
-	}
-
-	TSharedPtr<FJsonObject> RootObject;
-	const TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(RawJson);
-	if (!FJsonSerializer::Deserialize(Reader, RootObject) || !RootObject.IsValid())
-	{
-		return Result;
-	}
-
-	const TArray<TSharedPtr<FJsonValue>>* CandidateValues = nullptr;
-	if (!RootObject->TryGetArrayField(TEXT("candidate_assets"), CandidateValues) || !CandidateValues)
-	{
-		return Result;
-	}
-
-	for (const TSharedPtr<FJsonValue>& Value : *CandidateValues)
-	{
-		const TSharedPtr<FJsonObject>* CandidateObject = nullptr;
-		if (Value.IsValid() && Value->TryGetObject(CandidateObject) && CandidateObject && CandidateObject->IsValid())
-		{
-			FString AssetPath;
-			if ((*CandidateObject)->TryGetStringField(TEXT("asset_path"), AssetPath))
-			{
-				Result.Add(AssetPath);
-			}
-		}
-	}
-
-	return Result;
-}
-
-TArray<FAssetData> UGitNexusBlueprintAnalyzerCommandlet::GetAllBlueprintAssets() const
-{
-	FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>(TEXT("AssetRegistry"));
-	IAssetRegistry& AssetRegistry = AssetRegistryModule.Get();
-	AssetRegistry.SearchAllAssets(true);
-
-	FARFilter Filter;
-	Filter.ClassPaths.Add(UBlueprint::StaticClass()->GetClassPathName());
-	Filter.bRecursiveClasses = true;
-
-	TArray<FAssetData> Assets;
-	AssetRegistry.GetAssets(Filter, Assets);
-	return Assets;
-}
-
-UBlueprint* UGitNexusBlueprintAnalyzerCommandlet::LoadBlueprintFromAssetPath(const FString& AssetPath) const
-{
-	const FSoftObjectPath SoftObjectPath(AssetPath);
-	return Cast<UBlueprint>(SoftObjectPath.TryLoad());
-}
-
-void UGitNexusBlueprintAnalyzerCommandlet::CollectBlueprintGraphs(UBlueprint* Blueprint, TArray<UEdGraph*>& OutGraphs) const
-{
-	if (!Blueprint)
-	{
-		return;
-	}
-
-	Blueprint->GetAllGraphs(OutGraphs);
-}
-
-bool UGitNexusBlueprintAnalyzerCommandlet::IsTargetFunctionNode(
-	const UEdGraphNode* Node,
-	const FString& TargetSymbolKey,
-	const FString& TargetClassName,
-	const FString& TargetFunctionName
-) const
-{
-	if (const UK2Node_CallFunction* CallNode = Cast<UK2Node_CallFunction>(Node))
-	{
-		if (const UFunction* TargetFunction = CallNode->GetTargetFunction())
-		{
-			const UClass* OwnerClass = TargetFunction->GetOwnerClass();
-			const FString SymbolKey = OwnerClass
-				? FString::Printf(TEXT("%s::%s"), *OwnerClass->GetName(), *TargetFunction->GetName())
-				: TargetFunction->GetName();
-			return SymbolKey == TargetSymbolKey
-				|| TargetFunction->GetName() == TargetFunctionName
-				|| (OwnerClass && OwnerClass->GetName() == TargetClassName && TargetFunction->GetName() == TargetFunctionName);
-		}
-	}
-
-	if (const UK2Node_Event* EventNode = Cast<UK2Node_Event>(Node))
-	{
-		return EventNode->GetFunctionName().ToString() == TargetFunctionName;
-	}
-
-	return false;
-}
-
-TSharedPtr<FJsonObject> UGitNexusBlueprintAnalyzerCommandlet::BuildReferenceJson(UBlueprint* Blueprint, const UEdGraph* Graph, const UEdGraphNode* Node) const
-{
-	TSharedPtr<FJsonObject> Object = MakeShared<FJsonObject>();
-	Object->SetStringField(TEXT("asset_path"), Blueprint ? Blueprint->GetPathName() : FString());
-	Object->SetStringField(TEXT("graph_name"), Graph ? Graph->GetName() : FString());
-	Object->SetStringField(TEXT("node_kind"), Node ? Node->GetClass()->GetName() : FString());
-	Object->SetStringField(TEXT("node_title"), Node ? Node->GetNodeTitle(ENodeTitleType::ListView).ToString() : FString());
-	Object->SetStringField(TEXT("blueprint_owner_function"), Graph ? Graph->GetName() : FString());
-	Object->SetStringField(TEXT("chain_anchor_id"), Node ? Node->NodeGuid.ToString(EGuidFormats::DigitsWithHyphens) : FString());
-	Object->SetStringField(TEXT("source"), TEXT("editor_confirmed"));
-	return Object;
-}
-
-TSharedPtr<FJsonObject> UGitNexusBlueprintAnalyzerCommandlet::BuildChainNodeJson(const UEdGraph* Graph, const UEdGraphNode* Node, int32 Depth) const
-{
-	TSharedPtr<FJsonObject> Object = MakeShared<FJsonObject>();
-	Object->SetStringField(TEXT("node_id"), Node ? Node->NodeGuid.ToString(EGuidFormats::DigitsWithHyphens) : FString());
-	Object->SetStringField(TEXT("graph_name"), Graph ? Graph->GetName() : FString());
-	Object->SetStringField(TEXT("node_kind"), Node ? Node->GetClass()->GetName() : FString());
-	Object->SetStringField(TEXT("node_title"), Node ? Node->GetNodeTitle(ENodeTitleType::ListView).ToString() : FString());
-	Object->SetNumberField(TEXT("depth"), Depth);
-	return Object;
-}
-
-UEdGraphNode* UGitNexusBlueprintAnalyzerCommandlet::FindNodeByGuid(UBlueprint* Blueprint, const FString& NodeGuid) const
-{
-	if (!Blueprint)
-	{
-		return nullptr;
-	}
-
-	FGuid Guid;
-	if (!FGuid::Parse(NodeGuid, Guid))
-	{
-		return nullptr;
-	}
-
-	TArray<UEdGraph*> Graphs;
-	CollectBlueprintGraphs(Blueprint, Graphs);
-	for (UEdGraph* Graph : Graphs)
-	{
-		if (!Graph)
-		{
-			continue;
-		}
-
-		for (UEdGraphNode* Node : Graph->Nodes)
-		{
-			if (Node && Node->NodeGuid == Guid)
-			{
-				return Node;
-			}
-		}
-	}
-
-	return nullptr;
-}
+#include "GitNexusBlueprintAnalyzerCommandlet.h"
+
+#include "AssetRegistry/AssetRegistryModule.h"
+#include "AssetRegistry/IAssetRegistry.h"
+#include "Blueprint/BlueprintSupport.h"
+#include "Blueprint/UserWidget.h"
+#include "Dom/JsonObject.h"
+#include "EdGraph/EdGraph.h"
+#include "EdGraph/EdGraphNode.h"
+#include "EdGraph/EdGraphPin.h"
+#include "Engine/Blueprint.h"
+#include "EdGraphSchema_K2.h"
+#include "K2Node_CallFunction.h"
+#include "K2Node_Event.h"
+#include "K2Node_IfThenElse.h"
+#include "K2Node_Switch.h"
+#include "K2Node_VariableGet.h"
+#include "K2Node_VariableSet.h"
+#include "Kismet2/BlueprintEditorUtils.h"
+#include "Misc/FileHelper.h"
+#include "Misc/Guid.h"
+#include "Misc/PackageName.h"
+#include "Misc/Paths.h"
+#include "Serialization/JsonReader.h"
+#include "Serialization/JsonSerializer.h"
+#include "UObject/SoftObjectPath.h"
+#include "UObject/GarbageCollection.h"
+
+UGitNexusBlueprintAnalyzerCommandlet::UGitNexusBlueprintAnalyzerCommandlet()
+{
+	IsClient = false;
+	IsEditor = true;
+	LogToConsole = true;
+	ShowErrorCount = true;
+}
+
+int32 UGitNexusBlueprintAnalyzerCommandlet::Main(const FString& Params)
+{
+	FString Operation;
+	FString OutputJsonPath;
+	FParse::Value(*Params, TEXT("Operation="), Operation);
+	FParse::Value(*Params, TEXT("OutputJson="), OutputJsonPath);
+
+	if (Operation.IsEmpty() || OutputJsonPath.IsEmpty())
+	{
+		UE_LOG(LogTemp, Error, TEXT("GitNexusBlueprintAnalyzer requires Operation= and OutputJson= parameters."));
+		return 1;
+	}
+
+	if (Operation.Equals(TEXT("SyncAssets"), ESearchCase::IgnoreCase))
+	{
+		FString FilterJsonPath;
+		FParse::Value(*Params, TEXT("FilterJson="), FilterJsonPath);
+		// Legacy support: also check IgnoreJson= for backward compatibility
+		if (FilterJsonPath.IsEmpty())
+		{
+			FParse::Value(*Params, TEXT("IgnoreJson="), FilterJsonPath);
+		}
+		FString ModeStr;
+		FParse::Value(*Params, TEXT("Mode="), ModeStr);
+		const bool bDeepMode = ModeStr.Equals(TEXT("deep"), ESearchCase::IgnoreCase);
+		return RunSyncAssets(OutputJsonPath, FilterJsonPath, bDeepMode);
+	}
+
+	if (Operation.Equals(TEXT("FindNativeBlueprintReferences"), ESearchCase::IgnoreCase))
+	{
+		FString CandidatesJsonPath;
+		FString TargetSymbolKey;
+		FString TargetClassName;
+		FString TargetFunctionName;
+		FParse::Value(*Params, TEXT("CandidatesJson="), CandidatesJsonPath);
+		FParse::Value(*Params, TEXT("TargetSymbolKey="), TargetSymbolKey);
+		FParse::Value(*Params, TEXT("TargetClass="), TargetClassName);
+		FParse::Value(*Params, TEXT("TargetFunction="), TargetFunctionName);
+		return RunFindNativeBlueprintReferences(OutputJsonPath, CandidatesJsonPath, TargetSymbolKey, TargetClassName, TargetFunctionName);
+	}
+
+	if (Operation.Equals(TEXT("ExpandBlueprintChain"), ESearchCase::IgnoreCase))
+	{
+		FString AssetPath;
+		FString ChainAnchorId;
+		FString Direction = TEXT("downstream");
+		int32 MaxDepth = 5;
+		FParse::Value(*Params, TEXT("AssetPath="), AssetPath);
+		FParse::Value(*Params, TEXT("ChainAnchorId="), ChainAnchorId);
+		FParse::Value(*Params, TEXT("Direction="), Direction);
+		FParse::Value(*Params, TEXT("MaxDepth="), MaxDepth);
+		return RunExpandBlueprintChain(OutputJsonPath, AssetPath, ChainAnchorId, Direction, MaxDepth);
+	}
+
+	UE_LOG(LogTemp, Error, TEXT("Unsupported GitNexusBlueprintAnalyzer operation: %s"), *Operation);
+	return 1;
+}
+
+// ── SyncAssets entry point ──────────────────────────────────────────────
+
+int32 UGitNexusBlueprintAnalyzerCommandlet::RunSyncAssets(
+	const FString& OutputJsonPath,
+	const FString& FilterJsonPath,
+	bool bDeepMode)
+{
+	const FFilterPrefixes Filters = LoadFilterPrefixes(FilterJsonPath);
+	const TArray<FAssetData> Assets = GetAllBlueprintAssets(Filters);
+
+	if (bDeepMode)
+	{
+		UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: Running in DEEP mode (full Blueprint loading)"));
+		return RunSyncAssetsDeep(OutputJsonPath, Assets);
+	}
+
+	UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: Running in METADATA mode (no asset loading)"));
+	return RunSyncAssetsMetadata(OutputJsonPath, Assets);
+}
+
+// ── Metadata-only sync (default) ────────────────────────────────────────
+// Uses FAssetData tags + AssetRegistry dependencies. Zero asset loading.
+
+int32 UGitNexusBlueprintAnalyzerCommandlet::RunSyncAssetsMetadata(
+	const FString& OutputJsonPath,
+	const TArray<FAssetData>& Assets)
+{
+	TArray<TSharedPtr<FJsonValue>> AssetValues;
+	IAssetRegistry& AssetRegistry = IAssetRegistry::GetChecked();
+
+	for (const FAssetData& AssetData : Assets)
+	{
+		TSharedPtr<FJsonObject> AssetObject = MakeShared<FJsonObject>();
+		AssetObject->SetStringField(TEXT("asset_path"), AssetData.GetSoftObjectPath().ToString());
+
+		// GeneratedClass from tag
+		FString GeneratedClassTag;
+		if (AssetData.GetTagValue(FBlueprintTags::GeneratedClassPath, GeneratedClassTag))
+		{
+			AssetObject->SetStringField(TEXT("generated_class"), GeneratedClassTag);
+		}
+
+		// ParentClass from tag
+		FString ParentClassTag;
+		if (AssetData.GetTagValue(FBlueprintTags::ParentClassPath, ParentClassTag))
+		{
+			AssetObject->SetStringField(TEXT("parent_class"), ParentClassTag);
+
+			// Extract native parent from the tag (class name after the last '.')
+			const int32 DotIdx = ParentClassTag.Find(TEXT("."), ESearchCase::IgnoreCase, ESearchDir::FromEnd);
+			if (DotIdx != INDEX_NONE)
+			{
+				FString ParentClassName = ParentClassTag.Mid(DotIdx + 1);
+				// Remove trailing _C suffix if present (generated class suffix)
+				if (ParentClassName.EndsWith(TEXT("_C")))
+				{
+					ParentClassName = ParentClassName.LeftChop(2);
+				}
+				// Remove trailing ' (quote) from path notation
+				ParentClassName.RemoveFromEnd(TEXT("'"));
+				TArray<TSharedPtr<FJsonValue>> NativeParents;
+				NativeParents.Add(MakeShared<FJsonValueString>(ParentClassName));
+				AssetObject->SetArrayField(TEXT("native_parents"), NativeParents);
+			}
+		}
+
+		// NativeParentClass tag (more reliable for native parents)
+		FString NativeParentClassTag;
+		if (AssetData.GetTagValue(FBlueprintTags::NativeParentClassPath, NativeParentClassTag))
+		{
+			const int32 DotIdx = NativeParentClassTag.Find(TEXT("."), ESearchCase::IgnoreCase, ESearchDir::FromEnd);
+			if (DotIdx != INDEX_NONE)
+			{
+				FString NativeClassName = NativeParentClassTag.Mid(DotIdx + 1);
+				NativeClassName.RemoveFromEnd(TEXT("'"));
+				TArray<TSharedPtr<FJsonValue>> NativeParents;
+				NativeParents.Add(MakeShared<FJsonValueString>(NativeClassName));
+				AssetObject->SetArrayField(TEXT("native_parents"), NativeParents);
+			}
+		}
+
+		// Dependencies from AssetRegistry (no loading needed)
+		TArray<FName> Dependencies;
+		AssetRegistry.GetDependencies(AssetData.PackageName, Dependencies, UE::AssetRegistry::EDependencyCategory::Package);
+		TArray<TSharedPtr<FJsonValue>> DependencyValues;
+		for (const FName& Dependency : Dependencies)
+		{
+			DependencyValues.Add(MakeShared<FJsonValueString>(Dependency.ToString()));
+		}
+		AssetObject->SetArrayField(TEXT("dependencies"), DependencyValues);
+
+		// native_function_refs not available in metadata mode
+		AssetObject->SetArrayField(TEXT("native_function_refs"), TArray<TSharedPtr<FJsonValue>>());
+
+		AssetValues.Add(MakeShared<FJsonValueObject>(AssetObject));
+	}
+
+	UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: %d assets indexed (metadata mode)"), AssetValues.Num());
+
+	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
+	RootObject->SetNumberField(TEXT("version"), 1);
+	RootObject->SetStringField(TEXT("generated_at"), FDateTime::UtcNow().ToIso8601());
+	RootObject->SetStringField(TEXT("project_path"), FPaths::ConvertRelativePathToFull(FPaths::GetProjectFilePath()));
+	RootObject->SetStringField(TEXT("mode"), TEXT("metadata"));
+	RootObject->SetArrayField(TEXT("assets"), AssetValues);
+
+	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
+}
+
+// ── Deep sync (--deep) ──────────────────────────────────────────────────
+// Loads each Blueprint fully to extract native_function_refs from graphs.
+// Uses batch GC to prevent OOM on large projects.
+
+static constexpr int32 DEEP_BATCH_SIZE = 50;
+
+int32 UGitNexusBlueprintAnalyzerCommandlet::RunSyncAssetsDeep(
+	const FString& OutputJsonPath,
+	const TArray<FAssetData>& Assets)
+{
+	TArray<TSharedPtr<FJsonValue>> AssetValues;
+	int32 SkippedCount = 0;
+	int32 BatchCounter = 0;
+
+	for (const FAssetData& AssetData : Assets)
+	{
+		const FSoftObjectPath SoftPath = AssetData.GetSoftObjectPath();
+		UObject* LoadedAsset = SoftPath.TryLoad();
+		UBlueprint* Blueprint = LoadedAsset ? Cast<UBlueprint>(LoadedAsset) : nullptr;
+		if (!Blueprint)
+		{
+			if (!LoadedAsset)
+			{
+				SkippedCount++;
+				UE_LOG(LogTemp, Warning, TEXT("GitNexusBlueprintAnalyzer: Skipped asset (failed to load): %s"), *AssetData.PackageName.ToString());
+			}
+			continue;
+		}
+
+		TSharedPtr<FJsonObject> AssetObject = MakeShared<FJsonObject>();
+		AssetObject->SetStringField(TEXT("asset_path"), AssetData.GetSoftObjectPath().ToString());
+
+		if (Blueprint->GeneratedClass)
+		{
+			AssetObject->SetStringField(TEXT("generated_class"), Blueprint->GeneratedClass->GetPathName());
+		}
+
+		if (Blueprint->ParentClass)
+		{
+			AssetObject->SetStringField(TEXT("parent_class"), Blueprint->ParentClass->GetPathName());
+		}
+
+		TArray<TSharedPtr<FJsonValue>> NativeParents;
+		for (UClass* Class = Blueprint->ParentClass; Class; Class = Class->GetSuperClass())
+		{
+			if (Class->ClassGeneratedBy == nullptr)
+			{
+				NativeParents.Add(MakeShared<FJsonValueString>(Class->GetName()));
+			}
+		}
+		AssetObject->SetArrayField(TEXT("native_parents"), NativeParents);
+
+		TArray<FName> Dependencies;
+		IAssetRegistry::GetChecked().GetDependencies(AssetData.PackageName, Dependencies, UE::AssetRegistry::EDependencyCategory::Package);
+		TArray<TSharedPtr<FJsonValue>> DependencyValues;
+		for (const FName& Dependency : Dependencies)
+		{
+			DependencyValues.Add(MakeShared<FJsonValueString>(Dependency.ToString()));
+		}
+		AssetObject->SetArrayField(TEXT("dependencies"), DependencyValues);
+
+		TArray<UEdGraph*> Graphs;
+		CollectBlueprintGraphs(Blueprint, Graphs);
+		TSet<FString> NativeFunctionRefs;
+		for (const UEdGraph* Graph : Graphs)
+		{
+			if (!Graph)
+			{
+				continue;
+			}
+
+			for (const UEdGraphNode* Node : Graph->Nodes)
+			{
+				if (const UK2Node_CallFunction* CallNode = Cast<UK2Node_CallFunction>(Node))
+				{
+					if (const UFunction* TargetFunction = CallNode->GetTargetFunction())
+					{
+						const UClass* OwnerClass = TargetFunction->GetOwnerClass();
+						const FString SymbolKey = OwnerClass
+							? FString::Printf(TEXT("%s::%s"), *OwnerClass->GetName(), *TargetFunction->GetName())
+							: TargetFunction->GetName();
+						NativeFunctionRefs.Add(SymbolKey);
+					}
+				}
+			}
+		}
+
+		TArray<TSharedPtr<FJsonValue>> NativeFunctionRefValues;
+		for (const FString& Ref : NativeFunctionRefs)
+		{
+			NativeFunctionRefValues.Add(MakeShared<FJsonValueString>(Ref));
+		}
+		AssetObject->SetArrayField(TEXT("native_function_refs"), NativeFunctionRefValues);
+
+		AssetValues.Add(MakeShared<FJsonValueObject>(AssetObject));
+
+		// Batch GC to prevent OOM on large projects
+		BatchCounter++;
+		if (BatchCounter >= DEEP_BATCH_SIZE)
+		{
+			CollectGarbage(GARBAGE_COLLECTION_KEEPFLAGS);
+			BatchCounter = 0;
+			UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: Processed %d / %d assets (GC)"), AssetValues.Num(), Assets.Num());
+		}
+	}
+
+	if (SkippedCount > 0)
+	{
+		UE_LOG(LogTemp, Warning, TEXT("GitNexusBlueprintAnalyzer: %d assets skipped (failed to load)"), SkippedCount);
+	}
+	UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: %d assets indexed (deep mode)"), AssetValues.Num());
+
+	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
+	RootObject->SetNumberField(TEXT("version"), 1);
+	RootObject->SetStringField(TEXT("generated_at"), FDateTime::UtcNow().ToIso8601());
+	RootObject->SetStringField(TEXT("project_path"), FPaths::ConvertRelativePathToFull(FPaths::GetProjectFilePath()));
+	RootObject->SetStringField(TEXT("mode"), TEXT("deep"));
+	RootObject->SetArrayField(TEXT("assets"), AssetValues);
+
+	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
+}
+
+// ── FindNativeBlueprintReferences ───────────────────────────────────────
+
+int32 UGitNexusBlueprintAnalyzerCommandlet::RunFindNativeBlueprintReferences(
+	const FString& OutputJsonPath,
+	const FString& CandidatesJsonPath,
+	const FString& TargetSymbolKey,
+	const FString& TargetClassName,
+	const FString& TargetFunctionName
+)
+{
+	TArray<TSharedPtr<FJsonValue>> ConfirmedReferences;
+	TArray<FString> CandidateAssets = LoadCandidateAssets(CandidatesJsonPath);
+
+	for (const FString& AssetPath : CandidateAssets)
+	{
+		UBlueprint* Blueprint = LoadBlueprintFromAssetPath(AssetPath);
+		if (!Blueprint)
+		{
+			continue;
+		}
+
+		TArray<UEdGraph*> Graphs;
+		CollectBlueprintGraphs(Blueprint, Graphs);
+		for (const UEdGraph* Graph : Graphs)
+		{
+			if (!Graph)
+			{
+				continue;
+			}
+
+			for (const UEdGraphNode* Node : Graph->Nodes)
+			{
+				if (Node && IsTargetFunctionNode(Node, TargetSymbolKey, TargetClassName, TargetFunctionName))
+				{
+					ConfirmedReferences.Add(MakeShared<FJsonValueObject>(BuildReferenceJson(Blueprint, Graph, Node)));
+				}
+			}
+		}
+	}
+
+	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
+	TSharedPtr<FJsonObject> TargetObject = MakeShared<FJsonObject>();
+	TargetObject->SetStringField(TEXT("symbol_key"), TargetSymbolKey);
+	TargetObject->SetStringField(TEXT("class_name"), TargetClassName);
+	TargetObject->SetStringField(TEXT("symbol_name"), TargetFunctionName);
+	RootObject->SetObjectField(TEXT("target_function"), TargetObject);
+	RootObject->SetNumberField(TEXT("candidates_scanned"), CandidateAssets.Num());
+	RootObject->SetArrayField(TEXT("confirmed_references"), ConfirmedReferences);
+
+	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
+}
+
+// ── ExpandBlueprintChain ────────────────────────────────────────────────
+
+int32 UGitNexusBlueprintAnalyzerCommandlet::RunExpandBlueprintChain(
+	const FString& OutputJsonPath,
+	const FString& AssetPath,
+	const FString& ChainAnchorId,
+	const FString& Direction,
+	int32 MaxDepth
+)
+{
+	UBlueprint* Blueprint = LoadBlueprintFromAssetPath(AssetPath);
+	if (!Blueprint)
+	{
+		return 1;
+	}
+
+	UEdGraphNode* StartNode = FindNodeByGuid(Blueprint, ChainAnchorId);
+	if (!StartNode)
+	{
+		return 1;
+	}
+
+	struct FChainFrontierEntry
+	{
+		UEdGraphNode* Node;
+		int32 Depth;
+		FString TraversedFromPinName;
+		FGuid TraversedFromNodeId;
+	};
+
+	TArray<TSharedPtr<FJsonValue>> NodeValues;
+	TSet<FGuid> Visited;
+	TArray<FChainFrontierEntry> Frontier;
+	Frontier.Add({ StartNode, 0, FString(), FGuid() });
+	Visited.Add(StartNode->NodeGuid);
+
+	const bool bUpstream = Direction.Equals(TEXT("upstream"), ESearchCase::IgnoreCase);
+
+	while (Frontier.Num() > 0)
+	{
+		const FChainFrontierEntry Current = Frontier[0];
+		Frontier.RemoveAt(0);
+
+		NodeValues.Add(MakeShared<FJsonValueObject>(BuildChainNodeJson(
+			Current.Node->GetGraph(), Current.Node, Current.Depth,
+			Current.TraversedFromPinName, Current.TraversedFromNodeId)));
+		if (Current.Depth >= MaxDepth)
+		{
+			continue;
+		}
+
+		for (UEdGraphPin* Pin : Current.Node->Pins)
+		{
+			if (!Pin)
+			{
+				continue;
+			}
+
+			const bool bMatchesDirection = bUpstream ? Pin->Direction == EGPD_Input : Pin->Direction == EGPD_Output;
+			if (!bMatchesDirection)
+			{
+				continue;
+			}
+
+			for (UEdGraphPin* LinkedPin : Pin->LinkedTo)
+			{
+				if (!LinkedPin || !LinkedPin->GetOwningNode())
+				{
+					continue;
+				}
+
+				UEdGraphNode* NextNode = LinkedPin->GetOwningNode();
+				if (Visited.Contains(NextNode->NodeGuid))
+				{
+					continue;
+				}
+
+				// NOTE: In diamond-shaped graphs, BFS only records the first-discovered parent.
+				Visited.Add(NextNode->NodeGuid);
+				Frontier.Add({ NextNode, Current.Depth + 1, Pin->PinName.ToString(), Current.Node->NodeGuid });
+			}
+		}
+	}
+
+	TSharedPtr<FJsonObject> RootObject = MakeShared<FJsonObject>();
+	RootObject->SetArrayField(TEXT("nodes"), NodeValues);
+	return WriteJsonToFile(OutputJsonPath, RootObject) ? 0 : 1;
+}
+
+// ── Utility functions ───────────────────────────────────────────────────
+
+bool UGitNexusBlueprintAnalyzerCommandlet::WriteJsonToFile(const FString& OutputJsonPath, const TSharedPtr<FJsonObject>& RootObject) const
+{
+	FString JsonText;
+	const TSharedRef<TJsonWriter<>> Writer = TJsonWriterFactory<>::Create(&JsonText);
+	if (!FJsonSerializer::Serialize(RootObject.ToSharedRef(), Writer))
+	{
+		return false;
+	}
+
+	return FFileHelper::SaveStringToFile(JsonText, *OutputJsonPath, FFileHelper::EEncodingOptions::ForceUTF8WithoutBOM);
+}
+
+TArray<FString> UGitNexusBlueprintAnalyzerCommandlet::LoadCandidateAssets(const FString& CandidatesJsonPath) const
+{
+	TArray<FString> Result;
+	if (CandidatesJsonPath.IsEmpty())
+	{
+		return Result;
+	}
+
+	FString RawJson;
+	if (!FFileHelper::LoadFileToString(RawJson, *CandidatesJsonPath))
+	{
+		return Result;
+	}
+
+	TSharedPtr<FJsonObject> RootObject;
+	const TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(RawJson);
+	if (!FJsonSerializer::Deserialize(Reader, RootObject) || !RootObject.IsValid())
+	{
+		return Result;
+	}
+
+	const TArray<TSharedPtr<FJsonValue>>* CandidateValues = nullptr;
+	if (!RootObject->TryGetArrayField(TEXT("candidate_assets"), CandidateValues) || !CandidateValues)
+	{
+		return Result;
+	}
+
+	for (const TSharedPtr<FJsonValue>& Value : *CandidateValues)
+	{
+		const TSharedPtr<FJsonObject>* CandidateObject = nullptr;
+		if (Value.IsValid() && Value->TryGetObject(CandidateObject) && CandidateObject && CandidateObject->IsValid())
+		{
+			FString AssetPath;
+			if ((*CandidateObject)->TryGetStringField(TEXT("asset_path"), AssetPath))
+			{
+				Result.Add(AssetPath);
+			}
+		}
+	}
+
+	return Result;
+}
+
+UGitNexusBlueprintAnalyzerCommandlet::FFilterPrefixes
+UGitNexusBlueprintAnalyzerCommandlet::LoadFilterPrefixes(const FString& FilterJsonPath) const
+{
+	FFilterPrefixes Result;
+	if (FilterJsonPath.IsEmpty())
+	{
+		return Result;
+	}
+
+	FString RawJson;
+	if (!FFileHelper::LoadFileToString(RawJson, *FilterJsonPath))
+	{
+		UE_LOG(LogTemp, Warning, TEXT("GitNexusBlueprintAnalyzer: Could not read filter file: %s"), *FilterJsonPath);
+		return Result;
+	}
+
+	TSharedPtr<FJsonObject> RootObject;
+	const TSharedRef<TJsonReader<>> Reader = TJsonReaderFactory<>::Create(RawJson);
+	if (!FJsonSerializer::Deserialize(Reader, RootObject) || !RootObject.IsValid())
+	{
+		return Result;
+	}
+
+	// Read include_prefixes (whitelist — if set, ONLY these paths are included)
+	const TArray<TSharedPtr<FJsonValue>>* IncludeValues = nullptr;
+	if (RootObject->TryGetArrayField(TEXT("include_prefixes"), IncludeValues) && IncludeValues)
+	{
+		for (const TSharedPtr<FJsonValue>& Value : *IncludeValues)
+		{
+			FString Prefix;
+			if (Value.IsValid() && Value->TryGetString(Prefix))
+			{
+				Result.IncludePrefixes.Add(Prefix);
+			}
+		}
+	}
+
+	// Read exclude_prefixes (blacklist)
+	const TArray<TSharedPtr<FJsonValue>>* ExcludeValues = nullptr;
+	if (RootObject->TryGetArrayField(TEXT("exclude_prefixes"), ExcludeValues) && ExcludeValues)
+	{
+		for (const TSharedPtr<FJsonValue>& Value : *ExcludeValues)
+		{
+			FString Prefix;
+			if (Value.IsValid() && Value->TryGetString(Prefix))
+			{
+				Result.ExcludePrefixes.Add(Prefix);
+			}
+		}
+	}
+
+	if (Result.IncludePrefixes.Num() > 0)
+	{
+		UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: Loaded %d include prefixes (whitelist)"), Result.IncludePrefixes.Num());
+	}
+	if (Result.ExcludePrefixes.Num() > 0)
+	{
+		UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: Loaded %d exclude prefixes"), Result.ExcludePrefixes.Num());
+	}
+
+	return Result;
+}
+
+TArray<FAssetData> UGitNexusBlueprintAnalyzerCommandlet::GetAllBlueprintAssets(const FFilterPrefixes& Filters) const
+{
+	FAssetRegistryModule& AssetRegistryModule = FModuleManager::LoadModuleChecked<FAssetRegistryModule>(TEXT("AssetRegistry"));
+	IAssetRegistry& AssetRegistry = AssetRegistryModule.Get();
+	AssetRegistry.SearchAllAssets(true);
+
+	FARFilter Filter;
+	Filter.ClassPaths.Add(UBlueprint::StaticClass()->GetClassPathName());
+	Filter.bRecursiveClasses = true;
+
+	TArray<FAssetData> AllAssets;
+	AssetRegistry.GetAssets(Filter, AllAssets);
+
+	const bool bHasIncludes = Filters.IncludePrefixes.Num() > 0;
+	const bool bHasExcludes = Filters.ExcludePrefixes.Num() > 0;
+
+	if (!bHasIncludes && !bHasExcludes)
+	{
+		return AllAssets;
+	}
+
+	TArray<FAssetData> FilteredAssets;
+	int32 IncludedCount = 0;
+	int32 ExcludedCount = 0;
+
+	for (const FAssetData& Asset : AllAssets)
+	{
+		const FString PackagePath = Asset.PackageName.ToString();
+
+		// Include filter (whitelist): if set, asset MUST match at least one prefix
+		if (bHasIncludes)
+		{
+			bool bIncluded = false;
+			for (const FString& Prefix : Filters.IncludePrefixes)
+			{
+				if (PackagePath.StartsWith(Prefix))
+				{
+					bIncluded = true;
+					break;
+				}
+			}
+			if (!bIncluded)
+			{
+				IncludedCount++;
+				continue;
+			}
+		}
+
+		// Exclude filter (blacklist): skip assets matching any prefix
+		if (bHasExcludes)
+		{
+			bool bExcluded = false;
+			for (const FString& Prefix : Filters.ExcludePrefixes)
+			{
+				if (PackagePath.StartsWith(Prefix))
+				{
+					bExcluded = true;
+					break;
+				}
+			}
+			if (bExcluded)
+			{
+				ExcludedCount++;
+				continue;
+			}
+		}
+
+		FilteredAssets.Add(Asset);
+	}
+
+	UE_LOG(LogTemp, Display, TEXT("GitNexusBlueprintAnalyzer: %d assets after filtering (%d outside include scope, %d excluded)"),
+		FilteredAssets.Num(), IncludedCount, ExcludedCount);
+	return FilteredAssets;
+}
+
+UBlueprint* UGitNexusBlueprintAnalyzerCommandlet::LoadBlueprintFromAssetPath(const FString& AssetPath) const
+{
+	const FSoftObjectPath SoftObjectPath(AssetPath);
+	return Cast<UBlueprint>(SoftObjectPath.TryLoad());
+}
+
+void UGitNexusBlueprintAnalyzerCommandlet::CollectBlueprintGraphs(UBlueprint* Blueprint, TArray<UEdGraph*>& OutGraphs) const
+{
+	if (!Blueprint)
+	{
+		return;
+	}
+
+	Blueprint->GetAllGraphs(OutGraphs);
+}
+
+bool UGitNexusBlueprintAnalyzerCommandlet::IsTargetFunctionNode(
+	const UEdGraphNode* Node,
+	const FString& TargetSymbolKey,
+	const FString& TargetClassName,
+	const FString& TargetFunctionName
+) const
+{
+	if (const UK2Node_CallFunction* CallNode = Cast<UK2Node_CallFunction>(Node))
+	{
+		if (const UFunction* TargetFunction = CallNode->GetTargetFunction())
+		{
+			const UClass* OwnerClass = TargetFunction->GetOwnerClass();
+			const FString SymbolKey = OwnerClass
+				? FString::Printf(TEXT("%s::%s"), *OwnerClass->GetName(), *TargetFunction->GetName())
+				: TargetFunction->GetName();
+			return SymbolKey == TargetSymbolKey
+				|| TargetFunction->GetName() == TargetFunctionName
+				|| (OwnerClass && OwnerClass->GetName() == TargetClassName && TargetFunction->GetName() == TargetFunctionName);
+		}
+	}
+
+	if (const UK2Node_Event* EventNode = Cast<UK2Node_Event>(Node))
+	{
+		return EventNode->GetFunctionName().ToString() == TargetFunctionName;
+	}
+
+	return false;
+}
+
+TSharedPtr<FJsonObject> UGitNexusBlueprintAnalyzerCommandlet::BuildReferenceJson(UBlueprint* Blueprint, const UEdGraph* Graph, const UEdGraphNode* Node) const
+{
+	TSharedPtr<FJsonObject> Object = MakeShared<FJsonObject>();
+	Object->SetStringField(TEXT("asset_path"), Blueprint ? Blueprint->GetPathName() : FString());
+	Object->SetStringField(TEXT("graph_name"), Graph ? Graph->GetName() : FString());
+	Object->SetStringField(TEXT("node_kind"), Node ? Node->GetClass()->GetName() : FString());
+	Object->SetStringField(TEXT("node_title"), Node ? Node->GetNodeTitle(ENodeTitleType::ListView).ToString() : FString());
+	Object->SetStringField(TEXT("blueprint_owner_function"), Graph ? Graph->GetName() : FString());
+	Object->SetStringField(TEXT("chain_anchor_id"), Node ? Node->NodeGuid.ToString(EGuidFormats::DigitsWithHyphens) : FString());
+	Object->SetStringField(TEXT("source"), TEXT("editor_confirmed"));
+	return Object;
+}
+
+TSharedPtr<FJsonObject> UGitNexusBlueprintAnalyzerCommandlet::BuildChainNodeJson(
+	const UEdGraph* Graph, const UEdGraphNode* Node, int32 Depth,
+	const FString& TraversedFromPinName, const FGuid& TraversedFromNodeId) const
+{
+	TSharedPtr<FJsonObject> Object = MakeShared<FJsonObject>();
+	Object->SetStringField(TEXT("node_id"), Node ? Node->NodeGuid.ToString(EGuidFormats::DigitsWithHyphens) : FString());
+	Object->SetStringField(TEXT("graph_name"), Graph ? Graph->GetName() : FString());
+	Object->SetStringField(TEXT("node_kind"), Node ? Node->GetClass()->GetName() : FString());
+	Object->SetStringField(TEXT("node_title"), Node ? Node->GetNodeTitle(ENodeTitleType::ListView).ToString() : FString());
+	Object->SetNumberField(TEXT("depth"), Depth);
+
+	if (!TraversedFromPinName.IsEmpty())
+	{
+		Object->SetStringField(TEXT("traversed_from_pin"), TraversedFromPinName);
+	}
+	if (TraversedFromNodeId.IsValid())
+	{
+		Object->SetStringField(TEXT("traversed_from_node"), TraversedFromNodeId.ToString(EGuidFormats::DigitsWithHyphens));
+	}
+
+	if (Node)
+	{
+		AnnotateNodeMetadata(Object, Node);
+		Object->SetObjectField(TEXT("pins"), BuildPinsJson(Node));
+		AnnotateNodeDetails(Object, Node);
+	}
+
+	return Object;
+}
+
+TSharedPtr<FJsonObject> UGitNexusBlueprintAnalyzerCommandlet::BuildPinJson(const UEdGraphPin* Pin) const
+{
+	TSharedPtr<FJsonObject> PinObj = MakeShared<FJsonObject>();
+	if (!Pin)
+	{
+		return PinObj;
+	}
+
+	PinObj->SetStringField(TEXT("name"), Pin->PinName.ToString());
+	PinObj->SetStringField(TEXT("direction"), Pin->Direction == EGPD_Input ? TEXT("input") : TEXT("output"));
+	PinObj->SetStringField(TEXT("type"), Pin->PinType.PinCategory.ToString());
+
+	if (Pin->PinType.PinSubCategoryObject.IsValid())
+	{
+		PinObj->SetStringField(TEXT("sub_type"), Pin->PinType.PinSubCategoryObject->GetName());
+	}
+
+	if (!Pin->DefaultValue.IsEmpty())
+	{
+		PinObj->SetStringField(TEXT("default_value"), Pin->DefaultValue);
+	}
+	else if (Pin->DefaultObject)
+	{
+		PinObj->SetStringField(TEXT("default_value"), Pin->DefaultObject->GetPathName());
+	}
+
+	if (Pin->LinkedTo.Num() > 0)
+	{
+		TArray<TSharedPtr<FJsonValue>> ConnectedTo;
+		TArray<TSharedPtr<FJsonValue>> ConnectedToTitle;
+		for (const UEdGraphPin* LinkedPin : Pin->LinkedTo)
+		{
+			if (LinkedPin && LinkedPin->GetOwningNode())
+			{
+				ConnectedTo.Add(MakeShared<FJsonValueString>(
+					LinkedPin->GetOwningNode()->NodeGuid.ToString(EGuidFormats::DigitsWithHyphens)));
+				ConnectedToTitle.Add(MakeShared<FJsonValueString>(
+					LinkedPin->GetOwningNode()->GetNodeTitle(ENodeTitleType::ListView).ToString()));
+			}
+		}
+		PinObj->SetArrayField(TEXT("connected_to"), ConnectedTo);
+		PinObj->SetArrayField(TEXT("connected_to_title"), ConnectedToTitle);
+	}
+
+	return PinObj;
+}
+
+TSharedPtr<FJsonObject> UGitNexusBlueprintAnalyzerCommandlet::BuildPinsJson(const UEdGraphNode* Node) const
+{
+	TSharedPtr<FJsonObject> PinsObj = MakeShared<FJsonObject>();
+	if (!Node)
+	{
+		return PinsObj;
+	}
+
+	TArray<TSharedPtr<FJsonValue>> ExecPins;
+	TArray<TSharedPtr<FJsonValue>> DataPins;
+
+	for (const UEdGraphPin* Pin : Node->Pins)
+	{
+		if (!Pin)
+		{
+			continue;
+		}
+
+		TSharedPtr<FJsonObject> PinJson = BuildPinJson(Pin);
+		if (Pin->PinType.PinCategory == UEdGraphSchema_K2::PC_Exec)
+		{
+			ExecPins.Add(MakeShared<FJsonValueObject>(PinJson));
+		}
+		else
+		{
+			DataPins.Add(MakeShared<FJsonValueObject>(PinJson));
+		}
+	}
+
+	PinsObj->SetArrayField(TEXT("exec_pins"), ExecPins);
+	PinsObj->SetArrayField(TEXT("data_pins"), DataPins);
+	return PinsObj;
+}
+
+void UGitNexusBlueprintAnalyzerCommandlet::AnnotateNodeMetadata(TSharedPtr<FJsonObject>& NodeObj, const UEdGraphNode* Node) const
+{
+	if (!Node)
+	{
+		return;
+	}
+
+	NodeObj->SetBoolField(TEXT("is_enabled"), Node->IsNodeEnabled());
+
+	if (!Node->NodeComment.IsEmpty())
+	{
+		NodeObj->SetStringField(TEXT("comment"), Node->NodeComment);
+	}
+}
+
+void UGitNexusBlueprintAnalyzerCommandlet::AnnotateNodeDetails(TSharedPtr<FJsonObject>& NodeObj, const UEdGraphNode* Node) const
+{
+	if (!Node)
+	{
+		return;
+	}
+
+	TSharedPtr<FJsonObject> Details = MakeShared<FJsonObject>();
+	bool bHasDetails = false;
+
+	if (const UK2Node_CallFunction* CallNode = Cast<UK2Node_CallFunction>(Node))
+	{
+		Details->SetBoolField(TEXT("is_pure"), CallNode->IsNodePure());
+		if (const UFunction* TargetFunction = CallNode->GetTargetFunction())
+		{
+			Details->SetStringField(TEXT("function_name"), TargetFunction->GetName());
+			if (const UClass* OwnerClass = TargetFunction->GetOwnerClass())
+			{
+				Details->SetStringField(TEXT("target_class"), OwnerClass->GetName());
+			}
+		}
+		bHasDetails = true;
+	}
+	else if (const UK2Node_VariableGet* GetNode = Cast<UK2Node_VariableGet>(Node))
+	{
+		Details->SetStringField(TEXT("variable_name"), GetNode->GetVarName().ToString());
+		Details->SetStringField(TEXT("node_role"), TEXT("variable_get"));
+		bHasDetails = true;
+	}
+	else if (const UK2Node_VariableSet* SetNode = Cast<UK2Node_VariableSet>(Node))
+	{
+		Details->SetStringField(TEXT("variable_name"), SetNode->GetVarName().ToString());
+		Details->SetStringField(TEXT("node_role"), TEXT("variable_set"));
+		bHasDetails = true;
+	}
+	else if (Cast<UK2Node_IfThenElse>(Node))
+	{
+		Details->SetStringField(TEXT("branch_type"), TEXT("if_then_else"));
+		bHasDetails = true;
+	}
+	else if (Cast<UK2Node_Switch>(Node))
+	{
+		Details->SetStringField(TEXT("branch_type"), TEXT("switch"));
+		bHasDetails = true;
+	}
+
+	if (bHasDetails)
+	{
+		NodeObj->SetObjectField(TEXT("details"), Details);
+	}
+}
+
+UEdGraphNode* UGitNexusBlueprintAnalyzerCommandlet::FindNodeByGuid(UBlueprint* Blueprint, const FString& NodeGuid) const
+{
+	if (!Blueprint)
+	{
+		return nullptr;
+	}
+
+	FGuid Guid;
+	if (!FGuid::Parse(NodeGuid, Guid))
+	{
+		return nullptr;
+	}
+
+	TArray<UEdGraph*> Graphs;
+	CollectBlueprintGraphs(Blueprint, Graphs);
+	for (UEdGraph* Graph : Graphs)
+	{
+		if (!Graph)
+		{
+			continue;
+		}
+
+		for (UEdGraphNode* Node : Graph->Nodes)
+		{
+			if (Node && Node->NodeGuid == Guid)
+			{
+				return Node;
+			}
+		}
+	}
+
+	return nullptr;
+}