diff --git a/README.md b/README.md index 830ad8d..c0d4646 100644 --- a/README.md +++ b/README.md @@ -139,12 +139,15 @@ git pull --ff-only PDrive installs a pinned, checksum-verified rclone build published from its public source fork. It contains the upstream fix for -[rclone #9722](https://github.com/rclone/rclone/issues/9722), a source-pinned API -bridge fix and a Proton file-data limiter that leaves metadata browsing outside -bulk transfer limits. The weekly updater stays on that reviewed PDrive build -until this project publishes a replacement and never restarts an active mount. -The optional official Proton Drive CLI is a separate client and is not required -by this project. +[rclone #9722](https://github.com/rclone/rclone/issues/9722), the API bridge +worker fix proposed in +[Proton-API-Bridge #8](https://github.com/rclone/Proton-API-Bridge/pull/8) and the +Proton file-data limiter tracked in +[rclone #9832](https://github.com/rclone/rclone/issues/9832). The limiter leaves +metadata browsing outside bulk transfer limits. The weekly updater stays on +that reviewed PDrive build until this project publishes a replacement and never +restarts an active mount. The optional official Proton Drive CLI is a separate +client and is not required by this project. ## Uninstall diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 6dd6d6d..c2e7fe7 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -109,6 +109,11 @@ The installed binary comes from the public [`oss-singularity/Proton-API-Bridge`](https://github.com/oss-singularity/Proton-API-Bridge) commit used to build the asset; the bridge worker-drain correction is proposed upstream in [Proton-API-Bridge PR #8](https://github.com/rclone/Proton-API-Bridge/pull/8). +The independent Proton file-data limiter, its reproduction measurements and the +public prototype are tracked in +[rclone issue #9832](https://github.com/rclone/rclone/issues/9832). Keep these +upstream efforts separate: one fixes leaked upload-worker slots after errors; +the other limits only bulk file readers so API metadata remains responsive. The Linux x86-64 asset is statically linked and its checksum is embedded in `pdrive-prerequisites` and published beside the release. diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.md index e42660c..bd2f33f 100644 --- a/docs/OPERATIONS.md +++ b/docs/OPERATIONS.md @@ -838,9 +838,12 @@ rclone release. `pdrive-prerequisites` verifies the embedded SHA-256 digest, minimum upload-safe version and required Proton backend command before atomic installation. The updater invokes that same verifier and does not follow rclone's official stable channel, because an otherwise newer binary may lack -PDrive's source-reviewed file-data limiter and bridge-worker fix. A newly -installed binary is intentionally left for the next natural mount start; the -updater never restarts an active transfer. +PDrive's source-reviewed file-data limiter and bridge-worker fix. Their upstream +review is tracked independently in +[rclone #9832](https://github.com/rclone/rclone/issues/9832) and +[Proton-API-Bridge #8](https://github.com/rclone/Proton-API-Bridge/pull/8). +A newly installed binary is intentionally left for the next natural mount +start; the updater never restarts an active transfer. The optional official Proton Drive CLI timer runs five minutes after boot when due and daily with up to four hours of randomized delay. Its updater accepts diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 1e505d4..8fc56b3 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -397,9 +397,12 @@ The upstream correction is tracked in [rclone #9722](https://github.com/rclone/rclone/issues/9722). New toolkit installations use a pinned, checksum-verified PDrive rclone build based on the fixed beta. Its source also pins the API bridge worker-drain correction and adds -the file-data-only limiter. The weekly updater keeps this reviewed build until -PDrive publishes a replacement instead of replacing it with an incompatible -official binary. +the file-data-only limiter. The bridge correction is proposed upstream in +[Proton-API-Bridge #8](https://github.com/rclone/Proton-API-Bridge/pull/8), while +the limiter's measurements and proposed backend contract are tracked in +[rclone #9832](https://github.com/rclone/rclone/issues/9832). The weekly updater +keeps this reviewed build until PDrive publishes a replacement instead of +replacing it with an incompatible official binary. The guarded helper does not treat an ordinary 100% transfer as stalled. It requires a terminal backend error in the completion window, a fixed rclone,