From 23adb5fec2ebb3502d36c787f56ff765924cf3cd Mon Sep 17 00:00:00 2001
From: Nubenetes Bot <bot@nubenetes.com>
Date: Mon, 18 May 2026 20:37:11 +0200
Subject: [PATCH] docs: add annual growth commit distribution pie chart to
 README

---
 GEMINI.md             |  4 +++-
 README.md             | 15 +++++++++++++++
 src/readme_updater.py |  7 +++++++
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/GEMINI.md b/GEMINI.md
index 1bceeb47..279ab316 100644
--- a/GEMINI.md
+++ b/GEMINI.md
@@ -185,7 +185,9 @@ Whenever a significant curation cycle (automatic or manual) is completed, the RE
 *   **Historical Growth:** Add/update the monthly surge rows in the "2026: The Agentic Monthly Surge" table.
 
 ### 3. Visual & Diagram Sync
-*   **Mermaid Charts:** Update the "Major Ecosystem Pillars" pie chart to align with the **Strategic Dimensions** defined in the V2 portal.
+*   **Mermaid Charts:** 
+    - Update the "Major Ecosystem Pillars" pie chart to align with the **Strategic Dimensions** defined in the V2 portal.
+    - **Annual Growth Distribution**: Include a Mermaid pie chart visualizing the historical distribution of commits by year, perfectly synchronized with the Annual Growth Summary table.
 *   **Linguistic Diversity**: Maintain a dedicated chart visualizing the project's commitment to **Global Access** (Mandate 10).
 *   **Architecture Flow:** If the Agentic Stack or the deployment lifecycle changes, the corresponding Mermaid diagrams MUST be updated immediately.
 *   **Robustness:** Follow the "Mermaid Diagram Best Practices" (node quoting, explicit direction) as defined in this document.
diff --git a/README.md b/README.md
index b787244f..240ddc60 100644
--- a/README.md
+++ b/README.md
@@ -166,6 +166,21 @@ The growth of Nubenetes reflects the acceleration of the Cloud Native ecosystem.
 | 9 | 2026 | 1012 | 4,179 | **Agentic AI Surge** (May 2026 Inception) |
 <!-- ANNUAL_GROWTH_END -->
 
+<!-- ANNUAL_CHART_START -->
+```mermaid
+pie title Nubenetes Historical Commit Distribution (By Year)
+    "2018" : 350
+    "2019" : 142
+    "2020" : 2046
+    "2021" : 531
+    "2022" : 402
+    "2023" : 30
+    "2024" : 53
+    "2025" : 5
+    "2026" : 1012
+```
+<!-- ANNUAL_CHART_END -->
+
 #### 2026: The Agentic Monthly Surge
 <!-- MONTHLY_SURGE_START -->
 | Month | Commits | Est. New Refs | Status |
diff --git a/src/readme_updater.py b/src/readme_updater.py
index ffee2d1d..298eda9c 100644
--- a/src/readme_updater.py
+++ b/src/readme_updater.py
@@ -100,6 +100,11 @@ def get_stats():
     
     growth_data.sort(key=lambda x: x["year"])
     
+    annual_chart = "```mermaid\npie title Nubenetes Historical Commit Distribution (By Year)\n"
+    for item in growth_data:
+        annual_chart += f"    \"{item['year']}\" : {item['count']}\n"
+    annual_chart += "```"
+    
     for idx, item in enumerate(growth_data, 1):
         year = item["year"]
         count = item["count"]
@@ -135,6 +140,7 @@ def get_stats():
         "pillar_chart": pillar_chart,
         "lang_chart": lang_chart,
         "annual_growth": "\n".join(annual_rows),
+        "annual_chart": annual_chart,
         "monthly_surge": "\n".join(monthly_rows),
         "last_update": datetime.now().strftime("%Y-%m-%d")
     }
@@ -158,6 +164,7 @@ def update_readme(stats):
     content = replace_section(content, "HEART_STATS", stats["heart_stats"])
     content = replace_section(content, "TOP_CATEGORIES", stats["top_categories"])
     content = replace_section(content, "ANNUAL_GROWTH", stats["annual_growth"])
+    content = replace_section(content, "ANNUAL_CHART", stats["annual_chart"])
     content = replace_section(content, "MONTHLY_SURGE", stats["monthly_surge"])
     content = replace_section(content, "PILLAR_CHART", stats["pillar_chart"])
     content = replace_section(content, "SUB_ECO_CHART", stats["lang_chart"])