v1.2.0-versioning.0

DO NOT USE IN PRODUCTION. This is a development release to make some worker versioning functionality available to try out.

What's Changed

• Replace runner macos-14 with macos-13 in CI tests by @rodrigozhou in #709
• Fix whitespace in temporal batch --help output by @josh-berry in #722
• ci: Directly check for needed secrets before testing against cloud by @josh-berry in #725
• Bump github.com/golang-jwt/jwt/v4 from 4.5.0 to 4.5.1 by @dependabot in #703

Full Changelog: v1.1.2...v1.2.0-versioning.0

v1.1.2

Highlights

• Updates Temporal Server to 1.25.2 and UI Server to 2.32.0.
• temporal workflow reset now respects the --reapply-* options when operating in batch mode.

What's Changed

• Fix mismatched go versions (and AS casing) by @LeeBrotherston in #702
• Improved docs gen by @prasek in #691
• Upgrade the macos runner in ci workflow by @rodrigozhou in #707
• Add reset reapply to batch reset command by @jamipouchi in #700
• change log-format to string-enum by @yuandrew in #711
• Fix flaky reset test by @dandavison in #713
• Version bumps: Server -> 1.25.2; UI Server -> 2.32.0 by @josh-berry in #712

New Contributors

• @LeeBrotherston made their first contribution in #702
• @jamipouchi made their first contribution in #700

Full Changelog: v1.1.1...v1.1.2

v1.1.1

Highlights

• Updates Temporal Server to v1.25.1, and UI Server to v2.31.2
• Improves --help documentation in several areas, especially for temporal operator nexus commands.
• Adds a global --command-timeout option to force the CLI to exit with an error if the command cannot be completed in the requested time.
• Adds a --rps option to batch operations to limit the number of requests per second.
• Adds an --id-conflict-policy option everywhere workflows are started that specifies what to do if the desired Workflow ID already exists.
• Fixes an issue where --reapply-type All was not re-applying Updates.

What's Changed

• Cap UI port at max value by @Sushisource in #671
• Use YAML for CLI command generation by @yuandrew in #666
• Batch rate limit by @stephanos in #675
• Create new string-enum[] type by @yuandrew in #677
• Add global context-rpc-timeout option by @yuandrew in #676
• Make --reapply-type All reapply updates in addition to signals by @dandavison in #680
• EDU-3157: Add instructions on how to remove Search Attributes by @fairlydurable in #683
• fix(sqlite): support all sqlite pragma statement by @vbehar in #682
• Improving Describe-TQ Command Description by @Shivs11 in #684
• Auto generate CLI docs for documentation repo by @yuandrew in #685
• Add id-conflict-policy by @yuandrew in #688
• Warn users not to use dev-server in production by @josh-berry in #689
• Update nexus commands.yml for docs gen by @prasek in #693
• update --command-timeout description by @prasek in #694
• Version bumps: Server -> 1.25.1; UI Server -> 2.31.2 by @josh-berry in #696

New Contributors

• @vbehar made their first contribution in #682
• @prasek made their first contribution in #693

Full Changelog: v1.1.0...v1.1.1

v1.1.0

💥 Breaking Changes

• temporal workflow update has been renamed to temporal workflow update execute, to allow for the creation of new workflow update sub-commands. All flags and behavior remain the same.

Highlights

• The temporal nexus suite of commands has been added to support Nexus, a new feature designed to connect durable executions across team, namespace, region, and cloud boundaries. It promotes a more modular architecture for sharing a subset of your team’s capabilities via well-defined service API contracts for other teams to use, that abstract underlying Temporal primitives, like Workflows, or execute arbitrary code. Learn more at: https://temporal.io/nexus
• The new temporal workflow update start command starts an Update asynchronously. Callers can wait for such an Update to complete by running an update execute or update result command against the same --workflow-id and --update-id.
• The new temporal workflow update result command waits for an Update to complete and fetches the result.
• The new temporal workflow update describe command reports the status of a running or recently-completed Update. Unlike update result and update execute, update describe does NOT wait for the update to complete, but returns status immediately.
• The temporal task-queue describe command now returns improved backlog stats including backlog count, age, and growth rate.
• Temporal Server has been updated to v1.25.0, and UI Server has been updated to v2.30.3.

What's Changed

• Nexus by @bergundy in #577
• Use static membership for devserver by @stephanos in #582
• Fix dev server search attribute registration helptext by @Sushisource in #636
• Include additional build-time information in the version string by @dandavison in #637
• Fix typo in schedule create example by @josh-berry in #640
• add --public-path option to the command by @ggrebert in #644
• Making tq stats visible from cli by @Shivs11 in #638
• Add workflow update start and workflow update execute subcommands by @dandavison in #642
• Upgrade server with endpoint regexp validation to allow "-" and deny "_" by @bergundy in #641
• Dump junit.xml by @dandavison in #650
• Upgrade server to 1.25.0-rc.2 by @bergundy in #655
• List schedules query param support by @justinp-tt in #654
• Reduce test suite time by @yuandrew in #656
• Remove in-development warning from README by @josh-berry in #657
• Update major Temporal dependencies by @josh-berry in #659
• Update major Temporal dependencies by @josh-berry in #661
• Update help text to conform to style by @josh-berry in #662
• Merge nexus branch into main by @josh-berry in #663
• Add workflow update result, update describe and result commands by @Sushisource in #658
• changes to tq-describe-command descriptions by @Shivs11 in #668

New Contributors

• @ggrebert made their first contribution in #644
• @Shivs11 made their first contribution in #638
• @justinp-tt made their first contribution in #654
• @yuandrew made their first contribution in #656

Full Changelog: v1.0.0...v1.1.0

v1.0.0

Temporal CLI Reaches 1.0

Temporal CLI is now considered featureful enough to be v1.0! 🎉 It continues to be production-quality.

Future releases will maintain the same commands, flags, behaviors, and JSON output to the extent possible (except for experimental features, which will be clearly marked as such in --help output). Text output is still subject to change.

Release Highlights (since v0.13.0)

• The experimental Worker Versioning feature was added in v0.13.1, making it easier to manage multiple worker versions running on the same task queue. (Commands associated with this feature are subject to change.)
• Search attributes can now be created during dev-server startup using the new --search-attribute flag.
• The --help output has been rewritten top-to-bottom to be more comprehensive and informative.

Upgrading from Older Versions

If you are switching from tctl or upgrading from a CLI version older than v0.12.0, please note that many commands have changed. See the release notes for v0.12.0 for more details.

What's Changed

• Supported flattened event detail view on workflow show/execute by @cretz in #615
• Tweak server start-up text by @dandavison in #624
• Fix nil deref if the env file can't be parsed by @josh-berry in #625
• Adjust dev-server tunables to avoid persistence rate-limiting by @josh-berry in #626
• EDU-2415: Improve CLI Help content by @fairlydurable in #561
• Dependency Updates: Server -> 1.24.2, Cobra -> 1.8.1, and more by @josh-berry in #630

Full Changelog: v0.13.2...v1.0.0

v0.14.0-nexus.0

⚠️ DO NOT USE IN PRODUCTION. This is a development release to make some Nexus functionality available to try out. ⚠️

What's Changed

• Supported flattened event detail view on workflow show/execute by @cretz in #615
• Tweak server start-up text by @dandavison in #624
• Fix nil deref if the env file can't be parsed by @josh-berry in #625
• Nexus by @bergundy in #577

Full Changelog: v0.13.2...v0.14.0-nexus.0

v0.13.2

What's Changed

• workflow show: Add blank line above Results: by @josh-berry in #603
• Fix commit rule confirmation message by @antlai-temporal in #610
• dev-server: Properly deal with IPv6 by @mjameswh in #611
• Update UI module for versioning pre-release by @antlai-temporal in #614
• Fix marshaling of payloads with null values by @dandavison in #617

Full Changelog: v0.13.1...v0.13.2

v0.13.1

Highlights

This is a minor release that introduces support for worker versioning using a new API provided by Temporal Servers with version 1.24.0+.

Worker versioning is an experimental feature, currently in pre-release, which associates Build IDs to worklfows and activities using rules, and then guarantees that only workers running compatible code will process their tasks. Rules are scoped by a task queue, and can be manipulated or listed with the CLI. For example:

      temporal task-queue versioning -t my-queue get-rules

Known Incompatibilities

task-queue describe is now returning task reachability information in addition to pollers info, to safely retire old workers using worker versioning. It uses an enhanced API that is not supported by a server with version <1.24.0. To access pollers information in older servers set the --legacy-mode flag, and select the task queue type using the --task-queue-type-legacy argument (if different from workflow).

What's Changed

• Accept search attributes for dev server and disable cache by default by @cretz in #593
• Trigger goreleaser on published release by @antlai-temporal in #598
• Support worker versioning with new API by @antlai-temporal in #596

Full Changelog: v0.13.0...v0.13.1

v0.13.0

Highlights

This release upgrades Temporal Server to version 1.24.1. It builds on the CLI refresh work of 0.12.0, which introduced many changes, please read the 0.12.0 release notes if upgrading from 0.11.X or older.

Known Incompatibilities

The --data option on temporal operator namespace create now provides multiple key-value pairs by repeating the --data flag. The former syntax of a single --data option with key-value pairs separated by commas is no longer supported. See #583 for details.

What's Changed

• Resurrect install.sh by @josh-berry in #540
• Tweak server start text by @dandavison in #554
• New flag: workflow show --event-details by @dandavison in #555
• Fix panic when started without a stdout by @mjameswh in #549
• Specify go compiler minor version by @dandavison in #563
• get-free-port: prevent duplicate ports on Linux by @mjameswh in #564
• Use server's timestamp.ParseDuration for all durations by @dnr in #572
• Add test to verify that Schedule memo can be updated by @antlai-temporal in #569
• Update the docker-builds repo when releases are published by @tdeebswihart in #570
• Setting host level mutable state cache size to 8k by @prathyushpv in #574
• Use "uses" instead of curl by @tdeebswihart in #575
• Fix setting env name with a property by @antlai-temporal in #568
• Revert "Use "uses" instead of curl (#575)" by @tdeebswihart in #576
• Fail on unknown environments by @Sushisource in #578
• Print encoding of workflow results by @Sushisource in #579
• Normalize semantic of --data args by @mjameswh in #583
• Normalize --name and --type flags on workflow commands by @cretz in #580
• Prepare dependencies and tests for CLI 0.13-rc.1 release (server v1.24.1) by @josh-berry in #584
• Update server & add --reapply-exclude flag to reset by @Sushisource in #588
• Pin goreleaser version by @antlai-temporal in #591
• Fix trigger-publish.yml to quote the commit hash by @antlai-temporal in #592
• Publish only non-RC releases by @antlai-temporal in #594

New Contributors

• @mjameswh made their first contribution in #549

Full Changelog: v0.12.0...v0.13.0

v0.13.0-rc.2

This release fixes some CI issues blocking the publishing of docker images. It also adds support for excluding some event types in workflow reset.

What's Changed

• Update server & add --reapply-exclude flag to reset by @Sushisource in #588
• Pin goreleaser version by @antlai-temporal in #591
• Fix trigger-publish.yml to quote the commit hash by @antlai-temporal in #592

Full Changelog: v0.13.0-rc.1...v0.13.0-rc.2