mirror of
https://github.com/samvallad33/vestige.git
synced 2026-06-22 21:28:08 +02:00
Revert "Add developer launch kit for Vestige v2.1.23"
This reverts commit 00511948ff.
This commit is contained in:
Sam Valladares
parent
6a37586c5f
commit
a355da99a6
34 changed files with 42 additions and 1303 deletions
|
|
@ -6,7 +6,7 @@ Every conversation starts from zero. You explain your project structure, your pr
|
|||
|
||||
Vestige is an open-source Rust MCP server that gives AI agents persistent memory modeled on real neuroscience. Not metaphorical neuroscience. Actual published algorithms from Ebbinghaus (1885), Collins & Loftus (1975), Bjork & Bjork (1992), Frey & Morris (1997), and the FSRS-6 spaced repetition scheduler trained on 700 million Anki reviews.
|
||||
|
||||
~86,000 lines of Rust. 30 cognitive modules. 1,200+ tests. v2.1.23 adds Receipt Lock for unverified agent claims. Single 22MB binary with embedded SvelteKit dashboard. AGPL-3.0 licensed. Stats: [LAUNCH_STATS.md](../LAUNCH_STATS.md).
|
||||
77,840+ lines of Rust. 29 cognitive modules. 734 tests. Single binary deployment with an embedded SvelteKit dashboard. AGPL-3.0 licensed.
|
||||
|
||||
Here is how we built it.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,4 @@
|
|||
# Vestige v2.1.23 — Demo Script (Conference + Launch Video)
|
||||
|
||||
> Stats: [LAUNCH_STATS.md](../LAUNCH_STATS.md) · Wave A hook: [receipt-lock.md](receipt-lock.md)
|
||||
# Vestige v2.0 "Cognitive Leap" — MCP Dev Summit NYC Demo Script
|
||||
|
||||
**Event:** MCP Dev Summit NYC, April 1-3, 2026
|
||||
**Presenter:** Sam Valladares
|
||||
|
|
@ -17,7 +15,7 @@
|
|||
- [ ] Phone hotspot configured as backup (embedding model already cached = no network needed)
|
||||
|
||||
### Software
|
||||
- [ ] Vestige binary installed: `vestige-mcp --version` shows `2.1.23` (or latest)
|
||||
- [ ] Vestige v2.0 binary installed: `vestige-mcp --version` shows `2.0.0`
|
||||
- [ ] Claude Code installed and authenticated
|
||||
- [ ] Terminal font size: 18pt minimum (audience readability)
|
||||
- [ ] Browser zoom: 150% for dashboard views
|
||||
|
|
@ -207,7 +205,7 @@ claude mcp add vestige vestige-mcp -s user
|
|||
|
||||
### [2:50-3:00] Close
|
||||
|
||||
> Vestige v2.1.23. Open source, AGPL-3.0. The repo is `samvallad33/vestige`. Come talk to me if you want to see the neuroscience under the hood.
|
||||
> Vestige v2.0, "Cognitive Leap." Open source, AGPL-3.0. The repo is `samvallad33/vestige`. Come talk to me if you want to see the neuroscience under the hood.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -393,9 +391,9 @@ vestige-mcp --version
|
|||
# One command to install
|
||||
```
|
||||
|
||||
> This is what I've been building. I'm one person, I'm twenty-two years old, and I believe this is how AI memory should work — grounded in real science, running locally, open source.
|
||||
> This is what I've been building for the past three months. I'm one person, I'm twenty-one years old, and I believe this is how AI memory should work — grounded in real science, running locally, open source.
|
||||
>
|
||||
> Vestige v2.1.23. The repo is `github.com/samvallad33/vestige`. The dashboard is running at `localhost:3927`. I'll be around all three days — come find me if you want to talk about FSRS, or synaptic tagging, or why I think every AI assistant on the planet should have a forgetting curve.
|
||||
> Vestige v2.0, "Cognitive Leap." The repo is `github.com/samvallad33/vestige`. The dashboard is running at `localhost:3927`. I'll be around all three days — come find me if you want to talk about FSRS, or synaptic tagging, or why I think every AI assistant on the planet should have a forgetting curve.
|
||||
>
|
||||
> Thank you.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,167 +0,0 @@
|
|||
# Wave A Launch — Receipt Lock (v2.1.23)
|
||||
|
||||
Primary viral hook. Post **before** the memory/science Show HN wave. Stats: [LAUNCH_STATS.md](../LAUNCH_STATS.md).
|
||||
|
||||
---
|
||||
|
||||
## Hacker News — Show HN
|
||||
|
||||
### Title (≤80 chars)
|
||||
|
||||
```
|
||||
Show HN: Vestige – blocks coding agents from claiming "tests passed" without receipts
|
||||
```
|
||||
|
||||
### First comment (body)
|
||||
|
||||
```
|
||||
Hi HN,
|
||||
|
||||
Your coding agent probably ends sessions with something like "all tests passed" or
|
||||
"the build is green." I kept trusting that — until it wasn't true.
|
||||
|
||||
I built Receipt Lock in Vestige (an MCP memory server I maintain). Before operational
|
||||
claims become part of the final answer, Vestige checks them against structured
|
||||
command receipts from the current transcript. No matching successful receipt → the
|
||||
claim can be blocked and a local veto receipt is written (JSON + HTML under
|
||||
~/.vestige/sanhedrin/).
|
||||
|
||||
**What it is:** Optional Claude Code Cognitive Sandwich hooks + local MCP server.
|
||||
Not cloud. Not "trust me bro" logging — inspectable receipts on disk.
|
||||
|
||||
**Install (memory server — required base):**
|
||||
npm install -g vestige-mcp-server@latest
|
||||
claude mcp add vestige vestige-mcp -s user
|
||||
|
||||
**Enable Receipt Lock (optional):**
|
||||
vestige sandwich install --enable-sanhedrin
|
||||
|
||||
Sanhedrin verifier can point at any OpenAI-compatible endpoint (Ollama, MLX, hosted API).
|
||||
|
||||
**And it also does real memory:** FSRS-6 spaced repetition, prediction error gating,
|
||||
memory dreaming, 3D dashboard at localhost:3927. ~86K LOC Rust, 25 MCP tools, 1,200+
|
||||
tests, 22MB binary. 100% local after first embedding download.
|
||||
|
||||
I'm 22, solo, AGPL-3.0. Repo: https://github.com/samvallad33/vestige
|
||||
Comparison: https://github.com/samvallad33/vestige/blob/main/docs/comparison.md
|
||||
|
||||
Happy to discuss false positive tuning, Sanhedrin presets, or why receipts beat vibes.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## r/ExperiencedDevs
|
||||
|
||||
### Title
|
||||
|
||||
```
|
||||
My coding agent kept saying "tests passed" when they hadn't. I added a receipt check before the summary ships.
|
||||
```
|
||||
|
||||
### Body
|
||||
|
||||
```markdown
|
||||
**TL;DR:** Vestige Receipt Lock checks operational claims ("tests passed", "build green", "lint clean") against structured command receipts from the transcript. No receipt → block + local veto artifact.
|
||||
|
||||
**The failure mode:** Agent runs partial checks, or hallucinates a green ending. You merge. CI breaks. You've seen this.
|
||||
|
||||
**The fix:** Optional hooks (`vestige sandwich install --enable-sanhedrin`) + MCP memory server. When the model tries to assert verification without evidence, Vestige can veto and write `~/.vestige/sanhedrin/latest.html` so you can inspect what happened.
|
||||
|
||||
**Not a replacement for CI.** It's a last-mile guard on *agent-authored* summaries in Claude Code.
|
||||
|
||||
**Stack:** Rust, local, MCP. Same project also does FSRS-6 cognitive memory (decay, dreaming, contradiction tools) — I'll post that angle separately if people want the science side.
|
||||
|
||||
```bash
|
||||
npm install -g vestige-mcp-server@latest
|
||||
claude mcp add vestige vestige-mcp -s user
|
||||
vestige sandwich install --enable-sanhedrin
|
||||
```
|
||||
|
||||
GitHub: https://github.com/samvallad33/vestige
|
||||
|
||||
What false positives are you seeing with agent verification claims? Curious if this matches your workflow.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## r/programming
|
||||
|
||||
### Title
|
||||
|
||||
```
|
||||
Open-source guard: coding agents can't claim "tests passed" without command receipts (local MCP, Rust)
|
||||
```
|
||||
|
||||
### Body — use r/ExperiencedDevs body; add:
|
||||
|
||||
```markdown
|
||||
License: AGPL-3.0. v2.1.23. Stats: ~86K LOC, 25 tools, 22MB binary.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## X / Twitter thread (8 posts)
|
||||
|
||||
1. Your coding agent ends with "tests passed." Did it run tests? Or did it summarize hope?
|
||||
|
||||
2. I ship Receipt Lock in Vestige — checks operational claims against command receipts from the transcript.
|
||||
|
||||
3. No matching successful receipt → claim blocked. Local veto receipt: `~/.vestige/sanhedrin/latest.html`
|
||||
|
||||
4. Optional hooks. Local MCP server. Not cloud analytics.
|
||||
|
||||
5. ```bash
|
||||
npm i -g vestige-mcp-server@latest
|
||||
claude mcp add vestige vestige-mcp -s user
|
||||
vestige sandwich install --enable-sanhedrin
|
||||
```
|
||||
|
||||
6. Same binary also does FSRS-6 memory — decay, dreaming, 3D brain viz. Thread on that tomorrow.
|
||||
|
||||
7. 22yo solo dev. AGPL. https://github.com/samvallad33/vestige
|
||||
|
||||
8. What's the worst "green build" lie your agent told you? Reply — building the FAQ from real stories.
|
||||
|
||||
---
|
||||
|
||||
## Lobste.rs
|
||||
|
||||
### Title
|
||||
|
||||
```
|
||||
Vestige Receipt Lock: local MCP guard against unverified "tests passed" agent claims
|
||||
```
|
||||
|
||||
### Tags
|
||||
|
||||
`rust` `programming` `security`
|
||||
|
||||
### Body
|
||||
|
||||
Use HN first comment (shorter). Link comparison.md.
|
||||
|
||||
---
|
||||
|
||||
## Engagement playbook (Wave A)
|
||||
|
||||
| Window | Action |
|
||||
|--------|--------|
|
||||
| 0–3h | Reply every comment within 30 min |
|
||||
| Tone | Technical, humble, no "revolutionary" |
|
||||
| Competitors | Acknowledge Mem0/Cursor memory; don't bash |
|
||||
| CTA | Install + link comparison.md |
|
||||
| Next | Schedule Wave B 48h after Wave A peaks |
|
||||
|
||||
### DO NOT
|
||||
|
||||
- "Game-changer" / "AI-powered" / "paradigm shift"
|
||||
- Disparage Mem0 or Claude native memory
|
||||
- Promise Receipt Lock replaces CI
|
||||
|
||||
---
|
||||
|
||||
## Timing
|
||||
|
||||
- **HN / Lobsters:** Tuesday or Wednesday, 8–10 AM US Eastern
|
||||
- **Reddit:** Same day, +1–2h after HN
|
||||
- **X:** Pin thread during HN peak
|
||||
|
|
@ -1,6 +1,4 @@
|
|||
# Reddit Launch Posts — cross_reference / deep_reference (v2.1.23)
|
||||
|
||||
> Canonical install: [LAUNCH_STATS.md](../LAUNCH_STATS.md) — **no `sudo mv`**; use `npm install -g vestige-mcp-server@latest`
|
||||
# Reddit Launch Posts — cross_reference Tool
|
||||
|
||||
## Post 1: r/ClaudeAI (Primary)
|
||||
|
||||
|
|
@ -80,8 +78,8 @@ Memory systems need to be SMARTER, not just bigger. That's what Vestige does —
|
|||
- **cross_reference** — the new tool that catches contradictions before they become wrong answers
|
||||
|
||||
### Stats:
|
||||
- 25 MCP tools
|
||||
- 1,200+ tests
|
||||
- 22 MCP tools
|
||||
- 746 tests, 0 failures
|
||||
- Zero `unsafe` code
|
||||
- Clean security audit (0 findings — AgentAudit verified)
|
||||
- Single 22MB Rust binary — no Docker, no PostgreSQL, no cloud
|
||||
|
|
@ -89,8 +87,9 @@ Memory systems need to be SMARTER, not just bigger. That's what Vestige does —
|
|||
|
||||
### Install (30 seconds):
|
||||
```bash
|
||||
npm install -g vestige-mcp-server@latest
|
||||
vestige health
|
||||
# macOS Apple Silicon
|
||||
npm install -g vestige-mcp-server
|
||||
sudo mv vestige-mcp /usr/local/bin/
|
||||
claude mcp add vestige vestige-mcp -s user
|
||||
```
|
||||
|
||||
|
|
@ -163,12 +162,12 @@ The AI sees the conflict. Picks the right one. Every time.
|
|||
**100% local. Your data never leaves your machine.**
|
||||
|
||||
```bash
|
||||
npm install -g vestige-mcp-server@latest
|
||||
vestige health
|
||||
npm install -g vestige-mcp-server
|
||||
sudo mv vestige-mcp /usr/local/bin/
|
||||
claude mcp add vestige vestige-mcp -s user
|
||||
```
|
||||
|
||||
1,200+ tests. Zero unsafe code. AGPL-3.0.
|
||||
746 tests. Zero unsafe code. Clean security audit. AGPL-3.0.
|
||||
|
||||
GitHub: https://github.com/samvallad33/vestige
|
||||
|
||||
|
|
@ -176,7 +175,7 @@ GitHub: https://github.com/samvallad33/vestige
|
|||
|
||||
## Post 3: r/rust (Optional, technical audience)
|
||||
|
||||
**Title:** `I built a 22MB Rust binary that gives AI agents a brain — FSRS-6, 30 cognitive modules, Receipt Lock, 25 MCP tools. ~86K LOC, zero unsafe.`
|
||||
**Title:** `I built a 22MB Rust binary that gives AI agents a brain — FSRS-6, 29 cognitive modules, 3D dashboard, and a new contradiction detection tool. 746 tests, zero unsafe.`
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -189,7 +188,7 @@ The latest addition: `cross_reference` — pairwise contradiction detection acro
|
|||
- No runtime, no GC pauses during real-time search
|
||||
- `tokio::sync::Mutex` for the cognitive engine, `std::sync::Mutex` for SQLite reader/writer split
|
||||
- Zero `unsafe` blocks in the entire codebase
|
||||
- `cargo test` runs 1,200+ tests across the workspace
|
||||
- `cargo test` runs 746 tests in 11 seconds
|
||||
|
||||
**Architecture:**
|
||||
```
|
||||
|
|
@ -214,7 +213,7 @@ SQLite WAL + FTS5 + USearch HNSW
|
|||
Clean security audit. Parameterized SQL everywhere. CSP headers on the dashboard. Constant-time auth comparison (`subtle::ConstantTimeEq`). File permissions 0o600/0o700.
|
||||
|
||||
GitHub: https://github.com/samvallad33/vestige
|
||||
AGPL-3.0 | 1,200+ tests | ~86K LOC
|
||||
AGPL-3.0 | 746 tests | 79K+ LOC
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
# Vestige v2.1.23 Launch — Show HN + Cross-Posts (Wave B: Memory)
|
||||
|
||||
> **Wave A (Receipt Lock)** posts live in [receipt-lock.md](receipt-lock.md). Run Wave A first.
|
||||
> Stats: [LAUNCH_STATS.md](../LAUNCH_STATS.md)
|
||||
# Vestige v2.0 Launch — Show HN + Cross-Posts
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -10,7 +7,7 @@
|
|||
### Title (76 chars)
|
||||
|
||||
```
|
||||
Show HN: Vestige v2.1.23 – FSRS-6 memory for AI agents + local Receipt Lock
|
||||
Show HN: Vestige – FSRS-6 spaced repetition as long-term memory for AI agents
|
||||
```
|
||||
|
||||
### Body (first comment)
|
||||
|
|
@ -60,7 +57,7 @@ retrieval. Written in Rust, 100% local, single 22MB binary.
|
|||
discover hidden connections and synthesize insights. Inspired by hippocampal
|
||||
replay during sleep.
|
||||
|
||||
**Dashboard (since v2.0, still core):**
|
||||
**v2.0 adds:**
|
||||
|
||||
- 3D neural visualization dashboard (SvelteKit + Three.js) — watch memories
|
||||
pulse when accessed, burst particles on creation, golden flash lines when
|
||||
|
|
@ -77,10 +74,7 @@ retrieval. Written in Rust, 100% local, single 22MB binary.
|
|||
embedded via Rust's `include_dir!` macro. No Docker, no Node runtime, no
|
||||
external services.
|
||||
|
||||
**v2.1.23 adds Receipt Lock:** optional hooks that block operational claims like
|
||||
"tests passed" unless matching command receipts exist in the transcript.
|
||||
|
||||
**Numbers:** ~86,000 lines of Rust, 1,200+ tests, 30 cognitive modules, 25 MCP
|
||||
**Numbers:** 77,840 lines of Rust, 734 tests, 29 cognitive modules, 21 MCP
|
||||
tools, search under 50ms for 1000 memories (SQLite FTS5 + USearch HNSW).
|
||||
|
||||
**What it is NOT:** This is not RAG. RAG treats memory as a static database —
|
||||
|
|
@ -93,7 +87,7 @@ The embedding model (Nomic Embed Text v1.5) runs locally via ONNX. After the
|
|||
first-run model download (~130MB), there are zero network requests. No
|
||||
telemetry, no analytics, no phoning home.
|
||||
|
||||
I've been using this daily and the experience is genuinely different.
|
||||
I've been using this daily for 2 months and the experience is genuinely different.
|
||||
Claude remembers my coding patterns, my architectural decisions, my preferences.
|
||||
New sessions start with context instead of a blank slate.
|
||||
|
||||
|
|
@ -281,12 +275,12 @@ surprising and useful.
|
|||
|
||||
### r/rust
|
||||
|
||||
**Title:** `Vestige v2.1.23 — ~86K LOC Rust memory system with FSRS-6, Receipt Lock, and a 22MB binary`
|
||||
**Title:** `Vestige v2.0 — 77K LOC Rust memory system with FSRS-6, HNSW, Axum WebSockets, and an embedded SvelteKit dashboard in a 22MB binary`
|
||||
|
||||
**Body:**
|
||||
|
||||
```markdown
|
||||
I've been building Vestige and just shipped v2.1.23. It's
|
||||
I've been building Vestige for the past few months and just shipped v2.0. It's
|
||||
a cognitive memory system for AI agents that implements neuroscience-backed
|
||||
memory algorithms in pure Rust.
|
||||
|
||||
|
|
@ -320,7 +314,7 @@ memory algorithms in pure Rust.
|
|||
- **Release profile**: `lto = true`, `codegen-units = 1`, `opt-level = "z"`,
|
||||
`strip = true` gets the binary down to 22MB including embedded assets.
|
||||
|
||||
- **1,200+ tests** across workspace. Zero warnings on release gates.
|
||||
- **734 tests**: 352 core + 378 mcp + 4 doctests. Zero warnings.
|
||||
|
||||
**Architecture:**
|
||||
|
||||
|
|
@ -363,7 +357,7 @@ Happy to discuss any of the Rust architecture decisions.
|
|||
|
||||
### r/ClaudeAI
|
||||
|
||||
**Title:** `Vestige v2.1.23 — give Claude real long-term memory (FSRS-6) + optional Receipt Lock for fake "tests passed" claims`
|
||||
**Title:** `Vestige v2.0 "Cognitive Leap" — give Claude real long-term memory with neuroscience-backed forgetting, a 3D dashboard, and 21 MCP tools`
|
||||
|
||||
**Body:**
|
||||
|
||||
|
|
@ -391,7 +385,7 @@ locally on your machine.
|
|||
strength model, testing effect, synaptic tagging, spreading activation,
|
||||
context-dependent retrieval, memory dreaming.
|
||||
|
||||
**Highlights:**
|
||||
**v2.0 new features:**
|
||||
|
||||
- **3D Memory Dashboard** at localhost:3927/dashboard — watch Claude's mind in
|
||||
real-time. Memories pulse when accessed, burst particles on creation, golden
|
||||
|
|
@ -407,8 +401,7 @@ locally on your machine.
|
|||
**Setup (2 minutes):**
|
||||
|
||||
```bash
|
||||
npm install -g vestige-mcp-server@latest
|
||||
vestige health
|
||||
npm install -g vestige-mcp-server
|
||||
claude mcp add vestige vestige-mcp -s user
|
||||
```
|
||||
|
||||
|
|
@ -424,7 +417,7 @@ on Project X ended with a tricky race condition in the WebSocket handler.
|
|||
It's the difference between talking to someone with amnesia vs. someone who
|
||||
actually knows you.
|
||||
|
||||
25 MCP tools. ~86,000 lines of Rust. 1,200+ tests. Works with Claude Code, Claude
|
||||
21 MCP tools. 77,840 lines of Rust. 734 tests. Works with Claude Code, Claude
|
||||
Desktop, Cursor, VS Code Copilot, JetBrains, Windsurf, and Xcode.
|
||||
|
||||
Source: https://github.com/samvallad33/vestige
|
||||
|
|
@ -436,7 +429,7 @@ Happy to answer questions or help with setup.
|
|||
|
||||
### r/LocalLLaMA
|
||||
|
||||
**Title:** `Vestige v2.1.23 — local-first AI memory with FSRS-6, Receipt Lock, zero cloud (~86K LOC Rust, 22MB binary)`
|
||||
**Title:** `Vestige v2.0 — local-first AI memory server with FSRS-6 spaced repetition, ONNX embeddings, and zero cloud dependency (77K LOC Rust, 22MB binary)`
|
||||
|
||||
**Body:**
|
||||
|
||||
|
|
@ -489,7 +482,7 @@ algorithms:
|
|||
- 3D force-directed memory graph with real-time WebSocket events
|
||||
- HyDE query expansion (template-based hypothetical document embeddings)
|
||||
- FSRS decay visualization with retention curves
|
||||
- 1,200+ tests, 30 cognitive modules, 25 tools
|
||||
- 734 tests, 29 cognitive modules, 21 tools
|
||||
- fastembed 5.11 with feature flags for Nomic v2 MoE + Qwen3 reranker
|
||||
|
||||
**Performance:**
|
||||
|
|
@ -542,7 +535,8 @@ This is a solo project — feedback, issues, and contributions are very welcome.
|
|||
implementations, some are engineering heuristics inspired by research)
|
||||
3. 100% local, zero cloud — this is a feature, not a limitation
|
||||
4. The 3D dashboard is a genuine exploration tool, not just eye candy
|
||||
5. FSRS-6 + Receipt Lock — spaced repetition memory and optional agent claim verification
|
||||
5. FSRS-6 is the differentiator — no other AI memory system uses real spaced
|
||||
repetition
|
||||
|
||||
### What NOT to Say
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue