Skip to content

v1.4.0

Latest
Latest

Choose a tag to compare

View all tags
@stevebrownlee stevebrownlee released this 18 Mar 01:53
v1.4.0
c040fbe

What's New in v1.4.0

Guaranteed Filesystem-First Write-Through for Team Items

Team-visibility items (decisions, patterns, shared data) now follow a strict 3-step write
sequence where the .engrams/ markdown write is guaranteed, not best-effort:

  1. SQLite write (acquires the DB-generated ID for filename)
  2. .engrams/ markdown file write — operation fails if this fails
  3. ChromaDB embedding — best-effort, never blocking

This ensures .engrams/ remains git-committable and authoritative for team knowledge.
The SQLite database is always rebuildable from the filesystem via TeamContentIndexer.scan_and_sync().

Full Roo Scaffold via engrams init

engrams init --tool roo now installs the complete Roo Code experience — not just the
strategy rules file. Six files are installed automatically:

  • .roomodes — custom Roo mode definitions
  • .roo/system-prompt-flow-architect
  • .roo/system-prompt-flow-code
  • .roo/system-prompt-flow-debug
  • .roo/system-prompt-flow-ask
  • .roo/system-prompt-flow-orchestrator

Per-file conflict handling ensures existing customizations are never silently overwritten.
Use --skip-prompts to install only the strategy rules (rules-only mode for existing Roo setups).

Rewritten System Prompts — All Five Flow Modes

All five Flow mode system prompts have been fully audited and rewritten, fixing 126 combined
issues across the suite:

Mode Issues Fixed Token Reduction
Architect 28 ~82% (1,435 → ~250 lines)
Code 32 ~85% (1,462 → ~230 lines)
Debug 34 ~85% (1,459 → ~290 lines)
Ask 31 ~70% (616 → ~185 lines)
Orchestrator 21 ~45%

Key improvements across all modes:

  • Removed 12+ references to nonexistent MCP tools
  • Added governance pre-check (tool_check_planned_action) before mutations
  • Added get_context_for_files workflow for file-aware context retrieval
  • Added get_relevant_context with mode-specific profiles
  • Added parallel tool call support
  • Added mode handoff protocols
  • Fixed Engrams session initialization (INIT section now correctly used)
  • Removed hardcoded project-specific paths

Other Changes

  • New --skip-prompts CLI flag for engrams init --tool roo (rules-only mode)
  • scripts/sync_scaffolds.sh — developer utility for keeping scaffold files in sync
  • pyproject.toml package-data updated to include scaffolds/**/*
  • 8 new passing tests in tests/test_scaffold/test_roo_scaffold.py
  • Team/solo visibility config during engrams init (sets workspace default for all subsequent logging)

Full Changelog: v1.3.1...v1.4.0

Install / upgrade:

uvx --reinstall --from engrams-mcp engrams-mcp
# or
pip install --upgrade engrams-mcp
Assets 2
Loading