@hir4ta/mneme 0.18.3 → 0.19.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mneme",
   "description": "A plugin that provides long-term memory for Claude Code. It automatically saves context lost during auto-compact, offering features for session restoration, recording technical decisions, and learning developer patterns.",
-  "version": "0.18.3",
+  "version": "0.19.0",
   "author": {
     "name": "hir4ta"
   },

package/README.ja.md

@@ -10,9 +10,9 @@ Claude Codeの長期記憶を実現するプラグイン
 ## 機能
 
 ### コア機能
-- **会話の自動保存**: セッション終了時にjqで自動保存（確実・高速）
+- **インクリメンタル保存**: 各ターン完了時に差分のみをSQLiteに保存（Node.js、高速）
 - **自動記憶検索**: プロンプトごとに関連する過去のセッション・判断を自動で注入
-- **PreCompactバックアップ**: Auto-Compact前にinteractionsをバックアップ（コンテキスト95%で発動）
+- **PreCompact対応**: Auto-Compact前に未保存分をキャッチアップ（コンテキスト95%で発動）
 - **フルデータ抽出**: `/mneme:save` で要約・判断・パターン・ルールを一括保存
 - **記憶参照プランニング**: `/mneme:plan` で過去の知見を活用した設計・計画
 - **セッション再開**: `/mneme:resume` で過去のセッションを再開（チェーン追跡付き）
@@ -49,6 +49,15 @@ Claude Codeの長期記憶を実現するプラグイン
 
 ### 前提条件
 
+> **⚠️ 重要: Node.js 22.5.0 以上が必要です**
+>
+> mnemeは **Node.js 22.5.0** で導入された組み込みの `node:sqlite` モジュールを使用しています。
+> Node.js 20以前のバージョンではダッシュボードが動作しません。
+>
+> バージョン確認: `node --version`
+>
+> Node.js 20 LTSは2026年4月でサポート終了です。Node.js 22以上にアップグレードしてください。
+
 - **jq**: フックでJSON処理に使用します
 
 ```bash
@@ -110,11 +119,15 @@ Claude Codeを再起動
 
 ## 使い方
 
-### セッション自動保存
+### インクリメンタル保存
+
+**会話ログは各ターン完了時に自動保存**されます（Node.jsでストリーミング処理）。設定不要。
 
-**会話ログは自動保存**されます（セッション終了時にjqで抽出）。設定不要。
+- **Stop hook**: 各アシスタント応答完了時に差分のみを保存
+- **PreCompact hook**: Auto-Compact前に未保存分をキャッチアップ
+- **SessionEnd hook**: 軽量な終了処理のみ（重い処理なし）
 
-**PreCompact**ではinteractionsを`preCompactBackups`にバックアップします（コンテキスト95%で発動）。要約は自動作成されません。
+**`/mneme:save`を実行しないと、セッション終了時に会話履歴は削除されます**（ゴミデータ防止）。
 
 ### 自動記憶検索
 
@@ -214,47 +227,55 @@ mnemeはMCPサーバーを提供し、Claude Codeから直接呼び出せる検
 
 ```mermaid
 flowchart TB
-    subgraph autosave [会話の自動保存]
-        A[セッション終了] --> B[SessionEndフック]
-        B --> C[jqでトランスクリプトから抽出]
-        C --> D[interactions + files + metrics]
+    subgraph incremental [インクリメンタル保存]
+        A[各ターン] --> B[Stop Hook]
+        B --> C[Node.js ストリーミング]
+        C --> D[差分のみ保存]
     end
 
     subgraph autosearch [自動記憶検索]
-        E[ユーザープロンプト] --> F[UserPromptSubmitフック]
-        F --> G[sessions/decisions/patternsを検索]
-        G --> H[関連コンテキストを注入]
+        E[ユーザープロンプト] --> F[UserPromptSubmit Hook]
+        F --> G[sessions/decisions/patterns検索]
+        G --> H[関連コンテキスト注入]
+    end
+
+    subgraph precompact [PreCompact キャッチアップ]
+        I[コンテキスト95%] --> J[PreCompact Hook]
+        J --> K[未保存分をキャッチアップ]
     end
 
-    subgraph backup [PreCompactバックアップ]
-        I[コンテキスト95%] --> J[PreCompactフック]
-        J --> K[interactionsをpreCompactBackupsに保存]
+    subgraph sessionend [セッション終了]
+        L[終了] --> M[SessionEnd Hook]
+        M --> N{コミット済み?}
+        N -->|Yes| O[interactions保持]
+        N -->|No| P[interactions削除]
     end
 
-    subgraph manual [手動操作]
-        L["mneme:save"] --> M[判断 + パターン + ルールを抽出]
-        N["mneme:plan"] --> O[記憶参照 + 設計 + タスク分割]
+    subgraph manual [手動アクション]
+        Q["mneme:save"] --> R[decisions + patterns + rules抽出]
+        R --> S[セッションをコミット済みに]
+        T["mneme:plan"] --> U[記憶参照 + タスク分割]
     end
 
     subgraph resume [セッション再開]
-        P["mneme:resume"] --> Q[一覧から選択]
-        Q --> R[過去の文脈を復元 + resumedFrom設定]
+        V["mneme:resume"] --> W[一覧から選択]
+        W --> X[コンテキスト復元 + resumedFrom設定]
     end
 
     subgraph review [レビュー]
-        S["mneme:review"] --> T[ルールに基づく指摘]
-        T --> U[レビュー結果を保存]
+        Y["mneme:review"] --> Z[ルールベース指摘]
+        Z --> AA[レビュー結果保存]
     end
 
     subgraph dashboard [ダッシュボード]
-        V["npx @hir4ta/mneme -d"] --> W[ブラウザで表示]
-        W --> X[全データを閲覧]
+        AB["npx @hir4ta/mneme -d"] --> AC[ブラウザで開く]
+        AC --> AD[全データ閲覧]
     end
 
-    D --> P
-    H --> L
-    M --> V
-    U --> V
+    D --> Q
+    H --> Q
+    S --> AB
+    AA --> AB
 ```
 
 ## データ保存
@@ -397,7 +418,7 @@ mnemeは**完全にローカルで動作**し、外部サーバーへのデー
 | **外部通信** | なし - curl/fetch/HTTP リクエスト等は一切使用していません |
 | **データ保存** | すべてプロジェクト内の `.mneme/` ディレクトリに保存 |
 | **会話履歴** | `local.db` に保存され、自動的にgitignore（Git共有されません） |
-| **使用ツール** | bash, jq, sqlite3, Node.js標準ライブラリのみ |
+| **使用ツール** | bash, Node.js, jq, sqlite3（外部依存なし） |
 | **コード** | オープンソース - すべてのコードは監査可能です |
 
 ### プライバシー設計

package/README.md

@@ -10,9 +10,9 @@ Provides automatic session saving, intelligent memory search, and web dashboard
 ## Features
 
 ### Core Features
-- **Auto-save interactions**: Conversations auto-saved at session end (jq-based, reliable)
+- **Incremental save**: Save only new interactions on each turn completion (Node.js, fast)
 - **Auto memory search**: Related past sessions/decisions automatically injected on each prompt
-- **Backup on PreCompact**: Interactions backed up before Auto-Compact (context 95% full)
+- **PreCompact support**: Catch up unsaved interactions before Auto-Compact (context 95% full)
 - **Full data extraction**: Save summary, decisions, patterns, and rules with `/mneme:save`
 - **Memory-informed planning**: Design and plan with past knowledge via `/mneme:plan`
 - **Session Resume**: Resume past sessions with `/mneme:resume` (with chain tracking)
@@ -49,6 +49,15 @@ Provides automatic session saving, intelligent memory search, and web dashboard
 
 ### Prerequisites
 
+> **⚠️ IMPORTANT: Node.js >= 22.5.0 Required**
+>
+> mneme uses the built-in `node:sqlite` module, which was introduced in **Node.js 22.5.0**.
+> The dashboard will NOT work on Node.js 20 or earlier versions.
+>
+> Check your version: `node --version`
+>
+> Node.js 20 LTS ends April 2026. Please upgrade to Node.js 22 or later.
+
 - **jq**: Used for JSON processing in hooks
 
 ```bash
@@ -110,11 +119,15 @@ This will auto-update on Claude Code startup.
 
 ## Usage
 
-### Session Auto-Save
+### Incremental Save
+
+**Conversation logs are auto-saved on each turn completion** (Node.js streaming). No configuration needed.
 
-**Interactions are auto-saved** at session end using jq (no Claude dependency). No configuration needed.
+- **Stop hook**: Saves only new interactions on each assistant response completion
+- **PreCompact hook**: Catches up unsaved interactions before Auto-Compact
+- **SessionEnd hook**: Lightweight cleanup only (no heavy processing)
 
-**PreCompact** backs up interactions to `preCompactBackups` before Auto-Compact (context 95% full). Summary is NOT auto-created.
+**If you don't run `/mneme:save`, conversation history is deleted at session end** (prevents garbage data).
 
 ### Auto Memory Search
 
@@ -214,10 +227,10 @@ mneme provides MCP servers with search and database tools callable directly from
 
 ```mermaid
 flowchart TB
-    subgraph autosave [Auto-Save Interactions]
-        A[Session End] --> B[SessionEnd Hook]
-        B --> C[jq extracts from transcript]
-        C --> D[interactions + files + metrics]
+    subgraph incremental [Incremental Save]
+        A[Each Turn] --> B[Stop Hook]
+        B --> C[Node.js streaming]
+        C --> D[Save only new interactions]
     end
 
     subgraph autosearch [Auto Memory Search]
@@ -226,35 +239,43 @@ flowchart TB
         G --> H[Inject relevant context]
     end
 
-    subgraph backup [PreCompact Backup]
+    subgraph precompact [PreCompact Catch-up]
         I[Context 95% Full] --> J[PreCompact Hook]
-        J --> K[Backup interactions to preCompactBackups]
+        J --> K[Catch up missed interactions]
+    end
+
+    subgraph sessionend [Session End]
+        L[Exit] --> M[SessionEnd Hook]
+        M --> N{Committed?}
+        N -->|Yes| O[Keep interactions]
+        N -->|No| P[Delete interactions]
     end
 
     subgraph manual [Manual Actions]
-        L["mneme:save"] --> M[Extract decisions + patterns + rules]
-        N["mneme:plan"] --> O[Memory-informed design + tasks]
+        Q["mneme:save"] --> R[Extract decisions + patterns + rules]
+        R --> S[Mark session committed]
+        T["mneme:plan"] --> U[Memory-informed design + tasks]
     end
 
     subgraph resume [Session Resume]
-        P["mneme:resume"] --> Q[Select from list]
-        Q --> R[Restore past context + set resumedFrom]
+        V["mneme:resume"] --> W[Select from list]
+        W --> X[Restore past context + set resumedFrom]
     end
 
     subgraph review [Review]
-        S["mneme:review"] --> T[Rule-based findings]
-        T --> U[Save review results]
+        Y["mneme:review"] --> Z[Rule-based findings]
+        Z --> AA[Save review results]
     end
 
     subgraph dashboard [Dashboard]
-        V["npx @hir4ta/mneme -d"] --> W[Open in browser]
-        W --> X[View all data]
+        AB["npx @hir4ta/mneme -d"] --> AC[Open in browser]
+        AC --> AD[View all data]
     end
 
-    D --> P
-    H --> L
-    M --> V
-    U --> V
+    D --> Q
+    H --> Q
+    S --> AB
+    AA --> AB
 ```
 
 ## Data Storage
@@ -388,16 +409,6 @@ Tags are selected from `.mneme/tags.json` to prevent notation variations (e.g.,
 - **cloud**: serverless, microservices, edge, wasm
 - And more...
 
-## Versioning
-
-This project follows [Semantic Versioning](https://semver.org/).
-
-**⚠️ While in 0.x (pre-1.0), breaking changes may occur between minor versions.**
-
-If you encounter issues after an update:
-1. Check the [releases](https://github.com/hir4ta/mneme/releases) for migration notes
-2. Re-initialize with `npx @hir4ta/mneme --init` if needed
-
 ## Security and Privacy
 
 mneme operates **entirely locally** with no data sent to external servers.
@@ -407,7 +418,7 @@ mneme operates **entirely locally** with no data sent to external servers.
 | **External Communication** | None - no curl/fetch/HTTP requests are made |
 | **Data Storage** | All data stored in project's `.mneme/` directory |
 | **Conversation History** | Stored in `local.db`, automatically gitignored (not shared via Git) |
-| **Tools Used** | bash, jq, sqlite3, Node.js standard libraries only |
+| **Tools Used** | bash, Node.js, jq, sqlite3 (no external dependencies) |
 | **Code** | Open source - all code is auditable |
 
 ### Privacy by Design