diff --git a/workflows/01-community-ops.sh b/workflows/01-community-ops.sh new file mode 100644 index 00000000..db653833 --- /dev/null +++ b/workflows/01-community-ops.sh @@ -0,0 +1,295 @@ +#!/usr/bin/env bash +# ───────────────────────────────────────────────────────────────────── +# Scenario 1: Community Operations Automation +# Flow: Issue auto-classify → Assign responsible → Weekly report → Release notes +# +# Commands/Skills chained: +# 1. issue +list -- fetch open issues +# 2. issue +view -- read issue details +# 3. issue +batch-label -- add classification labels +# 4. issue +batch-assign -- assign responsible person +# 5. pr +list -- collect merged PRs for weekly report +# 6. wiki +create -- publish community weekly report +# 7. release +create -- publish release notes +# ───────────────────────────────────────────────────────────────────── + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +source "$SCRIPT_DIR/lib/common.sh" + +usage() { + echo "Usage: $0 --owner OWNER --repo REPO [--week WEEKS_AGO] [--dry-run]" + echo "" + echo " --owner OWNER Repository owner (org or user)" + echo " --repo REPO Repository name" + echo " --week N Generate report for N weeks ago (default: 0 = this week)" + echo " --dry-run Preview actions without executing" + exit 1 +} + +WEEKS_AGO=0 +DRY_RUN=false +OWNER="" +REPO="" + +while [[ $# -gt 0 ]]; do + case "$1" in + --owner) OWNER="$2"; shift 2 ;; + --repo) REPO="$2"; shift 2 ;; + --week) WEEKS_AGO="$2"; shift 2 ;; + --dry-run) DRY_RUN="true"; shift ;; + --help|-h) usage ;; + *) log_err "Unknown arg: $1"; usage ;; + esac +done + +check_auth +require_owner_repo + +# ───────────────────────────────────────────────────────────────────── +log_title "Phase 1: Issue Auto-Classification" +# ───────────────────────────────────────────────────────────────────── + +log_step "Fetching open issues..." +ISSUES_JSON=$(gl_check issue +list --owner "$OWNER" --repo "$REPO" --state open --limit 100) +ISSUE_COUNT=$(echo "$ISSUES_JSON" | jq '.data.issues | length') +log_ok "Found $ISSUE_COUNT open issues" + +if [[ "$ISSUE_COUNT" -gt 0 ]]; then + # Classify each issue by keywords in title/description + declare -A LABEL_MAP=() + BUG_IDS=() + FEATURE_IDS=() + QUESTION_IDS=() + DOCS_IDS=() + + log_step "Classifying issues by content..." + + for i in $(seq 0 $((ISSUE_COUNT - 1))); do + ISSUE_ID=$(echo "$ISSUES_JSON" | jq -r ".data.issues[$i].id") + ISSUE_TITLE=$(echo "$ISSUES_JSON" | jq -r ".data.issues[$i].subject // .data.issues[$i].title // \"\"") + ISSUE_DESC=$(echo "$ISSUES_JSON" | jq -r ".data.issues[$i].description // \"\"" | head -c 500) + COMBINED="$ISSUE_TITLE $ISSUE_DESC" + + # Keyword-based classification + if echo "$COMBINED" | grep -qiE 'bug|error|crash|fault|fix|修复|错误|异常|崩溃'; then + BUG_IDS+=("$ISSUE_ID") + log_info " #$ISSUE_ID → BUG: $ISSUE_TITLE" + elif echo "$COMBINED" | grep -qiE 'feature|新增|建议|enhancement|add|support|功能'; then + FEATURE_IDS+=("$ISSUE_ID") + log_info " #$ISSUE_ID → FEATURE: $ISSUE_TITLE" + elif echo "$COMBINED" | grep -qiE 'how|怎么|如何|question|help|\?|?'; then + QUESTION_IDS+=("$ISSUE_ID") + log_info " #$ISSUE_ID → QUESTION: $ISSUE_TITLE" + elif echo "$COMBINED" | grep -qiE 'doc|文档|readme|说明|guide'; then + DOCS_IDS+=("$ISSUE_ID") + log_info " #$ISSUE_ID → DOCS: $ISSUE_TITLE" + else + log_info " #$ISSUE_ID → UNCATEGORIZED: $ISSUE_TITLE" + fi + done + + divider + log_info "Classification summary:" + log_info " Bugs: ${#BUG_IDS[@]}" + log_info " Features: ${#FEATURE_IDS[@]}" + log_info " Questions: ${#QUESTION_IDS[@]}" + log_info " Docs: ${#DOCS_IDS[@]}" + + # Apply labels via batch-label + if [[ ${#BUG_IDS[@]} -gt 0 ]]; then + log_step "Labeling bug issues..." + for bid in "${BUG_IDS[@]}"; do + gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$bid" --labels "bug" > /dev/null 2>&1 || true + done + log_ok "Labeled ${#BUG_IDS[@]} bug issues" + fi + + if [[ ${#FEATURE_IDS[@]} -gt 0 ]]; then + log_step "Labeling feature issues..." + for fid in "${FEATURE_IDS[@]}"; do + gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$fid" --labels "feature" > /dev/null 2>&1 || true + done + log_ok "Labeled ${#FEATURE_IDS[@]} feature issues" + fi + + if [[ ${#QUESTION_IDS[@]} -gt 0 ]]; then + log_step "Labeling question issues..." + for qid in "${QUESTION_IDS[@]}"; do + gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$qid" --labels "question" > /dev/null 2>&1 || true + done + log_ok "Labeled ${#QUESTION_IDS[@]} question issues" + fi + + if [[ ${#DOCS_IDS[@]} -gt 0 ]]; then + log_step "Labeling docs issues..." + for did in "${DOCS_IDS[@]}"; do + gl_run issue +label-add --owner "$OWNER" --repo "$REPO" --number "$did" --labels "documentation" > /dev/null 2>&1 || true + done + log_ok "Labeled ${#DOCS_IDS[@]} docs issues" + fi +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Phase 2: Assign Responsible Persons" +# ───────────────────────────────────────────────────────────────────── + +log_step "Fetching repo members for assignment..." +MEMBERS_JSON=$(gl_run repo +members --owner "$OWNER" --repo "$REPO" --limit 50) +MEMBER_COUNT=$(echo "$MEMBERS_JSON" | jq '.data.members | length' 2>/dev/null || echo "0") + +if [[ "$MEMBER_COUNT" -gt 0 ]]; then + # Assign bugs to first member, features to second, etc. (round-robin) + MEMBER_LOGINS=() + for i in $(seq 0 $((MEMBER_COUNT - 1))); do + LOGIN=$(echo "$MEMBERS_JSON" | jq -r ".data.members[$i].login // .data.members[$i].username // empty") + [[ -n "$LOGIN" ]] && MEMBER_LOGINS+=("$LOGIN") + done + + if [[ ${#MEMBER_LOGINS[@]} -gt 0 ]]; then + assign_issues() { + local label="$1" + shift + local ids=("$@") + local member_idx=0 + for id in "${ids[@]}"; do + local assignee="${MEMBER_LOGINS[$((member_idx % ${#MEMBER_LOGINS[@]}))]}" + gl_run issue +update --owner "$OWNER" --repo "$REPO" --number "$id" --assignee "$assignee" > /dev/null 2>&1 || true + log_info " Assigned #$id → @$assignee" + ((member_idx++)) + done + } + + log_step "Assigning bug issues..." + assign_issues "bug" "${BUG_IDS[@]}" 2>/dev/null || true + log_step "Assigning feature issues..." + assign_issues "feature" "${FEATURE_IDS[@]}" 2>/dev/null || true + log_ok "Assignment complete" + fi +else + log_warn "No repo members found, skipping assignment" +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Phase 3: Generate Community Weekly Report" +# ───────────────────────────────────────────────────────────────────── + +WEEK_START=$(date -d "$((WEEKS_AGO * 7)) days ago" +%Y-%m-%d 2>/dev/null || date_today) +WEEK_END=$(date_today) + +log_step "Collecting weekly data (week of $WEEK_START)..." + +# Closed issues this week +CLOSED_ISSUES=$(gl_run issue +list --owner "$OWNER" --repo "$REPO" --state closed --limit 100) +CLOSED_COUNT=$(echo "$CLOSED_ISSUES" | jq '.data.issues | length' 2>/dev/null || echo "0") + +# Merged PRs this week +MERGED_PRS=$(gl_run pr +list --owner "$OWNER" --repo "$REPO" --state merged --limit 100) +MERGED_COUNT=$(echo "$MERGED_PRS" | jq '.data.issues | length' 2>/dev/null || echo "0") + +# New issues +NEW_ISSUES_COUNT=$ISSUE_COUNT + +# Build weekly report +REPORT_TITLE="Community Weekly Report: $WEEK_START ~ $WEEK_END" +REPORT_BODY="# $REPORT_TITLE + +## Summary +- New Issues: **$NEW_ISSUES_COUNT** +- Closed Issues: **$CLOSED_COUNT** +- Merged PRs: **$MERGED_COUNT** + +## Issue Classification +| Type | Count | +|------|-------| +| Bug | ${#BUG_IDS[@]} | +| Feature | ${#FEATURE_IDS[@]} | +| Question | ${#QUESTION_IDS[@]} | +| Docs | ${#DOCS_IDS[@]} | + +## Highlights +- Auto-classified and labeled $(( ${#BUG_IDS[@]} + ${#FEATURE_IDS[@]} + ${#QUESTION_IDS[@]} + ${#DOCS_IDS[@]} )) issues +- Assigned responsible persons for bug and feature issues + +--- +*Auto-generated by gitlink-cli community-ops workflow*" + +log_ok "Weekly report generated" +echo "" +echo "$REPORT_BODY" + +# Publish to Wiki +log_step "Publishing weekly report to Wiki..." +WIKI_RESULT=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO" \ + --title "$REPORT_TITLE" \ + --content "$REPORT_BODY" 2>&1) || true + +if [[ "$(json_ok "$WIKI_RESULT")" == "true" ]]; then + log_ok "Weekly report published to Wiki" +else + log_warn "Wiki publish may have failed (wiki module might not be enabled)" +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Phase 4: Auto-Publish Release Notes" +# ───────────────────────────────────────────────────────────────────── + +log_step "Collecting recent changes for release notes..." + +# Get recent commits via compare API +TAG_NAME="weekly-$(date +%Y%m%d)" +RELEASE_NAME="Weekly Release $(date +%Y-%m-%d)" + +# Build release notes from closed issues and merged PRs +RELEASE_BODY="# Release Notes - $(date +%Y-%m-%d) + +## Merged PRs ($MERGED_COUNT)" + +if [[ "$MERGED_COUNT" -gt 0 ]]; then + for i in $(seq 0 $((MERGED_COUNT > 10 ? 9 : MERGED_COUNT - 1))); do + PR_TITLE=$(echo "$MERGED_PRS" | jq -r ".data.issues[$i].subject // .data.issues[$i].title // \"\"") + PR_NUM=$(echo "$MERGED_PRS" | jq -r ".data.issues[$i].id // .data.issues[$i].number // \"\"") + RELEASE_BODY+=$'\n'"- #$PR_NUM $PR_TITLE" + done +fi + +RELEASE_BODY+=" + +## Closed Issues ($CLOSED_COUNT)" + +if [[ "$CLOSED_COUNT" -gt 0 ]]; then + for i in $(seq 0 $((CLOSED_COUNT > 10 ? 9 : CLOSED_COUNT - 1))); do + ISSUE_TITLE=$(echo "$CLOSED_ISSUES" | jq -r ".data.issues[$i].subject // .data.issues[$i].title // \"\"") + ISSUE_NUM=$(echo "$CLOSED_ISSUES" | jq -r ".data.issues[$i].id // .data.issues[$i].number // \"\"") + RELEASE_BODY+=$'\n'"- #$ISSUE_NUM $ISSUE_TITLE" + done +fi + +RELEASE_BODY+=" + +--- +*Auto-generated by gitlink-cli community-ops workflow*" + +log_step "Creating release: $TAG_NAME..." +RELEASE_RESULT=$(gl_run release +create --owner "$OWNER" --repo "$REPO" \ + --tag "$TAG_NAME" \ + --name "$RELEASE_NAME" \ + --body "$RELEASE_BODY" 2>&1) || true + +if [[ "$(json_ok "$RELEASE_RESULT")" == "true" ]]; then + log_ok "Release $TAG_NAME created successfully" +else + log_warn "Release creation may have failed (tag might already exist)" + log_info "You can manually create with: gitlink-cli release +create --owner $OWNER --repo $REPO --tag $TAG_NAME --name '$RELEASE_NAME'" +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Community Operations Complete" +# ───────────────────────────────────────────────────────────────────── + +echo -e "${GREEN}Summary:${NC}" +echo " Issues classified: $(( ${#BUG_IDS[@]} + ${#FEATURE_IDS[@]} + ${#QUESTION_IDS[@]} + ${#DOCS_IDS[@]} ))" +echo " Closed this week: $CLOSED_COUNT" +echo " Merged PRs: $MERGED_COUNT" +echo " Weekly report: Published to Wiki" +echo " Release notes: $TAG_NAME" +echo "" diff --git a/workflows/02-code-quality-gatekeeper.sh b/workflows/02-code-quality-gatekeeper.sh new file mode 100644 index 00000000..53c4a0c6 --- /dev/null +++ b/workflows/02-code-quality-gatekeeper.sh @@ -0,0 +1,484 @@ +#!/usr/bin/env bash +# ───────────────────────────────────────────────────────────────────── +# Scenario 2: Code Quality Gatekeeper +# Flow: PR submit → Load Skill → Auto Review → Check CI → Auto-merge +# +# Commands/Skills chained: +# 1. pr +list -- list open PRs +# 2. pr +view -- get PR details +# 3. pr +files -- get changed files +# 4. pr +diff -- get diff content +# 5. gitlink-code-review -- AI code review (skill-driven) +# 6. api POST .../reviews -- post review comment with scores +# 7. ci +builds -- check CI build status +# 8. pr +merge -- auto-merge if quality passes threshold +# ───────────────────────────────────────────────────────────────────── + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +source "$SCRIPT_DIR/lib/common.sh" + +usage() { + echo "Usage: $0 --owner OWNER --repo REPO [--pr-id ID] [--threshold SCORE] [--dry-run]" + echo "" + echo " --owner OWNER Repository owner" + echo " --repo REPO Repository name" + echo " --pr-id ID Specific PR to review (default: all open PRs)" + echo " --threshold SCORE Min quality score to auto-merge (default: 80)" + echo " --dry-run Preview actions without executing" + exit 1 +} + +THRESHOLD=80 +DRY_RUN=false +OWNER="" +REPO="" +PR_ID="" + +while [[ $# -gt 0 ]]; do + case "$1" in + --owner) OWNER="$2"; shift 2 ;; + --repo) REPO="$2"; shift 2 ;; + --pr-id) PR_ID="$2"; shift 2 ;; + --threshold) THRESHOLD="$2"; shift 2 ;; + --dry-run) DRY_RUN="true"; shift ;; + --help|-h) usage ;; + *) log_err "Unknown arg: $1"; usage ;; + esac +done + +check_auth +require_owner_repo + +# ── Review a single PR ─────────────────────────────────────────────── +review_pr() { + local pr_id="$1" + + log_title "Reviewing PR #$pr_id" + + # Initialize arrays + ISSUES_FOUND=() + AI_POSITIVE=() + AI_RECOMMENDATIONS=() + + # Step 1: Get PR details + log_step "Fetching PR details..." + PR_JSON=$(gl_check pr +view --owner "$OWNER" --repo "$REPO" --id "$pr_id") + PR_TITLE=$(echo "$PR_JSON" | jq -r '.data.title // .data.subject // "N/A"') + PR_STATE=$(echo "$PR_JSON" | jq -r '.data.state // .data.status // "N/A"') + PR_AUTHOR=$(echo "$PR_JSON" | jq -r '.data.author.login // .data.author.username // .data.user.login // "N/A"') + log_ok "PR #$pr_id: \"$PR_TITLE\" by @$PR_AUTHOR (state: $PR_STATE)" + + # Step 2: Get changed files + log_step "Fetching changed files..." + FILES_JSON=$(gl_run pr +files --owner "$OWNER" --repo "$REPO" --id "$pr_id") + FILE_COUNT=0 + if echo "$FILES_JSON" | jq empty 2>/dev/null; then + FILE_COUNT=$(echo "$FILES_JSON" | jq '.data.files | length' 2>/dev/null || echo "0") + fi + log_ok "Changed files: $FILE_COUNT" + + # List changed files + if [[ "$FILE_COUNT" -gt 0 ]] && [[ "$FILE_COUNT" != "null" ]]; then + for i in $(seq 0 $((FILE_COUNT - 1))); do + FNAME=$(echo "$FILES_JSON" | jq -r ".data.files[$i].name // .data.files[$i].filename // \"unknown\"" 2>/dev/null || echo "unknown") + echo " $FNAME" + done + fi + + # Step 3: Get diff (extract file names and content from diff response) + log_step "Fetching diff..." + DIFF_JSON=$(gl_run pr +diff --owner "$OWNER" --repo "$REPO" --id "$pr_id") + DIFF_CONTENT="" + if echo "$DIFF_JSON" | jq empty 2>/dev/null; then + DIFF_CONTENT=$(echo "$DIFF_JSON" | jq -r ' + [.data.files[]?.sections[]?.lines[]?.content // empty] | join("\n") + ' 2>/dev/null | head -c 5000 || true) + fi + DIFF_LINES=$(echo "$DIFF_CONTENT" | wc -l) + log_ok "Diff: $DIFF_LINES lines" + + # Step 4: AI-powered code review + log_step "AI analyzing code quality..." + + # Build file list string + FILE_LIST="" + if [[ "$FILE_COUNT" -gt 0 ]] && [[ "$FILE_COUNT" != "null" ]]; then + for i in $(seq 0 $((FILE_COUNT - 1))); do + FNAME=$(echo "$FILES_JSON" | jq -r ".data.files[$i].name // .data.files[$i].filename // \"unknown\"" 2>/dev/null || echo "unknown") + FILE_LIST+="- $FNAME"$'\n' + done + fi + + # Truncate diff to fit within context limits + DIFF_TRUNCATED=$(echo "$DIFF_CONTENT" | head -c 4000) + + # ── Load gitlink-code-review skill (concise version) ────────── + SKILL_DIR="$SCRIPT_DIR/../skills/gitlink-code-review" + SKILL_DIMENSIONS="" + if [[ -f "$SKILL_DIR/SKILL.md" ]]; then + SKILL_DIMENSIONS=$(sed -n '/^## 📊 审查维度/,/^## 🔧 使用方式/p' "$SKILL_DIR/SKILL.md" | grep '^\- \*\*' | head -20) + fi + + REVIEW_PROMPT="你是代码审查专家。请按 gitlink-code-review skill 的审查维度分析以下 PR。 + +## 审查维度与检查项 + +${SKILL_DIMENSIONS:-1. 代码质量: 复杂度、命名、注释、格式 +2. 安全性: SQL注入、XSS、敏感信息、认证、输入验证 +3. 性能: 循环效率、资源泄漏、N+1查询、内存 +4. 可维护性: 代码重复、职责单一、依赖耦合、测试覆盖} + +## 评分标准 +- 90-100: 优秀,可直接合并 +- 75-89: 良好,建议合并 +- 60-74: 一般,需要改进 +- <60: 较差,不建议合并 + +## 问题严重级别 +- CRITICAL: 阻止合并 +- HIGH: 强烈建议修复 +- MEDIUM: 建议修复 +- LOW: 可选修复 + +## PR 数据 + +PR 标题: $PR_TITLE +变更文件: +$FILE_LIST +代码差异: +$DIFF_TRUNCATED + +## 输出要求 + +请严格按以下 JSON 格式输出,不要输出其他内容: +{\"total\": <0-100>, \"quality\": <0-25>, \"security\": <0-25>, \"performance\": <0-25>, \"maintainability\": <0-25>, \"issues\": [{\"severity\": \"HIGH/MEDIUM/LOW\", \"category\": \"quality/security/performance/maintainability\", \"file\": \"文件路径\", \"rule\": \"规则名\", \"description\": \"问题描述\", \"suggestion\": \"修复建议\"}], \"positive_notes\": [{\"description\": \"优秀实践描述\"}], \"recommendations\": [\"改进建议1\"], \"verdict\": \"PASS或FAIL\"}" + + # Call Claude Code CLI for AI review + AI_AVAILABLE=false + if command -v claude &>/dev/null; then + log_info "Calling AI agent for code review (may take 30-60s)..." + PROMPT_FILE=$(mktemp) + AI_OUT_FILE=$(mktemp) + echo "$REVIEW_PROMPT" > "$PROMPT_FILE" + + # Run claude in a subshell to isolate from set -euo pipefail + AI_EXIT=0 + ( + timeout 120 claude -p --output-format json < "$PROMPT_FILE" > "$AI_OUT_FILE" 2>/dev/null + ) || AI_EXIT=$? + + if [[ $AI_EXIT -eq 0 ]] && [[ -s "$AI_OUT_FILE" ]]; then + # Parse Claude CLI JSON response + AI_RESULT=$(jq -r '.result // empty' "$AI_OUT_FILE" 2>/dev/null) + else + log_warn "AI call failed (exit: $AI_EXIT), falling back to keyword-based" + AI_RESULT="" + fi + rm -f "$PROMPT_FILE" "$AI_OUT_FILE" + + if [[ -n "$AI_RESULT" ]]; then + # Extract JSON block from AI response (may contain markdown wrapping) + # Use python for reliable JSON extraction from mixed content + AI_JSON="" + if command -v python3 &>/dev/null; then + AI_JSON=$(python3 -c " +import sys, json +text = sys.stdin.read() +# Find JSON by balanced brace matching +depth = 0 +start = -1 +results = [] +for i, c in enumerate(text): + if c == '{': + if depth == 0: + start = i + depth += 1 + elif c == '}': + depth -= 1 + if depth == 0 and start >= 0: + results.append(text[start:i+1]) + start = -1 +for m in reversed(results): + try: + obj = json.loads(m) + if 'total' in obj and 'verdict' in obj: + print(json.dumps(obj)) + break + except: pass +" <<< "$AI_RESULT" 2>/dev/null) + fi + # Fallback: simple grep extraction + if [[ -z "$AI_JSON" ]]; then + AI_JSON=$(echo "$AI_RESULT" | grep -oP '\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}' | tail -1) + fi + + if [[ -n "$AI_JSON" ]] && echo "$AI_JSON" | jq empty 2>/dev/null; then + TOTAL_SCORE=$(echo "$AI_JSON" | jq -r '.total // 0' 2>/dev/null) + SCORE_QUALITY=$(echo "$AI_JSON" | jq -r '.quality // 0' 2>/dev/null) + SCORE_SECURITY=$(echo "$AI_JSON" | jq -r '.security // 0' 2>/dev/null) + SCORE_PERFORMANCE=$(echo "$AI_JSON" | jq -r '.performance // 0' 2>/dev/null) + SCORE_MAINTAINABILITY=$(echo "$AI_JSON" | jq -r '.maintainability // 0' 2>/dev/null) + AI_VERDICT=$(echo "$AI_JSON" | jq -r '.verdict // "PASS"' 2>/dev/null) + + # Extract structured issues array (objects with severity/category/description) + ISSUES_FOUND=() + ISSUE_COUNT=$(echo "$AI_JSON" | jq '.issues | length' 2>/dev/null || echo "0") + if [[ "$ISSUE_COUNT" -gt 0 ]] && [[ "$ISSUE_COUNT" != "null" ]]; then + for idx in $(seq 0 $((ISSUE_COUNT - 1))); do + # Support both structured objects and plain strings + issue=$(echo "$AI_JSON" | jq -r ' + if .issues['"$idx"'] | type == "object" then + "[" + (.issues['"$idx"'].severity // "?") + "] " + + (.issues['"$idx"'].category // "?") + ": " + + (.issues['"$idx"'].description // .issues['"$idx"'].rule // "unknown") + + (if .issues['"$idx"'].file then " (" + .issues['"$idx"'].file + ")" else "" end) + + (if .issues['"$idx"'].suggestion then " → " + .issues['"$idx"'].suggestion else "" end) + else + .issues['"$idx"'] // empty + end + ' 2>/dev/null) + [[ -n "$issue" ]] && ISSUES_FOUND+=("$issue") + done + fi + + # Extract positive notes and recommendations + AI_POSITIVE=() + POS_COUNT=$(echo "$AI_JSON" | jq '.positive_notes | length' 2>/dev/null || echo "0") + if [[ "$POS_COUNT" -gt 0 ]] && [[ "$POS_COUNT" != "null" ]]; then + for idx in $(seq 0 $((POS_COUNT - 1))); do + note=$(echo "$AI_JSON" | jq -r '.positive_notes['"$idx"'].description // empty' 2>/dev/null) + [[ -n "$note" ]] && AI_POSITIVE+=("$note") + done + fi + + AI_RECOMMENDATIONS=() + REC_COUNT=$(echo "$AI_JSON" | jq '.recommendations | length' 2>/dev/null || echo "0") + if [[ "$REC_COUNT" -gt 0 ]] && [[ "$REC_COUNT" != "null" ]]; then + for idx in $(seq 0 $((REC_COUNT - 1))); do + rec=$(echo "$AI_JSON" | jq -r '.recommendations['"$idx"'] // empty' 2>/dev/null) + [[ -n "$rec" ]] && AI_RECOMMENDATIONS+=("$rec") + done + fi + + AI_AVAILABLE=true + log_ok "AI review complete (verdict: $AI_VERDICT)" + else + log_warn "Could not parse AI response JSON, falling back to keyword-based" + fi + fi + fi + + # Fallback: keyword-based heuristics if AI is not available + if [[ "$AI_AVAILABLE" != "true" ]]; then + log_warn "AI not available, falling back to keyword-based analysis" + + SCORE_QUALITY=25 + SCORE_SECURITY=25 + SCORE_PERFORMANCE=25 + SCORE_MAINTAINABILITY=25 + ISSUES_FOUND=() + + if echo "$DIFF_CONTENT" | grep -qiE 'password|secret|token|api_key|apikey|private_key'; then + SCORE_SECURITY=$((SCORE_SECURITY - 15)) + ISSUES_FOUND+=("SECURITY: 检测到可能的硬编码凭证") + fi + if echo "$DIFF_CONTENT" | grep -qiE 'eval\(|exec\(|system\(|shell_exec|os\.system|subprocess\.call'; then + SCORE_SECURITY=$((SCORE_SECURITY - 10)) + ISSUES_FOUND+=("SECURITY: 检测到危险函数调用") + fi + if echo "$DIFF_CONTENT" | grep -qiE 'TODO|FIXME|HACK|XXX'; then + SCORE_QUALITY=$((SCORE_QUALITY - 5)) + ISSUES_FOUND+=("QUALITY: 存在 TODO/FIXME/HACK 注释") + fi + if echo "$DIFF_CONTENT" | grep -qiE 'SELECT \*|\.findAll\(\)|\.all\(\)'; then + SCORE_PERFORMANCE=$((SCORE_PERFORMANCE - 10)) + ISSUES_FOUND+=("PERFORMANCE: 可能的全表查询") + fi + if echo "$DIFF_CONTENT" | grep -qiE 'sleep\(|time\.sleep|Thread\.sleep'; then + SCORE_PERFORMANCE=$((SCORE_PERFORMANCE - 5)) + ISSUES_FOUND+=("PERFORMANCE: 检测到阻塞式 sleep") + fi + if [[ "$FILE_COUNT" -gt 20 ]]; then + SCORE_MAINTAINABILITY=$((SCORE_MAINTAINABILITY - 10)) + ISSUES_FOUND+=("MAINTAINABILITY: 变更文件数量过多 ($FILE_COUNT)") + fi + + TOTAL_SCORE=$((SCORE_QUALITY + SCORE_SECURITY + SCORE_PERFORMANCE + SCORE_MAINTAINABILITY)) + TOTAL_SCORE=$((TOTAL_SCORE < 0 ? 0 : TOTAL_SCORE)) + fi + + # Print review report + divider + if [[ "$AI_AVAILABLE" == "true" ]]; then + log_info "AI Review Report for PR #$pr_id" + else + log_info "Review Report for PR #$pr_id (keyword-based)" + fi + echo "" + echo " Overall Score: $TOTAL_SCORE / 100" + echo " Code Quality: $SCORE_QUALITY / 25" + echo " Security: $SCORE_SECURITY / 25" + echo " Performance: $SCORE_PERFORMANCE / 25" + echo " Maintainability: $SCORE_MAINTAINABILITY / 25" + echo "" + + if [[ ${#ISSUES_FOUND[@]} -gt 0 ]]; then + echo " Issues Found:" + for issue in "${ISSUES_FOUND[@]}"; do + echo " - $issue" + done + echo "" + fi + + if [[ "${#AI_POSITIVE[@]}" -gt 0 ]]; then + echo " Positive Notes:" + for note in "${AI_POSITIVE[@]}"; do + echo " + $note" + done + echo "" + fi + + if [[ "${#AI_RECOMMENDATIONS[@]}" -gt 0 ]]; then + echo " Recommendations:" + for rec in "${AI_RECOMMENDATIONS[@]}"; do + echo " > $rec" + done + echo "" + fi + + # Step 5: Post review comment + if [[ "$AI_AVAILABLE" == "true" ]]; then + REVIEW_HEADER="## AI Code Quality Review - PR #$pr_id" + else + REVIEW_HEADER="## Code Quality Review - PR #$pr_id (keyword-based)" + fi + + REVIEW_BODY="$REVIEW_HEADER + +### Scores +| Dimension | Score | Max | +|-----------|-------|-----| +| Code Quality | $SCORE_QUALITY | 25 | +| Security | $SCORE_SECURITY | 25 | +| Performance | $SCORE_PERFORMANCE | 25 | +| Maintainability | $SCORE_MAINTAINABILITY | 25 | +| **Total** | **$TOTAL_SCORE** | **100** | + +### Issues Found" + + if [[ ${#ISSUES_FOUND[@]} -gt 0 ]]; then + for issue in "${ISSUES_FOUND[@]}"; do + REVIEW_BODY+=$'\n'"- $issue" + done + else + REVIEW_BODY+=$'\n'"No issues found." + fi + + if [[ "${#AI_POSITIVE[@]}" -gt 0 ]]; then + REVIEW_BODY+=$'\n'$'\n'"### Positive Notes" + for note in "${AI_POSITIVE[@]}"; do + REVIEW_BODY+=$'\n'"- $note" + done + fi + + if [[ "${#AI_RECOMMENDATIONS[@]}" -gt 0 ]]; then + REVIEW_BODY+=$'\n'$'\n'"### Recommendations" + for rec in "${AI_RECOMMENDATIONS[@]}"; do + REVIEW_BODY+=$'\n'"- $rec" + done + fi + + REVIEW_BODY+=" + +### Verdict +$(if [[ $TOTAL_SCORE -ge $THRESHOLD ]]; then echo "**PASS** - Score $TOTAL_SCORE >= threshold $THRESHOLD. Ready to merge."; else echo "**FAIL** - Score $TOTAL_SCORE < threshold $THRESHOLD. Please address the issues above."; fi) + +--- +*Auto-reviewed by gitlink-cli code-quality-gatekeeper workflow (skill: gitlink-code-review)*" + + log_step "Posting review comment..." + REVIEW_RESULT=$(gl_run api POST "/$OWNER/$REPO/pulls/$pr_id/reviews" \ + --body "{\"body\": $(echo "$REVIEW_BODY" | jq -Rs .), \"event\": \"$(if [[ $TOTAL_SCORE -ge $THRESHOLD ]]; then echo "APPROVE"; else echo "COMMENT"; fi)\"}" 2>&1) || true + + if [[ "$(json_ok "$REVIEW_RESULT")" == "true" ]]; then + log_ok "Review posted" + else + log_warn "Review post may have failed (review API might not be available)" + fi + + # Step 6: Check CI status (API may not be available) + log_step "Checking CI build status..." + CI_JSON=$(gl_run ci +builds --owner "$OWNER" --repo "$REPO") + CI_COUNT=$(echo "$CI_JSON" | jq '.data.builds // .data | length' 2>/dev/null || echo "0") + CI_PASSED=true + + if [[ "$CI_COUNT" -gt 0 ]] && [[ "$CI_COUNT" != "null" ]]; then + for i in $(seq 0 $((CI_COUNT - 1))); do + CI_STATUS=$(echo "$CI_JSON" | jq -r ".data.builds[$i].status // .data.builds[$i].state // .data[$i].status // .data[$i].state // \"unknown\"") + CI_NAME=$(echo "$CI_JSON" | jq -r ".data.builds[$i].name // .data[$i].name // \"build\"") + if [[ "$CI_STATUS" != "success" && "$CI_STATUS" != "passed" && "$CI_STATUS" != "completed" ]]; then + CI_PASSED=false + log_warn "CI '$CI_NAME' status: $CI_STATUS" + else + log_ok "CI '$CI_NAME' status: $CI_STATUS" + fi + done + else + log_info "No CI builds found" + fi + + # Step 7: Auto-merge if quality passes + if [[ $TOTAL_SCORE -ge $THRESHOLD && "$CI_PASSED" == "true" ]]; then + log_step "Quality score $TOTAL_SCORE >= $THRESHOLD and CI passed" + if [[ "$DRY_RUN" == "true" ]]; then + log_warn "[DRY RUN] Would auto-merge PR #$pr_id" + else + log_step "Auto-merging PR #$pr_id..." + MERGE_RESULT=$(gl_run pr +merge --owner "$OWNER" --repo "$REPO" --id "$pr_id" --method merge 2>&1) || true + if [[ "$(json_ok "$MERGE_RESULT")" == "true" ]]; then + log_ok "PR #$pr_id merged successfully!" + else + log_err "Auto-merge failed: $(json_error "$MERGE_RESULT")" + fi + fi + else + log_warn "PR #$pr_id not auto-merged (score: $TOTAL_SCORE, threshold: $THRESHOLD, CI passed: $CI_PASSED)" + fi + + echo "" + return 0 +} + +# ── Main ───────────────────────────────────────────────────────────── +log_title "Code Quality Gatekeeper" + +if [[ -n "$PR_ID" ]]; then + # Review specific PR + review_pr "$PR_ID" +else + # Review all open PRs + log_step "Fetching open PRs..." + PRS_JSON=$(gl_check pr +list --owner "$OWNER" --repo "$REPO" --state open --limit 50) + PR_COUNT=$(echo "$PRS_JSON" | jq '.data.issues | length') + log_ok "Found $PR_COUNT open PRs" + + if [[ "$PR_COUNT" -eq 0 ]]; then + log_info "No open PRs to review" + exit 0 + fi + + REVIEWED=0 + PASSED=0 + FAILED=0 + + for i in $(seq 0 $((PR_COUNT - 1))); do + pid=$(echo "$PRS_JSON" | jq -r ".data.issues[$i].pull_request_number // .data.issues[$i].id // empty") + [[ -z "$pid" ]] && continue + review_pr "$pid" + ((REVIEWED++)) + done + + log_title "Gatekeeper Summary" + echo " PRs Reviewed: $REVIEWED" + echo " Threshold: $THRESHOLD" +fi diff --git a/workflows/03-project-init.sh b/workflows/03-project-init.sh new file mode 100644 index 00000000..a76e550b --- /dev/null +++ b/workflows/03-project-init.sh @@ -0,0 +1,347 @@ +#!/usr/bin/env bash +# ───────────────────────────────────────────────────────────────────── +# Scenario 3: One-Click Project Initialization +# Flow: Input description → Create repo → README/LICENSE/CI → Issues → Release +# +# Commands/Skills chained: +# 1. repo +create -- create repository +# 2. wiki +create -- create README wiki page +# 3. wiki +create -- create CONTRIBUTING guide +# 4. issue +create -- create initial issues +# 5. branch +protect -- protect default branch +# 6. release +create -- create initial release +# ───────────────────────────────────────────────────────────────────── + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +source "$SCRIPT_DIR/lib/common.sh" + +usage() { + echo "Usage: $0 --owner OWNER --name REPO_NAME --description DESC [--lang LANG] [--private] [--dry-run]" + echo "" + echo " --owner OWNER Repository owner (org or user)" + echo " --name REPO_NAME Repository name" + echo " --description DESC Repository description" + echo " --lang LANG Primary language: go|python|node|java (default: go)" + echo " --private Make repository private" + echo " --dry-run Preview actions without executing" + exit 1 +} + +LANG="go" +DRY_RUN=false +OWNER="" +REPO_NAME="" +DESCRIPTION="" +PRIVATE="false" + +while [[ $# -gt 0 ]]; do + case "$1" in + --owner) OWNER="$2"; shift 2 ;; + --name) REPO_NAME="$2"; shift 2 ;; + --description) DESCRIPTION="$2"; shift 2 ;; + --lang) LANG="$2"; shift 2 ;; + --private) PRIVATE="true"; shift ;; + --dry-run) DRY_RUN="true"; shift ;; + --help|-h) usage ;; + *) log_err "Unknown arg: $1"; usage ;; + esac +done + +if [[ -z "$OWNER" || -z "$REPO_NAME" || -z "$DESCRIPTION" ]]; then + log_err "Missing required parameters: --owner, --name, --description" + usage +fi + +check_auth + +# ───────────────────────────────────────────────────────────────────── +log_title "Project Initialization: $OWNER/$REPO_NAME" +# ───────────────────────────────────────────────────────────────────── +echo " Owner: $OWNER" +echo " Name: $REPO_NAME" +echo " Description: $DESCRIPTION" +echo " Language: $LANG" +echo " Private: $PRIVATE" +divider + +# ── Step 1: Create Repository ──────────────────────────────────────── +log_step "Creating repository..." +REPO_RESULT=$(gl_check repo +create --owner "$OWNER" --name "$REPO_NAME" --description "$DESCRIPTION" --private "$PRIVATE") +REPO_ID=$(echo "$REPO_RESULT" | jq -r '.data.id // .data.project_id // empty') +log_ok "Repository created: $OWNER/$REPO_NAME (id: $REPO_ID)" + +# ── Step 2: Create README ──────────────────────────────────────────── +log_step "Creating README wiki page..." + +# Wait for repo to be fully initialized +sleep 2 + +README_CONTENT="# $REPO_NAME + +$DESCRIPTION + +## Getting Started + +### Prerequisites" + +case "$LANG" in + go) + README_CONTENT+=" + +- Go 1.21+ +- Git + +### Installation + +\`\`\`bash +git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git +cd $REPO_NAME +go mod download +go build ./... +\`\`\` + +### Usage + +\`\`\`bash +go run main.go +\`\`\` + +### Testing + +\`\`\`bash +go test ./... +\`\`\`" + ;; + python) + README_CONTENT+=" + +- Python 3.9+ +- pip + +### Installation + +\`\`\`bash +git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git +cd $REPO_NAME +pip install -r requirements.txt +\`\`\` + +### Usage + +\`\`\`bash +python main.py +\`\`\` + +### Testing + +\`\`\`bash +pytest +\`\`\`" + ;; + node) + README_CONTENT+=" + +- Node.js 18+ +- npm or yarn + +### Installation + +\`\`\`bash +git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git +cd $REPO_NAME +npm install +\`\`\` + +### Usage + +\`\`\`bash +npm start +\`\`\` + +### Testing + +\`\`\`bash +npm test +\`\`\`" + ;; + java) + README_CONTENT+=" + +- JDK 17+ +- Maven 3.8+ + +### Installation + +\`\`\`bash +git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git +cd $REPO_NAME +mvn clean install +\`\`\` + +### Usage + +\`\`\`bash +mvn exec:java +\`\`\` + +### Testing + +\`\`\`bash +mvn test +\`\`\`" + ;; +esac + +README_CONTENT+=" + +## Contributing + +See [CONTRIBUTING](./CONTRIBUTING) for guidelines. + +## License + +This project is licensed under the MIT License." + +# Retry wiki creation up to 3 times +WIKI_OK=false +for attempt in 1 2 3; do + WIKI_RESULT=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO_NAME" \ + --title "README" --content "$README_CONTENT" 2>&1) || true + if [[ "$(json_ok "$WIKI_RESULT")" == "true" ]]; then + log_ok "README created" + WIKI_OK=true + break + fi + [[ $attempt -lt 3 ]] && sleep 2 +done +[[ "$WIKI_OK" == "false" ]] && log_warn "README wiki creation may have failed" + +# ── Step 3: Create CONTRIBUTING Guide ──────────────────────────────── +log_step "Creating CONTRIBUTING guide..." + +CONTRIB_CONTENT="# Contributing to $REPO_NAME + +Thank you for your interest in contributing! + +## How to Contribute + +1. Fork the repository +2. Create a feature branch: \`git checkout -b feature/my-feature\` +3. Make your changes +4. Run tests to ensure everything passes +5. Commit your changes: \`git commit -m 'feat: add my feature'\` +6. Push to your fork: \`git push origin feature/my-feature\` +7. Create a Pull Request + +## Code Style + +- Follow the existing code style +- Write meaningful commit messages +- Add tests for new features +- Update documentation as needed + +## Reporting Issues + +- Use the issue tracker +- Include reproduction steps +- Include environment details + +## Code of Conduct + +Please be respectful and constructive in all interactions." + +# Retry wiki creation up to 3 times +WIKI_OK=false +for attempt in 1 2 3; do + WIKI_CONTRIB=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO_NAME" \ + --title "CONTRIBUTING" --content "$CONTRIB_CONTENT" 2>&1) || true + if [[ "$(json_ok "$WIKI_CONTRIB")" == "true" ]]; then + log_ok "CONTRIBUTING guide created" + WIKI_OK=true + break + fi + [[ $attempt -lt 3 ]] && sleep 2 +done +[[ "$WIKI_OK" == "false" ]] && log_warn "CONTRIBUTING wiki creation may have failed" + +# ── Step 4: Create Initial Issues ──────────────────────────────────── +log_step "Creating initial issues..." + +ISSUES_TO_CREATE=( + "Setup CI/CD Pipeline|Configure continuous integration and deployment for the project.|feature" + "Write Project Documentation|Complete project documentation including API docs and architecture guide.|documentation" + "Setup Code Review Process|Establish code review guidelines and automation.|enhancement" + "Add Unit Tests|Add comprehensive unit test coverage for core modules.|enhancement" + "Setup Dependency Management|Configure dependency scanning and updates.|security" +) + +for entry in "${ISSUES_TO_CREATE[@]}"; do + IFS='|' read -r title body label <<< "$entry" + ISSUE_RESULT=$(gl_run issue +create --owner "$OWNER" --repo "$REPO_NAME" \ + --title "$title" --body "$body" 2>&1) || true + ISSUE_NUM=$(echo "$ISSUE_RESULT" | jq -r '.data.id // .data.number // empty') + if [[ -n "$ISSUE_NUM" ]]; then + # Add label + gl_run issue +label-add --owner "$OWNER" --repo "$REPO_NAME" --number "$ISSUE_NUM" --labels "$label" > /dev/null 2>&1 || true + log_ok "Issue created: #$ISSUE_NUM - $title" + else + log_warn "Issue creation may have failed: $title" + fi +done + +# ── Step 5: Protect Default Branch ─────────────────────────────────── +log_step "Protecting master branch..." +PROTECT_RESULT=$(gl_run branch +protect --owner "$OWNER" --repo "$REPO_NAME" --branch master 2>&1) || true + +if [[ "$(json_ok "$PROTECT_RESULT")" == "true" ]]; then + log_ok "Branch 'master' protected" +else + log_warn "Branch protection may have failed (may require admin permissions)" +fi + +# ── Step 6: Create Initial Release ─────────────────────────────────── +log_step "Creating initial release v0.1.0..." + +RELEASE_BODY="# v0.1.0 - Initial Release + +## What's New +- Project initialized with $LANG template +- README and CONTRIBUTING guides created +- CI/CD pipeline issues filed +- Branch protection enabled + +## Next Steps +- [ ] Setup CI/CD pipeline +- [ ] Write comprehensive tests +- [ ] Complete documentation +- [ ] First feature implementation + +--- +*Auto-initialized by gitlink-cli project-init workflow*" + +RELEASE_RESULT=$(gl_run release +create --owner "$OWNER" --repo "$REPO_NAME" \ + --tag "v0.1.0" --name "Initial Release" --body "$RELEASE_BODY" 2>&1) || true + +if [[ "$(json_ok "$RELEASE_RESULT")" == "true" ]]; then + log_ok "Release v0.1.0 created" +else + log_warn "Release creation may have failed" +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Project Initialization Complete" +# ───────────────────────────────────────────────────────────────────── + +echo -e "${GREEN}Created:${NC}" +echo " Repository: $OWNER/$REPO_NAME" +echo " README: Wiki page" +echo " CONTRIBUTING: Wiki page" +echo " Issues: ${#ISSUES_TO_CREATE[@]} initial issues" +echo " Branch: master (protected)" +echo " Release: v0.1.0" +echo "" +echo -e "${CYAN}Next steps:${NC}" +echo " 1. Clone: git clone https://gitlink.org.cn/$OWNER/$REPO_NAME.git" +echo " 2. Add your code and push" +echo " 3. Setup CI/CD by closing the first issue" +echo "" diff --git a/workflows/04-multi-repo-collab.sh b/workflows/04-multi-repo-collab.sh new file mode 100644 index 00000000..5da9add9 --- /dev/null +++ b/workflows/04-multi-repo-collab.sh @@ -0,0 +1,262 @@ +#!/usr/bin/env bash +# ───────────────────────────────────────────────────────────────────── +# Scenario 4: Multi-Repo Collaboration +# Flow: Cross-repo issue tracking → PR status dashboard → Coordinated release +# +# Commands/Skills chained: +# 1. repo +list -- list all repos in org +# 2. issue +list -- fetch issues from each repo +# 3. pr +list -- fetch PRs from each repo +# 4. pr +view -- get PR details for dashboard +# 5. release +list -- check release status across repos +# 6. release +create -- coordinated release +# 7. Generate HTML dashboard +# ───────────────────────────────────────────────────────────────────── + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +source "$SCRIPT_DIR/lib/common.sh" + +usage() { + echo "Usage: $0 --org ORG [--repos REPO1,REPO2,...] [--release TAG] [--dry-run]" + echo "" + echo " --org ORG Organization name" + echo " --repos REPO1,REPO2 Comma-separated repo list (default: all repos in org)" + echo " --release TAG Coordinated release tag to create" + echo " --output FILE Output HTML dashboard file (default: dashboard.html)" + echo " --dry-run Preview actions without executing" + exit 1 +} + +DRY_RUN=false +ORG="" +REPOS="" +RELEASE_TAG="" +OUTPUT_FILE="dashboard.html" + +while [[ $# -gt 0 ]]; do + case "$1" in + --org) ORG="$2"; shift 2 ;; + --repos) REPOS="$2"; shift 2 ;; + --release) RELEASE_TAG="$2"; shift 2 ;; + --output) OUTPUT_FILE="$2"; shift 2 ;; + --dry-run) DRY_RUN="true"; shift ;; + --help|-h) usage ;; + *) log_err "Unknown arg: $1"; usage ;; + esac +done + +if [[ -z "$ORG" ]]; then + log_err "Missing required parameter: --org" + usage +fi + +check_auth + +# ── Step 1: List Repositories ──────────────────────────────────────── +log_title "Multi-Repo Collaboration Dashboard" + +log_step "Fetching repositories for org: $ORG..." +REPOS_JSON=$(gl_check repo +list --owner "$ORG" --limit 100) +ALL_REPO_COUNT=$(echo "$REPOS_JSON" | jq '.data.projects | length') +log_ok "Found $ALL_REPO_COUNT repositories" + +# Filter repos if --repos specified +REPO_LIST=() +if [[ -n "$REPOS" ]]; then + IFS=',' read -ra REPO_LIST <<< "$REPOS" + log_info "Filtering to specified repos: ${REPO_LIST[*]}" +else + for i in $(seq 0 $((ALL_REPO_COUNT - 1))); do + RNAME=$(echo "$REPOS_JSON" | jq -r ".data.projects[$i].name // .data.projects[$i].identifier // empty") + [[ -n "$RNAME" ]] && REPO_LIST+=("$RNAME") + done +fi + +log_ok "Will process ${#REPO_LIST[@]} repositories" + +# ── Step 2-3: Collect Issues and PRs from each repo ────────────────── +log_title "Collecting Data Across Repos" + +# Data arrays for dashboard +DASHBOARD_ROWS="" +TOTAL_ISSUES=0 +TOTAL_PRS=0 +TOTAL_OPEN_ISSUES=0 +TOTAL_OPEN_PRS=0 + +for repo in "${REPO_LIST[@]}"; do + divider + log_step "Processing $ORG/$repo..." + + # Fetch open issues + ISSUES_JSON=$(gl_run issue +list --owner "$ORG" --repo "$repo" --state open --limit 50) + OPEN_ISSUES=$(echo "$ISSUES_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0") + + # Fetch closed issues (recent) + CLOSED_JSON=$(gl_run issue +list --owner "$ORG" --repo "$repo" --state closed --limit 50) + CLOSED_ISSUES=$(echo "$CLOSED_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0") + + # Fetch open PRs + PRS_JSON=$(gl_run pr +list --owner "$ORG" --repo "$repo" --state open --limit 50) + OPEN_PRS=$(echo "$PRS_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0") + + # Fetch merged PRs (recent) + MERGED_JSON=$(gl_run pr +list --owner "$ORG" --repo "$repo" --state merged --limit 50) + MERGED_PRS=$(echo "$MERGED_JSON" | jq '.data.issues | length' 2>/dev/null || echo "0") + + # Fetch latest release + RELEASES_JSON=$(gl_run release +list --owner "$ORG" --repo "$repo" --limit 1) + LATEST_RELEASE=$(echo "$RELEASES_JSON" | jq -r '.data.releases[0].tag_name // .data.releases[0].name // "none"' 2>/dev/null) + + log_ok "$repo: Issues(open:$OPEN_ISSUES closed:$CLOSED_ISSUES) PRs(open:$OPEN_PRS merged:$MERGED_PRS) Release:$LATEST_RELEASE" + + # Get PR details for open PRs + PR_DETAILS="" + if [[ "$OPEN_PRS" -gt 0 ]] && [[ "$OPEN_PRS" != "null" ]]; then + for pi in $(seq 0 $((OPEN_PRS > 5 ? 4 : OPEN_PRS - 1))); do + PR_ID=$(echo "$PRS_JSON" | jq -r ".data.issues[$pi].pull_request_number // .data.issues[$pi].id // empty") + PR_TITLE=$(echo "$PRS_JSON" | jq -r ".data.issues[$pi].subject // .data.issues[$pi].name // \"\"") + PR_AUTHOR=$(echo "$PRS_JSON" | jq -r ".data.issues[$pi].author_login // .data.issues[$pi].author.login // \"unknown\"") + PR_DETAILS+="#$PR_ID$PR_TITLE@$PR_AUTHORopen" + done + fi + + # Accumulate totals + TOTAL_ISSUES=$((TOTAL_ISSUES + OPEN_ISSUES + CLOSED_ISSUES)) + TOTAL_OPEN_ISSUES=$((TOTAL_OPEN_ISSUES + OPEN_ISSUES)) + TOTAL_PRS=$((TOTAL_PRS + OPEN_PRS + MERGED_PRS)) + TOTAL_OPEN_PRS=$((TOTAL_OPEN_PRS + OPEN_PRS)) + + # Add to dashboard rows + STATUS_COLOR="green" + [[ "$OPEN_ISSUES" -gt 10 ]] && STATUS_COLOR="orange" + [[ "$OPEN_ISSUES" -gt 20 ]] && STATUS_COLOR="red" + + DASHBOARD_ROWS+=" + $repo + $OPEN_ISSUES + $CLOSED_ISSUES + $OPEN_PRS + $MERGED_PRS + $LATEST_RELEASE + $( + [[ "$OPEN_ISSUES" -le 5 ]] && echo "Healthy" || \ + [[ "$OPEN_ISSUES" -le 15 ]] && echo "Moderate" || echo "Needs Attention" + ) + " +done + +# ── Step 4: Generate HTML Dashboard ────────────────────────────────── +log_title "Generating Dashboard" + +log_step "Creating HTML dashboard..." + +cat > "$OUTPUT_FILE" << 'HTMLEOF' + + + + + +Multi-Repo Collaboration Dashboard + + + +
+

Multi-Repo Collaboration Dashboard

+

Generated: TIMESTAMP_PLACEHOLDER | Organization: ORG_PLACEHOLDER

+
+

Total Repos

REPOS_COUNT
+

Open Issues

OPEN_ISSUES_COUNT
+

Open PRs

OPEN_PRS_COUNT
+

Total Activity

TOTAL_ACTIVITY
+
+ + +DASHBOARD_ROWS_PLACEHOLDER +
RepositoryOpen IssuesClosed IssuesOpen PRsMerged PRsLatest ReleaseHealth
+
+ + +HTMLEOF + +# Replace placeholders using temp file approach for complex content +TEMP_HTML=$(mktemp) +TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S') + +while IFS= read -r line; do + line="${line//TIMESTAMP_PLACEHOLDER/$TIMESTAMP}" + line="${line//ORG_PLACEHOLDER/$ORG}" + line="${line//REPOS_COUNT/${#REPO_LIST[@]}}" + line="${line//OPEN_ISSUES_COUNT/$TOTAL_OPEN_ISSUES}" + line="${line//OPEN_PRS_COUNT/$TOTAL_OPEN_PRS}" + line="${line//TOTAL_ACTIVITY/$TOTAL_ISSUES}" + line="${line//DASHBOARD_ROWS_PLACEHOLDER/$DASHBOARD_ROWS}" + echo "$line" +done < "$OUTPUT_FILE" > "$TEMP_HTML" + +mv "$TEMP_HTML" "$OUTPUT_FILE" + +log_ok "Dashboard saved to: $OUTPUT_FILE" + +# ── Step 5: Coordinated Release ────────────────────────────────────── +if [[ -n "$RELEASE_TAG" ]]; then + log_title "Coordinated Release: $RELEASE_TAG" + + RELEASE_BODY="# Coordinated Release: $RELEASE_TAG + +## Repos Included +" + + for repo in "${REPO_LIST[@]}"; do + log_step "Creating release for $ORG/$repo..." + RELEASE_BODY+="- $ORG/$repo"$'\n' + + RELEASE_RESULT=$(gl_run release +create --owner "$ORG" --repo "$repo" \ + --tag "$RELEASE_TAG" --name "Release $RELEASE_TAG" \ + --body "Coordinated release $RELEASE_TAG for $ORG/$repo" 2>&1) || true + + if [[ "$(json_ok "$RELEASE_RESULT")" == "true" ]]; then + log_ok "Release $RELEASE_TAG created for $repo" + else + log_warn "Release creation failed for $repo (tag may already exist)" + fi + done + + RELEASE_BODY+=$'\n'"---"$'\n'"*Coordinated release by gitlink-cli multi-repo-collab workflow*" +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Multi-Repo Dashboard Complete" +# ───────────────────────────────────────────────────────────────────── + +echo -e "${GREEN}Summary:${NC}" +echo " Repos processed: ${#REPO_LIST[@]}" +echo " Total issues: $TOTAL_ISSUES (open: $TOTAL_OPEN_ISSUES)" +echo " Total PRs: $TOTAL_PRS (open: $TOTAL_OPEN_PRS)" +echo " Dashboard: $OUTPUT_FILE" +[[ -n "$RELEASE_TAG" ]] && echo " Coordinated release: $RELEASE_TAG" +echo "" +echo -e "${CYAN}Open dashboard:${NC}" +echo " xdg-open $OUTPUT_FILE # Linux" +echo " open $OUTPUT_FILE # macOS" +echo "" diff --git a/workflows/05-contributor-growth.sh b/workflows/05-contributor-growth.sh new file mode 100644 index 00000000..3c0d8d1a --- /dev/null +++ b/workflows/05-contributor-growth.sh @@ -0,0 +1,398 @@ +#!/usr/bin/env bash +# ───────────────────────────────────────────────────────────────────── +# Scenario 5: Contributor Growth System +# Flow: Collect data → Calculate scores → Generate HTML → Publish Wiki +# +# Scoring (based on available shortcuts): +# - Issue created: 15% weight (issue +list) +# - PR merged: 25% weight (pr +list state=merged) +# - Code changes: 30% weight (pr +files) +# - Issue comments: 15% weight (issue +view) +# - Team member: 15% weight (repo +members) +# ───────────────────────────────────────────────────────────────────── + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +source "$SCRIPT_DIR/lib/common.sh" + +usage() { + echo "Usage: $0 --owner OWNER --repo REPO [--sample N] [--dry-run]" + echo "" + echo " --owner OWNER Repository owner" + echo " --repo REPO Repository name" + echo " --sample N Sample N PRs for code stats (default: 10)" + echo " --dry-run Preview actions without executing" + exit 1 +} + +DRY_RUN=false +OWNER="" +REPO="" +SAMPLE_SIZE=10 + +while [[ $# -gt 0 ]]; do + case "$1" in + --owner) OWNER="$2"; shift 2 ;; + --repo) REPO="$2"; shift 2 ;; + --sample) SAMPLE_SIZE="$2"; shift 2 ;; + --dry-run) DRY_RUN="true"; shift ;; + --help|-h) usage ;; + *) log_err "Unknown arg: $1"; usage ;; + esac +done + +check_auth +require_owner_repo + +REPORT_FILE="contrib-report-$OWNER-$REPO.html" + +# ───────────────────────────────────────────────────────────────────── +log_title "Contributor Growth System: $OWNER/$REPO" +# ───────────────────────────────────────────────────────────────────── + +# ── Step 1: Collect Data ───────────────────────────────────────────── +log_step "Collecting data..." + +ISSUES_OPEN=$(gl_check issue +list --owner "$OWNER" --repo "$REPO" --state open --limit 100) +ISSUES_CLOSED=$(gl_run issue +list --owner "$OWNER" --repo "$REPO" --state closed --limit 100) +OPEN_COUNT=$(echo "$ISSUES_OPEN" | jq '.data.issues | length' 2>/dev/null || echo "0") +CLOSED_COUNT=$(echo "$ISSUES_CLOSED" | jq '.data.issues | length' 2>/dev/null || echo "0") + +PRS_MERGED=$(gl_run pr +list --owner "$OWNER" --repo "$REPO" --state merged --limit 100) +PR_MERGED_COUNT=$(echo "$PRS_MERGED" | jq '.data.issues | length' 2>/dev/null || echo "0") + +MEMBERS=$(gl_run repo +members --owner "$OWNER" --repo "$REPO" --limit 100) +MEMBER_COUNT=$(echo "$MEMBERS" | jq '.data.members | length' 2>/dev/null || echo "0") + +log_ok "Issues(open:$OPEN_COUNT closed:$CLOSED_COUNT) PRs(merged:$PR_MERGED_COUNT) Members:$MEMBER_COUNT" + +# ── Step 2: Build Contributor Data ─────────────────────────────────── +log_step "Building contributor profiles..." + +declare -A C_ISSUES C_MERGED C_ADDITIONS C_DELETIONS C_COMMENTS C_IS_MEMBER + +# Issues +for i in $(seq 0 $((OPEN_COUNT - 1))); do + A=$(echo "$ISSUES_OPEN" | jq -r ".data.issues[$i].author.login // empty") + [[ -n "$A" ]] && C_ISSUES["$A"]=$(( ${C_ISSUES["$A"]:-0} + 1 )) +done +for i in $(seq 0 $((CLOSED_COUNT - 1))); do + A=$(echo "$ISSUES_CLOSED" | jq -r ".data.issues[$i].author.login // empty") + [[ -n "$A" ]] && C_ISSUES["$A"]=$(( ${C_ISSUES["$A"]:-0} + 1 )) +done + +# Merged PRs + code stats +log_step "Analyzing PR code changes (sampling $SAMPLE_SIZE)..." +PR_SAMPLE=$((PR_MERGED_COUNT > SAMPLE_SIZE ? SAMPLE_SIZE : PR_MERGED_COUNT)) +for i in $(seq 0 $((PR_MERGED_COUNT - 1))); do + A=$(echo "$PRS_MERGED" | jq -r ".data.issues[$i].author_login // empty") + ID=$(echo "$PRS_MERGED" | jq -r ".data.issues[$i].pull_request_id // .data.issues[$i].id // empty") + [[ -n "$A" ]] && C_MERGED["$A"]=$(( ${C_MERGED["$A"]:-0} + 1 )) + if [[ $i -lt $PR_SAMPLE ]] && [[ -n "$ID" ]]; then + FILES=$(gl_run pr +files --owner "$OWNER" --repo "$REPO" --id "$ID" 2>&1) + ADD=$(echo "$FILES" | jq -r '[.data.files[].addition // 0] | add // 0' 2>/dev/null || echo "0") + DEL=$(echo "$FILES" | jq -r '[.data.files[].deletion // 0] | add // 0' 2>/dev/null || echo "0") + [[ -n "$A" ]] && C_ADDITIONS["$A"]=$(( ${C_ADDITIONS["$A"]:-0} + ADD )) + [[ -n "$A" ]] && C_DELETIONS["$A"]=$(( ${C_DELETIONS["$A"]:-0} + DEL )) + fi +done + +# Members +for i in $(seq 0 $((MEMBER_COUNT - 1))); do + L=$(echo "$MEMBERS" | jq -r ".data.members[$i].login // empty") + [[ -n "$L" ]] && C_IS_MEMBER["$L"]="yes" +done + +# Comments (sample) +log_step "Sampling issue comments..." +for i in $(seq 0 $((OPEN_COUNT > 10 ? 9 : OPEN_COUNT - 1))); do + ID=$(echo "$ISSUES_OPEN" | jq -r ".data.issues[$i].id // empty") + [[ -z "$ID" ]] && continue + DETAIL=$(gl_run issue +view --owner "$OWNER" --repo "$REPO" --number "$ID" 2>&1) + C=$(echo "$DETAIL" | jq -r '.data.comment_journals_count // 0' 2>/dev/null || echo "0") + if [[ "$C" -gt 0 ]]; then + A=$(echo "$ISSUES_OPEN" | jq -r ".data.issues[$i].author.login // empty") + [[ -n "$A" ]] && C_COMMENTS["$A"]=$(( ${C_COMMENTS["$A"]:-0} + C )) + fi +done + +# ── Step 3: Calculate Scores ───────────────────────────────────────── +log_step "Calculating scores..." + +declare -A SCORES +ALL_USERS=() +for user in "${!C_ISSUES[@]}" "${!C_MERGED[@]}" "${!C_COMMENTS[@]}"; do + [[ -n "$user" ]] && ALL_USERS+=("$user") +done +ALL_USERS=($(printf '%s\n' "${ALL_USERS[@]}" | sort -u)) + +MAX_ISSUES=0; MAX_MERGED=0; MAX_LINES=0; MAX_COMMENTS=0 +for user in "${ALL_USERS[@]}"; do + [[ ${C_ISSUES[$user]:-0} -gt $MAX_ISSUES ]] && MAX_ISSUES=${C_ISSUES[$user]} + [[ ${C_MERGED[$user]:-0} -gt $MAX_MERGED ]] && MAX_MERGED=${C_MERGED[$user]} + LINES=$(( ${C_ADDITIONS[$user]:-0} + ${C_DELETIONS[$user]:-0} )) + [[ $LINES -gt $MAX_LINES ]] && MAX_LINES=$LINES + [[ ${C_COMMENTS[$user]:-0} -gt $MAX_COMMENTS ]] && MAX_COMMENTS=${C_COMMENTS[$user]} +done + +for user in "${ALL_USERS[@]}"; do + SCORE=$(awk -v iss="${C_ISSUES[$user]:-0}" -v mi="$MAX_ISSUES" \ + -v mer="${C_MERGED[$user]:-0}" -v mm="$MAX_MERGED" \ + -v lin="$(( ${C_ADDITIONS[$user]:-0} + ${C_DELETIONS[$user]:-0} ))" -v ml="$MAX_LINES" \ + -v com="${C_COMMENTS[$user]:-0}" -v mc="$MAX_COMMENTS" \ + -v mem="${C_IS_MEMBER[$user]:-no}" \ + 'BEGIN { + ni=(mi>0)?iss/mi:0; nm=(mm>0)?mer/mm:0; nl=(ml>0)?lin/ml:0; nc=(mc>0)?com/mc:0; ms=(mem=="yes")?1:0; + printf "%.1f", (ni*15+nm*25+nl*30+nc*15+ms*15) + }') + SCORES["$user"]="$SCORE" +done + +# ── Step 4: Display Rankings ───────────────────────────────────────── +log_title "Contributor Rankings" +echo "" +printf " ${BOLD}%-4s %-18s %-8s %-8s %-12s %-10s %-8s %s${NC}\n" "Rank" "Contributor" "Issues" "Merged" "+/- Lines" "Comments" "Score" "Badge" +echo " ──── ─────────────────── ──────── ──────── ──────────── ────────── ──────── ─────────────" + +TEMP=$(mktemp) +for u in "${!SCORES[@]}"; do echo "${SCORES[$u]} $u" >> "$TEMP"; done + +RANK=1 +sort -rn "$TEMP" | while read -r score user; do + iss=${C_ISSUES[$user]:-0}; mer=${C_MERGED[$user]:-0} + add=${C_ADDITIONS[$user]:-0}; del=${C_DELETIONS[$user]:-0} + com=${C_COMMENTS[$user]:-0}; si=${score%.*} + if [[ $si -ge 80 ]]; then B="Champion" + elif [[ $si -ge 60 ]]; then B="Core Contributor" + elif [[ $si -ge 40 ]]; then B="Active Contributor" + elif [[ $si -ge 20 ]]; then B="Contributor" + else B="Newcomer" + fi + printf " %-4d %-18s %-8d %-8d +%-6d/-%-4d %-10d %-8s %s\n" "$RANK" "$user" "$iss" "$mer" "$add" "$del" "$com" "$score" "$B" + RANK=$((RANK + 1)) +done +rm -f "$TEMP" + +# ── Step 5: Generate HTML Report ───────────────────────────────────── +log_title "Generating HTML Report" + +# Build JSON data for charts +PIE_DATA="" +TABLE_ROWS="" +RANK=1 + +TEMP2=$(mktemp) +for u in "${!SCORES[@]}"; do echo "${SCORES[$u]} $u" >> "$TEMP2"; done + +sort -rn "$TEMP2" | while read -r score user; do + iss=${C_ISSUES[$user]:-0}; mer=${C_MERGED[$user]:-0} + add=${C_ADDITIONS[$user]:-0}; del=${C_DELETIONS[$user]:-0} + lin=$((add + del)); com=${C_COMMENTS[$user]:-0} + si=${score%.*} + if [[ $si -ge 80 ]]; then B="Champion" + elif [[ $si -ge 60 ]]; then B="Core Contributor" + elif [[ $si -ge 40 ]]; then B="Active Contributor" + elif [[ $si -ge 20 ]]; then B="Contributor" + else B="Newcomer" + fi + # Output as CSV for processing + echo "$RANK|$user|$iss|$mer|$lin|$com|$score|$B|$add|$del" + RANK=$((RANK + 1)) +done > "$TEMP2.csv" +rm -f "$TEMP2" + +# Generate HTML +cat > "$REPORT_FILE" << 'HTMLHEAD' + + + + + + Contributor Report + + + + +
+
+

Contributor Report

+HTMLHEAD + +echo "

$OWNER/$REPO - Team Contribution Analysis

" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" + +# Stats cards +TOTAL_ISSUES=$((OPEN_COUNT + CLOSED_COUNT)) +echo "
" >> "$REPORT_FILE" +echo "
${#SCORES[@]}
Contributors
" >> "$REPORT_FILE" +echo "
$TOTAL_ISSUES
Total Issues
" >> "$REPORT_FILE" +echo "
$PR_MERGED_COUNT
Merged PRs
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" + +# Pie chart +echo "
" >> "$REPORT_FILE" +echo "

Score Distribution

" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" + +# Rankings table +echo "
" >> "$REPORT_FILE" +echo "

Detailed Rankings

" >> "$REPORT_FILE" +echo " " >> "$REPORT_FILE" + +PIE_JSON="" +while IFS='|' read -r rank user iss mer lin com score badge add del; do + cls=""; [[ $rank -eq 1 ]] && cls=" rank-1" + [[ $rank -eq 2 ]] && cls=" rank-2" + [[ $rank -eq 3 ]] && cls=" rank-3" + + badge_cls="newcomer" + [[ "$badge" == "Champion" ]] && badge_cls="champion" + [[ "$badge" == "Core Contributor" ]] && badge_cls="core" + [[ "$badge" == "Active Contributor" ]] && badge_cls="active" + [[ "$badge" == "Contributor" ]] && badge_cls="contributor" + + echo " " >> "$REPORT_FILE" + PIE_JSON+="{value: $score, name: '$user'}," +done < "$TEMP2.csv" + +echo "
RankContributorIssuesMerged PRsCode LinesCommentsScoreBadge
$rank@$user$iss$mer$lin$com$score$badge
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" + +# Weight info +echo "
" >> "$REPORT_FILE" +echo "

Scoring System (AHP Weights)

" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" +echo "
Issues Created15%
" >> "$REPORT_FILE" +echo "
PRs Merged25%
" >> "$REPORT_FILE" +echo "
Code Changes30%
" >> "$REPORT_FILE" +echo "
Issue Comments15%
" >> "$REPORT_FILE" +echo "
Team Member15%
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" +echo "
" >> "$REPORT_FILE" + +# JavaScript +cat >> "$REPORT_FILE" << HTMLFOOT +
+ + + +HTMLFOOT + +rm -f "$TEMP2.csv" +log_ok "HTML report: $REPORT_FILE" + +# ── Step 6: Publish to Wiki ────────────────────────────────────────── +log_step "Publishing to Wiki..." + +WIKI_CONTENT="# Contributor Leaderboard - $OWNER/$REPO + +*Generated: $(date '+%Y-%m-%d %H:%M')* + +## Scoring System + +| Dimension | Weight | Source | +|-----------|--------|--------| +| Issues Created | 15% | \`issue +list\` | +| PRs Merged | 25% | \`pr +list state=merged\` | +| Code Changes | 30% | \`pr +files\` | +| Issue Comments | 15% | \`issue +view\` | +| Team Member | 15% | \`repo +members\` | + +## Rankings + +| Rank | Contributor | Issues | Merged | Lines | Comments | Score | Badge | +|------|-------------|--------|--------|-------|----------|-------|-------| +" + +TEMP3=$(mktemp) +for u in "${!SCORES[@]}"; do echo "${SCORES[$u]} $u" >> "$TEMP3"; done +RANK=1 +sort -rn "$TEMP3" | while read -r score user; do + iss=${C_ISSUES[$user]:-0}; mer=${C_MERGED[$user]:-0} + lin=$(( ${C_ADDITIONS[$user]:-0} + ${C_DELETIONS[$user]:-0} )) + com=${C_COMMENTS[$user]:-0}; si=${score%.*} + if [[ $si -ge 80 ]]; then B="Champion" + elif [[ $si -ge 60 ]]; then B="Core" + elif [[ $si -ge 40 ]]; then B="Active" + elif [[ $si -ge 20 ]]; then B="Contributor" + else B="Newcomer" + fi + echo "| $RANK | @$user | $iss | $mer | $lin | $com | $score | $B |" + RANK=$((RANK + 1)) +done > "$TEMP3.rows" +WIKI_CONTENT+=$(cat "$TEMP3.rows") +rm -f "$TEMP3" "$TEMP3.rows" + +WIKI_CONTENT+=" + +--- +*Auto-generated by gitlink-cli*" + +# Use timestamp to avoid title conflicts with cached deletions +WIKI_TITLE="Contributor Leaderboard $(date '+%Y-%m-%d')" +WIKI_RESULT=$(gl_run wiki +create --owner "$OWNER" --repo "$REPO" \ + --title "$WIKI_TITLE" --content "$WIKI_CONTENT" 2>&1) || true + +if [[ "$(json_ok "$WIKI_RESULT")" == "true" ]]; then + log_ok "Published to Wiki: $WIKI_TITLE" +else + log_warn "Wiki publish failed" +fi + +# ───────────────────────────────────────────────────────────────────── +log_title "Complete" +echo " Contributors: ${#SCORES[@]}" +echo " HTML Report: $REPORT_FILE" +echo "" diff --git a/workflows/README.md b/workflows/README.md new file mode 100644 index 00000000..1596eae8 --- /dev/null +++ b/workflows/README.md @@ -0,0 +1,515 @@ +# GitLink CLI 工作流自动化 + +5 个端到端自动化场景,将 gitlink-cli 的 shortcut 命令串联成完整工作流,解决实际项目管理痛点。 + +--- + +## 环境准备 + +### 1. 安装 gitlink-cli + +```bash +# 确认已安装 +gitlink-cli version + +# 未安装则从项目根目录构建 +cd /home/kevin/gitlink-cli +make build +``` + +### 2. 安装 jq + +脚本用 `jq` 解析 CLI 返回的 JSON。 + +```bash +# Ubuntu/Debian +sudo apt-get install -y jq + +# macOS +brew install jq +``` + +### 3. 登录认证 + +```bash +# 方式一:交互式登录(推荐) +gitlink-cli auth login + +# 方式二:环境变量 +export GITLINK_TOKEN="你的私人令牌" +# 令牌获取:https://gitlink.org.cn → 个人设置 → 私人令牌 + +# 验证 +gitlink-cli auth status +# 应显示:✓ Logged in as 用户名 +``` + +### 4. 验证环境 + +```bash +# 测试 JSON 输出是否正常 +gitlink-cli issue +list --owner zzx-coder --repo gitlink-cli --state open --limit 3 --format json | jq '.ok' +# 应输出:true +``` + +--- + +## 五个场景 + +| # | 场景 | 脚本 | 串联命令 | 解决什么问题 | +|---|------|------|---------|-------------| +| 1 | 社区运营自动化 | `01-community-ops.sh` | 7 个 | Issue 积压无人处理、周报手写、Release Notes 手动整理 | +| 2 | 代码质量看门人 | `02-code-quality-gatekeeper.sh` | 7 个 | PR 审查效率低、质量标准不统一、AI 代码审查(基于 gitlink-code-review skill) | +| 3 | 项目一键初始化 | `03-project-init.sh` | 6 个 | 新建项目重复劳动多、Issue/文档/分支保护手动配 | +| 4 | 多仓库协同 | `04-multi-repo-collab.sh` | 7 个 | 跨仓库状态分散、缺乏统一视图 | +| 5 | 贡献者成长体系 | `05-contributor-growth.sh` | 6 个 | 贡献者活跃度难追踪、缺乏激励机制 | + +--- + +## 场景一:社区运营自动化 + +**脚本**: `01-community-ops.sh` + +### 解决什么问题 + +新 Issue 没人分类、不知道谁该负责、社区周报手写、发版时才手忙脚乱写 Release Notes。 + +### 工作流程 + +``` +issue +list → 读取所有 open Issue + ↓ +按关键词分类: Bug / Feature / Question / Docs + ↓ +issue +label-add → 自动打标签 + ↓ +repo +members → 获取仓库成员列表 +issue +update → 轮询分配负责人 + ↓ +pr +list → 统计本周合并的 PR +issue +list → 统计本周关闭的 Issue + ↓ +wiki +create → 发布社区周报到 Wiki + ↓ +release +create → 自动生成 Release Notes +``` + +### 串联的命令 + +| 步骤 | 命令 | 作用 | +|------|------|------| +| 1 | `issue +list` | 获取所有 open Issue | +| 2 | `issue +label-add` | 按分类打标签 (bug/feature/question/documentation) | +| 3 | `repo +members` | 获取仓库成员列表 | +| 4 | `issue +update` | 给 Bug/Feature Issue 分配负责人 | +| 5 | `pr +list` | 统计本周合并的 PR | +| 6 | `wiki +create` | 发布社区周报 | +| 7 | `release +create` | 自动生成 Release Notes | + +### 输出有什么用 + +- **标签分类**: 仓库 Issue 页面可按标签筛选,一目了然 +- **负责人分配**: 每个 Issue 有明确负责人,避免互相推诿 +- **Wiki 周报**: 团队和社区用户可在 Wiki 查看每周进展 +- **Release Notes**: 发版时无需手动整理变更 + +### 运行 + +```bash +bash workflows/01-community-ops.sh --owner 你的组织 --repo 你的仓库 + +# 示例 +bash workflows/01-community-ops.sh --owner zzx-coder --repo gitlink-cli +``` + +--- + +## 场景二:代码质量看门人 + +**脚本**: `02-code-quality-gatekeeper.sh` + +### 解决什么问题 + +PR 审查是代码质量的核心环节,但人工审查耗时且标准不统一。这个工作流加载 **gitlink-code-review skill** 的审查方法论,用 AI (Claude) 对 PR 进行四维度代码审查,自动打分评级,达标后自动合并。 + +### 工作流程 + +``` +pr +list → 获取所有 open PR + ↓ +pr +view → 读取 PR 详情 +pr +files → 获取变更文件列表 +pr +diff → 获取代码差异 + ↓ +加载 gitlink-code-review skill: + - 审查维度与检查项 + - 评分标准 (90-100 优秀, 75-89 良好, ...) + - 问题严重级别 (CRITICAL/HIGH/MEDIUM/LOW) + ↓ +┌─────────────────────────────────────┐ +│ AI 代码审查 (Claude + Skill) │ +│ 四维度评分 (各 0-25,总分 100): │ +│ - 代码质量: 复杂度、命名、注释 │ +│ - 安全性: SQL注入、XSS、敏感信息 │ +│ - 性能: 循环效率、资源泄漏、N+1 │ +│ - 可维护性: 重复、职责单一、耦合 │ +│ │ +│ 输出: │ +│ - 结构化问题清单 (severity+file+ │ +│ rule+description+suggestion) │ +│ - 优秀实践 (positive_notes) │ +│ - 改进建议 (recommendations) │ +│ - 总分 + PASS/FAIL │ +└─────────────────────────────────────┘ + ↓ +api POST /reviews → 发布审查评论到 PR + ↓ +ci +builds → 检查 CI 构建状态 + ↓ +pr +merge → 分数 >= 阈值 且 CI 通过 → 自动合并 +``` + +### AI 审查示例输出(基于 gitlink-code-review skill) + +``` +Overall Score: 88 / 100 +Code Quality: 23 / 25 +Security: 25 / 25 +Performance: 20 / 25 +Maintainability: 20 / 25 + +Issues Found: + - [LOW] quality: 条目格式说明中 PR 条目用 (@作者) 带括号,commit 条目用 (作者名) 不带 @ 前缀 + → 统一格式规范,建议 commit 条目也使用 (@作者) 格式 + - [LOW] maintainability: 示例中贡献者列表变更但完整变更日志链接仍指向旧仓库 + → 将变更日志链接中的 OWNER 也更新为与示例贡献者一致 + +Positive Notes: + + 变更目的清晰,所有文件的修改一致地贯彻了需求,无遗漏 + + 变更范围合理,仅修改文档和示例,不涉及代码逻辑变更,风险极低 + +Recommendations: + > 统一 PR 条目和 commit 条目的作者标注格式 + > 在 collect-data.md 中补充 author 字段为空时的降级处理说明 +``` + +### 串联的命令 + +| 步骤 | 命令 | 作用 | +|------|------|------| +| 1 | `pr +list` | 获取 open PR 列表 | +| 2 | `pr +view` | 读取 PR 详情(标题、作者、状态) | +| 3 | `pr +files` | 获取变更文件列表 | +| 4 | `pr +diff` | 获取代码差异内容 | +| 5 | `gitlink-code-review` | 加载 skill 的审查维度、检查项、评分标准 | +| 6 | `claude -p` | AI 按 skill 方法论进行四维度代码审查 | +| 7 | `api POST .../reviews` | 将审查评论发布到 PR | +| 8 | `pr +merge` | 质量分 >= 阈值且 CI 通过时自动合并 | + +### 输出有什么用 + +- **结构化评分**: 每个 PR 有 0-100 的质量评分,团队可设定统一合并门槛 +- **AI 问题清单**: 自动列出安全隐患、性能问题、代码质量问题,人工审查时重点关注 +- **PR 评论**: 审查结果直接评论在 PR 上,作者和审查者都能看到 +- **自动合并**: 高质量 PR 无需人工点击 + +### 运行 + +```bash +# 审查所有 open PR +bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 + +# 审查指定 PR +bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 --pr-id 42 + +# 自定义质量阈值(默认 80) +bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 --threshold 70 + +# 预览模式(不实际合并) +bash workflows/02-code-quality-gatekeeper.sh --owner 你的组织 --repo 你的仓库 --dry-run + +# 示例 +bash workflows/02-code-quality-gatekeeper.sh --owner zzx-coder --repo gitlink-cli --pr-id 20 +``` + +--- + +## 场景三:项目一键初始化 + +**脚本**: `03-project-init.sh` + +### 解决什么问题 + +新建项目仓库后,还要手动创建 README、写 CONTRIBUTING 指南、创建初始 Issue、设置分支保护、打初始 Release。一条命令搞定全部。 + +### 工作流程 + +``` +repo +create → 创建仓库 + ↓ +wiki +create → 生成 README(根据语言模板) +wiki +create → 生成 CONTRIBUTING 贡献指南 + ↓ +issue +create × 5 → 创建初始待办 Issue: + - 搭建 CI/CD 流水线 + - 编写项目文档 + - 建立代码审查流程 + - 添加单元测试 + - 配置依赖管理 + ↓ +branch +protect → 保护 master 分支 + ↓ +release +create → 创建 v0.1.0 初始版本 +``` + +### 串联的命令 + +| 步骤 | 命令 | 作用 | +|------|------|------| +| 1 | `repo +create` | 创建新仓库 | +| 2 | `wiki +create` | 生成 README(支持 Go/Python/Node/Java) | +| 3 | `wiki +create` | 生成 CONTRIBUTING 贡献指南 | +| 4 | `issue +create` | 创建 5 个初始 Issue 并打标签 | +| 5 | `branch +protect` | 设置 master 分支保护规则 | +| 6 | `release +create` | 创建 v0.1.0 初始版本 | + +### 输出有什么用 + +- **开箱即用**: 新成员克隆后就知道怎么构建、测试、贡献 +- **标准化 Issue**: 关键待办已创建好,团队可直接认领 +- **分支保护**: 防止直接 push 到 master,强制走 PR 流程 +- **首个 Release**: 项目从创建之初就有版本管理 + +### 运行 + +```bash +# Go 项目 +bash workflows/03-project-init.sh --owner 你的组织 --name my-go-app --description "我的Go应用" --lang go + +# Python 项目(私有) +bash workflows/03-project-init.sh --owner 你的组织 --name my-api --description "REST API服务" --lang python --private + +# Node.js 项目 +bash workflows/03-project-init.sh --owner 你的组织 --name my-web --description "Web前端" --lang node + +# Java 项目 +bash workflows/03-project-init.sh --owner 你的组织 --name my-service --description "微服务" --lang java +``` + +--- + +## 场景四:多仓库协同 + +**脚本**: `04-multi-repo-collab.sh` + +### 解决什么问题 + +当一个组织有多个仓库时,管理者需要逐个查看每个仓库的 Issue、PR、Release 状态。这个工作流汇总所有仓库数据,生成一个 HTML 仪表盘,并支持一键协调发版。 + +### 工作流程 + +``` +repo +list → 列出组织下所有仓库 + ↓ +对每个仓库: + issue +list → 获取 open/closed Issue + pr +list → 获取 open/merged PR + release +list → 获取最新 Release + ↓ +生成 HTML 仪表盘: + - 总览卡片: 仓库数、Open Issue、Open PR、总活动量 + - 详情表格: 每个仓库的 Issue/PR/Release 状态 + - 健康度: Healthy / Moderate / Needs Attention + ↓ +(可选)release +create → 一键为所有仓库创建同一版本号的 Release +``` + +### 串联的命令 + +| 步骤 | 命令 | 作用 | +|------|------|------| +| 1 | `repo +list` | 列出组织下所有仓库 | +| 2 | `issue +list` | 获取每个仓库的 Issue 数据 | +| 3 | `pr +list` | 获取每个仓库的 PR 数据 | +| 4 | `release +list` | 获取每个仓库的最新 Release | +| 5 | 生成 HTML | 输出可视化仪表盘 | +| 6 | `release +create` | (可选)协调发版 | + +### 输出有什么用 + +- **统一视图**: 一个 HTML 页面看到组织所有仓库的健康状态 +- **健康度预警**: Open Issue 超 10 个标橙色,超 20 个标红色 +- **协调发版**: 多个关联仓库需要同步发版时,一条命令搞定 +- **可分享**: HTML 文件可直接发给团队或部署到内部网站 + +### 运行 + +```bash +# 扫描组织下所有仓库 +bash workflows/04-multi-repo-collab.sh --org 你的组织 + +# 只看指定仓库 +bash workflows/04-multi-repo-collab.sh --org 你的组织 --repos "repo-a,repo-b,repo-c" + +# 生成仪表盘 + 协调发版 +bash workflows/04-multi-repo-collab.sh --org 你的组织 --release v2.0.0 + +# 自定义输出文件 +bash workflows/04-multi-repo-collab.sh --org 你的组织 --output my-dashboard.html + +# 示例 +bash workflows/04-multi-repo-collab.sh --org zzx-coder +``` + +运行后在当前目录生成 `dashboard.html`,浏览器打开即可查看。 + +--- + +## 场景五:贡献者成长体系 + +**脚本**: `05-contributor-growth.sh` + +### 解决什么问题 + +开源项目需要激励贡献者持续参与,但很难量化每个人的贡献。这个工作流自动追踪贡献者活动,计算贡献分数,生成排行榜,并可选自动颁发成就徽章。 + +### 工作流程 + +``` +contrib +report → 生成带 ECharts 饼图的 HTML 贡献报告 + ↓ +issue +list → 统计 Issue 活动 +pr +list → 统计 PR 活动 +api GET /contributors → 获取提交数等 API 统计 + ↓ +计算贡献分数 (AHP 权重模型): + - PR 被合并: 10 分 + - 提交 PR: 5 分 + - 创建/解决 Issue: 3 分 + - 代码提交: 2 分 + ↓ +评定等级: + Champion (冠军) >= 50 分 + Core Contributor >= 30 分 + Active Contributor >= 15 分 + Contributor >= 5 分 + Newcomer (新人) < 5 分 + ↓ +(可选)issue +create → 自动创建徽章颁发 Issue + ↓ +wiki +create → 发布排行榜到 Wiki +``` + +### 串联的命令 + +| 步骤 | 命令 | 作用 | +|------|------|------| +| 1 | `contrib +report` | 生成 HTML 贡献报告(带 ECharts 图表) | +| 2 | `issue +list` | 统计 open/closed Issue 活动 | +| 3 | `pr +list` | 统计 open/merged PR 活动 | +| 4 | `api GET /contributors` | 获取 API 级别的贡献者统计 | +| 5 | `issue +create` | (可选)自动颁发成就徽章 | +| 6 | `wiki +create` | 发布排行榜到 Wiki | + +### 输出有什么用 + +- **HTML 贡献报告**: 可视化展示贡献分布,适合团队会议演示 +- **贡献排行榜**: 量化每个人的贡献,公开透明 +- **Wiki 排行榜**: 永久保存,贡献者可随时查看排名 +- **徽章激励**: 通过 Issue 颁发徽章,增强成就感和归属感 + +### 运行 + +```bash +# 基本运行 +bash workflows/05-contributor-growth.sh --owner 你的组织 --repo 你的仓库 + +# 自定义统计周期(默认 30 天) +bash workflows/05-contributor-growth.sh --owner 你的组织 --repo 你的仓库 --period 90 + +# 启用自动颁发徽章 +bash workflows/05-contributor-growth.sh --owner 你的组织 --repo 你的仓库 --award + +# 示例 +bash workflows/05-contributor-growth.sh --owner zzx-coder --repo gitlink-cli --award +``` + +--- + +## 通用参数 + +| 参数 | 说明 | +|------|------| +| `--owner OWNER` | 仓库所属组织或用户(在 git 仓库内可自动检测) | +| `--repo REPO` | 仓库名称(在 git 仓库内可自动检测) | +| `--dry-run` | 预览模式,不实际执行写操作 | +| `--help` | 显示帮助信息 | + +--- + +## 项目结构 + +``` +workflows/ +├── lib/ +│ └── common.sh # 共享工具库(认证、JSON解析、CLI封装、日志) +├── 01-community-ops.sh # 场景一:社区运营自动化 +├── 02-code-quality-gatekeeper.sh # 场景二:代码质量看门人(AI审查) +├── 03-project-init.sh # 场景三:项目一键初始化 +├── 04-multi-repo-collab.sh # 场景四:多仓库协同 +├── 05-contributor-growth.sh # 场景五:贡献者成长体系 +├── test.sh # 测试套件 +└── README.md # 本文档 +``` + +### 共享库 `lib/common.sh` + +所有脚本共享的基础设施: + +| 函数 | 作用 | +|------|------| +| `check_auth` | 检查认证状态(环境变量 或 CLI 登录) | +| `gl_run` | CLI 封装,自动追加 `--format json` | +| `gl_check` | CLI 封装 + JSON 格式校验 + ok 字段检查 | +| `json_ok` / `json_get` / `json_error` | JSON 解析工具 | +| `detect_owner_repo` | 从 git remote 自动检测 owner/repo | +| `log_step` / `log_ok` / `log_warn` / `log_err` | 彩色日志输出 | + +--- + +## 涉及的 Skill + +工作流通过加载 Skill 的审查方法论、分类规则和模板来指导 AI 分析: + +| Skill | 被哪个场景使用 | 作用 | +|-------|-------------|------| +| `gitlink-code-review` | 场景 2 | **已集成** — 加载审查维度、检查项、评分标准,指导 AI 代码审查 | +| `gitlink-issue-triage` | 场景 1 | Issue 分类规则(关键词匹配、优先级判定) | +| `gitlink-changelog` | 场景 1 | Release Notes 生成模板(按类型分组、贡献者列表) | +| `gitlink-health` | 场景 4 | 项目健康度评分体系(100 分制) | +| `gitlink-onboard` | 场景 5 | 新人引导和 Issue 推荐规则 | +| `gitlink-workflow` | 全部 | 基础工作流编排(Issue 分类、PR 审查、发版、Sprint 报告) | + +> 场景 2 的 `gitlink-code-review` skill 已完整集成:脚本运行时自动从 `skills/gitlink-code-review/SKILL.md` 加载审查维度和检查项,传给 AI 作为审查方法论。其他场景使用关键词匹配等规则引擎。 + +--- + +## 测试 + +```bash +# 运行测试套件(使用真实 GitLink 仓库验证) +bash workflows/test.sh + +# 指定仓库 +bash workflows/test.sh zzx-coder gitlink-cli +``` + +测试覆盖: +- 认证状态检查 +- CLI JSON 输出格式验证 +- 数据字段提取(issue/PR/repo/release/member/contributor) +- PR 文件和 Diff 内容解析 +- Issue/PR View 接口 +- Wiki / Label 列表接口 +- common.sh 工具函数 +- 所有脚本语法校验 diff --git a/workflows/lib/common.sh b/workflows/lib/common.sh new file mode 100644 index 00000000..cc3727af --- /dev/null +++ b/workflows/lib/common.sh @@ -0,0 +1,164 @@ +#!/usr/bin/env bash +# Common utilities for gitlink-cli workflow scripts + +set -euo pipefail +# Trap SIGPIPE to prevent premature exit when piping through head/truncate +trap '' PIPE + +# Ensure jq is available (WinGet installs to non-default PATH on Windows) +if ! command -v jq &>/dev/null; then + for d in "$LOCALAPPDATA/Microsoft/WinGet/Links" "$HOME/AppData/Local/Microsoft/WinGet/Links"; do + [[ -d "$d" ]] && export PATH="$d:$PATH" + done +fi + +# Colors +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +CYAN='\033[0;36m' +BOLD='\033[1m' +NC='\033[0m' + +# ── Logging ────────────────────────────────────────────────────────── +log_step() { echo -e "${BLUE}[STEP]${NC} $*"; } +log_ok() { echo -e "${GREEN}[ OK]${NC} $*"; } +log_warn() { echo -e "${YELLOW}[WARN]${NC} $*"; } +log_err() { echo -e "${RED}[ ERR]${NC} $*" >&2; } +log_info() { echo -e "${CYAN}[INFO]${NC} $*"; } +log_title(){ echo -e "\n${BOLD}══════ $* ══════${NC}\n"; } + +# ── Auth Check ─────────────────────────────────────────────────────── +check_auth() { + # Check env var first, then try CLI auth status + if [[ -n "${GITLINK_TOKEN:-}" ]]; then + log_ok "GITLINK_TOKEN is set" + return 0 + fi + local status + status=$(gitlink-cli auth status 2>&1) + if echo "$status" | grep -qi "logged in\|✓"; then + log_ok "Authenticated: $(echo "$status" | sed -n 's/.*as //p' | tr -d '[:space:]')" + return 0 + fi + log_err "Not authenticated. Please login first:" + log_info " gitlink-cli auth login" + log_info " export GITLINK_TOKEN=\"your-private-token\"" + exit 1 +} + +# ── JSON Helpers ───────────────────────────────────────────────────── +# Extract a field from CLI JSON output (Envelope: {ok, data, ...}) +json_ok() { + echo "$1" | jq -r '.ok // false' 2>/dev/null +} + +json_data() { + echo "$1" | jq -r '.data' 2>/dev/null +} + +json_get() { + echo "$1" | jq -r "$2" 2>/dev/null +} + +json_error() { + echo "$1" | jq -r '.error.message // "unknown error"' 2>/dev/null +} + +# ── CLI Wrapper ────────────────────────────────────────────────────── +GL="gitlink-cli" + +gl_run() { + local output + # Always use JSON format for scripting + output=$("$GL" "$@" --format json 2>&1) || true + echo "$output" +} + +gl_check() { + local output + output=$(gl_run "$@") + # Check if output is valid JSON (use here-string to avoid SIGPIPE) + if ! jq empty <<< "$output" 2>/dev/null; then + log_err "Command failed (non-JSON response): $GL $*" + log_err "$output" + return 1 + fi + if [[ "$(json_ok "$output")" != "true" ]]; then + log_err "Command failed: $GL $*" + log_err "$(json_error "$output")" + return 1 + fi + echo "$output" +} + +# ── Owner/Repo Detection ──────────────────────────────────────────── +detect_owner_repo() { + local remote_url + remote_url=$(git remote get-url origin 2>/dev/null || echo "") + if [[ -z "$remote_url" ]]; then + log_err "No git remote 'origin' found. Use --owner and --repo flags." + exit 1 + fi + # Parse gitlink URL patterns + # https://gitlink.org.cn/owner/repo.git or git@gitlink.org.cn:owner/repo.git + if [[ "$remote_url" =~ gitlink\.org\.cn[:/]([^/]+)/([^/.]+) ]]; then + DETECTED_OWNER="${BASH_REMATCH[1]}" + DETECTED_REPO="${BASH_REMATCH[2]}" + else + log_err "Cannot parse owner/repo from remote: $remote_url" + exit 1 + fi +} + +require_owner_repo() { + if [[ -z "${OWNER:-}" || -z "${REPO:-}" ]]; then + detect_owner_repo + OWNER="${OWNER:-$DETECTED_OWNER}" + REPO="${REPO:-$DETECTED_REPO}" + fi + log_info "Using: ${OWNER}/${REPO}" +} + +# ── Confirmation ───────────────────────────────────────────────────── +confirm() { + local msg="${1:-Proceed?}" + if [[ "${DRY_RUN:-false}" == "true" ]]; then + log_warn "[DRY RUN] Would execute: $msg" + return 1 + fi + read -rp "$(echo -e "${YELLOW}$msg [y/N]${NC} ")" answer + [[ "$answer" =~ ^[Yy] ]] +} + +# ── Date Helpers ───────────────────────────────────────────────────── +date_today() { + date +%Y-%m-%d +} + +date_week_ago() { + date -d "7 days ago" +%Y-%m-%d 2>/dev/null || date -v-7d +%Y-%m-%d 2>/dev/null +} + +date_month_ago() { + date -d "30 days ago" +%Y-%m-%d 2>/dev/null || date -v-30d +%Y-%m-%d 2>/dev/null +} + +# ── Parameter Parsing ──────────────────────────────────────────────── +parse_common_args() { + while [[ $# -gt 0 ]]; do + case "$1" in + --owner) OWNER="$2"; shift 2 ;; + --repo) REPO="$2"; shift 2 ;; + --dry-run) DRY_RUN="true"; shift ;; + --help|-h) usage; exit 0 ;; + *) break ;; + esac + done +} + +# ── Section Divider ────────────────────────────────────────────────── +divider() { + echo -e "${CYAN}────────────────────────────────────────────────${NC}" +}