stig-gradle-plugin/com.stigway.gradle.support

Package-level declarations

Types

enum ComplexityBand : Enum<ComplexityBand>

data class DemangledToMangledResult(val map: Map<String, String>, val duplicates: Map<String, List<String>>)

Result of buildDemangledToMangledMap including the lookup map and any detected ambiguities where multiple mangled symbols share the same demangled name.

ExecResult

data class ExecResult(val exitCode: Int, val output: String)

GradleStigProblemReporter

class GradleStigProblemReporter(projectPath: String, taskName: String, logger: Logger, problemsFile: File, failAt: ProblemSeverity?, events: StigTaskReporter? = null) : StigArtifactProblemReporter

LlvmToolChecker

object LlvmToolChecker

Runtime cross-check that every LLVM binary in StigLlvmToolchain is present on PATH and reports the expected LLVM_MAJOR.

ResolvedGeneratedAnalysisTransforms

data class ResolvedGeneratedAnalysisTransforms(val config: BitcodeTransformsConfig, val provisionalSymbols: List<String>)

StigAnalysisEndpoint

data class StigAnalysisEndpoint(val name: String = "", val ret: Boolean? = null, val params: List<Int>? = null, val asil: String? = null)

StigAnalysisInputs

data class StigAnalysisInputs(val schema: String? = null, val entryPoints: List<String>? = null, val sources: List<StigAnalysisEndpoint>? = null, val sinks: List<StigAnalysisEndpoint>? = null)

StigAnalysisWorkspaceLock

abstract class StigAnalysisWorkspaceLock : BuildService<StigAnalysisWorkspaceLock.Parameters> , AutoCloseable

Keeps one consumer checkout's analysis outputs stable across independent Gradle invocations.

StigAnalyzerExecutionCoordinator

abstract class StigAnalyzerExecutionCoordinator : BuildService<StigAnalyzerExecutionCoordinator.Parameters>

Limits concurrent native analyzer processes across activity projects in one Gradle build.

StigBazelExecrootAccessCoordinator

abstract class StigBazelExecrootAccessCoordinator : BuildService<BuildServiceParameters.None>

Build-scoped exclusive-access coordinator for tasks that invoke Bazel or read files through its shared execroot. Despite the BuildService superclass name (a Gradle term, not a runtime daemon), this is one object for the duration of a Gradle build. It serves two roles:

StigDokkaExecutionCoordinator

abstract class StigDokkaExecutionCoordinator : BuildService<BuildServiceParameters.None>

Limits active Dokka generators across projects; each generator may use multiple JVM threads.

StigGitRepositories

object StigGitRepositories

StigGitRepositoryStatus

data class StigGitRepositoryStatus(val repository: File, val entries: List<StigGitStatusEntry>)

StigGitStatusEntry

data class StigGitStatusEntry(val indexStatus: Char, val workTreeStatus: Char, val path: String, val originalPath: String? = null)

StigIcon

data class StigIcon(val semanticName: String, val spriteId: String, val unicode: String, val cssColor: String? = null)

Central STIG icon vocabulary.

StigModelCheckCoordinator

abstract class StigModelCheckCoordinator : BuildService<BuildServiceParameters.None>

Serializes loading and wiring of compiled-model sessions within a Gradle build.

StigModelIconRegistry

object StigModelIconRegistry

Central icon assignment for every executable Highway metamodel object.

StigModelLinks

object StigModelLinks

Model-tree anchors shared by Dokka rendering and finding navigation.

StigSourceActions

object StigSourceActions

Shared resolution and HTML rendering for source actions in Dokka model and report content.

StigSpriteIconValidator

object StigSpriteIconValidator

Build-time round-trip check: every StigSpriteIcon entry must resolve to a <symbol id="..."> in the vendored stig-icons.svg. The vendored sprite is generated from pinned Iconify JSON packages by StigIconSpriteGenerator; if the Kotlin side adds an enum value but no one regenerates the sprite, every diagram using that icon would render an empty box. This validator catches the divergence at task-action time instead.

Functions

buildDemangledToMangledMap

fun buildDemangledToMangledMap(execOperations: ExecOperations, mangledSymbols: Collection<String>, cxxfiltBinary: String = StigLlvmToolchain.CXXFILT): DemangledToMangledResult

Builds a reverse lookup map from demangled C++ names to mangled LLVM symbols.

buildSymbolDisplayNames

fun buildSymbolDisplayNames(execOperations: ExecOperations, symbols: List<String>, cxxfiltBinary: String = StigLlvmToolchain.CXXFILT): Map<String, String>

demangleSymbols

fun demangleSymbols(execOperations: ExecOperations, symbols: List<String>, cxxfiltBinary: String = StigLlvmToolchain.CXXFILT): Map<String, String>

execAndCapture

fun execAndCapture(execOperations: ExecOperations, command: List<String>, workingDir: File? = null): ExecResult

execToFile

fun execToFile(execOperations: ExecOperations, command: List<String>, workingDir: File? = null, outputFile: File): Int

execToFileWithTimeout

fun execToFileWithTimeout(command: List<String>, workingDir: File? = null, outputFile: File, timeoutSeconds: Long, onOutputLine: (String) -> Unit? = null, onProcessStarted: (ProcessHandle) -> Unit? = null): Int

firstNonBlank

fun firstNonBlank(vararg values: String?): String?

generatedTransformIdentity

fun generatedTransformIdentity(entry: GeneratedAnalysisTransformEntry): String

loadGeneratedAnalysisTransforms

fun loadGeneratedAnalysisTransforms(file: File, owner: String): ResolvedGeneratedAnalysisTransforms

loadSourceCodeAnalysisConfigurationManifest

fun loadSourceCodeAnalysisConfigurationManifest(file: File?): SourceCodeAnalysisConfigurationManifest?

normalizeEntryPoints

fun normalizeEntryPoints(raw: List<String>?): List<String>

p3Units

fun SourceCodeAnalysisConfigurationManifest.p3Units(): List<String>

p4Units

fun SourceCodeAnalysisConfigurationManifest.p4Units(): List<String>

parseProblemSeverityThreshold

fun parseProblemSeverityThreshold(raw: String?): ProblemSeverity?

readStigAnalysisInputs

fun readStigAnalysisInputs(file: File): StigAnalysisInputs

resolveExecutable

fun resolveExecutable(raw: String): String

resolveWorkspaceDir

fun resolveWorkspaceDir(projectLayout: ProjectLayout, path: String): File

sanitizeFileStem

fun sanitizeFileStem(raw: String, fallback: String): String

stripReturnType

fun stripReturnType(demangled: String): String

Strips the return type prefix from a demangled C++ function name. e.g. "RetType* ns::Func<T>(Params)" → "ns::Func<T>(Params)".

validateSourceCodeAnalysisConfigurationManifest

fun validateSourceCodeAnalysisConfigurationManifest(manifest: SourceCodeAnalysisConfigurationManifest, file: File? = null)

verifyLlvmToolMajor

fun verifyLlvmToolMajor(execOperations: ExecOperations, tool: String, expectedMajor: String = StigLlvmToolchain.LLVM_MAJOR)

Runs <tool> --version, parses the first line for an LLVM major- version number (e.g. clang version 18.1.8 → "18"), and throws if the parsed major differs from expectedMajor. The defence-in- depth complement to StigLlvmToolchain: even when every task uses the registry, a misconfigured PATH (clang++-18 symlink pointing at clang-22's binary, version-suffix-stripped install, etc.) can let the wrong major sneak in. This function catches that at task- configuration / pre-exec time, before the offending binary actually produces bitcode.

verifyRequiredSymbolsPresent

fun verifyRequiredSymbolsPresent(inputs: SymbolVerifierInputs, execOperations: ExecOperations, logger: Logger, taskName: String, reporter: GradleStigProblemReporter, events: StigTaskReporter? = null): List<UnresolvedApplicationSymbol>

Adapts Gradle process/logging services to the shared symbol-verification engine.

writeMarker

fun RegularFileProperty.writeMarker(entries: Map<String, Any>)

Writes a key-value marker file from a map.

fun RegularFileProperty.writeMarker(vararg entries: Pair<String, Any>)

Writes a key-value marker file for Gradle up-to-date checks.