compendium-mcp 0.5.0 → 0.6.1

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 (2) hide show
  1. package/README.md +13 -7
  2. package/package.json +13 -9
package/README.md CHANGED
@@ -90,10 +90,10 @@ Binary packaging details for maintainers: [npm/DISTRIBUTION.md](npm/DISTRIBUTION
90
90
 
91
91
  | Mode | Command | Notes |
92
92
  |------|---------|-------|
93
- | **stdio** (default) | `compendium` / `compendium stdio` | Cursor / Claude Desktop |
94
- | **Streamable HTTP/SSE** | `compendium http [BIND]` | Requires `--features http`. Endpoint: `http://{bind}/mcp` |
93
+ | **stdio** (default) | `compendium` / `compendium stdio` | Cursor / Claude Desktop — dual-compat (legacy initialize or modern connect) |
94
+ | **Streamable HTTP** | `compendium http [BIND]` | Requires `--features http`. Endpoint: `http://{bind}/mcp`. Sessionless (`2026-07-28`); JSON preferred, SSE fallback |
95
95
 
96
- Default HTTP bind: `127.0.0.1:8788` (override with arg or `COMPENDIUM_HTTP_BIND`).
96
+ Default HTTP bind: `127.0.0.1:8788` (override with arg or `COMPENDIUM_HTTP_BIND`). App cache (`COMPENDIUM_CACHE_DIR`) is not an MCP session — set it for multi-request HTTP. See playbook `http-transport`.
97
97
 
98
98
  ## Tools
99
99
 
@@ -169,7 +169,7 @@ src/
169
169
  brand.rs # SEP-973 icons for serverInfo + tool
170
170
  config.rs # COMPENDIUM_* env config
171
171
  server/ # MCP tool + resources + action handlers (rmcp)
172
- http.rs # Streamable HTTP/SSE (feature = "http")
172
+ http.rs # Streamable HTTP, sessionless (feature = "http")
173
173
  pipeline/
174
174
  brief/ # workspace brief (walk / window / pack / synthesize)
175
175
  tokens.rs # heuristic or tiktoken BPE (feature = "real-tokens")
@@ -192,7 +192,7 @@ tests/
192
192
  e2e_smoke.rs # spawns binary, MCP handshake, tools + resources
193
193
  eval_regression.rs # B1 heuristic quality + latency smoke
194
194
  CHANGELOG.md
195
- REPORT.md # design essay + Shipped/Next/Deferred roadmap
195
+ REPORT.md # design essay + Shipped (A–C) / Next ops / Deferred roadmap
196
196
  ```
197
197
 
198
198
  ## Build
@@ -235,6 +235,12 @@ Same `command` / `args` / `env` as Cursor, in Claude’s MCP config file.
235
235
 
236
236
  ### Local Cargo binary (developers)
237
237
 
238
+ After code changes, rebuild and **reload MCP** so the live tool schema matches source (avoid stale `npx`/Release binaries during development):
239
+
240
+ ```bash
241
+ cargo build --release --features real-tokens,http
242
+ ```
243
+
238
244
  ```json
239
245
  {
240
246
  "mcpServers": {
@@ -284,7 +290,7 @@ Point an MCP streamable-HTTP client at that URL (e.g. `StreamableHttpClientTrans
284
290
  | `COMPENDIUM_ARCHIVE_MAX_UNCOMPRESSED` | `4194304` | Max total uncompressed bytes for pack/unpack |
285
291
  | `COMPENDIUM_ARCHIVE_MAX_FILES` | `50` | Max files per archive |
286
292
  | `COMPENDIUM_SKILL_TTL_MS` | `300000` | Soft TTL (ms) on skill `resources/read` responses |
287
- | `COMPENDIUM_CACHE_DIR` | _(unset)_ | Persist session cache (chunks/cache keys) across restarts; default size cap 64 MiB |
293
+ | `COMPENDIUM_CACHE_DIR` | _(unset)_ | Persist session cache (chunks/cache keys) across restarts; default size cap 64 MiB. Multiple MCP processes may share one dir — **no** cross-process lock; TTL/eviction are best-effort. Prefer a dedicated dir per user/host. |
288
294
  | `COMPENDIUM_CACHE_MAX_BYTES` | _(unset / 64MiB with dir)_ | Soft cap on total cached payload bytes |
289
295
  | `RUST_LOG` | `compendium=info` | Logs on **stderr** only |
290
296
 
@@ -386,7 +392,7 @@ cargo test --test e2e_smoke
386
392
  cargo run --features http -- http 127.0.0.1:8788
387
393
  ```
388
394
 
389
- `e2e_smoke` spawns `CARGO_BIN_EXE_compendium`, completes the MCP initialize handshake over stdio, lists tools, then calls gateway actions. `http_smoke` (requires `--features http`) exercises streamable HTTP in-process.
395
+ `e2e_smoke` spawns `CARGO_BIN_EXE_compendium`, completes MCP connect (legacy initialize) over stdio, lists tools, then calls gateway actions. `http_smoke` (requires `--features http`) exercises sessionless streamable HTTP in-process.
390
396
 
391
397
  ## Design notes
392
398
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "compendium-mcp",
3
- "version": "0.5.0",
3
+ "version": "0.6.1",
4
4
  "description": "MCP server that compresses, summarizes, and filters context to minimize LLM token usage",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -34,17 +34,21 @@
34
34
  "LICENSE"
35
35
  ],
36
36
  "scripts": {
37
- "prepack": "node npm/scripts/check-wrapper.js",
37
+ "check-npm-gates": "node npm/scripts/check-versions-selftest.js && node npm/scripts/check-versions.js && node npm/scripts/check-residual-npm.js",
38
+ "check-versions": "node npm/scripts/check-versions.js",
39
+ "check-versions-selftest": "node npm/scripts/check-versions-selftest.js",
40
+ "check-residual-npm": "node npm/scripts/check-residual-npm.js",
41
+ "prepack": "node npm/scripts/check-wrapper.js && node npm/scripts/check-versions.js",
38
42
  "prepare": "node npm/scripts/link-bins.js"
39
43
  },
40
44
  "optionalDependencies": {
41
- "compendium-mcp-darwin-arm64": "0.5.0",
42
- "compendium-mcp-darwin-x64": "0.5.0",
43
- "compendium-mcp-linux-x64": "0.5.0",
44
- "compendium-mcp-linux-x64-musl": "0.5.0",
45
- "compendium-mcp-linux-arm64": "0.5.0",
46
- "compendium-mcp-win32-x64": "0.5.0",
47
- "compendium-mcp-win32-arm64": "0.5.0"
45
+ "compendium-mcp-darwin-arm64": "0.6.1",
46
+ "compendium-mcp-darwin-x64": "0.6.1",
47
+ "compendium-mcp-linux-x64": "0.6.1",
48
+ "compendium-mcp-linux-x64-musl": "0.6.1",
49
+ "compendium-mcp-linux-arm64": "0.6.1",
50
+ "compendium-mcp-win32-x64": "0.6.1",
51
+ "compendium-mcp-win32-arm64": "0.6.1"
48
52
  },
49
53
  "preferUnplugged": true
50
54
  }