Changelog

Changelog

All notable changes to BizarHarness are documented here. The format is based on Keep a Changelog, and the project adheres to Semantic Versioning.

For npm releases, see https://www.npmjs.com/package/bizarharness. For GitHub releases, see https://github.com/DrB0rk/BizarHarness/releases.

Unreleased

• Background agents v0.4.2 (Forseti audit fixes) — see Background Agents.
• Dev sandbox moved into its own BizarHarness-dev project.
• Per-project Hindsight bank migration (40+ docs moved from default to project banks).
• Windows path-separator fixes in the CLI (path.dirname instead of lastIndexOf).

2.0.0 (current) — 2026-06-17

The "Bizar plugin" release. Adds the bundled opencode plugin, the visual plan tool, the Quick agent, and the self-improvement protocol. Backwards-compatible with 1.x agent definitions and routing.

Added

• Bizar opencode plugin (v0.3.1). Loop detection at thresholds 5/8/12, periodic status reporting, handoff signal. The plugin is bundled with the installer and enabled by default. See Bizar Plugin.
• Background agents (v0.4.2, experimental). Asynchronous subagent execution via a single opencode serve instance. Four custom tools: bizar_spawn_background, bizar_status, bizar_collect, bizar_kill. See Background Agents.
• bizarharness plan command. Visual plan tool with a browser-based viewer/editor. Subcommands: new, open, list, delete, export. See Plans Command.
• Quick agent. Free single-shot fast-path agent. Skips decomposition and delegation. Useful for one-line changes.
• Forseti auditor. Adversarial plan review for Tier 4 and Tier 5 work. Runs in M3 with edit: deny.
• Self-improvement log. Every task appends a lesson to .bizar/AGENTS_SELF_IMPROVEMENT.md. Read at session start.
• Per-project Hindsight banks. Every project gets its own bank; the default bank is reserved for general/system knowledge only.
• Skill discovery protocol. Agents proactively install Skills CLI packs by domain (e.g., skills add supabase/agent-skills --all -y for database work).
• bizarharness audit subcommand. Security audit of agent configuration.
• bizarharness test-gate subcommand. Detect and run the project's test suite.
• bizarharness export subcommand. Export agents/rules to another harness (Claude Code, Cursor, opencode).

Changed

• Odin tool surface stripped. No bash, glob, grep, edit, write, question. Odin can only dispatch.
• Vör research-first protocol. Vör reads .bizar/PROJECT.md and the project's Hindsight bank before asking any questions.
• AGENTS.md restructured. New sections: Skill Discovery Protocol, Always-On Rules, Hindsight Memory Protocol, Model Routing & Agents.
• All subagents get byte-identical ## Loop Guard Handling section. Verified by SHA256.

Fixed

• Vör no longer asks generic questions before reading project context.
• Windows path-separator handling in cli/copy.mjs and cli/utils.mjs (replaced lastIndexOf('/') with path.dirname()).
• The __ABS__ global sentinel in the plugin's path normalization was replaced with path.relative(worktree, ...) for in-worktree paths and a per-path stable hash for out-of-worktree paths. (Resolves a fingerprint-collision attack vector.)
• Plugin tool.execute.before no longer claims to carry the agent name (it doesn't). State is per-session only.

1.2.x — 2026-06

The "polish" release series. Adds hooks, commands, rules, and Windows compatibility.

1.2.1 — 2026-06-15

• Windows path-separator fixes (cli/copy.mjs, cli/utils.mjs).
• Added tryReadVersion() helper for cross-platform npm version detection.
• .gitignore now excludes node_modules/ and package-lock.json for contributors.

1.2.0 — 2026-06-12

• Hooks system. Opencode hooks for session lifecycle events.
• Slash commands. Bundled commands for common operations.
• Always-on rules. rules/general.md, rules/javascript.md, rules/python.md, rules/git.md, rules/testing.md.
• Skill packs via installer. Curated skills from skills.sh integrated into the install flow.
• Forseti agent added. Adversarial plan review.
• Baldr agent added. Design system plans.

1.1.x — 2026-05

The "expansion" release series. Adds Frigg, Vör, and the research-first protocol.

1.1.0 — 2026-05-28

• Frigg agent. Read-only Q&A using DeepSeek V4 Flash (free). Never modifies files.
• Vör agent with research-first protocol. Reads .bizar/PROJECT.md and Hindsight bank before asking.
• Mimir agent with Semble-first search. Uses Semble MCP for codebase exploration.
• Hindsight memory MCP integration. Per-project banks with bank_id parameter.
• RTK integration. Token optimization for shell commands.
• Semble integration. AI-powered code search.

1.0.x — 2026-04

The initial release.

1.0.0 — 2026-04-22

• Odin (M3 router).
• Thor (M2.7, moderate implementation).
• Tyr (M3, complex implementation).
• Heimdall (free, file ops and mechanical work).
• Hermod (M2.7, git ops).
• Vidarr (GPT-5.5, last resort).
• bizarharness interactive installer.
• Source install script (install.sh).
• opencode.json template with deep-merge via jq.
• Master AGENTS.md with the routing table and skill discovery protocol.

---

For older changes and detailed commit history, see the GitHub repository:

• BizarHarness releases
• BizarHarness commits