Skip to content

Pgstac variant#1

Merged
SethDocherty merged 5 commits intomainfrom
pgstac-variant
Jan 28, 2026
Merged

Pgstac variant#1
SethDocherty merged 5 commits intomainfrom
pgstac-variant

Conversation

@SethDocherty
Copy link
Member

This pull request introduces a major new version (v1.2.0) of the dgeo extension, focused on improving queryability, schema validation, and compatibility with pgstac and the STAC API. The update includes breaking changes to the schema and example files, new fields for CID discovery, asset-level metadata, and improved documentation and migration guidance.

Key highlights:

  • The nested dgeo:assets array is replaced by a flat, queryable dgeo:cids array.
  • Asset-level dgeo fields (dgeo:cid, dgeo:cid_profile) are now supported, enabling better CID-to-asset correlation.
  • The JSON Schema is upgraded for stricter validation, including regex checks for CIDs and uniqueness constraints.
  • Example files and documentation are fully updated to reflect the new schema and migration path.

Most important changes:

Schema and Validation Improvements

  • Major schema refactor: replaces dgeo:assets with a flat, required dgeo:cids array, introduces optional dgeo:piece_cids, and adds asset-level dgeo:cid and dgeo:cid_profile fields. Enforces stricter validation with regex patterns for CIDs, uniqueness, and minimum array lengths. [1] [2]
  • Adds invalid example cases in item-invalid.json to demonstrate schema enforcement for required fields, format validation, uniqueness, and minimum array constraints.

Breaking Changes and Asset Model Updates

  • Migrates all example files (item.json, item-core.json, collection.json) to use the new flat dgeo:cids array and asset-level fields, removing the old nested dgeo:assets structure and dgeo:context. Asset roles, descriptions, and naming now use standard STAC asset keys and fields. [1] [2] [3] [4] [5]

Documentation and Migration Guidance

  • Adds a comprehensive CHANGELOG.md detailing all breaking changes, new features, migration steps, and schema improvements. References a new migration guide and provides upgrade instructions.

General Improvements

  • Updates all schema and example file descriptions for clarity, and rewrites the README (as referenced in the changelog) to document new features, queryability, and migration.

These changes are a major step toward making dgeo assets more discoverable, interoperable, and standards-compliant, but require all users to migrate existing data to the new schema.

- Expanded the scope of the dgeo extension in README to include "Assets".
- Enhanced the description to clarify the purpose of the dgeo extension.
- Updated objectives for improved clarity on queryable CID-based discovery and asset-level metadata.
- Revised examples in README to reflect new usage patterns and asset-level fields.
- Modified JSON Schema to include required fields for dgeo:cids and dgeo:piece_cids.
- Added asset-level fields dgeo:cid and dgeo:cid_profile to support CID-to-asset correlation.
- Improved validation patterns for CIDs and Piece CIDs in the schema.
- Removed deprecated context fields and clarified the structure for asset definitions.
…n with dgeo specifications; add invalid examples for schema validation
…pdate asset links and metadata for improved clarity and consistency
…breaking changes, new features, and migration steps
Copilot AI review requested due to automatic review settings January 28, 2026 20:58
@SethDocherty SethDocherty merged commit 2e0fb35 into main Jan 28, 2026
5 of 7 checks passed
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