claude-memory-layer 1.0.15 → 1.0.17

package/README.md

@@ -71,6 +71,9 @@ npx claude-memory-layer search "배포 이슈"
   - `GET /health` (서버 헬스)
   - `GET /api/health` (outbox pending/failed 포함 상세 헬스)
   - `GET /api/stats/retrieval-traces` (검색→컨텍스트 채택 추적)
+- 주입 임계값 튜닝(환경변수):
+  - `CLAUDE_MEMORY_MIN_SCORE` (기본 0.4)
+  - `CLAUDE_MEMORY_FALLBACK_MIN_SCORE` (기본 0.3, 결과 0건일 때 재시도)
 
 ---
 

package/dist/cli/index.js

@@ -2046,49 +2046,62 @@ var SQLiteEventStore = class {
   }
   async getRecentRetrievalTraces(limit = 50) {
     await this.initialize();
-    const rows = sqliteAll(
-      this.db,
-      `SELECT * FROM retrieval_traces ORDER BY created_at DESC LIMIT ?`,
-      [limit]
-    );
-    return rows.map((row) => ({
-      traceId: row.trace_id,
-      sessionId: row.session_id || void 0,
-      projectHash: row.project_hash || void 0,
-      queryText: row.query_text,
-      strategy: row.strategy || void 0,
-      candidateEventIds: row.candidate_event_ids ? JSON.parse(row.candidate_event_ids) : [],
-      selectedEventIds: row.selected_event_ids ? JSON.parse(row.selected_event_ids) : [],
-      candidateDetails: row.candidate_details_json ? JSON.parse(row.candidate_details_json) : [],
-      selectedDetails: row.selected_details_json ? JSON.parse(row.selected_details_json) : [],
-      candidateCount: Number(row.candidate_count || 0),
-      selectedCount: Number(row.selected_count || 0),
-      confidence: row.confidence || void 0,
-      fallbackTrace: row.fallback_trace ? JSON.parse(row.fallback_trace) : [],
-      createdAt: toDateFromSQLite(row.created_at)
-    }));
+    try {
+      const rows = sqliteAll(
+        this.db,
+        `SELECT * FROM retrieval_traces ORDER BY created_at DESC LIMIT ?`,
+        [limit]
+      );
+      return rows.map((row) => ({
+        traceId: row.trace_id,
+        sessionId: row.session_id || void 0,
+        projectHash: row.project_hash || void 0,
+        queryText: row.query_text,
+        strategy: row.strategy || void 0,
+        candidateEventIds: row.candidate_event_ids ? JSON.parse(row.candidate_event_ids) : [],
+        selectedEventIds: row.selected_event_ids ? JSON.parse(row.selected_event_ids) : [],
+        candidateDetails: row.candidate_details_json ? JSON.parse(row.candidate_details_json) : [],
+        selectedDetails: row.selected_details_json ? JSON.parse(row.selected_details_json) : [],
+        candidateCount: Number(row.candidate_count || 0),
+        selectedCount: Number(row.selected_count || 0),
+        confidence: row.confidence || void 0,
+        fallbackTrace: row.fallback_trace ? JSON.parse(row.fallback_trace) : [],
+        createdAt: toDateFromSQLite(row.created_at)
+      }));
+    } catch (err) {
+      if (err?.message?.includes("no such table"))
+        return [];
+      throw err;
+    }
   }
   async getRetrievalTraceStats() {
     await this.initialize();
-    const row = sqliteGet(
-      this.db,
-      `SELECT
-        COUNT(*) as total_queries,
-        AVG(candidate_count) as avg_candidate_count,
-        AVG(selected_count) as avg_selected_count,
-        CASE
-          WHEN SUM(candidate_count) > 0 THEN (SUM(selected_count) * 1.0 / SUM(candidate_count))
-          ELSE 0
-        END as selection_rate
-       FROM retrieval_traces`,
-      []
-    );
-    return {
-      totalQueries: Number(row?.total_queries || 0),
-      avgCandidateCount: Number(row?.avg_candidate_count || 0),
-      avgSelectedCount: Number(row?.avg_selected_count || 0),
-      selectionRate: Number(row?.selection_rate || 0)
-    };
+    try {
+      const row = sqliteGet(
+        this.db,
+        `SELECT
+          COUNT(*) as total_queries,
+          AVG(candidate_count) as avg_candidate_count,
+          AVG(selected_count) as avg_selected_count,
+          CASE
+            WHEN SUM(candidate_count) > 0 THEN (SUM(selected_count) * 1.0 / SUM(candidate_count))
+            ELSE 0
+          END as selection_rate
+         FROM retrieval_traces`,
+        []
+      );
+      return {
+        totalQueries: Number(row?.total_queries || 0),
+        avgCandidateCount: Number(row?.avg_candidate_count || 0),
+        avgSelectedCount: Number(row?.avg_selected_count || 0),
+        selectionRate: Number(row?.selection_rate || 0)
+      };
+    } catch (err) {
+      if (err?.message?.includes("no such table")) {
+        return { totalQueries: 0, avgCandidateCount: 0, avgSelectedCount: 0, selectionRate: 0 };
+      }
+      throw err;
+    }
   }
   /**
    * Close database connection
@@ -9214,41 +9227,51 @@ function saveClaudeSettings(settings) {
   fs9.writeFileSync(tempPath, JSON.stringify(settings, null, 2));
   fs9.renameSync(tempPath, CLAUDE_SETTINGS_PATH);
 }
+var REQUIRED_HOOK_FILES = [
+  "user-prompt-submit.js",
+  "post-tool-use.js",
+  "session-start.js",
+  "stop.js",
+  "session-end.js"
+];
+function hasHook(settings, hookName, commandFragment) {
+  const hookEntries = settings.hooks?.[hookName];
+  if (!hookEntries)
+    return false;
+  return hookEntries.some((entry) => entry.hooks?.some((hook) => hook.command?.includes(commandFragment)));
+}
 function getHooksConfig(pluginPath) {
+  const makeHook = (fileName) => [
+    {
+      matcher: "",
+      hooks: [
+        {
+          type: "command",
+          command: `node ${path9.join(pluginPath, "hooks", fileName)}`
+        }
+      ]
+    }
+  ];
   return {
-    UserPromptSubmit: [
-      {
-        matcher: "",
-        hooks: [
-          {
-            type: "command",
-            command: `node ${path9.join(pluginPath, "hooks", "user-prompt-submit.js")}`
-          }
-        ]
-      }
-    ],
-    PostToolUse: [
-      {
-        matcher: "",
-        hooks: [
-          {
-            type: "command",
-            command: `node ${path9.join(pluginPath, "hooks", "post-tool-use.js")}`
-          }
-        ]
-      }
-    ]
+    SessionStart: makeHook("session-start.js"),
+    UserPromptSubmit: makeHook("user-prompt-submit.js"),
+    PostToolUse: makeHook("post-tool-use.js"),
+    Stop: makeHook("stop.js"),
+    SessionEnd: makeHook("session-end.js")
   };
 }
 var program = new Command();
-program.name("claude-memory-layer").description("Claude Code Memory Plugin CLI").version("1.0.15");
+program.name("claude-memory-layer").description("Claude Code Memory Plugin CLI").version("1.0.17");
 program.command("install").description("Install hooks into Claude Code settings").option("--path <path>", "Custom plugin path (defaults to auto-detect)").action(async (options) => {
   try {
     const pluginPath = options.path || getPluginPath();
-    const userPromptHook = path9.join(pluginPath, "hooks", "user-prompt-submit.js");
-    if (!fs9.existsSync(userPromptHook)) {
+    const missingHooks = REQUIRED_HOOK_FILES.filter(
+      (file) => !fs9.existsSync(path9.join(pluginPath, "hooks", file))
+    );
+    if (missingHooks.length > 0) {
       console.error(`
 \u274C Hook files not found at: ${pluginPath}`);
+      console.error(`   Missing: ${missingHooks.join(", ")}`);
       console.error('   Make sure you have built the plugin with "npm run build"');
       process.exit(1);
     }
@@ -9261,8 +9284,11 @@ program.command("install").description("Install hooks into Claude Code settings"
     saveClaudeSettings(settings);
     console.log("\n\u2705 Claude Memory Layer installed!\n");
     console.log("Hooks registered:");
+    console.log("  - SessionStart: Register session -> project mapping");
     console.log("  - UserPromptSubmit: Memory retrieval on user input");
-    console.log("  - PostToolUse: Store tool observations\n");
+    console.log("  - PostToolUse: Store tool observations");
+    console.log("  - Stop: Store assistant responses");
+    console.log("  - SessionEnd: Persist session summary\n");
     console.log("Plugin path:", pluginPath);
     console.log("\n\u26A0\uFE0F  Restart Claude Code for changes to take effect.\n");
     console.log("Commands:");
@@ -9282,8 +9308,11 @@ program.command("uninstall").description("Remove hooks from Claude Code settings
       console.log("\n\u{1F4CB} No hooks installed.\n");
       return;
     }
+    delete settings.hooks.SessionStart;
     delete settings.hooks.UserPromptSubmit;
     delete settings.hooks.PostToolUse;
+    delete settings.hooks.Stop;
+    delete settings.hooks.SessionEnd;
     if (Object.keys(settings.hooks).length === 0) {
       delete settings.hooks;
     }
@@ -9303,23 +9332,25 @@ program.command("status").description("Check plugin installation status").action
     const settings = loadClaudeSettings();
     const pluginPath = getPluginPath();
     console.log("\n\u{1F9E0} Claude Memory Layer Status\n");
-    const hasUserPromptHook = settings.hooks?.UserPromptSubmit?.some(
-      (h) => h.hooks?.some((hook) => hook.command?.includes("user-prompt-submit"))
-    );
-    const hasPostToolHook = settings.hooks?.PostToolUse?.some(
-      (h) => h.hooks?.some((hook) => hook.command?.includes("post-tool-use"))
-    );
+    const hasSessionStartHook = hasHook(settings, "SessionStart", "session-start");
+    const hasUserPromptHook = hasHook(settings, "UserPromptSubmit", "user-prompt-submit");
+    const hasPostToolHook = hasHook(settings, "PostToolUse", "post-tool-use");
+    const hasStopHook = hasHook(settings, "Stop", "stop");
+    const hasSessionEndHook = hasHook(settings, "SessionEnd", "session-end");
     console.log("Hooks:");
+    console.log(`  SessionStart: ${hasSessionStartHook ? "\u2705 Installed" : "\u274C Not installed"}`);
     console.log(`  UserPromptSubmit: ${hasUserPromptHook ? "\u2705 Installed" : "\u274C Not installed"}`);
     console.log(`  PostToolUse: ${hasPostToolHook ? "\u2705 Installed" : "\u274C Not installed"}`);
-    const hooksExist = fs9.existsSync(path9.join(pluginPath, "hooks", "user-prompt-submit.js"));
+    console.log(`  Stop: ${hasStopHook ? "\u2705 Installed" : "\u274C Not installed"}`);
+    console.log(`  SessionEnd: ${hasSessionEndHook ? "\u2705 Installed" : "\u274C Not installed"}`);
+    const hooksExist = REQUIRED_HOOK_FILES.every((file) => fs9.existsSync(path9.join(pluginPath, "hooks", file)));
     console.log(`
 Plugin files: ${hooksExist ? "\u2705 Found" : "\u274C Not found"}`);
     console.log(`  Path: ${pluginPath}`);
     const dashboardRunning = await isServerRunning(37777);
     console.log(`
 Dashboard: ${dashboardRunning ? "\u2705 Running at http://localhost:37777" : "\u23F9\uFE0F  Not running"}`);
-    if (!hasUserPromptHook || !hasPostToolHook) {
+    if (!hasSessionStartHook || !hasUserPromptHook || !hasPostToolHook || !hasStopHook || !hasSessionEndHook) {
       console.log('\n\u{1F4A1} Run "claude-memory-layer install" to set up hooks.\n');
     } else {
       console.log("\n\u2705 Plugin is fully installed and configured.\n");