Rename Restore Request contract to Restore Snapshot for backup/restore naming consistency - PR_26152_093-restore-snapshot-contract-rename

Author: ToolboxAid

docs/dev/reports/restore_request_contract_tests_validation.md

@@ -0,0 +1,45 @@
+# Restore Snapshot Contract Rename Validation
+
+PR: PR_26152_093-restore-snapshot-contract-rename
+
+## Scope
+
+- Renamed the restore contract module to `src/shared/contracts/restoreSnapshotContract.js`.
+- Renamed the restore contract test to `tests/shared/RestoreSnapshotContract.test.mjs`.
+- Renamed restore fixtures to `tests/fixtures/restore-snapshots/restore-snapshot-scenarios.json`.
+- Renamed restore spec/report references to Restore Snapshot terminology.
+- Kept Backup Snapshot and Restore Snapshot as separate contract, fixture, spec, test, and report surfaces.
+
+## Lanes Executed
+
+- contract - restore snapshot syntax and targeted contract validation.
+- dependent contract - backup snapshot and migration plan validation to verify rename compatibility.
+
+## Lanes Skipped
+
+- runtime - no runtime behavior changed.
+- UI/CSS/HTML - no UI, CSS, or HTML files changed.
+- samples - samples are out of scope for contract rename validation.
+- repo-wide tests - explicitly out of scope.
+
+## Commands
+
+- PASS: `node --check src/shared/contracts/restoreSnapshotContract.js`
+- PASS: `node --check tests/shared/RestoreSnapshotContract.test.mjs`
+- PASS: `node tests/shared/RestoreSnapshotContract.test.mjs`
+- PASS: `node tests/shared/BackupSnapshotContract.test.mjs`
+- PASS: `node tests/shared/MigrationPlanContract.test.mjs`
+
+## Reference Check
+
+- PASS: Active restore source/test/fixture/spec/report references use Restore Snapshot terminology.
+- PASS: Backup Snapshot remains separate and was not consolidated with Restore Snapshot.
+
+## Expected PASS Behavior
+
+- Restore Snapshot contract exports, validation names, fixture keys, test names, and documentation references resolve under Restore Snapshot terminology.
+- Backup Snapshot contract tests and Migration Plan contract tests continue to pass.
+
+## Expected WARN Behavior
+
+- None.

docs/dev/reports/restore_snapshot_contract_rename_validation.md

@@ -0,0 +1,47 @@
+# Restore Snapshot Contract Tests Validation
+
+PR: PR_26152_092-backup-restore-contract-tests
+
+## Scope
+
+- Added `src/shared/contracts/restoreSnapshotContract.js`.
+- Added `tests/shared/RestoreSnapshotContract.test.mjs`.
+- Added `tests/fixtures/restore-snapshots/restore-snapshot-scenarios.json`.
+- Added `docs/dev/specs/RESTORE_SNAPSHOT_CONTRACT.md`.
+- Restore Snapshot contract remains metadata-only and does not contain runtime state, toolState, file bytes, auth session state, installer state, updater implementation details, or storage implementation details.
+
+## Lanes Executed
+
+- contract - restore snapshot contract syntax and targeted fixture validation.
+- contract dependencies - migration plan, version compatibility, update channel, install receipt, library item, project, and identity/permissions contract compatibility.
+
+## Lanes Skipped
+
+- runtime - no runtime behavior changed.
+- UI/CSS/HTML - no UI, CSS, or HTML files changed.
+- samples - samples are out of scope for contract-only validation.
+- repo-wide tests - explicitly out of scope.
+
+## Commands
+
+- PASS: `node --check src/shared/contracts/restoreSnapshotContract.js`
+- PASS: `node --check tests/shared/RestoreSnapshotContract.test.mjs`
+- PASS: `node tests/shared/RestoreSnapshotContract.test.mjs`
+- PASS: `node tests/shared/MigrationPlanContract.test.mjs`
+- PASS: `node tests/shared/VersionCompatibilityContract.test.mjs`
+- PASS: `node tests/shared/UpdateChannelContract.test.mjs`
+- PASS: `node tests/shared/InstallReceiptContract.test.mjs`
+- PASS: `node tests/shared/LibraryItemContract.test.mjs`
+- PASS: `node tests/shared/ProjectContract.test.mjs`
+- PASS: `node tests/shared/IdentityPermissionsContract.test.mjs`
+
+## Expected PASS Behavior
+
+- Valid restore snapshot fixtures pass.
+- Invalid restore snapshot fixtures reject missing owner/project/link records, mismatched backup/release/compatibility linkage, blocked or incompatible compatibility gates, invalid timestamps, and forbidden runtime/tool/file/auth/installer/updater/storage fields.
+- Existing dependent contract tests remain compatible.
+
+## Expected WARN Behavior
+
+- None.
+

docs/dev/reports/restore_snapshot_contract_tests_validation.md

@@ -1,20 +1,20 @@
-# Restore Request Contract
+# Restore Snapshot Contract
 
 ## Purpose
 
-Restore Request records describe a metadata-only request to restore from a Backup Snapshot into a target Release context.
+Restore Snapshot records describe a metadata-only restore point created from a Backup Snapshot into a target Release context.
 
 The record links the restore owner, project, backup snapshot, target release, and version compatibility records. It does not store restore payload data, runtime state, toolState, file bytes, auth session state, installer state, updater implementation details, or storage implementation details.
 
 ## Ownership
 
-- Every Restore Request requires `ownerId`.
-- The Restore Request owner must match `backupSnapshot.ownerId`.
-- The Restore Request owner must match `versionCompatibility.ownerId`.
+- Every Restore Snapshot requires `ownerId`.
+- The Restore Snapshot owner must match `backupSnapshot.ownerId`.
+- The Restore Snapshot owner must match `versionCompatibility.ownerId`.
 
 ## Required Linkage
 
-- `projectId` links the request to the persisted Project container.
+- `projectId` links the restore snapshot to the persisted Project container.
 - `backupSnapshot` identifies the Backup Snapshot selected for restore.
 - `targetRelease` identifies the published or retired Release target.
 - `versionCompatibility` identifies the compatibility gate for the target restore path.
@@ -31,7 +31,7 @@ The record links the restore owner, project, backup snapshot, target release, an
 
 ## Boundaries
 
-Restore Request records must not contain:
+Restore Snapshot records must not contain:
 
 - runtime state
 - toolState or tool payloads
@@ -45,7 +45,6 @@ Restore Request records must not contain:
 
 Targeted validation lives in:
 
-- `src/shared/contracts/restoreRequestContract.js`
-- `tests/shared/RestoreRequestContract.test.mjs`
-- `tests/fixtures/restore-requests/restore-request-scenarios.json`
-
+- `src/shared/contracts/restoreSnapshotContract.js`
+- `tests/shared/RestoreSnapshotContract.test.mjs`
+- `tests/fixtures/restore-snapshots/restore-snapshot-scenarios.json`