Open comment report — pipeline overview

Summary

The Federal Register pipeline produces an Open Comment Period report: which documents are open for public comment, when comment periods close, metadata for downstream use, and (when present) CFA comment draft text per docket.

Outputs

The JSON includes slug, comment_draft_markdown (latest comment_draft analysis per open docket), and summary counts.

Generation

• Command: python scripts/run_report.py (or as part of the full pipeline).
• Schema (conceptual): report, generated_at, summary (counts for 7 / 30 / 90 day windows), documents[] (identifiers, titles, agencies, dates, FR URLs, has_comment_draft, comment_draft_analysis_id, comment_draft_markdown).

Publish to this Documentation.AI site (primary)

1. Run the report in FederalRegister: python scripts/run_report.py.
2. Copy output/open_comment_report.json into this repo as docs/data/open-comment-report.json.
3. Run python3 scripts/generate_open_comment_site.py from the cfa-reports root.
4. Commit changes and push main; Documentation.AI rebuilds. The FR Proposed Rules tab shows hub, current dockets, and per-docket pages under docs/reports/fr-proposed-rules/current/dockets/.

Without a database: run python3 scripts/fetch_fr_proposed_rules_json.py in cfa-reports first to fill docs/data/open-comment-report.json from the Federal Register public API (proposed rules with comment deadlines in the next 90 days; CFA draft fields empty). Then run the generator as above.

Optional: CFA Astro

The CFA frontend can still consume frontend/src/data/open-comment-report.json for secondary surfaces; run scripts/sync-open-comment-report.sh when you want parity. Primary public reporting for open comments is intended on this Documentation.AI deployment.

Source

Adapted from FederalRegister/docs/OPEN_COMMENT_REPORT_FOR_CFA.md. The canonical pipeline definition remains in the FederalRegister repository.

---

© 2026 Center for Federal Accountability. Published from the cfa-reports repository.