ShapeLex v0.6.0

Professional Fingerprint MCP

ShapeLex v0.6.0 turns the original prototype into a deterministic, local-first retrieval system for long AI coding sessions.

Highlights

• Deterministic Unicode-aware lexical fingerprints, rolling hashes, O(n) winnowing, and offset voting.
• Exact matches require both raw UTF-8 byte equality and a full SHA-256 verification.
• Recognition of exact, relocated, reordered, and closely related text.
• English and Spanish critical-difference protection for negations, numbers, dates, operators, destructive verbs, and instructions.
• Lazy, bounded, memory-only fingerprint index with suppression limits and LRU eviction.
• Transactional store v2 with migration, revisions, locking, atomic writes, and content-addressed sources.
• Compact match metadata through the existing MCP tools, without expanding the public tool surface.
• Node.js 22+ support and expanded property, acceptance, torture, performance, mutation, packaging, platform, and security verification.

Install or verify

npx -y shapelex-mcp@0.6.0 --doctor

ShapeLex remains local-only by default, has zero runtime npm dependencies, and preserves exact expansion through sx:// handles.

See the full changelog and the quick start.

ShapeLex v0.5.0

ShapeLex 0.5.0 turns the initial prototype into a safer, lower-overhead local memory layer.

Highlights

• Added cumulative per-session compression telemetry with an explicit heuristic-estimator label.
• Added workspace-bound file-backed compression through shapelex_compress_text.sourcePath.
• Added checksum-verified expansion so changed source files invalidate stale handles.
• Removed server-only word-shape and fingerprint data from model-facing responses.
• Added explicit truncation and source-offset metadata for critical previews.
• Reduced duplicated MCP response text for compression, context, and expansion.
• Compacted persistent file-backed indexes without storing a second full source copy.
• Added true memory-only operation with SHAPELEX_PERSIST=0.
• Enforced store-size limits before writes and cleaned failed temporary writes.

Install

npm install shapelex-mcp@0.5.0

The published npm package was verified through a clean installation and its doctor command.

ShapeLex v0.4.0

ShapeLex v0.4.0 is the first public npm release.

Highlights:

• Published npm package: shapelex-mcp@0.4.0
• Lean MCP toolset for Codex, Claude Code, and Cursor
• Agent-driven ShapeLex usage instructions
• shapelex_context for one-call compact task context
• Smoke, end-to-end, benchmark, and agent adoption simulations
• Cross-platform shapelex-mcp --doctor
• Local-only storage with .shapelex* gitignore protection
• English and Spanish setup documentation

Simulation examples from the deterministic test suite:

• Smoke task: 2160 raw prompt tokens vs 699 with ShapeLex, about 67.6% fewer prompt tokens
• End-to-end lean mode: 6573 raw prompt tokens vs 2148 with ShapeLex, about 67.3% fewer prompt tokens
• Full mode including tool schema: 4722 loaded tokens, about 27.9% fewer than raw

Install:

npx -y shapelex-mcp --doctor

Note: simulation results are deterministic examples, not a universal promise. Real savings depend on context size, AI app, active toolset, and agent behavior.