@gamaze/hicortex 0.4.3 → 0.4.5

package/dist/nightly.js

@@ -55,9 +55,10 @@ const distiller_js_1 = require("./distiller.js");
 const consolidate_js_1 = require("./consolidate.js");
 const transcript_reader_js_1 = require("./transcript-reader.js");
 const claude_md_js_1 = require("./claude-md.js");
-const license_js_1 = require("./license.js");
+const features_js_1 = require("./features.js");
+const extensions_js_1 = require("./extensions.js");
+const state_js_1 = require("./state.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");
 function readNightlyConfig(stateDir) {
     try {
         const configPath = (0, node_path_1.join)(stateDir, "config.json");
@@ -78,25 +79,24 @@ function readConfigLicenseKey(stateDir) {
         return undefined;
     }
 }
-function readLastRun() {
-    try {
-        const ts = (0, node_fs_1.readFileSync)(LAST_RUN_PATH, "utf-8").trim();
-        const d = new Date(ts);
-        if (!isNaN(d.getTime()))
-            return d;
-    }
-    catch {
-        // No file — first run
-    }
-    return new Date(0); // Process everything
+function readLastRun(stateDir = HICORTEX_HOME) {
+    const ts = (0, state_js_1.loadState)(stateDir).lastNightly;
+    if (!ts)
+        return new Date(0); // First run — process everything
+    const d = new Date(ts);
+    return isNaN(d.getTime()) ? new Date(0) : d;
 }
-function writeLastRun() {
-    (0, node_fs_1.mkdirSync)(HICORTEX_HOME, { recursive: true });
-    (0, node_fs_1.writeFileSync)(LAST_RUN_PATH, new Date().toISOString());
+function writeLastRun(stateDir = HICORTEX_HOME) {
+    (0, state_js_1.updateState)((s) => {
+        s.lastNightly = new Date().toISOString();
+        return s;
+    }, stateDir);
 }
 async function runNightly(options = {}) {
     const dryRun = options.dryRun ?? false;
     const stateDir = options.stateDir ?? HICORTEX_HOME;
+    // One-time migration of legacy state files (no-op if state.json exists)
+    (0, state_js_1.migrateLegacyState)(stateDir);
     // Check mode: client or server
     const savedConfig = readNightlyConfig(stateDir);
     if (savedConfig?.mode === "client") {
@@ -109,9 +109,9 @@ async function runNightly(options = {}) {
     // Init DB
     const db = (0, db_js_1.initDb)(dbPath);
     try {
-        // License: read from config file or env var
+        // License: read from config file or env var, init feature cache
         const licenseKey = readConfigLicenseKey(stateDir) ?? process.env.HICORTEX_LICENSE_KEY;
-        await (0, license_js_1.validateLicense)(licenseKey, stateDir);
+        await (0, features_js_1.initFeatures)(licenseKey, stateDir);
         // Init LLM: check config.json first, then auto-detect
         let llmConfig;
         const savedConfig = readNightlyConfig(stateDir);
@@ -182,7 +182,6 @@ 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) {
@@ -197,8 +196,8 @@ async function runNightly(options = {}) {
                 continue;
             }
             // Check cap before distilling
-            if (features.maxMemories > 0 && storage.countMemories(db) >= features.maxMemories) {
-                console.log(`[hicortex]   Free tier limit (${features.maxMemories} memories). Skipping new ingestion. ` +
+            if ((0, features_js_1.memoryCapReached)(storage.countMemories(db))) {
+                console.log(`[hicortex]   Free tier limit (${(0, features_js_1.maxMemoriesAllowed)()} memories). Skipping new ingestion. ` +
                     `Upgrade: https://hicortex.gamaze.com/`);
                 break;
             }
@@ -238,7 +237,7 @@ async function runNightly(options = {}) {
         }
         // Step 4: Inject lessons into CLAUDE.md
         if (!dryRun) {
-            const injection = (0, claude_md_js_1.injectLessons)(db, { stateDir });
+            const injection = await (0, claude_md_js_1.injectLessons)(db, { stateDir });
             console.log(`[hicortex] CLAUDE.md updated: ${injection.lessonsCount} lessons at ${injection.path}`);
         }
         // Step 5: Update last-run timestamp
@@ -427,8 +426,8 @@ async function injectLessonsFromServer(serverUrl, authToken) {
         return;
     }
     const data = await resp.json();
-    const maxLessons = 10;
-    const selected = data.lessons.slice(0, maxLessons);
+    const maxLessons = (0, features_js_1.lessonsLimit)();
+    const selected = await (0, extensions_js_1.getLessonSelector)().select(data.lessons, { maxLessons });
     // Format lessons
     const lessonLines = selected.map((l) => {
         const titleMatch = l.content.match(/## Lesson: (.+)/);
@@ -462,14 +461,11 @@ async function injectLessonsFromServer(serverUrl, authToken) {
     }
     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");
+    // Write to CLAUDE.md (uses fs/path/os already imported at top of file)
+    const claudeMdPath = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");
     let content = "";
     try {
-        content = readFileSync(claudeMdPath, "utf-8");
+        content = (0, node_fs_1.readFileSync)(claudeMdPath, "utf-8");
     }
     catch { }
     const startIdx = content.indexOf(START_MARKER);
@@ -484,7 +480,7 @@ async function injectLessonsFromServer(serverUrl, authToken) {
             content += "\n";
         content += block + "\n";
     }
-    mkdirSync(dirname(claudeMdPath), { recursive: true });
-    writeFileSync(claudeMdPath, content);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(claudeMdPath), { recursive: true });
+    (0, node_fs_1.writeFileSync)(claudeMdPath, content);
     console.log(`[hicortex] CLAUDE.md updated: ${lessonLines.length} lessons, ${data.index.total} memories indexed`);
 }

package/dist/state.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Centralized state management — single ~/.hicortex/state.json file.
+ *
+ * Replaces 4 separate state files used by previous versions:
+ *   - nightly-last-run.txt   → state.lastNightly
+ *   - last-consolidated.txt  → state.lastConsolidated
+ *   - tier.json              → state.tier
+ *   - license-validated.txt  → state.tier.validatedAt (subsumed)
+ *
+ * Why one file:
+ *   - Atomic writes (write to temp + rename)
+ *   - Easier debugging (one file to inspect)
+ *   - No filesystem chatter from multiple separate writes
+ *   - Single migration path going forward
+ *
+ * Note: ~/.hicortex/config.json is intentionally NOT merged here. Config is
+ * user-edited and tracked separately from machine state.
+ */
+import type { LicenseInfo } from "./types.js";
+/** Persisted tier information — reflects the last successful validation. */
+export interface PersistedTier {
+    /** Tier name from the validation API response. */
+    tier: LicenseInfo["tier"];
+    /** ISO timestamp of when this tier was validated against the API. */
+    validatedAt: string;
+    /** Cached features object — used by features.ts and offline fallback. */
+    features: LicenseInfo["features"];
+}
+export interface HicortexState {
+    /** ISO timestamp of the last nightly transcript scan watermark. */
+    lastNightly?: string;
+    /** ISO timestamp of the last consolidation pipeline run. */
+    lastConsolidated?: string;
+    /** Last-known license tier (replaces tier.json + license-validated.txt). */
+    tier?: PersistedTier;
+}
+/**
+ * Load the state file. Returns an empty state if the file is missing
+ * or corrupted (callers should handle missing fields with defaults).
+ */
+export declare function loadState(stateDir?: string): HicortexState;
+/**
+ * Atomically write the state file. Uses write-to-temp + rename so a crash
+ * during write cannot leave a half-written state.json on disk.
+ */
+export declare function saveState(state: HicortexState, stateDir?: string): void;
+/**
+ * Read-modify-write helper. The updater receives the current state and
+ * returns the next state (or void if it mutates in place).
+ */
+export declare function updateState(updater: (state: HicortexState) => HicortexState | void, stateDir?: string): HicortexState;
+/**
+ * One-time migration from the 4 legacy state files to state.json.
+ *
+ * Behaviour:
+ *   1. If state.json already exists, do nothing (and clean up any leftover
+ *      legacy files from a previously interrupted migration).
+ *   2. Otherwise, read whichever legacy files exist, build a HicortexState,
+ *      write state.json, and delete the legacy files.
+ *
+ * Idempotent: safe to call on every boot.
+ * Returns true if migration ran, false if state.json already existed.
+ */
+export declare function migrateLegacyState(stateDir?: string): boolean;

package/dist/state.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Centralized state management — single ~/.hicortex/state.json file.
+ *
+ * Replaces 4 separate state files used by previous versions:
+ *   - nightly-last-run.txt   → state.lastNightly
+ *   - last-consolidated.txt  → state.lastConsolidated
+ *   - tier.json              → state.tier
+ *   - license-validated.txt  → state.tier.validatedAt (subsumed)
+ *
+ * Why one file:
+ *   - Atomic writes (write to temp + rename)
+ *   - Easier debugging (one file to inspect)
+ *   - No filesystem chatter from multiple separate writes
+ *   - Single migration path going forward
+ *
+ * Note: ~/.hicortex/config.json is intentionally NOT merged here. Config is
+ * user-edited and tracked separately from machine state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadState = loadState;
+exports.saveState = saveState;
+exports.updateState = updateState;
+exports.migrateLegacyState = migrateLegacyState;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const STATE_FILE = "state.json";
+/**
+ * Load the state file. Returns an empty state if the file is missing
+ * or corrupted (callers should handle missing fields with defaults).
+ */
+function loadState(stateDir = HICORTEX_HOME) {
+    const path = (0, node_path_1.join)(stateDir, STATE_FILE);
+    try {
+        const raw = (0, node_fs_1.readFileSync)(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Atomically write the state file. Uses write-to-temp + rename so a crash
+ * during write cannot leave a half-written state.json on disk.
+ */
+function saveState(state, stateDir = HICORTEX_HOME) {
+    try {
+        (0, node_fs_1.mkdirSync)(stateDir, { recursive: true });
+        const path = (0, node_path_1.join)(stateDir, STATE_FILE);
+        const tmp = `${path}.tmp`;
+        (0, node_fs_1.writeFileSync)(tmp, JSON.stringify(state, null, 2));
+        (0, node_fs_1.renameSync)(tmp, path);
+    }
+    catch (err) {
+        console.warn(`[hicortex] Failed to save state: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Read-modify-write helper. The updater receives the current state and
+ * returns the next state (or void if it mutates in place).
+ */
+function updateState(updater, stateDir = HICORTEX_HOME) {
+    const current = loadState(stateDir);
+    const result = updater(current);
+    const next = result ?? current;
+    saveState(next, stateDir);
+    return next;
+}
+// ---------------------------------------------------------------------------
+// One-time legacy migration
+// ---------------------------------------------------------------------------
+const LEGACY_FILES = [
+    "nightly-last-run.txt",
+    "last-consolidated.txt",
+    "license-validated.txt",
+    "tier.json",
+];
+/**
+ * One-time migration from the 4 legacy state files to state.json.
+ *
+ * Behaviour:
+ *   1. If state.json already exists, do nothing (and clean up any leftover
+ *      legacy files from a previously interrupted migration).
+ *   2. Otherwise, read whichever legacy files exist, build a HicortexState,
+ *      write state.json, and delete the legacy files.
+ *
+ * Idempotent: safe to call on every boot.
+ * Returns true if migration ran, false if state.json already existed.
+ */
+function migrateLegacyState(stateDir = HICORTEX_HOME) {
+    const statePath = (0, node_path_1.join)(stateDir, STATE_FILE);
+    if ((0, node_fs_1.existsSync)(statePath)) {
+        cleanupLegacyFiles(stateDir);
+        return false;
+    }
+    const state = {};
+    let foundAny = false;
+    // 1. nightly-last-run.txt → state.lastNightly
+    const ln = readLegacyText(stateDir, "nightly-last-run.txt");
+    if (ln) {
+        state.lastNightly = ln;
+        foundAny = true;
+    }
+    // 2. last-consolidated.txt → state.lastConsolidated
+    const lc = readLegacyText(stateDir, "last-consolidated.txt");
+    if (lc) {
+        state.lastConsolidated = lc;
+        foundAny = true;
+    }
+    // 3. tier.json → state.tier (full object)
+    const tierRaw = readLegacyText(stateDir, "tier.json");
+    if (tierRaw) {
+        try {
+            state.tier = JSON.parse(tierRaw);
+            foundAny = true;
+        }
+        catch {
+            // Corrupted tier.json — ignore
+        }
+    }
+    // 4. license-validated.txt → state.tier.validatedAt (only if no tier yet)
+    //    (subsumed by tier.json when it exists)
+    if (!state.tier) {
+        const lv = readLegacyText(stateDir, "license-validated.txt");
+        if (lv) {
+            // We have a validation timestamp but no tier object — preserve as
+            // a placeholder so offline grace can still work. The features module
+            // will re-validate on next boot to get the full features back.
+            // We deliberately don't fabricate features here.
+            foundAny = true;
+        }
+    }
+    if (foundAny) {
+        saveState(state, stateDir);
+        cleanupLegacyFiles(stateDir);
+        console.log("[hicortex] Migrated legacy state files to ~/.hicortex/state.json");
+        return true;
+    }
+    return false;
+}
+function readLegacyText(stateDir, name) {
+    try {
+        const raw = (0, node_fs_1.readFileSync)((0, node_path_1.join)(stateDir, name), "utf-8").trim();
+        return raw || null;
+    }
+    catch {
+        return null;
+    }
+}
+function cleanupLegacyFiles(stateDir) {
+    for (const name of LEGACY_FILES) {
+        try {
+            (0, node_fs_1.unlinkSync)((0, node_path_1.join)(stateDir, name));
+        }
+        catch {
+            // File didn't exist — fine
+        }
+    }
+}

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "hicortex",
   "name": "Hicortex — Long-term Memory That Learns",
   "description": "Your agents remember past decisions, avoid repeated mistakes, and get smarter every day. Nightly reflection generates actionable lessons that automatically update agent behavior.",
-  "version": "0.3.11",
+  "version": "0.4.5",
   "kind": "lifecycle",
   "skills": ["./skills/hicortex-memory", "./skills/hicortex-learn", "./skills/hicortex-activate"],
   "configSchema": {
@@ -10,7 +10,7 @@
     "properties": {
       "licenseKey": {
         "type": "string",
-        "description": "Hicortex license key (hctx-...). Leave empty for free tier (100 memory cap)."
+        "description": "Hicortex license key (hctx-...). Leave empty for free tier (250 memory cap)."
       },
       "llmBaseUrl": {
         "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "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": {
@@ -45,13 +45,17 @@
   "engines": {
     "node": ">=18"
   },
-  "license": "UNLICENSED",
+  "license": "MIT",
   "homepage": "https://hicortex.gamaze.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mha33/hicortex.git",
+    "url": "https://github.com/gamaze-labs/hicortex.git",
     "directory": "packages/openclaw-plugin"
   },
+  "bugs": {
+    "url": "https://github.com/gamaze-labs/hicortex/issues"
+  },
+  "author": "Mattias Hansson",
   "dependencies": {
     "@huggingface/transformers": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.28.0",

package/skills/hicortex-learn/SKILL.md

@@ -23,12 +23,12 @@ When invoked with `/learn <text>`, store the learning in long-term memory via hi
 ## Example
 
 ```
-/learn z.ai API uses Bearer auth on all endpoints, not x-api-key
+/learn always check provider docs before assuming an API uses the same auth scheme as OpenAI
 ```
 
 Becomes:
 ```
-hicortex_ingest(content="LEARNING: z.ai API uses Bearer auth on all three endpoints (paas, coding, anthropic). Not x-api-key. (2026-03-24)", project="global", memory_type="lesson")
+hicortex_ingest(content="LEARNING: always check provider docs before assuming an API uses the same auth scheme as OpenAI — header names and token formats vary widely (Bearer vs x-api-key vs custom). (2026-04-07)", project="global", memory_type="lesson")
 ```
 
 ## Rules