Changelog

Version history and release notes for ContextVault.

v1.9.0 + MCP v2.0.0 (Latest)

Released: March 6, 2026

MCP Server v2.0.0 — Major Refactor

• McpServer + registerTool API: Migrated from deprecated Server + setRequestHandler to modern SDK pattern
• Zod input schemas: Runtime validation on all 23 tools with typed parameters
• Tool annotations: Every tool declares readOnlyHint, destructiveHint, idempotentHint, openWorldHint
• structuredContent: ctx_status returns machine-readable vault stats alongside text
• Self-contained descriptions: Every tool description works standalone with any AI client (Cursor, Windsurf, Cline, OpenCode)
• MCP Resources: registerResource with ResourceTemplate for contextvault://doc/{id}
• SDK upgraded to @modelcontextprotocol/sdk ^1.6.1, added zod ^3.23.8

Slash Commands Rewrite

• Rewrote all 23 /ctx-* commands: ~3,400 → ~477 total lines
• All commands now delegate to MCP tools instead of manual file operations
• Trigger-optimized descriptions for Claude's skill auto-triggering system
• Consistent wording between slash commands (Claude-optimized) and MCP tools (client-agnostic)

v1.8.8 + MCP v1.0.8

Released: February 8, 2026

CLI UX & Quality (MCP v1.0.8)

• CLI UX: TTY detection — shows informative banner when run in terminal (instead of silent hang)
• CLI flags: --version/-v, --help/-h, --check-update for version management
• Dynamic version: Version read from package.json at runtime (no more hardcoded strings)
• Health score breakdown: Per-category scoring table (Index Consistency, File Integrity, Size Compliance, Code Drift)
• Smarter merge suggestions: Compares actual content keywords, not just topic type prefix
• 54 tests, all pass (up from 49)

v1.8.7 + MCP v1.0.7

Released: February 8, 2026

Bug Fixes (MCP v1.0.7)

• Health check: No longer flags archived entries as "missing file"
• Health check: Respects mode setting — skips global vault in local mode
• Code drift: Filters false positives (JS globals, URLs, example paths)
• Review tool: Only counts active documents, not archived
• Added parseActiveEntries() for accurate active-only queries
• 49 tests (up from 46), npm README added

Feature Consolidation (28 → 23 commands)

Merged overlapping features into /ctx-doc with a type parameter:

• /ctx-snippet → /ctx-doc type=snippet (defaults to global vault)
• /ctx-intel → /ctx-doc type=intel
• /ctx-note → /ctx-update section="Notes"
• /ctx-explain → Removed (use /ctx-doc)
• /ctx-ask → Use /ctx-search + /ctx-read

New: AI Agent Documentation

• docs/skill.md: Comprehensive documentation for AI agents
• All 23 commands with parameters and examples
• Best practices and workflows

Technical

• 46 tests, all pass
• Net code reduction: -469 lines

v1.8.6 + MCP v1.0.4

Released: February 6, 2026

New: 3 Commands (then 28 total)

• /ctx-archive: Archive deprecated docs to archive/ folder with reason header
• /ctx-review: Weekly curation review — finds stale docs, suggests merges, identifies archive candidates
• /ctx-ask: Natural language Q&A (removed in v1.8.7)

Enhanced: Code-Drift Detection

• /ctx-health now detects broken file references in docs
• Checks if referenced files still exist
• Validates line numbers are within file bounds
• Flags docs needing updates when codebase changes

Enhanced: Semantic Clustering

• Research tracking now categorizes by domain (frontend, backend, database, testing, config, etc.)
• Cross-domain exploration weighted higher (1.0x to 2.0x)
• Exploring frontend + backend + database triggers reminders sooner than same-domain exploration
• Research reminders now show domains explored

Technical

• 45 tests (up from 42), all pass
• 10 domain categories for semantic clustering
• Native hooks updated with domain categorization

v1.8.5 + MCP v1.0.3

Released: February 2026

New: Research Insight Detection

• Second enforcement axis: Research tracking alongside edit tracking
• Tracks Read, Grep, Glob, WebSearch, WebFetch tool usage
• Non-blocking nudges when significant exploration happens without documentation
• Suggests /ctx-doc type=intel to capture findings
• MCP v1.0.3: Same research tracking for ctx_search/ctx_read calls

Thresholds

• Balanced: 10 actions + 4 areas + 10 min since last doc (all must be true)
• Strict: 6 actions + 3 areas + 5 min since last doc
• Native: 2x MCP thresholds (20/5 vs 10/4) to handle Read/Grep burst patterns
• Light mode: Research reminders completely disabled

Technical

• Stop hook now includes research stats in session summary
• Research becomes a significance factor (15+ lookups / 5+ areas)
• 8 new integration tests (42 total, all pass)

MCP Server v1.0.2

Released: February 2026

New: MCP Server

• ContextVault now works with any MCP-compatible AI tool via npx contextvault-mcp
• Supported: Claude Code, Cursor, Windsurf, OpenCode, Cline, Continue, Copilot CLI
• 25 MCP tools mirroring all /ctx-* commands
• 4 MCP resources for auto-context (indexes, settings, instructions)
• Server-side enforcement engine (no hooks needed)
• Auto-detects existing .claude/vault/ — zero migration for bash installer users
• Legacy import: ctx_import copies from .claude/vault/ to .contextvault/

npm

• Package: contextvault-mcp
• v1.0.0 — Initial release (25 tools, 4 resources)
• v1.0.1 — Fixed legacy import overwriting index
• v1.0.2 — Auto-detect .claude/vault/ paths, zero-conflict with bash installer
• v1.0.3 — Research insight detection (trackResearch, getResearchReminder)
• v1.0.4 — 3 new tools (ctx_archive, ctx_review, ctx_ask), code-drift detection, semantic clustering
• v1.0.5 — Feature consolidation (28 → 23 tools), ctx_doc with type parameter
• v1.0.6 — Added README for npm display
• v1.0.7 — Health/review bug fixes, parseActiveEntries, false positive filters
• v1.0.8 — CLI UX (TTY detection, --version, --help, --check-update), health score breakdown, smarter merge suggestions
• v2.0.0 — BREAKING: McpServer + registerTool, Zod schemas, tool annotations, structuredContent, self-contained descriptions

v1.8.4

Released: February 2026

New Features

• Native Windows PowerShell installer (install-contextvault.ps1)
• Cross-platform installation support (macOS, Linux, Windows)
• Marketing website at ctx-vault.com
• Full documentation site

Improvements

• Optimized CLAUDE.md from 775 to 221 lines
• Better OS detection for install instructions

v1.8.3

Released: February 2026

New Features

• Configurable enforcement levels: light, balanced, strict
• New command: /ctx-mode enforcement [level]

Changes

• Default enforcement changed to balanced
• Settings stored in ~/.claude/vault/settings.json

v1.8.2

Released: February 2026

Improvements

• Smart blocking at session end only for significant undocumented work
• Improved detection of meaningful vs. trivial edits

v1.8.1

Released: February 2026

Changes

• Completion-triggered reminders (TodoWrite + git commit only)
• Reduced hook noise during normal work

v1.8.0

Released: February 2026

Major Release: "Remind, Don't Block"

• Non-blocking milestone-based enforcement
• Hooks suggest documentation but don't prevent work
• Only session-end Stop hook can block (if significant work)

v1.7.6

Released: February 2026

Improvements

• Hook deduplication prevents duplicate reminders
• Smarter /ctx-bootstrap detection

v1.7.5

Released: February 2026

New Features

• New command: /ctx-bootstrap — Auto-scan and document entire codebase
• Creates architecture doc + feature docs automatically
• Optional --interactive flag to review each doc

v1.7.4

Released: January 2026

Bug Fixes

• Fixed Stop enforcer session fallback issue

v1.7.3

Released: January 2026

Documentation

• Added APPEND vs ARCHIVE decision tree
• Clear examples for when to preserve vs. archive content

v1.7.2

Released: January 2026

Core Rule Added

• APPEND, NEVER REPLACE rule prevents information loss
• History sections now properly preserved

v1.7.1

Released: January 2026

New Features

• New command: /ctx-plan for multi-step task tracking
• Archive mechanism for deprecated content

v1.7.0

Released: January 2026

Major Release: Smart Detection

• Automatic suggestion of the right command based on work type
• Bug fix? Suggests /ctx-error
• Decision made? Suggests /ctx-decision

v1.6.x

Released: January 2026

Highlights

• v1.6.9: BLOCKING PreToolUse mid-session enforcement
• v1.6.8: More aggressive Stop hook enforcement
• v1.6.7: BLOCKING Stop hook forces documentation
• v1.6.0: Added 6 new commands (health, note, changelog, link, quiz, explain)

Earlier Versions

Upgrade Instructions

To upgrade to the latest version, re-run the installer:

# macOS/Linux
curl -sL https://ctx-vault.com/install | bash

# Windows PowerShell
irm https://ctx-vault.com/install.ps1 | iex