Issue #126 Simplify JsonPath docs and use mvnw

Promote json-java21-jsonpath docs to README.md and keep it focused on public usage (Goessner spec + basic examples). Update human READMEs to use ./mvnw (with -am when selecting modules) and add a top-level JsonPath pointer.\n\nVerify: ./mvnw test -pl json-java21-jsonpath -am -Djava.util.logging.ConsoleHandler.level=INFO

Author: simbo1905

README.md

@@ -20,7 +20,7 @@ We welcome contributions to the JTD Validator incubating within this repo.
 To try the examples from this README, build the project and run the standalone example class:
 
 ```bash
-mvn package
+./mvnw package
 java -cp ./json-java21/target/java.util.json-*.jar:./json-java21/target/test-classes \
   jdk.sandbox.java.util.json.examples.ReadmeExamples
 ```
@@ -257,10 +257,10 @@ The test data is bundled as ZIP files and extracted automatically at runtime:
 
 ```bash
 # Run human-readable report
-mvn exec:java -pl json-compatibility-suite
+./mvnw exec:java -pl json-compatibility-suite
 
 # Run JSON output (dogfoods the API)
-mvn exec:java -pl json-compatibility-suite -Dexec.args="--json"
+./mvnw exec:java -pl json-compatibility-suite -Dexec.args="--json"
 ```
 
 
@@ -368,10 +368,10 @@ The validator provides full RFC 8927 compliance with comprehensive test coverage
 
 ```bash
 # Run all JTD compliance tests
-$(command -v mvnd || command -v mvn || command -v ./mvnw) test -pl json-java21-jtd -Dtest=JtdSpecIT
+./mvnw test -pl json-java21-jtd -Dtest=JtdSpecIT
 
 # Run with detailed logging
-$(command -v mvnd || command -v mvn || command -v ./mvnw) test -pl json-java21-jtd -Djava.util.logging.ConsoleHandler.level=FINE
+./mvnw test -pl json-java21-jtd -Djava.util.logging.ConsoleHandler.level=FINE
 ```
 
 Features:
@@ -388,7 +388,24 @@ Features:
 Requires JDK 21 or later. Build with Maven:
 
 ```bash
-mvn clean package
+./mvnw clean package
+```
+
+## JsonPath
+
+This repo also includes a JsonPath query engine (module `json-java21-jsonpath`), based on the original Goessner JSONPath article:
+https://goessner.net/articles/JsonPath/
+
+```java
+import jdk.sandbox.java.util.json.*;
+import json.java21.jsonpath.JsonPath;
+
+JsonValue doc = Json.parse("""
+  {"store": {"book": [{"author": "A"}, {"author": "B"}]}}
+  """);
+
+JsonPath path = JsonPath.parse("$.store.book[*].author");
+var authors = path.query(doc);
 ```
 
 See AGENTS.md for detailed guidance including logging configuration. 

json-java21-jsonpath/ARCHITECTURE.md

@@ -0,0 +1,52 @@
+# JsonPath
+
+This module provides a JSONPath-style query engine for JSON documents parsed with `jdk.sandbox.java.util.json`.
+
+It is based on the original Stefan Goessner JSONPath article:
+https://goessner.net/articles/JsonPath/
+
+## Usage
+
+Parse JSON once with `Json.parse(...)`, compile the JsonPath once with `JsonPath.parse(...)`, then query multiple documents:
+
+```java
+import jdk.sandbox.java.util.json.*;
+import json.java21.jsonpath.JsonPath;
+
+JsonValue doc = Json.parse("""
+  {"store": {"book": [{"author": "A"}, {"author": "B"}]}}
+  """);
+
+JsonPath path = JsonPath.parse("$.store.book[*].author");
+var authors = path.query(doc);
+
+// If you want a static call site:
+var sameAuthors = JsonPath.query(path, doc);
+```
+
+Notes:
+- Prefer `JsonPath.parse(String)` + `query(JsonValue)` to avoid repeatedly parsing the same path.
+- `JsonPath.query(String, JsonValue)` is intended for one-off usage.
+
+## Supported Syntax
+
+This implementation follows Goessner-style JSONPath operators, including:
+- `$` root
+- `.name` / `['name']` property access
+- `[n]` array index (including negative indices)
+- `[start:end:step]` slices
+- `*` wildcards
+- `..` recursive descent
+- `[n,m]` and `['a','b']` unions
+- `[?(@.prop)]` and `[?(@.prop op value)]` basic filters
+- `[(@.length-1)]` limited script support
+
+## Testing
+
+```bash
+./mvnw test -pl json-java21-jsonpath -am -Djava.util.logging.ConsoleHandler.level=INFO
+```
+
+```bash
+./mvnw test -pl json-java21-jsonpath -am -Dtest=JsonPathGoessnerTest -Djava.util.logging.ConsoleHandler.level=FINE
+```

json-java21-jsonpath/README.md

@@ -174,16 +174,16 @@ Validation errors include standardized information:
 
 ```bash
 # Build the module
-$(command -v mvnd || command -v mvn || command -v ./mvnw) compile -pl json-java21-jtd
+./mvnw compile -pl json-java21-jtd -am
 
 # Run tests
-$(command -v mvnd || command -v mvn || command -v ./mvnw) test -pl json-java21-jtd
+./mvnw test -pl json-java21-jtd -am
 
 # Run RFC compliance tests
-$(command -v mvnd || command -v mvn || command -v ./mvnw) test -pl json-java21-jtd -Dtest=JtdSpecIT
+./mvnw test -pl json-java21-jtd -am -Dtest=JtdSpecIT
 
 # Run with detailed logging
-$(command -v mvnd || command -v mvn || command -v ./mvnw) test -pl json-java21-jtd -Djava.util.logging.ConsoleHandler.level=FINE
+./mvnw test -pl json-java21-jtd -am -Djava.util.logging.ConsoleHandler.level=FINE
 ```
 
 ## Architecture
@@ -217,4 +217,4 @@ This implementation is fully compliant with RFC 8927:
 
 ## License
 
-This project is part of the OpenJDK JSON API implementation and follows the same licensing terms.
+This project is part of the OpenJDK JSON API implementation and follows the same licensing terms.