fix: always use half of available parallelism (#611)

* fix: always use half of available parallelism

* fix fallback docs

* revert docs

* tweak logic

src/polyfills/cpus.ts

@@ -5,5 +5,5 @@ import {
 
 export const availableParallelism = (): number =>
   typeof nodeAvailableParallelism === 'function'
-    ? Math.floor(nodeAvailableParallelism() / 2)
-    : (cpus()?.length ?? 1);
+    ? nodeAvailableParallelism()
+    : (cpus()?.length ?? 0);

src/services/run-tests.ts

@@ -97,7 +97,8 @@ export const runTestsParallel = async (
     ? [sanitizePath(dir)]
     : await listFiles(testDir, configs);
   const filesByConcurrency: string[][] = [];
-  const concurrencyLimit = configs?.concurrency ?? availableParallelism();
+  const concurrencyLimit =
+    configs?.concurrency ?? Math.max(Math.floor(availableParallelism() / 2), 1);
   const concurrencyResults: (boolean | undefined)[][] = [];
   const showLogs = !isQuiet(configs);
 

website/docs/documentation/poku/options/concurrency.mdx

@@ -5,7 +5,8 @@ sidebar_position: 8
 # `concurrency`
 
 When using `parallel` option, use `concurrency` to limit the number of tests running concurrently.<br />
-The default value is `0` (no limit).
+The default value is half of the available cores. When available, the `os.availableParallelism()` method is used. Otherwise Poku looks at the `os.cpus().length` or sets the value to `1`.<br />
+To allow unlimited parallelism set the value to `0`.
 
 ## CLI