Feat/refactoring memoryable baseline

README.ja.md

@@ -194,7 +194,7 @@ uv run --directory /path/to/exocortex exocortex --transport sse --port 8765
 | `exo_trace_lineage` | 🕰️ 記憶の系譜・進化を追跡（時系列推論） |
 | `exo_curiosity_scan` | 🤔 矛盾・古い情報・知識のギャップをスキャン |
 | `exo_analyze_knowledge` | 知識ベースの健全性分析と改善提案 |
-| `exo_sleep` | バックグラウンド整理（重複検出、孤立記憶のレスキュー）を起動 |
+| `exo_sleep` | バックグラウンド整理（重複検出、孤立記憶のレスキュー、自動リンク）を起動 |
 | `exo_consolidate` | 記憶クラスタから抽象パターンを抽出 |
 
 ### 🤖 知識の自律的改善（Knowledge Autonomy）
@@ -338,16 +338,25 @@ AI: exo_trace_lineage(memory_id="現在の判断", direction="backward")
 
 ### Curiosity Engine `exo_curiosity_scan`
 
-Curiosity Engineは、好奇心旺盛な人間のように**知識ベースに疑問を投げかけます**。矛盾や不整合をスキャンし、知識の質を向上させるための質問を生成します。
+Curiosity Engineは、好奇心旺盛な人間のように**知識ベースに疑問を投げかけます**。矛盾や不整合をスキャンし、リンク候補を提案し、知識の質を向上させるための質問を生成します。
 
 **検出する内容：**
 
 | カテゴリ | 説明 | 例 |
 |---------|------|-----|
 | 🔴 **矛盾** | 互いに矛盾する記憶 | 同じトピックで成功 vs 失敗 |
+| 🔗 **リンク候補** | リンクすべき未接続の記憶 | タグ・コンテキスト・類似度で検出 |
 | 📅 **古い情報** | 見直しが必要な古い知識 | supersededされたが未リンク |
 | ❓ **質問** | 知識に関する人間的な質問 | 「これはまだ有効？」 |
 
+**リンク候補の検出戦略：**
+
+| 戦略 | 信頼度 | 説明 |
+|------|--------|------|
+| **タグ共有** | 高 (0.7+) | 2つ以上のタグを共有する記憶 |
+| **コンテキスト共有** | 中 (0.6) | 同じプロジェクト＋同じタイプ |
+| **セマンティック類似度** | 高 (0.7+) | 70%以上の類似度を持つ記憶 |
+
 **出力例：**
 
 ```json
@@ -360,9 +369,29 @@ Curiosity Engineは、好奇心旺盛な人間のように**知識ベースに
       "confidence": 0.85
     }
   ],
+  "suggested_links": [
+    {
+      "source_summary": "DB最適化テクニック",
+      "target_summary": "クエリパフォーマンス改善",
+      "reason": "3つのタグを共有: database, performance, optimization",
+      "link_type": "tag_shared",
+      "confidence": 0.8
+    }
+  ],
   "outdated_knowledge": [],
   "questions": [
-    "🤔 これらの記憶は矛盾しているようです。両方とも有効ですか？"
+    "🤔 これらの記憶は矛盾しているようです。両方とも有効ですか？",
+    "🔗 リンクされていない関連記憶が見つかりました。リンクしてグラフを強化しませんか？"
+  ],
+  "next_actions": [
+    {
+      "action": "create_link",
+      "priority": "medium",
+      "details": {
+        "call": "exo_link_memories",
+        "args": { "source_id": "...", "target_id": "...", "relation_type": "related" }
+      }
+    }
   ]
 }
 ```
@@ -371,11 +400,16 @@ Curiosity Engineは、好奇心旺盛な人間のように**知識ベースに
 ```
 AI: exo_curiosity_scan(context_filter="my-project")
     ↓
-結果: 潜在的な問題と調査すべき質問のレポート
+結果: 問題・リンク候補・質問のレポート
+    ↓
+AI: next_actions を実行してリンクを作成
+    ↓
+結果: 知識グラフがより豊かに！
 ```
 
 **ユースケース：**
 - 🔍 **知識の監査**: 「知識に矛盾はない？」
+- 🔗 **グラフ強化**: 「リンクすべき未接続の記憶を見つけて」
 - 🧹 **品質メンテナンス**: 「何をクリーンアップすべき？」
 - 💡 **発見**: 「知識について何を問うべき？」
 
@@ -553,13 +587,17 @@ exo_store_memory(
 │  ┌──────────────────────────────────────────────────────┐   │
 │  │ 1. 重複検出                                           │   │
 │  │    - 類似度 >= 95% の記憶を検出                       │   │
-│  │    - 新しい方 → 古い方に 'supersedes' リンクを作成    │   │
+│  │    - 新しい方 → 古い方に 'related' リンクを作成       │   │
 │  ├──────────────────────────────────────────────────────┤   │
 │  │ 2. 孤立記憶のレスキュー                              │   │
 │  │    - タグもリンクもない記憶を検出                     │   │
 │  │    - 最も類似した記憶に 'related' リンクを作成       │   │
 │  ├──────────────────────────────────────────────────────┤   │
-│  │ 3. パターンマイニング（Phase 2）                      │   │
+│  │ 3. 自動リンク（高信頼度のみ）                        │   │
+│  │    - タグ共有: 3つ以上 → 'related'                   │   │
+│  │    - セマンティック: 80%以上 → 'related'             │   │
+│  ├──────────────────────────────────────────────────────┤   │
+│  │ 4. パターンマイニング（Phase 2）                      │   │
 │  │    - 記憶クラスタから共通パターンを抽出              │   │
 │  └──────────────────────────────────────────────────────┘   │
 └─────────────────────────────────────────────────────────────┘

README.md

@@ -194,7 +194,7 @@ uv run --directory /path/to/exocortex exocortex --transport sse --port 8765
 | `exo_trace_lineage` | 🕰️ Trace the evolution/lineage of a memory (temporal reasoning) |
 | `exo_curiosity_scan` | 🤔 Scan for contradictions, outdated info, and knowledge gaps |
 | `exo_analyze_knowledge` | Analyze knowledge base health and get improvement suggestions |
-| `exo_sleep` | Trigger background consolidation (deduplication, orphan rescue) |
+| `exo_sleep` | Trigger background consolidation (deduplication, orphan rescue, auto-linking) |
 | `exo_consolidate` | Extract abstract patterns from memory clusters |
 
 ### 🤖 Knowledge Autonomy
@@ -338,16 +338,25 @@ Result: Shows the evolution chain of how the current decision came to be
 
 ### Curiosity Engine with `exo_curiosity_scan`
 
-The Curiosity Engine actively **questions your knowledge base** like a curious human would. It scans for inconsistencies and generates questions to improve knowledge quality.
+The Curiosity Engine actively **questions your knowledge base** like a curious human would. It scans for inconsistencies, finds unlinked memories, and generates questions to improve knowledge quality.
 
 **What it detects:**
 
 | Category | Description | Example |
 |----------|-------------|---------|
 | 🔴 **Contradictions** | Memories that conflict with each other | Success vs Failure on same topic |
 | 📅 **Outdated Info** | Old knowledge that may need review | Memories superseded but not linked |
+| 🔗 **Suggested Links** | Unlinked memories that should be connected | Memories sharing tags, context, or high similarity |
 | ❓ **Questions** | Human-like questions about your knowledge | "Is this still valid?" |
 
+**Suggested Links Detection Strategies:**
+
+| Strategy | Confidence | Description |
+|----------|------------|-------------|
+| **Tag Sharing** | High (0.7+) | Memories sharing 2+ tags are likely related |
+| **Context Sharing** | Medium (0.6) | Same project + same type (insight/decision) |
+| **Semantic Similarity** | High (0.7+) | High vector similarity (>70%) but not linked |
+
 **Example Output:**
 
 ```json
@@ -360,9 +369,34 @@ The Curiosity Engine actively **questions your knowledge base** like a curious h
       "confidence": 0.85
     }
   ],
+  "suggested_links": [
+    {
+      "source_summary": "Database optimization technique",
+      "target_summary": "Query performance improvement",
+      "reason": "Share 3 tags: database, performance, optimization",
+      "link_type": "tag_shared",
+      "confidence": 0.8,
+      "suggested_relation": "related"
+    }
+  ],
   "outdated_knowledge": [],
   "questions": [
-    "🤔 These memories seem to contradict. Are both still valid?"
+    "🤔 These memories seem to contradict. Are both still valid?",
+    "🔗 Found unlinked related memories. Link them to strengthen the graph?"
+  ],
+  "next_actions": [
+    {
+      "action": "create_link",
+      "priority": "medium",
+      "details": {
+        "call": "exo_link_memories",
+        "args": {
+          "source_id": "...",
+          "target_id": "...",
+          "relation_type": "related"
+        }
+      }
+    }
   ]
 }
 ```
@@ -371,11 +405,16 @@ The Curiosity Engine actively **questions your knowledge base** like a curious h
 ```
 AI: exo_curiosity_scan(context_filter="my-project")
     ↓
-Result: Report of potential issues and questions to investigate
+Result: Report of issues, suggested links, and questions
+    ↓
+AI: Executes next_actions to create links
+    ↓
+Result: Knowledge graph becomes richer and more connected!
 ```
 
 **Use Cases:**
 - 🔍 **Knowledge audit**: "Are there any contradictions in my knowledge?"
+- 🔗 **Graph enrichment**: "Find unlinked memories that should be connected"
 - 🧹 **Quality maintenance**: "What needs to be cleaned up?"
 - 💡 **Discovery**: "What questions should I be asking about my knowledge?"
 
@@ -553,13 +592,17 @@ Like human sleep consolidates memories, Exocortex has a **background consolidati
 │  ┌──────────────────────────────────────────────────────┐   │
 │  │ 1. Deduplication                                      │   │
 │  │    - Find memories with similarity >= 95%             │   │
-│  │    - Link newer → older with 'supersedes' relation    │   │
+│  │    - Link newer → older with 'related' relation       │   │
 │  ├──────────────────────────────────────────────────────┤   │
 │  │ 2. Orphan Rescue                                      │   │
 │  │    - Find memories with no tags and no links          │   │
 │  │    - Link to most similar memory with 'related'       │   │
 │  ├──────────────────────────────────────────────────────┤   │
-│  │ 3. Pattern Mining (Phase 2)                           │   │
+│  │ 3. Auto-linking (High Confidence Only)                │   │
+│  │    - Tag sharing: 3+ shared tags → 'related'          │   │
+│  │    - Semantic: 80%+ similarity → 'related'            │   │
+│  ├──────────────────────────────────────────────────────┤   │
+│  │ 4. Pattern Mining (Phase 2)                           │   │
 │  │    - Extract common patterns from memory clusters     │   │
 │  └──────────────────────────────────────────────────────┘   │
 └─────────────────────────────────────────────────────────────┘

exocortex/__init__.py

@@ -4,4 +4,4 @@
 storing and retrieving development insights across projects.
 """
 
-__version__ = "0.9.1"
+__version__ = "1.0.0"