Package org.egothor.methodatlas

package org.egothor.methodatlas
Provides the core command-line utility for analyzing Java test sources and producing structured metadata about JUnit test methods.

The central component of this package is MethodAtlasApp, a command-line application that scans Java source trees, identifies JUnit Jupiter test methods, and emits per-method metadata describing the discovered tests.

Overview

The application traverses one or more directory roots and discovers test methods via pluggable TestDiscovery providers. The default JVM provider uses JavaParser internally; file selection follows the conventional *Test.java pattern.

For each detected test method the application reports:

  • fully-qualified class name (FQCN)
  • test method name
  • method size measured in lines of code (LOC)
  • JUnit @Tag annotations declared on the method
  • text of any @DisplayName annotation declared on the method

The resulting dataset can be used for test inventory generation, quality metrics, governance reporting, or security analysis of test coverage.

AI-Based Security Tagging

When enabled via command-line options, the application can augment the extracted test metadata with security classification suggestions produced by an AI provider. The AI integration is implemented through the AiSuggestionEngine abstraction located in the org.egothor.methodatlas.ai package.

In this mode the application sends each discovered test class to the configured AI provider and receives suggested security annotations, such as:

  • whether the test validates a security property
  • suggested @DisplayName describing the security intent
  • taxonomy-based security tags
  • optional explanatory reasoning

These suggestions are merged with the source-derived metadata and emitted alongside the standard output fields.

Output Formats

The application supports two output modes:

  • CSV (default) 
    fqcn,method,loc,tags,display_name
    or, when AI enrichment is enabled: 
    fqcn,method,loc,tags,display_name,ai_security_relevant,ai_display_name,ai_tags,ai_reason,ai_interaction_score
  • Plain text, enabled using the -plain command-line option

Typical Usage


 java -jar methodatlas.jar /path/to/project
 
 

 java -jar methodatlas.jar -plain /path/to/project

The command scans the specified source directory recursively and emits one output record per detected test method.

Implementation Notes

  • Test method discovery is performed by pluggable TestDiscovery providers loaded via ServiceLoader; the JVM provider ships in the methodatlas-discovery-jvm module.
  • Source file write-back is performed by pluggable SourcePatcher providers, also loaded via ServiceLoader.
  • Test detection in the JVM provider is based on JUnit Jupiter annotations such as @Test, @ParameterizedTest, @RepeatedTest, @TestFactory, and @TestTemplate.

Sub-packages

  • org.egothor.methodatlas.api — platform-neutral SPI contracts: TestDiscovery, SourcePatcher, DiscoveredMethod, ScanRecord
  • org.egothor.methodatlas.discovery.jvm — Java/JVM test discovery implementation (shipped in the methodatlas-discovery-jvm module): JavaTestDiscovery, JavaSourcePatcher
  • org.egothor.methodatlas.discovery.dotnet — C#/.NET test discovery implementation (shipped in the methodatlas-discovery-dotnet module): DotNetTestDiscovery, DotNetSourcePatcher
  • org.egothor.methodatlas.emit — output emitters: OutputEmitter, SarifEmitter, GitHubAnnotationsEmitter, DeltaEmitter
  • org.egothor.methodatlas.ai — AI suggestion engine and provider integrations
  • org.egothor.methodatlas.command — CLI command handler implementations: one class per CLI mode (ScanCommand, SarifCommand, DiffCommand, ApplyTagsCommand, ApplyTagsFromCsvCommand, GitHubAnnotationsCommand, ManualPrepareCommand), plus shared infrastructure in CommandSupport
See Also:
  • Class
    Description
    AiResultCache
    In-memory cache of AI classification results loaded from a previous MethodAtlas scan output.
    ApplyTagsFromCsvEngine
    Engine that applies annotation changes to source files driven by a reviewed MethodAtlas CSV export.
    ClassificationOverride
    Applies human-authored classification overrides to AI-generated (or absent) security classification results.
    ClassificationOverride.Entry
    A single override entry as stored in the in-memory index.
    CliConfig
    Parsed command-line configuration used to drive a single application run.
    DeltaEntry
    A single change entry in a MethodAtlas delta report.
    DeltaEntry.ChangeType
    The type of change represented by a DeltaEntry.
    DeltaReport
    Computes the difference between two MethodAtlas scan outputs.
    DeltaReport.DeltaResult
    The aggregate result of comparing two MethodAtlas scan outputs.
    ManualMode
    Selects between the two phases of the manual AI workflow.
    ManualMode.Consume
    Consume phase: read operator-saved response files and emit enriched CSV.
    ManualMode.Prepare
    Prepare phase: scan source files and write AI prompt work files and empty response stubs.
    MethodAtlasApp
    Command-line application for scanning Java test sources, extracting JUnit test metadata, and optionally enriching the emitted results with AI-generated security tagging suggestions.
    OutputMode
    Output formats supported by the MethodAtlas application.
    TagAiDrift
    Describes the agreement between a source-level @Tag("security") annotation and the AI classification of the same test method.
    TestMethodSink
    Consumer that receives a single discovered test method record.