Makefile

# Lambda Project Makefile
# Utilizes Premake5 build system with standard make targets

# Project configuration
PROJECT_NAME = Lambda
DEFAULT_CONFIG = build_lambda_config.json

# Build configurations
BUILD_DIR = build
BUILD_DEBUG_DIR = build_debug
BUILD_RELEASE_DIR = build_release
BUILD_WINDOWS_DIR = build_windows
BUILD_LINUX_DIR = build_linux

# Output executables
LAMBDA_EXE = lambda.exe
LAMBDA_PROFILE_EXE = lambda-profile.exe
LAMBDA_CLI_EXE = lambda-cli.exe

# Unicode support is always enabled (utf8proc-based)
# No longer using conditional compilation flags

# Auto-detect number of jobs for parallel compilation
NPROCS := 1
OS := $(shell uname -s)
ifeq ($(OS),Darwin)
	NPROCS := $(shell sysctl -n hw.ncpu 2>/dev/null || nproc 2>/dev/null || echo 1)
	PREMAKE_FILE := premake5.mac.lua
	PREMAKE_CLI_FILE := premake5.cli.mac.lua
	PREMAKE_JUBE_FILE := premake5.jube.mac.lua
	MACOS_DEPLOYMENT_TARGET ?= $(or $(MACOSX_DEPLOYMENT_TARGET),15.0)
	MACOS_CMAKE_FLAGS := -DCMAKE_OSX_DEPLOYMENT_TARGET=$(MACOS_DEPLOYMENT_TARGET) -DCMAKE_OSX_SYSROOT=$(shell xcrun --show-sdk-path)
else ifeq ($(OS),Linux)
	NPROCS := $(shell nproc 2>/dev/null || echo 1)
	PREMAKE_FILE := premake5.lin.lua
	PREMAKE_CLI_FILE := premake5.cli.lin.lua
	PREMAKE_JUBE_FILE := premake5.jube.lin.lua
else
	# Windows/MSYS2 detection
	NPROCS := $(shell nproc 2>/dev/null || echo 4)
	PREMAKE_FILE := premake5.win.lua
	PREMAKE_CLI_FILE := premake5.cli.win.lua
	PREMAKE_JUBE_FILE := premake5.jube.win.lua
endif

# Keep the isolated CST profile's generated Premake file out of the normal
# profile's generated configuration while retaining the repository root as
# Premake's relative-path base.
LAMBDA_CST_PREMAKE_FILE := premake5.lambda-cst.lua

NPROCS := $(shell n="$(NPROCS)"; if expr "$$n" : '^[1-9][0-9]*$$' >/dev/null; then echo "$$n"; else echo 1; fi)

# Render visual tests are CPU-heavy but independent; leave one core free for
# the OS and browser/reference helpers.
RADIANT_RENDER_JOBS := $(shell n=$(NPROCS); if [ "$$n" -gt 1 ]; then echo $$((n - 1)); else echo 1; fi)
# DOM fixtures are process-isolated and CPU-heavy; bound concurrency while
# leaving one core available for the host. Override with DOM_UI_JOBS=<n>.
DOM_UI_JOBS ?= $(shell n=$(NPROCS); if [ "$$n" -gt 1 ]; then echo $$((n - 1)); else echo 1; fi)
LAYOUT_TEST_ENV ?= LAMBDA_AUTO_CLOSE=1
# Ranges and reflection remain extended `make test` coverage; their large
# known-failure inventories are not part of the fast Radiant baseline gate.
RADIANT_BASELINE_TEST_PROJECTS := test_ui_automation_gtest test_page_load_gtest test_radiant_view_gtest test_layout_fuzzy_gtest test_wpt_css_syntax_gtest test_wpt_input_events_gtest
RADIANT_DOM2_WPT_RUNNERS := input_events
# These are the native projects selected by test-lambda-baseline. Keep this
# list aligned with the runner's non-extended config projects; otherwise a
# clean baseline run reports a missing executable. The concurrency and Node
# preliminary projects remain excluded by that runner.
LAMBDA_BASELINE_TEST_PROJECTS := \
	test_lambda_gtest \
	test_lambda_parser_poc_gtest \
	test_mir_gc_stress_gtest \
	test_mir_ratchet_gtest \
	test_mir_emission_gtest \
	test_js_mir_emission_gtest \
	test_item_repr_gtest \
	test_lambda_typed \
	test_scalar_compare_gtest \
	test_binary_storage_gtest \
	test_lambda_errors_gtest \
	test_lambda_repl_gtest \
	test_lambda_proc_gtest \
	test_js_gtest \
	test_js_opt_gtest \
	test_lambda_opt_gtest \
	test_js_test262_gtest \
	test_compiler_pass_gtest \
	test_js_bt_regex_gtest \
	test_js_coerce_gtest \
	test_lambda_std_gtest \
	test_ts_gtest
# test-input-baseline invokes these five binaries directly, so keep their
# build separate from the full test aggregate and reusable by both targets.
INPUT_BASELINE_TEST_PROJECTS := \
	test_wpt_html_parser_gtest \
	test_markdown_gtest \
	test_yaml_suite_gtest \
	test_math_ascii_gtest \
	test_math_gtest
# GoogleTest emits pass/skip records and suite summaries unrelated to failures;
# retain runtime diagnostics and failure records so baseline output stays actionable.
GTEST_PROGRESS_FILTER = grep -vE '^Running main\(\) from |^Note: Google Test filter =|^\[ RUN      \]|^\[       OK \]|^\[  SKIPPED \]|^\[ DISABLED \]|^  YOU HAVE [0-9]+ DISABLED TESTS|^\[----------\]|^\[==========\]|^\[  PASSED  \]'

# Optimize parallel jobs: use all cores for compilation, limit linking to 1
JOBS := $(NPROCS)
LINK_JOBS := 1
# Fast debug test builds do not use ASan by default; use all cores for tests.
TEST_JOBS := $(NPROCS)

# ccache enablement moved below — must run AFTER the CC/CXX compiler-detection
# block (lines ~94-109) so the ccache prefix isn't overwritten.

# Detect Python executable
# On MSYS2/Windows, prefer MINGW64 over CLANG64 for Universal CRT avoidance
# Force explicit paths for MSYS environment compatibility
ifeq ($(shell test -f /mingw64/bin/python3 && echo yes),yes)
	PYTHON := /mingw64/bin/python3
else ifeq ($(shell test -f /clang64/bin/python3 && echo yes),yes)
	PYTHON := /clang64/bin/python3
else
	PYTHON := python3
endif

# Detect Premake5 executable
# On MSYS2/Windows, prefer MINGW64 over CLANG64 for Universal CRT avoidance
PREMAKE5_BIN := $(shell command -v premake5 2>/dev/null || command -v /mingw64/bin/premake5 2>/dev/null || command -v /clang64/bin/premake5 2>/dev/null || echo premake5)
# Route every `$(PREMAKE5) gmake` through a wrapper that suppresses premake5's
# noisy per-file "Generated ..." progress (185+ lines) while keeping errors and
# its exit status. Absolute path so it also works from `cd build/premake` sites.
PREMAKE5 := bash $(CURDIR)/utils/premake_quiet.sh $(PREMAKE5_BIN)

# MSYS2/Windows Environment Detection
MSYSTEM_DETECTED := $(shell echo $$MSYSTEM)
IS_MSYS2 := $(shell [ -n "$(MSYSTEM_DETECTED)" ] && echo "yes" || echo "no")

# Detect C/C++ compilers
# All platforms use Clang by default
# On MSYS2/Windows: CLANG64 Clang (avoids Universal CRT, uses MSVCRT.dll)
# Force explicit paths for MSYS environment compatibility
ifeq ($(shell test -f /clang64/bin/clang && echo yes),yes)
	CC := /clang64/bin/clang
	CXX := /clang64/bin/clang++
	AR := /clang64/bin/ar
	RANLIB := /clang64/bin/ranlib
else ifeq ($(OS),Linux)
	CC := clang
	CXX := clang++
	AR := ar
	RANLIB := ranlib
else
	CC := gcc
	CXX := g++
	AR := ar
	RANLIB := ranlib
endif

# Enable ccache for faster builds if available.
# MUST come after the CC/CXX detection block above; otherwise the platform
# branches overwrite our `ccache <compiler>` wrap.
ifneq ($(shell which ccache 2>/dev/null),)
	CC := ccache $(CC)
	CXX := ccache $(CXX)
	export CCACHE_DIR := $(shell pwd)/build/.ccache
	# 5 GiB matches ccache's own default; 500M was undersized for 147 test TUs.
	export CCACHE_MAXSIZE := 5G
	export CCACHE_COMPRESS := 1
	# time_macros: __DATE__/__TIME__ shouldn't invalidate cache entries.
	# include_file_mtime: rely on content hash, not mtime, when headers are
#   regenerated identically (common with generated parser.c).
	export CCACHE_SLOPPINESS := time_macros,include_file_mtime
endif

# Tree-sitter grammar dependencies
# This system automatically manages the dependency chain:
# grammar.js -> parser.c -> lambda-cst verifier
# When grammar.js is modified, the reference parser is automatically regenerated
# One grammar file states the whole language. The former production/reference
# split (grammar-common.js + grammar-lambda.js) retired with S16: Tree-sitter
# left the production parse path, so table size stopped constraining it
# (vibe/Lambda_Design_Syntax.md 4.4).
GRAMMAR_JS = lambda/tree-sitter-lambda/grammar.js
GRAMMAR_SCANNER_C = lambda/tree-sitter-lambda/src/scanner.c
PARSER_C = lambda/tree-sitter-lambda/src/parser.c
GRAMMAR_JSON = lambda/tree-sitter-lambda/src/grammar.json
NODE_TYPES_JSON = lambda/tree-sitter-lambda/src/node-types.json
# Use the exact project-pinned CLI directly. `npx package@version` may query
# npm after a clean even when this dependency is installed, making release
# builds fail offline before compilation begins.
TREE_SITTER_CLI = $(CURDIR)/node_modules/.bin/tree-sitter

# Generate the reference parser outputs once. The generated parser is used only
# by the isolated lambda-cst verifier; normal Lambda builds use the C parser.
$(PARSER_C) $(GRAMMAR_JSON) $(NODE_TYPES_JSON) &: $(GRAMMAR_JS) $(GRAMMAR_SCANNER_C)
	@out=$$(cd lambda/tree-sitter-lambda && $(TREE_SITTER_CLI) generate 2>&1) || { printf '%s\n' "$$out"; exit 1; }

# Tree-sitter library targets
# Build from source on all platforms
TREE_SITTER_LIB = lambda/tree-sitter/libtree-sitter.a
TREE_SITTER_LAMBDA_LIB = lambda/tree-sitter-lambda/libtree-sitter-lambda.a
TREE_SITTER_JAVASCRIPT_LIB = lambda/tree-sitter-javascript/libtree-sitter-javascript.a
TREE_SITTER_BASH_LIB = lambda/tree-sitter-bash/libtree-sitter-bash.a
TREE_SITTER_PYTHON_LIB = lambda/tree-sitter-python/libtree-sitter-python.a
TREE_SITTER_TYPESCRIPT_LIB = lambda/tree-sitter-typescript/libtree-sitter-typescript.a
TREE_SITTER_RUBY_LIB = lambda/tree-sitter-ruby/libtree-sitter-ruby.a
TREE_SITTER_LATEX_LIB = lambda/tree-sitter-latex/libtree-sitter-latex.a
TREE_SITTER_LATEX_MATH_LIB = lambda/tree-sitter-latex-math/libtree-sitter-latex-math.a
RE2_LIB = build_temp/re2-noabsl/cmake_build/libre2.a

# MIR JIT library. The source is vendored in-tree at lambda/mir (see
# lambda/mir/VENDOR.md) and built in place, so the path is the same on every
# platform and matches build_lambda_config.json. The patches under patches/
# are ALREADY APPLIED to the vendored source — they are kept as the record of
# our delta vs upstream, for re-syncing to a newer MIR, not applied at build
# time (that would dirty tracked files on every build).
MIR_BUILD_DIR = lambda/mir
MIR_LIB = $(MIR_BUILD_DIR)/libmir.a
# Upstream vnmakarov/mir commit the vendored source was taken from. Pinned so
# GNUmakefile's `git log -1` does not resolve to the Lambda repo's HEAD, which
# would rebuild all of MIR on every Lambda commit.
MIR_UPSTREAM_COMMIT = 99c65079038f3ba9242ef646f308c266cfd7a8e5
# The upstream libmir archive currently has a hard dependency on its c2mir
# object. Lambda never includes or calls that frontend; vendor sources stay
# untouched under the dependency boundary.
MIR_SOURCES = $(wildcard $(MIR_BUILD_DIR)/mir*.c $(MIR_BUILD_DIR)/mir*.h $(MIR_BUILD_DIR)/c2mir/*.c $(MIR_BUILD_DIR)/c2mir/*.h)

# JavaScript scanner dependencies
JS_GRAMMAR_JS = lambda/tree-sitter-javascript/grammar.js
JS_SCANNER_C = lambda/tree-sitter-javascript/src/scanner.c

# Bash and Ruby grammar dependencies
BASH_GRAMMAR_JS = lambda/tree-sitter-bash/grammar.js
BASH_SCANNER_C = lambda/tree-sitter-bash/src/scanner.c
RUBY_GRAMMAR_JS = lambda/tree-sitter-ruby/grammar.js
RUBY_SCANNER_C = lambda/tree-sitter-ruby/src/scanner.c

# TypeScript grammar and scanner dependencies
TS_GRAMMAR_JS = lambda/tree-sitter-typescript/grammar.js
TS_PARSER_C = lambda/tree-sitter-typescript/src/parser.c
TS_SCANNER_C = lambda/tree-sitter-typescript/src/scanner.c
TS_SCANNER_H = lambda/tree-sitter-typescript/scanner_v2.h

# LaTeX grammar dependencies
LATEX_GRAMMAR_JS = lambda/tree-sitter-latex/grammar.js
LATEX_PARSER_C = lambda/tree-sitter-latex/src/parser.c
LATEX_GRAMMAR_JSON = lambda/tree-sitter-latex/src/grammar.json
LATEX_NODE_TYPES_JSON = lambda/tree-sitter-latex/src/node-types.json

# Python grammar dependencies. parser.c is generated and gitignored, but the
# premake tests build compiles it directly (build_lambda_config.json lang-python),
# so it must exist on disk before that build runs. grammar.json is tracked.
PYTHON_PARSER_C = lambda/tree-sitter-python/src/parser.c
PYTHON_GRAMMAR_JSON = lambda/tree-sitter-python/src/grammar.json

# LaTeX Math grammar dependencies
LATEX_MATH_GRAMMAR_JS = lambda/tree-sitter-latex-math/grammar.js
LATEX_MATH_PARSER_C = lambda/tree-sitter-latex-math/src/parser.c

# Quietly build lambda/tree-sitter-$(1)'s static lib: run the sub-make with its
# output captured and shown only on failure, so a successful parser build is a
# single status line. $(2) = extra sub-make args (e.g. TS=...).
define ts_lib_build
@out=$$(env -u OS PATH="/mingw64/bin:$$PATH" $(MAKE) -C lambda/tree-sitter-$(1) libtree-sitter-$(1).a CC="$(CC)" CXX="$(CXX)" $(2) 2>&1) || { printf '%s\n' "$$out"; exit 1; }; \
echo "✅ tree-sitter-$(1) library built"
endef

# Generate a grammar with the project CLI before compiling its sub-library.
define ts_generate
@out=$$(cd lambda/tree-sitter-$(1) && $(TREE_SITTER_CLI) generate $(2) 2>&1) || { printf '%s\n' "$$out"; exit 1; }
endef

# Build tree-sitter library (amalgamated build, no ICU dependency)
# Uses lib.c single-file approach - no external ICU/Unicode library needed
$(TREE_SITTER_LIB):
	@echo "Building tree-sitter library (amalgamated, no ICU)..."
	@cd lambda/tree-sitter && \
	rm -f libtree-sitter.a tree_sitter.o && \
	$(CC) -c lib/src/lib.c \
		-Ilib/include \
		-Ilib/src \
		-O3 -Wall -Wextra -std=c11 -fPIC \
		-D_POSIX_C_SOURCE=200112L -D_DEFAULT_SOURCE \
		-o tree_sitter.o && \
	$(AR) rcs libtree-sitter.a tree_sitter.o && \
	rm -f tree_sitter.o
	@echo "✅ tree-sitter library built: lambda/tree-sitter/libtree-sitter.a"

# Build tree-sitter-lambda library (depends on parser generation)
$(TREE_SITTER_LAMBDA_LIB): $(PARSER_C)
	# pass the pinned CLI because the sub-make otherwise falls back to an unqualified tree-sitter
	$(call ts_lib_build,lambda,TS="$(TREE_SITTER_CLI)")

# Build tree-sitter-javascript library (depends on grammar and scanner source)
# Generate with the project CLI directly; the sub-make only compiles the result.
$(TREE_SITTER_JAVASCRIPT_LIB): $(JS_GRAMMAR_JS) $(JS_SCANNER_C)
	$(call ts_generate,javascript,--abi 14)
	$(call ts_lib_build,javascript,)

# Build tree-sitter-bash library (depends on grammar and scanner source)
$(TREE_SITTER_BASH_LIB): $(BASH_GRAMMAR_JS) $(BASH_SCANNER_C)
	$(call ts_generate,bash,--abi 14)
	$(call ts_lib_build,bash,)

# Regenerate the ignored Python parser before a direct Premake compile.
# The ABI-14 header cannot compile a stale ABI-15 parser.c from an older CLI.
generate-tree-sitter-python-parser:
	@out=$$(env -u OS PATH="/mingw64/bin:$$PATH" $(MAKE) -B -C lambda/tree-sitter-python \
		src/parser.c TS="$(TREE_SITTER_CLI)" 2>&1) || { printf '%s\n' "$$out"; exit 1; }

# Build tree-sitter-python library
$(TREE_SITTER_PYTHON_LIB): generate-tree-sitter-python-parser
	@echo "Building tree-sitter-python library..."
	env -u OS PATH="/mingw64/bin:$$PATH" $(MAKE) -C lambda/tree-sitter-python \
		libtree-sitter-python.a TS="$(TREE_SITTER_CLI)" \
		CC="$(CC)" CXX="$(CXX)" V=1 VERBOSE=1

# Generate TypeScript parser from grammar.js when it changes
$(TS_PARSER_C): $(TS_GRAMMAR_JS)
	@out=$$(cd lambda/tree-sitter-typescript && \
		{ [ -d node_modules/tree-sitter-javascript ] || npm install --save tree-sitter-javascript@file:../tree-sitter-javascript; } && \
		$(TREE_SITTER_CLI) generate 2>&1) || { printf '%s\n' "$$out"; exit 1; }

# Build tree-sitter-typescript library (depends on parser generation + scanner)
$(TREE_SITTER_TYPESCRIPT_LIB): $(TS_PARSER_C) $(TS_SCANNER_C) $(TS_SCANNER_H)
	$(call ts_lib_build,typescript,)

# Build tree-sitter-ruby library (depends on grammar and scanner source)
$(TREE_SITTER_RUBY_LIB): $(RUBY_GRAMMAR_JS) $(RUBY_SCANNER_C)
	$(call ts_generate,ruby,--abi 14)
	$(call ts_lib_build,ruby,)

# Generate LaTeX parser from grammar.js when it changes
$(LATEX_PARSER_C) $(LATEX_GRAMMAR_JSON) $(LATEX_NODE_TYPES_JSON): $(LATEX_GRAMMAR_JS)
	@out=$$(cd lambda/tree-sitter-latex && $(TREE_SITTER_CLI) generate 2>&1) || { printf '%s\n' "$$out"; exit 1; }

# Build tree-sitter-latex library (depends on parser generation)
$(TREE_SITTER_LATEX_LIB): $(LATEX_PARSER_C)
	$(call ts_lib_build,latex,)

# Generate LaTeX Math parser from grammar.js when it changes.
# Keep the generated source at ABI 14 so it matches the checked-in header.
$(LATEX_MATH_PARSER_C): $(LATEX_MATH_GRAMMAR_JS)
	@out=$$(cd lambda/tree-sitter-latex-math && $(TREE_SITTER_CLI) generate --abi 14 2>&1) || { printf '%s\n' "$$out"; exit 1; }

# Build tree-sitter-latex-math library (depends on parser generation)
$(TREE_SITTER_LATEX_MATH_LIB): $(LATEX_MATH_PARSER_C)
	$(call ts_lib_build,latex-math,)

# Build re2 library (reconfigures cmake if CMakeCache is stale/wrong platform)
# On Windows/CLANG64: must pass explicit compiler flags so cmake uses clang++
# with -stdlib=libc++ (matching the rest of the build) instead of defaulting
# to GCC/libstdc++, which would cause an ABI mismatch at link time.
$(RE2_LIB):
	@echo "Building re2 library from source..."
	@mkdir -p build_temp/re2-noabsl/cmake_build
	@# CMake needs a single executable for CMAKE_*_COMPILER; if ccache is in
	@# use, $(CC)/$(CXX) is "ccache gcc"/"ccache g++" — split into launcher
	@# + real compiler so cmake's compiler-ID probe works. MSYS2's ccache
	@# cannot resolve the Windows absolute compiler path emitted into Ninja
	@# rules, so RE2 must use the compiler directly on that platform.
	@cd build_temp/re2-noabsl/cmake_build && \
		RE2_CC="$(firstword $(filter-out ccache,$(CC)))" ; \
		RE2_CXX="$(firstword $(filter-out ccache,$(CXX)))" ; \
		RE2_LAUNCHER="$(if $(filter yes,$(IS_MSYS2)),,$(filter ccache,$(firstword $(CC))))" ; \
		cmake .. \
			-DCMAKE_C_COMPILER="$$RE2_CC$(if $(filter yes,$(IS_MSYS2)),.exe,)" \
			-DCMAKE_CXX_COMPILER="$$RE2_CXX$(if $(filter yes,$(IS_MSYS2)),.exe,)" \
			-DCMAKE_C_COMPILER_LAUNCHER="$$RE2_LAUNCHER" \
			-DCMAKE_CXX_COMPILER_LAUNCHER="$$RE2_LAUNCHER" \
			-DCMAKE_CXX_FLAGS="$(if $(filter /clang64/bin/clang++,$(CXX)),-stdlib=libc++,) -O2" \
			$(MACOS_CMAKE_FLAGS) \
			-DCMAKE_BUILD_TYPE=Release \
			-DCMAKE_POSITION_INDEPENDENT_CODE=ON \
			-DBUILD_SHARED_LIBS=OFF \
			-DRE2_BUILD_TESTING=OFF \
			-Wno-dev \
			-G Ninja 2>&1 | tail -3 && \
		ninja -j$(JOBS)
	@echo "re2 library built: $(RE2_LIB)"

# Build MIR JIT library from the vendored source at lambda/mir.
# Only the libmir.a target is built (the upstream target includes mir.o,
# mir-gen.o, and c2mir.o); Lambda does not invoke c2mir. MIR's own executables
# (c2m, m2b, b2m, mir-bin-run) are not part of the vendored subset.
$(MIR_LIB): $(MIR_SOURCES)
	@echo "Building MIR library from vendored source ($(MIR_BUILD_DIR))..."
ifeq ($(IS_MSYS2),yes)
	@$(MAKE) -C $(MIR_BUILD_DIR) libmir.a CC=/clang64/bin/clang.exe AR=/clang64/bin/llvm-ar.exe \
		CFLAGS="-O2 -DNDEBUG -fPIC" GITCOMMIT=$(MIR_UPSTREAM_COMMIT)
else
	@$(MAKE) -C $(MIR_BUILD_DIR) libmir.a -j$(JOBS) GITCOMMIT=$(MIR_UPSTREAM_COMMIT)
endif
	@echo "✅ MIR built: $(MIR_LIB)"

# Remove MIR build outputs, leaving the vendored source untouched.
clean-mir:
	@echo "Cleaning MIR build outputs in $(MIR_BUILD_DIR)..."
	@rm -f $(MIR_BUILD_DIR)/libmir.a $(MIR_BUILD_DIR)/*.o $(MIR_BUILD_DIR)/*.d \
		$(MIR_BUILD_DIR)/c2mir/*.o $(MIR_BUILD_DIR)/c2mir/*.d

# Verify the vendored source still matches upstream + patches/. Clones pristine
# upstream at MIR_UPSTREAM_COMMIT, applies every patch, and diffs the result
# against lambda/mir. Run after editing lambda/mir or a MIR patch by hand.
# diff uses --strip-trailing-cr: upstream stores some files with CRLF (e.g.
# c2mir/x86_64/mirc_x86_64_win.h) but the vendored import was LF-normalized;
# EOL style is not a real content difference.
verify-mir-patches:
	@set -e; \
	work=build_temp/mir-verify; \
	rm -rf $$work; mkdir -p $$work; \
	echo "Fetching pristine MIR $(MIR_UPSTREAM_COMMIT)..."; \
	git -c advice.detachedHead=false clone -q https://github.com/vnmakarov/mir.git $$work/upstream; \
	git -C $$work/upstream -c advice.detachedHead=false checkout -q $(MIR_UPSTREAM_COMMIT); \
	for p in patches/mir-*.patch; do \
		echo "  applying $$p"; \
		git -C $$work/upstream apply "$(CURDIR)/$$p" || { echo "ERROR: $$p does not apply to upstream" >&2; exit 1; }; \
	done; \
	fail=0; \
	for f in $$(cd $(MIR_BUILD_DIR) && find . -name '*.c' -o -name '*.h'); do \
		if ! diff -q --strip-trailing-cr "$$work/upstream/$$f" "$(MIR_BUILD_DIR)/$$f" >/dev/null 2>&1; then \
			echo "DIFFERS: $$f"; fail=1; \
		fi; \
	done; \
	if [ $$fail -ne 0 ]; then \
		echo "ERROR: lambda/mir does not equal upstream + patches/. Either regenerate the" >&2; \
		echo "       patch for your change or re-vendor from upstream." >&2; \
		exit 1; \
	fi; \
	echo "✅ lambda/mir == upstream $(MIR_UPSTREAM_COMMIT) + patches/mir-*.patch"

build-mir: $(MIR_LIB)

# Toolchain Validation Functions
define toolchain_verify
	@echo "🔍 Verifying toolchain..."
	@if command -v $(CC) >/dev/null 2>&1; then \
		echo "✅ Compiler: $(CC) ($(shell $(CC) --version 2>/dev/null | head -1 || echo 'version unknown'))"; \
	else \
		echo "❌ Compiler $(CC) not found"; \
	fi
	@if command -v $(CXX) >/dev/null 2>&1; then \
		echo "✅ C++ Compiler: $(CXX) ($(shell $(CXX) --version 2>/dev/null | head -1 || echo 'version unknown'))"; \
	else \
		echo "❌ C++ Compiler $(CXX) not found"; \
	fi
endef

# Checking DLL dependencies on Windows (avoid Universal CRT)
define windows_dll_check
	@target="$(if $(1),$(1),lambda.exe)"; \
	if [ -f "$$target" ]; then \
		ldd "$$target" 2>/dev/null | grep -E "not found|mingw64|msys64|ucrt|api-ms-win-crt" || echo "✅ No problematic dependencies found"; \
	else \
		echo "⚠️  $$target not found, skipping DLL check"; \
	fi
endef

# Function to run make with error collection and summary.
# Full clang output goes to temp/build_<TARGET>.log; only errors + a summary
# print to the terminal (keeps agent/CI logs small and readable).
# Usage: $(call run_make_with_error_summary,LABEL[,CONFIG[,EXTRA_FLAGS[,MAKE_TARGET]]])
# LABEL:       log/message label; also the make target unless MAKE_TARGET is set
#              (e.g., lambda, lambda-cli, tests). Log goes to temp/build_<LABEL>.log
# CONFIG:      premake config (default: debug_native; e.g. release_native)
# EXTRA_FLAGS: extra flags/vars appended to the sub-make (e.g. -s CFLAGS="-w")
# MAKE_TARGET: actual make target when it differs from LABEL (e.g. 'all' to build
#              every project while logging under a friendly label)
# The error-path location check below uses POSIX case because recipes run under
# /bin/sh on Linux rather than Bash.
define run_make_with_error_summary
	@echo "🔨 Building '$(1)' (config: $(if $(2),$(2),debug_native)) — full clang log: temp/build_$(1).log"
	@mkdir -p temp && BUILD_LOG="temp/build_$(1).log" && \
	if $(MAKE) -C build/premake --no-print-directory config=$(if $(2),$(2),debug_native) $(if $(4),$(4),$(1)) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)" LINK_JOBS="$(LINK_JOBS)" $(3) > "$$BUILD_LOG" 2>&1; then \
		BUILD_RC=0; echo "✅ Build completed successfully for target: $(1)"; \
	else \
		BUILD_RC=$$?; echo "❌ Build failed for target: $(1)"; \
	fi; \
	echo ""; \
	echo "📋 Build Summary:"; \
	echo "================"; \
	ERROR_COUNT=`grep -E "(error:|Error:|ERROR:|fatal:|Failed:|failed:)" "$$BUILD_LOG" 2>/dev/null | grep -v -E "warning:|Warning:|WARNING:" | wc -l | tr -d ' '`; \
	WARNING_COUNT=`grep -E "(warning:|Warning:|WARNING:)" "$$BUILD_LOG" 2>/dev/null | wc -l | tr -d ' '`; \
	echo "Errors: $$ERROR_COUNT"; \
	echo "Warnings: $$WARNING_COUNT"; \
	echo ""; \
	if [ "$$ERROR_COUNT" -gt 0 ] 2>/dev/null; then \
		echo "🔴 ERRORS FOUND:"; \
		echo "================"; \
		grep -n -E "(error:|Error:|ERROR:|fatal:|Failed:|failed:)" "$$BUILD_LOG" | grep -v -E "warning:|Warning:|WARNING:" | while IFS=: read -r line_num content; do \
			file_info=$$(echo "$$content" | grep -oE "\.\.\/[^[:space:]]+\.[ch]p*p?:[0-9]+:[0-9]+:" | head -1); \
			if [ -z "$$file_info" ]; then \
				file_info=$$(echo "$$content" | grep -oE "\.\.\/[^[:space:]]+\.[ch]p*p?:[0-9]+:" | head -1); \
			fi; \
			if [ -z "$$file_info" ]; then \
				file_info=$$(echo "$$content" | grep -oE "[^[:space:]]+\.[ch]p*p?:[0-9]+:[0-9]+:" | head -1); \
			fi; \
			if [ -z "$$file_info" ]; then \
				file_info=$$(echo "$$content" | grep -oE "[^[:space:]]+\.[ch]p*p?:[0-9]+:" | head -1); \
			fi; \
			if [ -n "$$file_info" ]; then \
				rel_path=$$(echo "$$file_info" | cut -d: -f1); \
				line_no=$$(echo "$$file_info" | cut -d: -f2); \
				col_no=$$(echo "$$file_info" | cut -d: -f3); \
				case "$$rel_path" in \
					../*) abs_path="$$(cd build/premake && realpath "$$rel_path" 2>/dev/null || echo "$$(pwd)/$$rel_path")" ;; \
					*) abs_path="$$(pwd)/build/premake/$$rel_path" ;; \
				esac; \
				if [ -n "$$col_no" ] && [ "$$col_no" != "" ]; then \
					location="$$line_no:$$col_no"; \
				else \
					location="$$line_no"; \
				fi; \
				clean_content=$$(echo "$$content" | sed "s|[^[:space:]]*\.[ch]p*p*:[0-9]*:[0-9]*:||" | sed "s|[^[:space:]]*\.[ch]p*p*:[0-9]*:||"); \
				echo "   file://$$abs_path:$$location -$$clean_content"; \
			else \
				echo "   $$content"; \
			fi; \
		done; \
		echo ""; \
		echo "💡 Click on the file:// links above to jump to errors in VS Code"; \
	fi; \
	echo "📄 Full build log: temp/build_$(1).log"; \
	exit $$BUILD_RC
endef

# Combined tree-sitter libraries target
# Core: only parsers needed by lambda.exe (JS, TS, LaTeX)
# Normal Lambda profiles use the first-party C parser.  The Lambda
# Tree-sitter archive is built only by the dedicated CST differential profile.
tree-sitter-core-libs: $(TREE_SITTER_LIB) $(TREE_SITTER_JAVASCRIPT_LIB) $(TREE_SITTER_TYPESCRIPT_LIB) $(TREE_SITTER_LATEX_LIB) $(TREE_SITTER_LATEX_MATH_LIB)

# Release frontends use the same direct RD/Pratt parser, so keep the Lambda
# Tree-sitter archive out of every normal profile.
tree-sitter-release-libs: $(TREE_SITTER_LIB) $(TREE_SITTER_JAVASCRIPT_LIB) $(TREE_SITTER_TYPESCRIPT_LIB) $(TREE_SITTER_LATEX_LIB) $(TREE_SITTER_LATEX_MATH_LIB)

# All: includes jube-only parsers (Python, Bash, Ruby)
tree-sitter-libs: tree-sitter-core-libs $(TREE_SITTER_BASH_LIB) $(TREE_SITTER_PYTHON_LIB) $(TREE_SITTER_RUBY_LIB)

# Default target
.DEFAULT_GOAL := build

# Phony targets (don't correspond to actual files)
.PHONY: all build build-ascii clean clean-grammar generate-grammar test-grammar-s16 generate-names debug release rebuild lambda-cst \
	    test test-all test-all-baseline test-lambda-baseline test-lambda-interp interp-sweep interp-bench test-lambda-full test-gc-rooting test-gc-rooting-core test-mir-gc-stress test-gc-rooting-python test-bash-baseline test-input-baseline test-radiant-baseline test-layout-baseline test-page-load test-radiant-online test-pdf-render test-extended test-input run help \
	    lambda lambda-cli build-cli lambda-jube build-jube build-lang-python build-node-core build-node-fs build-node-net build-node-crypto build-node-zlib release-lang-python release-node-core release-node-fs release-node-net release-node-crypto release-node-zlib package-standard package-jube package-node-reduced package-minimal verify-jube-package verify-node-profile-packages test-jube-module-integrity test-jube-module-loader-negative test-jube-language-dispatch test-hosted-python-architecture-checker test-node-module-architecture-checker test-jube-node-fs-async-work test-jube-node-fs-dynamic test-jube-node-fs-negative test-jube-node-net-negative test-jube-node-core-leaves test-jube-node-error-lane test-jube-node-core-dynamic test-jube-node-zlib-dynamic test-jube-node-zlib-negative test-jube-node-zlib-parity release-jube format lint lint-full check-code-dup check-lambda-dup check-radiant-dup hosted-python-coupling-inventory check-hosted-python-architecture check-hosted-python-module-boundary check-node-module-architecture hosted-node-coupling-inventory docs intellisense analyze-binary \
	    build-debug build-release build-debug-profile build-release-profile clean-all distclean \
	    tree-sitter-libs tree-sitter-core-libs tree-sitter-release-libs generate-tree-sitter-python-parser \
	    generate-premake clean-premake build-lambda-data build-lambda-rt build-radiant build-lambda-static check-module-boundary build-test build-input-baseline build-lambda-baseline build-radiant-baseline build-pdf-render-test build-test-linux build-jube-test test-jube run-radiant-baseline run-layout-baseline-suites \
	    capture-layout test-layout layout layout-snapshot layout-snapshot-check layout-snapshot-diff count-loc struct-census tidy-printf benchmark bench-compile \
	    fuzz-lambda fuzz-lambda-extended fuzz-radiant fuzz-radiant-quick type-chart build-mir clean-mir verify-mir-patches \
	    ensure-test262-gtest test-js262-prelim test-js-exception-catalog test-js-callable-catalog test-js-opt test262-baseline test262-full \
	    test-ui-automation test-reactive-ui test-redex-baseline dom-ui dom-ui-run hit-test-ui editable-unit editable-ui editable-editor-e2e test-editable drawing-editor-e2e test-drawing check-error-recovery \
	    build-graph-mermaid-test test-graph-mermaid build-graph-graphviz-test test-graph-graphviz \
	    build-graph-structurizr-test test-graph-structurizr \
	    node-baseline node-regression-gate node-full node-update-baseline node-official-report test-jube-node-net-crypto-dynamic

# Help target - shows available commands
help:
	@echo "$(PROJECT_NAME) - Available Make Targets:"
	@echo ""
	@echo "Build Targets (Premake-based):"
	@echo "  build         - Build lambda (core) using Premake build system (incremental, default)"
	@echo "                  On Windows/MSYS2: Uses CLANG64 Clang (avoids Universal CRT)"
	@echo "                  All platforms use Clang as the default compiler"
	@echo "  debug         - Build with debug symbols and AddressSanitizer using Premake"
	@echo "  build-release - Build optimized release version using Premake"
	@echo "  build-debug-profile   - Build optimized, symbolized debug profile with JS execution profiling"
	@echo "  build-release-profile - Build optimized release with JS execution profiling enabled"
	@echo "  release       - Build release version and prepare release artifacts"
	@echo "  lambda-cli    - Build headless CLI-only version (release, no Radiant/GUI, outputs lambda-cli.exe)"
	@echo "  lambda-cst    - Build the Tree-sitter Lambda CST differential verifier"
	@echo "  build-mir     - Build MIR JIT library from vendored source at lambda/mir"
	@echo "  clean-mir     - Remove MIR build outputs (keeps the vendored source)"
	@echo "  verify-mir-patches - Check lambda/mir == upstream MIR + patches/mir-*.patch"
	@echo "  build-jube    - Build the standard host plus hosted Python and a compatibility link"
	@echo "  release-jube  - Package the full hosted-language bundle (same host binary)"
	@echo "  rebuild       - Force complete rebuild using Premake"
	@echo "  lambda        - Build lambda project specifically using Premake"
	@echo "  all           - Build all projects"
	@echo ""
	@echo "Maintenance:"
	@echo "  clean         - Remove build artifacts"
	@echo "  clean-test    - Remove test output and temporary files"
	@echo "  clean-grammar - Remove generated Lambda CST grammar files"
	@echo "  clean-all     - Remove all build directories and tree-sitter libraries"
	@echo "  distclean     - Complete cleanup (build dirs + executables + tests)"
	@echo "  intellisense  - Update VS Code IntelliSense database (compile_commands.json)"
	@echo ""
	@echo "Premake Build System:"
	@echo "  generate-premake - Generate premake5.lua from build_lambda_config.json"
	@echo "  clean-premake - Clean Premake build artifacts and generated files"
	@echo "  build-test    - Build all test executables using Premake"
	@echo "  build-input-baseline - Build only native input baseline test executables"
	@echo "  build-lambda-baseline - Build Lambda baseline runtime and input test executables"
	@echo "  build-radiant-baseline - Build only lambda and the native runners used by test-radiant-baseline"
	@echo "  build-pdf-render-test - Build PDF render visual gtest executable using Premake"
	@echo "  build-jube-test - Build hosted Python compatibility bundle and test executables"
	@echo ""
	@echo "Grammar & Parser:"
	@echo "  generate-grammar - Generate the Lambda CST parser from grammar.js"
	@echo "  test-grammar-s16 - S16 surface-syntax conformance (reference grammar)"
	@echo "                     (automatic when grammar.js changes)"
	@echo "  generate-names - Regenerate immutable NameId catalogs from the Python source list"
	@echo "  tree-sitter-libs - Build all tree-sitter libraries (amalgamated, no ICU)"
	@echo "                     Automatically regenerates LaTeX parser if grammar.js changes"
	@echo ""
	@echo "Development:"
	@echo "  test          - Run ALL test suites (baseline + extended, alias for test-all)"
	@echo "  test-all      - Run ALL test suites (baseline + extended)"
	@echo "  test-all-baseline - Run ALL BASELINE test suites (core functionality, must pass 100%)"
	@echo "  test-lambda-baseline - Run LAMBDA baseline test suite only"
	@echo "  test-lambda-full - Run Lambda baseline plus the concurrency runtime gate"
	@echo "  test-gc-rooting - Run exact-root forced-GC JIT/interpreter/root-effect gates"
	@echo "  test-bash-baseline - Run Bash transpiler baseline test suite"
	@echo "  test-input-baseline - Run HTML5 WPT, CommonMark, YAML, ASCII Math, and LaTeX Math parser tests"
	@echo "  test-radiant-baseline - Run shared layout baselines ($(LAYOUT_BASELINE_SUITES)) + render visual + other checks"
	@echo "  test-layout-baseline - Run the shared layout baseline suites only"
	@echo "  test-radiant-online - Run Radiant online URL smoke tests"
	@echo "  test-reactive-ui     - Run Reactive UI event simulation tests (todo toggle/delete)"
	@echo "  editable-unit        - Run focused editable gate, DOM action, and cancellation fixtures"
	@echo "  editable-ui          - Run contenteditable UI automation fixtures"
	@echo "  editable-editor-e2e  - Run offline CodeMirror, ProseMirror, and Editor.js probes"
	@echo "  test-editable        - Run all focused editable and upstream editor checks"
	@echo "  drawing-editor-e2e   - Run offline Raphaël, maxGraph, and JointJS SVG probes"
	@echo "  test-drawing         - Run all editable-drawing compatibility probes"
	@echo "  test-redex-baseline  - Run Redex formal semantics baseline verification"
	@echo "  test-graph-mermaid   - Run Mermaid graph corpus and Lambda integration fixtures"
	@echo "  test-graph-graphviz  - Run DOT parser and Graphviz package integration fixtures"
	@echo "  test-graph-structurizr - Run Structurizr parser and C4 package fixtures"
	@echo "  test-pdf-render - Run PDF render visual gtest suite"
	@echo "  layout-snapshot       - Save page suite snapshot: make layout-snapshot suite=page"
	@echo "  test-extended - Run EXTENDED test suites only (HTTP/HTTPS, ongoing features)"
	@echo "  test-js262-prelim - Run the bounded Test262 runner preflight"
	@echo "  test-js-opt   - Run JS optimization contract tests with the profile child"
	@echo "  test-library  - Run library tests only"
	@echo "  test-input    - Run input processing test suite (MIME detection & math)"
	@echo "  test-validator- Run validator tests only"
	@echo "  test-mir      - Run MIR JIT tests only"
	@echo "  test-lambda   - Run lambda runtime tests only"
	@echo "  test-std      - Run Lambda Standard Tests (custom test runner)"
	@echo "  test-coverage - Run tests with code coverage analysis"
	@echo "  test-benchmark- Run performance benchmark tests"
	@echo "  fuzz-lambda    - Run fuzzy tests (5 minutes, mutation + random generation)"
	@echo "  fuzz-lambda-extended - Run extended fuzzy tests (1 hour)"
	@echo "  test-integration - Run end-to-end integration tests"
	@echo "  test-all      - Run complete test suite (all test types)"

	@echo "  run           - Build and run the default executable"
	@echo "  analyze       - Run static analysis with scan-build (fixed for custom build)"
	@echo "  analyze-verbose - Run detailed static analysis with extra checkers"
	@echo "  analyze-single - Run static analysis on individual files"
	@echo "  analyze-direct - Direct clang static analysis (bypasses build system)"
	@echo "  analyze-compile-db - Use compile_commands.json for analysis (requires bear)"
	@echo "  tidy-printf   - Convert printf/fprintf(stderr) to log_debug() using Clang AST"
	@echo "                  Usage: make tidy-printf FILE='pattern' [DRY_RUN=1] [BACKUP=1]"
	@echo "  format        - Format source code with clang-format"
	@echo "  lint          - Unified policy linter, fast pass (ast-grep + alint + hybrid + structural)"
	@echo "                  Usage: make lint [ARGS='--rule <id>' | --report | --list]   ~10 s"
	@echo "  lint-full     - Same plus the clang-tidy backend (slow, comprehensive)"
	@echo "                  Usage: make lint-full [ARGS=--report]                         ~4 min"
	@echo "  check-code-dup    - Check lib, lambda, and radiant for duplicate code"
	@echo "  check-lambda-dup  - Check lambda for duplicate code"
	@echo "  check-radiant-dup - Check radiant for duplicate code"
	@echo "  count-loc     - Count lines of code in the repository"
	@echo "  struct-census - libclang census of every struct/class/union/enum with real sizes"
	@echo "                  Incremental; reports to vibe/meta/ds/, viewer in make devtool"
	@echo "  cheatsheet    - Regenerate Lambda_Cheatsheet.pdf from Markdown (requires pandoc, xelatex)"
	@echo "  bench-compile - Run C/C++ compilation performance benchmark"
	@echo "                  Tests single-file, template, multi-file, and full Lambda builds"
	@echo "  test-layout              - Run Lambda CSS layout integration tests (all suites)"
	@echo "                             Uses Lambda CSS engine (custom CSS cascade and layout)"
	@echo "                             Usage: make test-layout suite=baseline (run specific suite)"
	@echo "                             Usage: make test-layout test=table_simple (run specific test, .html/.htm optional)"
	@echo "                             Usage: make test-layout pattern=float (run tests matching pattern)"
	@echo "                             Note: Uppercase variants also work (SUITE=, TEST=, PATTERN=)"
	@echo "                             Available suites: auto-detected from test/layout/data/"
	@echo "  layout                   - Alias for test-layout"
	@echo "                             Usage: make layout suite=baseline"
	@echo "                             Usage: make layout pattern=float (run tests matching pattern)"
	@echo "                             Note: Uppercase variants also work (SUITE=, TEST=, PATTERN=)"
	@echo "                             Available suites: auto-detected from test/layout/data/"
	@echo "  capture-layout   - Extract browser layout references using Puppeteer"
	@echo "                             REQUIRES: test=<name> OR suite=<name>"
	@echo "                             Usage: make capture-layout test=basic-text-align"
	@echo "                             Usage: make capture-layout suite=baseline"
	@echo "                             Usage: make capture-layout test=table_007 force=1"
	@echo "                             Note: Uppercase variants also work (TEST=, SUITE=, FORCE=)"
	@echo ""
	@echo "Options:"
	@echo "  JOBS=N        - Set number of parallel compilation jobs (default: $(JOBS))"
	@echo "  CONFIG=file   - Use specific configuration file"
	@echo ""
	@echo "Examples:"
	@echo "  make build JOBS=4         # Build with 4 parallel jobs"
	@echo "  make debug                # Debug build with AddressSanitizer"
	@echo "  make rebuild              # Force complete rebuild"

# Environment debugging target
env-debug:
	@echo "🔍 Environment Detection Debug:"
	@echo "MSYSTEM: '$(MSYSTEM)'"
	@echo "MSYSTEM_DETECTED: '$(MSYSTEM_DETECTED)'"
	@echo "IS_MSYS2: '$(IS_MSYS2)'"

# Main build target (incremental)
build: tree-sitter-core-libs $(RE2_LIB) $(MIR_LIB)
	@rm -f .lambda_release_build 2>/dev/null || true
ifeq ($(IS_MSYS2),yes)
	@echo "Building $(PROJECT_NAME) using MSYS2 CLANG64 environment..."
	PATH="/clang64/bin:$$PATH" $(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable with $(JOBS) parallel jobs..."
	PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake -j$(JOBS) lambda CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(call windows_dll_check)
	@echo "✅ Build completed successfully!"
else
	@echo "Building $(PROJECT_NAME) using Premake build system..."
	$(call toolchain_verify)
	@echo "Generating Premake configuration..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	@$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable with $(JOBS) parallel jobs..."
	# Ensure explicit compiler variables are passed to Premake build
	@echo "Using CC=$(CC) CXX=$(CXX)"
	$(call run_make_with_error_summary,lambda)
endif

print-vars:
	@echo "Unicode support: Always enabled (utf8proc)"

print-jobs:
	@echo "CPU cores detected (NPROCS): $(NPROCS)"
	@echo "Parallel jobs (JOBS): $(JOBS)"
	@echo "Link jobs (LINK_JOBS): $(LINK_JOBS)"

$(LAMBDA_EXE): build

# Build the isolated Tree-sitter Lambda CST verifier.  Normal Lambda
# profiles deliberately do not build or link TREE_SITTER_LAMBDA_LIB.
lambda-cst: $(TREE_SITTER_LIB) $(TREE_SITTER_LAMBDA_LIB)
	@mkdir -p temp/lambda-parser-poc build/premake
	@echo "Generating lambda-cst Premake configuration..."
	$(PYTHON) utils/generate_premake.py --variant lambda-cst --output $(LAMBDA_CST_PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(LAMBDA_CST_PREMAKE_FILE)
	$(call run_make_with_error_summary,lambda-cst,debug_native,,lambda-cst)



# Debug build
debug: tree-sitter-libs $(RE2_LIB) $(MIR_LIB)
	@rm -f .lambda_release_build 2>/dev/null || true
	@echo "Building debug version using Premake build system..."
	$(call toolchain_verify)
	@echo "Generating Premake configuration..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable (debug) with $(JOBS) parallel jobs..."
	$(MAKE) -C build/premake config=debug_native lambda -j$(JOBS) CC="$(CC)" CXX="$(CXX)"
	@echo "Debug build completed. Executable: lambda.exe"
	$(call windows_dll_check)

# Release build (optimized with size reduction)
# Optimizations applied:
#   1. Dead code elimination (-ffunction-sections, -fdata-sections, -Wl,-dead_strip)
#   2. log_debug() and log_info() stripped via NDEBUG macro
#   3. Symbol visibility control (-fvisibility=hidden)
#   4. Debug symbols stripped (-s linker flag + post-build strip)
#   5. LTO enabled (-flto)
# build-release compiles the optimized lambda.exe.
# prepare-release packages an existing release binary plus assets/docs into ./release/.
release: build-release
	@$(MAKE) prepare-release

prepare-release:
	@bash utils/prepare_release.sh

build-release:
	@$(MAKE) clean-all
	@$(MAKE) build-release-compile

build-release-compile: tree-sitter-release-libs $(RE2_LIB) $(MIR_LIB)
	@echo "Building release version using Premake build system..."
	@echo "Optimizations: LTO, dead code elimination, symbol visibility, stripped logging"
	$(call toolchain_verify)
	@echo "Generating Premake configuration..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable (release) with $(JOBS) parallel jobs..."
	$(call run_make_with_error_summary,lambda,release_native)
ifeq ($(OS),Darwin)
	@echo "Stripping debug symbols (macOS)..."
	@strip -x lambda_release.exe 2>/dev/null || strip -x lambda.exe 2>/dev/null || true
else
	@echo "Stripping debug symbols..."
	@strip lambda_release.exe 2>/dev/null || strip lambda.exe 2>/dev/null || true
endif
	@echo "Release build completed."
	@ls -lh lambda_release.exe 2>/dev/null || ls -lh lambda.exe 2>/dev/null || true
	@touch .lambda_release_build
	$(call windows_dll_check)

build-release-profile: tree-sitter-release-libs $(RE2_LIB) $(MIR_LIB)
	@echo "Building release_profile version using Premake build system..."
	@echo "Optimizations: LTO, dead code elimination, JS execution profiling enabled"
	$(call toolchain_verify)
	@echo "Generating Premake configuration..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable (release_profile) with $(JOBS) parallel jobs..."
	$(call run_make_with_error_summary,lambda,release_profile_native)
	@echo "Release profile build completed."
	@ls -lh lambda-profile.exe 2>/dev/null || true
	$(call windows_dll_check,lambda-profile.exe)

# Keep regular debug free of profiler hooks so its runtime cost reflects only
# debugging and sanitizer instrumentation; use this target to collect JS profiles.
build-debug-profile: tree-sitter-core-libs $(RE2_LIB) $(MIR_LIB)
	@echo "Building debug_profile version using Premake build system..."
	@echo "Optimizations: O3 with symbols, frame pointers, JS execution profiling"
	$(call toolchain_verify)
	@echo "Generating Premake configuration..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable (debug_profile) with $(JOBS) parallel jobs..."
	$(call run_make_with_error_summary,lambda,debug_profile_native)
	@echo "Debug profile build completed. Executable: lambda-debug-profile.exe"
	@ls -lh lambda-debug-profile.exe 2>/dev/null || true
	$(call windows_dll_check,lambda-debug-profile.exe)

# Headless CLI build (no Radiant layout engine or GUI support)
# Produces lambda-cli.exe with only Lambda scripting capabilities (release build)
lambda-cli: build-cli

build-cli: tree-sitter-libs
	@echo "Building Lambda CLI (headless, release) using Premake build system..."
	@echo "Excluded: Radiant layout engine, GUI windowing, font rendering, image codecs"
	$(PYTHON) utils/generate_premake.py --variant cli --output $(PREMAKE_CLI_FILE)
	@echo "Generating makefiles..."
	$(PREMAKE5) gmake --file=$(PREMAKE_CLI_FILE)
	@echo "Building lambda-cli executable (release) with $(JOBS) parallel jobs..."
	$(call run_make_with_error_summary,lambda-cli,release_native,-s CFLAGS="-w" CXXFLAGS="-w")
ifeq ($(OS),Darwin)
	@strip -x lambda-cli.exe 2>/dev/null || true
else
	@strip lambda-cli.exe 2>/dev/null || true
endif
	@echo "✅ CLI build completed. Executable: lambda-cli.exe"
	@ls -lh lambda-cli.exe 2>/dev/null || true

# Compatibility name for the former polyglot executable. It is a link to the
# normal host, never a separately compiled runtime.
lambda-jube: build-jube

build-jube: build build-lang-python
	@ln -sfn lambda.exe lambda-jube.exe
	@echo "✅ Jube compatibility name points to the standard host: lambda-jube.exe -> lambda.exe"

# Hosted Python is a separately loaded native module. It is never a dependency
# of the standard host build, so Python stays absent unless this target is run.
# Build the matching host first: an exact Jube service-table bump must not
# leave a freshly stamped module paired with a stale executable.
build-lang-python: build build-windows-host-import $(TREE_SITTER_PYTHON_LIB)
	@echo "Building external lang-python hosted module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native lang-python -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	@ls -lh modules/lang-python/lang-python.dylib modules/lang-python/lang-python.so modules/lang-python/lang-python.dll 2>/dev/null || true

build-windows-host-import: build
	@if [ "$(findstring NT,$(OS))" != "" ]; then \
		dlltool -D lambda.exe -d lambda_host_exports.def -l modules/lambda-host.lib; \
	fi

ifneq (,$(findstring NT,$(OS)))
NODE_MODULE_BUILD_FLAGS = -B
else
NODE_MODULE_BUILD_FLAGS =
endif

build-node-core: build build-windows-host-import
	@echo "Building external node-core Jube module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native node-core $(NODE_MODULE_BUILD_FLAGS) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(PYTHON) utils/update_jube_manifest_integrity.py modules/node-core
	@ls -lh modules/node-core/node-core.dylib modules/node-core/node-core.so modules/node-core/node-core.dll 2>/dev/null || true

build-node-fs: build build-windows-host-import
	@echo "Building external node-fs Jube module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native node-fs $(NODE_MODULE_BUILD_FLAGS) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(PYTHON) utils/update_jube_manifest_integrity.py modules/node-fs
	@ls -lh modules/node-fs/node-fs.dylib modules/node-fs/node-fs.so modules/node-fs/node-fs.dll 2>/dev/null || true

build-node-net: build build-windows-host-import
	@echo "Building external node-net Jube module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native node-net $(NODE_MODULE_BUILD_FLAGS) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(PYTHON) utils/update_jube_manifest_integrity.py modules/node-net
	@ls -lh modules/node-net/node-net.dylib modules/node-net/node-net.so modules/node-net/node-net.dll 2>/dev/null || true

build-node-crypto: build build-windows-host-import
	@echo "Building external node-crypto Jube module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native node-crypto $(NODE_MODULE_BUILD_FLAGS) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(PYTHON) utils/update_jube_manifest_integrity.py modules/node-crypto
	@ls -lh modules/node-crypto/node-crypto.dylib modules/node-crypto/node-crypto.so modules/node-crypto/node-crypto.dll 2>/dev/null || true

build-node-zlib: build build-windows-host-import
	@echo "Building external node-zlib Jube module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native node-zlib $(NODE_MODULE_BUILD_FLAGS) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(PYTHON) utils/update_jube_manifest_integrity.py modules/node-zlib
	@ls -lh modules/node-zlib/node-zlib.dylib modules/node-zlib/node-zlib.so modules/node-zlib/node-zlib.dll 2>/dev/null || true

define release_node_module
release-node-$(1): release
	@echo "Building release node-$(1) Jube module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=release_native node-$(1) -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	$(PYTHON) utils/update_jube_manifest_integrity.py modules/node-$(1)
	@mkdir -p release/modules/node-$(1)
	@cp modules/node-$(1)/module.json release/modules/node-$(1)/module.json
	@cp modules/node-$(1)/node-$(1).dylib modules/node-$(1)/node-$(1).so modules/node-$(1)/node-$(1).dll release/modules/node-$(1)/ 2>/dev/null || true
endef

$(eval $(call release_node_module,core))
$(eval $(call release_node_module,fs))
$(eval $(call release_node_module,net))
$(eval $(call release_node_module,crypto))
$(eval $(call release_node_module,zlib))

# The release language module is built independently, then copied next to the
# full distribution's unchanged host executable.  The standard bundle never
# depends on this target.
release-lang-python: release $(TREE_SITTER_PYTHON_LIB)
	@echo "Building release lang-python hosted module..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=release_native lang-python -j$(JOBS) CC="$(CC)" CXX="$(CXX)" --no-print-directory -s CFLAGS="-w" CXXFLAGS="-w"
	@mkdir -p release/modules/lang-python
	@cp modules/lang-python/module.json release/modules/lang-python/module.json
	@cp modules/lang-python/lang-python.dylib modules/lang-python/lang-python.so modules/lang-python/lang-python.dll release/modules/lang-python/ 2>/dev/null || true

# Standard and full Jube packages deliberately reuse the identical host.  The
# full package adds language modules; it never recompiles a second runtime.
package-standard: release-node-core release-node-fs release-node-net release-node-crypto release-node-zlib
	@mkdir -p release-standard
	@cp release/lambda release-standard/lambda
	@mkdir -p release-standard/modules
	@cp modules/module-set.json release-standard/modules/module-set.json
	# The module set advertises node-core, node-fs, node-net, and node-crypto, so their images must ship
	# with the compatibility bundle instead of falling back to host providers.
	@mkdir -p release-standard/modules/node-core
	@cp release/modules/node-core/module.json release-standard/modules/node-core/module.json
	@cp release/modules/node-core/node-core.dylib release/modules/node-core/node-core.so release/modules/node-core/node-core.dll release-standard/modules/node-core/ 2>/dev/null || true
	@mkdir -p release-standard/modules/node-fs
	@cp release/modules/node-fs/module.json release-standard/modules/node-fs/module.json
	@cp release/modules/node-fs/node-fs.dylib release/modules/node-fs/node-fs.so release/modules/node-fs/node-fs.dll release-standard/modules/node-fs/ 2>/dev/null || true
	@mkdir -p release-standard/modules/node-net
	@cp release/modules/node-net/module.json release-standard/modules/node-net/module.json
	@cp release/modules/node-net/node-net.dylib release/modules/node-net/node-net.so release/modules/node-net/node-net.dll release-standard/modules/node-net/ 2>/dev/null || true
	@mkdir -p release-standard/modules/node-crypto
	@cp release/modules/node-crypto/module.json release-standard/modules/node-crypto/module.json
	@cp release/modules/node-crypto/node-crypto.dylib release/modules/node-crypto/node-crypto.so release/modules/node-crypto/node-crypto.dll release-standard/modules/node-crypto/ 2>/dev/null || true
	@mkdir -p release-standard/modules/node-zlib
	@cp release/modules/node-zlib/module.json release-standard/modules/node-zlib/module.json
	@cp release/modules/node-zlib/node-zlib.dylib release/modules/node-zlib/node-zlib.so release/modules/node-zlib/node-zlib.dll release-standard/modules/node-zlib/ 2>/dev/null || true
	@for module in node-core node-fs node-net node-crypto node-zlib; do \
		if ! find "release-standard/modules/$$module" -maxdepth 1 -type f \
			\( -name "$$module.dylib" -o -name "$$module.so" -o -name "$$module.dll" \) \
			-print -quit | rg -q .; then \
			echo "missing packaged $$module image"; exit 1; \
		fi; \
	done
	# Keep a manifest-only descriptor so a missing optional language has a
	# deterministic diagnostic without putting its grammar or native code in the host.
	@mkdir -p release-standard/modules/lang-python
	@cp modules/lang-python/module.json release-standard/modules/lang-python/module.json

package-jube: package-standard release-lang-python
	@mkdir -p release-jube
	@cp release-standard/lambda release-jube/lambda
	@mkdir -p release-jube/modules/lang-python
	@cp release/modules/lang-python/module.json release-jube/modules/lang-python/module.json
	@cp release/modules/lang-python/lang-python.dylib release/modules/lang-python/lang-python.so release/modules/lang-python/lang-python.dll release-jube/modules/lang-python/ 2>/dev/null || true

# The first extraction leaves reduced-node equal to the compatibility host plus
# node-core activation. Later leaf manifests extend this target without ever
# recompiling the shared host binary.
package-node-reduced: release-node-core
	@mkdir -p release-node-reduced/modules
	@cp release/lambda release-node-reduced/lambda
	@cp modules/module-set-reduced.json release-node-reduced/modules/module-set.json
	@mkdir -p release-node-reduced/modules/node-core
	@cp release/modules/node-core/module.json release-node-reduced/modules/node-core/module.json
	@cp release/modules/node-core/node-core.dylib release/modules/node-core/node-core.so release/modules/node-core/node-core.dll release-node-reduced/modules/node-core/ 2>/dev/null || true
	@if ! find release-node-reduced/modules/node-core -maxdepth 1 -type f \
		\( -name 'node-core.dylib' -o -name 'node-core.so' -o -name 'node-core.dll' \) \
		-print -quit | rg -q .; then \
		echo "missing packaged node-core image"; exit 1; \
	fi
	# A cataloged but image-less leaf blocks legacy host fallback and reports the
	# profile's deliberate absence through Node's normal MODULE_NOT_FOUND path.
	@mkdir -p release-node-reduced/modules/node-fs
	@cp modules/node-fs/module.json release-node-reduced/modules/node-fs/module.json
	@mkdir -p release-node-reduced/modules/node-zlib
	@cp modules/node-zlib/module.json release-node-reduced/modules/node-zlib/module.json

# A minimal bundle deliberately has no module-set file. The registry therefore
# keeps node-core inactive while the same host binary remains usable for plain JS.
package-minimal: release
	@mkdir -p release-minimal/modules/node-zlib
	@cp release/lambda release-minimal/lambda
	@cp modules/node-zlib/module.json release-minimal/modules/node-zlib/module.json

verify-jube-package: package-jube
	@shasum -a 256 release-standard/lambda release-jube/lambda
	@cmp -s release-standard/lambda release-jube/lambda
	@mkdir -p temp/hosted-python-package-check
	@if cd temp/hosted-python-package-check && ../../release-standard/lambda py ../../test/py/test_py_basic.py --no-log >standard.out 2>standard.err; then \
		echo "standard bundle unexpectedly loaded lang-python"; exit 1; \
	fi
	@rg -q "Hosted language module for 'py' is unavailable or incompatible\." temp/hosted-python-package-check/standard.err
	@cd release-standard && ./lambda js -e "let z = require('zlib'); console.log(z.gunzipSync(z.gzipSync(Buffer.from('jube'))).toString())" --no-log | rg -x "jube"
	@cd release-standard && ./lambda js -e "console.log(require('zlib').crc32(Buffer.from('jube')))" --no-log | rg -x "1308032562"
	@cd release-standard && ./lambda js -e "console.log(require('buffer').Buffer === Buffer)" --no-log | rg -x "true"
	@cd release-standard && ./lambda js -e "console.log(require('fs').existsSync('../test/node/jube_fs_exists_registry.txt'))" --no-log | rg -x "true"
	@cd release-standard && ./lambda js -e "console.log(require('net').isIP('127.0.0.1'), typeof require('dns').lookup)" --no-log | rg -x "4 function"
	@cd release-jube && ./lambda py ../test/py/test_py_basic.py --no-log >/dev/null

verify-node-profile-packages: package-node-reduced package-minimal
	@cmp -s release-node-reduced/lambda release-minimal/lambda
	@cd release-node-reduced && ./lambda js -e "console.log(require('path').join('a', 'b'))" --no-log | rg -x "a/b"
	@mkdir -p temp/node-minimal-package-check
	@cd release-minimal && ./lambda js -e "console.log(1 + 1)" --no-log | rg -x "2"
	@cd release-minimal && ./lambda js -e "console.log(typeof Buffer)" --no-log | rg -x "undefined"
	@cd release-minimal && ./lambda js -e "console.log(typeof vm)" --no-log | rg -x "undefined"
	@cd release-minimal && ./lambda js -e "let moduleName = 'path'; try { require(moduleName) } catch (e) { console.log(e.code); console.log(e.message) }" --no-log | rg -x "MODULE_NOT_FOUND|Cannot find module 'path'"
	@cd release-node-reduced && ./lambda js -e "try { require('zlib') } catch (e) { console.log(e.code) }" --no-log | rg -x "MODULE_NOT_FOUND"
	@cd release-node-reduced && ./lambda js -e "try { require('net') } catch (e) { console.log(e.code) }" --no-log | rg -x "MODULE_NOT_FOUND"
	@cd release-minimal && ./lambda js -e "try { require('zlib') } catch (e) { console.log(e.code) }" --no-log | rg -x "MODULE_NOT_FOUND"

# The negative-fixture suite supplies an explicit digest and verifies that the
# loader rejects tampered bytes before dlopen can execute module initializers.
test-jube-module-integrity: build build-lang-python
	@$(PYTHON) utils/test_jube_module_loader_negative.py

# Loader rejection matrix for the external Python module.  It uses copied
# bundles so no test case can alter the active development module.
test-jube-module-loader-negative: build build-lang-python
	@python3 utils/test_jube_module_loader_negative.py

# Generic hosted-language dispatch must work before the language descriptor is
# loaded, including aliases and case-normalized source extensions.
test-jube-language-dispatch: build build-lang-python
	@python3 utils/test_jube_language_dispatch.py

# The source checker must prove its own retired-boundary rules with synthetic
# regressions, not merely pass because the current tree happens to be clean.
test-hosted-python-architecture-checker:
	@python3 utils/test_hosted_python_architecture_checker.py

test-node-module-architecture-checker:
	@python3 utils/test_node_module_architecture_checker.py
	@python3 utils/check_node_module_architecture.py --require-module-binary

# Node module coverage must stay independent from JavaScript runtime coverage.
.PHONY: test-js-node-test-separation
test-js-node-test-separation:
	@python3 utils/check_js_node_test_separation.py

# N2 fs-pilot gate: readFile/writeFile must keep their session-owned Jube work
# completion behavior both normally and under the forced-GC lifetime probe.
# node-fs is external, so a rebuilt host must not reuse a stale module image.
test-jube-node-fs-async-work: build build-node-fs build-node-core
	@./lambda.exe js test/node/fs_basic.js --no-log | diff -u test/node/fs_basic.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/fs_basic.js --no-log | diff -u test/node/fs_basic.txt -
	@./lambda.exe js test/node/jube_fs_async_work.js --no-log | diff -u test/node/jube_fs_async_work.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_async_work.js --no-log | diff -u test/node/jube_fs_async_work.txt -
	@./lambda.exe js test/node/jube_fs_permission_registry.js --permission --no-log | diff -u test/node/jube_fs_permission_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_permission_registry.js --permission --no-log | diff -u test/node/jube_fs_permission_registry.txt -
	@./lambda.exe js test/node/jube_fs_async_write_work.js --no-log | diff -u test/node/jube_fs_async_write_work.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_async_write_work.js --no-log | diff -u test/node/jube_fs_async_write_work.txt -
	@./lambda.exe js test/node/jube_fs_append_registry.js --no-log | diff -u test/node/jube_fs_append_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_append_registry.js --no-log | diff -u test/node/jube_fs_append_registry.txt -
	@./lambda.exe js test/node/jube_fs_promises_registry.js --no-log | diff -u test/node/jube_fs_promises_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_promises_registry.js --no-log | diff -u test/node/jube_fs_promises_registry.txt -
	@./lambda.exe js test/node/jube_fs_directory_registry.js --no-log | diff -u test/node/jube_fs_directory_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_directory_registry.js --no-log | diff -u test/node/jube_fs_directory_registry.txt -
	@./lambda.exe js test/node/jube_fs_filehandle_registry.js --no-log | diff -u test/node/jube_fs_filehandle_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_filehandle_registry.js --no-log | diff -u test/node/jube_fs_filehandle_registry.txt -
	@./lambda.exe js test/node/jube_fs_stats_registry.js --no-log | diff -u test/node/jube_fs_stats_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_stats_registry.js --no-log | diff -u test/node/jube_fs_stats_registry.txt -
	@./lambda.exe js test/node/jube_fs_descriptor_callback_registry.js --no-log | diff -u test/node/jube_fs_descriptor_callback_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_descriptor_callback_registry.js --no-log | diff -u test/node/jube_fs_descriptor_callback_registry.txt -
	@./lambda.exe js test/node/jube_fs_descriptor_io_callback_registry.js --no-log | diff -u test/node/jube_fs_descriptor_io_callback_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_descriptor_io_callback_registry.js --no-log | diff -u test/node/jube_fs_descriptor_io_callback_registry.txt -
	@./lambda.exe js test/node/jube_fs_directory_callback_registry.js --no-log | diff -u test/node/jube_fs_directory_callback_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_directory_callback_registry.js --no-log | diff -u test/node/jube_fs_directory_callback_registry.txt -
	@./lambda.exe js test/node/jube_fs_directory_promises_registry.js --no-log | diff -u test/node/jube_fs_directory_promises_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_directory_promises_registry.js --no-log | diff -u test/node/jube_fs_directory_promises_registry.txt -
	@./lambda.exe js test/node/jube_fs_access_registry.js --no-log | diff -u test/node/jube_fs_access_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_access_registry.js --no-log | diff -u test/node/jube_fs_access_registry.txt -
	@./lambda.exe js test/node/jube_fs_chmod_registry.js --no-log | diff -u test/node/jube_fs_chmod_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_chmod_registry.js --no-log | diff -u test/node/jube_fs_chmod_registry.txt -
	@./lambda.exe js test/node/jube_fs_copy_file_registry.js --no-log | diff -u test/node/jube_fs_copy_file_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_copy_file_registry.js --no-log | diff -u test/node/jube_fs_copy_file_registry.txt -
	@./lambda.exe js test/node/jube_fs_truncate_registry.js --no-log | diff -u test/node/jube_fs_truncate_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_truncate_registry.js --no-log | diff -u test/node/jube_fs_truncate_registry.txt -
	@./lambda.exe js test/node/jube_fs_rm_registry.js --no-log | diff -u test/node/jube_fs_rm_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_rm_registry.js --no-log | diff -u test/node/jube_fs_rm_registry.txt -
	@./lambda.exe js test/node/jube_fs_realpath_registry.js --no-log | diff -u test/node/jube_fs_realpath_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_realpath_registry.js --no-log | diff -u test/node/jube_fs_realpath_registry.txt -
	@./lambda.exe js test/node/jube_fs_mkdtemp_registry.js --no-log | diff -u test/node/jube_fs_mkdtemp_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_mkdtemp_registry.js --no-log | diff -u test/node/jube_fs_mkdtemp_registry.txt -
	@./lambda.exe js test/node/jube_fs_link_registry.js --no-log | diff -u test/node/jube_fs_link_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_link_registry.js --no-log | diff -u test/node/jube_fs_link_registry.txt -
	@./lambda.exe js test/node/jube_fs_vector_registry.js --no-log | diff -u test/node/jube_fs_vector_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_vector_registry.js --no-log | diff -u test/node/jube_fs_vector_registry.txt -
	@./lambda.exe js test/node/jube_fs_symlink_registry.js --no-log | diff -u test/node/jube_fs_symlink_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_symlink_registry.js --no-log | diff -u test/node/jube_fs_symlink_registry.txt -
	@./lambda.exe js test/node/jube_fs_watch_stub_registry.js --no-log | diff -u test/node/jube_fs_watch_stub_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_watch_stub_registry.js --no-log | diff -u test/node/jube_fs_watch_stub_registry.txt -
	@./lambda.exe js test/node/jube_fs_legacy_stub_registry.js --no-log | diff -u test/node/jube_fs_legacy_stub_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_legacy_stub_registry.js --no-log | diff -u test/node/jube_fs_legacy_stub_registry.txt -
	@./lambda.exe js test/node/jube_fs_statfs_registry.js --no-log | diff -u test/node/jube_fs_statfs_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_statfs_registry.js --no-log | diff -u test/node/jube_fs_statfs_registry.txt -
	@./lambda.exe js test/node/jube_fs_readlink_registry.js --no-log | diff -u test/node/jube_fs_readlink_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_readlink_registry.js --no-log | diff -u test/node/jube_fs_readlink_registry.txt -
	@./lambda.exe js test/node/jube_fs_chown_registry.js --no-log | diff -u test/node/jube_fs_chown_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_chown_registry.js --no-log | diff -u test/node/jube_fs_chown_registry.txt -
	@./lambda.exe js test/node/jube_fs_exists_registry.js --no-log | diff -u test/node/jube_fs_exists_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_exists_registry.js --no-log | diff -u test/node/jube_fs_exists_registry.txt -
	@./lambda.exe js test/node/jube_fs_constants_registry.js --no-log | diff -u test/node/jube_fs_constants_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_constants_registry.js --no-log | diff -u test/node/jube_fs_constants_registry.txt -
	@./lambda.exe js test/node/jube_fs_timestamp_registry.js --no-log | diff -u test/node/jube_fs_timestamp_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_timestamp_registry.js --no-log | diff -u test/node/jube_fs_timestamp_registry.txt -
	@./lambda.exe js test/node/jube_fs_promisify_args_registry.js --no-log | diff -u test/node/jube_fs_promisify_args_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_promisify_args_registry.js --no-log | diff -u test/node/jube_fs_promisify_args_registry.txt -
	@./lambda.exe js test/node/jube_fs_stream_factory_registry.js --no-log | diff -u test/node/jube_fs_stream_factory_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_stream_factory_registry.js --no-log | diff -u test/node/jube_fs_stream_factory_registry.txt -

# node-fs owns callback read/write behavior through the permission, domain,
# root, and work services in both static and isolated dynamic profiles.
test-jube-node-fs-dynamic: build-node-fs build-node-core
	@mkdir -p temp/node-fs-dynamic/node-core temp/node-fs-dynamic/node-fs
	@cp modules/node-core/module.json temp/node-fs-dynamic/node-core/module.json
	@cp modules/node-core/node-core.dylib modules/node-core/node-core.so modules/node-core/node-core.dll temp/node-fs-dynamic/node-core/ 2>/dev/null || true
	@cp modules/node-fs/module.json temp/node-fs-dynamic/node-fs/module.json
	@cp modules/node-fs/node-fs.dylib modules/node-fs/node-fs.so modules/node-fs/node-fs.dll temp/node-fs-dynamic/node-fs/ 2>/dev/null || true
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/fs_basic.js --no-log | diff -u test/node/fs_basic.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic ./lambda.exe js test/node/jube_fs_async_work.js --no-log | diff -u test/node/jube_fs_async_work.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_permission_registry.js --permission --no-log | diff -u test/node/jube_fs_permission_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_async_write_work.js --no-log | diff -u test/node/jube_fs_async_write_work.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_append_registry.js --no-log | diff -u test/node/jube_fs_append_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_promises_registry.js --no-log | diff -u test/node/jube_fs_promises_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_directory_registry.js --no-log | diff -u test/node/jube_fs_directory_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_filehandle_registry.js --no-log | diff -u test/node/jube_fs_filehandle_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_stats_registry.js --no-log | diff -u test/node/jube_fs_stats_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_descriptor_callback_registry.js --no-log | diff -u test/node/jube_fs_descriptor_callback_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_descriptor_io_callback_registry.js --no-log | diff -u test/node/jube_fs_descriptor_io_callback_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_directory_callback_registry.js --no-log | diff -u test/node/jube_fs_directory_callback_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_directory_promises_registry.js --no-log | diff -u test/node/jube_fs_directory_promises_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_access_registry.js --no-log | diff -u test/node/jube_fs_access_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_chmod_registry.js --no-log | diff -u test/node/jube_fs_chmod_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_copy_file_registry.js --no-log | diff -u test/node/jube_fs_copy_file_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_truncate_registry.js --no-log | diff -u test/node/jube_fs_truncate_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_rm_registry.js --no-log | diff -u test/node/jube_fs_rm_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_realpath_registry.js --no-log | diff -u test/node/jube_fs_realpath_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_mkdtemp_registry.js --no-log | diff -u test/node/jube_fs_mkdtemp_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_link_registry.js --no-log | diff -u test/node/jube_fs_link_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_vector_registry.js --no-log | diff -u test/node/jube_fs_vector_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_symlink_registry.js --no-log | diff -u test/node/jube_fs_symlink_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_watch_stub_registry.js --no-log | diff -u test/node/jube_fs_watch_stub_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_legacy_stub_registry.js --no-log | diff -u test/node/jube_fs_legacy_stub_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_statfs_registry.js --no-log | diff -u test/node/jube_fs_statfs_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_readlink_registry.js --no-log | diff -u test/node/jube_fs_readlink_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_chown_registry.js --no-log | diff -u test/node/jube_fs_chown_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_exists_registry.js --no-log | diff -u test/node/jube_fs_exists_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_constants_registry.js --no-log | diff -u test/node/jube_fs_constants_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_timestamp_registry.js --no-log | diff -u test/node/jube_fs_timestamp_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_promisify_args_registry.js --no-log | diff -u test/node/jube_fs_promisify_args_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-fs-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_fs_stream_factory_registry.js --no-log | diff -u test/node/jube_fs_stream_factory_registry.txt -

test-jube-node-fs-negative: build-node-fs build-node-core
	@python3 utils/test_jube_module_loader_negative.py --runtime-module-dir modules/node-fs --runtime-specifier fs

test-jube-node-net-negative: build-node-net build-node-core
	@python3 utils/test_jube_module_loader_negative.py --runtime-module-dir modules/node-net --runtime-specifier net

# N3 leaf gate: normal decoding plus the forced-GC namespace/constructor
# lifetime probe after each node-core leaf moves behind Jube tables.
test-jube-node-core-leaves: build
	@./lambda.exe js test/node/jube_string_decoder_registry.js --no-log | diff -u test/node/jube_string_decoder_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_string_decoder_gc_namespace.js --no-log | diff -u test/node/jube_string_decoder_gc_namespace.txt -
	@./lambda.exe js test/node/jube_querystring_registry.js --no-log | diff -u test/node/jube_querystring_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_querystring_registry.js --no-log | diff -u test/node/jube_querystring_registry.txt -
	@./lambda.exe js test/node/jube_os_registry.js --no-log | diff -u test/node/jube_os_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_os_registry.js --no-log | diff -u test/node/jube_os_registry.txt -
	@./lambda.exe js test/node/jube_url_registry.js --no-log | diff -u test/node/jube_url_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_url_registry.js --no-log | diff -u test/node/jube_url_registry.txt -
	@./lambda.exe js test/node/jube_events_registry.js --no-log | diff -u test/node/jube_events_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_events_gc_registry.js --no-log | diff -u test/node/jube_events_gc_registry.txt -
	@./lambda.exe js test/node/jube_punycode_registry.js --no-log | diff -u test/node/jube_punycode_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_punycode_registry.js --no-log | diff -u test/node/jube_punycode_registry.txt -
	@./lambda.exe js test/node/jube_timers_promises_registry.js --no-log | diff -u test/node/jube_timers_promises_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_timers_promises_registry.js --no-log | diff -u test/node/jube_timers_promises_registry.txt -
	@./lambda.exe js test/node/jube_constants_registry.js --no-log | diff -u test/node/jube_constants_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_constants_registry.js --no-log | diff -u test/node/jube_constants_registry.txt -
	@./lambda.exe js test/node/jube_v8_registry.js --no-log | diff -u test/node/jube_v8_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_v8_registry.js --no-log | diff -u test/node/jube_v8_registry.txt -
	@./lambda.exe js test/node/jube_perf_hooks_registry.js --no-log | diff -u test/node/jube_perf_hooks_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_perf_hooks_registry.js --no-log | diff -u test/node/jube_perf_hooks_registry.txt -
	@./lambda.exe js test/node/jube_workers_registry.js --no-log | diff -u test/node/jube_workers_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_workers_registry.js --no-log | diff -u test/node/jube_workers_registry.txt -
	@./lambda.exe js test/node/worker_message_port_lifecycle.js --no-log | diff -u test/node/worker_message_port_lifecycle.txt -
	@./lambda.exe js test/node/jube_tty_registry.js --no-log | diff -u test/node/jube_tty_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_tty_registry.js --no-log | diff -u test/node/jube_tty_registry.txt -
	@./lambda.exe js test/node/jube_module_registry.js --no-log | diff -u test/node/jube_module_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_module_registry.js --no-log | diff -u test/node/jube_module_registry.txt -
	@./lambda.exe js test/node/jube_vm_registry.js --no-log | diff -u test/node/jube_vm_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_vm_registry.js --no-log | diff -u test/node/jube_vm_registry.txt -
	@./lambda.exe js test/node/jube_runtime_services_registry.js --no-log | diff -u test/node/jube_runtime_services_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_runtime_services_registry.js --no-log | diff -u test/node/jube_runtime_services_registry.txt -
	@./lambda.exe js test/node/jube_domain_registry.js --no-log | diff -u test/node/jube_domain_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_domain_registry.js --no-log | diff -u test/node/jube_domain_registry.txt -
	@./lambda.exe js test/node/jube_cluster_registry.js --no-log | diff -u test/node/jube_cluster_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_cluster_registry.js --no-log | diff -u test/node/jube_cluster_registry.txt -
	@./lambda.exe js test/node/jube_readline_test_registry.js --no-log | diff -u test/node/jube_readline_test_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_readline_test_registry.js --no-log | diff -u test/node/jube_readline_test_registry.txt -
	@./lambda.exe js test/node/jube_buffer_registry.js --no-log | diff -u test/node/jube_buffer_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_buffer_registry.js --no-log | diff -u test/node/jube_buffer_registry.txt -
	@./lambda.exe js test/node/jube_util_registry.js --no-log | diff -u test/node/jube_util_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_util_registry.js --no-log | diff -u test/node/jube_util_registry.txt -
	@./lambda.exe js test/node/jube_assert_registry.js --no-log | diff -u test/node/jube_assert_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_assert_registry.js --no-log | diff -u test/node/jube_assert_registry.txt -
	@./lambda.exe js test/node/jube_stream_registry.js --no-log | diff -u test/node/jube_stream_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_stream_registry.js --no-log | diff -u test/node/jube_stream_registry.txt -
	@./lambda.exe js test/node/jube_repl_registry.js --no-log | diff -u test/node/jube_repl_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_repl_registry.js --no-log | diff -u test/node/jube_repl_registry.txt -
	@./lambda.exe js test/node/jube_diagnostics_channel_registry.js --no-log | diff -u test/node/jube_diagnostics_channel_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_diagnostics_channel_registry.js --no-log | diff -u test/node/jube_diagnostics_channel_registry.txt -
	@./lambda.exe js test/node/jube_host_globals_registry.js --no-log | diff -u test/node/jube_host_globals_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_host_globals_registry.js --no-log | diff -u test/node/jube_host_globals_registry.txt -
	@./lambda.exe js test/node/jube_process_registry.js --no-log | diff -u test/node/jube_process_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_process_registry.js --no-log | diff -u test/node/jube_process_registry.txt -
	@./lambda.exe js test/node/jube_net_resource_registry.js --no-log | diff -u test/node/jube_net_resource_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_net_resource_registry.js --no-log | diff -u test/node/jube_net_resource_registry.txt -
	@./lambda.exe js test/node/jube_net_ip_registry.js --no-log | diff -u test/node/jube_net_ip_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_net_ip_registry.js --no-log | diff -u test/node/jube_net_ip_registry.txt -
	@./lambda.exe js test/node/jube_host_namespace_registry.js --no-log | diff -u test/node/jube_host_namespace_registry.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_host_namespace_registry.js --no-log | diff -u test/node/jube_host_namespace_registry.txt -
	@./lambda.exe js test/node/jube_cluster_online_hook.js --no-log | diff -u test/node/jube_cluster_online_hook.txt -
	@./lambda.exe js test/node/jube_console_formatter_hook.js --no-log | diff -u test/node/jube_console_formatter_hook.txt -
	@JUBE_MODULE_PATH=./temp/no-node-profile ./lambda.exe js test/node/jube_console_minimal_formatter.js --no-log | diff -u test/node/jube_console_minimal_formatter.txt -

# Tune1's merged Item error lane must preserve identity through nested calls,
# accessors, primitive throws, finally, and forced collection.
test-jube-node-error-lane: build
	@./lambda.exe js test/node/js_tune1_error_lane.js --no-log | diff -u test/node/js_tune1_error_lane.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/js_tune1_error_lane.js --no-log | diff -u test/node/js_tune1_error_lane.txt -
	@./lambda.exe js test/node/jube_error_ordinary_properties.js --no-log | diff -u test/node/jube_error_ordinary_properties.txt -
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_error_ordinary_properties.js --no-log | diff -u test/node/jube_error_ordinary_properties.txt -

# Static-to-dynamic parity gate. The isolated root deliberately has no
# module-set file, so node-core cannot be registered from the executable.
# Host-namespace parity imports fs, whose dynamic provider is node-fs; stage
# the dependency so this isolated core image cannot silently fall back static.
test-jube-node-core-dynamic: build-node-core build-node-fs build-node-net
	@mkdir -p temp/node-core-dynamic/node-core temp/node-core-dynamic/node-fs temp/node-core-dynamic/node-net
	@cp modules/node-core/module.json temp/node-core-dynamic/node-core/module.json
	@cp modules/node-core/node-core.dylib modules/node-core/node-core.so modules/node-core/node-core.dll temp/node-core-dynamic/node-core/ 2>/dev/null || true
	@cp modules/node-fs/module.json temp/node-core-dynamic/node-fs/module.json
	@cp modules/node-fs/node-fs.dylib modules/node-fs/node-fs.so modules/node-fs/node-fs.dll temp/node-core-dynamic/node-fs/ 2>/dev/null || true
	@cp modules/node-net/module.json temp/node-core-dynamic/node-net/module.json
	@cp modules/node-net/node-net.dylib modules/node-net/node-net.so modules/node-net/node-net.dll temp/node-core-dynamic/node-net/ 2>/dev/null || true
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_constants_registry.js --no-log | diff -u test/node/jube_constants_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_timers_promises_registry.js --no-log | diff -u test/node/jube_timers_promises_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_v8_registry.js --no-log | diff -u test/node/jube_v8_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_v8_registry.js --no-log | diff -u test/node/jube_v8_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_perf_hooks_registry.js --no-log | diff -u test/node/jube_perf_hooks_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_perf_hooks_registry.js --no-log | diff -u test/node/jube_perf_hooks_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_workers_registry.js --no-log | diff -u test/node/jube_workers_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_workers_registry.js --no-log | diff -u test/node/jube_workers_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_tty_registry.js --no-log | diff -u test/node/jube_tty_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_tty_registry.js --no-log | diff -u test/node/jube_tty_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_module_registry.js --no-log | diff -u test/node/jube_module_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_module_registry.js --no-log | diff -u test/node/jube_module_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_vm_registry.js --no-log | diff -u test/node/jube_vm_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_vm_registry.js --no-log | diff -u test/node/jube_vm_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_runtime_services_registry.js --no-log | diff -u test/node/jube_runtime_services_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_runtime_services_registry.js --no-log | diff -u test/node/jube_runtime_services_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_domain_registry.js --no-log | diff -u test/node/jube_domain_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_domain_registry.js --no-log | diff -u test/node/jube_domain_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_cluster_registry.js --no-log | diff -u test/node/jube_cluster_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_cluster_registry.js --no-log | diff -u test/node/jube_cluster_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_readline_test_registry.js --no-log | diff -u test/node/jube_readline_test_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_readline_test_registry.js --no-log | diff -u test/node/jube_readline_test_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_buffer_registry.js --no-log | diff -u test/node/jube_buffer_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_buffer_registry.js --no-log | diff -u test/node/jube_buffer_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_util_registry.js --no-log | diff -u test/node/jube_util_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_util_registry.js --no-log | diff -u test/node/jube_util_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_assert_registry.js --no-log | diff -u test/node/jube_assert_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_assert_registry.js --no-log | diff -u test/node/jube_assert_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_stream_registry.js --no-log | diff -u test/node/jube_stream_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_stream_registry.js --no-log | diff -u test/node/jube_stream_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_repl_registry.js --no-log | diff -u test/node/jube_repl_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_repl_registry.js --no-log | diff -u test/node/jube_repl_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_diagnostics_channel_registry.js --no-log | diff -u test/node/jube_diagnostics_channel_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_diagnostics_channel_registry.js --no-log | diff -u test/node/jube_diagnostics_channel_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_host_globals_registry.js --no-log | diff -u test/node/jube_host_globals_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_host_globals_registry.js --no-log | diff -u test/node/jube_host_globals_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_process_registry.js --no-log | diff -u test/node/jube_process_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_process_registry.js --no-log | diff -u test/node/jube_process_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_net_ip_registry.js --no-log | diff -u test/node/jube_net_ip_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_net_ip_registry.js --no-log | diff -u test/node/jube_net_ip_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_host_namespace_registry.js --no-log | diff -u test/node/jube_host_namespace_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_host_namespace_registry.js --no-log | diff -u test/node/jube_host_namespace_registry.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_cluster_online_hook.js --no-log | diff -u test/node/jube_cluster_online_hook.txt -
	@JUBE_MODULE_PATH=./temp/node-core-dynamic ./lambda.exe js test/node/jube_console_formatter_hook.js --no-log | diff -u test/node/jube_console_formatter_hook.txt -

# N4 delivery proof: a no-module-set root activates node-zlib and its node-core
# dependency in dependency order; neither provider is statically registered.
test-jube-node-zlib-dynamic: build-node-zlib build-node-core
	@mkdir -p temp/node-zlib-dynamic/node-core temp/node-zlib-dynamic/node-zlib
	@cp modules/node-core/module.json temp/node-zlib-dynamic/node-core/module.json
	@cp modules/node-core/node-core.dylib modules/node-core/node-core.so modules/node-core/node-core.dll temp/node-zlib-dynamic/node-core/ 2>/dev/null || true
	@cp modules/node-zlib/module.json temp/node-zlib-dynamic/node-zlib/module.json
	@cp modules/node-zlib/node-zlib.dylib modules/node-zlib/node-zlib.so modules/node-zlib/node-zlib.dll temp/node-zlib-dynamic/node-zlib/ 2>/dev/null || true
	@JUBE_MODULE_PATH=./temp/node-zlib-dynamic ./lambda.exe js test/node/jube_zlib_dynamic_registry.js --no-log > temp/node-zlib-dynamic/normal.out
	@diff -u test/node/jube_zlib_dynamic_registry.txt temp/node-zlib-dynamic/normal.out
	@JUBE_MODULE_PATH=./temp/node-zlib-dynamic LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 ./lambda.exe js test/node/jube_zlib_dynamic_registry.js --no-log > temp/node-zlib-dynamic/forced.out
	@diff -u test/node/jube_zlib_dynamic_registry.txt temp/node-zlib-dynamic/forced.out

test-jube-node-zlib-negative: build-node-zlib build-node-core
	@python3 utils/test_jube_module_loader_negative.py --runtime-module-dir modules/node-zlib --runtime-specifier zlib

# The parity fixture now validates the module-owned namespace against its
# golden behavior; the host no longer contains a static zlib namespace.
test-jube-node-zlib-parity: build-node-zlib build-node-core
	@mkdir -p temp/node-zlib-dynamic/node-core temp/node-zlib-dynamic/node-zlib
	@cp modules/node-core/module.json temp/node-zlib-dynamic/node-core/module.json
	@cp modules/node-core/node-core.dylib modules/node-core/node-core.so modules/node-core/node-core.dll temp/node-zlib-dynamic/node-core/ 2>/dev/null || true
	@cp modules/node-zlib/module.json temp/node-zlib-dynamic/node-zlib/module.json
	@cp modules/node-zlib/node-zlib.dylib modules/node-zlib/node-zlib.so modules/node-zlib/node-zlib.dll temp/node-zlib-dynamic/node-zlib/ 2>/dev/null || true
	@JUBE_MODULE_PATH=./temp/node-zlib-dynamic ./lambda.exe js test/node/jube_zlib_parity_registry.js --no-log > temp/node-zlib-dynamic/dynamic.out
	@diff -u test/node/jube_zlib_parity_registry.txt temp/node-zlib-dynamic/dynamic.out

# N6 leaf delivery proof: DNS remains owned by node-net and crypto resolves
# through its own node-crypto image; neither namespace is a node-core fallback.
test-jube-node-net-crypto-dynamic: build-node-net build-node-crypto build-node-core
	@mkdir -p temp/node-net-crypto-dynamic/node-core temp/node-net-crypto-dynamic/node-net temp/node-net-crypto-dynamic/node-crypto
	@cp modules/node-core/module.json temp/node-net-crypto-dynamic/node-core/module.json
	@cp modules/node-core/node-core.dylib modules/node-core/node-core.so modules/node-core/node-core.dll temp/node-net-crypto-dynamic/node-core/ 2>/dev/null || true
	@cp modules/node-net/module.json temp/node-net-crypto-dynamic/node-net/module.json
	@cp modules/node-net/node-net.dylib modules/node-net/node-net.so modules/node-net/node-net.dll temp/node-net-crypto-dynamic/node-net/ 2>/dev/null || true
	@cp modules/node-crypto/module.json temp/node-net-crypto-dynamic/node-crypto/module.json
	@cp modules/node-crypto/node-crypto.dylib modules/node-crypto/node-crypto.so modules/node-crypto/node-crypto.dll temp/node-net-crypto-dynamic/node-crypto/ 2>/dev/null || true
	@JUBE_MODULE_PATH=./temp/node-net-crypto-dynamic ./lambda.exe js test/node/jube_node_net_crypto_dynamic.js --no-log | diff -u test/node/jube_node_net_crypto_dynamic.txt -

release-jube: package-jube
	@ln -sfn lambda release-jube/lambda-jube
	@echo "✅ Full Jube bundle uses the standard host plus modules."

# Build the compatibility host/module bundle and all test executables.
build-jube-test: build-jube build-test

# Run hosted Python through the compatibility host name.
test-jube: build-jube-test
	@LAMBDA_PY_HOST_EXE=./lambda-jube.exe ./test/test_py_gtest.exe

# Force rebuild (clean + build)
rebuild: clean-all
	@echo "Force rebuilding $(PROJECT_NAME) using Premake build system..."
	@echo "Generating Premake configuration..."
	$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)
	@echo "Generating makefiles..."
	$(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@echo "Building lambda executable with $(JOBS) parallel jobs..."
	$(MAKE) -C build/premake config=debug_native lambda -j$(JOBS) CC="$(CC)" CXX="$(CXX)"
	@echo "Rebuild completed. Executable: lambda.exe"

# Specific project builds
lambda: build

# Build all projects
all: lambda
	@echo "All projects built successfully."

build-wasm:
	@echo "Building WebAssembly version..."
	./compile-wasm.sh --linking-only

# Clean targets
clean:
	@echo "Cleaning build artifacts and executables..."
	@echo "Cleaning Premake build artifacts..."
	@rm -rf $(BUILD_DIR)/obj 2>/dev/null || true
	@rm -rf $(BUILD_DIR)/lib 2>/dev/null || true
	@echo "Cleaning legacy build artifacts (if any)..."
	@rm -rf $(BUILD_DIR)/*.o 2>/dev/null || true
	@rm -rf $(BUILD_DEBUG_DIR)/*.o 2>/dev/null || true
	@rm -rf $(BUILD_RELEASE_DIR)/*.o 2>/dev/null || true
	@rm -rf $(BUILD_WINDOWS_DIR)/*.o 2>/dev/null || true
	@rm -rf $(BUILD_LINUX_DIR)/*.o 2>/dev/null || true
	@rm -f $(BUILD_DIR)/*.d 2>/dev/null || true
	@rm -f $(BUILD_DEBUG_DIR)/*.d 2>/dev/null || true
	@rm -f $(BUILD_RELEASE_DIR)/*.d 2>/dev/null || true
	@rm -f $(BUILD_WINDOWS_DIR)/*.d 2>/dev/null || true
	@rm -f $(BUILD_LINUX_DIR)/*.d 2>/dev/null || true
	@rm -f $(BUILD_DIR)/*.compile_log 2>/dev/null || true
	@rm -f $(BUILD_DIR)/*.compile_status 2>/dev/null || true
	@rm -f $(BUILD_DEBUG_DIR)/*.compile_log 2>/dev/null || true
	@rm -f $(BUILD_DEBUG_DIR)/*.compile_status 2>/dev/null || true
	@rm -f $(BUILD_RELEASE_DIR)/*.compile_log 2>/dev/null || true
	@rm -f $(BUILD_RELEASE_DIR)/*.compile_status 2>/dev/null || true
	@rm -f $(BUILD_WINDOWS_DIR)/*.compile_log 2>/dev/null || true
	@rm -f $(BUILD_WINDOWS_DIR)/*.compile_status 2>/dev/null || true
	@rm -f $(BUILD_LINUX_DIR)/*.compile_log 2>/dev/null || true
	@rm -f $(BUILD_LINUX_DIR)/*.compile_status 2>/dev/null || true
	@echo "Cleaning executables..."
	@rm -f $(LAMBDA_EXE)
	@rm -f $(LAMBDA_PROFILE_EXE)
	@rm -f lambda_debug.exe
	@rm -f lambda_release.exe
	@rm -f lambda-windows.exe
	@rm -f lambda-linux.exe
	@rm -f .lambda_release_build
	@rm -f .lambda_release_backup.exe
	@rm -f .lambda_build_backup.exe
	@echo "Build artifacts and executables cleaned."

clean-test:
	@echo "Cleaning test build outputs..."
	@rm -rf test_output/ 2>/dev/null || true
	@find test/ -name "*.exe" -type f -delete 2>/dev/null || true
	@rm -f test_*.exe 2>/dev/null || true
	@rm -f *.exe.tmp 2>/dev/null || true
	@rm -f build_test_*.json 2>/dev/null || true
	@rm -f build_test_*.json.tmp 2>/dev/null || true
	@find test/ -name "*.dSYM" -type d -exec rm -rf {} + 2>/dev/null || true
	@find test/ -name "*.o" -type f -delete 2>/dev/null || true
	@echo "Test build outputs cleaned."

clean-grammar:
	@echo "Cleaning generated grammar and embed files..."
	@rm -f $(PARSER_C)
	@rm -f $(GRAMMAR_JSON)
	@rm -f $(NODE_TYPES_JSON)
	@echo "Generated grammar and embed files cleaned."

# IntelliSense support
intellisense:
	@echo "Updating IntelliSense database..."
	@./utils/update_intellisense.sh

# Generate type hierarchy chart
type-chart:
	dot -Tsvg doc/type_hierarchy.dot -o doc/type_hierarchy.svg
	@echo "Type hierarchy chart generated: doc/type_hierarchy.svg"

# Generate grammar explicitly (useful for development)
generate-grammar: $(PARSER_C) $(GRAMMAR_JSON) $(NODE_TYPES_JSON)
	@echo "Grammar generation complete."

# S16 Surface Syntax conformance for the Tree-sitter reference grammar:
# accept/reject pairs over the line-start classification, brace forms, control
# forms, and the audit rulings.
test-grammar-s16:
	@echo "== reference grammar (tree-sitter) =="
	@./test/ts_s16_conformance.sh
	@echo "== production parser (C) =="
	@./test/c_s16_conformance.sh

generate-names:
	$(PYTHON) -B utils/generate_well_known_names.py
	@echo "Generated NameId catalogs."

# Generate TypeScript grammar explicitly
generate-grammar-typescript: $(TS_PARSER_C)
	@echo "TypeScript grammar generation complete."

clean-all: clean-premake clean-test
	@echo "Removing all build directories..."
	@rm -rf $(BUILD_DIR)
	@rm -rf $(BUILD_DEBUG_DIR)
	@rm -rf $(BUILD_RELEASE_DIR)
	@rm -rf $(BUILD_WINDOWS_DIR)
	@rm -rf $(BUILD_LINUX_DIR)
	@echo "Cleaning tree-sitter libraries..."
	@rm -f lambda/tree-sitter/libtree-sitter.a lambda/tree-sitter/tree_sitter.o
	@rm -f lambda/tree-sitter-lambda/libtree-sitter-lambda.a lambda/tree-sitter-lambda/src/*.o
	@rm -f lambda/tree-sitter-javascript/libtree-sitter-javascript.a lambda/tree-sitter-javascript/src/*.o
	@rm -f lambda/tree-sitter-bash/libtree-sitter-bash.a lambda/tree-sitter-bash/src/*.o
	@rm -f lambda/tree-sitter-python/libtree-sitter-python.a lambda/tree-sitter-python/src/*.o
	@rm -f lambda/tree-sitter-typescript/libtree-sitter-typescript.a lambda/tree-sitter-typescript/src/*.o
	@rm -f lambda/tree-sitter-ruby/libtree-sitter-ruby.a lambda/tree-sitter-ruby/src/*.o
	@rm -f lambda/tree-sitter-latex/libtree-sitter-latex.a lambda/tree-sitter-latex/src/*.o
	@rm -f lambda/tree-sitter-latex-math/libtree-sitter-latex-math.a lambda/tree-sitter-latex-math/src/*.o
	@rm -rf build_temp/re2-noabsl/cmake_build
	@$(MAKE) --no-print-directory clean-mir
	@echo "All build directories and tree-sitter libraries cleaned."

distclean: clean-all clean-grammar clean-test
	@echo "Complete cleanup..."
	@rm -f $(LAMBDA_EXE)
	@rm -f $(LAMBDA_PROFILE_EXE)
	@rm -f lambda_debug.exe
	@rm -f lambda_release.exe
	@rm -f lambda-windows.exe
	@rm -f lambda-linux.exe
	@rm -f *.exe
	@echo "Complete cleanup finished."

# Development targets
test: build-test
	@echo "Clearing HTTP cache for clean test runs..."
	@rm -rf temp/cache
	@echo "Running lambda (core) test suites (excluding jube)..."
	@LAMBDA_TEST_HEAVY_LOAD=1 node test/test_run.js --exclude-target=jube --exclude-test=test_radiant_online_view_gtest --parallel

test-all: build-test
	@echo "Clearing HTTP cache for clean test runs..."
	@rm -rf temp/cache
	@echo "Running ALL test suites (baseline + extended)..."
	@LAMBDA_TEST_HEAVY_LOAD=1 node test/test_run.js --parallel

test-all-baseline: build-test
	@echo "Clearing HTTP cache for clean test runs..."
	@rm -rf temp/cache
	@echo "Running BASELINE test suites only..."
	@LAMBDA_TEST_HEAVY_LOAD=1 node test/test_run.js --category=baseline --parallel

# Keep the baseline report focused on test results. This target-specific value
# propagates through its build prerequisites without changing standalone builds.
# Lambda baseline cases, including ABI checks, are listed in the build config
# consumed by test_run.js so execution and final-summary accounting stay under
# one runner.
# ---------------------------------------------------------------------------
# Error completion / native-fault separation gate
# ---------------------------------------------------------------------------

check-error-recovery:
	@python3 test/error_handling/check_recovery_boundaries.py

# ---------------------------------------------------------------------------
# T0 AST interpreter (LAMBDA_TIER=interp) — vibe/impl/Lambda_Impl_Ast_Interp.md
# ---------------------------------------------------------------------------

# Differential gate: every script in the committed P0 subset must match its
# golden under the interpreter with zero fallbacks. Regenerate the subset with
# `python3 test/interp/tier_sweep.py` after any walker change.
test-lambda-interp:
	@echo "Running T0 interpreter differential over the committed subset..."
	@./test/test_interp_gtest.exe

# Full-corpus sweep: reports match / fallback / mismatch per script. A mismatch
# is a T0 bug by definition (SI3); a fallback is uncovered coverage.
# Sweep, then regenerate BOTH committed lists from that one sweep — they are a
# partition of the corpus and refreshing either alone lets them drift.
interp-sweep:
	@python3 test/interp/tier_sweep.py --out temp/sweep_full.tsv
	@python3 test/interp/refresh_lists.py --sweep temp/sweep_full.tsv

# §6 turnaround + memory report. Release build only (CLAUDE rule 10).
interp-bench:
	@echo "Generating the synthetic scale corpus..."
	@python3 test/interp/gen_bench.py
	@echo "Measuring both tiers (median of 5, one warm-up)..."
	@python3 test/interp/run_bench.py
	@python3 test/interp/repl_bench.py

test-lambda-baseline: TEST_BUILD_QUIET := 1
test-lambda-baseline: build-lambda-baseline test-input-baseline
	@echo "Clearing HTTP cache for clean test runs..."
	@rm -rf temp/cache
	@echo "Running LAMBDA baseline test suite..."
	# Pin the baseline's optimization contract to its ordinary debug host;
	# otherwise a stale standalone profile binary could be selected implicitly.
	@LAMBDA_TEST_HEAVY_LOAD=1 LAMBDA_JS_OPT_EXE=./lambda.exe node test/test_run.js --target=lambda --category=baseline --exclude-test=test_node_prelim_gtest --exclude-test=test_lambda_concurrency_gtest --parallel --input-results=test_output/input_baseline_results.json

# Keep the runtime-global and Lambda-adjacent gates explicit in the full Lambda lane.
test-lambda-full: test-lambda-baseline
	@echo "Running Lambda concurrency runtime gate..."
	@./test/test_lambda_concurrency_gtest.exe
	@echo "Running extended Lambda runtime gate..."
	@./test/test_lambda_extended_gtest.exe
	@echo "Running Lambda DOM-node gate..."
	@./test/test_lambda_domnode_gtest.exe
	@echo "Running Lambda validator-input gate..."
	@./test/test_validator_input_gtest.exe

# Permanent exact-root CI lane. Collection is injected only at public allocator
# boundaries, and poison makes a missed root deterministic instead of relying
# on a stale native-stack word or recycled slab contents.
#
# Keep the core lane independent of an optional hosted language.  This lets the
# standard host prove its root invariants without building or initializing
# Python, while the aggregate target preserves the historical full check.
test-gc-rooting-core: build
	@mkdir -p temp
	@echo "Running LambdaJS JIT exact-root forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/regression_side_stack_frame_gc.js > temp/gc_rooting_js_jit.txt
	@diff -u test/js/regression_side_stack_frame_gc.txt temp/gc_rooting_js_jit.txt
	@echo "Running Lambda-to-JS Promise membrane exact-root forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/concurrency_lambda_promise.js > temp/gc_rooting_lambda_promise.txt
	@diff -u test/js/concurrency_lambda_promise.txt temp/gc_rooting_lambda_promise.txt
	@echo "Running LambdaJS with-scope stack forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/regression_with_stack_gc.js > temp/gc_rooting_js_with.txt
	@diff -u test/js/regression_with_stack_gc.txt temp/gc_rooting_js_with.txt
	@echo "Running LambdaJS inherited-accessor forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/regression_property_accessor_gc.js > temp/gc_rooting_js_accessor.txt
	@diff -u test/js/regression_property_accessor_gc.txt temp/gc_rooting_js_accessor.txt
	@echo "Running LambdaJS eval state forced-GC gates..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/eval_basic.js > temp/gc_rooting_js_eval_basic.txt
	@diff -u test/js/eval_basic.txt temp/gc_rooting_js_eval_basic.txt
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/eval_local_var_nested.js > temp/gc_rooting_js_eval_local.txt
	@diff -u test/js/eval_local_var_nested.txt temp/gc_rooting_js_eval_local.txt
	@echo "Running LambdaJS deterministic randomized forced-GC gate..."
	@LAMBDA_GC_FORCE_SEED=1592594996 LAMBDA_GC_FORCE_ONE_IN=3 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --no-log test/js/regression_side_stack_frame_gc.js > temp/gc_rooting_js_random.txt
	@diff -u test/js/regression_side_stack_frame_gc.txt temp/gc_rooting_js_random.txt
	@echo "Running LambdaJS MIR-interpreter exact-root forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe js --mir-interp --no-log test/js/regression_side_stack_frame_gc.js > temp/gc_rooting_js_interp.txt
	@diff -u test/js/regression_side_stack_frame_gc.txt temp/gc_rooting_js_interp.txt
	@echo "Running Lambda MIR-Direct exact-root forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe run --no-log test/lambda/proc/proc_var.ls > temp/gc_rooting_lambda.txt
	@diff -u test/lambda/proc/proc_var.txt temp/gc_rooting_lambda.txt
	@echo "Running suspended partial-Item construction forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe run --no-log test/lambda/proc/proc_async_partial_item_gc.ls > temp/gc_rooting_proc_partial_item.txt
	@diff -u test/lambda/proc/proc_async_partial_item_gc.txt temp/gc_rooting_proc_partial_item.txt
	@echo "Running module-owned wide-scalar forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe --no-log test/lambda/uint64_storage_lifetime.ls > temp/gc_rooting_module_scalars.txt
	@diff -u test/lambda/uint64_storage_lifetime.txt temp/gc_rooting_module_scalars.txt
	@echo "Running number-model exact-conversion forced-GC gates..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe --no-log test/lambda/number_model_realign.ls > temp/gc_rooting_number_model_jit.txt
	@diff -u test/lambda/number_model_realign.txt temp/gc_rooting_number_model_jit.txt
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe --mir-interp --no-log test/lambda/number_model_realign.ls > temp/gc_rooting_number_model_interp.txt
	@diff -u test/lambda/number_model_realign.txt temp/gc_rooting_number_model_interp.txt
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		./lambda.exe run --no-log test/lambda/proc/proc_number_model_realign.ls > temp/gc_rooting_number_model_proc.txt
	@diff -u -b -B test/lambda/proc/proc_number_model_realign.txt temp/gc_rooting_number_model_proc.txt
	@python3 utils/check_gc_effects.py
	@python3 utils/check_gc_root_hazards.py
	@# The MIR emission corpus is swept by a driver rather than more shell
	@# blocks here: it runs every test/mir fixture plus the capture/hoist
	@# regressions through all three forced-GC modes and compares each against
	@# the same script's unstressed output, so adding a fixture extends this
	@# gate automatically. See MT4 in vibe/Lambda_Design_MIR_Emission_Test.md.
	@$(MAKE) --no-print-directory test-mir-gc-stress
	@echo "Core exact-root forced-GC gates passed."

# Forced-GC stress sweep over the MIR emission corpus (MT4). Also runs inside
# test-lambda-baseline; this target is the standalone entry point.
test-mir-gc-stress:
	@if [ ! -x test/test_mir_gc_stress_gtest.exe ]; then $(MAKE) --no-print-directory build-test; fi
	@echo "Running forced-GC stress sweep over the MIR emission corpus..."
	@./test/test_mir_gc_stress_gtest.exe

test-gc-rooting-python: build build-lang-python
	@mkdir -p temp
	@echo "Running LambdaPy closure exact-root forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		$${LAMBDA_PY_HOST_EXE:-./lambda.exe} py --no-log test/py/test_py_closures.py > temp/gc_rooting_py_closures.txt
	@diff -u test/py/test_py_closures.txt temp/gc_rooting_py_closures.txt
	@echo "Running LambdaPy generator exact-root forced-GC gate..."
	@LAMBDA_GC_FORCE_EVERY=1 LAMBDA_GC_POISON_FREED=1 \
		$${LAMBDA_PY_HOST_EXE:-./lambda.exe} py --no-log test/py/test_py_generators.py > temp/gc_rooting_py_generators.txt
	@diff -u test/py/test_py_generators.txt temp/gc_rooting_py_generators.txt
	@echo "Hosted-Python exact-root forced-GC gates passed."

test-gc-rooting: test-gc-rooting-core test-gc-rooting-python
	@echo "Aggregate exact-root forced-GC gates passed."

test-redex-baseline: build
	@echo "Running Redex formal semantics baseline verification..."
	@cd lambda/semantics && racket baseline-verify.rkt

test-bash-baseline: build-jube-test
	@echo "Running Bash transpiler baseline tests (requires lambda-jube)..."
	@./test/test_bash_run_gtest.exe

# Build only the js262 gtest runner if it is missing; full build-test is too broad here.
ensure-test262-gtest:
	@if [ ! -x ./test/test_js_test262_gtest.exe ]; then \
		echo "test/test_js_test262_gtest.exe not found; building js262 gtest runner only..."; \
		mkdir -p build/premake; \
		$(MAKE) generate-premake; \
		PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=$(PREMAKE_FILE); \
		PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake config=debug_native test_js_test262_gtest -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"; \
	else \
		echo "Using existing test/test_js_test262_gtest.exe"; \
	fi

# Fast runner-level Test262 gate. Rebuild the focused executable so source
# changes are never hidden by the existence-only ensure target above.
test-js262-prelim: ensure-test262-gtest
	@$(MAKE) -C build/premake config=debug_native test_js_test262_gtest -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"
	@./test/test_js_test262_gtest.exe --prelim

# D8.4.3 standing gate: a raw scalar or void helper must not silently regain
# an in-band error-lane contract that the emitter cannot transport.
test-js-exception-catalog:
	@python3 utils/js_exception_catalog_census.py --prefix js_ --violations

# D6.2.2v2 standing gate: executable targets, visible bindings, identity
# aliases, and call/construct capabilities remain one coherent catalog.
test-js-callable-catalog:
	@python3 utils/js_callable_census.py --check

# test262 baseline: run only tests in baseline, must pass 100%
# Add VERBOSE=1 to dump per-batch timing (top 20/top 5) and top-20 memory growth.
test262-baseline: test-js-exception-catalog ensure-test262-gtest
	@echo "Running test262 baseline ($(shell wc -l < test/js262/test262_baseline.txt | tr -d ' ') entries)..."
	@echo "Ensuring release lambda.exe for js262 runtime performance..."
	@$(MAKE) build-release-compile
	@./test/test_js_test262_gtest.exe --baseline-only --batch-only --run-async --async-list=test/js262/test262_baseline.txt $(if $(VERBOSE),--verbose)

# test262 full: run all discovered test262 tests (slow, ~5min)
test262-full: ensure-test262-gtest
	@echo "Running full test262 suite..."
	@echo "Ensuring release lambda.exe for js262 runtime performance..."
	@$(MAKE) build-release-compile
	@./test/test_js_test262_gtest.exe --batch-only --run-async --async-list=test/js262/test262_baseline.txt $(if $(VERBOSE),--verbose)

# test262 update baseline: run all tests and update baseline with current passing set
test262-update-baseline: build-test
	@echo "Running full test262 suite and updating baseline..."
	@echo "Ensuring release lambda.exe for js262 runtime performance..."
	@$(MAKE) build-release-compile
	@./test/test_js_test262_gtest.exe --batch-only --run-async --async-list=test/js262/test262_baseline.txt --update-baseline $(if $(VERBOSE),--verbose)

# Node.js official: install Lambda-compatible shims for test harness
node-shim:
	@echo "Installing Lambda test shims into ref/node/test/common/..."
	@if [ -d ref/node/test/common ]; then \
		if [ ! -f ref/node/test/common/index.js.orig ]; then \
			cp ref/node/test/common/index.js ref/node/test/common/index.js.orig; \
		fi; \
		if [ ! -f ref/node/test/common/tmpdir.js.orig ]; then \
			cp ref/node/test/common/tmpdir.js ref/node/test/common/tmpdir.js.orig; \
		fi; \
		if [ ! -f ref/node/test/common/fixtures.js.orig ]; then \
			cp ref/node/test/common/fixtures.js ref/node/test/common/fixtures.js.orig; \
		fi; \
		if [ ! -f ref/node/test/common/internet.js.orig ]; then \
			cp ref/node/test/common/internet.js ref/node/test/common/internet.js.orig; \
		fi; \
		if [ ! -f ref/node/test/common/wpt.js.orig ]; then \
			cp ref/node/test/common/wpt.js ref/node/test/common/wpt.js.orig; \
		fi; \
		if [ ! -f ref/node/test/common/dns.js.orig ]; then \
			cp ref/node/test/common/dns.js ref/node/test/common/dns.js.orig; \
		fi; \
		if [ ! -f ref/node/test/common/crypto.js.orig ]; then \
			cp ref/node/test/common/crypto.js ref/node/test/common/crypto.js.orig; \
		fi; \
		cp lambda/js/test_shim/common_index.js ref/node/test/common/index.js; \
		cp lambda/js/test_shim/tmpdir.js ref/node/test/common/tmpdir.js; \
		cp lambda/js/test_shim/fixtures.js ref/node/test/common/fixtures.js; \
		cp lambda/js/test_shim/internet.js ref/node/test/common/internet.js; \
		cp lambda/js/test_shim/wpt.js ref/node/test/common/wpt.js; \
		cp lambda/js/test_shim/dns.js ref/node/test/common/dns.js; \
		cp lambda/js/test_shim/crypto.js ref/node/test/common/crypto.js; \
		cp lambda/js/test_shim/package.json ref/node/test/common/package.json; \
		echo "Shims installed."; \
	else \
		echo "ERROR: ref/node/test/common/ not found. Clone Node.js repo first."; \
		exit 1; \
	fi

# Node.js official: restore original common module
node-shim-restore:
	@echo "Restoring original ref/node/test/common/..."
	@if [ -f ref/node/test/common/index.js.orig ]; then \
		mv ref/node/test/common/index.js.orig ref/node/test/common/index.js; \
		mv ref/node/test/common/tmpdir.js.orig ref/node/test/common/tmpdir.js; \
		mv ref/node/test/common/fixtures.js.orig ref/node/test/common/fixtures.js; \
		if [ -f ref/node/test/common/internet.js.orig ]; then \
			mv ref/node/test/common/internet.js.orig ref/node/test/common/internet.js; \
		fi; \
		if [ -f ref/node/test/common/wpt.js.orig ]; then \
			mv ref/node/test/common/wpt.js.orig ref/node/test/common/wpt.js; \
		fi; \
		if [ -f ref/node/test/common/dns.js.orig ]; then \
			mv ref/node/test/common/dns.js.orig ref/node/test/common/dns.js; \
		fi; \
		if [ -f ref/node/test/common/crypto.js.orig ]; then \
			mv ref/node/test/common/crypto.js.orig ref/node/test/common/crypto.js; \
		fi; \
		echo "Originals restored."; \
	else \
		echo "No backup found — nothing to restore."; \
	fi

# Node.js official test suite: run official Node.js tests from ref/node/test/parallel/
node-baseline: build-test node-shim
	@echo "Running Node.js official test suite..."
	@./test/test_node_gtest.exe --baseline-only

# Node.js official: fast regression gate for currently locked passing tests
node-regression-gate: build-test node-shim
	@echo "Running Node.js official regression gate..."
	@./test/test_node_gtest.exe --baseline-only --gtest_brief=1

# Node.js official: run full enabled official Node.js test sweep
node-full: build-test node-shim
	@echo "Running full Node.js official test suite..."
	@./test/test_node_gtest.exe

# Node.js official: update baseline with current passing set
node-update-baseline: build-test node-shim
	@echo "Running Node.js official test suite and updating baseline..."
	@./test/test_node_gtest.exe --update-baseline

# Node.js official: generate inventory/report from baseline plus latest temp run files
node-official-report:
	@$(PYTHON) -B test/node/node_official_report.py

ensure-yaml-submodule:
	@if [ ! -f test/yaml/229Q/=== ]; then \
		echo "Initializing test/yaml submodule..."; \
		git submodule update --init test/yaml; \
	fi

test-input-baseline: build-input-baseline ensure-yaml-submodule
	@echo "Clearing HTTP cache for clean test runs..."
	@rm -rf temp/cache
	@mkdir -p test_output
	@echo "=============================================================="
	@echo "🧪 Running INPUT baseline tests"
	@echo "=============================================================="
	@total_passed=0; \
	total_failed=0; \
	total_skipped=0; \
	wpt_passed=0; wpt_failed=0; wpt_skipped=0; wpt_status="⏭️  SKIP"; \
	md_passed=0; md_failed=0; md_skipped=0; md_status="⏭️  SKIP"; \
	yaml_passed=0; yaml_failed=0; yaml_skipped=0; yaml_status="⏭️  SKIP"; \
	math_passed=0; math_failed=0; math_skipped=0; math_status="⏭️  SKIP"; \
	latex_math_passed=0; latex_math_failed=0; latex_math_skipped=0; latex_math_status="⏭️  SKIP"; \
	\
	echo ""; \
	echo "📦 HTML5 WPT Parser Tests:"; \
	if [ -f "test/test_wpt_html_parser_gtest.exe" ]; then \
		output=$$(./test/test_wpt_html_parser_gtest.exe --baseline 2>&1) || true; \
		echo "$$output" | $(GTEST_PROGRESS_FILTER) | tail -20; \
		wpt_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		wpt_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		wpt_skipped=$$(echo "$$output" | grep -E "^\[  SKIPPED \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		wpt_passed=$${wpt_passed:-0}; wpt_failed=$${wpt_failed:-0}; wpt_skipped=$${wpt_skipped:-0}; \
		if [ "$$wpt_failed" = "0" ] || [ -z "$$wpt_failed" ]; then wpt_status="✅ PASS"; wpt_failed=0; else wpt_status="❌ FAIL"; fi; \
	else \
		echo "   ⚠️  test/test_wpt_html_parser_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 CommonMark Markdown Tests:"; \
	if [ -f "test/test_markdown_gtest.exe" ]; then \
		output=$$(./test/test_markdown_gtest.exe --baseline 2>&1) || true; \
		echo "$$output" | $(GTEST_PROGRESS_FILTER) | tail -20; \
		md_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		md_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		md_skipped=$$(echo "$$output" | grep -E "^\[  SKIPPED \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		md_passed=$${md_passed:-0}; md_failed=$${md_failed:-0}; md_skipped=$${md_skipped:-0}; \
		if [ "$$md_failed" = "0" ] || [ -z "$$md_failed" ]; then md_status="✅ PASS"; md_failed=0; else md_status="❌ FAIL"; fi; \
	else \
		echo "   ⚠️  test/test_markdown_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 YAML Suite Tests:"; \
	if [ -f "test/test_yaml_suite_gtest.exe" ]; then \
		output=$$(./test/test_yaml_suite_gtest.exe 2>&1) || true; \
		echo "$$output" | grep -E "^===|^Total|^Pass rate" | head -10; \
		yaml_total=$$(echo "$$output" | grep "Total test cases:" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		yaml_json_passed=$$(echo "$$output" | grep "JSON Comparison Results" -A1 | grep "Total:" | grep -oE "Passed: [0-9]+" | grep -oE "[0-9]+" || echo "0"); \
		yaml_json_failed=$$(echo "$$output" | grep "JSON Comparison Results" -A1 | grep "Total:" | grep -oE "Failed: [0-9]+" | grep -oE "[0-9]+" || echo "0"); \
		yaml_error_passed=$$(echo "$$output" | grep "Error Test Results" -A1 | grep "Total:" | grep -oE "Passed[^:]*: [0-9]+" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		yaml_parse_passed=$$(echo "$$output" | grep "Parse-Only Test Results" -A1 | grep "Total:" | grep -oE "Passed[^:]*: [0-9]+" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		yaml_passed=$$((yaml_json_passed + yaml_error_passed + yaml_parse_passed)); \
		yaml_passed=$${yaml_passed:-0}; yaml_json_failed=$${yaml_json_failed:-0}; \
		yaml_failed=$${yaml_json_failed:-0}; yaml_skipped=0; \
		if [ "$$yaml_failed" = "0" ] || [ -z "$$yaml_failed" ]; then yaml_status="✅ PASS"; yaml_failed=0; else yaml_status="❌ FAIL"; fi; \
	else \
		echo "   ⚠️  test/test_yaml_suite_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 ASCII Math Tests:"; \
	if [ -f "test/test_math_ascii_gtest.exe" ]; then \
		output=$$(./test/test_math_ascii_gtest.exe 2>&1) || true; \
		echo "$$output" | $(GTEST_PROGRESS_FILTER) | tail -20; \
		math_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		math_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		math_skipped=$$(echo "$$output" | grep -E "^\[  SKIPPED \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		math_passed=$${math_passed:-0}; math_failed=$${math_failed:-0}; math_skipped=$${math_skipped:-0}; \
		if [ "$$math_failed" = "0" ] || [ -z "$$math_failed" ]; then math_status="✅ PASS"; math_failed=0; else math_status="❌ FAIL"; fi; \
	else \
		echo "   ⚠️  test/test_math_ascii_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 LaTeX Math Tests:"; \
	if [ -f "test/test_math_gtest.exe" ]; then \
		output=$$(./test/test_math_gtest.exe 2>&1) || true; \
		echo "$$output" | $(GTEST_PROGRESS_FILTER) | tail -20; \
		latex_math_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		latex_math_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		latex_math_skipped=$$(echo "$$output" | grep -E "^\[  SKIPPED \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		latex_math_passed=$${latex_math_passed:-0}; latex_math_failed=$${latex_math_failed:-0}; latex_math_skipped=$${latex_math_skipped:-0}; \
		if [ "$$latex_math_failed" = "0" ] || [ -z "$$latex_math_failed" ]; then latex_math_status="✅ PASS"; latex_math_failed=0; else latex_math_status="❌ FAIL"; fi; \
	else \
		echo "   ⚠️  test/test_math_gtest.exe not found"; \
	fi; \
	\
	total_passed=$$((wpt_passed + md_passed + yaml_passed + math_passed + latex_math_passed)); \
	total_failed=$$((wpt_failed + md_failed + yaml_failed + math_failed + latex_math_failed)); \
	total_tests=$$((total_passed + total_failed)); \
	\
	echo ""; \
	echo "=============================================================="; \
	echo "🏁 INPUT BASELINE TEST RESULTS"; \
	echo "=============================================================="; \
	echo ""; \
	echo "📊 Test Results by Suite:"; \
	echo "   ├── HTML5 WPT Parser    $$wpt_status  ($$wpt_passed passed, $$wpt_failed failed)"; \
	echo "   ├── CommonMark Markdown $$md_status  ($$md_passed passed, $$md_failed failed)"; \
	echo "   ├── YAML Suite          $$yaml_status  ($$yaml_passed passed, $$yaml_failed failed)"; \
	echo "   ├── ASCII Math          $$math_status  ($$math_passed passed, $$math_failed failed)"; \
	echo "   └── LaTeX Math          $$latex_math_status  ($$latex_math_passed passed, $$latex_math_failed failed)"; \
	echo ""; \
	echo "📊 Overall Results:"; \
	echo "   Total Tests: $$total_tests"; \
	echo "   ✅ Passed:   $$total_passed"; \
	if [ $$total_failed -gt 0 ]; then \
		echo "   ❌ Failed:   $$total_failed"; \
	fi; \
	echo "=============================================================="; \
	echo "{\"total_passed\":$$total_passed,\"total_failed\":$$total_failed,\"suites\":[{\"name\":\"HTML5 WPT Parser\",\"passed\":$$wpt_passed,\"failed\":$$wpt_failed},{\"name\":\"CommonMark Markdown\",\"passed\":$$md_passed,\"failed\":$$md_failed},{\"name\":\"YAML Suite\",\"passed\":$$yaml_passed,\"failed\":$$yaml_failed},{\"name\":\"ASCII Math\",\"passed\":$$math_passed,\"failed\":$$math_failed},{\"name\":\"LaTeX Math\",\"passed\":$$latex_math_passed,\"failed\":$$latex_math_failed}]}" > test_output/input_baseline_results.json

# Layout baseline suites shared by test-radiant-baseline and test-layout-baseline.
LAYOUT_BASELINE_SUITES ?= baseline form wpt-css-box wpt-css-text wpt-css-inline wpt-css-sizing wpt-css-images wpt-css-tables wpt-css-lists wpt-css-position wpt-css-multicol puppertino markdown bootstrap tailwind
# The baseline target must select recorded entries before reporting aggregate
# failures; otherwise untracked work-in-progress fixtures are misreported as
# baseline regressions.
# Keep one shared layout context per 100-file batch; the runner resets
# document-scoped caches between files and reaps timed-out workers.
LAYOUT_BASELINE_RUNNER = $(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --baseline-only --batch-size 100 --concurrency 1
# Layout categories clear temp/ before each batch; keep aggregate records outside
# that workspace so a later suite cannot erase an earlier suite's result.
LAYOUT_BASELINE_RESULTS = test_output/_layout_baseline_results.txt

# Keep the layout-only and full Radiant reports on the same aggregation and
# rendering path so their suite totals cannot drift apart.
define DEFINE_TEST_DURATION_FORMATTER
format_duration() { \
	seconds="$$1"; \
	if [ "$$seconds" -ge 3600 ]; then \
		printf "%dh%dm%ds" $$((seconds / 3600)) $$(((seconds % 3600) / 60)) $$((seconds % 60)); \
	elif [ "$$seconds" -ge 60 ]; then \
		printf "%dm%ds" $$((seconds / 60)) $$((seconds % 60)); \
	else \
		printf "%ds" "$$seconds"; \
	fi; \
	};
endef

define COLLECT_LAYOUT_BASELINE_RESULTS
layout_results=$$(cat $(LAYOUT_BASELINE_RESULTS)); \
while IFS='|' read -r suite s_status s_passed s_partial s_failed s_skipped s_elapsed; do \
	layout_total_passed=$$((layout_total_passed + s_passed)); \
	layout_total_partial=$$((layout_total_partial + s_partial)); \
	layout_total_failed=$$((layout_total_failed + s_failed)); \
	layout_total_skipped=$$((layout_total_skipped + s_skipped)); \
	if [ "$$s_status" = "❌ FAIL" ]; then layout_overall_status="❌ FAIL"; any_failed=1; fi; \
done < $(LAYOUT_BASELINE_RESULTS); \
rm -f $(LAYOUT_BASELINE_RESULTS); \
if [ $$layout_run_exit -ne 0 ]; then layout_overall_status="❌ FAIL"; any_failed=1; fi;
endef

define PRINT_LAYOUT_BASELINE_SUITE_RESULTS
if [ -n "$$layout_results" ]; then \
	suite_count=$$(printf "%s\n" "$$layout_results" | wc -l | tr -d ' '); \
	suite_idx=0; \
	printf "%s\n" "$$layout_results" | while IFS='|' read -r sname sstatus spassed spartial sfailed sskipped selapsed; do \
		suite_idx=$$((suite_idx + 1)); \
		if [ $$suite_idx -eq $$suite_count ]; then \
			printf "   │   └── %-14s $$sstatus  (%s, $$spassed passed, $$spartial partially passing, $$sfailed failed, $$sskipped skipped) (test_radiant_layout.js -c $$sname)\n" "$$sname" "$$(format_duration "$$selapsed")"; \
		else \
			printf "   │   ├── %-14s $$sstatus  (%s, $$spassed passed, $$spartial partially passing, $$sfailed failed, $$sskipped skipped) (test_radiant_layout.js -c $$sname)\n" "$$sname" "$$(format_duration "$$selapsed")"; \
		fi; \
	done; \
fi;
endef

# Run the shared layout baseline inventory without building. Suites with a
# recorded baseline run only those entries; suites without one run in full.
run-layout-baseline-suites:
	@mkdir -p test_output; \
	> $(LAYOUT_BASELINE_RESULTS); \
	any_failed=0; \
	echo ""; \
	echo "📦 Layout Baseline Tests:"; \
	for suite in $(LAYOUT_BASELINE_SUITES); do \
		echo ""; \
		echo "  ▸ $$suite:"; \
		layout_log="test_output/_layout_baseline_$${suite}.log"; \
		rm -f "$$layout_log"; \
		layout_exit=0; \
		s_start=$$(date +%s); \
		$(LAYOUT_BASELINE_RUNNER) -c "$$suite" > "$$layout_log" 2>&1 || layout_exit=$$?; \
		s_elapsed=$$(($$(date +%s) - s_start)); \
		grep -E "Baseline-only:|No recorded baseline" "$$layout_log" | head -1 || true; \
		grep -A5 "Summary:" "$$layout_log" | tail -6 || true; \
		grep "Baseline Regressions" "$$layout_log" | head -1 || true; \
		s_passed=$$(grep "   ✅ Successful:" "$$layout_log" | grep -oE "[0-9]+" | head -1); s_passed=$${s_passed:-0}; \
		s_partial=$$(grep "   ⚠️  Partially Passing:" "$$layout_log" | grep -oE "[0-9]+" | head -1); s_partial=$${s_partial:-0}; \
		s_skipped=$$(grep "Skipped:" "$$layout_log" | grep -oE "[0-9]+" | head -1); s_skipped=$${s_skipped:-0}; \
		s_failed=$$(grep "   ❌ Failed:" "$$layout_log" | grep -oE "[0-9]+" | head -1); s_failed=$${s_failed:-0}; \
		s_status="✅ PASS"; \
		if grep -q "Baseline Regressions" "$$layout_log"; then \
			s_status="❌ FAIL"; any_failed=1; \
		elif [ $$layout_exit -ne 0 ] || ! grep -q "   ✅ Successful:" "$$layout_log"; then \
			if [ $$s_failed -eq 0 ]; then s_failed=1; fi; \
			s_status="❌ FAIL"; any_failed=1; \
		fi; \
		echo "$$suite|$$s_status|$$s_passed|$$s_partial|$$s_failed|$$s_skipped|$$s_elapsed" >> $(LAYOUT_BASELINE_RESULTS); \
		rm -f "$$layout_log"; \
	done; \
	if [ $$any_failed -gt 0 ]; then exit 1; fi

test-radiant-baseline: build-radiant-baseline
	@$(MAKE) --no-print-directory run-radiant-baseline

# Run radiant tests without rebuilding (use when test executables are already built).
# Commands wait directly on their child process; periodic polling used to round
# every short phase up to the next second and accumulated substantial tail time.
# Suite boundaries are timed here because the heterogeneous runners do not expose
# a common elapsed-time field in their result summaries.
# Layout details are retained in the parent shell because later child processes
# reuse the shared temp directory and may remove earlier runner artifacts.
# A crashed layout category must fail the gate instead of disappearing from its totals.
run-radiant-baseline:
	@ui_passed=0; ui_failed=0; ui_status="⏭️  SKIP"; \
	ui_elapsed=0; \
	dom_ui_passed=0; dom_ui_failed=0; dom_ui_status="⏭️  SKIP"; \
	dom_ui_elapsed=0; \
	radiant_view_passed=0; radiant_view_failed=0; radiant_view_status="⏭️  SKIP"; \
	radiant_view_elapsed=0; \
	page_passed=0; page_failed=0; page_status="⏭️  SKIP"; \
	page_elapsed=0; \
	fuzzy_passed=0; fuzzy_failed=0; fuzzy_status="⏭️  SKIP"; \
	fuzzy_elapsed=0; \
	render_passed=0; render_failed=0; render_total=0; render_xpassed=0; render_xfailed=0; render_skipped=0; render_errors=0; render_regressions=0; render_details="not run"; render_status="⏭️  SKIP"; \
	render_elapsed=0; \
	snapshot_passed=0; snapshot_failed=0; snapshot_status="⏭️  SKIP"; \
	snapshot_elapsed=0; \
	any_failed=0; \
	layout_total_passed=0; layout_total_partial=0; layout_total_failed=0; layout_total_skipped=0; \
	layout_elapsed=0; \
	layout_overall_status="✅ PASS"; \
	mkdir -p temp; \
	$(DEFINE_TEST_DURATION_FORMATTER) \
	run_logged() { \
		log_file="$$1"; shift; \
		rm -f "$$log_file"; \
		run_logged_start=$$(date +%s); \
		"$$@" > "$$log_file" 2>&1; \
		run_logged_exit=$$?; \
		run_logged_elapsed=$$(($$(date +%s) - run_logged_start)); \
		return $$run_logged_exit; \
	}; \
	\
	echo ""; \
	echo "=============================================================="; \
	echo "🧪 RADIANT BASELINE TEST SUITE"; \
	echo "=============================================================="; \
	\
	layout_run_exit=0; \
	layout_start=$$(date +%s); \
	$(MAKE) --no-print-directory run-layout-baseline-suites || layout_run_exit=$$?; \
	layout_elapsed=$$(($$(date +%s) - layout_start)); \
	$(COLLECT_LAYOUT_BASELINE_RESULTS) \
	if [ -f test/layout/snapshot/page.json ]; then \
		echo ""; \
		echo "📦 Layout Page Suite Regression:"; \
		snapshot_start=$$(date +%s); \
		snap_output=$$($(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css -c page --json -j 5 2>/dev/null \
			| node test/layout/layout_suite_snapshot.js --check page 2>&1) || true; \
		snapshot_elapsed=$$(($$(date +%s) - snapshot_start)); \
		echo "$$snap_output" | tail -5; \
		snapshot_passed=$$(echo "$$snap_output" | grep "Current:" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		snapshot_passed=$${snapshot_passed:-0}; \
		if echo "$$snap_output" | grep -q "REGRESSION\|regression detected"; then \
			snapshot_status="❌ FAIL"; snapshot_failed=1; any_failed=1; \
		elif echo "$$snap_output" | grep -q "snapshot check passed\|No regressions\|No average regression"; then \
			snapshot_status="✅ PASS"; \
		else \
			snapshot_status="✅ PASS"; \
		fi; \
	fi; \
	\
	echo ""; \
	echo "📦 UI Automation Tests:"; \
	if [ -f "test/test_ui_automation_gtest.exe" ]; then \
		run_logged "temp/_radiant_ui_automation.log" ./test/test_ui_automation_gtest.exe || true; \
		ui_elapsed=$$run_logged_elapsed; \
		output=$$(cat "temp/_radiant_ui_automation.log"); \
		echo "$$output" | grep -E "^\[|tests executed" | tail -5; \
		ui_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		ui_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \][[:space:]]+[0-9]+ test" | head -1 | grep -oE "[0-9]+" | head -1 || echo "0"); \
		ui_passed=$${ui_passed:-0}; ui_failed=$${ui_failed:-0}; \
		if [ "$$ui_failed" = "0" ] || [ -z "$$ui_failed" ]; then ui_status="✅ PASS"; ui_failed=0; else ui_status="❌ FAIL"; any_failed=1; fi; \
	else \
		echo "   ⚠️  test/test_ui_automation_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 Radiant View Command Tests:"; \
	if [ -f "test/test_radiant_view_gtest.exe" ]; then \
		run_logged "temp/_radiant_view_cmd.log" ./test/test_radiant_view_gtest.exe || true; \
		radiant_view_elapsed=$$run_logged_elapsed; \
		output=$$(cat "temp/_radiant_view_cmd.log"); \
		echo "$$output" | grep -E "^\[|tests executed" | tail -5; \
		radiant_view_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		radiant_view_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \][[:space:]]+[0-9]+ test" | head -1 | grep -oE "[0-9]+" | head -1 || echo "0"); \
		radiant_view_passed=$${radiant_view_passed:-0}; radiant_view_failed=$${radiant_view_failed:-0}; \
		if [ "$$radiant_view_failed" = "0" ] || [ -z "$$radiant_view_failed" ]; then radiant_view_status="✅ PASS"; radiant_view_failed=0; else radiant_view_status="❌ FAIL"; any_failed=1; fi; \
	else \
		echo "   ⚠️  test/test_radiant_view_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 View Page and Markdown (Headless) Tests:"; \
	if [ -f "test/test_page_load_gtest.exe" ]; then \
		run_logged "temp/_radiant_page_load.log" ./test/test_page_load_gtest.exe || true; \
		page_elapsed=$$run_logged_elapsed; \
		output=$$(cat "temp/_radiant_page_load.log"); \
		echo "$$output" | grep -E "^\[|pages loaded" | tail -5; \
		page_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		page_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \][[:space:]]+[0-9]+ test" | head -1 | grep -oE "[0-9]+" | head -1 || echo "0"); \
		page_passed=$${page_passed:-0}; page_failed=$${page_failed:-0}; \
		if [ "$$page_failed" = "0" ] || [ -z "$$page_failed" ]; then page_status="✅ PASS"; page_failed=0; else page_status="❌ FAIL"; any_failed=1; fi; \
	else \
		echo "   ⚠️  test/test_page_load_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 Fuzzy Crash Tests:"; \
	if [ -f "test/test_layout_fuzzy_gtest.exe" ]; then \
		fuzzy_start=$$(date +%s); \
		output=$$(./test/test_layout_fuzzy_gtest.exe 2>&1) || true; \
		fuzzy_elapsed=$$(($$(date +%s) - fuzzy_start)); \
		echo "$$output" | grep -E "^\[|fuzzy files tested" | tail -5; \
		fuzzy_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		fuzzy_failed=$$(echo "$$output" | grep -E "^\[  FAILED  \][[:space:]]+[0-9]+ test" | head -1 | grep -oE "[0-9]+" | head -1 || echo "0"); \
		fuzzy_passed=$${fuzzy_passed:-0}; fuzzy_failed=$${fuzzy_failed:-0}; \
		if [ "$$fuzzy_failed" = "0" ] || [ -z "$$fuzzy_failed" ]; then fuzzy_status="✅ PASS"; fuzzy_failed=0; else fuzzy_status="❌ FAIL"; any_failed=1; fi; \
	else \
		echo "   ⚠️  test/test_layout_fuzzy_gtest.exe not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 Render Visual Tests:"; \
	if [ -f "test/render/test_radiant_render.js" ]; then \
		echo "   workers: $(RADIANT_RENDER_JOBS)"; \
		run_logged "temp/_radiant_render_visual.log" sh -c 'cd test/render && LAMBDA_ROOT="$(CURDIR)" node test_radiant_render.js -j $(RADIANT_RENDER_JOBS) --baseline' || true; \
		render_elapsed=$$run_logged_elapsed; \
		output=$$(cat "temp/_radiant_render_visual.log"); \
		echo "$$output" | grep -E "PASS|FAIL|ERROR|Results:|Baseline Regressions|baseline tests passed" | tail -15; \
		render_line=$$(echo "$$output" | grep "^Results:" | tail -1); \
		render_passed=$$(echo "$$render_line" | grep -oE "^Results: [0-9]+" | grep -oE "[0-9]+" || echo "0"); \
		render_total=$$(echo "$$render_line" | grep -oE "^Results: [0-9]+/[0-9]+" | grep -oE "/[0-9]+" | tr -d "/" || echo "0"); \
		render_xpassed=$$(echo "$$render_line" | grep -oE "[0-9]+ new passes" | grep -oE "[0-9]+" || echo "0"); \
		render_xfailed=$$(echo "$$render_line" | grep -oE "[0-9]+ expected failures" | grep -oE "[0-9]+" || echo "0"); \
		render_skipped=$$(echo "$$render_line" | grep -oE "[0-9]+ skipped" | grep -oE "[0-9]+" || echo "0"); \
		render_errors=$$(echo "$$render_line" | grep -oE "[0-9]+ errors" | grep -oE "[0-9]+" || echo "0"); \
		render_passed=$${render_passed:-0}; render_total=$${render_total:-0}; render_xpassed=$${render_xpassed:-0}; render_xfailed=$${render_xfailed:-0}; render_skipped=$${render_skipped:-0}; render_errors=$${render_errors:-0}; \
		render_details="$${render_passed}/$${render_total} passed"; \
		if [ $$render_xpassed -gt 0 ]; then render_details="$$render_details, $$render_xpassed new passes"; fi; \
		if [ $$render_xfailed -gt 0 ]; then render_details="$$render_details, $$render_xfailed expected failures"; fi; \
		if [ $$render_skipped -gt 0 ]; then render_details="$$render_details, $$render_skipped skipped"; fi; \
		if [ $$render_errors -gt 0 ]; then render_details="$$render_details, $$render_errors errors"; fi; \
		render_failed=0; \
		if echo "$$output" | grep -q "Baseline Regressions"; then \
			render_regressions=$$(echo "$$output" | grep "Baseline Regressions" | grep -oE "[0-9]+" | head -1); render_regressions=$${render_regressions:-0}; \
			render_failed=$$render_regressions; \
			render_details="$$render_details, $$render_regressions baseline regressions"; \
			render_status="❌ FAIL"; any_failed=1; \
		else \
			render_status="✅ PASS"; \
		fi; \
	else \
		echo "   ⚠️  test/render/test_radiant_render.js not found"; \
	fi; \
	\
	echo ""; \
	echo "📦 DOM UI Integration:"; \
	dom_ui_exit=0; \
	run_logged "temp/_radiant_dom_ui.log" $(MAKE) --no-print-directory dom-ui-run || dom_ui_exit=$$?; \
	dom_ui_elapsed=$$run_logged_elapsed; \
	output=$$(cat "temp/_radiant_dom_ui.log"); \
	echo "$$output" | tail -5; \
	dom_ui_line=$$(echo "$$output" | grep "^dom-ui:" | tail -1); \
	dom_ui_passed=$$(echo "$$dom_ui_line" | grep -oE "[0-9]+/[0-9]+" | cut -d/ -f1 || echo "0"); \
	dom_ui_total=$$(echo "$$dom_ui_line" | grep -oE "[0-9]+/[0-9]+" | cut -d/ -f2 || echo "0"); \
	dom_ui_passed=$${dom_ui_passed:-0}; dom_ui_total=$${dom_ui_total:-0}; \
	dom_ui_failed=$$((dom_ui_total - dom_ui_passed)); \
	if [ $$dom_ui_exit -eq 0 ] && [ $$dom_ui_total -gt 0 ]; then dom_ui_status="✅ PASS"; else dom_ui_status="❌ FAIL"; if [ $$dom_ui_failed -eq 0 ]; then dom_ui_failed=1; fi; any_failed=1; fi; \
	\
	wpt_syntax_passed=0; wpt_syntax_failed=0; wpt_syntax_status="⏭️  SKIP"; wpt_syntax_elapsed=0; \
	echo ""; \
	echo "📦 WPT CSS Syntax Conformance:"; \
	if [ -f "test/test_wpt_css_syntax_gtest.exe" ]; then \
		run_logged "temp/_radiant_wpt_css_syntax.log" ./test/test_wpt_css_syntax_gtest.exe || true; \
		wpt_syntax_elapsed=$$run_logged_elapsed; \
		output=$$(cat "temp/_radiant_wpt_css_syntax.log"); \
		echo "$$output" | grep -E "^\[  PASSED|^\[  FAILED|^\[  SKIPPED" | tail -5; \
		wpt_syntax_passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		wpt_syntax_failed=$$(echo "$$output" | grep -E "^[0-9]+ FAILED TEST" | grep -oE "^[0-9]+" || echo "0"); \
		wpt_syntax_passed=$${wpt_syntax_passed:-0}; wpt_syntax_failed=$${wpt_syntax_failed:-0}; \
		wpt_syntax_baseline=25; \
		if [ "$$wpt_syntax_passed" -ge "$$wpt_syntax_baseline" ] 2>/dev/null; then wpt_syntax_status="✅ PASS"; else wpt_syntax_status="❌ FAIL"; any_failed=1; fi; \
	else \
		echo "   ⚠️  test/test_wpt_css_syntax_gtest.exe not found"; \
	fi; \
	\
	wpt_dom2_passed=0; wpt_dom2_failed=0; wpt_dom2_status="✅ PASS"; wpt_dom2_elapsed=0; \
	echo ""; \
	echo "📦 WPT DOM2 Conformance:"; \
	for runner in $(RADIANT_DOM2_WPT_RUNNERS); do \
		exe="test/test_wpt_$${runner}_gtest.exe"; \
		if [ ! -f "$$exe" ]; then echo "   ⚠️  $$exe not found"; wpt_dom2_failed=$$((wpt_dom2_failed + 1)); wpt_dom2_status="❌ FAIL"; any_failed=1; continue; fi; \
		runner_exit=0; log_file="temp/_radiant_wpt_$${runner}.log"; \
		run_logged "$$log_file" "$$exe" || runner_exit=$$?; \
		wpt_dom2_elapsed=$$((wpt_dom2_elapsed + run_logged_elapsed)); \
		output=$$(cat "$$log_file"); \
		passed=$$(echo "$$output" | grep -E "^\[  PASSED  \]" | grep -oE "[0-9]+" | head -1 || echo "0"); passed=$${passed:-0}; \
		failed=$$(echo "$$output" | grep -E "^\[  FAILED  \][[:space:]]+[0-9]+ test" | head -1 | grep -oE "[0-9]+" | head -1 || echo "0"); failed=$${failed:-0}; \
		if [ $$runner_exit -ne 0 ] && [ $$failed -eq 0 ]; then failed=1; fi; \
		wpt_dom2_passed=$$((wpt_dom2_passed + passed)); wpt_dom2_failed=$$((wpt_dom2_failed + failed)); \
		if [ $$failed -eq 0 ]; then echo "   ✅ $$runner ($$passed passing files)"; else echo "   ❌ $$runner ($$failed regressions)"; wpt_dom2_status="❌ FAIL"; any_failed=1; fi; \
	done; \
	\
	total_passed=$$((layout_total_passed + snapshot_passed + ui_passed + dom_ui_passed + radiant_view_passed + page_passed + fuzzy_passed + render_passed + wpt_syntax_passed + wpt_dom2_passed)); \
	total_failed=$$((layout_total_failed + snapshot_failed + ui_failed + dom_ui_failed + radiant_view_failed + page_failed + fuzzy_failed + render_failed + wpt_syntax_failed + wpt_dom2_failed)); \
	total_skipped=$$layout_total_skipped; \
	total_tests=$$((total_passed + layout_total_partial + total_failed)); \
	\
	echo ""; \
	echo "=============================================================="; \
	echo "🏁 RADIANT BASELINE TEST RESULTS BREAKDOWN"; \
	echo "=============================================================="; \
	echo ""; \
	echo "📊 Test Results by Suite:"; \
	echo "   ├── Layout Baseline     $$layout_overall_status  ($$(format_duration "$$layout_elapsed"), $$layout_total_passed passed, $$layout_total_partial partially passing, $$layout_total_failed failed, $$layout_total_skipped skipped)"; \
	$(PRINT_LAYOUT_BASELINE_SUITE_RESULTS) \
	echo "   ├── Layout Page Suite   $$snapshot_status  ($$(format_duration "$$snapshot_elapsed"), $$snapshot_passed passed, $$snapshot_failed failed) (layout_suite_snapshot.js --check page)"; \
	echo "   ├── UI Automation       $$ui_status  ($$(format_duration "$$ui_elapsed"), $$ui_passed passed, $$ui_failed failed) (test_ui_automation_gtest.exe)"; \
	echo "   ├── DOM UI Integration  $$dom_ui_status  ($$(format_duration "$$dom_ui_elapsed"), $$dom_ui_passed passed, $$dom_ui_failed failed) (dom-ui-run)"; \
	echo "   ├── Radiant View Cmd    $$radiant_view_status  ($$(format_duration "$$radiant_view_elapsed"), $$radiant_view_passed passed, $$radiant_view_failed failed) (test_radiant_view_gtest.exe)"; \
	echo "   ├── View Page & Markdown $$page_status  ($$(format_duration "$$page_elapsed"), $$page_passed passed, $$page_failed failed) (test_page_load_gtest.exe)"; \
	echo "   ├── Fuzzy Crash         $$fuzzy_status  ($$(format_duration "$$fuzzy_elapsed"), $$fuzzy_passed passed, $$fuzzy_failed failed) (test_layout_fuzzy_gtest.exe)"; \
	echo "   ├── Render Visual       $$render_status  ($$(format_duration "$$render_elapsed"), $$render_details) (test_radiant_render.js --baseline)"; \
	echo "   ├── WPT CSS Syntax      $$wpt_syntax_status  ($$(format_duration "$$wpt_syntax_elapsed"), $$wpt_syntax_passed passed, $$wpt_syntax_failed failed) (test_wpt_css_syntax_gtest.exe)"; \
	echo "   └── WPT DOM2            $$wpt_dom2_status  ($$(format_duration "$$wpt_dom2_elapsed"), $$wpt_dom2_passed passed, $$wpt_dom2_failed failed) ($(RADIANT_DOM2_WPT_RUNNERS))"; \
	echo ""; \
	echo "📊 Overall Results:"; \
	echo "   Total Tests: $$total_tests"; \
	echo "   ✅ Passed:   $$total_passed"; \
	if [ $$layout_total_partial -gt 0 ]; then \
		echo "   ⚠️  Partially Passing: $$layout_total_partial"; \
	fi; \
	if [ $$total_failed -gt 0 ]; then \
		echo "   ❌ Failed:   $$total_failed"; \
	fi; \
	if [ $$total_skipped -gt 0 ]; then \
		echo "   ⏭️  Skipped:  $$total_skipped"; \
	fi; \
	echo "=============================================================="; \
	rm -f $(LAYOUT_BASELINE_RESULTS); \
	if [ $$any_failed -gt 0 ]; then exit 1; fi

# Keep the runner's suite records through the page snapshot so the final
# layout-only report cannot lose the results it needs to aggregate.
test-layout-baseline: build-test
	@any_failed=0; \
	layout_total_passed=0; layout_total_partial=0; layout_total_failed=0; layout_total_skipped=0; \
	layout_elapsed=0; layout_overall_status="✅ PASS"; \
	snapshot_passed=0; snapshot_failed=0; snapshot_status="⏭️  SKIP"; snapshot_elapsed=0; \
	mkdir -p temp; \
	$(DEFINE_TEST_DURATION_FORMATTER) \
	echo ""; \
	echo "=============================================================="; \
	echo "🧪 LAYOUT BASELINE TEST SUITE"; \
	echo "=============================================================="; \
	layout_run_exit=0; \
	layout_start=$$(date +%s); \
	$(MAKE) --no-print-directory run-layout-baseline-suites || layout_run_exit=$$?; \
	layout_elapsed=$$(($$(date +%s) - layout_start)); \
	$(COLLECT_LAYOUT_BASELINE_RESULTS) \
	if [ -f test/layout/snapshot/page.json ]; then \
		echo ""; \
		echo "📦 Layout Page Suite Regression:"; \
		snapshot_exit=0; \
		snapshot_start=$$(date +%s); \
		snapshot_output=$$($(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css -c page --json -j 5 2>/dev/null \
			| node test/layout/layout_suite_snapshot.js --check page 2>&1) || snapshot_exit=$$?; \
		snapshot_elapsed=$$(($$(date +%s) - snapshot_start)); \
		echo "$$snapshot_output" | tail -5; \
		snapshot_passed=$$(echo "$$snapshot_output" | grep "Current:" | grep -oE "[0-9]+" | head -1 || echo "0"); \
		snapshot_passed=$${snapshot_passed:-0}; \
		if echo "$$snapshot_output" | grep -q "REGRESSION\|regression detected" || [ $$snapshot_exit -ne 0 ]; then \
			snapshot_status="❌ FAIL"; snapshot_failed=1; any_failed=1; \
		elif echo "$$snapshot_output" | grep -q "snapshot check passed\|No regressions\|No average regression"; then \
			snapshot_status="✅ PASS"; \
		else \
			snapshot_status="❌ FAIL"; snapshot_failed=1; any_failed=1; \
		fi; \
	fi; \
	\
	total_passed=$$((layout_total_passed + snapshot_passed)); \
	total_failed=$$((layout_total_failed + snapshot_failed)); \
	total_tests=$$((total_passed + layout_total_partial + total_failed)); \
	\
	echo ""; \
	echo "=============================================================="; \
	echo "🏁 LAYOUT BASELINE TEST RESULTS BREAKDOWN"; \
	echo "=============================================================="; \
	echo ""; \
	echo "📊 Test Results by Suite:"; \
	echo "   ├── Layout Baseline     $$layout_overall_status  ($$(format_duration "$$layout_elapsed"), $$layout_total_passed passed, $$layout_total_partial partially passing, $$layout_total_failed failed, $$layout_total_skipped skipped)"; \
	$(PRINT_LAYOUT_BASELINE_SUITE_RESULTS) \
	echo "   └── Layout Page Suite   $$snapshot_status  ($$(format_duration "$$snapshot_elapsed"), $$snapshot_passed passed, $$snapshot_failed failed) (layout_suite_snapshot.js --check page)"; \
	echo ""; \
	echo "📊 Overall Results:"; \
	echo "   Total Tests: $$total_tests"; \
	echo "   ✅ Passed:   $$total_passed"; \
	if [ $$layout_total_partial -gt 0 ]; then \
		echo "   ⚠️  Partially Passing: $$layout_total_partial"; \
	fi; \
	if [ $$total_failed -gt 0 ]; then \
		echo "   ❌ Failed:   $$total_failed"; \
	fi; \
	if [ $$layout_total_skipped -gt 0 ]; then \
		echo "   ⏭️  Skipped:  $$layout_total_skipped"; \
	fi; \
	echo "=============================================================="; \
	if [ $$any_failed -gt 0 ]; then exit 1; fi

test-ui-automation: build-test
	@echo "Running UI Automation test suite..."
	@echo "=============================================================="
	@if [ -f "test/test_ui_automation_gtest.exe" ]; then \
		./test/test_ui_automation_gtest.exe; \
	else \
		echo "Error: test/test_ui_automation_gtest.exe not found - run 'make build-test' first"; \
		exit 1; \
	fi

test-page-load: build-test
	@echo "Running View Page and Markdown (Headless) test suite..."
	@echo "=============================================================="
	@if [ -f "test/test_page_load_gtest.exe" ]; then \
		./test/test_page_load_gtest.exe; \
	else \
		echo "Error: test/test_page_load_gtest.exe not found - run 'make build-test' first"; \
		exit 1; \
	fi

test-radiant-online: build-test
	@echo "Running Radiant online URL smoke test suite..."
	@echo "=============================================================="
	@if [ -f "test/test_radiant_online_view_gtest.exe" ]; then \
		./test/test_radiant_online_view_gtest.exe; \
	else \
		echo "Error: test/test_radiant_online_view_gtest.exe not found - run 'make build-test' first"; \
		exit 1; \
	fi

build-pdf-render-test: build-lambda-data
	@echo "Building PDF render visual gtest executable using Premake5..."
	@mkdir -p build/premake
	$(MAKE) generate-premake
	cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE)
	PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake config=debug_native -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)" \
		test_pdf_render_visual_gtest

test-pdf-render: build-pdf-render-test
	@echo "Running PDF render visual gtest suite..."
	@echo "=============================================================="
	@if [ -f "test/test_pdf_render_visual_gtest.exe" ]; then \
		./test/test_pdf_render_visual_gtest.exe $(ARGS); \
	else \
		echo "Error: test/test_pdf_render_visual_gtest.exe not found - run 'make build-pdf-render-test' first"; \
		exit 1; \
	fi

test-reactive-ui: build
	@echo "Running Reactive UI test suite..."
	@echo "=============================================================="
	@PASS=0; FAIL=0; TOTAL=0; \
	for json in test/ui/todo_toggle.json test/ui/todo_delete.json test/ui/todo_add_item.json test/ui/todo_text_input.json; do \
		name=$$(basename $$json .json); \
		TOTAL=$$((TOTAL + 1)); \
		echo "--- $$name ---"; \
		if ./lambda.exe view test/lambda/ui/todo.ls --event-file $$json --headless --no-log; then \
			PASS=$$((PASS + 1)); \
		else \
			FAIL=$$((FAIL + 1)); \
			echo "FAIL: $$name"; \
		fi; \
	done; \
	echo "=============================================================="; \
	echo "Reactive UI: $$PASS/$$TOTAL passed"; \
	if [ $$FAIL -gt 0 ]; then exit 1; fi

# The upstream packages are checked-in offline artifacts. These targets never
# run npm and exercise the same public event route as platform input.
editable-unit: build
	@./lambda.exe view test/html/editable-dom-composition.html --event-file test/ui/test_editing_contenteditable_dom_action.json --headless --no-log
	@./lambda.exe view test/html/editable-dom-composition.html --event-file test/ui/test_editing_contenteditable_unsupported_transfer.json --headless --no-log
	@./lambda.exe view test/html/editable-physical-keydown.html --event-file test/ui/test_editing_physical_keydown_cancellation.json --headless --no-log
	@./lambda.exe view test/ui/editable-template-gate.ls --event-file test/ui/editable-template-gate.json --headless --no-log

editable-ui: build
	@./lambda.exe view test/html/editable-dom-composition.html --event-file test/ui/test_editing_contenteditable_dom_action.json --headless --no-log
	@./lambda.exe view test/html/editable-dom-composition.html --event-file test/ui/test_editing_contenteditable_composition.json --headless --no-log
	@./lambda.exe view test/html/editable-dom-composition.html --event-file test/ui/test_editing_contenteditable_unsupported_transfer.json --headless --no-log
	@./lambda.exe view test/html/editable-physical-keydown.html --event-file test/ui/test_editing_physical_keydown_cancellation.json --headless --no-log
	@./lambda.exe view test/ui/editing/contenteditable.html --event-file test/ui/test_editing_paired_false_island_contenteditable.json --headless --no-log
	@./lambda.exe view test/ui/rte_prototype.ls --event-file test/ui/rte_typing_at_caret.json --headless --no-log
	@./lambda.exe view test/ui/editable-mixed-routes.ls --event-file test/ui/editable-mixed-routes.json --headless --no-log

editable-editor-e2e: build
	@./lambda.exe view test/ui/dom_mutation_replacechild_notifies.html --event-file test/ui/dom_mutation_replacechild_notifies.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/typing.html --event-file test/ui/editable-editors-codemirror.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/typing.html --event-file test/ui/editable-editors-codemirror-operations.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/typing.html --event-file test/ui/editable-editors-codemirror-full.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/typing.html --event-file test/ui/editable-editors-codemirror-selection-composition.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/typing.html --event-file test/ui/editable-editors-codemirror-domchange.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/typing.html --event-file test/ui/editable-editors-codemirror-events.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/readonly.html --event-file test/ui/editable-editors-codemirror-readonly.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/codemirror/direction.html --event-file test/ui/editable-editors-codemirror-direction.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/typing.html --event-file test/ui/editable-editors-prosemirror.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/typing.html --event-file test/ui/editable-editors-prosemirror-operations.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/typing.html --event-file test/ui/editable-editors-prosemirror-full.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/typing.html --event-file test/ui/editable-editors-prosemirror-selection-composition.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/typing.html --event-file test/ui/editable-editors-prosemirror-domchange.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/marked.html --event-file test/ui/editable-editors-prosemirror-marked-composition.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/typing.html --event-file test/ui/editable-editors-prosemirror-clipboard-html.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/prosemirror/readonly.html --event-file test/ui/editable-editors-prosemirror-readonly.json --headless --no-log
	@./lambda.exe view test/html/editable-prosemirror.html --event-file test/ui/editable-editors-prosemirror-toolbar.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs-operations.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs-tools.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs-lifecycle.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs-onchange.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs-block-ids.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/empty.html --event-file test/ui/editable-editors-editorjs-dataempty.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/clipboard.html --event-file test/ui/editable-editors-editorjs-paste.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/clipboard.html --event-file test/ui/editable-editors-editorjs-delete.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/clipboard.html --event-file test/ui/editable-editors-editorjs-arrow.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/clipboard.html --event-file test/ui/editable-editors-editorjs-clipboard.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/typing.html --event-file test/ui/editable-editors-editorjs-onchange-index.json --headless --no-log
	@./lambda.exe view test/editable-editors/fixtures/editorjs/readonly.html --event-file test/ui/editable-editors-editorjs-readonly.json --headless --no-log
	@./lambda.exe view test/html/editable-editorjs.html --event-file test/ui/editable-editors-editorjs-page.json --headless --no-log

test-editable: editable-unit editable-ui editable-editor-e2e

# Pinned drawing packages are built locally by test/drawing-editors; this target
# never installs packages and exercises ordinary DOM/SVG/event lifetime paths.
drawing-editor-e2e: build
	@cd test/drawing-editors && node tools/build.mjs
	@./lambda.exe view test/html/svg-dom-contract.html --event-file test/ui/svg-dom-contract.json --headless --no-log
	@./lambda.exe view test/html/js-loop-listener-contract.html --event-file test/ui/js-loop-listener-contract.json --headless --no-log
	@./lambda.exe view test/html/js-loop-listener-bundle-contract.html --event-file test/ui/js-loop-listener-bundle-contract.json --headless --no-log
	@./lambda.exe view test/html/editable-raphael.html --event-file test/ui/editable-drawing-raphael.json --headless --no-log
	@./lambda.exe view test/html/editable-maxgraph.html --event-file test/ui/editable-drawing-maxgraph.json --headless --no-log
	@./lambda.exe view test/html/editable-jointjs.html --event-file test/ui/editable-drawing-jointjs.json --headless --no-log

test-drawing: drawing-editor-e2e hit-test-ui

# Coordinate assertions against document.elementFromPoint(), including ported
# WPT SVG geometry cases. Each fixture names its own HTML page.
hit-test-ui: build
	@echo "Running Radiant hit-test UI suite..."
	@echo "=============================================================="
	@PASS=0; FAIL=0; TOTAL=0; \
	for json in test/ui/hit-test/*.json; do \
		[ -f "$$json" ] || continue; \
		name=$$(basename "$$json" .json); \
		TOTAL=$$((TOTAL + 1)); \
		page=$$(sed -n 's/.*"html"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$$json" | head -1); \
		if [ -z "$$page" ]; then echo "  FAIL $$name (missing html)"; FAIL=$$((FAIL + 1)); continue; fi; \
		if ./lambda.exe view "$$page" --event-file "$$json" --headless --no-log; then \
			echo "  PASS $$name"; PASS=$$((PASS + 1)); \
		else \
			echo "  FAIL $$name"; FAIL=$$((FAIL + 1)); \
		fi; \
	done; \
	echo "=============================================================="; \
	echo "hit-test-ui: $$PASS/$$TOTAL passed"; \
	if [ $$FAIL -gt 0 ]; then exit 1; fi

# Stage 4C Phase A — the full plain-DOM editor suite headless under `lambda.exe js`.
# The runner (test/editor-js/tools/run-phase-a.mjs) bundles each test group
# (core/view/drawing + 6 tier corpora) to an IIFE, runs it, and aggregates the
# in-engine harness summaries. React `.test.tsx` are excluded by construction.
editor-4c-js: build
	@echo "Running Stage 4C Phase A (plain-DOM suite under lambda.exe js)..."
	@echo "=============================================================="
	@cd test/editor-js && node tools/run-phase-a.mjs
	@echo "=============================================================="

# Stage 4C Phase B/C — editor event-driven UI automation under lambda.exe view + event_sim.
# Runs the 4B baseline set (test/ui/editor4b/*.json), the 4C Phase-B set
# (test/ui/editor4c/*.json), and the Phase-C expansion set
# (test/ui/editor4c_phase_c/*.json). Each fixture may name its own harness page
# via the "html" field (default test/html/editor-dom.html).
editor-4c-view: build
	@echo "Running Stage 4C Phase B/C editor UI test suite..."
	@echo "=============================================================="
	@PASS=0; FAIL=0; TOTAL=0; \
	for json in test/ui/editor4b/*.json test/ui/editor4c/*.json test/ui/editor4c_phase_c/*.json; do \
		[ -f "$$json" ] || continue; \
		name=$$(basename $$json .json); \
		TOTAL=$$((TOTAL + 1)); \
		page=$$(sed -n 's/.*"html"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$$json" | head -1); \
		[ -n "$$page" ] || page="test/html/editor-dom.html"; \
		if ./lambda.exe view "$$page" --event-file $$json --headless --no-log >/dev/null 2>&1; then \
			PASS=$$((PASS + 1)); \
			printf "  \033[32m✓\033[0m %s\n" "$$name"; \
		else \
			FAIL=$$((FAIL + 1)); \
			printf "  \033[31m✗\033[0m %s\n" "$$name"; \
		fi; \
	done; \
	echo "=============================================================="; \
	echo "editor-4c-view: $$PASS/$$TOTAL passed"; \
	if [ $$FAIL -gt 0 ]; then exit 1; fi

# Browser-library DOM fixtures run through the real Radiant input/event/layout loop.
dom-ui: build dom-ui-run

dom-ui-run:
	@echo "Running DOM UI integration suite..."
	@echo "=============================================================="
	@node test/ui/dom/run-dom-ui.mjs --jobs "$(DOM_UI_JOBS)" $(if $(or $(test),$(TEST)),--test "$(or $(test),$(TEST))")

# Stage 4C Milestone 3 — parity report: cross-check the Radiant Phase-A pass-set
# against the vitest/jsdom oracle (the editor's own suite under Node). Runs
# Phase A (via run-phase-a.mjs) AND a fresh vitest oracle, reconciles per group,
# writes vibe/editing/Stage4C_Parity_Report.md, and exits non-zero on any
# unexplained divergence. React `.test.tsx` are the only intentional exclusion.
editor-4c-parity: build
	@echo "Running Stage 4C parity report (Radiant Phase-A vs vitest/jsdom oracle)..."
	@echo "=============================================================="
	@cd test/editor-js && node tools/parity-report.mjs --refresh-oracle
	@echo "=============================================================="

# Stage 4C — full editor conformance: parity (Phase A breadth + jsdom oracle
# cross-check) + Phase B (view depth). Parity subsumes the Phase-A run, so
# `editor-4c-js` is only needed for a quick Phase-A-only pass.
editor-4c: editor-4c-parity editor-4c-view
	@echo "=============================================================="
	@echo "Stage 4C complete: parity (Phase A + jsdom oracle) + Phase B (view + event_sim) all green."

# Save/check/diff layout suite snapshots for regression detection outside baseline
layout-snapshot:
	@SUITE_VAR="$(or $(suite),$(SUITE))"; \
	if [ -z "$$SUITE_VAR" ]; then \
		echo "Usage: make layout-snapshot suite=<name>"; \
		echo "  e.g. make layout-snapshot suite=page"; \
		exit 1; \
	fi; \
	echo "Saving snapshot for suite: $$SUITE_VAR"; \
	$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css -c $$SUITE_VAR --json -j 5 2>/dev/null \
		| node test/layout/layout_suite_snapshot.js --save $$SUITE_VAR

layout-snapshot-check:
	@SUITE_VAR="$(or $(suite),$(SUITE))"; \
	if [ -z "$$SUITE_VAR" ]; then \
		echo "Usage: make layout-snapshot-check suite=<name>"; \
		exit 1; \
	fi; \
	$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css -c $$SUITE_VAR --json -j 5 2>/dev/null \
		| node test/layout/layout_suite_snapshot.js --check $$SUITE_VAR

layout-snapshot-diff:
	@SUITE_VAR="$(or $(suite),$(SUITE))"; \
	if [ -z "$$SUITE_VAR" ]; then \
		echo "Usage: make layout-snapshot-diff suite=<name>"; \
		exit 1; \
	fi; \
	$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css -c $$SUITE_VAR --json -j 5 2>/dev/null \
		| node test/layout/layout_suite_snapshot.js --diff $$SUITE_VAR

# Math Testing targets (multi-layered semantic comparison framework)
test-math: build
	@echo "Running LaTeX Math test suite (ALL)..."
	@echo "=============================================================="
	@cd test/latex && npm test

test-math-baseline: build
	@echo "Running LaTeX Math BASELINE tests (DVI must pass 100%)..."
	@echo "=============================================================="
	@cd test/latex && npm run test:baseline

test-math-extended: build
	@echo "Running LaTeX Math EXTENDED tests (semantic comparison)..."
	@echo "=============================================================="
	@cd test/latex && npm run test:extended

test-math-verbose: build
	@echo "Running LaTeX Math tests (verbose mode)..."
	@echo "=============================================================="
	@cd test/latex && npm run test:verbose

test-math-group: build
	@echo "Running LaTeX Math tests for group: $(group)"
	@echo "=============================================================="
	@cd test/latex && node test_math_comparison.js --group=$(group)

test-math-single: build
	@echo "Running single LaTeX Math test: $(test)"
	@echo "=============================================================="
	@cd test/latex && node test_math_comparison.js --test=$(test) --verbose

setup-math-tests:
	@echo "Setting up LaTeX Math test dependencies..."
	@cd test/latex && npm install
	@echo "LaTeX Math test setup complete."

generate-math-references:
	@echo "Generating reference files (MathLive + KaTeX)..."
	@echo "=============================================================="
	@cd test/latex && npm run generate:mathlive
	@cd test/latex && npm run generate:katex
	@echo "Reference files generated in test/latex/reference/"

test-extended: build-test
	@echo "Clearing HTTP cache for clean test runs..."
	@rm -rf temp/cache
	@echo "Running EXTENDED test suites only..."
	@LAMBDA_TEST_HEAVY_LOAD=1 node test/test_run.js --category=extended --parallel
	@$(MAKE) dom-ui-run

# Runs against the debug lambda.exe from `build`: it defines
# LAMBDA_JS_EXEC_PROFILE, and unlike lambda-debug-profile.exe it is rebuilt by
# the ordinary flow, so the suite cannot bind to a stale non-profiling binary.
test-js-opt: build build-test
	@echo "Running JavaScript optimization contract tests..."
	@./test/test_js_opt_gtest.exe --gtest_color=no

test-library: build
	@echo "Running library test suite..."
	@node test/test_run.js --target=library --raw

test-input: build
	@echo "Running input processing test suite..."
	@node test/test_run.js --target=input --raw

build-graph-mermaid-test:
	@echo "Building Mermaid graph semantic runner..."
	@mkdir -p build/premake
	@$(MAKE) generate-premake
	@PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake config=debug_native lambda test_graph_mermaid_gtest test_lambda_gtest -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"

test-graph-mermaid: build-graph-mermaid-test
	@echo "Running Mermaid graph semantic corpus..."
	@./test/test_graph_mermaid_gtest.exe
	@echo "Running Mermaid graph package integration fixtures..."
	@./test/test_lambda_gtest.exe --gtest_filter='*mermaid*'

build-graph-graphviz-test:
	@echo "Building Graphviz graph semantic runner..."
	@mkdir -p build/premake
	@$(MAKE) generate-premake
	@PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake config=debug_native lambda test_graph_parser_gtest test_lambda_gtest -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"

test-graph-graphviz: build-graph-graphviz-test
	@echo "Running native DOT parser coverage..."
	@./test/test_graph_parser_gtest.exe --gtest_filter='GraphParserTest.ParserLocBudget:GraphParserTest.ParseDOTGraph:GraphParserTest.ParseComplexDOTGraph:GraphParserTest.ParseUndirectedGraph:GraphParserTest.ParseEmptyGraph'
	@echo "Running manifest-driven Graphviz package fixtures..."
	@./test/test_lambda_gtest.exe --gtest_filter='*graphviz*'
	@echo "Running headless .gv view bridge..."
	@MEMTRACK_MODE=DEBUG ./lambda.exe view test/lambda/graph/graphviz/view.gv --headless --no-log 2>temp/graphviz_view_memtrack.log
	@! grep -qi 'memtrack: .*leak' temp/graphviz_view_memtrack.log
	@rm -f temp/graphviz_view_memtrack.log

build-graph-structurizr-test:
	@echo "Building Structurizr graph test runners..."
	@mkdir -p build/premake
	@$(MAKE) generate-premake
	@PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=$(PREMAKE_FILE)
	@PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake config=debug_native lambda test_graph_parser_gtest test_lambda_gtest -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"

test-graph-structurizr: build-graph-structurizr-test
	@echo "Running native Structurizr parser coverage..."
	@./test/test_graph_parser_gtest.exe --gtest_filter='GraphParserTest.ParserLocBudget:GraphParserTest.ParseStructurizrWorkspace:GraphParserTest.ParseStructurizrArchetypes:GraphParserTest.AutoDetectStructurizrDsl:GraphParserTest.RecoverStructurizrWorkspaceRoot'
	@echo "Running Structurizr/C4 package integration fixtures..."
	@./test/test_lambda_gtest.exe --gtest_filter='*structurizr*'
	@echo "Running headless .dsl selected-view bridge..."
	@./lambda.exe view test/lambda/graph/structurizr/advanced_static.dsl --view-key Expression --headless --no-log
	@echo "Running selected-view HTML conversion bridge..."
	@./lambda.exe convert test/lambda/graph/structurizr/advanced_static.dsl -t html -o temp/structurizr_convert.html --view-key Expression
	@grep -q 'data-node-id="api"' temp/structurizr_convert.html
	@grep -q 'data-node-id="user"' temp/structurizr_convert.html
	@! grep -q 'data-node-id="worker"' temp/structurizr_convert.html
	@rm -f temp/structurizr_convert.html

test-validator: build
	@echo "Running validator test suite..."
	@node test/test_run.js --target=validator --raw

test-lambda: build
	@echo "Running lambda test suite..."
	@node test/test_run.js --target=lambda --raw

# CSS Resolution Verification Target
# Compares Lambda CSS resolved properties against browser reference data
resolve: build
	@echo ""
	@echo "═══════════════════════════════════════════════════════════════════════════════"
	@echo "CSS Resolution Verification"
	@echo "═══════════════════════════════════════════════════════════════════════════════"
	@echo ""
	@if [ -z "$(TEST)" ]; then \
		echo "Usage: make resolve TEST=<test_name>"; \
		echo ""; \
		echo "Example: make resolve TEST=baseline_803_basic_margin"; \
		echo ""; \
		echo "Available tests:"; \
		ls -1 test/layout/reference/baseline/*.json | xargs -n1 basename | sed 's/\.json//' | head -20; \
		echo "... and more (see test/layout/reference/baseline/)"; \
		echo ""; \
		exit 1; \
	fi; \
	TEST_NAME="$(TEST)"; \
	HTML_FILE="test/layout/data/baseline/$${TEST_NAME}.html"; \
	if [ ! -f "$${HTML_FILE}" ]; then \
		echo "❌ Error: Test HTML file not found: $${HTML_FILE}"; \
		exit 1; \
	fi; \
	REF_FILE="test/layout/reference/baseline/$${TEST_NAME}.json"; \
	if [ ! -f "$${REF_FILE}" ]; then \
		echo "❌ Error: Browser reference not found: $${REF_FILE}"; \
		exit 1; \
	fi; \
	echo "📄 Test: $${TEST_NAME}"; \
	echo "📂 HTML: $${HTML_FILE}"; \
	echo "📊 Reference: $${REF_FILE}"; \
	echo ""; \
	echo "─────────────────────────────────────────────────────────────────────────────────"; \
	echo "Running Lambda CSS resolution..."; \
	echo "─────────────────────────────────────────────────────────────────────────────────"; \
	./$(LAMBDA_EXE) layout "$${HTML_FILE}" --width 1200 --height 800 2>&1 | grep -E '^\[|^Error' || true; \
	echo ""; \
	if [ ! -f "temp/view_tree.json" ]; then \
		echo "❌ Error: Lambda CSS output not generated at temp/view_tree.json"; \
		exit 1; \
	fi; \
	echo "✅ Lambda CSS output generated"; \
	echo ""; \
	echo "─────────────────────────────────────────────────────────────────────────────────"; \
	echo "Comparing CSS properties..."; \
	echo "─────────────────────────────────────────────────────────────────────────────────"; \
	cd test/layout && node compare_css.js "$${TEST_NAME}"

# Run CSS resolution verification on all baseline tests
resolve-all: build
	@echo ""
	@echo "═══════════════════════════════════════════════════════════════════════════════"
	@echo "CSS Resolution Verification - All Baseline Tests"
	@echo "═══════════════════════════════════════════════════════════════════════════════"
	@echo ""
	@PASSED=0; \
	FAILED=0; \
	TOTAL=0; \
	for ref_file in test/layout/reference/baseline/*.json; do \
		TEST_NAME=$$(basename "$${ref_file}" .json); \
		HTML_FILE="test/layout/data/baseline/$${TEST_NAME}.html"; \
		if [ ! -f "$${HTML_FILE}" ]; then \
			continue; \
		fi; \
		TOTAL=$$((TOTAL + 1)); \
		echo ""; \
		echo "Testing: $${TEST_NAME}"; \
		if $(MAKE) resolve TEST="$${TEST_NAME}" > "/tmp/resolve_$${TEST_NAME}.log" 2>&1; then \
			echo "  ✅ PASSED"; \
			PASSED=$$((PASSED + 1)); \
		else \
			echo "  ❌ FAILED"; \
			FAILED=$$((FAILED + 1)); \
		fi; \
	done; \
	echo ""; \
	echo "═══════════════════════════════════════════════════════════════════════════════"; \
	echo "Summary"; \
	echo "═══════════════════════════════════════════════════════════════════════════════"; \
	echo "Total tests: $${TOTAL}"; \
	echo "Passed: $${PASSED}"; \
	echo "Failed: $${FAILED}"; \
	if [ "$${FAILED}" -gt 0 ]; then \
		echo ""; \
		echo "See logs in /tmp/resolve_*.log for details"; \
		exit 1; \
	fi

test-std: build
	@echo "Running Lambda Standard Tests (simple runner)..."
	@if [ -f "test/simple_test_runner.sh" ]; then \
		./test/simple_test_runner.sh; \
	else \
		echo "Error: Simple test runner script not found"; \
		exit 1; \
	fi

test-coverage:
	@echo "Running tests with coverage analysis..."
	@if command -v gcov >/dev/null 2>&1 && command -v lcov >/dev/null 2>&1; then \
		echo "Compiling with coverage flags..."; \
		gcc --coverage -fprofile-arcs -ftest-coverage -o lambda_coverage.exe $(shell find lambda -name "*.c") -I./include -I./lambda; \
		node test/test_run.js; \
		gcov $(shell find lambda -name "*.c"); \
		lcov --capture --directory . --output-file coverage.info; \
		genhtml coverage.info --output-directory coverage-report; \
		echo "Coverage report generated in coverage-report/"; \
		echo "Open coverage-report/index.html to view results"; \
	else \
		echo "Coverage tools not found. Install with: brew install lcov"; \
		exit 1; \
	fi

test-benchmark:
	@echo "Running performance benchmark tests..."
	@if [ -f "test/test_benchmark.sh" ]; then \
		chmod +x test/test_benchmark.sh; \
		./test/test_benchmark.sh; \
	else \
		echo "Benchmark test script not found at test/test_benchmark.sh"; \
		exit 1; \
	fi

# Fuzzy Testing Framework
# Shell-based fuzzer for testing Lambda robustness

# Run fuzzy tests (quick mode: 5 minutes)
fuzz-lambda: build
	@echo "Running fuzzy tests (quick mode: 5 minutes)..."
	@chmod +x test/fuzzy/lambda/test_fuzzy.sh
	@./test/fuzzy/lambda/test_fuzzy.sh --duration=300
	@echo "✅ Fuzzy tests completed"

# Run extended fuzzy tests (1 hour)
fuzz-lambda-extended: build
	@echo "Running extended fuzzy tests (1 hour)..."
	@chmod +x test/fuzzy/lambda/test_fuzzy.sh
	@./test/fuzzy/lambda/test_fuzzy.sh --duration=3600
	@echo "✅ Extended fuzzy tests completed"

# Radiant Layout Engine Fuzzy Testing
# Generates adversarial HTML/CSS and tests layout robustness

# Quick radiant fuzz (2 minutes, stress mode)
fuzz-radiant-quick: build
	@echo "Running Radiant layout fuzzy tests (quick: 2 minutes, stress mode)..."
	@chmod +x test/fuzzy/radiant/test_fuzzy_radiant.sh
	@./test/fuzzy/radiant/test_fuzzy_radiant.sh --duration=120 --stress

# Full radiant fuzz (default 5 minutes, override with duration=N)
fuzz-radiant: build
	@echo "Running Radiant layout fuzzy tests..."
	@chmod +x test/fuzzy/radiant/test_fuzzy_radiant.sh
	@./test/fuzzy/radiant/test_fuzzy_radiant.sh --duration=$(or $(duration),300) --stress

# Lambda JS Engine Fuzzy Testing
# Generates and mutates JavaScript programs to test JS engine robustness

# Quick JS fuzz (2 minutes)
fuzz-js-quick: build
	@echo "Running JS engine fuzzy tests (quick: 2 minutes)..."
	@chmod +x test/fuzzy/js/test_fuzzy_js.sh
	@./test/fuzzy/js/test_fuzzy_js.sh --duration=120

# Full JS fuzz (default 5 minutes, override with duration=N)
fuzz-js: build
	@echo "Running JS engine fuzzy tests..."
	@chmod +x test/fuzzy/js/test_fuzzy_js.sh
	@./test/fuzzy/js/test_fuzzy_js.sh --duration=$(or $(duration),300)

test-integration:
	@echo "Running integration tests..."
	@if [ -f "test/test_integration.sh" ]; then \
		chmod +x test/test_integration.sh; \
		./test/test_integration.sh; \
	else \
		echo "Integration test script not found at test/test_integration.sh"; \
		exit 1; \
	fi

# Phase 6: Build System Integration Targets
validate-build:
	@echo "Validating build objects for testing (Phase 6)..."
	@if [ -f "lib/build_utils.sh" ]; then \
		if source lib/build_utils.sh && validate_build_objects; then \
			echo "✅ Build objects validation passed"; \
		else \
			echo "❌ Build objects validation failed"; \
			echo "Run 'make build' to ensure all objects are current"; \
			exit 1; \
		fi; \
	else \
		echo "❌ Build utilities not found"; \
		exit 1; \
	fi

run: build
	@echo "Running $(LAMBDA_EXE)..."
	@if [ -f "$(LAMBDA_EXE)" ]; then \
		./$(LAMBDA_EXE); \
	else \
		echo "Executable $(LAMBDA_EXE) not found. Build first with 'make build'"; \
		exit 1; \
	fi

# Code quality targets
analyze: clean
	@echo "Running static analysis with clang..."
	@if command -v scan-build >/dev/null 2>&1; then \
		CC="scan-build clang" CXX="scan-build clang++" \
		scan-build -o analysis-results --use-cc=clang --use-c++=clang++ \
		./compile.sh build_lambda_config.json --force; \
		echo "Analysis complete. Results saved in analysis-results/"; \
		echo "Open the HTML report to view findings."; \
	elif [ -f "/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build" ]; then \
		CC="/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build clang" \
		CXX="/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build clang++" \
		/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build -o analysis-results \
		--use-cc=clang --use-c++=clang++ \
		./compile.sh build_lambda_config.json --force; \
		echo "Analysis complete. Results saved in analysis-results/"; \
	else \
		echo "scan-build not found. Install with: brew install llvm"; \
		exit 1; \
	fi

analyze-verbose: clean
	@echo "Running detailed static analysis..."
	@if command -v scan-build >/dev/null 2>&1; then \
		CC="scan-build clang" CXX="scan-build clang++" \
		scan-build -enable-checker alpha.core.CastSize \
		           -enable-checker alpha.core.CastToStruct \
		           -enable-checker alpha.security.ArrayBoundV2 \
		           -enable-checker alpha.security.ReturnPtrRange \
		           -enable-checker alpha.unix.cstring.BadSizeArg \
		           -enable-checker alpha.unix.cstring.OutOfBounds \
		           -o analysis-results-verbose \
		           --use-cc=clang --use-c++=clang++ \
		           ./compile.sh build_lambda_config.json --force; \
		echo "Detailed analysis complete. Results saved in analysis-results-verbose/"; \
	elif [ -f "/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build" ]; then \
		CC="/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build clang" \
		CXX="/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build clang++" \
		/opt/homebrew/Cellar/llvm/21.1.0/bin/scan-build -enable-checker alpha.core.CastSize \
		           -enable-checker alpha.core.CastToStruct \
		           -enable-checker alpha.security.ArrayBoundV2 \
		           -enable-checker alpha.security.ReturnPtrRange \
		           -enable-checker alpha.unix.cstring.BadSizeArg \
		           -enable-checker alpha.unix.cstring.OutOfBounds \
		           -o analysis-results-verbose \
		           --use-cc=clang --use-c++=clang++ \
		           ./compile.sh build_lambda_config.json --force; \
		echo "Detailed analysis complete. Results saved in analysis-results-verbose/"; \
	else \
		echo "scan-build not found. Install with: brew install llvm"; \
		exit 1; \
	fi

analyze-single:
	@echo "Running static analysis on individual files..."
	@mkdir -p analysis-results-single
	@echo "Testing analyzer with a simple buggy file..."
	@echo 'int main() { int *p = 0; return *p; }' > /tmp/test_analyzer.c
	@clang --analyze -Xanalyzer -analyzer-output=text /tmp/test_analyzer.c && echo "✅ Analyzer working" || echo "❌ Analyzer failed"
	@rm -f /tmp/test_analyzer.c
	@echo ""
	@echo "Analyzing Lambda source files..."
	@for file in lambda/core/print.cpp lambda/runtime/pack.cpp lib/strbuf.c lib/arraylist.c; do \
		if [ -f "$$file" ]; then \
			echo "Analyzing $$file..."; \
			clang --analyze -Xanalyzer -analyzer-output=text \
			      -Xanalyzer -analyzer-checker=core,unix,deadcode,security \
			      -I. -Ilib -Ilib/mem-pool/include \
			      "$$file" 2>&1 || echo "  (completed)"; \
		fi; \
	done
	@echo "Single file analysis complete."

# Alternative approach using compile_commands.json for better integration
analyze-compile-db: build
	@echo "Generating compile_commands.json for static analysis..."
	@if command -v bear >/dev/null 2>&1; then \
		bear -- make rebuild; \
		echo "Running clang-tidy with compile database..."; \
		if command -v clang-tidy >/dev/null 2>&1; then \
			find lambda -name "*.cpp" -o -name "*.c" | head -10 | \
			xargs clang-tidy -p . --checks='-*,clang-analyzer-*,bugprone-*,cert-*,misc-*,performance-*,portability-*,readability-*'; \
		else \
			echo "clang-tidy not found. Install with: brew install llvm"; \
		fi; \
	else \
		echo "bear not found. Install with: brew install bear"; \
		echo "Falling back to direct analysis..."; \
		$(MAKE) analyze-direct; \
	fi

# Direct analysis without build system wrapper
analyze-direct:
	@echo "Running direct static analysis on source files..."
	@mkdir -p analysis-results-direct
	@echo "Analyzing files that can compile independently..."
	@# Analyze files that don't have complex dependencies
	@for file in lambda/core/print.cpp lambda/runtime/pack.cpp lambda/core/utf_string.cpp \
	             lambda/format/format-*.cpp lambda/input/input-common.cpp \
	             lib/mime-*.c lambda/validator/error_reporting.c; do \
		if [ -f "$$file" ]; then \
			echo "Analyzing $$file..."; \
			clang --analyze -Xanalyzer -analyzer-output=html \
			      -Xanalyzer -analyzer-output-dir=analysis-results-direct \
			      -Xanalyzer -analyzer-checker=core,unix,deadcode,security.insecureAPI \
			      -I. -Ilib -Ilib/mem-pool/include -Ilambda \
			      -Ilambda/tree-sitter/lib/include \
			      -Iwasm-deps/include -Iwindows-deps/include \
			      "$$file" 2>/dev/null || echo "  (skipped due to dependencies)"; \
		fi; \
	done
	@echo "Running syntax-only analysis on complex files..."
	@find lambda -name "*.cpp" -o -name "*.c" | head -20 | while read file; do \
		echo "Syntax checking $$file..."; \
		clang -fsyntax-only -Weverything -Wno-padded -Wno-c++98-compat \
		      -I. -Ilib -Ilib/mem-pool/include -Ilambda \
		      -Ilambda/tree-sitter/lib/include \
		      -Iwasm-deps/include -Iwindows-deps/include \
		      "$$file" 2>&1 | grep -E "(warning|error)" | head -10 || true; \
	done
	@echo "Direct analysis complete. Check analysis-results-direct/ for HTML reports"
	@ls -la analysis-results-direct/ 2>/dev/null || echo "No HTML reports generated (code may be clean)"

format:
	@echo "Formatting source code..."
	@if command -v clang-format >/dev/null 2>&1; then \
		find lambda -name "*.c" -o -name "*.cpp" -o -name "*.h" | xargs clang-format -i; \
		echo "Code formatted with clang-format."; \
	else \
		echo "clang-format not found. Install with: brew install clang-format"; \
	fi

# lint-cppcheck was retired in Phase 4 (vibe/Lambda_Lint.md §8). cppcheck's
# bug-finding overlap with the Phase 3 `bugprone-*` / `clang-analyzer-*`
# families made it largely redundant; its only unique capability was
# whole-program unusedFunction, replaced by the hybrid backend at
# utils/lint/dead-code/run_unused_function.sh (rule_id: unused-function).
# Install of cppcheck is no longer required.

# Binary size analysis by library group
analyze-binary:
	@python3 utils/analyze_binary.py lambda.exe -v

# Unified project-policy linter.
#
# Runs every ast-grep rule under utils/lint/rules/ (applying each rule's
# inline-suppression marker) plus the structural checks dispatched by run.sh
# (currently utils/check_state_machine.py), and aggregates into one pass/fail
# gate. This is the single entry point — no per-policy wrapper targets.
#
# Examples:
#   make lint                                  # full sweep, CI gate
#   make lint ARGS='--rule ^no-raw-alloc$$'    # one rule (or family regex)
#   make lint ARGS='--structural-only'         # skip pattern rules
#   make lint ARGS=--report                    # write Report_NNN.{md,json,tsv}
#   make lint ARGS=--format=github             # GitHub Actions annotations
#   utils/lint/run.sh --list                   # list all rule ids
lint:
	@utils/lint/run.sh $(ARGS)

# Same pipeline plus the clang-tidy backend (bugprone-* + clang-analyzer-* +
# cert-* across all of lambda/ + radiant/). Slow (~4 min on 8 cores); split
# off from `make lint` so iterative dev runs stay fast (~6 s without tidy).
# All Report_NNN.* still aggregate findings across every active backend.
lint-full:
	@utils/lint/run.sh --with-tidy $(ARGS)

# libclang census of every struct/class/union/enum defined under lambda/, lib/
# and radiant/, with real record sizes. Incremental: only TUs whose dependency
# set changed are re-parsed. Config: utils/struct_census.config.json.
# Reports: vibe/meta/ds/struct_census.{json,csv}; interactive view in `make devtool`.
# See utils/Struct_Census.md
#   make struct-census                 # incremental refresh
#   make struct-census ARGS=--full     # ignore the cache, re-parse everything
struct-census:
	@python3 utils/struct_census.py $(ARGS)

# Lizard duplicate-code reports with documented generated-file and block exclusions.
check-code-dup:
	@python3 test/dedup/check_code_dup.py

check-lambda-dup:
	@python3 test/dedup/check_code_dup.py lambda

check-radiant-dup:
	@python3 test/dedup/check_code_dup.py radiant

check-hosted-python-architecture:
	@python3 utils/check_hosted_python_architecture.py

check-node-module-architecture:
	@python3 utils/check_node_module_architecture.py --require-node-core-object

hosted-node-coupling-inventory:
	@python3 utils/check_node_module_architecture.py --report

# Generate the checked review input for every remaining hosted-Python coupling.
# This is source analysis only; it never loads Jube or changes runtime behavior.
hosted-python-coupling-inventory:
	@python3 utils/check_hosted_python_architecture.py --inventory

check-hosted-python-module-boundary: build build-lang-python
	@python3 utils/check_hosted_python_architecture.py --require-module-binary

# Report the current provider/include/capability debt for the static-module
# split.  P0 is intentionally observational; P5 makes this a hard boundary
# gate once the source groups and public headers have moved.
static-module-inventory:
	@mkdir -p temp
	@python3 utils/check_static_module_architecture.py --json > temp/static-module-inventory.json
	@echo "Static-module inventory: temp/static-module-inventory.json"

static-module-boundary-baseline:
	@mkdir -p temp
	@python3 utils/check_static_module_architecture.py --boundary-baseline > temp/static-module-boundary-baseline.json
	@echo "Static-module boundary baseline: temp/static-module-boundary-baseline.json"

# Clang-tidy static analysis
# tidy / tidy-full / tidy-fix / generate-compile-db were retired in the Phase 3
# unification: the `bugprone-* + clang-analyzer-* + cert-*` subset (minus
# project-disabled noise) is now run by `make lint-full` (and on-demand by
# `make lint ARGS='--rule ^tidy-*'`) via utils/lint/tidy/run_tidy.sh.
# `tidy-printf` (below) is a different tool — a clang-based AST rewriter — and
# is retained.

# Refactor printf/fprintf to log_debug using clang-based tool
# Usage: make tidy-printf FILE='pattern' [DRY_RUN=1] [BACKUP=1]
tidy-printf:
	@if [ ! -f "utils/refactor_to_log_debug" ]; then \
		echo "Building refactor_to_log_debug tool..."; \
		cd utils && ./build_refactor_tool.sh || exit 1; \
	fi; \
	if [ -z "$(FILE)" ]; then \
		echo "Usage: make tidy-printf FILE='pattern' [DRY_RUN=1] [BACKUP=1]"; \
		echo ""; \
		echo "Examples:"; \
		echo "  make tidy-printf FILE='lambda/mir/mir-bitmap.h' DRY_RUN=1"; \
		echo "  make tidy-printf FILE='lambda/runtime/lambda-eval.cpp' BACKUP=1"; \
		echo "  make tidy-printf FILE='lambda/*.cpp' DRY_RUN=1"; \
		echo "  make tidy-printf FILE='lib/*.c' BACKUP=1"; \
		echo "  make tidy-printf FILE='lambda/input/input*.cpp' BACKUP=1"; \
		echo ""; \
		echo "Options:"; \
		echo "  FILE='pattern'  File pattern with wildcards (MUST be quoted!)"; \
		echo "  DRY_RUN=1       Preview changes without modifying files"; \
		echo "  BACKUP=1        Create .bak backup files before modifying"; \
		echo ""; \
		echo "Note: Always quote wildcards to prevent shell expansion!"; \
		exit 1; \
	fi; \
	DRY_RUN_FLAG=""; \
	BACKUP_FLAG=""; \
	if [ "$(DRY_RUN)" = "1" ]; then \
		DRY_RUN_FLAG="--dry-run"; \
	fi; \
	if [ "$(BACKUP)" = "1" ]; then \
		BACKUP_FLAG="--backup"; \
	fi; \
	FILES=$$(eval echo $(FILE)); \
	if [ -z "$$FILES" ]; then \
		echo "No files found matching pattern: $(FILE)"; \
		exit 1; \
	fi; \
	FILE_COUNT=$$(echo $$FILES | wc -w | tr -d ' '); \
	echo "Found $$FILE_COUNT file(s) matching pattern: $(FILE)"; \
	echo ""; \
	for file in $$FILES; do \
		if [ ! -f "$$file" ]; then \
			echo "Skipping non-existent file: $$file"; \
			continue; \
		fi; \
		echo "Processing $$file..."; \
		./utils/refactor_to_log_debug "$$file" $$DRY_RUN_FLAG $$BACKUP_FLAG; \
		echo ""; \
	done; \
	echo "✓ Completed processing $$FILE_COUNT file(s)"

# Documentation generation (if docs exist)
# docs:
# 	@echo "Generating documentation..."
# 	@if [ -f "README.md" ]; then \
# 		echo "README.md found."; \
# 		if command -v pandoc >/dev/null 2>&1; then \
# 			pandoc README.md -o README.html; \
# 			echo "Generated README.html"; \
# 		fi; \
# 	fi

# Cheatsheet PDF generation
cheatsheet:
	@echo "Generating Lambda Script cheatsheet PDFs..."
	@cd doc/_template && bash generate_pdf_cheatsheets.sh

# Utility targets
info:
	@echo "Project Information:"
	@echo "  Name: $(PROJECT_NAME)"
	@echo "  Default Config: $(DEFAULT_CONFIG)"
	@echo "  Parallel Jobs: $(JOBS)"
	@echo "  Build Directory: $(BUILD_DIR)"
	@echo "  Target Executable: $(LAMBDA_EXE)"
	@echo ""
	@echo "Available Configurations:"
	@ls -1 *.json 2>/dev/null | grep -E "(config|build)" | sed 's/^/  /' || echo "  No configuration files found"

# Performance targets
time-build:
	@echo "Timing build performance..."
	@time $(MAKE) rebuild JOBS=$(JOBS)

benchmark:
	@echo "Build benchmark (3 runs with $(JOBS) parallel jobs)..."
	@for i in 1 2 3; do \
		echo "Run $$i:"; \
		time $(MAKE) rebuild JOBS=$(JOBS) >/dev/null 2>&1; \
		echo ""; \
	done

# Premake5 Build System Targets
generate-premake:
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "Generating Premake5 configuration from JSON..."; fi
	@$(PYTHON) utils/generate_premake.py --output $(PREMAKE_FILE)

clean-premake:
	@echo "Cleaning Premake5 build artifacts..."
	@rm -rf build/premake
	@rm -f premake5.lua premake5.*.lua
	@rm -f *.make
	@rm -f dummy.cpp
	@echo "Premake5 artifacts cleaned."

build-lambda-data:
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "Building the lambda-data static archive..."; fi
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "Generating Premake configuration..."; fi
	@mkdir -p build/premake
	@$(MAKE) --no-print-directory TEST_BUILD_QUIET=$(TEST_BUILD_QUIET) generate-premake
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "Generating makefiles..."; fi
	@out=$$(cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE) 2>&1) || { printf '%s\n' "$$out"; exit 1; }
	$(call run_make_with_error_summary,lambda-data,debug_native,,lambda-data-cpp)
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "✅ lambda-data static archive built successfully!"; fi

build-lambda-rt: build-lambda-data
	@echo "Building the lambda-rt static archive..."
	@mkdir -p build/premake
	$(MAKE) generate-premake
	cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE)
	$(call run_make_with_error_summary,lambda-rt,debug_native,,lambda-rt-cpp)
	@echo "✅ lambda-rt static archive built successfully!"

build-radiant: build-lambda-rt
	@echo "Building the radiant static archive..."
	@mkdir -p build/premake
	$(MAKE) generate-premake
	cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE)
	$(call run_make_with_error_summary,radiant,debug_native,,radiant-cpp)
	@echo "✅ radiant static archive built successfully!"

build-lambda-static: build-radiant
	@echo "Linking the static-module Lambda executable..."
	@mkdir -p build/premake
	$(MAKE) generate-premake
	cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE)
	$(PYTHON) utils/patch_static_module_makefile.py
	$(call run_make_with_error_summary,lambda-exe,debug_native,,lambda-exe)
	@echo "✅ static-module Lambda executable built successfully!"

# Build only the native binaries invoked by test-input-baseline. Keeping this
# separate prevents that prerequisite from pulling the all-tests target back
# into test-lambda-baseline transitively.
# input runners link these archives directly, so declare them here to make a
# clean focused build materialize every linker input before the test link.
build-input-baseline: build-lambda-data $(TREE_SITTER_LIB) $(TREE_SITTER_LAMBDA_LIB) $(TREE_SITTER_LATEX_LIB) $(TREE_SITTER_LATEX_MATH_LIB) $(RE2_LIB)
	@echo "Building input baseline test executables..."
	$(call run_make_with_error_summary,input-baseline,debug_native,,$(INPUT_BASELINE_TEST_PROJECTS))

# Build the Lambda host and only the native projects selected by the Lambda
# baseline runner. The release-host branch preserves the existing convention
# that baseline tests use an already-selected release host when available.
# The Lambda baseline includes JS cases that require the external Node Jube
# modules. Build them here because the focused lane intentionally does not use
# the aggregate build-test target that normally supplies these DSOs.
# debug and release share lambda.exe; remove it before a release host rebuild
# so make cannot mistake an ASan debug binary for an up-to-date release host.
build-lambda-baseline: build-input-baseline build-node-core build-node-fs
	@echo "Building the Lambda baseline runtime and native test executables..."
	@if [ -f .lambda_release_build ]; then \
		echo "Rebuilding lambda.exe in release mode (incremental)..."; \
		rm -f lambda.exe; \
		$(MAKE) -C build/premake config=release_native lambda -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)" LINK_JOBS="$(LINK_JOBS)"; \
	else \
		echo "Rebuilding lambda.exe in debug mode (incremental)..."; \
		$(MAKE) -C build/premake config=debug_native lambda -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)" LINK_JOBS="$(LINK_JOBS)"; \
	fi
	$(call run_make_with_error_summary,lambda-baseline,debug_native,,$(LAMBDA_BASELINE_TEST_PROJECTS))

check-module-boundary:
	@echo "Building static-module validation DSOs..."
	@mkdir -p build/premake
	$(MAKE) generate-premake
	cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE)
	$(MAKE) -C build/premake config=debug_native lambda-boundary-lib lambda-boundary-core lambda-boundary-io lambda-boundary-rt lambda-boundary-radiant -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"
	$(PYTHON) utils/check_module_boundary.py
	@echo "✅ module-boundary validation completed (Class-F ratcheted deferment)"

build-test: build-lambda-data build-windows-host-import generate-tree-sitter-python-parser
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "Building tests using Premake5..."; fi
	@if [ "$(TEST_BUILD_QUIET)" != "1" ]; then echo "Building configurations..."; fi
	@mkdir -p build/premake
	@# Drop a backup left behind by an interrupted earlier run. The restore step
	@# below keys on this file merely existing, so a stale one silently replaces
	@# a freshly built lambda.exe with an older binary -- which surfaces much
	@# later as "unknown option" for a flag that is in fact implemented. Clearing
	@# it here makes "the backup exists" mean "this invocation created it".
	@rm -f .lambda_build_backup.exe
	@$(MAKE) --no-print-directory TEST_BUILD_QUIET=$(TEST_BUILD_QUIET) generate-premake
	@out=$$(cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE) 2>&1) || { printf '%s\n' "$$out"; exit 1; }
# If last build was release, rebuild lambda.exe incrementally in release mode.
# debug and release share lambda.exe; force a relink before copying the host.
	@if [ -f .lambda_release_build ]; then \
		echo "Rebuilding lambda.exe in release mode (incremental) — log: temp/build_tests_lambda.log"; \
		rm -f lambda.exe; \
		mkdir -p temp; \
		$(MAKE) -C build/premake config=release_native lambda -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" > temp/build_tests_lambda.log 2>&1 || { echo "❌ release lambda rebuild failed (see temp/build_tests_lambda.log):"; tail -20 temp/build_tests_lambda.log; exit 1; }; \
		cp -p lambda.exe .lambda_build_backup.exe; \
	fi
	@echo "Building all test executables (debug mode, $(TEST_JOBS) jobs)..."
	$(call run_make_with_error_summary,tests,debug_native,,all)
	@# The debug "all" target also rebuilds hosted modules; refresh every
	@# manifest before restoring the release host. Otherwise a rebuilt Node DSO
	@# retains its previous digest and all module-backed JS tests fail at load.
	@for module_dir in modules/lang-python modules/node-core modules/node-fs modules/node-zlib; do \
		$(PYTHON) utils/update_jube_manifest_integrity.py $$module_dir || exit 1; \
	done
	@# Restore release lambda.exe over the debug one
	@if [ -f .lambda_build_backup.exe ]; then \
		echo "Restoring release lambda.exe..."; \
		mv .lambda_build_backup.exe lambda.exe; \
	fi

# Radiant baseline needs lambda plus its focused native runners; building every test
# project made unrelated suites dominate this gate after a clean build.
build-radiant-baseline:
	@echo "Building the Radiant baseline runtime and native test runners..."
	@mkdir -p build/premake
	$(MAKE) generate-premake
	cd build/premake && PATH="/clang64/bin:$$PATH" $(PREMAKE5) gmake --file=../../$(PREMAKE_FILE)
	@echo "Building lambda-data static archive with $(TEST_JOBS) parallel jobs..."
	$(MAKE) -C build/premake config=debug_native lambda-data-cpp -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"
	@if [ -f .lambda_release_build ]; then \
		echo "Rebuilding lambda.exe in release mode (incremental)..."; \
		$(MAKE) -C build/premake config=release_native lambda -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"; \
	else \
		echo "Rebuilding lambda.exe in debug mode (incremental)..."; \
		$(MAKE) -C build/premake config=debug_native lambda -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"; \
	fi
	@echo "Building Radiant baseline test executables (debug mode, $(TEST_JOBS) jobs)..."
	PATH="/clang64/bin:$$PATH" $(MAKE) -C build/premake config=debug_native $(RADIANT_BASELINE_TEST_PROJECTS) -j$(TEST_JOBS) CC="$(CC)" CXX="$(CXX)" AR="$(AR)" RANLIB="$(RANLIB)"

# Capture browser layout references using Puppeteer
# Usage:
#   make capture-layout test=test-name           # captures a specific test (auto-discovers suite)
#   make capture-layout suite=baseline           # captures only baseline category
#   make capture-layout test=test-name force=1   # force regenerate a specific test
#   make capture-layout suite=basic force=1      # force regenerate specific category
#   make capture-layout suite=baseline platform=linux  # capture Linux-specific references
# Note: Either test= or suite= is REQUIRED (no longer allows capturing all tests)
capture-layout:
	@echo "🧭 Capturing browser layout references..."
	@TEST_VAR="$(or $(test),$(TEST))"; \
	SUITE_VAR="$(or $(suite),$(SUITE))"; \
	PLATFORM_VAR="$(or $(platform),$(PLATFORM))"; \
	if [ -z "$$TEST_VAR" ] && [ -z "$$SUITE_VAR" ]; then \
		echo ""; \
		echo "❌ Error: Either test= or suite= parameter is required"; \
		echo ""; \
		echo "Usage:"; \
		echo "  make capture-layout test=<test-name>     # Capture a specific test"; \
		echo "  make capture-layout suite=<suite-name>   # Capture entire suite"; \
		echo "  make capture-layout suite=baseline platform=linux  # Linux-specific refs"; \
		echo ""; \
		echo "Examples:"; \
		echo "  make capture-layout test=basic-text-align"; \
		echo "  make capture-layout suite=baseline"; \
		echo "  make capture-layout test=table_007 force=1"; \
		echo "  make capture-layout suite=baseline platform=linux force=1"; \
		echo ""; \
		echo "Available suites: antd, basic, baseline, bootstrap, css2.1, flex, grid, tailwind, yoga, web-tmpl, wpt-css-box, wpt-css-images, wpt-css-tables, wpt-css-position, wpt-css-text, wpt-css-lists"; \
		echo "Available platforms: linux, darwin, win32"; \
		echo ""; \
		exit 1; \
	fi; \
	if [ -d "test/layout" ]; then \
	    cd test/layout && \
	    if [ ! -d node_modules ]; then \
	        echo "📦 Installing test layout dependencies..."; \
	        npm install; \
	    fi; \
	    FORCE_FLAG=""; \
	    FORCE_VAR="$(or $(force),$(FORCE))"; \
	    if [ -n "$$FORCE_VAR" ] && [ "$$FORCE_VAR" != "0" ]; then \
	        FORCE_FLAG="--force"; \
	        echo "🔄 Force regeneration enabled"; \
	    fi; \
	    PLATFORM_FLAG=""; \
	    if [ -n "$$PLATFORM_VAR" ]; then \
	        PLATFORM_FLAG="--platform $$PLATFORM_VAR"; \
	        echo "📦 Platform-specific reference: $$PLATFORM_VAR"; \
	    fi; \
	    if [ -n "$$TEST_VAR" ]; then \
	        case "$$TEST_VAR" in \
	            *.html|*.htm) TEST_FILE="$$TEST_VAR" ;; \
	            *) \
	                TEST_FILE=""; \
	                FOUND_SUITE=""; \
	                for dir in antd basic baseline bootstrap css2.1 flex grid tailwind yoga wpt-css-box wpt-css-images wpt-css-tables wpt-css-position wpt-css-text wpt-css-lists; do \
	                    if [ -f "data/$$dir/$${TEST_VAR}.htm" ]; then \
	                        TEST_FILE="data/$$dir/$${TEST_VAR}.htm"; \
	                        FOUND_SUITE="$$dir"; \
	                        break; \
	                    elif [ -f "data/$$dir/$${TEST_VAR}.html" ]; then \
	                        TEST_FILE="data/$$dir/$${TEST_VAR}.html"; \
	                        FOUND_SUITE="$$dir"; \
	                        break; \
	                    fi; \
	                    for subdir in data/$$dir/*/; do \
	                        if [ -d "$$subdir" ]; then \
	                            if [ -f "$${subdir}$${TEST_VAR}.htm" ]; then \
	                                TEST_FILE="$${subdir}$${TEST_VAR}.htm"; \
	                                FOUND_SUITE="$$dir"; \
	                                break 2; \
	                            elif [ -f "$${subdir}$${TEST_VAR}.html" ]; then \
	                                TEST_FILE="$${subdir}$${TEST_VAR}.html"; \
	                                FOUND_SUITE="$$dir"; \
	                                break 2; \
	                            fi; \
	                        fi; \
	                    done; \
	                done; \
	                if [ -z "$$TEST_FILE" ] && [ -f "data/web-tmpl/$${TEST_VAR}/index.html" ]; then \
	                    TEST_FILE="data/web-tmpl/$${TEST_VAR}/index.html"; \
	                    FOUND_SUITE="web-tmpl"; \
	                fi; \
	                if [ -z "$$TEST_FILE" ]; then \
	                    echo "❌ Error: Test file '$$TEST_VAR' not found in any suite directory"; \
	                    echo "   Searched in: antd, basic, baseline, bootstrap, css2.1, flex, grid, tailwind, yoga, web-tmpl, wpt-css-*"; \
	                    exit 1; \
	                fi; \
	                echo "📄 Found test in suite: $$FOUND_SUITE" \
	            ;; \
	        esac; \
	        echo "📄 Capturing single test: $$TEST_FILE"; \
	        LAMBDA_ROOT=$(CURDIR) node extract_browser_references.js $$FORCE_FLAG $$PLATFORM_FLAG $$TEST_FILE; \
	    else \
	        echo "📂 Capturing suite: $$SUITE_VAR"; \
	        LAMBDA_ROOT=$(CURDIR) node extract_browser_references.js $$FORCE_FLAG $$PLATFORM_FLAG --category $$SUITE_VAR; \
	    fi; \
	else \
	    echo "❌ Error: Layout directory not found at test/layout"; \
	    exit 1; \
	fi

# Layout Engine Testing Targets
# ==============================

# test-layout: Run layout tests using Lambda CSS engine
# Usage: make test-layout [suite=SUITE] [test=TEST] [pattern=PATTERN] [update=1]
# Note: test parameter now accepts filename with or without .html/.htm extension
# Example: make test-layout test=baseline_301_simple_margin
test-layout:
	@echo "🎨 Running Lambda CSS Layout Engine Tests"
	@echo "=========================================="
	@STALE_FILE=""; \
	if [ ! -x "$(LAMBDA_EXE)" ]; then \
		echo "🔧 $(LAMBDA_EXE) missing; building before layout tests"; \
		$(MAKE) build; \
	else \
		STALE_FILE=$$(find radiant lambda lib -type f \( -name '*.c' -o -name '*.cc' -o -name '*.cpp' -o -name '*.cxx' -o -name '*.h' -o -name '*.hpp' -o -name '*.m' -o -name '*.mm' \) -newer "$(LAMBDA_EXE)" -print -quit 2>/dev/null); \
		if [ -n "$$STALE_FILE" ]; then \
			echo "🔧 $(LAMBDA_EXE) is older than $$STALE_FILE; rebuilding before layout tests"; \
			$(MAKE) build; \
		fi; \
	fi
	@if [ -f "test/layout/test_radiant_layout.js" ]; then \
		TEST_VAR="$(or $(test),$(TEST))"; \
		PATTERN_VAR="$(or $(pattern),$(PATTERN))"; \
		SUITE_VAR="$(or $(suite),$(SUITE))"; \
		UPDATE_BASELINE_VAR="$(or $(update),$(UPDATE),$(update-baseline),$(UPDATE_BASELINE))"; \
		CONCURRENCY_VAR="$(or $(layout_concurrency),$(LAYOUT_CONCURRENCY),$(concurrency),$(CONCURRENCY))"; \
		UPDATE_BASELINE_FLAG=""; \
		CONCURRENCY_FLAG=""; \
		if [ -n "$$UPDATE_BASELINE_VAR" ]; then UPDATE_BASELINE_FLAG="--update-baseline"; fi; \
		if [ -n "$$CONCURRENCY_VAR" ]; then CONCURRENCY_FLAG="-j $$CONCURRENCY_VAR"; fi; \
		if [ -n "$$TEST_VAR" ]; then \
			case "$$TEST_VAR" in \
				*.html|*.htm) TEST_FILE="$$TEST_VAR" ;; \
				*) \
					TEST_FILE=""; \
					for dir in antd basic baseline bootstrap css2.1 flex grid tailwind yoga form wpt-css-box wpt-css-images wpt-css-tables wpt-css-position wpt-css-text wpt-css-lists wpt-css-inline; do \
						if [ -f "test/layout/data/$$dir/$${TEST_VAR}.htm" ]; then \
							TEST_FILE="$${TEST_VAR}.htm"; \
							break; \
						elif [ -f "test/layout/data/$$dir/$${TEST_VAR}.html" ]; then \
							TEST_FILE="$${TEST_VAR}.html"; \
							break; \
						fi; \
						for subdir in test/layout/data/$$dir/*/; do \
							if [ -d "$$subdir" ]; then \
								if [ -f "$${subdir}$${TEST_VAR}.htm" ]; then \
									TEST_FILE="$${TEST_VAR}.htm"; \
									break 2; \
								elif [ -f "$${subdir}$${TEST_VAR}.html" ]; then \
									TEST_FILE="$${TEST_VAR}.html"; \
									break 2; \
								fi; \
							fi; \
						done; \
					done; \
					if [ -z "$$TEST_FILE" ] && [ -f "test/layout/data/web-tmpl/$${TEST_VAR}/index.html" ]; then \
						TEST_FILE="$${TEST_VAR}/index.html"; \
					fi; \
					if [ -z "$$TEST_FILE" ]; then \
						TEST_FILE="$${TEST_VAR}.html"; \
					fi \
				;; \
			esac; \
			echo "🎯 Running single test: $$TEST_FILE"; \
			$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css --test $$TEST_FILE -v; \
		elif [ -n "$$PATTERN_VAR" ]; then \
			echo "🔍 Running tests matching pattern: $$PATTERN_VAR"; \
			$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css --pattern $$PATTERN_VAR $$CONCURRENCY_FLAG; \
		elif [ -n "$$SUITE_VAR" ]; then \
			echo "📂 Running test suite: $$SUITE_VAR"; \
			$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css --category $$SUITE_VAR $$CONCURRENCY_FLAG $$UPDATE_BASELINE_FLAG; \
		else \
			echo "🎯 Running all layout tests"; \
			$(LAYOUT_TEST_ENV) node test/layout/test_radiant_layout.js --engine lambda-css $$CONCURRENCY_FLAG $$UPDATE_BASELINE_FLAG; \
		fi; \
	else \
		echo "❌ Error: Layout test script not found at test/layout/test_radiant_layout.js"; \
		exit 1; \
	fi

# layout: Alias for test-layout
layout: test-layout

# ─── Render Visual Regression Tests ─────────────────────────────────────────

# capture-render: Capture browser reference PNGs for render tests
# Usage: make capture-render [test=<test-name>] [force=1] [platform=<platform>] [suite=<suite>]
capture-render:
	@echo "🖼️  Capturing browser render references..."
	@if [ -d "test/render" ]; then \
		cd test/render && \
		if [ ! -d node_modules ]; then \
			echo "📦 Installing render test dependencies..."; \
			npm install; \
		fi; \
		ARGS=""; \
		TEST_VAR="$(or $(test),$(TEST))"; \
		FORCE_VAR="$(or $(force),$(FORCE))"; \
		PLATFORM_VAR="$(or $(platform),$(PLATFORM))"; \
		SUITE_VAR="$(or $(suite),$(SUITE))"; \
		if [ -n "$$TEST_VAR" ]; then \
			ARGS="$$ARGS --test $$TEST_VAR"; \
		fi; \
		if [ -n "$$FORCE_VAR" ] && [ "$$FORCE_VAR" != "0" ]; then \
			ARGS="$$ARGS --force"; \
		fi; \
		if [ -n "$$PLATFORM_VAR" ]; then \
			ARGS="$$ARGS --platform $$PLATFORM_VAR"; \
		fi; \
		if [ -n "$$SUITE_VAR" ]; then \
			ARGS="$$ARGS --suite $$SUITE_VAR"; \
		fi; \
		LAMBDA_ROOT=$(CURDIR) node capture_render_references.js $$ARGS; \
	else \
		echo "❌ Error: Render test directory not found at test/render"; \
		exit 1; \
	fi

# test-render: Run render visual regression tests, including baseline checks by default
# Usage: make test-render [test=<test-name>] [pattern=<regex>] [threshold=<percent>] [suite=<suite>] [baseline=0] [update=1]
test-render:
	@echo "🎨 Running Radiant Render Tests"
	@echo "================================"
	@if [ -d "test/render" ]; then \
		cd test/render && \
		if [ ! -d node_modules ]; then \
			echo "📦 Installing render test dependencies..."; \
			npm install; \
		fi; \
		ARGS=""; \
		TEST_VAR="$(or $(test),$(TEST))"; \
		PATTERN_VAR="$(or $(pattern),$(PATTERN))"; \
		THRESHOLD_VAR="$(or $(threshold),$(THRESHOLD))"; \
		SUITE_VAR="$(or $(suite),$(SUITE))"; \
		BASELINE_VAR="$(or $(baseline),$(BASELINE),1)"; \
		UPDATE_VAR="$(or $(update),$(UPDATE),$(update-baseline),$(UPDATE_BASELINE))"; \
		if [ -n "$$TEST_VAR" ]; then \
			ARGS="$$ARGS --test $$TEST_VAR"; \
		fi; \
		if [ -n "$$PATTERN_VAR" ]; then \
			ARGS="$$ARGS --pattern $$PATTERN_VAR"; \
		fi; \
		if [ -n "$$THRESHOLD_VAR" ]; then \
			ARGS="$$ARGS --threshold $$THRESHOLD_VAR"; \
		fi; \
		if [ -n "$$SUITE_VAR" ]; then \
			ARGS="$$ARGS --suite $$SUITE_VAR"; \
		fi; \
		if [ -n "$$BASELINE_VAR" ] && [ "$$BASELINE_VAR" != "0" ]; then \
			ARGS="$$ARGS --baseline"; \
		fi; \
		if [ -n "$$UPDATE_VAR" ] && [ "$$UPDATE_VAR" != "0" ]; then \
			ARGS="$$ARGS --update-baseline"; \
		fi; \
		LAMBDA_ROOT=$(CURDIR) node test_radiant_render.js $$ARGS; \
	else \
		echo "❌ Error: Render test directory not found at test/render"; \
		exit 1; \
	fi

# render-test: Alias for test-render
render-test: test-render

# render: Alias for test-render
render: test-render

# compare-layout: Run Radiant layout and compare with browser reference
# Usage: make compare-layout test=<test-name> [category=<category>] [options]
# Example: make compare-layout test=sample3.html category=page
# Example: make compare-layout test=baseline_301 category=baseline verbose=1
compare-layout: build
	@if [ -z "$(test)" ] && [ -z "$(TEST)" ]; then \
		echo "Usage: make compare-layout test=<test-name> [category=<category>]"; \
		echo ""; \
		echo "Examples:"; \
		echo "  make compare-layout test=sample3.html category=page"; \
		echo "  make compare-layout test=baseline_301 category=baseline"; \
		echo "  make compare-layout test=sample3 category=page verbose=1"; \
		echo ""; \
		echo "Options (pass as make variables):"; \
		echo "  test=NAME       Test file name (required)"; \
		echo "  category=CAT    Test category (default: page)"; \
		echo "  verbose=1       Show all comparisons"; \
		echo "  threshold=N     Difference threshold (default: 0.5)"; \
		echo "  elements=LIST   Comma-separated list of elements"; \
		exit 1; \
	fi; \
	TEST_VAR="$${test:-$(TEST)}"; \
	CAT_VAR="$${category:-$(CATEGORY)}"; \
	CAT_VAR="$${CAT_VAR:-page}"; \
	OPTS="--run --test $$TEST_VAR --category $$CAT_VAR"; \
	if [ -n "$(verbose)" ] || [ -n "$(VERBOSE)" ]; then \
		OPTS="$$OPTS --verbose"; \
	fi; \
	if [ -n "$(threshold)" ] || [ -n "$(THRESHOLD)" ]; then \
		OPTS="$$OPTS --threshold $${threshold:-$(THRESHOLD)}"; \
	fi; \
	if [ -n "$(elements)" ] || [ -n "$(ELEMENTS)" ]; then \
		OPTS="$$OPTS --elements $${elements:-$(ELEMENTS)}"; \
	fi; \
	node test/layout/compare-layout.js $$OPTS

# devtool: Launch the DevTool Electron app
# Usage: make devtool
devtool:
	@echo "🚀 Launching DevTool..."
	@if [ -d "utils/devtool" ]; then \
		cd utils/devtool && npm run electron:dev; \
	else \
		echo "❌ Error: DevTool not found at utils/devtool"; \
		exit 1; \
	fi

# download: Download a web page and save it to test/layout/data/page/
# Usage: make download <url>
# Example: make download https://example.com
# This will download the page and extract the domain as prefix
download:
	@if [ -z "$(filter-out download,$(MAKECMDGOALS))" ]; then \
		echo "Usage: make download <url>"; \
		echo ""; \
		echo "Example:"; \
		echo "  make download https://example.com/path/page.html"; \
		echo ""; \
		echo "This will:"; \
		echo "  1. Download the web page from the URL"; \
		echo "  2. Save to test/layout/data/page/"; \
		echo "  3. Use cleansed full URL path as filename"; \
		echo "  4. Extract domain name as resource prefix"; \
		exit 1; \
	fi; \
	URL_VAR="$(filter-out download,$(MAKECMDGOALS))"; \
	if [ -z "$$URL_VAR" ]; then \
		echo "❌ Error: No URL provided"; \
		exit 1; \
	fi; \
	if ! echo "$$URL_VAR" | grep -qE '^https?://'; then \
		echo "❌ Error: Invalid URL - must start with http:// or https://"; \
		echo "   Provided: $$URL_VAR"; \
		exit 1; \
	fi; \
	DOMAIN=$$(echo "$$URL_VAR" | sed -E 's|^https?://([^/:]+).*|\1|' | sed -E 's/^www\.//' | sed -E 's/\..*//' | tr '[:upper:]' '[:lower:]'); \
	PREFIX="$$DOMAIN"; \
	FULL_PATH=$$(echo "$$URL_VAR" | sed -E 's|^https?://[^/]+||' | sed -E 's|^/||' | sed -E 's|[^a-zA-Z0-9._-]|_|g' | sed -E 's|_+|_|g' | sed -E 's|^[^a-zA-Z0-9]+||'); \
	if [ -z "$$FULL_PATH" ] || [ "$$FULL_PATH" = "_" ]; then \
		FILENAME="$$PREFIX.html"; \
	else \
		FILENAME="$$FULL_PATH"; \
		if ! echo "$$FILENAME" | grep -qE '\.(html?|htm)$$'; then \
			FILENAME="$$FILENAME.html"; \
		fi; \
	fi; \
	OUTPUT_DIR="test/layout/data/page"; \
	echo "📥 Downloading web page..."; \
	echo "  URL: $$URL_VAR"; \
	echo "  Output directory: $$OUTPUT_DIR"; \
	echo "  Filename: $$FILENAME"; \
	echo "  Prefix: $$PREFIX"; \
	echo ""; \
	mkdir -p "$$OUTPUT_DIR"; \
	node utils/downloader/download-page.js "$$URL_VAR" "$$OUTPUT_DIR" --prefix "$$PREFIX" --name "$$FILENAME"

# Catch-all target to allow filenames as targets for download
%:
	@:

# Run compilation performance benchmark
bench-compile:
	@echo "Running C/C++ compilation benchmark..."
	@bash utils/benchmark_compile.sh

# Count lines of code in the repository
count-loc:
	@./utils/count_loc.sh

# Publish ./site to gh-pages branch
gh-pages:
	@echo "Publishing site to gh-pages..."
	@cd /tmp/lambda-ghpages && rm -rf * && cp -R $(CURDIR)/site/* . && \
		git add -A && git commit -m "Update site" && git push origin gh-pages
	@echo "Done. Site published to gh-pages."