pure-documentation sweep

[peter-lawrey]

This PR is a pure-documentation sweep of the Java-Runtime-Compiler project.
It does not change runtime behaviour or public APIs; instead it:

• formalises contributor guidance for both humans & AI agents;
• publishes a full, traceable requirements catalogue;
• lifts README quality from “quick demo” to fully-fledged user guide;
• fills the biggest Javadoc holes in the public surface;
• annotates tutorial source so examples read cleanly in generated docs;
• freshens copyright headers and trims the over-long LICENSE file.

---

✨ Key additions

• AGENTS.md – house rules for LLM contributors, Javadoc dos & don’ts, commit etiquette, nine-box tagging.
• src/main/adoc/project-requirements.adoc – functional, non-functional & compliance requirements with stable IDs (JRC-…).
• Expanded README.adoc – quick-start, install flags, feature table, operational notes, FAQ; copy-paste friendly blocks.

---

🛠️ Code-level documentation

Area	What changed
Public core	Full Javadoc for CompilerUtils, CachedCompiler, MyJavaFileManager, JavaSourceFromString, CloseableByteArrayOutputStream.
Examples / tests	Brief, meaningful comments for Bar, Foo, Tee, TeeImpl, FooBarTee, plus tokenised date placeholder.
SuppressWarnings clarifications	Inline rationales where reflective or Unsafe hacks are required.

---

🧹 House-keeping

• Re-license headers to “2014-2025 chronicle.software” across source & POM.
• Shrunk LICENSE.adoc to the canonical Apache-2.0 text (external component notices remain in source bundles).
• Replaced {latest} placeholders with “look up on Maven Central” to nudge users toward correct versioning.

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud