@webpresso/agent-config 0.3.6 → 0.4.1

package/README.md

@@ -30,6 +30,10 @@ also re-exports the shared low-level primitives sourced from
 - `@webpresso/agent-config/stryker`
 - `@webpresso/agent-config/workers-test`
 
+The Vitest surface includes stable group ordering, explicit staged-worker
+selection, and root-aware Node project construction. Consumers keep ownership
+of package-specific worker defaults, include patterns, aliases, and setup files.
+
 ## Relationship to other packages
 
 - `@webpresso/agent-config` — consumer-installed package surface

package/dist/esm/automation-authoring/index.d.ts

@@ -0,0 +1 @@
+export * from "@webpresso/agent-core/automation-authoring";

package/dist/esm/automation-authoring/index.js

@@ -0,0 +1,3 @@
+// Consumer surface: re-export agent-core's sealed automation authoring contract
+// so consumers depend on @webpresso/agent-config alone when preferred.
+export * from "@webpresso/agent-core/automation-authoring";

package/dist/esm/vitest/group-order.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveVitestGroupOrderFor(seed: string, offset?: number): number;
+export declare function resolveVitestGroupOrder(offset?: number): number;

package/dist/esm/vitest/group-order.js

@@ -0,0 +1,17 @@
+import { readConsumerPackageJson } from "./consumer-package.js";
+function stableHash(input) {
+    let hash = 0;
+    for (const char of input) {
+        hash = (hash * 31 + char.charCodeAt(0)) % 1000;
+    }
+    return hash;
+}
+function consumerName() {
+    return readConsumerPackageJson()?.name ?? process.cwd();
+}
+export function resolveVitestGroupOrderFor(seed, offset = 0) {
+    return 1000 + stableHash(seed) + offset;
+}
+export function resolveVitestGroupOrder(offset = 0) {
+    return resolveVitestGroupOrderFor(consumerName(), offset);
+}

package/dist/esm/vitest/node.d.ts

@@ -16,7 +16,10 @@ export type ResolveAliasEntry = {
     find: string | RegExp;
     replacement: string;
 };
+export declare function resolveStagedMaxWorkers(defaultMaxWorkers: number): number;
 export interface CreateNodeProjectsOptions {
+    /** Absolute package root. A verified-empty root omits the integration project. */
+    root?: string;
     unitInclude?: string[];
     unitExclude?: string[];
     integrationInclude?: string[];
@@ -24,6 +27,7 @@ export interface CreateNodeProjectsOptions {
     fileParallelism?: boolean;
     isolate?: boolean;
     testTimeout?: number;
+    hookTimeout?: number;
     /**
      * Extra resolve aliases appended (after the built-ins) to BOTH the unit and
      * integration projects. Lets a consumer inject repo-specific module rewrites

package/dist/esm/vitest/node.js

@@ -11,15 +11,19 @@
  * }))
  * ```
  */
-import { dirname, join } from "node:path";
+import { globSync, readdirSync, statSync } from "node:fs";
+import { dirname, isAbsolute, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { defineConfig } from "vite-plus/test/config";
 import { createFlakinessReporter } from "./flakiness-reporter.js";
 import { generatedRuntimeAliases } from "./generated-runtime-aliases.js";
-import { resolvedExecArgv, resolvedMaxWorkers, resolvedPool } from "./pool-defaults.js";
+import { resolveVitestGroupOrder } from "./group-order.js";
+import { parsePositiveInt, resolvedExecArgv, resolvedMaxWorkers, resolvedPool, } from "./pool-defaults.js";
 import { assertNonWorkersVitest4 } from "./version-guard.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const configDir = __dirname;
+const groupOrder = resolveVitestGroupOrder();
+const maxDiscoveryEntries = 10_000;
 assertNonWorkersVitest4({ caller: "nodeConfig" });
 // Route bun:sqlite → better-sqlite3 shim so Node-based vitest can load `@webpresso/agent-kit/blueprint`.
 const bunSqliteAlias = [
@@ -32,6 +36,46 @@ const bunSqliteAlias = [
 const webpressoInline = {
     deps: { inline: [/webpresso/] },
 };
+export function resolveStagedMaxWorkers(defaultMaxWorkers) {
+    const forcedMaxWorkers = parsePositiveInt(process.env["VITEST_MAX_WORKERS"]);
+    if (forcedMaxWorkers !== undefined)
+        return forcedMaxWorkers;
+    return process.env["VP_RUN_CONCURRENCY_LIMIT"] ? 1 : defaultMaxWorkers;
+}
+function hasMatchingFiles(root, patterns) {
+    try {
+        if (!isAbsolute(root) || !statSync(root).isDirectory())
+            return true;
+        const matches = globSync(patterns, {
+            cwd: root,
+            exclude: ["**/.stryker-tmp/**", "**/node_modules/**"],
+        });
+        if (matches.length > 0)
+            return true;
+        // `globSync` can silently skip EACCES directories and report an empty
+        // result. Enumerate the same discoverable tree explicitly before treating
+        // emptiness as proof; Dirent checks avoid following symlink loops.
+        const pending = [root];
+        let discoveredEntries = 0;
+        while (pending.length > 0) {
+            const directory = pending.pop();
+            if (!directory)
+                continue;
+            for (const entry of readdirSync(directory, { withFileTypes: true })) {
+                discoveredEntries += 1;
+                if (discoveredEntries > maxDiscoveryEntries)
+                    return true;
+                if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== ".stryker-tmp") {
+                    pending.push(join(directory, entry.name));
+                }
+            }
+        }
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
 /**
  * Create vitest projects for unit/integration test split.
  *
@@ -60,6 +104,7 @@ export function createNodeProjects(name, options = {}) {
     const projectFileParallelism = options.fileParallelism;
     const projectIsolate = options.isolate;
     const projectTestTimeout = options.testTimeout;
+    const projectHookTimeout = options.hookTimeout;
     const extraAlias = options.extraAlias ?? [];
     const extraSetupFiles = options.extraSetupFiles ?? [];
     const sharedResolve = {
@@ -69,13 +114,16 @@ export function createNodeProjects(name, options = {}) {
     const projectInline = {
         deps: { inline: [...webpressoInline.deps.inline, ...(options.extraInline ?? [])] },
     };
-    return [
+    const projects = [
         {
             resolve: sharedResolve,
             server: projectInline,
             test: {
                 server: projectInline,
                 name: `${name}/unit`,
+                sequence: {
+                    groupOrder,
+                },
                 globals: true,
                 restoreMocks: true,
                 environment: "node",
@@ -84,6 +132,7 @@ export function createNodeProjects(name, options = {}) {
                 fileParallelism: projectFileParallelism,
                 isolate: projectIsolate,
                 ...(projectTestTimeout !== undefined && { testTimeout: projectTestTimeout }),
+                ...(projectHookTimeout !== undefined && { hookTimeout: projectHookTimeout }),
                 ...(extraSetupFiles.length > 0 && { setupFiles: [...extraSetupFiles] }),
                 include: unitInclude,
                 exclude: [
@@ -94,11 +143,16 @@ export function createNodeProjects(name, options = {}) {
                 ],
             },
         },
-        {
+    ];
+    if (!options.root || hasMatchingFiles(options.root, integrationInclude)) {
+        projects.push({
             resolve: sharedResolve,
             server: projectInline,
             test: {
                 name: `${name}/integration`,
+                sequence: {
+                    groupOrder: groupOrder + 1,
+                },
                 globals: true,
                 restoreMocks: true,
                 environment: "node",
@@ -107,6 +161,7 @@ export function createNodeProjects(name, options = {}) {
                 fileParallelism: projectFileParallelism,
                 isolate: projectIsolate,
                 ...(projectTestTimeout !== undefined && { testTimeout: projectTestTimeout }),
+                ...(projectHookTimeout !== undefined && { hookTimeout: projectHookTimeout }),
                 execArgv: resolvedExecArgv,
                 onConsoleLog: () => false,
                 silent: process.env.VITEST_CONSOLE === "1" ? false : "passed-only",
@@ -116,8 +171,9 @@ export function createNodeProjects(name, options = {}) {
                 reporters: ["default", createFlakinessReporter()],
                 retry: process.env.CI ? 2 : 0,
             },
-        },
-    ];
+        });
+    }
+    return projects;
 }
 export const nodeConfig = defineConfig({
     resolve: {
@@ -126,6 +182,9 @@ export const nodeConfig = defineConfig({
     },
     server: webpressoInline,
     test: {
+        sequence: {
+            groupOrder,
+        },
         globals: true,
         restoreMocks: true,
         environment: "node",

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

@@ -3,7 +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));
-const parsePositiveInt = (value) => {
-    if (!value)
+export const parsePositiveInt = (value) => {
+    if (!value || !/^\d+$/.test(value))
         return;
-    const parsed = Number.parseInt(value, 10);
-    return Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
+    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/dist/esm/vitest/react.js

@@ -20,9 +20,11 @@ import react from "@vitejs/plugin-react";
 import { defineConfig } from "vite-plus/test/config";
 import { createFlakinessReporter } from "./flakiness-reporter.js";
 import { generatedRuntimeAliases, generatedRuntimeDedupe } from "./generated-runtime-aliases.js";
+import { resolveVitestGroupOrder } from "./group-order.js";
 import { resolvedExecArgv, resolvedMaxWorkers, resolvedMinWorkers, resolvedPool, } from "./pool-defaults.js";
 import { assertNonWorkersVitest4 } from "./version-guard.js";
 assertNonWorkersVitest4({ caller: "reactConfig" });
+const groupOrder = resolveVitestGroupOrder();
 export const reactConfig = defineConfig({
     plugins: [react()],
     resolve: {
@@ -31,6 +33,9 @@ export const reactConfig = defineConfig({
         tsconfigPaths: true,
     },
     test: {
+        sequence: {
+            groupOrder,
+        },
         globals: true,
         restoreAllMocks: true,
         environment: "happy-dom",

package/dist/esm/vitest/workers.d.ts

@@ -6,6 +6,9 @@ export declare const workersConfig: {
         tsconfigPaths: boolean;
     };
     test: {
+        sequence: {
+            groupOrder: number;
+        };
         globals: boolean;
         restoreMocks: boolean;
         reporters: string[];

package/dist/esm/vitest/workers.js

@@ -1,7 +1,9 @@
 import { defineConfig } from "vite-plus/test/config";
 import { createFlakinessReporter } from "./flakiness-reporter.js";
+import { resolveVitestGroupOrder } from "./group-order.js";
 import { assertVitest4 } from "./version-guard.js";
 assertVitest4({ caller: "workersConfig" });
+const groupOrder = resolveVitestGroupOrder();
 /**
  * Shared Vitest configuration for Cloudflare Workers
  */
@@ -10,6 +12,9 @@ export const workersConfig = defineConfig({
         tsconfigPaths: true,
     },
     test: {
+        sequence: {
+            groupOrder,
+        },
         globals: true,
         restoreMocks: true,
         reporters: ["default", createFlakinessReporter()],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/agent-config",
-  "version": "0.3.6",
+  "version": "0.4.1",
   "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,12 +16,17 @@
     "dist/esm",
     "!dist/**/*.map",
     "!dist/**/*.test.*",
-    "LICENSE",
-    "README.md"
+    "LICENSE"
   ],
   "type": "module",
   "sideEffects": false,
   "exports": {
+    "./automation-authoring": {
+      "import": {
+        "types": "./dist/esm/automation-authoring/index.d.ts",
+        "default": "./dist/esm/automation-authoring/index.js"
+      }
+    },
     "./deploy": {
       "import": {
         "types": "./dist/esm/deploy/index.d.ts",
@@ -100,6 +105,12 @@
         "default": "./dist/esm/vitest/flakiness-reporter.js"
       }
     },
+    "./vitest/group-order": {
+      "import": {
+        "types": "./dist/esm/vitest/group-order.d.ts",
+        "default": "./dist/esm/vitest/group-order.js"
+      }
+    },
     "./vitest/node": {
       "import": {
         "types": "./dist/esm/vitest/node.d.ts",
@@ -112,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",
@@ -167,8 +184,8 @@
   },
   "dependencies": {
     "@vitejs/plugin-react": "^6.0.3",
-    "@webpresso/agent-core": "0.1.3",
-    "vite": "^8.1.4",
+    "@webpresso/agent-core": "0.1.5",
+    "vite": "^8.1.5",
     "vite-plus": "^0.2.4",
     "vitest": "^4.1.10"
   },
@@ -213,6 +230,7 @@
       "src/**/__fixtures__/**"
     ],
     "exports": {
+      "./automation-authoring": "./src/automation-authoring/index.ts",
       "./deploy": "./src/deploy/index.ts",
       "./dev": "./src/dev/index.ts",
       "./e2e": "./src/e2e/index.ts",
@@ -226,8 +244,10 @@
       "./tsconfig/react-library.json": "./src/tsconfig/react-library.json",
       "./tsconfig/react-router.json": "./src/tsconfig/react-router.json",
       "./vitest/flakiness-reporter": "./src/vitest/flakiness-reporter.ts",
+      "./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",