@gamaze/hicortex 0.7.1 → 0.10.1

package/README.md

@@ -2,7 +2,7 @@
 
 Your agents learn from every session — successes and mistakes. Hicortex captures experiences, distills lessons, and applies them automatically. Connect multiple agents to shared memory and they improve together, overnight.
 
-Works with **Claude Code**, **Pi**, **OpenClaw**, and any MCP-compatible agent.
+Works with **Hermes**, **OpenClaw**, **Claude Code**, **Pi**, and any MCP-compatible agent.
 
 **Website:** [hicortex.gamaze.com](https://hicortex.gamaze.com) · **Docs:** [hicortex.gamaze.com/docs](https://hicortex.gamaze.com/docs/)
 
@@ -12,7 +12,7 @@ Works with **Claude Code**, **Pi**, **OpenClaw**, and any MCP-compatible agent.
 npx @gamaze/hicortex init
 ```
 
-Detects your environment, installs a persistent MCP server daemon, auto-detects Ollama/Claude CLI/API keys, and registers with Claude Code. One command.
+Detects available LLM candidates (Ollama models, Claude CLI, API keys from env/Hermes/.env/Claude Code settings/OpenClaw), presents a numbered list, and asks you to choose. Installs a persistent MCP server daemon and registers with Claude Code. One command.
 
 ## Install — Client Mode (multi-client)
 
@@ -20,28 +20,51 @@ Detects your environment, installs a persistent MCP server daemon, auto-detects
 npx @gamaze/hicortex init --server https://your-server.example.com
 ```
 
-Connects to a remote Hicortex server. Sessions are distilled locally (privacy), memories are sent to the shared server. No local database needed.
+Connects to a remote Hicortex server. No local database or local LLM needed. The nightly job denoises sessions locally (no LLM — just strips tool noise), then POSTs the denoised text to the server. The server distills, embeds, and stores. Raw session content never leaves the machine.
+
+## Install — Hermes
+
+The Hermes plugin is a recall-only adapter: it injects fresh lessons every turn and exposes the full 8-tool memory surface, backed by a Hicortex server (local or remote). Capture happens automatically — the server machine's nightly job reads each Hermes profile's `state.db`.
+
+```bash
+# 1. Install the plugin (prompts for server URL + auth token; leave empty for a local server)
+hermes plugins install gamaze-labs/hicortex-hermes-plugin
+
+# 2. Activate it as the memory provider, then restart your gateway
+hermes memory setup hicortex
+hermes gateway restart
+```
+
+Find the server's auth token with `hicortex status` on the server machine.
 
 ## Install — OpenClaw
 
+The OC plugin is a recall-only adapter (lessons + memory tools): it requires a Hicortex server. Run the server once on the same machine (or point the plugin at a remote server via `serverUrl` config). Capture happens automatically — the machine's Hicortex nightly reads OpenClaw's session files (`~/.openclaw/agents/*/sessions/`) alongside Claude Code and Hermes sessions.
+
 ```bash
+# 1. Start the Hicortex server (once, on the machine running OC)
+npx @gamaze/hicortex init
+
+# 2. Install the plugin
 openclaw plugins install @gamaze/hicortex
 openclaw gateway restart
 ```
 
+The plugin connects to `http://127.0.0.1:8787` by default. For a remote server, add `serverUrl` and `authToken` (find the token via `hicortex status` on the server) to the plugin config in `~/.openclaw/openclaw.json`.
+
 ## Requirements
 
 - Node.js 18+
-- LLM: Ollama 9b+ (recommended), Claude CLI, or API key (Anthropic, OpenAI, etc.)
-- ~500MB disk for database + embedding model
+- **Server mode:** LLM required — Ollama 9b+ (recommended), Claude CLI, or API key (Anthropic, OpenAI, etc.). ~500MB disk for database + embedding model.
+- **Client mode:** No local LLM needed. Node.js 18+ and network access to the server are sufficient.
+- **OC plugin:** Requires a running Hicortex server. No local LLM, database, or embedder in the plugin itself.
 
 ## What Happens Automatically
 
 | When | What | How |
 |------|------|-----|
-| Agent start | Recent lessons injected into context | CLAUDE.md / EXPERIENCE.md / OC hook |
-| Agent end | Conversation captured | CC + Pi: nightly transcript scan / OC: hook |
-| Nightly | Distill → score → reflect → link → inject | Automatic pipeline |
+| Agent start | Recent lessons fetched fresh and injected into context | CC SessionStart hook (calls `hicortex lessons-context`) / Hermes plugin prefetch / OC `before_agent_start` hook |
+| Nightly | Denoise sessions → POST /distill → server distills + embeds + stores → consolidate (score, reflect, link, decay) | Automatic pipeline — no manual steps |
 
 ## Agent Tools (MCP)
 
@@ -64,7 +87,8 @@ Skills: `/learn` to save explicit learnings.
 npx @gamaze/hicortex server                    # Start MCP server (port 8787)
 npx @gamaze/hicortex init                      # Set up server mode
 npx @gamaze/hicortex init --server <url>       # Set up client mode
-npx @gamaze/hicortex nightly                   # Run distill + consolidate
+npx @gamaze/hicortex nightly                   # Run distill + consolidate (full nightly)
+npx @gamaze/hicortex nightly --capture-only    # Capture only, skip consolidation (safe for sub-daily runs)
 npx @gamaze/hicortex nightly --dry-run         # Preview without changes
 npx @gamaze/hicortex status                    # Show config, DB stats
 npx @gamaze/hicortex uninstall                 # Remove CC integration (keeps DB)
@@ -77,8 +101,8 @@ npx @gamaze/hicortex uninstall                 # Remove CC integration (keeps DB
   ┌──────────┐              ┌──────────────┐          ┌──────────┐
   │CC sessions│              │   Shared DB   │          │CC sessions│
   │    ↓      │  POST        │              │  POST    │    ↓      │
-  │ Distill   │──/ingest───→│  Embed+Store  │←/ingest──│ Distill   │
-  │ (local)   │              │      ↓       │          │ (local)   │
+  │ Denoise   │──/distill──→│Distill+Store  │←/distill─│ Denoise   │
+  │ (no LLM)  │              │      ↓       │          │ (no LLM)  │
   │           │  MCP         │ Consolidate  │   MCP    │           │
   │    CC    ←│──(search)───│ (score,link,  │──(search)→│   CC     │
   │           │              │  reflect)    │          │           │
@@ -99,15 +123,16 @@ Config at `~/.hicortex/config.json`. Created by `init`. Key options:
 |-------|-------------|
 | `mode` | `"server"` (default) or `"client"` |
 | `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 |
-| `licenseKey` | License key for higher tiers |
-| `lessonTarget` | Injection target file (default: `~/.claude/CLAUDE.md`) |
-| `moduleIndexTokenBudget` | Max tokens for domain index in injection (default: 500) |
+| `llmModel` | Model for importance scoring (server mode) |
+| `distillModel` | Model for session distillation — 9b+ recommended (server mode) |
+| `distillBaseUrl` | Separate Ollama instance for distillation (server mode) |
+| `distillFallback` | `"strict"` (default) — abort on remote distill failure, retry next run; `"local"` — fall back to base model (lower quality, 0.9.0 behaviour) |
+| `reflectModel` | Model for nightly reflection — largest available (server mode) |
+| `reflectBaseUrl` | Separate Ollama instance for reflection (server mode) |
+| `authToken` | Bearer token for endpoint auth. Generated on first `init` in server mode. Find the active token with `hicortex status` or in `~/.hicortex/config.json`. |
+| `licenseKey` | Commercial license key (optional; for display in `hicortex status`) |
+| `moduleIndexTokenBudget` | Max tokens for domain index in lessons context (default: 500) |
+| `nightlyHour` | Local hour (0–23) for the nightly job installed by `init` (defaults: client 2, server 3). Applied on fresh installs; existing schedules are never overwritten |
 | `telemetry` | Anonymous usage telemetry, `false` to opt out |
 
 Full docs: [hicortex.gamaze.com/docs/configuration.html](https://hicortex.gamaze.com/docs/configuration.html)
@@ -117,20 +142,19 @@ Full docs: [hicortex.gamaze.com/docs/configuration.html](https://hicortex.gamaze
 | Endpoint | Method | Auth | Description |
 |----------|--------|------|-------------|
 | `/health` | GET | No | Server status, memory count, version |
-| `/ingest` | POST | Yes | Accept pre-distilled memories from clients |
+| `/distill` | POST | Yes | Canonical capture endpoint (0.9.0+). Accepts denoised session text (`text` string or `messages` array), distills server-side, stores. Used by both server-mode and client-mode nightly jobs. |
+| `/search` | GET | Yes | Semantic memory search |
+| `/context` | GET | Yes | Recent context memories |
+| `/lessons` | GET | Yes | Lessons + memory index (used by CC SessionStart hook) |
+| `/ingest` | POST | Yes | Legacy: accept a single pre-distilled memory from older clients |
 | `/sse` | GET | Yes | MCP SSE stream for agent connections |
 | `/messages` | POST | Yes | MCP message endpoint |
 
-## Pricing
+## License
 
-| Tier | Price | Memories | Clients |
-|------|-------|----------|---------|
-| Free | $0 | 250 | Unlimited (trial) |
-| Pro | $9/month | Unlimited | Single |
-| Team | $29/month | Unlimited | Unlimited |
-| Lifetime | $149 | Unlimited | Single |
+**Personal and noncommercial use is free** under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0). Commercial use (for-profit businesses, client work, revenue-generating products) requires a per-seat license — see [hicortex.gamaze.com](https://hicortex.gamaze.com).
 
-[hicortex.gamaze.com](https://hicortex.gamaze.com)
+Versions ≤ 0.7.1 published to npm remain MIT-licensed.
 
 ## Uninstall
 
@@ -147,19 +171,26 @@ Optional config (add to plugin entry in `~/.openclaw/openclaw.json`):
 
 | Field | Default | Description |
 |-------|---------|-------------|
-| `licenseKey` | _(none)_ | License key. Free tier (250 memories) without key. |
-| `llmBaseUrl` | _(auto)_ | Override LLM base URL |
-| `llmApiKey` | _(auto)_ | Override LLM API key |
-| `llmModel` | _(auto)_ | Override model for scoring and distillation |
-| `reflectModel` | _(auto)_ | Override model for nightly reflection |
-| `consolidateHour` | `2` | Hour (0-23, local time) for nightly consolidation |
-| `dbPath` | _(auto)_ | Custom database path |
+| `serverUrl` | `http://127.0.0.1:8787` | Hicortex server URL. Change for remote servers. |
+| `authToken` | _(none)_ | Bearer token. Localhost bypasses auth; required for remote servers. Get the token from `hicortex status` on the server. |
+| `licenseKey` | _(none)_ | Commercial license key. Optional; only affects the display in `hicortex status`. |
+
+## LLM Configuration
 
-For CC, set environment variables: `ANTHROPIC_API_KEY` (auto-detected), or `HICORTEX_LLM_BASE_URL` + `HICORTEX_LLM_API_KEY` + `HICORTEX_LLM_MODEL` for custom providers.
+LLM selection is **user-controlled**: `npx @gamaze/hicortex init` detects candidates and asks you to choose. Nothing is silently auto-applied at runtime.
+
+| Method | Config key | Notes |
+|--------|-----------|-------|
+| Ollama (local) | `llmBackend: "ollama"` | Set by init; no API key needed |
+| Claude CLI | `llmBackend: "claude-cli"` | Uses CC subscription; no API key needed |
+| Custom provider | `llmBaseUrl` + `llmApiKey` | Any OpenAI-compatible endpoint |
+| Hicortex env vars | `HICORTEX_LLM_BASE_URL` + `HICORTEX_LLM_API_KEY` | Override at runtime |
+
+If no LLM is configured, the server starts in **recall-only mode**: search, lessons, and context work; `/distill` and consolidation are disabled. Run `npx @gamaze/hicortex init` to configure.
 
 ## Database
 
-Canonical location: `~/.hicortex/hicortex.db`. Existing OC installations at `~/.openclaw/data/hicortex.db` are automatically migrated on upgrade.
+Canonical location: `~/.hicortex/hicortex.db`. The OC plugin no longer owns its own database — it is a thin client to the server. Previously, OC installations at `~/.openclaw/data/hicortex.db` were migrated automatically on upgrade; this migration path remains in the server's `resolveDbPath` for any pre-0.10.0 installations.
 
 ## Development
 
@@ -174,7 +205,9 @@ npm test
 
 **Tools not visible to agent (OC):** The plugin auto-adds tools to `tools.allow` on startup. Restart the gateway after install.
 
-**LLM auto-config failed:** Check logs for `[hicortex] WARNING`. Add `llmBaseUrl` to plugin config or set `HICORTEX_LLM_BASE_URL` env var.
+**OC plugin: "Server unreachable":** The plugin requires a running Hicortex server. Run `npx @gamaze/hicortex init` on the same machine, or set `serverUrl` in the plugin config to point at a remote server.
+
+**LLM auto-config failed:** Check logs for `[hicortex] WARNING`. Add `llmBaseUrl` to plugin config or set `HICORTEX_LLM_BASE_URL` env var (applies to server setup, not the OC plugin itself).
 
 **No lessons generated:** Reflection requires an LLM. Check that your provider is accessible and has sufficient quota.
 

package/dist/claude-md.d.ts

@@ -1,29 +1,17 @@
 /**
- * CLAUDE.md lesson injection — manages the Hicortex Learnings block.
+ * CLAUDE.md block management — removeLessonsBlock only (0.9.0+).
  *
- * 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)
+ * Lesson injection was removed in 0.9.0: lessons are now fetched at query time
+ * via the CC SessionStart hook (`hicortex lessons-context`) and by the Hermes
+ * plugin's prefetch/system_prompt_block. File-based injection caused EPERM
+ * errors on macOS, stale blocks, and unwinnable multi-file bookkeeping.
  *
- * Idempotent: calling twice with the same data produces the same file.
+ * removeLessonsBlock is kept so init/uninstall can strip the old static block
+ * from machines upgrading from 0.8.0 and earlier.
  */
-import type Database from "better-sqlite3";
-/**
- * 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.
- */
-export declare function injectLessons(db: Database.Database, options?: {
-    claudeMdPath?: string;
-    stateDir?: string;
-    project?: string;
-}): Promise<{
-    lessonsCount: number;
-    path: string;
-}>;
 /**
  * Remove the Hicortex Learnings block from CLAUDE.md.
- * Used by the uninstall command.
+ * Used by init (migration from 0.8.0) and uninstall.
+ * Returns true if a block was found and removed.
  */
 export declare function removeLessonsBlock(claudeMdPath?: string): boolean;

package/dist/claude-md.js

@@ -1,259 +1,27 @@
 "use strict";
 /**
- * CLAUDE.md lesson injection — manages the Hicortex Learnings block.
+ * CLAUDE.md block management — removeLessonsBlock only (0.9.0+).
  *
- * 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)
+ * Lesson injection was removed in 0.9.0: lessons are now fetched at query time
+ * via the CC SessionStart hook (`hicortex lessons-context`) and by the Hermes
+ * plugin's prefetch/system_prompt_block. File-based injection caused EPERM
+ * errors on macOS, stale blocks, and unwinnable multi-file bookkeeping.
  *
- * Idempotent: calling twice with the same data produces the same file.
+ * removeLessonsBlock is kept so init/uninstall can strip the old static block
+ * from machines upgrading from 0.8.0 and earlier.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.injectLessons = injectLessons;
 exports.removeLessonsBlock = removeLessonsBlock;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
-const storage = __importStar(require("./storage.js"));
-const features_js_1 = require("./features.js");
-const extensions_js_1 = require("./extensions.js");
-const state_js_1 = require("./state.js");
 const START_MARKER = "<!-- HICORTEX-LEARNINGS:START -->";
 const END_MARKER = "<!-- HICORTEX-LEARNINGS:END -->";
 const DEFAULT_CLAUDE_MD = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "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.
- */
-async function injectLessons(db, options = {}) {
-    const claudeMdPath = options.claudeMdPath ?? DEFAULT_CLAUDE_MD;
-    // Determine limits based on license
-    const maxLessons = (0, features_js_1.lessonsLimit)();
-    // Load MODULE_INDEX from state for domain-aware selection
-    const state = (0, state_js_1.loadState)(options.stateDir);
-    const moduleIndex = state.moduleIndex;
-    // --- Lessons ---
-    const lessons = storage.getLessons(db, 30, options.project);
-    const selected = await (0, extensions_js_1.getLessonSelector)().select(lessons, {
-        maxLessons,
-        project: options.project,
-        moduleIndex,
-    });
-    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})` : ""}`;
-    });
-    // --- Memory Index ---
-    const tokenBudget = readModuleIndexTokenBudget();
-    const indexLines = buildModuleIndex(db, tokenBudget, moduleIndex);
-    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("", "### Lessons (updated nightly)");
-        blockParts.push(...lessonLines);
-    }
-    // Project context
-    if (projectContext.length > 0) {
-        blockParts.push("", `### This Project (${currentProject})`);
-        blockParts.push(...projectContext);
-    }
-    // Memory index
-    if (indexLines.length > 0) {
-        blockParts.push("", "### Memory Index");
-        blockParts.push(...indexLines);
-        blockParts.push(`${totalCount} memories, ${lessonCount} lessons, ${sourceCount} agents. Search with \`hicortex_search\`.`);
-    }
-    blockParts.push(END_MARKER);
-    const block = blockParts.join("\n");
-    // --- Write ---
-    let content = "";
-    try {
-        content = (0, node_fs_1.readFileSync)(claudeMdPath, "utf-8");
-    }
-    catch {
-        // File doesn't exist — will create it
-    }
-    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";
-    }
-    (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 };
-}
-const DEFAULT_MODULE_INDEX_TOKEN_BUDGET = 500;
-// BPE tokenizers average 3.5-4.5 chars/token for English prose. 4 is conservative.
-const CHARS_PER_TOKEN = 4;
-/**
- * Read moduleIndexTokenBudget from config.json. Defaults to 500.
- */
-function readModuleIndexTokenBudget() {
-    try {
-        const configPath = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex", "config.json");
-        const config = JSON.parse((0, node_fs_1.readFileSync)(configPath, "utf-8"));
-        return typeof config.moduleIndexTokenBudget === "number"
-            ? config.moduleIndexTokenBudget
-            : DEFAULT_MODULE_INDEX_TOKEN_BUDGET;
-    }
-    catch {
-        return DEFAULT_MODULE_INDEX_TOKEN_BUDGET;
-    }
-}
-/**
- * Build structured MODULE_INDEX block for injection.
- * Uses domain-grouped format if MODULE_INDEX is available,
- * falls back to flat "project: count" format otherwise.
- */
-function buildModuleIndex(db, tokenBudget, moduleIndex) {
-    if (moduleIndex && moduleIndex.domains.length > 0) {
-        const charBudget = tokenBudget * CHARS_PER_TOKEN;
-        let charCount = 0;
-        const lines = [];
-        for (const domain of moduleIndex.domains) {
-            const kwStr = domain.keywords.length > 0
-                ? `: ${domain.keywords.join(", ")}`
-                : "";
-            const domainLine = `${domain.name} (${domain.memoryCount} memories, ${domain.lessonCount} lessons)${kwStr}`;
-            const projectLine = `  ${domain.projects.join(" | ")}`;
-            const blockChars = domainLine.length + projectLine.length + 2; // +2 for newlines
-            if (charCount + blockChars > charBudget && lines.length > 0)
-                break;
-            lines.push(domainLine);
-            lines.push(projectLine);
-            charCount += blockChars;
-        }
-        return lines;
-    }
-    // Fallback: flat project index (OSS default)
-    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}`).join(" | ")];
-    }
-    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.
+ * Used by init (migration from 0.8.0) and uninstall.
+ * Returns true if a block was found and removed.
  */
 function removeLessonsBlock(claudeMdPath = DEFAULT_CLAUDE_MD) {
     let content;

package/dist/cli.d.ts

@@ -5,8 +5,9 @@
  * Commands:
  *   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
+ *   nightly    Run capture + consolidate (manual trigger)
+ *              nightly --capture-only  Capture only, skip consolidation
+ *              nightly --status        Show nightly pipeline health check
  *   status     Show config, DB stats, adapter status
  *   uninstall  Clean removal of CC integration
  */

package/dist/cli.js

@@ -6,8 +6,9 @@
  * Commands:
  *   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
+ *   nightly    Run capture + consolidate (manual trigger)
+ *              nightly --capture-only  Capture only, skip consolidation
+ *              nightly --status        Show nightly pipeline health check
  *   status     Show config, DB stats, adapter status
  *   uninstall  Clean removal of CC integration
  */
@@ -50,8 +51,9 @@ switch (command) {
         }
         else {
             const dryRun = args.includes("--dry-run");
+            const captureOnly = args.includes("--capture-only");
             import("./nightly.js").then(({ runNightly }) => {
-                runNightly({ dryRun }).catch((err) => {
+                runNightly({ dryRun, captureOnly }).catch((err) => {
                     console.error("[hicortex] Nightly pipeline failed:", err);
                     process.exit(1);
                 });
@@ -75,24 +77,40 @@ switch (command) {
             });
         });
         break;
+    case "lessons-context":
+        // CC SessionStart hook: fetch lessons from the configured server and print
+        // a Markdown block to stdout. Fail-soft — any error = silent exit 0 so a
+        // broken hook never blocks a CC session.
+        import("./lessons-context.js").then(({ fetchLessonsContext }) => {
+            fetchLessonsContext()
+                .then((block) => {
+                if (block)
+                    process.stdout.write(block + "\n");
+                process.exit(0);
+            })
+                .catch(() => process.exit(0));
+        }).catch(() => process.exit(0));
+        break;
     default:
         console.log(`Hicortex — Human-like memory for self-improving AI agents
 
 Usage: hicortex <command> [options]
 
 Commands:
-  server     Start the MCP HTTP/SSE server (server mode)
-  init       Set up Hicortex (server mode, local DB + daemon)
-  init --server <url>  Set up as client (remote server, local distillation)
-  nightly    Run nightly distill + consolidate + inject
-  status     Show current configuration and stats
-  uninstall  Remove CC integration (preserves DB)
+  server          Start the MCP HTTP/SSE server (server mode)
+  init            Set up Hicortex (server mode, local DB + daemon)
+  init --server <url>  Set up as client (remote server)
+  nightly         Run nightly denoise + capture + consolidate
+  lessons-context Fetch lessons and print Markdown to stdout (CC SessionStart hook)
+  status          Show current configuration and stats
+  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
-  nightly --status     Show nightly pipeline health
+  nightly --dry-run         Preview without changes
+  nightly --capture-only    Capture only, skip consolidation (safe to run multiple times/day)
+  nightly --status          Show nightly pipeline health
 
 Examples:
   npx @gamaze/hicortex server

package/dist/consolidate.js

@@ -268,13 +268,6 @@ async function stageReflection(db, memories, llm, budget, embedFn, dryRun) {
                 minor: 0.6,
             };
             try {
-                // Check memory cap before storing lesson
-                if ((0, features_js_1.memoryCapReached)(storage.countMemories(db))) {
-                    console.log(`[hicortex] Free tier limit (${(0, features_js_1.maxMemoriesAllowed)()} memories). ` +
-                        `Existing memories and lessons still work. New lessons won't be saved. ` +
-                        `Upgrade for unlimited usage: https://hicortex.gamaze.com/`);
-                    break;
-                }
                 const embedding = await embedFn(content);
                 // Contradiction check: find semantically similar existing lessons.
                 // If a very similar lesson exists, ask the LLM whether the new one

package/dist/db.js

@@ -226,6 +226,30 @@ const MIGRATIONS = [
             db.exec("CREATE INDEX IF NOT EXISTS idx_memories_domain ON memories(domain)");
         },
     },
+    {
+        version: 4,
+        name: "unique_source_session",
+        up: (db) => {
+            // De-duplicate any pre-existing source_session values (e.g. from the
+            // /ingest + /distill race before this migration): keep the oldest row per
+            // source_session, NULL the rest so they lose their dedup key (the memory
+            // itself is preserved). Then add a UNIQUE partial index so the server can
+            // idempotently re-distill a segment without double-inserting.
+            db.exec(`
+        UPDATE memories SET source_session = NULL
+        WHERE rowid NOT IN (
+          SELECT MIN(rowid) FROM memories
+          WHERE source_session IS NOT NULL
+          GROUP BY source_session
+        )
+        AND source_session IS NOT NULL
+      `);
+            db.exec(`
+        CREATE UNIQUE INDEX IF NOT EXISTS idx_memories_source_session_unique
+          ON memories(source_session) WHERE source_session IS NOT NULL
+      `);
+        },
+    },
 ];
 /**
  * Run all pending migrations against the database.