velocious 1.0.260 → 1.0.263

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -91,6 +91,30 @@ testEvents.on("testRetried", ({testDescription, attemptNumber}) => {
91
91
  })
92
92
  ```
93
93
 
94
+ ## Parallel test splitting
95
+
96
+ Split test files across parallel CI jobs using `--groups` and `--group-number`.
97
+
98
+ ```bash
99
+ # Run group 1 of 4
100
+ npx velocious test --groups=4 --group-number=1
101
+
102
+ # Run group 2 of 4
103
+ npx velocious test --groups=4 --group-number=2
104
+
105
+ # Combine with tags
106
+ npx velocious test --groups=3 --group-number=1 --tag fast
107
+ ```
108
+
109
+ Files are distributed using a greedy load-balancing algorithm. Each file is
110
+ weighted by its spec directory (`system/` = 20, `frontend-models/` = 10,
111
+ `controller/` = 3, default = 1) with a 2x multiplier for `.browser-spec.js`
112
+ files. The heaviest files are assigned first to the group with the least
113
+ accumulated weight, producing balanced wall-clock times across groups.
114
+
115
+ The algorithm is deterministic: the same file list always produces the same
116
+ group assignments.
117
+
94
118
  ## Browser system tests
95
119
 
96
120
  Run browser compatibility tests via System Testing: