@gamaze/hicortex 0.4.1 → 0.4.3

package/README.md

@@ -71,7 +71,7 @@ npx @gamaze/hicortex uninstall                 # Remove CC integration (keeps DB
 ## Architecture
 
 ```
-  Client (MBP)              Server (bedrock)          Client (MBA)
+  Client A                  Server                    Client B
   ┌──────────┐              ┌──────────────┐          ┌──────────┐
   │CC sessions│              │   Shared DB   │          │CC sessions│
   │    ↓      │  POST        │              │  POST    │    ↓      │
@@ -99,6 +99,7 @@ Config at `~/.hicortex/config.json`. Created by `init`. Key options:
 | `serverUrl` | Remote server URL (client mode) |
 | `llmModel` | Model for importance scoring |
 | `distillModel` | Model for session distillation (9b+ recommended) |
+| `distillBaseUrl` | Separate Ollama instance for distillation |
 | `reflectModel` | Model for nightly reflection (largest available) |
 | `reflectBaseUrl` | Separate Ollama instance for reflection |
 | `authToken` | Bearer token for endpoint auth |

package/dist/claude-md.d.ts

@@ -1,15 +1,16 @@
 /**
  * CLAUDE.md lesson injection — manages the Hicortex Learnings block.
  *
- * Writes a delimited block into ~/.claude/CLAUDE.md containing:
- * - Agent guidance for proactive tool use
- * - Active lessons from the DB
+ * Injects a dynamic, nightly-updated block into ~/.claude/CLAUDE.md:
+ * - Top lessons (from reflection, high-confidence)
+ * - Memory index (projects + counts, primes the agent to search)
+ * - Current project context (recent decisions for this project)
  *
- * Idempotent: calling twice with the same lessons produces the same file.
+ * Idempotent: calling twice with the same data produces the same file.
  */
 import type Database from "better-sqlite3";
 /**
- * Inject lessons from the DB into CLAUDE.md.
+ * Inject lessons, memory index, and project context into CLAUDE.md.
  * Creates the file if it doesn't exist.
  * Replaces existing block if present, appends if not.
  */

package/dist/claude-md.js

@@ -2,11 +2,12 @@
 /**
  * CLAUDE.md lesson injection — manages the Hicortex Learnings block.
  *
- * Writes a delimited block into ~/.claude/CLAUDE.md containing:
- * - Agent guidance for proactive tool use
- * - Active lessons from the DB
+ * Injects a dynamic, nightly-updated block into ~/.claude/CLAUDE.md:
+ * - Top lessons (from reflection, high-confidence)
+ * - Memory index (projects + counts, primes the agent to search)
+ * - Current project context (recent decisions for this project)
  *
- * Idempotent: calling twice with the same lessons produces the same file.
+ * Idempotent: calling twice with the same data produces the same file.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -46,42 +47,67 @@ exports.injectLessons = injectLessons;
 exports.removeLessonsBlock = removeLessonsBlock;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_path_2 = require("node:path");
 const node_os_1 = require("node:os");
 const storage = __importStar(require("./storage.js"));
 const license_js_1 = require("./license.js");
 const START_MARKER = "<!-- HICORTEX-LEARNINGS:START -->";
 const END_MARKER = "<!-- HICORTEX-LEARNINGS:END -->";
-const DEFAULT_CLAUDE_MD = (0, node_path_2.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");
-const AGENT_GUIDANCE = `You have access to long-term memory via Hicortex MCP tools. Use \`hicortex_search\` when you need context from past sessions, decisions, or prior work. Use \`hicortex_context\` at session start to recall recent project state. Use \`hicortex_ingest\` to save important decisions or learnings. Sessions are auto-captured nightly.`;
+const DEFAULT_CLAUDE_MD = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");
 /**
- * Inject lessons from the DB into CLAUDE.md.
+ * Inject lessons, memory index, and project context into CLAUDE.md.
  * Creates the file if it doesn't exist.
  * Replaces existing block if present, appends if not.
  */
 function injectLessons(db, options = {}) {
     const claudeMdPath = options.claudeMdPath ?? DEFAULT_CLAUDE_MD;
-    const stateDir = options.stateDir ?? (0, node_path_2.join)((0, node_os_1.homedir)(), ".hicortex");
-    // Determine lesson limit based on license
+    const stateDir = options.stateDir ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+    // Determine limits based on license
     const features = (0, license_js_1.getFeatures)(stateDir);
-    const maxLessons = features.maxMemories === -1 ? 15 : 7;
-    // Load lessons
+    const maxLessons = features.maxMemories === -1 ? 10 : 5;
+    // --- Lessons ---
     const lessons = storage.getLessons(db, 30, options.project);
     const selected = lessons.slice(0, maxLessons);
-    // Format lesson lines
     const lessonLines = selected.map((l) => {
-        const match = l.content.match(/## Lesson: (.+)/);
-        return match ? `- ${match[1]}` : `- ${l.content.slice(0, 200)}`;
+        const titleMatch = l.content.match(/## Lesson: (.+)/);
+        const typeMatch = l.content.match(/\*\*Type:\*\* (\w+)/);
+        const severityMatch = l.content.match(/\*\*Severity:\*\* (\w+)/);
+        const title = titleMatch ? titleMatch[1] : l.content.slice(0, 150);
+        const meta = [severityMatch?.[1], typeMatch?.[1]].filter(Boolean).join(", ");
+        return `- ${title}${meta ? ` (${meta})` : ""}`;
     });
-    // Build the block
-    const blockParts = [START_MARKER, "## Hicortex Learnings", "", AGENT_GUIDANCE];
+    // --- Memory Index ---
+    const projectIndex = buildProjectIndex(db);
+    const totalCount = storage.countMemories(db);
+    const lessonCount = lessons.length;
+    const sourceCount = countSources(db);
+    // --- Current Project Context ---
+    const currentProject = detectCurrentProject(claudeMdPath);
+    const projectContext = currentProject
+        ? buildProjectContext(db, currentProject)
+        : [];
+    // --- Build Block ---
+    const blockParts = [START_MARKER, "## Hicortex Memory"];
+    // Mandatory instruction
+    blockParts.push("", "You have access to shared long-term memory across all agents and sessions.", "BEFORE making decisions, search memory: `hicortex_search` for prior decisions on the same topic.", "Use `hicortex_context` at session start for recent project state.");
+    // Lessons
     if (lessonLines.length > 0) {
-        blockParts.push("", "### Active Lessons");
+        blockParts.push("", "### Lessons (updated nightly)");
         blockParts.push(...lessonLines);
     }
+    // Project context
+    if (projectContext.length > 0) {
+        blockParts.push("", `### This Project (${currentProject})`);
+        blockParts.push(...projectContext);
+    }
+    // Memory index
+    if (projectIndex.length > 0) {
+        blockParts.push("", "### Memory Index");
+        blockParts.push(projectIndex.join(" | "));
+        blockParts.push(`${totalCount} memories, ${lessonCount} lessons, ${sourceCount} agents. Search with \`hicortex_search\`.`);
+    }
     blockParts.push(END_MARKER);
     const block = blockParts.join("\n");
-    // Read existing file or start empty
+    // --- Write ---
     let content = "";
     try {
         content = (0, node_fs_1.readFileSync)(claudeMdPath, "utf-8");
@@ -89,31 +115,94 @@ function injectLessons(db, options = {}) {
     catch {
         // File doesn't exist — will create it
     }
-    // Replace or append
     const startIdx = content.indexOf(START_MARKER);
     const endIdx = content.indexOf(END_MARKER);
     if (startIdx !== -1 && endIdx !== -1) {
-        // Replace existing block
         content =
             content.slice(0, startIdx) +
                 block +
                 content.slice(endIdx + END_MARKER.length);
     }
     else {
-        // Append with blank line separator
-        if (content.length > 0 && !content.endsWith("\n")) {
+        if (content.length > 0 && !content.endsWith("\n"))
             content += "\n";
-        }
-        if (content.length > 0) {
+        if (content.length > 0)
             content += "\n";
-        }
         content += block + "\n";
     }
-    // Write
     (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(claudeMdPath), { recursive: true });
     (0, node_fs_1.writeFileSync)(claudeMdPath, content);
     return { lessonsCount: selected.length, path: claudeMdPath };
 }
+/**
+ * Build compact project index: "hicortex: 18 | boat: 24 | health: 45"
+ */
+function buildProjectIndex(db) {
+    try {
+        const rows = db
+            .prepare(`SELECT project, COUNT(*) as cnt FROM memories
+         WHERE project IS NOT NULL
+         GROUP BY project ORDER BY cnt DESC LIMIT 10`)
+            .all();
+        return rows.map((r) => `${r.project}: ${r.cnt}`);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Count distinct source agents.
+ */
+function countSources(db) {
+    try {
+        return db
+            .prepare("SELECT COUNT(DISTINCT source_agent) as cnt FROM memories")
+            .get().cnt;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Detect current project from the CLAUDE.md path.
+ * CC puts project-specific CLAUDE.md files in ~/.claude/projects/<encoded-path>/
+ * The global ~/.claude/CLAUDE.md has no project context.
+ */
+function detectCurrentProject(claudeMdPath) {
+    // Global CLAUDE.md — no project
+    if (claudeMdPath === DEFAULT_CLAUDE_MD)
+        return null;
+    // Project CLAUDE.md: ~/.claude/projects/-Users-foo-myproject/CLAUDE.md
+    // Extract the last segment of the encoded path
+    const match = claudeMdPath.match(/projects\/[^/]*-([^/]+)\//);
+    if (match)
+        return match[1];
+    return null;
+}
+/**
+ * Build recent decisions/facts for a specific project.
+ * Returns formatted lines like: "- Shipped v0.4.1 with multi-client (2026-03-28)"
+ */
+function buildProjectContext(db, project) {
+    try {
+        const rows = db
+            .prepare(`SELECT content, created_at FROM memories
+         WHERE project = ? AND memory_type IN ('decision', 'episode')
+         ORDER BY created_at DESC LIMIT 5`)
+            .all(project);
+        return rows.map((r) => {
+            const date = r.created_at?.slice(0, 10) ?? "";
+            // Extract first meaningful line from content
+            const lines = r.content.split("\n").filter((l) => l.trim().length > 10);
+            const summary = lines.find((l) => l.startsWith("- ") || l.startsWith("### "))?.replace(/^[-#\s]+/, "").slice(0, 120) ??
+                r.content.slice(0, 120);
+            return `- ${summary} (${date})`;
+        });
+    }
+    catch {
+        return [];
+    }
+}
 /**
  * Remove the Hicortex Learnings block from CLAUDE.md.
  * Used by the uninstall command.
@@ -124,16 +213,14 @@ function removeLessonsBlock(claudeMdPath = DEFAULT_CLAUDE_MD) {
         content = (0, node_fs_1.readFileSync)(claudeMdPath, "utf-8");
     }
     catch {
-        return false; // File doesn't exist
+        return false;
     }
     const startIdx = content.indexOf(START_MARKER);
     const endIdx = content.indexOf(END_MARKER);
     if (startIdx === -1 || endIdx === -1)
         return false;
-    // Remove block and any trailing blank line
     let newContent = content.slice(0, startIdx) +
         content.slice(endIdx + END_MARKER.length);
-    // Clean up double blank lines left by removal
     newContent = newContent.replace(/\n{3,}/g, "\n\n").trim();
     if (newContent.length > 0)
         newContent += "\n";

package/dist/cli.d.ts

@@ -6,6 +6,7 @@
  *   server     Start the MCP HTTP/SSE server (persistent daemon)
  *   init       Detect existing setup and configure for CC/OC
  *   nightly    Run distill + consolidate + inject lessons (manual trigger)
+ *              nightly --status  Show nightly pipeline health check
  *   status     Show config, DB stats, adapter status
  *   uninstall  Clean removal of CC integration
  */

package/dist/cli.js

@@ -7,6 +7,7 @@
  *   server     Start the MCP HTTP/SSE server (persistent daemon)
  *   init       Detect existing setup and configure for CC/OC
  *   nightly    Run distill + consolidate + inject lessons (manual trigger)
+ *              nightly --status  Show nightly pipeline health check
  *   status     Show config, DB stats, adapter status
  *   uninstall  Clean removal of CC integration
  */
@@ -38,13 +39,24 @@ switch (command) {
         break;
     }
     case "nightly": {
-        const dryRun = process.argv.includes("--dry-run");
-        import("./nightly.js").then(({ runNightly }) => {
-            runNightly({ dryRun }).catch((err) => {
-                console.error("[hicortex] Nightly pipeline failed:", err);
-                process.exit(1);
+        const args = process.argv.slice(3);
+        if (args.includes("--status")) {
+            import("./nightly-status.js").then(({ showNightlyStatus }) => {
+                showNightlyStatus().catch((err) => {
+                    console.error("[hicortex] Status check failed:", err);
+                    process.exit(1);
+                });
             });
-        });
+        }
+        else {
+            const dryRun = args.includes("--dry-run");
+            import("./nightly.js").then(({ runNightly }) => {
+                runNightly({ dryRun }).catch((err) => {
+                    console.error("[hicortex] Nightly pipeline failed:", err);
+                    process.exit(1);
+                });
+            });
+        }
         break;
     }
     case "status":
@@ -77,13 +89,15 @@ Commands:
   uninstall  Remove CC integration (preserves DB)
 
 Options:
-  server --port <n>   Port (default: 8787)
-  server --host <h>   Host (default: 127.0.0.1)
-  nightly --dry-run   Preview without changes
+  server --port <n>    Port (default: 8787)
+  server --host <h>    Host (default: 127.0.0.1)
+  nightly --dry-run    Preview without changes
+  nightly --status     Show nightly pipeline health
 
 Examples:
   npx @gamaze/hicortex server
   npx @gamaze/hicortex init
+  npx @gamaze/hicortex nightly --status
   npx @gamaze/hicortex init --server https://myserver.example.com
   npx @gamaze/hicortex status`);
         process.exit(command ? 1 : 0);

package/dist/distiller.d.ts

@@ -4,12 +4,22 @@
  * not from filesystem scanning.
  */
 import type { LlmClient } from "./llm.js";
+/**
+ * Estimate a safe chunk size in chars based on the LLM provider and model.
+ * - API providers (Anthropic, OpenAI, claude-cli): no chunking needed (large context windows)
+ * - Ollama: query /api/show for context_length AND parameter_count, cap based on both
+ * - Small models (<8B params): max 20K chars (~5K tokens) — keeps CPU inference under ~60s
+ * - Larger models: up to 60K chars (~15K tokens)
+ * - Fallback: 20K chars
+ */
+export declare function detectChunkSize(provider: string, model: string, baseUrl?: string): Promise<number>;
 /**
  * Convert OpenClaw hook messages to a filtered transcript string.
  */
 export declare function extractConversationText(messages: unknown[]): string;
 /**
  * Send filtered conversation to LLM for knowledge extraction.
+ * For large transcripts, chunks into segments to avoid overwhelming small models.
  * Returns an array of memory entries to ingest, or empty array if nothing worth extracting.
  */
-export declare function distillSession(llm: LlmClient, conversation: string, projectName: string, date: string): Promise<string[]>;
+export declare function distillSession(llm: LlmClient, conversation: string, projectName: string, date: string, chunkSizeChars?: number): Promise<string[]>;

package/dist/distiller.js

@@ -5,11 +5,74 @@
  * not from filesystem scanning.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectChunkSize = detectChunkSize;
 exports.extractConversationText = extractConversationText;
 exports.distillSession = distillSession;
 const prompts_js_1 = require("./prompts.js");
 const MAX_TRANSCRIPT_CHARS = 80_000;
 const MIN_CONVERSATION_CHARS = 200;
+// Chunk size limits by model parameter count (for local/CPU inference)
+// Small models are slow on CPU — cap input size to keep inference under ~60s
+const SMALL_MODEL_PARAMS = 8_000_000_000; // 8B — threshold for "small"
+const SMALL_MODEL_MAX_CHUNK_CHARS = 20_000; // ~5K tokens — safe for 4-8B on CPU
+const LARGE_MODEL_MAX_CHUNK_CHARS = 60_000; // ~15K tokens — ok for 8B+ on GPU or API
+/**
+ * Estimate a safe chunk size in chars based on the LLM provider and model.
+ * - API providers (Anthropic, OpenAI, claude-cli): no chunking needed (large context windows)
+ * - Ollama: query /api/show for context_length AND parameter_count, cap based on both
+ * - Small models (<8B params): max 20K chars (~5K tokens) — keeps CPU inference under ~60s
+ * - Larger models: up to 60K chars (~15K tokens)
+ * - Fallback: 20K chars
+ */
+async function detectChunkSize(provider, model, baseUrl) {
+    // API-based providers handle large contexts natively — no chunking needed
+    if (provider !== "ollama") {
+        return MAX_TRANSCRIPT_CHARS;
+    }
+    // Query Ollama for model metadata
+    if (baseUrl) {
+        try {
+            const resp = await fetch(`${baseUrl}/api/show`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ name: model }),
+                signal: AbortSignal.timeout(5000),
+            });
+            if (resp.ok) {
+                const data = await resp.json();
+                const info = data.model_info ?? {};
+                // Extract parameter count for speed-aware capping
+                const paramKey = Object.keys(info).find((k) => k.endsWith("parameter_count"));
+                const paramCount = paramKey && typeof info[paramKey] === "number"
+                    ? info[paramKey]
+                    : 0;
+                const isSmallModel = paramCount > 0 && paramCount < SMALL_MODEL_PARAMS;
+                // Extract context length for context-aware capping
+                const ctxKey = Object.keys(info).find((k) => k.endsWith("context_length") || k.endsWith("context_window"));
+                const contextTokens = ctxKey && typeof info[ctxKey] === "number"
+                    ? info[ctxKey]
+                    : 0;
+                // Determine max chunk size based on model size (speed constraint)
+                // Unknown param count defaults to conservative (small model) — safe for any hardware
+                const maxBySpeed = !isSmallModel && paramCount > 0 ? LARGE_MODEL_MAX_CHUNK_CHARS : SMALL_MODEL_MAX_CHUNK_CHARS;
+                // Determine max chunk size based on context window (fits-in-context constraint)
+                const maxByContext = contextTokens > 0
+                    ? Math.floor(contextTokens * 0.6 * 4) // 60% of context, ~4 chars/token
+                    : MAX_TRANSCRIPT_CHARS;
+                const chunkChars = Math.min(maxBySpeed, maxByContext);
+                console.log(`[hicortex]     Model: ${paramCount > 0 ? `${(paramCount / 1e9).toFixed(1)}B params` : "unknown size"}, ` +
+                    `context: ${contextTokens > 0 ? `${contextTokens} tokens` : "unknown"}, ` +
+                    `chunk size: ${chunkChars} chars${isSmallModel ? " (small model cap)" : ""}`);
+                return chunkChars;
+            }
+        }
+        catch {
+            // Failed to query — use fallback
+        }
+    }
+    // Fallback: 20K chars (~5K tokens) — safe for 4B models with 32K context
+    return 20_000;
+}
 // Entry types to skip entirely (from the Python distiller)
 const SKIP_ENTRY_TYPES = new Set([
     "progress",
@@ -128,17 +191,54 @@ function extractConversationText(messages) {
 }
 /**
  * Send filtered conversation to LLM for knowledge extraction.
+ * For large transcripts, chunks into segments to avoid overwhelming small models.
  * Returns an array of memory entries to ingest, or empty array if nothing worth extracting.
  */
-async function distillSession(llm, conversation, projectName, date) {
+async function distillSession(llm, conversation, projectName, date, chunkSizeChars) {
     if (conversation.length < MIN_CONVERSATION_CHARS) {
         return [];
     }
-    // Truncate if too long
+    // Cap total input at MAX_TRANSCRIPT_CHARS
     let transcript = conversation;
     if (transcript.length > MAX_TRANSCRIPT_CHARS) {
         transcript = transcript.slice(0, MAX_TRANSCRIPT_CHARS) + "\n\n[...truncated...]";
     }
+    // Use provided chunk size or default to no chunking
+    const chunkSize = chunkSizeChars ?? MAX_TRANSCRIPT_CHARS;
+    // If transcript fits in one chunk, distill directly
+    if (transcript.length <= chunkSize) {
+        return distillChunk(llm, transcript, projectName, date);
+    }
+    // Chunk large transcripts and distill each segment
+    const chunks = splitIntoChunks(transcript, chunkSize);
+    console.log(`[hicortex]     Chunking ${transcript.length} chars into ${chunks.length} segments`);
+    const allEntries = [];
+    const seen = new Set();
+    for (let i = 0; i < chunks.length; i++) {
+        console.log(`[hicortex]     Chunk ${i + 1}/${chunks.length} (${chunks[i].length} chars)`);
+        try {
+            const entries = await distillChunk(llm, chunks[i], projectName, date);
+            for (const entry of entries) {
+                // Deduplicate by normalized content
+                const key = entry.toLowerCase().replace(/\s+/g, " ").slice(0, 100);
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    allEntries.push(entry);
+                }
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[hicortex]     Chunk ${i + 1} failed: ${msg}`);
+            // Continue with remaining chunks — partial extraction is better than none
+        }
+    }
+    return allEntries;
+}
+/**
+ * Distill a single chunk of conversation text.
+ */
+async function distillChunk(llm, transcript, projectName, date) {
     const prompt = (0, prompts_js_1.distillation)(projectName, date, transcript);
     try {
         const result = await llm.completeDistill(prompt);
@@ -147,7 +247,6 @@ async function distillSession(llm, conversation, projectName, date) {
         if (result === "NO_EXTRACT" || result.slice(0, 20).includes("NO_EXTRACT")) {
             return [];
         }
-        // Split distilled markdown into individual memory entries
         return parseDistilledEntries(result);
     }
     catch (err) {
@@ -156,6 +255,35 @@ async function distillSession(llm, conversation, projectName, date) {
         return [];
     }
 }
+/**
+ * Split transcript text into chunks at natural boundaries (double newlines).
+ * Each chunk is at most maxChars, split at the last paragraph boundary.
+ */
+function splitIntoChunks(text, maxChars) {
+    if (text.length <= maxChars)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxChars) {
+            chunks.push(remaining);
+            break;
+        }
+        // Find the last paragraph break within maxChars
+        let splitAt = remaining.lastIndexOf("\n\n", maxChars);
+        if (splitAt < maxChars * 0.5) {
+            // No good paragraph break — fall back to last newline
+            splitAt = remaining.lastIndexOf("\n", maxChars);
+        }
+        if (splitAt < maxChars * 0.3) {
+            // No good break at all — hard split
+            splitAt = maxChars;
+        }
+        chunks.push(remaining.slice(0, splitAt).trim());
+        remaining = remaining.slice(splitAt).trim();
+    }
+    return chunks.filter((c) => c.length >= MIN_CONVERSATION_CHARS);
+}
 /**
  * Parse distilled markdown into individual memory entry strings.
  * Each section item becomes a separate memory.

package/dist/init.js

@@ -717,7 +717,7 @@ async function runInit(options = {}) {
         catch { /* new file */ }
         const block = [
             "<!-- HICORTEX-LEARNINGS:START -->",
-            "## Hicortex Learnings",
+            "## Hicortex Memory",
             "",
             "You have access to long-term memory via Hicortex MCP tools. Use `hicortex_search` when you need context from past sessions, decisions, or prior work. Use `hicortex_context` at session start to recall recent project state. Use `hicortex_ingest` to save important decisions or learnings. Sessions are auto-captured nightly.",
             "<!-- HICORTEX-LEARNINGS:END -->",
@@ -858,7 +858,7 @@ async function runClientInit(serverUrl) {
         catch { }
         const block = [
             "<!-- HICORTEX-LEARNINGS:START -->",
-            "## Hicortex Learnings",
+            "## Hicortex Memory",
             "",
             "You have access to long-term memory via Hicortex MCP tools. Use `hicortex_search` when you need context from past sessions, decisions, or prior work. Use `hicortex_context` at session start to recall recent project state. Use `hicortex_ingest` to save important decisions or learnings. Sessions are auto-captured nightly.",
             "<!-- HICORTEX-LEARNINGS:END -->",

package/dist/llm.d.ts

@@ -25,6 +25,10 @@ export interface LlmConfig {
     provider: string;
     /** Optional separate model for distillation (defaults to model if unset). */
     distillModel?: string;
+    /** Optional separate endpoint for distillation (e.g. remote Ollama with larger/faster model). */
+    distillBaseUrl?: string;
+    distillApiKey?: string;
+    distillProvider?: string;
     /** Optional separate endpoint for reflect-tier LLM (e.g. remote Ollama with larger model). */
     reflectBaseUrl?: string;
     reflectApiKey?: string;
@@ -59,6 +63,17 @@ export declare function findClaudeBinary(): string | null;
  * baseUrl field stores the path to the claude binary.
  */
 export declare function claudeCliConfig(claudePath: string): LlmConfig;
+/**
+ * Check if a local Ollama instance is reachable and has models loaded.
+ * Returns the model name if available, null otherwise.
+ */
+export declare function probeOllama(baseUrl?: string): Promise<string | null>;
+/**
+ * For batch operations (nightly pipeline), prefer Ollama when available.
+ * Claude CLI has strict rate limits that kill batch distillation.
+ * Falls back to the provided config if Ollama is unreachable.
+ */
+export declare function preferOllamaForBatch(resolved: LlmConfig, ollamaBaseUrl?: string): Promise<LlmConfig>;
 export declare class RateLimitError extends Error {
     retryAfterMs: number;
     constructor(retryAfterMs: number);
@@ -81,6 +96,7 @@ export declare class LlmClient {
     completeReflect(prompt: string, maxTokens?: number): Promise<string>;
     /**
      * Distillation-tier completion (session knowledge extraction).
+     * Routes to distillBaseUrl/distillProvider if configured (e.g. remote Ollama with faster model).
      */
     completeDistill(prompt: string, maxTokens?: number): Promise<string>;
     /**

package/dist/llm.js

@@ -24,6 +24,8 @@ exports.resolveLlmConfig = resolveLlmConfig;
 exports.resolveLlmConfigForCC = resolveLlmConfigForCC;
 exports.findClaudeBinary = findClaudeBinary;
 exports.claudeCliConfig = claudeCliConfig;
+exports.probeOllama = probeOllama;
+exports.preferOllamaForBatch = preferOllamaForBatch;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
@@ -348,6 +350,55 @@ function claudeCliConfig(claudePath) {
         provider: "claude-cli",
     };
 }
+/**
+ * Check if a local Ollama instance is reachable and has models loaded.
+ * Returns the model name if available, null otherwise.
+ */
+async function probeOllama(baseUrl = "http://localhost:11434") {
+    try {
+        const resp = await fetch(`${baseUrl}/api/ps`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        if (!resp.ok)
+            return null;
+        const data = (await resp.json());
+        if (data.models && data.models.length > 0) {
+            return data.models[0].name;
+        }
+        // No model loaded — check if any are available
+        const tagsResp = await fetch(`${baseUrl}/api/tags`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        if (!tagsResp.ok)
+            return null;
+        const tags = (await tagsResp.json());
+        return tags.models?.[0]?.name ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * For batch operations (nightly pipeline), prefer Ollama when available.
+ * Claude CLI has strict rate limits that kill batch distillation.
+ * Falls back to the provided config if Ollama is unreachable.
+ */
+async function preferOllamaForBatch(resolved, ollamaBaseUrl = "http://localhost:11434") {
+    // Only override claude-cli (which has rate limits)
+    if (resolved.provider !== "claude-cli")
+        return resolved;
+    const model = await probeOllama(ollamaBaseUrl);
+    if (!model)
+        return resolved;
+    return {
+        ...resolved,
+        baseUrl: ollamaBaseUrl,
+        apiKey: "",
+        model,
+        reflectModel: resolved.reflectModel ?? model,
+        provider: "ollama",
+    };
+}
 // ---------------------------------------------------------------------------
 // LLM Client class
 // ---------------------------------------------------------------------------
@@ -401,8 +452,12 @@ class LlmClient {
     }
     /**
      * Distillation-tier completion (session knowledge extraction).
+     * Routes to distillBaseUrl/distillProvider if configured (e.g. remote Ollama with faster model).
      */
     async completeDistill(prompt, maxTokens = 2048) {
+        if (this.config.distillBaseUrl) {
+            return this.completeWithOverride(this.config.distillBaseUrl, this.config.distillApiKey ?? this.config.apiKey, this.config.distillProvider ?? this.config.provider, this.config.distillModel ?? this.config.model, prompt, maxTokens, 900_000);
+        }
         return this.complete(this.config.distillModel ?? this.config.model, prompt, maxTokens, 900_000);
     }
     /**

package/dist/mcp-server.js

@@ -273,10 +273,15 @@ async function startServer(options = {}) {
             reflectModel: savedConfig?.reflectModel,
         });
     }
-    // Apply optional distillModel (e.g. larger local model for session extraction)
+    // Apply optional distill endpoint (e.g. remote Ollama with faster model)
     if (savedConfig?.distillModel) {
         llmConfig.distillModel = savedConfig.distillModel;
     }
+    if (savedConfig?.distillBaseUrl) {
+        llmConfig.distillBaseUrl = savedConfig.distillBaseUrl;
+        llmConfig.distillApiKey = savedConfig.distillApiKey ?? llmConfig.apiKey;
+        llmConfig.distillProvider = savedConfig.distillProvider ?? llmConfig.provider;
+    }
     // Apply separate reflect endpoint if configured (e.g. remote Ollama with larger model)
     if (savedConfig?.reflectBaseUrl) {
         llmConfig.reflectBaseUrl = savedConfig.reflectBaseUrl;
@@ -284,11 +289,13 @@ async function startServer(options = {}) {
         llmConfig.reflectProvider = savedConfig.reflectProvider ?? llmConfig.provider;
     }
     llm = new llm_js_1.LlmClient(llmConfig);
-    const distillInfo = llmConfig.distillModel ? `, distill: ${llmConfig.distillModel}` : "";
+    const distillInfo = llmConfig.distillBaseUrl
+        ? `${llmConfig.distillProvider}/${llmConfig.distillModel}@${llmConfig.distillBaseUrl}`
+        : llmConfig.distillModel ? llmConfig.distillModel : "";
     const reflectInfo = llmConfig.reflectBaseUrl
         ? `${llmConfig.reflectProvider}/${llmConfig.reflectModel}@${llmConfig.reflectBaseUrl}`
         : llmConfig.reflectModel;
-    console.log(`[hicortex] LLM fast: ${llmConfig.provider}/${llmConfig.model}${distillInfo}, reflect: ${reflectInfo}`);
+    console.log(`[hicortex] LLM fast: ${llmConfig.provider}/${llmConfig.model}${distillInfo ? `, distill: ${distillInfo}` : ""}, reflect: ${reflectInfo}`);
     // License: read from options, config file, or env var
     const licenseKey = options.licenseKey
         ?? savedConfig?.licenseKey
@@ -361,6 +368,40 @@ async function startServer(options = {}) {
             llm: `${llmConfig.provider}/${llmConfig.model}`,
         });
     });
+    // REST /lessons — return lessons + memory index for client CLAUDE.md injection
+    app.get("/lessons", (_req, res) => {
+        if (!db) {
+            res.status(503).json({ error: "Server not initialized" });
+            return;
+        }
+        try {
+            const lessons = storage.getLessons(db, 30);
+            const totalCount = storage.countMemories(db);
+            // Project index
+            const projects = db
+                .prepare("SELECT project, COUNT(*) as cnt FROM memories WHERE project IS NOT NULL GROUP BY project ORDER BY cnt DESC LIMIT 10")
+                .all();
+            const sourceCount = db.prepare("SELECT COUNT(DISTINCT source_agent) as cnt FROM memories").get().cnt;
+            const lessonCount = lessons.length;
+            res.json({
+                lessons: lessons.map(l => ({
+                    content: l.content,
+                    created_at: l.created_at,
+                    base_strength: l.base_strength,
+                    access_count: l.access_count,
+                })),
+                index: {
+                    total: totalCount,
+                    lessonCount,
+                    sourceCount,
+                    projects: projects.map(p => ({ name: p.project, count: p.cnt })),
+                },
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
     // REST /ingest — accept pre-distilled memories from remote clients
     app.post("/ingest", async (req, res) => {
         if (!db) {

package/dist/nightly-status.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Nightly pipeline status — lightweight check without running the pipeline.
+ *
+ * Shows:
+ *   - Last run timestamp + age
+ *   - Timer/schedule status (systemd/launchd)
+ *   - DB memory count
+ *   - Distillation source breakdown
+ *   - Staleness warnings
+ */
+export declare function showNightlyStatus(): Promise<void>;

package/dist/nightly-status.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Nightly pipeline status — lightweight check without running the pipeline.
+ *
+ * Shows:
+ *   - Last run timestamp + age
+ *   - Timer/schedule status (systemd/launchd)
+ *   - DB memory count
+ *   - Distillation source breakdown
+ *   - Staleness warnings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showNightlyStatus = showNightlyStatus;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const node_child_process_1 = require("node:child_process");
+const db_js_1 = require("./db.js");
+const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const LAST_RUN_PATH = (0, node_path_1.join)(HICORTEX_HOME, "nightly-last-run.txt");
+const CONFIG_PATH = (0, node_path_1.join)(HICORTEX_HOME, "config.json");
+const STALE_THRESHOLD_HOURS = 30;
+async function showNightlyStatus() {
+    console.log("Hicortex Nightly Pipeline Status");
+    console.log("─".repeat(40));
+    // Last run
+    let lastRun = null;
+    let lastRunStr = "never";
+    try {
+        const ts = (0, node_fs_1.readFileSync)(LAST_RUN_PATH, "utf-8").trim();
+        const d = new Date(ts);
+        if (!isNaN(d.getTime())) {
+            lastRun = d;
+            lastRunStr = ts;
+        }
+        else {
+            lastRunStr = `${ts} (invalid)`;
+        }
+    }
+    catch {
+        // No file
+    }
+    if (lastRun) {
+        const ageMs = Date.now() - lastRun.getTime();
+        const ageHours = Math.round(ageMs / (60 * 60 * 1000));
+        const ageStr = ageHours < 1 ? "just now" :
+            ageHours < 24 ? `${ageHours}h ago` :
+                `${Math.round(ageHours / 24)}d ago`;
+        const isStale = ageHours > STALE_THRESHOLD_HOURS;
+        console.log(`Last run:    ${lastRunStr} (${ageStr})${isStale ? " ⚠ STALE" : ""}`);
+    }
+    else {
+        console.log(`Last run:    ${lastRunStr}`);
+    }
+    // LLM config
+    try {
+        const config = JSON.parse((0, node_fs_1.readFileSync)(CONFIG_PATH, "utf-8"));
+        const backend = config.llmBackend ?? "auto-detect";
+        const model = config.llmModel ?? "default";
+        const mode = config.mode === "client" ? "client → " + (config.serverUrl ?? "?") : "server (local)";
+        console.log(`Mode:        ${mode}`);
+        console.log(`LLM backend: ${backend}${backend !== "auto-detect" ? ` (${model})` : ""}`);
+    }
+    catch {
+        console.log("Config:      not configured (run: hicortex init)");
+    }
+    // Timer/schedule
+    const os = (0, node_os_1.platform)();
+    let timerActive = false;
+    let timerInfo = "not installed";
+    if (os === "darwin") {
+        try {
+            const out = (0, node_child_process_1.execSync)("launchctl list 2>/dev/null | grep hicortex-nightly", {
+                encoding: "utf-8",
+                timeout: 3000,
+            });
+            if (out.trim()) {
+                timerActive = true;
+                timerInfo = "launchd (loaded)";
+            }
+        }
+        catch { /* not installed */ }
+    }
+    else if (os === "linux") {
+        try {
+            const active = (0, node_child_process_1.execSync)("systemctl --user is-active hicortex-nightly.timer 2>/dev/null", {
+                encoding: "utf-8",
+                timeout: 3000,
+            }).trim();
+            if (active === "active" || active === "waiting") {
+                timerActive = true;
+                try {
+                    const next = (0, node_child_process_1.execSync)("systemctl --user show hicortex-nightly.timer --property=NextElapseUSecRealtime 2>/dev/null", {
+                        encoding: "utf-8",
+                        timeout: 3000,
+                    }).trim();
+                    const match = next.match(/=(\d+)/);
+                    if (match) {
+                        const nextDate = new Date(Number(match[1]) / 1000);
+                        timerInfo = `systemd (active, next: ${nextDate.toISOString()})`;
+                    }
+                    else {
+                        timerInfo = `systemd (${active})`;
+                    }
+                }
+                catch {
+                    timerInfo = `systemd (${active})`;
+                }
+            }
+        }
+        catch { /* not installed */ }
+    }
+    console.log(`Timer:       ${timerInfo}${!timerActive ? " ⚠ Pipeline will NOT run automatically" : ""}`);
+    // DB stats
+    const dbPath = (0, db_js_1.resolveDbPath)();
+    if ((0, node_fs_1.existsSync)(dbPath)) {
+        try {
+            const { initDb } = await import("./db.js");
+            const db = initDb(dbPath);
+            const count = db.prepare("SELECT COUNT(*) as c FROM memories").get().c;
+            let linkCount = 0;
+            try {
+                linkCount = db.prepare("SELECT COUNT(*) as c FROM memory_links").get().c;
+            }
+            catch {
+                // memory_links table may not exist in older DBs
+            }
+            // Source breakdown (top 5)
+            const sources = db.prepare("SELECT source_agent, COUNT(*) as cnt FROM memories GROUP BY source_agent ORDER BY cnt DESC LIMIT 5").all();
+            console.log(`\nMemories:    ${count} (${linkCount} links)`);
+            if (sources.length > 0) {
+                console.log("Sources:");
+                for (const s of sources) {
+                    console.log(`  ${s.source_agent || "unknown"}: ${s.cnt}`);
+                }
+            }
+            db.close();
+        }
+        catch (err) {
+            console.log(`\nDB:          error (${err instanceof Error ? err.message : String(err)})`);
+        }
+    }
+    else {
+        console.log(`\nDB:          not found (run: hicortex init)`);
+    }
+    // Health assessment
+    console.log("\n" + "─".repeat(40));
+    const issues = [];
+    if (!lastRun)
+        issues.push("Pipeline has never run. Run: hicortex nightly");
+    else if (lastRun && (Date.now() - lastRun.getTime()) > STALE_THRESHOLD_HOURS * 60 * 60 * 1000) {
+        issues.push(`Pipeline hasn't run in ${STALE_THRESHOLD_HOURS}+ hours. Check timer.`);
+    }
+    if (!timerActive)
+        issues.push("No timer installed. Nightly pipeline won't run automatically.");
+    if (!(0, node_fs_1.existsSync)(dbPath))
+        issues.push("No database found. Run: hicortex init");
+    if (issues.length === 0) {
+        console.log("✓ Nightly pipeline healthy");
+    }
+    else {
+        console.log("Issues:");
+        for (const issue of issues) {
+            console.log(`  ⚠ ${issue}`);
+        }
+    }
+}

package/dist/nightly.js

@@ -147,18 +147,30 @@ async function runNightly(options = {}) {
                 reflectModel: savedConfig?.reflectModel,
             });
         }
-        // Apply distillModel and reflect overrides from config
+        // Apply distill and reflect overrides from config
         if (savedConfig?.distillModel) {
             llmConfig.distillModel = savedConfig.distillModel;
         }
+        if (savedConfig?.distillBaseUrl) {
+            llmConfig.distillBaseUrl = savedConfig.distillBaseUrl;
+            llmConfig.distillApiKey = savedConfig.distillApiKey ?? llmConfig.apiKey;
+            llmConfig.distillProvider = savedConfig.distillProvider ?? llmConfig.provider;
+        }
         if (savedConfig?.reflectBaseUrl) {
             llmConfig.reflectBaseUrl = savedConfig.reflectBaseUrl;
             llmConfig.reflectApiKey = savedConfig.reflectApiKey ?? llmConfig.apiKey;
             llmConfig.reflectProvider = savedConfig.reflectProvider ?? llmConfig.provider;
         }
+        // Auto-detect Ollama for batch distillation (claude-cli has rate limits)
+        llmConfig = await (0, llm_js_1.preferOllamaForBatch)(llmConfig);
+        if (llmConfig.provider === "ollama") {
+            console.log(`[hicortex] Auto-detected local Ollama (${llmConfig.model}) — using for batch distillation`);
+        }
         const llm = new llm_js_1.LlmClient(llmConfig);
-        const distillInfo = llmConfig.distillModel ? `, distill: ${llmConfig.distillModel}` : "";
-        console.log(`[hicortex] LLM: ${llmConfig.provider}/${llmConfig.model}${distillInfo}`);
+        const distillInfo = llmConfig.distillBaseUrl
+            ? `${llmConfig.distillProvider}/${llmConfig.distillModel}@${llmConfig.distillBaseUrl}`
+            : llmConfig.distillModel ?? "";
+        console.log(`[hicortex] LLM: ${llmConfig.provider}/${llmConfig.model}${distillInfo ? `, distill: ${distillInfo}` : ""}`);
         // Step 1: Read new CC transcripts
         const since = readLastRun();
         console.log(`[hicortex] Reading CC transcripts since ${since.toISOString()}`);
@@ -171,6 +183,8 @@ async function runNightly(options = {}) {
         // Step 2: Distill each session
         let memoriesIngested = 0;
         const features = (0, license_js_1.getFeatures)(stateDir);
+        // Detect safe chunk size based on model context window
+        const chunkSize = await (0, distiller_js_1.detectChunkSize)(llmConfig.provider, llmConfig.distillModel ?? llmConfig.model, llmConfig.baseUrl);
         for (const batch of batches) {
             const transcript = (0, distiller_js_1.extractConversationText)(batch.entries);
             if (transcript.length < 200) {
@@ -189,7 +203,7 @@ async function runNightly(options = {}) {
                 break;
             }
             try {
-                const entries = await (0, distiller_js_1.distillSession)(llm, transcript, batch.projectName, batch.date);
+                const entries = await (0, distiller_js_1.distillSession)(llm, transcript, batch.projectName, batch.date, chunkSize);
                 for (const entry of entries) {
                     try {
                         const embedding = await (0, embedder_js_1.embed)(entry);
@@ -288,8 +302,23 @@ async function runClientNightly(config, dryRun) {
     if (config.distillModel) {
         llmConfig.distillModel = config.distillModel;
     }
+    if (config.distillBaseUrl) {
+        llmConfig.distillBaseUrl = config.distillBaseUrl;
+        llmConfig.distillApiKey = config.distillApiKey ?? llmConfig.apiKey;
+        llmConfig.distillProvider = config.distillProvider ?? llmConfig.provider;
+    }
+    // Auto-detect Ollama for batch distillation when claude-cli was resolved (fallback)
+    llmConfig = await (0, llm_js_1.preferOllamaForBatch)(llmConfig);
+    if (llmConfig.provider === "ollama" && !config.distillBaseUrl) {
+        console.log(`[hicortex] Auto-detected local Ollama (${llmConfig.model}) — using for batch distillation`);
+    }
     const llm = new llm_js_1.LlmClient(llmConfig);
-    console.log(`[hicortex] LLM: ${llmConfig.provider}/${llmConfig.distillModel ?? llmConfig.model}`);
+    const distillInfo = llmConfig.distillBaseUrl
+        ? `${llmConfig.distillProvider}/${llmConfig.distillModel}@${llmConfig.distillBaseUrl}`
+        : llmConfig.distillModel ?? "";
+    console.log(`[hicortex] LLM: ${llmConfig.provider}/${llmConfig.model}${distillInfo ? `, distill: ${distillInfo}` : ""}`);
+    // Detect safe chunk size based on model context window
+    const chunkSize = await (0, distiller_js_1.detectChunkSize)(llmConfig.provider, llmConfig.distillModel ?? llmConfig.model, llmConfig.baseUrl);
     // Read new CC transcripts
     const since = readLastRun();
     console.log(`[hicortex] Reading CC transcripts since ${since.toISOString()}`);
@@ -316,7 +345,7 @@ async function runClientNightly(config, dryRun) {
             continue;
         }
         try {
-            const entries = await (0, distiller_js_1.distillSession)(llm, transcript, batch.projectName, batch.date);
+            const entries = await (0, distiller_js_1.distillSession)(llm, transcript, batch.projectName, batch.date, chunkSize);
             if (entries.length === 0) {
                 console.log(`[hicortex]     → No memories extracted`);
                 continue;
@@ -371,7 +400,91 @@ async function runClientNightly(config, dryRun) {
             console.error(`[hicortex]     Failed: ${err instanceof Error ? err.message : String(err)}`);
         }
     }
+    // Inject lessons from server into CLAUDE.md
+    if (!dryRun) {
+        try {
+            await injectLessonsFromServer(serverUrl, authToken);
+        }
+        catch (err) {
+            console.error(`[hicortex] CLAUDE.md injection failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
     if (!dryRun)
         writeLastRun();
     console.log(`[hicortex] Client nightly complete: ${memoriesIngested} memories from ${sessionsSent} sessions → ${serverUrl}`);
 }
+/**
+ * Fetch lessons + memory index from server and inject into CLAUDE.md.
+ * Client mode equivalent of the server's injectLessons(db, ...).
+ */
+async function injectLessonsFromServer(serverUrl, authToken) {
+    const resp = await fetch(`${serverUrl}/lessons`, {
+        headers: authToken ? { "Authorization": `Bearer ${authToken}` } : {},
+        signal: AbortSignal.timeout(10_000),
+    });
+    if (!resp.ok) {
+        console.log(`[hicortex] Could not fetch lessons from server (${resp.status})`);
+        return;
+    }
+    const data = await resp.json();
+    const maxLessons = 10;
+    const selected = data.lessons.slice(0, maxLessons);
+    // Format lessons
+    const lessonLines = selected.map((l) => {
+        const titleMatch = l.content.match(/## Lesson: (.+)/);
+        const typeMatch = l.content.match(/\*\*Type:\*\* (\w+)/);
+        const severityMatch = l.content.match(/\*\*Severity:\*\* (\w+)/);
+        const title = titleMatch ? titleMatch[1] : l.content.slice(0, 150);
+        const meta = [severityMatch?.[1], typeMatch?.[1]].filter(Boolean).join(", ");
+        return `- ${title}${meta ? ` (${meta})` : ""}`;
+    });
+    // Format project index
+    const projectIndex = data.index.projects.map(p => `${p.name}: ${p.count}`);
+    // Build block
+    const START_MARKER = "<!-- HICORTEX-LEARNINGS:START -->";
+    const END_MARKER = "<!-- HICORTEX-LEARNINGS:END -->";
+    const blockParts = [START_MARKER, "## Hicortex Memory"];
+    blockParts.push("", "You have access to shared long-term memory across all agents and sessions.", "BEFORE making decisions, search memory: `hicortex_search` for prior decisions on the same topic.", "Use `hicortex_context` at session start for recent project state.");
+    if (lessonLines.length > 0) {
+        blockParts.push("", "### Lessons (updated nightly)");
+        blockParts.push(...lessonLines);
+    }
+    else {
+        blockParts.push("", "### Getting Started");
+        blockParts.push("- Search past decisions with `hicortex_search` before starting work");
+        blockParts.push("- Save important decisions with `hicortex_ingest`");
+        blockParts.push("- Lessons will appear here after the first nightly run");
+    }
+    if (projectIndex.length > 0) {
+        blockParts.push("", "### Memory Index");
+        blockParts.push(projectIndex.join(" | "));
+        blockParts.push(`${data.index.total} memories, ${data.index.lessonCount} lessons, ${data.index.sourceCount} agents. Search with \`hicortex_search\`.`);
+    }
+    blockParts.push(END_MARKER);
+    const block = blockParts.join("\n");
+    // Write to CLAUDE.md
+    const { readFileSync, writeFileSync, mkdirSync } = await import("node:fs");
+    const { join, dirname } = await import("node:path");
+    const { homedir } = await import("node:os");
+    const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
+    let content = "";
+    try {
+        content = readFileSync(claudeMdPath, "utf-8");
+    }
+    catch { }
+    const startIdx = content.indexOf(START_MARKER);
+    const endIdx = content.indexOf(END_MARKER);
+    if (startIdx !== -1 && endIdx !== -1) {
+        content = content.slice(0, startIdx) + block + content.slice(endIdx + END_MARKER.length);
+    }
+    else {
+        if (content.length > 0 && !content.endsWith("\n"))
+            content += "\n";
+        if (content.length > 0)
+            content += "\n";
+        content += block + "\n";
+    }
+    mkdirSync(dirname(claudeMdPath), { recursive: true });
+    writeFileSync(claudeMdPath, content);
+    console.log(`[hicortex] CLAUDE.md updated: ${lessonLines.length} lessons, ${data.index.total} memories indexed`);
+}

package/dist/prompts.js

@@ -134,6 +134,8 @@ RULES:
   tool configurations, API discoveries, project milestones
 - PRIORITIZE Corrections & Rejections — these are high-value signals for learning
   what the user does NOT want. Even a single "no" or style correction is worth extracting.
+- Strong language or profanity from the user is a high-intensity signal — it indicates
+  the correction matters deeply. Note the intensity in the extraction.
 - PRIVACY CLASSIFICATION (one of):
   - PUBLIC: general tech knowledge, open-source patterns, publicly available info
   - WORK: project-specific decisions, architecture choices, client/business context

package/dist/status.js

@@ -112,9 +112,43 @@ async function runStatus() {
     const lastRunPath = (0, node_path_1.join)(HICORTEX_HOME, "nightly-last-run.txt");
     try {
         const ts = (0, node_fs_1.readFileSync)(lastRunPath, "utf-8").trim();
-        console.log(`  Last run:   ${ts}`);
+        const lastRun = new Date(ts);
+        if (isNaN(lastRun.getTime())) {
+            console.log(`  Last run:   ${ts} (invalid timestamp)`);
+        }
+        else {
+            const STALE_THRESHOLD_HOURS = 30;
+            const ageHours = Math.round((Date.now() - lastRun.getTime()) / (60 * 60 * 1000));
+            const ageStr = ageHours < 1 ? "just now" : ageHours < 24 ? `${ageHours}h ago` : `${Math.round(ageHours / 24)}d ago`;
+            console.log(`  Last run:   ${ts} (${ageStr})`);
+            // Show staleness warning if missed a night
+            if (ageHours > STALE_THRESHOLD_HOURS) {
+                console.log(`  ⚠ Nightly pipeline hasn't run in ${ageHours}h. Check: hicortex nightly --dry-run`);
+            }
+        }
     }
     catch {
-        console.log("  Last run:   never");
+        console.log("  Last run:   never (run: hicortex nightly)");
+    }
+    // Distillation stats (if DB exists)
+    if (dbExists) {
+        const TOP_SOURCES_LIMIT = 5;
+        try {
+            const { initDb } = await import("./db.js");
+            const db2 = initDb(dbPath);
+            // Count memories by source
+            const rows = db2.prepare(`SELECT source_agent, COUNT(*) as cnt FROM memories GROUP BY source_agent ORDER BY cnt DESC LIMIT ${TOP_SOURCES_LIMIT}`).all();
+            if (rows.length > 0) {
+                console.log("  Sources:");
+                for (const r of rows) {
+                    const agent = r.source_agent || "unknown";
+                    console.log(`    ${agent}: ${r.cnt}`);
+                }
+            }
+            db2.close();
+        }
+        catch (err) {
+            console.log(`  Sources:    (error: ${err instanceof Error ? err.message : String(err)})`);
+        }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Human-like memory for self-improving AI agents. Automatic capturing, nightly reflection, and cross-agent learning. Works with Claude Code and OpenClaw.",
   "main": "dist/index.js",
   "bin": {
@@ -11,6 +11,17 @@
       "./dist/index.js"
     ]
   },
+  "keywords": [
+    "mcp-server",
+    "memory",
+    "ai-agents",
+    "agent-memory",
+    "self-improving",
+    "claude-code",
+    "openclaw",
+    "vector-search",
+    "nightly-distillation"
+  ],
   "types": "dist/index.d.ts",
   "files": [
     "dist/",