Summary

• make local pnpm test worker defaults memory-tiered by host RAM in scripts/test-parallel.mjs
• keep aggressive parallel defaults for high-memory local hosts (>=96 GiB)
• default sub-64 GiB hosts to conservative low-style workers and serial gateway to avoid OOM
• add a concise AGENTS note with a safe local gate command when Vitest memory pressure is observed

Why

Recent parallel worker tuning made local Vitest runs on lower-memory machines hit extreme RSS and destabilize the host during land/gate workflows.

Validation

• pnpm check
• pnpm build
• monitored pnpm test on this machine after patch: completed with peak RSS ~10.06 GiB (previously default profile was peaking around ~18.3 GiB and being terminated for safety)

Greptile Summary

Tiered local Vitest worker defaults by host memory to prevent OOM on lower-memory machines during pnpm test runs.

• Introduced memory-based host classification (high >=96 GiB, low <64 GiB, mid 64-95 GiB)
• High-memory hosts (Mac Studio class) maintain aggressive parallel defaults for fast wall-clock times
• Low-memory hosts (<64 GiB) default to conservative workers (unit=2, unitIsolated=1, extensions=1, gateway=1) to avoid OOM
• Mid-range hosts (64-95 GiB) get moderate parallelism with conservative gateway settings
• Gateway parallel mode now enabled automatically on high-memory local hosts
• Added AGENTS.md note documenting the manual override command for users experiencing memory pressure

Confidence Score: 5/5

• Safe to merge - addresses a validated operational issue with a well-structured solution
• The changes are defensive, well-tested by the author (validated RSS reduction from ~18.3 GiB to ~10.06 GiB), and preserve existing behavior for high-memory hosts while fixing OOM issues on lower-memory machines. The logic is clear with reasonable thresholds, and the documentation update provides a manual escape hatch for users.
• No files require special attention

_{Last reviewed commit: 27a8cbd}