squish-memory 1.0.2 → 1.1.5

package/.env.example

@@ -0,0 +1,130 @@
+# Squish Environment Configuration
+# Copy this file to .env and customize as needed
+
+# =============================================================================
+# MODE (default: local)
+# =============================================================================
+# local  - SQLite database, TF-IDF embeddings (no API key needed)
+# remote - PostgreSQL + Redis, provider-backed embeddings
+
+SQUISH_MODE=local
+
+# =============================================================================
+# DATABASE (remote mode only)
+# =============================================================================
+DATABASE_URL=postgres://squish:squish_dev@localhost:5432/squish
+REDIS_URL=redis://localhost:6379
+
+# =============================================================================
+# LOCAL MODE DATA DIRECTORY
+# =============================================================================
+SQUISH_DATA_DIR=./.squish
+
+# =============================================================================
+# MCP SERVER
+# =============================================================================
+SQUISH_MCP_PORT=8767
+SQUISH_MCP_SERVER_ENABLED=false
+
+# CORS (comma-separated origins, * wildcard for port)
+# SQUISH_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:8080
+
+# =============================================================================
+# EMBEDDINGS PROVIDER
+# =============================================================================
+# Options: local | openai | ollama | google | none | auto
+# local = TF-IDF (no API key needed)
+# auto  = Try OpenAI > Ollama > Google > local fallback
+SQUISH_EMBEDDINGS_PROVIDER=local
+
+# OpenAI (required for cloud embeddings)
+# SQUISH_OPENAI_API_KEY=sk-...
+# SQUISH_OPENAI_API_URL=https://api.openai.com/v1/embeddings
+# SQUISH_OPENAI_EMBEDDING_MODEL=text-embedding-3-small
+
+# Ollama
+# SQUISH_OLLAMA_URL=http://localhost:11434
+# SQUISH_OLLAMA_EMBEDDING_MODEL=nomic-embed-text:v1.5
+
+# Google Cloud
+# 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
+# SQUISH_GOOGLE_EMBEDDING_MODEL=gemini-embedding-001
+
+# Embedding reliability
+SQUISH_EMBEDDINGS_TIMEOUT_MS=30000
+SQUISH_EMBEDDINGS_MAX_RETRIES=3
+SQUISH_EMBEDDINGS_RETRY_DELAY_MS=1000
+
+# =============================================================================
+# QMD (local markdown search)
+# =============================================================================
+SQUISH_QMD_ENABLED=false
+# SQUISH_QMD_COLLECTIONS=./qmd-collections
+# SQUISH_QMD_FALLBACK=hybrid
+
+# =============================================================================
+# LIFECYCLE & MEMORY
+# =============================================================================
+SQUISH_LIFECYCLE_ENABLED=true
+SQUISH_SUMMARIZATION_ENABLED=true
+SQUISH_GOVERNANCE_ENABLED=true
+
+# Memory tier decay (v1.1.0+)
+# Threshold for tier demotion: memories below this score get demoted (default: 0.1)
+# SQUISH_DECAY_THRESHOLD=0.1
+# Decay job cron schedule (default: hourly)
+# SQUISH_LIFECYCLE_DECAY_CRON=0 * * * *
+
+# =============================================================================
+# ENCRYPTION (v1.1.0+)
+# =============================================================================
+# Client-side AES-256-GCM encryption for memory content
+# Set passphrase to enable encryption (requires existing memories to be re-encrypted)
+# SQUISH_ENCRYPTION_PASSPHRASE=your-secure-passphrase
+
+# Core memory limits (v0.9.2+)
+# SQUISH_CORE_MEMORY_TOTAL_BYTES=16384
+# SQUISH_CORE_MEMORY_SECTION_BYTES=4096
+
+# =============================================================================
+# SUPABASE / NEON (v1.1.0+)
+# =============================================================================
+# Remote PostgreSQL backend (use either Supabase OR Neon, not both)
+# SUPABASE_URL=https://your-project.supabase.co
+# SUPABASE_SERVICE_KEY=your-service-key
+# NEON_PROJECT_ID=your-neon-project-id
+# NEON_SERVICE_KEY=your-service-key
+
+# =============================================================================
+# GRAPH BOOST (v1.1.0+)
+# =============================================================================
+# Scoring weight for graph boost in recall (default: 1.5)
+# Higher = more influence from memory associations
+# SQUISH_WEIGHT_GRAPH_BOOST=1.5
+
+# =============================================================================
+# MANAGED MODE (Squish Cloud)
+# =============================================================================
+# SQUISH_MANAGED_MODE=false
+# SQUISH_MANAGED_API_URL=https://api.squish.dev
+# SQUISH_MANAGED_API_KEY=your-api-key
+
+# =============================================================================
+# REMOTE AUTH
+# =============================================================================
+# Token-based auth (primary)
+# SQUISH_REMOTE_TOKEN=
+
+# OAuth (optional)
+# SQUISH_OAUTH_AUTH_URL=
+# SQUISH_OAUTH_TOKEN_URL=
+# SQUISH_OAUTH_CLIENT_ID=
+
+# =============================================================================
+# OPENCLAW GATEWAY
+# =============================================================================
+OPENCLAW_GATEWAY_ENABLED=false

package/CHANGELOG.md

@@ -2,6 +2,61 @@
 
 All notable changes to Squish will be documented in this file.
 
+## [1.1.5] - 2026-04-11
+
+### Added - Release Prep Enhancements
+- **New environment variables**: SQUISH_ENCRYPTION_PASSPHRASE, SQUISH_DECAY_THRESHOLD, SQUISH_LIFECYCLE_DECAY_CRON, SUPABASE_URL, SUPABASE_SERVICE_KEY, NEON_PROJECT_ID, NEON_SERVICE_KEY, SQUISH_WEIGHT_GRAPH_BOOST
+- **PostgreSQL schema**: Added memory_associations, namespaces, and maintenance_jobs tables for full parity with SQLite
+- **Release workflow**: Fixed test step to skip when no tests configured
+
+### Added - Wiki Storage
+- **Memory storage module**: New core/memory/markdown/markdown-storage.ts for memory file storage
+- **Memory hooks**: New core/memory/hooks.ts for memory lifecycle hooks
+
+### Changed - Version Bump
+- Updated all version references from 1.1.0 to 1.1.5
+
+## [1.1.0] - 2026-03-28
+
+### Changed - Launch Surface Cleanup
+- Removed legacy CLI commands `observe` and `projects`
+- Removed legacy MCP tools `squish_observe` and `squish_projects`
+- `squish learn` is now the single capture path for `success`, `failure`, `fix`, and `observation`
+- `squish context --list-projects` is now the single project discovery path
+- Launch docs and help now reflect the final 18-tool MCP surface
+
+## [1.1.0-enhanced] - 2026-03-27
+
+### Added - Security & Encryption
+- **Client-side encryption**: AES-256-GCM encryption for sensitive memories
+- **Optional encryption**: Controlled via `SQUISH_ENCRYPTION_PASSPHRASE` env var
+- **Encryption MCP tools**:
+  - `squish_set_passphrase`: Set encryption passphrase (writes to `.squish/.env`)
+  - `squish_rotate_key`: Rotate passphrase and re-encrypt all memories
+- **New schema columns**: `encrypted_content`, `encryption_nonce`, `is_encrypted`, `status`
+
+### Added - Graph-Boosted Retrieval
+- **Graph associations**: Memories linked by coactivation count
+- **Boost computation**: `weight * coactivationCount` per association
+- **Hybrid search integration**: Graph boost added to RRF scoring
+- **Configurable weight**: `SQUISH_WEIGHT_GRAPH_BOOST` (default: 1.5)
+
+### Added - Memory Lifecycle
+- **Decay scheduler**: Automatic tier promotion/demotion based on importance
+- **Tier system**: hot → warm → cold → expired
+- **Cron-based**: Configurable via `SQUISH_LIFECYCLE_DECAY_CRON`
+- **New schema columns**: `status`, `decay_rate`, `last_decay_at`
+
+### Added - Supabase Backend Support
+- **PostgreSQL via Supabase**: New backend option
+- **Auto-detection**: Uses Supabase when `SUPABASE_URL` and `SUPABASE_SERVICE_KEY` are set
+- **Drizzle ORM**: Full compatibility with existing queries
+
+### Changed - Memory Types
+- Replaced `jot` type with `note`
+- Added `reflection` type
+- Updated categorizer, merge strategies, and two-stage detector
+
 ## [1.0.0] - 2026-03-17
 
 ### 🚀 Major Release - Universal Plugin Architecture