crystal-sycl

JIT include path configuration

AdaptiveCppCompiler now requires explicit include directories for JIT compilation. You can provide them in two ways:

1. CMake defaults (recommended):
   • CRYSTAL_INCLUDE_DIR
   • CRYSTAL_DEPS_INCLUDE_DIR
2. Runtime environment variables (override/fallback):
   • CRYSTAL_INCLUDE_DIR
   • CRYSTAL_DEPS_INCLUDE_DIR

The compiler validates both paths before calling acpp and fails early if a path is empty, missing, or not a directory.

Configure with CMake

cmake -S . -B build \
  -DCRYSTAL_INCLUDE_DIR="$PWD/include" \
  -DCRYSTAL_DEPS_INCLUDE_DIR="$PWD/deps/include"

Configure with environment variables

export CRYSTAL_INCLUDE_DIR="$PWD/include"
export CRYSTAL_DEPS_INCLUDE_DIR="$PWD/deps/include"

If constructor parameters/config values and environment variables are both present, environment variables are used first.

Runtime configuration

At startup db_cli reads runtime settings from the first existing file in this order:

1. path from CRYSTAL_CONFIG
2. ./crystal.conf
3. ./crystal-sycl.conf
4. $HOME/.config/crystal-sycl/config.conf

Environment variables CRYSTAL_INCLUDE_DIR and CRYSTAL_DEPS_INCLUDE_DIR override the same keys from the config file. CMake defaults remain a fallback.

See crystal.conf.example for supported keys, including JIT include paths, output limit, timing output and memory guard parameters.