Daily Code Metrics Report - 2026-02-13

[github-actions[bot]]

The codebase currently consists of 808,011 lines of code across 2,915 files, representing steady growth of +3.58% over the past week and +1.65% over the past month. The quality score stands at 49.2/100, with excellent test coverage (2.27:1 test-to-source ratio) but opportunities for improvement in code organization, documentation, and stability.

Key Findings:

• Go dominates the codebase with 412,710 LOC (51.1%), followed by YAML workflows (186,335 LOC, 23.1%) and Markdown documentation (165,324 LOC, 20.5%)
• Test coverage is exceptional at 226.6% (289,379 test LOC vs 127,727 source LOC), showing strong commitment to testing
• High code churn over the past 7 days: 445 commits modified 2,009 source files with +59,323/-15,257 lines (net +44,066 lines)
• Large files remain a concern with 506 files exceeding 500 LOC (17.4% of total files)
• Documentation coverage is low at 1.5/20 points, indicating insufficient documentation relative to code size

📊 Visualizations

LOC Distribution by Language

Analysis: Go is the primary language, accounting for just over half of the codebase. YAML and Markdown combined make up 43.6% of the codebase, reflecting the workflow-centric nature of this repository. JavaScript and TypeScript are minimal at 3,567 LOC combined (0.4%), while Python and Shell scripts provide utility functions.

Top Directories by LOC

Analysis: The docs/ directory contains the most code (895,770 LOC), primarily due to the docs/public/ subdirectory with 844,672 LOC - this appears to include generated or bundled documentation assets. Core application logic resides in pkg/ (428,812 LOC), with workflow compilation in pkg/workflow/ (250,807 LOC) and CLI functionality in pkg/cli/ (124,897 LOC). The .github/workflows/ directory contains 242,044 LOC across 382 workflow definition files.

Quality Score Breakdown

Analysis: The quality score of 49.2/100 breaks down as follows:

• Test Coverage (30/30): Perfect score - test-to-source ratio of 2.27 exceeds recommended target
• Code Organization (7.6/25): Needs improvement - 17.4% of files are large (>500 LOC), indicating opportunities for better modularization
• Documentation (1.5/20): Critical gap - documentation coverage is insufficient for a codebase of this size
• Churn Stability (0/15): High volatility - significant net change of +44K lines in 7 days indicates rapid development but potential instability
• Comment Density (10/10): Excellent - 10.46% comment ratio meets best practices

Test Coverage Analysis

Analysis: With 931 test files containing 289,379 LOC of tests versus 127,727 LOC of source code, the test-to-source ratio is an outstanding 2.266 - well above the recommended range of 0.5-1.0. This indicates comprehensive test coverage, though it's worth noting that this high ratio may include integration tests, workflow tests, or test fixtures that contribute to the line count.

Code Churn (Last 7 Days)

Analysis: The past 7 days saw intense development activity across multiple areas:

• Most active files include scratchpad/dev.md (+1,751 lines), research documentation (+1,385 lines), and numerous test files
• Test file additions dominate the top changes, with compiler_orchestrator_workflow_test.go (+995), markdown_security_scanner_test.go (+891), and compiler_yaml_main_job_test.go (+820)
• The dictation skill saw significant refactoring with +983/-240 lines
• This analysis *excludes .lock.yml files (generated workflow files) to focus on meaningful source code changes

Historical Trends (30 Days)

Analysis: Over the past 30 days, the codebase has shown steady growth from ~795K to 808K LOC (+1.65%). Test coverage percentage has fluctuated significantly, with a dramatic increase of +299.65% over 30 days (from ~0.57 to 2.27), indicating a major shift in testing strategy or methodology. The 7-day trend shows a slight decline of -9.69%, likely due to source LOC growing faster than test LOC in recent days.

📈 Detailed Metrics

Size Metrics

Lines of Code by Language

Language	LOC	% of Total	Change (7d)
Go	412,710	51.1%	⬆️ +3.58%
YAML	186,335	23.1%	⬆️ +3.58%
Markdown	165,324	20.5%	⬆️ +3.58%
JSON	29,583	3.7%	⬆️ +3.58%
Shell	7,935	1.0%	⬆️ +3.58%
JavaScript	1,916	0.2%	⬆️ +3.58%
CSS	1,728	0.2%	⬆️ +3.58%
TypeScript	1,651	0.2%	⬆️ +3.58%
Python	829	0.1%	⬆️ +3.58%
HTML	0	0.0%	-

Total LOC: 808,011 (⬆️ +3.58% 7d, ⬆️ +1.65% 30d)

Lines of Code by Directory (Top 10)

Directory	LOC	% of Total	Files
docs/	895,770	110.9%	194
docs/public/	844,672	104.5%	29
pkg/	428,812	53.1%	1,639
.github/	254,063	31.4%	417
pkg/workflow/	250,807	31.0%	870
.github/workflows/	242,044	30.0%	382
pkg/cli/	124,897	15.5%	558
actions/	114,533	14.2%	447
actions/setup/	113,476	14.0%	442
docs/src/	37,308	4.6%	139

Note: Directory LOC counts are recursive and may overlap with parent directories

Quality Indicators

• Total Files: 2,915 files
• Average File Size: 605 lines
• Large Files (>500 LOC): 506 files (17.4%)
• Function Count: 7,179 functions (Go)
• Comment Lines: 43,180 lines
• Comment Ratio: 10.46%

Test Coverage

• Test Files: 931 files
• Test LOC (test_lines_of_code): 289,379 lines
• Source LOC: 127,727 lines
• Test-to-Source Ratio (test_to_source_ratio): 2.266
• Trend (7d): ⬇️ -9.69%
• Trend (30d): ⬆️ +299.65%

Code Churn (Last 7 Days)

Source Code Churn (Excludes *.lock.yml)

• Files Modified: 2,009 files
• Commits: 445 commits
• Lines Added: +59,323 lines
• Lines Deleted: -15,257 lines
• Net Change: +44,066 lines

Most Active Source Files

1. scratchpad/dev.md: +1,751/-0 lines
2. research/blog-research/BLOG-RESEARCH.md: +1,385/-0 lines
3. pkg/workflow/compiler_orchestrator_workflow_test.go: +995/-0 lines
4. skills/dictation/SKILL.md: +983/-240 lines
5. pkg/workflow/markdown_security_scanner_test.go: +891/-0 lines
6. pkg/workflow/compiler_yaml_main_job_test.go: +820/-0 lines
7. pkg/workflow/compiler_shell_script_test.go: +776/-0 lines
8. pkg/workflow/compiler_safe_output_schema_test.go: +741/-0 lines
9. research/claude-code-release/RESEARCH.md: +683/-0 lines
10. skills/dictation/INSTRUCTIONS.md: +642/-102 lines

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

Data collection in progress - workflow lock file metrics will be available in future reports

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): 199 files
• Compiled Workflows (.lock.yml): 199 files
• Average Workflow Size: 1,216 lines
• Workflow Directory LOC: 242,044 lines

Documentation

• Doc Files (docs/): 70 files
• Doc LOC: 15,060 lines
• Code-to-Docs Ratio: 53.77:1
• Documentation Coverage: 1.86%

Quality Score: 49.2/100

Component Breakdown

• Test Coverage (30%): 30.0/30 points ✅ Excellent test coverage
• Code Organization (25%): 7.6/25 points ⚠️ High percentage of large files
• Documentation (20%): 1.5/20 points ❌ Critical documentation gap
• Churn Stability (15%): 0.0/15 points ⚠️ High volatility in recent changes
• Comment Density (10%): 10.0/10 points ✅ Excellent inline documentation

💡 Insights & Recommendations

1. Address Documentation Gap (Priority: High)

   • Current documentation coverage is only 1.86% (15,060 doc LOC vs 808,011 total LOC)
   • Recommendation: Establish documentation standards and incrementally document core packages (pkg/workflow, pkg/cli, pkg/parser)
   • Target: Increase documentation coverage to at least 5-10% to achieve better quality scores

2. Reduce Large File Count (Priority: Medium)

   • 506 files (17.4%) exceed 500 LOC, indicating potential modularization opportunities
   • Recommendation: Identify and refactor the largest files, especially in pkg/workflow (250,807 LOC across 870 files = avg 288 lines/file)
   • Target: Reduce large file percentage to under 10% by breaking down complex modules

3. Monitor Code Churn Stability (Priority: Medium)

   • Net change of +44,066 lines over 7 days indicates rapid development but may impact stability
   • Recommendation: Consider stabilization periods between major feature additions; increase focus on refactoring vs new features
   • Target: Reduce 7-day net change to under 20,000 lines for better stability scores

4. Investigate docs/public/ Directory Size (Priority: Low)

   • The docs/public/ directory contains 844,672 LOC (104.5% of total codebase), which seems unusually large
   • Recommendation: Verify if this directory contains generated/bundled assets that could be excluded from metrics or stored separately
   • Consider: Exclude generated documentation bundles from LOC metrics if appropriate

5. Maintain Excellent Test Coverage (Priority: Ongoing)

   • Current 2.27:1 test-to-source ratio is exemplary and should be maintained
   • Recent 7-day trend shows slight decline (-9.69%) - ensure new code additions include corresponding tests
   • Continue the strong testing culture demonstrated by 931 test files

---

Report generated by Daily Code Metrics workflow
Historical data: 17 data points spanning 37 days | Last updated: 2026-02-13 11:09 UTC
Workflow run: §21984396669

AI generated by Daily Code Metrics and Trend Tracking Agent

• expires on Feb 16, 2026, 11:11 AM UTC

[github-actions[bot]]

This discussion was automatically closed because it expired on 2026-02-16T11:11:16.418Z.

Closed by Workflow