claude-memory-hub 0.8.2 → 0.9.0

package/CHANGELOG.md

@@ -5,14 +5,29 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ---
 
-## [0.8.2] - 2026-04-02
+## [0.9.0] - 2026-04-02
 
-Increased context injection limits for richer cross-session memory.
+Smart context budget allocation — memory never gets pushed out by lower-priority content.
+
+### Smart Budget Allocation (breaking change in injection behavior)
+
+- **Priority-based `fitWithinBudget()`** — replaces naive sequential concatenation. Four content sections now compete for 8,000 chars with explicit priorities: P1 memory (min 500 chars) > P2 CLAUDE.md (min 200 chars) > P3 resource advice (droppable) > P4 overhead warning (droppable). When total fits, everything is kept. When over budget, lowest priority sections are shrunk or dropped first
+- **Memory context guaranteed** — past session context always gets first claim on budget. Previously could be truncated when CLAUDE.md + advice consumed too much space
+
+### CLAUDE.md Adaptive Compression
+
+- **3-level `formatForInjection()`** — CLAUDE.md summary now adapts to available budget: Level 3 (full: headings + token cost, >500 chars), Level 2 (compact: file + token cost, >200 chars), Level 1 (minimal: file names only, <200 chars). Previously always used full format regardless of remaining space
+
+### Overhead Warning Injection
+
+- **Auto-inject warning when unused resources > 10K tokens** — UserPromptSubmit hook now analyzes `OverheadReport` and injects a one-line note if unused skills/agents exceed 10,000 listing tokens. Points user to `memory_context_budget` tool for details. Zero-cost when overhead is acceptable
 
 ### Context Injection Limits
 
-- **UserPromptSubmit cap doubled** — `MAX_CHARS` increased from 4,500 (~1,125 tokens) to 8,000 (~2,000 tokens). Session-start context injection now carries significantly more past knowledge
-- **Proactive retrieval cap doubled** — `MAX_INJECTION_CHARS` increased from 1,500 (~375 tokens) to 3,000 (~750 tokens). Mid-session topic-shift injections now include fuller context from L3
+- **UserPromptSubmit cap doubled** — `MAX_CHARS` increased from 4,500 (~1,125 tokens) to 8,000 (~2,000 tokens)
+- **Proactive retrieval cap doubled** — `MAX_INJECTION_CHARS` increased from 1,500 (~375 tokens) to 3,000 (~750 tokens)
+- **Proactive summary slice increased** — per-result summary increased from 200 to 400 chars for richer mid-session context
+- **Memory result summary increased** — session-start per-result summary increased from 300 to 400 chars
 
 ---
 

package/README.md

@@ -74,6 +74,8 @@ Search:        Keyword-only, no semantic ranking
 | Multi-agent memory sharing | -- | -- | **Yes (free)** |
 | Permission-aware (approved only) | -- | -- | **Yes** |
 | Data export/import (JSONL) | -- | -- | **Yes** |
+| Smart budget allocation (priority-based) | -- | -- | **Yes** |
+| Overhead warning (unused resources) | -- | -- | **Yes** |
 | Hook batching (3ms vs 75ms) | -- | -- | **Yes** |
 | Browser UI | -- | Yes | **Yes** |
 | Health monitoring + auto-cleanup | -- | -- | **Yes** |
@@ -412,6 +414,7 @@ Migration is idempotent — safe to run multiple times with zero duplicates.
 | **v0.7.0** | Honest resource analysis, semantic search scaling, batch embeddings, 14 observation patterns, DB auto-cleanup, summarizer retry |
 | **v0.8.0** | 91 unit tests (was 0%), L1 read-through cache, PostToolUse batch queue (75ms→3ms), JSONL export/import, data cleanup CLI, CI/CD auto-publish |
 | **v0.8.1** | Token-budget-aware MCP tools (`max_tokens`), proactive mid-session memory retrieval (topic-shift detection), session-end batch flush |
+| **v0.9.0** | Smart budget allocation (priority-based, memory never pushed out), CLAUDE.md adaptive compression (3 levels), overhead warning auto-injection, doubled injection limits |
 
 See [CHANGELOG.md](CHANGELOG.md) for full details.
 

package/dist/hooks/post-compact.js

@@ -1829,15 +1829,26 @@ class ClaudeMdTracker {
       tokenCost: r.token_cost
     }));
   }
-  formatForInjection(entries) {
+  formatForInjection(entries, maxChars) {
     if (entries.length === 0)
       return "";
-    const lines = ["**Active CLAUDE.md rules:**"];
+    const minimal = `CLAUDE.md: ${entries.map((e) => basename2(dirname(e.path)) + "/" + basename2(e.path)).join(", ")}`;
+    if (maxChars !== undefined && maxChars < 200)
+      return minimal;
+    const compactLines = ["**Active CLAUDE.md rules:**"];
+    for (const e of entries) {
+      compactLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok)`);
+    }
+    const compact = compactLines.join(`
+`);
+    if (maxChars !== undefined && maxChars < 500)
+      return compact;
+    const fullLines = ["**Active CLAUDE.md rules:**"];
     for (const e of entries) {
       const headings = e.sections.map((s) => s.heading).join(", ");
-      lines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
+      fullLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
     }
-    return lines.join(`
+    return fullLines.join(`
 `);
   }
   computeHash(content) {
@@ -1955,36 +1966,77 @@ async function handleUserPromptSubmit(hook, project) {
   plan.recommendations = validator.filterAliveRecommendations(plan.recommendations);
   plan.skipped = validator.filterAliveRecommendations(plan.skipped);
   const advice = loader.formatContextAdvice(plan);
-  const lines = [];
-  if (results.length > 0) {
-    lines.push("**Past session context:**");
-    for (const r of results) {
-      const date = new Date(r.created_at).toLocaleDateString();
-      const files = safeJson3(r.files_touched, []);
-      lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 300)}`);
-      if (files.length > 0)
-        lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
-    }
-  }
-  if (advice)
-    lines.push("", advice);
+  let mdSummary = "";
   if (hook.cwd) {
     try {
       const mdTracker = new ClaudeMdTracker;
       const mdEntries = mdTracker.scanAndUpdate(hook.cwd, project);
-      const mdSummary = mdTracker.formatForInjection(mdEntries);
-      if (mdSummary)
-        lines.push("", mdSummary);
+      mdSummary = mdTracker.formatForInjection(mdEntries);
       const tracker = new ResourceTracker;
       for (const entry of mdEntries) {
         tracker.trackUsage(hook.session_id, project, "claude_md", entry.path, entry.tokenCost);
       }
     } catch {}
   }
-  const safeContext = validator.validate(lines.join(`
-`));
+  let overheadWarning = "";
+  try {
+    const overhead = await registry.getOverheadReport(project);
+    const unusedTokens = overhead.potential_savings.if_remove_unused_skills + overhead.potential_savings.if_remove_unused_agents;
+    if (unusedTokens > 1e4) {
+      const unusedCount = overhead.usage_analysis.skills_never_used.length + overhead.usage_analysis.agents_never_used.length;
+      overheadWarning = `Note: ${unusedCount} unused resources (~${unusedTokens} listing tok overhead). Run \`memory_context_budget\` for details.`;
+    }
+  } catch {}
+  const memorySection = buildMemorySection(results);
+  const safeContext = validator.validate(fitWithinBudget(memorySection, mdSummary, advice, overheadWarning));
   return { additionalContext: safeContext };
 }
+function fitWithinBudget(memoryText, mdText, adviceText, overheadText) {
+  const MAX_CHARS2 = 8000;
+  const sections = [
+    { text: memoryText, priority: 1, minChars: 500 },
+    { text: mdText, priority: 2, minChars: 200 },
+    { text: adviceText, priority: 3, minChars: 0 },
+    { text: overheadText, priority: 4, minChars: 0 }
+  ].filter((s) => s.text.length > 0);
+  const totalNeeded = sections.reduce((sum, s) => sum + s.text.length, 0);
+  if (totalNeeded <= MAX_CHARS2) {
+    return sections.map((s) => s.text).join(`
+
+`);
+  }
+  let remaining = MAX_CHARS2;
+  const allocated = [];
+  sections.sort((a, b) => a.priority - b.priority);
+  for (const section of sections) {
+    if (remaining <= 0)
+      break;
+    if (section.text.length <= remaining) {
+      allocated.push(section.text);
+      remaining -= section.text.length + 2;
+    } else if (remaining >= section.minChars) {
+      allocated.push(section.text.slice(0, remaining));
+      remaining = 0;
+    }
+  }
+  return allocated.join(`
+
+`);
+}
+function buildMemorySection(results) {
+  if (results.length === 0)
+    return "";
+  const lines = ["**Past session context:**"];
+  for (const r of results) {
+    const date = new Date(r.created_at).toLocaleDateString();
+    const files = safeJson3(r.files_touched, []);
+    lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 400)}`);
+    if (files.length > 0)
+      lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
+  }
+  return lines.join(`
+`);
+}
 async function handleSessionEnd(hook, project) {
   const store = new SessionStore;
   store.completeSession(hook.session_id);

package/dist/hooks/post-tool-use.js

@@ -1536,15 +1536,26 @@ class ClaudeMdTracker {
       tokenCost: r.token_cost
     }));
   }
-  formatForInjection(entries) {
+  formatForInjection(entries, maxChars) {
     if (entries.length === 0)
       return "";
-    const lines = ["**Active CLAUDE.md rules:**"];
+    const minimal = `CLAUDE.md: ${entries.map((e) => basename2(dirname(e.path)) + "/" + basename2(e.path)).join(", ")}`;
+    if (maxChars !== undefined && maxChars < 200)
+      return minimal;
+    const compactLines = ["**Active CLAUDE.md rules:**"];
+    for (const e of entries) {
+      compactLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok)`);
+    }
+    const compact = compactLines.join(`
+`);
+    if (maxChars !== undefined && maxChars < 500)
+      return compact;
+    const fullLines = ["**Active CLAUDE.md rules:**"];
     for (const e of entries) {
       const headings = e.sections.map((s) => s.heading).join(", ");
-      lines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
+      fullLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
     }
-    return lines.join(`
+    return fullLines.join(`
 `);
   }
   computeHash(content) {
@@ -1662,36 +1673,77 @@ async function handleUserPromptSubmit(hook, project) {
   plan.recommendations = validator.filterAliveRecommendations(plan.recommendations);
   plan.skipped = validator.filterAliveRecommendations(plan.skipped);
   const advice = loader.formatContextAdvice(plan);
-  const lines = [];
-  if (results.length > 0) {
-    lines.push("**Past session context:**");
-    for (const r of results) {
-      const date = new Date(r.created_at).toLocaleDateString();
-      const files = safeJson3(r.files_touched, []);
-      lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 300)}`);
-      if (files.length > 0)
-        lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
-    }
-  }
-  if (advice)
-    lines.push("", advice);
+  let mdSummary = "";
   if (hook.cwd) {
     try {
       const mdTracker = new ClaudeMdTracker;
       const mdEntries = mdTracker.scanAndUpdate(hook.cwd, project);
-      const mdSummary = mdTracker.formatForInjection(mdEntries);
-      if (mdSummary)
-        lines.push("", mdSummary);
+      mdSummary = mdTracker.formatForInjection(mdEntries);
       const tracker = new ResourceTracker;
       for (const entry of mdEntries) {
         tracker.trackUsage(hook.session_id, project, "claude_md", entry.path, entry.tokenCost);
       }
     } catch {}
   }
-  const safeContext = validator.validate(lines.join(`
-`));
+  let overheadWarning = "";
+  try {
+    const overhead = await registry.getOverheadReport(project);
+    const unusedTokens = overhead.potential_savings.if_remove_unused_skills + overhead.potential_savings.if_remove_unused_agents;
+    if (unusedTokens > 1e4) {
+      const unusedCount = overhead.usage_analysis.skills_never_used.length + overhead.usage_analysis.agents_never_used.length;
+      overheadWarning = `Note: ${unusedCount} unused resources (~${unusedTokens} listing tok overhead). Run \`memory_context_budget\` for details.`;
+    }
+  } catch {}
+  const memorySection = buildMemorySection(results);
+  const safeContext = validator.validate(fitWithinBudget(memorySection, mdSummary, advice, overheadWarning));
   return { additionalContext: safeContext };
 }
+function fitWithinBudget(memoryText, mdText, adviceText, overheadText) {
+  const MAX_CHARS2 = 8000;
+  const sections = [
+    { text: memoryText, priority: 1, minChars: 500 },
+    { text: mdText, priority: 2, minChars: 200 },
+    { text: adviceText, priority: 3, minChars: 0 },
+    { text: overheadText, priority: 4, minChars: 0 }
+  ].filter((s) => s.text.length > 0);
+  const totalNeeded = sections.reduce((sum, s) => sum + s.text.length, 0);
+  if (totalNeeded <= MAX_CHARS2) {
+    return sections.map((s) => s.text).join(`
+
+`);
+  }
+  let remaining = MAX_CHARS2;
+  const allocated = [];
+  sections.sort((a, b) => a.priority - b.priority);
+  for (const section of sections) {
+    if (remaining <= 0)
+      break;
+    if (section.text.length <= remaining) {
+      allocated.push(section.text);
+      remaining -= section.text.length + 2;
+    } else if (remaining >= section.minChars) {
+      allocated.push(section.text.slice(0, remaining));
+      remaining = 0;
+    }
+  }
+  return allocated.join(`
+
+`);
+}
+function buildMemorySection(results) {
+  if (results.length === 0)
+    return "";
+  const lines = ["**Past session context:**"];
+  for (const r of results) {
+    const date = new Date(r.created_at).toLocaleDateString();
+    const files = safeJson3(r.files_touched, []);
+    lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 400)}`);
+    if (files.length > 0)
+      lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
+  }
+  return lines.join(`
+`);
+}
 async function handleSessionEnd(hook, project) {
   const store = new SessionStore;
   store.completeSession(hook.session_id);
@@ -1869,7 +1921,7 @@ function evaluateProactiveInjection(sessionId, toolName, toolInput, toolResponse
   const lines = [`**Relevant past context** (topic: ${currentTopic}):`];
   for (const r of results) {
     const date = new Date(r.created_at).toLocaleDateString();
-    lines.push(`- [${date}] ${r.summary.slice(0, 200)}`);
+    lines.push(`- [${date}] ${r.summary.slice(0, 400)}`);
     const files = safeJson4(r.files_touched, []);
     if (files.length > 0)
       lines.push(`  Files: ${files.slice(0, 3).join(", ")}`);

package/dist/hooks/pre-compact.js

@@ -1829,15 +1829,26 @@ class ClaudeMdTracker {
       tokenCost: r.token_cost
     }));
   }
-  formatForInjection(entries) {
+  formatForInjection(entries, maxChars) {
     if (entries.length === 0)
       return "";
-    const lines = ["**Active CLAUDE.md rules:**"];
+    const minimal = `CLAUDE.md: ${entries.map((e) => basename2(dirname(e.path)) + "/" + basename2(e.path)).join(", ")}`;
+    if (maxChars !== undefined && maxChars < 200)
+      return minimal;
+    const compactLines = ["**Active CLAUDE.md rules:**"];
+    for (const e of entries) {
+      compactLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok)`);
+    }
+    const compact = compactLines.join(`
+`);
+    if (maxChars !== undefined && maxChars < 500)
+      return compact;
+    const fullLines = ["**Active CLAUDE.md rules:**"];
     for (const e of entries) {
       const headings = e.sections.map((s) => s.heading).join(", ");
-      lines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
+      fullLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
     }
-    return lines.join(`
+    return fullLines.join(`
 `);
   }
   computeHash(content) {
@@ -1955,36 +1966,77 @@ async function handleUserPromptSubmit(hook, project) {
   plan.recommendations = validator.filterAliveRecommendations(plan.recommendations);
   plan.skipped = validator.filterAliveRecommendations(plan.skipped);
   const advice = loader.formatContextAdvice(plan);
-  const lines = [];
-  if (results.length > 0) {
-    lines.push("**Past session context:**");
-    for (const r of results) {
-      const date = new Date(r.created_at).toLocaleDateString();
-      const files = safeJson3(r.files_touched, []);
-      lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 300)}`);
-      if (files.length > 0)
-        lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
-    }
-  }
-  if (advice)
-    lines.push("", advice);
+  let mdSummary = "";
   if (hook.cwd) {
     try {
       const mdTracker = new ClaudeMdTracker;
       const mdEntries = mdTracker.scanAndUpdate(hook.cwd, project);
-      const mdSummary = mdTracker.formatForInjection(mdEntries);
-      if (mdSummary)
-        lines.push("", mdSummary);
+      mdSummary = mdTracker.formatForInjection(mdEntries);
       const tracker = new ResourceTracker;
       for (const entry of mdEntries) {
         tracker.trackUsage(hook.session_id, project, "claude_md", entry.path, entry.tokenCost);
       }
     } catch {}
   }
-  const safeContext = validator.validate(lines.join(`
-`));
+  let overheadWarning = "";
+  try {
+    const overhead = await registry.getOverheadReport(project);
+    const unusedTokens = overhead.potential_savings.if_remove_unused_skills + overhead.potential_savings.if_remove_unused_agents;
+    if (unusedTokens > 1e4) {
+      const unusedCount = overhead.usage_analysis.skills_never_used.length + overhead.usage_analysis.agents_never_used.length;
+      overheadWarning = `Note: ${unusedCount} unused resources (~${unusedTokens} listing tok overhead). Run \`memory_context_budget\` for details.`;
+    }
+  } catch {}
+  const memorySection = buildMemorySection(results);
+  const safeContext = validator.validate(fitWithinBudget(memorySection, mdSummary, advice, overheadWarning));
   return { additionalContext: safeContext };
 }
+function fitWithinBudget(memoryText, mdText, adviceText, overheadText) {
+  const MAX_CHARS2 = 8000;
+  const sections = [
+    { text: memoryText, priority: 1, minChars: 500 },
+    { text: mdText, priority: 2, minChars: 200 },
+    { text: adviceText, priority: 3, minChars: 0 },
+    { text: overheadText, priority: 4, minChars: 0 }
+  ].filter((s) => s.text.length > 0);
+  const totalNeeded = sections.reduce((sum, s) => sum + s.text.length, 0);
+  if (totalNeeded <= MAX_CHARS2) {
+    return sections.map((s) => s.text).join(`
+
+`);
+  }
+  let remaining = MAX_CHARS2;
+  const allocated = [];
+  sections.sort((a, b) => a.priority - b.priority);
+  for (const section of sections) {
+    if (remaining <= 0)
+      break;
+    if (section.text.length <= remaining) {
+      allocated.push(section.text);
+      remaining -= section.text.length + 2;
+    } else if (remaining >= section.minChars) {
+      allocated.push(section.text.slice(0, remaining));
+      remaining = 0;
+    }
+  }
+  return allocated.join(`
+
+`);
+}
+function buildMemorySection(results) {
+  if (results.length === 0)
+    return "";
+  const lines = ["**Past session context:**"];
+  for (const r of results) {
+    const date = new Date(r.created_at).toLocaleDateString();
+    const files = safeJson3(r.files_touched, []);
+    lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 400)}`);
+    if (files.length > 0)
+      lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
+  }
+  return lines.join(`
+`);
+}
 async function handleSessionEnd(hook, project) {
   const store = new SessionStore;
   store.completeSession(hook.session_id);

package/dist/hooks/session-end.js

@@ -1536,15 +1536,26 @@ class ClaudeMdTracker {
       tokenCost: r.token_cost
     }));
   }
-  formatForInjection(entries) {
+  formatForInjection(entries, maxChars) {
     if (entries.length === 0)
       return "";
-    const lines = ["**Active CLAUDE.md rules:**"];
+    const minimal = `CLAUDE.md: ${entries.map((e) => basename2(dirname(e.path)) + "/" + basename2(e.path)).join(", ")}`;
+    if (maxChars !== undefined && maxChars < 200)
+      return minimal;
+    const compactLines = ["**Active CLAUDE.md rules:**"];
+    for (const e of entries) {
+      compactLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok)`);
+    }
+    const compact = compactLines.join(`
+`);
+    if (maxChars !== undefined && maxChars < 500)
+      return compact;
+    const fullLines = ["**Active CLAUDE.md rules:**"];
     for (const e of entries) {
       const headings = e.sections.map((s) => s.heading).join(", ");
-      lines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
+      fullLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
     }
-    return lines.join(`
+    return fullLines.join(`
 `);
   }
   computeHash(content) {
@@ -1662,36 +1673,77 @@ async function handleUserPromptSubmit(hook, project) {
   plan.recommendations = validator.filterAliveRecommendations(plan.recommendations);
   plan.skipped = validator.filterAliveRecommendations(plan.skipped);
   const advice = loader.formatContextAdvice(plan);
-  const lines = [];
-  if (results.length > 0) {
-    lines.push("**Past session context:**");
-    for (const r of results) {
-      const date = new Date(r.created_at).toLocaleDateString();
-      const files = safeJson3(r.files_touched, []);
-      lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 300)}`);
-      if (files.length > 0)
-        lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
-    }
-  }
-  if (advice)
-    lines.push("", advice);
+  let mdSummary = "";
   if (hook.cwd) {
     try {
       const mdTracker = new ClaudeMdTracker;
       const mdEntries = mdTracker.scanAndUpdate(hook.cwd, project);
-      const mdSummary = mdTracker.formatForInjection(mdEntries);
-      if (mdSummary)
-        lines.push("", mdSummary);
+      mdSummary = mdTracker.formatForInjection(mdEntries);
       const tracker = new ResourceTracker;
       for (const entry of mdEntries) {
         tracker.trackUsage(hook.session_id, project, "claude_md", entry.path, entry.tokenCost);
       }
     } catch {}
   }
-  const safeContext = validator.validate(lines.join(`
-`));
+  let overheadWarning = "";
+  try {
+    const overhead = await registry.getOverheadReport(project);
+    const unusedTokens = overhead.potential_savings.if_remove_unused_skills + overhead.potential_savings.if_remove_unused_agents;
+    if (unusedTokens > 1e4) {
+      const unusedCount = overhead.usage_analysis.skills_never_used.length + overhead.usage_analysis.agents_never_used.length;
+      overheadWarning = `Note: ${unusedCount} unused resources (~${unusedTokens} listing tok overhead). Run \`memory_context_budget\` for details.`;
+    }
+  } catch {}
+  const memorySection = buildMemorySection(results);
+  const safeContext = validator.validate(fitWithinBudget(memorySection, mdSummary, advice, overheadWarning));
   return { additionalContext: safeContext };
 }
+function fitWithinBudget(memoryText, mdText, adviceText, overheadText) {
+  const MAX_CHARS2 = 8000;
+  const sections = [
+    { text: memoryText, priority: 1, minChars: 500 },
+    { text: mdText, priority: 2, minChars: 200 },
+    { text: adviceText, priority: 3, minChars: 0 },
+    { text: overheadText, priority: 4, minChars: 0 }
+  ].filter((s) => s.text.length > 0);
+  const totalNeeded = sections.reduce((sum, s) => sum + s.text.length, 0);
+  if (totalNeeded <= MAX_CHARS2) {
+    return sections.map((s) => s.text).join(`
+
+`);
+  }
+  let remaining = MAX_CHARS2;
+  const allocated = [];
+  sections.sort((a, b) => a.priority - b.priority);
+  for (const section of sections) {
+    if (remaining <= 0)
+      break;
+    if (section.text.length <= remaining) {
+      allocated.push(section.text);
+      remaining -= section.text.length + 2;
+    } else if (remaining >= section.minChars) {
+      allocated.push(section.text.slice(0, remaining));
+      remaining = 0;
+    }
+  }
+  return allocated.join(`
+
+`);
+}
+function buildMemorySection(results) {
+  if (results.length === 0)
+    return "";
+  const lines = ["**Past session context:**"];
+  for (const r of results) {
+    const date = new Date(r.created_at).toLocaleDateString();
+    const files = safeJson3(r.files_touched, []);
+    lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 400)}`);
+    if (files.length > 0)
+      lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
+  }
+  return lines.join(`
+`);
+}
 async function handleSessionEnd(hook, project) {
   const store = new SessionStore;
   store.completeSession(hook.session_id);
@@ -2057,7 +2109,7 @@ function evaluateProactiveInjection(sessionId, toolName, toolInput, toolResponse
   const lines = [`**Relevant past context** (topic: ${currentTopic}):`];
   for (const r of results) {
     const date = new Date(r.created_at).toLocaleDateString();
-    lines.push(`- [${date}] ${r.summary.slice(0, 200)}`);
+    lines.push(`- [${date}] ${r.summary.slice(0, 400)}`);
     const files = safeJson4(r.files_touched, []);
     if (files.length > 0)
       lines.push(`  Files: ${files.slice(0, 3).join(", ")}`);

package/dist/hooks/user-prompt-submit.js

@@ -1536,15 +1536,26 @@ class ClaudeMdTracker {
       tokenCost: r.token_cost
     }));
   }
-  formatForInjection(entries) {
+  formatForInjection(entries, maxChars) {
     if (entries.length === 0)
       return "";
-    const lines = ["**Active CLAUDE.md rules:**"];
+    const minimal = `CLAUDE.md: ${entries.map((e) => basename2(dirname(e.path)) + "/" + basename2(e.path)).join(", ")}`;
+    if (maxChars !== undefined && maxChars < 200)
+      return minimal;
+    const compactLines = ["**Active CLAUDE.md rules:**"];
+    for (const e of entries) {
+      compactLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok)`);
+    }
+    const compact = compactLines.join(`
+`);
+    if (maxChars !== undefined && maxChars < 500)
+      return compact;
+    const fullLines = ["**Active CLAUDE.md rules:**"];
     for (const e of entries) {
       const headings = e.sections.map((s) => s.heading).join(", ");
-      lines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
+      fullLines.push(`- ${basename2(dirname(e.path))}/${basename2(e.path)} (~${e.tokenCost} tok): ${headings || "no sections"}`);
     }
-    return lines.join(`
+    return fullLines.join(`
 `);
   }
   computeHash(content) {
@@ -1662,36 +1673,77 @@ async function handleUserPromptSubmit(hook, project) {
   plan.recommendations = validator.filterAliveRecommendations(plan.recommendations);
   plan.skipped = validator.filterAliveRecommendations(plan.skipped);
   const advice = loader.formatContextAdvice(plan);
-  const lines = [];
-  if (results.length > 0) {
-    lines.push("**Past session context:**");
-    for (const r of results) {
-      const date = new Date(r.created_at).toLocaleDateString();
-      const files = safeJson3(r.files_touched, []);
-      lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 300)}`);
-      if (files.length > 0)
-        lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
-    }
-  }
-  if (advice)
-    lines.push("", advice);
+  let mdSummary = "";
   if (hook.cwd) {
     try {
       const mdTracker = new ClaudeMdTracker;
       const mdEntries = mdTracker.scanAndUpdate(hook.cwd, project);
-      const mdSummary = mdTracker.formatForInjection(mdEntries);
-      if (mdSummary)
-        lines.push("", mdSummary);
+      mdSummary = mdTracker.formatForInjection(mdEntries);
       const tracker = new ResourceTracker;
       for (const entry of mdEntries) {
         tracker.trackUsage(hook.session_id, project, "claude_md", entry.path, entry.tokenCost);
       }
     } catch {}
   }
-  const safeContext = validator.validate(lines.join(`
-`));
+  let overheadWarning = "";
+  try {
+    const overhead = await registry.getOverheadReport(project);
+    const unusedTokens = overhead.potential_savings.if_remove_unused_skills + overhead.potential_savings.if_remove_unused_agents;
+    if (unusedTokens > 1e4) {
+      const unusedCount = overhead.usage_analysis.skills_never_used.length + overhead.usage_analysis.agents_never_used.length;
+      overheadWarning = `Note: ${unusedCount} unused resources (~${unusedTokens} listing tok overhead). Run \`memory_context_budget\` for details.`;
+    }
+  } catch {}
+  const memorySection = buildMemorySection(results);
+  const safeContext = validator.validate(fitWithinBudget(memorySection, mdSummary, advice, overheadWarning));
   return { additionalContext: safeContext };
 }
+function fitWithinBudget(memoryText, mdText, adviceText, overheadText) {
+  const MAX_CHARS2 = 8000;
+  const sections = [
+    { text: memoryText, priority: 1, minChars: 500 },
+    { text: mdText, priority: 2, minChars: 200 },
+    { text: adviceText, priority: 3, minChars: 0 },
+    { text: overheadText, priority: 4, minChars: 0 }
+  ].filter((s) => s.text.length > 0);
+  const totalNeeded = sections.reduce((sum, s) => sum + s.text.length, 0);
+  if (totalNeeded <= MAX_CHARS2) {
+    return sections.map((s) => s.text).join(`
+
+`);
+  }
+  let remaining = MAX_CHARS2;
+  const allocated = [];
+  sections.sort((a, b) => a.priority - b.priority);
+  for (const section of sections) {
+    if (remaining <= 0)
+      break;
+    if (section.text.length <= remaining) {
+      allocated.push(section.text);
+      remaining -= section.text.length + 2;
+    } else if (remaining >= section.minChars) {
+      allocated.push(section.text.slice(0, remaining));
+      remaining = 0;
+    }
+  }
+  return allocated.join(`
+
+`);
+}
+function buildMemorySection(results) {
+  if (results.length === 0)
+    return "";
+  const lines = ["**Past session context:**"];
+  for (const r of results) {
+    const date = new Date(r.created_at).toLocaleDateString();
+    const files = safeJson3(r.files_touched, []);
+    lines.push(`- [${date}, ${r.project}] ${r.summary.slice(0, 400)}`);
+    if (files.length > 0)
+      lines.push(`  Files: ${files.slice(0, 5).join(", ")}`);
+  }
+  return lines.join(`
+`);
+}
 async function handleSessionEnd(hook, project) {
   const store = new SessionStore;
   store.completeSession(hook.session_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-memory-hub",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Persistent memory system for Claude Code. Zero API key. Zero Python. 5 hooks + MCP server + SQLite FTS5 + semantic search.",
   "type": "module",
   "main": "dist/index.js",