@hir4ta/mneme 0.22.0 → 0.22.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.22.0",
+  "version": "0.22.2",
   "author": {
     "name": "hir4ta"
   },

package/README.ja.md

@@ -1,5 +1,7 @@
 # mneme
 
+![Version](https://img.shields.io/badge/version-0.22.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)
 
@@ -24,7 +26,11 @@ Claude Codeの長期記憶を実現するプラグイン
 
 Claude Codeのセッションは終了やAuto-Compactで文脈が失われ、過去の判断が追えず、知見の再利用が困難です。
 
-**mnemeでの解決**: 自動保存と再開、毎プロンプトでの自動記憶検索、判断・パターン履歴の検索・ダッシュボード参照。`.mneme/` のJSONはGit管理可能で、チームでの知見共有にも対応します。
+**よくある問題**: セッション間での文脈喪失、同じミスの繰り返し、不透明な設計判断
+
+**mnemeでの解決**: 自動保存と再開、毎プロンプトでの自動記憶検索、判断・パターン履歴の検索
+
+**チームでの利点**: `.mneme/` のJSONファイルはGit管理され、判断やセッション履歴をチームで共有できます。
 
 ## インストール
 

package/README.md

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

package/dist/lib/session-finalize.js

@@ -875,15 +875,26 @@ async function sessionFinalize(sessionId, cwd, transcriptPath, cleanupPolicy, gr
           console.error(
             `[mneme] Session ended without /mneme:save - cleaned up ${cleanupResult.count} interactions`
           );
+          fs3.unlinkSync(sessionFile);
+          const linkFile = path3.join(sessionLinksDir, `${sessionShortId}.json`);
+          if (fs3.existsSync(linkFile)) {
+            fs3.unlinkSync(linkFile);
+          }
+          console.error(
+            "[mneme] Session completed (not saved, cleaned up immediately)"
+          );
+        } else {
+          data.status = "complete";
+          data.endedAt = now;
+          data.updatedAt = now;
+          delete data.uncommitted;
+          delete data.interactions;
+          delete data.preCompactBackups;
+          safeWriteJson(sessionFile, data);
+          console.error(
+            "[mneme] Session completed (committed in SQLite, kept despite missing summary)"
+          );
         }
-        fs3.unlinkSync(sessionFile);
-        const linkFile = path3.join(sessionLinksDir, `${sessionShortId}.json`);
-        if (fs3.existsSync(linkFile)) {
-          fs3.unlinkSync(linkFile);
-        }
-        console.error(
-          "[mneme] Session completed (not saved, cleaned up immediately)"
-        );
       } else if (cleanupPolicy === "never") {
         console.error(
           "[mneme] Session completed (not saved, kept as uncommitted)"

package/dist/servers/db-server.js

@@ -31069,6 +31069,14 @@ async function saveInteractions(claudeSessionId, mnemeSessionId) {
     ...interaction,
     id: `int-${String(idx + 1).padStart(3, "0")}`
   }));
+  if (finalInteractions.length === 0) {
+    return {
+      success: true,
+      savedCount: 0,
+      mergedFromBackup: backupInteractions.length,
+      message: "No interactions to save (transcript may have no text user messages). Existing data preserved."
+    };
+  }
   try {
     const deleteStmt = database.prepare(
       "DELETE FROM interactions WHERE session_id = ?"
@@ -31377,6 +31385,147 @@ server.registerTool(
     };
   }
 );
+server.registerTool(
+  "mneme_update_session_summary",
+  {
+    description: "Update session JSON file with summary data. MUST be called during /mneme:save Phase 3 to persist session metadata. Creates the session file if it does not exist (e.g. when SessionStart hook was skipped).",
+    inputSchema: {
+      claudeSessionId: external_exports3.string().min(8).describe("Full Claude Code session UUID (36 chars)"),
+      title: external_exports3.string().describe("Session title"),
+      summary: external_exports3.object({
+        goal: external_exports3.string().describe("What the session aimed to accomplish"),
+        outcome: external_exports3.string().describe("What was actually accomplished"),
+        description: external_exports3.string().optional().describe("Detailed description of the session")
+      }).describe("Session summary object"),
+      tags: external_exports3.array(external_exports3.string()).optional().describe("Semantic tags for the session"),
+      sessionType: external_exports3.string().optional().describe(
+        "Session type (e.g. implementation, research, bugfix, refactor)"
+      )
+    }
+  },
+  async ({ claudeSessionId, title, summary, tags, sessionType }) => {
+    if (!claudeSessionId.trim()) {
+      return fail("claudeSessionId must not be empty.");
+    }
+    const projectPath = getProjectPath();
+    const sessionsDir = path4.join(projectPath, ".mneme", "sessions");
+    const shortId = claudeSessionId.slice(0, 8);
+    let sessionFile = null;
+    const searchDir = (dir) => {
+      if (!fs4.existsSync(dir)) return null;
+      for (const entry of fs4.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path4.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          const result = searchDir(fullPath);
+          if (result) return result;
+        } else if (entry.name === `${shortId}.json`) {
+          return fullPath;
+        }
+      }
+      return null;
+    };
+    sessionFile = searchDir(sessionsDir);
+    if (!sessionFile) {
+      const now = /* @__PURE__ */ new Date();
+      const yearMonth = path4.join(
+        sessionsDir,
+        String(now.getFullYear()),
+        String(now.getMonth() + 1).padStart(2, "0")
+      );
+      if (!fs4.existsSync(yearMonth)) {
+        fs4.mkdirSync(yearMonth, { recursive: true });
+      }
+      sessionFile = path4.join(yearMonth, `${shortId}.json`);
+      const initial = {
+        id: shortId,
+        sessionId: claudeSessionId,
+        createdAt: now.toISOString(),
+        title: "",
+        tags: [],
+        context: {
+          projectDir: projectPath,
+          projectName: path4.basename(projectPath)
+        },
+        metrics: {
+          userMessages: 0,
+          assistantResponses: 0,
+          thinkingBlocks: 0,
+          toolUsage: []
+        },
+        files: [],
+        status: null
+      };
+      fs4.writeFileSync(sessionFile, JSON.stringify(initial, null, 2));
+    }
+    const data = readJsonFile(sessionFile) ?? {};
+    data.title = title;
+    data.summary = summary;
+    data.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    if (tags) data.tags = tags;
+    if (sessionType) data.sessionType = sessionType;
+    const transcriptPath = getTranscriptPath(claudeSessionId);
+    if (transcriptPath) {
+      try {
+        const parsed = await parseTranscript(transcriptPath);
+        data.metrics = {
+          userMessages: parsed.metrics.userMessages,
+          assistantResponses: parsed.metrics.assistantResponses,
+          thinkingBlocks: parsed.metrics.thinkingBlocks,
+          toolUsage: parsed.toolUsage
+        };
+        if (parsed.files.length > 0) {
+          data.files = parsed.files;
+        }
+      } catch {
+      }
+    }
+    const ctx = data.context;
+    if (ctx && !ctx.repository) {
+      try {
+        const { execSync } = await import("node:child_process");
+        const cwd = ctx.projectDir || projectPath;
+        const branch = execSync("git rev-parse --abbrev-ref HEAD", {
+          encoding: "utf8",
+          cwd
+        }).trim();
+        if (branch) ctx.branch = branch;
+        const remoteUrl = execSync("git remote get-url origin", {
+          encoding: "utf8",
+          cwd
+        }).trim();
+        const repoMatch = remoteUrl.match(/[:/]([^/]+\/[^/]+?)(\.git)?$/);
+        if (repoMatch) ctx.repository = repoMatch[1].replace(/\.git$/, "");
+        const userName = execSync("git config user.name", {
+          encoding: "utf8",
+          cwd
+        }).trim();
+        const userEmail = execSync("git config user.email", {
+          encoding: "utf8",
+          cwd
+        }).trim();
+        if (userName)
+          ctx.user = {
+            name: userName,
+            ...userEmail ? { email: userEmail } : {}
+          };
+      } catch {
+      }
+    }
+    fs4.writeFileSync(sessionFile, JSON.stringify(data, null, 2));
+    markSessionCommitted(claudeSessionId);
+    return ok(
+      JSON.stringify(
+        {
+          success: true,
+          sessionFile: sessionFile.replace(projectPath, "."),
+          shortId
+        },
+        null,
+        2
+      )
+    );
+  }
+);
 server.registerTool(
   "mneme_mark_session_committed",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hir4ta/mneme",
-  "version": "0.22.0",
+  "version": "0.22.2",
   "description": "Long-term memory plugin for Claude Code - automated session saving, recording technical decisions, and web dashboard",
   "keywords": [
     "claude",

package/scripts/export-weekly-knowledge-html.ts

@@ -45,6 +45,7 @@ interface UnitItem {
   tags: string[];
   sourceType: "decision" | "pattern" | "rule";
   sourceId: string;
+  sourceRefs: Array<{ type: "decision" | "pattern" | "rule"; id: string }>;
   status: "pending" | "approved" | "rejected";
   createdAt: string;
   updatedAt: string;
@@ -271,11 +272,11 @@ function renderHtml(params: {
     {
       en:
         pendingUnits.length > 0
-          ? `Pending approvals remain (${pendingUnits.length}). Prioritize high-impact units first.`
-          : "No pending units. Approval queue is healthy.",
+          ? `Pending approvals remain (${pendingUnits.length}). Prioritize high-impact dev rules first.`
+          : "No pending dev rules. Approval queue is healthy.",
       ja:
         pendingUnits.length > 0
-          ? `承認待ちユニットが ${pendingUnits.length} 件あります。影響の大きいものから優先承認してください。`
+          ? `承認待ちの開発ルールが ${pendingUnits.length} 件あります。影響の大きいものから優先承認してください。`
           : "承認待ちはありません。承認キューは健全です。",
     },
     {
@@ -291,11 +292,11 @@ function renderHtml(params: {
     {
       en:
         newPatterns.length > 0
-          ? `New patterns detected (${newPatterns.length}). Promote stable ones to approved units.`
+          ? `New patterns detected (${newPatterns.length}). Promote stable ones to approved dev rules.`
           : "Low pattern capture. Run /mneme:save more frequently during debugging sessions.",
       ja:
         newPatterns.length > 0
-          ? `今週の新規パターンは ${newPatterns.length} 件です。安定したものは承認済みユニットへ昇格してください。`
+          ? `今週の新規パターンは ${newPatterns.length} 件です。安定したものは承認済み開発ルールへ昇格してください。`
           : "パターンの蓄積が少なめです。デバッグ中は /mneme:save をこまめに実行してください。",
     },
   ];
@@ -652,8 +653,8 @@ function renderHtml(params: {
             <span data-i18n="heroTitleJa">週次ナレッジスナップショット</span>
           </h1>
           <p>
-            <span data-i18n="heroDescEn">This week, your team captured and refined project knowledge across sessions, units, and source artifacts.</span>
-            <span data-i18n="heroDescJa">この1週間で、チームはセッション・ユニット・元データを通じて知見を蓄積し、整理しました。</span>
+            <span data-i18n="heroDescEn">This week, your team captured and refined project knowledge across sessions, development rules, and source artifacts.</span>
+            <span data-i18n="heroDescJa">この1週間で、チームはセッション・開発ルール・元データを通じて知見を蓄積し、整理しました。</span>
           </p>
           <div class="meta">
             <span data-i18n="metaEn">Period: ${formatDate(from)} to ${formatDate(to)} | Generated: ${generatedAt.toISOString()}</span>
@@ -671,9 +672,9 @@ function renderHtml(params: {
       <article class="kpi"><div class="label"><span data-i18n="kpiDecisionEn">New Decisions</span><span data-i18n="kpiDecisionJa">新規意思決定</span></div><div class="value">${newDecisions.length}</div></article>
       <article class="kpi"><div class="label"><span data-i18n="kpiPatternEn">New Patterns</span><span data-i18n="kpiPatternJa">新規パターン</span></div><div class="value">${newPatterns.length}</div></article>
       <article class="kpi"><div class="label"><span data-i18n="kpiRuleEn">Changed Rules</span><span data-i18n="kpiRuleJa">変更ルール</span></div><div class="value">${changedRules.length}</div></article>
-      <article class="kpi"><div class="label"><span data-i18n="kpiTouchedEn">Touched Units</span><span data-i18n="kpiTouchedJa">更新ユニット</span></div><div class="value">${touchedUnits.length}</div></article>
-      <article class="kpi"><div class="label"><span data-i18n="kpiApprovedEn">Approved Units</span><span data-i18n="kpiApprovedJa">承認済みユニット</span></div><div class="value">${approvedUnits.length}</div></article>
-      <article class="kpi"><div class="label"><span data-i18n="kpiPendingEn">Pending Units</span><span data-i18n="kpiPendingJa">承認待ちユニット</span></div><div class="value">${pendingUnits.length}</div></article>
+      <article class="kpi"><div class="label"><span data-i18n="kpiTouchedEn">Touched Dev Rules</span><span data-i18n="kpiTouchedJa">更新された開発ルール</span></div><div class="value">${touchedUnits.length}</div></article>
+      <article class="kpi"><div class="label"><span data-i18n="kpiApprovedEn">Approved Dev Rules</span><span data-i18n="kpiApprovedJa">承認済み開発ルール</span></div><div class="value">${approvedUnits.length}</div></article>
+      <article class="kpi"><div class="label"><span data-i18n="kpiPendingEn">Pending Dev Rules</span><span data-i18n="kpiPendingJa">承認待ち開発ルール</span></div><div class="value">${pendingUnits.length}</div></article>
     </section>
 
     <section class="section">
@@ -684,8 +685,8 @@ function renderHtml(params: {
           <div class="pulse-value">${approvalRate}%</div>
           <div class="meter"><i style="width:${approvalRate}%"></i></div>
           <div class="pulse-note">
-            <span data-i18n="pulseApprovalNoteEn">Among units touched this week, how many were approved.</span>
-            <span data-i18n="pulseApprovalNoteJa">今週更新されたユニットのうち、承認済みになった割合です。</span>
+            <span data-i18n="pulseApprovalNoteEn">Among dev rules touched this week, how many were approved.</span>
+            <span data-i18n="pulseApprovalNoteJa">今週更新された開発ルールのうち、承認済みになった割合です。</span>
           </div>
         </article>
         <article class="pulse">
@@ -702,8 +703,8 @@ function renderHtml(params: {
           <div class="pulse-value">${pendingUnits.length}</div>
           <div class="meter"><i style="width:${Math.min(100, pendingUnits.length * 10)}%"></i></div>
           <div class="pulse-note">
-            <span data-i18n="pulseQueueNoteEn">Units waiting for approval in the project-wide queue.</span>
-            <span data-i18n="pulseQueueNoteJa">プロジェクト全体で現在承認待ちのユニット件数です。</span>
+            <span data-i18n="pulseQueueNoteEn">Dev rules waiting for approval in the project-wide queue.</span>
+            <span data-i18n="pulseQueueNoteJa">プロジェクト全体で現在承認待ちの開発ルール件数です。</span>
           </div>
         </article>
       </div>

package/servers/db-server.ts

@@ -1009,6 +1009,17 @@ async function saveInteractions(
     id: `int-${String(idx + 1).padStart(3, "0")}`,
   }));
 
+  // Guard: don't delete existing data when there's nothing to insert
+  if (finalInteractions.length === 0) {
+    return {
+      success: true,
+      savedCount: 0,
+      mergedFromBackup: backupInteractions.length,
+      message:
+        "No interactions to save (transcript may have no text user messages). Existing data preserved.",
+    };
+  }
+
   // Delete existing interactions for this session
   try {
     const deleteStmt = database.prepare(
@@ -1422,6 +1433,185 @@ server.registerTool(
   },
 );
 
+// Tool: mneme_update_session_summary
+server.registerTool(
+  "mneme_update_session_summary",
+  {
+    description:
+      "Update session JSON file with summary data. " +
+      "MUST be called during /mneme:save Phase 3 to persist session metadata. " +
+      "Creates the session file if it does not exist (e.g. when SessionStart hook was skipped).",
+    inputSchema: {
+      claudeSessionId: z
+        .string()
+        .min(8)
+        .describe("Full Claude Code session UUID (36 chars)"),
+      title: z.string().describe("Session title"),
+      summary: z
+        .object({
+          goal: z.string().describe("What the session aimed to accomplish"),
+          outcome: z.string().describe("What was actually accomplished"),
+          description: z
+            .string()
+            .optional()
+            .describe("Detailed description of the session"),
+        })
+        .describe("Session summary object"),
+      tags: z
+        .array(z.string())
+        .optional()
+        .describe("Semantic tags for the session"),
+      sessionType: z
+        .string()
+        .optional()
+        .describe(
+          "Session type (e.g. implementation, research, bugfix, refactor)",
+        ),
+    },
+  },
+  async ({ claudeSessionId, title, summary, tags, sessionType }) => {
+    if (!claudeSessionId.trim()) {
+      return fail("claudeSessionId must not be empty.");
+    }
+
+    const projectPath = getProjectPath();
+    const sessionsDir = path.join(projectPath, ".mneme", "sessions");
+    const shortId = claudeSessionId.slice(0, 8);
+
+    // Find existing session file
+    let sessionFile: string | null = null;
+    const searchDir = (dir: string): string | null => {
+      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 === `${shortId}.json`) {
+          return fullPath;
+        }
+      }
+      return null;
+    };
+    sessionFile = searchDir(sessionsDir);
+
+    // Create session file if not found (SessionStart hook may not have run)
+    if (!sessionFile) {
+      const now = new Date();
+      const yearMonth = path.join(
+        sessionsDir,
+        String(now.getFullYear()),
+        String(now.getMonth() + 1).padStart(2, "0"),
+      );
+      if (!fs.existsSync(yearMonth)) {
+        fs.mkdirSync(yearMonth, { recursive: true });
+      }
+      sessionFile = path.join(yearMonth, `${shortId}.json`);
+      // Write minimal session JSON
+      const initial = {
+        id: shortId,
+        sessionId: claudeSessionId,
+        createdAt: now.toISOString(),
+        title: "",
+        tags: [],
+        context: {
+          projectDir: projectPath,
+          projectName: path.basename(projectPath),
+        },
+        metrics: {
+          userMessages: 0,
+          assistantResponses: 0,
+          thinkingBlocks: 0,
+          toolUsage: [],
+        },
+        files: [],
+        status: null,
+      };
+      fs.writeFileSync(sessionFile, JSON.stringify(initial, null, 2));
+    }
+
+    // Read, update, write
+    const data = readJsonFile<Record<string, unknown>>(sessionFile) ?? {};
+    data.title = title;
+    data.summary = summary;
+    data.updatedAt = new Date().toISOString();
+    if (tags) data.tags = tags;
+    if (sessionType) data.sessionType = sessionType;
+
+    // Enrich with transcript metrics/files if available
+    const transcriptPath = getTranscriptPath(claudeSessionId);
+    if (transcriptPath) {
+      try {
+        const parsed = await parseTranscript(transcriptPath);
+        data.metrics = {
+          userMessages: parsed.metrics.userMessages,
+          assistantResponses: parsed.metrics.assistantResponses,
+          thinkingBlocks: parsed.metrics.thinkingBlocks,
+          toolUsage: parsed.toolUsage,
+        };
+        if (parsed.files.length > 0) {
+          data.files = parsed.files;
+        }
+      } catch {
+        // Transcript parse failed, keep existing values
+      }
+    }
+
+    // Enrich context if minimal (missing repository info)
+    const ctx = data.context as Record<string, unknown> | undefined;
+    if (ctx && !ctx.repository) {
+      try {
+        const { execSync } = await import("node:child_process");
+        const cwd = (ctx.projectDir as string) || projectPath;
+        const branch = execSync("git rev-parse --abbrev-ref HEAD", {
+          encoding: "utf8",
+          cwd,
+        }).trim();
+        if (branch) ctx.branch = branch;
+        const remoteUrl = execSync("git remote get-url origin", {
+          encoding: "utf8",
+          cwd,
+        }).trim();
+        const repoMatch = remoteUrl.match(/[:/]([^/]+\/[^/]+?)(\.git)?$/);
+        if (repoMatch) ctx.repository = repoMatch[1].replace(/\.git$/, "");
+        const userName = execSync("git config user.name", {
+          encoding: "utf8",
+          cwd,
+        }).trim();
+        const userEmail = execSync("git config user.email", {
+          encoding: "utf8",
+          cwd,
+        }).trim();
+        if (userName)
+          ctx.user = {
+            name: userName,
+            ...(userEmail ? { email: userEmail } : {}),
+          };
+      } catch {
+        // Not a git repo or git not available
+      }
+    }
+
+    fs.writeFileSync(sessionFile, JSON.stringify(data, null, 2));
+
+    // Auto-commit: mark session as committed after successful summary write
+    // This ensures committed flag is set even if mneme_mark_session_committed is not called explicitly
+    markSessionCommitted(claudeSessionId);
+
+    return ok(
+      JSON.stringify(
+        {
+          success: true,
+          sessionFile: sessionFile.replace(projectPath, "."),
+          shortId,
+        },
+        null,
+        2,
+      ),
+    );
+  },
+);
+
 // Tool: mneme_mark_session_committed
 server.registerTool(
   "mneme_mark_session_committed",

package/skills/save/SKILL.md

@@ -4,7 +4,7 @@ description: |
   Extract and persist session outputs, then generate development rule candidates (decision/pattern/rule).
   Use when: (1) finishing meaningful implementation work, (2) capturing reusable guidance,
   (3) before ending a long session.
-disable-model-invocation: true
+disable-model-invocation: false
 ---
 
 # /mneme:save
@@ -41,11 +41,20 @@ Always render missing required fields as blocking errors before write.
 - Merge linked/resumed child sessions into the master session.
 
 2. **Interactions commit**
-- Save transcript interactions to `.mneme/local.db`.
-- Mark the Claude session committed.
+- Save transcript interactions to `.mneme/local.db` via `mneme_save_interactions`.
+- Do NOT call `mneme_mark_session_committed` yet (wait until after Phase 3).
 
-3. **Session summary extraction**
-- Update master session JSON (`title/goal/outcome/description/tags/sessionType`).
+3. **Session summary extraction (required MCP)**
+- Extract from the conversation: `title`, `goal`, `outcome`, `description`, `tags`, `sessionType`.
+- **MUST call `mneme_update_session_summary`** MCP tool with the extracted data.
+  This writes the summary to `.mneme/sessions/` JSON file, ensuring the session is preserved on SessionEnd.
+- **Then call `mneme_mark_session_committed`** to finalize the commit.
+
+<required>
+- Call `mneme_update_session_summary` with: `claudeSessionId`, `title`, `summary` (`goal`, `outcome`), `tags`, `sessionType`
+- Call `mneme_mark_session_committed` AFTER `mneme_update_session_summary` succeeds
+- Do NOT skip this step even for short/research sessions
+</required>
 
 4. **Decision extraction (source)**
 - Persist concrete choices and rationale to `decisions/YYYY/MM/*.json`.