Add anomaly detection Graph visualizations to Markdown summary

Author: JohT

domains/anomaly-detection/summary/anomalyDetectionSummary.sh

@@ -75,7 +75,11 @@ anomaly_detection_deep_dive_report() {
     echo "### 2.${report_number} ${language} ${nodeLabel}" > "${detail_report_include_directory}/DeepDiveSectionTitle.md"
     echo "" > "${detail_report_include_directory}/empty.md"
     cp -f "${ANOMALY_DETECTION_SUMMARY_DIR}/report_no_anomaly_detection_data.template.md" "${detail_report_include_directory}/report_no_anomaly_detection_data.template.md"
+    cp -f "${ANOMALY_DETECTION_SUMMARY_DIR}/report_no_anomaly_detection_graphs.template.md" "${detail_report_include_directory}/report_no_anomaly_detection_graphs.template.md"
+    
+    # Copy
     cp -f "${detail_report_directory}/Top_anomaly_features.md" "${detail_report_include_directory}" || true
+    cp -f "${detail_report_directory}/GraphVisualizations/GraphVisualizationsReferenceForSummary.md" "${detail_report_include_directory}/GraphVisualizationsReference.md" || true
 
     # Assemble Markdown-Includes containing plots depending on their availability (fallback empty.md)
     if [ -f "${detail_report_directory}/Anomaly_feature_importance_explained.svg" ] ; then
@@ -103,6 +107,11 @@ anomaly_detection_deep_dive_report() {
     cat "${detail_report_directory}/report_deep_dive.template.md" | "${MARKDOWN_SCRIPTS_DIR}/embedMarkdownIncludes.sh" "${detail_report_include_directory}" > "${detail_report_directory}/report_deep_dive_with_vars.md"
     sed "s/{{deep_dive_directory}}/${detail_report_directory_name}/g" "${detail_report_directory}/report_deep_dive_with_vars.md" > "${detail_report_directory}/report_deep_dive_${report_number}.md" 
 
+    # Add a page break at the end of a deep dive section
+    {
+        echo "--"
+    } >> "${detail_report_directory}/report_deep_dive_${report_number}.md" 
+
     rm -rf "${detail_report_directory}/report_deep_dive_with_vars.md"
     rm -rf "${detail_report_directory}/report_deep_dive.template.md"
     rm -rf "${detail_report_include_directory}"

domains/anomaly-detection/summary/report.template.md

@@ -104,6 +104,24 @@ Each abstraction level includes anomaly statistics, SHAP feature importance, arc
 
 ---
 
+### 📕 Graph Visualizations (Archetype-Level Network Views)
+
+| Plot | Description | Best For | Adds | Why |
+|------|--------------|----------|------|-----|
+| **Top Hub Graph Visualization** | Displays the most connected node (e.g., **#1 Hub**) at the center, surrounded by its direct dependencies. Incoming nodes show who is dependent on the hub. | Understanding highly connected code units or components that serve as central integrators. | Highlights nodes that act as major dependency aggregators. | Helps detect over-centralized modules or potential architectural bottlenecks. |
+| **Top Bottleneck Graph Visualization** | Shows the node with the highest betweenness centrality (e.g., **#1 Bottleneck**) and its local neighborhood. | Identifying code units that control information or dependency flow. | Emphasizes nodes that mediate critical paths between modules. | Reveals single points of failure or routing constraints in dependency flow. |
+| **Top Authority Graph Visualization** | Centers the most authoritative node (e.g., **#1 Authority**) with incoming and outgoing links from dependent nodes with high PageRank and emphasized PageRank to ArticleRank difference. | Detecting key knowledge or functionality providers. | Highlights components with high centrality. | Indicates structural or semantic “sources of truth” in the system. |
+| **Top Bridge Graph Visualization** | Displays a node acting as a structural bridge between clusters (e.g., **#1 Bridge**) and its cross-cluster connections based on node embeddings encoding the Graph structure. | Understanding cross-cutting dependencies between modules. | Reveals links connecting distinct architectural domains. | Useful for spotting boundary leaks or undesired coupling between subsystems. |
+| **Top Outlier Graph Visualization** | Centers an unusual or isolated node (e.g., **#1 Outlier**) that can hardly be assigned to a cluster and visualizes its sparse or unexpected dependency patterns. | Identifying structurally or behaviorally anomalous nodes. | Highlights nodes with rare or unexpected connection patterns. | Helps pinpoint code units that deviate from established dependency norms. |
+
+> **Note:**
+> - In all Graph Visualizations, the **central node** represents the selected *Top Archetype* (e.g., *Top 1 Hub*).  
+> - **Darker nodes** indicate *incoming dependencies*, while **brighter nodes** indicate *outgoing dependencies*.  
+> - **Emphasized nodes** (thicker borders or larger size) mark particularly influential or anomalous dependencies, depending on the archetype.  
+> - These visualizations are most effective for interpreting *local dependency topology* and *role significance* of key components.
+
+---
+
 ### 📔 Summary Categories
 
 | Category | Included Plots | Typical Usage |
@@ -114,6 +132,7 @@ Each abstraction level includes anomaly statistics, SHAP feature importance, arc
 | **Cluster Noise Analysis** | Cluster Noise (3 types) | Identify special structural anomalies |
 | **Feature Distributions** | Betweenness, Clustering, Rank Difference | Assess feature-based structure patterns |
 | **Feature Relationships** | Clustering vs PageRank | Evaluate global vs local influence balance |
+| **Archetype Graphs** | Top Hub / Bottleneck / Authority / Bridge / Outlier | Visualizing key dependency roles and structural importance |
 
 ---
 

domains/anomaly-detection/summary/report_deep_dive.template.md

@@ -12,7 +12,7 @@
 
 #### Archetype Distribution
 
-<!-- include:DeepDiveArchetypes.md|report_no_data_info.template.md -->
+<!-- include:DeepDiveArchetypes.md|report_no_anomaly_detection_data.template.md -->
 
 #### Top anomalies with their local contributing features (via SHAP)
 
@@ -31,3 +31,5 @@ See [Plot Interpretation Guide](#3-plot-interpretation-guide) on how to read the
 <!-- include:report_deep_dive_cluster_noise_plots.md|empty.md -->
 
 <!-- include:report_deep_dive_feature_plots.md|report_no_anomaly_detection_data.template.md -->
+
+<!-- include:GraphVisualizationsReference.md|report_no_anomaly_detection_graphs.template.md -->

domains/anomaly-detection/summary/report_no_anomaly_detection_graphs.template.md

@@ -0,0 +1 @@
+⚠️ _No anomaly detection graph visualizations for this level._