DOC: Autogenerate and update documentation

Author: actions-user

docs/helpers/CDPBrowser.md

@@ -515,7 +515,10 @@ Returns **[string][2]** the resolved, absolute URL.
 
 Settles after an interaction (click, key press, etc.) before the next step runs, using the
 listener `_armActionSettle` started *before* the interaction was dispatched (`armed`; a fresh
-one is armed here too, as a safety net, if a call site forgot to).
+one is armed here too, as a safety net, if a call site forgot to — but arming this late can
+only miss a navigation that already started during the action's own dispatch, exactly the race
+this design exists to avoid, so every call site should pass its own pre-armed `armed`, not rely
+on this fallback).
 
 If `options.waitForAction` was set explicitly in the config, honors it literally as a fixed
 pacing sleep, exactly as before this round — an explicit value is a deliberate choice

docs/helpers/Kitesurf.md

@@ -93,7 +93,9 @@ Type: [object][5]
 
 Closes the target as `CDPBrowser._finishTest` does, then releases the cloud session acquired
 in `_resolveEndpoint` via the Cloudflare API so it does not linger for the full `keepAlive`
-window.
+window. The release runs in a `finally` so a rejection while closing the CDP connection still
+frees the cloud session instead of leaving the browser alive until `keepAlive` expires; the
+session id is cleared before the request, so a repeated call never releases it twice.
 
 ### _resolveEndpoint
 

docs/helpers/Obscura.md

@@ -176,7 +176,9 @@ Returns **[Promise][2]<[boolean][5]>** true if the URL answered.
 ### _resolveBinary
 
 Resolves the `obscura` binary to spawn, in priority order: `options.binaryPath`, then the
-`OBSCURA_PATH` environment variable, then `obscura` on `PATH` (via `which`).
+`OBSCURA_PATH` environment variable, then `obscura` on `PATH`. The `PATH` lookup walks the
+directories itself instead of shelling out to `which`, which does not exist on Windows: on
+Windows every `PATHEXT` suffix is tried, so an `obscura.exe` on `PATH` is found too.
 
 Returns **([string][4] | null)** an absolute or relative path to the binary, or null if none resolved.