Skip to content

docs: extension candidates ranked against live reporting (refs #7) - #15

Draft
markramm wants to merge 3 commits into
mainfrom
docs/extension-candidates
Draft

markramm wants to merge 3 commits into
mainfrom
docs/extension-candidates

Conversation

@markramm

Copy link
Copy Markdown
Owner

What

The finding to read first

usaspending "<IDV PIID>" --keywords --count returns a false VerifiedAbsence for an IDIQ that
exists. count() defaults to contract types A-D, and not_searched does not say IDVs were
excluded. With --all-types the same query is a Hit. The details and a proposed fix are in
FEEDBACK.md and draft issue 2.

Ranking (top 5)

  1. FEC, bulk first (new). A live FEC question was answered from keyless bulk files after DEMO_KEY returned 429.
  2. usaspending: IDV-aware counts, PIID-shape routing, --idv, --agency (new; includes the bug above).
  3. SAM.gov (SAM.gov client (solicitations + entity registry) — keyless, twice load-bearing already #2, strengthened).
  4. CourtListener docket-watch mode (new). A court-scoped docket-number query found a related case the story had missed.
  5. Nonprofit 990 / Schedule I (Nonprofit/990 client (ProPublica Nonprofit Explorer API) — keyless #4, strengthened with a live name-collision probe).

Note on the base

This branch is cut from origin/main. Local main holds unpushed commits, including
docs/source-plugin-design.md, which the new doc references by commit (b0969f3). Expect a
trivial tail conflict in FEEDBACK.md when those land.

Refs #7

🤖 Generated with Claude Code

markramm and others added 3 commits September 29, 2026 11:03
…iction

Adds docs/extension-candidates.md: eight live investigations (described by
shape), the research moves each needs, and a ranked list of extensions with
access shape, stories deepened, VerifiedAbsence value, value to other
newsrooms, and effort. Cross-references #1, #2 and #4 (strengthened) and
EPIC #7; new issue proposals are drafted at the end for approval.

FEEDBACK.md: a false VerifiedAbsence on usaspending --count for an IDV PIID
(default types exclude IDVs and not_searched does not say so), the FEC gap
answered via keyless bulk files, docket-watch friction, the gao.gov
allow-list, and a 990 name-collision probe.

Refs #7

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…d keyless, issue numbers; add www.gao.gov to the browser allow-list

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@markramm
markramm force-pushed the docs/extension-candidates branch from fe5ceb4 to 48d3d5d Compare September 29, 2026 15:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant