Skip to content

fix(quota-gatherer): bound provider concurrency + retain last-known snapshot on error (#1268) - #3996

Merged
dezren39 merged 2 commits into
mainfrom
queue/4978-1268-quota-gatherer-bounds
Nov 1, 2026
Merged

dezren39 merged 2 commits into
mainfrom
queue/4978-1268-quota-gatherer-bounds

Conversation

@dezren39

@dezren39 dezren39 commented Nov 1, 2026 •

Copy link
Copy Markdown
Member

Follow-up to issue #1268 from triage task 2527 (queue task 4978). The CLI half of #1268 already landed in OpenChamber; these are the two remaining gatherer gaps in pm-stack/aggregator/scripts/gather-quota.ts:

1. Bounded provider concurrency — the tick no longer fires one unbounded Promise.all over the whole provider catalogue (~30 simultaneous dashboard fetches). Providers now run through mapWithConcurrency (new, in src/quota-gather-map.ts where it is unit-testable): default 6 in flight — matching the CLI — configurable via QUOTA_GATHER_CONCURRENCY. A non-positive/invalid limit degrades to sequential, never back to unbounded; results keep catalogue order.

2. Last-known retention on timeout/error — an errored provider run with no ok row of its own no longer writes fresh error entries over (or drops) its last good data. The gatherer reads the previous tick's quota-current.json and retains that provider's ok entries verbatim (lastKnownEntries, also in quota-gather-map.ts). Retained entries keep their original measuredAt, so the hub's existing freshness classification surfaces them as stale — visible staleness, not fresh-looking data. The heartbeat still reports the run as error with its reason, now with the retained row count, and the tick log marks the run retained-last-known. Partial failures (some credential rows ok) keep the fresh entries untouched, as before.

Tests — test/quota-gather-map.test.ts gains 6 tests: concurrency bound enforced (max in-flight == limit) with order preserved, over-large limit, empty input, invalid limit degrading to sequential, rejection propagation; retention returns ok entries verbatim and never error/unconfigured or unknown-provider entries. Laptop results: quota test files 94/94 pass; full aggregator suite 926 pass / 1 fail — the slice3 registry failure is identical on clean main in this environment (pre-existing, unrelated); tsc --noEmit shows the same 12 pre-existing errors as main, none in the changed files; bun build of the gatherer script succeeds.

Scope note: #1268 itself stays open — this packet covers the gatherer follow-up only (the parent issue also tracks the broader perf item); the issue gets the completion note, not a close.

🤖 Queue worker (repo-worker-code), lane A — task 4978


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need.

@dezren39
dezren39 requested a review from a team as a code owner November 1, 2026 21:23
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-01T21:31:35.008703Z 6190a8c Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai

coderabbitai Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 38 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: c93a96bc-44e2-44d6-ad27-6bfcc5527a6b
Commits

Reviewing files that changed from the base of the PR and between 83709fa and 6190a8c.

Files selected for processing: 6
  • pm-stack/aggregator/scripts/gather-quota.ts
  • pm-stack/aggregator/src/model.ts
  • pm-stack/aggregator/src/quota-current.ts
  • pm-stack/aggregator/src/quota-gather-map.ts
  • pm-stack/aggregator/test/quota-current.test.ts
  • pm-stack/aggregator/test/quota-gather-map.test.ts
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2676120ed1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +443 to +444
run.entries = retained;
run.retained = true;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Surface failed fetches when retaining last-known entries

When a provider fails on the normal 15-minute tick, its retained entries are typically only 15 minutes old and still have state: "ok". quota-current.ts considers those entries fresh for 20 minutes, and both overlayQuotaCurrent() and summarize() ignore the heartbeat's per-provider error. Consequently, the failed fetch now appears healthy/current for roughly five minutes instead of surfacing the failure immediately; preserving measuredAt alone does not make retained data stale. Carry an explicit retention/failure signal through to the reader so it can display last-known data without reporting the failed provider as current.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed in the follow-up commit on this PR — thank you, the 15-min tick vs 20-min freshness bound point is correct and preservation of measuredAt alone was not enough.

What changed:

  • QuotaCurrentEntry gains an explicit retainedFromFailedTick?: string marker (model.ts), stamped by the gatherer on retained copies via the new markRetained helper (quota-gather-map.ts) — original measuredAt preserved, previous-tick objects untouched.
  • entryState() in quota-current.ts — the single classification point behind both overlayQuotaCurrent() and summarize() — now classifies any entry carrying the marker as stale immediately, regardless of the freshness bound. The pool keeps showing the last-known windows under the stale state instead of reading healthy/current.
  • Tests: quota-current.test.ts gains "a retained entry is stale immediately, even inside the freshness bound (perf(quota-plane): parallel provider fetching + per-provider timeout budget for the 15-min tick #1268)" (entry 5 min old + marker → pool stale, dated windows kept); quota-gather-map.test.ts gains the markRetained copy/stamp test. Quota test files: 96/96 pass on the laptop.

The heartbeat per-provider error also remains as before; the reader-facing signal is now the entry marker + stale classification.

@dezren39

dezren39 commented Nov 1, 2026

Copy link
Copy Markdown
Member Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. More of your lovely PRs please.

Reviewed commit: 6190a8cc62

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant