Skip to content

Commit 9b6c9f1

Browse files
authored
docs(devlog): 260815 old-draft triage plan, matrix, worker packets (#1745)
* docs(devlog): 260815 old-draft triage plan and matrix * docs(devlog): old-draft matrix A-audit amendments (no closes) * docs(devlog): wp2 worker packets * docs(devlog): packet A-audit amendments
1 parent 656376f commit 9b6c9f1

4 files changed

Lines changed: 140 additions & 0 deletions

File tree

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# 000 - 260815_old_draft_triage: Plan
2+
3+
## Objective
4+
5+
Triage the 18 older open drafts (#1703 #1669 #1664 #1660 #1655 #1652 #1645 #1644 #1624 #1584 #1569 #1557 #1552 #1526 #1521 #1498 #1367 #1165): land the worthwhile (provider additions prioritized), close the superseded, keep the rest drafted with named gaps. Then a release-readiness hardening loop on dev (no publish).
6+
7+
## Loop-spec
8+
9+
- Archetype: verifier-defined (gh state + lidge suite + dev CI).
10+
- Write scope: GitHub PR state + devlog unit + repair branches. Out of scope: npm publish, tags, main/preview, issues.
11+
- Bounds: one session; heavy repairs capped at one worker attempt each, else KEEP-DRAFT.
12+
- Subagents: gpt-5.6-sol, medium effort (owner directive).
13+
14+
## Evidence base
15+
16+
4 sol/medium explorer verdicts (2026-08-15, diff-level + merge-tree + GraphQL threads) against origin/dev 420db6274.
17+
18+
## Disposition summary (010 has full evidence)
19+
20+
- CLOSE (2): #1498 (superseded by policy routing + #1702, 31 unresolved defects), #1367 (retired seam, 10 blockers).
21+
- KEEP-DRAFT (6): #1552 (auth sponsorship), #1703 (unsafe routing design), #1645 (5 correctness/security blockers), #1557 (not fail-closed), #1526 (5748-line auth surface), #1624 (dormant contract).
22+
- CHERRY-PICK light (6): #1664 MiniMax, #1669 modelPickerOrder, #1660 terminal guard, #1652 streamAborted, #1165 imageInput, #1644 droid docs.
23+
- CHERRY-PICK heavy (4): #1655 empty-completion guard, #1569 native chat->chat, #1584 request pacing, #1521 service tiers.
24+
25+
## Work-phase map
26+
27+
| WP | Doc | Slice |
28+
|----|-----|-------|
29+
| wp1 | 010 | this matrix |
30+
| wp2 | 020 | CLOSE 2 + KEEP-DRAFT 6 comments; dispatch 6 light repair workers |
31+
| wp3 | 020 | integrate light six; lidge verify; land via admin PR; close source PRs with landed-SHA comment |
32+
| wp4 | 020 | heavy four: one worker attempt each; land what passes, else KEEP-DRAFT |
33+
| wp5 | 030 | release-readiness loop: lidge gates, dev CI, release.ts preflight, report |
34+
35+
## Landing mechanics (from 260815_open_pr_triage, proven)
36+
37+
Cherry-pick contributor commits (author preserved) onto repair branch off origin/dev, repair commits on top, integrate into int branch, lidge suite, open PR to dev, --admin merge, close source PR with landed-SHA comment. Direct dev push impossible (Protect dev ruleset, bypass=pull_request).
38+
39+
## Accept criteria
40+
41+
- c1 matrix; c2 18 dispositions executed; c3 lidge suite green on final tree; c4 readiness report; c5 privacy clean.
42+
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# 010 - Old-draft triage matrix (wp1 deliverable)
2+
3+
Evidence: 4 sol/medium subagents + A-audit (GO-WITH-FIXES, 2 blockers folded), 2026-08-15, against origin/dev 420db6274. All 18 are drafts.
4+
5+
A-audit amendment: both CLOSE calls were revised to KEEP-DRAFT. #1498 is NOT superseded (current policy routing lacks allowance snapshots, reservations, settlement, pre-dispatch quota/cost evidence; assemble.ts passes neither codexAccountId nor accountRef). #1367's failure class is NOT covered (terminal repair is a narrower registry-controlled case; no custom-provider escape hatch exists on dev). Closing would discard real requirements with no preservation mechanism in scope.
6+
7+
## KEEP-DRAFT (8)
8+
9+
| PR | Gaps |
10+
|----|------|
11+
| #1498 economy combo routing | Defective as written (31 unresolved threads, conflicts, 755 behind) but its allowance/reservation/settlement semantics remain unimplemented; preserve until a scoped runtime follow-up exists |
12+
| #1367 bounded JSON fallback | Redesign around current registry-only compat + terminal-repair architecture; 10 unresolved blockers |
13+
| #1552 Command Code OAuth pool | 2565-line auth-boundary change; needs maintainer security sponsorship, real GUI screenshot, rebase |
14+
| #1703 claude classifier affinity | Real defect but implementation can silently cross provider privacy/billing boundaries; maintainer design hold |
15+
| #1645 vision chat/Google sidecars | 5 verified blockers incl. OAuth-over-HTTP loopback (describe-chat.ts:25) and missing image-boundary checks |
16+
| #1557 least-privilege catalog endpoint | Response not projected through closed allowlist DTO; not fail-closed; unsponsored auth-cors surface |
17+
| #1526 reset-credit operation identity | Real idempotency gap but 5748-line auth/persistence authority; needs split or exceptional security review |
18+
| #1624 quota recovery policy contract | Sound but dormant no-op contract; land only with the #657 runtime slice |
19+
20+
## CHERRY-PICK light (6) - repair then land
21+
22+
| PR | Repair scope |
23+
|----|--------------|
24+
| #1664 MiniMax Code/CLI | Shared compiled-aware argv builder (Bun.isStandaloneExecutable) replacing spawn(execPath,[argv[1]]) - repo-wide launcher debt (index.ts/opencode.ts/claude.ts), not MiniMax-only; rebase (124 behind); full gates |
25+
| #1669 modelPickerOrder | Fail-soft string-array normalization + malformed-input regression + docs contradiction fix |
26+
| #1660 terminal guard openai-chat | Resolve src/types.ts conflict; add explicit-false + combo/routed-compaction exclusion tests; provider-option docs |
27+
| #1652 streamAborted | Cover WS finalize + relay-eager paths; fix trackSseForRequestLog cancellation race; drop unrelated fixture churn |
28+
| #1165 imageInput combo control | Fix double expansion of combo continuations; combo set round-trip; add Turkish/zh-TW locale keys; test coverage |
29+
| #1644 Factory Droid docs | Name the droid provider id in config; define text-only accepted schema + rejection behavior (EN+KO); docs build |
30+
31+
## CHERRY-PICK heavy (4) - one worker attempt each
32+
33+
| PR | Repair scope |
34+
|----|--------------|
35+
| #1655 empty-completion guard | Reimplement on current core.ts: bound retained events/bytes, usage preservation, guard composition, retry-cause record, integration tests; currently CI-red |
36+
| #1569 native chat->chat | Rebuild around shared openai-chat request builder + bounded SSE parser; redactSecretString on structured provider errors; URL normalization |
37+
| #1584 request pacing | Reconcile 4 conflicting files (ProviderSettings, responses/core, fetch-helpers, policy-fallback); remove real-timer flake tests; 358 behind |
38+
| #1521 service tiers | Port per-model resolver across 4 conflicts (openai-chat adapter, provider-fetch, 2 test files) onto current service-tier gating; #1436 |
39+
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# 020 - Execution record (wp2-wp4)
2+
3+
## wp2 worker packets (P artifact)
4+
5+
Shared mechanics for every worker (sol/medium, forked session):
6+
7+
1. git worktree add /tmp/ocx-repair-<n> -b repair/260815-pr-<n> origin/dev (run from the main checkout)
8+
2. cd /tmp/ocx-repair-<n>; git fetch origin pull/<n>/head; cherry-pick the PR commits (author preserved); resolve conflicts
9+
3. Apply the named repairs only - no drive-by refactors
10+
4. bun install at root (plus cd gui && bun install when touching gui/)
11+
5. bun run typecheck MUST pass; run ONLY focused tests for touched/added files; NEVER the full suite (owner runs it remotely)
12+
6. Commit with clear messages; DO NOT push; DO NOT touch the main checkout working tree
13+
7. Report: branch, commits, files changed, test tails, rejected repairs + reasons
14+
15+
### repair/260815-pr-1664 (MiniMax Code/CLI, 3 commits)
16+
17+
Cherry-pick EXACTLY the two non-merge commits (A-audit: skip merge commit 50ac35d02, whose second-parent patch duplicates befd076f6):
18+
git cherry-pick befd076f601f1c77a57406b93dabe10347013edb
19+
git cherry-pick cd3c26a4c7a51937c4a58ced88a4cbb5a8519098
20+
Repairs:
21+
- Introduce ONE shared compiled-aware launcher argv helper (Bun.isStandaloneExecutable split: standalone -> spawn(process.execPath, args); source -> spawn(process.execPath, [process.argv[1], ...args])) in a shared cli module.
22+
- Migrate ALL launcher call sites (A-audit expanded scope): PR-head src/cli/minimax.ts:261; existing src/cli/index.ts:123 (+consumers 471/518, dispatch injection 934-936), src/cli/opencode.ts:497, src/cli/claude.ts:272, src/server/management/system-restart.ts:216, src/update/index.ts (251, 301, 307, 331, 375), src/update/job.ts (1869, 1873).
23+
- Unit tests for both modes.
24+
25+
### repair/260815-pr-1669 (modelPickerOrder, 1 commit)
26+
27+
- Runtime-normalize config value: fail-soft string-array filter before any .filter() use; malformed hand-edited values must not crash catalog sync.
28+
- Malformed-input regression tests; fix docs contradiction in docs-site model-ordering guide.
29+
30+
### repair/260815-pr-1660 (terminal guard openai-chat, 2 commits; conflict src/types.ts)
31+
32+
- Resolve types.ts conflict against current dev.
33+
- Add explicit-false activation test; combo-attempt and routed-compaction exclusion tests; document the provider option.
34+
35+
### repair/260815-pr-1652 (streamAborted, 1 commit)
36+
37+
- Mark streamAborted on the native Responses WebSocket finalize path and src/server/relay-eager.ts eager path (both currently omit it).
38+
- Fix trackSseForRequestLog continuing terminal handling after cancellation.
39+
- Drop the unrelated rate-limit test fixture mutation from the cherry-pick.
40+
41+
### repair/260815-pr-1165 (imageInput combo control, 3 commits)
42+
43+
- Preserve and regression-test the existing anti-double-expansion deletion (PR head deletes previous_response_id before child dispatch; A-audit: already correct - lock with a test, do not 'fix').
44+
- ocx combo set must not silently reset imageInput disabled mode (round-trip test).
45+
- Add missing Turkish + zh-TW locale keys; stored-image replay coverage.
46+
47+
### repair/260815-pr-1644 (Factory Droid docs, 1 commit)
48+
49+
- Name the droid provider id in the config example so the verification command works.
50+
- Define the text-only accepted input schema + explicit rejection behavior for images/tool items, in BOTH English and Korean guides.
51+
- Run the docs-site build.
52+
53+
## Execution log
54+
55+
(pending)
56+
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# 030 - Release-readiness record (wp5)
2+
3+
(pending)

0 commit comments

Comments
 (0)