Bump to 0.7.2, enrich npm README for MCP directory listings

The npm README is used by mcp.so and other directories as the package
overview. Updated with full product description, 12-tool table, privacy
model, and install instructions. Synced Makefile + npm version to 0.7.2.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sgx-labs

Makefile

@@ -1,6 +1,6 @@
 BINARY_NAME := same
 BUILD_DIR := build
-VERSION := 0.7.0
+VERSION := 0.7.2
 LDFLAGS := -ldflags "-s -w -X main.Version=$(VERSION)"
 
 # CGO is required for sqlite3 + sqlite-vec

npm/README.md

@@ -1,12 +1,38 @@
-# @sgx-labs/same
+# SAME — Stateless Agent Memory Engine
 
-NPM wrapper for [SAME (Stateless Agent Memory Engine)](https://github.com/sgx-labs/statelessagent) — persistent memory for AI coding agents.
+Persistent memory for AI coding agents. Local-first, private, no cloud.
 
-This package downloads the prebuilt SAME binary for your platform at install time. No Go toolchain required.
+Your AI agent forgets everything between sessions. SAME fixes that. It indexes your project notes locally, captures decisions as you work, and surfaces relevant context at session start. A 6-gate relevance chain decides when to inject context and when to stay quiet — about 80% of prompts get no injection at all.
+
+## What it does
+
+- **Semantic search** over your markdown notes via local Ollama embeddings (falls back to keyword search without Ollama)
+- **Federated search** across multiple registered vaults
+- **Session handoffs** — your agent writes what it did, the next session picks up where it left off
+- **Decision log** — decisions are saved and surfaced automatically in future sessions
+- **`same ask`** — RAG chat over your vault with source citations
+- **`same demo`** — try it in 60 seconds, creates a sandbox, cleans up after
+
+## 12 MCP Tools
+
+| Tool | Type | Description |
+|------|------|-------------|
+| `search_notes` | read | Semantic + keyword search across your vault |
+| `search_notes_filtered` | read | Search with domain, workstream, and tag filters |
+| `search_across_vaults` | read | Federated search across multiple vaults |
+| `find_similar_notes` | read | Find notes related to a given note |
+| `get_note` | read | Read full note content |
+| `get_session_context` | read | Pinned notes, latest handoff, recent decisions |
+| `recent_activity` | read | Recently modified notes |
+| `index_stats` | read | Vault health and index statistics |
+| `reindex` | read | Re-scan and re-index notes |
+| `save_note` | write | Create or update a note in the vault |
+| `save_decision` | write | Log a project decision |
+| `create_handoff` | write | Create a session handoff note |
 
 ## MCP Configuration
 
-Add to your MCP client config (Claude Desktop, Cursor, etc.):
+Add to your MCP client config (Claude Code, Cursor, Windsurf, Claude Desktop):
 
 ```json
 {
@@ -19,22 +45,38 @@ Add to your MCP client config (Claude Desktop, Cursor, etc.):
 }
 ```
 
+## Install
+
+```bash
+# Via npm/npx (downloads the Go binary automatically)
+npx -y @sgx-labs/same version
+
+# Or via shell script
+curl -fsSL https://statelessagent.com/install.sh | bash
+```
+
 ## CLI Usage
 
 ```bash
 # Initialize SAME in your project
-npx @sgx-labs/same init
+same init
 
 # Search your notes
-npx @sgx-labs/same search "authentication approach"
+same search "authentication approach"
 
 # Ask a question with cited answers
-npx @sgx-labs/same ask "what did we decide about the database schema?"
+same ask "what did we decide about the database schema?"
 
-# Check version
-npx @sgx-labs/same version
+# Try the interactive demo
+same demo
 ```
 
+## Privacy
+
+- ~10MB Go binary. SQLite + Ollama on localhost.
+- Zero outbound network calls. No telemetry. No analytics. No accounts. No API keys.
+- Your notes never leave your machine.
+
 ## Platform Support
 
 | Platform | Architecture | Status |
@@ -46,6 +88,11 @@ npx @sgx-labs/same version
 
 ## Links
 
-- [Main repository](https://github.com/sgx-labs/statelessagent)
-- [Documentation](https://github.com/sgx-labs/statelessagent#readme)
-- [Releases](https://github.com/sgx-labs/statelessagent/releases)
+- [Website](https://statelessagent.com)
+- [Documentation](https://statelessagent.com/docs)
+- [GitHub](https://github.com/sgx-labs/statelessagent)
+- [Discord](https://discord.gg/9KfTkcGs7g)
+
+## License
+
+BSL 1.1 — converts to Apache 2.0 on 2030-02-02.

npm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sgx-labs/same",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Persistent memory for AI coding agents. Local-first, SQLite + vector search. MCP server with 12 tools.",
   "homepage": "https://statelessagent.com",
   "repository": {