feat(serverless): activate a ready app version by number

[Ryank90]

Summary

• Add runware serverless apps versions activate <appId> <versionNumber> to pin or roll back a ready version via POST /v1/apps/{appId}/deploy
• Print the accepted app, including activeVersionId and status. Rollout to healthy workers is not waited on
• Surface 404 (unknown app) and 409 (missing/not-ready version, or deleting) from the problem body, with client tests for the happy path and conflict

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. To trigger a review, include coderabbit-review in the PR description. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 578f86e0-9817-4113-b4d7-80f05be939b4

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

🟢 Approval recommended

Functionality is covered with targeted client tests and integrates cleanly, with only minor UX/documentation clarity nits noted.

Pull request overview

Adds support for activating (“deploying”) a specific serverless app version by version number, enabling pin/rollback of a ready version via the serverless deploy endpoint and surfacing the accepted app state in CLI output.

Changes:

• Introduces runware serverless apps versions activate <appId> <versionNumber> and wires it into the versions command group.
• Adds DeployVersion to the serverless API client (POST /v1/apps/{appId}/deploy) with tests covering success, 404, and 409 cases.
• Enhances app display output to include activeVersionId, and updates generated command docs accordingly.

File summaries

File	Description
internal/cmd/serverless/display.go	Adds printing of the app’s active version ID in app detail output.
internal/cmd/serverless/display_test.go	Updates app display expectations to include active version ID.
internal/cmd/serverless/apps_versions.go	Extends versions command group and adds activate subcommand implementation.
internal/api/serverless/client.go	Adds DeployVersion client method and request type alias.
internal/api/serverless/client_test.go	Adds tests for deploy version happy path + 404/409 handling + no API key.
docs/runware_serverless_apps.md	Updates apps docs to reflect “Manage application versions”.
docs/runware_serverless_apps_versions.md	Updates versions group docs and links new activate command.
docs/runware_serverless_apps_versions_show.md	Updates “SEE ALSO” label to match new group description.
docs/runware_serverless_apps_versions_list.md	Updates “SEE ALSO” label to match new group description.
docs/runware_serverless_apps_versions_activate.md	Adds docs page for the new activate command.

Review details

• Files reviewed: 10/10 changed files
• Comments generated: 3
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.