AprismJDK

AJR — Aprism Java Runtime is an open-source, cross-platform OpenJDK variant designed bottom-up around the Aprism loader ecosystem: a bundled AprismateAgent (JavaAgent-like, low-level), opened and stable JVM interfaces, performance/hardware-fusion APIs, cross-language bridges (Cpp2Java / Rust2Java) on the Foreign Function & Memory API, and extreme cross-Java-version compatibility.

Status

v26.2 GA — first stable JDK variant release. This release delivers:

• Real OpenJDK fork — OpenJDK 25 (jdk-25+10) built natively on Windows via Cygwin, branded AprismJDK / AJR end to end
• jdk.aprismate module — 21 exported packages compiled INTO the image; capability descriptor wired (isAprismJdk=true in-image)
• AprismateAgent embedded — lib/aprismate.jar in every image; -javaagent:$JAVA_HOME/lib/aprismate.jar and the auto-load flag -XX:+AprismateAgent both work out of the box; self-contained jar attaches to STOCK JDKs with full premain functionality
• Fail-safe contract — agent failures roll back and never abort the host JVM
• invoke framework — MethodHandle-tier reflection elimination in the module (jdk.aprismate.invoke)
• Reproducible patch series — 4 reversible patches + overlay sync, canonical scripts/configure-fork.sh
• Compat sweep — repeatable 8-check matrix green (KI-2 documented)
• Packaging — zip/tar.gz + SHA256SUMS + provenance; tag-triggered CI with cosign keyless signing

See ROADMAP pointer and the v26.2 GA measured matrix in docs/en/12-compatibility-matrix.md.

Historical: v26.0/v26.1 lines delivered the Java-layer API surface under mixed version tags (audit trail in FACT.md Sessions 9-11).

See ROADMAP.md for the complete v26.0-v26.1 development plan.

Documentation

All documentation follows bilingual approach (EN canonical + ZH mirror):

• docs/01-architecture.md — Positioning, architecture, relationship to Aprism, roadmap
• docs/02-aprismate-agent.md — AprismateAgent entry points, capabilities, fail-safe contract
• docs/03-opened-interfaces.md — The jdk.aprismate stable API module
• docs/06-compatibility-matrix.md — Cross-Java-version compatibility and fallback behavior
• docs/ROADMAP.md — Complete v26.0-v26.1 development roadmap (20 releases)

Planned for v26.0-Alpha.3+:

• docs/04-perf-hardware.md — Performance & hardware-fusion APIs
• docs/05-cross-language.md — Cpp2Java / Rust2Java bridge design

Quick Start

# Clone repository
git clone https://github.com/AprismLab/AprismJDK.git
cd AprismJDK

# Build all modules
./gradlew build

# Run tests
./gradlew test

Note: This release builds API stubs only. Full JDK/JRE distributions will be available starting v26.0-Alpha.5.

Project Structure

AprismJDK/
├── aprismate-api/          # jdk.aprismate module (VmInfo, Agent API)
├── aprismate-agent/        # AprismateAgent implementation (skeleton)
├── aprismate-tests/        # Integration tests
├── docs/                   # Documentation (EN + ZH)
│   ├── en/                 # English documentation
│   └── zh/                 # Chinese documentation (mirrors)
└── .github/workflows/      # CI/CD automation

Supported Java Versions

AprismJDK v26.x targets three Java LTS lines:

Java Version	Status	Capabilities
Java 25	Primary target	Full feature set
Java 21	Secondary target	Full (backported)
Java 17	Maintenance	Subset (FFM limitations)

See docs/06-compatibility-matrix.md for detailed compatibility information.

Governance

AprismJDK follows the Aprism main-project management and version-control convention:

• Signed commits/tags — All commits and tags must be signed (SSH ED25519)
• Version scheme — v<MAJOR>.<MINOR>[-Alpha.<N>] (e.g., v26.0-Alpha.1, v26.0)
• Release cadence — Each minor line has Alpha.1-9, then GA
• Bilingual docs — EN (canonical) + ZH (mirror)
• Session log — FACT.md tracks decisions and progress

See Aprism/docs/en/10-project-management-and-version-control.md for complete governance model.

Development Roadmap

v26.0 Line (Foundation):

• Alpha.1: Project skeleton, API stubs, documentation
• Alpha.2-4: Gradle build system, dependency management
• Alpha.5: OpenJDK source fork, basic JDK build
• Alpha.6: JDK/JRE packaging and distribution
• Alpha.7: Agent attachment infrastructure
• Alpha.8-9: Testing infrastructure, CI/CD hardening
• GA: Stable foundation release

v26.1 Line (Capabilities):

• Alpha.1: Agent logging and instrumentation integration
• Alpha.2: ClassRedefiner+ implementation
• Alpha.3: ClassRedefiner+ testing and hardening
• Alpha.4: MethodHookRegistry+ implementation
• Alpha.5: BytecodeTransformer implementation
• Alpha.6: ThreadInsight + HeapInsight
• Alpha.7: JitInsight + performance tuning
• Alpha.8-9: Real-world testing (Minecraft integration)
• GA: Full-featured stable release

See docs/ROADMAP.md for detailed milestone planning.

Contributing

AprismJDK is part of the Aprism ecosystem. Contributions follow the same process as the main Aprism project:

1. Fork and branch — Create a feature branch from main
2. Sign commits — All commits must be signed
3. Test coverage — Include tests for new functionality
4. Documentation — Update both EN and ZH docs
5. Pull request — Submit PR against main branch

Community

• Issues — Report bugs and request features via GitHub Issues
• Discussions — Technical discussions on GitHub Discussions
• Main project — AprismLab/Aprism

License

GPL-2.0 (see LICENSE). OpenJDK upstream is GPL-2.0 with the Classpath Exception; AprismJDK tracks upstream LTS lines (currently OpenJDK 25).