Add simplified build system with meta-modules and wrapper scripts

[tclune]

Summary

This PR introduces a simplified build system for MAPL that reduces cognitive load for both developers and AI agents by providing meta-modules and wrapper scripts.

Changes

Wrapper Scripts

• build.sh - Simple build wrapper: ./build.sh [compiler] [build_type]
• test.sh - Simple test wrapper: ./test.sh [compiler] [test_pattern]
• BUILD.md - Comprehensive documentation

Meta-Modules (Created in ~/modulefiles/core/)

• nag-stack - Loads NAG + OpenMPI + baselibs
• gfortran-stack - Loads GFortran + OpenMPI + baselibs

Benefits

Before:

module purge
module load nag/7.2.41
module load openmpi/5.0.5
module load baselibs/9.7.0
mkdir -p build-nag
cd build-nag
cmake .. -DCMAKE_BUILD_TYPE=Debug
cmake --build . -j8
# For tests: remember to set DYLD_LIBRARY_PATH...

After:

./build.sh nag
./test.sh nag

Key Features

• Automatic module loading (no need to remember sequences)
• Automatic DYLD_LIBRARY_PATH handling via ctest
• Consistent build directory naming
• Support for test filtering
• Clear error messages

Related Issues

• Partially addresses Update mapl-build skill documentation for new build workflow #4511 (wrapper scripts and meta-modules complete)
• Skill documentation update tracked separately in Update mapl-build skill documentation for new build workflow #4511

Testing

Meta-modules tested and confirmed working:

module load nag-stack      # ✓ Loads all dependencies
module load gfortran-stack # ✓ Loads all dependencies

Scripts tested for proper module loading and error handling.

[mathomp4]

@tclune This might only work for you...or only on bucy? For example, I don't have things like gfortran-stack on my macOS machines.

But if it helps you, that is good. I might suggest more modern CMake though a la:

BUILD_DIR="build-${COMPILER}"
INSTALL_DIR="install-${COMPILER}"

and then replace:

# Create build directory
mkdir -p "$BUILD_DIR"
cd "$BUILD_DIR"

# Configure with CMake
echo ""
echo "Configuring with CMake..."
cmake .. \
    -DCMAKE_BUILD_TYPE="$BUILD_TYPE" \
    -DCMAKE_INSTALL_PREFIX=../install

with:

cmake -B ${BUILD_DIR} -S . --install-prefix=$(pwd)/${INSTALL_DIR} -DCMAKE_BUILD_TYPE=${BUILD_TYPE}

You also don't ever do install with this:

cmake --build . -j8

(and you should point to ${BUILD_DIR}).

If you want that then you'd need to add a:

cmake --build ${BUILD_DIR} --parallel 8 --target install

Similarly for ctest you can do:

ctest --test-dir ${BUILD_DIR} ...

For real safety, maybe BUILD_DIR and INSTALL_DIR should be full paths and even where the source is? Then you can do:

cmake -B ${BUILD_DIR} -S ${SOURCE_DIR} --install-prefix=${INSTALL_DIR} -DCMAKE_BUILD_TYPE=${BUILD_TYPE}

[tclune]

Yes - this was just the initial response (recommendation) from claude after a lengthy set of questions. Not at all sure I like it and very much think of this as just the start of a discussion.

[tclune]

Please make inline suggestions. I also now see that claude failed to bring the updated "skill" over from the other branch. (It did not follow my instructions and initially committed in on the wrong branch.)

[tclune]

I wonder where Claude found that CMake version. The environment it was running in has v3.31.1.

[pchakraborty]

I use something like
BUILD_DIR="${SOURCE_DIR}/build/${COMPILER}/${BUILD_TYPE}”
Might be cleaner - you will need to gitignore only the build directory.

[mathomp4]

Well, at the moment we ignore:

/build*
/install*

so if it's a directory called that, we ignore it. Plus our CMake adds a .gitignore file to all build and install directories regardless of names.

[pchakraborty]

Similar to BUILD_DIR

[pchakraborty]

We’ll need build type, unless we assume that we are testing only the Debug build for that compiler