@aibridge/cli 0.2.0 → 0.3.0

package/README.md

@@ -28,7 +28,7 @@ npx skills add ycmjason/aibridge
 That's it. The skill runs the CLI on demand via `npx -y @aibridge/cli` — nothing else to install. Ask your agent to "use aibridge", or try it yourself:
 
 ```bash
-npx -y @aibridge/cli subagent "summarize the architecture of this repo"
+npx -y @aibridge/cli subagent --model xai-grok/grok-4.5 "summarize the architecture of this repo"
 ```
 
 <sup>Want the `aibridge` command on your PATH for manual use? `npm i -g @aibridge/cli` (optional).</sup>
@@ -37,21 +37,21 @@ npx -y @aibridge/cli subagent "summarize the architecture of this repo"
 
 | Command | Use when |
 |---|---|
-| `aibridge plan "<task>"` | You want a delegate model to study the repo and expand a task into a detailed, reviewable **plan file** before any code is written |
-| `aibridge implement <plan.md>` | You have an approved plan file and want it executed in place — with your project's **real typecheck and tests** run until green |
-| `aibridge review [--plan <plan.md>]` | You want a **different model** to pressure-test the working-tree diff against the plan contract (over-reach is a finding) — or to review the plan itself before implementing |
-| `aibridge subagent "<task>"` | A self-contained task deserves a concurrent delegate, a cross-model second opinion, or a red-team pass |
-| `aibridge image-gen "<prompt>" --out out.png` | You need a real raster image — on a Codex (default), Antigravity, or Grok seat, with render verification |
+| `aibridge plan --model xai-grok/grok-4.5 --out plan.md "<task>"` | You want a delegate model to study the repo and expand a task into a detailed, reviewable **plan file** before any code is written |
+| `aibridge implement --model google-antigravity/gemini-3.6-flash <plan.md>` | You have an approved plan file and want it executed in place — with your project's **real typecheck and tests** run until green |
+| `aibridge review --model xai-grok/grok-4.5 --out review.md [--plan <plan.md>]` | You want a **different model** to pressure-test the working-tree diff against the plan contract (over-reach is a finding) — or to review the plan itself before implementing |
+| `aibridge subagent --model xai-grok/grok-4.5 "<task>"` | A self-contained task deserves a concurrent delegate, a cross-model second opinion, or a red-team pass |
+| `aibridge image-gen --model openai-codex/gpt-5.6-sol --out out.png "<prompt>"` | You need a real raster image — on a Codex, Antigravity, or Grok seat, with render verification |
 | `aibridge quota` | Two-second check of every backend's remaining quota before you pipeline work |
 | `aibridge runs` | Inspect or watch past delegation runs (`~/.aibridge/runs`) |
 
 The three verbs compose into an orchestrator-driven loop your agent stays in charge of:
 
 ```
-aibridge plan "add rate limiting to the API"   # delegate writes plan.md
+aibridge plan --model xai-grok/grok-4.5 --out plan.md "add rate limiting to the API"   # delegate writes plan.md
 # → your agent reads, edits, approves the plan
-aibridge implement plan.md                     # another model executes it, runs your gates
-aibridge review --plan plan.md                 # a third seat cross-checks the diff
+aibridge implement --model google-antigravity/gemini-3.6-flash plan.md                 # another model executes it, runs your gates
+aibridge review --model xai-grok/grok-4.5 --out review.md --plan plan.md               # a third seat cross-checks the diff
 ```
 
 Plan files — not their contents — travel between stages, so the loop is nearly free on your agent's context.

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as runCli, t as buildContext } from "./context-DQxvMUd2.mjs";
+import { r as runCli, t as buildContext } from "./context-B6I4QI9z.mjs";
 //#region src/cli.ts
 await runCli(buildContext(process), process.argv.slice(2));
 //#endregion

package/dist/{context-DQxvMUd2.mjs → context-B6I4QI9z.mjs}

@@ -112,9 +112,6 @@ const MODELS = {
 		brief: "Claude Opus 5, 1M context via claude CLI — long-context work; bills subscription"
 	}
 };
-const DEFAULT_MODEL = "xai-grok/grok-4.5";
-const DEFAULT_IMPLEMENTER = "google-antigravity/gemini-3.6-flash";
-const DEFAULT_IMAGE_GEN = "openai-codex/gpt-5.6-sol";
 const IMAGE_GEN_FORMATS = /* @__PURE__ */ new Map([
 	["agy", "jpg"],
 	["codex", "png"],
@@ -240,11 +237,11 @@ async function imageGen$1(flags, prompt) {
 		this.process.stderr.write(`aibridge image-gen: ${msg}\n`);
 		this.process.exitCode = 1;
 	};
-	const inputSlug = flags.model ?? "openai-codex/gpt-5.6-sol";
+	const inputSlug = flags.model;
 	const model = resolveModel(inputSlug);
 	if (!model) return fail(formatUnknownModelError(inputSlug));
 	if (!supportsImageGen(model)) return fail(formatImageGenModelError(inputSlug, model));
-	if (model.spec.backend === "codex" && model.effort) return fail(`effort "-${model.effort}" has no effect on image-gen (the image tool renders, not the seat model); use ${DEFAULT_IMAGE_GEN}.`);
+	if (model.spec.backend === "codex" && model.effort) return fail(`effort "-${model.effort}" has no effect on image-gen (the image tool renders, not the seat model); pass the un-suffixed slug "${model.spec.slug}" instead.`);
 	const expected = imageFormatFor(model);
 	if (expected === void 0) return fail(formatImageGenModelError(inputSlug, model));
 	const label = expected === "png" ? "PNG" : "JPEG";
@@ -378,7 +375,7 @@ const fullDescription$6 = [
 	"",
 	"Image-gen seats (canonical slug):",
 	...listModelHelpLines({ imageOnly: true }),
-	`Default: ${DEFAULT_IMAGE_GEN}.`
+	"Recommended seat: openai-codex/gpt-5.6-sol."
 ].join("\n");
 const imageGen = buildCommand({
 	func: imageGen$1,
@@ -387,8 +384,7 @@ const imageGen = buildCommand({
 			model: {
 				kind: "parsed",
 				parse: String,
-				optional: true,
-				brief: `Model slug (default: ${DEFAULT_IMAGE_GEN})`
+				brief: "Model slug (required) — see the seat list above"
 			},
 			out: {
 				kind: "parsed",
@@ -649,7 +645,7 @@ function readRunLogs(id) {
 //#endregion
 //#region src/commands/implement/impl.ts
 async function implement$1(flags, planFile) {
-	const inputSlug = flags.model ?? "google-antigravity/gemini-3.6-flash";
+	const inputSlug = flags.model;
 	const model = resolveModel(inputSlug);
 	if (!model) {
 		this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);
@@ -719,8 +715,7 @@ const implement = buildCommand({
 			model: {
 				kind: "parsed",
 				parse: String,
-				optional: true,
-				brief: `Model slug (default: ${DEFAULT_IMPLEMENTER})`
+				brief: "Model slug (required) — see the seat list above"
 			},
 			timeout: {
 				kind: "parsed",
@@ -781,7 +776,7 @@ function extractPathFromPorcelainLine(line) {
 	return content;
 }
 async function plan$1(flags, taskPrompt) {
-	const inputSlug = flags.model ?? "xai-grok/grok-4.5";
+	const inputSlug = flags.model;
 	const model = resolveModel(inputSlug);
 	if (!model) {
 		this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);
@@ -801,7 +796,7 @@ async function plan$1(flags, taskPrompt) {
 	const cwd = this.process.cwd();
 	const promptSnippet = taskPrompt.replace(/\r?\n/g, " ").slice(0, 80);
 	const run = startRun("plan", `${model.spec.slug}: ${promptSnippet}`);
-	const absOutPath = flags.out ? isAbsolute(flags.out) ? flags.out : resolve(cwd, flags.out) : resolve(run.dir, "plan.md");
+	const absOutPath = isAbsolute(flags.out) ? flags.out : resolve(cwd, flags.out);
 	const beforePorcelain = await getPorcelainStatus(cwd);
 	const outcome = await delegate({
 		model,
@@ -866,14 +861,12 @@ const plan = buildCommand({
 			model: {
 				kind: "parsed",
 				parse: String,
-				optional: true,
-				brief: `Model slug (default: ${DEFAULT_MODEL})`
+				brief: "Model slug (required) — see the seat list above"
 			},
 			out: {
 				kind: "parsed",
 				parse: String,
-				optional: true,
-				brief: "Where to write the plan (default: <run.dir>/plan.md)"
+				brief: "Where to write the plan file (required)"
 			},
 			timeout: {
 				kind: "parsed",
@@ -1032,7 +1025,7 @@ function parseReviewVerdict(response) {
 	};
 }
 async function review$1(flags) {
-	const inputSlug = flags.model ?? "xai-grok/grok-4.5";
+	const inputSlug = flags.model;
 	const model = resolveModel(inputSlug);
 	if (!model) {
 		this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);
@@ -1082,7 +1075,7 @@ async function review$1(flags) {
 	const timeoutSec = flags.timeout ?? 1200;
 	const modeDetail = isDirty ? absPlanPath ? `diff + plan (${absPlanPath})` : `diff (${baseRef})` : `plan-only (${absPlanPath})`;
 	const run = startRun("review", `${model.spec.slug}: ${modeDetail}`);
-	const absOutPath = flags.out ? isAbsolute(flags.out) ? flags.out : resolve(cwd, flags.out) : resolve(run.dir, "review.md");
+	const absOutPath = isAbsolute(flags.out) ? flags.out : resolve(cwd, flags.out);
 	let reviewPrompt;
 	if (isDirty) reviewPrompt = `You are an expert code reviewer. Inspect the working tree diff against base '${baseRef}' and untracked files at ${cwd}.\n` + (absPlanPath ? `Compare the implementation against the plan contract at ${absPlanPath}. Any file modified or feature added outside the plan contract counts as over-reach (severity: major unless harmful, then critical).\n` : "") + `Write your detailed review report to the file ${absOutPath}. For each finding, include file:line, severity (critical|major|minor), and rationale.\nYour final answer (last message) must consist of EXACTLY ONE VERDICT LINE:\nEither: "PASS"\nOr: "FINDINGS: <c> critical, <m> major, <n> minor"`;
 	else reviewPrompt = `You are an expert architecture reviewer. Inspect the plan contract file at ${absPlanPath}.\nReview the plan for soundness, missing edge cases, safety, and feasibility.\nWrite your detailed review report to the file ${absOutPath}. For each finding, include severity (critical|major|minor) and rationale.\nYour final answer (last message) must consist of EXACTLY ONE VERDICT LINE:\nEither: "PASS"\nOr: "FINDINGS: <c> critical, <m> major, <n> minor"`;
@@ -1134,8 +1127,7 @@ const review = buildCommand({
 		model: {
 			kind: "parsed",
 			parse: String,
-			optional: true,
-			brief: `Model slug (default: ${DEFAULT_MODEL})`
+			brief: "Model slug (required) — see the seat list above"
 		},
 		plan: {
 			kind: "parsed",
@@ -1152,8 +1144,7 @@ const review = buildCommand({
 		out: {
 			kind: "parsed",
 			parse: String,
-			optional: true,
-			brief: "Where to write the review report (default: <run.dir>/review.md)"
+			brief: "Where to write the review report (required)"
 		},
 		timeout: {
 			kind: "parsed",
@@ -1345,7 +1336,7 @@ const runs = buildCommand({
 //#endregion
 //#region src/commands/subagent/impl.ts
 async function subagent$1(flags, prompt) {
-	const inputSlug = flags.model ?? "xai-grok/grok-4.5";
+	const inputSlug = flags.model;
 	const model = resolveModel(inputSlug);
 	if (!model) {
 		this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);
@@ -1399,7 +1390,7 @@ const fullDescription = [
 	"",
 	"Available models (canonical slug):",
 	...listModelHelpLines(),
-	`Default: ${DEFAULT_MODEL} (off-budget). The claude-backend slugs are FALLBACKS for`,
+	"Recommended first choice: xai-grok/grok-4.5 (off-budget). The claude-backend slugs are FALLBACKS for",
 	"when the off-budget CLIs are quota-exhausted — they bill your Claude subscription."
 ].join("\n");
 const subagent = buildCommand({
@@ -1409,8 +1400,7 @@ const subagent = buildCommand({
 			model: {
 				kind: "parsed",
 				parse: String,
-				optional: true,
-				brief: `Model slug to delegate to (default: ${DEFAULT_MODEL})`
+				brief: "Model slug (required) — see the seat list above"
 			},
 			timeout: {
 				kind: "parsed",
@@ -1494,4 +1484,4 @@ function buildContext(process) {
 	return { process };
 }
 //#endregion
-export { listModelHelpLines as C, formatUnknownModelError as S, supportsImageGen as T, DEFAULT_IMPLEMENTER as _, readRunLogs as a, backendModelId as b, evaluateCodexPreflight as c, renderPreflightRefusal as d, delegate as f, DEFAULT_IMAGE_GEN as g, positiveIntSeconds as h, listRuns as i, preflightCodex as l, nonEmptyPrompt as m, app as n, startRun as o, getDriver as p, runCli as r, evaluateAgyPreflight as s, buildContext as t, preflightModel as u, DEFAULT_MODEL as v, resolveModel as w, formatImageGenModelError as x, MODELS as y };
+export { supportsImageGen as S, backendModelId as _, readRunLogs as a, listModelHelpLines as b, evaluateCodexPreflight as c, renderPreflightRefusal as d, delegate as f, MODELS as g, positiveIntSeconds as h, listRuns as i, preflightCodex as l, nonEmptyPrompt as m, app as n, startRun as o, getDriver as p, runCli as r, evaluateAgyPreflight as s, buildContext as t, preflightModel as u, formatImageGenModelError as v, resolveModel as x, formatUnknownModelError as y };

package/dist/index.d.mts

@@ -39,9 +39,6 @@ interface ResolvedModel {
   readonly effort: Effort | undefined;
 }
 declare const MODELS: Record<string, ModelSpec>;
-declare const DEFAULT_MODEL = "xai-grok/grok-4.5";
-declare const DEFAULT_IMPLEMENTER = "google-antigravity/gemini-3.6-flash";
-declare const DEFAULT_IMAGE_GEN = "openai-codex/gpt-5.6-sol";
 declare function supportsImageGen(resolved: ResolvedModel): boolean;
 declare function resolveModel(input: string): ResolvedModel | undefined;
 declare function backendModelId(resolved: ResolvedModel): string;
@@ -179,4 +176,4 @@ declare function renderPreflightRefusal(cmd: string, verdict: {
   resetAt: string | undefined;
 }): string;
 //#endregion
-export { type AgentCliDriver, type Backend, DEFAULT_IMAGE_GEN, DEFAULT_IMPLEMENTER, DEFAULT_MODEL, type DelegateOptions, type DelegateOutcome, type DelegationResult, type DelegationTask, type Effort, type LocalContext, MODELS, type ModelSpec, type PreflightVerdict, type ResolvedModel, type RunLog, type RunMeta, app, backendModelId, buildContext, delegate, evaluateAgyPreflight, evaluateCodexPreflight, formatImageGenModelError, formatUnknownModelError, getDriver, listModelHelpLines, listRuns, nonEmptyPrompt, positiveIntSeconds, preflightCodex, preflightModel, readRunLogs, renderPreflightRefusal, resolveModel, runCli, startRun, supportsImageGen };
+export { type AgentCliDriver, type Backend, type DelegateOptions, type DelegateOutcome, type DelegationResult, type DelegationTask, type Effort, type LocalContext, MODELS, type ModelSpec, type PreflightVerdict, type ResolvedModel, type RunLog, type RunMeta, app, backendModelId, buildContext, delegate, evaluateAgyPreflight, evaluateCodexPreflight, formatImageGenModelError, formatUnknownModelError, getDriver, listModelHelpLines, listRuns, nonEmptyPrompt, positiveIntSeconds, preflightCodex, preflightModel, readRunLogs, renderPreflightRefusal, resolveModel, runCli, startRun, supportsImageGen };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { C as listModelHelpLines, S as formatUnknownModelError, T as supportsImageGen, _ as DEFAULT_IMPLEMENTER, a as readRunLogs, b as backendModelId, c as evaluateCodexPreflight, d as renderPreflightRefusal, f as delegate, g as DEFAULT_IMAGE_GEN, h as positiveIntSeconds, i as listRuns, l as preflightCodex, m as nonEmptyPrompt, n as app, o as startRun, p as getDriver, r as runCli, s as evaluateAgyPreflight, t as buildContext, u as preflightModel, v as DEFAULT_MODEL, w as resolveModel, x as formatImageGenModelError, y as MODELS } from "./context-DQxvMUd2.mjs";
-export { DEFAULT_IMAGE_GEN, DEFAULT_IMPLEMENTER, DEFAULT_MODEL, MODELS, app, backendModelId, buildContext, delegate, evaluateAgyPreflight, evaluateCodexPreflight, formatImageGenModelError, formatUnknownModelError, getDriver, listModelHelpLines, listRuns, nonEmptyPrompt, positiveIntSeconds, preflightCodex, preflightModel, readRunLogs, renderPreflightRefusal, resolveModel, runCli, startRun, supportsImageGen };
+import { S as supportsImageGen, _ as backendModelId, a as readRunLogs, b as listModelHelpLines, c as evaluateCodexPreflight, d as renderPreflightRefusal, f as delegate, g as MODELS, h as positiveIntSeconds, i as listRuns, l as preflightCodex, m as nonEmptyPrompt, n as app, o as startRun, p as getDriver, r as runCli, s as evaluateAgyPreflight, t as buildContext, u as preflightModel, v as formatImageGenModelError, x as resolveModel, y as formatUnknownModelError } from "./context-B6I4QI9z.mjs";
+export { MODELS, app, backendModelId, buildContext, delegate, evaluateAgyPreflight, evaluateCodexPreflight, formatImageGenModelError, formatUnknownModelError, getDriver, listModelHelpLines, listRuns, nonEmptyPrompt, positiveIntSeconds, preflightCodex, preflightModel, readRunLogs, renderPreflightRefusal, resolveModel, runCli, startRun, supportsImageGen };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibridge/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "CLI that bridges tasks to AI CLIs on your machine (plan / implement / review / subagent / image-gen)",
   "type": "module",
   "license": "MIT",
@@ -35,11 +35,11 @@
   ],
   "dependencies": {
     "@stricli/core": "1.3.0",
-    "@aibridge/proc": "0.2.0",
-    "@aibridge/driver-codex": "0.2.0",
-    "@aibridge/driver-grok": "0.2.0",
-    "@aibridge/driver-claude": "0.2.0",
-    "@aibridge/driver-agy": "0.2.0"
+    "@aibridge/proc": "0.3.0",
+    "@aibridge/driver-agy": "0.3.0",
+    "@aibridge/driver-grok": "0.3.0",
+    "@aibridge/driver-codex": "0.3.0",
+    "@aibridge/driver-claude": "0.3.0"
   },
   "devDependencies": {
     "tsdown": "0.22.14"

package/src/commands/image-gen/command.ts

@@ -1,5 +1,5 @@
 import { buildCommand } from '@stricli/core';
-import { DEFAULT_IMAGE_GEN, listModelHelpLines } from '../../models.ts';
+import { listModelHelpLines } from '../../models.ts';
 import { nonEmptyPrompt, positiveIntSeconds } from '../../parsers.ts';
 import imageGenImpl from './impl.ts';
 
@@ -9,7 +9,7 @@ const fullDescription = [
   '',
   'Image-gen seats (canonical slug):',
   ...listModelHelpLines({ imageOnly: true }),
-  `Default: ${DEFAULT_IMAGE_GEN}.`,
+  'Recommended seat: openai-codex/gpt-5.6-sol.',
 ].join('\n');
 
 export const imageGen = buildCommand({
@@ -19,8 +19,7 @@ export const imageGen = buildCommand({
       model: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: `Model slug (default: ${DEFAULT_IMAGE_GEN})`,
+        brief: 'Model slug (required) — see the seat list above',
       },
       out: {
         kind: 'parsed',

package/src/commands/image-gen/impl.ts

@@ -15,7 +15,6 @@ import type { ImageResult } from '../../driver.ts';
 import { getDriver } from '../../drivers.ts';
 import {
   backendModelId,
-  DEFAULT_IMAGE_GEN,
   formatImageGenModelError,
   formatUnknownModelError,
   imageFormatFor,
@@ -24,7 +23,7 @@ import {
 } from '../../models.ts';
 
 export interface ImageGenFlags {
-  readonly model?: string;
+  readonly model: string;
   readonly out: string;
   readonly aspectRatio?: string;
   readonly image?: string;
@@ -45,14 +44,14 @@ export default async function imageGen(
     this.process.exitCode = 1;
   };
 
-  const inputSlug = flags.model ?? DEFAULT_IMAGE_GEN;
+  const inputSlug = flags.model;
   const model = resolveModel(inputSlug);
   if (!model) return fail(formatUnknownModelError(inputSlug));
   if (!supportsImageGen(model)) return fail(formatImageGenModelError(inputSlug, model));
 
   if (model.spec.backend === 'codex' && model.effort) {
     return fail(
-      `effort "-${model.effort}" has no effect on image-gen (the image tool renders, not the seat model); use ${DEFAULT_IMAGE_GEN}.`,
+      `effort "-${model.effort}" has no effect on image-gen (the image tool renders, not the seat model); pass the un-suffixed slug "${model.spec.slug}" instead.`,
     );
   }
 

package/src/commands/implement/command.ts

@@ -1,5 +1,5 @@
 import { buildCommand } from '@stricli/core';
-import { DEFAULT_IMPLEMENTER, listModelHelpLines } from '../../models.ts';
+import { listModelHelpLines } from '../../models.ts';
 import { positiveIntSeconds } from '../../parsers.ts';
 import implementImpl from './impl.ts';
 
@@ -17,8 +17,7 @@ export const implement = buildCommand({
       model: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: `Model slug (default: ${DEFAULT_IMPLEMENTER})`,
+        brief: 'Model slug (required) — see the seat list above',
       },
       timeout: {
         kind: 'parsed',

package/src/commands/implement/impl.ts

@@ -3,12 +3,12 @@ import { isAbsolute, resolve } from 'node:path';
 import { runCaptured } from '@aibridge/proc';
 import type { LocalContext } from '../../context.ts';
 import { delegate } from '../../delegate.ts';
-import { DEFAULT_IMPLEMENTER, formatUnknownModelError, resolveModel } from '../../models.ts';
+import { formatUnknownModelError, resolveModel } from '../../models.ts';
 import { preflightModel, renderPreflightRefusal } from '../../quotaPreflight.ts';
 import { startRun } from '../../runlog.ts';
 
 export interface ImplementFlags {
-  readonly model?: string;
+  readonly model: string;
   readonly timeout?: number;
   readonly preflight: boolean;
 }
@@ -18,7 +18,7 @@ export default async function implement(
   flags: ImplementFlags,
   planFile: string,
 ): Promise<void> {
-  const inputSlug = flags.model ?? DEFAULT_IMPLEMENTER;
+  const inputSlug = flags.model;
   const model = resolveModel(inputSlug);
   if (!model) {
     this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);

package/src/commands/plan/command.ts

@@ -1,5 +1,5 @@
 import { buildCommand } from '@stricli/core';
-import { DEFAULT_MODEL, listModelHelpLines } from '../../models.ts';
+import { listModelHelpLines } from '../../models.ts';
 import { nonEmptyPrompt, positiveIntSeconds } from '../../parsers.ts';
 import planImpl from './impl.ts';
 
@@ -17,14 +17,12 @@ export const plan = buildCommand({
       model: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: `Model slug (default: ${DEFAULT_MODEL})`,
+        brief: 'Model slug (required) — see the seat list above',
       },
       out: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: 'Where to write the plan (default: <run.dir>/plan.md)',
+        brief: 'Where to write the plan file (required)',
       },
       timeout: {
         kind: 'parsed',

package/src/commands/plan/impl.ts

@@ -3,13 +3,13 @@ import { isAbsolute, resolve } from 'node:path';
 import { runCaptured } from '@aibridge/proc';
 import type { LocalContext } from '../../context.ts';
 import { delegate } from '../../delegate.ts';
-import { DEFAULT_MODEL, formatUnknownModelError, resolveModel } from '../../models.ts';
+import { formatUnknownModelError, resolveModel } from '../../models.ts';
 import { preflightModel, renderPreflightRefusal } from '../../quotaPreflight.ts';
 import { startRun } from '../../runlog.ts';
 
 export interface PlanFlags {
-  readonly model?: string;
-  readonly out?: string;
+  readonly model: string;
+  readonly out: string;
   readonly timeout?: number;
   readonly preflight: boolean;
 }
@@ -63,7 +63,7 @@ export default async function plan(
   flags: PlanFlags,
   taskPrompt: string,
 ): Promise<void> {
-  const inputSlug = flags.model ?? DEFAULT_MODEL;
+  const inputSlug = flags.model;
   const model = resolveModel(inputSlug);
   if (!model) {
     this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);
@@ -86,11 +86,7 @@ export default async function plan(
   const promptSnippet = taskPrompt.replace(/\r?\n/g, ' ').slice(0, 80);
   const run = startRun('plan', `${model.spec.slug}: ${promptSnippet}`);
 
-  const absOutPath = flags.out
-    ? isAbsolute(flags.out)
-      ? flags.out
-      : resolve(cwd, flags.out)
-    : resolve(run.dir, 'plan.md');
+  const absOutPath = isAbsolute(flags.out) ? flags.out : resolve(cwd, flags.out);
 
   const beforePorcelain = await getPorcelainStatus(cwd);
 

package/src/commands/review/command.ts

@@ -1,5 +1,5 @@
 import { buildCommand } from '@stricli/core';
-import { DEFAULT_MODEL, listModelHelpLines } from '../../models.ts';
+import { listModelHelpLines } from '../../models.ts';
 import { positiveIntSeconds } from '../../parsers.ts';
 import reviewImpl from './impl.ts';
 
@@ -17,8 +17,7 @@ export const review = buildCommand({
       model: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: `Model slug (default: ${DEFAULT_MODEL})`,
+        brief: 'Model slug (required) — see the seat list above',
       },
       plan: {
         kind: 'parsed',
@@ -35,8 +34,7 @@ export const review = buildCommand({
       out: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: 'Where to write the review report (default: <run.dir>/review.md)',
+        brief: 'Where to write the review report (required)',
       },
       timeout: {
         kind: 'parsed',

package/src/commands/review/impl.ts

@@ -3,15 +3,15 @@ import { isAbsolute, resolve } from 'node:path';
 import { runCaptured } from '@aibridge/proc';
 import type { LocalContext } from '../../context.ts';
 import { delegate } from '../../delegate.ts';
-import { DEFAULT_MODEL, formatUnknownModelError, resolveModel } from '../../models.ts';
+import { formatUnknownModelError, resolveModel } from '../../models.ts';
 import { preflightModel, renderPreflightRefusal } from '../../quotaPreflight.ts';
 import { startRun } from '../../runlog.ts';
 
 export interface ReviewFlags {
-  readonly model?: string;
+  readonly model: string;
   readonly plan?: string;
   readonly base?: string;
-  readonly out?: string;
+  readonly out: string;
   readonly timeout?: number;
   readonly preflight: boolean;
 }
@@ -78,7 +78,7 @@ export function parseReviewVerdict(response: string): ReviewVerdictResult {
 }
 
 export default async function review(this: LocalContext, flags: ReviewFlags): Promise<void> {
-  const inputSlug = flags.model ?? DEFAULT_MODEL;
+  const inputSlug = flags.model;
   const model = resolveModel(inputSlug);
   if (!model) {
     this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);
@@ -140,11 +140,7 @@ export default async function review(this: LocalContext, flags: ReviewFlags): Pr
 
   const run = startRun('review', `${model.spec.slug}: ${modeDetail}`);
 
-  const absOutPath = flags.out
-    ? isAbsolute(flags.out)
-      ? flags.out
-      : resolve(cwd, flags.out)
-    : resolve(run.dir, 'review.md');
+  const absOutPath = isAbsolute(flags.out) ? flags.out : resolve(cwd, flags.out);
 
   let reviewPrompt: string;
   if (isDirty) {

package/src/commands/subagent/command.ts

@@ -1,5 +1,5 @@
 import { buildCommand } from '@stricli/core';
-import { DEFAULT_MODEL, listModelHelpLines } from '../../models.ts';
+import { listModelHelpLines } from '../../models.ts';
 import { nonEmptyPrompt, positiveIntSeconds } from '../../parsers.ts';
 import subagentImpl from './impl.ts';
 
@@ -8,7 +8,7 @@ const fullDescription = [
   '',
   'Available models (canonical slug):',
   ...listModelHelpLines(),
-  `Default: ${DEFAULT_MODEL} (off-budget). The claude-backend slugs are FALLBACKS for`,
+  'Recommended first choice: xai-grok/grok-4.5 (off-budget). The claude-backend slugs are FALLBACKS for',
   'when the off-budget CLIs are quota-exhausted — they bill your Claude subscription.',
 ].join('\n');
 
@@ -19,8 +19,7 @@ export const subagent = buildCommand({
       model: {
         kind: 'parsed',
         parse: String,
-        optional: true,
-        brief: `Model slug to delegate to (default: ${DEFAULT_MODEL})`,
+        brief: 'Model slug (required) — see the seat list above',
       },
       timeout: {
         kind: 'parsed',

package/src/commands/subagent/impl.ts

@@ -1,16 +1,11 @@
 import type { LocalContext } from '../../context.ts';
 import { delegate } from '../../delegate.ts';
-import {
-  backendModelId,
-  DEFAULT_MODEL,
-  formatUnknownModelError,
-  resolveModel,
-} from '../../models.ts';
+import { backendModelId, formatUnknownModelError, resolveModel } from '../../models.ts';
 import { preflightModel, renderPreflightRefusal } from '../../quotaPreflight.ts';
 import { startRun } from '../../runlog.ts';
 
 export interface SubagentFlags {
-  readonly model?: string;
+  readonly model: string;
   readonly timeout?: number;
   readonly tools: boolean;
   readonly preflight: boolean;
@@ -22,7 +17,7 @@ export default async function subagent(
   flags: SubagentFlags,
   prompt: string,
 ): Promise<void> {
-  const inputSlug = flags.model ?? DEFAULT_MODEL;
+  const inputSlug = flags.model;
   const model = resolveModel(inputSlug);
   if (!model) {
     this.process.stderr.write(`${formatUnknownModelError(inputSlug)}\n`);

package/src/flagMapping.test.ts

@@ -35,7 +35,7 @@ describe('flag mapping & defaults lock', () => {
   it('plan command maps defaults correctly', async () => {
     mockPlanImpl.mockReset();
     const ctx = fakeCtx();
-    await runCli(ctx, ['plan', 'do something']);
+    await runCli(ctx, ['plan', '--model', 'xai-grok/grok-4.5', '--out', 'plan.md', 'do something']);
     expect(mockPlanImpl).toHaveBeenCalledTimes(1);
     const [call] = mockPlanImpl.mock.calls;
     expect(call).toBeDefined();
@@ -43,6 +43,8 @@ describe('flag mapping & defaults lock', () => {
     const [flags, prompt] = call;
     expect(prompt).toBe('do something');
     expect(flags).toEqual({
+      model: 'xai-grok/grok-4.5',
+      out: 'plan.md',
       preflight: true,
     });
   });
@@ -50,7 +52,17 @@ describe('flag mapping & defaults lock', () => {
   it('plan command handles --no-preflight and --timeout', async () => {
     mockPlanImpl.mockReset();
     const ctx = fakeCtx();
-    await runCli(ctx, ['plan', '--no-preflight', '--timeout', '120', 'task']);
+    await runCli(ctx, [
+      'plan',
+      '--model',
+      'xai-grok/grok-4.5',
+      '--out',
+      'plan.md',
+      '--no-preflight',
+      '--timeout',
+      '120',
+      'task',
+    ]);
     expect(mockPlanImpl).toHaveBeenCalledTimes(1);
     const [call] = mockPlanImpl.mock.calls;
     expect(call).toBeDefined();
@@ -58,6 +70,8 @@ describe('flag mapping & defaults lock', () => {
     const [flags, prompt] = call;
     expect(prompt).toBe('task');
     expect(flags).toEqual({
+      model: 'xai-grok/grok-4.5',
+      out: 'plan.md',
       preflight: false,
       timeout: 120,
     });
@@ -66,7 +80,7 @@ describe('flag mapping & defaults lock', () => {
   it('subagent command maps defaults correctly', async () => {
     mockSubagentImpl.mockReset();
     const ctx = fakeCtx();
-    await runCli(ctx, ['subagent', 'hello agent']);
+    await runCli(ctx, ['subagent', '--model', 'xai-grok/grok-4.5', 'hello agent']);
     expect(mockSubagentImpl).toHaveBeenCalledTimes(1);
     const [call] = mockSubagentImpl.mock.calls;
     expect(call).toBeDefined();
@@ -74,6 +88,7 @@ describe('flag mapping & defaults lock', () => {
     const [flags, prompt] = call;
     expect(prompt).toBe('hello agent');
     expect(flags).toEqual({
+      model: 'xai-grok/grok-4.5',
       tools: true,
       preflight: true,
       json: false,
@@ -83,7 +98,14 @@ describe('flag mapping & defaults lock', () => {
   it('subagent command handles --no-tools and --no-preflight', async () => {
     mockSubagentImpl.mockReset();
     const ctx = fakeCtx();
-    await runCli(ctx, ['subagent', '--no-tools', '--no-preflight', 'hello agent']);
+    await runCli(ctx, [
+      'subagent',
+      '--model',
+      'xai-grok/grok-4.5',
+      '--no-tools',
+      '--no-preflight',
+      'hello agent',
+    ]);
     expect(mockSubagentImpl).toHaveBeenCalledTimes(1);
     const [call] = mockSubagentImpl.mock.calls;
     expect(call).toBeDefined();
@@ -91,6 +113,7 @@ describe('flag mapping & defaults lock', () => {
     const [flags, prompt] = call;
     expect(prompt).toBe('hello agent');
     expect(flags).toEqual({
+      model: 'xai-grok/grok-4.5',
       tools: false,
       preflight: false,
       json: false,

package/src/index.ts

@@ -6,9 +6,6 @@ export { getDriver } from './drivers.ts';
 export {
   type Backend,
   backendModelId,
-  DEFAULT_IMAGE_GEN,
-  DEFAULT_IMPLEMENTER,
-  DEFAULT_MODEL,
   type Effort,
   formatImageGenModelError,
   formatUnknownModelError,

package/src/models.ts

@@ -95,10 +95,6 @@ export const MODELS: Record<string, ModelSpec> = {
   },
 } as const satisfies Record<string, ModelSpec>;
 
-export const DEFAULT_MODEL = 'xai-grok/grok-4.5';
-export const DEFAULT_IMPLEMENTER = 'google-antigravity/gemini-3.6-flash';
-export const DEFAULT_IMAGE_GEN = 'openai-codex/gpt-5.6-sol';
-
 export type ImageFormat = 'jpg' | 'png';
 
 const IMAGE_GEN_FORMATS: ReadonlyMap<Backend, ImageFormat> = new Map([