Center for Federal Accountability › Reports

Open comment report — pipeline overview

How the FederalRegister project produces the open comment period report and how it feeds this Documentation.AI site and optional CFA builds.

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

Artifact	Location (FederalRegister repo)
JSON	`output/open_comment_report.json`
Markdown	`output/open_comment_report.md`

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)

Run the report in FederalRegister: python scripts/run_report.py.
Copy **output/open_comment_report.json into this repo as docs/data/open-comment-report.json**.
Run **python3 scripts/generate_open_comment_site.py from the cfa-reports** root.
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.