feat(scripts): reset-aware Attributes.WriteBatchAndWaitAsync overload + deploy-gate mirror (#36)

Claude-Session: https://claude.ai/code/session_01XPsuy2ZZ5Gbyfpt8PrK5BV
2026-09-10 15:27:00 -04:00
parent 03c8a01dd1
commit b623fdb05e
3 changed files with 101 additions and 0 deletions
@@ -332,6 +332,19 @@ public sealed class ScriptCompileSurface
        /// <param name="timeout">The maximum time to wait for the response.</param>
        /// <returns><c>true</c> if the response value was observed before the timeout elapsed; otherwise <c>false</c>.</returns>
        public Task<bool> WriteBatchAndWaitAsync(IReadOnlyDictionary<string, object?> values, string flagKey, object? flagValue, string responseKey, object? responseValue, TimeSpan timeout) => throw new NotSupportedException(CompileOnly);
+
+        /// <summary>Mirrors the reset-aware <c>AttributeAccessor.WriteBatchAndWaitAsync</c> overload (Gitea #36).</summary>
+        /// <param name="values">The set of attribute values to write as a batch.</param>
+        /// <param name="flagKey">The name of the flag attribute signaling the write.</param>
+        /// <param name="flagValue">The value written to the flag attribute.</param>
+        /// <param name="responseKey">The name of the attribute to observe for a response.</param>
+        /// <param name="responseValue">The value to wait for on the response attribute.</param>
+        /// <param name="timeout">The maximum time to wait for the response.</param>
+        /// <param name="resetKey">The attribute written first and waited on before the batch.</param>
+        /// <param name="resetValue">The reset value the device must echo before the batch is written.</param>
+        /// <param name="resetTimeout">The maximum time to wait for the reset echo; <c>null</c> means <paramref name="timeout"/>.</param>
+        /// <returns>The phase-aware handshake outcome.</returns>
+        public Task<HandshakeResult> WriteBatchAndWaitAsync(IReadOnlyDictionary<string, object?> values, string flagKey, object? flagValue, string responseKey, object? responseValue, TimeSpan timeout, string resetKey, object? resetValue, TimeSpan? resetTimeout = null) => throw new NotSupportedException(CompileOnly);
    }

    /// <summary>Compile-only mirror of <c>ChildrenAccessor</c>.</summary>