hmem-mcp 5.0.0 → 5.1.21

package/dist/mcp-server.js

@@ -116,14 +116,14 @@ function syncPull(hmemPath) {
                 "pull", "--config", hmemSyncConfig(hmemPath),
                 "--hmem-path", hmemPath,
                 "--server-url", s.serverUrl, "--token", s.token,
-            ], { env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32" });
+            ], { env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32", windowsHide: true });
             if (result.error)
                 process.stderr.write(`hmem-sync pull error (${s.name ?? s.serverUrl}): ${result.error.message}\n`);
         }
     }
     else {
         const result = spawnSync("hmem-sync", ["pull", "--config", hmemSyncConfig(hmemPath), "--hmem-path", hmemPath], {
-            env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32",
+            env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32", windowsHide: true,
         });
         if (result.error)
             process.stderr.write(`hmem-sync pull error: ${result.error.message}\n`);
@@ -175,12 +175,12 @@ function syncPullThenPush(hmemPath) {
                 "pull", "--config", hmemSyncConfig(hmemPath),
                 "--hmem-path", hmemPath,
                 "--server-url", s.serverUrl, "--token", s.token,
-            ], { env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32" });
+            ], { env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32", windowsHide: true });
         }
     }
     else {
         spawnSync("hmem-sync", ["pull", "--config", hmemSyncConfig(hmemPath), "--hmem-path", hmemPath], {
-            env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32",
+            env: { ...process.env }, encoding: "utf8", shell: process.platform === "win32", windowsHide: true,
         });
     }
     lastPullAt = Date.now();
@@ -197,13 +197,13 @@ function syncPush(hmemPath) {
                 "push", "--config", hmemSyncConfig(hmemPath),
                 "--hmem-path", hmemPath,
                 "--server-url", s.serverUrl, "--token", s.token,
-            ], { env: { ...process.env }, shell: process.platform === "win32", stdio: "ignore", detached: true });
+            ], { env: { ...process.env }, shell: process.platform === "win32", stdio: "ignore", detached: true, windowsHide: true });
             child.unref();
         }
     }
     else {
         const child = spawn("hmem-sync", ["push", "--config", hmemSyncConfig(hmemPath), "--hmem-path", hmemPath], {
-            env: { ...process.env }, shell: process.platform === "win32", stdio: "ignore", detached: true,
+            env: { ...process.env }, shell: process.platform === "win32", stdio: "ignore", detached: true, windowsHide: true,
         });
         child.unref();
     }
@@ -211,11 +211,60 @@ function syncPush(hmemPath) {
 // Load hmem config (hmem.config.json in project dir, falls back to defaults)
 const hmemConfig = loadHmemConfig(PROJECT_DIR);
 log(`Config: levels=[${hmemConfig.maxCharsPerLevel.join(",")}] depth=${hmemConfig.maxDepth}`);
+// ---- Version upgrade detection ----
+import { createRequire } from "node:module";
+const _require = createRequire(import.meta.url);
+const PKG_VERSION = _require("../package.json").version;
+/** Check if hmem was upgraded since last session. Auto-syncs skills and returns upgrade notice. */
+function checkVersionUpgrade() {
+    try {
+        const configPath = path.join(PROJECT_DIR, "hmem.config.json");
+        if (!fs.existsSync(configPath))
+            return "";
+        const raw = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        const lastSeen = raw?.memory?.lastSeenVersion || raw?.lastSeenVersion;
+        if (!lastSeen) {
+            // First run with version tracking — save current version, sync skills silently
+            saveLastSeenVersion(configPath, raw);
+            autoSyncSkills();
+            return "";
+        }
+        if (lastSeen !== PKG_VERSION) {
+            saveLastSeenVersion(configPath, raw);
+            autoSyncSkills();
+            return `\n\n⚠ hmem-mcp updated: v${lastSeen} → v${PKG_VERSION}. Skills have been auto-synced. Run /hmem-update for full post-update steps (entry migration, schema enforcement, config check).`;
+        }
+    }
+    catch { }
+    return "";
+}
+/** Auto-sync skill files on version upgrade. Runs hmem update-skills in background. */
+function autoSyncSkills() {
+    try {
+        const child = spawn("hmem", ["update-skills"], {
+            detached: true, stdio: "ignore",
+            env: { ...process.env },
+        });
+        child.unref();
+        log("Auto-syncing skills after version upgrade");
+    }
+    catch { }
+}
+function saveLastSeenVersion(configPath, raw) {
+    try {
+        if (!raw.memory)
+            raw.memory = {};
+        raw.memory.lastSeenVersion = PKG_VERSION;
+        fs.writeFileSync(configPath, JSON.stringify(raw, null, 2) + "\n", "utf8");
+    }
+    catch { }
+}
+let versionUpgradeNotice = checkVersionUpgrade();
 // Session-scoped cache — persists across tool calls within this MCP connection
 const sessionCache = new SessionCache();
 const CONTEXT_THRESHOLD_WARNING = "\n\n⚠ CONTEXT THRESHOLD REACHED (~{tokens}k tokens delivered this session).\n" +
-    "Recommended: flush_context to save current work, then /clear to reset conversation.\n" +
-    "After /clear, use load_project to restore project context.";
+    "Tell the user to run /hmem-wipe — it saves key knowledge and prepares for /clear.\n" +
+    "Alternative: flush_context manually, then /clear, then load_project to restore context.";
 const CACHE_RESET_SIGNAL = "/tmp/hmem-cache-reset-signal";
 /** Track tokens in a tool response and append threshold warning if needed. */
 function trackTokens(result) {
@@ -232,6 +281,11 @@ function trackTokens(result) {
         return result;
     const text = result.content.map(c => c.text).join("");
     sessionCache.addTokens(text.length);
+    // One-time version upgrade notice (shown once per session)
+    if (versionUpgradeNotice) {
+        result.content[result.content.length - 1].text += versionUpgradeNotice;
+        versionUpgradeNotice = ""; // only show once
+    }
     if (sessionCache.checkThreshold(hmemConfig.contextTokenThreshold)) {
         const tokK = Math.round(sessionCache.totalTokensDelivered / 1000);
         result.content[result.content.length - 1].text += CONTEXT_THRESHOLD_WARNING.replace("{tokens}", String(tokK));
@@ -259,8 +313,14 @@ function formatRecentOEntries(store, limit, exchangeCount, linkedTo, expandAll)
         lines.push(`  ${o.id}  ${o.created_at.substring(0, 10)}  ${o.title}`);
         // Expand exchanges: all entries when expandAll, otherwise only latest
         if (expandAll || i === 0) {
-            const exLimit = expandAll && i > 0 ? Math.min(exchangeCount, 5) : exchangeCount;
-            const exchanges = store.getOEntryExchanges(o.id, exLimit);
+            // Check for checkpoint summaries — if present, show summary + only exchanges after it
+            // Always show: latest summary (if any) + last 5 exchanges verbatim
+            const VERBATIM_WINDOW = 5;
+            const summaries = store.getCheckpointSummaries(o.id, 1);
+            if (summaries.length > 0) {
+                lines.push(`    [Summary] ${summaries[0].content}`);
+            }
+            const exchanges = store.getOEntryExchanges(o.id, VERBATIM_WINDOW, true);
             for (const ex of exchanges) {
                 const userShort = ex.userText.length > 300 ? ex.userText.substring(0, 300) + "..." : ex.userText;
                 const agentShort = ex.agentText.length > 500 ? ex.agentText.substring(0, 500) + "..." : ex.agentText;
@@ -339,26 +399,30 @@ server.tool("write_memory", "Write a new memory entry to your hierarchical long-
     "  Level 3: 2 tabs — even more detail\n" +
     "  Level 4: 3 tabs — fine-grained detail\n" +
     "  Level 5: 4 tabs — raw context/data\n" +
+    "Use > lines for body text (shown on drill-down, hidden in listings):\n" +
+    "  Title line\\n> Body line 1\\n> Body line 2\\n\\tChild title\\n\\t> Child body\n" +
     "The system auto-assigns an ID and timestamp. " +
     `Use prefix to categorize: ${prefixList}.\n\n` +
     "Store types:\n" +
     "  personal (default): Your private memory\n", {
     prefix: z.string().toUpperCase().describe(`Memory category: ${prefixList}`),
-    content: z.string().min(3).describe("The memory content. Use tab indentation for depth levels. Example:\n" +
-        "Built the Council Dashboard for Althing Inc.\n" +
-        "\tMy role was frontend architecture with React + Vite\n" +
-        "\t\tShadcnUI for components, SSE for real-time updates\n" +
-        "\t\t\tAuth was tricky — EventSource can't send custom headers"),
+    content: z.string().min(3).describe("The memory content. Use tab indentation for depth levels. Use > for body text (hidden in listings, shown on drill-down).\n" +
+        "Example:\n" +
+        "Council Dashboard for Althing Inc.\n" +
+        "> Built a real-time dashboard with React + Vite. ShadcnUI for components, SSE for live updates.\n" +
+        "\tFrontend architecture\n" +
+        "\t> React + Vite, ShadcnUI components, SSE for real-time updates\n" +
+        "\t\tAuth was tricky — EventSource can't send custom headers"),
     links: z.array(z.string()).optional().describe("Optional: IDs of related memories, e.g. ['P0001', 'L0005']"),
-    favorite: z.boolean().optional().describe("Mark this entry as a favorite — shown with [♥] in bulk reads and always inlined with L2 detail. " +
+    favorite: z.coerce.boolean().optional().describe("Mark this entry as a favorite — shown with [♥] in bulk reads and always inlined with L2 detail. " +
         "Use for reference info you need to see every session, regardless of category."),
     tags: z.array(z.string()).min(1).describe("Required hashtags for cross-cutting search (min 1, recommend 3+). " +
         "E.g. ['#hmem', '#curation']. Max 10, lowercase, must start with #. Shown after title in reads."),
-    pinned: z.boolean().optional().describe("Mark this entry as pinned [P] (super-favorite). Pinned entries show full L2 content in bulk reads. " +
+    pinned: z.coerce.boolean().optional().describe("Mark this entry as pinned [P] (super-favorite). Pinned entries show full L2 content in bulk reads. " +
         "Use for reference entries you need to see in full every session."),
     store: z.enum(["personal", "company"]).default("personal").describe("Target store: 'personal' or 'company'"),
     min_role: z.enum(["worker", "al", "pl", "ceo"]).default("worker").describe("Minimum role to see this entry"),
-    force: z.boolean().optional().describe("Force creation of a new root entry even if existing entries share tags. " +
+    force: z.coerce.boolean().optional().describe("Force creation of a new root entry even if existing entries share tags. " +
         "Only use when you intentionally want a separate entry, not a child of an existing one."),
 }, async ({ prefix, content, links, favorite, tags, pinned, store: storeName, min_role: minRole, force }) => {
     const templateName = AGENT_ID.replace(/_\d+$/, "");
@@ -455,9 +519,11 @@ server.tool("write_memory", "Write a new memory entry to your hierarchical long-
 });
 server.tool("update_memory", "Update the text of an existing memory entry or sub-node (your own personal memory). " +
     "Only modifies the text at the specified ID — children are preserved unchanged.\n\n" +
+    "Supports > body format: 'New title\\n> Body line 1\\n> Body line 2' splits into title (shown in listings) + body (shown on drill-down).\n\n" +
     "Use cases:\n" +
     "- Correct outdated wording: update_memory(id='L0003', content='corrected summary')\n" +
-    "- Fix a sub-node: update_memory(id='L0003.2', content='corrected detail')\n" +
+    "- Add title/body split: update_memory(id='L0003', content='Short title\\n> Detailed body text')\n" +
+    "- Fix a sub-node: update_memory(id='L0003.2', content='node title\\n> node body')\n" +
     "- Mark as obsolete: FIRST write the correction, THEN update with [✓ID] reference:\n" +
     "  1. write_memory(prefix='E', content='Correct fix is...') → E0076\n" +
     "  2. update_memory(id='E0042', content='Wrong — see [✓E0076]', obsolete=true)\n" +
@@ -469,17 +535,17 @@ server.tool("update_memory", "Update the text of an existing memory entry or sub
     id: z.string().describe("ID of the entry or node to update, e.g. 'L0003' or 'L0003.2'"),
     content: z.string().min(1).describe("New text content for this node (plain text, no indentation)"),
     links: z.array(z.string()).optional().describe("Optional: update linked entry IDs (root entries only). Replaces existing links."),
-    obsolete: z.boolean().optional().describe("Mark this root entry as no longer valid (root entries only). " +
+    obsolete: z.coerce.boolean().optional().describe("Mark this root entry as no longer valid (root entries only). " +
         "Requires [✓ID] correction reference in content (e.g. 'Wrong — see [✓E0076]')."),
-    favorite: z.boolean().optional().describe("Set or clear the [♥] favorite flag. Works on root entries and sub-nodes. " +
+    favorite: z.coerce.boolean().optional().describe("Set or clear the [♥] favorite flag. Works on root entries and sub-nodes. " +
         "Root favorites are always shown with L2 detail in bulk reads."),
-    irrelevant: z.boolean().optional().describe("Mark as irrelevant [-]. Works on root entries and sub-nodes. " +
+    irrelevant: z.coerce.boolean().optional().describe("Mark as irrelevant [-]. Works on root entries and sub-nodes. " +
         "No correction entry needed (unlike obsolete). Irrelevant entries/nodes are hidden from output."),
     tags: z.array(z.string()).optional().describe("Set tags on this entry/node. Replaces all existing tags. " +
         "Pass empty array [] to remove all tags. E.g. ['#hmem', '#curation']."),
-    pinned: z.boolean().optional().describe("Set or clear the [P] pinned flag (root entries only). " +
+    pinned: z.coerce.boolean().optional().describe("Set or clear the [P] pinned flag (root entries only). " +
         "Pinned entries show full L2 content in bulk reads (super-favorite)."),
-    active: z.boolean().optional().describe("Mark this root entry as actively relevant [*] (root entries only). " +
+    active: z.coerce.boolean().optional().describe("Mark this root entry as actively relevant [*] (root entries only). " +
         "When any entry in a prefix has active=true, only active entries of that prefix are shown with children in bulk reads. " +
         "Non-active entries in the same prefix are shown as title-only (no children)."),
     store: z.enum(["personal", "company"]).default("personal").describe("Target store: 'personal' or 'company'"),
@@ -560,10 +626,10 @@ server.tool("update_many", "Batch-update multiple memory entries at once. Applie
     "Use this instead of calling update_memory multiple times during curation.\n\n" +
     "Example: update_many(ids=['T0005', 'T0012', 'L0044'], irrelevant=true)", {
     ids: z.array(z.string()).min(1).describe("List of entry/node IDs to update, e.g. ['T0005', 'T0012', 'L0044']"),
-    irrelevant: z.boolean().optional().describe("Mark all as irrelevant [-]"),
-    favorite: z.boolean().optional().describe("Set or clear [♥] favorite on all"),
-    active: z.boolean().optional().describe("Set or clear [*] active on all"),
-    pinned: z.boolean().optional().describe("Set or clear [P] pinned on all"),
+    irrelevant: z.coerce.boolean().optional().describe("Mark all as irrelevant [-]"),
+    favorite: z.coerce.boolean().optional().describe("Set or clear [♥] favorite on all"),
+    active: z.coerce.boolean().optional().describe("Set or clear [*] active on all"),
+    pinned: z.coerce.boolean().optional().describe("Set or clear [P] pinned on all"),
     store: z.enum(["personal", "company"]).default("personal"),
 }, async ({ ids, irrelevant, favorite, active, pinned, store: storeName }) => {
     const templateName = AGENT_ID.replace(/_\d+$/, "");
@@ -659,10 +725,11 @@ server.tool("append_memory", "Append new child nodes to an existing memory entry
     "Use this to extend an existing entry with additional detail without overwriting it.\n\n" +
     "Content uses tab indentation relative to the parent:\n" +
     "  0 tabs = direct child of id\n" +
-    "  1 tab  = grandchild, etc.\n\n" +
+    "  1 tab  = grandchild, etc.\n" +
+    "Use > for body text: 'Node title\\n> Body shown on drill-down\\n\\tChild node'\n\n" +
     "Examples:\n" +
-    "  append_memory(id='L0003', content='New finding\\n\\tSub-detail') " +
-    "→ adds L2 node + L3 child\n" +
+    "  append_memory(id='L0003', content='New finding\\n> Detailed explanation\\n\\tSub-detail') " +
+    "→ adds L2 node (with title + body) + L3 child\n" +
     "  append_memory(id='L0003.2', content='Extra note') " +
     "→ adds L3 node under the L2 node L0003.2", {
     id: z.string().describe("Root entry ID or parent node ID to append children to, e.g. 'L0003' or 'L0003.2'"),
@@ -749,11 +816,11 @@ server.tool("read_memory", "Read from your hierarchical long-term memory (.hmem)
     time: z.string().optional().describe("Time filter 'HH:MM' — filter entries by time of day"),
     period: z.string().optional().describe("Time window: '+4h' (after), '-2h' (before), '4h' (±4h symmetric), 'both' (±2h default)"),
     time_around: z.string().optional().describe("Reference entry ID — find entries created around the same time"),
-    show_obsolete: z.boolean().optional().describe("Include all obsolete entries (default: only top 3 most-accessed)"),
-    show_obsolete_path: z.boolean().optional().describe("When reading an obsolete entry by ID, show the full correction chain instead of just the final valid entry."),
-    titles_only: z.boolean().optional().describe("Compact title listing — shows all entries as ID + date + title, without V2 selection or children. " +
+    show_obsolete: z.coerce.boolean().optional().describe("Include all obsolete entries (default: only top 3 most-accessed)"),
+    show_obsolete_path: z.coerce.boolean().optional().describe("When reading an obsolete entry by ID, show the full correction chain instead of just the final valid entry."),
+    titles_only: z.coerce.boolean().optional().describe("Compact title listing — shows all entries as ID + date + title, without V2 selection or children. " +
         "Like a table of contents. Combine with prefix to filter by category."),
-    expand: z.boolean().optional().describe("Expand full tree with complete node content (ID queries only). " +
+    expand: z.coerce.boolean().optional().describe("Expand full tree with complete node content (ID queries only). " +
         "Use to deep-dive into a project after a long break. " +
         "depth controls how deep (default: 5 = full tree). " +
         "Example: read_memory({ id: 'P0001', expand: true, depth: 3 })"),
@@ -762,8 +829,8 @@ server.tool("read_memory", "Read from your hierarchical long-term memory (.hmem)
         "use after context compression to recover key knowledge. " +
         "Auto-selected if omitted: first bulk read → discover, subsequent → essentials."),
     store: z.enum(["personal", "company"]).default("personal").describe("Source store: 'personal' or 'company'"),
-    curator: z.boolean().optional().describe("Set true to show full metadata (access counts, roles, dates). For curators only."),
-    show_all: z.boolean().optional().describe("Curation mode: show ALL entries of the selected prefix with depth 3 children. " +
+    curator: z.coerce.boolean().optional().describe("Set true to show full metadata (access counts, roles, dates). For curators only."),
+    show_all: z.coerce.boolean().optional().describe("Curation mode: show ALL entries of the selected prefix with depth 3 children. " +
         "Bypasses V2 selection and session cache. Use with prefix filter for manageable output."),
     tag: z.string().optional().describe("Filter by hashtag, e.g. '#hmem'. Only entries with this tag are shown in bulk reads. " +
         "Also works with search to find tagged entries."),
@@ -863,7 +930,8 @@ server.tool("read_memory", "Read from your hierarchical long-term memory (.hmem)
             }
             const effectiveDepth = depth || (id ? 2 : 1);
             // Session cache: cached entries shown as titles in subsequent bulk reads
-            const isBulkListing = !id && !search && !time_around;
+            // Explicit filters (after, before, prefix, stale_days, tag) bypass V2 selection + cache
+            const isBulkListing = !id && !search && !time_around && !after && !before && !prefix && !stale_days && !tag;
             const useCache = isBulkListing && storeName === "personal" && !show_all;
             const cachedIds = useCache ? sessionCache.getCachedIds() : undefined;
             const hiddenIds = useCache ? sessionCache.getHiddenIds() : undefined;
@@ -886,6 +954,7 @@ server.tool("read_memory", "Read from your hierarchical long-term memory (.hmem)
                 mode: isBulkListing ? effectiveMode : undefined,
                 tag,
                 staleDays: stale_days,
+                directResults: !isBulkListing && !id && !search && !time_around,
             });
             if (entries.length === 0) {
                 const hmemPath = storeName === "company"
@@ -1123,7 +1192,7 @@ server.tool("import_memory", "Import entries from a .hmem file into your memory.
     "Deduplicates by L1 content (merges sub-nodes), remaps IDs on conflict.", {
     source_path: z.string().describe("Path to .hmem file to import"),
     store: z.enum(["personal", "company"]).default("personal").describe("Target store: 'personal' (your own memory) or 'company' (shared company store)"),
-    dry_run: z.boolean().default(false).describe("Preview only — report what would happen without modifying the database"),
+    dry_run: z.coerce.boolean().default(false).describe("Preview only — report what would happen without modifying the database"),
 }, async ({ source_path, store: storeName, dry_run }) => {
     try {
         const hmemStore = storeName === "company"
@@ -1311,30 +1380,51 @@ server.tool("load_project", "Load a project and activate it. Returns L2 content
             if (e.level_1 && e.level_1 !== e.title)
                 lines.push(`  ${e.level_1}`);
             if (e.children) {
+                const { withBody, withChildren } = hmemConfig.loadProjectExpand;
                 for (const child of e.children.filter(c => !c.irrelevant)) {
                     const cId = child.id.replace(e.id, "");
-                    const isOverview = child.seq === 1; // .1 = Overview node
+                    const expandBody = withBody.includes(child.seq);
+                    const expandChildTitles = withChildren.includes(child.seq);
                     lines.push(`  ${cId}  ${child.title || child.content.substring(0, 60)}`);
                     if (child.children && child.children.length > 0) {
                         for (const gc of child.children.filter((g) => !g.irrelevant)) {
                             const gcId = gc.id.replace(e.id, "");
-                            if (isOverview) {
-                                // Overview: show full L3 content
-                                lines.push(`    ${gcId}  ${gc.content}`);
+                            if (expandBody) {
+                                // Show L3 title + body content
+                                lines.push(`    ${gcId}  ${gc.title || gc.content.substring(0, 80)}`);
+                                if (gc.content && gc.content !== gc.title) {
+                                    // Show body lines indented
+                                    for (const bodyLine of gc.content.split("\n")) {
+                                        lines.push(`      ${bodyLine}`);
+                                    }
+                                }
+                            }
+                            else if (expandChildTitles) {
+                                // Show all L3 children as titles
+                                const gcTitle = gc.title || (gc.content.length > 80 ? gc.content.substring(0, 80) : gc.content);
+                                lines.push(`    ${gcId}  ${gcTitle}`);
                             }
                             else {
-                                // Other L2 nodes: compact titles only
+                                // Default: compact titles only
                                 const gcTitle = gc.title || (gc.content.length > 80 ? gc.content.substring(0, 80) : gc.content);
                                 lines.push(`    ${gcId}  ${gcTitle}`);
                             }
-                            // L4 hint
-                            if (gc.child_count && gc.child_count > 0) {
-                                lines.push(`      [+${gc.child_count} → ${gc.id}]`);
+                            // L4 children titles (already loaded via depth=4)
+                            if (gc.children && gc.children.length > 0) {
+                                const visibleL4 = gc.children.filter((l4) => !l4.irrelevant);
+                                for (const l4 of visibleL4) {
+                                    const l4Id = l4.id.replace(e.id, "");
+                                    const l4Title = l4.title || (l4.content?.length > 60 ? l4.content.substring(0, 60) + "…" : l4.content || "");
+                                    lines.push(`      ${l4Id}  ${l4Title}`);
+                                }
+                            }
+                            else if (gc.child_count && gc.child_count > 0) {
+                                lines.push(`      [+${gc.child_count}]`);
                             }
                         }
                     }
                     else if (child.child_count && child.child_count > 0) {
-                        lines.push(`    [+${child.child_count} → ${child.id}]`);
+                        lines.push(`    [+${child.child_count}]`);
                     }
                 }
             }
@@ -1369,14 +1459,31 @@ server.tool("load_project", "Load a project and activate it. Returns L2 content
                     lines.push(`    ${r.id}  ${r.title}`);
                 }
             }
-            // Inject recent O-entries linked to this project (full exchanges for all)
+            // Inject the most recent O-entry linked to this project with last N exchanges
+            // Purpose: seamless continuation of the previous session's conversation
             if (hmemConfig.recentOEntries > 0) {
-                const { text, ids } = formatRecentOEntries(hmemStore, hmemConfig.recentOEntries, 10, id, true);
+                const { text, ids } = formatRecentOEntries(hmemStore, 1, hmemConfig.recentOEntries, id, true);
                 if (text) {
                     lines.push("  " + text.replace(/\n/g, "\n  "));
                     sessionCache.registerDelivered(ids);
                 }
             }
+            // Inject universal conventions (C-entries tagged #universal)
+            try {
+                const conventions = hmemStore.read({
+                    prefix: "C", depth: 2, agentRole: (ROLE || "worker"),
+                }).filter(c => !c.obsolete && !c.irrelevant && c.tags?.includes("#universal"));
+                if (conventions.length > 0) {
+                    lines.push("  Conventions (#universal):");
+                    for (const c of conventions) {
+                        lines.push(`    ${c.id}  ${c.title}`);
+                        if (c.level_1 && c.level_1 !== c.title)
+                            lines.push(`      ${c.level_1}`);
+                    }
+                }
+            }
+            catch { /* conventions are optional */ }
+            const irrelevantTip = `Tip: update_memory(id, { irrelevant: true }) to hide noisy entries from future loads.`;
             const output = lines.join("\n");
             const outputTokens = Math.round(output.length / 4);
             const totalStats = hmemStore.stats();
@@ -1390,7 +1497,7 @@ server.tool("load_project", "Load a project and activate it. Returns L2 content
             return trackTokens({
                 content: [{
                         type: "text",
-                        text: `✓ Project ${id} activated.${tokenInfo}\n\n${output}`,
+                        text: `✓ Project ${id} activated.${tokenInfo}\n${irrelevantTip}\n\n${output}\n\n${irrelevantTip}`,
                     }],
             });
         }
@@ -1595,7 +1702,7 @@ server.tool("get_audit_queue", "CURATOR ONLY (ceo role). Returns agents whose .h
     "Each agent should be audited in a separate spawn to keep context bounded.", {}, async () => {
     if (!isCurator()) {
         return {
-            content: [{ type: "text", text: "ERROR: get_audit_queue is only available to the ceo/curator role." }],
+            content: [{ type: "text", text: "ERROR: get_audit_queue is only available to the ceo/curator role. Set HMEM_AGENT_ROLE=ceo in your MCP server config to use curation tools." }],
             isError: true,
         };
     }
@@ -1681,8 +1788,11 @@ server.tool("read_agent_memory", "CURATOR ONLY (ceo role). Read the full memory
             const favTag = e.favorite ? " [♥]" : "";
             lines.push(`[${e.id}] ${date}${role}${favTag}${obsoleteTag}${irrelevantTag}${access}`);
             lines.push(`  ${e.title}`);
-            if (e.level_1 !== e.title)
-                lines.push(`  ${e.level_1}`);
+            if (e.level_1 && e.level_1 !== e.title) {
+                for (const bodyLine of e.level_1.split("\n")) {
+                    lines.push(`  ${bodyLine}`);
+                }
+            }
             if (e.children && e.children.length > 0) {
                 for (const child of e.children) {
                     const indent = "  ".repeat(child.depth - 1);
@@ -1716,10 +1826,10 @@ server.tool("fix_agent_memory", "CURATOR ONLY (ceo role). Correct a specific ent
     content: z.string().optional().describe("New text content. For root entries: replaces the L1 summary. " +
         "For node IDs: replaces that node's content."),
     min_role: z.enum(["worker", "al", "pl", "ceo"]).optional().describe("Update access clearance (root entries only)."),
-    obsolete: z.boolean().optional().describe("Mark or unmark as obsolete (root entries only). " +
+    obsolete: z.coerce.boolean().optional().describe("Mark or unmark as obsolete (root entries only). " +
         "Obsolete entries stay in memory but are shown with [⚠ OBSOLETE]."),
-    favorite: z.boolean().optional().describe("Set or clear the [♥] favorite flag (root entries only)."),
-    irrelevant: z.boolean().optional().describe("Mark or unmark as irrelevant (root entries only). Irrelevant entries are hidden from bulk reads. No correction entry needed."),
+    favorite: z.coerce.boolean().optional().describe("Set or clear the [♥] favorite flag (root entries only)."),
+    irrelevant: z.coerce.boolean().optional().describe("Mark or unmark as irrelevant (root entries only). Irrelevant entries are hidden from bulk reads. No correction entry needed."),
 }, async ({ agent_name, entry_id, content, min_role, obsolete, favorite, irrelevant }) => {
     if (!isCurator()) {
         return {
@@ -1961,7 +2071,7 @@ function formatTitlesOnly(entries, config, curator = false) {
                     lines.push(`  ${compactChildId}${cfav}  ${short}${grandchildren}`);
                 }
                 if (e.hiddenChildrenCount && e.hiddenChildrenCount > 0) {
-                    lines.push(`  [+${e.hiddenChildrenCount} more → ${e.id}]`);
+                    lines.push(`  [+${e.hiddenChildrenCount} more]`);
                 }
                 if (hiddenIrr > 0) {
                     lines.push(`  (+${hiddenIrr} irrelevant hidden)`);
@@ -2068,9 +2178,11 @@ function renderEntryFormatted(lines, e, curator, expand = false) {
         else {
             lines.push(`${e.id}  ${e.title}${tagStr}`);
         }
-        // Node drilldown: show full content below title
-        if (hasDetail && e.level_1 !== e.title) {
-            lines.push(`  ${e.level_1}`);
+        // Node drilldown: show body below title
+        if (e.level_1 && e.level_1 !== e.title) {
+            for (const bodyLine of e.level_1.split("\n")) {
+                lines.push(`  ${bodyLine}`);
+            }
         }
     }
     else {
@@ -2096,9 +2208,11 @@ function renderEntryFormatted(lines, e, curator, expand = false) {
             const syncTag = syncThreshold && e.updated_at && e.updated_at <= syncThreshold ? " ✓" : "";
             lines.push(`${e.id}${promotedTag}${activeTag}${pinnedTag}${obsoleteTag}${irrelevantTag}${syncTag}  ${e.title}${tagStr}`);
         }
-        // Show full level_1 content below title when entry is expanded/drilled
-        if (hasDetail && e.level_1 !== e.title) {
-            lines.push(`  ${e.level_1}`);
+        // Show body below title when entry is drilled into
+        if (e.level_1 && e.level_1 !== e.title) {
+            for (const bodyLine of e.level_1.split("\n")) {
+                lines.push(`  ${bodyLine}`);
+            }
         }
     }
     // Children — filter out irrelevant nodes
@@ -2114,7 +2228,7 @@ function renderEntryFormatted(lines, e, curator, expand = false) {
         else if (e.expanded && !expand) {
             renderChildrenFormatted(lines, visibleChildren, curator, rootId);
             if (e.hiddenChildrenCount && e.hiddenChildrenCount > 0) {
-                lines.push(`  [+${e.hiddenChildrenCount} more → ${e.id}]`);
+                lines.push(`  [+${e.hiddenChildrenCount} more]`);
             }
         }
         else if (e.hiddenChildrenCount !== undefined) {
@@ -2124,7 +2238,7 @@ function renderEntryFormatted(lines, e, curator, expand = false) {
                 const fav = nodeMarkers(child);
                 const compactChildId = child.id.replace(rootId, "");
                 const hint = (child.child_count ?? 0) > 0
-                    ? `  [+${child.child_count} → ${child.id}]`
+                    ? `  [+${child.child_count}]`
                     : "";
                 if (curator) {
                     lines.push(`  [${child.id}]${fav} ${child.title}${hint}`);
@@ -2134,7 +2248,7 @@ function renderEntryFormatted(lines, e, curator, expand = false) {
                 }
             }
             if (e.hiddenChildrenCount > 0) {
-                lines.push(`  [+${e.hiddenChildrenCount} more → ${e.id}]`);
+                lines.push(`  [+${e.hiddenChildrenCount} more]`);
             }
         }
         else {
@@ -2202,7 +2316,7 @@ function renderChildrenFormatted(lines, children, curator, rootId) {
         const ctags = formatTagSuffix(child.tags, curator);
         const compactId = rootId ? child.id.replace(rootId, "") : child.id;
         const hint = (child.child_count ?? 0) > 0
-            ? `  [+${child.child_count} → ${child.id}]`
+            ? `  [+${child.child_count}]`
             : "";
         if (curator) {
             lines.push(`${indent}[${child.id}]${fav} ${child.title}${ctags}${hint}`);
@@ -2221,24 +2335,31 @@ function renderChildrenFormatted(lines, children, curator, rootId) {
 function renderChildrenExpanded(lines, children, curator, rootId) {
     for (const child of children) {
         const indent = "  ".repeat(child.depth - 1);
+        const bodyIndent = indent + "  ";
         const fav = nodeMarkers(child);
         const compactId = rootId ? child.id.replace(rootId, "") : child.id;
         const visibleGrandchildren = child.children?.filter(c => !c.irrelevant);
         const hasLoadedChildren = visibleGrandchildren && visibleGrandchildren.length > 0;
         const isBoundary = !hasLoadedChildren && (child.child_count ?? 0) > 0;
+        const hasBody = child.content && child.content !== child.title;
         if (hasLoadedChildren) {
-            // Inner node: full content + recurse
+            // Inner node: title + body + recurse
             if (curator) {
-                lines.push(`${indent}[${child.id}]${fav} ${child.content}`);
+                lines.push(`${indent}[${child.id}]${fav} ${child.title}`);
             }
             else {
-                lines.push(`${indent}${compactId}${fav}  ${child.content}`);
+                lines.push(`${indent}${compactId}${fav}  ${child.title}`);
+            }
+            if (hasBody) {
+                for (const bodyLine of child.content.split("\n")) {
+                    lines.push(`${bodyIndent}${bodyLine}`);
+                }
             }
             renderChildrenExpanded(lines, visibleGrandchildren, curator, rootId);
         }
         else if (isBoundary) {
             // Boundary: title only + child count hint
-            const hint = `  [+${child.child_count} → ${child.id}]`;
+            const hint = `  [+${child.child_count}]`;
             if (curator) {
                 lines.push(`${indent}[${child.id}]${fav} ${child.title}${hint}`);
             }
@@ -2247,12 +2368,17 @@ function renderChildrenExpanded(lines, children, curator, rootId) {
             }
         }
         else {
-            // Leaf node (no children at all): full content
+            // Leaf node: title + body
             if (curator) {
-                lines.push(`${indent}[${child.id}]${fav} ${child.content}`);
+                lines.push(`${indent}[${child.id}]${fav} ${child.title}`);
             }
             else {
-                lines.push(`${indent}${compactId}${fav}  ${child.content}`);
+                lines.push(`${indent}${compactId}${fav}  ${child.title}`);
+            }
+            if (hasBody) {
+                for (const bodyLine of child.content.split("\n")) {
+                    lines.push(`${bodyIndent}${bodyLine}`);
+                }
             }
         }
     }
@@ -2277,6 +2403,7 @@ function checkForUpdates() {
             stdio: ["ignore", "pipe", "ignore"],
             detached: true,
             shell: process.platform === "win32",
+            windowsHide: true,
         });
         child.unref();
         let out = "";