clawvault 1.5.1 → 1.6.1

package/bin/clawvault.js

@@ -250,6 +250,7 @@ program
   .option('-n, --limit <n>', 'Max results', '10')
   .option('-c, --category <category>', 'Filter by category')
   .option('--tags <tags>', 'Filter by tags (comma-separated)')
+  .option('--recent', 'Boost recent documents')
   .option('--full', 'Include full content in results')
   .option('-v, --vault <path>', 'Vault path')
   .option('--json', 'Output as JSON')
@@ -261,7 +262,8 @@ program
         limit: parseInt(options.limit),
         category: options.category,
         tags: options.tags?.split(',').map(t => t.trim()),
-        fullContent: options.full
+        fullContent: options.full,
+        temporalBoost: options.recent
       });
       
       if (options.json) {
@@ -303,6 +305,7 @@ program
   .option('-n, --limit <n>', 'Max results', '5')
   .option('-c, --category <category>', 'Filter by category')
   .option('--tags <tags>', 'Filter by tags (comma-separated)')
+  .option('--recent', 'Boost recent documents')
   .option('--full', 'Include full content in results')
   .option('-v, --vault <path>', 'Vault path')
   .option('--json', 'Output as JSON')
@@ -314,7 +317,8 @@ program
         limit: parseInt(options.limit),
         category: options.category,
         tags: options.tags?.split(',').map(t => t.trim()),
-        fullContent: options.full
+        fullContent: options.full,
+        temporalBoost: options.recent
       });
       
       if (options.json) {
@@ -350,6 +354,36 @@ program
     }
   });
 
+// === CONTEXT ===
+program
+  .command('context <task>')
+  .description('Generate task-relevant context for prompt injection')
+  .option('-n, --limit <n>', 'Max results', '5')
+  .option('--format <format>', 'Output format (markdown|json)', 'markdown')
+  .option('--recent', 'Boost recent documents (enabled by default)', true)
+  .option('-v, --vault <path>', 'Vault path')
+  .action(async (task, options) => {
+    try {
+      const vaultPath = resolveVaultPath(options.vault);
+      const format = options.format === 'json' ? 'json' : 'markdown';
+
+      const { contextCommand } = await import('../dist/commands/context.js');
+      await contextCommand(task, {
+        vaultPath,
+        limit: parseInt(options.limit),
+        format,
+        recent: options.recent
+      });
+    } catch (err) {
+      if (err instanceof QmdUnavailableError) {
+        printQmdMissing();
+        process.exit(1);
+      }
+      console.error(chalk.red(`Error: ${err.message}`));
+      process.exit(1);
+    }
+  });
+
 // === LIST ===
 program
   .command('list [category]')

package/dist/{chunk-MXNXWOPL.js → chunk-3HFB7EMU.js}

@@ -8,7 +8,7 @@ import {
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-VJIFT5T5.js";
+} from "./chunk-MIIXBNO3.js";
 
 // src/lib/vault.ts
 import * as fs from "fs";

package/dist/{chunk-VJIFT5T5.js → chunk-MIIXBNO3.js}

@@ -36,6 +36,7 @@ var DEFAULT_CONFIG = {
 
 // src/lib/search.ts
 import { execFileSync, spawnSync } from "child_process";
+import * as fs from "fs";
 import * as path from "path";
 var QMD_INSTALL_URL = "https://github.com/tobi/qmd";
 var QMD_INSTALL_COMMAND = "bun install -g github:tobi/qmd";
@@ -199,7 +200,8 @@ var SearchEngine = class {
       minScore = 0,
       category,
       tags,
-      fullContent = false
+      fullContent = false,
+      temporalBoost = false
     } = options;
     if (!query.trim()) return [];
     const args = [
@@ -218,14 +220,15 @@ var SearchEngine = class {
       minScore,
       category,
       tags,
-      fullContent
+      fullContent,
+      temporalBoost
     });
   }
   /**
    * Convert qmd results to ClawVault SearchResult format
    */
   convertResults(qmdResults, options) {
-    const { limit = 10, minScore = 0, category, tags, fullContent = false } = options;
+    const { limit = 10, minScore = 0, category, tags, fullContent = false, temporalBoost = false } = options;
     const results = [];
     const maxScore = qmdResults[0]?.score || 1;
     for (const qr of qmdResults) {
@@ -233,6 +236,7 @@ var SearchEngine = class {
       const relativePath = this.vaultPath ? path.relative(this.vaultPath, filePath) : filePath;
       const docId = relativePath.replace(/\.md$/, "");
       let doc = this.documents.get(docId);
+      const modifiedAt = this.resolveModifiedAt(doc, filePath);
       const parts = relativePath.split(path.sep);
       const docCategory = parts.length > 1 ? parts[0] : "root";
       if (category && docCategory !== category) continue;
@@ -241,7 +245,8 @@ var SearchEngine = class {
         if (!tags.some((t) => docTags.has(t))) continue;
       }
       const normalizedScore = maxScore > 0 ? qr.score / maxScore : 0;
-      if (normalizedScore < minScore) continue;
+      const finalScore = temporalBoost ? normalizedScore * this.getRecencyFactor(modifiedAt) : normalizedScore;
+      if (finalScore < minScore) continue;
       if (!doc) {
         doc = {
           id: docId,
@@ -253,19 +258,33 @@ var SearchEngine = class {
           frontmatter: {},
           links: [],
           tags: [],
-          modified: /* @__PURE__ */ new Date()
+          modified: modifiedAt
         };
       }
       results.push({
         document: fullContent ? doc : { ...doc, content: "" },
-        score: normalizedScore,
+        score: finalScore,
         snippet: this.cleanSnippet(qr.snippet),
         matchedTerms: []
         // qmd doesn't provide this
       });
-      if (results.length >= limit) break;
     }
-    return results;
+    return results.sort((a, b) => b.score - a.score).slice(0, limit);
+  }
+  resolveModifiedAt(doc, filePath) {
+    if (doc) return doc.modified;
+    try {
+      return fs.statSync(filePath).mtime;
+    } catch {
+      return /* @__PURE__ */ new Date(0);
+    }
+  }
+  getRecencyFactor(modifiedAt) {
+    const ageMs = Math.max(0, Date.now() - modifiedAt.getTime());
+    const ageDays = ageMs / (24 * 60 * 60 * 1e3);
+    if (ageDays < 1) return 1;
+    if (ageDays <= 7) return 0.9;
+    return 0.7;
   }
   /**
    * Convert qmd:// URI to file path

package/dist/{chunk-QYJI73KF.js → chunk-PIJGYMQZ.js}

@@ -1,7 +1,7 @@
 import {
   DEFAULT_CATEGORIES,
   hasQmd
-} from "./chunk-VJIFT5T5.js";
+} from "./chunk-MIIXBNO3.js";
 
 // src/commands/setup.ts
 import * as fs from "fs";

package/dist/chunk-XPGSEJGY.js

@@ -0,0 +1,91 @@
+import {
+  ClawVault
+} from "./chunk-3HFB7EMU.js";
+
+// src/commands/context.ts
+import * as path from "path";
+var DEFAULT_LIMIT = 5;
+var MAX_SNIPPET_LENGTH = 320;
+function formatRelativeAge(date, now = Date.now()) {
+  const ageMs = Math.max(0, now - date.getTime());
+  const days = Math.floor(ageMs / (24 * 60 * 60 * 1e3));
+  if (days === 0) return "today";
+  if (days < 7) return `${days} day${days === 1 ? "" : "s"} ago`;
+  const weeks = Math.floor(days / 7);
+  if (weeks < 5) return `${weeks} week${weeks === 1 ? "" : "s"} ago`;
+  const months = Math.floor(days / 30);
+  if (months < 12) return `${months} month${months === 1 ? "" : "s"} ago`;
+  const years = Math.floor(days / 365);
+  return `${years} year${years === 1 ? "" : "s"} ago`;
+}
+function normalizeSnippet(result) {
+  const source = (result.snippet || result.document.content || "").trim();
+  if (!source) return "No snippet available.";
+  return source.replace(/\s+/g, " ").slice(0, MAX_SNIPPET_LENGTH);
+}
+function formatContextMarkdown(task, entries) {
+  let output = `## Relevant Context for: ${task}
+
+`;
+  if (entries.length === 0) {
+    output += "_No relevant context found._\n";
+    return output;
+  }
+  for (const entry of entries) {
+    output += `### ${entry.title} (score: ${entry.score.toFixed(2)}, ${entry.age})
+`;
+    output += `${entry.snippet}
+
+`;
+  }
+  return output.trimEnd();
+}
+async function buildContext(task, options) {
+  const normalizedTask = task.trim();
+  if (!normalizedTask) {
+    throw new Error("Task description is required.");
+  }
+  const vault = new ClawVault(path.resolve(options.vaultPath));
+  await vault.load();
+  const limit = Math.max(1, options.limit ?? DEFAULT_LIMIT);
+  const recent = options.recent ?? true;
+  const results = await vault.vsearch(normalizedTask, {
+    limit,
+    temporalBoost: recent
+  });
+  const context = results.map((result) => ({
+    title: result.document.title,
+    path: path.relative(vault.getPath(), result.document.path).split(path.sep).join("/"),
+    category: result.document.category,
+    score: result.score,
+    snippet: normalizeSnippet(result),
+    modified: result.document.modified.toISOString(),
+    age: formatRelativeAge(result.document.modified)
+  }));
+  return {
+    task: normalizedTask,
+    generated: (/* @__PURE__ */ new Date()).toISOString(),
+    context,
+    markdown: formatContextMarkdown(normalizedTask, context)
+  };
+}
+async function contextCommand(task, options) {
+  const result = await buildContext(task, options);
+  const format = options.format ?? "markdown";
+  if (format === "json") {
+    console.log(JSON.stringify({
+      task: result.task,
+      generated: result.generated,
+      count: result.context.length,
+      context: result.context
+    }, null, 2));
+    return;
+  }
+  console.log(result.markdown);
+}
+
+export {
+  formatContextMarkdown,
+  buildContext,
+  contextCommand
+};

package/dist/commands/context.d.ts

@@ -0,0 +1,27 @@
+type ContextFormat = 'markdown' | 'json';
+interface ContextOptions {
+    vaultPath: string;
+    limit?: number;
+    format?: ContextFormat;
+    recent?: boolean;
+}
+interface ContextEntry {
+    title: string;
+    path: string;
+    category: string;
+    score: number;
+    snippet: string;
+    modified: string;
+    age: string;
+}
+interface ContextResult {
+    task: string;
+    generated: string;
+    context: ContextEntry[];
+    markdown: string;
+}
+declare function formatContextMarkdown(task: string, entries: ContextEntry[]): string;
+declare function buildContext(task: string, options: ContextOptions): Promise<ContextResult>;
+declare function contextCommand(task: string, options: ContextOptions): Promise<void>;
+
+export { type ContextEntry, type ContextFormat, type ContextOptions, type ContextResult, buildContext, contextCommand, formatContextMarkdown };

package/dist/commands/context.js

@@ -0,0 +1,12 @@
+import {
+  buildContext,
+  contextCommand,
+  formatContextMarkdown
+} from "../chunk-XPGSEJGY.js";
+import "../chunk-3HFB7EMU.js";
+import "../chunk-MIIXBNO3.js";
+export {
+  buildContext,
+  contextCommand,
+  formatContextMarkdown
+};

package/dist/commands/doctor.js

@@ -1,7 +1,10 @@
 import {
   ClawVault,
   findVault
-} from "../chunk-MXNXWOPL.js";
+} from "../chunk-3HFB7EMU.js";
+import {
+  hasQmd
+} from "../chunk-MIIXBNO3.js";
 import {
   scanVaultLinks
 } from "../chunk-4VQTUVH7.js";
@@ -9,9 +12,6 @@ import "../chunk-J7ZWCI2C.js";
 import {
   formatAge
 } from "../chunk-7ZRP733D.js";
-import {
-  hasQmd
-} from "../chunk-VJIFT5T5.js";
 
 // src/commands/doctor.ts
 import * as fs from "fs";

package/dist/commands/setup.js

@@ -1,7 +1,7 @@
 import {
   setupCommand
-} from "../chunk-QYJI73KF.js";
-import "../chunk-VJIFT5T5.js";
+} from "../chunk-PIJGYMQZ.js";
+import "../chunk-MIIXBNO3.js";
 export {
   setupCommand
 };

package/dist/commands/sleep.d.ts

@@ -1,4 +1,4 @@
-import { H as HandoffDocument, D as Document } from '../types-DO8rJ490.js';
+import { H as HandoffDocument, D as Document } from '../types-DMU3SuAV.js';
 
 type PromptFn = (question: string) => Promise<string>;
 interface SleepOptions {

package/dist/commands/sleep.js

@@ -1,12 +1,12 @@
 import {
   ClawVault
-} from "../chunk-MXNXWOPL.js";
+} from "../chunk-3HFB7EMU.js";
+import {
+  qmdUpdate
+} from "../chunk-MIIXBNO3.js";
 import {
   clearDirtyFlag
 } from "../chunk-MZZJLQNQ.js";
-import {
-  qmdUpdate
-} from "../chunk-VJIFT5T5.js";
 
 // src/commands/sleep.ts
 import * as fs from "fs";

package/dist/commands/status.js

@@ -1,6 +1,10 @@
 import {
   ClawVault
-} from "../chunk-MXNXWOPL.js";
+} from "../chunk-3HFB7EMU.js";
+import {
+  QmdUnavailableError,
+  hasQmd
+} from "../chunk-MIIXBNO3.js";
 import {
   scanVaultLinks
 } from "../chunk-4VQTUVH7.js";
@@ -8,10 +12,6 @@ import "../chunk-J7ZWCI2C.js";
 import {
   formatAge
 } from "../chunk-7ZRP733D.js";
-import {
-  QmdUnavailableError,
-  hasQmd
-} from "../chunk-VJIFT5T5.js";
 
 // src/commands/status.ts
 import * as fs from "fs";

package/dist/commands/wake.d.ts

@@ -1,4 +1,4 @@
-import { e as SessionRecap } from '../types-DO8rJ490.js';
+import { e as SessionRecap } from '../types-DMU3SuAV.js';
 import { RecoveryInfo } from './recover.js';
 import './checkpoint.js';
 

package/dist/commands/wake.js

@@ -1,6 +1,7 @@
 import {
   ClawVault
-} from "../chunk-MXNXWOPL.js";
+} from "../chunk-3HFB7EMU.js";
+import "../chunk-MIIXBNO3.js";
 import {
   recover
 } from "../chunk-MILVYUPK.js";
@@ -8,7 +9,6 @@ import {
   clearDirtyFlag
 } from "../chunk-MZZJLQNQ.js";
 import "../chunk-7ZRP733D.js";
-import "../chunk-VJIFT5T5.js";
 
 // src/commands/wake.ts
 import * as path from "path";

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { V as VaultConfig, S as StoreOptions, D as Document, a as SearchOptions, b as SearchResult, c as SyncOptions, d as SyncResult, C as Category, M as MemoryType, H as HandoffDocument, e as SessionRecap } from './types-DO8rJ490.js';
-export { f as DEFAULT_CATEGORIES, g as DEFAULT_CONFIG, h as MEMORY_TYPES, T as TYPE_TO_CATEGORY, i as VaultMeta } from './types-DO8rJ490.js';
+import { V as VaultConfig, S as StoreOptions, D as Document, a as SearchOptions, b as SearchResult, c as SyncOptions, d as SyncResult, C as Category, M as MemoryType, H as HandoffDocument, e as SessionRecap } from './types-DMU3SuAV.js';
+export { f as DEFAULT_CATEGORIES, g as DEFAULT_CONFIG, h as MEMORY_TYPES, T as TYPE_TO_CATEGORY, i as VaultMeta } from './types-DMU3SuAV.js';
 export { setupCommand } from './commands/setup.js';
+export { ContextEntry, ContextFormat, ContextOptions, ContextResult, buildContext, contextCommand, formatContextMarkdown } from './commands/context.js';
 export { TemplateVariables, buildTemplateVariables, renderTemplate } from './lib/template-engine.js';
 
 /**
@@ -215,6 +216,8 @@ declare class SearchEngine {
      * Convert qmd results to ClawVault SearchResult format
      */
     private convertResults;
+    private resolveModifiedAt;
+    private getRecencyFactor;
     /**
      * Convert qmd:// URI to file path
      */

package/dist/index.js

@@ -1,15 +1,20 @@
+import {
+  setupCommand
+} from "./chunk-PIJGYMQZ.js";
 import {
   buildTemplateVariables,
   renderTemplate
 } from "./chunk-7766SIJP.js";
+import {
+  buildContext,
+  contextCommand,
+  formatContextMarkdown
+} from "./chunk-XPGSEJGY.js";
 import {
   ClawVault,
   createVault,
   findVault
-} from "./chunk-MXNXWOPL.js";
-import {
-  setupCommand
-} from "./chunk-QYJI73KF.js";
+} from "./chunk-3HFB7EMU.js";
 import {
   DEFAULT_CATEGORIES,
   DEFAULT_CONFIG,
@@ -24,7 +29,7 @@ import {
   hasQmd,
   qmdEmbed,
   qmdUpdate
-} from "./chunk-VJIFT5T5.js";
+} from "./chunk-MIIXBNO3.js";
 
 // src/index.ts
 import * as fs from "fs";
@@ -49,11 +54,14 @@ export {
   SearchEngine,
   TYPE_TO_CATEGORY,
   VERSION,
+  buildContext,
   buildTemplateVariables,
+  contextCommand,
   createVault,
   extractTags,
   extractWikiLinks,
   findVault,
+  formatContextMarkdown,
   hasQmd,
   qmdEmbed,
   qmdUpdate,

package/dist/{types-DO8rJ490.d.ts → types-DMU3SuAV.d.ts}

@@ -68,6 +68,8 @@ interface SearchOptions {
     tags?: string[];
     /** Include full content in results */
     fullContent?: boolean;
+    /** Boost recent documents in ranking */
+    temporalBoost?: boolean;
 }
 interface StoreOptions {
     /** Category to store in */

package/hooks/clawvault/HOOK.md

@@ -1,10 +1,10 @@
 ---
 name: clawvault
-description: "Context death resilience - auto-checkpoint and recovery detection"
+description: "Context resilience - recovery detection, auto-checkpoint, and session context injection"
 metadata:
   openclaw:
     emoji: "🐘"
-    events: ["gateway:startup", "command:new"]
+    events: ["gateway:startup", "command:new", "session:start"]
     requires:
       bins: ["clawvault"]
 ---
@@ -15,6 +15,7 @@ Integrates ClawVault's context death resilience into OpenClaw:
 
 - **On gateway startup**: Checks for context death, alerts agent
 - **On /new command**: Auto-checkpoints before session reset
+- **On session start**: Injects relevant vault context for the initial prompt
 
 ## Installation
 
@@ -43,6 +44,20 @@ openclaw hooks enable clawvault
 2. Captures state even if agent forgot to handoff
 3. Ensures continuity across session resets
 
+### Session Start
+
+1. Extracts the initial user prompt (`context.initialPrompt` or first user message)
+2. Runs `clawvault context "<prompt>" --format json`
+3. Injects up to 4 relevant context bullets into session messages
+
+Injection format:
+
+```text
+[ClawVault] Relevant context for this task:
+- <title> (<age>): <snippet>
+- <title> (<age>): <snippet>
+```
+
 ## No Configuration Needed
 
 Just enable the hook. It auto-detects vault path via:

package/hooks/clawvault/handler.js

@@ -4,6 +4,7 @@
  * Provides automatic context death resilience:
  * - gateway:startup → detect context death, inject recovery info
  * - command:new → auto-checkpoint before session reset
+ * - session:start → inject relevant context for first user prompt
  * 
  * SECURITY: Uses execFileSync (no shell) to prevent command injection
  */
@@ -12,6 +13,10 @@ import { execFileSync } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
 
+const MAX_CONTEXT_RESULTS = 4;
+const MAX_CONTEXT_PROMPT_LENGTH = 500;
+const MAX_CONTEXT_SNIPPET_LENGTH = 220;
+
 // Sanitize string for safe display (prevent prompt injection via control chars)
 function sanitizeForDisplay(str) {
   if (typeof str !== 'string') return '';
@@ -22,6 +27,126 @@ function sanitizeForDisplay(str) {
     .slice(0, 200);                   // Limit length
 }
 
+// Sanitize prompt before passing to CLI command
+function sanitizePromptForContext(str) {
+  if (typeof str !== 'string') return '';
+  return str
+    .replace(/[\x00-\x1f\x7f]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .slice(0, MAX_CONTEXT_PROMPT_LENGTH);
+}
+
+function extractTextFromMessage(message) {
+  if (typeof message === 'string') return message;
+  if (!message || typeof message !== 'object') return '';
+
+  const content = message.content ?? message.text ?? message.message;
+  if (typeof content === 'string') return content;
+
+  if (Array.isArray(content)) {
+    return content
+      .map((part) => {
+        if (typeof part === 'string') return part;
+        if (!part || typeof part !== 'object') return '';
+        if (typeof part.text === 'string') return part.text;
+        if (typeof part.content === 'string') return part.content;
+        return '';
+      })
+      .filter(Boolean)
+      .join(' ');
+  }
+
+  return '';
+}
+
+function isUserMessage(message) {
+  if (typeof message === 'string') return true;
+  if (!message || typeof message !== 'object') return false;
+  const role = typeof message.role === 'string' ? message.role.toLowerCase() : '';
+  const type = typeof message.type === 'string' ? message.type.toLowerCase() : '';
+  return role === 'user' || role === 'human' || type === 'user';
+}
+
+function extractInitialPrompt(event) {
+  const fromContext = sanitizePromptForContext(event?.context?.initialPrompt);
+  if (fromContext) return fromContext;
+
+  const candidates = [
+    event?.context?.messages,
+    event?.context?.initialMessages,
+    event?.context?.history,
+    event?.messages
+  ];
+
+  for (const list of candidates) {
+    if (!Array.isArray(list)) continue;
+    for (const message of list) {
+      if (!isUserMessage(message)) continue;
+      const text = sanitizePromptForContext(extractTextFromMessage(message));
+      if (text) return text;
+    }
+  }
+
+  return '';
+}
+
+function truncateSnippet(snippet) {
+  const safe = sanitizeForDisplay(snippet).replace(/\s+/g, ' ').trim();
+  if (safe.length <= MAX_CONTEXT_SNIPPET_LENGTH) return safe;
+  return `${safe.slice(0, MAX_CONTEXT_SNIPPET_LENGTH - 3).trimEnd()}...`;
+}
+
+function parseContextJson(output) {
+  try {
+    const parsed = JSON.parse(output);
+    if (!parsed || !Array.isArray(parsed.context)) return [];
+
+    return parsed.context
+      .slice(0, MAX_CONTEXT_RESULTS)
+      .map((entry) => ({
+        title: sanitizeForDisplay(entry?.title || 'Untitled'),
+        age: sanitizeForDisplay(entry?.age || 'unknown age'),
+        snippet: truncateSnippet(entry?.snippet || '')
+      }))
+      .filter((entry) => entry.snippet);
+  } catch {
+    return [];
+  }
+}
+
+function formatContextInjection(entries) {
+  const lines = ['[ClawVault] Relevant context for this task:'];
+  for (const entry of entries) {
+    lines.push(`- ${entry.title} (${entry.age}): ${entry.snippet}`);
+  }
+  return lines.join('\n');
+}
+
+function injectSystemMessage(event, message) {
+  if (!event.messages || !Array.isArray(event.messages)) return false;
+
+  if (event.messages.length === 0) {
+    event.messages.push(message);
+    return true;
+  }
+
+  const first = event.messages[0];
+  if (first && typeof first === 'object' && !Array.isArray(first)) {
+    if ('role' in first || 'content' in first) {
+      event.messages.push({ role: 'system', content: message });
+      return true;
+    }
+    if ('type' in first || 'text' in first) {
+      event.messages.push({ type: 'system', text: message });
+      return true;
+    }
+  }
+
+  event.messages.push(message);
+  return true;
+}
+
 // Validate vault path - must be absolute and exist
 function validateVaultPath(vaultPath) {
   if (!vaultPath || typeof vaultPath !== 'string') return null;
@@ -151,11 +276,9 @@ async function handleStartup(event) {
     const alertMsg = alertParts.join(' ');
 
     // Inject into event messages if available
-    if (event.messages && Array.isArray(event.messages)) {
-      event.messages.push(alertMsg);
+    if (injectSystemMessage(event, alertMsg)) {
+      console.warn('[clawvault] Context death detected, alert injected');
     }
-    
-    console.warn('[clawvault] Context death detected, alert injected');
   } else {
     console.log('[clawvault] Clean startup - no context death');
   }
@@ -194,6 +317,47 @@ async function handleNew(event) {
   }
 }
 
+// Handle session start - inject dynamic context for first prompt
+async function handleSessionStart(event) {
+  const vaultPath = findVaultPath();
+  if (!vaultPath) {
+    console.log('[clawvault] No vault found, skipping context injection');
+    return;
+  }
+
+  const prompt = extractInitialPrompt(event);
+  if (!prompt) {
+    console.log('[clawvault] No initial prompt, skipping context injection');
+    return;
+  }
+
+  console.log('[clawvault] Fetching context for session start');
+
+  const result = runClawvault([
+    'context',
+    prompt,
+    '--format', 'json',
+    '-v', vaultPath
+  ]);
+
+  if (!result.success) {
+    console.warn('[clawvault] Context lookup failed');
+    return;
+  }
+
+  const entries = parseContextJson(result.output);
+  if (entries.length === 0) {
+    console.log('[clawvault] No relevant context found for prompt');
+    return;
+  }
+
+  if (injectSystemMessage(event, formatContextInjection(entries))) {
+    console.log(`[clawvault] Injected ${entries.length} context item(s)`);
+  } else {
+    console.log('[clawvault] No message array available, skipping injection');
+  }
+}
+
 // Main handler - route events
 const handler = async (event) => {
   try {
@@ -206,6 +370,11 @@ const handler = async (event) => {
       await handleNew(event);
       return;
     }
+
+    if (event.type === 'session' && event.action === 'start') {
+      await handleSessionStart(event);
+      return;
+    }
   } catch (err) {
     console.error('[clawvault] Hook error:', err.message || 'unknown error');
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "1.5.1",
+  "version": "1.6.1",
   "description": "🐘 An elephant never forgets. Structured memory for OpenClaw agents. Context death resilience, Obsidian-compatible markdown, local semantic search.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -28,7 +28,7 @@
     ]
   },
   "scripts": {
-    "build": "tsup src/index.ts src/commands/entities.ts src/commands/link.ts src/commands/checkpoint.ts src/commands/recover.ts src/commands/status.ts src/commands/template.ts src/commands/setup.ts src/commands/wake.ts src/commands/sleep.ts src/commands/doctor.ts src/commands/shell-init.ts src/commands/repair-session.ts src/lib/entity-index.ts src/lib/auto-linker.ts src/lib/config.ts src/lib/template-engine.ts src/lib/session-utils.ts src/lib/session-repair.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/commands/entities.ts src/commands/link.ts src/commands/checkpoint.ts src/commands/recover.ts src/commands/status.ts src/commands/template.ts src/commands/setup.ts src/commands/context.ts src/commands/wake.ts src/commands/sleep.ts src/commands/doctor.ts src/commands/shell-init.ts src/commands/repair-session.ts src/lib/entity-index.ts src/lib/auto-linker.ts src/lib/config.ts src/lib/template-engine.ts src/lib/session-utils.ts src/lib/session-repair.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/commands/*.ts src/lib/*.ts --format esm --dts --watch",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",