Skip to content

run start: add --wait option - #107

Open
brandonc wants to merge 11 commits into
mainfrom
feature/run-start-wait
Open

run start: add --wait option#107
brandonc wants to merge 11 commits into
mainfrom
feature/run-start-wait

Conversation

@brandonc

Copy link
Copy Markdown
Collaborator

Description

#87 with a few changes

Example Output

PR Checklist

  • Run npx changie new or install changie to prepare a new changelog entry for the next set of release notes.
  • Ensure any command changes are sensitive to these global flags:
    • --json — Force machine readable output to stdout. Does not apply to stderr.
    • --markdown — Force markdown output to stdout. Does not apply to stderr.
    • --dry-run — Don't make any actual writes or other mutations. Describe what would have changed to stderr.
    • --quiet — Only render essential content.
  • Get the logging interface from the context and add debug logging for interesting conditions and nonfatal situations.
  • Run make gen/screenshot if the root command output changes.
  • Add the Autocomplete field to positional arguments and flags to assist shell autocomplete.

PCI review checklist

  • I have documented a clear reason for, and description of, the change I am making.

  • If applicable, I've documented a plan to revert these changes if they require more than reverting the pull request.

  • If applicable, I've documented the impact of any changes to security controls.

    Examples of changes to security controls include using new access control methods, adding or removing logging pipelines, etc.

jordanenglish and others added 10 commits August 17, 2026 11:16
`run start --wait` polls the newly created run to a terminal state,
streaming each status transition, and maps the outcome to an exit code:
applied / planned_and_finished / planned_and_saved succeed, while
errored, canceled, discarded, and policy failures exit non-zero. A plan
that finishes but needs a manual apply (auto-apply disabled) stops
rather than hanging.

--timeout bounds the wait; if it elapses, tfctl stops watching and exits
non-zero, but the run keeps running in HCP Terraform. On completion the
elapsed time and run URL are printed. The final summary reuses the same
renderer as `run status`.
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.

3 participants