squish-memory 0.8.2 → 0.9.1

package/.claude-plugin/marketplace.json

@@ -6,8 +6,8 @@
   "plugins": [
     {
       "name": "squish",
-      "version": "0.6.0",
-      "description": "Production-ready two-tier memory system for Claude Code with 11 consolidated MCP tools. Always-visible core memory (persona, user info, project context, notes) + intelligent context paging. Advanced features: merge detection, semantic search, lifecycle management, bridge discovery. Features: 30-100x performance gains, automatic session hooks, privacy-first encryption, PostgreSQL team collaboration. Major consolidation: 39% fewer tools with same functionality.",
+      "version": "0.9.0",
+      "description": "The memory layer for AI agents. Give Claude Code persistent, intelligent memory with trigger detection, contradiction resolution, and hybrid search. Works with any MCP client.",
       "author": {
         "name": "michielhdoteth"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "squish",
-  "version": "0.6.0",
-  "description": "11 consolidated MCP tools for persistent two-tier memory system: core_memory, context_paging, merge, plus semantic search, lifecycle management, and intelligent context paging",
+  "version": "0.9.0",
+  "description": "The memory layer for AI agents - persistent, intelligent memory with trigger detection, contradiction resolution, and hybrid search",
   "author": {
     "name": "michielhdoteth",
     "url": "https://github.com/michielhdoteth"

package/.env.mcp

@@ -0,0 +1,30 @@
+# MCP Server Configuration
+SQUISH_MCP_PORT=8767
+SQUISH_MCP_SERVER_ENABLED=true
+
+# Embeddings - Hybrid mode for best quality
+SQUISH_EMBEDDINGS_PROVIDER=hybrid
+SQUISH_MULTIMODAL_EMBEDDINGS_ENABLED=true
+
+# Google Cloud Multimodal (1408-dim vectors)
+# Get API key from: https://console.cloud.google.com/apis/credentials
+GOOGLE_CLOUD_PROJECT=your-project-id
+GOOGLE_CLOUD_LOCATION=us-central1
+# GOOGLE_CLOUD_API_KEY=your-api-key
+# Or use service account:
+# GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
+
+# QMD for local markdown search
+SQUISH_QMD_ENABLED=true
+SQUISH_QMD_COLLECTIONS=./qmd-collections
+SQUISH_QMD_FALLBACK=hybrid
+
+# Managed Mode (Squish Cloud - optional)
+# SQUISH_MANAGED_MODE=true
+# SQUISH_MANAGED_API_URL=https://api.squish.dev
+# SQUISH_MANAGED_API_KEY=your-api-key
+
+# Lifecycle & Summarization
+SQUISH_LIFECYCLE_ENABLED=true
+SQUISH_SUMMARIZATION_ENABLED=true
+SQUISH_GOVERNANCE_ENABLED=true

package/.mcp.json

@@ -2,12 +2,9 @@
   "mcpServers": {
     "squish": {
       "command": "node",
-      "args": ["./dist/index.js"],
-      "cwd": "${CLAUDE_PLUGIN_ROOT}",
+      "args": ["dist/commands/mcp-server.js"],
       "env": {
-        "SQUISH_MODE": "local",
-        "NODE_ENV": "production",
-        "SQUISH_DATA_DIR": "${CLAUDE_WORKING_DIRECTORY}/.squish"
+        "NODE_ENV": "production"
       }
     }
   }

package/CHANGELOG.md

@@ -0,0 +1,111 @@
+# Changelog
+
+All notable changes to Squish will be documented in this file.
+
+## [0.9.1] - 2026-03-14
+
+### Fixed - CLI & Database
+- Fixed `core_memory` CLI command to properly create/resolve projects
+- Fixed SQLite schema initialization (was missing core_memory, observations, users tables)
+- Fixed database health check SQL syntax error
+- Fixed missing database migrations (recorded_at, retrieval_priority, etc.)
+
+### Fixed - MCP Integration
+- MCP verification now passes all checks
+- All 14 MCP tools properly registered and tested
+
+### Added - New Components
+- MCP client, server, standalone-server implementations
+- Memory modules: categorizer, conflict-detector, edit-workflow, progressive-disclosure
+- MCP config files for Claude Desktop, OpenClaw, OpenCode
+
+### Known Issues
+- `memory_associations` table not yet created (optional feature for graph traversal)
+- QMD optional (works without it)
+
+## [0.9.0] - 2026-02-28
+
+### Added - OpenClaw Self-Install
+
+#### Self-Install Command
+- `npx squish-memory install` - One-command OpenClaw setup
+- `squish install` - CLI command for self-installation
+- `squish health` - Service health check with JSON output option
+- `squish stats` - Memory statistics by project
+- Automatic mcporter.json configuration for MCP
+- Creates ~/.squish data directory automatically
+- Smart binary detection across platforms
+
+#### Updated Skill Files
+- `skills/squish-memory/SKILL.md` - v0.9.0 with self-install docs
+- `skills/squish-memory/install.mjs` - Node.js installer script
+- `skills/squish-memory/install.sh` - Bash fallback installer
+- `skills/squish-memory/mcp-config.json` - MCP config template
+
+### Added - Competitive Core Features
+
+#### Trigger Detection (`core/memory/trigger-detector.ts`)
+- Automatic detection of explicit memory triggers ("remember", "important", "don't forget")
+- Implicit signal detection (decisions, corrections, preferences, workflow rules, lessons)
+- Priority classification (high/normal) based on signal strength
+- Type inference for automatic memory classification
+
+#### Contradiction Resolution (`core/memory/contradiction-resolver.ts`)
+- Auto-detection of contradictions when writing new memories
+- Supersession logic for outdated information
+- Temporal contradiction detection (facts that are no longer valid)
+- Automatic archiving of superseded memories with traceability
+
+#### Write Gate Enforcement (`core/memory/write-gate.ts`)
+- Content validation before memory storage
+- Secret detection and sanitization integration
+- Quality scoring (0-100) for memory content
+- Contradiction pre-check integration
+
+#### Hybrid Scorer (`core/memory/hybrid-scorer.ts`)
+- Multi-factor relevance scoring (semantic, recency, coactivation, importance, confidence)
+- Trigger-aware confidence scoring
+- Customizable weight configuration
+- Score distribution analytics
+
+#### Retrieval Quality Telemetry (`core/memory/telemetry.ts`)
+- Echo/fizzle tracking for memory usage patterns
+- Telemetry-based retrieval boosting (0.5-2.0 factor)
+- Memory quality analytics
+- Automatic flush to database
+
+#### Temporal Facts Lifecycle (`core/memory/temporal-facts.ts`)
+- Temporal validity checking
+- Auto-supersession of outdated temporal facts
+- Expired fact cleanup job
+- Temporal fact statistics
+
+### Improved
+
+- **Memory Pipeline**: Integrated trigger detection and contradiction resolution in write path
+- **Hybrid Retrieval**: Entity-aware reranking with boost factors
+- **Worker Jobs**: Strengthened decay/dedup automation
+- **Test Coverage**: Added 24 new tests (145 total, up from 121)
+
+### Fixed
+
+- Worker.ts syntax errors (duplicate method declarations, missing braces)
+- AssociationType now includes 'duplicate' and 'merged' types
+- Logger calls properly typed in telemetry module
+- Memory metadata type definition for contradiction resolution
+
+## [0.8.2] - 2026-01-30
+
+### Added
+- Hybrid Search: BM25 + vector search with Reciprocal Rank Fusion
+- Importance Scoring: Auto-score memories with temporal decay
+- Consolidation: Summarize old, low-importance memory clusters
+- Core Memory: 2KB always-visible 4-section memory
+- Context Paging: Token budgeting (8KB budget)
+- CLI fallback mode when MCP fails
+- 16 MCP tools for Claude Code integration
+
+### Technical
+- SQLite with FTS5 for local mode
+- PostgreSQL + pgvector for team mode
+- Drizzle ORM for database abstraction

package/QUICK-START.md

@@ -0,0 +1,65 @@
+# Squish - Quick Start
+
+Universal two-tier memory for any AI agent.
+
+## Start in 30 seconds
+
+```bash
+# 1. Install
+bun install
+
+# 2. Build
+bun run build
+
+# 3. Start MCP server (works with Claude Code, OpenClaw, or any MCP client)
+bun run mcp
+
+# ✓ Running on http://localhost:8767
+```
+
+## Test it
+
+```bash
+# Health check
+curl http://localhost:8767/health
+
+# Expected output:
+{
+  "status": "ok",
+  "server": "squish-mcp",
+  "version": "0.9.0",
+  "tools": 6
+}
+```
+
+## Use it
+
+```bash
+# Search memories
+curl -X POST http://localhost:8767/tools/call \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "squish_search",
+    "arguments": {
+      "query": "authentication"
+    }
+  }'
+```
+
+## Configure
+
+Copy `.env.mcp` to `.env` and customize:
+
+```bash
+cp .env.mcp .env
+```
+
+Key settings:
+
+- **SQUISH_MCP_PORT**: Server port (default: 8767)
+- **SQUISH_EMBEDDINGS_PROVIDER**: local|google-multimodal|hybrid
+- **SQUISH_QMD_ENABLED**: Enable markdown search (true/false)
+
+## Full Docs
+
+See [docs/MCP-SERVER.md](docs/MCP-SERVER.md)