[daily-code-metrics] Daily Code Metrics Report - 2026-06-20

[github-actions[bot]]

Key metrics today: LOC: 1,740,168 | Quality score: 77.3/100 (Good) | Test ratio: 1.98 | Active source files (7d): 990

📋 Executive Summary

The gh-aw codebase continues its steady growth, reaching 1.74M lines of code across 11 languages, up +1.5% in 7 days and +13.2% over 30 days. The overall quality score sits at 77.3/100 ("Good"), improving +5.2% week-over-week — driven primarily by stronger churn stability as weekly file activity settled from last week's peak. Test coverage remains the standout strength (full 30/30 points, test:source ratio of 1.98), and documentation scores well (17.4/20) on a healthy 2.87 code-to-docs ratio.

Activity over the last 7 days was substantial but stable: 269 commits touching 990 source files for a net +26,323 lines. The biggest churn concentrates in generated/config artifacts (action_pins.json, safe_outputs_tools.json) and specs/reference docs rather than core Go logic, which signals healthy, low-risk volatility. Separately, *.lock.yml workflow files saw heavy regeneration (253 files, net −723) — correctly excluded from the quality score to avoid generated-file noise.

The two areas with the most headroom are comment density (9.96%, worth only 5.0/10) and code organization (14.8/25). The organization score reflects a rising count of files over 500 LOC, though that specific metric has been measured inconsistently across historical runs and should be read as directional rather than precise.

📊 Key Visualizations

Quality Score Breakdown

Test Coverage is maxed out (100% of weight); Documentation (87%) and Churn Stability (67%) are solid. The clearest upside is Comment Density (50%) and Code Organization (59%) — together ~15 unrealized points.

Historical Trends (30 Days)

LOC rises consistently (7-day MA climbing steadily), while the test:source ratio has drifted down slightly (−4.1% over 30d) as source code grew a touch faster than tests. The quality score has been stable-to-improving across the days where it's been tracked (mid-70s).

💡 Top Recommendations

• Raise comment density — at 9.96% the Go codebase is the largest lever (only 5.0/10). Prioritize doc comments on exported functions in pkg/ (40.9% of LOC) to lift this toward the 20% full-marks threshold.
• Watch the test:source ratio — it slipped −4.1% over 30 days as source grew +13% vs tests +8.4%. Keep adding tests alongside new pkg/ code to hold the ratio above 1.5.
• Address large files — 888 files exceed 500 LOC. Audit and split the largest source modules to improve the Code Organization component (currently 14.8/25).

📈 Detailed Metrics

Size Metrics

Language	LOC	% of Total
YAML	472,337	27.1%
Go Tests	446,760	25.7%
JavaScript (CJS)	265,650	15.3%
Markdown	255,810	14.7%
Go Source	225,170	12.9%
JSON	50,577	2.9%
Shell Scripts	15,142	0.9%
JavaScript	3,966	0.2%
TypeScript	2,808	0.2%
JavaScript (MJS)	998	0.1%
Python	950	0.1%

Directory	LOC	% of Total
pkg/	710,897	40.9%
.github/	581,551	33.4%
actions/	285,961	16.4%
docs/	90,258	5.2%
scratchpad/	35,896	2.1%
scripts/	8,018	0.5%

• Total LOC: 1,740,168 (7d ➡️ +1.5% | 30d ⬆️ +13.2%)
• Total Files: 5,453 | Go files: 2,262

Quality Indicators

• Average Go Source File Size: 238.0 lines
• Large Files (>500 LOC): 888 files (metric measured inconsistently across history — directional only)
• Function Count: 14,175 (7d ⬆️ +2.8% | 30d ⬆️ +19.5%)
• Comment Lines: 66,902 (Go) — Comment Ratio: 9.96% (7d ➡️ +0.1% | 30d ⬇️ −4.0%)

Test Coverage

• Test Files: 1,316
• Test LOC (test_lines_of_code): 446,760 (7d ⬆️ +1.6% | 30d ⬆️ +8.4%)
• Source LOC: 225,170 (7d ⬆️ +2.4% | 30d ⬆️ +13.0%)
• Test-to-Source Ratio (test_to_source_ratio): 1.984 (7d ➡️ −0.8% | 30d ⬇️ −4.1%)

Code Churn (Last 7 Days — source only, excludes *.lock.yml)

• Files Modified: 990
• Commits: 269
• Lines Added: +40,395
• Lines Deleted: −14,072
• Net Change: +26,323

Most Active Source Files:

• pkg/workflow/js/safe_outputs_tools.json (+915/−843)
• specs/otel-observability-spec.md (+862/−779)
• docs/src/content/docs/reference/frontmatter-full.md (+1,225/−118)
• .github/aw/actions-lock.json (+687/−622)
• pkg/actionpins/data/action_pins.json (+687/−622)
• pkg/workflow/data/action_pins.json (+687/−622)

Workflow Lock File Churn (*.lock.yml only)

• Lock Files Modified: 253
• Lines Added: +67,544
• Lines Deleted: −68,267
• Net Change: −723

Lock file churn is reported separately and excluded from quality score calculations to avoid noise from generated files.

Workflow Metrics

• Total Workflow Files (.md) (total_workflows): 347 (7d ➡️ +1.2% | 30d ⬆️ +6.8%)
• Compiled Workflows (.lock.yml): 249
• Average Workflow Size: 233.1 lines

Documentation

• Doc Files (docs/, markdown): 443 (7d ⬆️ +3.7% | 30d ⬆️ +42.4%)
• Doc LOC: 78,395 (7d ⬆️ +3.1% | 30d ⬆️ +18.5%)
• Code-to-Docs Ratio: 2.87:1

Quality Score: 77.3/100 (Good)

Component	Score	Weight
Test Coverage	30.0	/30
Code Organization	14.8	/25
Documentation	17.4	/20
Churn Stability	10.1	/15
Comment Density	5.0	/10

Quality score uses standardized, documented formulas (test:source ratio, large-file share, code-to-docs ratio, source-churn intensity, comment ratio). Churn stability uses source churn only, excluding *.lock.yml.

References: §27880617477

---

Report generated by Daily Code Metrics workflow (executive summary variant)
Historical data: 53 entries | Last updated: 2026-06-20 UTC

Generated by 📊 Daily Code Metrics and Trend Tracking Agent · 312.1 AIC · ⌖ 20 AIC · ⊞ 15.3K · ◷

• expires on Jun 23, 2026, 11:12 AM UTC-08:00

[pelikhan]

/q make sure code generated files like lock.yml are EXCLUDED from report.

actions-lock.json are also code generated.

[github-actions[bot]]

🔧 Pay attention, 007! Q is preparing your gadgets for this discussion comment...