hmem-mcp 5.0.0 → 5.1.21

package/dist/cli-checkpoint.js

@@ -78,62 +78,111 @@ export async function checkpoint() {
         const activeProject = store.getActiveProject();
         const projectName = activeProject?.title?.split("|")[0]?.trim() ?? "unknown";
         const projectId = activeProject?.id ?? "";
-        // 3. Format exchanges (generous limits — Haiku needs context)
-        const formattedExchanges = exchanges.map((ex, i) => {
+        // 3. Tag skill-dialog exchanges (brainstorming, debugging, TDD, etc.)
+        const skillMarker = "Base directory for this skill:";
+        for (const ex of exchanges) {
+            if (ex.userText.includes(skillMarker)) {
+                store.addTag(ex.nodeId, "#skill-dialog");
+            }
+        }
+        // 4. Get previous checkpoint summaries for rolling compression
+        const prevSummaries = store.getCheckpointSummaries(activeOId, 2);
+        const lastSummarySeq = prevSummaries.length > 0 ? prevSummaries[0].seq : 0;
+        // Only format exchanges AFTER the last summary (those are new)
+        const newExchanges = exchanges.filter(ex => ex.seq > lastSummarySeq);
+        // Split: last 5 stay verbatim, the rest get summarized
+        const VERBATIM_WINDOW = 5;
+        const toSummarize = newExchanges.length > VERBATIM_WINDOW
+            ? newExchanges.slice(0, -VERBATIM_WINDOW)
+            : [];
+        const verbatimExchanges = newExchanges.slice(-VERBATIM_WINDOW);
+        // 5. Format exchanges (generous limits — Haiku needs context)
+        const formattedExchanges = newExchanges.map((ex, i) => {
             const user = ex.userText.length > 800 ? ex.userText.substring(0, 800) + "..." : ex.userText;
             const agent = ex.agentText.length > 1200 ? ex.agentText.substring(0, 1200) + "..." : ex.agentText;
-            return `--- Exchange ${i + 1} ---\nUSER: ${user}\nAGENT: ${agent}`;
+            const currentTitle = ex.userText.split("\n")[0].replace(/[<>\[\]]/g, "").substring(0, 40);
+            return `--- Exchange ${i + 1} (${ex.nodeId}) [title: "${currentTitle}"] ---\nUSER: ${user}\nAGENT: ${agent}`;
         }).join("\n\n");
-        // 4. Close store before spawning subagent (avoid DB lock)
+        // Format previous summaries for rolling compression
+        let prevSummaryText = "";
+        if (prevSummaries.length > 0) {
+            const parts = prevSummaries.reverse().map((s, i) => {
+                const label = i === prevSummaries.length - 1 ? "Most recent summary" : "Older summary";
+                return `[${label} — ${s.created_at.substring(0, 16)}]\n${s.content}`;
+            });
+            prevSummaryText = parts.join("\n\n");
+        }
+        // 6. Close store before spawning subagent (avoid DB lock)
         store.close();
         // 5. Build MCP config for subagent
         mcpConfigPath = buildMcpConfig(projectDir, agentId);
-        // 6. Build the prompt
-        const prompt = `You are a background checkpoint agent. Your job is to extract valuable knowledge from a coding session and save it to long-term memory using the hmem MCP tools.
-
-## Context
-
-Project: ${projectName} (${projectId})
-Active O-entry: ${activeOId}
-
-## Recent conversation (oldest first):
-
+        // 7. Build the prompt
+        const summarySection = prevSummaryText
+            ? `\n## Previous checkpoint summaries (oldest first):\n\n${prevSummaryText}\n`
+            : "";
+        // Build exchange listing for titling
+        const exchangeListing = newExchanges.map(ex => {
+            const currentTitle = ex.userText.split("\n")[0].replace(/[<>\[\]]/g, "").substring(0, 40);
+            return `  ${ex.nodeId}: "${currentTitle}"`;
+        }).join("\n");
+        // Build conditional summary task
+        const hasSummaryWork = toSummarize.length > 0;
+        const summaryNodeIds = toSummarize.map(e => e.nodeId).join(", ");
+        const verbatimNodeIds = verbatimExchanges.map(e => e.nodeId).join(", ");
+        const summaryTask = hasSummaryWork
+            ? `### 4. Checkpoint summary (REQUIRED — ${toSummarize.length} exchanges to compress)
+Summarize exchanges ${summaryNodeIds} into a rolling summary.
+${prevSummaryText ? "IMPORTANT: Incorporate the previous summary into your new one — it covers older exchanges. The new summary should be a CUMULATIVE summary of everything so far." : "This is the first summary for this session."}
+append_memory(id="${activeOId}", content="\\t[CP] Rolling summary covering all exchanges through ${toSummarize[toSummarize.length - 1].nodeId}. 3-8 sentences. Match conversation language.")
+The last ${verbatimExchanges.length} exchanges (${verbatimNodeIds}) stay verbatim — do NOT include them in the summary.`
+            : `### 4. Checkpoint summary — SKIP
+Only ${newExchanges.length} exchanges since last summary — all within the verbatim window (last ${VERBATIM_WINDOW}). No summary needed.`;
+        const prompt = `You are a checkpoint agent for "${projectName}" (${projectId}). Process ${newExchanges.length} new exchanges from ${activeOId}.
+${summarySection}
 ${formattedExchanges}
 
-## Your task
+## Tasks (execute ALL in order):
 
-Analyze the conversation above and save NON-OBVIOUS insights to memory. Follow these rules strictly:
+### 1. Title each exchange (REQUIRED)
+Each exchange node needs a descriptive title (max 50 chars, match conversation language).
+Current titles (auto-extracted, usually bad):
+${exchangeListing}
 
-### What to save (ONLY if present):
-1. **Lessons (L)**: Technical insights, best practices discovered, "aha moments"
-   - BAD: "Stop Hook logs exchanges" (that's a feature description, not a lesson)
-   - GOOD: "HMEM_AGENT_ID must be set in hook scripts, otherwise resolveHmemPath falls back to memory.hmem instead of Agents/NAME/NAME.hmem"
+For each: update_memory(id="<nodeId>", content="Descriptive title summarizing the exchange")
+Example: update_memory(id="${newExchanges[0]?.nodeId || "O0XXX.1"}", content="Fix hmem-sync path resolution for HMEM_AGENT_ID")
 
-2. **Errors (E)**: Bugs encountered + root cause + fix
-   - GOOD: "TypeScript compile error: store.db is private — fixed by adding public helper methods getActiveOId(), getActiveProject(), findChildNode()"
+### 2. Extract knowledge (non-obvious only, max 2-3)
+- L: Root-cause lesson (not surface symptoms)
+- E: Bug + root cause + fix
+- D: Architecture decision + rationale
+write_memory(prefix="L/E/D", content="...", tags=[3-5 tags], links=["${projectId}"])
+Skip if nothing non-obvious happened.
 
-3. **Decisions (D)**: Architecture/design decisions + rationale
-   - GOOD: "Checkpoint uses claude -p --model haiku with --mcp-config for MCP tool access — alternative was direct DB writes but that produced low-quality entries without proper context"
+### 3. Update project P-entry (IMPORTANT)
+Keep ${projectName} (${projectId}) current:
+- **Protocol** (.7): append_memory(id="${projectId}.7", content="Session YYYY-MM-DD: what happened, what was decided/shipped")
+- **Bugs** (.6): new bugs found → append with reference to E-entry
+- **Open tasks** (.8): tasks completed → update as done; new tasks → append
+- **Overview** (.1): if project state, architecture, or goals changed significantly
+- **Codebase** (.2): if new files/modules added or entry points changed
+Read the P-entry first: read_memory(id="${projectId}") to see current state before updating.
 
-4. **Handoff**: Update the project's Protocol section with current state
-   - 2-3 sentences: what was accomplished, what's in progress, next step
-   - Use: append_memory(id="${projectId}.7", content="Handoff (YYYY-MM-DD HH:MM): ...")
+${summaryTask}
 
-### Rules:
-- Use write_memory for L/D/E entries. Always include tags (3-5) and links=["${projectId}"]
-- Use append_memory to update the Protocol handoff (${projectId}.7)
-- Match the language of existing entries (check with read_memory first)
-- Skip if nothing noteworthy — don't write garbage entries
-- Max 2-3 entries total. Quality over quantity
-- Each L1 must be a complete, self-contained sentence (~15-20 tokens)
-- Title (~50 chars) should be specific, not vague
+### 5. Title the O-entry root
+If the O-entry root (${activeOId}) still has a generic title like "unassigned" or just the project name,
+give it a proper session title based on what happened so far:
+update_memory(id="${activeOId}", content="Session title summarizing key topics (max 60 chars)")
 
-### Before writing:
-1. Call read_memory() to see existing entries — avoid duplicates
-2. Check if a similar L/D/E already exists before creating a new one
-3. If it does, use append_memory to extend it instead
+### 6. Project relevance check
+Are these exchanges about ${projectName}? If conversation drifted to a different project, note "[DRIFT: topic X]" in the summary.
 
-Now analyze the conversation and save what's worth keeping. If nothing is noteworthy, just say "Nothing to save." and exit.`;
+## Rules:
+- read_memory() FIRST to avoid duplicates and see current P-entry state
+- Match language of existing entries (likely German)
+- Tags: 3-5 per entry, lowercase with #
+- Only save what's valuable in 6 months
+- Do NOT skip titling — every exchange needs a proper title`;
         // 7. Spawn Haiku with MCP access
         const allowedTools = [
             "mcp__hmem__read_memory",
@@ -149,6 +198,19 @@ Now analyze the conversation and save what's worth keeping. If nothing is notewo
                 timeout: 120_000,
             }).trim();
             console.log(`[hmem checkpoint] Haiku: ${output.substring(0, 300)}`);
+            // Tag the checkpoint summary node that Haiku wrote via append_memory
+            // Haiku writes it as a [CP] prefixed L2 node under the O-entry
+            try {
+                const postStore = new HmemStore(hmemPath, config);
+                const tagged = postStore.tagNewCheckpointSummaries(activeOId);
+                if (tagged.length > 0) {
+                    console.log(`[hmem checkpoint] Tagged checkpoint summaries: ${tagged.join(", ")}`);
+                }
+                postStore.close();
+            }
+            catch (tagErr) {
+                console.error(`[hmem checkpoint] Failed to tag summary: ${tagErr}`);
+            }
         }
         catch (e) {
             const stdout = e.stdout?.toString()?.substring(0, 200) || "";

package/dist/cli-checkpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-checkpoint.js","sourceRoot":"","sources":["../src/cli-checkpoint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-checkpoint.js","sourceRoot":"","sources":["../src/cli-checkpoint.ts"],"names":[],"mappings":"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"}

package/dist/cli-context-inject.d.ts

@@ -2,12 +2,13 @@
  * cli-context-inject.ts
  *
  * Called by Claude Code's SessionStart[clear] hook after /clear.
- * Reads hook input from stdin (JSON with transcript_path, session_id, etc.)
- * and outputs compressed context to stdout for re-injection:
- *   - Last N messages from the conversation transcript
- *   - Active project briefing (title + overview content)
- *   - Recent O-entries (session logs) linked to the project
- *   - R-entries (rules)
+ * Outputs a compact context summary to stdout for re-injection:
+ *   - Compact project overview (all P-entries, one line each, active marked)
+ *   - R-entries (rules, one line each)
+ *   - Hint to use load_project for full briefing
+ *
+ * Deliberately lightweight (~200 tokens). Full context comes from
+ * load_project() or read_memory() which the agent calls next.
  *
  * Usage: hmem context-inject  (reads stdin JSON from Claude Code hook)
  *

package/dist/cli-context-inject.js

@@ -2,12 +2,13 @@
  * cli-context-inject.ts
  *
  * Called by Claude Code's SessionStart[clear] hook after /clear.
- * Reads hook input from stdin (JSON with transcript_path, session_id, etc.)
- * and outputs compressed context to stdout for re-injection:
- *   - Last N messages from the conversation transcript
- *   - Active project briefing (title + overview content)
- *   - Recent O-entries (session logs) linked to the project
- *   - R-entries (rules)
+ * Outputs a compact context summary to stdout for re-injection:
+ *   - Compact project overview (all P-entries, one line each, active marked)
+ *   - R-entries (rules, one line each)
+ *   - Hint to use load_project for full briefing
+ *
+ * Deliberately lightweight (~200 tokens). Full context comes from
+ * load_project() or read_memory() which the agent calls next.
  *
  * Usage: hmem context-inject  (reads stdin JSON from Claude Code hook)
  *
@@ -18,73 +19,20 @@
 import fs from "node:fs";
 import { openAgentMemory } from "./hmem-store.js";
 import { loadHmemConfig } from "./hmem-config.js";
-/** Number of recent conversation messages to include after /clear. */
-const RECENT_MESSAGES = 20;
-/** Read the last N user/assistant messages from a JSONL transcript. */
-function readRecentTranscript(transcriptPath, count) {
-    if (!transcriptPath || !fs.existsSync(transcriptPath))
-        return [];
-    const stat = fs.statSync(transcriptPath);
-    const TAIL_BYTES = 5 * 1024 * 1024; // 5MB tail
-    const start = Math.max(0, stat.size - TAIL_BYTES);
-    const fd = fs.openSync(transcriptPath, "r");
-    const buf = Buffer.alloc(Math.min(stat.size, TAIL_BYTES));
-    fs.readSync(fd, buf, 0, buf.length, start);
-    fs.closeSync(fd);
-    const text = buf.toString("utf-8");
-    const lines = text.split("\n").filter(l => l.trim());
-    const messages = [];
-    for (const line of lines) {
-        try {
-            const entry = JSON.parse(line);
-            // Claude Code transcript format: { type: "human"|"assistant", message: { role, content } }
-            const role = entry.type || entry.role || entry.message?.role;
-            if (role !== "human" && role !== "assistant" && role !== "user")
-                continue;
-            const content = entry.message?.content || entry.content;
-            if (!content)
-                continue;
-            let text;
-            if (typeof content === "string") {
-                text = content;
-            }
-            else if (Array.isArray(content)) {
-                text = content
-                    .filter(c => c.type === "text" && c.text)
-                    .map(c => c.text)
-                    .join("\n");
-            }
-            else {
-                continue;
-            }
-            if (!text.trim())
-                continue;
-            const label = (role === "human" || role === "user") ? "USER" : "ASSISTANT";
-            // Truncate very long messages (e.g. tool outputs)
-            const maxLen = 500;
-            const truncated = text.length > maxLen ? text.substring(0, maxLen) + "..." : text;
-            messages.push(`${label}: ${truncated}`);
-        }
-        catch { /* skip malformed lines */ }
-    }
-    return messages.slice(-count);
-}
+import { resolveEnvDefaults } from "./cli-env.js";
 export async function contextInject() {
-    const projectDir = process.env.HMEM_PROJECT_DIR || process.env.COUNCIL_PROJECT_DIR || "";
+    // Resolve env defaults (HMEM_PROJECT_DIR, HMEM_AGENT_ID)
+    resolveEnvDefaults();
+    const projectDir = process.env.HMEM_PROJECT_DIR || "";
     if (!projectDir) {
         process.stderr.write("HMEM_PROJECT_DIR not set\n");
         return;
     }
-    // Read hook input from stdin
-    let transcriptPath = "";
+    // Read hook input from stdin (required by Claude Code hook protocol)
     try {
-        const stdin = fs.readFileSync(0, "utf-8").trim();
-        if (stdin) {
-            const input = JSON.parse(stdin);
-            transcriptPath = input.transcript_path || "";
-        }
+        fs.readFileSync(0, "utf-8");
     }
-    catch { /* no stdin or invalid JSON — OK */ }
+    catch { /* no stdin — OK */ }
     const agentId = process.env.HMEM_AGENT_ID || process.env.COUNCIL_AGENT_ID || "";
     const templateName = agentId.replace(/_\d+$/, "");
     const config = loadHmemConfig(projectDir);
@@ -98,79 +46,28 @@ export async function contextInject() {
     }
     try {
         const lines = [];
-        // 1. Recent conversation transcript
-        const recentMessages = readRecentTranscript(transcriptPath, RECENT_MESSAGES);
-        if (recentMessages.length > 0) {
-            lines.push("## Recent conversation (before /clear):");
-            lines.push(...recentMessages);
-            lines.push("");
-        }
-        // 2. Active project briefing
-        const allEntries = store.read({ prefix: "P", depth: 1, agentRole: "worker" });
-        const activeProject = allEntries.find(e => e.active && !e.obsolete && !e.irrelevant);
-        if (activeProject) {
-            const projectEntries = store.read({
-                id: activeProject.id,
-                depth: 3,
-                expand: true,
-                agentRole: "worker",
-            });
-            if (projectEntries.length > 0) {
-                const p = projectEntries[0];
-                lines.push(`## Active project: ${p.id}  ${p.title}`);
-                if (p.level_1 && p.level_1 !== p.title)
-                    lines.push(`  ${p.level_1}`);
-                // Overview node (.1) — expand with full content
-                if (p.children) {
-                    const overview = p.children.find((c) => c.seq === 1);
-                    if (overview) {
-                        lines.push(`  Overview:`);
-                        if (overview.children) {
-                            for (const gc of overview.children.filter((g) => !g.irrelevant)) {
-                                lines.push(`    ${gc.content}`);
-                            }
-                        }
-                    }
-                }
-                // 3. Recent O-entries linked to project (full exchanges for all)
-                if (config.recentOEntries > 0) {
-                    const recentO = store.getRecentOEntries(config.recentOEntries, activeProject.id);
-                    if (recentO.length > 0) {
-                        lines.push(`\n  Recent sessions:`);
-                        for (let i = 0; i < recentO.length; i++) {
-                            const o = recentO[i];
-                            lines.push(`    ${o.id}  ${o.created_at.substring(0, 10)}  ${o.title}`);
-                            const exLimit = i === 0 ? 10 : 5;
-                            const exchanges = store.getOEntryExchanges(o.id, exLimit);
-                            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;
-                                lines.push(`      USER: ${userShort}`);
-                                if (agentShort)
-                                    lines.push(`      AGENT: ${agentShort}`);
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        else {
-            const projects = allEntries.filter(e => !e.obsolete && !e.irrelevant);
-            lines.push("## No active project. Available:");
-            for (const p of projects) {
-                lines.push(`  ${p.id}  ${p.title}`);
+        // 1. Compact project overview — one line per P-entry
+        const allProjects = store.read({ prefix: "P", depth: 1, agentRole: "worker" })
+            .filter(e => !e.obsolete && !e.irrelevant);
+        const activeProject = allProjects.find(e => e.active);
+        if (allProjects.length > 0) {
+            lines.push("## Projects:");
+            for (const p of allProjects) {
+                const marker = p.active ? " [*]" : "";
+                lines.push(`  ${p.id}${marker}  ${p.title}`);
             }
         }
-        // 4. R-entries (rules)
+        // 2. R-entries (rules) — compact, one line each
         const rules = store.read({ prefix: "R", depth: 1, agentRole: "worker" })
             .filter(r => !r.obsolete && !r.irrelevant);
         if (rules.length > 0) {
             lines.push("\n## Rules:");
             for (const r of rules) {
-                lines.push(`  ${r.id}  ${r.title}`);
+                const body = r.level_1 && r.level_1 !== r.title ? `\n> ${r.level_1}` : "";
+                lines.push(`  ${r.id}  ${r.title}${body}`);
             }
         }
-        lines.push("\n(Context re-injected after /clear. Use load_project for full briefing, read_memory(id) to drill into specific entries.)");
+        lines.push(`\n(Context re-injected after /clear. Use load_project for full briefing, read_memory(id) to drill into specific entries.)`);
         process.stdout.write(lines.join("\n") + "\n");
     }
     finally {

package/dist/cli-context-inject.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-context-inject.js","sourceRoot":"","sources":["../src/cli-context-inject.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-context-inject.js","sourceRoot":"","sources":["../src/cli-context-inject.ts"],"names":[],"mappings":"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"}

package/dist/cli-env.d.ts

@@ -0,0 +1,16 @@
+/**
+ * cli-env.ts
+ *
+ * Shared environment variable resolution for all hmem CLI commands.
+ * Sets HMEM_PROJECT_DIR and HMEM_AGENT_ID defaults so CLI commands
+ * work without a bash wrapper script (cross-platform, no Git Bash needed on Windows).
+ */
+/**
+ * Resolve HMEM_PROJECT_DIR and HMEM_AGENT_ID environment variables.
+ *
+ * - HMEM_PROJECT_DIR defaults to ~/.hmem
+ * - HMEM_AGENT_ID is auto-detected from Agents/ directory if not set
+ *
+ * Call this early in any CLI command that needs these env vars.
+ */
+export declare function resolveEnvDefaults(): void;

package/dist/cli-env.js

@@ -0,0 +1,40 @@
+/**
+ * cli-env.ts
+ *
+ * Shared environment variable resolution for all hmem CLI commands.
+ * Sets HMEM_PROJECT_DIR and HMEM_AGENT_ID defaults so CLI commands
+ * work without a bash wrapper script (cross-platform, no Git Bash needed on Windows).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+/**
+ * Resolve HMEM_PROJECT_DIR and HMEM_AGENT_ID environment variables.
+ *
+ * - HMEM_PROJECT_DIR defaults to ~/.hmem
+ * - HMEM_AGENT_ID is auto-detected from Agents/ directory if not set
+ *
+ * Call this early in any CLI command that needs these env vars.
+ */
+export function resolveEnvDefaults() {
+    // HMEM_PROJECT_DIR: default to ~/.hmem
+    if (!process.env.HMEM_PROJECT_DIR) {
+        process.env.HMEM_PROJECT_DIR = process.env.COUNCIL_PROJECT_DIR || path.join(os.homedir(), ".hmem");
+    }
+    const projectDir = process.env.HMEM_PROJECT_DIR;
+    // HMEM_AGENT_ID: auto-detect from Agents/ directory
+    if (!process.env.HMEM_AGENT_ID && !process.env.COUNCIL_AGENT_ID) {
+        const agentsDir = path.join(projectDir, "Agents");
+        try {
+            const entries = fs.readdirSync(agentsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    process.env.HMEM_AGENT_ID = entry.name;
+                    break;
+                }
+            }
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=cli-env.js.map

package/dist/cli-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-env.js","sourceRoot":"","sources":["../src/cli-env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,uCAAuC;IACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAEhD,oDAAoD;IACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC;oBACvC,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/cli-hook-startup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * cli-hook-startup.ts
+ *
+ * Called by Claude Code's UserPromptSubmit hook on every user message.
+ * Replaces the former hmem-startup.sh bash script — works cross-platform (no Git Bash needed on Windows).
+ *
+ * Behavior:
+ * - First message: remind agent to call read_memory()
+ * - Every N messages: checkpoint reminder (remind mode only)
+ * - After 60 messages: context warning (every 5 messages)
+ *
+ * Reads hook JSON from stdin, outputs hook JSON to stdout.
+ *
+ * Usage: hmem hook-startup
+ *
+ * Requires env:
+ *   HMEM_PROJECT_DIR — root directory for .hmem files (default: ~/.hmem)
+ *   HMEM_AGENT_ID    — agent identifier (optional, auto-detected)
+ */
+export declare function hookStartup(): Promise<void>;

package/dist/cli-hook-startup.js

@@ -0,0 +1,101 @@
+/**
+ * cli-hook-startup.ts
+ *
+ * Called by Claude Code's UserPromptSubmit hook on every user message.
+ * Replaces the former hmem-startup.sh bash script — works cross-platform (no Git Bash needed on Windows).
+ *
+ * Behavior:
+ * - First message: remind agent to call read_memory()
+ * - Every N messages: checkpoint reminder (remind mode only)
+ * - After 60 messages: context warning (every 5 messages)
+ *
+ * Reads hook JSON from stdin, outputs hook JSON to stdout.
+ *
+ * Usage: hmem hook-startup
+ *
+ * Requires env:
+ *   HMEM_PROJECT_DIR — root directory for .hmem files (default: ~/.hmem)
+ *   HMEM_AGENT_ID    — agent identifier (optional, auto-detected)
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { resolveEnvDefaults } from "./cli-env.js";
+import { loadHmemConfig } from "./hmem-config.js";
+export async function hookStartup() {
+    // Read hook JSON from stdin
+    let input;
+    try {
+        const data = fs.readFileSync(0, "utf8");
+        input = JSON.parse(data || "{}");
+    }
+    catch {
+        process.exit(0);
+    }
+    // Extract session_id
+    const sessionId = input?.session_id || "global";
+    // Skip subagents
+    if (input?.parentUuid)
+        process.exit(0);
+    // Resolve env defaults
+    resolveEnvDefaults();
+    // Read config
+    let interval = 20;
+    let mode = "remind";
+    const projectDir = process.env.HMEM_PROJECT_DIR;
+    if (projectDir) {
+        try {
+            const agentId = process.env.HMEM_AGENT_ID || "";
+            const templateName = agentId.replace(/_\d+$/, "");
+            let configDir = projectDir;
+            if (templateName && templateName !== "UNKNOWN") {
+                const agentDir = path.join(projectDir, "Agents", templateName);
+                if (fs.existsSync(agentDir))
+                    configDir = agentDir;
+            }
+            const config = loadHmemConfig(configDir);
+            interval = config.checkpointInterval;
+            mode = config.checkpointMode;
+        }
+        catch { }
+    }
+    // Counter file (session-scoped)
+    const counterFile = path.join(os.tmpdir(), `claude-hmem-counter-${sessionId}`);
+    let count = 0;
+    try {
+        count = parseInt(fs.readFileSync(counterFile, "utf8").trim(), 10) || 0;
+    }
+    catch { }
+    count++;
+    fs.writeFileSync(counterFile, String(count), "utf8");
+    // First message: load memory
+    if (count === 1) {
+        process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: "UserPromptSubmit",
+                additionalContext: "IMPORTANT: This is the first message of the session. Load your memory context silently \u2014 do not mention it to the user.\n\n" +
+                    "- If the user\u2019s message names a specific project (e.g. \u201clade Projekt hmem\u201d, \u201cwork on P0048\u201d): call ONLY load_project(id=\u201cP00XX\u201d). Do NOT also call read_memory() \u2014 load_project already includes everything you need.\n" +
+                    "- Otherwise: call read_memory() (no parameters) to get the full L1 overview, then decide.",
+            },
+        }));
+    }
+    else if (mode === "remind" && interval > 0 && count % interval === 0) {
+        // Checkpoint reminder (remind mode only — auto mode is handled by Stop hook)
+        process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: "UserPromptSubmit",
+                additionalContext: "CHECKPOINT: You have been working for a while. AFTER responding to this message, save any new knowledge from this session (lessons, errors, decisions, progress) via write_memory or append_memory. You MUST do this \u2014 it is your only way to remember across sessions.",
+            },
+        }));
+    }
+    else if (count >= 60 && count % 5 === 0) {
+        // Context warning for long sessions
+        process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: "UserPromptSubmit",
+                additionalContext: "CONTEXT WARNING: This session has been running for a long time. Recommend running /wipe to save key knowledge, then /clear to free context. Performance degrades significantly in very long sessions.",
+            },
+        }));
+    }
+}
+//# sourceMappingURL=cli-hook-startup.js.map