@polderlabs/bizar 10.25.1 → 10.26.0

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Bizar Harness is a Claude Code-native, guarded-autonomy harness. It ships project and user-level agents, skills, slash commands, hooks, an MCP server, CLI utilities, and verification scripts. OpenKan is bundled as Bizar’s default durable planning, progression, task, and PRD-goal system; Bizar integrates with it only through the `.ok/` workspace and its supported CLI boundary.
 
-If you are an agent: read this file, inspect `.ok/` with `bizar task list` and `bizar goals list`, then run `make check` before changing code.
+If you are an agent: read this file, inspect `.ok/` with `ok task list` and `ok prd list`, then run `make check` before changing code.
 
 ## Commands
 
@@ -15,9 +15,9 @@ make check-arch               # architectural and removed-surface checks
 make verify-removed-surfaces  # prove deleted subsystems are absent
 make verify-repo-structure    # prove tracked/package paths are clean
 make clean-check              # debug-artifact/static hygiene gate
-bizar task list               # OpenKan task progression
-bizar plan list               # OpenKan plans
-bizar goals list              # OpenKan PRD goals
+ok task list               # OpenKan task progression
+ok plan list               # OpenKan plans
+ok prd list              # OpenKan PRD goals
 make session-start            # lifecycle compatibility target
 make session-end              # lifecycle compatibility target
 ```

package/README.md

@@ -35,34 +35,43 @@ 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
 
-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 native aliases — `haiku`, `sonnet`, `opus`, `fable` —
+and OmniRoute handles ordered failover between configured full IDs for the
+chosen alias, so there is no model picker step.
 
 ```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.
 
+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.
@@ -98,40 +107,36 @@ foregrounded.
 
 ## Your models, everywhere Bizar dispatches
 
-`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.
+- `haiku` — trivial / cheap micro-edits
+- `sonnet` — ordinary implementation, research, planning lanes
+- `opus` — hard / architectural / adversarial / debug / high-risk review lanes
+- `fable` — explicit Anthropic OpenAI-compat 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
 ```
 
@@ -144,9 +149,7 @@ also ships 80 skills for planning, debugging, verification, 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.
+risk. It does not create parallel workers merely to look busy.
 
 ```text
 Core coordination                 Specialist coverage
@@ -186,10 +189,12 @@ point where an external or difficult-to-reverse decision belongs to you.
 ├── 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
+└── agents/          Bizar agent definitions (alias-agnostic)
 
 ~/.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
@@ -203,11 +208,13 @@ plane, background daemon, or general-purpose note vault.
 
 | Command | When to use it |
 | --- | --- |
-| `bizar install` | Install or refresh Bizar in your global Claude configuration |
-| `bizar models` | Discover and select the models Bizar may dispatch |
+| `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 doctor` | Diagnose the global installation and provider connectivity |
 | `bizar validate` | Run an install-focused health check |
-| `bizar task` | Inspect or coordinate scoped worktree tasks |
+| `ok task` | Inspect or coordinate scoped worktree tasks (OpenKan-native) |
+| `ok plan` / `ok prd` | Manage OpenKan plans and PRD goals |
 | `bizar worktree-merge --all` | Review and merge completed isolated work, surfacing conflicts |
 | `bizar control snapshot --json` | Read the machine-friendly current harness state |
 | `bizar evidence` | Inspect local dispatch and verification evidence |

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
@@ -136,12 +135,10 @@ function showHelp() {
     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
@@ -154,7 +151,7 @@ function showHelp() {
 
   Install:
     npm install -g @polderlabs/bizar
-    npm install -g @anthropic-ai/claude-code
+    curl -fsSL https://claude.ai/install.sh | bash
   `);
 }
 
@@ -399,7 +396,7 @@ async function main() {
       dbg('loaded command module:', 'claim');
       const found = await mod.run(cmd, cmdArgs, isHelpRequest);
       if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar claim <subcommand> — run 'bizar claim --help'`));
+        console.error(chalk.red(`  ✗ Usage: ok task claim <task-id> — run 'ok task --help'`));
         process.exit(EXIT_USAGE);
       }
       break;
@@ -415,7 +412,7 @@ async function main() {
       dbg('loaded command module:', 'task');
       const found = await mod.run(cmd, cmdArgs, isHelpRequest);
       if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar task <subcommand> — run 'bizar task --help'`));
+        console.error(chalk.red(`  ✗ Usage: ok task <subcommand> — run 'ok task --help'`));
         process.exit(EXIT_USAGE);
       }
       break;
@@ -452,22 +449,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 +464,6 @@ async function main() {
     }
 
     case 'tools':
-    case 'tier':
     case 'upgrade-defaults': {
       const mod = await importCommand(cmd);
       if (!mod) { process.exit(EXIT_ERROR); return; }
@@ -615,29 +595,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) {

package/cli/commands/claim.mjs

@@ -3,16 +3,16 @@ import { OpenKanError, runOpenKanOk } from '../openkan.mjs';
 
 function help() {
   process.stdout.write(`
-  bizar claim — claim an OpenKan task lease
+  ok task claim — claim an OpenKan task lease
 
   Usage:
-    bizar claim <task-id> [--who <agent>] [--lease-ms <ms>]
-    bizar claim release <task-id> [--who <agent>]
-    bizar claim heartbeat <task-id> [--who <agent>] [--lease-ms <ms>]
-    bizar claim list [--status <status>] [--json]
+    ok task claim <task-id> [--who <agent>] [--lease-ms <ms>]
+    ok task release <task-id> [--who <agent>]
+    ok task heartbeat <task-id> [--who <agent>] [--lease-ms <ms>]
+    ok task list [--status <status>] [--json]
 
   Claims are OpenKan .ok locks, not feature_list.json annotations. Use
-  \`bizar task update\` for status transitions and \`bizar goals\` for PRDs.
+  \`ok task update\` for status transitions and \`ok prd\` for PRDs.
 `);
 }
 

package/cli/commands/goal-bootstrap.mjs

@@ -9,7 +9,7 @@ function usage() {
   bizar goal-bootstrap — retired compatibility alias
 
   OpenKan PRDs are Bizar's default durable goal system.
-  Use: bizar goals list | bizar goals add <title> | bizar goals update <id> ...
+  Use: ok prd list | ok prd add <title> | ok prd update <id> ...
 `);
 }
 

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/install.mjs

@@ -53,18 +53,23 @@ export function showInstallHelp() {
     while the prior ANTHROPIC_* and BIZAR_* env vars are merged back
     in from the stash.
 
-    1. Installs @polderlabs/bizar via npm (skipped if already current).
-    2. Installs or updates OpenKan from its official installer as Bizar's
-       default durable planning, progression, and PRD-goal runtime.
-    3. Shells to ./install.sh for platform-specific system dependencies.
-    4. Syncs agent files, slash commands, and bundled skills into
+    1. Uses the already-installed @polderlabs/bizar package.
+    2. Installs or updates Claude Code with Anthropic's native installer
+       (never npm) when the native launcher is absent.
+    3. Installs or updates OpenKan from npm as Bizar's default durable
+       planning, progression, and PRD-goal runtime.
+    4. Uses platform dependencies prepared by ./install.sh when invoked
+       through that bootstrap.
+    5. Syncs agent files, slash commands, and bundled skills into
        ~/.claude/ (or $CLAUDE_CONFIG_DIR).
-    5. Registers the Bizar MCP server in ~/.claude/settings.json.
-    6. Wires Claude Code lifecycle hooks (SessionStart / PreToolUse /
+    6. Registers the Bizar MCP server in ~/.claude/settings.json.
+    7. Wires Claude Code lifecycle hooks (SessionStart / PreToolUse /
        PostToolUse / UserPromptSubmit) under ~/.claude/hooks/.
-    7. In a terminal, confirms the install and securely asks for a provider
-       URL and key only when they are not already configured.
-    8. Runs 'bizar doctor' as a post-install health check.
+    8. In a terminal, confirms the install and securely asks for a provider
+       URL and key only when they are not already configured. Fresh setups
+       can also choose a default model, agent teams, OpenKan home, and whether
+       to initialise the current project's .ok/ workspace.
+    9. Runs 'bizar doctor' as a post-install health check.
 
     Provider settings are global (~/.claude/settings.json), so they work from
     every project. Key input is hidden. Use --yes or --non-interactive to skip

package/cli/commands/openkan.mjs

@@ -1,5 +1,5 @@
 import { spawnSync } from 'node:child_process';
-import { executableOnPath, ensureOpenKanProject, installOpenKanPromise, OpenKanError, runOpenKanOk } from '../openkan.mjs';
+import { ensureOpenKanProject, installOpenKanPromise, OpenKanError, resolveOpenKanDashboard, runOpenKanOk } from '../openkan.mjs';
 
 function print(result) {
   if (result.stdout) process.stdout.write(result.stdout);
@@ -13,23 +13,28 @@ bizar openkan — default durable planning and goals surface
 
 Usage:
   bizar openkan install                 Install @polderlabs/openkan@latest from npm
-  bizar openkan init                    Initialise .ok/ in this project
-  bizar openkan task <ok task args...>  Manage durable tasks
-  bizar openkan plan <ok plan args...>  Manage plans and phases
-  bizar openkan goals <ok prd args...>  Manage PRDs, goals, and milestones
-  bizar openkan doctor                  Validate the .ok/ workspace
+  ok init                                Initialise .ok/ in this project
+  ok task <add|list|show|update|...>     Manage durable tasks
+  ok plan <add|list|show|update>         Manage plans and phases
+  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
 
-Shortcuts: \`bizar task\`, \`bizar plan\`, and \`bizar goals\` use this
-same OpenKan workspace. Bizar no longer creates a SQLite task ledger or
+Canonical commands are \`ok task\`, \`ok plan\`, and \`ok prd\`; they use this
+same OpenKan workspace. The Bizar planning aliases remain compatibility-only.
+Bizar no longer creates a SQLite task ledger or
 feature/progress files for live planning.
 `);
 }
 
 function runDashboard(args) {
-  const bin = process.env.BIZAR_OPENKAN_BIN || executableOnPath('openkan');
-  if (!bin) throw new OpenKanError('OPENKAN_NOT_FOUND', 'OpenKan is required. Run `bizar openkan install`.');
-  const result = spawnSync(bin, args, { cwd: process.cwd(), encoding: 'utf8', shell: false });
+  const launcher = resolveOpenKanDashboard();
+  const command = launcher.endsWith('.ts')
+    ? [process.execPath, '--experimental-strip-types', launcher, ...args]
+    : launcher.endsWith('.mjs')
+      ? [process.execPath, launcher, ...args]
+      : [launcher, ...args];
+  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 || '' });
 }
@@ -40,8 +45,9 @@ export async function run(name, args, isHelpRequest) {
   if (isHelpRequest || !subcommand || subcommand === 'help') { help(); return true; }
   try {
     if (subcommand === 'install') {
-      const result = await installOpenKanPromise();
-      print(result);
+      const result = await installOpenKanPromise({ persistConfig: true });
+      process.stdout.write(`  ✓ ${result.message}\n`);
+      if (result.agent?.skipped) process.stdout.write('  ! OpenKan agent/skill installation was skipped by configuration.\n');
       return true;
     }
     if (subcommand === 'init') {

package/cli/commands/planning.mjs

@@ -3,7 +3,7 @@ import { OpenKanError, runOpenKanOk } from '../openkan.mjs';
 
 function usage(name) {
   const resource = name === 'goals' ? 'prd' : 'plan';
-  process.stdout.write(`\n  bizar ${name} — OpenKan ${resource} lifecycle\n\n  Usage: bizar ${name} <ok ${resource} args...>\n  Run \`bizar openkan ${name} --help\` for the canonical OpenKan surface.\n`);
+  process.stdout.write(`\n  bizar ${name} — compatibility alias for OpenKan ${resource}\n\n  Usage: ok ${resource} <args...>\n  Run \`ok ${resource} --help\` for the canonical OpenKan surface.\n`);
 }
 
 export async function run(name, args, isHelpRequest) {

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/task.mjs

@@ -3,18 +3,18 @@ import { OpenKanError, runOpenKanOk } from '../openkan.mjs';
 
 function help() {
   process.stdout.write(`
-  bizar task — OpenKan-backed task lifecycle
+  ok task — OpenKan-backed task lifecycle
 
   Usage:
-    bizar task add <title> [--owner agent] [--priority p0|p1|p2|p3]
-    bizar task list [--status pending|in_progress|review|done|cancelled] [--json]
-    bizar task show <id> [--json]
-    bizar task claim <id> --owner <agent> [--lease-ms <ms>]
-    bizar task heartbeat <id> --owner <agent> [--lease-ms <ms>]
-    bizar task update <id> --status <status> [--evidence <text>]
-    bizar task complete <id> --owner <agent> --evidence <text>
-    bizar task cancel <id> --owner <agent> --reason <text>
-    bizar task release <id> --owner <agent>
+    ok task add <title> [--owner agent] [--priority p0|p1|p2|p3]
+    ok task list [--status pending|in_progress|review|done|cancelled] [--json]
+    ok task show <id> [--json]
+    ok task claim <id> --owner <agent> [--lease-ms <ms>]
+    ok task heartbeat <id> --owner <agent> [--lease-ms <ms>]
+    ok task update <id> --status <status> [--evidence <text>]
+    ok task complete <id> --owner <agent> --evidence <text>
+    ok task cancel <id> --owner <agent> --reason <text>
+    ok task release <id> --owner <agent>
 
   This is an exact convenience alias for \`ok task\`. OpenKan persists task
   state, scoped ownership, dependencies, evidence, plans, and goals under

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