Skip to content

feat(news): add the award announcements resource (Tango API 5.14.0) - #106

Draft
vdavez wants to merge 1 commit into
mainfrom
feat/news-award-announcements
Draft

vdavez wants to merge 1 commit into
mainfrom
feat/news-award-announcements

Conversation

@vdavez

@vdavez vdavez commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds the award announcements resource from Tango API 5.14.0.

  • list_award_announcements() and get_award_announcement() (by uuid) over /api/news/award_announcements/, with every filter as a named parameter.
  • AwardAnnouncement and AwardAnnouncementAwardee schemas, plus ShapeConfig.AWARD_ANNOUNCEMENTS_MINIMAL and AWARD_ANNOUNCEMENTS_COMPREHENSIVE, which mirror the API's list and retrieve defaults, including the awardees and organization expands.
  • query_type="award_announcement" documented for create_webhook_alert(), and alerts.award_announcement.match in the webhook guide.
  • contracts/filter_shape_contract.json re-vendored at API 5.14.0.
    The conformance gates map the new resource and drop the two resources the contract no longer lists.

Each row names its source.
official_release rows are the Department of War's daily contracts release as published.
makegov_generated rows are written by MakeGov from FPDS data with a language model and are not government text; the README, API reference, method docstring and model docstring all say so.

Testing

  • uv run pytest: 716 passed, 1 skipped.
  • ruff format --check, ruff check and strict mypy pass on tango/.
  • check_filter_shape_conformance.py and check_shape_coverage.py pass against the API 5.14.0 contract.
  • Requests are mocked in tests/test_award_announcements.py, and nothing here has run against the live endpoint.
    No live test is added.

Notes

  • Hold this until Tango API 5.14.0 is serving; the methods return 404 before then.
  • CHANGELOG.md entries are under [Unreleased], with no version bump.

🤖 Generated with Claude Code

`list_award_announcements()` and `get_award_announcement()` cover the new `/api/news/award_announcements/` resource, with `AwardAnnouncement` and `AwardAnnouncementAwardee` schemas, minimal and comprehensive default shapes, and the `awardees` and `organization` expands.
Each row names its `source`: `official_release` rows are the Department of War's daily contracts release as published, and `makegov_generated` rows are written by MakeGov from FPDS data with a language model and are not government text.
`award_announcement` is documented as an alert query type, for `alerts.award_announcement.match`.
The vendored filter/shape contract moves to API 5.14.0, and the conformance gates drop the two resources it no longer lists.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vdavez
vdavez force-pushed the feat/news-award-announcements branch from f469997 to b85cacc Compare October 30, 2026 20:08
@vdavez vdavez changed the title feat(news): add the award announcements resource (Tango API 5.15.0) feat(news): add the award announcements resource (Tango API 5.14.0) Oct 30, 2026
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