Research-Stack/0-Core-Formalism/lean/Semantics/build-static

OTOM Static Compilation Suite

Builds Lean 4 executables with static linking via GCC for the OTOM Research Stack.

Quick Start

cd 0-Core-Formalism/lean/Semantics/build-static

# Verify toolchain
./build_static.sh check

# Build all executables with static linking
./build_static.sh

# Optimized release build with LTO
./build_static.sh release --lto

# Build inside Docker (musl, fully static)
./build_static.sh docker

Available Targets

Target	Description
all	Static build of all executables (default)
release	Optimized -O3 build, optional --lto
debug	Debug build with symbols
check	Verify toolchain availability
lint	Run zero-trust linter (AGENTS.md)
verilog	Emit Lean-verified Verilog for FPGA
synthesis	Full FPGA synthesis (yosys + nextpnr)
clean	Remove build artifacts
docker	Reproducible Docker-based build

Executables

The following targets are built from lakefile.toml:

• bindserver — OTOM bind server
• searchserver — Search service
• SemanticsCli — CLI interface
• openworm_benchmark — OpenWorm benchmark
• ExtremeParameterTestEval — Parameter test (extreme)
• NominalParameterTestEval — Parameter test (nominal)
• moim_benchmark — MOIM benchmark
• generate_sparkle_phi_s3c — Sparkle Phi/S3C generator
• tangnano9k_emitter — Tang Nano 9K Verilog emitter

Configuration

Environment variables:

Variable	Default	Description
LEAN_CC	gcc	C compiler
LEANC_OPTS	—	Additional compiler flags
JOBS	auto	Parallel jobs
TARGET_DIR	./out	Output directory for binaries

Static Linking Notes

• Uses -static -static-libgcc for glibc-based static linking
• Use --musl or Docker build for fully static musl binaries
• lake passes flags to leanc, which wraps the system compiler
• Verified with ldd to confirm no dynamic dependencies

Makefile Interface

make static       # Default static build
make release      # Optimized build
make check        # Toolchain verification
make docker-build # Docker-based build
make clean        # Clean artifacts

Architecture

• build_static.sh — Main orchestration script
• Makefile — Standard make interface
• Dockerfile.static — Alpine/musl reproducible build