Commit graph

120 commits

Author SHA1 Message Date
Sam Valladares
a6ba67884d docs: professionalize data storage warning section
Replace casual tone with clear risk assessment table and
professional recommendations.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 01:48:16 -06:00
Sam Valladares
086cc2fa2c chore: bump version to 1.1.0
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 01:44:30 -06:00
Sam Valladares
3023e58ce3 docs: add What's New in v1.1 section at top of README
Highlights v1.1 features prominently:
- Tool consolidation (29 → 8)
- New CLI binary commands
- Documentation improvements
- Backward compatibility note

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 01:41:34 -06:00
Sam Valladares
3ac85eeff4 docs: add version pinning and release tags documentation
- Document how to pin to specific versions
- List available versions (v1.0.0, v1.1.0)
- Add version check command

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 01:37:55 -06:00
Sam Valladares
36244f3c95 docs(faq): clarify Vestige vs Claude native memory compatibility
Address common question: users don't need to disable Claude's native
memory to use Vestige. They're independent systems that can run
simultaneously.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 01:34:56 -06:00
Sam Valladares
8bb6500985 feat(v1.1): consolidate 29 tools → 8 unified tools + CLI
Tool Consolidation:
- search: merges recall, semantic_search, hybrid_search
- memory: merges get_knowledge, delete_knowledge, get_memory_state
- codebase: merges remember_pattern, remember_decision, get_codebase_context
- intention: merges all 5 intention tools into action-based API

New CLI Binary:
- vestige stats [--tagging] [--states]
- vestige health
- vestige consolidate
- vestige restore <file>

Documentation:
- Verify all neuroscience claims against codebase
- Fix Memory States table: "Retention" → "Accessibility" with formula
- Clarify Spreading Activation: embedding similarity vs full network module
- Update Synaptic Tagging: clarify 9h/2h implementation vs biology
- Add comprehensive FAQ with 30+ questions
- Add storage modes: global, per-project, multi-Claude household
- Add CLAUDE.md setup instructions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 01:31:58 -06:00
Sam Valladares
29130c3068 fix: accurate science claims, security docs, remove hardcoded path
## Changes

### README.md
- Fix FSRS-6 formula: power law (not exponential Ebbinghaus)
- Correct formula: R(t,S) = (1 + factor × t/S)^(-w₂₀)
- Honest "The Science" table showing what's fully implemented vs inspired
- Added / indicators for implementation accuracy
- Transparency note about honest marketing

### demo.sh
- Remove hardcoded /Users/entity002 path (security/privacy)
- Use relative path with fallback: ${VESTIGE:-$(dirname "$0")/...}

### SECURITY.md (new)
- Document trust model and security boundaries
- Explain data storage locations
- List input validation measures
- Security contact process

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 20:29:37 -06:00
Sam Valladares
3a4a19fa20 docs: add comprehensive data backup warnings
- Detail what causes data loss (delete, corrupt, lost device)
- Clarify "For AI memory = fine, For critical data = not fine"
- Add automated cron job backup example
- Mention Time Machine / Windows Backup as options

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 20:00:51 -06:00
Sam Valladares
bd41ec3388 docs: comprehensive README rewrite
- Add one-liner CLI install (claude mcp add vestige vestige-mcp)
- Document first-run network requirement (~130MB model download)
- Add data storage locations and backup instructions
- Reorganize all 29 tools into clear tables
- Add troubleshooting section
- Honest framing of neuroscience claims

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 19:49:36 -06:00
Sam Valladares
7440f21402 Add vestige-restore binary for backup restoration 2026-01-25 13:52:01 -06:00
Sam Valladares
f4842a12c1 Remove comparison section from README 2026-01-25 13:34:36 -06:00
Sam Valladares
dbb1c7bb3b Remove comparison column from Why Vestige section 2026-01-25 13:33:33 -06:00
Sam Valladares
a4d14f268c Update README with improved installation guide and 29 tools
- Simple 4-step Quick Start (2 minutes)
- Global install instructions (sudo cp to /usr/local/bin)
- Claude Code and Claude Desktop config examples
- Full 29-tool reference with descriptions
- Prediction Error Gating section with visual diagram
- Troubleshooting section
- Updating instructions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 13:31:37 -06:00
Sam Valladares
bbd1c15b4a Add Prediction Error Gating and smart_ingest tool (26 tools total)
Implements neuroscience-inspired memory gating based on prediction error:
- New smart_ingest MCP tool that auto-decides CREATE/UPDATE/SUPERSEDE
- PredictionErrorGate evaluates semantic similarity vs existing memories
- Automatically supersedes demoted memories with similar new content
- Reinforces near-identical memories instead of creating duplicates
- Adds promote_memory/demote_memory/request_feedback tools

Thresholds:
- >0.92 similarity = Reinforce existing
- >0.75 similarity = Update/Merge
- <0.75 similarity = Create new
- Demoted + similar = Auto-supersede

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 13:30:03 -06:00
Sam Valladares
5337efdfa7 Switch embedding model from BGE to nomic-embed-text-v1.5
- Replace BGE-base-en-v1.5 with nomic-embed-text-v1.5
- 8192 token context window (vs 512 for BGE)
- Matryoshka representation learning support
- Fully open source with training data released
- Same 768 dimensions, no schema changes required

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 03:11:15 -06:00
Sam Valladares
449d60754a Replace all engram references with vestige
Updated TypeScript packages, npm package, and config files.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:44:11 -06:00
Sam Valladares
d9b762030e Fix CI: correct test names and remove undefined benchmarks
- Fix journey_tests (was 'journeys')
- Remove benchmarks job (no benchmarks defined)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:41:40 -06:00
Sam Valladares
b1f593dd67 Remove cognitive science and extreme validation tests for v1.0
Will be added in a later release.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:40:37 -06:00
Sam Valladares
042ec15467 Fix CI: Update package names from engram to vestige
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:39:30 -06:00
Sam Valladares
f9c60eb5a7 Initial commit: Vestige v1.0.0 - Cognitive memory MCP server
FSRS-6 spaced repetition, spreading activation, synaptic tagging,
hippocampal indexing, and 130 years of memory research.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 01:31:03 -06:00