[daveshanley]

API documentation and retained-input analysis exposed three input-preservation defects: concurrent local opens could replace an existing parsed tree, nullable examples became the string "", and remote retrieval URLs could be mistaken for host overrides.

• Recheck the local file cache under the cold-load reservation. Existing readers keep the same file/tree; the cached hot path is unchanged.
• Preserve decoded null examples while retaining literal "" strings.
• Use an OpenAPI 3 retrieval URL as the relative-reference base without replacing an explicit BaseURL or $self policy. Resolve remote references as URIs, preserving their host, query and escaped path; decode only the fragment. Local file references keep their existing behavior.

Validation: deterministic stale-miss and nullable-example regressions fail before their fixes. Exact retrieval-URL tests cover root-relative, scheme-relative, cross-origin, query, escaped-path and lazy-schema resolution. Independent adversarial testing verified 16 exact-URI cases and no unexpected fetches. Focused race tests pass. Owning-package tests cover the new fallback and local-pointer branches. Bunkhouse's full Doctor race suite passes against this source. Final-head CI passes Linux and Windows. CodeQL and both patch/project coverage checks pass.

Risk: medium. URI resolution, concurrent cold-load publication and generated values are shared library behavior. Explicit BaseURL host override and $self precedence remain covered. No new public option, permission rule or cached hot-path work is added. Bare external named-anchor handling is an existing limitation outside this repair. No merge or release is included.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (f6e97f4) to head (794be11).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #702   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          315       315           
  Lines        39762     39755    -7     
=========================================
- Hits         39762     39755    -7     

Flag	Coverage Δ
unittests	100.00% <100.00%> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.