@rlabs-inc/memory 0.1.0 → 0.2.0

package/dist/server/index.js

@@ -10773,9 +10773,15 @@ class Database {
       if (!id)
         continue;
       const record = this._columns.getRecord(index);
-      const withId = { id, ...record };
-      if (filter(withId)) {
-        results.push(withId);
+      const withMeta = {
+        id,
+        ...record,
+        created: this._created[index] || 0,
+        updated: this._updated[index] || 0,
+        stale: this._staleFlags[index] || false
+      };
+      if (filter(withMeta)) {
+        results.push(withMeta);
       }
     }
     return results;
@@ -10786,9 +10792,15 @@ class Database {
       if (!id)
         continue;
       const record = this._columns.getRecord(index);
-      const withId = { id, ...record };
-      if (filter(withId)) {
-        return withId;
+      const withMeta = {
+        id,
+        ...record,
+        created: this._created[index] || 0,
+        updated: this._updated[index] || 0,
+        stale: this._staleFlags[index] || false
+      };
+      if (filter(withMeta)) {
+        return withMeta;
       }
     }
     return null;
@@ -11142,9 +11154,12 @@ class MemoryStore {
   }
   async getProject(projectId) {
     if (this._projects.has(projectId)) {
+      console.log(`\uD83D\uDD04 [DEBUG] Returning cached databases for ${projectId}`);
       return this._projects.get(projectId);
     }
+    console.log(`\uD83C\uDD95 [DEBUG] Creating NEW databases for ${projectId}`);
     const projectPath = import_path2.join(this._config.basePath, projectId);
+    console.log(`   Path: ${projectPath}`);
     const [memories, summaries, snapshots, sessions] = await Promise.all([
       createDatabase({
         path: import_path2.join(projectPath, "memories"),
@@ -11329,20 +11344,31 @@ class MemoryStore {
   }
   async storeSessionSummary(projectId, sessionId, summary, interactionTone = "") {
     const { summaries } = await this.getProject(projectId);
-    return summaries.insert({
+    console.log(`\uD83D\uDCDD [DEBUG] Storing summary for ${projectId}:`);
+    console.log(`   Summary length: ${summary.length} chars`);
+    console.log(`   Summaries count before: ${summaries.all().length}`);
+    const id = await summaries.insert({
       session_id: sessionId,
       project_id: projectId,
       summary,
       interaction_tone: interactionTone
     });
+    console.log(`   Summaries count after: ${summaries.all().length}`);
+    console.log(`   Inserted ID: ${id}`);
+    return id;
   }
   async getLatestSummary(projectId) {
     const { summaries } = await this.getProject(projectId);
+    console.log(`\uD83D\uDCD6 [DEBUG] Getting latest summary for ${projectId}:`);
     const all = summaries.all();
-    if (!all.length)
+    console.log(`   Summaries found: ${all.length}`);
+    if (!all.length) {
+      console.log(`   No summaries found!`);
       return null;
+    }
     all.sort((a, b) => b.created - a.created);
     const latest = all[0];
+    console.log(`   Latest summary: ${latest.summary.slice(0, 50)}...`);
     return {
       id: latest.id,
       session_id: latest.session_id,
@@ -11727,6 +11753,12 @@ class MemoryEngine {
   }
   async _getStore(projectId, projectPath) {
     const key = this._config.storageMode === "local" && projectPath ? projectPath : projectId;
+    console.log(`\uD83C\uDFEA [DEBUG] _getStore called:`);
+    console.log(`   projectId: ${projectId}`);
+    console.log(`   projectPath: ${projectPath}`);
+    console.log(`   storageMode: ${this._config.storageMode}`);
+    console.log(`   cache key: ${key}`);
+    console.log(`   cached: ${this._stores.has(key)}`);
     if (this._stores.has(key)) {
       return this._stores.get(key);
     }
@@ -11900,14 +11932,31 @@ function createEngine(config) {
 }
 
 // src/core/curator.ts
+var import_os3 = require("os");
+var import_path5 = require("path");
+var import_fs3 = require("fs");
+function getClaudeCommand() {
+  const envCommand = process.env.CURATOR_COMMAND;
+  if (envCommand) {
+    return envCommand;
+  }
+  const claudeLocal = import_path5.join(import_os3.homedir(), ".claude", "local", "claude");
+  if (import_fs3.existsSync(claudeLocal)) {
+    return claudeLocal;
+  }
+  return "claude";
+}
+
 class Curator {
   _config;
   constructor(config = {}) {
+    const cliCommand = config.cliCommand ?? getClaudeCommand();
     this._config = {
       apiKey: config.apiKey ?? "",
-      cliCommand: config.cliCommand ?? "claude",
+      cliCommand,
       cliType: config.cliType ?? "claude-code"
     };
+    console.log(`\uD83E\uDDE0 Curator initialized with CLI: ${cliCommand}`);
   }
   buildCurationPrompt(triggerType = "session_end") {
     return `You have just had a conversation. As this session is ending (${triggerType}), please curate memories for the Claude Tools Memory System.
@@ -12101,33 +12150,96 @@ ${prompt}`
     return this.parseCurationResponse(content.text);
   }
   async curateWithCLI(sessionId, triggerType = "session_end", cwd) {
-    const prompt = this.buildCurationPrompt(triggerType);
+    const systemPrompt = this.buildCurationPrompt(triggerType);
+    const userMessage = "This session has ended. Please curate the memories from our conversation according to the instructions in your system prompt. Return ONLY the JSON structure.";
     const args = [];
     if (this._config.cliType === "claude-code") {
-      args.push("--resume", sessionId, "-p", prompt, "--output-format", "json", "--max-turns", "1");
+      args.push("--resume", sessionId, "-p", userMessage, "--append-system-prompt", systemPrompt, "--output-format", "json", "--max-turns", "1");
     } else {
-      args.push("--resume", sessionId, "-p", prompt, "--output-format", "json");
+      args.push("--resume", sessionId, "-p", `${systemPrompt}
+
+${userMessage}`, "--output-format", "json");
     }
+    console.log(`
+\uD83D\uDCCB Executing CLI command:`);
+    console.log(`   Command: ${this._config.cliCommand}`);
+    console.log(`   Args: --resume ${sessionId} -p [user_message] --append-system-prompt [curation_instructions] --output-format json --max-turns 1`);
+    console.log(`   CWD: ${cwd || "not set"}`);
+    console.log(`   User message: "${userMessage.slice(0, 50)}..."`);
+    console.log(`   System prompt length: ${systemPrompt.length} chars`);
     const proc = Bun.spawn([this._config.cliCommand, ...args], {
       cwd,
       env: {
         ...process.env,
         MEMORY_CURATOR_ACTIVE: "1"
-      }
+      },
+      stderr: "pipe"
     });
-    const output = await new Response(proc.stdout).text();
+    const [stdout, stderr] = await Promise.all([
+      new Response(proc.stdout).text(),
+      new Response(proc.stderr).text()
+    ]);
     const exitCode = await proc.exited;
+    console.log(`
+\uD83D\uDCE4 CLI Response:`);
+    console.log(`   Exit code: ${exitCode}`);
+    console.log(`   Stdout length: ${stdout.length} chars`);
+    console.log(`   Stderr length: ${stderr.length} chars`);
+    if (stderr) {
+      console.log(`
+⚠️ Stderr output:`);
+      console.log(stderr.slice(0, 1000));
+    }
+    if (stdout) {
+      console.log(`
+\uD83D\uDCE5 Stdout output (first 500 chars):`);
+      console.log(stdout.slice(0, 500));
+    }
     if (exitCode !== 0) {
-      console.error(`CLI exited with code ${exitCode}`);
+      console.error(`
+❌ CLI exited with code ${exitCode}`);
       return { session_summary: "", memories: [] };
     }
     try {
-      const jsonMatch = output.match(/\{[\s\S]*\}/)?.[0];
+      const cliOutput = JSON.parse(stdout);
+      if (cliOutput.type === "error" || cliOutput.is_error === true) {
+        console.log(`
+❌ CLI returned error:`);
+        console.log(`   Type: ${cliOutput.type}`);
+        console.log(`   Message: ${cliOutput.message || cliOutput.error || "Unknown error"}`);
+        return { session_summary: "", memories: [] };
+      }
+      let aiResponse = "";
+      if (typeof cliOutput.result === "string") {
+        aiResponse = cliOutput.result;
+        console.log(`
+\uD83D\uDCE6 Extracted result from CLI wrapper (${aiResponse.length} chars)`);
+      } else {
+        console.log(`
+⚠️ No result field in CLI output`);
+        console.log(`   Keys: ${Object.keys(cliOutput).join(", ")}`);
+        return { session_summary: "", memories: [] };
+      }
+      const codeBlockMatch = aiResponse.match(/```(?:json)?\s*([\s\S]*?)```/);
+      if (codeBlockMatch) {
+        aiResponse = codeBlockMatch[1].trim();
+        console.log(`\uD83D\uDCDD Extracted JSON from markdown code block`);
+      }
+      const jsonMatch = aiResponse.match(/\{[\s\S]*\}/)?.[0];
       if (jsonMatch) {
-        return this.parseCurationResponse(jsonMatch);
+        console.log(`✅ Found JSON object (${jsonMatch.length} chars)`);
+        const result = this.parseCurationResponse(jsonMatch);
+        console.log(`   Parsed ${result.memories.length} memories`);
+        return result;
+      } else {
+        console.log(`
+⚠️ No JSON object found in AI response`);
+        console.log(`   Response preview: ${aiResponse.slice(0, 200)}...`);
       }
     } catch (error) {
-      console.error("Failed to parse CLI output:", error);
+      console.error(`
+❌ Failed to parse CLI output:`, error);
+      console.log(`   Raw stdout (first 500 chars): ${stdout.slice(0, 500)}`);
     }
     return { session_summary: "", memories: [] };
   }
@@ -12283,6 +12395,17 @@ function createServer(config = {}) {
               context_type: m2.context_type
             })), body.current_message ?? "");
           }
+          console.log(`
+\uD83D\uDCE4 [DEBUG] Response to hook:`);
+          console.log(`   memories_count: ${result.memories.length}`);
+          console.log(`   has_primer: ${!!result.primer}`);
+          console.log(`   formatted length: ${result.formatted.length} chars`);
+          if (result.formatted) {
+            console.log(`   formatted preview:
+${result.formatted.slice(0, 300)}...`);
+          } else {
+            console.log(`   ⚠️ formatted is EMPTY!`);
+          }
           return Response.json({
             success: true,
             context: result.formatted,

package/dist/server/index.mjs

@@ -10753,9 +10753,15 @@ class Database {
       if (!id)
         continue;
       const record = this._columns.getRecord(index);
-      const withId = { id, ...record };
-      if (filter(withId)) {
-        results.push(withId);
+      const withMeta = {
+        id,
+        ...record,
+        created: this._created[index] || 0,
+        updated: this._updated[index] || 0,
+        stale: this._staleFlags[index] || false
+      };
+      if (filter(withMeta)) {
+        results.push(withMeta);
       }
     }
     return results;
@@ -10766,9 +10772,15 @@ class Database {
       if (!id)
         continue;
       const record = this._columns.getRecord(index);
-      const withId = { id, ...record };
-      if (filter(withId)) {
-        return withId;
+      const withMeta = {
+        id,
+        ...record,
+        created: this._created[index] || 0,
+        updated: this._updated[index] || 0,
+        stale: this._staleFlags[index] || false
+      };
+      if (filter(withMeta)) {
+        return withMeta;
       }
     }
     return null;
@@ -11122,9 +11134,12 @@ class MemoryStore {
   }
   async getProject(projectId) {
     if (this._projects.has(projectId)) {
+      console.log(`\uD83D\uDD04 [DEBUG] Returning cached databases for ${projectId}`);
       return this._projects.get(projectId);
     }
+    console.log(`\uD83C\uDD95 [DEBUG] Creating NEW databases for ${projectId}`);
     const projectPath = join2(this._config.basePath, projectId);
+    console.log(`   Path: ${projectPath}`);
     const [memories, summaries, snapshots, sessions] = await Promise.all([
       createDatabase({
         path: join2(projectPath, "memories"),
@@ -11309,20 +11324,31 @@ class MemoryStore {
   }
   async storeSessionSummary(projectId, sessionId, summary, interactionTone = "") {
     const { summaries } = await this.getProject(projectId);
-    return summaries.insert({
+    console.log(`\uD83D\uDCDD [DEBUG] Storing summary for ${projectId}:`);
+    console.log(`   Summary length: ${summary.length} chars`);
+    console.log(`   Summaries count before: ${summaries.all().length}`);
+    const id = await summaries.insert({
       session_id: sessionId,
       project_id: projectId,
       summary,
       interaction_tone: interactionTone
     });
+    console.log(`   Summaries count after: ${summaries.all().length}`);
+    console.log(`   Inserted ID: ${id}`);
+    return id;
   }
   async getLatestSummary(projectId) {
     const { summaries } = await this.getProject(projectId);
+    console.log(`\uD83D\uDCD6 [DEBUG] Getting latest summary for ${projectId}:`);
     const all = summaries.all();
-    if (!all.length)
+    console.log(`   Summaries found: ${all.length}`);
+    if (!all.length) {
+      console.log(`   No summaries found!`);
       return null;
+    }
     all.sort((a, b) => b.created - a.created);
     const latest = all[0];
+    console.log(`   Latest summary: ${latest.summary.slice(0, 50)}...`);
     return {
       id: latest.id,
       session_id: latest.session_id,
@@ -11707,6 +11733,12 @@ class MemoryEngine {
   }
   async _getStore(projectId, projectPath) {
     const key = this._config.storageMode === "local" && projectPath ? projectPath : projectId;
+    console.log(`\uD83C\uDFEA [DEBUG] _getStore called:`);
+    console.log(`   projectId: ${projectId}`);
+    console.log(`   projectPath: ${projectPath}`);
+    console.log(`   storageMode: ${this._config.storageMode}`);
+    console.log(`   cache key: ${key}`);
+    console.log(`   cached: ${this._stores.has(key)}`);
     if (this._stores.has(key)) {
       return this._stores.get(key);
     }
@@ -11880,14 +11912,31 @@ function createEngine(config) {
 }
 
 // src/core/curator.ts
+import { homedir as homedir3 } from "os";
+import { join as join4 } from "path";
+import { existsSync } from "fs";
+function getClaudeCommand() {
+  const envCommand = process.env.CURATOR_COMMAND;
+  if (envCommand) {
+    return envCommand;
+  }
+  const claudeLocal = join4(homedir3(), ".claude", "local", "claude");
+  if (existsSync(claudeLocal)) {
+    return claudeLocal;
+  }
+  return "claude";
+}
+
 class Curator {
   _config;
   constructor(config = {}) {
+    const cliCommand = config.cliCommand ?? getClaudeCommand();
     this._config = {
       apiKey: config.apiKey ?? "",
-      cliCommand: config.cliCommand ?? "claude",
+      cliCommand,
       cliType: config.cliType ?? "claude-code"
     };
+    console.log(`\uD83E\uDDE0 Curator initialized with CLI: ${cliCommand}`);
   }
   buildCurationPrompt(triggerType = "session_end") {
     return `You have just had a conversation. As this session is ending (${triggerType}), please curate memories for the Claude Tools Memory System.
@@ -12081,33 +12130,96 @@ ${prompt}`
     return this.parseCurationResponse(content.text);
   }
   async curateWithCLI(sessionId, triggerType = "session_end", cwd) {
-    const prompt = this.buildCurationPrompt(triggerType);
+    const systemPrompt = this.buildCurationPrompt(triggerType);
+    const userMessage = "This session has ended. Please curate the memories from our conversation according to the instructions in your system prompt. Return ONLY the JSON structure.";
     const args = [];
     if (this._config.cliType === "claude-code") {
-      args.push("--resume", sessionId, "-p", prompt, "--output-format", "json", "--max-turns", "1");
+      args.push("--resume", sessionId, "-p", userMessage, "--append-system-prompt", systemPrompt, "--output-format", "json", "--max-turns", "1");
     } else {
-      args.push("--resume", sessionId, "-p", prompt, "--output-format", "json");
+      args.push("--resume", sessionId, "-p", `${systemPrompt}
+
+${userMessage}`, "--output-format", "json");
     }
+    console.log(`
+\uD83D\uDCCB Executing CLI command:`);
+    console.log(`   Command: ${this._config.cliCommand}`);
+    console.log(`   Args: --resume ${sessionId} -p [user_message] --append-system-prompt [curation_instructions] --output-format json --max-turns 1`);
+    console.log(`   CWD: ${cwd || "not set"}`);
+    console.log(`   User message: "${userMessage.slice(0, 50)}..."`);
+    console.log(`   System prompt length: ${systemPrompt.length} chars`);
     const proc = Bun.spawn([this._config.cliCommand, ...args], {
       cwd,
       env: {
         ...process.env,
         MEMORY_CURATOR_ACTIVE: "1"
-      }
+      },
+      stderr: "pipe"
     });
-    const output = await new Response(proc.stdout).text();
+    const [stdout, stderr] = await Promise.all([
+      new Response(proc.stdout).text(),
+      new Response(proc.stderr).text()
+    ]);
     const exitCode = await proc.exited;
+    console.log(`
+\uD83D\uDCE4 CLI Response:`);
+    console.log(`   Exit code: ${exitCode}`);
+    console.log(`   Stdout length: ${stdout.length} chars`);
+    console.log(`   Stderr length: ${stderr.length} chars`);
+    if (stderr) {
+      console.log(`
+⚠️ Stderr output:`);
+      console.log(stderr.slice(0, 1000));
+    }
+    if (stdout) {
+      console.log(`
+\uD83D\uDCE5 Stdout output (first 500 chars):`);
+      console.log(stdout.slice(0, 500));
+    }
     if (exitCode !== 0) {
-      console.error(`CLI exited with code ${exitCode}`);
+      console.error(`
+❌ CLI exited with code ${exitCode}`);
       return { session_summary: "", memories: [] };
     }
     try {
-      const jsonMatch = output.match(/\{[\s\S]*\}/)?.[0];
+      const cliOutput = JSON.parse(stdout);
+      if (cliOutput.type === "error" || cliOutput.is_error === true) {
+        console.log(`
+❌ CLI returned error:`);
+        console.log(`   Type: ${cliOutput.type}`);
+        console.log(`   Message: ${cliOutput.message || cliOutput.error || "Unknown error"}`);
+        return { session_summary: "", memories: [] };
+      }
+      let aiResponse = "";
+      if (typeof cliOutput.result === "string") {
+        aiResponse = cliOutput.result;
+        console.log(`
+\uD83D\uDCE6 Extracted result from CLI wrapper (${aiResponse.length} chars)`);
+      } else {
+        console.log(`
+⚠️ No result field in CLI output`);
+        console.log(`   Keys: ${Object.keys(cliOutput).join(", ")}`);
+        return { session_summary: "", memories: [] };
+      }
+      const codeBlockMatch = aiResponse.match(/```(?:json)?\s*([\s\S]*?)```/);
+      if (codeBlockMatch) {
+        aiResponse = codeBlockMatch[1].trim();
+        console.log(`\uD83D\uDCDD Extracted JSON from markdown code block`);
+      }
+      const jsonMatch = aiResponse.match(/\{[\s\S]*\}/)?.[0];
       if (jsonMatch) {
-        return this.parseCurationResponse(jsonMatch);
+        console.log(`✅ Found JSON object (${jsonMatch.length} chars)`);
+        const result = this.parseCurationResponse(jsonMatch);
+        console.log(`   Parsed ${result.memories.length} memories`);
+        return result;
+      } else {
+        console.log(`
+⚠️ No JSON object found in AI response`);
+        console.log(`   Response preview: ${aiResponse.slice(0, 200)}...`);
       }
     } catch (error) {
-      console.error("Failed to parse CLI output:", error);
+      console.error(`
+❌ Failed to parse CLI output:`, error);
+      console.log(`   Raw stdout (first 500 chars): ${stdout.slice(0, 500)}`);
     }
     return { session_summary: "", memories: [] };
   }
@@ -12263,6 +12375,17 @@ function createServer(config = {}) {
               context_type: m2.context_type
             })), body.current_message ?? "");
           }
+          console.log(`
+\uD83D\uDCE4 [DEBUG] Response to hook:`);
+          console.log(`   memories_count: ${result.memories.length}`);
+          console.log(`   has_primer: ${!!result.primer}`);
+          console.log(`   formatted length: ${result.formatted.length} chars`);
+          if (result.formatted) {
+            console.log(`   formatted preview:
+${result.formatted.slice(0, 300)}...`);
+          } else {
+            console.log(`   ⚠️ formatted is EMPTY!`);
+          }
           return Response.json({
             success: true,
             context: result.formatted,

package/hooks/curation.ts

@@ -0,0 +1,89 @@
+#!/usr/bin/env bun
+// ============================================================================
+// CURATION HOOK - Trigger memory curation
+// Hook: PreCompact (auto|manual)
+//
+// Triggers memory curation when context is about to be compacted.
+// This ensures memories are captured before context is lost.
+// ============================================================================
+
+import { join } from 'path'
+import { styleText } from 'util'
+
+// Configuration
+const MEMORY_API_URL = process.env.MEMORY_API_URL || 'http://localhost:8765'
+
+// Styled output helpers (for stderr feedback)
+const info = (text: string) => styleText('cyan', text)
+const success = (text: string) => styleText('green', text)
+const warn = (text: string) => styleText('yellow', text)
+
+/**
+ * Get project ID from working directory
+ */
+function getProjectId(cwd: string): string {
+  // Look for .memory-project.json in cwd or parents
+  let path = cwd
+  while (path !== '/') {
+    const configPath = join(path, '.memory-project.json')
+    try {
+      const config = JSON.parse(Bun.file(configPath).text() as any)
+      if (config.project_id) return config.project_id
+    } catch {
+      // Continue to parent
+    }
+    path = join(path, '..')
+  }
+
+  // Fallback: use directory name
+  return cwd.split('/').pop() || 'default'
+}
+
+/**
+ * Main hook entry point
+ */
+async function main() {
+  // Skip if called from memory curator subprocess
+  if (process.env.MEMORY_CURATOR_ACTIVE === '1') return
+
+  try {
+    // Read input from stdin
+    const inputText = await Bun.stdin.text()
+    const input = JSON.parse(inputText)
+
+    const sessionId = input.session_id || 'unknown'
+    const cwd = process.env.CLAUDE_PROJECT_DIR || input.cwd || process.cwd()
+    const trigger = input.trigger || 'pre_compact'
+    const hookEvent = input.hook_event_name || 'PreCompact'
+
+    const projectId = getProjectId(cwd)
+
+    console.error(info(`🧠 Curating memories (${hookEvent})...`))
+
+    // Fire and forget - trigger curation
+    // The server handles the actual curation asynchronously
+    const response = await fetch(`${MEMORY_API_URL}/memory/checkpoint`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        session_id: sessionId,
+        project_id: projectId,
+        claude_session_id: sessionId,
+        trigger: trigger === 'pre_compact' || trigger === 'manual' ? 'pre_compact' : 'session_end',
+        cwd,
+      }),
+      signal: AbortSignal.timeout(5000),
+    }).catch(() => null)
+
+    if (response?.ok) {
+      console.error(success('✨ Memory curation started'))
+    } else {
+      console.error(warn('⚠️ Memory server not available'))
+    }
+
+  } catch (error: any) {
+    console.error(warn(`⚠️ Hook error: ${error.message}`))
+  }
+}
+
+main()