vitest.config.ts

import { defineConfig, defineProject } from "vitest/config";
import { cpus } from "node:os";

const baseExclude = [
  "**/node_modules/**",
  "**/dist/**",
  "**/.review/**",
  "**/.worktrees/**",
  "**/.kspec-worktrees/**",
  "**/tests/e2e/**",
];

// These integration suites perform real git worktree/shadow-lock/bootstrap I/O.
// They pass in isolation but can time out when competing with the rest of the
// full suite, so run them in a dedicated serial project after the default pool.
const heavySerialSuites = [
  "tests/dispatch-workspace-config.test.ts",
  "tests/dispatch-workspace-registry.test.ts",
  "tests/dispatch-workspace-cleanup.test.ts",
  "tests/canonical-task-workspace-contract.test.ts",
  "tests/dispatch-runtime-bootstrap-contract.test.ts",
  // CLI-heavy integration suites that spawn 100+ subprocesses each.
  // Under full-suite concurrency they exhaust process/fd limits and
  // crash with STACK_TRACE_ERROR or assertion failures.
  "tests/integration.test.ts",
  "tests/agent-dispatch-engine.test.ts",
  "tests/activity-display.test.ts",
  "tests/cli/session-note-limit.test.ts",
  "tests/cli/session-start-format.test.ts",
  "tests/cli/session-start-notes.test.ts",
  "tests/cli/session-start-activity-timeline.test.ts",
  "tests/meta.test.ts",
];

// On machines with many cores vitest spawns one worker per core by default.
// Each worker can trigger dozens of kspec CLI subprocesses, leading to resource
// exhaustion (fd limits, process table pressure) on repeated full-suite runs.
// Cap at 8 workers to keep subprocess fan-out manageable.
const defaultMaxWorkers = Math.min(cpus().length, 8);

export default defineConfig({
  test: {
    projects: [
      defineProject({
        test: {
          name: "default",
          globals: true,
          environment: "node",
          testTimeout: 45_000,
          maxWorkers: defaultMaxWorkers,
          globalSetup: "./tests/global-setup.ts",
          setupFiles: ["./tests/setup.ts"],
          exclude: [...baseExclude, ...heavySerialSuites],
          sequence: {
            groupOrder: 0,
          },
        },
      }),
      defineProject({
        test: {
          name: "heavy-serial",
          globals: true,
          environment: "node",
          testTimeout: 45_000,
          globalSetup: "./tests/global-setup.ts",
          setupFiles: ["./tests/setup.ts"],
          include: heavySerialSuites,
          exclude: baseExclude,
          fileParallelism: false,
          maxWorkers: 1,
          sequence: {
            groupOrder: 1,
          },
        },
      }),
    ],
  },
});