You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/execution-model.md
+26-26Lines changed: 26 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -82,6 +82,31 @@ If an automation block does not have explicit triggers configured, it will be tr
82
82
!!! Note
83
83
The `on` parameter can be used within individual automation blocks, while `triggers.include` and `triggers.exclude` can only be defined at the file level.
84
84
85
+
**Note on Matching:**
86
+
87
+
- When using a `String` as the matching type, the values in `triggers.include.*` and `triggers.exclude.*` require exact matches. This means that the names of branches or repositories must exactly match the specified string to either trigger or prevent triggering the automation.
88
+
- For more precise control, use a regular expression (regex) format: `r/REGEX_PATTERN/`.
89
+
90
+
**Default Behavior:**
91
+
92
+
- Implicit triggers are the default behavior if the automation doesn't have explicit triggers configured.
93
+
- The automation runs for all branches and repositories if neither include nor exclude is specified.
94
+
95
+
**Exclude/Include prioritization**
96
+
97
+
- Exclude overrides the include option. Thus, a repo will be excluded when it matches the include and exclude lists.
98
+
99
+
In the following example, the automations in the file will be triggered for all repositories that contain the string `feature`, except for the repository `my_feature`
100
+
```yaml+jinja
101
+
triggers:
102
+
include:
103
+
repository:
104
+
- r/feature/
105
+
exclude:
106
+
repository:
107
+
- my_feature
108
+
```
109
+
85
110
## Action-Level Execution Control
86
111
87
112
gitStream provides intelligent action-level execution control that automatically skips certain actions based on the original triggering event. This feature helps reduce noise and ensures that AI-powered and code-related actions only execute when there are actual code changes, improving efficiency across all supported providers (GitLab, Bitbucket, and GitHub).
@@ -146,32 +171,7 @@ automations:
146
171
147
172
With implicit triggers (no explicit triggers configured), `describe-changes` will only execute when the automation is triggered by code changes, while `add-reviewers` follows the current default behavior.
148
173
149
-
**Note on Matching:**
150
-
151
-
- When using a `String` as the matching type, the values in `triggers.include.*` and `triggers.exclude.*` require exact matches. This means that the names of branches or repositories must exactly match the specified string to either trigger or prevent triggering the automation.
152
-
- For more precise control, use a regular expression (regex) format: `r/REGEX_PATTERN/`.
153
-
154
-
**Default Behavior:**
155
-
156
-
- Implicit triggers are the default behavior if the automation doesn't have explicit triggers configured.
157
-
- The automation runs for all branches and repositories if neither include nor exclude is specified.
158
-
159
-
**Exclude/Include prioritization**
160
-
161
-
- Exclude overrides the include option. Thus, a repo will be excluded when it matches the include and exclude lists.
162
-
163
-
In the following example, the automations in the file will be triggered for all repositories that contain the string `feature`, except for the repository `my_feature`
0 commit comments