docs: update schema compatibility metrics (strict headline + overall); align README test commands with wrapper; include updated schema engine changes for remote refs, logging, and compile session

Author: simbo1905

README.md

@@ -104,27 +104,28 @@ var result = schema.validate(
 // result.valid() => true
 ```
 
-Compatibility: runs the official 2020‑12 JSON Schema Test Suite on `verify`; **measured compatibility is 64.6%** (1,177 of 1,822 tests pass) with comprehensive metrics reporting.
+Compatibility: runs the official 2020‑12 JSON Schema Test Suite on `verify`; **strict compatibility is 61.6%** (1024 of 1,663 validations). [Overall including all discovered tests: 56.2% (1024 of 1,822)].
 
 ### JSON Schema Test Suite Metrics
 
 The validator now provides defensible compatibility statistics:
 
 ```bash
 # Run with console metrics (default)
-mvn verify -pl json-java21-schema
+./mvn-test-no-boilerplate.sh -pl json-java21-schema
 
-# Export detailed JSON metrics  
-mvn verify -pl json-java21-schema -Djson.schema.metrics=json
+# Export detailed JSON metrics
+./mvn-test-no-boilerplate.sh -pl json-java21-schema -Djson.schema.metrics=json
 
 # Export CSV metrics for analysis
-mvn verify -pl json-java21-schema -Djson.schema.metrics=csv
+./mvn-test-no-boilerplate.sh -pl json-java21-schema -Djson.schema.metrics=csv
 ```
 
 **Current measured compatibility**:
-- **Overall**: 64.6% (1,177 of 1,822 tests pass)
-- **Test coverage**: 420 test groups, 1,657 validation attempts
-- **Skip breakdown**: 70 unsupported schema groups, 2 test exceptions, 480 lenient mismatches
+- **Strict (headline)**: 61.6% (1024 of 1,663 validations)
+- **Overall (incl. out‑of‑scope)**: 56.2% (1024 of 1,822 discovered tests)
+- **Test coverage**: 420 test groups, 1,663 validation attempts
+- **Skip breakdown**: 65 unsupported schema groups, 0 test exceptions, 647 lenient mismatches
 
 ## Building
 

json-java21-schema/README.md

@@ -23,19 +23,20 @@ Compatibility and verify
 
 - The module runs the official JSON Schema Test Suite during Maven verify.
 - Default mode is lenient: unsupported groups/tests are skipped to avoid build breaks while still logging.
-- Strict mode: enable with -Djson.schema.strict=true to enforce full assertions.
-- **Measured compatibility**: 54.4% (992 of 1,822 tests pass in lenient mode)
-- **Test coverage**: 420 test groups, 1,628 validation attempts, 73 unsupported schema groups, 0 test exceptions, 638 lenient mismatches
+- Strict mode: enable with `-Djson.schema.strict=true` to enforce full assertions.
+- Measured compatibility (headline strictness): 61.6% (1024 of 1,663 validations)
+  - Overall including all discovered tests: 56.2% (1024 of 1,822)
+- Test coverage: 420 test groups, 1,663 validation attempts, 65 unsupported schema groups, 0 test exceptions, 647 lenient mismatches
 - Detailed metrics available via `-Djson.schema.metrics=json|csv`
 
 How to run
 
 ```bash
 # Run unit + integration tests (includes official suite)
-mvn -pl json-java21-schema -am verify
+./mvn-test-no-boilerplate.sh -pl json-java21-schema
 
 # Strict mode
-mvn -Djson.schema.strict=true -pl json-java21-schema -am verify
+./mvn-test-no-boilerplate.sh -pl json-java21-schema -Djson.schema.strict=true
 ```
 
 OpenRPC validation

json-java21-schema/src/main/java/io/github/simbo1905/json/schema/JsonSchema.java

@@ -95,7 +95,7 @@ enum Nothing implements JsonSchema {
 
     @Override
     public ValidationResult validateAt(String path, JsonValue json, Deque<ValidationFrame> stack) {
-      LOG.severe(() -> "ERROR: Nothing enum validateAt called - this should never happen");
+      LOG.severe(() -> "ERROR: SCHEMA: Nothing.validateAt invoked");
       throw new UnsupportedOperationException("Nothing enum should not be used for validation");
     }
   }
@@ -158,7 +158,7 @@ interface RemoteFetcher {
 
     static RemoteFetcher disallowed() {
       return (uri, policy) -> {
-        LOG.severe(() -> "ERROR: Remote fetching disabled but requested for URI: " + uri);
+        LOG.severe(() -> "ERROR: FETCH: " + uri + " - policy POLICY_DENIED");
         throw new RemoteResolutionException(
             Objects.requireNonNull(uri, "uri"),
             RemoteResolutionException.Reason.POLICY_DENIED,
@@ -316,7 +316,7 @@ static JsonSchema compile(JsonValue schemaJson, Options options, CompileOptions
     Objects.requireNonNull(schemaJson, "schemaJson");
     Objects.requireNonNull(options, "options");
     Objects.requireNonNull(compileOptions, "compileOptions");
-    LOG.info(() -> "json-schema.compile start doc=" + java.net.URI.create("urn:inmemory:root") + " options=" + options.summary());
+    LOG.fine(() -> "json-schema.compile start doc=" + java.net.URI.create("urn:inmemory:root") + " options=" + options.summary());
     LOG.fine(() -> "compile: Starting schema compilation with full options, schema type: " + schemaJson.getClass().getSimpleName() +
         ", options.assertFormats=" + options.assertFormats() + ", compileOptions.remoteFetcher=" + compileOptions.remoteFetcher().getClass().getSimpleName());
     LOG.fine(() -> "compile: fetch policy allowedSchemes=" + compileOptions.fetchPolicy().allowedSchemes());
@@ -373,7 +373,7 @@ static JsonSchema compile(JsonValue schemaJson, Options options, CompileOptions
       }
     }
 
-    LOG.info(() -> "json-schema.compile done   roots=" + rootCount);
+    LOG.fine(() -> "json-schema.compile done   roots=" + rootCount);
     return result;
   }
 
@@ -700,7 +700,7 @@ static CompiledRegistry freezeRoots(Map<java.net.URI, CompiledRoot> built, java.
     }
     if (entryRoot == null) {
       // As a last resort, pick the first element to avoid NPE, but log an error
-      LOG.severe(() -> "ERROR: Primary root URI not found in compiled roots: " + primaryUri);
+      LOG.severe(() -> "ERROR: SCHEMA: primary root not found doc=" + primaryUri);
       entryRoot = built.values().iterator().next();
     }
     final java.net.URI primaryResolved = entryRoot.docUri();
@@ -728,7 +728,7 @@ static CompiledRegistry freezeRoots(Map<java.net.URI, CompiledRoot> built, java.
   /// @return ValidationResult with success/failure information
   default ValidationResult validate(JsonValue json) {
     Objects.requireNonNull(json, "json");
-    LOG.info(() -> "json-schema.validate start frames=0 doc=unknown");
+    LOG.fine(() -> "json-schema.validate start frames=0 doc=unknown");
     List<ValidationError> errors = new ArrayList<>();
     Deque<ValidationFrame> stack = new ArrayDeque<>();
     Set<ValidationKey> visited = new HashSet<>();
@@ -1805,7 +1805,7 @@ static CompilationBundle compileBundle(JsonValue schemaJson, Options options, Co
       // Create compilation bundle
       CompiledRoot entryRoot = compiled.get(entryUri);
       if (entryRoot == null) {
-        LOG.severe(() -> "ERROR: Entry root must exist but was null for URI: " + entryUri);
+      LOG.severe(() -> "ERROR: SCHEMA: entry root null doc=" + entryUri);
       }
       assert entryRoot != null : "Entry root must exist";
       List<CompiledRoot> allRoots = List.copyOf(compiled.values());

json-java21-schema/src/main/java/io/github/simbo1905/json/schema/VirtualThreadHttpFetcher.java

@@ -174,16 +174,10 @@ JsonValue fetchSchemaJson(java.net.URI docUri) {
 
             return result.document();
         } catch (JsonSchema.RemoteResolutionException e) {
-            LOG.finest(() -> "fetchSchemaJson: caught RemoteResolutionException object=" + e + ", uri=" + e.uri() + ", reason=" + e.reason() + ", message='" + e.getMessage() + "'");
-            if (e.reason() == JsonSchema.RemoteResolutionException.Reason.NOT_FOUND) {
-                LOG.warning(() -> "fetchSchemaJson: non-200 response for uri=" + docUri);
-            } else if (e.reason() == JsonSchema.RemoteResolutionException.Reason.NETWORK_ERROR) {
-                LOG.severe(() -> "ERROR: fetchSchemaJson network error for uri=" + docUri + ": " + e.getMessage());
-            }
+            // Already logged by the fetch path; rethrow
             throw e;
         } catch (Exception e) {
-            LOG.finest(() -> "fetchSchemaJson: caught unexpected exception object=" + e + ", class=" + e.getClass().getSimpleName() + ", message='" + e.getMessage() + "'");
-            LOG.severe(() -> "ERROR: fetchSchemaJson unexpected error for uri=" + docUri + ": " + e.getMessage());
+            LOG.severe(() -> "ERROR: FETCH: " + docUri + " - unexpected NETWORK_ERROR");
             throw new JsonSchema.RemoteResolutionException(docUri, JsonSchema.RemoteResolutionException.Reason.NETWORK_ERROR, "Failed to fetch schema", e);
         }
     }