feat(sled): state, local and education procurement

[makegov-mark]

SDK support for Tango's new /api/sled/ namespace — state, local and education (SLED) procurement. Blocked: the endpoints are not live on the public API yet. Hold until the API ships them.

Siblings: makegov/tango-python#62, makegov/tango-node#18.

What's here

sled.go + sled_test.go, and five presets in shapes.go:

Method	Route
ListSledOpportunities / IterateSledOpportunities	GET /api/sled/opportunities/
GetSledOpportunity	GET /api/sled/opportunities/{opportunity_id}/
ListSledOpportunityRevisions	GET /api/sled/opportunities/{opportunity_id}/revisions/
GetSledCoverage	GET /api/sled/opportunities/coverage/
ListSledForecasts / IterateSledForecasts	GET /api/sled/forecasts/
GetSledForecast	GET /api/sled/forecasts/{forecast_id}/

Three options structs name every one of the API's 27 solicitation filters and 13 forecast filters.

Four things a reviewer should check

The SDK must not synthesize status=open. The API defaults a list request with no status and no active to open-only. Making that explicit client-side breaks Active: boolPtr(false), which is the complement of open and therefore has to reach the server as the only liveness param. A subtest pins both halves — that no liveness param is sent when the caller asks for none, and that active=false is sent rather than dropped.

*bool, not bool, for the three boolean filters. Active, HasDocuments and SourceDeclared are pointers so false reaches the server instead of vanishing into Go's zero value — the same reason setIfNotNilBool exists in internal.go. Getting this wrong would silently make "closed solicitations" and "records with no documents" unqueryable.

ShapeSledRevisionsMinimal omits changes. The per-field before/after requires a Small plan; naming it in a suggested shape would 403 every Free caller on a field they never asked to gate. changed_fields is in the shape and available at every plan. A test asserts the split rather than trusting the constant to stay right.

ChangeSeenAfter has no Before twin, deliberately. The API exposes only the lower bound on that field. The struct comment says so, rather than leaving a reader to assume the pair was forgotten.

Scope note

This SDK has no dibbs, exclusions or sbir resources, so unlike tango-python and tango-node there was no vendored contract to refresh and no conformance or shape-coverage gate to satisfy — SLED lands as a plain resource file following the protests.go shape.

Testing

• go test ./... and go test -race ./... — pass. sled_test.go adds 13 tests (one table-driven with 8 subtests).
• go vet ./... — clean. gofmt -s -l . — clean.
• golangci-lint run could not run here: the checked-in config fails to load on the locally installed version (can't unmarshal config by viper … 'output.formats' expected a map, got 'slice'). That is a pre-existing config/version mismatch unrelated to this change, and CI's pinned version should be unaffected — but it means lint is unverified locally, so worth a look at the CI result.

Docs

New State & Local (SLED) section in docs/API_REFERENCE.md, and an addition to docs/WEBHOOKS.md troubleshooting: an exclusion or DIBBS solicitation reaching its date fires nothing, because open/closed is derived at query time — but alerts.sled_opportunity.match does fire when a SLED solicitation closes, since its liveness is a stored field the API recomputes every fifteen minutes.

🤖 Generated with Claude Code

---

Update: the paid document-body leaf

Pushed a second commit adding attachments(extracted_text) — a SLED document body, served on the Small plan and above, from Tango API 4.25.1.

Three rules are documented wherever a caller will look, because each one is otherwise a support ticket:

• The leaf must be named. No default or suggested shape includes it, and attachments(*) does not carry it — the API resolves the body only for a caller who asked, so a default naming it would make every detail fetch pay for a document nobody wanted to read. A test pins the shapes against it.
• The key is absent, not null, whenever the text is not being served: below Small (where it is withheld and named in meta.upgrade_hints), on a contested document, or where the text could not be resolved.
• A contested document never returns text, at any plan — its stored bytes disagree with what the record advertised, so its extracted text is not reliably that record's content.

And the distinction worth stating plainly, because it reads backwards in both directions: searching document text is ungated (every plan, ids only, no fragment of the document) while reading a body is paid (Small and above, one record at a time). Buying the body does not change search.

Sequencing: the SLED surface itself is live on the production API. extracted_text needs 4.25.1, which is not deployed yet — so this PR is mergeable, but that one field will 400 until the API catches up. GET /api/version reports what a caller is talking to.