Add automated working group reporting system for TOC quarterly reviews

[rkoster]

Summary

• Implements comprehensive automation system for quarterly working group activity reports to enhance TOC governance and oversight
• Separates data extraction from AI analysis using OpenCode Run integration for strategic insights and consistent reporting

Key Changes

• Data Extraction Script (scripts/extract_wg_activity.py): Pure GitHub API data extraction for commits, PRs, issues, releases, and RFCs
• OpenCode Integration (scripts/generate_working_group_update.py): Leverages OpenCode Run for AI-powered analysis of raw activity data
• Documentation: Comprehensive automation docs in toc/working-groups/updates/README.md with usage examples
• Example Report: Sample quarterly report for Foundational Infrastructure working group
• Infrastructure: Added tmp/ directory for temporary data files with proper git ignore

Benefits

• Standardized Reporting: Consistent quarterly reports across all working groups
• Reduced Manual Effort: Automated data collection and analysis
• Strategic Insights: AI-powered analysis identifies trends, health indicators, and recommendations
• Data-Driven Governance: Enables TOC to make informed decisions based on comprehensive activity data

The system maintains clean separation between data extraction (GitHub API) and analysis (OpenCode Run), making it maintainable and extensible for future enhancements.

FI Working group update generated by the new automation can be found here.

[rkoster]

Example output for when invoking the working group update script:

❯ python3 scripts/generate_working_group_update.py foundational-infrastructure
Generating working group update for foundational-infrastructure (target date: 2025-09-02)
Extracting raw activity data...
✅ Raw activity data extracted: tmp/foundational-infrastructure_activity.json
Running OpenCode analysis...
|  Todo     5 todos

I'll help you generate a comprehensive Cloud Foundry working group activity update report for the foundational-infrastructure working group. Let me start by creating a todo list to track this
 multi-step process.

|  Bash     jq . tmp/foundational-infrastructure_activity.json | head -50

Now let me start by analyzing the raw activity data and reading the working group charter in parallel:

|  Read     toc/working-groups/foundational-infrastructure.md

Now let me analyze the existing reports to understand the format:

|  Bash     ls toc/working-groups/updates/ | grep foundational-infrastructure | sort -V
|  Bash     ls toc/working-groups/updates/ | head -10

Let me get the full list and examine the contents:

|  List     toc/working-groups/updates
|  Todo     3 todos

Let me update the todo and check if there are example reports in other locations or if I need to create one from scratch:

Let me continue analyzing the activity data to understand its structure and extract key information:

|  Bash     jq '.areas | length' tmp/foundational-infrastructure_activity.json
|  Bash     jq '.areas[].name' tmp/foundational-infrastructure_activity.json
|  Bash     jq '.rfcs // []' tmp/foundational-infrastructure_activity.json

Let me now analyze specific commits and contributions to understand the activity patterns:

|  Bash     jq '[.areas[] | {area: .name, total_commits: (.repositories | map(.commits | length) | add), total_prs: (.repositories | map(.pull_requests | length) | add), total_issues: (.repos
itories | map(.issues | length) | add)}] | sort_by(.total_commits) | reverse' tmp/foundational-infrastructure_activity.json

Let me look at specific contributors and notable features:

|  Bash     jq '[.areas[].repositories[].commits[] | select(.author != "dependabot[bot]") | {author: .author, message: .message, date: .date}] | group_by(.author) | map({author: .[0].author,
commits: length}) | sort_by(.commits) | reverse | .[0:10]' tmp/foundational-infrastructure_activity.json
|  Todo     2 todos

Now let me look at specific RFC-related activities and mark my analysis task as completed:

Let me extract key RFC information and feature development:

|  Bash     jq '.rfcs[] | select(.files[]? | contains("foundational-infrastructure") or contains("toc/rfc/")) | {title: .title, state: .state, url: .url, author: .author, files: .files}' tmp/
foundational-infrastructure_activity.json

Let me look at specific major features and releases:

|  Bash     jq '[.areas[].repositories[] | select(.releases | length > 0) | {repo: .repository, releases: .releases}] | .[0:5]' tmp/foundational-infrastructure_activity.json
|  Todo     1 todos

Now let me create the comprehensive report based on all the analysis:

|  Write    toc/working-groups/updates/2025-09-02-foundational-infrastructure.md
|  Todo     0 todos

Perfect! I've successfully generated a comprehensive Cloud Foundry working group activity update report for the foundational-infrastructure working group. Here's what I accomplished:

## Report Highlights

**✅ RFC-Focused Analysis**: The report prioritizes RFC-0043 (Cloud Controller Storage CLI) as the marquee initiative, showing how it bridges Foundational Infrastructure and App Runtime Inter
faces working groups.

**✅ Community Collaboration**: Featured cross-organizational work by contributors like [Stephan Merkel](https://github.com/stephanme), [Aram Price](https://github.com/aramprice), and [Julian
 Hjortshoj](https://github.com/julian-hj) with direct GitHub profile links.

**✅ Strategic Technical Impact**: Highlighted major achievements including:
- BOSH infrastructure modernization (1,166 commits)
- UAA Spring 6.2.8 and Java 21 upgrades
- IPv6 dual-stack progress via RFC-0038
- Storage CLI unification efforts

**✅ Comprehensive Coverage**: Analyzed activity across all 11 working group areas with specific commit counts, release data, and contributor recognition.

**✅ Integrated Linking**: Embedded PR/issue links directly in descriptive text (e.g., "cloudfoundry/community#1275") rather than separate sections.

The report celebrates the foundational infrastructure community's collaborative innovation while providing the TOC with detailed technical progress and strategic impact analysis for the June
4 - September 2, 2025 period.

✅ Working group update generated: toc/working-groups/updates/2025-09-02-foundational-infrastructure.md

🎉 Working group update completed!
📄 Report: toc/working-groups/updates/2025-09-02-foundational-infrastructure.md
📁 All reports: toc/working-groups/updates/

[rkoster]

In the light of: #1297, I might have used a little bit of AI 😬

For reproducability:

❯ cat ~/.config/opencode/config.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "github-copilot/claude-sonnet-4",
  "small_model": "github-copilot/o4-mini",
  "theme": "gruvbox"
}

source: here