Daily Code Metrics Report - 2026-03-22

[github-actions[bot]]

The codebase has 674,434 total LOC across 3,508 files as of 2026-03-22. The quality score stands at 73/100 (Good) — a 6-point dip from yesterday's 79, driven primarily by reduced documentation coverage (docs/MD at 39K LOC vs ~42K prior) and continued moderate churn (823 source files modified, 323 commits in 7 days). The positive news: test coverage remains excellent at a 2.26x test-to-source ratio with 951 test files and 313K test LOC.

Go remains the dominant language with 452K LOC (source + tests), representing ~67% of the codebase. The pkg/ directory dominates at 476K LOC across 1,813 files, followed by .github/ (303K), actions/ (152K). Today's churn shows notable new test files and a new expression_validation.go refactoring, consistent with the active workflow compiler development.

📊 Visualizations

LOC Distribution by Language

Go (source + tests) accounts for 452K LOC (~67% of all code), with Markdown documentation at 181K lines. The heavy test LOC (313K) relative to source (139K) reflects a test-first culture with 2.26x coverage ratio.

Top Directories by LOC

pkg/ is the clear center of gravity at 476K LOC, reflecting the library-first architecture. .github/ (303K) and actions/ (152K) together represent 455K LOC — a significant portion devoted to workflow automation infrastructure.

Quality Score Breakdown

Test Coverage scores a perfect 30/30. Code Organization (16/25) reflects 238 large files (>500 LOC, 15.3% ratio) — a perennial challenge at this codebase size. Documentation (13/20) is the biggest opportunity: the code-to-docs ratio of 11.5:1 suggests that API/reference docs haven't kept pace with code growth.

Test Coverage Analysis

Test-to-source ratio is stable at 2.26x across the past 14 days, consistently well above the 2.0x target. With 951 test files and 313K test LOC, the testing infrastructure is robust.

Code Churn (Last 7 Days)

Top churn is led by new specs/artifacts.md (+7,148 lines) and scratchpad/artifacts.md (+5,561 lines) — new specification documents. Active test additions (expression_optimizer_test.go +1,210, top_level_github_app_import_test.go +837) and a schema update (+737/-308 for main_workflow_schema.json) round out the most active files. Lock files (177 modified) are tracked separately and excluded from quality scoring.

Historical Trends (30 Days)

Total LOC shows a modest recalibration today (-29K) from yesterday's 703K peak, reflecting refined measurement methodology (excluding package-lock.json from docs). The quality score trend shows a decline from the 80-81 peak in mid-March (Mar 14-17) back to 73 today — primarily attributable to documentation coverage changes.

📈 Detailed Metrics

Size Metrics

Lines of Code by Language

Language	LOC	% of Total	Files
Go Tests	313,783	46.5%	951
Go Source	138,684	20.6%	604
Markdown	181,363	26.9%	960
Shell	9,594	1.4%	66
JSON	19,248	2.9%	—
JavaScript	3,210	0.5%	13
TypeScript	2,122	0.3%	19
YAML (Workflows)	5,601	0.8%	23
Python	829	0.1%	3

Lines of Code by Directory

Directory	LOC	Notes
pkg/	476,158	Core library (1,813 files)
.github/	303,204	Workflows + compiled .lock.yml
actions/	152,188	Actions (558 files)
docs/ (MD)	39,432	Documentation only
scratchpad/	34,261	Research/drafts (64 files)
skills/	8,206	Skill definitions (26 files)
scripts/	5,835	Build/utility scripts (27 files)
research/	2,241	Research docs (2 files)
cmd/	2,417	CLI entrypoints (10 files)
internal/	74	Internal packages (2 files)

Quality Indicators

• Average Go File Size: 290 lines
• Large Files (>500 LOC): 238 files (15.3% of Go files)
• Function Count: 8,042 functions
• Comment Lines: 47,266 lines (10.44% ratio)
• Comment Density: 10.44%

Test Coverage

• Test Files: 951 files
• Test LOC (test_lines_of_code): 313,783 lines
• Source LOC: 138,684 lines
• Test-to-Source Ratio (test_to_source_ratio): 2.26
• Trend (7d): ➡️ stable (~2.27 all week)
• Trend (30d): ➡️ stable (~2.27-2.30 range)

Code Churn (Last 7 Days)

Source Code Churn (Excludes *.lock.yml)

• Files Modified: 823 files
• Commits: 323 commits
• Lines Added: +47,832 lines
• Lines Deleted: -29,189 lines
• Net Change: +18,643 lines

Most Active Source Files

1. specs/artifacts.md: +7,148/-0 lines
2. scratchpad/artifacts.md: +5,561/-0 lines
3. README.md: +1,003/-477 lines
4. pkg/workflow/expression_optimizer_test.go: +1,210/-0 lines
5. pkg/parser/schemas/main_workflow_schema.json: +737/-308 lines
6. pkg/workflow/top_level_github_app_import_test.go: +837/-0 lines
7. scratchpad/github-mcp-access-control-specification.md: +675/-69 lines
8. .github/workflows/daily-safe-output-integrator.md: +739/-0 lines
9. pkg/workflow/expression_validation.go: +0/-715 lines
10. pkg/cli/compile_integration_test.go: +680/-2 lines

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

• Lock Files Modified: 181 files
• Lines Added: +40,659 lines
• Lines Deleted: -54,871 lines
• Net Change: -14,212 lines

Note: 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): 239 files
• Compiled Workflows (.lock.yml): 177 files
• Regular .yml workflows: 23 files
• Average Workflow Size (.md): 256 lines

Documentation

• Doc Files (docs/): 245 files
• Doc LOC (Markdown only): 39,432 lines
• Code-to-Docs Ratio: 11.47:1
• Trend (7d): ⬇️ reduced from ~41K

Quality Score: 73/100

Component Breakdown

• Test Coverage (30%): 30/30 — excellent, ratio 2.26x
• Code Organization (25%): 16/25 — 238 large files (15.3%)
• Documentation (20%): 13/20 — code-to-docs ratio 11.47:1
• Churn Stability (15%): 5/15 — 823 files/323 commits in 7 days
• Comment Density (10%): 9/10 — 10.44% ratio

💡 Insights & Recommendations

1. Documentation Gap: The code-to-docs ratio of 11.47:1 is the primary driver pulling the quality score below 80. With Go source at 138K LOC and docs at only 39K markdown lines, consider prioritizing API reference documentation for the most active packages (pkg/workflow/, pkg/cli/).

2. Expression Layer Refactoring: The deletion of pkg/workflow/expression_validation.go (715 lines) paired with new test additions (expression_optimizer_test.go +1,210) suggests an ongoing validation/optimization refactor — worth monitoring for completeness in the next 2-3 days.

3. Large File Count Growing: 238 files exceed 500 LOC (up from 211 on Mar 2). As the pkg/ directory grows, consider splitting the largest files — particularly in pkg/workflow/ and pkg/cli/ which contain many large integration test files.

4. Artifacts Specification Added: Two large new files (specs/artifacts.md 7,148 LOC, scratchpad/artifacts.md 5,561 LOC) were added this week. Once finalized, the scratchpad version should be consolidated into specs/ or docs/ to avoid duplication.

5. Lock File Churn Improving: Lock file net change is -14,212 lines (deletions > additions), suggesting workflow consolidation or cleanup — a healthy trend reducing compiled workflow bloat.

---

Report generated by Daily Code Metrics workflow | §23402180617
Historical data: 18 days (2026-03-02 → 2026-03-22) | Generated: 2026-03-22 UTC

AI generated by Daily Code Metrics and Trend Tracking Agent · history

• expires on Mar 25, 2026, 11:46 AM UTC

[github-actions[bot]]

This discussion has been marked as outdated by Daily Code Metrics and Trend Tracking Agent.

A newer discussion is available at Discussion #22417.