Skip to content

vox-integration-tests API Reference (generated)

Crate: vox-integration-tests · Version: 0.6.0 · Target: Library (lib.rs)

Cross-crate integration test harness (test-only L5).

Integration test harness crate (no public API).

Tests live under crates/vox-integration-tests/tests/. This library target exists so integration tests can share helpers if needed without publishing a surface area.

The ts_emit_* test files all gate on the same emitted-TypeScript tsc --noEmit contract, so their shared plumbing (path resolution, fixture collection, the strict tsconfig, and the node-direct tsc invocation) lives here once instead of being copy-pasted per file — that copy-paste previously let each file’s tsconfig drift independently, which is exactly the risk the negative-control test exists to catch.

DependencyKind
vox-actor-runtimeDevelopment
vox-bounded-fsDevelopment
vox-cliDevelopment
vox-codegenDevelopment
vox-compilerDevelopment
vox-configDevelopment
vox-deploy-codegenDevelopment
vox-lspDevelopment
vox-orchestratorDevelopment
vox-orchestrator-mcpDevelopment
vox-plugin-apiDevelopment
vox-repositoryDevelopment
vox-scaling-policyDevelopment
vox-secretsDevelopment
vox-skillsDevelopment
vox-speechDevelopment
vox-test-harnessDevelopment
vox-workflow-runtimeDevelopment
FunctionDescription
strip_unc_prefixStrip the Windows \\?\ UNC prefix that canonicalize() adds on Windows. cmd.exe and many CLI tools cannot handle the extended-length path prefix.
ts_scratch_dirAbsolute path to the ts-noemit-scratch dir that contains node_modules and the base tsconfig.json used by every TS-emit-typecheck gate test.
collect_vox_filesCollect all .vox files directly under dir (non-recursive), sorted for determinism. Propagates read_dir/entry errors rather than swallowing them into an empty Vec — a caller silently seeing “zero fixtures” for an unreadable directory looks identical to “the corpus is genuinely empty,” which would let a corpus-comparison test complete having compared nothing.
strict_tsconfig_jsonThe canonical strict tsconfig.json (compilerOptions + include) shared by every TS-emit-typecheck gate test. The negative-control test’s entire premise is proving that THIS SAME config rejects bad TypeScript — keep it in exactly one place so that invariant can’t silently drift between the positive gate and the negative control.
run_tsc_noemitResolve tsc’s CLI entrypoint under scratch/node_modules/typescript/bin/tsc and run tsc --noEmit --project <tsconfig> by invoking node directly. The node_modules/.bin/tsc(.cmd) shims rely on PATH resolution that fails under nextest on Windows (‘node’ is not recognized); this is portable and shim-free.
env_var_lockTake ENV_VAR_LOCK (recovering from a poisoned lock), then mutate env vars through vox_test_harness::env_scratch::EnvScratch, the workspace’s one reviewed set_var site. Bind the lock BEFORE the scratch. Locals drop in reverse order, so the vars are restored while the lock is still held, even during a panic unwind.
Dependency Topology, diagram 113 nodes, 12 edges: vox-integration-tests → vox-actor-runtime; vox-integration-tests → vox-bounded-fs; vox-integration-tests → vox-cli; vox-integration-tests → vox-codegen; vox-integration-tests → vox-compiler; vox-integration-tests → vox-config; vox-integration-tests → vox-deploy-codegen; vox-inte…vox-integration-testsvox-actor-runtimevox-bounded-fsvox-clivox-codegenvox-compilervox-configvox-deploy-codegenvox-lspvox-orchestratorvox-orchestrator-mcpvox-plugin-apivox-repository
Diagram source
graph {
direction: right
node vox_integration_tests: "vox-integration-tests"
node vox_actor_runtime: "vox-actor-runtime"
vox_integration_tests -> vox_actor_runtime
node vox_bounded_fs: "vox-bounded-fs"
vox_integration_tests -> vox_bounded_fs
node vox_cli: "vox-cli"
vox_integration_tests -> vox_cli
node vox_codegen: "vox-codegen"
vox_integration_tests -> vox_codegen
node vox_compiler: "vox-compiler"
vox_integration_tests -> vox_compiler
node vox_config: "vox-config"
vox_integration_tests -> vox_config
node vox_deploy_codegen: "vox-deploy-codegen"
vox_integration_tests -> vox_deploy_codegen
node vox_lsp: "vox-lsp"
vox_integration_tests -> vox_lsp
node vox_orchestrator: "vox-orchestrator"
vox_integration_tests -> vox_orchestrator
node vox_orchestrator_mcp: "vox-orchestrator-mcp"
vox_integration_tests -> vox_orchestrator_mcp
node vox_plugin_api: "vox-plugin-api"
vox_integration_tests -> vox_plugin_api
node vox_repository: "vox-repository"
vox_integration_tests -> vox_repository
}
KindSymbolSignatureSourceDescription
fnstrip_unc_prefixpub fn strip_unc_prefix(p: PathBuf) -> PathBufcrates/vox-integration-tests/src/lib.rs#L19-L32Strip the Windows \\?\ UNC prefix that canonicalize() adds on Windows. cmd.exe and many CLI tools cannot handle the extended-length path prefix.
fnts_scratch_dirpub fn ts_scratch_dir() -> PathBufcrates/vox-integration-tests/src/lib.rs#L36-L43Absolute path to the ts-noemit-scratch dir that contains node_modules and the base tsconfig.json used by every TS-emit-typecheck gate test.
fncollect_vox_filespub fn collect_vox_files(dir: &Path) -> std::io::Result<Vec<PathBuf>>crates/vox-integration-tests/src/lib.rs#L51-L61Collect all .vox files directly under dir (non-recursive), sorted for determinism. Propagates read_dir/entry errors rather than swallowing them into an empty Vec — a caller silently seeing “zero fixtures” for an unreadable directory looks identical to “the corpus is genuinely empty,” which would let a corpus-comparison test complete having compared nothing.
fnstrict_tsconfig_jsonpub fn strict_tsconfig_json() -> serde_json::Valuecrates/vox-integration-tests/src/lib.rs#L67-L83The canonical strict tsconfig.json (compilerOptions + include) shared by every TS-emit-typecheck gate test. The negative-control test’s entire premise is proving that THIS SAME config rejects bad TypeScript — keep it in exactly one place so that invariant can’t silently drift between the positive gate and the negative control.
fnrun_tsc_noemitpub fn run_tsc_noemit(scratch: &Path, tsconfig_path: &Path) -> std::process::Outputcrates/vox-integration-tests/src/lib.rs#L89-L108Resolve tsc’s CLI entrypoint under scratch/node_modules/typescript/bin/tsc and run tsc --noEmit --project <tsconfig> by invoking node directly. The node_modules/.bin/tsc(.cmd) shims rely on PATH resolution that fails under nextest on Windows (‘node’ is not recognized); this is portable and shim-free.
fnenv_var_lockpub fn env_var_lock() -> MutexGuard<'static, ()>crates/vox-integration-tests/src/lib.rs#L124-L126Take ENV_VAR_LOCK (recovering from a poisoned lock), then mutate env vars through vox_test_harness::env_scratch::EnvScratch, the workspace’s one reviewed set_var site. Bind the lock BEFORE the scratch. Locals drop in reverse order, so the vars are restored while the lock is still held, even during a panic unwind.