Reqover is an experimental Java developer tool for request-scoped coverage attribution.
New here? The README's contributing section lists good first tasks. The single most useful contribution right now is a report saying "I ran the demo and it didn't work" — see Reporting Issues.
- Issues, pull requests, commit messages, and code comments: English. This keeps the history readable for contributors anywhere.
- User-facing documentation is bilingual. Korean is maintained because Reqover started as a Korean competition entry; English is the primary version.
Questions in Korean are welcome in issues — just include an English summary so others can follow the thread.
Requirements:
- JDK 17 or 21
- Git
Run tests:
./gradlew clean test --no-daemonBuild all artifacts:
./gradlew build --no-daemonGenerate SBOM:
./gradlew cyclonedxBomOn Windows, use .\gradlew.bat instead of ./gradlew.
reqover-core: coverage bucket model, probe runtime, and theCoverageStoreSPIreqover-instrumentation: ASM bytecode instrumentationreqover-agent: Java agent packaging and transformerreqover-spring-mvc: Spring MVC request adapterreqover-spring-webflux: WebFlux request adapterreqover-spring-boot-starter: one-dependency wiring, the opt-in report endpoint, and the shutdown exportreqover-report: aggregation, reverse lookup, impact analysis, diffing, JSON/HTML renderingreqover-cli:render,diff, andimpactover a report written to diskexamples: demo applicationsdocs: planning, architecture, troubleshooting, and competition notesscripts: demo runners, the impact demo, and the SBOM vulnerability check.github/actions/impact: the reusable pull request action
User-facing docs exist as English/Korean pairs. The .md file is English; the
.ko.md file is Korean.
| English | Korean |
|---|---|
README.md |
README.ko.md |
docs/02_architecture.md |
docs/02_architecture.ko.md |
docs/17_integration_guide.md |
docs/17_integration_guide.ko.md |
Updating both languages is appreciated but not required. Change whichever you can, say so in the pull request, and a maintainer will follow up on the other one. An out-of-date translation is worse than a missing one, so please don't guess at a language you aren't comfortable in.
Documents under docs/ without a .ko.md sibling are single-language; those
still Korean-only are marked (Korean) in the README's documentation list, and
translations are welcome.
- Keep changes scoped to the relevant module.
- Update docs when behavior or commands change.
- Update the README when user-facing setup or demo flow changes — see Documentation Layout for which files that means.
- Add tests for coverage attribution, instrumentation, and report changes.
- Do not commit generated build outputs.
- Do not commit
.env, API keys, tokens, local credentials, or private certificates. - New first-party source files (Java, Kotlin build scripts, JavaScript, CSS,
Python, shell, PowerShell) start with the project license header:
Copyright 2026 Reqover contributors. All Rights Reserved., the Apache-2.0 notice, andSPDX-License-Identifier: Apache-2.0. Copy it from any existing file of the same type; scripts keep their shebang on the first line. Do not add or change headers in third-party files (the Gradle wrapper, the vendored icons and theirLICENSE,third-party-licenses/).
Changes reach main through a pull request. CI runs the full test suite on
JDK 17 and 21 plus an OSV dependency scan, and those checks must pass.
Fork the repository, branch, and open the PR against main. If you are planning
a large change, open an issue first — work thrown away because the direction
didn't match is the worst outcome for everyone.
./gradlew testpasses../gradlew buildpasses.- New behavior is documented.
- License or dependency changes are reflected in
THIRD_PARTY_NOTICES.md. - New source files carry the Apache-2.0 license header.
- No secrets are included.
For a documentation-only change, say so and skip the build boxes rather than ticking something you did not run — CI verifies it on the PR anyway.
When reporting a bug, include:
- OS and JDK version (
java -version) - Spring Boot version, and whether the application is MVC or WebFlux
- the full command used, including the entire
-javaagent:option - any line starting with
[reqover]from standard error — the agent reports configuration problems there, and it is usually the fastest way to find the cause - expected behavior
- actual behavior
- minimal reproduction steps
- relevant logs
If the demo itself failed, the demo reproduction issue template collects these for you.
Getting stuck because the documentation was unclear counts as a bug. Please report that too.