Skip to content

v2.5.5 — Monograph adoption & reliability

Choose a tag to compare

@nokhodian nokhodian released this 22 Jul 13:48

What's New

Monograph Bug Fixes (@monoes/monograph@1.4.1)

  • Fix: monograph_doctor crash on ESMrequire('better-sqlite3') failed in ESM context; switched to await import() pattern
  • Fix: staleness threshold too generous — auto-rebuild threshold lowered from 3→1 commits behind HEAD; monograph_query now appends a staleness warning to every result when the index is behind
  • Fix: no graceful fallback for natural-language queries — zero-result responses now include a hint that monograph indexes identifiers, not prose descriptions

Monograph Adoption Enforcement (@monoes/monomindcli@2.5.5)

  • Graph gate redesigned — previously one-shot (blocked once, then toothless); now persistent: first grep without monograph → hard block, subsequent greps → reminder with node count
  • Generated fallback hook-handler — projects where source helpers couldn't be found got zero monograph enforcement; the generated stub now includes the full gate cycle (pre-bash block, pre-search warn, post-graph-tool clear)
  • Agent definitions updated — added "Code Navigation (monograph-first)" section to 5 core agents (coder, reviewer, tester, planner, coordinator)
  • Init upgrade pathmonomind init now detects and upgrades existing global CLAUDE.md monomind blocks that lack monograph instructions
  • Global CLAUDE.md — monograph-first rule added to the monomind integration block written by init

Packages Published

Package Version
@monoes/monograph 1.4.1
@monoes/monomindcli 2.5.5
monomind 2.5.5

Full Changelog: v2.5.4...v2.5.5