MapleJockey local pilot UI
The standalone UI embeds the shared local engine, synthetic fixture and metadata-only report adapter. Canadian English and the MapleJockey maple red, ivory and charcoal identity continue from the directory.
Build and run
From the project root, run node pilot/ui/build.mjs. It writes MapleJockey_Pilot.html at the project root and pilot/dist/MapleJockey_Pilot.html. Open the pilot workspace in a modern browser. The operator walkthrough follows the same five steps. Keep MapleJockey_Canadian_Tools_and_Migration.html and MapleJockey_Assessment.html beside it for companion links.
No package installation, external service, browser storage or network connection is required. The Content Security Policy prohibits runtime network connections. Bytes remain in page memory until explicitly downloaded. Refreshing or closing the page discards the current session references.
Five-minute demo
- 0:00–0:45: Review the named owner, scope, rollback owner and 60-second demonstrator threshold. Explain that the target measures local processing only and is not a business-approved recovery objective.
- 0:45–1:30: Select Run guided synthetic demo. This performs actual serialisation, reparse, independent baseline comparison and file-reading checks in browser memory. It does not claim a file was downloaded and re-imported.
- 1:30–2:15: Inspect the results: eight files, byte equality, four restored CSV observations and a recomputed total of 40. Notice binary/SVG and provider checks that remain not tested.
- 2:15–3:00: Run corrupt-content and missing-file simulations. A passed negative test means a deliberate defect was detected. Neither simulation changes source or current restored bytes.
- 3:00–3:45: Preview a restored text file safely. SVG, HTML and binary formats are never rendered. Individual restored bytes can be downloaded for trusted inspection.
- 3:45–4:30: Go to Rollback & evidence, clear the restored copy and show the retained source baseline. This does not delete downloaded files or change any provider account.
- 4:30–5:00: Download the readable report, result JSON and assessment JSON. Explain the next live-destination evidence gate.
To demonstrate a user-selected file boundary, use Export & re-import, acknowledge that the JSON contains unencrypted file contents, download it, and select the downloaded file. Restoration is still into browser memory. A fresh isolated on-disk restore is a separate CLI exercise.
Validation
node --check pilot/ui/app.jsandnode --check pilot/ui/build.mjspass.node pilot/ui/smoke-test.mjspasses 18 UI event/rendering-harness checks using the actual shared engine and report adapter.- Coverage: real guided restore, explicit memory scope, metadata-only exports, negative tests, SVG preview rejection, plan invalidation, required export acknowledgement, manual-file route, pre-read size limits, malformed imports, pending-import revision cancellation, source-preserving rollback, safe text preview and session discard.
- The harness uses minimal DOM stubs. It does not establish native browser layout, keyboard navigation, file chooser, print or actual browser download behaviour. Browser execution remains unavailable under the environment's browser-process restrictions.
Important boundaries
Plan edits and new source selections clear old export and restore results. A new bundle selection clears the previous result before validation, including oversized or malformed attempts. Pending file reads cannot restore a result after a scope or source revision.
The transfer bundle contains file contents without encryption. The result and assessment reports contain paths, sizes and hashes but exclude file contents. Hash matching is not evidence of source authenticity or safe content. No provider tenancy, access-control enforcement, location, support access, key control, sharing model or production continuity is tested here.
v0.4 interface review
The compact layout, bundled Lato/Noto Sans fonts and stronger text contrast are included in the 17 November 2026 update. See validation_v04/VALIDATION_REPORT.md at the package root for the consolidated 151-check result, font checks, 27 colour-pair checks and remaining browser/provider gates. Earlier results above retain their original scope.