Daily Code Metrics Report - 2026-03-26

[github-actions[bot]]

The codebase continues its steady growth trajectory, reaching 707,220 total LOC today — up ~604 from yesterday (+0.09%) and +4,522 from one week ago (+0.64%). Go remains the dominant language with 147,574 source lines and a strong 323,743 test lines, yielding an excellent test-to-source ratio of 2.19x. The quality score holds at 73/100 (Good) for the fifth consecutive day, indicating a stable and well-tested codebase with room for improvement in code organization, documentation coverage, and churn stability.

Source code churn remains active with 402 commits and 884 unique files touched in the last 7 days (+8,046 net lines added), driven largely by new test additions and documentation updates. The most notable activity involves the safe-outputs and expression-optimizer subsystems. Workflow lock file churn (+13,713 net lines) is tracked separately and excluded from quality scoring to avoid false signals from generated artifacts.

📊 Visualizations

LOC Distribution by Language

Go (source + tests) accounts for 66% of the codebase, with Markdown documentation making up 26%. Test code (323K LOC) now slightly exceeds source code (148K LOC), reflecting the project's commitment to thorough testing. YAML workflows are minimal at 1,427 LOC as most workflow definitions are stored as .md files.

Top Directories by LOC

pkg/ dominates with 491,664 LOC (majority of business logic), followed by .github/workflows at 299,800 LOC (workflow definitions as Markdown). docs/ has grown to 55,280 LOC — up significantly from 37,420 yesterday, suggesting documentation expansion. actions/ is notably smaller (13K LOC) than prior measurements (160K), indicating a metric calculation adjustment.

Quality Score Breakdown

Overall quality is 73/100 (Good). Test coverage scores a perfect 30/30, while code organization (16/25) and documentation (13/20) have the most room for growth. Churn stability remains low at 5/15 due to high active development, which is expected at this phase.

Test Coverage Analysis

The 2.19x test-to-source ratio is exceptional, far exceeding the 0.5x minimum target. Historically the ratio has been stable between 2.20–2.27x over the past 5 days. Both test files (969) and source files (626) are growing proportionally, indicating disciplined test-driven development practices.

Code Churn (Last 7 Days)

The most churned source files are dominated by deletions from specs/artifacts.md (-7,148) and scratchpad/artifacts.md (-5,561) — cleanup of temporary documentation. New test additions are the primary driver of additions: expression_optimizer_test.go (+1,210), apm_unpack.test.cjs (+980), and compile_integration_test.go (+948). Generated *.lock.yml files are excluded.

Historical Trends (30 Days)

Over the 6-day tracking window, total LOC has grown from 703,420 to 707,220 (+0.54%). The quality score has been stable at 73 for 5 consecutive days (down from 79 on March 21). The test-to-source ratio has declined slightly from 2.27 to 2.19 — still excellent but worth monitoring as new source code is being added faster than tests in recent days.

📈 Detailed Metrics

Size Metrics

Lines of Code by Language

Language	LOC	% of Total	Change vs Yesterday
Go Tests	323,743	45.8%	⬆️ +2,131
Markdown	183,627	26.0%	⬆️ +811
Go Source	147,574	20.9%	⬆️ +1,816
JSON	34,794	4.9%	⬆️ +11
Shell Scripts	9,811	1.4%	➡️ 0
JavaScript	3,278	0.5%	⬆️ +66
TypeScript	2,137	0.3%	➡️ 0
YAML	1,427	0.2%	⬇️ -4,231
Python	829	0.1%	➡️ 0
Total	707,220	100%	⬆️ +604

Lines of Code by Directory

Directory	LOC	% of Total	Files
pkg/	491,664	43.2%	~1,595
.github/workflows	299,800	26.4%	242
docs/	55,280	4.9%	133
scratchpad/	34,406	3.0%	—
actions/	13,033	1.1%	—
skills/	8,206	0.7%	—
scripts/	5,537	0.5%	—
specs/	2,499	0.2%	—
cmd/	2,419	0.2%	—
research/	2,241	0.2%	—
internal/	74	0.0%	—

Quality Indicators

• Average File Size (Go Source): 235.7 lines
• Large Files (>500 LOC): 255 Go files
• Function Count: 8,442 functions
• Comment Lines: 49,215 lines
• Comment Ratio: 10.44% (comment/total Go LOC)
• Total Files: 3,612 files

Test Coverage

• Test Files: 969 files
• Test LOC (test_lines_of_code): 323,743 lines
• Source LOC: 147,574 lines
• Test-to-Source Ratio (test_to_source_ratio): 2.19x
• Trend (7d): ⬇️ -0.08 (2.27 → 2.19)
• Status: Excellent (far exceeds 0.5x minimum, 1.0x recommended)

Code Churn (Last 7 Days)

Source Code Churn (Excludes *.lock.yml)

• Files Modified (unique): 884 files
• Commits: 402 commits
• Lines Added: +55,734 lines
• Lines Deleted: -28,893 lines
• Net Change: +26,841 lines

Most Active Source Files

1. specs/artifacts.md: +0/-7,148 lines (cleanup)
2. scratchpad/artifacts.md: +0/-5,561 lines (cleanup)
3. README.md: +1,052/-478 lines
4. pkg/workflow/expression_optimizer_test.go: +1,210/-0 lines (new tests)
5. actions/setup/js/apm_unpack.test.cjs: +980/-0 lines (new tests)
6. pkg/cli/compile_integration_test.go: +948/-2 lines (new tests)
7. docs/src/content/docs/reference/frontmatter-full.md: +767/-178 lines (docs update)
8. pkg/parser/schemas/main_workflow_schema.json: +687/-220 lines (schema update)
9. actions/setup/js/apm_unpack.cjs: +829/-0 lines (new code)
10. pkg/workflow/safe_outputs_config_generation.go: +164/-588 lines (refactor)

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

• Lock Files Modified (unique): 181 files
• Lines Added: +69,731 lines
• Lines Deleted: -56,018 lines
• Net Change: +13,713 lines

Note: Lock file churn is excluded from quality score calculations.

Workflow Metrics

• Total Workflow Files (.md) (total_workflows): 242 files ⬆️ +1
• Compiled Workflows (.lock.yml): 178 files ➡️
• Non-lock YAML files: 21 files ⬇️ -1
• Average Workflow Size: 257 lines ➡️

Documentation

• Doc Files (docs/): 133 files ⬆️ +2
• Doc LOC: 40,279 lines ⬆️ +2,859 vs yesterday
• Code-to-Docs Ratio: 4.06:1 (source vs docs)
• Trend: Improving (docs growing faster than source)

Quality Score: 73/100

Component Breakdown

Component	Score	Max	%
Test Coverage (30%)	30	30	100%
Code Organization (25%)	16	25	64%
Documentation (20%)	13	20	65%
Churn Stability (15%)	5	15	33%
Comment Density (10%)	9	10	90%
Total	73	100	73%

💡 Insights & Recommendations

1. Reduce large files: 255 Go files exceed 500 LOC. Splitting these would improve the Code Organization score from 16/25 toward the maximum — targeting ≤200 large files could add ~4 points.

2. Monitor test ratio decline: The test-to-source ratio has drifted from 2.27 to 2.19 over 5 days. New source files in actions/setup/js/ were added without proportional test growth. Consider adding test coverage for apm_unpack.cjs (+829 lines, no tests yet visible).

3. Documentation momentum: docs/ grew +2,859 lines today, narrowing the code-to-docs ratio from 3.90 to 4.06. Continuing to expand docs/ would improve the Documentation score (currently 13/20).

4. Expression optimizer cleanup: pkg/workflow/expression_optimizer_test.go has been the most churned test file for several days (+1,210 lines added). The corresponding source expression_validation.go was deleted last week — verify the optimizer implementation is fully tested and stable.

5. Safe outputs config refactor: pkg/workflow/safe_outputs_config_generation.go shows -588 lines (a significant reduction), indicating a refactor. Ensure downstream tests and integration tests have been updated accordingly.

---

Report generated by Daily Code Metrics workflow
Historical data: 6 days | Last updated: 2026-03-26 21:30 UTC

References:

• §23618958816

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

• expires on Mar 29, 2026, 9:40 PM 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 #23280.