Document the tested PdfCraft property draft consumer

Author: PerchAnton

README.md

@@ -96,6 +96,22 @@ revision `28620b8264660ea84a182110cf5894da90281c42`. The alpha 2 additions are n
 This is a working, tested consumer patch
 awaiting maintainer review; upstream adoption is not claimed.
 
+## Proposed PdfCraft UI consumer
+
+[PdfCraft PR #4594](https://github.com/storytold/pdfcraft/pull/4594) integrates alpha 2 into **Document Properties**.
+Description, Initial View and Custom values share a draft bound to document identity,
+edit generation and permissions. `check_live` rejects stale input after edits, Undo/Redo,
+reload or a document switch; the existing engine commits one atomic batch. Cancel,
+Escape and no-ops do not add history. Failed engine edits retain the form for correction.
+Clean inspection tabs retain their existing live refresh without rebasing typed input.
+
+The consumer owns a [real UI adapter](https://github.com/PerchAnton/pdfcraft/blob/535d990d10832baf3b0a64910c51b280c224bd5c/crates/ui-egui/examples/properties_scenarios.rs)
+and [10 scenarios / 79 steps](https://github.com/PerchAnton/pdfcraft/tree/535d990d10832baf3b0a64910c51b280c224bd5c/tests/interactions/document-properties),
+replayed by interaction-check, including save/reopen and preservation of custom metadata.
+Local scoped UI tests, strict Clippy, assets, parity and wasm checks pass. Both dependencies
+are pinned; upstream review of the source-policy exception and adoption is pending.
+See [reproduction instructions](https://github.com/PerchAnton/pdfcraft/blob/535d990d10832baf3b0a64910c51b280c224bd5c/docs/document-properties-sessions.md).
+
 ## PhotoCraft integration pilot
 
 The [adapter in interaction-check](https://github.com/PerchAnton/interaction-check/tree/main/adapters/photocraft)
@@ -113,8 +129,7 @@ python3 interaction_check.py scenarios/photocraft/*.json -- \
 ```
 
 This is an **external, headless integration pilot**. Upstream PhotoCraft has not added this
-dependency and its GUI is unchanged. It is not a fix for a PhotoCraft issue. PdfCraft has not
-been built or adapted by this project.
+dependency and its GUI is unchanged. It is not a fix for a PhotoCraft issue. The separate PdfCraft UI proposal is described above.
 
 See [research and adoption decision](docs/DECISION.md) and [validation evidence](docs/VALIDATION.md).
 

docs/DECISION.md

@@ -4,6 +4,16 @@ Research date: 24 October 2026 (Europe/Kyiv). The implementation is an experimen
 maintainer has agreed to adopt either project. The first consumer focus is PhotoCraft,
 followed by PdfCraft.
 
+## Follow-up — 25 October 2026
+
+The narrow consumers are now proposed in [PhotoCraft #9190](https://github.com/storytold/photocraft/pull/9190)
+(Edit Selected Guides) and [PdfCraft #4594](https://github.com/storytold/pdfcraft/pull/4594) (Document Properties).
+The latter uses alpha 2 without adding any application-specific API to the library.
+Its baseline regressions reproduce stale metadata overwrites and loss of Redo after Undo;
+the adapter drives real widgets and checks engine save/reopen. [Validation](VALIDATION.md)
+records the scoped checks. These are tested consumer patches, not upstream adoption.
+The research and candidate-selection notes below describe the earlier 24 October snapshot.
+
 ## What the repositories show
 
 PhotoCraft and PdfCraft are Rust applications using egui 0.36 and pinned dependencies from

docs/VALIDATION.md

@@ -1,5 +1,33 @@
 # Validation evidence
 
+## PdfCraft consumer proposal — 25 October 2026
+
+[PR #4594](https://github.com/storytold/pdfcraft/pull/4594), consumer commit `535d990d10832baf3b0a64910c51b280c224bd5c` on upstream
+`418ac6a2af49b7ac2fed44ca2cae8d5d1d2cec0d`, uses edit-session alpha 2 at
+`033f7c3a67b825b8f222288788cc61234c0c945d` and interaction-check at
+`7722d66c0ede7855ff58d1df3d1632fd4e5e66a5`.
+
+On macOS arm64, Rust 1.99.1, Python 3.14.3, English UI and system-font fallback disabled:
+
+- Two upstream UI regressions fail before the fix: confirming a stale title after another
+  edit, and confirming after edit + Undo back to the same original value.
+- 522 unit, 1,153 integration and 3 performance tests pass for `pdfcraft-ui-egui`; 11
+  existing tests are ignored. Tests run with two threads and host loopback/GPU access.
+- Formatting, strict Clippy on all UI targets, layering, asset attribution and parity pass.
+- `xtask wasm` checks 31 crates successfully, with warnings in unchanged platform-specific code.
+- 10 JSONL scenarios / 79 steps pass through actual egui controls and the real engine.
+  They cover commit, Cancel/Escape, no-op preserving Redo, custom validation, stale edits,
+  Undo ABA, reload, target switching/closure, clean inspection refresh, and save/reopen.
+  JSON and JUnit reports were generated. Actual Description, Custom, Initial View and
+  stale-notice screenshots were inspected locally; synthetic PDF bytes are not committed.
+- Engine refusal/retry is atomic. A separate test checks freshness immediately at commit,
+  without relying on a preceding frame. Pending input is not rebased by an inspection tab.
+
+The [consumer documentation](https://github.com/PerchAnton/pdfcraft/blob/535d990d10832baf3b0a64910c51b280c224bd5c/docs/document-properties-sessions.md)
+explains replay and the proposed exact Git-source exception. These results are local;
+Linux/Windows CI, native OS input, another PDF reader, packaging and maintainer adoption
+are not implied. PhotoCraft's existing alpha 1 pin is unchanged.
+
 ## Alpha 2 review — 25 October 2026
 
 On macOS arm64 with **Rust 1.88.0**, the minimum supported compiler: