From 8a807c10a14e49a6883d7869304e4a2961a4d0a8 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 25 Mar 2026 06:18:49 +0000
Subject: [PATCH 1/4] Initial plan


From 7cc56f94b90d8148ebf82b4e42fe23cd6c727e69 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 25 Mar 2026 06:25:46 +0000
Subject: [PATCH 2/4] fix: GenerateVisualizationHtml returns non-empty
 dataSources when no snapshots are passed

Co-authored-by: witskeeper <5594094+witskeeper@users.noreply.github.com>
Agent-Logs-Url: https://github.com/netcorepal/netcorepal-cloud-framework/sessions/9a0e5d36-f784-4c22-a030-0a202f9cec8e
---
 .../VisualizationHtmlBuilder.cs               | 57 ++++++++++++++++++-
 .../VisualizationHtmlBuilderTests.cs          | 18 ++++++
 2 files changed, 74 insertions(+), 1 deletion(-)

diff --git a/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs b/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
index 0f0328c5..233b44d8 100644
--- a/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
+++ b/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
@@ -61,7 +61,10 @@ public static string GenerateVisualizationHtml(
             }
 
             // 构建 dataSources 数组 - 每个snapshot生成完整的数据源
-            var dataSourcesJson = BuildDataSourcesJson(snapshotList);
+            // 当没有快照时，使用 analysisResult 直接构建一个 Runtime 数据源，确保 dataSources 不为空
+            var dataSourcesJson = snapshotList.Count > 0
+                ? BuildDataSourcesJson(snapshotList)
+                : BuildDataSourcesJsonFromAnalysisResult(analysisResult);
             var diagramConfigsJson = BuildDiagramConfigsJson();
 
             // 替换模板中的占位符
@@ -142,6 +145,58 @@ private static string BuildDataSourcesJson(System.Collections.Generic.List<Snaps
             return sb.ToString();
         }
 
+        // 当没有快照时，直接从 analysisResult 构建包含单个 Runtime 数据源的 dataSources JSON 字符串
+        private static string BuildDataSourcesJsonFromAnalysisResult(CodeFlowAnalysisResult analysisResult)
+        {
+            var architectureOverviewMermaid =
+                MermaidVisualizers.ArchitectureOverviewMermaidVisualizer.GenerateMermaid(analysisResult);
+            var allProcessingFlowMermaid =
+                MermaidVisualizers.ProcessingFlowMermaidVisualizer.GenerateMermaid(analysisResult);
+            var allAggregateMermaid =
+                MermaidVisualizers.AggregateRelationMermaidVisualizer.GenerateAllAggregateMermaid(analysisResult);
+
+            var sb = new StringBuilder();
+            sb.Append("[{");
+
+            // 元数据（使用运行时默认值，version 使用时间戳以确保唯一性）
+            var now = DateTime.Now;
+            sb.Append("\"metadata\":{");
+            sb.Append($"\"version\":\"{EscapeJavaScript(now.ToString("yyyyMMddHHmmss"))}\",");
+            sb.Append($"\"timestamp\":\"{now:yyyy-MM-dd HH:mm:ss}\",");
+            sb.Append("\"description\":\"Runtime\",");
+            sb.Append("\"hash\":\"\",");
+            sb.Append($"\"nodeCount\":{analysisResult.Nodes.Count},");
+            sb.Append($"\"relationshipCount\":{analysisResult.Relationships.Count}");
+            sb.Append("},");
+
+            // 分析结果
+            sb.Append("\"analysisResult\":");
+            sb.Append(BuildAnalysisResultJson(analysisResult));
+            sb.Append(",");
+
+            // 统计信息
+            sb.Append("\"statistics\":");
+            sb.Append(BuildStatisticsJson(analysisResult));
+            sb.Append(",");
+
+            // 图表数据
+            sb.Append("\"diagrams\":");
+            sb.Append(BuildArchitectureOverviewMermaidJson(architectureOverviewMermaid));
+            sb.Append(",");
+
+            // 处理流程图
+            sb.Append("\"allChainFlowCharts\":");
+            sb.Append(BuildProcessingFlowMermaidJson(allProcessingFlowMermaid));
+            sb.Append(",");
+
+            // 聚合关系图
+            sb.Append("\"allAggregateRelationDiagrams\":");
+            sb.Append(BuildAllAggregateRelationDiagramsJson(allAggregateMermaid));
+
+            sb.Append("}]");
+            return sb.ToString();
+        }
+
         // 构建 analysisResult 的 JSON 字符串
         private static string BuildAnalysisResultJson(CodeFlowAnalysisResult analysisResult)
         {
diff --git a/test/NetCorePal.Extensions.CodeAnalysis.UnitTests/VisualizationHtmlBuilderTests.cs b/test/NetCorePal.Extensions.CodeAnalysis.UnitTests/VisualizationHtmlBuilderTests.cs
index f57f78d2..4fe169c3 100644
--- a/test/NetCorePal.Extensions.CodeAnalysis.UnitTests/VisualizationHtmlBuilderTests.cs
+++ b/test/NetCorePal.Extensions.CodeAnalysis.UnitTests/VisualizationHtmlBuilderTests.cs
@@ -6,6 +6,24 @@ namespace NetCorePal.Extensions.CodeAnalysis.UnitTests;
 
 public class VisualizationHtmlBuilderTests
 {
+    [Fact]
+    public void GenerateVisualizationHtml_WithNoSnapshots_ShouldContainNonEmptyDataSources()
+    {
+        var result = CodeFlowAnalysisHelper.GetResultFromAssemblies(typeof(VisualizationHtmlBuilderTests).Assembly);
+
+        // Do not pass snapshots - this is the bug scenario
+        var html = VisualizationHtmlBuilder.GenerateVisualizationHtml(result);
+
+        // dataSources must not be empty so the page script can access dataSources[0].statistics
+        Assert.Contains("const dataSources =", html);
+        Assert.DoesNotContain("const dataSources = []", html);
+        Assert.Contains("\"statistics\":", html);
+        Assert.Contains("\"metadata\":", html);
+        Assert.Contains("\"analysisResult\":", html);
+        // Runtime fallback entry should have "Runtime" as description
+        Assert.Contains("\"description\":\"Runtime\"", html);
+    }
+
     [Fact]
     public void GenerateVisualizationHtml_ShouldContainBasicHtmlAndDiagrams()
     {

From de5a58dbc0f3a578028694a7504f95e5037b5446 Mon Sep 17 00:00:00 2001
From: witskeeper <witskeeper@gmail.com>
Date: Wed, 25 Mar 2026 15:35:19 +0800
Subject: [PATCH 3/4] Update
 src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 .../VisualizationHtmlBuilder.cs                               | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs b/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
index 233b44d8..c1f2db94 100644
--- a/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
+++ b/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
@@ -163,8 +163,8 @@ private static string BuildDataSourcesJsonFromAnalysisResult(CodeFlowAnalysisRes
             sb.Append("\"metadata\":{");
             sb.Append($"\"version\":\"{EscapeJavaScript(now.ToString("yyyyMMddHHmmss"))}\",");
             sb.Append($"\"timestamp\":\"{now:yyyy-MM-dd HH:mm:ss}\",");
-            sb.Append("\"description\":\"Runtime\",");
-            sb.Append("\"hash\":\"\",");
+            sb.Append($"\"description\":\"{EscapeJavaScript("Runtime")}\",");
+            sb.Append($"\"hash\":\"{EscapeJavaScript(string.Empty)}\",");
             sb.Append($"\"nodeCount\":{analysisResult.Nodes.Count},");
             sb.Append($"\"relationshipCount\":{analysisResult.Relationships.Count}");
             sb.Append("},");

From 99409748beab73bb606fae75f51f048caaaef7d9 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 25 Mar 2026 07:37:13 +0000
Subject: [PATCH 4/4] refactor: extract BuildSingleDataSourceEntryJson to
 eliminate duplication between snapshot and runtime paths

Co-authored-by: witskeeper <5594094+witskeeper@users.noreply.github.com>
Agent-Logs-Url: https://github.com/netcorepal/netcorepal-cloud-framework/sessions/8ed1e14d-3148-4d96-8663-ce2c347cca1f
---
 .../VisualizationHtmlBuilder.cs               | 99 +++++++------------
 1 file changed, 38 insertions(+), 61 deletions(-)

diff --git a/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs b/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
index 233b44d8..a5d4402e 100644
--- a/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
+++ b/src/NetCorePal.Extensions.CodeAnalysis/VisualizationHtmlBuilder.cs
@@ -83,70 +83,48 @@ private static string BuildDataSourcesJson(System.Collections.Generic.List<Snaps
         {
             var sb = new StringBuilder();
             sb.Append("[");
-            
             for (int i = 0; i < snapshots.Count; i++)
             {
                 var snapshot = snapshots[i];
                 var analysisResult = snapshot.GetAnalysisResult();
-                
-                // 生成该快照的Mermaid图表
-                var architectureOverviewMermaid =
-                    MermaidVisualizers.ArchitectureOverviewMermaidVisualizer.GenerateMermaid(analysisResult);
-                var allProcessingFlowMermaid =
-                    MermaidVisualizers.ProcessingFlowMermaidVisualizer.GenerateMermaid(analysisResult);
-                var allAggregateMermaid =
-                    MermaidVisualizers.AggregateRelationMermaidVisualizer.GenerateAllAggregateMermaid(analysisResult);
-                
-                sb.Append("{");
-                
-                // 元数据
-                sb.Append("\"metadata\":{");
-                sb.Append($"\"version\":\"{EscapeJavaScript(snapshot.Metadata.Version)}\",");
-                sb.Append($"\"timestamp\":\"{snapshot.Metadata.Timestamp:yyyy-MM-dd HH:mm:ss}\",");
-                sb.Append($"\"description\":\"{EscapeJavaScript(snapshot.Metadata.Description)}\",");
-                sb.Append($"\"hash\":\"{EscapeJavaScript(snapshot.Metadata.Hash)}\",");
-                sb.Append($"\"nodeCount\":{snapshot.Metadata.NodeCount},");
-                sb.Append($"\"relationshipCount\":{snapshot.Metadata.RelationshipCount}");
-                sb.Append("},");
-                
-                // 分析结果
-                sb.Append("\"analysisResult\":");
-                sb.Append(BuildAnalysisResultJson(analysisResult));
-                sb.Append(",");
-                
-                // 统计信息
-                sb.Append("\"statistics\":");
-                sb.Append(BuildStatisticsJson(analysisResult));
-                sb.Append(",");
-                
-                // 图表数据
-                sb.Append("\"diagrams\":");
-                sb.Append(BuildArchitectureOverviewMermaidJson(architectureOverviewMermaid));
-                sb.Append(",");
-                
-                // 处理流程图
-                sb.Append("\"allChainFlowCharts\":");
-                sb.Append(BuildProcessingFlowMermaidJson(allProcessingFlowMermaid));
-                sb.Append(",");
-                
-                // 聚合关系图
-                sb.Append("\"allAggregateRelationDiagrams\":");
-                sb.Append(BuildAllAggregateRelationDiagramsJson(allAggregateMermaid));
-                
-                sb.Append("}");
-                
+                sb.Append(BuildSingleDataSourceEntryJson(
+                    analysisResult,
+                    snapshot.Metadata.Version,
+                    snapshot.Metadata.Timestamp.ToString("yyyy-MM-dd HH:mm:ss"),
+                    snapshot.Metadata.Description,
+                    snapshot.Metadata.Hash,
+                    snapshot.Metadata.NodeCount,
+                    snapshot.Metadata.RelationshipCount));
                 if (i < snapshots.Count - 1)
-                {
                     sb.Append(",");
-                }
             }
-            
             sb.Append("]");
             return sb.ToString();
         }
 
         // 当没有快照时，直接从 analysisResult 构建包含单个 Runtime 数据源的 dataSources JSON 字符串
         private static string BuildDataSourcesJsonFromAnalysisResult(CodeFlowAnalysisResult analysisResult)
+        {
+            var now = DateTime.Now;
+            return "[" + BuildSingleDataSourceEntryJson(
+                analysisResult,
+                now.ToString("yyyyMMddHHmmss"),
+                now.ToString("yyyy-MM-dd HH:mm:ss"),
+                "Runtime",
+                string.Empty,
+                analysisResult.Nodes.Count,
+                analysisResult.Relationships.Count) + "]";
+        }
+
+        // 构建单个数据源条目的 JSON 字符串（snapshots 路径和 runtime 回退路径共享此逻辑）
+        private static string BuildSingleDataSourceEntryJson(
+            CodeFlowAnalysisResult analysisResult,
+            string version,
+            string timestamp,
+            string description,
+            string hash,
+            int nodeCount,
+            int relationshipCount)
         {
             var architectureOverviewMermaid =
                 MermaidVisualizers.ArchitectureOverviewMermaidVisualizer.GenerateMermaid(analysisResult);
@@ -156,17 +134,16 @@ private static string BuildDataSourcesJsonFromAnalysisResult(CodeFlowAnalysisRes
                 MermaidVisualizers.AggregateRelationMermaidVisualizer.GenerateAllAggregateMermaid(analysisResult);
 
             var sb = new StringBuilder();
-            sb.Append("[{");
+            sb.Append("{");
 
-            // 元数据（使用运行时默认值，version 使用时间戳以确保唯一性）
-            var now = DateTime.Now;
+            // 元数据
             sb.Append("\"metadata\":{");
-            sb.Append($"\"version\":\"{EscapeJavaScript(now.ToString("yyyyMMddHHmmss"))}\",");
-            sb.Append($"\"timestamp\":\"{now:yyyy-MM-dd HH:mm:ss}\",");
-            sb.Append("\"description\":\"Runtime\",");
-            sb.Append("\"hash\":\"\",");
-            sb.Append($"\"nodeCount\":{analysisResult.Nodes.Count},");
-            sb.Append($"\"relationshipCount\":{analysisResult.Relationships.Count}");
+            sb.Append($"\"version\":\"{EscapeJavaScript(version)}\",");
+            sb.Append($"\"timestamp\":\"{EscapeJavaScript(timestamp)}\",");
+            sb.Append($"\"description\":\"{EscapeJavaScript(description)}\",");
+            sb.Append($"\"hash\":\"{EscapeJavaScript(hash)}\",");
+            sb.Append($"\"nodeCount\":{nodeCount},");
+            sb.Append($"\"relationshipCount\":{relationshipCount}");
             sb.Append("},");
 
             // 分析结果
@@ -193,7 +170,7 @@ private static string BuildDataSourcesJsonFromAnalysisResult(CodeFlowAnalysisRes
             sb.Append("\"allAggregateRelationDiagrams\":");
             sb.Append(BuildAllAggregateRelationDiagramsJson(allAggregateMermaid));
 
-            sb.Append("}]");
+            sb.Append("}");
             return sb.ToString();
         }