feat(quota-planner): add phase-aware routing planner by Komzpa · Pull Request #737 · Soju06/codex-lb

Komzpa · 2026-05-20T18:59:51Z

Summary

add quota planner settings, decision log, window observations, request_kind accounting, scheduler, and dashboard APIs
enable safe shadow planning by default: dry-run, no synthetic traffic, soft routing costs only, and test lifespan disables the background scheduler explicitly
add deterministic demand forecast/simulation, phase-aware routing costs, reserve/warmup decisions, frontend settings/forecast/decision UI, and docs
add a gated warmup actuator with admin warm-now/cancel, normal request logging, optional API-key reservation/finalization, warmup effect observations, budgets, and best-effort effect refresh
extend warmup planning beyond “once per cycle”: candidate starts now target demand peaks, work-block offsets, demand/capacity crossings, and active-reset spacing; flat/low-demand cycles produce auditable no-op rows instead of starting cold accounts
expose target peak, scheduled time, expected gain/cost, no-op/skip reason, and warmup_cycle details through the API/UI decision timeline

Verification

make lint
make typecheck
uv run pytest tests/unit/test_quota_planner.py tests/integration/test_quota_planner_api.py tests/unit/test_request_logs_repository.py tests/test_request_logs_options_api.py (24 passed)
cd frontend && bun run lint
cd frontend && bun run typecheck
cd frontend && bun run test:coverage (73 files / 420 tests)
temp SQLite uv run codex-lb-db upgrade head && uv run codex-lb-db check
rg -n "peak|stagger|warmup_cycle|no_op|warmup_probe|request_kind.*warmup|QuotaWarmupService" app/modules/quota_planner tests docs frontend/src/features/quota-planner

Notes

Synthetic warmup traffic remains gated off by default and is not emitted unless auto/synthetic/dry-run/budget/effect checks all allow it. The default path is non-blocking and degrades to normal routing when planner inputs are missing or stale.
Warmup failures return auditable skipped/failed decisions; usage-effect refresh is best-effort so it cannot turn a handled probe result into a stuck planned decision.
feat(automations): scheduled cycles, grouped runs, and run details UI #438’s generic automation/job framework is not required for this feature: the scheduler/control loop owns quota phase decisions, while QuotaWarmupService remains the actuator and accounting path.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7d644996a7

ℹ️ 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".

Soju06 · 2026-05-21T11:04:09Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 42d238eaa7

ℹ️ 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".

Soju06 · 2026-05-21T11:33:01Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ad7fc13370

ℹ️ 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".

Soju06 · 2026-05-21T12:28:52Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ce54ff8299

ℹ️ 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".

Soju06 · 2026-05-21T13:05:20Z

@codex review

Soju06 · 2026-06-01T13:44:22Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ead36b5b55

ℹ️ 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".

Soju06 · 2026-06-01T14:23:19Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b904927e5b

ℹ️ 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".

Soju06 · 2026-06-01T15:04:08Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 88f6b2bda9

ℹ️ 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".

Soju06 · 2026-06-01T15:30:05Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 91f6a88c62

ℹ️ 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".

Soju06 · 2026-06-01T16:04:41Z

@codex review

Komzpa · 2026-06-01T16:04:45Z

@codex review

chatgpt-codex-connector · 2026-06-01T16:10:49Z

Codex Review: Didn't find any major issues. Can't wait for the next one!

ℹ️ 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".

Komzpa · 2026-06-02T02:50:26Z

Folded into #716.

#716 is the surviving main-based routing/quota branch for this bucket. It includes the routing/quota changes from this PR, has current-head CI green, and has a clean current-head Codex review, so this separate PR can be closed to keep the queue reviewable.

chatgpt-codex-connector Bot reviewed May 20, 2026

View reviewed changes

Comment thread app/modules/proxy/repo_bundle.py Outdated

Komzpa force-pushed the feature/quota-phase-planner branch 3 times, most recently from 7302627 to d42aa27 Compare May 20, 2026 19:58

Komzpa mentioned this pull request May 20, 2026

feat(automations): scheduled cycles, grouped runs, and run details UI #438

Open

Komzpa force-pushed the feature/quota-phase-planner branch 2 times, most recently from 8a20570 to 42d238e Compare May 21, 2026 10:50

chatgpt-codex-connector Bot reviewed May 21, 2026

View reviewed changes

Comment thread app/modules/quota_planner/warmup.py

Comment thread app/modules/proxy/load_balancer.py Outdated

Comment thread openspec/specs/quota-phase-planner/context.md

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Komzpa force-pushed the feature/quota-phase-planner branch from 42d238e to ad7fc13 Compare May 21, 2026 11:19

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

chatgpt-codex-connector Bot reviewed May 21, 2026

View reviewed changes

Comment thread app/modules/quota_planner/scheduler.py Outdated

Comment thread app/modules/proxy/load_balancer.py Outdated

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Komzpa force-pushed the feature/quota-phase-planner branch from ad7fc13 to ce54ff8 Compare May 21, 2026 12:15

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

chatgpt-codex-connector Bot reviewed May 21, 2026

View reviewed changes

Comment thread app/modules/quota_planner/scheduler.py Outdated

Comment thread app/modules/quota_planner/logic.py Outdated

Comment thread app/modules/quota_planner/logic.py

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Komzpa force-pushed the feature/quota-phase-planner branch from ce54ff8 to 5b01d3f Compare May 21, 2026 12:49

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Komzpa mentioned this pull request May 21, 2026

Tested live aggregate stack and suggested merge order #554

Closed

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label May 21, 2026

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label Jun 1, 2026

fix(quota-planner): address scheduler review findings

ead36b5

chatgpt-codex-connector Bot reviewed Jun 1, 2026

View reviewed changes

Comment thread app/modules/quota_planner/warmup.py Outdated

Comment thread app/modules/quota_planner/warmup.py

Komzpa added 2 commits June 1, 2026 18:02

fix(pr737): harden quota warmup evidence and cancellation

747100b

style(pr737): format quota planner cancellation test

b904927

Komzpa removed the 🤖 codex: needs work [@codex review] raised an issue label Jun 1, 2026

chatgpt-codex-connector Bot reviewed Jun 1, 2026

View reviewed changes

Comment thread app/modules/quota_planner/logic.py Outdated

Comment thread app/modules/quota_planner/warmup.py Outdated

Soju06 added 🤖 codex: needs work [@codex review] raised an issue and removed 🤖 codex: needs work [@codex review] raised an issue labels Jun 1, 2026

Komzpa force-pushed the feature/quota-phase-planner branch from edf291c to 88f6b2b Compare June 1, 2026 14:48

chatgpt-codex-connector Bot reviewed Jun 1, 2026

View reviewed changes

Comment thread app/modules/quota_planner/logic.py Outdated

Komzpa added the 🤖 codex: needs work [@codex review] raised an issue label Jun 1, 2026

fix(quota-planner): harden warmup capacity accounting

91f6a88

Komzpa force-pushed the feature/quota-phase-planner branch from 88f6b2b to 91f6a88 Compare June 1, 2026 15:15

Soju06 removed the 🤖 codex: needs work [@codex review] raised an issue label Jun 1, 2026

chatgpt-codex-connector Bot reviewed Jun 1, 2026

View reviewed changes

Comment thread app/core/balancer/logic.py

Soju06 added the 🤖 codex: needs work [@codex review] raised an issue label Jun 1, 2026

fix(balancer): apply planner costs to relative availability

b9e8a37

Soju06 removed the 🤖 codex: needs work [@codex review] raised an issue label Jun 1, 2026

Soju06 added the 🤖 codex: ok [@codex review] says no issues found. label Jun 1, 2026

Komzpa mentioned this pull request Jun 1, 2026

feat(proxy): restore opportunistic traffic class on main #716

Open

Komzpa closed this Jun 2, 2026

Conversation

Komzpa commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Verification

Notes

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Soju06 commented May 21, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Soju06 commented May 21, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Soju06 commented May 21, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Soju06 commented May 21, 2026

Uh oh!

Soju06 commented Jun 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Soju06 commented Jun 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Soju06 commented Jun 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Soju06 commented Jun 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Soju06 commented Jun 1, 2026

Uh oh!

Komzpa commented Jun 1, 2026

Uh oh!

chatgpt-codex-connector Bot commented Jun 1, 2026

Uh oh!

Komzpa commented Jun 2, 2026

Uh oh!

Reviewers

Assignees

Komzpa commented May 20, 2026 •

edited

Loading