fileworkbench/docs/RELEASE-0.2.3.md

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.