First commit for private source control. Older commits available on Github.

Assets/Scripts/Framework/Services/Puzzles/Base/BasePuzzle.cs

@@ -0,0 +1,50 @@
+// ==============================
+// PuzzleBase.cs (updated)
+// ==============================
+
+using System.Collections.Generic;
+using BriarQueen.Framework.Assets;
+using BriarQueen.Framework.Coordinators.Events;
+using BriarQueen.Framework.Managers.Audio;
+using BriarQueen.Framework.Managers.Hints.Data;
+using BriarQueen.Framework.Managers.IO;
+using BriarQueen.Framework.Managers.Levels.Data;
+using BriarQueen.Framework.Registries;
+using Cysharp.Threading.Tasks;
+using VContainer;
+
+namespace BriarQueen.Framework.Services.Puzzles.Base
+{
+    public abstract class BasePuzzle : BaseLevel
+    {
+        protected AddressableManager AddressableManager;
+        protected AssetRegistry AssetRegistry;
+        protected AudioManager AudioManager;
+        protected ItemRegistry ItemRegistry;
+        protected PuzzleService PuzzleService;
+
+        public abstract string PuzzleID { get; }
+
+        public override bool IsPuzzleLevel => true;
+
+        // BaseLevel still requires these.
+        public abstract override string LevelName { get; }
+        public abstract override Dictionary<int, BaseHint> Hints { get; }
+
+        public abstract UniTask CompletePuzzle();
+
+        [Inject]
+        public void Construct(EventCoordinator eventCoordinator, AudioManager audioManager,
+            SaveManager saveManager, ItemRegistry itemRegistry, AddressableManager addressableManager,
+            AssetRegistry assetRegistry, PuzzleService puzzleService)
+        {
+            EventCoordinator = eventCoordinator;
+            AudioManager = audioManager;
+            SaveManager = saveManager;
+            ItemRegistry = itemRegistry;
+            AddressableManager = addressableManager;
+            AssetRegistry = assetRegistry;
+            PuzzleService = puzzleService;
+        }
+    }
+}

Assets/Scripts/Framework/Services/Puzzles/Base/BasePuzzle.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 2f7dc618c5084940a094037aab5f4e8b
+timeCreated: 1769876583

Assets/Scripts/Framework/Services/Puzzles/Base/IPuzzleStateful.cs

@@ -0,0 +1,15 @@
+using Cysharp.Threading.Tasks;
+
+namespace BriarQueen.Framework.Services.Puzzles.Base
+{
+    public interface IPuzzleStateful
+    {
+        /// <summary>If true, manager can mark the puzzle completed (and optionally clear state).</summary>
+        bool IsCompleted { get; }
+
+        UniTask<byte[]> CaptureState();
+
+        /// <summary>Restore the puzzle from a previously captured serialized blob.</summary>
+        UniTask RestoreState(byte[] state);
+    }
+}

Assets/Scripts/Framework/Services/Puzzles/Base/IPuzzleStateful.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: e05bb678cdfe40f6acffd77fceb3faba
+timeCreated: 1769878647

Assets/Scripts/Framework/Services/Puzzles/Base/IPuzzleWorldStateSync.cs

@@ -0,0 +1,7 @@
+namespace BriarQueen.Framework.Services.Puzzles.Base
+{
+    public interface IPuzzleWorldStateSync
+    {
+        void SyncWorldStateToSave();
+    }
+}

Assets/Scripts/Framework/Services/Puzzles/Base/IPuzzleWorldStateSync.cs.meta

@@ -0,0 +1,3 @@
+fileFormatVersion: 2
+guid: 120766eb18204d1593aad20a292f305c
+timeCreated: 1774453311