mvnlog: build log viewer, integration tests, script routing

[gnodet]

Summary

Part 5 of the logging feature chain. Depends on #12698 (warning mode).

Adds the mvnlog tool — a CLI viewer for build-report JSON files — plus integration tests for the entire feature set and script routing.

mvnlog viewer

• mvnlog / mvnlog --json — view the latest build report as human-readable or raw JSON
• BuildReportRenderer — renders reports with ANSI colors, timing, failure details
• SimpleJsonReader — dependency-free streaming JSON parser
• LogInvoker / LogParser / LogContext — invoker chain for the tool
• CommonsCliLogOptions / LogOptions — CLI option parsing
• MavenLogCling — entry point class

Script routing

• mvn --log routes to MavenLogCling (both mvn and mvn.cmd)
• Script argument stripping prevents --log from colliding with --log-file prefix matching
• mvnlog / mvnlog.cmd shell scripts for direct invocation
• component.xml updated to include mvnlog in the distribution

Integration tests

• MavenITgh12571BuildReportTest — 8 IT tests covering build report JSON, console modes (plain/machine/verbose), warning mode, version info on failure, and mvnlog viewer
• 11 existing ITs updated with --console=verbose to preserve expected output format
• IT test resources (single module + multi-module project POMs)

Files changed (36 files, ~2500 insertions)

Area	Files
API	Tools.java, LogOptions, ParserRequest
Entry point	MavenLogCling
Invoker	LogInvoker, LogParser, LogContext, CommonsCliLogOptions
Renderer	BuildReportRenderer, SimpleJsonReader
Shell	BuiltinShellCommandRegistryFactory (mvnlog command)
Scripts	mvn, mvn.cmd, mvnlog, mvnlog.cmd, component.xml
CLI	CommonsCliOptions (+--log constant/option)
Tests	BuildReportRendererTest, SimpleJsonReaderTest
ITs	MavenITgh12571BuildReportTest + 11 existing ITs + 4 resource POMs

PR chain

#	PR	Feature
1	#12694	Logging foundation
2	#12695	Build report
3	#12697	Console modes
4	#12698	Warning mode + diagnostics
5	This PR	mvnlog viewer
6	#12702	Structured problems pipeline
7	#12714	TRACE level migration

Test plan

• mvn compile — clean compile
• mvn test -pl impl/maven-cli — all tests pass
• CI validation

🤖 Generated with Claude Code

[gnodet]

Well-structured mvnlog tool that follows established Maven tool patterns. Two minor polish items noted after verification (three other findings about shell script flag stripping and JSON parser depth were false positives).

Also noted:

• The zero-dependency JSON reader/writer approach is sound — no JSON library exists in maven-cli's dependency tree.
• The 11 existing IT modifications adding --console=verbose are necessary for the new console mode system.
• Strong test coverage with 12 integration test cases.

This review was generated by an AI agent and may contain inaccuracies. Please verify all suggestions before applying.

Claude Code on behalf of gnodet

[gnodet]

The tab-completer only offers --diagnostics, --failures, --full, --list but is missing 5 of the 9 supported options: --json, --module, --mojo, --level, --grep. This reduces discoverability in mvnsh.

Suggested change

	private List<Completer> mvnlogCompleter(String name) {
	private List<Completer> mvnlogCompleter(String name) {
	return List.of(new ArgumentCompleter(new StringsCompleter(
	"--diagnostics", "--failures", "--full", "--list", "--json",
	"--module", "--mojo", "--level", "--grep")));