Skip to content

feat: add --list-tasks and --start-at-task for inspection and resume#232

Merged
josegonzalez merged 3 commits intomainfrom
212-add-list-tasks-and-start-at-task
Apr 29, 2026
Merged

feat: add --list-tasks and --start-at-task for inspection and resume#232
josegonzalez merged 3 commits intomainfrom
212-add-list-tasks-and-start-at-task

Conversation

@josegonzalez
Copy link
Copy Markdown
Member

Summary

--list-tasks on apply and plan walks the resolved task plan post --play / --tags filtering and post loop: expansion and prints one line per envelope without running. when: predicates evaluate against inputs only; predicates that reference .registered render as [unknown].

--start-at-task <name> on apply skips earlier tasks (rendered as [skipped] ... (before --start-at-task)) and runs from the matched task onward, including descending into a block: group when the match lives inside.

validate --strict gains cross-reference checks for --play and --start-at-task, surfacing unknown_play_reference / unknown_start_at_task problems for typos before they reach apply.

Closes #212.

`--list-tasks` on `apply` and `plan` walks the resolved task plan post `--play` / `--tags` filtering and post `loop:` expansion and prints one line per envelope without running. `when:` predicates evaluate against inputs only; predicates that reference `.registered` render as `[unknown]`. `--start-at-task <name>` on `apply` skips earlier tasks (with a `(before --start-at-task)` reason) and runs from the matched task onward, including descending into a `block:` group when the match lives inside. `validate --strict` gains cross-reference checks for `--play` and `--start-at-task`, surfacing `unknown_play_reference` / `unknown_start_at_task` problems for typos before they reach `apply`.
@dokku-bot
Copy link
Copy Markdown

sh-checker report

To get the full details, please check in the job output.

shellcheck errors
shellcheck checking is disabled.
shfmt errors

'shfmt -l -d -i 2' returned error 1 finding the following formatting issues:

----------
tests/bats/list_resume.bats
diff tests/bats/list_resume.bats.orig tests/bats/list_resume.bats
--- tests/bats/list_resume.bats.orig
+++ tests/bats/list_resume.bats
@@ -57,7 +57,7 @@
   assert_output --partial "docket-test-list-1"
   assert_output --partial "docket-test-list-2"
   run dokku apps:exists docket-test-list-1
-  assert_failure   # never created
+  assert_failure # never created
 }
 
 @test "--list-tasks honors --tags filter" {
@@ -133,7 +133,7 @@
   assert_output --partial "[skipped] first"
   assert_output --partial "before --start-at-task"
   run dokku apps:exists docket-test-start-at-first
-  assert_failure   # skipped
+  assert_failure # skipped
   run dokku apps:exists docket-test-start-at-second
   assert_success
   run dokku apps:exists docket-test-start-at-third
----------

You can reformat the above files to meet shfmt's requirements by typing:

  shfmt -l -d -i 2 -w filename


The loader auto-names entries that omit `name:` as `task #N <hex>`, so a recipe written entirely with shorthand (`- dokku_app: { app: ... }`) renders as opaque random suffixes in --list-tasks output. When the envelope name matches the auto pattern, fall back to `<TypeName>: <body identifier>` (App, Name, Service, Repository, Mount, Url) so the listing reads back the body the user wrote.
@josegonzalez josegonzalez merged commit 2ed54f2 into main Apr 29, 2026
10 checks passed
@josegonzalez josegonzalez deleted the 212-add-list-tasks-and-start-at-task branch April 29, 2026 14:01
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.

Add --list-tasks and --start-at-task for inspection and resume

2 participants