Daily Code Metrics Report - 2026-03-27

[github-actions[bot]]

The codebase continues steady growth, reaching 712,686 total LOC today — a +0.77% increase from yesterday (707,220) and +5.7% over the past 6 days. The quality score holds stable at 73/100 (Good), with excellent test coverage (2.19x ratio) remaining the strongest component. The primary areas for improvement remain code organization (large file count trending up to 257 files >500 LOC) and churn stability (high velocity with 972 source files touched in 7 days).

Today's function count reached 8,489 (+47 from yesterday), reflecting active feature development. Source code churn shows 24,883 lines added and only 4,146 deleted in the 7-day window — indicating net positive growth rather than heavy refactoring. Workflow lock files generated significant separate churn (65,930 lines added / 53,200 deleted) but are excluded from quality scoring to avoid noise.

Quality Score: 73/100 — Good

Component	Score	Trend
Test Coverage (30%)	30/30	➡️ Stable
Code Organization (25%)	16/25	⬇️ Large files +2
Documentation (20%)	13/20	➡️ Stable
Churn Stability (15%)	5/15	➡️ Stable (high churn)
Comment Density (10%)	9/10	➡️ Stable

Visualizations

LOC Distribution by Language

Go Tests (324K LOC, 45.5%) and Go Source (148K LOC, 20.8%) dominate the codebase. Markdown documentation at 183K LOC (25.8%) reflects the workflow-heavy nature of this repository. The high test-to-source ratio in Go is a clear indicator of strong testing discipline.

Top Directories by LOC

pkg/ dominates at 492,813 LOC (49.1% of codebase), consistent with a library-heavy architecture. .github/workflows at 299,967 LOC highlights the extensive automation infrastructure. The docs/ directory increased substantially to 55,282 LOC compared to earlier in the week.

Quality Score Breakdown

The score remains locked at 73/100 across all 6 days of history. Test coverage is maxed out at 30/30. The biggest opportunity is Code Organization (16/25) — reducing the count of files over 500 LOC would directly improve this score.

Test Coverage Analysis

With a 2.189x test-to-source ratio (324K test LOC vs 148K source LOC), this codebase significantly exceeds the recommended 1.0x ratio. This is exceptional — every line of source code has over 2 lines of test coverage on average.

Code Churn (Last 7 Days)

The largest churn comes from specs/artifacts.md and scratchpad/artifacts.md (both deleted, 7,148 and 5,561 lines respectively), indicating cleanup of temporary specification documents. New test files dominate additions: pkg/workflow/expression_optimizer_test.go (+1,210), apm_unpack.test.cjs (+980), and pkg/cli/audit_diff_test.go (+695).

Historical Trends (6 Days)

Total LOC shows a clear upward trend from 674K (Mar 22) to 712K (Mar 27) — +5.7% in 6 days. The test-to-source ratio is gradually declining (2.26 → 2.19) as source code grows slightly faster than tests, though still well above healthy levels. Quality score and function count show consistent positive trajectories.

Detailed Metrics

Size Metrics

Lines of Code by Language

Language	LOC	% of Total	Change (vs Mar 26)
Go Source	148,158	20.8%	⬆️ +584 (+0.4%)
Go Tests	324,307	45.5%	⬆️ +564 (+0.2%)
Markdown	183,644	25.8%	⬆️ +17 (+0.01%)
Shell Scripts	9,811	1.4%	➡️ 0%
JSON	34,795	4.9%	⬆️ +1 (0.0%)
YAML Workflows	5,705	0.8%	⬆️ +278 (+5.1%)
TypeScript	2,137	0.3%	➡️ 0%
JavaScript	~3,300	0.5%	➡️ ~0%
Python	829	0.1%	➡️ 0%

Total: 712,686 LOC (+5,466 from Mar 26, +0.77%)

Lines of Code by Directory

Directory	LOC	% of Total
pkg/	492,813	49.1%
.github/workflows	299,967	29.9%
docs/	55,282	5.5%
scratchpad/	34,408	3.4%
actions/	13,033	1.3%
skills/	8,206	0.8%
scripts/	5,537	0.6%
specs/	2,499	0.2%
research/	2,241	0.2%
cmd/	2,419	0.2%

Quality Indicators

• Total Files: 3,618 (+6 from Mar 26)
• Go Source Files: 629 (+3 from Mar 26)
• Go Test Files: 970 (+1 from Mar 26)
• Average File Size (Go): 235.5 LOC
• Large Files (>500 LOC): 257 (+2 from Mar 26) ⬇️
• Function Count: 8,489 (+47 from Mar 26) ⬆️
• Comment Lines: 49,296 (+81 from Mar 26)
• Comment Ratio: 10.44%

Test Coverage

• Test Files: 970
• Test LOC (test_lines_of_code): 324,307 lines
• Source LOC: 148,158 lines
• Test-to-Source Ratio (test_to_source_ratio): 2.189x
• Trend (7d): ⬇️ -0.001 (marginal decrease, still excellent)

Code Churn (Last 7 Days)

Source Code Churn (Excludes *.lock.yml)

• Files Modified: 972 files
• Commits: 358 commits
• Lines Added: +24,883 lines
• Lines Deleted: -4,146 lines
• Net Change: +20,737 lines

Most Active Source Files

Rank	File	Added	Deleted	Total Change
1	specs/artifacts.md	0	7,148	7,148
2	scratchpad/artifacts.md	0	5,561	5,561
3	README.md	1,055	478	1,533
4	pkg/workflow/expression_optimizer_test.go	1,210	0	1,210
5	actions/setup/js/apm_unpack.test.cjs	980	0	980
6	docs/src/content/docs/reference/frontmatter-full.md	767	178	945
7	pkg/parser/schemas/main_workflow_schema.json	638	214	852
8	actions/setup/js/apm_unpack.cjs	829	0	829
9	pkg/workflow/safe_outputs_config_generation.go	164	588	752
10	pkg/cli/audit_diff_test.go	695	0	695

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

• Lock Files Modified: 179 files
• Lines Added: +65,930 lines
• Lines Deleted: -53,200 lines
• Net Change: +12,730 lines

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): 283 files (+41 from Mar 26)
• Compiled Workflows (.lock.yml): 178 files
• Non-lock YAML files: 26 files
• Average Workflow Size: 257 lines

Documentation

• Doc Files (docs/): 133 files
• Doc LOC: 40,281 lines
• Code-to-Docs Ratio: 3.68:1
• Documentation Coverage: Good (ratio < 5:1)

Insights & Recommendations

1. Address growing large file count: 257 files exceed 500 LOC (+2 today, +19 over 6 days). Splitting large files into focused modules would improve the Code Organization score from 16/25 and make the codebase more maintainable.

2. Protect the test ratio: The test-to-source ratio has declined from 2.26 to 2.19 over 6 days as source grows slightly faster than tests. New feature additions like pkg/workflow/qmd.go and pkg/workflow/safe_outputs_config_generation.go should be tracked to ensure test coverage follows.

3. Churn stability opportunity: 972 source files modified in 7 days indicates high velocity development. Consider periodic refactoring sprints to stabilize interfaces and reduce churn — this would improve the Churn Stability score from 5/15 to potentially 10-12/15.

4. Documentation growth positive: The docs/ directory has expanded significantly (37K → 55K LOC) over the week, improving the code-to-docs ratio from 11.5:1 to 3.68:1. This is a major positive trend — continue investing in documentation.

5. Comment density maintained: With 49,296 comment lines at a 10.44% ratio, the codebase stays close to the 10% target. The score of 9/10 reflects healthy inline documentation practice.

---

Report generated by Daily Code Metrics workflow
Historical data: 6 days tracked | Last updated: 2026-03-27 21:50 UTC
Workflow run: §23668326806

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

• expires on Mar 30, 2026, 9:58 PM UTC