docs(r2-02): correct WriteIdempotentAttribute's unwired claim; disable Write/Ack retry authoring cells (S-8)

2026-07-13 10:07:01 -04:00
parent 20ff67bf9a
commit 99b424240a
4 changed files with 12 additions and 6 deletions
@@ -48,7 +48,10 @@ public interface IDriverCapabilityInvoker
    ///     Execute a <see cref="DriverCapability.Write"/> call honoring idempotence semantics — when
    ///     <paramref name="isIdempotent"/> is <c>false</c>, retries are disabled regardless of the
    ///     configured policy; when <c>true</c>, the call runs through the Write pipeline which may
-    ///     retry if the tier configuration permits.
+    ///     retry if the tier configuration permits. <b>The current production default is <c>false</c></b>
+    ///     (R2-02/S-8): <c>DriverInstanceActor.HandleWriteAsync</c> passes <c>isIdempotent: false</c> so a
+    ///     command-shaped write is never replayed; per-tag opt-in via <see cref="WriteIdempotentAttribute"/>
+    ///     is the unshipped forward path.
    /// </summary>
    /// <typeparam name="TResult">Return type of the underlying driver write call.</typeparam>
    /// <param name="hostName">The resolved host name for pipeline keying + status tracking.</param>