tkmind/tkmind_go
1
0
Fork 0
Code Issues Pull Requests Actions 4 Packages Projects Releases Wiki Activity

chore(aaif): rename a bunch of repository references (#8152)

Browse Source 
Signed-off-by: Michael Neale <michael.neale@gmail.com>
Co-authored-by: Michael Neale <michael.neale@gmail.com>

continuing migration to aaif
This commit is contained in:
Jack Amadeo
2026-04-07 01:34:48 -04:00
committed by GitHub
parent 0b080faad5
commit 583acd4335
236 changed files with 1097 additions and 962 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/scripts/community_stars.py
+166 -107
View File
@@ -1,6 +1,9 @@
#!/usr/bin/env python3
"""
Community Stars Analysis Script for block/goose repository
Community Stars Analysis Script for aaif-goose/goose repository
# TODO: Update BLOCK_ORGS, is_block_employee(), and team categorization logic
# for the AAIF org structure after the transfer from block/goose.
This script analyzes GitHub contributor statistics and generates rankings for:
- Top 5 Community All-Stars (External contributors)
@@ -23,25 +26,26 @@ Requirements:
- Team list file at documentation/scripts/community_stars_teams.txt
"""
import calendar
import json
import re
import sys
import time
import urllib.request
from datetime import datetime
import calendar
from pathlib import Path
import time
# GitHub URL for team list file
TEAMS_FILE_URL = "https://raw.githubusercontent.com/block/goose/main/documentation/scripts/community_stars_teams.txt"
TEAMS_FILE_URL = "https://raw.githubusercontent.com/aaif-goose/goose/main/documentation/scripts/community_stars_teams.txt"
LOCAL_TEAMS_FILE = Path(__file__).parent / "community_stars_teams.txt"
# Block-related organizations to check
BLOCK_ORGS = {'square', 'block', 'squareup', 'block-ghc', 'cashapp'}
BLOCK_ORGS = {"square", "block", "squareup", "block-ghc", "cashapp"}
def is_block_employee(username):
"""Check if a user is a Block employee by checking their profile and org memberships.
Makes a single API call to get user profile (includes company field),
then only calls orgs endpoint if company field doesn't match.
"""
@@ -49,93 +53,97 @@ def is_block_employee(username):
# First check the user's profile (single API call)
url = f"https://api.github.com/users/{username}"
with urllib.request.urlopen(url) as response:
user_data = json.loads(response.read().decode('utf-8'))
user_data = json.loads(response.read().decode("utf-8"))
# Check company field first (no additional API call needed)
company = user_data.get('company', '').lower() if user_data.get('company') else ''
company = (
user_data.get("company", "").lower() if user_data.get("company") else ""
)
if company:
# Check for Block-related keywords in company field
block_keywords = ['block', 'square', 'cash app', 'cashapp', 'tidal']
block_keywords = ["block", "square", "cash app", "cashapp", "tidal"]
if any(keyword in company for keyword in block_keywords):
return True
# Only check orgs if company field didn't match (second API call only when needed)
url = f"https://api.github.com/users/{username}/orgs"
with urllib.request.urlopen(url) as response:
orgs = json.loads(response.read().decode('utf-8'))
orgs = json.loads(response.read().decode("utf-8"))
# Check if any org matches Block orgs (case-insensitive)
user_orgs = {org['login'].lower() for org in orgs}
user_orgs = {org["login"].lower() for org in orgs}
if user_orgs & BLOCK_ORGS:
return True
return False
except Exception as e:
# If we can't check (rate limit, network error, etc.), return False
# This means we'll default to treating them as external
return False
def load_team_lists():
"""Load and parse team lists from file (local or GitHub)."""
content = None
# Try local file first
if LOCAL_TEAMS_FILE.exists():
with open(LOCAL_TEAMS_FILE, 'r') as f:
with open(LOCAL_TEAMS_FILE, "r") as f:
content = f.read()
else:
# Fall back to GitHub
try:
with urllib.request.urlopen(TEAMS_FILE_URL) as response:
content = response.read().decode('utf-8')
content = response.read().decode("utf-8")
except Exception as e:
print(f"Error: Could not load team list file from {TEAMS_FILE_URL}")
print(f"Details: {e}")
sys.exit(1)
# Parse the team lists
goose_maintainers = set()
block_non_goose = set()
external_goose = set()
bots = set()
current_section = None
for line in content.split('\n'):
for line in content.split("\n"):
line = line.strip()
# Skip comments and empty lines
if not line or line.startswith('#'):
if not line or line.startswith("#"):
# Check for section headers in comments
if '# Goose Maintainers' in line:
current_section = 'goose_maintainers'
elif '# Block, non-goose' in line:
current_section = 'block_non_goose'
elif '# External, goose' in line:
current_section = 'external_goose'
elif '# Bots' in line:
current_section = 'bots'
if "# Goose Maintainers" in line:
current_section = "goose_maintainers"
elif "# Block, non-goose" in line:
current_section = "block_non_goose"
elif "# External, goose" in line:
current_section = "external_goose"
elif "# Bots" in line:
current_section = "bots"
continue
# Add username to appropriate set (lowercase for case-insensitive matching)
username = line.lower()
if current_section == 'goose_maintainers':
if current_section == "goose_maintainers":
goose_maintainers.add(username)
elif current_section == 'block_non_goose':
elif current_section == "block_non_goose":
block_non_goose.add(username)
elif current_section == 'external_goose':
elif current_section == "external_goose":
external_goose.add(username)
elif current_section == 'bots':
elif current_section == "bots":
bots.add(username)
return goose_maintainers, block_non_goose, external_goose, bots
def parse_date_range(date_input):
"""Parse various date input formats and return start/end timestamps."""
date_input = date_input.strip()
# Format: "Month YYYY" (e.g., "November 2025")
month_year_pattern = r'^(January|February|March|April|May|June|July|August|September|October|November|December)\s+(\d{4})$'
month_year_pattern = r"^(January|February|March|April|May|June|July|August|September|October|November|December)\s+(\d{4})$"
match = re.match(month_year_pattern, date_input, re.IGNORECASE)
if match:
month_name = match.group(1).capitalize()
@@ -144,16 +152,16 @@ def parse_date_range(date_input):
last_day = calendar.monthrange(year, start_date.month)[1]
end_date = datetime(year, start_date.month, last_day, 23, 59, 59)
return start_date.timestamp(), end_date.timestamp(), date_input
# Format: "Date1 - Date2" (e.g., "November 1, 2025 - November 17, 2025" or "2025-11-01 - 2025-11-17")
if ' - ' in date_input or ' to ' in date_input:
separator = ' - ' if ' - ' in date_input else ' to '
if " - " in date_input or " to " in date_input:
separator = " - " if " - " in date_input else " to "
parts = date_input.split(separator)
if len(parts) == 2:
date_formats = ["%B %d, %Y", "%b %d, %Y", "%Y-%m-%d"]
start_date = None
end_date = None
for fmt in date_formats:
try:
start_date = datetime.strptime(parts[0].strip(), fmt)
@@ -161,12 +169,17 @@ def parse_date_range(date_input):
break
except ValueError:
continue
if start_date and end_date:
end_date = datetime(end_date.year, end_date.month, end_date.day, 23, 59, 59)
end_date = datetime(
end_date.year, end_date.month, end_date.day, 23, 59, 59
)
return start_date.timestamp(), end_date.timestamp(), date_input
raise ValueError(f"Could not parse date input: {date_input}\nSupported formats:\n - 'Month YYYY' (e.g., 'November 2025')\n - 'Month Day, YYYY - Month Day, YYYY' (e.g., 'November 1, 2025 - November 17, 2025')\n - 'YYYY-MM-DD - YYYY-MM-DD' (e.g., '2025-11-01 - 2025-11-17')")
raise ValueError(
f"Could not parse date input: {date_input}\nSupported formats:\n - 'Month YYYY' (e.g., 'November 2025')\n - 'Month Day, YYYY - Month Day, YYYY' (e.g., 'November 1, 2025 - November 17, 2025')\n - 'YYYY-MM-DD - YYYY-MM-DD' (e.g., '2025-11-01 - 2025-11-17')"
)
def main():
# Parse command line arguments
@@ -191,127 +204,162 @@ def main():
goose_maintainers, block_non_goose, external_goose, bots = load_team_lists()
# Load GitHub data
github_data_file = '/tmp/github_contributors.json'
github_data_file = "/tmp/github_contributors.json"
contributors_data = None
# Try to load existing file first
try:
with open(github_data_file, 'r') as f:
with open(github_data_file, "r") as f:
contributors_data = json.load(f)
# Validate the data is not empty or invalid
if not contributors_data or not isinstance(contributors_data, list) or len(contributors_data) == 0:
print(f"Warning: GitHub data file exists but is empty or invalid. Fetching fresh data...", file=sys.stderr)
if (
not contributors_data
or not isinstance(contributors_data, list)
or len(contributors_data) == 0
):
print(
f"Warning: GitHub data file exists but is empty or invalid. Fetching fresh data...",
file=sys.stderr,
)
contributors_data = None
except (FileNotFoundError, json.JSONDecodeError):
print(f"GitHub data file not found or invalid. Fetching fresh data...", file=sys.stderr)
print(
f"GitHub data file not found or invalid. Fetching fresh data...",
file=sys.stderr,
)
contributors_data = None
# Fetch from GitHub API if needed
if contributors_data is None:
print("Fetching contributor data from GitHub API...", file=sys.stderr)
max_retries = 3
retry_delay = 2
for attempt in range(max_retries):
try:
url = "https://api.github.com/repos/block/goose/stats/contributors"
url = "https://api.github.com/repos/aaif-goose/goose/stats/contributors"
with urllib.request.urlopen(url, timeout=30) as response:
contributors_data = json.loads(response.read().decode('utf-8'))
contributors_data = json.loads(response.read().decode("utf-8"))
# Validate the response
if contributors_data and isinstance(contributors_data, list) and len(contributors_data) > 0:
if (
contributors_data
and isinstance(contributors_data, list)
and len(contributors_data) > 0
):
# Save to file for future use
with open(github_data_file, 'w') as f:
with open(github_data_file, "w") as f:
json.dump(contributors_data, f)
print(f"✓ Successfully fetched data for {len(contributors_data)} contributors", file=sys.stderr)
print(
f"✓ Successfully fetched data for {len(contributors_data)} contributors",
file=sys.stderr,
)
break
else:
print(f"Attempt {attempt + 1}/{max_retries}: GitHub API returned empty data. Retrying...", file=sys.stderr)
print(
f"Attempt {attempt + 1}/{max_retries}: GitHub API returned empty data. Retrying...",
file=sys.stderr,
)
contributors_data = None
if attempt < max_retries - 1:
time.sleep(retry_delay)
except Exception as e:
print(f"Attempt {attempt + 1}/{max_retries}: Error fetching from GitHub API: {e}", file=sys.stderr)
print(
f"Attempt {attempt + 1}/{max_retries}: Error fetching from GitHub API: {e}",
file=sys.stderr,
)
if attempt < max_retries - 1:
time.sleep(retry_delay)
else:
print("\nError: Could not fetch GitHub contributor data after multiple attempts.")
print("The GitHub stats API may be temporarily unavailable or still computing statistics.")
print(
"\nError: Could not fetch GitHub contributor data after multiple attempts."
)
print(
"The GitHub stats API may be temporarily unavailable or still computing statistics."
)
print("Please try again in a few minutes.")
sys.exit(1)
if contributors_data is None:
print("\nError: GitHub API returned empty data after multiple attempts.")
print("The repository statistics may still be computing. Please try again in a few minutes.")
print(
"The repository statistics may still be computing. Please try again in a few minutes."
)
sys.exit(1)
# Process contributors
contributor_stats = []
checked_orgs = {} # Cache org checks to avoid redundant API calls
print("Checking contributor organizations...", file=sys.stderr)
for contributor in contributors_data:
# Skip if author is None (deleted users)
if contributor.get('author') is None:
if contributor.get("author") is None:
continue
username = contributor['author']['login']
username = contributor["author"]["login"]
username_lower = username.lower()
# Skip excluded categories (case-insensitive matching)
if username_lower in bots or username_lower in goose_maintainers or username_lower in external_goose:
if (
username_lower in bots
or username_lower in goose_maintainers
or username_lower in external_goose
):
continue
# Calculate stats for the specified period
period_commits = 0
period_additions = 0
period_deletions = 0
for week in contributor['weeks']:
week_timestamp = week['w']
for week in contributor["weeks"]:
week_timestamp = week["w"]
if start_timestamp <= week_timestamp <= end_timestamp:
period_commits += week['c']
period_additions += week['a']
period_deletions += week['d']
period_commits += week["c"]
period_additions += week["a"]
period_deletions += week["d"]
# Only include contributors with activity in the period
if period_commits > 0:
total_lines = period_additions + period_deletions
# Categorize (only Block non-goose and External now)
if username_lower in block_non_goose:
category = 'block_non_goose'
category = "block_non_goose"
else:
# Check if user is in a Block org (with caching)
if username not in checked_orgs:
checked_orgs[username] = is_block_employee(username)
# Add a small delay to avoid rate limiting
time.sleep(0.1)
if checked_orgs[username]:
category = 'block_non_goose'
category = "block_non_goose"
print(f" ✓ Detected Block employee: @{username}", file=sys.stderr)
else:
category = 'external'
contributor_stats.append({
'username': username,
'category': category,
'commits': period_commits,
'additions': period_additions,
'deletions': period_deletions,
'total_lines': total_lines,
'score': period_commits + total_lines
})
category = "external"
contributor_stats.append(
{
"username": username,
"category": category,
"commits": period_commits,
"additions": period_additions,
"deletions": period_deletions,
"total_lines": total_lines,
"score": period_commits + total_lines,
}
)
# Sort by score
contributor_stats.sort(key=lambda x: x['score'], reverse=True)
contributor_stats.sort(key=lambda x: x["score"], reverse=True)
# Separate by category
block_list = [c for c in contributor_stats if c['category'] == 'block_non_goose']
external_list = [c for c in contributor_stats if c['category'] == 'external']
block_list = [c for c in contributor_stats if c["category"] == "block_non_goose"]
external_list = [c for c in contributor_stats if c["category"] == "external"]
# Get top 5 from each
top_external = external_list[:5]
@@ -320,7 +368,9 @@ def main():
# Print results
print("=" * 70)
print(f"COMMUNITY STARS - {display_period.upper()}")
print(f"(Period: {start_date.strftime('%B %d, %Y')} - {end_date.strftime('%B %d, %Y')})")
print(
f"(Period: {start_date.strftime('%B %d, %Y')} - {end_date.strftime('%B %d, %Y')})"
)
print("=" * 70)
print()
@@ -328,7 +378,9 @@ def main():
print("-" * 70)
if top_external:
for i, contrib in enumerate(top_external, 1):
print(f"{i}. @{contrib['username']:20s} - {contrib['commits']:3d} commits, {contrib['total_lines']:6,d} lines")
print(
f"{i}. @{contrib['username']:20s} - {contrib['commits']:3d} commits, {contrib['total_lines']:6,d} lines"
)
else:
print("No external contributors found for this period.")
@@ -337,7 +389,9 @@ def main():
print("-" * 70)
if top_internal:
for i, contrib in enumerate(top_internal, 1):
print(f"{i}. @{contrib['username']:20s} - {contrib['commits']:3d} commits, {contrib['total_lines']:6,d} lines")
print(
f"{i}. @{contrib['username']:20s} - {contrib['commits']:3d} commits, {contrib['total_lines']:6,d} lines"
)
else:
print("No internal contributors found for this period.")
@@ -346,17 +400,22 @@ def main():
print("-" * 70)
if contributor_stats:
for i, contrib in enumerate(contributor_stats, 1):
cat_label = "External" if contrib['category'] == 'external' else "Block"
print(f"{i:2d}. @{contrib['username']:20s} - {contrib['commits']:3d} commits, {contrib['total_lines']:6,d} lines [{cat_label}]")
cat_label = "External" if contrib["category"] == "external" else "Block"
print(
f"{i:2d}. @{contrib['username']:20s} - {contrib['commits']:3d} commits, {contrib['total_lines']:6,d} lines [{cat_label}]"
)
else:
print("No contributors found for this period.")
print()
print("=" * 70)
print(f"Total contributors (excluding bots, goose maintainers, external goose): {len(contributor_stats)}")
print(
f"Total contributors (excluding bots, goose maintainers, external goose): {len(contributor_stats)}"
)
print(f" External: {len(external_list)}")
print(f" Block (non-goose): {len(block_list)}")
print("=" * 70)
if __name__ == "__main__":
main()
documentation/scripts/community_stars_teams.txt
+1 -1
View File
@@ -1,5 +1,5 @@
# Community Stars Team Lists
# This file categorizes contributors for the block/goose Community Stars program
# This file categorizes contributors for the aaif-goose/goose Community Stars program
# Format: One username per line under each category header
#
# Note: External contributors (eligible for Community All-Stars) are automatically
documentation/scripts/generate-docs-map.js
+1 -1
View File
@@ -79,7 +79,7 @@ async function main() {
}
}
output += `---\n\n> Full docs: https://block.github.io/goose/\n`;
output += `---\n\n> Full docs: https://goose-docs.ai/\n`;
fs.writeFileSync(OUTPUT_FILE, output);
console.log(`[generate-docs-map] Generated: ${OUTPUT_FILE}`);