clementine-agent 1.18.19 → 1.18.21

package/dist/tools/shared.d.ts

@@ -105,6 +105,8 @@ export type MemoryStoreType = {
         accessLogRetentionDays?: number;
         transcriptRetentionDays?: number;
         behavioralRetentionDays?: number;
+        recallTraceRetentionDays?: number;
+        memoryEventRetentionDays?: number;
     }): {
         episodicPruned: number;
         accessLogPruned: number;
@@ -113,6 +115,8 @@ export type MemoryStoreType = {
         feedbackPruned: number;
         reflectionsPruned: number;
         usageLogPruned: number;
+        recallTracesPruned: number;
+        memoryEventsPruned: number;
     };
     checkDuplicate(content: string, sourceFile?: string): {
         isDuplicate: boolean;
@@ -286,6 +290,8 @@ export type MemoryStoreType = {
         recordsWritten?: number;
         recordsSkipped?: number;
         recordsFailed?: number;
+        recordsUnchanged?: number;
+        recallCheckStatus?: string | null;
         overviewNotePath?: string | null;
         errorsJson?: string | null;
         status?: 'running' | 'ok' | 'error' | 'partial';
@@ -300,6 +306,8 @@ export type MemoryStoreType = {
         recordsWritten: number;
         recordsSkipped: number;
         recordsFailed: number;
+        recordsUnchanged: number;
+        recallCheckStatus: string | null;
         overviewNotePath: string | null;
         errorsJson: string | null;
         status: string;
@@ -368,6 +376,23 @@ export type MemoryStoreType = {
         chunkIds: number[];
         scores: number[];
         agentSlug?: string | null;
+        matchTypes?: string[];
+        backendCounts?: {
+            fts: number;
+            vector: number;
+            graph: number;
+            recency: number;
+        } | null;
+        evidence?: Array<{
+            chunkId: number;
+            matchType: string;
+            score: number;
+            sourceFile?: string;
+            section?: string;
+        }>;
+        confidence?: number | null;
+        emptyReason?: string | null;
+        allowEmpty?: boolean;
     }): void;
     getRecentRecallTraces(sessionKey: string, limit?: number): Array<{
         id: number;
@@ -375,6 +400,21 @@ export type MemoryStoreType = {
         query: string;
         chunkIds: number[];
         scores: number[];
+        backendCounts: {
+            fts: number;
+            vector: number;
+            graph: number;
+            recency: number;
+        } | null;
+        evidence: Array<{
+            chunkId: number;
+            matchType: string;
+            score: number;
+            sourceFile?: string;
+            section?: string;
+        }>;
+        confidence: number | null;
+        emptyReason: string | null;
         retrievedAt: string;
     }>;
     getRecallTrace(traceId: number): {
@@ -383,6 +423,21 @@ export type MemoryStoreType = {
         messageId: string | null;
         query: string;
         retrievedAt: string;
+        backendCounts: {
+            fts: number;
+            vector: number;
+            graph: number;
+            recency: number;
+        } | null;
+        evidence: Array<{
+            chunkId: number;
+            matchType: string;
+            score: number;
+            sourceFile?: string;
+            section?: string;
+        }>;
+        confidence: number | null;
+        emptyReason: string | null;
         chunks: Array<{
             id: number;
             sourceFile: string;
@@ -503,6 +558,19 @@ export type MemoryStoreType = {
             recallTracesLast30d: number;
             extractionSkipsLast30d: number;
         };
+        retrievalProof: {
+            tracesLast7d: number;
+            emptyTracesLast7d: number;
+            tracedChunksLast7d: number;
+        };
+        memoryEvents: {
+            total: number;
+            indexed: number;
+            bySourceType: Array<{
+                sourceType: string;
+                count: number;
+            }>;
+        };
         topCitedLast30d: Array<{
             chunkId: number;
             sourceFile: string;
@@ -556,8 +624,29 @@ export type MemoryStoreType = {
             }>;
             currentModel: string;
             ready: boolean;
+            cacheDir: string;
+            cacheExists: boolean;
+            cacheBytes: number;
+            cacheSize: string;
+            installed: boolean;
         };
     };
+    recordMemoryEvent?(input: {
+        sourceType: string;
+        sourceId?: number | null;
+        sessionKey?: string | null;
+        agentSlug?: string | null;
+        content: string;
+        indexed?: boolean;
+    }): void;
+    getMemoryEventStats(): {
+        total: number;
+        indexed: number;
+        bySourceType: Array<{
+            sourceType: string;
+            count: number;
+        }>;
+    };
     logAutonomyEvent(row: {
         component: string;
         event: string;

package/dist/types.d.ts

@@ -351,6 +351,15 @@ export interface SessionSummary {
     exchangeCount: number;
     createdAt: string;
 }
+export interface SessionLineageEntry {
+    sessionKey: string;
+    parentSessionId: string | null;
+    childSessionId: string | null;
+    reason: string;
+    summary: string;
+    exchangeCount: number;
+    createdAt: string;
+}
 export interface WikilinkConnection {
     direction: 'incoming' | 'outgoing';
     file: string;
@@ -887,6 +896,8 @@ export interface IngestionRun {
     recordsWritten: number;
     recordsSkipped: number;
     recordsFailed: number;
+    recordsUnchanged?: number;
+    recallCheckStatus?: string | null;
     overviewNotePath?: string | null;
     errorsJson?: string | null;
     status: 'running' | 'ok' | 'error' | 'partial';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.19",
+  "version": "1.18.21",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",

package/scripts/postinstall.js

@@ -6,14 +6,15 @@
  *   1. Rebuild native modules (better-sqlite3) for the current Node version
  *   2. Initialize ~/.clementine/ directory structure if it doesn't exist
  *   3. Copy default vault templates from package to data home
- *   4. Check for `claude` CLI on PATH (needed for OAuth login)
- *   5. Print first-run instructions
+ *   4. Optionally prefetch the local dense embedding model
+ *   5. Check for `claude` CLI on PATH (needed for OAuth login)
+ *   6. Print first-run instructions
  *
  * Safe to re-run — skips steps already completed.
  */
 
-import { execSync } from 'node:child_process';
-import { cpSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { execFileSync, execSync } from 'node:child_process';
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -22,6 +23,30 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PKG_DIR = path.resolve(__dirname, '..');
 const DATA_HOME = process.env.CLEMENTINE_HOME || path.join(os.homedir(), '.clementine');
 
+function readDataEnv() {
+  const envPath = path.join(DATA_HOME, '.env');
+  if (!existsSync(envPath)) return {};
+  try {
+    return Object.fromEntries(
+      readFileSync(envPath, 'utf-8')
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#') && line.includes('='))
+        .map((line) => {
+          const idx = line.indexOf('=');
+          return [line.slice(0, idx).trim(), line.slice(idx + 1).trim().replace(/^["']|["']$/g, '')];
+        }),
+    );
+  } catch {
+    return {};
+  }
+}
+
+function flagEnabled(name, envFile) {
+  const raw = process.env[name] ?? envFile[name];
+  return /^(1|true|yes|on)$/i.test(String(raw ?? ''));
+}
+
 // ── Step 1: Rebuild better-sqlite3 ─────────────────────────────────
 try {
   process.stdout.write('Rebuilding native modules...');
@@ -80,14 +105,39 @@ if (existsSync(srcVault)) {
   }
 }
 
-// ── Step 4: Check for claude CLI ────────────────────────────────────
+// ── Step 4: Optional local embedding model prefetch ─────────────────
+// Model weights are intentionally not bundled into the npm tarball. Users
+// who want repo/npm updates to keep the local dense model warm can opt in:
+//   CLEMENTINE_INSTALL_EMBEDDINGS=1 npm install -g clementine-agent
+// or put CLEMENTINE_PREFETCH_EMBEDDINGS=1 in ~/.clementine/.env.
+const dataEnv = readDataEnv();
+if (flagEnabled('CLEMENTINE_INSTALL_EMBEDDINGS', dataEnv) || flagEnabled('CLEMENTINE_PREFETCH_EMBEDDINGS', dataEnv)) {
+  const cliPath = path.join(PKG_DIR, 'dist', 'cli', 'index.js');
+  if (existsSync(cliPath)) {
+    try {
+      console.log('Prefetching Clementine local embedding model...');
+      execFileSync(process.execPath, [cliPath, 'memory', 'model', 'install'], {
+        cwd: PKG_DIR,
+        stdio: 'inherit',
+        env: { ...process.env, CLEMENTINE_HOME: DATA_HOME },
+        timeout: 10 * 60_000,
+      });
+    } catch {
+      console.log('Embedding model prefetch skipped/failed. Run `clementine memory model install` later.');
+    }
+  } else {
+    console.log('Embedding model prefetch skipped: built CLI not found yet.');
+  }
+}
+
+// ── Step 5: Check for claude CLI ────────────────────────────────────
 let claudeOnPath = false;
 try {
   execSync('claude --version', { stdio: 'pipe' });
   claudeOnPath = true;
 } catch { /* not on PATH */ }
 
-// ── Step 5: Print instructions ──────────────────────────────────────
+// ── Step 6: Print instructions ──────────────────────────────────────
 const alreadyConfigured = existsSync(path.join(DATA_HOME, '.env'));
 
 if (alreadyConfigured) {