claude-memory-hub 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -5,6 +5,32 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ---
 
+## [0.9.0] - 2026-04-02
+
+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)
+- **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
+
+---
+
 ## [0.8.1] - 2026-04-02
 
 Token-budget-aware MCP tools + proactive mid-session memory retrieval.

package/README.md

@@ -17,6 +17,31 @@ Zero API key. Zero Python. Zero config. One install command.
 
 ---
 
+## Why memory-hub?
+
+**Claude Code forgets everything.** Every session starts from zero. Auto-compact destroys 90% of your context. You lose files, decisions, errors — hours of work, gone.
+
+**claude-memory-hub fixes this.** One install command. No API key. No Python. No Docker.
+
+What makes it different? **The Compact Interceptor** — something no other memory tool has. When Claude Code auto-compacts at 200K tokens, memory-hub *tells the compact engine what matters*. PreCompact hook injects priority instructions. PostCompact hook saves the full summary. Result: 90% context salvage instead of vaporization.
+
+But it doesn't stop there:
+- **Cross-session memory** — past work auto-injected when you start a new session
+- **3-engine hybrid search** — FTS5 + TF-IDF + semantic embeddings (384-dim, offline)
+- **Proactive retrieval** — detects topic shifts mid-session, injects relevant context automatically
+- **91 unit tests**, batch queue (75ms→3ms), JSONL export/import, browser UI
+- **Multi-agent ready** — subagents share memory for free via MCP
+
+Built for developers who use Claude Code daily and are tired of repeating themselves.
+
+```bash
+bunx claude-memory-hub install
+```
+
+That's it. Your Claude now remembers.
+
+---
+
 ## The Problem
 
 Claude Code forgets everything between sessions. Within long sessions, auto-compact destroys 90% of context. Search is keyword-only with no ranking.
@@ -49,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** |
@@ -156,10 +183,10 @@ User prompt contains "remember that we use TypeScript strict"
 ## Architecture
 
 ```
-┌──────────────────────────────────────────────────────────────┐
-│                      Claude Code                             │
-│                                                              │
-│  5 Lifecycle Hooks                                           │
+┌─────────────────────────────────────────────────────────────┐
+│                      Claude Code                            │
+│                                                             │
+│  5 Lifecycle Hooks                                          │
 │  ┌───────────────┐  ┌──────────────┐  ┌──────────────┐      │
 │  │ PostToolUse   │  │ PreCompact   │  │ PostCompact  │      │
 │  │ batch queue   │  │ inject       │  │ save summary │      │
@@ -169,25 +196,25 @@ User prompt contains "remember that we use TypeScript strict"
 │  │UserPrompt    │          │          │ Stop         │      │
 │  │Submit: inject│          │          │ session end  │      │
 │  │past context  │          │          │ summarize    │      │
-│  └──────────────┘          │          └──────────────┘      │
+│  └──────────────┘          │          └──────────────┘      │ 
 │                            │                                │
 │  MCP Server (stdio, long-lived)                             │
 │  ┌─────────────────────────────────────────────────────┐    │
 │  │ memory_recall        memory_search  (L1 index)      │    │
 │  │ memory_entities      memory_timeline (L2 context)   │    │
 │  │ memory_session_notes memory_fetch   (L3 full)       │    │
-│  │ memory_store         memory_context_budget           │    │
-│  │ memory_health                                        │    │
-│  │                                                      │    │
-│  │ L1 WorkingMemory: read-through cache over L2         │    │
+│  │ memory_store         memory_context_budget          │    │
+│  │ memory_health                                       │    │
+│  │                                                     │    │
+│  │ L1 WorkingMemory: read-through cache over L2        │    │
 │  └─────────────────────────────────────────────────────┘    │
-│                                                              │
-│  Resource Intelligence    Browser UI (:37888)                │
+│                                                             │
+│  Resource Intelligence    Browser UI (:37888)               │
 │  ┌──────────────────┐     ┌──────────────────┐              │
 │  │ scan → track →   │     │ search, browse,  │              │
-│  │ analyze overhead  │     │ stats, health    │              │
+│  │ analyze overhead │     │ stats, health    │              │
 │  └──────────────────┘     └──────────────────┘              │
-└──────────────────────────────────────────────────────────────┘
+└─────────────────────────────────────────────────────────────┘
                              │
                    ┌─────────┴──────────┐
                    │   SQLite + FTS5    │
@@ -195,7 +222,7 @@ User prompt contains "remember that we use TypeScript strict"
                    │   memory-hub/      │
                    │                    │
                    │   memory.db        │
-                   │   batch/queue.jsonl │
+                   │   batch/queue.jsonl│
                    │   logs/            │
                    └────────────────────┘
 ```
@@ -216,7 +243,7 @@ User prompt contains "remember that we use TypeScript strict"
 │  files, errors, decisions   Per-session scope       │
 │  observations (14 patterns) Importance scored 1-5   │
 ├─────────────────────────────────────────────────────┤
-│  L3: LongTermStore          SQLite + FTS5 + TF-IDF │
+│  L3: LongTermStore          SQLite + FTS5 + TF-IDF  │
 │  Cross-session summaries    <100ms access           │
 │  Hybrid ranked search       Persistent forever      │
 │  Semantic embeddings        3-layer progressive     │
@@ -387,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

@@ -1717,7 +1717,7 @@ function safeJson(text, fallback) {
 
 // src/context/injection-validator.ts
 var log5 = createLogger("injection-validator");
-var MAX_CHARS = 4500;
+var MAX_CHARS = 8000;
 
 class InjectionValidator {
   registry;
@@ -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

@@ -1424,7 +1424,7 @@ function safeJson(text, fallback) {
 
 // src/context/injection-validator.ts
 var log3 = createLogger("injection-validator");
-var MAX_CHARS = 4500;
+var MAX_CHARS = 8000;
 
 class InjectionValidator {
   registry;
@@ -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);
@@ -1841,7 +1893,7 @@ var log6 = createLogger("proactive-retrieval");
 var DATA_DIR2 = join6(homedir5(), ".claude-memory-hub");
 var PROACTIVE_DIR = join6(DATA_DIR2, "proactive");
 var TOOL_CALL_INTERVAL = 15;
-var MAX_INJECTION_CHARS = 1500;
+var MAX_INJECTION_CHARS = 3000;
 function evaluateProactiveInjection(sessionId, toolName, toolInput, toolResponse) {
   const state = loadState(sessionId);
   state.toolCallCount++;
@@ -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

@@ -1717,7 +1717,7 @@ function safeJson(text, fallback) {
 
 // src/context/injection-validator.ts
 var log5 = createLogger("injection-validator");
-var MAX_CHARS = 4500;
+var MAX_CHARS = 8000;
 
 class InjectionValidator {
   registry;
@@ -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

@@ -1424,7 +1424,7 @@ function safeJson(text, fallback) {
 
 // src/context/injection-validator.ts
 var log3 = createLogger("injection-validator");
-var MAX_CHARS = 4500;
+var MAX_CHARS = 8000;
 
 class InjectionValidator {
   registry;
@@ -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);
@@ -2029,7 +2081,7 @@ var log9 = createLogger("proactive-retrieval");
 var DATA_DIR = join5(homedir4(), ".claude-memory-hub");
 var PROACTIVE_DIR = join5(DATA_DIR, "proactive");
 var TOOL_CALL_INTERVAL = 15;
-var MAX_INJECTION_CHARS = 1500;
+var MAX_INJECTION_CHARS = 3000;
 function evaluateProactiveInjection(sessionId, toolName, toolInput, toolResponse) {
   const state = loadState(sessionId);
   state.toolCallCount++;
@@ -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

@@ -1424,7 +1424,7 @@ function safeJson(text, fallback) {
 
 // src/context/injection-validator.ts
 var log3 = createLogger("injection-validator");
-var MAX_CHARS = 4500;
+var MAX_CHARS = 8000;
 
 class InjectionValidator {
   registry;
@@ -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.1",
+  "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",