[Bug] Codex Auth: primary_window가 월간(≈30d)인데 UI/API가 주간(Week)으로 표시됨 #315

요약

Codex Auth 계정 풀에서 일부 Team 계정은 WHAM primary_window.limit_window_seconds=2628000(약 30.4일)인데, OpenCodex가 이를 무조건 weeklyPercent/Week로 매핑합니다.
결과적으로 월간 한도 계정이 대시보드와 /api/codex-auth/accounts에서 주간 한도로 잘못 표시됩니다.

환경

• OpenCodex: 2.7.33 (@bitkyc08/opencodex)
• OS: WSL2 / Linux
• Dashboard: http://localhost:10100/#codex-auth
• OpenAI account mode: Pool mode

재현 결과 (실측)

같은 Team plan이라도 limit_window_seconds가 계정별로 다릅니다.
(계정 alias / email / account id는 마스킹)

chatgpt.com/backend-api/wham/usage 원본(민감정보 제외):

{
  "account": "monthly-1",
  "plan_type": "team",
  "primary_window": {
    "used_percent": 6,
    "reset_at": 1787336442,
    "limit_window_seconds": 2628000,
    "reset_after_seconds": 2549330
  },
  "secondary_window": null,
  "tertiary_window": null
}

{
  "account": "monthly-2",
  "plan_type": "team",
  "primary_window": {
    "used_percent": 39,
    "reset_at": 1787401330,
    "limit_window_seconds": 2628000,
    "reset_after_seconds": 2614217
  },
  "secondary_window": null,
  "tertiary_window": null
}

반면 OpenCodex /api/codex-auth/accounts?refresh=1 응답은 위 계정들을 모두 주간으로 내립니다:

{
  "account": "monthly-1",
  "quota": {
    "weeklyPercent": 6,
    "weeklyResetAt": 1787336442,
    "resetCredits": 0
  }
}

{
  "account": "monthly-2",
  "quota": {
    "weeklyPercent": 38,
    "weeklyResetAt": 1787401330,
    "resetCredits": 0
  }
}

대시보드 Codex Auth UI도 두 월간 계정 모두 Week로 표시합니다.

원인 추정

src/codex/quota.ts의 parseUsageQuota()가 primary_window를 항상 weekly로 취급합니다.

// primary_window was the 5h window; it now carries weekly data for GPT plans.
// secondary_window is the legacy weekly source; prefer primary when present.
const weeklyPercent = primaryPercent ?? secondaryPercent;
const monthlyPercent = normalizeUsagePercent(data.rate_limit.tertiary_window?.used_percent);

또한 WhamUsageResponse 타입에 limit_window_seconds가 없어, 실제 윈도우 길이로 주간/월간을 구분하지 않습니다.
월간은 tertiary_window만 본다고 가정하지만, 위 Team 계정은 primary_window만 있고 그 값이 월간입니다.

영향

1. Codex Auth UI에서 월간 한도가 Week로 오표시됨
2. /api/codex-auth/accounts가 monthlyPercent 대신 weeklyPercent만 반환
3. 계정 로테이션/usage score가 잘못된 window를 기준으로 동작할 수 있음

기대 동작

• limit_window_seconds ≈ 604800 → weekly (weeklyPercent / Week)
• limit_window_seconds ≈ 2628000(또는 30d 근처) → monthly (monthlyPercent / 30d/Month)
• 가능하면 window 길이(또는 명시 필드)로 판별하고, plan_type만으로 하드코딩하지 않기

제안 수정

1. WHAM window 타입에 limit_window_seconds 반영
2. parseUsageQuota()에서 window 길이로 weekly/monthly 분류
3. Codex Auth UI는 monthlyPercent가 있으면 30d/Month로 표시
4. 회귀 테스트: weekly(7d) primary / monthly(≈30d) primary / tertiary monthly 케이스

참고

• 재현 시점: 2026-07-23
• 동일 증상 open/closed 이슈는 검색 시 확인되지 않음