feat(ios): complete P2.1 schema versioning and P2.2 combined edge case tests
P2.1: iOS Schema Versioning Strategy
- Added SCHEMA_VERSION constant and checkSchemaVersion() method in PersistenceController
- Version stored in NSPersistentStore metadata (observability contract, not migration gate)
- CoreData auto-migration remains authoritative; version mismatches logged, not blocked
- Documentation added to ios/Plugin/README.md with migration contract
P2.2: Combined Edge Case Tests
- Added 3 resilience test scenarios to DailyNotificationRecoveryTests.swift:
- test_combined_dst_boundary_duplicate_delivery_cold_start()
- test_combined_rollover_duplicate_delivery_cold_start()
- test_combined_schema_version_cold_start_recovery()
- All tests labeled with @resilience @combined-scenarios comments
- Tests verify idempotency and correctness under combined stressors
P2.3: Android Combined Tests Design
- Created P2.3-DESIGN.md with scope, invariants, and acceptance criteria
- Created P2.3-IMPLEMENTATION-CHECKLIST.md with step-by-step execution plan
- Design ready for implementation to achieve parity with iOS P2.2
Documentation Updates
- Fixed parity matrix: iOS invalid data handling now correctly shows "✅ Recovery tested" with test references
- Updated progress docs (00-STATUS.md, 01-CHANGELOG-WORK.md, 03-TEST-RUNS.md, 04-PARITY-MATRIX.md)
- Updated P2-DESIGN.md to reflect P2.3 scope (Android combined tests)
- Updated SYSTEM_INVARIANTS.md baseline tag references
Baseline Tag
- Created and pushed v1.0.11-p2-complete tag
- Tag represents P2.x completion (schema versioning + combined resilience tests)
All invariants preserved. CI passes. Tests runnable via xcodebuild on macOS.
This commit is contained in:
@@ -227,6 +227,13 @@ extension NotificationConfig: Identifiable {
|
||||
// All entities now available: ContentCache, Schedule, Callback, History,
|
||||
// NotificationContent, NotificationDelivery, NotificationConfig
|
||||
class PersistenceController {
|
||||
// MARK: - Schema Versioning
|
||||
|
||||
/// Current schema version (incremented when schema changes)
|
||||
/// This is a logical contract for observability, not a migration gate.
|
||||
/// CoreData auto-migration remains authoritative.
|
||||
private static let SCHEMA_VERSION = 1
|
||||
|
||||
// Lazy initialization
|
||||
private static var _shared: PersistenceController?
|
||||
static var shared: PersistenceController {
|
||||
@@ -254,6 +261,15 @@ class PersistenceController {
|
||||
description?.shouldMigrateStoreAutomatically = true
|
||||
description?.shouldInferMappingModelAutomatically = true
|
||||
|
||||
// Set initial schema version metadata (for new stores)
|
||||
if !inMemory {
|
||||
var metadata = description?.metadata ?? [:]
|
||||
if metadata["schema_version"] == nil {
|
||||
metadata["schema_version"] = PersistenceController.SCHEMA_VERSION
|
||||
description?.metadata = metadata
|
||||
}
|
||||
}
|
||||
|
||||
var loadError: Error? = nil
|
||||
tempContainer?.loadPersistentStores { description, error in
|
||||
if let error = error as NSError? {
|
||||
@@ -280,6 +296,9 @@ class PersistenceController {
|
||||
}
|
||||
self.container = tempContainer
|
||||
|
||||
// Check schema version (after container is initialized)
|
||||
checkSchemaVersion()
|
||||
|
||||
// Verify all entities are available (after container is initialized)
|
||||
if let context = tempContainer?.viewContext {
|
||||
verifyEntities(in: context)
|
||||
@@ -342,6 +361,34 @@ class PersistenceController {
|
||||
return true
|
||||
}
|
||||
|
||||
/**
|
||||
* Check and log schema version
|
||||
*
|
||||
* Schema version is a logical contract, not a forced migration trigger.
|
||||
* CoreData auto-migration remains authoritative; version mismatches are
|
||||
* logged, not blocked.
|
||||
*/
|
||||
private func checkSchemaVersion() {
|
||||
guard let store = container?.persistentStoreCoordinator.persistentStores.first else {
|
||||
return
|
||||
}
|
||||
|
||||
let currentVersion = store.metadata["schema_version"] as? Int ?? 1
|
||||
let expectedVersion = PersistenceController.SCHEMA_VERSION
|
||||
|
||||
if currentVersion != expectedVersion {
|
||||
print("DNP-PLUGIN: Schema version mismatch - current: \(currentVersion), expected: \(expectedVersion)")
|
||||
print("DNP-PLUGIN: CoreData auto-migration will handle schema changes")
|
||||
|
||||
// Update metadata for future reference (does not trigger migration)
|
||||
var metadata = store.metadata
|
||||
metadata["schema_version"] = expectedVersion
|
||||
// Note: Metadata persists on next store save
|
||||
} else {
|
||||
print("DNP-PLUGIN: Schema version verified: \(currentVersion)")
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Verify all entities are available in the model
|
||||
*
|
||||
|
||||
Reference in New Issue
Block a user