# Fileworkbench 0.2.3 — complete diagnostic source release

This is a full source project with the previously separate SAF-D1 changes already
integrated. It is not a patch and does not require an existing checkout.

## Included changes

- Preserve all 0.2.2 modules, browser/viewer features, native iOS-facing core,
  fixtures, earlier fixes and regression tests.
- Integrate the SAF-D1 null-cursor diagnostic and its updated 16-case host harness.
- Display `Fileworkbench 0.2.3 · Browser diagnostics SAF-D1` in the Locations footer.
- Set Android versionName to 0.2.3 and versionCode to 5, retaining the package ID.
- Pin Gradle 8.14.5 in the distribution URL, shell/PowerShell bootstraps and hashes.
- Add checked-in JDK-17 daemon criteria. All module toolchains and bytecode targets
  use 17; the settings script rejects conflicting Gradle/JVM versions.
- Keep the original five distinct root plugin aliases and Kotlin/AGP versions;
  add an offline source check to catch alias duplication and mismatched pins.
- Update setup instructions for a fresh extraction and preserve historical evidence.

No extra permissions, cloud services, Office rendering engines, JDK, SDK, signing
keys or compiled APK are added. The external wrapper JAR still needs first-run
bootstrap on a network-capable machine.

## Folder issue status

The earlier nullable-`use` result bug was corrected, but the user still reports a
listing failure. There is no device trace establishing why it persists. SAF-D1
identifies an actual null query result separately, with provider authority, API
level and retained-read-grant status. It does not change how files are queried or
claim to repair provider behaviour. No paths, document IDs or contents are added
to the diagnostic. Temporary grants remain distinct from persistent grants.

After building and installing, verify the 0.2.3/SAF-D1 footer, then reproduce the
folder problem and capture the full new error. Do not clear app data for this test.

## Start here

Extract into a fresh directory, install/select JDK 17, and run the supplied wrapper
once before IDE import. Use `docs/BUILD.md` for Windows and Linux/macOS commands.
Do not copy old IDE/Gradle state or build configuration over the new source.
The updated `docs/VALIDATION.md` distinguishes host tests from Android verification.