@cachly-dev/mcp-server 0.9.8 → 0.9.10
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.
- package/CHANGELOG.md +30 -70
- package/Dockerfile +2 -4
- package/README.md +173 -310
- package/dist/index.js +64 -25
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/server.json +1 -1
- package/src/index.ts +68 -25
- package/test-features.cjs +23 -0
- package/.github/workflows/publish.yml +0 -42
- package/LICENSE +0 -202
- package/glama.json +0 -6
package/CHANGELOG.md
CHANGED
|
@@ -7,102 +7,62 @@
|
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
## [0.9.
|
|
10
|
+
## [0.9.3] – 2026-05-06
|
|
11
11
|
|
|
12
|
-
###
|
|
12
|
+
### 🧠 10x Vision Phase 2 — Layers 3, 5 & 6
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
#### Layer 3 — Multi-Agent Deliberation Chamber (MADC)
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
- **`compact_recover`** — Reconstruct full context from Crystal + last session + handoff + WIP registry + roadmap. The single command to call when context window compacts.
|
|
18
|
-
- **`brain_from_git`** — Parse git log, classify commits (fix/feat/refactor/perf/security/deploy/test/chore), store lessons at confidence 0.55, update CKG edges. Cold-start bootstrap for new brains.
|
|
19
|
-
- **`brain_predict_failures`** — Query CKG `causes`/`degrades_under` edges + failure-outcome lessons, rank by probability percentage. Returns pre-loaded fixes. Before every deploy: know what will break.
|
|
16
|
+
New tool: **`madc_deliberate`** — When conflicting lessons exist for a topic, run deliberation between 6 specialist expert agents (InfraAgent, AuthAgent, DeployAgent, DatabaseAgent, DebugAgent, APIAgent). Each agent votes based on its CKG domain coverage. Unanimous → loser superseded. Split → contested flag. Resolutions stored as permanent CKG nodes.
|
|
20
17
|
|
|
21
|
-
|
|
22
|
-
New npm description: *"Your AI forgets everything between sessions. cachly fixes that permanently. A causal brain that learns WHY things break."*
|
|
18
|
+
Auto-trigger: `learn_from_attempts` now detects contradictions, writes a `contradicts` CKG edge, and suggests `madc_deliberate` automatically.
|
|
23
19
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
## [0.9.6] – 2026-05-05
|
|
27
|
-
|
|
28
|
-
### 🔗 Repo URL fix + OAuth Device Flow
|
|
20
|
+
#### Layer 5 — Continuous Learning Stream (CLS)
|
|
29
21
|
|
|
30
|
-
|
|
31
|
-
- **package.json**: repository + bugs URLs updated
|
|
32
|
-
- OAuth Device Flow: zero-credential install, auto-starts on first tool call
|
|
22
|
+
Two new tools for learning **without `session_end`**:
|
|
33
23
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
## [0.9.5] – 2026-05-05
|
|
24
|
+
- **`cls_ingest`** — Ingest learning signals from 3 sources: `git_commit` (commit message + files → CKG edges + lesson), `ci_outcome` (green after red → confirmed fix at 75% confidence), `ide_diagnostic` (compiler error + fix pair → instant lesson + CKG `fixes` edge).
|
|
37
25
|
|
|
38
|
-
|
|
26
|
+
- **`cls_install_hooks`** — Outputs a ready-to-paste git post-commit hook + GitHub Actions step. Once installed: every commit and CI run feeds the brain automatically. Zero `session_end` required.
|
|
39
27
|
|
|
40
|
-
|
|
41
|
-
- **smithery.yaml**: 0 required fields — users only need to click the sign-in link
|
|
42
|
-
- `glama.json` added for ownership claim
|
|
28
|
+
#### Layer 6 — Federation Protocol (FedBrain)
|
|
43
29
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
## [0.9.4] – 2026-05-05
|
|
47
|
-
|
|
48
|
-
### ⚡ Auto-instance resolution + 1-field setup
|
|
49
|
-
|
|
50
|
-
- `resolveDefaultInstanceId()`: auto-fetches running instance when only JWT is set
|
|
51
|
-
- `handleTool`: auto-injects default `instance_id` for all tools when env absent
|
|
52
|
-
- smithery.yaml: only 1 required field (JWT)
|
|
53
|
-
|
|
54
|
-
---
|
|
30
|
+
Four new tools for AI-to-AI knowledge transfer with cryptographic provenance:
|
|
55
31
|
|
|
56
|
-
|
|
32
|
+
- **`fedbrain_contribute`** — Contribute a lesson to the global commons with a HMAC-signed knowledge certificate (domain fingerprint + confidence + outcome chain hash).
|
|
57
33
|
|
|
58
|
-
|
|
34
|
+
- **`fedbrain_search`** — Context-weighted search: your domain fingerprint (from contributed lessons + `context_hints`) weights results from brains with matching tech stacks higher. Shows Gold Standard badges (10+ confirms).
|
|
59
35
|
|
|
60
|
-
- **`
|
|
61
|
-
- **`cls_ingest`** + **`cls_install_hooks`**: Continuous Learning Stream from git/CI
|
|
62
|
-
- **`fedbrain_contribute`** / **`fedbrain_search`** / **`fedbrain_confirm`** / **`fedbrain_status`**: Federation Protocol with cryptographic provenance and context-weighted search
|
|
36
|
+
- **`fedbrain_confirm`** — Confirm that a syndicated lesson worked. Propagates back to global commons (increments `confirm_count`). Updates local CKG confidence. At 10 independent confirmations → 🏆 Gold Standard.
|
|
63
37
|
|
|
64
|
-
|
|
38
|
+
- **`fedbrain_status`** — Dashboard: contributed lessons, confirm history, Gold Standard count, pending propagations.
|
|
65
39
|
|
|
66
|
-
|
|
40
|
+
#### Summary
|
|
67
41
|
|
|
68
|
-
|
|
42
|
+
| Layer | Tool(s) | What it does |
|
|
43
|
+
|-------|---------|--------------|
|
|
44
|
+
| 3 (MADC) | `madc_deliberate` | Expert agent voting on contradicting beliefs |
|
|
45
|
+
| 5 (CLS) | `cls_ingest`, `cls_install_hooks` | Continuous learning without session_end |
|
|
46
|
+
| 6 (FedBrain) | `fedbrain_contribute`, `fedbrain_search`, `fedbrain_confirm`, `fedbrain_status` | Federated knowledge with crypto certificates |
|
|
69
47
|
|
|
70
|
-
|
|
71
|
-
- **`brain_predict`**: Predictive Pre-fetch — predict likely failures from current context
|
|
72
|
-
- **`brain_search`**: BM25+ full-text search over all brain data
|
|
73
|
-
- **`knowledge_decay`**: Manually trigger confidence decay for stale beliefs
|
|
48
|
+
Total tools: **63** (was 54 in v0.9.2)
|
|
74
49
|
|
|
75
50
|
---
|
|
76
51
|
|
|
77
|
-
## [0.9.
|
|
78
|
-
|
|
79
|
-
### 💎 Memory Crystals — Properly surfaced
|
|
52
|
+
## [0.9.2] – 2026-05-06
|
|
80
53
|
|
|
81
|
-
|
|
54
|
+
### 🧠 10x Vision Phase 1 — Layers 1, 2, 4 & 7
|
|
82
55
|
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
56
|
+
- **Layer 1 (CKG):** Redis-backed Causal Knowledge Graph. Typed edges: `fixes`, `requires`, `co-occurs`, `causes`, `contradicts`.
|
|
57
|
+
- **Layer 2 (BUE):** `learn_from_attempts` now writes CKG edges with Bayesian confidence `(s+1)/(t+2)`.
|
|
58
|
+
- **Layer 4 (PPE):** `brain_predict` — CKG traversal + text fallback for failure prediction.
|
|
59
|
+
- **Layer 7 (MCM):** Domain coverage map in `session_start` with confidence bars.
|
|
60
|
+
- New: `brain_search` (BM25+ over all brain data), `ckg_inspect` (BFS with confidence bars).
|
|
61
|
+
- `causal_trace` upgraded: CKG graph-first, text similarity fallback.
|
|
86
62
|
|
|
87
63
|
---
|
|
88
64
|
|
|
89
|
-
## [0.9.0] – 2026-05-05
|
|
90
|
-
|
|
91
|
-
### ⚡ compact_recover + 🌱 brain_from_git — The two most-requested missing tools
|
|
92
|
-
|
|
93
|
-
#### New Tools
|
|
94
|
-
|
|
95
|
-
- **`compact_recover`** — Fast context recovery after Claude/Cursor/Copilot context window compaction. Call as the FIRST tool after any context limit hit. Returns: last checkpoint (task + files + next step), session handoff if any, top recalled lessons for the current focus. Unlike `session_start`, this is instant — no full brain scan, no streak logic. Designed to be the first line of every CLAUDE.md recovery protocol.
|
|
96
|
-
|
|
97
|
-
- **`brain_from_git`** — Bootstrap the AI Brain from git history in one call. Scans the last N days of commits, extracts actionable knowledge (fixes, reverts, deploys, migrations), and bulk-loads them as lessons. Skips commits already in the Brain (safe to re-run). Supports author filtering for solo bootstrapping on team repos. The recommended first step for any new project: `brain_from_git(workspace_path=".", days=180)`.
|
|
98
|
-
|
|
99
|
-
#### Why these were missing
|
|
100
|
-
|
|
101
|
-
`compact_recover` was referenced in every CLAUDE.md template and Autopilot output but had no implementation — users were told to call it but it would fail silently. `brain_from_git` was the #1 marketed feature ("Turn your git history into an AI knowledge base") but only existed as ambient learning inside `session_end`. Both are now first-class MCP tools.
|
|
102
|
-
|
|
103
|
-
---
|
|
104
65
|
|
|
105
|
-
## [0.7.0] – 2026-05-04
|
|
106
66
|
|
|
107
67
|
### 🌐 Knowledge Syndication — The Global AI Brain
|
|
108
68
|
|
package/Dockerfile
CHANGED
|
@@ -11,8 +11,6 @@ COPY package*.json ./
|
|
|
11
11
|
RUN npm ci --omit=dev --ignore-scripts
|
|
12
12
|
COPY --from=builder /app/dist/ ./dist/
|
|
13
13
|
ENV NODE_ENV=production
|
|
14
|
-
ENV
|
|
15
|
-
|
|
16
|
-
ENV CACHLY_NO_TELEMETRY=1
|
|
17
|
-
ENV CACHLY_NO_UPDATE_CHECK=1
|
|
14
|
+
ENV PORT=3000
|
|
15
|
+
EXPOSE 3000
|
|
18
16
|
ENTRYPOINT ["node", "dist/index.js"]
|