ApplyTagsCommand.java

package org.egothor.methodatlas.command;

import java.io.IOException;

import java.io.PrintWriter;

import java.nio.file.Path;

import java.nio.file.Paths;

import java.util.LinkedHashMap;

import java.util.List;

import java.util.Map;

import java.util.logging.Level;

import java.util.logging.Logger;

import java.util.stream.Collectors;

import org.egothor.methodatlas.AiResultCache;

import org.egothor.methodatlas.emit.ClassificationOverride;

import org.egothor.methodatlas.CliConfig;

import org.egothor.methodatlas.ai.AiSuggestionEngine;

import org.egothor.methodatlas.api.DiscoveredMethod;

import org.egothor.methodatlas.api.SourcePatcher;

import org.egothor.methodatlas.api.TestDiscovery;

import org.egothor.methodatlas.api.TestDiscoveryConfig;

/**

 * CLI command handler for the {@code -apply-tags} mode.

 *

 * <p>

 * Discovers test methods via the configured {@link TestDiscovery} providers,

 * resolves AI suggestions for each class, and delegates the actual source file

 * write-back to the matching {@link SourcePatcher} implementation. A summary

 * line is written to the supplied writer on completion.

 * </p>

 *

 * <h2>Languages supported for write-back</h2>

 * <p>

 * Source write-back is only available for languages whose discovery plugin

 * ships a {@link SourcePatcher} implementation. At the time of writing this

 * is <strong>Java</strong> (JUnit&nbsp;5 / 4 / TestNG) and

 * <strong>C#</strong> (xUnit / NUnit / MSTest). Files discovered by any other

 * plugin (TypeScript, Go, Python, PowerShell, SAP ABAP, COBOL, …) are

 * recognised but skipped during write-back; the command prints a per-file

 * notice and an aggregate skip count in the summary line. Skipped files do

 * not cause a non-zero exit code on their own.

 * </p>

 *

 * @see ApplyTagsFromCsvCommand

 * @see org.egothor.methodatlas.api.SourcePatcher

 */

@SuppressWarnings("PMD.AvoidInstantiatingObjectsInLoops")

public final class ApplyTagsCommand implements Command {

    private final CliConfig cliConfig;

    private final TestDiscoveryConfig discoveryConfig;

    private final AiSuggestionEngine aiEngine;

    private final ClassificationOverride override;

    private final AiResultCache aiCache;

    private final PluginLoader pluginLoader;

    private final ScanOrchestrator scanOrchestrator;

    /**

     * Creates a new apply-tags command.

     *

     * @param cliConfig         full parsed CLI configuration

     * @param discoveryConfig   discovery configuration forwarded to providers

     * @param aiEngine          AI engine providing suggestions; {@code null}

     *                          when AI is disabled

     * @param override          human classification overrides

     * @param aiCache           AI result cache

     * @param pluginLoader      loader used to resolve {@link TestDiscovery}

     *                          and {@link SourcePatcher} plugins

     * @param scanOrchestrator  orchestrator providing

     *                          {@code collectMethodsByFile} and

     *                          {@code gatherAiSuggestionsForFile} helpers

     */

    public ApplyTagsCommand(CliConfig cliConfig, TestDiscoveryConfig discoveryConfig,

            AiSuggestionEngine aiEngine, ClassificationOverride override,

            AiResultCache aiCache, PluginLoader pluginLoader,

    /**

     * Discovers test methods, gathers AI suggestions, and patches source files.

     *

     * @param out writer for the completion summary line

     * @return {@code 0} if all files were processed successfully, {@code 1}

     *         if any file produced a parse or processing error

     * @throws IOException if traversing a file tree fails

     */

    @Override

    public int execute(PrintWriter out) throws IOException {

        // Initializers are omitted: both variables are assigned unconditionally in the

        // try block, which satisfies JLS §16.2.15 definite-assignment for try-finally

        // without a catch clause.

        Map<Path, List<DiscoveredMethod>> byFile;

        boolean hadErrors;

        try {

        } finally {

        // Fail-closed: with -redact-comments, abort before the first provider call or file

        // write if any file that would reach the AI provider cannot be redacted.

                            "Skipping {0}: no SourcePatcher available for this language",

                            sourceFile);

                }

                        + " — source write-back is not supported for this language "

                        + "(currently Java and C# only)");

            }

                try {

                    }

                    }

            }

        // Capacity 192 comfortably covers the worst-case message:

        //   "Apply-tags complete: <int> annotation(s) added to <int> file(s);

        //    <int> file(s) skipped (no source write-back support for the language)"

        // which is ~140 chars including the integer placeholders.

        }

    }

}

Mutations

2.2
Location : execute
Killed by : none removed conditional - replaced equality check with false → SURVIVED Covering tests

1.1
Location : lambda$execute$1
Killed by : none replaced boolean return with true for org/egothor/methodatlas/command/ApplyTagsCommand::lambda$execute$1 → SURVIVED Covering tests

2.2
Location : lambda$execute$1
Killed by : none replaced boolean return with false for org/egothor/methodatlas/command/ApplyTagsCommand::lambda$execute$1 → SURVIVED Covering tests

3.3
Location : lambda$execute$0
Killed by : none replaced boolean return with false for org/egothor/methodatlas/command/ApplyTagsCommand::lambda$execute$0 → SURVIVED Covering tests

4.4
Location : lambda$execute$0
Killed by : none replaced boolean return with true for org/egothor/methodatlas/command/ApplyTagsCommand::lambda$execute$0 → SURVIVED Covering tests

1.1
Location : execute
Killed by : none removed conditional - replaced equality check with false → SURVIVED Covering tests

2.2
Location : execute
Killed by : org.egothor.methodatlas.MethodAtlasAppApplyTagsTest.[engine:junit-jupiter]/[class:org.egothor.methodatlas.MethodAtlasAppApplyTagsTest]/[method:applyTags_addsTagImport(java.nio.file.Path)] removed conditional - replaced equality check with true → KILLED

3.3
Location : execute
Killed by : org.egothor.methodatlas.MethodAtlasAppApplyTagsTest.[engine:junit-jupiter]/[class:org.egothor.methodatlas.MethodAtlasAppApplyTagsTest]/[method:applyTags_addsDisplayNameImport(java.nio.file.Path)] removed conditional - replaced equality check with false → KILLED

4.4
Location : execute
Killed by : none removed conditional - replaced equality check with true → SURVIVED Covering tests

2.2
Location : execute
Killed by : none changed conditional boundary → SURVIVED Covering tests

3.3
Location : execute
Killed by : none removed conditional - replaced comparison check with true → SURVIVED Covering tests

1.1
Location : execute
Killed by : none Replaced integer addition with subtraction → SURVIVED Covering tests

2.2
Location : execute
Killed by : none removed conditional - replaced equality check with false → SURVIVED Covering tests