@pcircle/memesh 4.0.3 → 4.1.1

package/README.ja.md

@@ -1,110 +1,284 @@
+<!-- translated from README.md @ ab9d25f8d9cb7c78c4cc271717709e2efb4bac76 -->
+<!-- DO NOT edit this file by hand. The maintainer regenerates it from README.md via a private toolkit script (see internal docs). Manual edits will be overwritten on next sync. -->
+
 🌐 [English](README.md) | [繁體中文](README.zh-TW.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Português](README.pt.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Tiếng Việt](README.vi.md) | [Español](README.es.md) | [ภาษาไทย](README.th.md)
 
 <p align="center">
   <h1 align="center">MeMesh LLM Memory</h1>
   <p align="center">
-    <strong>Claude Code と MCP coding agents のためのローカルメモリレイヤー。</strong><br />
-    SQLite ファイル 1 つ。Docker 不要。クラウド不要。
+    <strong>Claude Code と MCP コーディングエージェント向けのローカルメモリ</strong><br />
+    SQLite ファイル 1 つ。Docker も クラウドも不要。
+  </p>
+  <p align="center">
+    <a href="https://www.npmjs.com/package/@pcircle/memesh"><img src="https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=3b82f6&label=npm" alt="npm" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22c55e?style=flat-square" alt="MIT" /></a>
+    <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-22c55e?style=flat-square" alt="Node" /></a>
+    <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-a855f7?style=flat-square" alt="MCP" /></a>
   </p>
 </p>
 
-> この日本語 README は要点をまとめた案内版です。最新かつ完全な内容は [English README](README.md) を参照してください。
+---
 
-## 何を解決するのか
+## 課題
 
-coding agent はセッションをまたぐと文脈を失いやすくなります。設計判断、バグ修正の経緯、過去の失敗、プロジェクト固有の制約を何度も説明し直すことになります。
+コーディングエージェントはセッション間で記憶を失います。アーキテクチャの決定、バグ修正、テスト失敗、苦労して得た教訓 — すべてを毎回説明し直さなければなりません。Claude Code はいつも初期状態から始まり、既に知っているはずの制約を再発見し、貴重なコンテキストを無駄にします。
 
-**MeMesh はそれらの知識をローカルに残し、検索できる状態で保持し、あとから再利用できるようにします。**
+**MeMesh は、コーディングエージェントに永続的で検索可能な進化するローカルメモリを与えます。**
 
-この npm package は MeMesh のローカル plugin / package 版です。クラウドのワークスペース製品や企業向け基盤を含むものではありません。
+このパッケージは MeMesh プロダクトファミリーのローカルメモリ層です。意図的にシンプルでオープンソース設計になっています。npm でインストール、メモリを `~/.memesh/knowledge-graph.db` に保存、Claude Code や MCP 互換クライアントに接続するだけ。ホステッドワークスペースやエンタープライズ向けのプロダクトは、このパッケージの README やロードマップとは分離して提供されます。
+
+---
 
 ## 60 秒で始める
 
-### 1. インストール
+### ステップ 1: インストール
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-### 2. 判断を記録する
+### ステップ 2: 決定を記録
 
 ```bash
 memesh remember --name "auth-decision" --type "decision" --obs "Use OAuth 2.0 with PKCE"
 ```
 
-### 3. あとで呼び戻す
+### ステップ 3: あとで思い出す
 
 ```bash
 memesh recall "login security"
-# → 言い回しが違っても "OAuth 2.0 with PKCE" を見つけられます
+# → 別の単語で検索しても「OAuth 2.0 with PKCE」が見つかります
+```
+
+**これだけです。** MeMesh がセッション間でメモリを保持・検索し始めます。
+
+インストールと接続をエンドツーエンドで確認したい場合:
+
+```bash
+memesh doctor
 ```
 
-ダッシュボードを開くには:
+ダッシュボードを開いてメモリを探索します:
 
 ```bash
 memesh
 ```
 
-## 誰に向いているか
+<p align="center">
+  <img src="docs/images/dashboard-search.png" alt="MeMesh Search — any memory instantly" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-analytics.png" alt="MeMesh Analytics — health score, timeline, patterns, knowledge coverage" width="100%" />
+</p>
+
+<p align="center">
+  <img src="docs/images/dashboard-graph.png" alt="MeMesh Graph — interactive knowledge graph with type filters and ego mode" width="100%" />
+</p>
+
+---
+
+## こんな方向けです
+
+| あなたが... | MeMesh でできること |
+|-----------|-----------------|
+| **Claude Code を使う開発者** | プロジェクト判断、ファイル固有の知見、過去の失敗が自動で呼び出される |
+| **コーディングエージェントのパワーユーザー** | 1 つのローカルメモリレイヤーを MCP 互換ツール全体で共有 |
+| **AI コーディングワークフローを実験中のチーム** | ホステッドインフラを導入せず、プロジェクト知識をエクスポート・インポート |
+| **エージェント開発者** | MCP、HTTP、CLI、Python SDK 経由でローカルメモリを追加 |
+
+---
+
+## コーディングエージェント向けに設計
+
+<table>
+<tr>
+<td width="33%" align="center">
+
+**Claude Code / Desktop**
+```bash
+memesh-mcp
+```
+MCP ツール + Claude Code フック
+
+</td>
+<td width="33%" align="center">
+
+**HTTP クライアント**
+```bash
+curl localhost:3737/v1/recall \
+  -H "Content-Type: application/json" \
+  -d '{"query":"auth"}'
+```
+`memesh serve` (REST API)
+
+</td>
+<td width="33%" align="center">
+
+**任意の LLM (OpenAI 形式)**
+```bash
+memesh export-schema \
+  --format openai
+```
+ツールを任意の API 呼び出しに貼り付け可能
+
+</td>
+</tr>
+</table>
+
+---
 
-- Claude Code を使い、セッション間でもプロジェクトの文脈を残したい開発者
-- 同じローカルメモリを MCP coding agents 間で使い回したい上級ユーザー
-- export / import でチーム知識を共有したい小規模な AI-native 開発チーム
-- CLI、HTTP、MCP にローカルメモリを組み込みたい agent 開発者
+## OpenMemory、Cursor Memories、Mem0、Zep との違い
 
-## MeMesh を選ぶ理由
+| | **MeMesh** | OpenMemory | Cursor Memories | Mem0 | Zep / Graphiti |
+|---|---|---|---|---|---|
+| **最適な用途** | コーディングエージェント向けローカルメモリ | ローカル・クロスクライアント MCP メモリ | Cursor ネイティブプロジェクトメモリ | 管理型アプリ・エージェントメモリ | テンポラル知識グラフ |
+| **インストール形態** | `npm install -g @pcircle/memesh` | ローカルアプリ・サーバーフロー | Cursor ビルトイン | クラウド API / SDK / MCP | サービス・フレームワークセットアップ |
+| **ストレージ** | 1 つのローカル SQLite ファイル | ローカルメモリスタック | Cursor 管理ルール・メモリ | ホステッド・セルフホスト型スタック | グラフデータベース |
+| **クラウド必須** | いいえ | ローカルモードなら不要 | Cursor アカウント設定による | プラットフォーム利用時は必須 | 通常は必須・セルフホスト可能 |
+| **Claude Code フック** | 第一級 | MCP ツール | いいえ | MCP ツール | Claude Code 専用ではない |
+| **ダッシュボード** | ビルトイン | ビルトイン | Cursor 設定 | プラットフォームダッシュボード | プラットフォーム・グラフツール |
+| **トレードオフ** | シンプルなローカル構成、エンタープライズスケールは非対応 | より広いローカルアプリフットプリント | Cursor に限定 | 強力な管理プラットフォーム、ローカルファースト性が低い | 強力なグラフモデル、セットアップが重い |
 
-- ローカルファースト: データは自分の SQLite に保存
-- 導入が軽い: `npm install -g` ですぐ使える
-- 接続方法が明快: CLI、HTTP、MCP をサポート
-- Claude Code と相性がよい: hooks により作業中の記憶呼び出しがしやすい
-- 見える・整理できる: dashboard があるので中身を確認しやすい
-- import の安全境界: import した記憶は検索できても、レビューや再保存を行うまでは Claude hooks へ自動注入されません
+**MeMesh は、エンタープライズスケールの管理インフラストラクチャと引き換えに、即座のローカルセットアップ、検査可能なストレージ、コーディングエージェントワークフロー統合を選びました。**
 
-## Claude Code で自動的に行うこと
+---
 
-MeMesh は現在、次の 5 つのタイミングで役立ちます。
+## Claude Code での自動動作
 
-- セッション開始時に、関連する記憶と既知の教訓を読み込む
-- ファイル編集前に、そのファイルやプロジェクトに関係する記憶を呼び出す
-- `git commit` 後に、変更内容を記録する
-- セッション終了時に、今回の修正やエラー、lesson learned を整理する
-- context compact 前に、重要な内容をローカルメモリへ保存する
+すべてを手動で記録する必要はありません。MeMesh に **6 つのフック** があり、作業中に知識を自動キャプチャ・注入します:
 
-## Dashboard でできること
+| タイミング | MeMesh の動作 |
+|---------|-----------|
+| **セッション開始時** | 最も関連の高いメモリ + 過去の教訓から得た予防警告 + エージェント編成バナーをロード |
+| **ファイル編集前** | ファイルまたはプロジェクト関連のメモリをリコール (Claude がコード執筆前) |
+| **bash コマンド実行前** | 高い検証性を持つコマンド (テスト、ビルド、lint、マイグレーション、デプロイ、ベンチマーク) をバックグラウンドエージェントとして実行するよう促す |
+| **`git commit` 後** | 変更内容と diff 統計を記録 |
+| **Claude 停止時** | 編集ファイル、修正エラー、失敗から自動生成した構造化教訓をキャプチャ |
+| **コンテキスト圧縮前** | コンテキスト限界で失われる前に知識を保存 |
 
-Dashboard には 7 つのタブがあり、11 言語に対応しています。
+> **いつでも無効化可能:** `export MEMESH_AUTO_CAPTURE=false`
 
-- Search: メモリ検索
-- Browse: メモリ一覧
-- Analytics: 健全性や傾向の確認
-- Graph: 関係グラフの確認
-- Lessons: 過去の教訓の確認
-- Manage: アーカイブと復元
-- Settings: LLM provider と言語設定
+---
 
-## Smart Mode とは
+## ダッシュボード
 
-MeMesh はデフォルトでオフライン利用できます。さらに LLM API key を設定すると、次のような機能を有効にできます。
+7 つのタブ、11 言語対応、外部依存なし。サーバー実行中は `http://localhost:3737/dashboard` でアクセス可能。
 
-- query expansion
-- より良い自動抽出
-- より賢い整理や圧縮
+| タブ | 表示内容 |
+|-----|--------|
+| **Search** | 全メモリ対象の全文検索 + ベクトル類似度検索 |
+| **Browse** | ページネーション表示された全エンティティ、アーカイブ・復元機能 |
+| **Analytics** | メモリ健全性スコア (0-100)、30 日間タイムライン、価値指標、知識カバレッジ、クリーンアップ提案、あなたの作業パターン |
+| **Graph** | インタラクティブ力指向知識グラフ、型フィルタ、検索、エゴモード、再度ヒートマップ |
+| **Lessons** | 過去の失敗から構造化された教訓 (エラー、根本原因、修正、予防) |
+| **Manage** | エンティティのアーカイブ・復元 |
+| **Settings** | LLM プロバイダ設定、言語セレクタ |
 
-API key がなくてもコア機能は使えます。
+---
 
-## さらに読む
+## スマート機能
 
-- 完全な機能一覧、比較、API、release 情報: [English README](README.md)
-- プラットフォーム別ガイド: [docs/platforms/README.md](docs/platforms/README.md)
-- API リファレンス: [docs/api/API_REFERENCE.md](docs/api/API_REFERENCE.md)
+**🧠 スマート検索** — 「login security」で検索すると「OAuth PKCE」についてのメモリが見つかります。設定した LLM を使いクエリを関連用語で拡張します。
 
-## 開発と検証
+**📊 スコア付きランキング** — 関連性 (30%) + 新しさ (25%) + 頻度 (15%) + 信頼度 (15%) + リコール影響度 (10%) + 時間的有効性 (5%) でランク付け。
+
+**🔄 知識の進化** — 判断は変わります。`forget` で古いメモリをアーカイブ (削除されない)。`supersedes` 関係で古い → 新しい をリンク。AI は常に最新版を参照します。
+
+**⚠️ 矛盾検出** — 互いに矛盾するメモリが 2 つある場合、MeMesh が警告します。
+
+**📦 チーム共有** — `memesh export > team-knowledge.json` → チームと共有 → `memesh import team-knowledge.json`。
+インポートされたバンドルは検索可能ですが、MeMesh はレビュー・ローカル再保存まで Claude フックへの自動注入はしません。
+
+---
+
+## 使用例
+
+> 「MeMesh が 3 週間前に PKCE と implicit フロー間で PKCE を選んだことを覚えていました。再び認証について Claude に聞いた時、すでに知っていました — 説明し直す必要がなかった。」
+> — **SaaS 構築中のソロ開発者**
+
+> 「毎週金曜日にチームのメモリをエクスポート、月曜日にインポートします。全員の Claude は先週チームが学んだことを知った状態で週を始めます。」
+> — **3 人スタートアップ、共有知識ベース**
+
+> 「ダッシュボードで、メモリの 90% が自動生成セッションログだったことに気づきました。アーキテクチャ判断向けに意図的に `remember` を使い始めました。ゲームチェンジャーです。」
+> — **Analytics タブを発見した開発者**
+
+---
+
+## スマートモードをアンロック (オプション)
+
+MeMesh はデフォルトでオフライン動作します。クエリ拡張、より賢い抽出、圧縮が必要な場合のみ LLM API キーを追加:
+
+```bash
+memesh config set llm.provider anthropic
+memesh config set llm.api-key sk-ant-...
+```
+
+またはダッシュボード Settings タブで視覚的にセットアップ:
+
+```bash
+memesh  # ダッシュボード → Settings タブを開く
+```
+
+| | レベル 0 (デフォルト) | レベル 1 (スマートモード) |
+|---|---|---|
+| **検索** | FTS5 キーワードマッチング | + LLM クエリ拡張 (~97% リコール率) |
+| **自動キャプチャ** | ルールベースパターン | + LLM が判断・教訓を抽出 |
+| **圧縮** | 利用不可 | `consolidate` で冗長メモリを圧縮 |
+| **コスト** | 無料、API キー不要 | 検索あたり ~$0.0001 (Haiku) |
+
+---
+
+## 9 つのメモリツール全覧
+
+| ツール | 機能 |
+|------|------|
+| `remember` | 観察、関係、タグ付きで知識を保存 |
+| `recall` | 多要素スコアリングと LLM クエリ拡張のスマート検索 |
+| `forget` | ソフトアーカイブ (削除されない) または特定の観察を削除 |
+| `consolidate` | LLM が冗長メモリを圧縮 |
+| `export` | メモリを JSON でシェア (プロジェクト・チーム間) |
+| `import` | マージ戦略付きメモリインポート (スキップ / 上書き / 追記) |
+| `learn` | ミスから構造化教訓を記録 (エラー、根本原因、修正、予防) |
+| `user_patterns` | 作業パターンを分析 — スケジュール、ツール、強み、学習領域 |
+| `verify_agent_work` | バックグラウンドエージェント作業の検証レポートを永続化、`git diff` で主張を現実チェック |
+
+---
+
+## アーキテクチャ
+
+```
+                    ┌─────────────────┐
+                    │   Core Engine   │
+                    │  (8 operations) │
+                    └────────┬────────┘
+           ┌─────────────────┼─────────────────┐
+           │                 │                 │
+     CLI (memesh)    HTTP API (serve)    MCP (memesh-mcp)
+           │                 │                 │
+           └─────────────────┼─────────────────┘
+                             │
+                    SQLite + FTS5 + sqlite-vec
+                    (~/.memesh/knowledge-graph.db)
+```
+
+コアはフレームワーク非依存。ターミナル、HTTP、MCP から同じロジックで動作します。
+
+---
+
+## コントリビュート
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/memesh-llm-memory
-cd memesh-llm-memory
-npm install
-npm run build
-npm test
+cd memesh-llm-memory && npm install && npm run build
+npm test             # 489 tests
+npm run test:e2e-dashboard
 ```
+
+ダッシュボード: `cd dashboard && npm install && npm run dev`
+
+---
+
+<p align="center">
+  <strong>MIT</strong> — Made by <a href="https://pcircle.ai">PCIRCLE AI</a>
+</p>