@hir4ta/mneme 0.24.0 → 0.24.2

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

package/README.ja.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.24.0-blue)
+![Version](https://img.shields.io/badge/version-0.24.2-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)
@@ -127,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`

package/README.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.24.0-blue)
+![Version](https://img.shields.io/badge/version-0.24.2-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)
@@ -127,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`

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}`);

package/dist/lib/search/prompt.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // lib/search/prompt.ts
-import * as fs6 from "node:fs";
-import * as path6 from "node:path";
+import * as fs7 from "node:fs";
+import * as path7 from "node:path";
 
 // lib/search/approved-rules.ts
 import * as fs4 from "node:fs";
@@ -282,6 +282,158 @@ function walkJsonFiles(dir, callback) {
   }
 }
 
+// lib/search/stopwords.ts
+var ENGLISH_STOPWORDS = /* @__PURE__ */ new Set([
+  // Articles & determiners
+  "the",
+  "this",
+  "that",
+  "these",
+  "those",
+  "some",
+  "any",
+  "all",
+  "each",
+  "every",
+  "both",
+  "other",
+  // Pronouns
+  "you",
+  "your",
+  "its",
+  "his",
+  "her",
+  "our",
+  "their",
+  "them",
+  "they",
+  "who",
+  "whom",
+  "which",
+  // Prepositions & conjunctions
+  "for",
+  "with",
+  "from",
+  "into",
+  "about",
+  "between",
+  "through",
+  "during",
+  "before",
+  "after",
+  "above",
+  "below",
+  "under",
+  "and",
+  "but",
+  "nor",
+  "not",
+  "than",
+  "then",
+  "also",
+  "once",
+  "again",
+  "further",
+  "such",
+  "same",
+  "few",
+  "more",
+  "most",
+  "too",
+  "own",
+  // Common verbs (non-technical)
+  "are",
+  "was",
+  "were",
+  "been",
+  "being",
+  "have",
+  "has",
+  "had",
+  "does",
+  "did",
+  "will",
+  "would",
+  "could",
+  "should",
+  "shall",
+  "might",
+  "must",
+  "can",
+  // Prompt noise
+  "please",
+  "help",
+  "want",
+  "need",
+  "like",
+  "just",
+  "only",
+  "very",
+  "really",
+  "here",
+  "there",
+  "what",
+  "when",
+  "where",
+  "how",
+  "why",
+  "let",
+  "make",
+  "way",
+  "tell"
+]);
+var JAPANESE_STOPWORDS = /* @__PURE__ */ new Set([
+  // Common prompt phrases (split on whitespace, so these appear as tokens)
+  "\u304F\u3060\u3055\u3044",
+  "\u306B\u3064\u3044\u3066",
+  "\u3064\u3044\u3066",
+  "\u3057\u307E\u3059",
+  "\u3057\u3066\u3044\u308B",
+  "\u3057\u3066\u308B",
+  "\u3067\u304D\u308B",
+  "\u3067\u304D\u307E\u3059",
+  "\u3067\u3059\u304B",
+  "\u3042\u308A\u307E\u3059\u304B",
+  "\u3042\u308A\u307E\u305B\u3093",
+  "\u3042\u308A\u307E\u3057\u305F",
+  "\u3067\u3059\u304C",
+  "\u3067\u3059\u3051\u3069",
+  "\u3067\u3059\u306E\u3067",
+  "\u3067\u3059\u304B\u3089",
+  "\u3067\u3059\u306D",
+  "\u3067\u3059\u3088",
+  "\u3057\u307E\u3057\u3087\u3046",
+  "\u3057\u3088\u3046",
+  "\u3057\u305F\u3044",
+  "\u3057\u305F\u3044\u3067\u3059",
+  "\u307B\u3057\u3044",
+  "\u307B\u3057\u3044\u3067\u3059",
+  "\u3042\u308A\u304C\u3068\u3046",
+  "\u304A\u306D\u304C\u3044",
+  "\u304A\u9858\u3044",
+  "\u6559\u3048\u3066",
+  "\u898B\u305B\u3066",
+  "\u3084\u3063\u3066",
+  "\u3069\u3046\u3084\u3063\u3066",
+  "\u306A\u305C",
+  "\u3069\u3046",
+  "\u3069\u306E",
+  "\u305D\u306E",
+  "\u3053\u306E",
+  "\u3042\u306E",
+  "\u305D\u308C",
+  "\u3053\u308C",
+  "\u3042\u308C"
+]);
+var ALL_STOPWORDS = /* @__PURE__ */ new Set([...ENGLISH_STOPWORDS, ...JAPANESE_STOPWORDS]);
+function isStopword(token) {
+  return ALL_STOPWORDS.has(token.toLowerCase());
+}
+function removeStopwords(tokens) {
+  const filtered = tokens.filter((t) => !isStopword(t));
+  return filtered.length > 0 ? filtered : tokens;
+}
+
 // lib/search/approved-rules.ts
 function isApproved(status) {
   if (typeof status !== "string") return false;
@@ -428,7 +580,9 @@ function searchPatternFiles(mnemeDir, pattern) {
 }
 function searchApprovedRules(options) {
   const { query, mnemeDir, limit = 5 } = options;
-  const keywords = query.toLowerCase().split(/\s+/).map((t) => t.trim()).filter((t) => t.length > 2);
+  const keywords = removeStopwords(
+    query.toLowerCase().split(/\s+/).map((t) => t.trim()).filter((t) => t.length > 2)
+  );
   if (keywords.length === 0) return [];
   const expanded = expandKeywordsWithAliases(keywords, loadTags(mnemeDir));
   const pattern = new RegExp(expanded.map(escapeRegex).join("|"), "i");
@@ -563,6 +717,14 @@ function searchSessions(mnemeDir, keywords, limit = 5, detail = "compact") {
         score += 2;
         matchedFields.push("errors");
       }
+      if (session.technologies?.some((t) => pattern.test(t))) {
+        score += 1.5;
+        matchedFields.push("technologies");
+      }
+      if (session.filesModified?.some((f) => pattern.test(f.path))) {
+        score += 1;
+        matchedFields.push("filesModified");
+      }
       if (score === 0 && keywords.length <= 2) {
         const titleWords = (title || "").toLowerCase().split(/\s+/);
         const tagWords = session.tags || [];
@@ -613,7 +775,9 @@ function searchKnowledge(options) {
     offset = 0,
     detail = "compact"
   } = options;
-  const keywords = query.toLowerCase().split(/\s+/).map((token) => token.trim()).filter((token) => token.length > 2);
+  const keywords = removeStopwords(
+    query.toLowerCase().split(/\s+/).map((token) => token.trim()).filter((token) => token.length > 2)
+  );
   if (keywords.length === 0) return [];
   const expandedKeywords = expandKeywordsWithAliases(
     keywords,
@@ -648,6 +812,55 @@ function searchKnowledge(options) {
   }).slice(safeOffset, safeOffset + limit);
 }
 
+// lib/search/file-search.ts
+import * as fs6 from "node:fs";
+import * as path6 from "node:path";
+function getSessionTitle(mnemeDir, sessionId) {
+  const sessionsDir = path6.join(mnemeDir, "sessions");
+  let title = sessionId;
+  walkJsonFiles(sessionsDir, (filePath) => {
+    if (!path6.basename(filePath, ".json").startsWith(sessionId)) return;
+    try {
+      const data = JSON.parse(fs6.readFileSync(filePath, "utf-8"));
+      if (data.title) title = data.title;
+    } catch {
+    }
+  });
+  return title;
+}
+function searchByFiles(database, projectPath, filePaths, mnemeDir, limit = 3) {
+  if (filePaths.length === 0) return [];
+  try {
+    const placeholders = filePaths.map(() => "?").join(",");
+    const rows = database.prepare(
+      `SELECT session_id, file_path, COUNT(*) as cnt
+       FROM file_index
+       WHERE project_path = ? AND file_path IN (${placeholders})
+       GROUP BY session_id, file_path`
+    ).all(projectPath, ...filePaths);
+    const sessionMap = /* @__PURE__ */ new Map();
+    for (const row of rows) {
+      const entry = sessionMap.get(row.session_id) || {
+        files: /* @__PURE__ */ new Set(),
+        count: 0
+      };
+      entry.files.add(row.file_path);
+      entry.count += row.cnt;
+      sessionMap.set(row.session_id, entry);
+    }
+    return [...sessionMap.entries()].sort(
+      (a, b) => b[1].files.size - a[1].files.size || b[1].count - a[1].count
+    ).slice(0, limit).map(([sessionId, data]) => ({
+      sessionId,
+      title: getSessionTitle(mnemeDir, sessionId),
+      matchedFiles: [...data.files],
+      fileCount: data.count
+    }));
+  } catch {
+    return [];
+  }
+}
+
 // lib/search/prompt.ts
 var originalEmit = process.emit;
 process.emit = (event, ...args) => {
@@ -666,17 +879,18 @@ function main() {
   const query = getArg(args, "query");
   const projectPath = getArg(args, "project");
   const limit = Number.parseInt(getArg(args, "limit") || "5", 10);
+  const files = getArg(args, "files");
   if (!query || !projectPath) {
     console.log(
       JSON.stringify({ success: false, error: "Missing required args" })
     );
     process.exit(1);
   }
-  const mnemeDir = path6.join(projectPath, ".mneme");
-  const dbPath = path6.join(mnemeDir, "local.db");
+  const mnemeDir = path7.join(projectPath, ".mneme");
+  const dbPath = path7.join(mnemeDir, "local.db");
   let database = null;
   try {
-    if (fs6.existsSync(dbPath)) {
+    if (fs7.existsSync(dbPath)) {
       database = new DatabaseSync(dbPath);
       database.exec("PRAGMA journal_mode = WAL");
     }
@@ -688,7 +902,10 @@ function main() {
       limit: Number.isFinite(limit) ? Math.max(1, Math.min(limit, 10)) : 5
     });
     const rules = searchApprovedRules({ query, mnemeDir, limit: 5 });
-    console.log(JSON.stringify({ success: true, results, rules }));
+    const fileRecommendations = files && database ? searchByFiles(database, projectPath, files.split(","), mnemeDir) : [];
+    console.log(
+      JSON.stringify({ success: true, results, rules, fileRecommendations })
+    );
   } catch (error) {
     console.log(
       JSON.stringify({ success: false, error: error.message })