Skip to content

feat: add 'tw info versions' and studio stars - #699

Merged
cristianrcv merged 5 commits into
masterfrom
feat/NOTASK-tw-api-1.190
Oct 7, 2026
Merged

cristianrcv merged 5 commits into
masterfrom
feat/NOTASK-tw-api-1.190

Conversation

@cristianrcv

@cristianrcv cristianrcv commented Oct 5, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds two features, on top of master (SDK 1.233.0):

  • tw info versions: lists the Nextflow versions you can launch with (GET /platform/versions, API 1.190). When the Platform version catalog is enabled, it reads the catalog instead, and -c fusion lists Fusion versions (/catalog/components/{key}/versions, API 1.230). --nextflow and --fusion filter by compatibility.
  • tw studios star|unstar, plus a "Starred" row in tw studios view (API 1.190).

Changes

  • feat(info): add 'tw info versions' to list launchable Nextflow versions (90642bb)
  • feat(studios): add star and unstar (c356ef3)
  • feat(info): list Fusion versions from the compatibility catalog in 'tw info versions' (b99341f)
  • docs: document 'tw info versions' and studio stars (a499b79)
  • build(native): register reflection metadata for 'info versions' and studio stars (613eeda)

Notes for review

Verification

  • ./gradlew test: 870 tests, 0 failures.
  • CI runs the full suite against the native binary on Linux, macOS and Windows.

🤖 Generated with Claude Code

@cristianrcv
cristianrcv added this pull request to stack #704 October 5, 2026 16:12
@cristianrcv
cristianrcv requested review from a team, educalleja, t0randr and vpatel85 October 5, 2026 16:18
@cristianrcv
cristianrcv removed this pull request from stack #704 October 5, 2026 16:20
@cristianrcv
cristianrcv added this pull request to stack #705 October 5, 2026 16:20

@educalleja educalleja left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Usage of the new commands

This PR adds two things: tw info versions and tw studios star|unstar. The agents commands from API 1.190 are in the agents PR (#702).

1. tw info versions (new)

Lists the Nextflow versions you can launch with. It takes no options.

  • The output is a table with Version and Default (yes/no).
  • The help for --nextflow-version (used by tw launch, tw pipelines add|update and others) now points to this command.

2. tw studios star / tw studios unstar (new)

Adds a studio to your starred studios, or removes it.

Option Description
-i, --id / -n, --name The studio, by session ID or by name. You must give exactly one
-w, --workspace Workspace
  • The output is "Studio <studio> starred at <workspace> workspace." (or unstarred).
  • tw studios view now shows Starred.

USAGE.md

  • tw info versions is mentioned next to the --tower-config bullet.
  • The studios bullet changes to tw studios star|unstar|extend|rename-checkpoint.

There's no example for either command. A possible one:

tw info versions
tw studios star -w my-org/my-workspace -n my-studio

🤖 Generated with Claude Code

@cristianrcv
cristianrcv removed this pull request from stack #705 October 7, 2026 13:26
cristianrcv and others added 5 commits October 7, 2026 16:59
--nextflow-version must name a version Platform knows, but tw had no
way to list them. Platform API 1.190.0 added GET /platform/versions,
which returns the configured Nextflow versions and the default one,
as the launch form uses them.

It lives under 'tw info' because it describes the Platform deployment
rather than a workspace resource: 'tw launch' takes a positional
pipeline name a subcommand would shadow, and 'tw pipelines versions'
already means pipeline versions. The --nextflow-version help now points
at it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Platform API 1.190.0 added studio starring (POST/DELETE
/studios/{sessionId}/star) and the starred flag on studio describe,
but tw never wired them up. This adds 'tw studios star|unstar' so CLI
users can do what the UI already does. 'studios view' now shows the
starred flag so the result of star/unstar is visible.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…w info versions'

--fusion-version must name a version Platform knows, but 'tw info
versions' only listed the Nextflow versions configured in
GET /platform/versions (API 1.190.0). API 1.230.0 (COMP-2121) added
GET /catalog/components/{key}/versions: the catalog's non-yanked
versions of one component with its default, optionally constrained by
compatibility with other components. It only exists when the catalog is
enabled, which /platform/versions reports as catalogEnabled.

The command now mirrors the launch form: it reads /platform/versions,
and when the catalog is on it lists the requested component
(-c nextflow|fusion) from the catalog, constrained to this Platform
release (the form passes the same platform context). --nextflow/--fusion
narrow the list to versions compatible with the given ones, e.g. the
Fusion versions that work with a Nextflow pick. Without the catalog only
Nextflow versions exist, so asking for another component or a
compatibility filter fails instead of returning a list that silently
ignores the request.

The aggregated /catalog/versions is not used: across all components it
also returns platform, wave and sched, which have no launch option.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
'Other additions' entries for 'tw info versions' (Nextflow and Fusion versions) and 'tw studios star|unstar'.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
…tudio stars

Entries for the 'info versions' and 'studios star|unstar' commands and responses, taken from a full test run under the GraalVM tracing agent. Response classes register allDeclaredFields, since Jackson serializes every field for -o json.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@cristianrcv
cristianrcv force-pushed the feat/NOTASK-tw-api-1.190 branch from a1a7bf9 to 613eeda Compare October 7, 2026 15:01
@cristianrcv
cristianrcv changed the base branch from feat/NOTASK-tw-api-1.167 to master October 7, 2026 15:01
@cristianrcv cristianrcv changed the title feat: support Platform API 1.190 features (studio stars, Nextflow versions) feat: add 'tw info versions' and studio stars Oct 7, 2026
@cristianrcv
cristianrcv merged commit cb6e189 into master Oct 7, 2026
9 checks passed

@jonmarti jonmarti left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@cristianrcv
cristianrcv deleted the feat/NOTASK-tw-api-1.190 branch October 8, 2026 09:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants