@gamaze/hicortex 0.4.3 → 0.4.4

package/dist/index.js

@@ -42,7 +42,9 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_path_1 = require("node:path");
 const db_js_1 = require("./db.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 llm_js_1 = require("./llm.js");
 const node_fs_1 = require("node:fs");
 const node_os_1 = require("node:os");
@@ -87,8 +89,10 @@ exports.default = {
                 llm = new llm_js_1.LlmClient(llmConfig);
                 log(`[hicortex] LLM: ${llmConfig.provider}/${llmConfig.model} ` +
                     `(reflect: ${llmConfig.reflectModel})`);
-                // License check (non-blocking)
-                (0, license_js_1.validateLicense)(config.licenseKey, stateDir).catch((err) => log(`[hicortex] License validation failed: ${err}`));
+                // One-time migration of legacy state files (no-op if state.json exists)
+                (0, state_js_1.migrateLegacyState)(stateDir);
+                // License: init feature cache (sync after this returns)
+                await (0, features_js_1.initFeatures)(config.licenseKey, stateDir);
                 // Schedule nightly consolidation
                 const consolidateHour = config.consolidateHour ?? 2;
                 cancelConsolidation = (0, consolidate_js_1.scheduleConsolidation)(db, llm, embedder_js_1.embed, consolidateHour);
@@ -123,9 +127,13 @@ exports.default = {
                 const lessons = storage.getLessons(db, 7, ctx.project);
                 if (lessons.length === 0)
                     return {};
-                const maxFeatures = (0, license_js_1.getFeatures)(stateDir);
-                const maxLessons = maxFeatures.maxMemories === -1 ? 20 : 10;
-                const formatted = lessons.slice(0, maxLessons).map((l) => {
+                const maxLessons = (0, features_js_1.lessonsLimit)();
+                const selected = await (0, extensions_js_1.getLessonSelector)().select(lessons, {
+                    maxLessons,
+                    project: ctx.project,
+                    agentId: ctx.agentId,
+                });
+                const formatted = selected.map((l) => {
                     // Extract just the lesson text from the structured content
                     const match = l.content.match(/## Lesson: (.+)/);
                     return match ? `- ${match[1]}` : `- ${l.content.slice(0, 200)}`;
@@ -136,9 +144,9 @@ exports.default = {
                     "\n";
                 // Daily friendly reminder when at memory cap
                 const memCount = storage.countMemories(db);
-                if (maxFeatures.maxMemories > 0 && memCount >= maxFeatures.maxMemories) {
+                if ((0, features_js_1.memoryCapReached)(memCount)) {
                     context +=
-                        `\n---\nHicortex free tier: ${maxFeatures.maxMemories} memories stored. ` +
+                        `\n---\nHicortex free tier: ${(0, features_js_1.maxMemoriesAllowed)()} memories stored. ` +
                             `New memories can no longer be saved, and your agent has stopped learning and self-improving from new sessions. ` +
                             `Existing memories, lessons, and search still work. ` +
                             `Upgrade for unlimited usage: https://hicortex.gamaze.com/ ` +
@@ -169,10 +177,8 @@ exports.default = {
                 if (entries.length === 0)
                     return;
                 // Check license cap
-                const features = (0, license_js_1.getFeatures)(stateDir);
-                if (features.maxMemories > 0 &&
-                    storage.countMemories(db) >= features.maxMemories) {
-                    console.warn(`[hicortex] Free tier limit reached (${features.maxMemories} memories). ` +
+                if ((0, features_js_1.memoryCapReached)(storage.countMemories(db))) {
+                    console.warn(`[hicortex] Free tier limit reached (${(0, features_js_1.maxMemoriesAllowed)()} memories). ` +
                         `Search and lessons still work, but new memories won't be saved. ` +
                         `Upgrade for unlimited usage: https://hicortex.gamaze.com/`);
                     return;
@@ -299,12 +305,11 @@ exports.default = {
             async execute(_callId, args, context) {
                 if (!db)
                     return { error: "Hicortex not initialized" };
-                const features = (0, license_js_1.getFeatures)(stateDir);
-                if (features.maxMemories > 0 && storage.countMemories(db) >= features.maxMemories) {
+                if ((0, features_js_1.memoryCapReached)(storage.countMemories(db))) {
                     return {
                         content: [{
                                 type: "text",
-                                text: `Free tier limit reached (${features.maxMemories} memories). ` +
+                                text: `Free tier limit reached (${(0, features_js_1.maxMemoriesAllowed)()} memories). ` +
                                     `Your existing memories and lessons still work — search and recall are unaffected. ` +
                                     `New memories won't be saved until you upgrade.\n\n` +
                                     `Upgrade for unlimited usage: https://hicortex.gamaze.com/`
@@ -529,26 +534,6 @@ function persistProviderConfig(llmConfig, log) {
         // Non-fatal — config works in memory even if we can't persist
     }
 }
-/**
- * Track when the memory cap was first hit. Returns days since cap was reached.
- * Stores timestamp in stateDir/cap-hit.txt on first detection.
- */
-function getDaysSinceCapHit(dir) {
-    const capFile = (0, node_path_1.join)(dir, "cap-hit.txt");
-    try {
-        const ts = (0, node_fs_1.readFileSync)(capFile, "utf-8").trim();
-        const hitDate = new Date(ts);
-        return Math.floor((Date.now() - hitDate.getTime()) / (1000 * 60 * 60 * 24));
-    }
-    catch {
-        // First time hitting cap — record it
-        try {
-            (0, node_fs_1.writeFileSync)(capFile, new Date().toISOString());
-        }
-        catch { /* non-fatal */ }
-        return 0;
-    }
-}
 const HICORTEX_TOOLS = [
     "hicortex_search",
     "hicortex_context",

package/dist/license.d.ts

@@ -1,5 +1,15 @@
+/**
+ * License API client.
+ *
+ * This module is a thin wrapper over the validation HTTP endpoint at
+ * https://hicortex.gamaze.com/api/validate. Persistence and feature gating
+ * live in features.ts + state.ts; this file does NOT touch disk.
+ *
+ * Offline grace: when the API is unreachable, we fall back to the cached
+ * tier in state.json (written by features.ts on the last successful
+ * validation). If the cached tier was validated within OFFLINE_GRACE_DAYS,
+ * we treat it as still valid.
+ */
 import type { LicenseInfo } from "./types.js";
-/** Validate a license key against the Hicortex API */
+/** Validate a license key against the Hicortex API. */
 export declare function validateLicense(key: string | undefined, stateDir: string): Promise<LicenseInfo>;
-/** Get current features, using cache or free tier defaults */
-export declare function getFeatures(stateDir: string): LicenseInfo["features"];

package/dist/license.js

@@ -1,13 +1,23 @@
 "use strict";
+/**
+ * License API client.
+ *
+ * This module is a thin wrapper over the validation HTTP endpoint at
+ * https://hicortex.gamaze.com/api/validate. Persistence and feature gating
+ * live in features.ts + state.ts; this file does NOT touch disk.
+ *
+ * Offline grace: when the API is unreachable, we fall back to the cached
+ * tier in state.json (written by features.ts on the last successful
+ * validation). If the cached tier was validated within OFFLINE_GRACE_DAYS,
+ * we treat it as still valid.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateLicense = validateLicense;
-exports.getFeatures = getFeatures;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
+const state_js_1 = require("./state.js");
 const VALIDATE_URL = "https://hicortex.gamaze.com/api/validate";
 const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
 const OFFLINE_GRACE_DAYS = 7;
-// In-memory cache
+// In-memory cache for the current process
 let cachedLicense = null;
 let cacheTimestamp = 0;
 const FREE_LICENSE = {
@@ -21,12 +31,12 @@ const FREE_LICENSE = {
         remoteIngest: true,
     },
 };
-/** Validate a license key against the Hicortex API */
+/** Validate a license key against the Hicortex API. */
 async function validateLicense(key, stateDir) {
     // No key = free tier
     if (!key)
         return FREE_LICENSE;
-    // Check in-memory cache
+    // Check in-memory cache (24h TTL)
     if (cachedLicense && Date.now() - cacheTimestamp < CACHE_TTL_MS) {
         return cachedLicense;
     }
@@ -41,57 +51,36 @@ async function validateLicense(key, stateDir) {
             throw new Error(`HTTP ${resp.status}`);
         }
         const data = (await resp.json());
-        // Cache result
         cachedLicense = data;
         cacheTimestamp = Date.now();
-        // Persist last successful validation timestamp for offline grace
-        if (data.valid) {
-            persistValidationTimestamp(stateDir);
-        }
         return data;
     }
     catch {
-        // Network failure — check offline grace period
-        return offlineFallback(key, stateDir);
-    }
-}
-/** Get current features, using cache or free tier defaults */
-function getFeatures(stateDir) {
-    if (cachedLicense)
-        return cachedLicense.features;
-    return FREE_LICENSE.features;
-}
-function persistValidationTimestamp(stateDir) {
-    try {
-        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(stateDir, "license-validated.txt"), new Date().toISOString());
-    }
-    catch {
-        // Non-critical
+        // Network failure — check offline grace period via state.tier
+        return offlineFallback(stateDir);
     }
 }
-function offlineFallback(key, stateDir) {
-    const tsPath = (0, node_path_1.join)(stateDir, "license-validated.txt");
-    if (!(0, node_fs_1.existsSync)(tsPath))
+/**
+ * Offline fallback: if state.tier was validated within the grace period,
+ * return its cached features as if validation succeeded. Otherwise, free tier.
+ */
+function offlineFallback(stateDir) {
+    const persisted = (0, state_js_1.loadState)(stateDir).tier;
+    if (!persisted)
         return FREE_LICENSE;
     try {
-        const lastValidated = new Date((0, node_fs_1.readFileSync)(tsPath, "utf-8").trim());
+        const lastValidated = new Date(persisted.validatedAt);
         const daysSince = (Date.now() - lastValidated.getTime()) / (1000 * 60 * 60 * 24);
         if (daysSince <= OFFLINE_GRACE_DAYS) {
-            // Within grace period — assume last known state was valid
-            return cachedLicense ?? {
+            return {
                 valid: true,
-                tier: "pro",
-                features: {
-                    reflection: true,
-                    vectorSearch: true,
-                    maxMemories: -1,
-                    crossAgent: true,
-                },
+                tier: persisted.tier,
+                features: persisted.features,
             };
         }
     }
     catch {
-        // Corrupted file
+        // Corrupted timestamp — fall through
     }
     return FREE_LICENSE;
 }

package/dist/mcp-server.js

@@ -55,7 +55,8 @@ const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
 const zod_1 = require("zod");
 const db_js_1 = require("./db.js");
 const llm_js_1 = require("./llm.js");
-const license_js_1 = require("./license.js");
+const features_js_1 = require("./features.js");
+const state_js_1 = require("./state.js");
 const embedder_js_1 = require("./embedder.js");
 const storage = __importStar(require("./storage.js"));
 const retrieval = __importStar(require("./retrieval.js"));
@@ -121,12 +122,11 @@ function createMcpServer() {
     }, async ({ content, project, memory_type }) => {
         if (!db)
             return { content: [{ type: "text", text: "Hicortex not initialized" }], isError: true };
-        const features = (0, license_js_1.getFeatures)(stateDir);
-        if (features.maxMemories > 0 && storage.countMemories(db) >= features.maxMemories) {
+        if ((0, features_js_1.memoryCapReached)(storage.countMemories(db))) {
             return {
                 content: [{
                         type: "text",
-                        text: `Free tier limit reached (${features.maxMemories} memories). ` +
+                        text: `Free tier limit reached (${(0, features_js_1.maxMemoriesAllowed)()} memories). ` +
                             `Your existing memories and lessons still work — search and recall are unaffected. ` +
                             `New memories won't be saved until you upgrade.\n\n` +
                             `Upgrade for unlimited usage: https://hicortex.gamaze.com/`
@@ -296,11 +296,13 @@ async function startServer(options = {}) {
         ? `${llmConfig.reflectProvider}/${llmConfig.reflectModel}@${llmConfig.reflectBaseUrl}`
         : llmConfig.reflectModel;
     console.log(`[hicortex] LLM fast: ${llmConfig.provider}/${llmConfig.model}${distillInfo ? `, distill: ${distillInfo}` : ""}, reflect: ${reflectInfo}`);
-    // License: read from options, config file, or env var
+    // One-time migration of legacy state files (no-op if state.json exists)
+    (0, state_js_1.migrateLegacyState)(stateDir);
+    // License: read from options, config file, or env var, init feature cache
     const licenseKey = options.licenseKey
         ?? savedConfig?.licenseKey
         ?? process.env.HICORTEX_LICENSE_KEY;
-    (0, license_js_1.validateLicense)(licenseKey, stateDir).catch((err) => console.log(`[hicortex] License validation failed: ${err}`));
+    await (0, features_js_1.initFeatures)(licenseKey, stateDir);
     if (licenseKey) {
         console.log(`[hicortex] License key configured`);
     }
@@ -411,15 +413,12 @@ async function startServer(options = {}) {
         // Pro license blocks remote ingest (upgrade to Team for multi-client)
         const ip = req.ip ?? req.socket.remoteAddress ?? "";
         const isLocal = ip === "127.0.0.1" || ip === "::1" || ip === "::ffff:127.0.0.1";
-        if (!isLocal) {
-            const features = (0, license_js_1.getFeatures)(stateDir);
-            if (features.remoteIngest === false) {
-                res.status(403).json({
-                    error: "Pro license is single-machine. Upgrade to Team for multi-client remote ingestion.",
-                    upgrade: "https://hicortex.gamaze.com/",
-                });
-                return;
-            }
+        if (!isLocal && !(0, features_js_1.remoteIngestAllowed)()) {
+            res.status(403).json({
+                error: "Pro license is single-machine. Upgrade to Team for multi-client remote ingestion.",
+                upgrade: "https://hicortex.gamaze.com/",
+            });
+            return;
         }
         const { content, source_agent, project, memory_type, privacy, source_session, session_date } = req.body ?? {};
         if (!content || typeof content !== "string") {
@@ -440,9 +439,8 @@ async function startServer(options = {}) {
             }
         }
         // License check
-        const features = (0, license_js_1.getFeatures)(stateDir);
-        if (features.maxMemories > 0 && storage.countMemories(db) >= features.maxMemories) {
-            res.status(429).json({ error: "Memory limit reached", limit: features.maxMemories });
+        if ((0, features_js_1.memoryCapReached)(storage.countMemories(db))) {
+            res.status(429).json({ error: "Memory limit reached", limit: (0, features_js_1.maxMemoriesAllowed)() });
             return;
         }
         try {

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;