squish-memory 1.1.5 → 1.2.1

package/config/plugin-manifest.schema.json

@@ -1,244 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "Squish Universal Plugin Manifest",
-  "description": "Universal plugin manifest for Squish memory system across all AI assistant clients",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "id",
-    "name",
-    "version",
-    "description",
-    "capabilities",
-    "targets",
-    "dependencies",
-    "auth"
-  ],
-  "properties": {
-    "id": {
-      "type": "string",
-      "pattern": "^@squish/(memory|plugin)-[a-z0-9-]+$",
-      "description": "Unique plugin identifier in @squish/ scope"
-    },
-    "name": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Human-readable plugin name"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Semantic version (major.minor.patch)"
-    },
-    "description": {
-      "type": "string",
-      "minLength": 10,
-      "description": "Short description of the plugin"
-    },
-    "capabilities": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["mcp", "cli", "web", "hooks"]
-      },
-      "minItems": 1,
-      "description": "What capabilities this plugin provides"
-    },
-    "targets": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "required": ["type"],
-        "properties": {
-          "type": {
-            "type": "string",
-            "enum": ["mcp", "hooks", "plugin-slot"]
-          },
-          "slot": {
-            "type": "string",
-            "description": "Plugin slot name (for plugin-slot type)"
-          },
-          "tools": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "List of tools this plugin exposes (for mcp type)"
-          },
-          "hooks": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "enum": [
-                "SessionStart",
-                "UserPromptSubmit",
-                "PostToolUse",
-                "SessionEnd",
-                "onInstall"
-              ]
-            },
-            "description": "List of hooks to register (for hooks type)"
-          },
-          "configPath": {
-            "type": "string",
-            "description": "Relative path to client config file"
-          },
-          "install": {
-            "type": "object",
-            "properties": {
-              "copy": {
-                "type": "array",
-                "items": {
-                  "type": "object",
-                  "required": ["from", "to"],
-                  "properties": {
-                    "from": { "type": "string" },
-                    "to": { "type": "string" }
-                  }
-                }
-              },
-              "merge": {
-                "type": "object",
-                "properties": {
-                  "file": { "type": "string" },
-                  "strategy": { "type": "string", "enum": ["deep-merge", "replace"] }
-                }
-              },
-              "command": {
-                "type": "string",
-                "description": "Custom install command to run"
-              }
-            }
-          },
-          "verify": {
-            "type": "object",
-            "properties": {
-              "command": { "type": "string" },
-              "fileExists": { "type": "string" },
-              "toolCheck": { "type": "string" }
-            }
-          }
-        }
-      },
-      "minProperties": 1,
-      "description": "Client-specific configurations"
-    },
-    "dependencies": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "required": ["version", "autoInstall"],
-        "properties": {
-          "version": {
-            "type": "string",
-            "description": "Pinned version (e.g., '1.2.0')"
-          },
-          "autoInstall": {
-            "type": "boolean",
-            "description": "Whether to auto-install if missing"
-          },
-          "optional": {
-            "type": "boolean",
-            "default": false,
-            "description": "Whether this dependency is optional"
-          },
-          "provides": {
-            "type": "array",
-            "items": { "type": "string" },
-            "description": "List of capabilities this dependency provides"
-          }
-        }
-      },
-      "description": "Runtime dependencies with version pinning"
-    },
-    "auth": {
-      "type": "object",
-      "required": ["modes", "default"],
-      "properties": {
-        "modes": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "enum": ["none", "token", "oauth"]
-          },
-          "minItems": 1,
-          "description": "Supported authentication modes"
-        },
-        "default": {
-          "type": "string",
-          "enum": ["none", "token", "oauth"],
-          "description": "Default auth mode"
-        },
-        "token": {
-          "type": "object",
-          "properties": {
-            "envVar": { "type": "string" },
-            "help": { "type": "string" }
-          }
-        },
-        "oauth": {
-          "type": "object",
-          "properties": {
-            "providers": {
-              "type": "array",
-              "items": { "type": "string", "enum": ["github", "google", "anthropic"] }
-            }
-          }
-        }
-      }
-    },
-    "pinning": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "string"
-      },
-      "description": "Compatibility matrix for all dependencies"
-    },
-    "entry": {
-      "type": "object",
-      "properties": {
-        "mcp": {
-          "type": "string",
-          "description": "Path to MCP server entry point (for mcp capability)"
-        },
-        "plugin": {
-          "type": "string",
-          "description": "Path to plugin entry point (for plugin-slot type)"
-        },
-        "cli": {
-          "type": "string",
-          "description": "Path to CLI binary (for cli capability)"
-        }
-      }
-    },
-    "compatibility": {
-      "type": "object",
-      "properties": {
-        "minNodeVersion": { "type": "string" },
-        "maxNodeVersion": { "type": "string" },
-        "clients": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "id": { "type": "string" },
-              "minVersion": { "type": "string" },
-              "maxVersion": { "type": "string" }
-            }
-          }
-        }
-      }
-    },
-    "healthCheck": {
-      "type": "object",
-      "properties": {
-        "mcpTool": {
-          "type": "string",
-          "description": "Tool name to call for health check"
-        },
-        "httpEndpoint": {
-          "type": "string",
-          "description": "HTTP endpoint for health check"
-        }
-      }
-    }
-  }
-}

package/config/plugin.json

@@ -1,32 +0,0 @@
-{
-  "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",
-  "author": {
-    "name": "michielhdoteth",
-    "url": "https://github.com/michielhdoteth"
-  },
-  "license": "MIT",
-  "homepage": "https://github.com/michielhdoteth/squish#readme",
-  "repository": "https://github.com/michielhdoteth/squish.git",
-   "commands": "./core/commands/",
-   "mcpServers": "./mcp.json.example",
-  "keywords": [
-    "claude",
-    "claude-code",
-    "claude-plugin",
-    "mcp-server",
-    "memory",
-    "persistent-memory",
-    "core-memory",
-    "context-management",
-    "semantic-search",
-    "full-text-search",
-    "local-first",
-    "privacy",
-    "agent-memory",
-    "slash-commands",
-    "two-tier-architecture",
-    "model-context-protocol"
-  ]
-}

package/config/remote-memory-policy.json

@@ -1,32 +0,0 @@
-{
-  "version": 1,
-  "mode": "remote",
-  "tenancy": {
-    "isolation": "project-and-user",
-    "defaultVisibility": "private",
-    "allowedVisibility": ["private", "project", "global"]
-  },
-  "retention": {
-    "hotDays": 30,
-    "warmDays": 180,
-    "coldArchiveDays": 730
-  },
-  "search": {
-    "hybrid": true,
-    "bm25": true,
-    "semantic": true,
-    "defaultLimit": 10,
-    "maxLimit": 50
-  },
-  "governance": {
-    "secretFiltering": true,
-    "mergeReviewRequired": true,
-    "auditSnapshots": true
-  },
-  "auth": {
-    "primary": "token",
-    "secondary": "oauth",
-    "requiredEnv": ["SQUISH_REMOTE_TOKEN"]
-  },
-  "requiredEnv": ["DATABASE_URL", "REDIS_URL", "SQUISH_REMOTE_TOKEN"]
-}

package/core/commands/context-paging.md

@@ -1,51 +0,0 @@
----
-description: Manage working set (load, evict, or view loaded memories)
----
-
-# Context Paging Management
-
-Manage your working set of memories for context tracking. Note: Claude manages its own context and token usage. These tools track which memories you're actively working with.
-
-## Actions
-
-### load
-Add a memory to your working set for active tracking.
-- Marks memory as currently relevant
-- Helps organize which memories are in your active consideration set
-- Does not affect Claude's actual context usage
-
-### evict
-Remove a memory from your working set.
-- Removes from your active tracking set
-- Memory is still stored and searchable
-- Useful when memory is no longer actively relevant
-
-### view
-View all memories currently in your working set.
-- Shows all memories you're actively tracking
-- Displays session ID and timestamp loaded
-- Lists memory content and metadata
-
-## Usage Examples
-
-Load a memory to working set:
-```
-/context-paging action=load sessionId=sess-123 memoryId=mem-uuid-456
-```
-
-Evict memory from working set:
-```
-/context-paging action=evict sessionId=sess-123 memoryId=mem-uuid-456
-```
-
-View all loaded memories in session:
-```
-/context-paging action=view sessionId=sess-123
-```
-
-## Important Notes
-
-- Working set is per-session - each Claude Code session has its own working set
-- Claude Code manages its own context window automatically
-- These tools are for your own organizational purposes
-- Memory removal from working set does not delete the memory permanently

package/core/commands/context-status.md

@@ -1,22 +0,0 @@
-# Context Status
-
-View working set status and core memory usage.
-
-## Usage
-```
-/context-status
-```
-
-## What it shows
-- **Core Memory**: Size usage and percentage
-- **Working Set**: How many memories you've loaded
-- **Available**: Total memories and observations in the database
-
-**Note**: Claude manages its own context and token limits intelligently. This shows what memories you've loaded into your working set for organization.
-
-## Example
-```
-/context-status
-```
-
-Provides a comprehensive view of your memory system state.

package/core/commands/context.md

@@ -1,5 +0,0 @@
----
-description: Get project context with relevant memories
----
-
-Retrieve project context by fetching relevant memories and observations. Automatically finds memories associated with the current project and task.

package/core/commands/core-memory.md

@@ -1,56 +0,0 @@
----
-description: Manage core memory (view, edit, or append to always-in-context sections)
----
-
-# Core Memory Management
-
-Manage always-in-context core memory sections: view all sections, edit a specific section, or append text to a section.
-
-## Actions
-
-### view
-View all core memory sections and statistics.
-- Displays all 4 sections: persona, user_info, project_context, working_notes
-- Shows section sizes and modification timestamps
-- No additional parameters required
-
-### edit
-Replace the entire content of a core memory section.
-- Completely replaces the section content
-- Use when you want to rewrite an entire section
-- Includes before/after comparison in response
-
-### append
-Append text to an existing core memory section.
-- Adds text to the end of a section
-- Useful for incremental updates
-- Preserves existing content
-
-## Usage Examples
-
-View all core memory:
-```
-/core-memory action=view projectId=my-project
-```
-
-Edit the persona section:
-```
-/core-memory action=edit projectId=my-project section=persona content="I am an expert developer who specializes in TypeScript and React..."
-```
-
-Append to project context:
-```
-/core-memory action=append projectId=my-project section=project_context text="New framework: Next.js 14 with App Router"
-```
-
-Append working notes:
-```
-/core-memory action=append projectId=my-project section=working_notes text="TODO: Implement authentication system"
-```
-
-## Core Memory Sections
-
-- **persona**: Your personality, communication style, and preferences
-- **user_info**: Information about you (name, experience, goals)
-- **project_context**: Project structure, tech stack, and conventions
-- **working_notes**: Current thoughts, TODOs, and active work items

package/core/commands/health.md

@@ -1,5 +0,0 @@
----
-description: Check service status
----
-
-Check the status of the Squish memory service, including database connection, storage mode, and overall health.

package/core/commands/init.md

@@ -1,39 +0,0 @@
----
-description: Initialize Squish memory system for the current project
----
-
-# Squish Initialization
-
-Initializes the Squish memory system for your current project. This creates the necessary database structure and default settings.
-
-## What it does:
-
-- Creates the `.squish/` directory in your project
-- Initializes the SQLite database
-- Sets up core memory sections (persona, user_info, project_context, working_notes)
-- Creates project and user records
-
-## Usage:
-
-Run this command once when starting to use Squish in a new project:
-
-```
-/squish:init
-```
-
-After initialization, Squish will automatically:
-- Capture context during your session
-- Store important information you share
-- Enable memory search across conversations
-
-## Requirements:
-
-- Node.js 18+ installed
-- Write access to current directory
-- No additional setup needed
-
-## Notes:
-
-- Safe to run multiple times (checks if already initialized)
-- All data stored locally in `.squish/` directory
-- Can be deleted anytime to reset memory

package/core/commands/merge.md

@@ -1,113 +0,0 @@
----
-description: Manage memory merges (detect, list, preview, stats, approve, reject, reverse)
----
-
-# Memory Merge Management
-
-Manage memory consolidation: detect duplicates, review proposals, preview merges, view statistics, and make decisions on merge proposals.
-
-## Actions
-
-### detect
-Scan for similar or duplicate memories and create merge proposals.
-- Uses advanced similarity detection (simhash, minhash, semantic embedding)
-- Filters by optional similarity threshold and memory type
-- Automatically creates proposals for similar memories
-- Returns list of detected duplicates with similarity scores
-
-### list
-View pending merge proposals for review.
-- Lists all proposals in specified status (pending, approved, rejected, expired)
-- Shows similarity scores and token savings estimates
-- Displays memory pairs and consolidation recommendations
-
-### preview
-See exactly what a merged memory will look like before executing.
-- Shows the result of merging two memories
-- Displays token savings
-- Shows similarity analysis and consolidation reasoning
-- Does not modify any memories
-
-### stats
-Get merge statistics and analytics.
-- Total tokens saved from merges
-- Number of merges completed
-- Most commonly merged memory types
-- Merge trends over time
-
-### approve
-Execute a merge proposal and consolidate similar memories.
-- Combines two memories into one
-- Records token savings
-- Creates audit trail for reversibility
-- Updates memory relationships
-
-### reject
-Decline a merge proposal and keep memories separate.
-- Marks proposal as rejected
-- Prevents future suggestions for same memory pair
-- No changes to original memories
-- Useful when memories should remain distinct
-
-### reverse
-Undo a previously completed merge and restore original memories.
-- Restores all original memories from before merge
-- Removes the merged memory
-- Preserves complete audit history
-- Can be called multiple times on different merged memories
-
-## Usage Examples
-
-Detect duplicate memories:
-```
-/merge action=detect projectId=my-project
-```
-
-Detect with filters:
-```
-/merge action=detect projectId=my-project threshold=0.8 memoryType=fact
-```
-
-List pending proposals:
-```
-/merge action=list projectId=my-project status=pending
-```
-
-Preview a merge:
-```
-/merge action=preview projectId=my-project proposalId=proposal-123
-```
-
-View merge statistics:
-```
-/merge action=stats projectId=my-project
-```
-
-Approve a merge:
-```
-/merge action=approve projectId=my-project proposalId=proposal-123 reviewNotes="Both are about API design patterns"
-```
-
-Reject a proposal:
-```
-/merge action=reject projectId=my-project proposalId=proposal-456 reviewNotes="These are separate concerns"
-```
-
-Reverse a completed merge:
-```
-/merge action=reverse projectId=my-project mergeHistoryId=merge-789
-```
-
-## Similarity Thresholds
-
-- **0.5-0.6**: Very similar (recommended for detection)
-- **0.7-0.8**: Highly similar (conservative threshold)
-- **0.9+**: Nearly identical (very safe threshold)
-
-## Memory Type Filters
-
-- fact
-- preference
-- decision
-- observation
-- context

package/core/commands/recall.md

@@ -1,5 +0,0 @@
----
-description: Retrieve a memory by ID
----
-
-Retrieve a specific memory by its ID. Get the full content and metadata of a stored memory.

package/core/commands/remember.md

@@ -1,11 +0,0 @@
----
-description: Store a memory with optional agent context and semantic embeddings
----
-
-Store a new memory with semantic embeddings for later retrieval. Memories are automatically indexed for full-text and semantic search.
-
-**Optional agent context:**
-- `agentId`: Store memory in an agent-specific context
-- `agentRole`: Define the agent's role (assistant, analyzer, etc.)
-- `visibilityScope`: Control visibility (private, project, team, or global)
-- `sector`: Classify memory type (episodic, semantic, procedural, etc.)

package/core/commands/search.md

@@ -1,10 +0,0 @@
----
-description: Search memories, conversations, or get recent items with optional scope selection
----
-
-Search across memories, conversations, or retrieve recent items. Use the `scope` parameter to select what to search.
-
-**Search scopes:**
-- `memories` (default): Full-text and semantic search across stored memories
-- `conversations`: Search past conversation history by query
-- `recent`: Get recent conversation items without requiring a query