engrm 0.4.12 → 0.4.14

package/dist/hooks/session-start.js

@@ -395,6 +395,84 @@ function computeObservationPriority(obs, nowEpoch) {
   return computeBlendedScore(obs.quality, obs.created_at_epoch, nowEpoch) + observationTypeBoost(obs.type);
 }
 
+// src/intelligence/summary-sections.ts
+function extractSummaryItems(section, limit) {
+  if (!section || !section.trim())
+    return [];
+  const rawLines = section.split(`
+`).map((line) => line.replace(/\s+/g, " ").trim()).filter(Boolean);
+  const items = [];
+  const seen = new Set;
+  let heading = null;
+  for (const rawLine of rawLines) {
+    const line = stripSectionPrefix(rawLine);
+    if (!line)
+      continue;
+    const headingOnly = parseHeading(line);
+    if (headingOnly) {
+      heading = headingOnly;
+      continue;
+    }
+    const isBullet = /^[-*•]\s+/.test(line);
+    const stripped = line.replace(/^[-*•]\s+/, "").trim();
+    if (!stripped)
+      continue;
+    const item = heading && isBullet ? `${heading}: ${stripped}` : stripped;
+    const normalized = normalizeItem(item);
+    if (!normalized || seen.has(normalized))
+      continue;
+    seen.add(normalized);
+    items.push(item);
+    if (limit && items.length >= limit)
+      break;
+  }
+  return items;
+}
+function formatSummaryItems(section, maxLen) {
+  const items = extractSummaryItems(section);
+  if (items.length === 0)
+    return null;
+  const cleaned = items.map((item) => `- ${item}`).join(`
+`);
+  if (cleaned.length <= maxLen)
+    return cleaned;
+  const truncated = cleaned.slice(0, maxLen).trimEnd();
+  const lastBreak = Math.max(truncated.lastIndexOf(`
+`), truncated.lastIndexOf(" "));
+  const safe = lastBreak > maxLen * 0.5 ? truncated.slice(0, lastBreak) : truncated;
+  return `${safe.trimEnd()}…`;
+}
+function normalizeSummarySection(section) {
+  const items = extractSummaryItems(section);
+  if (items.length === 0) {
+    const cleaned = section?.replace(/\s+/g, " ").trim() ?? "";
+    return cleaned || null;
+  }
+  return items.map((item) => `- ${item}`).join(`
+`);
+}
+function normalizeSummaryRequest(value) {
+  const cleaned = value?.replace(/\s+/g, " ").trim() ?? "";
+  return cleaned || null;
+}
+function stripSectionPrefix(value) {
+  return value.replace(/^(request|investigated|learned|completed|next steps|summary):\s*/i, "").trim();
+}
+function parseHeading(value) {
+  const boldMatch = value.match(/^\*{1,2}\s*(.+?)\s*:\*{1,2}$/);
+  if (boldMatch?.[1]) {
+    return boldMatch[1].trim().replace(/\s+/g, " ");
+  }
+  const plainMatch = value.match(/^(.+?):$/);
+  if (plainMatch?.[1]) {
+    return plainMatch[1].trim().replace(/\s+/g, " ");
+  }
+  return null;
+}
+function normalizeItem(value) {
+  return value.toLowerCase().replace(/\*+/g, "").replace(/\s+/g, " ").trim();
+}
+
 // src/context/inject.ts
 function tokenizeProjectHint(text) {
   return Array.from(new Set((text.toLowerCase().match(/[a-z0-9_+-]{4,}/g) ?? []).filter(Boolean)));
@@ -786,23 +864,7 @@ function chooseMeaningfulSessionHeadline(request, completed) {
   return request ?? completed ?? "(no summary)";
 }
 function formatSummarySection(value, maxLen) {
-  if (!value)
-    return null;
-  const cleaned = value.split(`
-`).map((line) => line.trim()).filter(Boolean).map((line) => line.startsWith("-") ? line : `- ${line}`).join(`
-`);
-  if (!cleaned)
-    return null;
-  return truncateMultilineText(cleaned, maxLen);
-}
-function truncateMultilineText(text, maxLen) {
-  if (text.length <= maxLen)
-    return text;
-  const truncated = text.slice(0, maxLen).trimEnd();
-  const lastBreak = Math.max(truncated.lastIndexOf(`
-`), truncated.lastIndexOf(" "));
-  const safe = lastBreak > maxLen * 0.5 ? truncated.slice(0, lastBreak) : truncated;
-  return `${safe.trimEnd()}…`;
+  return formatSummaryItems(value, maxLen);
 }
 function truncateText(text, maxLen) {
   if (text.length <= maxLen)
@@ -826,8 +888,7 @@ function stripInlineSectionLabel(value) {
 function extractMeaningfulLines(value, limit) {
   if (!value)
     return [];
-  return value.split(`
-`).map((line) => line.trim()).filter(Boolean).map((line) => line.replace(/^[-*]\s*/, "")).map((line) => stripInlineSectionLabel(line)).filter((line) => line.length > 0 && !looksLikeFileOperationTitle(line)).slice(0, limit);
+  return extractSummaryItems(value).map((line) => stripInlineSectionLabel(line)).filter((line) => line.length > 0 && !looksLikeFileOperationTitle(line)).slice(0, limit);
 }
 function formatObservationDetailFromContext(obs) {
   if (obs.facts) {
@@ -1093,7 +1154,7 @@ import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync
 import { join as join3 } from "node:path";
 import { homedir } from "node:os";
 var STATE_PATH = join3(homedir(), ".engrm", "config-fingerprint.json");
-var CLIENT_VERSION = "0.4.0";
+var CLIENT_VERSION = "0.4.14";
 function hashFile(filePath) {
   try {
     if (!existsSync3(filePath))
@@ -2156,6 +2217,18 @@ var MIGRATIONS = [
       CREATE INDEX IF NOT EXISTS idx_tool_events_created
         ON tool_events(created_at_epoch DESC, id DESC);
     `
+  },
+  {
+    version: 11,
+    description: "Add observation provenance from tool and prompt chronology",
+    sql: `
+      ALTER TABLE observations ADD COLUMN source_tool TEXT;
+      ALTER TABLE observations ADD COLUMN source_prompt_number INTEGER;
+      CREATE INDEX IF NOT EXISTS idx_observations_source_tool
+        ON observations(source_tool, created_at_epoch DESC);
+      CREATE INDEX IF NOT EXISTS idx_observations_source_prompt
+        ON observations(session_id, source_prompt_number DESC);
+    `
   }
 ];
 function isVecExtensionLoaded(db) {
@@ -2209,6 +2282,8 @@ function inferLegacySchemaVersion(db) {
     version = Math.max(version, 9);
   if (tableExists(db, "tool_events"))
     version = Math.max(version, 10);
+  if (columnExists(db, "observations", "source_tool"))
+    version = Math.max(version, 11);
   return version;
 }
 function runMigrations(db) {
@@ -2406,8 +2481,9 @@ class MemDatabase {
     const result = this.db.query(`INSERT INTO observations (
           session_id, project_id, type, title, narrative, facts, concepts,
           files_read, files_modified, quality, lifecycle, sensitivity,
-          user_id, device_id, agent, created_at, created_at_epoch
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(obs.session_id ?? null, obs.project_id, obs.type, obs.title, obs.narrative ?? null, obs.facts ?? null, obs.concepts ?? null, obs.files_read ?? null, obs.files_modified ?? null, obs.quality, obs.lifecycle ?? "active", obs.sensitivity ?? "shared", obs.user_id, obs.device_id, obs.agent ?? "claude-code", createdAt, now);
+          user_id, device_id, agent, source_tool, source_prompt_number,
+          created_at, created_at_epoch
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(obs.session_id ?? null, obs.project_id, obs.type, obs.title, obs.narrative ?? null, obs.facts ?? null, obs.concepts ?? null, obs.files_read ?? null, obs.files_modified ?? null, obs.quality, obs.lifecycle ?? "active", obs.sensitivity ?? "shared", obs.user_id, obs.device_id, obs.agent ?? "claude-code", obs.source_tool ?? null, obs.source_prompt_number ?? null, createdAt, now);
     const id = Number(result.lastInsertRowid);
     const row = this.getObservationById(id);
     this.ftsInsert(row);
@@ -2648,6 +2724,13 @@ class MemDatabase {
          ORDER BY prompt_number ASC
          LIMIT ?`).all(sessionId, limit);
   }
+  getLatestSessionPromptNumber(sessionId) {
+    const row = this.db.query(`SELECT prompt_number FROM user_prompts
+         WHERE session_id = ?
+         ORDER BY prompt_number DESC
+         LIMIT 1`).get(sessionId);
+    return row?.prompt_number ?? null;
+  }
   insertToolEvent(input) {
     const createdAt = input.created_at_epoch ?? Math.floor(Date.now() / 1000);
     const result = this.db.query(`INSERT INTO tool_events (
@@ -2757,8 +2840,15 @@ class MemDatabase {
   }
   insertSessionSummary(summary) {
     const now = Math.floor(Date.now() / 1000);
+    const normalized = {
+      request: normalizeSummaryRequest(summary.request),
+      investigated: normalizeSummarySection(summary.investigated),
+      learned: normalizeSummarySection(summary.learned),
+      completed: normalizeSummarySection(summary.completed),
+      next_steps: normalizeSummarySection(summary.next_steps)
+    };
     const result = this.db.query(`INSERT INTO session_summaries (session_id, project_id, user_id, request, investigated, learned, completed, next_steps, created_at_epoch)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, summary.request, summary.investigated, summary.learned, summary.completed, summary.next_steps, now);
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(summary.session_id, summary.project_id, summary.user_id, normalized.request, normalized.investigated, normalized.learned, normalized.completed, normalized.next_steps, now);
     const id = Number(result.lastInsertRowid);
     return this.db.query("SELECT * FROM session_summaries WHERE id = ?").get(id);
   }
@@ -2964,7 +3054,8 @@ async function main() {
         securityFindings: context.securityFindings?.length ?? 0,
         unreadMessages: msgCount,
         synced: syncedCount,
-        context
+        context,
+        estimatedReadTokens: estimateTokens(formatContextForInjection(context))
       });
       let packLine = "";
       try {
@@ -3049,6 +3140,34 @@ function formatSplashScreen(data) {
       lines.push(`  ${line}`);
     }
   }
+  const economics = formatContextEconomics(data);
+  if (economics.length > 0) {
+    lines.push("");
+    for (const line of economics) {
+      lines.push(`  ${line}`);
+    }
+  }
+  const legend = formatLegend();
+  if (legend.length > 0) {
+    lines.push("");
+    for (const line of legend) {
+      lines.push(`  ${line}`);
+    }
+  }
+  const contextIndex = formatContextIndex(data.context);
+  if (contextIndex.length > 0) {
+    lines.push("");
+    for (const line of contextIndex) {
+      lines.push(`  ${line}`);
+    }
+  }
+  const inspectHints = formatInspectHints(data.context);
+  if (inspectHints.length > 0) {
+    lines.push("");
+    for (const line of inspectHints) {
+      lines.push(`  ${line}`);
+    }
+  }
   lines.push("");
   return lines.join(`
 `);
@@ -3157,6 +3276,62 @@ function formatVisibleStartupBrief(context) {
   }
   return lines.slice(0, 14);
 }
+function formatContextEconomics(data) {
+  const totalMemories = Math.max(0, data.loaded + data.available);
+  const parts = [];
+  if (totalMemories > 0) {
+    parts.push(`${totalMemories.toLocaleString()} total memories`);
+  }
+  if (data.estimatedReadTokens > 0) {
+    parts.push(`read now ~${data.estimatedReadTokens.toLocaleString()}t`);
+  }
+  if (data.context.observations.length > 0) {
+    parts.push(`${data.context.observations.length} observations loaded`);
+  }
+  if (parts.length === 0)
+    return [];
+  return [`${c2.dim}Context economics:${c2.reset} ${parts.join(" \xB7 ")}`];
+}
+function formatLegend() {
+  return [
+    `${c2.dim}Legend:${c2.reset} #id | \uD83D\uDD34 bugfix | \uD83D\uDFE3 feature | \uD83D\uDD04 refactor | \u2705 change | \uD83D\uDD35 discovery | \u2696\uFE0F decision`
+  ];
+}
+function formatContextIndex(context) {
+  const rows = context.observations.filter((obs) => obs.type !== "digest").slice(0, 6).map((obs) => {
+    const icon = observationIcon(obs.type);
+    const fileHint = extractPrimaryFileHint(obs);
+    return `${icon} #${obs.id} ${truncateInline(obs.title, 110)}${fileHint ? ` ${c2.dim}(${fileHint})${c2.reset}` : ""}`;
+  });
+  if (rows.length === 0)
+    return [];
+  return [
+    `${c2.dim}Context index:${c2.reset} use IDs to fetch deeper detail when needed`,
+    ...rows
+  ];
+}
+function formatInspectHints(context) {
+  const hints = [];
+  if ((context.recentSessions?.length ?? 0) > 0) {
+    hints.push("recent_sessions");
+    hints.push("session_story");
+  }
+  if ((context.recentPrompts?.length ?? 0) > 0 || (context.recentToolEvents?.length ?? 0) > 0) {
+    hints.push("activity_feed");
+  }
+  if (context.observations.length > 0) {
+    hints.push("memory_console");
+  }
+  const unique = Array.from(new Set(hints)).slice(0, 4);
+  if (unique.length === 0)
+    return [];
+  const ids = context.observations.slice(0, 5).map((obs) => obs.id);
+  const fetchHint = ids.length > 0 ? `get_observations([${ids.join(", ")}])` : null;
+  return [
+    `${c2.dim}Inspect:${c2.reset} ${unique.join(" \xB7 ")}`,
+    ...fetchHint ? [`${c2.dim}Fetch by ID:${c2.reset} ${fetchHint}`] : []
+  ];
+}
 function rememberShownItem(shown, value) {
   if (!value)
     return;
@@ -3280,6 +3455,39 @@ function buildProjectSignalLine(context) {
   const top = Object.entries(context.projectTypeCounts).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 4).map(([type, count]) => `${type} ${count}`).join("; ");
   return top || null;
 }
+function observationIcon(type) {
+  switch (type) {
+    case "bugfix":
+      return "\uD83D\uDD34";
+    case "feature":
+      return "\uD83D\uDFE3";
+    case "refactor":
+      return "\uD83D\uDD04";
+    case "change":
+      return "\u2705";
+    case "discovery":
+      return "\uD83D\uDD35";
+    case "decision":
+      return "\u2696\uFE0F";
+    default:
+      return "\u2022";
+  }
+}
+function extractPrimaryFileHint(obs) {
+  const firstRead = parseJsonArraySafe(obs.files_read)[0];
+  const firstModified = parseJsonArraySafe(obs.files_modified)[0];
+  return firstModified ?? firstRead ?? null;
+}
+function parseJsonArraySafe(value) {
+  if (!value)
+    return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+  } catch {
+    return [];
+  }
+}
 function toSplashLines(value, maxItems) {
   if (!value)
     return [];
@@ -3502,6 +3710,7 @@ function capitalize(value) {
   return value.charAt(0).toUpperCase() + value.slice(1);
 }
 var __testables = {
+  formatSplashScreen,
   formatVisibleStartupBrief
 };
 runHook("session-start", main);