@polderlabs/bizar 10.25.2 → 10.28.0-beta.1

package/README.md

@@ -1,20 +1,20 @@
 <div align="center">
 
-```text
-██████╗ ██╗███████╗ █████╗ ██████╗
-██╔══██╗██║╚══███╔╝██╔══██╗██╔══██╗
-██████╔╝██║  ███╔╝ ███████║██████╔╝
-██╔══██╗██║ ███╔╝  ██╔══██║██╔══██╗
-██████╔╝██║███████╗██║  ██║██║  ██║
-╚═════╝ ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝
-```
+<img src="docs/assets/bizar-banner.svg" alt="Bizar: guarded autonomy for Claude Code" width="100%" />
+
+[![npm](https://img.shields.io/npm/v/%40polderlabs%2Fbizar?color=0f766e&label=npm)](https://www.npmjs.com/package/@polderlabs/bizar)
+[![license](https://img.shields.io/badge/license-MIT-0f172a)](LICENSE)
+[![Claude Code](https://img.shields.io/badge/works%20with-Claude%20Code-d97757)](https://docs.anthropic.com/en/docs/claude-code)
+[![release](https://img.shields.io/github/v/release/PolderLabsVOF/BizarHarness?color=2563eb&label=release)](https://github.com/PolderLabsVOF/BizarHarness/releases)
+![OmniRoute routing](https://img.shields.io/badge/routing-OmniRoute-0ea5e9)
+[![Planning](https://img.shields.io/badge/planning-OpenKan-f59e0b)](https://www.npmjs.com/package/@polderlabs/openkan)
 
 ### Guarded autonomy for Claude Code
 
 Choose your models once. Give Claude Code real work. Bizar supplies the routing,
 specialists, guardrails, and evidence to carry it through responsibly.
 
-`84 agents` · `80 skills` · `33 commands` · `14-tool MCP server`
+`85 agents` · `85 skills` · `37 commands` · `21-tool MCP server`
 
 </div>
 
@@ -35,47 +35,74 @@ the project you happen to be working on.
 
 | You want | Bizar provides |
 | --- | --- |
-| A clean way to begin | A guided installer and `bizar models` picker |
-| Your own gateway models | Global selection, full-ID subagent definitions, and native alias mapping |
+| A clean way to begin | A guided installer and a static four-alias dispatch surface |
+| Your own gateway models | Four native aliases (`haiku`/`sonnet`/`opus`/`fable`) with OmniRoute handling ordered failover between configured full IDs |
 | Useful parallel work | Isolated worktrees, scoped tasks, and specialist roles |
 | Fewer surprises | Explicit safety checks for releases, publication, deployment, pushes, and destructive operations |
 | Confidence at the end | Tests, architecture checks, E2E checks, and evidence-aware handoff |
 
-## Start here
+## Before you install
+
+<table>
+  <tr>
+    <td width="50%"><strong>Claude Code</strong><br />Bizar adds its integration to your user-level Claude Code configuration. Install Claude Code with Anthropic's installer first.</td>
+    <td width="50%"><strong>Node.js 22+</strong><br />OpenKan requires Node.js 22 or newer. Bizar and OpenKan install from npm.</td>
+  </tr>
+  <tr>
+    <td width="50%"><strong>OmniRoute</strong><br />Configure a gateway endpoint, API key, and model ID. OmniRoute resolves the full model IDs behind Bizar's four aliases and handles ordered failover.</td>
+    <td width="50%"><strong>Git</strong><br />Needed for isolated worktrees and normal project history. Bizar does not require a persistent daemon.</td>
+  </tr>
+</table>
+
+```mermaid
+flowchart LR
+    CC[Claude Code] --> B[Bizar]
+    B --> OR[OmniRoute gateway]
+    OR --> M[Configured model IDs]
+    B --> OK[OpenKan]
+    OK --> S[.ok workspace]
+```
+
+Configure OmniRoute once before installing Bizar. The command writes provider
+settings to Claude Code and preserves existing hooks, permissions, and MCP
+servers.
+
+```sh
+bizar setup-provider --gateway https://your-gateway.example/v1 --key "$YOUR_API_KEY" --model your/model-id
+```
+
+## Install Bizar
 
-Install Bizar globally, install its Claude Code integration, then choose the
-models you want Bizar to use.
+Install Bizar globally and its Claude Code integration. Bizar dispatches
+through four static aliases: `haiku`, `sonnet`, `opus`, and `fable`. OmniRoute
+maps each alias to configured full model IDs and applies ordered failover.
 
 ```sh
 npm install -g @polderlabs/bizar
 bizar install
-bizar models
 ```
 
-Restart Claude Code after installation. The installer adds Bizar's agents, skills, commands, hooks, settings, and the
-default OpenKan planning runtime to your user-level Claude configuration.
-Claude Code itself is installed with Anthropic's native installer; npm is used
-for Bizar and OpenKan, not for the Claude Code CLI.
-It preserves your configured gateway endpoint and credential values during a
-clean reinstall.
+Restart Claude Code after installation. The installer adds Bizar's agents,
+skills, commands, hooks, settings, and the default OpenKan planning runtime to
+your user-level Claude configuration. It preserves your configured gateway
+endpoint and credentials during a clean reinstall.
 
-On a new interactive install, Bizar also asks for an optional default model,
-whether Claude Code agent teams should be enabled, the OpenKan install
-directory, and whether the current project should receive a `.ok/` workspace.
-OpenKan is installed from npm as `@polderlabs/openkan@latest`; its package-owned
-agent and skill are installed into the same Claude configuration. Use
-`bizar install --yes` for CI or a prompt-free refresh.
+On a new interactive install, Bizar also asks whether Claude Code agent teams
+should be enabled, the OpenKan install directory, and whether the current
+project should receive a `.ok/` workspace. OpenKan is installed from npm as
+`@polderlabs/openkan@latest`; its package-owned agent and skill are
+installed into the same Claude configuration. Use `bizar install --yes` for
+CI or a prompt-free refresh.
 
 For a completely fresh Bizar-managed Claude setup while retaining endpoint and
 authentication settings:
 
 ```sh
 bizar install --force
-bizar models
 ```
 
 Then open any repository in Claude Code and describe the outcome you want.
-Mike—the Bizar coordinator—handles the rest.
+Mike, the Bizar coordinator, handles the rest.
 
 > **Tip:** Run `bizar doctor` whenever you want to verify that the global
 > install, Claude settings, hooks, skills, agents, and provider connection are
@@ -105,66 +132,87 @@ obvious edits stay small; larger requests get only the structure they need.
 Writing agents work in Git worktrees, while read-only research stays light and
 foregrounded.
 
-## Your models, everywhere Bizar dispatches
+## OmniRoute model aliases
 
-`bizar models` is the single operator-facing place to select models. It
-discovers candidates from your configured gateway and writes your selections to
-the global model router:
+Bizar dispatches through four static native aliases: `haiku`, `sonnet`,
+`opus`, `fable`. Claude Code's native per-call `model` field accepts one of
+these aliases. OmniRoute handles ordered failover between the configured full
+gateway IDs for the chosen alias, so the operator never picks a picker-style
+gateway ID per agent at this layer. There is no `bizar models` picker, no
+`model-router.json`, no `userSelected` block, and no Agent-model-guard hook.
 
-```text
-~/.claude/model-router.json
-```
+The four aliases are the entire dispatch surface:
 
-The router is never stored in a project directory. Bizar uses the selected
-models for direct subagents, workflows, and agent-team teammates.
+| Alias | Use it for |
+| --- | --- |
+| `haiku` | Trivial, economical micro-edits |
+| `sonnet` | Ordinary implementation, research, and planning |
+| `opus` | Architecture, debugging, adversarial review, and high-risk work |
+| `fable` | Explicit Anthropic OpenAI-compatible surfaces |
+
+Workflow scripts (`config/workflows/*.js`) inline a tiny `dispatchAgent`
+wrapper that picks the alias from a static policy; agent definitions stay
+model-agnostic so the harness, not the agent, owns alias selection.
 
 ```mermaid
 flowchart TD
-    Picker["bizar models"] --> Router["Global model router\n~/.claude/model-router.json"]
-    Router --> Definitions["Global Bizar agent definitions\nfull model ID in frontmatter"]
-    Router --> Aliases["sonnet · opus · haiku · fable\ncompatibility aliases"]
-    Definitions --> Agent["Subagents"]
-    Definitions --> Workflow["Workflow workers"]
-    Definitions --> Team["Agent-team teammates"]
+    Policy["Static alias policy\n(office-manager.md + workflow routeModel)"] --> Aliases["haiku · sonnet · opus · fable"]
+    Aliases --> OmniRoute["OmniRoute ordered failover\nper configured full ID"]
+    OmniRoute --> Agent["Subagents"]
+    OmniRoute --> Workflow["Workflow workers"]
+    OmniRoute --> Team["Agent-team teammates"]
 ```
 
-Claude Code's native per-call model field has a small alias vocabulary. Bizar
-avoids making that vocabulary a limitation: it projects each selected gateway
-model into a global subagent definition whose frontmatter contains the full
-model ID. The agent, workflow, and team routes use that definition. The four
-native aliases are compatibility shortcuts only; they do not enable an
-unselected provider or reduce your selected-model pool to four choices.
-
 Useful inspection commands:
 
 ```sh
-bizar models --list
-bizar models --agent-types --json
-bizar models explain todd
 bizar doctor
 ```
 
+## OpenKan owns durable work state
+
+OpenKan is Bizar's default planning and progression system. Bizar orchestrates
+the work; OpenKan stores project-local tasks, plans, PRDs, goals, and evidence
+under `.ok/`. Bizar talks to OpenKan through the supported `ok` CLI boundary,
+so OpenKan can evolve independently.
+
+```mermaid
+flowchart LR
+    R[Repository] --> I[ok init]
+    I --> O[.ok workspace]
+    O --> T[ok task]
+    O --> P[ok plan]
+    O --> G[ok prd]
+    B[Bizar agents and hooks] --> T
+    B --> P
+    B --> G
+```
+
+The installer can create an `.ok/` workspace for the current project. In an
+existing repository, run `ok init`. Use `ok task`, `ok plan`, and `ok prd` as
+the canonical commands. On OpenKan v0.5.0 and later, `ok` replaces the legacy
+`openkan` command.
+
+| Need | Command |
+| --- | --- |
+| Install or refresh OpenKan | `bizar openkan install` |
+| Create project state | `ok init` |
+| Track scoped work | `ok task` |
+| Track plans and goals | `ok plan` and `ok prd` |
+
 ## A specialist bench, not a generic swarm
 
-Bizar ships its core coordination roles alongside 68 focused specialists for
-architecture, accessibility, security, testing, documentation, performance,
-language and framework review, build repair, operations, and evaluation. It
-also ships 80 skills for planning, debugging, verification, review,
-worktrees, and implementation practice.
+Bizar ships 85 agent definitions and 85 skill packs for architecture,
+accessibility, security, testing, documentation, performance, build repair,
+operations, planning, debugging, review, worktrees, and implementation
+practice.
 
 The coordinator selects specialists when their expertise reduces a concrete
-risk. It does not create parallel workers merely to look busy. You can inspect
-the installed specialist definition names through `bizar models --agent-types
---json` and use a relevant Bizar specialist directly when needed.
-
-```text
-Core coordination                 Specialist coverage
-─────────────────                 ──────────────────────────────────
-Mike · research · plan            Architecture · accessibility · security
-Implementation · review           Build repair · tests · documentation
-Verification · integration        Frameworks · performance · operations
-                                  Evaluation · product and domain analysis
-```
+risk. It does not create parallel workers merely to look busy.
+
+| Coordination | Specialist coverage |
+| --- | --- |
+| Research, planning, implementation, review, verification | Architecture, accessibility, security, tests, documentation, performance, build repair, operations, and domain analysis |
 
 ## Guardrails that stay out of the way
 
@@ -186,25 +234,10 @@ point where an external or difficult-to-reverse decision belongs to you.
 
 ## What gets installed
 
-```text
-~/.claude/
-├── agents/          84 Bizar roles and specialist definitions
-├── skills/          80 skill packs
-├── commands/        39 slash-command surfaces
-├── hooks/           routing, lifecycle, safety, evidence, and quality hooks
-├── rules/           focused guidance for common development work
-├── workflows/       native workflow definitions
-├── settings.json    Bizar-managed Claude Code integration
-└── model-router.json operator-selected model state
-
-~/.config/bizar/
-├── installed.json   install record
-├── openkan/          managed @polderlabs/openkan npm runtime
-├── openkan-install.json  selected OpenKan home/package settings
-├── evidence/        local dispatch and verification evidence
-├── telemetry/       local routing and rejected-action feedback
-└── worktree-queue.json  completed worktree integration queue
-```
+| Location | Contents |
+| --- | --- |
+| `~/.claude/` | 85 agent definitions, 85 skills, 37 command surfaces, hooks, rules, workflows, and managed settings |
+| `~/.config/bizar/` | Install record, managed OpenKan runtime, evidence, telemetry, and completed-worktree queue |
 
 `bizar control` is a machine-readable command boundary for optional external
 interfaces. Bizar deliberately does not include an embedded browser control
@@ -217,7 +250,6 @@ plane, background daemon, or general-purpose note vault.
 | `bizar install` | Install or refresh Bizar, OpenKan, and the global Claude configuration |
 | `bizar openkan install` | Refresh the managed `@polderlabs/openkan` npm runtime and its agent/skill |
 | `bizar openkan init` | Initialise `.ok/` planning state in the current project |
-| `bizar models` | Discover and select the models Bizar may dispatch |
 | `bizar doctor` | Diagnose the global installation and provider connectivity |
 | `bizar validate` | Run an install-focused health check |
 | `ok task` | Inspect or coordinate scoped worktree tasks (OpenKan-native) |
@@ -255,6 +287,10 @@ make check
 
 - [Documentation index](docs/INDEX.md)
 - [Architecture](docs/architecture.md)
+- [Branching model](docs/branches.md) — `master` (stable) · `beta` · `dev` (nightly)
+- [Versioning rules](docs/versioning.md) — per-branch semver + conventional commits
+- [Development workflow](docs/development.md) — local dev + promotion + manual builds
+- [npm Trusted Publishing setup](docs/trusted-publishing.md) — one-time operator config
 - [Model routing decisions](docs/decisions/)
 - [Durable project progress, plans, and goals](.ok/)
 - [MIT license](LICENSE)
@@ -262,3 +298,9 @@ make check
 ## License
 
 MIT
+
+---
+
+<div align="center">
+  <a href="https://polderlabs.io/"><img src="docs/assets/sponsored-by-polderlabs.svg" alt="Sponsored by PolderLabs" width="100%" /></a>
+</div>

package/cli/bin.mjs

@@ -108,7 +108,6 @@ function showHelp() {
     artifact               Toggle global browser completion artifacts
     learn                  Manage bounded global preferences and project lessons
     tools                  Inventory installed agents, skills, hooks, commands, and MCP tools
-    tier                   Explain the explicit configured model tier for a task
     upgrade-defaults       Reapply safe Bizar-owned Claude defaults
     backup                 Create / list / verify / delete backups of BizarHarness state
     restore                Restore BizarHarness from a backup
@@ -132,16 +131,13 @@ function showHelp() {
     goals <subcommand>     OpenKan PRDs, goals, and milestones
     claim <subcommand>     OpenKan task lease shortcut
     control <subcommand>   Machine-readable agents/tasks/plans/goals/sessions/messages API
-    workflow <subcommand>  Session-bound autopilot workflow state
     hook <name>            Run a portable Claude Code hook
     worktree-merge <branch>  Merge a feature branch with archive tag (no work lost)
     worker <subcommand>      Run an exact-model Claude process worker in a worktree
-    models                 Configure the global model picker and Models.dev metadata
     evidence <subcommand>  Inspect model-routing evidence
     improve <subcommand>   Propose and verify bounded self-edits
     sandbox <subcommand>   Manage local execution sandboxes
     explain-run <id>       Explain a recorded run
-    model                  Deprecated alias for models
 
   Examples:
     bizar install
@@ -452,22 +448,6 @@ async function main() {
       break;
     }
 
-    case 'models': {
-      const mod = await importCommand('models');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load models command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'models');
-      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
-      if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar models [--list|--set|--clear|--json] — run 'bizar models --help'`));
-        process.exit(EXIT_USAGE);
-      }
-      break;
-    }
-
     case 'artifact': {
       const mod = await importCommand('artifact');
       if (!mod) { process.exit(EXIT_ERROR); return; }
@@ -483,7 +463,6 @@ async function main() {
     }
 
     case 'tools':
-    case 'tier':
     case 'upgrade-defaults': {
       const mod = await importCommand(cmd);
       if (!mod) { process.exit(EXIT_ERROR); return; }
@@ -615,45 +594,6 @@ async function main() {
       break;
     }
 
-    case 'model': {
-      // Deprecated alias. Routes to the original `model.mjs` so the
-      // legacy JSON shape (`{ providers: { ... }, total: N }`) and table
-      // output keep working for existing scripts and tests. New code
-      // should use `bizar models` (see `case 'models'`).
-      const mod = await importCommand('model');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load model command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module (deprecated alias):', 'model');
-      if (!isHelpRequest) {
-        console.error(chalk.yellow('  ! `bizar model` is deprecated; use `bizar models` for the new picker surface.'));
-      }
-      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
-      if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar model <subcommand> — run 'bizar model --help'`));
-        process.exit(EXIT_USAGE);
-      }
-      break;
-    }
-
-    case 'workflow': {
-      const mod = await importCommand('workflow');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load workflow command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'workflow');
-      const found = await mod.run(cmd, cmdArgs, isHelpRequest);
-      if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar workflow <subcommand> — run 'bizar workflow --help'`));
-        process.exit(EXIT_USAGE);
-      }
-      break;
-    }
-
     case 'hook': {
       const mod = await importCommand('hook');
       if (!mod) {

package/cli/commands/hook.mjs

@@ -18,14 +18,12 @@ const HOOK_ROOT = resolve(PACKAGE_ROOT, 'config', 'claude', 'hooks');
 const PRETOOL_SAFETY_LEAVES = new Set([
   'pretooluse-editwrite', 'path-ownership-guard',
   'pretooluse-bash', 'git-workflow-guard',
-  'agent-model-guard',
   'workflow-route-guard',
 ]);
 
 export const HOOK_PROGRAMS = Object.freeze({
   'advisor-context': 'advisor-context.mjs',
   'agent-grounding': 'agent-grounding.mjs',
-  'agent-model-guard': 'agent-model-guard.mjs',
   'content-style-guard': 'content-style-guard.mjs',
   'completion-artifact': 'completion-artifact.mjs',
   'control-inbox': 'control-inbox.mjs',
@@ -40,11 +38,9 @@ export const HOOK_PROGRAMS = Object.freeze({
   'pretooluse-bash': 'pretooluse-bash.mjs',
   'pretooluse-editwrite': 'pretooluse-editwrite.mjs',
   'sessionend-recall': 'sessionend-recall.mjs',
-  'sessionstart-model-sync': 'sessionstart-model-sync.mjs',
   'sessionstart-prime': 'sessionstart-prime.mjs',
   'simplify-guard': 'simplify-guard.mjs',
   telemetry: 'telemetry.mjs',
-  'thinking-route': 'thinking-route.mjs',
   'team-lifecycle': 'team-lifecycle.mjs',
   'verify-deliverables': 'verify-deliverables.mjs',
   'worker-suggest': 'worker-suggest.mjs',
@@ -59,12 +55,10 @@ export const EVENT_CHAINS = Object.freeze({
     'keyword-router',
     'workflow-route-guard',
     'worker-suggest',
-    'thinking-route',
     'telemetry',
   ]),
   'session-start': Object.freeze([
     'control-inbox',
-    'sessionstart-model-sync',
     'sessionstart-prime',
     'persistent-mode',
     'telemetry',
@@ -238,7 +232,6 @@ export function selectEventChain(eventKey, input = '') {
     if (toolName === 'Bash') {
       return ['workflow-route-guard', 'pretooluse-bash', 'git-workflow-guard'];
     }
-    if (toolName === 'Agent') return ['workflow-route-guard', 'agent-model-guard'];
     return [];
   }
 

package/cli/commands/openkan.mjs

@@ -19,6 +19,9 @@ Usage:
   ok prd <add|list|show|update>          Manage PRDs, goals, and milestones
   ok doctor                              Validate the .ok/ workspace
   bizar openkan dashboard [args...]     Forward to the OpenKan dashboard CLI
+                                        (legacy openkan.mjs on pre-v0.5.0
+                                         releases; ok serve on v0.5.0+ where
+                                         the legacy binary is retired)
 
 Canonical commands are \`ok task\`, \`ok plan\`, and \`ok prd\`; they use this
 same OpenKan workspace. The Bizar planning aliases remain compatibility-only.
@@ -29,11 +32,16 @@ feature/progress files for live planning.
 
 function runDashboard(args) {
   const launcher = resolveOpenKanDashboard();
+  // OpenKan v0.5.0 dropped the legacy `openkan` dashboard launcher. The
+  // dashboard now ships as `ok serve`; route to that subcommand when the
+  // resolved launcher is the `ok` binary instead of `openkan.mjs`.
+  const isOkLauncher = launcher.endsWith('ok.mjs') || launcher.endsWith('ok.ts');
+  const launcherArgs = isOkLauncher ? ['serve', ...args] : args;
   const command = launcher.endsWith('.ts')
-    ? [process.execPath, '--experimental-strip-types', launcher, ...args]
+    ? [process.execPath, '--experimental-strip-types', launcher, ...launcherArgs]
     : launcher.endsWith('.mjs')
-      ? [process.execPath, launcher, ...args]
-      : [launcher, ...args];
+      ? [process.execPath, launcher, ...launcherArgs]
+      : [launcher, ...launcherArgs];
   const result = spawnSync(command[0], command.slice(1), { cwd: process.cwd(), encoding: 'utf8', shell: false });
   if (result.error) throw result.error;
   print({ ok: result.status === 0, status: result.status ?? 1, stdout: result.stdout || '', stderr: result.stderr || '' });

package/cli/commands/setup-provider.mjs

@@ -43,7 +43,9 @@ export function updateProviderSettings(current, options) {
   const next = { ...current, env: { ...(current.env || {}) } };
   if (options.gateway !== undefined) {
     next.env.ANTHROPIC_BASE_URL = options.gateway;
-    next.env.BIZAR_MODEL_ROUTER_URL = options.gateway;
+    // Legacy compatibility: drop any pre-existing router-URL mirror so the
+    // install surface converges on a single provider URL.
+    delete next.env.BIZAR_MODEL_ROUTER_URL;
   }
   if (options.key !== undefined) next.env.ANTHROPIC_AUTH_TOKEN = options.key;
   if (options.model !== undefined) next.env.ANTHROPIC_MODEL = options.model;
@@ -87,7 +89,7 @@ export async function runSetupProvider(args = []) {
 
   if (options.list) {
     console.log(`  Settings: ${path}`);
-    console.log(`  Gateway: ${current.env?.ANTHROPIC_BASE_URL || current.env?.BIZAR_MODEL_ROUTER_URL || '(Anthropic default)'}`);
+    console.log(`  Gateway: ${current.env?.ANTHROPIC_BASE_URL || '(Anthropic default)'}`);
     console.log(`  Model:   ${current.env?.ANTHROPIC_MODEL || '(Claude Code default)'}`);
     console.log(`  API key: ${redact(current.env?.ANTHROPIC_AUTH_TOKEN || current.env?.ANTHROPIC_API_KEY)}`);
     return { ok: true, path, settings: current };

package/cli/commands/tools.mjs

@@ -15,7 +15,7 @@ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { resolveClaudeConfigDir, resolveGlobalModelRouter } from '../config-paths.mjs';
+import { resolveClaudeConfigDir } from '../config-paths.mjs';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = resolve(__filename, '..', '..');
 const CLAUDE_DIR = resolveClaudeConfigDir();
@@ -80,8 +80,6 @@ export async function runTools(cmdArgs) {
 
   const settingsPath = join(CLAUDE_DIR, 'settings.json');
   const hasSettings = existsSync(settingsPath);
-  const modelRouterPath = resolveGlobalModelRouter();
-  const hasModelRouter = existsSync(modelRouterPath);
 
   const summary = {
     userLevel: CLAUDE_DIR,
@@ -92,7 +90,6 @@ export async function runTools(cmdArgs) {
     wiredCommands,
     mcpTools,
     settings: { path: settingsPath, present: hasSettings },
-    modelRouter: { path: modelRouterPath, present: hasModelRouter },
   };
 
   if (asJson) {
@@ -118,8 +115,24 @@ export async function runTools(cmdArgs) {
   section(`wired bizar commands (${wiredCommands.length})`, wiredCommands.map((c) => 'bizar ' + c));
   console.log(chalk.bold('\n  settings'));
   console.log(`    ${hasSettings ? '✓' : '✗'} ${settingsPath}`);
-  console.log(chalk.bold('  model-router'));
-  console.log(`    ${hasModelRouter ? '✓' : '✗'} ${modelRouterPath}`);
+  if (hasSettings) {
+    try {
+      const parsed = JSON.parse(readFileSync(settingsPath, 'utf8'));
+      const env = (parsed && parsed.env) || {};
+      const aliases = {
+        sonnet: env.ANTHROPIC_DEFAULT_SONNET_MODEL,
+        haiku: env.ANTHROPIC_DEFAULT_HAIKU_MODEL,
+        opus: env.ANTHROPIC_DEFAULT_OPUS_MODEL,
+        fable: env.ANTHROPIC_DEFAULT_FABLE_MODEL,
+      };
+      console.log(chalk.bold('  alias map'));
+      for (const [key, value] of Object.entries(aliases)) {
+        console.log(`    ${key.padEnd(8)} → ${value || '(unset)'}`);
+      }
+      const model = parsed?.model;
+      if (model) console.log(chalk.dim(`    default model: ${model}`));
+    } catch { /* ignore malformed settings */ }
+  }
 }
 
 export async function run(name, args, isHelpRequest) {

package/cli/commands/upgrade-defaults.mjs

@@ -35,42 +35,18 @@
 import chalk from 'chalk';
 import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { resolveClaudeConfigDir, resolveGlobalModelRouter } from '../config-paths.mjs';
-import { configuredFallbackModels } from './models.mjs';
+import { resolveClaudeConfigDir } from '../config-paths.mjs';
 
 const CLAUDE_DIR = resolveClaudeConfigDir();
 const SETTINGS_PATH = join(CLAUDE_DIR, 'settings.json');
-// 10.22.0 / Phase 4 spirit-of-constraint: the install model id comes
-// from the operator's `userSelected.models[0]`, not a hardcoded literal.
-// The Bizar global router is the sole model-policy source.
-const BIZAR_ROUTER_PATH = resolveGlobalModelRouter();
-
-function readConfiguredModels() {
-  for (const path of [BIZAR_ROUTER_PATH]) {
-    if (!existsSync(path)) continue;
-    try {
-      const parsed = JSON.parse(readFileSync(path, 'utf8'));
-      const list = Array.isArray(parsed?.userSelected?.models)
-        ? parsed.userSelected.models.filter((id) => typeof id === 'string' && id.trim())
-        : [];
-      if (list.length > 0) return list;
-      const fallback = configuredFallbackModels(parsed);
-      if (fallback.length > 0) return fallback;
-      // An explicit empty selection is an intentional global policy.
-      if (path === BIZAR_ROUTER_PATH && parsed && typeof parsed === 'object'
-          && Array.isArray(parsed.userSelected?.models)) {
-        return [];
-      }
-    } catch { /* keep falling through */ }
-  }
-  return [];
-}
 
 const STATIC_FAVORED = {
   permissions: { defaultMode: 'bypassPermissions' },
   worktree: { bgIsolation: 'worktree' },
-  // `model` is intentionally absent — `buildFavored()` derives it from
-  // userSelected.models[0] (or omits it when empty).
+  // `model` is intentionally absent — settings.json ships the alias
+  // binding (model + modelOverrides + the four ANTHROPIC_DEFAULT_*_MODEL
+  // env vars) as the canonical source. `upgrade-defaults` only re-applies
+  // the safe Bizar-owned UX defaults, not model policy.
   alwaysThinkingEnabled: true,
   effortLevel: 'high',
   skipDangerousModePermissionPrompt: true,
@@ -79,10 +55,7 @@ const STATIC_FAVORED = {
 };
 
 function buildFavored() {
-  const out = { ...STATIC_FAVORED };
-  const picks = readConfiguredModels();
-  if (picks[0]) out.model = picks[0];
-  return out;
+  return { ...STATIC_FAVORED };
 }
 
 export async function run(name, args, isHelpRequest) {

package/cli/commands/util.mjs

@@ -82,7 +82,7 @@ export function showDoctorHelp() {
       • hook wiring
       • installed agents and skills
       • required local tools
-      • model-router reachability
+      • alias map (ANTHROPIC_DEFAULT_*_MODEL)
 
     Prints ✓/✗ for each check and a final summary. Exits non-zero
     if any check fails. Use \`bizar doctor\` after installation or