test(seqera-api): add nf-test helper coverage

Add lightweight nextflow_function coverage for lib/SeqeraApi.groovy
and document the lib test layout with a link to the nf-test
function testing docs.

Author: edmundmiller

tests/AGENTS.md

@@ -2,7 +2,7 @@
 
 ## Layout
 
-Each pipeline-level scenario lives in its own directory:
+Pipeline-level scenarios live in their own directories:
 
 - `pipeline_api_only/`
 - `pipeline_mixed_no_benchmark/`
@@ -16,13 +16,21 @@ Each scenario directory contains:
 - `main.nf.test.snap` — the snapshot for that scenario
 - `AGENTS.md` — scenario-specific guidance for future edits
 
+Function-level nf-test coverage for `lib/` helpers lives separately under:
+
+- `lib/`
+
+Reference: nf-test Function Testing docs — https://www.nf-test.com/docs/testcases/nextflow_function/
+
 ## Conventions
 
 - One scenario per directory.
 - Keep assertions local and explicit rather than heavily abstracted.
 - Prefer stable fixture files under `workflows/nf_aggregate/assets/`.
 - If routing behavior changes, update the scenario-specific `AGENTS.md` along with the test.
-- This directory is for pipeline routing/integration scenarios only; stage-specific pytest tests now live beside the relevant module under `modules/local/*/tests/`.
+- Pipeline routing/integration scenarios live under `tests/pipeline_*/`.
+- Function-level nf-test coverage for Groovy helpers under `lib/` lives under `tests/lib/`.
+- Stage-specific pytest tests live beside the relevant module under `modules/local/*/tests/`.
 
 ## Running tests
 

tests/lib/AGENTS.md

@@ -0,0 +1,18 @@
+# tests/lib/
+
+## Purpose
+
+This directory holds nf-test `nextflow_function` tests for helper code under `lib/`.
+
+Current coverage:
+
+- `SeqeraApi.groovy.test` — unit-ish behavioral coverage for `SeqeraApi` helpers using nf-test function tests and inline Groovy stubbing.
+
+## Conventions
+
+Reference: nf-test Function Testing docs — https://www.nf-test.com/docs/testcases/nextflow_function/
+
+- Prefer `nextflow_function` tests here instead of introducing a separate Spock/Gradle harness.
+- Keep assertions local and explicit.
+- Stub `SeqeraApi.metaClass.'static'.apiGet` inline when isolating pagination or workspace-resolution behavior.
+- Reserve pipeline routing/integration scenarios for the sibling `tests/pipeline_*/` directories.

tests/lib/SeqeraApi.groovy.test

@@ -0,0 +1,89 @@
+nextflow_function {
+    name "SeqeraApi helper functions"
+
+    test("apiGetAllTasks paginates until the final short page") {
+        function "SeqeraApi.apiGetAllTasks"
+
+        when {
+            function {
+                """
+                SeqeraApi.metaClass.'static'.apiGet = { String url, Map headers ->
+                    if (url.contains('offset=0')) {
+                        return [tasks: (1..100).collect { [taskId: it] }]
+                    }
+                    if (url.contains('offset=100')) {
+                        return [tasks: [[taskId: 101], [taskId: 102]]]
+                    }
+                    throw new RuntimeException("Unexpected URL: \${url}")
+                }
+
+                input[0] = 'https://example.com/tasks?workspaceId=55'
+                input[1] = [Authorization: 'Bearer test-token']
+                """
+            }
+        }
+
+        then {
+            assert function.success
+            assert function.result*.taskId == (1..102).toList()
+        }
+    }
+
+    test("resolveWorkspaceId returns the matching workspace id") {
+        function "SeqeraApi.resolveWorkspaceId"
+
+        when {
+            function {
+                """
+                SeqeraApi.metaClass.'static'.apiGet = { String url, Map headers ->
+                    if (url == 'https://api.example.com/orgs') {
+                        return [organizations: [[name: 'acme', orgId: 7], [name: 'other', orgId: 8]]]
+                    }
+                    if (url == 'https://api.example.com/orgs/7/workspaces') {
+                        return [workspaces: [[name: 'workspace-a', id: 11], [name: 'workspace-b', id: 42]]]
+                    }
+                    throw new RuntimeException("Unexpected URL: \${url}")
+                }
+
+                input[0] = 'acme/workspace-b'
+                input[1] = 'https://api.example.com'
+                input[2] = [Authorization: 'Bearer test-token']
+                """
+            }
+        }
+
+        then {
+            assert function.success
+            assert function.result == 42L
+        }
+    }
+
+    test("resolveWorkspaceId fails when the workspace is missing") {
+        function "SeqeraApi.resolveWorkspaceId"
+
+        when {
+            function {
+                """
+                SeqeraApi.metaClass.'static'.apiGet = { String url, Map headers ->
+                    if (url == 'https://api.example.com/orgs') {
+                        return [organizations: [[name: 'acme', orgId: 7]]]
+                    }
+                    if (url == 'https://api.example.com/orgs/7/workspaces') {
+                        return [workspaces: [[name: 'workspace-a', id: 11]]]
+                    }
+                    throw new RuntimeException("Unexpected URL: \${url}")
+                }
+
+                input[0] = 'acme/workspace-b'
+                input[1] = 'https://api.example.com'
+                input[2] = [Authorization: 'Bearer test-token']
+                """
+            }
+        }
+
+        then {
+            assert function.failed
+            assert function.stdout.any { it.contains("Workspace 'workspace-b' not found in org 'acme'") }
+        }
+    }
+}