Skip to content

v2.0.0

Choose a tag to compare

@benzsevern benzsevern released this 14 Jun 06:03
93193cc

GoldenMatch 2.0.0 -- first backwards-incompatible major.

This release removes four deprecation-window items that shipped with a
1.x runway. The pipeline behavior is output-equivalent; the breaks are in
removed escape hatches, internal shims, and the legacy identity id scheme.

BREAKING CHANGES

  • Identity :hash: scheme removed. The legacy :hash: lookup candidate
    and GOLDENMATCH_IDENTITY_ID_SCHEME are gone. A persisted identity DB
    still holding :hash:-keyed records will SPLIT on the next run.
    Run goldenmatch identity migrate-ids --path <db> (or --dsn) BEFORE
    upgrading. Un-fingerprintable rows keep their :hash: id.
  • GOLDENMATCH_CLUSTER_FRAMES_OUT removed. The Arrow frames-out path is
    the only clustering path now (output-equivalent). Public build_clusters
    is preserved as a frames-backed adapter.
  • RunHistory.cheapest_healthy() removed -- use pick_committed().
  • _scale_aware_backend (internal) removed -- backend selection routes
    through the v3 planner.

Migration

If you persist an identity DB, run the migration before upgrading:

goldenmatch identity migrate-ids --path <db>     # or --dsn <postgres-dsn>
goldenmatch identity migrate-ids --path <db> --dry-run   # counts only

Full guide: https://docs.bensevern.dev/ (Guides -> Migrating to v2).
See packages/python/goldenmatch/CHANGELOG.md for the complete 2.0.0 notes
(Added: stable Sail IdentityGraph API, identity migrate-ids; Performance:
Fellegi-Sunter block scoring ~3.5x faster on tiny-block shapes).