@polderlabs/bizar 6.2.0 → 6.2.2

package/config/cline.json.template

@@ -1,8 +1,8 @@
 {
   "$schema": "https://docs.cline.bot/config.json",
   "instructions": [".cline/instructions/bizar-tools.md"],
-  "model": "9router/minimax/MiniMax-M3",
-  "small_model": "9router/minimax/MiniMax-M2.7",
+  "model": "minimaxcustom/MiniMax-M3",
+  "small_model": "minimaxcustom/MiniMax-M2.7",
   "default_agent": "odin",
   "permission": "allow",
   "snapshot": false,
@@ -35,7 +35,7 @@
         "threshold": 0.5,
         "preserve_recent": 10,
         "strategy": "summarize",
-        "model": "9router/minimax/MiniMax-M3"
+        "model": "minimaxcustom/MiniMax-M3"
       }
     }]
   ],
@@ -52,7 +52,7 @@
     "odin": {
       "description": "Odin — Pure router that delegates all work to subagents.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#6366f1",
       "permission": {
         "task": "allow",
@@ -66,7 +66,7 @@
     "vor": {
       "description": "Vör — The Questioning One.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#8b5cf6",
       "permission": {
         "read": "allow",
@@ -77,7 +77,7 @@
     "frigg": {
       "description": "Frigg — All-knowing Q&A agent.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -93,7 +93,7 @@
     "quick": {
       "description": "Quick — Fast single-shot tasks.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#22d3ee",
       "permission": {
         "read": "allow",
@@ -112,7 +112,7 @@
     "mimir": {
       "description": "Mimir — Research and codebase exploration agent.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#0ea5e9",
       "permission": {
         "read": "allow",
@@ -130,7 +130,7 @@
     "heimdall": {
       "description": "Heimdall — Simple, routine, deterministic tasks.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#10b981",
       "permission": {
         "read": "allow",
@@ -147,7 +147,7 @@
     "hermod": {
       "description": "Hermod — Git and GitHub operations specialist.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#06b6d4",
       "permission": {
         "read": "allow",
@@ -163,7 +163,7 @@
     "thor": {
       "description": "Thor — Medium-complexity tasks, strong and reliable.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#a855f7",
       "permission": {
         "read": "allow",
@@ -180,7 +180,7 @@
     "baldr": {
       "description": "Baldr — UI/UX design system specialist.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#ec4899",
       "permission": {
         "read": "allow",
@@ -197,7 +197,7 @@
     "tyr": {
       "description": "Tyr — Complex implementation, debugging, architecture.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#f59e0b",
       "permission": {
         "read": "allow",
@@ -214,7 +214,7 @@
     "vidarr": {
       "description": "Vidarr — Ultimate fallback via MiniMax M3.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#dc2626",
       "permission": {
         "read": "allow",
@@ -231,7 +231,7 @@
     "forseti": {
       "description": "Forseti — Audits and corrects plans before execution.",
       "mode": "subagent",
-      "model": "9router/minimax/MiniMax-M3",
+      "model": "minimaxcustom/MiniMax-M3",
       "color": "#ef4444",
       "permission": {
         "read": "allow",
@@ -249,7 +249,7 @@
     "browser-harness": {
       "description": "browser-harness — Primary agent for browser-driven E2E verification. No-edit permissions. Drives Chrome via CDP for end-to-end testing of web apps.",
       "mode": "primary",
-      "model": "9router/minimax/MiniMax-M2.7",
+      "model": "minimaxcustom/MiniMax-M2.7",
       "color": "#84cc16",
       "permission": {
         "read": "allow",
@@ -332,84 +332,11 @@
       "description": "Validate the Bizar install: cline.json, plugin entry, agents, skills, hooks, rules, commands, and provider config.",
       "agent": "heimdall",
       "template": "commands-bizar/validate.md\n\n$ARGUMENTS"
-    }
-  },
-  "provider": {
-    "9router": {
-      "baseUrl": "http://localhost:20128/v1",
-      "apiKey": "${env:NINEROUTER_KEY}",
-      "models": {
-        "minimax/MiniMax-M3": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "minimax/MiniMax-M2.7": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "minimax/MiniMax-M2.5": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "minimax/MiniMax-M2.1": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "kr/auto": {
-          "reasoning": false
-        },
-        "kr/auto-thinking": {
-          "reasoning": true
-        },
-        "kr/claude-sonnet-4.5": {
-          "reasoning": false
-        },
-        "kr/claude-haiku-4.5": {
-          "reasoning": false
-        },
-        "kr/deepseek-3.2": {
-          "reasoning": false
-        },
-        "openrouter/cohere/north-mini-code:free": {
-          "reasoning": false
-        },
-        "openrouter/poolside/laguna-m.1:free": {
-          "reasoning": false
-        },
-        "openrouter/nvidia/nemotron-3-super-120b-a12b:free": {
-          "reasoning": true
-        }
-      }
     },
-    "minimax": {
-      "models": {
-        "MiniMax-M3": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        },
-        "MiniMax-M2.7": {
-          "interleaved": { "field": "reasoning_details" },
-          "reasoning": true,
-          "options": {
-            "thinking": { "type": "enabled" }
-          }
-        }
-      }
+    "setup-provider": {
+      "description": "Configure a provider in cline.json. Since v6.2.2 the installer no longer touches provider config — use this to add your own.",
+      "agent": "heimdall",
+      "template": "commands-bizar/setup-provider.md\n\n$ARGUMENTS"
     }
   }
 }

package/config/commands/setup-provider.md

@@ -0,0 +1,95 @@
+---
+description: Configure a provider in cline.json (apiKey, baseUrl, model catalog). The installer no longer touches provider config — use this command to set one up.
+agent: heimdall
+---
+# /setup-provider — Configure a provider in cline.json
+
+The Bizar installer no longer configures a provider for you (since
+v6.2.2 — the user owns provider config). Use this command to add
+or update a provider in `~/.cline/cline.json`.
+
+## What It Does
+
+Interactively (or non-interactively with flags), the setup-provider
+command writes a `provider` block to `~/.cline/cline.json` with:
+
+- `baseUrl` — the API endpoint (e.g. `http://localhost:20128/v1` for
+  the local 9Router gateway)
+- `apiKey` — the provider's API key (read from `env:` reference or
+  direct value)
+- `models` — the model catalog (the IDs returned by
+  `GET /v1/models`)
+
+## Default: 9Router Gateway
+
+If the user invokes `/setup-provider` with no arguments, default to
+the local 9Router gateway at `http://localhost:20128/v1`. The
+catalog comes from `GET http://localhost:20128/v1/models`. As of
+v6.2.2, that catalog includes:
+
+- `minimax/MiniMax-M3` (reasoning)
+- `minimax/MiniMax-M2.7` (reasoning)
+- `nvidia/minimaxai/minimax-m3` (reasoning)
+- `nvidia/minimaxai/minimax-m2.7` (reasoning)
+- `nvidia/z-ai/glm-5.2`
+- `nvidia/deepseek-ai/deepseek-v4-pro`
+- `nvidia/deepseek-ai/deepseek-v4-flash`
+- `nvidia/moonshotai/kimi-k2.6`
+- `nvidia/nemotron-3-ultra-550b-a55b`
+- `openrouter/cohere/north-mini-code:free`
+- `openrouter/poolside/laguna-m.1:free`
+- `openrouter/nvidia/nemotron-3-super-120b-a12b:free`
+- (and several more `minimax/MiniMax-M2.x` variants)
+
+## Flags
+
+- `--gateway <url>` — override the 9Router URL (default
+  `http://localhost:20128/v1`)
+- `--key <key>` — provider API key (writes `${env:KEY_NAME}` if it
+  looks like an env var name, otherwise writes the literal)
+- `--provider <name>` — provider name in cline.json (default `9router`)
+- `--model <id>` — add a single model instead of fetching the catalog
+- `--list` — print the model catalog from `/v1/models` and exit
+- `--remove <name>` — remove a provider by name
+
+## Examples
+
+```
+# Use the default 9Router gateway with the live model catalog
+/setup-provider
+
+# Custom provider
+/setup-provider --provider my-anthropic --gateway https://api.anthropic.com/v1 --key sk-ant-...
+
+# Just list the available models
+/setup-provider --list
+```
+
+## Implementation
+
+1. If `--list`, GET `${gateway}/v1/models` and pretty-print the IDs.
+2. If `--remove`, edit `~/.cline/cline.json` and remove the
+   `provider.<name>` block.
+3. Otherwise, read `~/.cline/cline.json`. If the file doesn't
+   exist, error — the user should run `bizar install` first.
+4. Build the new `provider.<name>` block from the flags + fetched
+   catalog.
+5. Write the file back atomically (write to `cline.json.tmp`,
+   then `rename`).
+6. Run `bizar validate` to confirm everything is wired up.
+
+## Security
+
+Never echo or log the full API key. If the user supplies a key on
+the command line, write it as a literal value (or `${env:KEY}`
+reference if it matches a `KEY_NAME` pattern). Never commit
+`~/.cline/cline.json` to source control — it may contain real
+secrets.
+
+## Related
+
+- `bizar connect` — interactive TUI for provider setup (alternative)
+- `bizar install` — installs the Bizar scaffolding (NOT provider config
+  since v6.2.2)
+- `bizar validate` — confirms provider config is wired correctly
+- Cline provider config: https://docs.cline.bot/customization/providers

package/config/hooks/PostToolUse

@@ -0,0 +1,66 @@
+#!/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/config/hooks/PreToolUse

@@ -0,0 +1,82 @@
+#!/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/config/hooks/README.md

@@ -1,29 +1,68 @@
-# Hook System
+# Bizar Harness — Cline Hooks
 
-BizarHarness uses **behavioral hooks** — agent-level instructions that simulate hook behavior. Since cline doesn't have a native hook runtime, all hooks are implemented as agent behavioral patterns.
+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.
 
-## Available Hooks
+## Format
 
-| Hook | Type | Trigger | Behavior |
-|------|------|---------|----------|
-| `pre-tool-use` | Behavioral | Before any edit/write | Check for secrets, verify permissions |
-| `post-tool-use` | Behavioral | After any edit/write | Auto-lint, auto-format, auto-test |
-| `session-start` | Behavioral | On session start | Read .bizar/, Hindsight recall, stack detection |
-| `session-end` | Behavioral | On task completion | Append to AGENTS_SELF_IMPROVEMENT.md |
-| `pre-commit` | Behavioral | Before git commit | Check for console.log, .env leaks, lint |
-| `post-implement` | Behavioral | After parallel implementation | Run test gate, verify both agents' outputs |
+Cline hooks are executable scripts (no extension) with a shebang line:
 
-## How It Works
+```bash
+#!/usr/bin/env node
+```
 
-Each hook is enforced by agent instructions in the agent `.md` files:
+They live in two locations:
+- **Global**: `~/Documents/Cline/Hooks/` (applies to all workspaces)
+- **Workspace**: `.clinerules/hooks/` (applies to one project)
 
-- **Pre-tool-use**: All implementation agents check for exposed secrets before any `write` or `edit` call
-- **Post-tool-use**: After file modifications, agents auto-run the linter and formatter
-- **Session-start**: Odin reads `.bizar/PROJECT.md` and Hindsight; Heimdall runs `bizar init` if missing
-- **Session-end**: Odin dispatches Heimdall to auto-extract self-improvement entries
-- **Pre-commit**: Hermod checks for console.log and .env before allowing git commits
-- **Post-implement**: After Thor+Tyr complete, Odin routes to Thor for test gate
+The `bizar install` / `bizar update` commands install these scripts to
+**both** locations with `chmod +x` so Cline picks them up.
 
-## Customization
+## What each hook does
 
-To disable a hook, remove its instruction from the relevant agent `.md` file(s) in `~/.config/cline/agents/`.
+| 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/config/hooks/TaskResume

@@ -0,0 +1,48 @@
+#!/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/config/hooks/TaskStart

@@ -0,0 +1,47 @@
+#!/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');
+});