Merge branch 'dev' of https://github.com/HyDE-Project/HyDE into dev

Author: kRHYME7

.github/scripts/remind-release.py

@@ -0,0 +1,62 @@
+import calendar
+from datetime import date, timedelta
+
+
+def get_fridays(year, month):
+    """Return a list of all Fridays in a given month."""
+    c = calendar.Calendar()
+    return [
+        d
+        for d in c.itermonthdates(year, month)
+        if d.weekday() == calendar.FRIDAY and d.month == month
+    ]
+
+
+def print_release_calendar(year):
+    print(f"# Bi-monthly Release Calendar for  {year}\n")
+    print(
+        "| Month     | Freeze Week  | Merge Friday | Snapshot     | Quarter | Tag     |"
+    )
+    print(
+        "|-----------|--------------|--------------|--------------|-------|---------|"
+    )
+    for month in range(1, 13):
+        fridays = get_fridays(year, month)
+        if not fridays:
+            continue
+        merge1 = fridays[0] if len(fridays) > 0 else None
+        snap1 = fridays[1] if len(fridays) > 1 else None
+        merge2 = fridays[2] if len(fridays) > 2 else None
+        snap2 = fridays[3] if len(fridays) > 3 else None
+        freeze1 = merge1 - timedelta(days=7) if merge1 else None
+        freeze2 = merge2 - timedelta(days=7) if merge2 else None
+        yy = str(year)[-2:]
+        m = str(month)
+        tag1 = f"{yy}.{m}.1" if merge1 else ""
+        tag3 = f"{yy}.{m}.3" if merge2 else ""
+        # Print 1st quarter row
+        print(
+            f"| {calendar.month_abbr[month]:<9} | "
+            f"{freeze1.strftime('%Y-%m-%d') if freeze1 else '':<12} | "
+            f"{merge1.strftime('%Y-%m-%d') if merge1 else '':<12} | "
+            f"{snap1.strftime('%Y-%m-%d') if snap1 else '':<12} | "
+            f"{'Q1':<5} | "
+            f"{tag1:<7} |"
+        )
+        # Print 3rd quarter row
+        if merge2:
+            print(
+                f"| {'':<9} | "
+                f"{freeze2.strftime('%Y-%m-%d') if freeze2 else '':<12} | "
+                f"{merge2.strftime('%Y-%m-%d') if merge2 else '':<12} | "
+                f"{snap2.strftime('%Y-%m-%d') if snap2 else '':<12} | "
+                f"{'Q3':<5} | "
+                f"{tag3:<7} |"
+            )
+
+
+if __name__ == "__main__":
+    import sys
+
+    year = int(sys.argv[1]) if len(sys.argv) > 1 else date.today().year
+    print_release_calendar(year)

Configs/.local/bin/hydectl

@@ -1,17 +1,47 @@
 ## Release & Branching Policy - Quarterly Releases
 
+# Bi-monthly Release Calendar for  2025
+
+| Month     | Freeze Week  | Merge Friday | Snapshot     | Quarter | Tag     |
+|-----------|--------------|--------------|--------------|-------|---------|
+| Jan       | 2024-12-27   | 2025-01-03   | 2025-01-10   | Q1    | 25.1.1  |
+|           | 2025-01-10   | 2025-01-17   | 2025-01-24   | Q3    | 25.1.3  |
+| Feb       | 2025-01-31   | 2025-02-07   | 2025-02-14   | Q1    | 25.2.1  |
+|           | 2025-02-14   | 2025-02-21   | 2025-02-28   | Q3    | 25.2.3  |
+| Mar       | 2025-02-28   | 2025-03-07   | 2025-03-14   | Q1    | 25.3.1  |
+|           | 2025-03-14   | 2025-03-21   | 2025-03-28   | Q3    | 25.3.3  |
+| Apr       | 2025-03-28   | 2025-04-04   | 2025-04-11   | Q1    | 25.4.1  |
+|           | 2025-04-11   | 2025-04-18   | 2025-04-25   | Q3    | 25.4.3  |
+| May       | 2025-04-25   | 2025-05-02   | 2025-05-09   | Q1    | 25.5.1  |
+|           | 2025-05-09   | 2025-05-16   | 2025-05-23   | Q3    | 25.5.3  |
+| Jun       | 2025-05-30   | 2025-06-06   | 2025-06-13   | Q1    | 25.6.1  |
+|           | 2025-06-13   | 2025-06-20   | 2025-06-27   | Q3    | 25.6.3  |
+| Jul       | 2025-06-27   | 2025-07-04   | 2025-07-11   | Q1    | 25.7.1  |
+|           | 2025-07-11   | 2025-07-18   | 2025-07-25   | Q3    | 25.7.3  |
+| Aug       | 2025-07-25   | 2025-08-01   | 2025-08-08   | Q1    | 25.8.1  |
+|           | 2025-08-08   | 2025-08-15   | 2025-08-22   | Q3    | 25.8.3  |
+| Sep       | 2025-08-29   | 2025-09-05   | 2025-09-12   | Q1    | 25.9.1  |
+|           | 2025-09-12   | 2025-09-19   | 2025-09-26   | Q3    | 25.9.3  |
+| Oct       | 2025-09-26   | 2025-10-03   | 2025-10-10   | Q1    | 25.10.1 |
+|           | 2025-10-10   | 2025-10-17   | 2025-10-24   | Q3    | 25.10.3 |
+| Nov       | 2025-10-31   | 2025-11-07   | 2025-11-14   | Q1    | 25.11.1 |
+|           | 2025-11-14   | 2025-11-21   | 2025-11-28   | Q3    | 25.11.3 |
+| Dec       | 2025-11-28   | 2025-12-05   | 2025-12-12   | Q1    | 25.12.1 |
+|           | 2025-12-12   | 2025-12-19   | 2025-12-26   | Q3    | 25.12.3 |
+
+
 #### Three Key Points
 
 1. **Development** - All development and PRs target`dev`
 2. **Release Candidate** - On Freeze Week, merge`dev` →`rc` (release-candidate). Only bug fixes and stabilization allowed in`rc`. `dev` remains open for new features.
-3. **Release** - Merge`rc` →`master` twice per month (1st Quarter & 3rd Quarter)
+3. **Release** - Merge`rc` →`master` twice per month (1st Quarter & 3rd Quarter of the Month)
 4. **Snapshot** - Create snapshot releases from stable`master` branch
 
 > **Note:** The `dev` branch is always open for new features and development every week, regardless of the release cycle. Only the `rc` (release-candidate) branch is frozen for testing and bug fixes during release preparation.
 
 ---
 
-## Quarterly Release Schedule Flow
+## Bi-monthly Release Schedule Flow
 
 - **Week before 1st/3rd Friday (Freeze Week):**
   - 🔄 Merge latest `dev` → `rc` (release-candidate)
@@ -24,7 +54,7 @@
   - ✅ `dev` branch remains open: New features and PRs accepted
 
 
-#### 1st & 3rd Quarter Cycle
+#### 1st & 3rd Quarter of the month Cycle
 
 **Week before 1st/3rd Friday (Freeze Week):**
 
@@ -86,11 +116,11 @@
 
 We use **year.month.quarter** format (`YY.M.Q`) instead of traditional semantic versioning for several reasons:
 
-- **Release-cycle aligned:** Matches our quarterly release schedule perfectly
+- **Release-cycle aligned:** Matches our bi-monthly release schedule perfectly
 - **Time-based clarity:** Instantly shows when a release was made
 - **Predictable progression:** Always `.1` then `.3` each month
 - **No arbitrary numbers:** No confusion about what constitutes "major" vs "minor"
-- **User-friendly:** Easy to understand - `25.7.1` = "July 2025, 1st Quarter"
+- **User-friendly:** Easy to understand - `25.7.1` = "July 2025, 1st Quarter of the Month"
 
 ---
 
@@ -174,7 +204,7 @@ graph LR
     style RELEASE fill:#a9b1d6,stroke:#252737,stroke-width:2px,color:#252737
 ```
 
-## Quarterly Release Schedule
+## Bi-monthly Release Schedule
 
 ```mermaid
 gantt