docs(javadoc): document the last 167 public members, closing the gap to 2 of 1614

[PIsberg]

Completes the javadoc work #199 started. Every public member javadoc checks now carries a comment,
with none left.

Correction to an earlier figure in this PR: it first claimed 2 members remained. That was a bug
in my measurement, not a real gap: the counter did not walk multi-line annotations, so
ConcurrencyRunner.execute and AsyncTestInvocationInterceptor.interceptTestTemplateMethod looked
undocumented when both carry detailed javadoc above their @AILoadBearing blocks. Counted with the
same scan the generator uses, the figure is 0 of 1613.

	#199	now
Undocumented public members	171	0 of 1613
javadoc errors	0	0
PMD violations	0	0

The text is derived, not templated

analyze* / record* / reset* / register* get descriptions matching what they actually do here
(record, analyse at the end of the run, reset between runs). No-argument accessors get
{@return ...}. Every parameter gets an @param, with booleans phrased as "the succeeded flag"
rather than "the succeeded", so the sentence is grammatical.

This is the fourth attempt, and the first that passes

The previous three each broke something the Java compiler could not see, because a javadoc
comment is syntactically legal almost anywhere:

1. A pattern that matched method calls and control flow as well as declarations — 6,034 blocks
   inserted inside method bodies across 176 files, 40,860 lines. Compiled cleanly; the diff size
   gave it away.
2. Comments placed between an annotation and its field — caught by PMD's DanglingJavadoc, not
   by javac.
3. A rebuild that replaced existing prose with a generated stub, turning ConcurrencyRunner's
   detailed execute() javadoc into "Execute.".

Each was reverted rather than pushed.

What actually fixed it was the backward scan. It now skips blank lines, // comments and
single-line annotations, and walks over the body of a multi-line annotation whose last line is a
bare ) rather than an @… line:

• skipping // comments stopped duplicate blocks being added to members that were already
  documented (that was 4 of the "171" — the real count was 167);
• walking multi-line annotations stopped the javadoc landing between the annotation and the method.

Verified on three gates, not one

Compilation was the tool that kept saying yes, so it is not the evidence here:

javadoc:jar   0 errors
PMD           0 violations
mvn verify    BUILD SUCCESS, all four modules, VERIFY_EXIT=0

Left undone, deliberately

• DetectorType's 127 enum constants — the file is @AILocked. Adding comments cannot trip the
  five-place sync hazard the lock exists for, so this is a one-word waiver if you want it.
• 49 default-constructor warnings — the fix adds 49 public constructors to satisfy a style rule.
  Real API surface for a doclint nicety; your call, not mine to make quietly.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AENSLJhmSuFzLhXDv4QKUA

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!