vestige/docs/LAUNCH_STATS.md
Sam Valladares 00511948ff Add developer launch kit for Vestige v2.1.23
Dual-wave marketing assets (Receipt Lock + cognitive memory), GitHub Pages
landing, comparison doc, ready-to-post copy, growth-engine scripts, and a
dedicated marketing Vestige data-dir setup path.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-02 12:38:18 -05:00

88 lines
2.8 KiB
Markdown

# Vestige Launch Stats (Single Source of Truth)
**Last verified:** 2026-06-02
**Use this file** when updating README, launch posts, npm README, and landing page. Do not invent numbers elsewhere.
## Release
| Field | Value |
|-------|-------|
| Version | **v2.1.23** ("Receipt Lock Hardening") |
| npm package | `vestige-mcp-server@latest` |
| Install | `npm install -g vestige-mcp-server@latest` |
| MCP connect (Claude Code) | `claude mcp add vestige vestige-mcp -s user` |
| Optional Receipt Lock | `vestige sandwich install --enable-sanhedrin` |
| License | AGPL-3.0-only |
| Repo | https://github.com/samvallad33/vestige |
| Homepage (marketing) | https://samvallad33.github.io/vestige/ (GitHub Pages) |
## Author
| Field | Value |
|-------|-------|
| Name | Sam Valladares |
| Age | **22** (solo developer) |
| GitHub stars (2026-06-02) | **542** |
| Forks | **55** |
## Codebase (run to refresh)
```bash
# Rust LOC (crates + tests)
find crates tests -name '*.rs' | xargs wc -l | tail -1
# MCP tool count (must match server assertion)
rg 'name: "' crates/vestige-mcp/src/server.rs | wc -l
# Tests
cargo test --workspace --no-fail-fast 2>&1 | tail -3
```
| Metric | Current value | Notes |
|--------|---------------|-------|
| Rust LOC | **~86,000** | `crates/` + `tests/` `.rs` files |
| MCP tools | **25** | Verified in `server.rs` (`tools.len() == 25`) |
| Cognitive modules | **30** | Per README architecture |
| Rust tests | **1,200+** | CHANGELOG v2.1.0: 1,229 passing; re-run before major launch |
| Dashboard tests | **171** | Vitest in `apps/dashboard` |
| Release binary | **~22MB** | Single binary, embedded SvelteKit dashboard |
| Embedding model | Nomic Embed Text v1.5 (~130MB first-run download) |
## Install (canonical — no `sudo mv`)
The npm package registers global bins via `postinstall`. **Do not** tell users to `sudo mv vestige-mcp` unless manual binary install failed.
```bash
npm install -g vestige-mcp-server@latest
vestige health
claude mcp add vestige vestige-mcp -s user
```
If `vestige-mcp` is not on PATH after install:
```bash
npm prefix -g # e.g. /usr/local or ~/.npm-global
# Ensure that path/bin is in your shell PATH
```
Manual binary placement (optional):
```bash
vestige update --install-dir /usr/local/bin
```
## Messaging guardrails
- Lead Wave A with **Receipt Lock** (agents overclaim "tests passed").
- Close Wave B with **cognitive memory** (FSRS-6, dreaming, 3D dashboard).
- Never: "revolutionary", "game-changer", "AI-powered", competitor bashing.
- Always: honest neuroscience (faithful implementations vs engineering heuristics).
## North-star metrics
Track weekly (see `docs/marketing/metrics-tracker.md`):
1. **npm downloads** (`npm view vestige-mcp-server` / npmjs.com stats)
2. **GitHub stars delta**
3. **Inbound issues/DMs** mentioning install
4. **Referral source** (HN, Reddit, X, registry)