Skip to content

Commit f73fcc5

Browse files
committed
docs(devlog): fold the seven-lane feasibility audit into lane ownership and scope
1 parent cc871a8 commit f73fcc5

5 files changed

Lines changed: 155 additions & 16 deletions

File tree

‎devlog/_plan/260911_lane_dispatch_round/000_plan.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,10 @@ Excluded on purpose, with the decision that blocks each one:
3434
- #4198, #4179 — publishing an official container image changes a documented policy
3535
("opencodex does not publish an official container image").
3636
- #4173 — the atomic update design competes with #4185 and #4203 already in flight.
37+
- #4204 — removed after the feasibility audit: binding the reasoning-effort clamp to the Desktop
38+
runtime needs `codex/runtime.ts`, `catalog/bundled.ts`, and `catalog/sync.ts`, because the catalog
39+
probes one selected runtime and no caller passes a consumer identity. Resolving a catalog per
40+
consumer is a design decision.
3741
- Contributor feature PRs (#4183, #4100, #4111, #4193, #4033, #4042) — these need review, not
3842
reimplementation, and reimplementing them would discard the author's work.
3943

@@ -68,4 +72,3 @@ are repeated inside every packet so a lane thread that never reads this file sti
6872
Merges are serialized through the orchestrator because `dev` is protected and shared. A lane PR
6973
merges when its exact head is green on final-head CI; the landing is proven by fetching `origin/dev`
7074
and checking ancestry, never by the merge command's own output.
71-

‎devlog/_plan/260911_lane_dispatch_round/010_lane_partition.md‎

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,13 +38,14 @@ Collision-free PRs, touching no file any other open PR touches: #4062, #4104, #4
3838
**L2** `codex/260911-l2-catalog-provider` — `src/providers/quota.ts`,
3939
`src/providers/quota-types.ts`, `src/providers/quota-wire.ts`,
4040
`src/providers/quota-routing-cache.ts`, `src/providers/quota-key-accounts.ts`,
41-
`src/providers/account-quota-disk.ts`, `src/providers/registry.ts`. Stack: #4201.
41+
`src/providers/account-quota-disk.ts`, `src/providers/registry.ts`, and the roster oracle
42+
`tests/providers/provider-registry-parity.test.ts`. Stack: #4201.
4243

4344
**L3** `codex/260911-l3-account-pool` — `src/codex/account-usability.ts`,
4445
`src/codex/account-pause.ts`, `src/codex/account-store.ts`, `src/codex/account-runtime-state.ts`,
4546
`src/codex/plan.ts`, `src/codex/plan-from-token.ts`, `src/codex/warmup.ts`,
4647
`src/codex/model-entitlements.ts`, `src/server/responses/codex-auth-error.ts`,
47-
`src/server/management/oauth-account-routes.ts`, the single key `codexPool.excludedPlans` in
48+
`src/codex/auth-api.ts`, `src/codex/routing.ts`, `src/types/config.ts`, the single key `codexPool.excludedPlans` in
4849
`src/config.ts`, and `docs-site/src/content/docs/guides/codex-integration.md` and its seven locale copies under
4950
`docs-site/src/content/docs/{fr,ja,ko,ru,tr,zh-cn,zh-tw}/guides/codex-integration.md`.
5051
Stack: #4126 → #4212 → #4211.
@@ -53,10 +54,11 @@ Stack: #4126 → #4212 → #4211.
5354
`bin/ocx.mjs`, `src/cli.ts`, `src/service.ts`, `src/config/pending-teardown.ts`,
5455
`src/lib/bun-runtime.ts`, `src/lib/package-tree-integrity.ts`, `src/lib/process-control.ts`,
5556
`src/codex/catalog/effort.ts`, `src/codex/cli-install-provenance.ts`,
56-
`docs-site/src/content/docs/getting-started/installation.md`. Stack: #4202 → #4169 → #4204 → #4207.
57+
`docs-site/src/content/docs/getting-started/installation.md`. Stack: #4202 → #4169 → #4207.
5758

58-
**L5** `codex/260911-l5-integrations-io` — directory `src/integrations/`; file
59-
`src/config/atomic-write.ts`. Stack: #4197 → #4214.
59+
**L5** `codex/260911-l5-integrations-io` — directory `src/integrations/`; files
60+
`src/config/atomic-write.ts`, `src/clients/config-export.ts`,
61+
`src/clients/config-export/contracts.ts`. Stack: #4197 → #4214.
6062

6163
**L6** `codex/260911-l6-streaming-tools` — `src/server/responses/codex-ws-exchange.ts`,
6264
`src/server/responses/codex-ws-wire.ts`, directory `src/adapters/qoder/`. Stack: #4191 → #4190.
@@ -73,3 +75,10 @@ Stack: #4126 → #4212 → #4211.
7375
- `src/config.ts`: only L3, and only `codexPool.excludedPlans`.
7476
- `docs-site/src/content/docs/guides/providers.md`: L7 only. A lane whose carried PR edits it drops
7577
that hunk and reports the wording to the orchestrator.
78+
79+
## Amendments from the seven-lane feasibility audit
80+
81+
Ownership above already carries them; `130_wp4_feasibility.md` records why each was granted. In short:
82+
L2 gained the roster oracle it must update, L3 traded `oauth-account-routes.ts` for the Codex account
83+
surface `auth-api.ts` plus `routing.ts` and `types/config.ts`, L5 gained the export-client contract,
84+
and #4204 left the round because binding the clamp to the Desktop runtime is a design decision.

‎devlog/_plan/260911_lane_dispatch_round/020_lane_packets.md‎

Lines changed: 31 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,10 @@ Owned: `src/server/responses/core.ts`, `src/server/responses/compact.ts`,
9595
Worktree `~/.codex/worktrees/260911-l2/opencodex`, branch `codex/260911-l2-catalog-provider`.
9696

9797
Owned: `src/providers/quota.ts`, `quota-types.ts`, `quota-wire.ts`, `quota-routing-cache.ts`,
98-
`quota-key-accounts.ts`, `account-quota-disk.ts`, `registry.ts` (all under `src/providers/`).
98+
`quota-key-accounts.ts`, `account-quota-disk.ts`, `registry.ts` (all under `src/providers/`), plus
99+
`tests/providers/provider-registry-parity.test.ts`, the oracle that locks the roster you are changing:
100+
it asserts the two-model list at `:464` and that `glm-5.3-flash` is absent at `:508`, so the catalog
101+
half cannot land without updating it.
99102

100103
1. **#4201 — BigModel Responses Coding Plan: missing quota probe and GLM-5.3-Flash catalog support**
101104
(reporter `bluesmilery`). **Decision: do not build on #4210.** It is an open draft by `Ingwannu`
@@ -111,9 +114,9 @@ Owned: `src/providers/quota.ts`, `quota-types.ts`, `quota-wire.ts`, `quota-routi
111114
Worktree `~/.codex/worktrees/260911-l3/opencodex`, branch `codex/260911-l3-account-pool`.
112115

113116
Owned: `src/codex/account-usability.ts`, `account-pause.ts`, `account-store.ts`,
114-
`account-runtime-state.ts`, `plan.ts`, `plan-from-token.ts`, `warmup.ts`, `model-entitlements.ts`
115-
(all under `src/codex/`), plus `src/server/responses/codex-auth-error.ts`,
116-
`src/server/management/oauth-account-routes.ts`, the single key `codexPool.excludedPlans` in
117+
`account-runtime-state.ts`, `plan.ts`, `plan-from-token.ts`, `warmup.ts`, `model-entitlements.ts`, `auth-api.ts`, `routing.ts`
118+
(all under `src/codex/`), plus `src/server/responses/codex-auth-error.ts`, `src/types/config.ts`,
119+
the single key `codexPool.excludedPlans` in
117120
`src/config.ts`, and `docs-site/src/content/docs/guides/codex-integration.md` and its seven locale copies under
118121
`docs-site/src/content/docs/{fr,ja,ko,ru,tr,zh-cn,zh-tw}/guides/codex-integration.md`.
119122

@@ -124,10 +127,17 @@ Owned: `src/codex/account-usability.ts`, `account-pause.ts`, `account-store.ts`,
124127
2. **#4212 — an account stuck on a failed credential refresh silently drops its models.** The ask is
125128
attribution, not new routing. **Decision: this round covers the refusal string
126129
(`codex-auth-error.ts:35`), the account-health surface, and the management route
127-
(`oauth-account-routes.ts`). It does not change the L1 refusal call sites at `core.ts:2243` and
128-
`compact.ts:296`;** if review asks for those, open a follow-up issue rather than crossing into L1.
130+
on the Codex account surface, which is `poolAccountDto` in `src/codex/auth-api.ts:377` under
131+
`/api/codex-auth/accounts`. The feasibility audit found the earlier grant of
132+
`oauth-account-routes.ts` was the wrong route: it serves the generic `/api/oauth/accounts` and
133+
`src/oauth/index.ts:331` excludes ChatGPT from it. The reporter's 503 is inlined at
134+
`responses/core.ts:2336` and `compact.ts:383`, which L1 owns, and the model-list drop is published
135+
from `catalog/sync.ts:1777`. Both are out of scope: write `Refs #4212`, not `Closes`,** and record
136+
them as follow-ups.
129137
3. **#4211 — keep Free-tier accounts out of pool selection.** **Decision: ship**
130-
**`codexPool.excludedPlans` as an array, absent by default,** so an existing install sees no
138+
**`codexPool.excludedPlans` as an array, absent by default, filtered in `getEligiblePoolAccounts`**
139+
**at `src/codex/routing.ts:1248` rather than in `isCodexAccountUsable`, which is where pause already
140+
lives, and explicit namespace selection at `auth-context.ts:922` keeps working,** so an existing install sees no
131141
behaviour change. Do not ship `minimumPlan`: ranking plans needs an ordering this repository does
132142
not have. **Decision: this round ships selection only.** If the dashboard or CLI display the issue
133143
also asks for needs `src/cli/account.ts`, a GUI component, or a locale key, stop and report; write
@@ -142,6 +152,11 @@ Owned: directories `src/update/`, `src/cli/`, `src/client/`; files `bin/ocx.mjs`
142152
`src/lib/package-tree-integrity.ts`, `src/lib/process-control.ts`, `src/codex/catalog/effort.ts`,
143153
`src/codex/cli-install-provenance.ts`, `docs-site/src/content/docs/getting-started/installation.md`.
144154

155+
Your stack is #4202 → #4169 → #4207. **#4204 was removed from the round** by the feasibility audit:
156+
binding the clamp to the Desktop runtime needs `codex/runtime.ts:573`, `catalog/bundled.ts:239`, and
157+
`catalog/sync.ts:1945`, because the catalog probes one selected runtime and no caller passes a
158+
consumer identity. Resolving a catalog per consumer is a design decision this round does not make.
159+
145160
1. **#4202 — global pnpm installations cannot self-update.** Carry PR #4203 by `oliver-mee` (open
146161
**draft**, `CHANGES_REQUESTED`, 36 files). **Decision: the keep-set is exactly** `bin/ocx.mjs`,
147162
`src/cli.ts`, `src/cli/launcher-context.ts`, `src/config/pending-teardown.ts`,
@@ -173,14 +188,20 @@ Owned: directories `src/update/`, `src/cli/`, `src/client/`; files `bin/ocx.mjs`
173188

174189
Worktree `~/.codex/worktrees/260911-l5/opencodex`, branch `codex/260911-l5-integrations-io`.
175190

176-
Owned: directory `src/integrations/`; file `src/config/atomic-write.ts`. No open PR touches either.
191+
Owned: directory `src/integrations/`; files `src/config/atomic-write.ts`,
192+
`src/clients/config-export.ts`, `src/clients/config-export/contracts.ts`. Note `src/clients/` (plural)
193+
is unrelated to L4's `src/client/` (singular). Open draft #3833 also edits the export-client surface;
194+
report the overlap rather than merging the two lines of work.
177195

178196
1. **#4197 — the DSH integration's atomic replace changes file ownership and causes `EACCES` across
179197
UIDs.** **Decision: refuse the integration write when the target exists and its owner is not the
180198
process euid, with an explicit API error. Do not relax the `0600` hardening and do not attempt
181199
`fchown`.** A metadata-preserving replace can be proposed later as its own issue.
182-
2. **#4214 — add Cline as a supported client integration.** Follow the existing registry pattern in
183-
`src/integrations/registry.ts`.
200+
2. **#4214 — add Cline as a supported client integration.** `IntegrationClientId` is an alias of
201+
`ExportClientId` at `clients/config-export/contracts.ts:84`, and the writer needs `EXPORT_CLIENTS`
202+
from `clients/config-export.ts:1112`, which is why both are yours. **Decision: ship the CLI and
203+
registry path only. The dashboard tab needs a locale key this round forbids, so write `Refs #4214`**
204+
and leave the tab as a follow-up.
184205

185206
## L6 — streaming and vendor tool leakage
186207

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# wp4 — merges, and the readiness check the lane merges need
2+
3+
wp4 owns serialized merges on final-head green CI with fetched ancestry proof. Three merges have
4+
already run under exactly that gate, all of them the round's own pull requests:
5+
6+
| PR | Head merged | Landing proof |
7+
|---|---|---|
8+
| #4217 | `538668bb0` | `git merge-base --is-ancestor` against fetched `origin/dev` |
9+
| #4220 | `6a3774c15` | same |
10+
| #4221 | `9f550ae56` | same |
11+
12+
No lane pull request exists yet, so the lane half of this phase has nothing to merge. That is an
13+
external dependency: a thread has to be opened against each worktree, which an agent cannot do.
14+
15+
## What this phase does before deferring the lane merges
16+
17+
Every defect the three round audits found had the same shape: a lane was told to fix something whose
18+
code does not live entirely inside the paths that lane owns. #4212 needed a management route L3 did
19+
not have. #4207 was client code in the wrong lane. #4190's leak sat in a directory no lane owned.
20+
Each was found by reading one issue against the tree.
21+
22+
A lane that discovers this itself burns a cycle and stops, and the merge this phase waits for never
23+
arrives. So before deferring, check all seven at once: one read-only `xai/grok-4.6` subagent per lane,
24+
fresh context, asked a single question — can this lane's stack be implemented entirely inside its
25+
owned paths, and if not, which exact path is missing? The questions are independent, so the seven run
26+
concurrently. Their verdicts are this phase's audit.
27+
28+
## Acceptance
29+
30+
- The three completed merges are recorded with their exact heads and landing proofs.
31+
- Seven verdicts, one per lane, each naming either that the stack fits the owned paths or the exact
32+
unowned `path:line` it needs.
33+
- Every finding is folded into that lane's packet, or recorded with a rebuttal the way the #4184
34+
finding was rebutted with the issue text that disproved it.
35+
- Amended packets are pushed and their remote heads read back with `git ls-remote`.
36+
- The lane merges are recorded as deferred with the reason, not as done.
37+
38+
## Out of scope
39+
40+
No implementation. No lane pull request. No merge of a lane branch, because none exists. A subagent
41+
that proposes a fix has exceeded its packet; only the path gap is used.
42+
43+
## Local checks
44+
45+
`NOT RUN`. Every subagent is read-only.
46+
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# wp4 — seven-lane feasibility audit
2+
3+
Seven read-only `xai/grok-4.6` subagents, one per lane, dispatched in one round with fresh context.
4+
Each was asked a single question: can this lane's stack be implemented entirely inside its owned
5+
paths, and if not, which exact path is missing? Four came back `fits`, three came back `gaps`.
6+
7+
Three of seven lanes would have started, hit an unowned file, and stopped. That is the cost this
8+
phase removed.
9+
10+
## Verdicts
11+
12+
| Lane | Verdict | Substance |
13+
|---|---|---|
14+
| L1 | fits | #4172 lands at `opencode-go-transport.ts:32` with every fanout call site owned; #4176 at `responses-undeclared-tool-guard.ts:324` and `types/tools.ts:69`. |
15+
| L2 | gaps | The quota half fits `quota.ts:2909`, but seeding `glm-5.3-flash` at `registry.ts:2651` fails `tests/providers/provider-registry-parity.test.ts:464` and `:508`, which lock the roster and assert Flash is absent. |
16+
| L3 | gaps | #4126 fits `warmup.ts:31` and `:290`. #4212 was pointed at the wrong surface. #4211 was pointed at the wrong function. |
17+
| L4 | gaps | #4202, #4169, and #4207 fit. #4204 cannot bind the clamp to the Desktop runtime from `effort.ts` alone. |
18+
| L5 | gaps | #4197 fits `integrations/config-io.ts:259`. #4214 needs the export-client contract, which L5 does not own. |
19+
| L6 | fits | #4191 at `codex-ws-exchange.ts:214`; #4190 by wrapping the `emit` callback inside `adapters/qoder/adapter.ts:58-67`. |
20+
| L7 | fits | #4215 at `guides/providers.md:70`; #4200 at `guides/remote-hub.md:77`. |
21+
22+
## Dispositions
23+
24+
**L2 — #4201.** Grant `tests/providers/provider-registry-parity.test.ts`. A lane that changes a
25+
registry roster owns the oracle that asserts the roster; otherwise the change cannot land at all.
26+
27+
**L3 — #4212.** The packet granted `oauth-account-routes.ts`, which is the wrong route: it serves the
28+
generic `/api/oauth/accounts`, and `oauth/index.ts:331` excludes ChatGPT from it. Codex pool accounts
29+
are served by `poolAccountDto` in `src/codex/auth-api.ts:377` under `/api/codex-auth/accounts`, so
30+
that file is granted instead. The reporter's 503 is inlined at `responses/core.ts:2336` and
31+
`compact.ts:383`, which L1 owns, and the model-list drop is published from `catalog/sync.ts:1777`.
32+
**Decision: #4212 is narrowed to per-account refresh-failure attribution on the Codex account
33+
surface.** The 503 wording and the catalog-drop attribution are recorded as follow-ups, and the pull
34+
request says `Refs #4212` rather than `Closes`.
35+
36+
**L3 — #4211.** Auto-selection filters in `getEligiblePoolAccounts` at `codex/routing.ts:1248`, not in
37+
`isCodexAccountUsable`, which is why pause does not appear in the latter either. Grant
38+
`src/codex/routing.ts` and `src/types/config.ts`, since the field needs a type next to
39+
`pausedCodexAccountIds` and the schema alone does not provide one. **Decision: the filter applies to
40+
automatic selection only; explicit namespace selection at `auth-context.ts:922` keeps working,** which
41+
is what the issue asks for.
42+
43+
**L4 — #4204. Removed from the round.** Binding the clamp to the Desktop runtime requires
44+
`codex/runtime.ts:573`, `catalog/bundled.ts:239`, and `catalog/sync.ts:1945`: the catalog probes one
45+
selected runtime and no caller passes a consumer identity. Deciding that a catalog should be resolved
46+
per consumer is a design decision, which is exactly what this round's decision-free filter excludes.
47+
L4's stack becomes #4202 → #4169 → #4207.
48+
49+
**L5 — #4214.** `IntegrationClientId` is an alias of `ExportClientId` from
50+
`clients/config-export/contracts.ts:84`, and the writer needs `EXPORT_CLIENTS` from
51+
`clients/config-export.ts:1112`. Grant both. The dashboard tab additionally needs a locale key, which
52+
this round forbids. **Decision: ship the CLI and registry path; the dashboard tab is a follow-up, and
53+
the pull request says `Refs #4214`.** Note that open draft #3833 also edits the export-client surface;
54+
L5 reports the overlap rather than merging the two lines of work.
55+
56+
## What this does not change
57+
58+
No lane gained a path another lane owns. `src/clients/` (plural) is unrelated to L4's `src/client/`
59+
(singular). The four `fits` lanes are untouched.
60+

0 commit comments

Comments
 (0)