Skip to content

engram-ctx Phase 1 (1.1.0) — Bridge Foundation

Latest
Latest

Choose a tag to compare

View all tags
@aop60003 aop60003 released this 03 May 07:41
engram-ctx-p1
425726f

Highlights

engram-ctx subpackage bridges tool outputs into engram's SQLite+FTS5 storage so AI agents can recall prior context without re-running expensive tools.

  • 5 MCP tools: engram_ctx_index, engram_ctx_search, engram_ctx_stats, engram_ctx_doctor, engram_ctx_purge
  • 5 lifecycle hooks: SessionStart, PreToolUse, PostToolUse (auto-indexes outputs ≥500 chars), UserPromptSubmit, Stop
  • Two installers: engram-ctx install claude-code and engram-ctx install codex (idempotent JSON/TOML merge)
  • engram-context skill (caveman-style output rules)
  • FastMCP middleware for non-hook MCP clients (Cursor, Copilot CLI, OpenCode)

Security & reliability hardening

  • PII/secret redaction expanded: JWT, Slack, Stripe, Google API keys, URL basic-auth, generic secret=… patterns
  • Hook stderr no longer leaks unmasked exception payloads
  • SQLite busy_timeout raised to 30s for hook concurrency
  • Codex hooks.json merges with user entries (was overwriting)
  • AWS 40-char base64 heuristic dropped (was over-redacting SHA1/git hashes)

Install

pip install --upgrade engram-ms

# Claude Code
engram-ctx install claude-code

# Codex CLI
engram-ctx install codex

Quality gates

  • 726 tests passing, 4 skipped
  • Windows-first regression suite (spaced usernames, CRLF stdin, unicode 한글, spaced CODEX_HOME)
  • End-to-end smoke verified in isolated profile
  • Final code review by independent reviewer

Phase 2 follow-ups

Tracked as #2-#6:

  • #2 engram_ctx_purge('all') confirm gate
  • #3 FTS5 syntax-error handling
  • #4 Fold tool_observations into versioned migration ladder
  • #5 engram_ctx_get + pagination for v1 API stability
  • #6 Daemonize engram-ctx hook

Full PR: #7

Assets 2
Loading