Skip to content

Commit 936aef8

Browse files
committed
Merge remote-tracking branch 'upstream/dev' into codex/fastwire-chat-tier-copy
2 parents c603dcd + 90fdc3a commit 936aef8

179 files changed

Lines changed: 3776 additions & 603 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.gitignore‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,12 @@ devlog/**/security-advisory-draft*
5151
.worktrees/
5252

5353
# Test-generated artifacts
54-
tests/.tmp-*/
54+
# Trailing slash matched directories only, but the same tests also leave plain
55+
# files behind when a run dies mid-write -- and on Windows those can stay locked
56+
# by an exiting child, so they cannot simply be deleted. An unignorable leftover
57+
# blocks the release preflight's clean-tree check for work that has nothing to do
58+
# with it, so ignore both shapes.
59+
tests/.tmp-*
5560
.claude/
5661

5762
# Retired Go native-runtime experiment. `go/` is not part of the build, the
Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# 012 — 후속: Codex가 998k를 보여주는 문제 (context_window는 표시가 아니라 예산)
2+
3+
## 증상
4+
5+
사용자가 배포된 v2.23.0으로 Codex를 열었더니 컨텍스트 표시가 `27k / 998k tokens used`였다.
6+
우리가 광고한 값은 1,050,000인데 998k가 나온다.
7+
8+
## 원인
9+
10+
Codex는 `context_window`를 **입력 예산**으로 쓴다. 표시값 998k는
11+
`1,050,000 - 52,000`이며, 52k는 시스템 프롬프트 + 툴 정의 베이스라인이다.
12+
13+
즉 사용자가 998k까지 채우도록 유도되는데, 실측 상한은 922k다. 76k 초과다.
14+
세션 후반에 `context_length_exceeded`를 맞는 구조이며, 이는 010에서
15+
auto-compaction을 945,000이 아니라 922,000으로 클램프한 것과 **같은 이유**의 문제다.
16+
그때는 compaction만 고쳤고, 광고 창 자체는 그대로 뒀다.
17+
18+
기존 네이티브 행들의 비율을 보면 Codex 계약이 분명하다:
19+
20+
| slug | context_window | auto_compact | 비율 |
21+
| --- | --- | --- | --- |
22+
| gpt-5.4 | 1,000,000 | 900,000 | 0.90 |
23+
| gpt-5.5 | 272,000 | 244,800 | 0.90 |
24+
| gpt-5.3-codex-spark | 100,000 | 90,000 | 0.90 |
25+
| gpt-5.6-sol (배포됨) | 1,050,000 | 922,000 | 0.878 |
26+
27+
5.6만 비율이 어긋나 있다. 창을 실제 상한보다 크게 잡고 compaction으로만 막으려 했기 때문이다.
28+
29+
## 재측정 (2026-08-17, 배포 후 재확인)
30+
31+
| 목표 입력 | 결과 |
32+
| --- | --- |
33+
| 915,000 | 성공 (input_tokens 915,160) |
34+
| 921,000 | 성공 (input_tokens 921,160) |
35+
| 923,000 | `context_length_exceeded` |
36+
37+
922,000 경계는 그대로다.
38+
39+
## 선택지
40+
41+
| 안 | context_window | Codex 표시 | 평가 |
42+
| --- | --- | --- | --- |
43+
| A 현행 | 1,050,000 | ~998k | 실측 상한 76k 초과. 후반 실패 |
44+
| B 실측 상한 | 922,000 | ~870k | 실제로 되는 최대치. 초과 없음 |
45+
| C 라이브 값 | 872,000 | ~820k | 안전하지만 실측 대비 50k 손해 |
46+
47+
**B를 택한다.** 광고 창이 곧 입력 예산이므로, 그 값은 "실제로 넣을 수 있는 최대"여야 한다.
48+
C는 upstream이 보고하는 `max_context_window`에 충실하지만, 그 값 자체가 측정과 어긋난다
49+
(872k보다 큰 921k 입력이 실제로 통과한다). A는 사용자를 초과로 몰고 간다.
50+
51+
## 계약 변경
52+
53+
```
54+
NATIVE_GPT56_CONTEXT_WINDOW 1_050_000 -> 922_000
55+
NATIVE_GPT56_MAX_INPUT_TOKENS 922_000 (유지)
56+
auto_compact_token_limit 922_000 -> min(floor(922000*0.9), 922000) = 829_800
57+
```
58+
59+
auto-compact가 90% 규칙으로 돌아온다. 다른 네이티브 행과 같은 모양이 되고,
60+
010에서 넣은 `min(90%, maxInput)` 클램프는 그대로 유지된다 — 이제 90%가 더 작아서
61+
클램프가 발화하지 않을 뿐, 규칙이 사라지는 것은 아니다.
62+
63+
## 부수 영향
64+
65+
`[1m]` 마커가 사라진다. Claude/Desktop 경로는 `>= 1,000,000`을 1M 계약으로 읽는데
66+
922,000은 그 아래다. 010에서 "GPT-5.6이 처음으로 authoritative 1M 모델이 된다"고 한
67+
변화가 되돌아간다. 이것은 회귀가 아니라 **정정**이다 — 실제로 1M을 넣을 수 없는 모델에
68+
1M 마커를 다는 것이 #854가 막으려던 바로 그 상황이다.
69+
70+
따라서 010/020이 갱신한 테스트 중 1M 승격을 전제한 것들을 되돌린다.
71+
72+
## 범위
73+
74+
- `src/codex/catalog/metadata.ts` 상수 1개.
75+
- 1,050,000 / 922,000 기대값을 가진 테스트 갱신.
76+
- `[1m]` 관련 픽스처를 010 이전 형태로 복귀 (gpt-5.6-sol이 sub-1M 픽스처로 돌아감).
77+
- docs-site 및 structure SoT의 1,050,000 표기 수정.
78+
- API 키 경로(`openai-apikey`, OpenRouter)의 1,050,000은 **건드리지 않는다** — 그쪽은
79+
별도 계약이고 이번 측정 대상이 아니다.
80+
Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
# 013 — 감사 접기(R9): 998k의 진짜 원인과 970,000이라는 답
2+
3+
012의 진단은 틀렸다. 리뷰어가 뒤집었고, codex-rs 소스로 확인했다.
4+
5+
## R9#1 — 998k는 베이스라인 차감이 아니라 95% 규칙 (수용, 진단 교체)
6+
7+
```rust
8+
// codex-rs/protocol/src/openai_models.rs:355
9+
const fn default_effective_context_window_percent() -> i64 { 95 }
10+
11+
// codex-rs/core/src/session/turn_context.rs:208-214
12+
pub(crate) fn model_context_window(&self) -> Option<i64> {
13+
let pct = self.model_info.effective_context_window_percent;
14+
self.model_info.resolved_context_window()
15+
.map(|cw| cw.saturating_mul(pct) / 100)
16+
}
17+
```
18+
19+
`context_window.rs:54`가 이 값을 `full_context_window_limit`으로 쓴다. 즉 Codex가 실제로
20+
채우려는 한도는 `context_window × 0.95`다.
21+
22+
검산이 전부 맞는다:
23+
24+
| slug | context_window | ×95% | 표시 |
25+
| --- | --- | --- | --- |
26+
| gpt-5.6 (현재 배포) | 1,050,000 | 997,500 | **998k** |
27+
| gpt-5.4 | 1,000,000 | 950,000 | 950k |
28+
| gpt-5.5 | 272,000 | 258,400 | 258k |
29+
| gpt-5.3-codex-spark | 100,000 | 95,000 | 95k |
30+
31+
52k 베이스라인 가설은 우연히 5.6 한 줄에만 들어맞았다. 다른 행으로 교차검증했으면
32+
바로 깨졌을 것이다.
33+
34+
## 그래서 922,000이 아니라 970,000이다 (012의 결론 폐기)
35+
36+
012는 `context_window = 922,000`을 제안했다. 그러면 Codex 한도는
37+
`922,000 × 0.95 = 875,900`이 되어, **실측으로 통과하는 입력 46,100토큰을 그냥 버린다.**
38+
리뷰어의 지적이 정확하다.
39+
40+
목표를 다시 쓰면: **95%를 적용한 결과가 922,000 바로 아래가 되어야 한다.**
41+
42+
```
43+
필요한 ctx = 922,000 / 0.95 = 970,526
44+
채택값 = 970,000 -> 970,000 × 0.95 = 921,500
45+
```
46+
47+
921,500은 실측 통과 구간(921,160 성공 / 923,000 거절) 안에 있고 922,000을 넘지 않는다.
48+
화면에는 "922k"로 표시된다 — 사용자가 기대한 바로 그 숫자다.
49+
50+
970,526 대신 970,000을 쓰는 이유는 500토큰 여유이고, 반올림 표시가 동일하다.
51+
52+
| 안 | ctx | Codex 한도 | 평가 |
53+
| --- | --- | --- | --- |
54+
| 현행 | 1,050,000 | 997,500 | 상한 75,500 초과 |
55+
| 012안 | 922,000 | 875,900 | 46,100 손해 |
56+
| **채택** | **970,000** | **921,500** | 상한 바로 아래, 손실 없음 |
57+
58+
## auto_compact
59+
60+
`min(floor(970000*0.9), 922000) = min(873,000, 922,000) = 873,000`.
61+
90% 규칙이 자연스럽게 다시 작아지고, 010의 클램프는 유지된다(발화만 안 할 뿐).
62+
873,000은 Codex 한도 921,500보다 낮아 compaction이 한도 전에 돈다 — 정상이다.
63+
64+
## R9#2 — `[1m]` 파급이 전부 사라지는 게 아니다 (수용)
65+
66+
970,000도 1,000,000 미만이라 파급 자체는 012와 같지만, 리뷰어가 지적한 대로
67+
"전부 사라진다"는 서술이 틀렸다. 실제로는:
68+
69+
| 경로 | 970,000에서 |
70+
| --- | --- |
71+
| Claude `/v1/models` `[1m]` variant | 사라짐 |
72+
| Desktop `supports1m`/`prefer1m`, management chip | false |
73+
| subagent 정의 마커 | 제거됨 |
74+
| **main-session auto-context** | **여전히 붙음** — `970k >= compactWindow(350k)`이므로 |
75+
| 이미 명시된 `[1m]` selector | 그대로 통과 |
76+
77+
마지막 두 줄이 012가 놓친 부분이다. `autoContext:false`일 때만 안 붙는다.
78+
따라서 010 이전 상태로 일괄 되돌리면 안 되고, 경로별로 다르게 기대해야 한다.
79+
80+
## R9#3 — GUI 프리셋 (수용)
81+
82+
`NATIVE_CAP_OPTIONS`의 1,050,000은 이제 권위값 970,000보다 커서 아무 효과가 없는
83+
선택지가 된다(cap은 낮추기만 한다). `970_000`으로 교체한다.
84+
`fmtK(970_000)` = "970k"이므로 M 표기 테스트는 1,000,000 케이스로 유지한다.
85+
86+
## Daybreak
87+
88+
같은 상수를 공유하므로 970,000으로 함께 내려간다. 012에 빠졌던 파급이며, 명시한다.
89+
90+
## 유지하는 것
91+
92+
- API 키 경로(`openai-apikey`)와 OpenRouter의 1,050,000 / 922,000: 별도 provider 계약.
93+
Codex의 95% 규칙은 네이티브 카탈로그에만 적용된다.
94+
- `NATIVE_GPT56_MAX_INPUT_TOKENS = 922,000`: 입력 상한 자체는 변함없다.
95+
- `min(90%, maxInput)` 클램프: routed/API 경로에서 계속 필요하다.
96+
97+
## 갱신 대상 (리뷰어 전수 + Daybreak)
98+
99+
`tests/codex-catalog.test.ts`, `tests/codex-catalog-sync-hardening.test.ts`,
100+
`tests/codex-convergence-account-selectors.test.ts`, `tests/claude-context-windows.test.ts`,
101+
`tests/claude-desktop-native-context.test.ts`, `tests/claude-model-info.test.ts`,
102+
`tests/desktop-3p.test.ts`, `tests/grok-sync.test.ts`, `tests/native-model-toggle.test.ts`,
103+
`tests/route-explainability.test.ts`, `gui/tests/models-native-group-controls.test.ts`.
104+
API-key/routed 픽스처의 1.05M/922k는 건드리지 않는다.
105+
106+
문서는 native 주장만 수정한다 (`structure/08`, 각 로케일의 `guides/codex-app-models.md`,
107+
`guides/providers.md`, `reference/configuration/providers.md`).
108+
`structure/03`과 quickstart의 API-key 서술은 유지한다.
109+
Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# 014 — 최종 결정: 922,000 (970,000 안 철회)
2+
3+
013은 `context_window = 970,000`을 제안했다. 철회한다. 사용자 지적이 옳다.
4+
5+
## 970,000이 틀린 이유
6+
7+
013의 계산 자체는 맞다: `970,000 × 0.95 = 921,500`으로 측정 상한 922,000 바로 아래에 붙는다.
8+
문제는 그게 **목표가 되어서는 안 된다**는 점이다.
9+
10+
측정된 경계는 `921,160 성공 / 923,000 거절`이다. 921,500은 그 사이 1,840토큰 폭의
11+
틈에 정확히 착지시키는 값이다. 즉 마진이 사실상 없다. 토크나이저 차이, 툴 정의 변화,
12+
upstream의 미세 조정 하나에 바로 실패한다.
13+
14+
95%는 Codex가 이미 마련해 둔 안전 여유다. 그 여유를 "낭비"로 보고 정확히 상한까지
15+
소진하도록 ctx를 역산하는 것은 안전장치를 무력화하는 것이다.
16+
17+
## upstream이 실제로 하는 방식
18+
19+
라이브 카탈로그를 다시 읽으면 계약이 분명하다:
20+
21+
| slug | context_window | max_context_window | 여유 |
22+
| --- | --- | --- | --- |
23+
| gpt-5.6-sol | 272,000 | 872,000 | 600,000 |
24+
| gpt-5.4 | 272,000 | 1,000,000 | 728,000 |
25+
| gpt-5.5 | 272,000 | 272,000 | 0 |
26+
| gpt-5.3-codex-spark | 128,000 | 128,000 | 0 |
27+
28+
**`context_window`는 하드 상한이 아니라 운영 cap이다.** 5.6은 872k까지 갈 수 있는데도
29+
272k로 운영한다. 372k도 같은 성격의 값이었다 — 지원 한계가 아니라 우리가 정한 cap.
30+
31+
여기서 배울 점: cap은 상한에서 여유를 두고 정한다. 상한에 맞춰 역산하지 않는다.
32+
33+
## 채택: 922,000
34+
35+
```
36+
NATIVE_GPT56_CONTEXT_WINDOW 1_050_000 -> 922_000
37+
NATIVE_GPT56_MAX_INPUT_TOKENS 922_000 (유지)
38+
auto_compact_token_limit min(floor(922000*0.9), 922000) = 829_800
39+
```
40+
41+
| 지표 | 값 |
42+
| --- | --- |
43+
| Codex 실제 한도 (95%) | 875,900 |
44+
| 화면 표시 | ~876k |
45+
| 하드 상한(922,000)까지 마진 | 46,100 |
46+
| auto-compact 발동 | 829,800 (한도보다 46,100 아래) |
47+
48+
세 겹이 된다: compaction 829,800 → Codex 한도 875,900 → 실측 상한 922,000.
49+
각 단계마다 46k씩 여유가 있다.
50+
51+
## 세 안 비교 (최종)
52+
53+
| 안 | ctx | Codex 한도 | 상한까지 마진 | 판정 |
54+
| --- | --- | --- | --- | --- |
55+
| 배포된 현행 | 1,050,000 | 997,500 | **-75,500 (초과)** | 실패 유발 |
56+
| 013안 | 970,000 | 921,500 | 500 | 마진 없음 |
57+
| **채택** | **922,000** | **875,900** | **46,100** | 안전 |
58+
59+
## 나머지는 013 그대로
60+
61+
- `[1m]` 파급은 경로별로 다름 (main-session auto-context는 922k >= 350k라 계속 붙음).
62+
- `NATIVE_CAP_OPTIONS`의 1,050,000 -> 922,000.
63+
- Daybreak도 같은 상수라 함께 내려감.
64+
- API 키/OpenRouter의 1,050,000, `NATIVE_GPT56_MAX_INPUT_TOKENS = 922,000` 유지.
65+
- 갱신 대상 테스트 11개 파일은 013의 목록 그대로.
66+
67+
## 남는 질문 (사용자 판단 영역, 이번엔 미적용)
68+
69+
872k(라이브 `max_context_window`)를 넘어서는 값을 광고해도 되는가?
70+
922,000은 upstream이 보고하는 872,000보다 크다. 실측으로는 921,160이 통과하므로
71+
872,000은 하드 상한이 아니지만, upstream 보고값을 넘는 광고라는 점은 기록해 둔다.
72+
더 보수적으로 가려면 872,000(→ 95% 후 828,400)이 선택지다.
73+
Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
# 050 — WP6: `ocx sync`가 켜진 클라이언트 통합까지 동기화
2+
3+
## 문제
4+
5+
`ocx sync`는 Codex 카탈로그만 쓴다.
6+
7+
```ts
8+
// src/server/management/config-routes.ts:383-395
9+
if (url.pathname === "/api/sync" && req.method === "POST") {
10+
const { syncModelsToCodex } = await import("../../codex/sync");
11+
const result = await syncModelsToCodex(runtime?.port, loadConfig(), null);
12+
...
13+
}
14+
```
15+
16+
Grok이나 Claude Desktop 토글이 켜져 있어도 갱신되지 않는다. 이번 컨텍스트 변경
17+
(1,050,000 -> 922,000)처럼 값이 바뀌면 Codex만 새 값을 받고 나머지는 옛 값에 머문다.
18+
사용자가 "모델 세팅할 때도 그렇고"라고 한 상황이 이것이다.
19+
20+
## 이미 있는 것
21+
22+
기동 경로는 각 통합을 **켜진 것만** 동기화한다:
23+
24+
| 통합 | 게이트 | 위치 |
25+
| --- | --- | --- |
26+
| Codex | `syncCodexOnStartIfEnabled` | `src/cli/index.ts:379` |
27+
| Grok | `shouldSyncGrokOnStart(config)` | `src/cli/index.ts:412-419` |
28+
| Claude Desktop | `claudeDesktopIntegrationEnabledNow()` | `src/cli/claude-desktop.ts` |
29+
30+
게이트 함수(`grokIntegrationEnabled`, `claudeDesktopIntegrationEnabled`)는
31+
`src/codex/desired-state.ts`에 이미 있다. 새로 만들 상태가 없다.
32+
33+
즉 `/api/sync`가 기동 경로와 같은 규칙을 따르기만 하면 된다.
34+
35+
## 설계
36+
37+
`/api/sync`를 다음 순서로 바꾼다.
38+
39+
1. `syncModelsToCodex` — 지금과 동일. Codex 카탈로그가 다른 통합의 입력이므로 먼저 돈다.
40+
2. `grokIntegrationEnabled(config)`이면 `syncGrokConfig(port, config, ...)`.
41+
3. `claudeDesktopIntegrationEnabled(config)`이면 Desktop writer.
42+
43+
**부분 실패는 전체 실패가 아니다.** Codex sync가 성공하고 Grok이 실패하면 200을 유지하되
44+
응답에 통합별 결과를 싣는다. 기동 경로가 이미 그렇게 한다 — Grok 실패가 start를 막지 않는다.
45+
46+
응답 형태:
47+
48+
```json
49+
{
50+
"ok": true,
51+
"...codex 기존 필드...": "…",
52+
"integrations": [
53+
{ "client": "grok", "ok": true, "changed": true },
54+
{ "client": "claude-desktop", "ok": false, "reason": "…" }
55+
]
56+
}
57+
```
58+
59+
꺼진 통합은 배열에 넣지 않는다 — "건드리지 않았다"와 "실패했다"를 구분해야 한다.
60+
61+
## 범위 밖
62+
63+
- 통합을 자동으로 켜지 않는다. `ocx sync`는 동기화 명령이지 활성화 명령이 아니다.
64+
- 새 CLI 플래그를 만들지 않는다. 기존 `ocx sync`의 동작이 넓어질 뿐이다.
65+
- Codex sync가 `refused`(409)면 나머지도 돌리지 않는다 — 카탈로그가 안 써졌으면
66+
하위 통합이 읽을 새 값이 없다.
67+
68+
## 테스트
69+
70+
- Grok on / Desktop off: Grok만 배열에 나오고 Desktop 설정 파일은 mtime 불변.
71+
- 둘 다 off: 배열이 비고 Codex만 갱신 (현행 동작과 동일).
72+
- Grok 실패: HTTP 200 유지, `integrations[0].ok === false`, Codex 결과는 성공으로 보고.
73+
- Codex refused: 409이고 `integrations`가 비어 있음.
74+
- 값 전파: 컨텍스트 상수를 바꾼 뒤 sync 한 번으로 `~/.grok/config.toml`의
75+
`context_window`가 새 값이 되는지 (C-ACTIVATION-GROUNDING-01).
76+
77+
## 검증 명령
78+
79+
`bun test --isolate tests/management-sync.test.ts tests/grok-sync.test.ts` (해당 파일 확인 후 확정),
80+
`bun x tsc --noEmit`.
81+

0 commit comments

Comments
 (0)