V4 implemented. Some tweaking left, but it is working

2026-08-11 12:07:19 -05:00
parent ccf2c78ff4
commit 0ace10269f
19 changed files with 1379 additions and 79 deletions
@@ -61,6 +61,8 @@ Implement the Version 4 project definition from the current repository state whi
 - Add API tests for relationship behavior and document-type selection.
 - Add UI tests or walkthrough coverage for grouped roles and type selection.
 - Add regression coverage for delete and cleanup semantics.
+- Enforce backup-first test execution for AI-run unit tests: backup `./data` before tests, then always prompt for restore after successful tests.
+- Keep restore confirmation-gated by default so code and test outcomes can be reviewed before data is reverted.

 ## Done When

@@ -24,7 +24,7 @@ This document defines the baseline requirements for the document transcription s
 | REQ-15 | Data Constraint | Calculate and store cryptographic file hashes (SHA-256) and file sizes for uploaded source images. | test |
 | REQ-16 | Data Constraint | Preserve a portable relational model across supported backends using SQLModel, SQLAlchemy, SQLite, and PostgreSQL. | inspection |
 | REQ-17 | Reliability | Ensure delete and update flows for documents, people, and relationship links remain deterministic and safe. | test |
-| REQ-18 | Operations Constraint | Keep canonical development, testing, restore, and recovery workflows OS-independent. | inspection |
+| REQ-18 | Operations Constraint | Keep canonical development, testing, restore, and recovery workflows OS-independent; for AI-run unit tests, require a pre-test backup of `./data` and an always-shown post-success confirmation prompt before any restore action. | inspection |
 | REQ-19 | Quality | Provide automated coverage for async transcription workflows, relationship-role enforcement, document-type selection, and regression behavior. | test |

 ## Clarifying Constraints