@webpresso/agent-config 0.4.0 → 0.4.2

package/dist/esm/vitest/pool-defaults.d.ts

@@ -3,8 +3,28 @@
  *
  * Centralizes shared-runner detection, env var overrides, Stryker compatibility,
  * and execArgv logic used by node.ts, react.ts, and react-router.ts.
+ *
+ * CI defaults intentionally use available cores for file-level parallelism so
+ * consumer repos on 2-vCPU GitHub/Ubicloud runners get maxWorkers=2 instead of
+ * the old floor(cpus*0.75)=1 serial bottleneck. Shared workspace runners
+ * (VP_RUN_CONCURRENCY_LIMIT) still force a single worker because outer
+ * parallelism already fan-outs packages.
  */
 export declare const parsePositiveInt: (value: string | undefined) => number | undefined;
+export interface ResolveDefaultMaxWorkersOptions {
+    /** Logical CPU count; defaults to `os.cpus().length`. */
+    readonly cpuCount?: number;
+    /** Env bag; defaults to `process.env`. */
+    readonly env?: NodeJS.ProcessEnv;
+}
+/**
+ * Resolve the default Vitest `maxWorkers` when `VITEST_MAX_WORKERS` is unset.
+ *
+ * - Shared workspace runners (`VP_RUN_CONCURRENCY_LIMIT`): always 1.
+ * - CI (`CI=true` / `CI=1`): use all logical CPUs (min 1) so 2-core runners get 2 workers.
+ * - Local/dev: 75% of CPUs (min 1) to leave headroom for the editor/OS.
+ */
+export declare function resolveDefaultMaxWorkers(options?: ResolveDefaultMaxWorkersOptions): number;
 export declare const resolvedPool: string;
 export declare const resolvedMaxWorkers: number;
 export declare const resolvedMinWorkers: number;

package/dist/esm/vitest/pool-defaults.js

@@ -3,22 +3,38 @@
  *
  * Centralizes shared-runner detection, env var overrides, Stryker compatibility,
  * and execArgv logic used by node.ts, react.ts, and react-router.ts.
+ *
+ * CI defaults intentionally use available cores for file-level parallelism so
+ * consumer repos on 2-vCPU GitHub/Ubicloud runners get maxWorkers=2 instead of
+ * the old floor(cpus*0.75)=1 serial bottleneck. Shared workspace runners
+ * (VP_RUN_CONCURRENCY_LIMIT) still force a single worker because outer
+ * parallelism already fan-outs packages.
  */
 import { cpus } from "node:os";
-// Shared workspace runners need tighter worker caps to avoid oversubscription.
-// `VP_RUN_CONCURRENCY_LIMIT` is the native Vite+ knob for shared task scheduling.
-const underSharedWorkspaceRunner = !!process.env.VP_RUN_CONCURRENCY_LIMIT;
-// Under a shared runner, default to a single Vitest worker per package.
-// The workspace runner already provides outer parallelism, and allowing many
-// inner fork workers causes frequent shutdown timeouts and EPIPE crashes on
-// large happy-dom / integration suites.
-const MAX_WORKERS = underSharedWorkspaceRunner ? 1 : Math.max(1, Math.floor(cpus().length * 0.75));
 export const parsePositiveInt = (value) => {
     if (!value || !/^\d+$/.test(value))
         return;
     const parsed = Number(value);
     return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;
 };
+/**
+ * Resolve the default Vitest `maxWorkers` when `VITEST_MAX_WORKERS` is unset.
+ *
+ * - Shared workspace runners (`VP_RUN_CONCURRENCY_LIMIT`): always 1.
+ * - CI (`CI=true` / `CI=1`): use all logical CPUs (min 1) so 2-core runners get 2 workers.
+ * - Local/dev: 75% of CPUs (min 1) to leave headroom for the editor/OS.
+ */
+export function resolveDefaultMaxWorkers(options = {}) {
+    const env = options.env ?? process.env;
+    const underSharedWorkspaceRunner = Boolean(env.VP_RUN_CONCURRENCY_LIMIT);
+    if (underSharedWorkspaceRunner)
+        return 1;
+    const cpuCount = Math.max(1, Math.floor(options.cpuCount ?? cpus().length));
+    const inCi = env.CI === "true" || env.CI === "1";
+    if (inCi)
+        return cpuCount;
+    return Math.max(1, Math.floor(cpuCount * 0.75));
+}
 const requestedPool = process.env.VITEST_POOL;
 const disableExecArgv = process.env.VITEST_DISABLE_EXEC_ARGV === "1";
 const forcedMaxWorkers = parsePositiveInt(process.env.VITEST_MAX_WORKERS);
@@ -28,7 +44,7 @@ const isStryker = process.env.STRYKER_MUTATOR_WORKER !== undefined;
 // Auto-clear execArgv to prevent ERR_WORKER_INVALID_EXEC_ARGV crashes.
 // See: https://vitest.dev/config/pool.html#threads
 export const resolvedPool = requestedPool === "threads" ? "threads" : "forks";
-export const resolvedMaxWorkers = forcedMaxWorkers ?? MAX_WORKERS;
+export const resolvedMaxWorkers = forcedMaxWorkers ?? resolveDefaultMaxWorkers();
 export const resolvedMinWorkers = forcedMinWorkers ?? 1;
 // --max-old-space-size=1536: Cap V8 heap to 1.5GB (Node 24 default is 4.2GB).
 // Actual worker RSS is 100-230MB; 1.5GB is 6× headroom while reducing phys_footprint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/agent-config",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": false,
   "description": "Shared vitest, tsconfig, stryker, and workers-test config for webpresso consumers. Binary-free — pure test/config tooling.",
   "homepage": "https://github.com/webpresso/agent-kit#readme",
@@ -16,8 +16,7 @@
     "dist/esm",
     "!dist/**/*.map",
     "!dist/**/*.test.*",
-    "LICENSE",
-    "README.md"
+    "LICENSE"
   ],
   "type": "module",
   "sideEffects": false,
@@ -124,6 +123,12 @@
         "default": "./dist/esm/vitest/node-source.js"
       }
     },
+    "./vitest/pool-defaults": {
+      "import": {
+        "types": "./dist/esm/vitest/pool-defaults.d.ts",
+        "default": "./dist/esm/vitest/pool-defaults.js"
+      }
+    },
     "./vitest/react": {
       "import": {
         "types": "./dist/esm/vitest/react.d.ts",
@@ -179,9 +184,9 @@
   },
   "dependencies": {
     "@vitejs/plugin-react": "^6.0.3",
-    "@webpresso/agent-core": "0.1.4",
+    "@webpresso/agent-core": "0.1.5",
     "vite": "^8.1.5",
-    "vite-plus": "^0.2.4",
+    "vite-plus": "^0.2.5",
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
@@ -242,6 +247,7 @@
       "./vitest/group-order": "./src/vitest/group-order.ts",
       "./vitest/node": "./src/vitest/node.ts",
       "./vitest/node-source": "./src/vitest/node-source.ts",
+      "./vitest/pool-defaults": "./src/vitest/pool-defaults.ts",
       "./vitest/react": "./src/vitest/react.ts",
       "./vitest/react-router": "./src/vitest/react-router.ts",
       "./vitest/react-setup": "./src/vitest/react-setup.ts",