Migrate build system to Kotlin build-logic

[jbachorik]

Summary

Migrates the native build system from buildSrc to a Gradle composite build (build-logic/) with modern Kotlin DSL plugins. This provides better IDE support, faster incremental builds, and a cleaner architecture.

Key changes:

• Replace buildSrc/ with build-logic/conventions/ composite build
• Convert all build scripts from Groovy to Kotlin DSL (.gradle → .gradle.kts)
• Create reusable Gradle plugins: NativeBuildPlugin, GtestPlugin, ScanBuildPlugin
• Add automatic musl libc detection with -D__musl__ compiler flag
• Add comprehensive documentation in build-logic/README.md and QUICKSTART.md
• Create tooling-agnostic AGENTS.md for AI coding assistants

Build system improvements:

• Platform-aware native compilation (Linux/macOS, x64/arm64)
• Configurable build configurations (release, debug, asan, tsan, fuzzer)
• Automatic debug symbol extraction for release builds
• Google Test integration with per-test task granularity
• scan-build static analysis integration (Linux only)

Test plan

• Build compiles on macOS arm64
• Build compiles on Linux x64
• Build compiles on Linux arm64
• Build compiles on Linux x64 musl
• All Java tests pass (testDebug)
• All C++ tests pass (gtestDebug)
• CI pipeline passes

# Local testing
./gradlew buildDebug
./gradlew testDebug
./gradlew gtestDebug

🤖 Generated with Claude Code

[dd-octo-sts]

Scan-Build Report

User:	runner@runnervmkj6or
Working Directory:	/home/runner/work/java-profiler/java-profiler/ddprof-lib/src/test/make
Command Line:	make -j4 all
Clang Version:	Ubuntu clang version 18.1.3 (1ubuntu1)
Date:	Fri Feb 6 14:08:42 2026

Bug Summary

Bug Type	Quantity	Display?
All Bugs	1
Unused code
Dead assignment	1

Reports

Bug Group	Bug Type ▾	File	Function/Method	Line	Path Length
Unused code	Dead assignment	libraryPatcher_linux.cpp	patch_library_unlocked	94	1

[dd-octo-sts]

CI Test Results

Run: #21753376434 | Commit: 38bf787 | Duration: 20m 18s (longest job)

❌ 1 of 40 test jobs failed

Status Overview

JDK	glibc-aarch64/debug	glibc-amd64/debug	musl-aarch64/debug	musl-amd64/debug
8	-	✅	-	-
8-ibm	-	✅	-	-
8-j9	✅	✅	-	-
8-librca	-	-	✅	✅
8-orcl	-	✅	-	-
8-zing	✅	✅	-	-
11	-	✅	-	-
11-j9	✅	✅	-	-
11-librca	-	-	✅	✅
11-zing	✅	✅	-	-
17	✅	✅	-	-
17-graal	✅	✅	-	-
17-j9	✅	✅	-	-
17-librca	-	-	✅	✅
17-zing	✅	✅	-	-
21	✅	✅	-	-
21-graal	✅	✅	-	-
21-librca	-	-	✅	✅
21-zing	✅	✅	-	-
25	✅	✅	-	-
25-graal	✅	❌	-	-
25-librca	-	-	✅	✅

Legend: ✅ passed | ❌ failed | ⚪ skipped | 🚫 cancelled

Failed Tests

glibc-amd64/debug / 25-graal

Job: View logs

No detailed failure information available. Check the job logs.

Summary: Total: 40 | Passed: 39 | Failed: 1

---

Updated: 2026-02-06 15:13:27 UTC

[rkennke]

So wait a minute...
Without having looked at much of the changes (which seems many):

• Now I need to learn Kotlin, in addition to Groovy, for the build system?
• How does it improve IDE support? I don't think my IDE (CLion) deals very well with Gradle, let alone Gradle with Kotlin stuff? (Although, it might actually like the Kotlin parts, CLion comes from the same company that invented Kotlin, after all).

[jbachorik]

@rkennke There is no Groovy left.
The main issue is that using groovy and buildSrc is 'old/deprecated` and any bugfixing/improving effort goes to the kotlin based stuff.

And we want to use the plugins because it simplifies the actual build files significantly :(

Eg. to completely setup the native build you just need to do

// Configure native build with the new plugin
nativeBuild {
  version.set(componentVersion)
  cppSourceDirs.set(listOf("src/main/cpp"))
  includeDirectories.set(
    listOf(
      "src/main/cpp",
      "${project(":malloc-shim").file("src/main/public")}"
    )
  )
}

No fancy gradle magic stealing configurations from other tasks etc.

I am planning to progressively move the logic that is not strictly related to configuring the build up to the plugins so the only thing you would need to do to maintain the build would be pretty small and declarative.

And, last but not least, dd-trace-java is also moving to Kotlin and since we cooperate with that project we need to be at least aware of the Kotlin syntax (but the codegen tools can take a brunt - the AGENTS.md is set up in a way that it should help with the build maintenance)

---

How does it improve IDE support?

Well, IntelliJ seems to be a lot snappier with this new config. Also, the build feels like starting faster ...

[rkennke]

There are a few changes in os_linux.cpp - are they related? Otherwise you might want to clean those up.