docs(mobile): say why bundle reads settle at on-settle under pipelined chunks

Claude-Session: https://claude.ai/code/session_01JNnE9qzUZMMnqpZWCqM3nb
This commit is contained in:
Jinwoo-H
2026-09-22 23:27:34 -04:00
parent c83ff83367
commit 34fda6f62e
@@ -15,9 +15,9 @@ import { rpcResultVariant } from './rpc-operation-result-reader'
// The two reads that hand a paired phone the desktop's mobile web bundle. Both are
// `require-result-or-throw`: there is no partial success here, and a salvage policy would produce a
// half-bundle that fails a hash check much later, far from the cause. Both settle at `on-settle`,
// because each reply is acted on before the next request is built — the manifest decides which
// chunks to read, and a chunk's reply decides whether its asset is whole.
// half-bundle that fails a hash check much later, far from the cause. Both settle at `on-settle`:
// the manifest decides which chunks to read, and a refused chunk must stop its siblings when it
// lands, not after the window drains.
/** The whole manifest plus the chunk size the host will serve it at. */
export const mobileWebBundleManifestRead = defineRpcOperation({