@hir4ta/mneme 0.23.2 → 0.24.1

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.23.2",
+  "version": "0.24.1",
   "author": {
     "name": "hir4ta"
   },

package/README.ja.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.23.2-blue)
+![Version](https://img.shields.io/badge/version-0.24.1-blue)
 ![Node.js](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen)
 [![NPM Version](https://img.shields.io/npm/v/%40hir4ta%2Fmneme)](https://www.npmjs.com/package/@hir4ta/mneme)
 [![MIT License](https://img.shields.io/npm/l/%40hir4ta%2Fmneme)](https://github.com/hir4ta/mneme/blob/main/LICENSE)
@@ -13,14 +13,16 @@ Claude Codeの長期記憶を実現するプラグイン
 
 - **インクリメンタル保存**: 各ターン完了時に差分のみをSQLiteに保存（Node.js、高速）
 - **自動記憶検索**: プロンプトごとに関連する過去のセッション・判断を自動で注入
+- **プログレッシブ検索**: 3層検索（コンパクト → サマリー → フル）でトークン消費を約70%削減
 - **PreCompact対応**: Auto-Compact前に未保存分をキャッチアップ（コンテキスト95%で発動）
 - **フルデータ抽出**: `/mneme:save` で要約・判断・パターン・ルールを一括保存
 - **セッション再開**: `/mneme:resume` で過去のセッションを再開（チェーン追跡付き）
-- **セッション提案**: セッション開始時に最新3件を提案
+- **ナレッジ・リフレクション**: `/mneme:reflect` で蓄積された知見を横断分析 — パターン検出、矛盾発見、鮮度チェック、昇格候補の提案
 - **知見の抽出**: `/mneme:harvest` でPRコメントから decision/pattern/rule の元データを抽出
-- **Webダッシュボード**: セッション・元データ・開発ルールの閲覧
-- **開発ルール + 承認**: 意思決定・パターン・ルールから開発ルールを生成し、インラインで承認/却下
-- **知識グラフ層**: セッションと承認済み開発ルールを一つのグラフで可視化
+- **Webダッシュボード**: セッション、開発ルール、統計、ナレッジグラフ、チーム活動を一括管理
+- **ナレッジグラフ**: 共有タグだけでなく、セッション→判断→パターン→ルールの実際の関係性を可視化
+- **チーム活動**: メンバーごとのセッション数、判断、パターンの貢献度とナレッジ品質を追跡
+- **AIナレッジレポート**: チーム貢献、活動分析、バイリンガル出力（EN/JA）を含むリッチHTMLレポート
 
 ## 課題と解決
 
@@ -114,7 +116,9 @@ Claude Codeを再起動
 | `/mneme:save`              | 全データ抽出: 要約・判断・パターン・ルール |
 | `/mneme:resume [id]`       | セッションを再開（ID省略で一覧表示）       |
 | `/mneme:search "クエリ"`   | セッションと承認済み開発ルールを検索       |
+| `/mneme:reflect`           | ナレッジ健全性分析: 矛盾検出、鮮度チェック、昇格候補 |
 | `/mneme:harvest <PR URL>`  | PRレビューコメントから知見を抽出           |
+| `/mneme:report`            | AI生成のHTMLナレッジレポートを出力         |
 
 ### 推奨ワークフロー
 
@@ -123,9 +127,8 @@ implement → save → approve rules
 ```
 
 1. **implement**: コードを実装
-2. **save**: 元データを抽出して開発ルール候補を生成
-3. **validate**: `npm run validate:sources` で必須項目/priority/tags を検証
-4. **approve rules**: 生成された開発ルールをインラインで確認・承認/却下
+2. **save**: 元データを抽出して開発ルール候補を生成（バリデーションはMCP経由で自動実行）
+3. **approve rules**: 生成された開発ルールをインラインで確認・承認/却下
 
 ランタイム詳細（Hook分岐、未保存終了、Auto-Compact）は以下:
 - `docs/mneme-runtime-flow.md`
@@ -151,7 +154,8 @@ npx @hir4ta/mneme --dashboard --port 8080
 - **Sessions**: セッション一覧・詳細
 - **開発ルール**: 意思決定・パターン・ルールから生成されたルールの確認・承認
 - **Statistics**: アクティビティチャート・セッション統計の表示
-- **Graph**: タグ共有によるセッション関連性の可視化
+- **Graph**: エンティティ間の関係性（セッション→判断→パターン→ルール）をインタラクティブに可視化
+- **Team**: メンバー貢献度、日別アクティビティ、ナレッジ品質を追跡
 
 #### 言語切り替え
 
@@ -206,6 +210,21 @@ DecisionとPatternは**排他的**です — 同じ知見はどちらか一方
 
 > **ヒント**: CLAUDE.md は簡潔に。各行について「これを消したらClaudeがミスするか？」と問い、不要なら削除してください。（[ベストプラクティス - Claude Code Docs](https://code.claude.com/docs/en/best-practices)）
 
+### ナレッジ・リフレクション
+
+蓄積されたナレッジの健全性、矛盾、成長機会を分析します。ナレッジベースの状態を確認したいときに手動で実行してください。
+
+```
+/mneme:reflect
+```
+
+分析カテゴリ:
+- **繰り返しテーマ**: セッション・判断・パターン横断で出現するタグと知識密度スコア
+- **矛盾検出**: 相反する可能性のあるアクティブな判断（AIによる意味的分析）
+- **昇格候補**: ルールに昇格されていない承認済みパターン
+- **鮮度チェック**: 更新されていない古い判断、未使用のルール、放置されたドラフト
+- **ナレッジ健全性**: 全体統計、承認パイプライン、優先度分布、タグカバレッジ
+
 ### ナレッジレポート
 
 Claude Code がセッションデータを分析し、開発活動の要約・セッションタイムライン・ナレッジハイライト・活用状況を含むリッチなHTMLレポートを生成します。
@@ -217,6 +236,7 @@ Claude Code がセッションデータを分析し、開発活動の要約・
 機能:
 - 期間選択: 1週間（デフォルト）、2週間、1ヶ月
 - AI生成の開発活動サマリー
+- チーム貢献の内訳（メンバーごとのセッション数・判断・パターン）
 - 展開可能なセッションタイムライン（目標、成果、議論、エラー）
 - ナレッジハイライト（意思決定・パターン・ルール）を直接表示
 - 全ソースからのタグヒートマップ

package/README.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.23.2-blue)
+![Version](https://img.shields.io/badge/version-0.24.1-blue)
 ![Node.js](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen)
 [![NPM Version](https://img.shields.io/npm/v/%40hir4ta%2Fmneme)](https://www.npmjs.com/package/@hir4ta/mneme)
 [![MIT License](https://img.shields.io/npm/l/%40hir4ta%2Fmneme)](https://github.com/hir4ta/mneme/blob/main/LICENSE)
@@ -13,14 +13,16 @@ Provides automatic session saving, intelligent memory search, and web dashboard
 
 - **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
+- **Progressive search**: 3-layer search (compact → summary → full) that reduces token usage by ~70%
 - **PreCompact support**: Catch up unsaved interactions before Auto-Compact (context 95% full)
 - **Full data extraction**: Save summary, decisions, patterns, and rules with `/mneme:save`
 - **Session Resume**: Resume past sessions with `/mneme:resume` (with chain tracking)
-- **Session Suggestion**: Recent 3 sessions shown at session start
+- **Knowledge Reflection**: Analyze accumulated knowledge to detect patterns, contradictions, stale items, and promotion candidates with `/mneme:reflect`
 - **Knowledge Harvesting**: Extract decision/pattern/rule sources from PR comments with `/mneme:harvest`
-- **Web Dashboard**: View sessions, source artifacts, and development rules
-- **Development Rules + Approval**: Generate rules from decisions/patterns/rules and approve/reject inline
-- **Knowledge Graph Layer**: Visualize sessions and approved development rules as one graph
+- **Web Dashboard**: Sessions, development rules, statistics, knowledge graph, and team activity
+- **Knowledge Graph**: Visualize cross-entity relationships — session chains, decision origins, pattern sources — not just shared tags
+- **Team Activity**: See who contributed what — session counts, decisions, patterns per member, and knowledge quality metrics
+- **AI Knowledge Report**: Rich HTML report with team contributions, activity analysis, and bilingual output (EN/JA)
 
 ## Problems Solved
 
@@ -114,7 +116,9 @@ This will auto-update on Claude Code startup.
 | `/mneme:save`            | Extract all data: summary, decisions, patterns, rules |
 | `/mneme:resume [id]`     | Resume session (show list if ID omitted)              |
 | `/mneme:search "query"`  | Search sessions and approved development rules        |
+| `/mneme:reflect`         | Analyze knowledge health: contradictions, stale items, promotion candidates |
 | `/mneme:harvest <PR URL>`| Extract knowledge from PR review comments             |
+| `/mneme:report`          | Generate AI-powered HTML knowledge report             |
 
 ### Recommended Workflow
 
@@ -123,9 +127,8 @@ implement → save → approve rules
 ```
 
 1. **implement**: Write code
-2. **save**: Extract source knowledge and generate development rule candidates
-3. **validate**: Run `npm run validate:sources` to enforce required fields/priority/tags
-4. **approve rules**: Review and approve/reject generated development rules inline
+2. **save**: Extract source knowledge and generate development rule candidates (validation runs automatically via MCP)
+3. **approve rules**: Review and approve/reject generated development rules inline
 
 Detailed runtime flow (hooks, uncommitted policy, auto-compact path):
 - `docs/mneme-runtime-flow.md`
@@ -151,7 +154,8 @@ npx @hir4ta/mneme --dashboard --port 8080
 - **Sessions**: List and view sessions
 - **Development Rules**: Review and approve rules generated from decisions/patterns/rules
 - **Statistics**: View activity charts and session statistics
-- **Graph**: Visualize session connections by shared tags
+- **Graph**: Visualize cross-entity relationships (session → decision → pattern → rule) with interactive filters
+- **Team**: Track team member contributions, daily activity timeline, and knowledge quality metrics
 
 #### Language Switching
 
@@ -206,6 +210,21 @@ For teams, you can create `.claude/rules/mneme.md` with path-scoped rules:
 
 > **Tip**: Keep CLAUDE.md concise. For each line, ask: "Would removing this cause Claude to make mistakes?" If not, cut it. ([Best Practices - Claude Code Docs](https://code.claude.com/docs/en/best-practices))
 
+### Knowledge Reflection
+
+Analyze your accumulated knowledge for health, contradictions, and growth opportunities. Run manually when you want to review the state of your knowledge base.
+
+```
+/mneme:reflect
+```
+
+Analysis categories:
+- **Recurring themes**: Tags appearing across sessions, decisions, and patterns — with knowledge density scoring
+- **Contradiction detection**: Active decisions that may conflict with each other (AI-powered semantic analysis)
+- **Promotion candidates**: Approved patterns not yet promoted to rules
+- **Staleness check**: Old decisions never updated, unused rules, forgotten drafts
+- **Knowledge health**: Overall stats, approval pipeline, priority distribution, tag coverage
+
 ### Knowledge Report
 
 Generate an AI-powered knowledge report. Claude Code analyzes session data and produces a rich HTML report with narrative summaries, session timelines, knowledge highlights, and usage insights.
@@ -217,6 +236,7 @@ Generate an AI-powered knowledge report. Claude Code analyzes session data and p
 Features:
 - Choose period: 1 week (default), 2 weeks, or 1 month
 - AI-generated development activity summary
+- Team contribution breakdown (per-member sessions, decisions, patterns)
 - Expandable session timeline with goals, outcomes, discussions, and errors
 - Knowledge highlights (decisions, patterns, rules) displayed directly
 - Tag heatmap aggregated from all sources

package/dist/lib/save/index.js

@@ -56,13 +56,13 @@ async function getGitInfo(projectPath) {
   return { owner, repository, repositoryUrl, repositoryRoot };
 }
 function resolveMnemeSessionId(projectPath, claudeSessionId) {
-  const shortId = claudeSessionId.slice(0, 8);
-  const sessionLinkPath = path.join(
-    projectPath,
-    ".mneme",
-    "session-links",
-    `${shortId}.json`
+  const sessionLinksDir = path.join(projectPath, ".mneme", "session-links");
+  const fullPath = path.join(sessionLinksDir, `${claudeSessionId}.json`);
+  const shortPath = path.join(
+    sessionLinksDir,
+    `${claudeSessionId.slice(0, 8)}.json`
   );
+  const sessionLinkPath = fs.existsSync(fullPath) ? fullPath : shortPath;
   if (fs.existsSync(sessionLinkPath)) {
     try {
       const link = JSON.parse(fs.readFileSync(sessionLinkPath, "utf8"));
@@ -72,24 +72,29 @@ function resolveMnemeSessionId(projectPath, claudeSessionId) {
     } catch {
     }
   }
-  return shortId;
+  return claudeSessionId;
 }
 function findSessionFileById(projectPath, mnemeSessionId) {
   const sessionsDir = path.join(projectPath, ".mneme", "sessions");
-  const searchDir = (dir) => {
+  const searchDirFor = (dir, fileName) => {
     if (!fs.existsSync(dir)) return null;
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
       const fullPath = path.join(dir, entry.name);
       if (entry.isDirectory()) {
-        const result = searchDir(fullPath);
-        if (result) return result;
-      } else if (entry.name === `${mnemeSessionId}.json`) {
+        const result2 = searchDirFor(fullPath, fileName);
+        if (result2) return result2;
+      } else if (entry.name === fileName) {
         return fullPath;
       }
     }
     return null;
   };
-  return searchDir(sessionsDir);
+  const result = searchDirFor(sessionsDir, `${mnemeSessionId}.json`);
+  if (result) return result;
+  if (mnemeSessionId.length > 8) {
+    return searchDirFor(sessionsDir, `${mnemeSessionId.slice(0, 8)}.json`);
+  }
+  return null;
 }
 function hasSessionSummary(sessionFile) {
   if (!sessionFile) return false;
@@ -181,12 +186,19 @@ function cleanupStaleUncommittedSessions(projectPath, graceDays) {
         } catch {
         }
       }
-      const linkPath = path2.join(
+      const fullLinkPath = path2.join(
+        projectPath,
+        ".mneme",
+        "session-links",
+        `${row.claude_session_id}.json`
+      );
+      const shortLinkPath = path2.join(
         projectPath,
         ".mneme",
         "session-links",
         `${row.claude_session_id.slice(0, 8)}.json`
       );
+      const linkPath = fs2.existsSync(fullLinkPath) ? fullLinkPath : shortLinkPath;
       if (fs2.existsSync(linkPath)) {
         try {
           fs2.unlinkSync(linkPath);
@@ -322,6 +334,24 @@ function migrateDatabase(db) {
     `);
     console.error("[mneme] Migrated: created session_save_state table");
   }
+  try {
+    db.exec("SELECT 1 FROM file_index LIMIT 1");
+  } catch {
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS file_index (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id TEXT NOT NULL,
+        project_path TEXT NOT NULL,
+        file_path TEXT NOT NULL,
+        tool_name TEXT,
+        timestamp TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+      CREATE INDEX IF NOT EXISTS idx_file_index_session ON file_index(session_id);
+      CREATE INDEX IF NOT EXISTS idx_file_index_project_file ON file_index(project_path, file_path);
+    `);
+    console.error("[mneme] Migrated: created file_index table");
+  }
 }
 function initDatabase(dbPath) {
   const mnemeDir = path3.dirname(dbPath);
@@ -568,6 +598,52 @@ async function parseTranscriptIncremental(transcriptPath, lastSavedLine) {
 
 // lib/save/index.ts
 var { DatabaseSync: DatabaseSync3 } = await import("node:sqlite");
+function normalizeFilePath(absPath, projectPath) {
+  if (!absPath.startsWith(projectPath)) return null;
+  return absPath.slice(projectPath.length).replace(/^\//, "");
+}
+var IGNORED_PREFIXES = [
+  "node_modules/",
+  "dist/",
+  ".git/",
+  ".mneme/",
+  ".claude/"
+];
+var IGNORED_FILES = ["package-lock.json", "pnpm-lock.yaml", "yarn.lock"];
+function isIgnoredPath(relativePath) {
+  return IGNORED_PREFIXES.some((p) => relativePath.startsWith(p)) || IGNORED_FILES.includes(relativePath);
+}
+function indexFilePaths(fileIndexStmt, interaction, mnemeSessionId, projectPath) {
+  const seen = /* @__PURE__ */ new Set();
+  const add = (absPath, toolName) => {
+    const normalized = normalizeFilePath(absPath, projectPath);
+    if (!normalized || isIgnoredPath(normalized) || seen.has(normalized))
+      return;
+    seen.add(normalized);
+    try {
+      fileIndexStmt.run(
+        mnemeSessionId,
+        projectPath,
+        normalized,
+        toolName,
+        interaction.timestamp
+      );
+    } catch {
+    }
+  };
+  for (const td of interaction.toolDetails) {
+    if (typeof td.detail === "string" && td.detail.startsWith("/")) {
+      add(td.detail, td.name);
+    }
+  }
+  if (interaction.toolResults) {
+    for (const tr of interaction.toolResults) {
+      if (tr.filePath?.startsWith("/")) {
+        add(tr.filePath, tr.toolName || "");
+      }
+    }
+  }
+}
 async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
   if (!claudeSessionId || !transcriptPath || !projectPath) {
     return {
@@ -613,6 +689,10 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
       owner, role, content, thinking, tool_calls, timestamp, is_compact_summary
     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `);
+  const fileIndexStmt = db.prepare(`
+    INSERT INTO file_index (session_id, project_path, file_path, tool_name, timestamp)
+    VALUES (?, ?, ?, ?, ?)
+  `);
   let insertedCount = 0;
   let lastTimestamp = saveState.lastSavedTimestamp || "";
   for (const interaction of interactions) {
@@ -676,6 +756,7 @@ async function incrementalSave(claudeSessionId, transcriptPath, projectPath) {
         );
         insertedCount++;
       }
+      indexFilePaths(fileIndexStmt, interaction, mnemeSessionId, projectPath);
       lastTimestamp = interaction.timestamp;
     } catch (error) {
       console.error(`[mneme] Error inserting interaction: ${error}`);