engramx 0.5.3 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +264 -291
  3. package/dist/aider-context-TNGSXMVY.js +54 -0
  4. package/dist/{chunk-IIFAAYDO.js → chunk-6SFMVYUN.js} +5 -0
  5. package/dist/chunk-CEAANHHX.js +88 -0
  6. package/dist/{chunk-KEV4LNM6.js → chunk-QOG4K427.js} +1 -1
  7. package/dist/chunk-SBHGK5WA.js +104 -0
  8. package/dist/cli.js +747 -130
  9. package/dist/{core-UXIP2GDR.js → core-77MHT3QV.js} +2 -1
  10. package/dist/cursor-mdc-HWVUZUZH.js +75 -0
  11. package/dist/exporter-A3VSLS4U.js +47 -0
  12. package/dist/importer-MCNFMV5O.js +66 -0
  13. package/dist/index.js +3 -2
  14. package/dist/migrate-5ZJWF2HD.js +10 -0
  15. package/dist/serve.js +2 -1
  16. package/dist/server-I3C74ZLB.js +193 -0
  17. package/dist/tuner-2LVIEE5V.js +113 -0
  18. package/package.json +11 -3
package/CHANGELOG.md CHANGED
@@ -4,6 +4,76 @@ All notable changes to engram are documented here. Format based on
4
4
  [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
5
5
  [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
+ ## [1.0.0] — 2026-04-17 — "Protocol"
8
+
9
+ ### Added
10
+
11
+ - **HTTP REST server** — `engram server --http` starts a local server on
12
+ 127.0.0.1:7337. Endpoints: `/health`, `/query`, `/stats`, `/providers`,
13
+ `/learn`. Bearer token auth via `ENGRAM_API_TOKEN`. PID file written on
14
+ start for HUD server-status detection.
15
+ - **Tree-sitter AST provider** (`engram:ast`) — WASM-based AST parsing for
16
+ 10 languages (TypeScript, JavaScript, Python, Go, Rust, PHP, Ruby, Java,
17
+ C, C++). Confidence 1.0 vs 0.85 for regex. When the AST provider succeeds
18
+ for a file, the regex `engram:structure` provider is skipped entirely.
19
+ - **LSP provider** (`engram:lsp`) — connects to running LSP servers. Hover
20
+ info is added to Read interceptions; diagnostic events on Edit create
21
+ mistake nodes automatically. Best-effort with graceful degradation when no
22
+ LSP is running.
23
+ - **Auto-tuning** — `engram tune [--dry-run|--apply]` analyzes
24
+ `.engram/hook-log.jsonl` and proposes per-project config changes:
25
+ confidence threshold, token budgets, provider enable/disable. Settings
26
+ are written to `.engram/config.json`.
27
+ - **Schema versioning** — 6 migration files (001–006). Auto-migrate on
28
+ startup with backup. `engram db status` shows current schema version;
29
+ `engram db migrate` runs pending migrations.
30
+ - **CCS integration** — Codebase Context Specification support.
31
+ `engram init --from-ccs` imports `.context/index.md` into the KG as
32
+ nodes. `engram gen-ccs` exports the KG to CCS format.
33
+ - **Continue.dev context provider** — `engramx-continue` npm package.
34
+ Surfaces as `@engram` in Continue's @-mention system. Falls back to HTTP
35
+ server if CLI is unavailable.
36
+ - **Cursor MDC generation** — `engram gen-mdc` generates
37
+ `.cursor/rules/engram-context.mdc` from the KG. YAML frontmatter with
38
+ auto-detected globs. `--watch` flag for live refresh on graph changes.
39
+ - **Zed context server** — `engram context-server` implements Zed's
40
+ JSON-RPC protocol. Registers as the `/engram` slash command inside Zed.
41
+ - **Aider context generation** — `engram gen-aider` creates
42
+ `.aider-context.md` from the KG. `--watch` flag for live refresh.
43
+ - **Benchmark harness v0.2** — automated `npm run bench` with 10 task
44
+ fixtures. Measures baseline vs engram token savings across real tasks.
45
+ Result: **88.1% aggregate token savings** (measured, not estimated).
46
+ - **Stress test suite** — `npm run stress` covering rapid concurrent reads,
47
+ provider concurrency, large graph operations, and hook-log replay.
48
+ - **Component health HUD** — statusLine now shows HTTP ✓/✗, LSP ✓/✗,
49
+ AST ✓/✗, and N IDEs. Updates automatically as components activate.
50
+ - **ECP spec v0.1** — Engram Context Protocol RFC at
51
+ `docs/specs/ecp-v0.1.md`. Vendor-neutral standard for hook-based context
52
+ enrichment across coding tools. CC-BY 4.0.
53
+ - **5 integration guides** — `docs/integrations/` with setup guides for
54
+ Continue.dev, Cursor, Zed, Aider, Claude Code, and CCS.
55
+ - **Per-project config** — `.engram/config.json` supports confidence
56
+ threshold, token budgets, and provider overrides. Read by the resolver
57
+ on every packet assembly.
58
+
59
+ ### Changed
60
+
61
+ - Provider priority now includes `engram:ast` (highest confidence, runs
62
+ first) and `engram:lsp` (lowest, best-effort enrichment). The regex
63
+ `engram:structure` provider is skipped on files where AST succeeds.
64
+ - `TOTAL_TOKEN_BUDGET` is now configurable via `.engram/config.json`.
65
+ Was hardcoded at 600.
66
+ - Test count: 520 → 579 (+59 tests across 6 new test files).
67
+
68
+ ### Fixed
69
+
70
+ - **Shell injection in Continue adapter** — switched from double-quote
71
+ escaping to single-quote wrapping for all CLI arguments.
72
+ - **HTTP server package.json path resolution** — now resolves correctly
73
+ from both `src/` (dev) and `dist/` (built) entry points.
74
+
75
+ ---
76
+
7
77
  ## [0.5.0] — 2026-04-13 — "Context Spine"
8
78
 
9
79
  ### Added
@@ -578,6 +648,7 @@ messages for follow-up tracking.
578
648
  (3-11x) and vs full corpus (30-70x).
579
649
  - Apache 2.0 licensed.
580
650
 
651
+ [1.0.0]: https://github.com/NickCirv/engram/releases/tag/v1.0.0
581
652
  [0.2.0]: https://github.com/NickCirv/engram/releases/tag/v0.2.0
582
653
  [0.1.1]: https://github.com/NickCirv/engram/releases/tag/v0.1.1
583
654
  [0.1.0]: https://github.com/NickCirv/engram/releases/tag/v0.1.0