@polderlabs/bizar 6.0.2 → 6.2.0

package/cli/utils.mjs

@@ -16,15 +16,15 @@ export function repoPath(...parts) {
 
 /**
  * Resolve the Cline global config directory.
- *
- * Mirrors Cline's `resolveClineDir()` in `@cline/shared/storage`:
- *   1. `process.env.CLINE_DIR` (explicit override)
- *   2. `$HOME/.cline` (the Cline default since v3.0)
- *
- * The legacy `~/.config/cline/` path (used by OpenCode and pre-v5.6
- * BizarHarness versions) is kept under `legacyClineConfigDir()` below
- * for back-compat with older scripts.
- */
+*
+  * Mirrors Cline's `resolveClineDir()` in `@cline/shared/storage`:
+  *   1. `process.env.CLINE_DIR` (explicit override)
+  *   2. `$HOME/.cline` (the Cline default since v3.0)
+  *
+  * v6.1.0 — Bizar is Cline-only. The pre-v5.6 `~/.config/cline/` path
+  * (the OpenCode-era layout) is no longer supported; the previous
+  * `legacyClineConfigDir()` helper has been removed.
+  */
 export function clineConfigDir() {
   if (process.env.CLINE_DIR && process.env.CLINE_DIR.trim()) {
     return process.env.CLINE_DIR.trim();
@@ -37,22 +37,6 @@ export function clineConfigDir() {
   return join(homedir(), '.cline');
 }
 
-/**
- * Legacy Cline config dir (`~/.config/cline/`). Used by OpenCode and the
- * pre-v5.6 BizarHarness installer. Exposed for back-compat with scripts
- * and tests that hard-coded this path.
- */
-export function legacyClineConfigDir() {
-  if (isWin) {
-    return process.env.APPDATA
-      ? join(process.env.APPDATA, 'cline')
-      : join(homedir(), '.config', 'cline');
-  }
-  return process.env.XDG_CONFIG_HOME
-    ? join(process.env.XDG_CONFIG_HOME, 'cline')
-    : join(homedir(), '.config', 'cline');
-}
-
 export function clineAgentsDir() {
   return join(clineConfigDir(), 'agents');
 }

package/config/cline.json.template

@@ -317,6 +317,21 @@
       "description": "Bizar Plugin Menu.",
       "agent": "odin",
       "template": "commands-bizar/bizar.md\n\n$ARGUMENTS"
+    },
+    "team": {
+      "description": "Spawn a Cline agent team — coordinate Thor, Tyr, Mimir, Hermod, and Forseti to complete a complex mission end-to-end.",
+      "agent": "odin",
+      "template": "commands-bizar/team.md\n\n$ARGUMENTS"
+    },
+    "test": {
+      "description": "Run the project's test suite via the Bizar test gate (auto-detects jest/vitest/bun/pytest/cargo/go).",
+      "agent": "thor",
+      "template": "commands-bizar/test.md\n\n$ARGUMENTS"
+    },
+    "validate": {
+      "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": {

package/config/commands/team.md

@@ -0,0 +1,124 @@
+---
+description: Spawn a Cline agent team — coordinate Thor (M2.7), Tyr (M3), Mimir (research), and Hermod (git) to complete a complex mission end-to-end.
+agent: odin
+---
+# Team — Spawn a Cline Agent Team
+
+The `/team` command spawns a **coordinated agent team** for a complex,
+multi-step mission. The lead agent coordinates teammates; each teammate
+owns a disjoint scope; results are synthesized and committed.
+
+## When to Use `/team`
+
+Use `/team` for any non-trivial mission that benefits from **parallel
+work + explicit coordination**. Examples:
+
+- **Refactor** — split a module across Thor (M2.7) and Tyr (M3) in parallel.
+- **Multi-feature build** — new feature A (Thor) + new feature B (Tyr) + tests (Heimdall).
+- **Research + implementation** — Mimir researches, Thor implements, Forseti audits.
+- **Migration / upgrade** — Hermod handles the git/PR lifecycle while Thor/Tyr write code.
+- **Bug hunt** — Mimir traces the data flow while Tyr writes the fix and tests.
+
+Do NOT use `/team` for trivial single-file edits or single-question
+clarifications. Use `@heimdall` directly for those.
+
+## Default Team Composition
+
+If the user does not specify a team composition, spawn this default:
+
+| Role          | Agent   | Model             | Job                                   |
+|---------------|---------|-------------------|---------------------------------------|
+| Lead          | @odin   | minimax/MiniMax-M3   | Coordinate, synthesize, gate quality  |
+| Implementer 1 | @thor   | minimax/MiniMax-M2.7 | Moderate-complexity implementation   |
+| Implementer 2 | @tyr    | minimax/MiniMax-M3   | Complex / cross-cutting work         |
+| Researcher    | @mimir  | 9router/kr/auto  | Codebase research, pattern discovery  |
+| Git ops       | @hermod | minimax/MiniMax-M2.7 | Branch, commit, push, PR             |
+| Reviewer      | @forseti| minimax/MiniMax-M3   | Audit plan + final output            |
+
+You can swap or remove any of these — but always keep at least one
+implementer and a reviewer.
+
+## Protocol (How Odin Runs a `/team` Invocation)
+
+1. **Read `.bizar/PROJECT.md`** if it exists. Factor the project
+   description into the team mission.
+2. **Read `bizar memory status`**. If the vault is reachable, run
+   `bizar memory search "<topic>"` for prior context on the mission.
+3. **Decompose** the mission into disjoint work items. Each item
+   names:
+   - The agent that owns it
+   - The file scope (paths/globs)
+   - The deliverable (a function, a test, a commit, a doc)
+   - The exit signal ("done when X is committed")
+4. **Launch in parallel** — use `bizar_spawn_team` with the mission
+   string. Or, if you prefer synchronous control, launch 2+ `task`
+   calls in a **single message** to drive Thor and Tyr directly.
+5. **Monitor** — while the team runs, return control to the user.
+   The team runs asynchronously. Use `bizar_status` to check progress
+   only when the user asks.
+6. **Synthesize** — when teammates report back, gate through @forseti
+   (audit) and @hermod (commit/push). Then report the final outcome
+   to the user with file:line references.
+
+## Pre-Dispatch Checklist (MANDATORY)
+
+- [ ] Each teammate has a **disjoint file scope** — no two agents
+       edit the same file or directory
+- [ ] Lockfiles, `package.json`, root configs, `tsconfig.json`,
+       `vite.config.*`, `Dockerfile`, CI configs are assigned to ONE
+       agent or marked READ-ONLY for everyone else
+- [ ] No subagent has both `bash: allow` AND a write-level git task
+       in the same batch — Hermod is the only git writer
+- [ ] Each teammate's scope is named in plain English
+- [ ] You have prepended the **Sibling-Awareness Block** to every
+       prompt — see Odin baseline, "Parallel Dispatch Coordination"
+- [ ] You have called `bizar memory status` and confirmed the vault
+       is reachable
+
+## Example Mission Strings
+
+**Refactor a module:**
+```
+Refactor src/api/auth.ts into a clean module: extract JWT validation
+into src/auth/jwt.ts, rate-limiting into src/auth/rate-limit.ts, and
+keep the public surface stable. Add tests for each new module. Update
+docs/architecture.md with the new module map. Do not change the HTTP
+route handlers.
+```
+
+**Multi-feature build:**
+```
+Add a kanban board: (1) Thor — backend API at /api/tasks with CRUD
+endpoints and SQLite persistence. (2) Tyr — frontend React component
+in src/components/Kanban.tsx with 5 columns. (3) Heimdall — write
+the OpenAPI spec at docs/api/tasks.yaml. (4) Hermod — open a PR
+named feat/kanban-board.
+```
+
+**Bug hunt:**
+```
+Mimir — trace the data flow from POST /api/checkout through to the
+Stripe webhook handler; find any place where the order status is
+written before the payment is confirmed. Tyr — write a regression
+test that reproduces the race. Thor — fix the bug. Forseti —
+audit the fix for completeness. Hermod — commit + push.
+```
+
+## Tool Reference
+
+- `bizar_spawn_team` — spawn a full team in one call (lead + mission)
+- `bizar_spawn_background` — spawn a single background agent
+- `bizar_status` — list all running background instances
+- `bizar_collect` — block until an instance completes (use sparingly)
+- `bizar_kill` — terminate an instance
+
+## Failure Modes
+
+- **Two agents write the same file** — STOP, revert one branch, reassign.
+- **One agent stalls** — call `bizar_kill`, route the remaining scope
+  to another agent.
+- **Tests fail after team work** — dispatch @thor to investigate; do
+  not paper over the failure.
+- **Git conflict** — route to @hermod for `git rebase` / merge resolution.
+- **A teammate goes silent** — call `bizar_status` for a status report;
+  if dead, kill and re-spawn with a fresh prompt.

package/config/commands/test.md

@@ -0,0 +1,60 @@
+---
+description: Run the project's test suite via the Bizar test gate. Auto-detects jest/vitest/bun/pytest/cargo/go. Exits non-zero on failure.
+agent: thor
+---
+# /test — Run the Project's Test Suite
+
+The `/test` command is a thin wrapper around `bizar test-gate`. It
+auto-detects the project's test runner and runs the full suite.
+
+## What It Does
+
+1. Detects the project stack (one of: npm, pytest, cargo, go).
+2. Runs the matching test command:
+   - `package.json` present → `npm test`
+   - `pyproject.toml` present → `pytest`
+   - `Cargo.toml` present → `cargo test`
+   - `go.mod` present → `go test ./...`
+3. Streams the test output to the user.
+4. Exits non-zero on test failures.
+
+## Exit Codes
+
+| Code | Meaning                          |
+|------|----------------------------------|
+| 0    | All tests passed                 |
+| 1    | Tests failed                     |
+| 2    | No test runner detected          |
+
+## How to Use
+
+Invoke `/test` (no arguments) from the project root. The test gate
+inspects the current directory and picks the right runner.
+
+To run a specific Bizar test scope instead, you can pass arguments
+to `/test`. The arguments are forwarded to the underlying runner:
+
+- `/test plugins/bizar` — run only the Bizar plugin tests (bun)
+- `/test --testPathPattern=auth` — pass a flag to the runner
+
+## When to Use
+
+- After any non-trivial code change
+- Before committing (`@hermod` should always run `/test` first)
+- As the final step of a `/team` mission — gate quality with tests
+
+## Common Patterns
+
+- **Post-implementation gate** — after Thor and Tyr finish their
+  parallel work, dispatch `@thor` to run `/test`. If failures, fix
+  and re-run.
+- **PR check** — run `/test` in CI before merging.
+- **Debug a flaky test** — run `/test` twice; if the second run
+  passes, the test is order-dependent (fix or quarantine).
+
+## Related
+
+- `bizar test-gate` — the underlying CLI command
+- `bizar doctor` — checks the Bizar install itself (not project tests)
+- `make check` — typecheck + tests (full pipeline, dev only)
+- `make e2e` — Bizar plugin end-to-end (dev only)

package/config/commands/validate.md

@@ -0,0 +1,66 @@
+---
+description: Validate the Bizar install end-to-end — cline.json parses, plugin entry resolves, all 14 agent files are installed, all skills/rules/hooks/commands are in place, provider config is sane, and the 9router gateway is reachable.
+agent: heimdall
+---
+# /validate — Validate the Bizar Install
+
+The `/validate` command runs `bizar doctor` with the full check
+battery. It is the fastest way to confirm the install is healthy
+and Cline will see every Bizar component on the next session start.
+
+## What It Checks
+
+1. **cline-reachable** — `cline --version` exits 0.
+2. **cline-config-valid** — `~/.cline/cline.json` parses as JSON.
+3. **plugin-entry-present** — `cline.json` has a Bizar plugin entry.
+4. **plugin-path-resolves** — the plugin path on disk actually exists.
+5. **agent-files-installed** — all 14 agent files in `~/.cline/agents/`
+   (odin, vor, frigg, quick, mimir, heimdall, hermod, thor, baldr,
+   tyr, vidarr, forseti, semble-search, agent-browser).
+6. **tools-available** — at least one of `headroom`, `semble`, `skills`
+   is on PATH.
+7. **provider-config-sanity** — `provider.9router` (preferred) or
+   `provider.minimax` (legacy) has at least one sane model entry.
+8. **9router-reachable** — 9Router gateway responds at
+   `http://localhost:20128/api/health` (lenient — warn, don't fail).
+9. **slash-commands-installed** — all Bizar slash commands
+   (`/audit`, `/explain`, `/init`, `/learn`, `/plan`, `/plow-through`,
+   `/pr-review`, `/tailscale-serve`, `/visual-plan`, `/bizar`,
+   `/team`, `/test`, `/validate`) are present in `~/.cline/commands/`.
+10. **skills-installed** — every subdir of `config/skills/` is
+    mirrored to `~/.cline/skills/`.
+11. **rules-installed** — every `.md` in `config/rules/` is mirrored
+    to `~/.cline/rules/`.
+12. **hooks-installed** — `config/hooks/` is mirrored to
+    `~/.cline/hooks/`.
+
+## How to Use
+
+Invoke `/validate` (no arguments) from anywhere. It is read-only and
+never modifies the system.
+
+If any check fails, the user should run `bizar update` to refresh the
+install, or `bizar repair` to fix common issues.
+
+## Output
+
+Each check prints ✓ or ✗ with a one-line message. The summary line
+shows the total pass/fail count. Exits non-zero if any check fails.
+
+For machine-readable output, the user can run `bizar doctor --json`
+directly.
+
+## When to Use
+
+- After a manual config edit — confirm nothing broke.
+- Before a `/team` mission — confirm the install is healthy so the
+  team has all the tools it needs.
+- After `bizar install` or `bizar update` — the install already
+  calls doctor, but a manual re-run is cheap.
+- When a user asks "why is cline misbehaving?" — start here.
+
+## Related
+
+- `bizar doctor` — the underlying CLI command
+- `bizar update` — refreshes the install (re-runs syncConfigExtras)
+- `bizar repair` — fixes common issues (stale symlinks, version drift)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "6.0.2",
-  "description": "Norse-pantheon multi-agent system for cline \u2014 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness. v4 ships as a single npm package bundling the dashboard server, cline plugin, and typed SDK.",
+  "version": "6.2.0",
+  "description": "Norse-pantheon multi-agent system for cline — 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness. v4 ships as a single npm package bundling the dashboard server, cline plugin, and typed SDK.",
   "type": "module",
   "bin": {
     "bizar": "cli/bin.mjs"
@@ -13,6 +13,7 @@
     "packages/sdk/",
     "config/",
     "templates/",
+    "scripts/",
     "install.sh",
     "cli/browser-harness-up.sh"
   ],
@@ -23,7 +24,7 @@
     "test:sdk": "node_modules/.bin/vitest run --root packages/sdk",
     "test:web": "cd bizar-dash && npx vitest run",
     "test:sdk:watch": "node_modules/.bin/vitest --root packages/sdk",
-    "test": "npm run typecheck && npm run test:sdk && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/cline-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/cline-sessions-detail.test.mjs bizar-dash/tests/cline-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs bizar-dash/tests/memory-lightrag.test.mjs bizar-dash/tests/memory-config.test.mjs bizar-dash/tests/memory-cli.test.mjs bizar-dash/tests/memory-cli-readlistdelete.test.mjs bizar-dash/tests/memory-cli-setup.test.mjs bizar-dash/tests/memory-conflicts.test.mjs bizar-dash/tests/memory-namespace.test.mjs bizar-dash/tests/memory-path-safety.test.mjs bizar-dash/tests/memory-protocol-drift.test.mjs bizar-dash/tests/memory-roundtrip.test.mjs bizar-dash/tests/cli-bugfixes.test.mjs bizar-dash/tests/server-bugfixes.test.mjs bizar-dash/tests/frontend-bugfixes.test.mjs",
+    "test": "npm run typecheck && npm run test:sdk && node --test cli/install.test.mjs cli/provision.test.mjs cli/commands/validate.test.mjs && bun test plugins/bizar/tests/loop.test.ts plugins/bizar/tests/block.test.ts plugins/bizar/tests/stall-think.test.ts plugins/bizar/tests/tools/bg-get-comments.test.ts plugins/bizar/tests/tools/bg-spawn-delegation.test.ts plugins/bizar/tests/tools/cline-runner.test.ts plugins/bizar/tests/settings.test.ts plugins/bizar/tests/commands.test.ts plugins/bizar/tests/commands-impl.test.ts plugins/bizar/tests/tools/plan-action.test.ts plugins/bizar/tests/tools/wait-for-feedback.test.ts plugins/bizar/tests/tools/read-glyph-feedback.test.ts plugins/bizar/tests/reasoning-clean.test.ts plugins/bizar/tests/key-rotation.test.ts && node bizar-dash/tests/smoke-v2.mjs && node --test bizar-dash/tests/path-safe.test.mjs bizar-dash/tests/tmux-wrap.test.mjs bizar-dash/tests/cline-sessions-detail.test.mjs bizar-dash/tests/cline-runner.test.mjs bizar-dash/tests/mod-instructions.node.test.mjs bizar-dash/tests/mod-upgrade.node.test.mjs bizar-dash/tests/graphify-mod-spawn.node.test.mjs bizar-dash/tests/no-agent-browser.node.test.mjs bizar-dash/tests/providers-store-backup-keys.node.test.mjs bizar-dash/tests/dashboard-ports.test.mjs bizar-dash/tests/submit-feedback.test.mjs bizar-dash/tests/yaml.test.mjs bizar-dash/tests/memory-store.test.mjs bizar-dash/tests/memory-schema.test.mjs bizar-dash/tests/memory-secrets.test.mjs bizar-dash/tests/memory-git.test.mjs bizar-dash/tests/memory-sync.test.mjs bizar-dash/tests/obsidian-back-compat.test.mjs bizar-dash/tests/memory-lightrag.test.mjs bizar-dash/tests/memory-config.test.mjs bizar-dash/tests/memory-cli.test.mjs bizar-dash/tests/memory-cli-readlistdelete.test.mjs bizar-dash/tests/memory-cli-setup.test.mjs bizar-dash/tests/memory-conflicts.test.mjs bizar-dash/tests/memory-namespace.test.mjs bizar-dash/tests/memory-path-safety.test.mjs bizar-dash/tests/memory-protocol-drift.test.mjs bizar-dash/tests/memory-roundtrip.test.mjs bizar-dash/tests/cli-bugfixes.test.mjs bizar-dash/tests/server-bugfixes.test.mjs bizar-dash/tests/frontend-bugfixes.test.mjs",
     "build": "npm run build:sdk && npm run build:dash",
     "prepublishOnly": "npm run build"
   },
@@ -109,4 +110,4 @@
   "optionalDependencies": {
     "@cline/sdk": "^0.0.58"
   }
-}
+}

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar-sdk",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/plugins/bizar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar-plugin",
-  "version": "6.0.2",
+  "version": "6.2.0",
   "description": "Bizar Norse-pantheon multi-agent plugin for Cline — 14 agents across 4 cost tiers with cost-aware routing and plans.",
   "type": "module",
   "main": "./index.ts",

package/plugins/bizar/src/clineruntime.ts

@@ -161,7 +161,7 @@ export class ClineRuntime {
       cwd: opts.workspaceRoot,
       enableTools: true,
       enableSpawnAgent: false,
-      enableAgentTeams: false,
+      enableAgentTeams: true,
       ...(execution ? { execution } : {}),
       ...(recovery ? { onConsecutiveMistakeLimitReached: recovery } : {}),
     };

package/plugins/bizar/tests/clineruntime-config.test.ts

@@ -166,6 +166,50 @@ describe("ClineRuntime.startSession — execution plumbing", () => {
   });
 });
 
+describe("ClineRuntime.startSession — agent teams plumbing (v6.2.0)", () => {
+  test("enableAgentTeams is true on every session (team-spawn requires it)", async () => {
+    const runtime = new ClineRuntime({ logger: stubLogger() });
+    (runtime as unknown as { core: unknown }).core = makeFakeCore();
+    await runtime.startSession({
+      providerId: "anthropic",
+      modelId: "claude-sonnet-4-6",
+      workspaceRoot: "/tmp",
+      prompt: "go",
+    });
+    const cfg = capturedConfig[0]!.config;
+    expect(cfg.enableAgentTeams).toBe(true);
+  });
+
+  test("enableTools is true, enableSpawnAgent is false", async () => {
+    const runtime = new ClineRuntime({ logger: stubLogger() });
+    (runtime as unknown as { core: unknown }).core = makeFakeCore();
+    await runtime.startSession({
+      providerId: "anthropic",
+      modelId: "claude-sonnet-4-6",
+      workspaceRoot: "/tmp",
+      prompt: "go",
+    });
+    const cfg = capturedConfig[0]!.config;
+    expect(cfg.enableTools).toBe(true);
+    expect(cfg.enableSpawnAgent).toBe(false);
+  });
+
+  test("all three boolean flags survive even when caller passes no opts", async () => {
+    const runtime = new ClineRuntime({ logger: stubLogger() });
+    (runtime as unknown as { core: unknown }).core = makeFakeCore();
+    await runtime.startSession({
+      providerId: "anthropic",
+      modelId: "claude-sonnet-4-6",
+      workspaceRoot: "/tmp",
+      prompt: "go",
+    });
+    const cfg = capturedConfig[0]!.config;
+    expect(cfg.enableAgentTeams).toBe(true);
+    expect(cfg.enableTools).toBe(true);
+    expect(cfg.enableSpawnAgent).toBe(false);
+  });
+});
+
 function stubLogger(): { info: (m: string) => void; warn: (m: string) => void; error: (m: string) => void; debug: (m: string) => void; log: (o: { level: string; message: string }) => void } {
   return {
     info: () => {},