initial commit v 0.2.0

2026-09-24 22:49:27 +02:00
commit db873063f8
129 changed files with 7512 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 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.