From 6cffddd56dd180a4087435a12aa44f8840170c61 Mon Sep 17 00:00:00 2001 From: Eric Deutsch Date: Thu, 4 Dec 2025 11:29:33 -0800 Subject: [PATCH 1/4] Add COLLATE to set_interpretation Clarify behavior of set_interpretation and member_ids. --- TranslatorReasonerAPI.yaml | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/TranslatorReasonerAPI.yaml b/TranslatorReasonerAPI.yaml index 7865e26..b9a89af 100644 --- a/TranslatorReasonerAPI.yaml +++ b/TranslatorReasonerAPI.yaml @@ -964,11 +964,17 @@ components: MANY means that member CURIEs MUST form one or more sets in the Results, and sets with more members are generally considered more desirable that sets with fewer members. - If this property is missing or null, the default is BATCH. + Only when there are no ids provided, set_interpretation MAY be + set to COLLATE to indicate that each result MUST collate + all applicable IDs matching this query node. + If this property is absent or null, the default is BATCH when + ids are present and the default is COLLATE when ids are not + present. enum: - BATCH - ALL - MANY + - COLLATE nullable: true member_ids: type: array @@ -977,7 +983,7 @@ components: field MUST be populated under a set_interpretation of MANY or ALL, when the 'ids' field holds a UUID representing the set itself. This field MUST NOT be used under a set_interpretation - of BATCH. + of BATCH or COLLATE or when set_interpretation is absent or null. nullable: true minItems: 1 items: From 4ed012a25d2898371f64fdc81178613f709d5e19 Mon Sep 17 00:00:00 2001 From: Eric Deutsch Date: Thu, 12 Feb 2026 11:25:02 -0800 Subject: [PATCH 2/4] Update COLLATE behavior --- TranslatorReasonerAPI.yaml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/TranslatorReasonerAPI.yaml b/TranslatorReasonerAPI.yaml index b9a89af..71f54b9 100644 --- a/TranslatorReasonerAPI.yaml +++ b/TranslatorReasonerAPI.yaml @@ -965,11 +965,11 @@ components: sets in the Results, and sets with more members are generally considered more desirable that sets with fewer members. Only when there are no ids provided, set_interpretation MAY be - set to COLLATE to indicate that each result MUST collate - all applicable IDs matching this query node. - If this property is absent or null, the default is BATCH when - ids are present and the default is COLLATE when ids are not - present. + set to COLLATE to indicate that mulitple matching nodes MUST be + collated into a single Result, rather than separated into + separate Results. If this property is absent, the default is + BATCH when ids are present, and the default is to separate nodes + into mutliple Results (i.e. not collate) when ids are not present. enum: - BATCH - ALL From b98fbef083419037db8c95bed8cb6f05b84567f9 Mon Sep 17 00:00:00 2001 From: Eric Deutsch Date: Thu, 12 Feb 2026 12:14:21 -0800 Subject: [PATCH 3/4] Fix spelling errors in set_interpretation description Corrected spelling errors in the TranslatorReasonerAPI.yaml file. --- TranslatorReasonerAPI.yaml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/TranslatorReasonerAPI.yaml b/TranslatorReasonerAPI.yaml index 71f54b9..864ba09 100644 --- a/TranslatorReasonerAPI.yaml +++ b/TranslatorReasonerAPI.yaml @@ -965,11 +965,10 @@ components: sets in the Results, and sets with more members are generally considered more desirable that sets with fewer members. Only when there are no ids provided, set_interpretation MAY be - set to COLLATE to indicate that mulitple matching nodes MUST be + set to COLLATE to indicate that multiple matching nodes MUST be collated into a single Result, rather than separated into separate Results. If this property is absent, the default is - BATCH when ids are present, and the default is to separate nodes - into mutliple Results (i.e. not collate) when ids are not present. + BATCH. enum: - BATCH - ALL From 4eeae20161193468b1e2d03d562310e9c1f1de2c Mon Sep 17 00:00:00 2001 From: Eric Deutsch Date: Thu, 12 Feb 2026 12:15:44 -0800 Subject: [PATCH 4/4] Update documentation for set_interpretation field --- TranslatorReasonerAPI.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TranslatorReasonerAPI.yaml b/TranslatorReasonerAPI.yaml index 864ba09..3eeff17 100644 --- a/TranslatorReasonerAPI.yaml +++ b/TranslatorReasonerAPI.yaml @@ -982,7 +982,7 @@ components: field MUST be populated under a set_interpretation of MANY or ALL, when the 'ids' field holds a UUID representing the set itself. This field MUST NOT be used under a set_interpretation - of BATCH or COLLATE or when set_interpretation is absent or null. + of BATCH or COLLATE or when set_interpretation is absent. nullable: true minItems: 1 items: