clawvault 1.11.0 → 1.11.2

package/dist/{chunk-5VYRT2XZ.js → chunk-GZOBCUVO.js}

@@ -1,7 +1,7 @@
 import {
   Observer,
   parseSessionFile
-} from "./chunk-RPMQZZPE.js";
+} from "./chunk-KOF3HYSL.js";
 
 // src/commands/observe.ts
 import * as fs2 from "fs";

package/dist/{chunk-RPMQZZPE.js → chunk-KOF3HYSL.js}

@@ -34,6 +34,7 @@ var Compressor = class {
     return this.mergeObservations(existingObservations, fallback);
   }
   resolveProvider() {
+    if (process.env.CLAWVAULT_NO_LLM) return null;
     if (process.env.ANTHROPIC_API_KEY) {
       return "anthropic";
     }
@@ -47,21 +48,33 @@ var Compressor = class {
   }
   buildPrompt(messages, existingObservations) {
     return [
-      "You are an observer that compresses raw AI session messages into durable observations.",
+      "You are an observer that compresses raw AI session messages into durable, human-meaningful observations.",
       "",
       "Rules:",
       "- Output markdown only.",
       "- Group observations by date heading: ## YYYY-MM-DD",
       "- Each line must follow: <emoji> <HH:MM> <observation>",
       "- Priority emojis: \u{1F534} critical, \u{1F7E1} notable, \u{1F7E2} info",
-      "- \u{1F534} for: decisions between alternatives, errors/failures, blockers, deadlines with explicit dates, breaking changes",
-      "- \u{1F7E1} for: preferences, architecture discussions, trade-offs, milestones, people interactions, notable context, routine deadlines",
-      "- \u{1F7E2} for: routine updates, deployments, builds, general info",
-      "- Preferences are \u{1F7E1} unless they indicate a breaking decision between alternatives.",
-      "- Each distinct error type or failure must be its own observation line; do not merge different errors.",
-      "- If multiple different errors occurred, list each separately with its specific error message.",
-      "- Keep observations concise and factual.",
-      "- Avoid duplicates when possible.",
+      "- \u{1F534} for: decisions between alternatives, blockers, deadlines with explicit dates, breaking changes, commitments made to people",
+      "- \u{1F7E1} for: preferences, architecture discussions, trade-offs, milestones, people interactions, notable context",
+      "- \u{1F7E2} for: completed tasks, deployments, builds, general progress",
+      "",
+      "QUALITY FILTERS (important):",
+      "- DO NOT observe: CLI errors, command failures, tool output parsing issues, retry attempts, debug logs.",
+      "  These are transient noise, not memories. Only observe errors if they represent a BLOCKER or an unresolved problem.",
+      '- DO NOT observe: "acknowledged the conversation", "said okay", routine confirmations.',
+      '- MERGE related events into single observations. If 5 images were generated, say "Generated 5 images for X" not 5 separate lines.',
+      '- MERGE retry sequences: "Tried X, failed, tried Y, succeeded" \u2192 "Resolved X using Y (after initial failure)"',
+      '- Prefer OUTCOMES over PROCESSES: "Deployed v1.2 to Railway" not "Started deploy... build finished... deploy succeeded"',
+      "",
+      "AGENT ATTRIBUTION:",
+      '- If the transcript shows multiple speakers/agents, prefix observations with who did it: "Pedro asked...", "Clawdious deployed...", "Zeca generated..."',
+      "- If only one agent is acting, attribution is optional.",
+      "",
+      "COMMITMENT FORMAT (when someone promises/agrees to something):",
+      '- Use: "\u{1F534} HH:MM [COMMITMENT] <who> committed to <what> by <when>" (include deadline if mentioned)',
+      "",
+      "Keep observations concise and factual. Aim for signal, not completeness.",
       "",
       "Existing observations (may be empty):",
       existingObservations.trim() || "(none)",
@@ -537,10 +550,57 @@ var Router = class {
   normalizeForDedup(content) {
     return content.replace(/^\d{2}:\d{2}\s+/, "").replace(/\[\[[^\]]*\]\]/g, (m) => m.replace(/\[\[|\]\]/g, "")).replace(/\s+/g, " ").trim().toLowerCase();
   }
-  appendToCategory(category, item) {
+  /**
+   * Extract entity slug from observation content for people/projects routing.
+   * Returns null if no entity can be identified.
+   */
+  extractEntitySlug(content, category) {
+    if (category !== "people" && category !== "projects") return null;
+    if (category === "people") {
+      const patterns = [
+        /(?:talked to|met with|spoke with|chatted with|discussed with|emailed|called|messaged)\s+([A-Z][a-z]+(?:\s+[A-Z][a-z]+)?)/,
+        /([A-Z][a-z]+(?:\s+[A-Z][a-z]+)?)\s+(?:said|asked|told|mentioned|from|at)\b/,
+        /\b(?:client|partner|colleague|contact)\s+([A-Z][a-z]+(?:\s+[A-Z][a-z]+)?)/i
+      ];
+      for (const pattern of patterns) {
+        const match = content.match(pattern);
+        if (match?.[1]) return this.toSlug(match[1]);
+      }
+    }
+    if (category === "projects") {
+      const patterns = [
+        /(?:deployed|shipped|launched|released|built|created|working on)\s+([A-Z][a-zA-Z0-9-]+)/,
+        /"([^"]+)"\s+(?:project|repo|service)/i
+      ];
+      for (const pattern of patterns) {
+        const match = content.match(pattern);
+        if (match?.[1]) return this.toSlug(match[1]);
+      }
+    }
+    return null;
+  }
+  toSlug(name) {
+    return name.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+  }
+  /**
+   * Resolve the file path for a routed item.
+   * For people/projects: entity-slug subfolder with date file (e.g., people/pedro/2026-02-12.md)
+   * For other categories: category/date.md
+   */
+  resolveFilePath(category, item) {
+    const entitySlug = this.extractEntitySlug(item.content, category);
+    if (entitySlug) {
+      const entityDir = path.join(this.vaultPath, category, entitySlug);
+      fs.mkdirSync(entityDir, { recursive: true });
+      return path.join(entityDir, `${item.date}.md`);
+    }
     const categoryDir = path.join(this.vaultPath, category);
     fs.mkdirSync(categoryDir, { recursive: true });
-    const filePath = path.join(categoryDir, `${item.date}.md`);
+    return path.join(categoryDir, `${item.date}.md`);
+  }
+  appendToCategory(category, item) {
+    const filePath = this.resolveFilePath(category, item);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
     const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8").trim() : "";
     const normalizedNew = this.normalizeForDedup(item.content);
     const existingLines = existing.split(/\r?\n/);
@@ -559,7 +619,9 @@ var Router = class {
     }
     const linkedContent = this.addWikiLinks(item.content);
     const entry = `- ${item.priority} ${linkedContent}`;
-    const header = existing ? "" : `# ${category} \u2014 ${item.date}
+    const entitySlug = this.extractEntitySlug(item.content, category);
+    const headerLabel = entitySlug ? `${category}/${entitySlug}` : category;
+    const header = existing ? "" : `# ${headerLabel} \u2014 ${item.date}
 `;
     const newContent = existing ? `${existing}
 ${entry}

package/dist/commands/observe.js

@@ -1,8 +1,8 @@
 import {
   observeCommand,
   registerObserveCommand
-} from "../chunk-5VYRT2XZ.js";
-import "../chunk-RPMQZZPE.js";
+} from "../chunk-GZOBCUVO.js";
+import "../chunk-KOF3HYSL.js";
 export {
   observeCommand,
   registerObserveCommand

package/dist/commands/sleep.js

@@ -7,7 +7,7 @@ import {
 import {
   Observer,
   parseSessionFile
-} from "../chunk-RPMQZZPE.js";
+} from "../chunk-KOF3HYSL.js";
 import {
   clearDirtyFlag
 } from "../chunk-MZZJLQNQ.js";

package/dist/commands/wake.d.ts

@@ -6,6 +6,8 @@ interface WakeOptions {
     vaultPath: string;
     handoffLimit?: number;
     brief?: boolean;
+    /** Skip LLM executive summary generation (useful for tests/offline) */
+    noSummary?: boolean;
 }
 interface WakeResult {
     recovery: RecoveryInfo;

package/dist/commands/wake.js

@@ -43,22 +43,35 @@ function formatDateKey(date) {
 }
 function readRecentObservationHighlights(vaultPath) {
   const now = /* @__PURE__ */ new Date();
-  const yesterday = new Date(now);
-  yesterday.setDate(now.getDate() - 1);
-  const dateKeys = [formatDateKey(now), formatDateKey(yesterday)];
   const highlights = [];
-  for (const dateKey of dateKeys) {
+  for (let daysAgo = 0; daysAgo < 7; daysAgo++) {
+    const date = new Date(now);
+    date.setDate(now.getDate() - daysAgo);
+    const dateKey = formatDateKey(date);
     const filePath = path.join(vaultPath, "observations", `${dateKey}.md`);
     if (!fs.existsSync(filePath)) continue;
     const content = fs.readFileSync(filePath, "utf-8");
+    const dayRed = [];
+    const dayYellow = [];
     for (const line of content.split(/\r?\n/)) {
       const match = line.trim().match(OBSERVATION_HIGHLIGHT_RE);
       if (!match?.[2]) continue;
-      highlights.push({
+      const item = {
         date: dateKey,
         priority: match[1],
         text: match[2].trim()
-      });
+      };
+      if (item.priority === "\u{1F534}") dayRed.push(item);
+      else dayYellow.push(item);
+    }
+    if (daysAgo === 0) {
+      highlights.push(...dayRed, ...dayYellow);
+    } else if (daysAgo === 1) {
+      highlights.push(...dayRed, ...dayYellow.slice(0, 5));
+    } else if (daysAgo <= 3) {
+      highlights.push(...dayRed);
+    } else {
+      highlights.push(...dayRed.slice(0, 3));
     }
   }
   return highlights;
@@ -113,6 +126,56 @@ function formatRecentObservations(highlights) {
   }
   return lines.join("\n").trim();
 }
+async function generateExecutiveSummary(recovery, recap, highlights) {
+  if (process.env.CLAWVAULT_NO_LLM || process.env.VITEST) return null;
+  const apiKey = process.env.GEMINI_API_KEY || process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY;
+  if (!apiKey) return null;
+  const redItems = highlights.filter((h) => h.priority === "\u{1F534}").map((h) => h.text).slice(0, 10);
+  const yellowItems = highlights.filter((h) => h.priority === "\u{1F7E1}").map((h) => h.text).slice(0, 5);
+  const projects = recap.activeProjects.slice(0, 8);
+  const commitments = recap.pendingCommitments.slice(0, 5);
+  const lastWork = recovery.checkpoint?.workingOn || recap.recentHandoffs[0]?.workingOn?.join(", ") || "";
+  const blockers = recovery.checkpoint?.blocked || recap.recentHandoffs[0]?.blocked?.join(", ") || "";
+  const nextSteps = recap.recentHandoffs[0]?.nextSteps?.join(", ") || "";
+  const prompt = [
+    "You are a chief of staff briefing an AI agent waking up for a new session.",
+    "Write a 3-5 sentence executive summary answering: What matters RIGHT NOW?",
+    "Be direct and specific. No headers, no bullets \u2014 just a tight paragraph.",
+    "Mention the most urgent item first. Include deadlines if any.",
+    "",
+    `Last working on: ${lastWork || "(unknown)"}`,
+    `Blockers: ${blockers || "(none)"}`,
+    `Next steps: ${nextSteps || "(none)"}`,
+    `Active projects (${projects.length}): ${projects.join(", ") || "(none)"}`,
+    `Pending commitments: ${commitments.join(", ") || "(none)"}`,
+    `Critical observations: ${redItems.join(" | ") || "(none)"}`,
+    `Notable observations: ${yellowItems.join(" | ") || "(none)"}`,
+    "",
+    "Write the briefing now. Be concise."
+  ].join("\n");
+  try {
+    if (process.env.GEMINI_API_KEY) {
+      const model = "gemini-2.0-flash";
+      const resp = await fetch(
+        `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${process.env.GEMINI_API_KEY}`,
+        {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            contents: [{ parts: [{ text: prompt }] }],
+            generationConfig: { temperature: 0.3, maxOutputTokens: 300 }
+          })
+        }
+      );
+      if (!resp.ok) return null;
+      const data = await resp.json();
+      return data.candidates?.[0]?.content?.parts?.[0]?.text?.trim() || null;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
 async function wake(options) {
   const vaultPath = path.resolve(options.vaultPath);
   const recovery = await recover(vaultPath, { clearFlag: true });
@@ -125,12 +188,19 @@ async function wake(options) {
   });
   const highlights = readRecentObservationHighlights(vaultPath);
   const observations = formatRecentObservations(highlights);
+  const execSummary = options.noSummary ? null : await generateExecutiveSummary(recovery, recap, highlights);
   const highlightSummaryItems = highlights.map((item) => `${item.priority} ${item.text}`);
   const wakeSummary = formatSummaryItems(highlightSummaryItems);
   const baseSummary = buildWakeSummary(recovery, recap);
-  const summary = wakeSummary ? `${baseSummary} | ${wakeSummary}` : baseSummary;
+  const fullBaseSummary = wakeSummary ? `${baseSummary} | ${wakeSummary}` : baseSummary;
+  const summary = execSummary || fullBaseSummary;
   const baseRecapMarkdown = vault.formatRecap(recap, { brief: options.brief ?? true }).trimEnd();
-  const recapMarkdown = `${baseRecapMarkdown}
+  const execSection = execSummary ? `## \u{1F4CB} Executive Summary
+
+${execSummary}
+
+` : "";
+  const recapMarkdown = `${execSection}${baseRecapMarkdown}
 
 ## Recent Observations
 ${observations}`;

package/dist/index.js

@@ -41,13 +41,13 @@ import {
   SessionWatcher,
   observeCommand,
   registerObserveCommand
-} from "./chunk-5VYRT2XZ.js";
+} from "./chunk-GZOBCUVO.js";
 import {
   Compressor,
   Observer,
   Reflector,
   parseSessionFile
-} from "./chunk-RPMQZZPE.js";
+} from "./chunk-KOF3HYSL.js";
 
 // src/index.ts
 import * as fs from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawvault",
-  "version": "1.11.0",
+  "version": "1.11.2",
   "description": "ClawVault™ - 🐘 An elephant never forgets. Structured memory for OpenClaw agents. Context death resilience, Obsidian-compatible markdown, local semantic search.",
   "type": "module",
   "main": "dist/index.cjs",