@pcircle/memesh 2.10.0 → 2.11.0

package/.mcp.json

@@ -2,11 +2,8 @@
   "mcpServers": {
     "memesh": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server-bootstrap.js"],
-      "env": {
-        "NODE_ENV": "production",
-        "MEMESH_DISABLE_DAEMON": "1"
-      }
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp/server.js"],
+      "env": { "NODE_ENV": "production" }
     }
   }
 }

package/README.md

@@ -1,286 +1,86 @@
-<div align="center">
-
-<img src="docs/images/memesh-logo.svg" alt="MeMesh" width="80" />
-
 # MeMesh Plugin
 
-### Your AI coding sessions deserve memory.
-
-MeMesh Plugin gives Claude Code persistent, searchable memory — so every session builds on the last.
+Minimal persistent memory plugin for Claude Code. Remembers decisions, patterns, and context across sessions.
 
 [![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
-[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
 [![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
 [![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
 
-```bash
-npm install -g @pcircle/memesh
-```
-
-[Get Started](#get-started) · [How It Works](#how-it-works) · [Commands](#commands) · [Docs](docs/USER_GUIDE.md)
-
-[繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
-
-</div>
-
-> **Note**: This project was originally called "Claude Code Buddy" and has been renamed to MeMesh Plugin to avoid potential trademark issues.
-
----
-
-## The Problem
-
-You're deep into a project with Claude Code. You made important decisions three sessions ago — which auth library, why you chose that database schema, what patterns to follow. But Claude doesn't remember. You repeat yourself. You lose context. You waste time.
-
-**MeMesh Plugin fixes this.** It gives Claude a persistent, searchable memory that grows with your project.
-
----
-
-## How It Works
-
-<table>
-<tr>
-<td width="50%">
-
-### Before MeMesh
-```
-Session 1: "Use JWT for auth"
-Session 2: "Why did we pick JWT again?"
-Session 3: "Wait, what auth library are we using?"
-```
-You repeat decisions. Claude forgets context. Progress stalls.
-
-</td>
-<td width="50%">
-
-### After MeMesh
-```
-Session 1: "Use JWT for auth" → saved
-Session 2: buddy-remember "auth" → instant recall
-Session 3: Context auto-loaded on start
-```
-Every session picks up where you left off.
-
-</td>
-</tr>
-</table>
-
----
-
-## What You Get
-
-**Searchable Project Memory** — Ask "what did we decide about auth?" and get an instant, semantically-matched answer. Not keyword search — *meaning* search, powered by local ONNX embeddings.
-
-**Smart Task Analysis** — `buddy-do "add user auth"` doesn't just execute. It pulls relevant context from past sessions, checks what patterns you've established, and builds an enriched plan before writing a single line.
-
-**Proactive Recall** — MeMesh automatically surfaces relevant memories when you start a session, hit a test failure, or encounter an error. No manual searching needed.
-
-**Workflow Automation** — Session recaps on startup. File change tracking. Code review reminders before commits. All running silently in the background.
-
-**Mistake Learning** — Record errors and fixes to build a knowledge base. The same mistake doesn't happen twice.
-
----
-
-## Get Started
-
-**Prerequisites**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
+## Installation
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-Restart Claude Code. That's it.
-
-**Verify** — type in Claude Code:
-
-```
-buddy-help
-```
+## What it does
 
-You should see a list of available commands.
+MeMesh gives Claude Code persistent memory through 3 MCP tools, 2 hooks, and a CLI dashboard:
 
-<details>
-<summary><strong>Install from source</strong> (contributors)</summary>
+### MCP Tools
 
-```bash
-git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
-cd claude-code-buddy
-npm install && npm run build
-```
+| Tool | Description |
+|------|-------------|
+| `remember` | Store knowledge — entities with observations, relations, and tags |
+| `recall` | Search stored knowledge via FTS5 full-text search with optional tag filtering |
+| `forget` | Delete stored knowledge by name (cascades to observations, relations, tags) |
 
-</details>
+### Hooks
 
----
+| Hook | Event | What |
+|------|-------|------|
+| Session Start | `SessionStart` | Auto-recalls project-specific + recent global memories |
+| Post Commit | `PostToolUse` (Bash) | Records git commits as knowledge entities |
 
-## Commands
+### CLI
 
-| Command | What it does |
+| Command | Description |
 |---------|-------------|
-| `buddy-do "task"` | Execute a task with full memory context |
-| `buddy-remember "topic"` | Search past decisions and context |
-| `buddy-help` | Show available commands |
-
-**Real examples:**
+| `memesh-view` | Generate and open an interactive HTML dashboard |
 
 ```bash
-# Get oriented in a new-to-you codebase
-buddy-do "explain this codebase"
-
-# Build features with context from past work
-buddy-do "add user authentication"
-
-# Recall why decisions were made
-buddy-remember "API design decisions"
-buddy-remember "why we chose PostgreSQL"
+memesh-view
 ```
 
-All data stays on your machine with automatic 90-day retention.
-
----
-
-## How is this different from CLAUDE.md?
-
-| | CLAUDE.md | MeMesh Plugin |
-|---|-----------|--------|
-| **Purpose** | Static instructions for Claude | Living memory that grows with your project |
-| **Search** | Manual text search | Semantic search by meaning |
-| **Updates** | You edit manually | Auto-captures decisions as you work |
-| **Recall** | Always loaded (can get long) | Surfaces relevant context on demand |
-| **Scope** | General preferences | Project-specific knowledge graph |
-
-**They work together.** CLAUDE.md tells Claude *how* to work. MeMesh Plugin remembers *what* you've built.
-
----
-
-## Platform Support
-
-| Platform | Status |
-|----------|--------|
-| macOS | ✅ |
-| Linux | ✅ |
-| Windows | ✅ (WSL2 recommended) |
-
-**Works with:** Claude Code CLI · VS Code Extension · Cursor (via MCP) · Any MCP-compatible editor
-
----
-
-## Visual Explorer (Streamlit UI)
+![MeMesh Dashboard](docs/images/dashboard-screenshot.png)
 
-MeMesh Plugin includes an interactive web UI for exploring your knowledge graph visually.
+## How it works
 
-**Dashboard** — Overview of your knowledge base with entity statistics, type distribution, tag trends, and growth over time.
-
-<div align="center">
-<img src="docs/images/streamlit-dashboard.png" alt="MeMesh Dashboard" width="800" />
-</div>
-
-**KG Explorer** — Interactive graph visualization with color-coded entity types, relation edges, FTS5 full-text search, and filtering by type, tags, and date range.
-
-<div align="center">
-<img src="docs/images/streamlit-kg-explorer.png" alt="MeMesh KG Explorer" width="800" />
-</div>
-
-**Quick start:**
-
-```bash
-cd streamlit
-pip install -r requirements.txt
-streamlit run app.py
-```
-
----
+- **Storage**: SQLite database at `~/.memesh/knowledge-graph.db`
+- **Search**: FTS5 full-text search (no vector embeddings)
+- **Isolation**: Tag-based project filtering (`project:<name>`)
+- **Schema**: entities, observations, relations, tags + FTS5 virtual table
+- **Validation**: All tool inputs validated with Zod schemas
 
 ## Architecture
 
-```mermaid
-graph TB
-    CC[Claude Code CLI] <-->|MCP Protocol| MCP[MCP Server]
-
-    MCP --> TH[Tool Handlers]
-    TH --> MT[Memory Tools]
-    TH --> ST[System Tools]
-    TH --> HT[Hook Tools]
-
-    MT --> UMS[Unified Memory Store]
-    MT --> KG[Knowledge Graph]
-
-    UMS --> SE[Search Engine]
-    KG --> FTS[FTS5 Full-Text Search]
-    KG --> VS[Vector Search]
-
-    VS --> EMB[ONNX Embeddings]
-    VS --> SVA[sqlite-vec Adapter]
-
-    KG --> DB[(SQLite DB)]
-    UMS --> DB
-
-    DB -.->|Read-Only| ST_UI[Streamlit Visual Explorer]
-
-    style CC fill:#4F46E5,color:#fff
-    style MCP fill:#7C3AED,color:#fff
-    style DB fill:#0891B2,color:#fff
-    style ST_UI fill:#06B6D4,color:#fff
-    style EMB fill:#10B981,color:#fff
 ```
-
-**How memory flows through the system:**
-
-```mermaid
-sequenceDiagram
-    participant U as You (in Claude Code)
-    participant M as MeMesh Plugin
-    participant KG as Knowledge Graph
-    participant E as Embeddings (ONNX)
-
-    U->>M: "Use JWT for auth"
-    M->>KG: Create entity (decision)
-    KG->>E: Generate embedding (local)
-    E-->>KG: 384-dim vector
-    KG-->>M: Stored + auto-relations inferred
-
-    Note over U,E: Next session...
-
-    U->>M: buddy-remember "auth"
-    M->>KG: Hybrid search (FTS5 + semantic)
-    KG->>E: Encode query
-    E-->>KG: Query vector
-    KG-->>M: Ranked results
-    M-->>U: "You decided JWT for auth because..."
+src/
+├── cli/
+│   └── view.ts           # HTML dashboard generator (D3.js graph + stats)
+├── db.ts                 # SQLite database (open/close/migrate, FTS5)
+├── knowledge-graph.ts    # Entity CRUD, relations, FTS5 search
+├── index.ts              # Package exports
+└── mcp/
+    ├── server.ts         # MCP server entry point (stdio transport)
+    └── tools.ts          # 3 tool handlers + Zod validation
+
+scripts/hooks/
+├── session-start.js      # Auto-recall on session start
+└── post-commit.js        # Git commit tracking
 ```
 
-Everything runs locally. No cloud. No API calls. Your data never leaves your machine.
-
----
-
-## Documentation
+**Dependencies** (3): `better-sqlite3`, `@modelcontextprotocol/sdk`, `zod`
 
-| Doc | Description |
-|-----|-------------|
-| [Getting Started](docs/GETTING_STARTED.md) | Step-by-step setup guide |
-| [User Guide](docs/USER_GUIDE.md) | Full usage guide with examples |
-| [Commands](docs/COMMANDS.md) | Complete command reference |
-| [Architecture](docs/ARCHITECTURE.md) | Technical deep dive |
-| [Contributing](CONTRIBUTING.md) | Contribution guidelines |
-| [Development](docs/DEVELOPMENT.md) | Dev setup for contributors |
+## Development
 
----
-
-## Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
-
----
+```bash
+npm install
+npm run build       # TypeScript compile + chmod executables
+npm test            # 73 tests (vitest, BDD style)
+npm run typecheck   # tsc --noEmit
+```
 
 ## License
 
-MIT — See [LICENSE](LICENSE)
-
----
-
-<div align="center">
-
-**Built with Claude Code, for Claude Code.**
-
-[Report Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [Request Feature](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [Get Help](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
-
-</div>
+MIT

package/dist/cli/view.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function generateDashboardHtml(dbPath?: string): string;
+//# sourceMappingURL=view.d.ts.map

package/dist/cli/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/cli/view.ts"],"names":[],"mappings":";AA+LA,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAyV7D"}