You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
release: v4.2.0 "Loop" — close the agent's research loop (grep + read-dedup)
Ships the token-saving work that was stranded on main since v4.1.0: Grep
interception (symbol greps → call-site lines from the reference graph, gated to
content-mode + >=4 callers), same-session read dedup (recall-safe, PreCompact +
SessionStart reset), richer find-usages call sites, and the deterministic
session-level bench. npm users on 4.1.0 had none of it.
Version 4.1.0 → 4.2.0 across package.json + lock + server.json (×2). CHANGELOG
[Unreleased] → [4.2.0] "Loop". README + install.html: v4.2 "Loop" callout/
showcase (grep→call-sites, read dedup, honest session bench); banner, hero pill,
nav, npx commitment, test badge (1025→1100) all bumped. server.json description
notes the read/grep/re-read interception.
Honest framing preserved: structural context-token reduction, not a bill saving;
no '89%' as cost; 'ranked' applies only to PageRank query results, never the
alphabetical grep caller list.
Audit: tsc clean; full suite 1100/1100; build clean; npm pack engramx-4.2.0.tgz
53 files no junk; npm audit 0 vulns. Fresh-clone verifier: RELEASE-READY (1100
green + all 3 features smoke-verified from clean checkout). Leak-audit 0 hits +
clean-room subagent verdict CLEAN.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
git add -A && git commit -q -m "feat: add buggy helper returning null causing form crashes"&& \
88
88
git revert --no-edit HEAD > /dev/null && \
89
-
npx --yes engramx@4.1.0 init .&& \
90
-
npx --yes engramx@4.1.0 mistakes
89
+
npx --yes engramx@4.2.0 init .&& \
90
+
npx --yes engramx@4.2.0 mistakes
91
91
```
92
92
93
93
You should see, within 30 seconds, the **bi-temporal pre-mortem** engram auto-captured from your revert:
@@ -119,9 +119,9 @@ On engramx's own repo the **per-file structural context reduction is ~89%** (89.
119
119
120
120
Works in 8 IDEs and counting — Claude Code, Cursor, Cline, Continue.dev, Aider, Windsurf, Zed, OpenAI Codex CLI. One install, one graph, every tool benefits. Apache 2.0. Local SQLite. Nothing leaves your machine.
121
121
122
-
> **v4.1 "Compass" shipped 2026-06-03 — engram now ranks the graph.**A real cross-file reference graph (tree-sitter `calls` edges) is built at `engram init`, and query results are ranked by **personalized PageRank**over it — importance flows from who-references-you, recursively, biased toward your query, instead of raw edge-degree. engram is the only tool in its category that *ranks* the graph rather than dumping it. New traversal commands `engram callers <symbol>`, `engram callees <symbol>`, and `engram impact <symbol>` walk the same edges.
122
+
> **v4.2 "Loop" shipped 2026-06-03 — engram now closes the agent's investigation loop.**The original Context Spine goal was to collapse the whole `grep → read → read` loop, not just the single file read. v4.2 ships the rest: a **Grep interception**that answers a content-mode symbol search from the reference graph with the actual `file:line: code` call sites — smaller than the raw grep (`init` is 573 vs 9,317 tokens on engram's own repo) while showing the real usage — and **same-session read dedup** that returns a pointer instead of re-serving an unchanged file the agent already read.
123
123
>
124
-
> Also new:**day-1 mistakes**— a bug-fix-commit miner (`fix:` / `fixes #N`, not just rare reverts) means a fresh `engram init` surfaces real landmines immediately, and a **per-session value line** (Stop hook) shows what engram kept out of context each session. And the **honesty pass**: every surface now frames the per-file win as a *structural context-packet reduction, not a cost saving* (engram's net agent-loop cost over prompt caching is ~0); the Read hook is size-guarded so a reported reduction is never negative, and `bench/real-world.ts` self-discloses its baseline. Incremental re-index now maintains the reference graph atomically, so ranking stays fresh between full inits. 1074 tests passing. See [CHANGELOG.md](CHANGELOG.md) for the full v4.1 diff (and v4.0 "Skill Pack" — bi-temporal mistakes from git-revert history).
124
+
> Both are**recall-safe by construction**(an `rg -n` escalation path; byte-unchanged + PreCompact/SessionStart reset guards) and **gated so they only fire when they genuinely save tokens** — a default `files_with_matches` grep, a low-usage symbol, or a tiny file all pass straight through. Honest framing throughout: a *structural* context-token reduction, not a bill saving (engram's net agent-loop cost over prompt caching is ~0). A new deterministic **session-level bench** (`bench/session-level.ts`) models the saving as a function of how often the agent re-fetches raw content, instead of quoting one number. 1100 tests passing. See [CHANGELOG.md](CHANGELOG.md) for the full v4.2 diff (and v4.1 "Compass" — PageRank-ranked graph + `callers`/`callees`/`impact` traversal).
125
125
126
126
<details>
127
127
<summary><strong>Earlier release notes (v3.4 "Universal Spine", May 2)</strong></summary>
<title>Install · engramx v4.1 "Compass" — ranked code-graph context for every AI coding tool</title>
7
+
<title>Install · engramx v4.2 "Loop" — closes the agent's research loop for every AI coding tool</title>
8
8
<metaname="description" content="One install. Works in Claude Code, Cursor, Cline, Continue, Aider, Codex, Windsurf, Zed. Bi-temporal mistakes auto-fire before your agent repeats them. Auto-captured from git revert history. Auto-installed on engram init. Up to ~89% fewer context tokens (structural, codebase-dependent — not a bill saving). Local SQLite, zero cloud, Apache 2.0.">
<metaproperty="og:title" content="engramx v4.1 'Compass' — ranked code-graph context for every AI coding tool. PageRank over a real cross-file reference graph, plus mistakes memory that fires before your agent repeats a fix the repo already reverted.">
11
+
<metaproperty="og:title" content="engramx v4.2 'Loop' — closes the agent's grep → read investigation loop. Symbol greps answered from the reference graph with real call sites; same-session re-reads deduped. Recall-safe and gated to only fire when it saves tokens.">
12
12
<metaproperty="og:description" content="npm install -g engramx → engram init. Auto-installs the Sentinel hook. Auto-captures bi-temporal mistakes from git revert. Up to ~89% fewer context tokens (structural, codebase-dependent — not a bill saving). Local SQLite, zero cloud. Apache 2.0.">
"description": "Ranked local code-graph context for AI coding tools. Works in 8 IDEs. Up to ~89% structural context reduction (varies by repo). Local SQLite, zero cloud, Apache 2.0.",
4
+
"description": "Ranked local code-graph context for AI coding tools — intercepts file reads, symbol greps, and re-reads. Works in 8 IDEs. Up to ~89% structural context reduction (varies by repo). Local SQLite, zero cloud, Apache 2.0.",
0 commit comments