Merge pull request #589 from projectbluefin/chore/close-v1.1-milestone

ci: Configure auto-merge for monthly reports workflow

Author: castrojo

.github/workflows/monthly-reports.yml

@@ -8,7 +8,7 @@ on:
 
 permissions:
   contents: write # For git commits
-  pull-requests: read # For GraphQL queries
+  pull-requests: write # For creating PRs and enabling auto-merge
 
 jobs:
   generate-report:
@@ -40,11 +40,51 @@ jobs:
         run: |
           echo "::warning::Report generation encountered errors but will attempt commit"
 
-      - name: Commit and push report
+      - name: Create feature branch
         run: |
+          BRANCH_NAME="monthly-report/$(date +%Y-%m)"
+          git checkout -b "$BRANCH_NAME"
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Commit changes to branch
+        run: |
           git add reports/
           [ -f static/data/contributors-history.json ] && git add static/data/contributors-history.json || true
-          git diff --staged --quiet || git commit -m "docs(reports): add monthly report for $(date +%B-%Y)"
-          git push
+          git diff --staged --quiet || git commit -m "docs(reports): add monthly report for $(date +%B\ %Y)"
+
+      - name: Push branch and create PR
+        run: |
+          BRANCH_NAME="monthly-report/$(date +%Y-%m)"
+          git push -u origin "$BRANCH_NAME"
+          gh pr create \
+            --title "docs(reports): Monthly report for $(date +%B\ %Y)" \
+            --body "$(cat <<'EOFBODY'
+          ## Automated Monthly Report
+
+          This PR contains the automated monthly report generated on $(date +%Y-%m-%d).
+
+          ### Contents
+          - Monthly activity summary
+          - Contributor statistics
+          - Project updates
+
+          ### Automated Checks
+          - [ ] Build passes
+          - [ ] No lint errors
+          - [ ] Report renders correctly
+
+          **Note:** This PR was automatically generated by the monthly-reports workflow.
+          EOFBODY
+          )" \
+            --base main \
+            --head "$BRANCH_NAME"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Enable auto-merge
+        run: |
+          BRANCH_NAME="monthly-report/$(date +%Y-%m)"
+          gh pr merge --auto --merge "$BRANCH_NAME"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.planning/ROADMAP.md

@@ -1,22 +1,22 @@
-# Roadmap: Biweekly Reports Feature (v1.1)
+# Roadmap: Monthly Reports Feature (v1.1)
 
 **Milestone:** v1.1  
-**Goal:** Add automated biweekly reports from GitHub Project Board  
-**Status:** In Progress - Phase 1 Complete  
+**Goal:** Add automated monthly reports from monitored repositories  
+**Status:** ✅ COMPLETE  
 **Created:** 2026-01-26  
-**Updated:** 2026-01-27
+**Completed:** 2026-01-27
 
 ---
 
 ## Milestone Overview
 
-**What:** Automated biweekly status reports from GitHub Project Board #2
+**What:** Automated monthly status reports from projectbluefin/common and monitored repositories
 
 **Why:** Provide community with transparent, data-driven summaries of completed work, contributors, and project momentum.
 
-**How:** 100% automated system that fetches project board data, categorizes by labels, formats as blog posts, and publishes every other Monday.
+**How:** 100% automated system that fetches merged PRs from repositories, categorizes by labels, formats as blog posts, and publishes on the last day of each month.
 
-**Success:** Reports published biweekly at `/reports`, properly categorized, mobile-responsive, with RSS feed support. Zero manual intervention required.
+**Success:** ✅ Reports published monthly at `/reports`, properly categorized, mobile-responsive, with RSS feed support. Zero manual intervention required.
 
 ---
 
@@ -65,37 +65,31 @@
 
 ---
 
-### Phase 2: Navigation & Discovery (1 day)
+### Phase 2: Navigation & Discovery ✅ COMPLETE
 
 **Goal:** Integrate reports into site navigation and enable discoverability  
-**Status:** Planned  
-**Plans:** 2 plans (1 wave)
+**Status:** Complete (2026-01-27)  
+**Plans:** 2 plans completed
 
-**Delivers:**
+**Delivered:**
 
-- Main navigation link to `/reports` ✅ (done in Phase 1)
-- RSS feed configuration (automatic from Docusaurus) ✅ (done in Phase 1)
-- Cross-links with changelogs and blog
-- Search integration verification
-- Mobile navigation testing
+- ✅ Main navigation link to `/reports`
+- ✅ RSS feed configuration (automatic from Docusaurus)
+- ✅ Cross-links with changelogs and blog
+- ✅ Search integration verified
+- ✅ Mobile navigation tested
 
 **Key Files:**
 
 - `src/pages/changelogs.tsx` (cross-link intro)
-- `scripts/lib/markdown-generator.js` (footer template)
-- `docusaurus.config.ts` (navbar order verification)
-- `reports/` (test report generation)
+- `scripts/lib/markdown-generator.mjs` (footer template)
+- `docusaurus.config.ts` (navbar order verified)
+- `reports/` (test reports generated)
 
-**Dependencies:** Phase 1 (reports must exist) ✅ COMPLETE
+**Dependencies:** Phase 1 ✅ COMPLETE
 
-Plans:
-
-- [ ] 02-01-PLAN.md — Cross-links & content integration (Wave 1)
-- [ ] 02-02-PLAN.md — Validation & testing (Wave 2)
-
-**Success Criteria:**
+**Success Criteria:** All met - Reports accessible, discoverable, mobile-responsive
 
-- "Reports" link visible in desktop and mobile navigation ✅ (done in Phase 1)
 - RSS feed validates at `/reports/rss.xml` ✅ (done in Phase 1)
 - Cross-links function correctly
 - Search returns report results