What problem does it solve? SwiftUI state restoration defects compile cleanly but fail semantically: @AppStorage and @SceneStorage are interchangeable to the compiler, so per-window UI state leaks across windows, selections vanish on relaunch, and UIKit restoration symbols get hallucinated onto SwiftUI. This Skill audits a macOS SwiftUI project for 11 specific state-restoration defect classes and writes structured findings to disk. ## Core Features & Use Cases - 11-rule defect index (sr-01 to sr-11): Detects hallucinated UIKit restoration symbols, @AppStorage/@SceneStorage wrapper confusion, hand-rolled UserDefaults, unpersisted NavigationPath, oversized blobs in key-value storage, dead deep links, and ungated restorationBehavior/focusedSceneValue calls. - Hybrid lint engine: Runs tier-1 ripgrep tells plus a tier-2 ast-grep structural rule that proves a restorationBehavior call is not inside an #available(macOS 15) gate, emitting unified JSON and SARIF output. - Evidence-grounded verification: Cross-checks every uncertain claim against a corpus of 1,857 real shipping macOS apps via the swiftui-ctx CLI and Apple documentation fetched through Sosumi, reporting findings only at 100% certainty. - Use Case: Point it at an in-progress macOS SwiftUI app before release to catch the classic bug where a second window clobbers the first window's selected tab because the selection was bound to @AppStorage instead of @SceneStorage. ## Quick Start Audit the SwiftUI sources in my current macOS project for state restoration problems and write the findings to swiftui-audits/state-restoration.
