import org.gradle.api.Incubating;

import javax.annotation.Nullable;

/**
 * Represents a contextual label.
 *
 * @since 8.9
 */
@Incubating
public interface ContextualLabel {

    /**
     * Returns the contextual description of a problem.
     *
     * @return the contextual label
     * @since 8.9
     */
    @Nullable
    String getContextualLabel();

import org.gradle.api.NonNullApi;
import org.gradle.tooling.events.problems.ContextualLabel;

import javax.annotation.Nullable;

@NonNullApi
public class DefaultContextualLabel implements ContextualLabel {

    private final String contextualLabel;

    public DefaultContextualLabel(@Nullable String contextualLabel) {
        this.contextualLabel = contextualLabel;
    }

    @Override
    public String getContextualLabel() {

public class DefaultContextualLabel implements InternalContextualLabel, Serializable {

    private final String contextualLabel;

    public DefaultContextualLabel(String contextualLabel) {
        this.contextualLabel = contextualLabel;
    }

    @Override
    public String getContextualLabel() {
        return contextualLabel;
    }

import java.util.List;

@NonNullApi
public class DefaultSingleProblemEvent extends BaseProgressEvent implements SingleProblemEvent {
    private final ProblemDefinition problemDefinition;
    private final ContextualLabel contextualLabel;
    private final Details details;
    private final List<Location> locations;
    private final List<Solution> solutions;
    private final AdditionalData additionalData;

                                                @Nullable InternalContextualLabel contextualLabel
    ) {
        this.additionalData = additionalData;
        this.details = details;
        this.locations = locations;
        this.solutions = solutions;
        this.failure = failure;
        this.contextualLabel = contextualLabel;
    }

    @Override
    public InternalAdditionalData getAdditionalData() {

            withProblemsWithStackTraceCount(1)
        }

        and:
        verifyAll(receivedProblem(0)) {
            fqid == REGISTRATION_UNSUPPORTED
            contextualLabel == "registration of listener on 'Gradle.buildFinished' is unsupported"
            definition.severity == Severity.WARNING
            definition.documentationLink != null
            locations.size() == 2

val problems = gradleInternal.services.get(Problems::class.java)

problems.forNamespace("buildscript").reporting {
    id("adhoc-script-deprecation", "Deprecated script plugin")
        .contextualLabel("Deprecated script plugin 'demo-script-plugin'")
        .severity(Severity.WARNING)
        .solution("Please use 'standard-plugin-2' instead of this plugin")
}

tasks {
    val warningTask by registering {

        ])

        and:
        if (isProblemsApiCheckEnabled()) {
            verifyAll(receivedProblem(0)) {
                fqid == 'validation:property-validation:missing-annotation'
                contextualLabel == 'Type \'MyTask\' property \'badTime\' is missing an input or output annotation'
                details == 'A property without annotation isn\'t considered during up-to-date checking'
                solutions == [

    private final String contextualLabel;
    private final List<String> solutions;
    private final List<ProblemLocation> problemLocations;
    private final String details;
    private final RuntimeException exception;
    private final AdditionalData additionalData;

    protected DefaultProblem(
        ProblemDefinition problemDefinition,
        @Nullable String contextualLabel,
        List<String> solutions,

        and:
        verifyAll(receivedProblem) {
            fqid == 'validation:property-validation:missing-annotation'
            contextualLabel == 'Type \'MyTask\' property \'tree.nonAnnotated\' is missing an input or output annotation'
            details == 'A property without annotation isn\'t considered during up-to-date checking'
            solutions == [