brainfile v0.20.0

Changelog

Every release of brainfile, newest first. Versions follow Semantic Versioning and match the git tags.

The canonical file is CHANGELOG.md in the repository; this page is rendered from it.

0.20.0 — 2026-08-13

Added

  • brainfile brief --agent <name> — per-agent session orientation: full briefing on first run, delta since your last brief after (notes, moves, completions, contract changes). Also an MCP tool (count is now 11).
  • MCP: all tools declare outputSchema and return structuredContent (spec 2026-07-28); legacy-era clients receive identical JSON as text.
  • TUI: L toggles the completed-history view, orthogonal to the t type cycle (they compose); $EDITOR handoff for editing documents; NO_COLOR support; launch resumes your last column and type filter; h/l column keys.

Changed

  • Completing a task now always writes BOTH logs/ledger.jsonl and the archived markdown, with rollback on failure; legacyMode is a no-op.
  • TUI panel system (1/2/3) collapsed into the single list; completed work is the L view; rules panel removed with the rules system.
  • Releases are tag-driven: pushing vX.Y.Z publishes and creates the GitHub Release.

Fixed

  • CLI errors print a clean message + usage instead of a stack trace.
  • migrate --logs-to-ledger is a non-destructive, idempotent backfill — it previously DELETED the markdown archives it migrated.
  • log --recent includes ledger-only records; archive --to local completes the task instead of dead-ending; failed overlays no longer report documents removed; MCP contract validate returns ok: false on failed checks instead of a tool error; help opened from a detail view returns to that detail.

Removed

  • The rules system (adr-2): schema block, core rule operations, and the rules command. Legacy boards parse fine; lint --fix folds rules into agent.instructions. [ ] column keybinds (use h/l or tab).

0.19.0 — 2026-08-12

Added

  • TUI v3: complete redesign on ink 7 + react 19 via esbuild bundle — dense one-row-per-document board, type glyphs, signal-only color, split detail.
  • First-class plans: brainfile plan add/list/show/link, plan-N documents.
  • MCP: spec 2026-07-28 (stateless era) via @modelcontextprotocol/server v2; one stdio server serves both protocol eras.

Changed

  • Core owns all V2 board mutations; CLI, MCP, and TUI are thin frontends with parity locked by tests.

Removed

  • V1 board-format support (adr-1); brainfile migrate remains the converter.

Security

  • Cleared GHSA-345p-7cg4-v4c7 et al. by leaving the pinned v1 MCP SDK.

0.18.1 — 2026-08-11

Fixed

  • First monorepo release: workspaces, tokenless publishing (npm trusted publishing / OIDC), commander 14, jest 30.

0.18.0 — 2026-08-11

Changed

  • Package renamed @brainfile/cli → brainfile. Monorepo consolidation at github.com/1broseidon/brainfile.