From 928964727b6445895fe13de81a1572abc0877cac Mon Sep 17 00:00:00 2001 From: Alex Kanitz Date: Fri, 13 Nov 2026 23:50:05 +0100 Subject: [PATCH 1/3] docs: list implemented GA4GH spec versions One row per product with the implemented and the current version of its GA4GH specification, each linked to its source: the spec file on the product's default branch and the upstream release page. Read from the repos: proTES implements TES 1.1.0 (not 1.0), TRS-Filer TRS 2.0.2, Funnel a TES commit after 1.1.0 without a stated release. Co-Authored-By: Claude Opus 5.5 --- .../ga4gh-standards.md | 43 +++++++++++++------ 1 file changed, 31 insertions(+), 12 deletions(-) diff --git a/docs/partners-and-developers/ga4gh-standards.md b/docs/partners-and-developers/ga4gh-standards.md index e555c47..3ddfca4 100644 --- a/docs/partners-and-developers/ga4gh-standards.md +++ b/docs/partners-and-developers/ga4gh-standards.md @@ -8,18 +8,37 @@ them, not this page, for the details. ## APIs and versions -| API | Current version | In the stack | Docs | -| --- | --- | --- | --- | -| [TES][ga4gh-tes], for tasks | [1.1.0](https://ga4gh.github.io/task-execution-schemas/) | proTES (1.0), [TESK][tesk] (1.0), [Funnel][funnel] (not stated in its docs) | [proTES](https://protes.readthedocs.io/en/latest/), [TESK](https://tesk.readthedocs.io/en/latest/) | -| [WES][ga4gh-wes], for workflows | [1.1.0](https://ga4gh.github.io/workflow-execution-service-schemas/) | [proWES](https://github.com/elixir-cloud-aai/proWES) (1.0.1), [CWL-WES](https://github.com/elixir-cloud-aai/cwl-WES) (1.0.0) | see the READMEs | -| [DRS][ga4gh-drs], for data | [1.5.0](https://ga4gh.github.io/data-repository-service-schemas/) | [DRS-Filer](https://github.com/elixir-cloud-aai/drs-filer) (1.1.0) | see the README | -| [TRS][ga4gh-trs], for tools and workflows | [2.0.1](https://ga4gh.github.io/tool-registry-service-schemas/) | [TRS-Filer](https://github.com/elixir-cloud-aai/trs-filer) (2.0.1) | [TRS-Filer](https://trs-filer.readthedocs.io/en/latest/) | -| [Service Registry][ga4gh-service-registry], for finding services | [1.0.0](https://github.com/ga4gh-discovery/ga4gh-service-registry) | [Cloud Registry](https://github.com/elixir-cloud-aai/cloud-registry) (1.0.0) | [Cloud Registry](https://cloud-registry.readthedocs.io/en/latest/) | - -The versions in brackets are the versions of the specification that each -product implements, as of November 2026. Check the product's docs for the -current state. Some products deviate from the specification in details: the -docs of the product list the deviations (for example, see the [Cloud Registry +The table lists, for each product, the version of the specification that it +implements and the current release of the specification. Each version links +to its source: the API specification (or the commit of the specification) +that the product's default branch builds on, and the release page of the +specification. Checked in November 2026. + +| Product | API | Implemented version | Current version | Docs | +| --- | --- | --- | --- | --- | +| [proTES](https://github.com/elixir-cloud-aai/proTES) | [TES][ga4gh-tes], for tasks | [1.1.0](https://github.com/elixir-cloud-aai/proTES/blob/dev/pro_tes/api/20221114.117cd92.task_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [proTES](https://protes.readthedocs.io/en/latest/) | +| [TESK][tesk] | [TES][ga4gh-tes], for tasks | [1.0.0](https://github.com/ga4gh/task-execution-schemas/blob/cafac9c47fddfa512e844c96ee4bcb2fb63d90c6/openapi/task_execution_service.openapi.yaml) (submodule of [tesk-api](https://github.com/elixir-cloud-aai/tesk-api)) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [TESK](https://tesk.readthedocs.io/en/latest/) | +| [Funnel][funnel] | [TES][ga4gh-tes], for tasks | 1.1.0 and later changes: not stated as a release; [its submodule](https://github.com/calypr/funnel/tree/develop/api/tes) points to a commit after 1.1.0 | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [Funnel][funnel] | +| [proWES](https://github.com/elixir-cloud-aai/proWES) | [WES][ga4gh-wes], for workflows | [1.0.1](https://github.com/elixir-cloud-aai/proWES/blob/dev/pro_wes/api/20201124.tag_1_0_1.workflow_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | +| [CWL-WES](https://github.com/elixir-cloud-aai/cwl-WES) | [WES][ga4gh-wes], for workflows | [1.0.0](https://github.com/elixir-cloud-aai/cwl-WES/blob/dev/cwl_wes/api/20181010.be85140.workflow_execution_service.swagger.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | +| [DRS-Filer](https://github.com/elixir-cloud-aai/drs-filer) | [DRS][ga4gh-drs], for data | [1.1.0](https://github.com/elixir-cloud-aai/drs-filer/blob/dev/drs_filer/api/20200622.383121d.data_repository_service.swagger.yaml) | [1.5.0](https://github.com/ga4gh/data-repository-service-schemas/releases/tag/drs-1.5.0) | see the README | +| [TRS-Filer](https://github.com/elixir-cloud-aai/trs-filer) | [TRS][ga4gh-trs], for tools and workflows | [2.0.2](https://github.com/elixir-cloud-aai/trs-filer/blob/dev/trs_filer/api/20250902.4854e2f.openapi.yaml) | [2.0.2](https://github.com/ga4gh/tool-registry-service-schemas/releases/tag/2.0.2) | [TRS-Filer](https://trs-filer.readthedocs.io/en/latest/) | +| [Cloud Registry](https://github.com/elixir-cloud-aai/cloud-registry) | [Service Registry][ga4gh-service-registry], for finding services | [1.0.0](https://github.com/elixir-cloud-aai/cloud-registry/blob/dev/cloud_registry/api/20201108.e0358db.openapi.yaml) | [1.0.0](https://github.com/ga4gh-discovery/ga4gh-service-registry/releases/tag/1.0.0) | [Cloud Registry](https://cloud-registry.readthedocs.io/en/latest/) | + +Notes on the table: + +- **TRS-Filer:** its specification file states `2.1.0`, but it is the + specification of the TRS release 2.0.2 (commit `4854e2f`); TRS 2.1.0 is + not released. +- **Funnel:** [Funnel][funnel] (now in the `calypr` organisation) doesn't + state a TES release. It builds on a commit of the TES repository after + 1.1.0, whose specification file states `1.1.0`. +- **TESK:** the TES API is implemented by tesk-api, which includes the TES + specification as a Git submodule. + +Check the product's docs for the current state. Some products deviate from +the specification in details: the docs of the product list the deviations +(for example, see the [Cloud Registry API](https://cloud-registry.readthedocs.io/en/latest/api/#deviations-from-the-ga4gh-specification)). !!! note "Do your clients support a newer version?" From d33ddc350e9e631f5f6be70c3fda97405232fb8e Mon Sep 17 00:00:00 2001 From: Alex Kanitz Date: Fri, 13 Nov 2026 23:56:59 +0100 Subject: [PATCH 2/3] docs: pin Funnel spec commit and add Poiesis Link Funnel's TES version to the pinned submodule commit instead of the moving develop branch, and add Poiesis, which the operator docs list as a TES service (review by Sourcery). Co-Authored-By: Claude Opus 5.5 --- docs/partners-and-developers/ga4gh-standards.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/partners-and-developers/ga4gh-standards.md b/docs/partners-and-developers/ga4gh-standards.md index 3ddfca4..3649284 100644 --- a/docs/partners-and-developers/ga4gh-standards.md +++ b/docs/partners-and-developers/ga4gh-standards.md @@ -18,7 +18,8 @@ specification. Checked in November 2026. | --- | --- | --- | --- | --- | | [proTES](https://github.com/elixir-cloud-aai/proTES) | [TES][ga4gh-tes], for tasks | [1.1.0](https://github.com/elixir-cloud-aai/proTES/blob/dev/pro_tes/api/20221114.117cd92.task_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [proTES](https://protes.readthedocs.io/en/latest/) | | [TESK][tesk] | [TES][ga4gh-tes], for tasks | [1.0.0](https://github.com/ga4gh/task-execution-schemas/blob/cafac9c47fddfa512e844c96ee4bcb2fb63d90c6/openapi/task_execution_service.openapi.yaml) (submodule of [tesk-api](https://github.com/elixir-cloud-aai/tesk-api)) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [TESK](https://tesk.readthedocs.io/en/latest/) | -| [Funnel][funnel] | [TES][ga4gh-tes], for tasks | 1.1.0 and later changes: not stated as a release; [its submodule](https://github.com/calypr/funnel/tree/develop/api/tes) points to a commit after 1.1.0 | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [Funnel][funnel] | +| [Funnel][funnel] | [TES][ga4gh-tes], for tasks | not stated: [a commit after 1.1.0](https://github.com/ga4gh/task-execution-schemas/blob/28a83a622e7d84fd4b8d438a6b2e99b0db2e5d5b/openapi/task_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [Funnel][funnel] | +| [Poiesis](https://github.com/JaeAeich/poiesis) | [TES][ga4gh-tes], for tasks | not stated: [a commit after 1.1.0](https://github.com/JaeAeich/poiesis/blob/dev/poiesis/api/tes/spec/c4c17c9.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [Poiesis](../operators/services/poiesis.md) | | [proWES](https://github.com/elixir-cloud-aai/proWES) | [WES][ga4gh-wes], for workflows | [1.0.1](https://github.com/elixir-cloud-aai/proWES/blob/dev/pro_wes/api/20201124.tag_1_0_1.workflow_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | | [CWL-WES](https://github.com/elixir-cloud-aai/cwl-WES) | [WES][ga4gh-wes], for workflows | [1.0.0](https://github.com/elixir-cloud-aai/cwl-WES/blob/dev/cwl_wes/api/20181010.be85140.workflow_execution_service.swagger.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | | [DRS-Filer](https://github.com/elixir-cloud-aai/drs-filer) | [DRS][ga4gh-drs], for data | [1.1.0](https://github.com/elixir-cloud-aai/drs-filer/blob/dev/drs_filer/api/20200622.383121d.data_repository_service.swagger.yaml) | [1.5.0](https://github.com/ga4gh/data-repository-service-schemas/releases/tag/drs-1.5.0) | see the README | @@ -30,9 +31,10 @@ Notes on the table: - **TRS-Filer:** its specification file states `2.1.0`, but it is the specification of the TRS release 2.0.2 (commit `4854e2f`); TRS 2.1.0 is not released. -- **Funnel:** [Funnel][funnel] (now in the `calypr` organisation) doesn't - state a TES release. It builds on a commit of the TES repository after - 1.1.0, whose specification file states `1.1.0`. +- **Funnel and Poiesis:** neither states a TES release. Both build on a + commit of the TES repository after the release 1.1.0 (Funnel, now in the + `calypr` organisation: `28a83a6`, as a Git submodule; Poiesis: `c4c17c9`), + whose specification file states `1.1.0`. - **TESK:** the TES API is implemented by tesk-api, which includes the TES specification as a Git submodule. From b0e744bd9acfafae56054c407b7f7e58d0d7fae0 Mon Sep 17 00:00:00 2001 From: Alex Kanitz Date: Sat, 14 Nov 2026 17:01:03 +0100 Subject: [PATCH 3/3] docs: add Conquest and WESkit, list TRS 2.1.0 Address the maintainer review: add rows for Conquest (WES 1.1 per its README) and WESkit (WES 1.1.0 spec file), list TRS-Filer as 2.1.0 with a note on ga4gh/tool-registry-service-schemas#295, move the tesk-api link from the table into the TESK note. Co-Authored-By: Claude Opus 5.5 --- .../ga4gh-standards.md | 21 ++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/docs/partners-and-developers/ga4gh-standards.md b/docs/partners-and-developers/ga4gh-standards.md index 3649284..715c3da 100644 --- a/docs/partners-and-developers/ga4gh-standards.md +++ b/docs/partners-and-developers/ga4gh-standards.md @@ -17,26 +17,33 @@ specification. Checked in November 2026. | Product | API | Implemented version | Current version | Docs | | --- | --- | --- | --- | --- | | [proTES](https://github.com/elixir-cloud-aai/proTES) | [TES][ga4gh-tes], for tasks | [1.1.0](https://github.com/elixir-cloud-aai/proTES/blob/dev/pro_tes/api/20221114.117cd92.task_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [proTES](https://protes.readthedocs.io/en/latest/) | -| [TESK][tesk] | [TES][ga4gh-tes], for tasks | [1.0.0](https://github.com/ga4gh/task-execution-schemas/blob/cafac9c47fddfa512e844c96ee4bcb2fb63d90c6/openapi/task_execution_service.openapi.yaml) (submodule of [tesk-api](https://github.com/elixir-cloud-aai/tesk-api)) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [TESK](https://tesk.readthedocs.io/en/latest/) | +| [TESK][tesk] | [TES][ga4gh-tes], for tasks | [1.0.0](https://github.com/ga4gh/task-execution-schemas/blob/cafac9c47fddfa512e844c96ee4bcb2fb63d90c6/openapi/task_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [TESK](https://tesk.readthedocs.io/en/latest/) | | [Funnel][funnel] | [TES][ga4gh-tes], for tasks | not stated: [a commit after 1.1.0](https://github.com/ga4gh/task-execution-schemas/blob/28a83a622e7d84fd4b8d438a6b2e99b0db2e5d5b/openapi/task_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [Funnel][funnel] | | [Poiesis](https://github.com/JaeAeich/poiesis) | [TES][ga4gh-tes], for tasks | not stated: [a commit after 1.1.0](https://github.com/JaeAeich/poiesis/blob/dev/poiesis/api/tes/spec/c4c17c9.openapi.yaml) | [1.1.0](https://github.com/ga4gh/task-execution-schemas/releases/tag/v1.1) | [Poiesis](../operators/services/poiesis.md) | | [proWES](https://github.com/elixir-cloud-aai/proWES) | [WES][ga4gh-wes], for workflows | [1.0.1](https://github.com/elixir-cloud-aai/proWES/blob/dev/pro_wes/api/20201124.tag_1_0_1.workflow_execution_service.openapi.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | +| [Conquest](https://github.com/anuragxxd/conquest) | [WES][ga4gh-wes], for workflows | [1.1](https://github.com/anuragxxd/conquest/blob/master/README.md) (README; no specification file) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | +| [WESkit](https://gitlab.com/one-touch-pipeline/weskit/api) | [WES][ga4gh-wes], for workflows | [1.1.0](https://gitlab.com/one-touch-pipeline/weskit/api/-/blob/master/weskit/api/workflow_execution_service_1.1.0.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | [WESkit](https://gitlab.com/one-touch-pipeline/weskit/documentation) | | [CWL-WES](https://github.com/elixir-cloud-aai/cwl-WES) | [WES][ga4gh-wes], for workflows | [1.0.0](https://github.com/elixir-cloud-aai/cwl-WES/blob/dev/cwl_wes/api/20181010.be85140.workflow_execution_service.swagger.yaml) | [1.1.0](https://github.com/ga4gh/workflow-execution-service-schemas/releases/tag/1.1.0) | see the README | | [DRS-Filer](https://github.com/elixir-cloud-aai/drs-filer) | [DRS][ga4gh-drs], for data | [1.1.0](https://github.com/elixir-cloud-aai/drs-filer/blob/dev/drs_filer/api/20200622.383121d.data_repository_service.swagger.yaml) | [1.5.0](https://github.com/ga4gh/data-repository-service-schemas/releases/tag/drs-1.5.0) | see the README | -| [TRS-Filer](https://github.com/elixir-cloud-aai/trs-filer) | [TRS][ga4gh-trs], for tools and workflows | [2.0.2](https://github.com/elixir-cloud-aai/trs-filer/blob/dev/trs_filer/api/20250902.4854e2f.openapi.yaml) | [2.0.2](https://github.com/ga4gh/tool-registry-service-schemas/releases/tag/2.0.2) | [TRS-Filer](https://trs-filer.readthedocs.io/en/latest/) | +| [TRS-Filer](https://github.com/elixir-cloud-aai/trs-filer) | [TRS][ga4gh-trs], for tools and workflows | [2.1.0](https://github.com/elixir-cloud-aai/trs-filer/blob/dev/trs_filer/api/20250902.4854e2f.openapi.yaml) | [2.0.2](https://github.com/ga4gh/tool-registry-service-schemas/releases/tag/2.0.2) | [TRS-Filer](https://trs-filer.readthedocs.io/en/latest/) | | [Cloud Registry](https://github.com/elixir-cloud-aai/cloud-registry) | [Service Registry][ga4gh-service-registry], for finding services | [1.0.0](https://github.com/elixir-cloud-aai/cloud-registry/blob/dev/cloud_registry/api/20201108.e0358db.openapi.yaml) | [1.0.0](https://github.com/ga4gh-discovery/ga4gh-service-registry/releases/tag/1.0.0) | [Cloud Registry](https://cloud-registry.readthedocs.io/en/latest/) | Notes on the table: -- **TRS-Filer:** its specification file states `2.1.0`, but it is the - specification of the TRS release 2.0.2 (commit `4854e2f`); TRS 2.1.0 is - not released. +- **TRS-Filer:** the specification file of the TRS release 2.0.2 (commit + `4854e2f`) states the version `2.1.0`, and there is no release 2.1.0 (see + [ga4gh/tool-registry-service-schemas#295](https://github.com/ga4gh/tool-registry-service-schemas/issues/295)). + The table takes the specification file as the source of truth and lists + `2.1.0`. - **Funnel and Poiesis:** neither states a TES release. Both build on a commit of the TES repository after the release 1.1.0 (Funnel, now in the `calypr` organisation: `28a83a6`, as a Git submodule; Poiesis: `c4c17c9`), whose specification file states `1.1.0`. -- **TESK:** the TES API is implemented by tesk-api, which includes the TES - specification as a Git submodule. +- **TESK:** the TES API is implemented by + [tesk-api](https://github.com/elixir-cloud-aai/tesk-api), which includes + the TES specification as a Git submodule. +- **Conquest:** its README states WES 1.1 (and TES 1.1 for its internal + task backend); the repository has no specification file. Check the product's docs for the current state. Some products deviate from the specification in details: the docs of the product list the deviations