feat(commons): add surgical remove members to ISurgicalAddressSpaceSink + deferred forwarding (guard-verified) (R2-07 T7)

2026-07-13 12:07:01 -04:00
parent 4f1853b21f
commit 438004e371
9 changed files with 210 additions and 1 deletions
@@ -2013,6 +2013,35 @@ public sealed class AddressSpaceApplierTests
            return FolderRenameReturns;
        }

+        /// <summary>Gets the queue of surgical remove calls (kind + node id) in call order (R2-07 Phase 2).</summary>
+        public ConcurrentQueue<(string Kind, string NodeId)> RemoveQueue { get; } = new();
+        /// <summary>Gets the list of recorded surgical remove calls.</summary>
+        public List<(string Kind, string NodeId)> RemoveCalls => RemoveQueue.ToList();
+        /// <summary>When false, the Remove* members report the node missing (return false), driving the
+        /// applier's rebuild fallback. Defaults to true (node present, removal succeeds).</summary>
+        public bool RemoveReturns { get; init; } = true;
+
+        /// <summary>Records a surgical variable-node removal; returns <see cref="RemoveReturns"/>.</summary>
+        public bool RemoveVariableNode(string variableNodeId)
+        {
+            RemoveQueue.Enqueue(("var", variableNodeId));
+            return RemoveReturns;
+        }
+
+        /// <summary>Records a surgical alarm-condition-node removal; returns <see cref="RemoveReturns"/>.</summary>
+        public bool RemoveAlarmConditionNode(string alarmNodeId)
+        {
+            RemoveQueue.Enqueue(("alarm", alarmNodeId));
+            return RemoveReturns;
+        }
+
+        /// <summary>Records a surgical equipment-subtree removal; returns <see cref="RemoveReturns"/>.</summary>
+        public bool RemoveEquipmentSubtree(string equipmentNodeId)
+        {
+            RemoveQueue.Enqueue(("equipment", equipmentNodeId));
+            return RemoveReturns;
+        }
+
        /// <summary>Gets the queue of alarm condition write calls.</summary>
        public ConcurrentQueue<(string NodeId, AlarmConditionSnapshot State)> AlarmQueue { get; } = new();
        /// <summary>Gets the queue of folder creation calls.</summary>