Improve docstring coverage to meet 80% threshold

[sheepdestroyer]

Description

CodeRabbit flagged that the repo's docstring coverage is ~25%, well below the 80%
threshold required by pre-merge checks.

Context

Noticed during review of PR #275 (sys.path import cleanup). The PR itself didn't
introduce or worsen the gap — this is a pre-existing global concern.

Scope

The repo has ~4,100+ lines in router/main.py alone, plus many scripts and
test files. Likely candidates for docstring additions:

• router/main.py — most endpoints, helpers, and route handlers
• router/agy_proxy.py — proxy functions
• router/circuit_breaker.py — breaker logic
• scripts/ — benchmark, verification, and utility scripts

Suggested Approach

• Tackle incrementally: one module per PR
• Prioritize public-facing functions and FastAPI route handlers
• Use Google-style docstrings consistent with existing code

Labels

• documentation
• code-quality
• maintenance

Related

• PR chore: eliminate sys.path.insert hacks — migrate to package-relative imports #275 (where the gap was flagged)

[google-labs-jules]

Jules is on it. When finished, you will see another comment and be able to review a PR.

[google-labs-jules]

Ready for a review! A PR has been created.

[google-labs-jules]

I apologize, but I encountered an unexpected error and wasn't able to complete the task.