2.1
2.1.1
Version 2.1.1 moves VRS to the renamed GKM metaschema processor
(ga4gh.gkm.metaschema) and its abstract-class convention, and tracks
GKM Core 1.3.0. The abstract classes Variation,
Molecular Variation, Systemic Variation, Location, and
Sequence Expression are now declared sealed: the processor derives
each class’s closed set of concrete subclasses instead of relying on
hand-maintained oneOf lists. The derived sets match 2.1.0 exactly, so the
instances VRS accepts and their computed identifiers are unchanged. This
release also renames the “Concepts” documentation section to “Model”, aligns
the maturity model page with the GA4GH TASC Technical Specification Development policy, and substantially expands the
test suite.
Patch Version Increment
adopts the renamed
ga4gh.gkm.metaschemaprocessor (0.4.8) and its abstract-class convention: abstract classes are markedabstract: trueand left open, while concrete classes stay closed to undefined properties (additionalProperties/unevaluatedProperties: false), as they already were in 2.1.0, by @larrybabb in https://github.com/ga4gh/vrs/pull/718declares Variation, Molecular Variation, Systemic Variation, Location, and Sequence Expression
sealed: true, replacing their hand-writtenoneOfunions with processor-derived ones. The derived unions are identical to 2.1.0’s. Properties that previously inlined aoneOfover the sequence expression classes (Allelestate, Relative AllelebaseState/mappedState, Adjacencylinker) now reference Sequence Expression instead, which resolves to the same three classes, by @larrybabb in https://github.com/ga4gh/vrs/pull/718publishes GA4GH Identifiable Object as a standalone, open JSON Schema (
json/Ga4ghIdentifiableObject) by @larrybabb in https://github.com/ga4gh/vrs/pull/718bumps the gkm-core submodule from
1.2.0to1.3.0. The only data-model changes in GKM Core 1.3.0 are a new optionalConceptSet.conceptSetTypefield andiriReferenceas a new allowedConceptSet.conceptsmember, and no VRS class uses ConceptSet. VRS classes that inherit from GKM Core’sEntity(GA4GH Identifiable Object, Sequence Expression, Sequence Offset Location, Sequence Reference, Traversal Block) orElement(Expression) see no property changes, since 1.3.0 only marks those root classes abstract, by @larrybabb in https://github.com/ga4gh/vrs/pull/718retokenizes the schema identity (
$id) to2.1.1by @ahwagner in https://github.com/ga4gh/vrs/pull/718, with a final retokenization pass (also dropping the ballot suffix from the gkm-core namespace pin) by @korikuzma when the release was cutaligns the GA4GH Maturity Model page with the GA4GH TASC Technical Specification Development policy by @ahwagner in https://github.com/ga4gh/vrs/pull/714
renames the “Concepts” documentation section to “Model”, generates the imported GKM Core class definitions locally instead of linking them from the submodule, and fixes the maturity model link, by @larrybabb in https://github.com/ga4gh/vrs/pull/718
expands the test suite with schema-invariant tests (abstract classes open, concrete classes closed), negative examples (
examples/invalid/), concrete-class coverage for every instantiable VRS class, and$refversion-token resolution tests. Also regenerates the stalevalidation/json/models.json, adding the missing fixtures for the draft intronic-position classes, by @larrybabb in https://github.com/ga4gh/vrs/pull/718updates the pre-commit CI job to check out submodules and install the schema-build dependencies, and makes the
update-json-def-fileshook fail on amakeerror, by @larrybabb in https://github.com/ga4gh/vrs/pull/718references the GA4GH metaschema processor in the README and refreshes contributor guidance (
.claude/CLAUDE.md) by @larrybabb in https://github.com/ga4gh/vrs/pull/718
2.1.0
Version 2.1.0 of the GA4GH Variation Representation Specification (VRS) adds support for intronic positions, including new classes for relative sequence locations and relative alleles. It also revises the normalization algorithm for ambiguous insertions to select the smallest repeat-unit factor rather than the greatest, changing the normalized (and therefore digested) representation of affected trial-use Allele instances.
Minor Version Increment
revises the Normalization algorithm for ambiguous insertions to select the smallest repeat-unit factor rather than the greatest, changing the normalized (and therefore digested) representation of affected trial-use Allele instances by @ahwagner in https://github.com/ga4gh/vrs/pull/700
Patch Version Increment
adds Relative Sequence Location, Sequence Offset Location, and Relative Allele to support intronic positions, all at draft maturity, by @korikuzma in https://github.com/ga4gh/vrs/pull/675
fixes
typeandga4gh.inherentfor the draft intronic position classes by @korikuzma in https://github.com/ga4gh/vrs/pull/684adds tests for ensuring correct properties by @korikuzma in https://github.com/ga4gh/vrs/pull/686
adds a Relative Allele example and intronic-position normalization rules by @larrybabb in https://github.com/ga4gh/vrs/pull/689
fixes inconsistent
seed_lengthformatting in normalization docs by @harshitmishra00182-ops in https://github.com/ga4gh/vrs/pull/702bumps the GKS-core submodule from 1.0.0 to 1.1.0 and, later, to 1.2.0 (by then renamed GKM Core); the only classes touched upstream (Mappable Concept, ConceptSet) are not inherited or embedded by any VRS class, so neither bump carries a data-compatibility impact into VRS by @korikuzma and @ahwagner in https://github.com/ga4gh/vrs/pull/664
removes broken refs in releases by @jsstevenson in https://github.com/ga4gh/vrs/pull/647
fixes a few warnings, removes anonymous entries from search results by @jsstevenson in https://github.com/ga4gh/vrs/pull/646
documents the imported GKS-core ConceptSet class and reorders the changelog by @korikuzma in https://github.com/ga4gh/vrs/pull/666
auto-updates copyright year by @jsstevenson in https://github.com/ga4gh/vrs/pull/673
fixes refs, adds warnings check to CI/CD by @jsstevenson in https://github.com/ga4gh/vrs/pull/671
fixes orphaned pages showing up in search results by @jsstevenson in https://github.com/ga4gh/vrs/pull/672
fixes the img.shields.io link for the docs badge by @korikuzma in https://github.com/ga4gh/vrs/pull/685
adds quick start guidance by @brendanreardon in https://github.com/ga4gh/vrs/pull/693
minor cosmetic and doc updates by @larrybabb in https://github.com/ga4gh/vrs/pull/698
adds a citation file by @jsstevenson in https://github.com/ga4gh/vrs/pull/701
removes an old unused TODO file by @jsstevenson in https://github.com/ga4gh/vrs/pull/703