Fix JSDoc and comments

Author: tmacro

lib/api/apiUtils/rateLimit/gcra.js

@@ -14,10 +14,9 @@
  * - 600 req/s ÷ 6 nodes = 100 req/s per node → interval = 100ms
  *
  * Dynamic work-stealing is achieved through Redis sync reconciliation:
- * - Each worker evaluates locally at its fixed per-worker quota
- * - Workers report consumed / workers to Redis
- * - Redis sums all workers' shares
- * - Workers overwrite local counters with Redis values
+ * - Each worker evaluates locally using preallocated tokens
+ * - Workers report processed requests to Redis
+ * - Redis sums all workers' requests
  * - Idle workers' unused capacity accumulates in Redis
  * - Busy workers pull back higher emptyAt values and throttle proportionally
  *

lib/api/apiUtils/rateLimit/tokenBucket.js

@@ -176,7 +176,9 @@ class WorkerTokenBucket {
 /**
  * Get or create token bucket for a bucket
  *
- * @param {string} bucketName - Bucket name
+ * @param {string} resourceClass - "bucket" or "account"
+ * @param {string} resourceId - bucket name or account canonicalId
+ * @param {string} measure - measure id e.g. "rps"
  * @param {object} limitConfig - Rate limit configuration
  * @param {object} log - Logger instance
  * @returns {WorkerTokenBucket}
@@ -244,7 +246,9 @@ function cleanupTokenBuckets(maxIdleMs = 60000) {
 /**
  * Remove a specific token bucket (used when rate limit config is deleted)
  *
- * @param {string} bucketName - Bucket name
+ * @param {string} resourceClass - "bucket" or "account"
+ * @param {string} resourceId - bucket name or account canonicalId
+ * @param {string} measure - measure id e.g. "rps"
  * @returns {boolean} True if bucket was found and removed
  */
 function removeTokenBucket(resourceClass, resourceId, measure) {