Skip to content

feat: Phase J J3 docs coverage report -- AST-based module docstring scanner, DocsCoverageReport, format_docs_coverage_report, 63 tests - #907

Merged
cschanhniem merged 1 commit into
mainfrom
feat/j3-docs-coverage-report
Jul 10, 2026
Merged

cschanhniem merged 1 commit into
mainfrom
feat/j3-docs-coverage-report

Conversation

@cschanhniem

Copy link
Copy Markdown
Collaborator

Implements J3 from NEXT_100_PR_MAP: docs coverage report.

What

  • docs_coverage.py: AST-based module docstring scanner
  • check_docs_coverage(source_dir) → DocsCoverageReport with total/covered/uncovered counts
  • _has_module_docstring(path): parses AST, gracefully handles SyntaxError
  • _extract_module_name(path, source_dir): converts file path to dotted module name
  • format_docs_coverage_report(report): human-readable with Documented/Undocumented sections
  • exclude_init flag to skip init.py files
  • 63 tests across 5 test classes
  • BASELINE: 7780 → 7843

Why

Shows what is and isn't documented. Undocumented modules are invisible to agents.

Disconfirming pass

  • Pure analysis; no existing modules modified
  • AST parsing doesn't execute code (safe)

…canner, DocsCoverageReport, format_docs_coverage_report, 63 tests (#907)
@cschanhniem
cschanhniem merged commit 76fefe6 into main Jul 10, 2026
1 check failed
cschanhniem added a commit that referenced this pull request Jul 10, 2026
…canner, DocsCoverageReport, format_docs_coverage_report, 63 tests (#907)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant