Files
openclaude/scripts/openclaude-bin-heap.test.ts
T
BogdanandGitHub d427a4b2bb perf(cli): enable Node module compile cache (#2092)
* perf(cli): enable Node module compile cache

Warm CLI invocations spend substantial time compiling the bundled ESM entrypoint. Enable Node's optional on-disk compile cache only in the process that imports the bundle, while preserving early Node 22 compatibility and making cache failures non-fatal.

Add deterministic launcher coverage, packaging checks, and a reproducible benchmark procedure so the startup benefit can be measured without flaky CI thresholds.

* fix(ci): isolate minimum Node launcher check

The full validation suite depends on knip and oxc-parser behavior unavailable in Node 22.0.0. Keep full CI on the active Node 22 line and exercise the declared runtime floor in a dedicated build-and-launch job.

* fix(benchmark): harden startup measurements

Keep environment setup outside the timed process window, document the API's Node 22.8 floor, and preserve completed benchmark results when git metadata is unavailable.

* test(cli): verify compile cache disable behavior

Pair NODE_DISABLE_COMPILE_CACHE with a temporary cache directory and assert that supported Node releases leave it empty while preserving normal launcher output.
2026-08-07 09:55:01 +08:00

41 lines
1.8 KiB
TypeScript

import { readFileSync } from 'node:fs'
import { join } from 'node:path'
import { describe, expect, test } from 'bun:test'
const BIN_PATH = join(import.meta.dir, '..', 'bin', 'openclaude')
const COMPILE_CACHE_PATH = join(import.meta.dir, '..', 'bin', 'node-compile-cache.mjs')
describe('openclaude launcher heap guard', () => {
test('raises the current Node heap before loading dist/cli.mjs', () => {
const source = readFileSync(BIN_PATH, 'utf-8')
expect(source).toContain('--max-old-space-size=')
expect(source).toContain('--expose-gc')
expect(source).toContain('spawnSync(process.execPath')
const importingBranch = source.slice(source.indexOf('if (existsSync(distPath))'))
const relaunchIndex = importingBranch.indexOf('relaunchWithLongSessionHeapIfNeeded()')
const compileCacheIndex = importingBranch.indexOf('enableNodeCompileCacheIfAvailable()')
const importIndex = importingBranch.indexOf("await import(pathToFileURL(distPath).href)")
expect(relaunchIndex).toBeGreaterThanOrEqual(0)
expect(compileCacheIndex).toBeGreaterThan(relaunchIndex)
expect(importIndex).toBeGreaterThan(compileCacheIndex)
})
test('keeps user and troubleshooting escape hatches', () => {
const source = readFileSync(BIN_PATH, 'utf-8')
expect(source).toContain('OPENCLAUDE_DISABLE_HEAP_RELAUNCH')
expect(source).toContain('OPENCLAUDE_NODE_MAX_OLD_SPACE_SIZE_MB')
expect(source).toContain('process.env.NODE_OPTIONS')
expect(source).toContain("hasNodeOptionFlag('--max-old-space-size')")
})
test('feature-detects the compile-cache API without a named builtin import', () => {
const source = readFileSync(COMPILE_CACHE_PATH, 'utf-8')
expect(source).toContain("import * as nodeModule from 'node:module'")
expect(source).not.toMatch(/import\s*\{[^}]*enableCompileCache[^}]*\}\s*from\s*['"]node:module['"]/s)
})
})