squish-memory 1.0.2 → 1.2.0

package/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/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/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/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/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/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/commands/observe.md

@@ -1,5 +0,0 @@
----
-description: Store observations from tool usage
----
-
-Store observations about tool usage, patterns, errors, and insights discovered during work. Automatically captured tool execution data can be annotated with additional context.

package/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/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/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

package/config/mcp-cli-fallback-policy.json

@@ -1,22 +0,0 @@
-{
-  "allowOperations": [
-    "remember",
-    "search",
-    "recall",
-    "health"
-  ],
-  "denyPatterns": [
-    "docker\\s+",
-    "\\|",
-    "&&",
-    ";",
-    "`",
-    "\\$\\("
-  ],
-  "fallbackTriggers": [
-    "mcp-unreachable",
-    "mcp-timeout",
-    "mcp-schema-error"
-  ],
-  "telemetryField": "executionPath"
-}

package/config/mcp.json

@@ -1,38 +0,0 @@
-{
-  "version": 1,
-  "defaults": {
-    "connectionTimeoutMs": 15000,
-    "requestTimeoutMs": 60000,
-    "maxConcurrentToolCalls": 4,
-    "retry": {
-      "enabled": true,
-      "maxAttempts": 3,
-      "backoffMs": 400
-    },
-    "lazyToolDiscovery": true,
-    "resultMaxChars": 12000
-  },
-  "servers": {
-    "filesystem": {
-      "transport": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-filesystem",
-        "."
-      ],
-      "env": {}
-    },
-    "github": {
-      "transport": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-github"
-      ],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
-      }
-    }
-  }
-}

package/config/plugin-manifest.json

@@ -1,152 +0,0 @@
-{
-  "id": "squish-memory",
-  "name": "Squish Memory",
-  "version": "1.0.2",
-  "description": "Universal two-tier memory system for AI agents with hybrid search, core memory, and MCP-first architecture",
-  "capabilities": ["mcp", "cli", "web"],
-  "targets": {
-    "claude-code": {
-      "type": "hooks",
-      "hooks": ["SessionStart", "UserPromptSubmit", "PostToolUse", "SessionEnd"],
-      "install": {
-        "copy": [
-          { "from": ".claude-plugin/plugin.json", "to": "~/.claude/plugin.json" }
-        ]
-      },
-      "verify": {
-        "fileExists": "~/.claude/plugin.json",
-        "toolCheck": "squish_health"
-      }
-    },
-    "openclaw": {
-      "type": "plugin-slot",
-      "slot": "memory",
-      "tools": ["memory_search", "memory_get"],
-      "install": {
-        "command": "node scripts/openclaw-bootstrap.mjs --skip-tool-check"
-      },
-      "verify": {
-        "fileExists": "~/.openclaw/openclaw-memory.json",
-        "toolCheck": "memory_search"
-      }
-    },
-    "opencode": {
-      "type": "mcp",
-      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
-      "install": {
-        "copy": [
-          { "from": "generated/mcp/mcp-servers.json", "to": "~/.config/opencode/mcp-servers.json" }
-        ]
-      },
-      "verify": {
-        "fileExists": "~/.config/opencode/mcp-servers.json",
-        "toolCheck": "squish_health"
-      }
-    },
-    "codex": {
-      "type": "mcp",
-      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
-      "install": {
-        "copy": [
-          { "from": "generated/mcp/mcp-servers.json", "to": "~/.codex/mcp-servers.json" }
-        ]
-      },
-      "verify": {
-        "fileExists": "~/.codex/mcp-servers.json",
-        "toolCheck": "squish_health"
-      }
-    },
-    "cursor": {
-      "type": "mcp",
-      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
-      "install": {
-        "copy": [
-          { "from": "generated/mcp/mcp-servers.json", "to": "~/.cursor/mcp.json" }
-        ]
-      },
-      "verify": {
-        "fileExists": "~/.cursor/mcp.json",
-        "toolCheck": "squish_health"
-      }
-    },
-    "vscode": {
-      "type": "mcp",
-      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
-      "install": {
-        "copy": [
-          { "from": "generated/mcp/mcp-servers.json", "to": "~/.vscode/mcp/servers.json" }
-        ]
-      },
-      "verify": {
-        "fileExists": "~/.vscode/mcp/servers.json",
-        "toolCheck": "squish_health"
-      }
-    },
-    "windsurf": {
-      "type": "mcp",
-      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
-      "install": {
-        "copy": [
-          { "from": "generated/mcp/mcp-servers.json", "to": "~/.windsurf/mcp-servers.json" }
-        ]
-      },
-      "verify": {
-        "fileExists": "~/.windsurf/mcp-servers.json",
-        "toolCheck": "squish_health"
-      }
-    }
-  },
-  "dependencies": {
-    "mcporter": {
-      "version": "0.7.3",
-      "autoInstall": true,
-      "optional": false,
-      "provides": ["mcp-bridge", "openclaw-memory"]
-    },
-    "@tobilu/qmd": {
-      "version": "2.0.1",
-      "autoInstall": true,
-      "optional": false,
-      "provides": ["fast-search", "bm25", "vector-search"]
-    }
-  },
-  "auth": {
-    "modes": ["none", "token"],
-    "default": "none",
-    "token": {
-      "envVar": "SQUISH_REMOTE_TOKEN",
-      "help": "Set SQUISH_REMOTE_TOKEN for remote mode authentication"
-    }
-  },
-  "pinning": {
-    "mcporter": "0.7.3",
-    "@tobilu/qmd": "2.0.1",
-    "@modelcontextprotocol/sdk": "1.27.1"
-  },
-  "entry": {
-    "mcp": "dist/commands/mcp-server.cjs",
-    "cli": "dist/index.js",
-    "plugin": "packages/plugin-openclaw/dist/index.js"
-  },
-  "compatibility": {
-    "minNodeVersion": "18.0.0",
-    "clients": [
-      { "id": "claude-code", "minVersion": "0.62.0" },
-      { "id": "openclaw", "minVersion": "2026.2.15" },
-      { "id": "opencode", "minVersion": "0.1.0" },
-      { "id": "codex", "minVersion": "0.1.0" },
-      { "id": "cursor", "minVersion": "0.45.0" },
-      { "id": "vscode-mcp", "minVersion": "1.0.0" },
-      { "id": "windsurf", "minVersion": "0.1.0" }
-    ]
-  },
-  "healthCheck": {
-    "mcpTool": "squish_health",
-    "httpEndpoint": "/health"
-  },
-  "generated": {
-    "from": "config/plugin-manifest.json",
-    "generator": "squish-memory@1.0.0",
-    "timestamp": "2026-01-17T00:00:00.000Z"
-  }
-}