@hir4ta/mneme 0.18.2 → 0.18.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/README.ja.md +28 -55
  3. package/README.md +27 -11
  4. package/learn_claude_code/figma_exports/claude_code_map.svg +107 -0
  5. package/learn_claude_code/figma_exports/claude_code_whiteboard.excalidraw +2578 -0
  6. package/package.json +4 -1
package/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "mneme",
3
3
  "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.",
4
- "version": "0.18.2",
4
+ "version": "0.18.4",
5
5
  "author": {
6
6
  "name": "hir4ta"
7
7
  },
package/README.ja.md CHANGED
@@ -7,17 +7,6 @@ Claude Codeの長期記憶を実現するプラグイン
7
7
 
8
8
  セッションの自動保存、インテリジェントな記憶検索、Webダッシュボードでの管理を提供します。
9
9
 
10
- > [!IMPORTANT]
11
- > **破壊的変更 (v0.17.0)**: `memoria` から `mneme` に名称変更しました。
12
- >
13
- > `@hir4ta/memoria` からアップグレードする場合は、Claude Code内で再インストール：
14
- > ```
15
- > /plugin marketplace add hir4ta/mneme-marketplace
16
- > /plugin install mneme@mneme-marketplace
17
- > ```
18
- > データディレクトリも変更: `.memoria/` → `.mneme/`
19
- > 手動でリネーム: `mv .memoria .mneme`
20
-
21
10
  ## 機能
22
11
 
23
12
  ### コア機能
@@ -60,6 +49,15 @@ Claude Codeの長期記憶を実現するプラグイン
60
49
 
61
50
  ### 前提条件
62
51
 
52
+ > **⚠️ 重要: Node.js 22.5.0 以上が必要です**
53
+ >
54
+ > mnemeは **Node.js 22.5.0** で導入された組み込みの `node:sqlite` モジュールを使用しています。
55
+ > Node.js 20以前のバージョンではダッシュボードが動作しません。
56
+ >
57
+ > バージョン確認: `node --version`
58
+ >
59
+ > Node.js 20 LTSは2026年4月でサポート終了です。Node.js 22以上にアップグレードしてください。
60
+
63
61
  - **jq**: フックでJSON処理に使用します
64
62
 
65
63
  ```bash
@@ -223,50 +221,7 @@ mnemeはMCPサーバーを提供し、Claude Codeから直接呼び出せる検
223
221
 
224
222
  ## 仕組み
225
223
 
226
- ```mermaid
227
- flowchart TB
228
- subgraph autosave [会話の自動保存]
229
- A[セッション終了] --> B[SessionEndフック]
230
- B --> C[jqでトランスクリプトから抽出]
231
- C --> D[interactions + files + metrics]
232
- end
233
-
234
- subgraph autosearch [自動記憶検索]
235
- E[ユーザープロンプト] --> F[UserPromptSubmitフック]
236
- F --> G[sessions/decisions/patternsを検索]
237
- G --> H[関連コンテキストを注入]
238
- end
239
-
240
- subgraph backup [PreCompactバックアップ]
241
- I[コンテキスト95%] --> J[PreCompactフック]
242
- J --> K[interactionsをpreCompactBackupsに保存]
243
- end
244
-
245
- subgraph manual [手動操作]
246
- L["mneme:save"] --> M[判断 + パターン + ルールを抽出]
247
- N["mneme:plan"] --> O[記憶参照 + 設計 + タスク分割]
248
- end
249
-
250
- subgraph resume [セッション再開]
251
- P["mneme:resume"] --> Q[一覧から選択]
252
- Q --> R[過去の文脈を復元 + resumedFrom設定]
253
- end
254
-
255
- subgraph review [レビュー]
256
- S["mneme:review"] --> T[ルールに基づく指摘]
257
- T --> U[レビュー結果を保存]
258
- end
259
-
260
- subgraph dashboard [ダッシュボード]
261
- V["npx @hir4ta/mneme -d"] --> W[ブラウザで表示]
262
- W --> X[全データを閲覧]
263
- end
264
-
265
- D --> P
266
- H --> L
267
- M --> V
268
- U --> V
269
- ```
224
+ ![mneme ワークフロー](docs/mneme-flow-ja.png)
270
225
 
271
226
  ## データ保存
272
227
 
@@ -399,6 +354,24 @@ mnemeは**ハイブリッドストレージ**方式でプライバシーと共
399
354
  - **cloud**: serverless, microservices, edge, wasm
400
355
  - その他...
401
356
 
357
+ ## セキュリティとプライバシー
358
+
359
+ mnemeは**完全にローカルで動作**し、外部サーバーへのデータ送信は一切ありません。
360
+
361
+ | 項目 | 説明 |
362
+ |------|------|
363
+ | **外部通信** | なし - curl/fetch/HTTP リクエスト等は一切使用していません |
364
+ | **データ保存** | すべてプロジェクト内の `.mneme/` ディレクトリに保存 |
365
+ | **会話履歴** | `local.db` に保存され、自動的にgitignore（Git共有されません） |
366
+ | **使用ツール** | bash, jq, sqlite3, Node.js標準ライブラリのみ |
367
+ | **コード** | オープンソース - すべてのコードは監査可能です |
368
+
369
+ ### プライバシー設計
370
+
371
+ - **会話内容（interactions）はローカル専用**: SQLite（`local.db`）に保存され、`.gitignore`に自動追加
372
+ - **メタデータのみGit共有可能**: セッション要約、決定、パターンなどはJSONでチーム共有可能
373
+ - **テレメトリなし**: 使用状況の追跡や外部送信は行いません
374
+
402
375
  ## ライセンス
403
376
 
404
377
  MIT
package/README.md CHANGED
@@ -7,17 +7,6 @@ Long-term memory plugin for Claude Code
7
7
 
8
8
  Provides automatic session saving, intelligent memory search, and web dashboard management.
9
9
 
10
- > [!IMPORTANT]
11
- > **Breaking Change (v0.17.0)**: Renamed from `memoria` to `mneme`.
12
- >
13
- > If upgrading from `@hir4ta/memoria`, please reinstall in Claude Code:
14
- > ```
15
- > /plugin marketplace add hir4ta/mneme-marketplace
16
- > /plugin install mneme@mneme-marketplace
17
- > ```
18
- > Data directory changed: `.memoria/` → `.mneme/`
19
- > Rename manually: `mv .memoria .mneme`
20
-
21
10
  ## Features
22
11
 
23
12
  ### Core Features
@@ -60,6 +49,15 @@ Provides automatic session saving, intelligent memory search, and web dashboard
60
49
 
61
50
  ### Prerequisites
62
51
 
52
+ > **⚠️ IMPORTANT: Node.js >= 22.5.0 Required**
53
+ >
54
+ > mneme uses the built-in `node:sqlite` module, which was introduced in **Node.js 22.5.0**.
55
+ > The dashboard will NOT work on Node.js 20 or earlier versions.
56
+ >
57
+ > Check your version: `node --version`
58
+ >
59
+ > Node.js 20 LTS ends April 2026. Please upgrade to Node.js 22 or later.
60
+
63
61
  - **jq**: Used for JSON processing in hooks
64
62
 
65
63
  ```bash
@@ -409,6 +407,24 @@ If you encounter issues after an update:
409
407
  1. Check the [releases](https://github.com/hir4ta/mneme/releases) for migration notes
410
408
  2. Re-initialize with `npx @hir4ta/mneme --init` if needed
411
409
 
410
+ ## Security and Privacy
411
+
412
+ mneme operates **entirely locally** with no data sent to external servers.
413
+
414
+ | Item | Description |
415
+ |------|-------------|
416
+ | **External Communication** | None - no curl/fetch/HTTP requests are made |
417
+ | **Data Storage** | All data stored in project's `.mneme/` directory |
418
+ | **Conversation History** | Stored in `local.db`, automatically gitignored (not shared via Git) |
419
+ | **Tools Used** | bash, jq, sqlite3, Node.js standard libraries only |
420
+ | **Code** | Open source - all code is auditable |
421
+
422
+ ### Privacy by Design
423
+
424
+ - **Conversations (interactions) are local-only**: Stored in SQLite (`local.db`), auto-added to `.gitignore`
425
+ - **Only metadata is Git-shareable**: Session summaries, decisions, patterns can be shared with team via JSON
426
+ - **No telemetry**: No usage tracking or external data transmission
427
+
412
428
  ## License
413
429
 
414
430
  MIT
package/learn_claude_code/figma_exports/claude_code_map.svg ADDED
@@ -0,0 +1,107 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="1600" height="1200" viewBox="0 0 1600 1200">
2
+ <defs>
3
+ <style>
4
+ .title { font: 700 32px 'Comic Sans MS', 'Trebuchet MS', sans-serif; }
5
+ .h2 { font: 700 20px 'Comic Sans MS', 'Trebuchet MS', sans-serif; }
6
+ .body { font: 16px 'Comic Sans MS', 'Trebuchet MS', sans-serif; }
7
+ .small { font: 14px 'Comic Sans MS', 'Trebuchet MS', sans-serif; }
8
+ .stroke { stroke: #222; stroke-width: 2.5; fill: none; }
9
+ .box { stroke: #222; stroke-width: 2.5; }
10
+ </style>
11
+ </defs>
12
+
13
+ <!-- Background -->
14
+ <rect x="0" y="0" width="1600" height="1200" fill="#FAF7F2" />
15
+
16
+ <!-- Title -->
17
+ <text x="40" y="60" class="title">Claude Code 学習マップ（1枚で全体像）</text>
18
+ <text x="40" y="90" class="small">ジュニア向けに視覚化 / 章ごとに区切り / 実務での流れがわかる</text>
19
+
20
+ <!-- Legend -->
21
+ <rect x="1240" y="30" width="320" height="150" fill="#FFF" class="box" />
22
+ <text x="1260" y="60" class="h2">色の意味</text>
23
+ <rect x="1260" y="75" width="16" height="16" fill="#CDE8FF" class="box" />
24
+ <text x="1285" y="88" class="small">基本（概念/プロンプト/コンテキスト）</text>
25
+ <rect x="1260" y="100" width="16" height="16" fill="#DFF7D6" class="box" />
26
+ <text x="1285" y="113" class="small">機能</text>
27
+ <rect x="1260" y="125" width="16" height="16" fill="#FFE7C7" class="box" />
28
+ <text x="1285" y="138" class="small">実務運用</text>
29
+ <rect x="1260" y="150" width="16" height="16" fill="#F5D6E6" class="box" />
30
+ <text x="1285" y="163" class="small">spec-workflow / Docs</text>
31
+
32
+ <!-- Quickstart -->
33
+ <rect x="40" y="120" width="520" height="170" fill="#FFF" class="box" />
34
+ <text x="60" y="150" class="h2">0.5 Quickstart</text>
35
+ <text x="60" y="175" class="body">最短で1回成功体験を作る</text>
36
+ <text x="60" y="200" class="small">- 最小プロンプト</text>
37
+ <text x="60" y="222" class="small">- 失敗時の修正ループ</text>
38
+ <text x="60" y="244" class="small">- 良い/悪い例（表）</text>
39
+
40
+ <!-- Core Concepts -->
41
+ <rect x="40" y="320" width="520" height="260" fill="#CDE8FF" class="box" />
42
+ <text x="60" y="350" class="h2">1. 概念（全体像）</text>
43
+ <text x="60" y="375" class="small">- 4レイヤー: 目的/コンテキスト/ツール/権限</text>
44
+ <text x="60" y="397" class="small">- タスク適性とリスク</text>
45
+ <text x="60" y="419" class="small">- ミニケース</text>
46
+ <text x="60" y="441" class="small">- 良い/悪い例（表）</text>
47
+ <text x="60" y="463" class="small">- 演習テンプレ + 解答</text>
48
+
49
+ <!-- Prompt Engineering -->
50
+ <rect x="600" y="320" width="480" height="260" fill="#CDE8FF" class="box" />
51
+ <text x="620" y="350" class="h2">2. プロンプト設計</text>
52
+ <text x="620" y="375" class="small">- 目的/制約/完了条件</text>
53
+ <text x="620" y="397" class="small">- フェーズ分割（質問/計画/検証）</text>
54
+ <text x="620" y="419" class="small">- 良い/悪い例（表）</text>
55
+ <text x="620" y="441" class="small">- テンプレ + 解答</text>
56
+
57
+ <!-- Context Engineering -->
58
+ <rect x="1120" y="320" width="440" height="260" fill="#CDE8FF" class="box" />
59
+ <text x="1140" y="350" class="h2">3. コンテキスト設計</text>
60
+ <text x="1140" y="375" class="small">- 正本/対象/制約を最小化</text>
61
+ <text x="1140" y="397" class="small">- ルールは薄く</text>
62
+ <text x="1140" y="419" class="small">- 良い/悪い例（表）</text>
63
+ <text x="1140" y="441" class="small">- テンプレ + 解答</text>
64
+
65
+ <!-- Features -->
66
+ <rect x="40" y="620" width="760" height="240" fill="#DFF7D6" class="box" />
67
+ <text x="60" y="650" class="h2">4. 各機能</text>
68
+ <text x="60" y="675" class="small">- Slash Commands / Skills / Sub-agents / Hooks / MCP</text>
69
+ <text x="60" y="697" class="small">- カスタムコマンドの例</text>
70
+ <text x="60" y="719" class="small">- 良い/悪い例（表）</text>
71
+ <text x="60" y="741" class="small">- テンプレ + 解答</text>
72
+
73
+ <!-- Practical -->
74
+ <rect x="840" y="620" width="720" height="240" fill="#FFE7C7" class="box" />
75
+ <text x="860" y="650" class="h2">5. 実務でどう使う</text>
76
+ <text x="860" y="675" class="small">- 標準フロー（課題→計画→実装→検証→振り返り）</text>
77
+ <text x="860" y="697" class="small">- チーム運用ルール</text>
78
+ <text x="860" y="719" class="small">- レビュー基準（実装/プロンプト）</text>
79
+ <text x="860" y="741" class="small">- 良い/悪い例（表） + テンプレ</text>
80
+
81
+ <!-- Spec-workflow -->
82
+ <rect x="40" y="900" width="760" height="240" fill="#F5D6E6" class="box" />
83
+ <text x="60" y="930" class="h2">6. spec-workflow MCP</text>
84
+ <text x="60" y="955" class="small">- 要件 → 設計 → タスクの型</text>
85
+ <text x="60" y="977" class="small">- 使い方（詳細）</text>
86
+ <text x="60" y="999" class="small">- 通し例（要件→設計→タスク→実装案）</text>
87
+ <text x="60" y="1021" class="small">- 良い/悪い例（表） + テンプレ</text>
88
+
89
+ <!-- Docs Best Practices -->
90
+ <rect x="840" y="900" width="720" height="240" fill="#F5D6E6" class="box" />
91
+ <text x="860" y="930" class="h2">7. ドキュメントのベストプラクティス</text>
92
+ <text x="860" y="955" class="small">- Diataxis / Good Docs / Write the Docs</text>
93
+ <text x="860" y="977" class="small">- 構成パターン（Overview→Quickstart→...）</text>
94
+ <text x="860" y="999" class="small">- 良い/悪い例（表） + テンプレ</text>
95
+
96
+ <!-- Flow arrows (rough) -->
97
+ <path d="M 300 290 C 320 300, 340 300, 360 320" class="stroke" />
98
+ <path d="M 560 450 C 580 450, 600 450, 600 450" class="stroke" />
99
+ <path d="M 1080 450 C 1100 450, 1120 450, 1120 450" class="stroke" />
100
+ <path d="M 400 580 C 420 600, 440 600, 460 620" class="stroke" />
101
+ <path d="M 1200 580 C 1200 600, 1200 610, 1200 620" class="stroke" />
102
+ <path d="M 400 860 C 420 880, 440 880, 460 900" class="stroke" />
103
+ <path d="M 1200 860 C 1200 880, 1200 890, 1200 900" class="stroke" />
104
+
105
+ <!-- Footer -->
106
+ <text x="40" y="1165" class="small">Tip: まず Quickstart → 概念 → プロンプト/コンテキスト → 機能 → 実務 → MCP → Docs</text>
107
+ </svg>