@polderlabs/bizar 9.0.0 → 10.0.7

package/.claude/worktrees/kanban-overhaul/config/hooks/PostToolUse

@@ -1,66 +0,0 @@
-#!/usr/bin/env node
-// PostToolUse — Bizar harness hook.
-//
-// Runs AFTER a tool completes. Reads JSON from stdin, outputs JSON to
-// stdout. This hook does NOT block (post-tool actions can't undo the
-// call); it just adds context for the AI's next decision.
-//
-// Responsibilities:
-//   1. Log tool latency for performance observability (append-only JSONL).
-//   2. Surface any pre-tool warnings (e.g. console.log detected) AFTER
-//      the tool ran, so the model gets a second chance to fix it.
-//   3. Remind the AI to run /test before claiming "done".
-
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-let raw = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { raw += chunk; });
-process.stdin.on('end', () => {
-  let input = {};
-  try { input = JSON.parse(raw); } catch { input = {}; }
-  const post = input.postToolUse || {};
-  const toolName = String(post.toolName || '');
-  const success = post.success !== false;
-  const executionTimeMs = Number(post.executionTimeMs) || 0;
-  const params = (post.parameters && typeof post.parameters === 'object') ? post.parameters : {};
-
-  // 1. Append-only JSONL log under ~/.config/bizar/hook-logs/
-  try {
-    const logDir = path.join(os.homedir(), '.config', 'bizar', 'hook-logs');
-    fs.mkdirSync(logDir, { recursive: true });
-    const today = new Date().toISOString().slice(0, 10);
-    const logFile = path.join(logDir, `post-tool-use-${today}.jsonl`);
-    const line = JSON.stringify({
-      ts: new Date().toISOString(),
-      tool: toolName,
-      success,
-      executionTimeMs,
-      sessionId: input.taskId || null,
-    });
-    fs.appendFileSync(logFile, line + '\n');
-  } catch { /* best-effort */ }
-
-  const out = { cancel: false, contextModification: '' };
-  const notes = [];
-
-  if (!success) {
-    notes.push(`Bizar PostToolUse: tool '${toolName}' failed. Investigate the error before proceeding.`);
-  } else if (executionTimeMs > 5000) {
-    notes.push(`Bizar PostToolUse: tool '${toolName}' took ${executionTimeMs}ms — consider whether this is worth the cost.`);
-  }
-
-  // Surface a reminder for write_to_file / apply_patch to src/.
-  const path = params.path || params.file_path || params.filePath || params.target_file || '';
-  if (/^write_to_file$|^apply_patch$|^replace_in_file$|^edit$/i.test(toolName) &&
-      /\/src\/|\/plugins\/|\/packages\//.test(String(path))) {
-    notes.push("Bizar PostToolUse: if you're done editing, run `/test` to gate the change with tests before claiming complete.");
-  }
-
-  out.contextModification = notes.join(' ');
-  process.stdout.write(JSON.stringify(out) + '\n');
-});

package/.claude/worktrees/kanban-overhaul/config/hooks/PreToolUse

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-// PreToolUse — Bizar harness hook.
-//
-// Cline hook script (https://docs.cline.bot/customization/hooks).
-// Runs BEFORE any tool call. Reads JSON from stdin, outputs JSON to
-// stdout. Returns `{ cancel: true, errorMessage: "..." }` to block
-// the tool call, or `{ cancel: false, contextModification: "..." }`
-// to add context for the next AI decision.
-//
-// This hook enforces three Bizar harness invariants:
-//   1. Block writes to .env, secrets, .lock files, node_modules.
-//   2. Warn (don't block) on console.log / debugger / .only() in src/.
-//   3. Always return a small context line for the next AI decision.
-
-'use strict';
-
-let raw = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { raw += chunk; });
-process.stdin.on('end', () => {
-  let input = {};
-  try { input = JSON.parse(raw); } catch { input = {}; }
-  const pre = input.preToolUse || {};
-  const toolName = String(pre.toolName || '');
-  const params = (pre.parameters && typeof pre.parameters === 'object') ? pre.parameters : {};
-
-  const out = { cancel: false, contextModification: '' };
-  const notes = [];
-
-  // Extract the most common "path" parameter (varies by tool name).
-  const path =
-    params.path ||
-    params.file_path ||
-    params.filePath ||
-    params.target_file ||
-    params.targetFile ||
-    params.notebook_path ||
-    '';
-
-  const lower = String(path).toLowerCase();
-
-  // 1. Hard block — secrets + protected paths.
-  const blocked = [
-    /\/\.env(\.|$|\/)/,
-    /\/\.envrc$/,
-    /\/secrets?\//,
-    /\/credentials?/,
-    /\/node_modules\//,
-    /\.(lock|lockb)$/,
-    /\/package-lock\.json$/,
-    /\/bun\.lockb?$/,
-    /\/yarn\.lock$/,
-  ];
-  if (path && blocked.some((re) => re.test(lower))) {
-    out.cancel = true;
-    out.errorMessage = `PreToolUse: refusing to write to protected path '${path}' (Bizar harness policy).`;
-    process.stdout.write(JSON.stringify(out) + '\n');
-    return;
-  }
-
-  // 2. Warn — debug artifacts in src/.
-  if (path && /\.(ts|tsx|js|jsx|mjs|cjs)$/.test(lower)) {
-    if (/\/src\//.test(lower) || /\/plugins\//.test(lower) || /\/packages\//.test(lower)) {
-      const text = JSON.stringify(params);
-      if (/\bconsole\.(log|debug|warn)\b/.test(text) && !/\bconsole\.(error|info)\b/.test(text)) {
-        notes.push('Heads up: console.log detected in src — `make clean-check` will fail.');
-      }
-      if (/\bdebugger\b/.test(text)) {
-        notes.push('Heads up: debugger statement detected — remove before committing.');
-      }
-      if (/\.only\s*\(/.test(text) && !/^[\s\S]*\.skip\s*\(/m.test(text)) {
-        notes.push('Heads up: .only() detected — `make clean-check` will fail.');
-      }
-    }
-  }
-
-  // 3. Always add a small context line for the AI's next decision.
-  notes.push(`Bizar PreToolUse: tool=${toolName || 'unknown'} path=${path || '(no path)'}`);
-
-  out.contextModification = notes.join(' ');
-  process.stdout.write(JSON.stringify(out) + '\n');
-});

package/.claude/worktrees/kanban-overhaul/config/hooks/README.md

@@ -1,68 +0,0 @@
-# Bizar Harness — Cline Hooks
-
-This directory contains Cline-native hook scripts. They are NOT markdown
-behavioral patterns — they are real Cline hook executables that run at
-specific lifecycle events.
-
-## Format
-
-Cline hooks are executable scripts (no extension) with a shebang line:
-
-```bash
-#!/usr/bin/env node
-```
-
-They live in two locations:
-- **Global**: `~/Documents/Cline/Hooks/` (applies to all workspaces)
-- **Workspace**: `.clinerules/hooks/` (applies to one project)
-
-The `bizar install` / `bizar update` commands install these scripts to
-**both** locations with `chmod +x` so Cline picks them up.
-
-## What each hook does
-
-| Hook | Stage | Job |
-|------|-------|-----|
-| `TaskStart` | New task | Prime the AI with `.bizar/PROJECT.md` + memory-vault search |
-| `TaskResume` | Existing task resumed | Re-read project state, check `git log` since last run |
-| `UserPromptSubmit` | User submits prompt | Tag the prompt for routing (`/team`, `/plow-through`, etc.) |
-| `PreToolUse` | Before every tool | Block writes to `.env`, `secrets/`, `node_modules/`, lockfiles; warn on `console.log`/`debugger`/`.only()` in `src/` |
-| `PostToolUse` | After every tool | Log latency to `~/.config/bizar/hook-logs/`, remind to run `/test` after edits |
-
-## I/O contract
-
-Cline invokes each hook with **JSON on stdin** and reads **JSON on stdout**.
-
-Input shape (Cline → hook):
-
-```json
-{
-  "clineVersion": "3.0.39",
-  "hookName": "PreToolUse",
-  "taskId": "...",
-  "preToolUse": { "toolName": "write_to_file", "parameters": { "path": "src/foo.ts", ... } }
-}
-```
-
-Output shape (hook → Cline):
-
-```json
-{
-  "cancel": false,
-  "contextModification": "small note for the next AI decision"
-}
-```
-
-Set `cancel: true` to block the tool call. The optional `errorMessage`
-is shown to the user.
-
-## Disabling a hook
-
-Rename the file to add a `.disabled` suffix (e.g. `PreToolUse.disabled`)
-or remove the executable bit (`chmod -x PreToolUse`). Cline silently
-skips hooks it can't execute.
-
-## See also
-
-- [Cline hooks documentation](https://docs.cline.bot/customization/hooks)
-- `cli/commands/validate.mjs` — `bizar validate` includes a `hooks-installed` check

package/.claude/worktrees/kanban-overhaul/config/hooks/TaskResume

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-// TaskResume — Bizar harness hook.
-//
-// Runs when an existing task is resumed. Reads JSON from stdin, outputs
-// JSON to stdout. Used to remind the model of previous progress and to
-// detect scope drift since the last run.
-
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-let raw = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { raw += chunk; });
-process.stdin.on('end', () => {
-  let input = {};
-  try { input = JSON.parse(raw); } catch { input = {}; }
-  const task = input.taskResume || {};
-  const previous = task.previousState || {};
-
-  try {
-    const logDir = path.join(os.homedir(), '.config', 'bizar', 'hook-logs');
-    fs.mkdirSync(logDir, { recursive: true });
-    const today = new Date().toISOString().slice(0, 10);
-    const logFile = path.join(logDir, `task-resume-${today}.jsonl`);
-    fs.appendFileSync(logFile, JSON.stringify({
-      ts: new Date().toISOString(),
-      taskId: input.taskId || null,
-      lastMessageTs: previous.lastMessageTs || null,
-      messageCount: previous.messageCount || null,
-    }) + '\n');
-  } catch { /* best-effort */ }
-
-  const notes = [
-    'Bizar TaskResume: re-read `.bizar/PROJECT.md` and `PROGRESS.md` before continuing.',
-    'Bizar TaskResume: check `git log --oneline -10` to see what changed since the last run.',
-  ];
-  if (previous.conversationHistoryDeleted) {
-    notes.push('Bizar TaskResume: WARNING — conversation history was deleted. Context from previous run is gone; verify scope before continuing.');
-  }
-
-  process.stdout.write(JSON.stringify({
-    cancel: false,
-    contextModification: notes.join(' '),
-  }) + '\n');
-});

package/.claude/worktrees/kanban-overhaul/config/hooks/TaskStart

@@ -1,47 +0,0 @@
-#!/usr/bin/env node
-// TaskStart — Bizar harness hook.
-//
-// Runs when a NEW task is started (not when resuming). Reads JSON from
-// stdin, outputs JSON to stdout. Used to prime the AI with project
-// context and to record the start of a session.
-
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-let raw = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { raw += chunk; });
-process.stdin.on('end', () => {
-  let input = {};
-  try { input = JSON.parse(raw); } catch { input = {}; }
-  const task = input.taskStart || {};
-  const initial = String(task.taskMetadata?.initialTask || '').slice(0, 500);
-
-  // Log task start to ~/.config/bizar/hook-logs/
-  try {
-    const logDir = path.join(os.homedir(), '.config', 'bizar', 'hook-logs');
-    fs.mkdirSync(logDir, { recursive: true });
-    const today = new Date().toISOString().slice(0, 10);
-    const logFile = path.join(logDir, `task-start-${today}.jsonl`);
-    fs.appendFileSync(logFile, JSON.stringify({
-      ts: new Date().toISOString(),
-      taskId: input.taskId || null,
-      clineVersion: input.clineVersion || null,
-      initial: initial,
-    }) + '\n');
-  } catch { /* best-effort */ }
-
-  const notes = [
-    'Bizar TaskStart: read `.bizar/PROJECT.md` (if present) before any routing decision.',
-    'Bizar TaskStart: if memory vault exists, run `bizar memory search "<topic>"` first.',
-    'Bizar TaskStart: Odin dispatches to subagents via `task` (sync) or `bizar_spawn_background` (async).',
-  ];
-
-  process.stdout.write(JSON.stringify({
-    cancel: false,
-    contextModification: notes.join(' '),
-  }) + '\n');
-});

package/.claude/worktrees/kanban-overhaul/config/hooks/UserPromptSubmit

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-// UserPromptSubmit — Bizar harness hook.
-//
-// Runs when the user submits a prompt. Reads JSON from stdin, outputs
-// JSON to stdout. Used to lightly tag user prompts for routing and to
-// add a "Plow Through" prompt hint when ambiguity is detected.
-
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-let raw = '';
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { raw += chunk; });
-process.stdin.on('end', () => {
-  let input = {};
-  try { input = JSON.parse(raw); } catch { input = {}; }
-  const submit = input.userPromptSubmit || {};
-  const prompt = String(submit.prompt || '').trim();
-
-  // Always log (no PII redaction needed — the prompt is the user's).
-  try {
-    const logDir = path.join(os.homedir(), '.config', 'bizar', 'hook-logs');
-    fs.mkdirSync(logDir, { recursive: true });
-    const today = new Date().toISOString().slice(0, 10);
-    const logFile = path.join(logDir, `user-prompt-${today}.jsonl`);
-    fs.appendFileSync(logFile, JSON.stringify({
-      ts: new Date().toISOString(),
-      taskId: input.taskId || null,
-      promptLength: prompt.length,
-    }) + '\n');
-  } catch { /* best-effort */ }
-
-  const notes = [];
-  if (prompt.length === 0) {
-    notes.push('Bizar UserPromptSubmit: empty prompt — wait for actual user input.');
-  } else if (prompt.startsWith('/team')) {
-    notes.push('Bizar UserPromptSubmit: /team — Odin will spawn a coordinated agent team. Confirm disjoint file scopes before dispatching.');
-  } else if (prompt.startsWith('/plow-through')) {
-    notes.push('Bizar UserPromptSubmit: /plow-through — autonomous mode. Dispatch 2+ parallel agents when possible. Run /test before claiming done.');
-  } else if (prompt.startsWith('/test')) {
-    notes.push('Bizar UserPromptSubmit: /test — auto-detects runner (jest/vitest/bun/pytest/cargo/go). Streams output to the user.');
-  } else if (prompt.startsWith('/validate')) {
-    notes.push('Bizar UserPromptSubmit: /validate — runs 21-point health check on the Bizar install.');
-  } else {
-    notes.push('Bizar UserPromptSubmit: if the request is complex, decompose into 2+ parallel subagent tasks (Odin) or spawn a /team.');
-  }
-
-  process.stdout.write(JSON.stringify({
-    cancel: false,
-    contextModification: notes.join(' '),
-  }) + '\n');
-});

package/.claude/worktrees/kanban-overhaul/config/rules/general.md

@@ -1,9 +0,0 @@
-# General Rules
-
-- Never commit `.env` files, API keys, secrets, or tokens
-- Never use `console.log` for debugging — use the debugger or a proper logging library
-- All code must be reviewed by another agent before merging
-- Keep functions small and focused — a function should do one thing
-- Use meaningful names for variables, functions, and classes
-- Prefer readability over cleverness
-- When uncertain or stuck, reach for `websearch` / `webfetch` (or `semble search` / `hindsight_recall` for repo and project memory) before trying a third variation of the same edit — see `uncertainty.md`

package/.claude/worktrees/kanban-overhaul/config/rules/git.md

@@ -1,11 +0,0 @@
-# Git Rules
-
-- Write conventional commit messages: `type(scope): description`
-  Types: feat, fix, chore, docs, style, refactor, perf, test, ci
-- Keep commits small and atomic — one logical change per commit
-- Never force-push to shared branches
-- Always rebase onto target branch before opening a PR
-- Squash fixup commits before merging
-- Write meaningful commit bodies when the subject line is insufficient
-- Reference issue numbers in commits that fix bugs: `fix(#123): description`
-- Never commit generated files, build artifacts, or dependency lockfiles unless intentional

package/.claude/worktrees/kanban-overhaul/config/rules/javascript.md

@@ -1,10 +0,0 @@
-# JavaScript / TypeScript Rules
-
-- Use `const` by default, `let` only when reassignment is needed
-- Prefer arrow functions for callbacks and closures
-- Use async/await over raw promises or callbacks
-- All functions must have explicit return types (TypeScript) or JSDoc (JavaScript)
-- Use optional chaining (`?.`) and nullish coalescing (`??`) over `&&` or `||` guards
-- No `any` types — use `unknown` and narrow with type guards
-- Use strict mode (`"use strict"`) in all modules
-- Prefer named exports over default exports

package/.claude/worktrees/kanban-overhaul/config/rules/python.md

@@ -1,10 +0,0 @@
-# Python Rules
-
-- Follow PEP 8 — use `ruff` for formatting and linting
-- Use type hints on all function signatures and public methods
-- Use `pathlib` over `os.path` for path manipulation
-- Prefer dataclasses over plain dicts for structured data
-- Use `async def` for I/O-bound functions, with proper `asyncio` patterns
-- Use context managers (`with` statements) for resource handling
-- No wildcard imports (`from module import *`)
-- Use `__all__` to define public API surface of modules

package/.claude/worktrees/kanban-overhaul/config/rules/testing.md

@@ -1,10 +0,0 @@
-# Testing Rules
-
-- Write tests before implementation (TDD) for all new features
-- Aim for 80%+ code coverage on all new code
-- Use Arrange-Act-Assert (AAA) pattern in all tests
-- One assertion per test — or use parameterized tests for multiple cases
-- Mock external services, not internal logic
-- Name tests descriptively: `test_{function}_{scenario}_{expected_behavior}`
-- Test edge cases, error paths, and boundary conditions, not just happy path
-- Integration tests should be clearly separated from unit tests

package/.claude/worktrees/kanban-overhaul/config/rules/thinking.md

@@ -1,56 +0,0 @@
-# Concise Thinking Rule
-
-## The Problem
-
-Models with `reasoning: true` + `variant: "high"` produce unbounded self-talk: "oh but what if this... actually let me reconsider... wait..." This is verbose, indecisive, and costly.
-
-## The Rule
-
-**Think in 2–4 sentences. One-shot. No loops.**
-
-### Structure
-
-Every reasoning output must follow this shape:
-
-```
-[Premise — what I know] → [Decision — what I'm doing] → [Next step]
-```
-
-No hedging. No "but what if". No mid-thought self-correction.
-
-### Hard Bans
-
-Never use these phrases in thinking output:
-- "oh but what if..."
-- "actually..."
-- "let me think..."
-- "wait..."
-- "hmm..."
-- "I wonder..."
-- "on second thought..."
-- "alternatively..."
-
-### One-Shot Pattern
-
-Think once. Decide. Act. Move on.
-
-**Forbidden patterns:**
-- "Option A... no wait Option B... actually let's try C..."
-- "I considered X, but then I realized Y, so maybe Z..."
-- "Let me reconsider..." followed by another reconsideration
-
-### What Thinking Should Look Like
-
-**BAD:**
-> "The file is missing a semicolon. Oh but what if it's actually a parsing issue? Let me think... Actually, looking more carefully, the real problem is the import statement is wrong. Wait, I should also check if the export is correct. Actually let me try fixing the import first..."
-
-**GOOD:**
-> "The import path is wrong — `../utils` should be `./utils`. Fixing the path resolves the missing export error. Next: re-run the build."
-
-### Length Cap
-
-Maximum **80 words** of thinking output before the first tool call or response. If you cannot decide in 80 words, state the decision you reached and proceed.
-
-### Enforcement
-
-This rule is injected into every model that supports `reasoning: true`. Non-compliance produces verbose, unhelpful output and is a correctness failure.

package/.claude/worktrees/kanban-overhaul/config/rules/uncertainty.md

@@ -1,70 +0,0 @@
-# Stop and Research Rule
-
-## The Problem
-
-LLM agents default to a "try again with a slight variation" loop when they are uncertain. They guess file paths, invent API names, mutate code they do not understand, and burn tokens retrying near-identical tool calls. The fix is always available: stop, use a research tool, learn something, then act.
-
-## The Rule
-
-**When uncertain or stuck, STOP. Research. Then act.**
-
-### The Three Phases
-
-Every stuck situation must move through these phases in order:
-
-1. **Attempt (max 2 tries).** Try your best guess once or twice. If both fail or you are not confident in the result, stop. Do not attempt a third variation.
-2. **Research (mandatory before retry #3).** Use the available tools to learn:
-   - `semble search "<concept>"` for codebase patterns
-   - `webfetch` for official documentation
-   - `read` for related files in the repo
-   - `obsidian_search` for prior project context
-   - `skill <name>` for domain-specific guidance
-   - Ask the user if you are still uncertain after research
-3. **Act with confidence.** After research, make one decisive attempt. If it still fails, return to phase 2 with the new information. Never return to phase 1.
-
-### Recognition Triggers
-
-You are stuck if any of these are true:
-
-- You are about to make the same tool call with slightly different arguments
-- You do not know which file contains the relevant code
-- The error message is unfamiliar
-- The user gave a goal but no clear path
-- You are guessing at API signatures, config keys, or command syntax
-- Multiple valid approaches exist and you do not know which is correct
-- Your previous two attempts produced the same outcome
-
-### Hard Bans
-
-Never do any of the following:
-
-- Try the same approach 3 or more times. Research after the second failure.
-- Guess at file paths without searching
-- Invent API names, method signatures, or config keys
-- Modify code you do not understand
-- Continue a plan after the user has corrected you
-- Pretend to be making progress when you are actually looping
-
-### Examples
-
-**BAD:** Agent needs to call the project's authentication helper.
-> "Let me try `auth.login()`. Nope, not exported. Maybe `auth.signIn()`? No. Try `authenticate()`? Hmm. Let me look for `Login`... `User.auth()`? Actually let me try `userLogin()`..."
-
-**GOOD:** Agent needs to call the project's authentication helper.
-> Searched the codebase: `semble search "authentication helper"` returned `src/auth/session.ts` exporting `createSession()`. Calling `createSession({ userId })` next.
-
-**BAD:** Agent is debugging a build failure.
-> "Error: ENOENT: no such file. Let me try creating `./config.json`. Failed. Try `./src/config.json`. Failed. Try `./app/config.json`. Failed. Let me try `process.cwd()`..."
-
-**GOOD:** Agent is debugging a build failure.
-> `semble search "config path"` and `read package.json` both show configs live in `config/`. The build script runs from the repo root, so the path is `config/<name>.json`. Fixing the import next.
-
-### Loop Guard Is The Last Resort
-
-The runtime loop guard in `cline.json` (`loopThresholdWarn: 5`, `loopThresholdEscalate: 8`, `loopThresholdBlock: 12`) is a safety net for when this rule fails. It is not the primary defense.
-
-If the loop guard fires, the rule failed first. Agents must self-correct before the guard kicks in. A trigger at 5 identical calls means the agent should have stopped at 2 and researched.
-
-## Enforcement
-
-Non-compliance looks like: 3+ similar tool calls in a row, repeated variations of the same failed command, "let me try X... nope... let me try Y..." narration, and increasing token spend with no progress. If you catch yourself doing this, stop, run a research tool, and act on the result.

package/.claude/worktrees/kanban-overhaul/config/skills/9router/SKILL.md

@@ -1,80 +0,0 @@
----
-name: 9router
-description: Entry point for 9Router — local/remote AI gateway with OpenAI-compatible REST for chat, image, TTS, STT, embeddings, web search, web fetch. Use when the user mentions 9Router, NINEROUTER_URL, or wants AI without writing provider boilerplate. This skill covers setup + indexes capability skills; fetch the relevant capability SKILL.md from the URLs below when needed.
----
-
-# 9Router
-
-Local/remote AI gateway exposing OpenAI-compatible REST. One key, many providers, auto-fallback.
-
-## Setup
-
-The Bizar harness expects 9Router at `http://localhost:20128` by default. Override with:
-
-```bash
-export NINEROUTER_URL="http://localhost:20128"      # or VPS / tunnel URL
-export NINEROUTER_KEY="sk-..."                      # from Dashboard → Keys (only if requireApiKey=true)
-```
-
-All requests: `${NINEROUTER_URL}/v1/...` with header `Authorization: Bearer ${NINEROUTER_KEY}` (omit if auth disabled).
-
-Verify: `curl $NINEROUTER_URL/api/health` → `{"ok":true}`
-
-## Discover models
-
-```bash
-curl $NINEROUTER_URL/v1/models                  # chat/LLM (default)
-curl $NINEROUTER_URL/v1/models/image            # image-gen
-curl $NINEROUTER_URL/v1/models/tts              # text-to-speech
-curl $NINEROUTER_URL/v1/models/embedding        # embeddings
-curl $NINEROUTER_URL/v1/models/web              # web search + fetch (entries have `kind` field)
-curl $NINEROUTER_URL/v1/models/stt              # speech-to-text
-curl $NINEROUTER_URL/v1/models/image-to-text    # vision
-```
-
-Use `data[].id` as `model` field in requests. Combos appear with `owned_by:"combo"`.
-
-Response shape:
-```json
-{ "object": "list", "data": [
-  { "id": "openai/gpt-5", "object": "model", "owned_by": "openai", "created": 1735000000 },
-  { "id": "tavily/search", "object": "model", "kind": "webSearch", "owned_by": "tavily", "created": 1735000000 }
-]}
-```
-
-## Capability skills
-
-When the user needs a specific capability, fetch that skill's `SKILL.md` from its raw URL:
-
-| Capability | Raw URL |
-|---|---|
-| Chat / code-gen | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-chat/SKILL.md |
-| Image generation | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-image/SKILL.md |
-| Text-to-speech | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-tts/SKILL.md |
-| Speech-to-text | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-stt/SKILL.md |
-| Embeddings | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-embeddings/SKILL.md |
-| Web search | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-search/SKILL.md |
-| Web fetch (URL → markdown) | https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-fetch/SKILL.md |
-
-## Bizar harness integration
-
-This skill is auto-installed by `bizar install` into `~/.cline/skills/9router/`. All
-Bizar agents that need chat or web capabilities should read these skill files
-before starting a task.
-
-**Quick-check command** (run from anywhere in a Bizar session):
-
-```bash
-curl -sS http://localhost:20128/api/health
-```
-
-If the response is not `{"ok":true}`, ask the user whether 9Router is running
-or whether `NINEROUTER_URL` should be re-pointed. Do NOT fall back to a
-non-routed provider silently — the whole point of 9Router is auto-fallback +
-single key rotation + observability.
-
-## Errors
-
-- 401 → set/refresh `NINEROUTER_KEY` (Dashboard → Keys)
-- 400 `Invalid model format` → check `model` exists in `/v1/models/<kind>`
-- 503 `All accounts unavailable` → wait `retry-after` or add another provider account