fix(review): accept positional focus text for parity with adversarial-review

Closes openai#522.

`/codex:review` unconditionally rejected any positional argument as
"custom focus text" (validateNativeReviewRequest), while
`/codex:adversarial-review` accepts it. That interface-parity gap also
blocked non-English model/effort entry: even when a host (e.g. Claude)
rewrites a natural-language phrase into `--model`/`--effort`, any
residual positional word still aborted the native review.

Remove the unconditional focus-text rejection. The native reviewer
(review/start) does not consume focus text, so leftover positional words
are now silently ignored rather than rejecting the invocation. Review
semantics are unchanged (still native structured-review); only the
spurious abort is gone.

Companion does no language/alias recognition — that is the host/.md
layer's job. This fix is purely about parity: review no longer fails
where adversarial-review succeeds.

Tested: runtime parity test (red before, green after), commands.test.mjs
assert updated to the new review.md wording. 0 regressions vs the openai#471
base (4 pre-existing fails unchanged).

Co-Authored-By: Claude <noreply@anthropic.com>

Author: axisrow

plugins/codex/commands/review.md

@@ -36,7 +36,7 @@ Argument handling:
 - `--model` and `--effort` select the Codex runtime for the review and are not focus text.
 - Do not strip `--wait` or `--background` yourself.
 - The companion script parses `--wait` and `--background`, but Claude Code's `Bash(..., run_in_background: true)` is what actually detaches the run.
-- `/codex:review` is native-review only. It does not support staged-only review, unstaged-only review, or extra focus text.
+- `/codex:review` is native-review only. It does not support staged-only review or unstaged-only review. Positional focus text is ignored by the native reviewer (for interface parity with `/codex:adversarial-review`); it does not abort the review.
 - If the user needs custom review instructions or more adversarial framing, they should use `/codex:adversarial-review`.
 
 Model/effort recognition (natural-language phrases):

plugins/codex/scripts/codex-companion.mjs

@@ -272,13 +272,13 @@ function buildNativeReviewTarget(target) {
   return null;
 }
 
-function validateNativeReviewRequest(target, focusText) {
-  if (focusText.trim()) {
-    throw new Error(
-      `\`/codex:review\` now maps directly to the built-in reviewer and does not support custom focus text. Retry with \`/codex:adversarial-review ${focusText.trim()}\` for focused review instructions.`
-    );
-  }
-
+function validateNativeReviewRequest(target, _focusText) {
+  // Parity with /codex:adversarial-review: positional focus text no longer
+  // aborts the native review. The native reviewer (review/start) does not
+  // consume focus text, so leftover positional words are silently ignored
+  // rather than rejecting the invocation. This keeps `/codex:review --model sol`
+  // usable when a host forwards residual positional text alongside flags,
+  // and removes an interface-parity gap with /codex:adversarial-review (#522).
   const nativeTarget = buildNativeReviewTarget(target);
   if (!nativeTarget) {
     throw new Error("This `/codex:review` target is not supported by the built-in reviewer. Retry with `/codex:adversarial-review` for custom targeting.");

tests/commands.test.mjs

@@ -39,7 +39,8 @@ test("review command uses AskUserQuestion and background Bash while staying revi
   assert.match(source, /Claude Code's `Bash\(..., run_in_background: true\)` is what actually detaches the run/i);
   assert.match(source, /When in doubt, run the review/i);
   assert.match(source, /\(Recommended\)/);
-  assert.match(source, /does not support staged-only review, unstaged-only review, or extra focus text/i);
+  assert.match(source, /does not support staged-only review or unstaged-only review/i);
+  assert.match(source, /Positional focus text is ignored by the native reviewer/i);
   assert.match(source, /Preserve the user's INTENT exactly/i);
   assert.match(source, /rewrite a natural-language model or effort mention into the corresponding/i);
   assert.match(source, /Model\/effort recognition \(natural-language phrases\):/i);

tests/runtime.test.mjs

@@ -1321,7 +1321,7 @@ test("task --background enqueues a detached worker and exposes per-job status",
   assert.equal(fakeState.lastTurnStart.effort, "max");
 });
 
-test("review rejects focus text because it is native-review only", () => {
+test("review accepts (ignores) positional focus text for parity with adversarial-review", () => {
   const repo = makeTempDir();
   const binDir = makeTempDir();
   installFakeCodex(binDir);
@@ -1336,9 +1336,13 @@ test("review rejects focus text because it is native-review only", () => {
     env: buildEnv(binDir)
   });
 
-  assert.equal(result.status > 0, true);
-  assert.match(result.stderr, /does not support custom focus text/i);
-  assert.match(result.stderr, /\/codex:adversarial-review focus on auth/i);
+  // Parity with /codex:adversarial-review: positional args no longer abort the
+  // native review. The native reviewer (review/start) does not consume focus
+  // text, so leftover words are ignored rather than rejecting the invocation.
+  // This keeps `/codex:review --model sol` usable when a host (e.g. Claude)
+  // forwards residual positional text alongside flags.
+  assert.equal(result.status, 0);
+  assert.doesNotMatch(result.stderr, /does not support custom focus text/i);
 });
 
 test("review rejects staged-only scope because it is native-review only", () => {