diff --git a/public-docs/hub/configuration/hub-yml.md b/public-docs/hub/configuration/hub-yml.md index 9d8a44247..a478dcf1e 100644 --- a/public-docs/hub/configuration/hub-yml.md +++ b/public-docs/hub/configuration/hub-yml.md @@ -72,10 +72,18 @@ environments: cwd: /workspace/project worktree: mode: branch-off - newBranch: paseo/review + newBranch: trigger-${{ paseo.execution.id }} base: origin/main ``` +`newBranch` is a branch-name string. Embed `${{ paseo.execution.id }}`, which renders the execution's UUID, so every execution branches off `base` on its own branch and keeps it when Hub retries or recovers that execution. + +One execution is one step run, so two steps selecting the same environment get separate branches. + +`${{ paseo.execution.id }}` is the only expression `newBranch` accepts. `paseo.prompt`, `paseo.context`, `paseo.inputs.*`, `values.*`, `steps..outputs.*`, and provider event fields are unavailable here, and each one fails bundle activation at the authored field, such as `.paseo/hub.yml.environments.review.worktree.newBranch`. + +`${{ paseo.execution.id }}` fails activation the same way anywhere else in a bundle. `branch` and `prNumber` take literal values. + An environment is a complete named object. A step selects its name; objects are not inherited, merged, or partially overridden. ### Named agents diff --git a/public-docs/hub/daemons.md b/public-docs/hub/daemons.md index 2e0dce859..24ba7b5c6 100644 --- a/public-docs/hub/daemons.md +++ b/public-docs/hub/daemons.md @@ -80,11 +80,13 @@ To keep executions off your working tree, add a worktree: ```yaml worktree: mode: branch-off - newBranch: hub/investigation + newBranch: trigger-${{ paseo.execution.id }} base: origin/main ``` -See [Git worktrees](/docs/worktrees) for setup hooks and scripts. +`${{ paseo.execution.id }}` renders the execution's UUID, so every execution gets its own branch off `origin/main`. + +[Environment fields](/docs/hub/configuration/hub-yml#environments) lists what `newBranch` accepts. See [Git worktrees](/docs/worktrees) for setup hooks and scripts. ## What Hub owns