Pp Lda Gov

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/lda-gov/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

LDA.gov — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the lda-gov-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install lda-gov --cli-only

2. Verify: lda-gov-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/other/lda-gov/cmd/lda-gov-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Search the official Lobbying Disclosure Act API, sync public filings into SQLite, and turn nested lobbying records into source-linked audits. The CLI keeps anonymous reads safe by default, supports optional registered API keys, and adds commands for entity resolution, anomaly checks, spend timelines, contribution totals, and graph exports.

When to Use This CLI

Use this CLI when you need official LDA.gov records, local analysis, repeatable watchdog checks, or agent-friendly evidence exports. It is strongest for lobbying filings, contribution reports, registrant/client/lobbyist lookup, source citation, and longitudinal analysis across synced data.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI for FEC campaign-finance data; use a dedicated FEC source.
• Do not use this CLI for legal advice about LDA filing obligations.
• Do not use this CLI for live bill status or congressional vote data; use Congress.gov or another legislative API.
• Do not use this CLI to infer missed filing obligations without corroborating records.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Evidence-grade local audits

• audit filings — Flag amendments, terminations, duplicate-risk filings, client/registrant conflicts, and missing source URLs.

  Use this when an agent needs reproducible watchdog flags instead of raw filing rows.

  lda-gov-pp-cli audit filings --agent --limit 25

• audit spend — Aggregate disclosed lobbying income and expenses by client, registrant, issue, year, and quarter.

  Use this when an agent needs analysis-ready spend totals rather than individual filings.

  lda-gov-pp-cli audit spend --client Boeing --from-year 2020 --to-year 2025 --csv

• contributions totals — Aggregate LD-203 contribution items by contributor, recipient, payee, item type, year, and report.

  Use this when an agent needs contribution totals without writing a custom flattener.

  lda-gov-pp-cli contributions totals --year 2024 --csv

Entity intelligence

• entities resolve — Rank matching registrants, clients, and lobbyists with official IDs, counts, last activity, and source URLs.

  Use this before citing or joining an ambiguous company, firm, or lobbyist name.

  lda-gov-pp-cli entities resolve Boeing --agent --limit 10

• graph export — Export client-registrant-lobbyist-issue-government entity edges for graph analysis.

  Use this when an agent needs a relationship graph for downstream NetworkX, Gephi, or SQL work.

  lda-gov-pp-cli graph export --client Boeing --format csv

• lobbyists covered-positions — List lobbyists' covered government positions connected to clients, registrants, and filing periods.

  Use this when an agent needs exact official covered-position evidence tied to active lobbying records.

  lda-gov-pp-cli lobbyists covered-positions --client Boeing --csv

Period monitoring

• reports quarter — Produce quarter stats for filings, amendments, terminations, top issues, top entities, spend, and LD-203 totals.

  Use this after quarterly deadlines when an agent needs a compact, source-linked snapshot.

  lda-gov-pp-cli reports quarter --year 2024 --period year_end --agent --select top_issue,top_government_entity,filings

Command Reference

clients — Access Client information.

• lda-gov-pp-cli clients list — Returns all clients matching the provided filters.
• lda-gov-pp-cli clients retrieve — Returns all clients matching the provided filters.

constants — An assorted list of constants found in the LDA REST API.

• lda-gov-pp-cli constants list-contribution-item-types — Returns all ContributionItemTypes.
• lda-gov-pp-cli constants list-countries — Returns all Countries.
• lda-gov-pp-cli constants list-filing-types — Returns all FilingTypes.
• lda-gov-pp-cli constants list-government-entities — Returns all GovernmentEntities.
• lda-gov-pp-cli constants list-lobbying-activity-general-issues — Returns all LobbyingActivityGeneralIssues.
• lda-gov-pp-cli constants list-lobbyist-prefixes — Returns all LobbyistPrefixes.
• lda-gov-pp-cli constants list-lobbyist-suffixes — Returns all LobbyistSuffixes.
• lda-gov-pp-cli constants list-states — Returns all States.

contributions — Manage contributions

• lda-gov-pp-cli contributions list-reports — List reports
• lda-gov-pp-cli contributions retrieve-report — Returns all contributions matching the provided filters.

filings — Access LD1 / LD2 filings.

• lda-gov-pp-cli filings list — List
• lda-gov-pp-cli filings retrieve — Returns all filings matching the provided filters.

lobbyists — Access Lobbyist information.

• lda-gov-pp-cli lobbyists list — Returns all lobbyists matching the provided filters.
• lda-gov-pp-cli lobbyists retrieve — Returns all lobbyists matching the provided filters.

registrants — Access Registrant information.

• lda-gov-pp-cli registrants list — Returns all registrants matching the provided filters.
• lda-gov-pp-cli registrants retrieve — Returns all registrants matching the provided filters.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

lda-gov-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Resolve a company before joining records

lda-gov-pp-cli entities resolve Boeing --agent --limit 10 --db ./lda.db

Ranks official registrant, client, and lobbyist matches so an agent can pick the right ID.

Build a source-linked quarter snapshot

lda-gov-pp-cli reports quarter --year 2024 --period year_end --agent --select top_issue,top_government_entity,filings --db ./lda.db

Narrows a potentially large report to the fields an agent needs in context.

Audit filings for cleanup flags

lda-gov-pp-cli audit filings --agent --limit 25 --db ./lda.db

Flags amendments, terminations, duplicate risks, and client/registrant conflicts.