Document v0.1.0 completion state

README.md

@@ -50,7 +50,7 @@ Python and PySide6/Qt for a desktop application. The initial implementation will
 
 ## Development
 
-The quick-start guide is in [`docs/how-to.md`](docs/how-to.md). The detailed design is in [`docs/design.md`](docs/design.md). See [`docs/roadmap.md`](docs/roadmap.md) for the planned milestones.
+The quick-start guide is in [`docs/how-to.md`](docs/how-to.md). The detailed design is in [`docs/design.md`](docs/design.md). See [`docs/completion-report.md`](docs/completion-report.md) for the v0.1.0 delivery record and [`docs/roadmap.md`](docs/roadmap.md) for future enhancements.
 
 ## License
 

docs/completion-report.md

@@ -0,0 +1,60 @@
+# DataLoom completion report
+
+**Project status:** Initial release complete; future enhancements are pending.
+
+## Delivered
+
+- Offline Windows desktop application built with Python, PySide6, and Qt.
+- Same-format Bitwarden JSON or CSV import for two or more files.
+- Unencrypted-export validation and import warning.
+- Conservative URL normalization, including case folding, trailing-slash removal, default-port handling, and `www.` equivalence.
+- Automatic removal of exact login duplicates using item type, normalized username, password, and normalized URI values.
+- Likely-duplicate review for same type, URL, and username with differing values.
+- Structured side-by-side duplicate comparison.
+- Newest-record recommendation when valid `revisionDate` values are available.
+- Manual review choices to keep one selected record or keep both records.
+- Same-format JSON/CSV export with CSV loss warnings.
+- In-app and plain-text audit logging, with full-secret logging optional and disabled by default.
+- Synthetic Bitwarden-style fixtures and automated tests.
+- Portable Windows 11 executable built with PyInstaller.
+- MIT license, security guidance, disclaimer, quick how-to, and README screenshot.
+
+## Validation performed
+
+- Local synthetic test suite: **6 passed**.
+- Synthetic merge smoke test: 8 records loaded, 1 exact duplicate removed, 7 records retained, 2 review groups generated.
+- JSON export round-trip verified.
+- Windows 11 synthetic test suite: **6 passed**.
+- Windows PyInstaller build completed successfully.
+- Packaged executable launch check passed and remained running for 8 seconds.
+- Interactive Windows 11 testing by Rob confirmed the application behavior was satisfactory.
+
+## Release
+
+- Version: `v0.1.0`
+- Asset: `DataLoom-v0.1.0-windows-x64.exe`
+- Target: Windows 11 x64
+- Release URL: `https://gitea.ledrew.me/ledadmin/DataLoom/releases/tag/v0.1.0`
+
+## Public-readiness review
+
+A final read-only review was completed before publication. The tracked repository contains no real Bitwarden exports, credentials, API keys, SSH keys, personal identifiers, internal network addresses, or local machine paths. The fixtures contain synthetic data only. The Git author email `admin@ledrew.me` was reviewed and explicitly approved for public visibility.
+
+Release and download URLs were verified to use `https://gitea.ledrew.me` rather than the internal Gitea address.
+
+## Known limitations
+
+- CSV cannot represent every Bitwarden JSON feature losslessly. DataLoom reports known CSV loss risks; JSON is preferred for complete preservation.
+- The current UI is read-only apart from duplicate keep decisions; it does not edit individual vault records.
+- Windows desktop interaction was validated manually; Linux GUI testing was intentionally skipped.
+- The application is not affiliated with or endorsed by Bitwarden.
+- Generated exports and audit logs are not encrypted or automatically deleted.
+
+## Future enhancements
+
+- Improve field-level difference highlighting beyond the current structured comparison.
+- Add richer support for all Bitwarden item types, attachments, passkeys, linked fields, and nested custom data.
+- Add explicit export preflight and stronger loss-detection for CSV.
+- Add optional secure handling and retention controls for audit logs.
+- Add application icons, screenshots, and polished packaging metadata.
+- Add more comprehensive Windows UI automation.

docs/roadmap.md

@@ -1,12 +1,23 @@
 # Roadmap
 
-1. Define internal record model and synthetic JSON/CSV fixtures.
+## Completed for v0.1.0
-2. Implement strict same-format Bitwarden import and validation.
+
-3. Implement loss-aware field preservation and URL normalization.
+- [x] Define internal record model and synthetic JSON/CSV fixtures.
-4. Implement exact/likely/possible duplicate classification and newest-record preference.
+- [x] Implement strict same-format Bitwarden import and validation.
-5. Implement same-format merged export with CSV loss warnings.
+- [x] Implement loss-aware field preservation and URL normalization.
-6. Build PySide6 desktop workflow and read-only review screens.
+- [x] Implement exact/likely duplicate classification and newest-record preference.
-7. Add comprehensive plain-text and in-app audit logging.
+- [x] Implement same-format merged export with CSV loss warnings.
-8. Add packaging documentation and desktop smoke tests.
+- [x] Build PySide6 desktop workflow and review screens.
+- [x] Add optional plain-text and in-app audit logging.
+- [x] Add Windows packaging documentation and desktop smoke tests.
+- [x] Build and manually validate the Windows 11 portable release.
+
+## Future enhancements
+
+- Improve field-level difference highlighting and review navigation.
+- Expand complete support for attachments, passkeys, linked fields, and all nested Bitwarden data.
+- Add stronger CSV loss detection and export preflight controls.
+- Add optional secure audit-log retention and handling controls.
+- Add packaging polish, icons, and broader Windows UI automation.
 
 Real Bitwarden exports are not required for development or tests.