Repository navigation
[P3][adapters] Document OPFS flush() weaker power-loss guarantees #39
Description
Summary
OPFS flush() may not provide same power-loss guarantees as POSIX fsync. Adapter maps fsync() → flush() without documenting weaker contract.
Audit ID: Section 4 Low — Wave 3
Location: src/adapter/opfs.ts:69-71
Related: #10 OPFS E2E
Tasks
- Research OPFS sync handle durability docs (Chrome/Firefox).
- Document in
docs/RELIABILITY.mdand adapter JSDoc what flush guarantees. - Verify OPFS browser persistence end-to-end on Chrome, Firefox, and Safari #10 E2E should verify best-effort persistence where possible.
Acceptance criteria
- Weaker browser contract documented honestly.
- No false parity with node-fs in README.
- Docs-only changeset usually not needed.
Activity
cevheri commentedon Jul 3, 2026
Implemented and shipped in PR #43 (merge commit 69f7161), released as v0.2.0. The PR description's comma-separated Closes list only auto-closed the first reference — closing manually. For #39/#28-style partials: the shipped scope is done; the real-browser verification half of #39 continues under #10, and the typed-error contract (#28) shipped as LibreDbError with stable codes across kernel, adapters, lenses, and CLI.