OvertureMaps / OvertureMaps/stac
Fetch schema:version from OvertureMaps/schema tags
@jjcfrancisco is already working on this.
Since Sep 16, 2026.
- Dominant language
- Rust
- Stars
- 39
- Forks
- 3
- Avg merge
- 4d 18m
- Merged PRs (30d)
- 7
Description
Type
Task
Scope
Multi-theme or Platform
Skillset
engineering
Description
Context
reconcile passes "" as the schema arg to build_single_release, so every catalog it produces ships schema:version: null (visible on prod today for 2026-08-19.0 at every level). Same bug in Python main — inherited, not a Rust regression. We plan to pair schema tags with release tags in OvertureMaps/schema — e.g. v1.18.0 and 2026-10-15.0 on the same commit — giving a queryable release→schema mapping.
Proposed change
Add fetch_schema_from_github(release_id) -> Result<Option<String>> in src/storage/http.rs:
- Query
https://api.github.com/repos/OvertureMaps/schema/tags; find the tag whose commit also carries arelease_id-shaped tag; return the pairedv*tag stripped of the leadingv. ReturnNoneif no pair found. - Cache the tag set in-memory for the run so reconcile only hits the API once.
Wire the resolver into apply_diff in reconcile.rs — the build_single_release(..., release, "", ...) call.
Fail-open: None from the resolver → keep passing "" (today's behavior). Network errors log and continue. A follow-up will add parquet-metadata as the primary source once Oct+ releases stamp it, demoting GH lookup to fallback.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.