[ptr727]

Adds scripts/backlog_metrics.py, a weekly backlog and review-cost report for the cataloged repositories. It prints markdown or minimal HTML to stdout, reads through gh only, and is wired into no workflow, so a server timer can mail it.

The test is tests/test_backlog_metrics.py (unittest, constructed fixtures, no gh call). tests/test_cli_usage.py lists the script under NO_REQUIRED_ARGUMENT, which that test requires of every tracked entry point. scripts/README.md gets a section, since it holds no table of scripts.

Review runs match the run name field, not workflowName: a live read showed name carries "Running Copilot Code Review" and workflowName reads "Copilot".

Verification

• uvx ruff@latest format --check scripts tests -> 57 files already formatted
• uvx ruff@latest check scripts/backlog_metrics.py tests/test_backlog_metrics.py tests/test_cli_usage.py -> All checks passed!
• uvx mypy@latest (pyproject.toml configures mypy and pyright, the hub validator runs mypy) -> Success: no issues found in 65 source files
• python3 tests/test_backlog_metrics.py -> Ran 27 tests ... OK
• python3 tests/test_cli_usage.py -> Ran 16 tests ... OK
• python3 scripts/prose_lint.py --diff <merge-base> -> exit 0, no violations
• python3 scripts/repo_gate.py -> no failing check
• python3 scripts/backlog_metrics.py --bogus -> error: unrecognized arguments: --bogus, exit 2
• Live read-only smoke run against one repository confirmed the table, label line, and billing lines render.

Local strict review ran twice at the frontier tier and is recorded against the final content. Round one fixed the review-run field, the missing UTF-8 decode (now reuses gh_graphql.run_subprocess), a count in test prose, and README wording. Round two fixed the test gaps.

Pre-existing findings, not filed

• scripts/README.md:9: a 43-word sentence in the existing utility list. The opt-in sentence-length check reports it because this change added one word to it.

Decision for the maintainer

The window is >=START with START = today minus N days, as specified. A weekly run therefore counts the boundary day in two consecutive reports. A bounded START..yesterday range would give non-overlapping full days. Not changed here because the brief fixed the >=DATE filters.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

• Source mode: Auto
• Repository: ptr727/ProjectTemplate
• Branch: add-backlog-metrics-report
• File: .coderabbit.yaml
• Commit: be1e374
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Advanced
• Run ID: 6d5f624b-e7b7-477d-abd0-c1c351f0b2c3

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[ptr727]

A recorded local strict-review pass covers head dee2c4d8433f5c35ccd4a994cc6b39849d452397, the content this pull request carries at that commit against develop, and it recorded 14 findings.

[codecov]

Codecov Report

❌ Patch coverage is 98.77301% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 81.60%. Comparing base (20b9d16) to head (be1e374).

Files with missing lines	Patch %	Lines
scripts/backlog_metrics.py	98.77%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3400      +/-   ##
===========================================
+ Coverage    81.33%   81.60%   +0.27%     
===========================================
  Files           18       19       +1     
  Lines        10049    10212     +163     
===========================================
+ Hits          8173     8334     +161     
- Misses        1876     1878       +2     

Flag	Coverage Δ
python-3.13	81.60% <98.77%> (+0.27%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

🟡 Changes recommended

Address the unresolved documentation, invalid-JSON diagnostic, and type-suppression rationale review comments.

1 open issue

• Align purpose docstring with emitted metrics · New

What changed in this PR

Adds a standalone Python utility that collects backlog, review-run, and billing metrics for cataloged repositories through gh, then renders Markdown or minimal HTML reports.

Changes:

• Adds scripts/backlog_metrics.py with metric collection, aggregation, billing fallback, CLI handling, and Markdown/HTML output.
• Adds unit tests covering collection, counting, billing, rendering, errors, and CLI behavior.
• Registers the script in CLI usage checks.
• Documents the utility and invocation examples in scripts/README.md.

File	Description
tests/​test_cli_usage.py	Registers the new script as a command-line entry point.
tests/​test_backlog_metrics.py	Tests counting, billing, rendering, collection, error handling, and CLI behavior.
scripts/​README.md	Documents the utility, output fields, failure behavior, and usage examples.
scripts/​backlog_metrics.py	Implements backlog, review-run, billing, aggregation, and report generation.

_{Review effort: Lite}

[ptr727]

A recorded local strict-review pass covers head be1e374efd0eaf2dba28f67a4f9c33c30beb38f7, the content this pull request carries at that commit against develop, and it recorded 1 finding.