@gamaze/hicortex 0.12.0 → 0.12.1

package/dist/classify-domains.js

@@ -73,9 +73,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runClassifyDomains = runClassifyDomains;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 const db_js_1 = require("./db.js");
 const state_js_1 = require("./state.js");
 const storage = __importStar(require("./storage.js"));
@@ -84,7 +84,7 @@ const domain_classify_js_1 = require("./domain-classify.js");
 const consolidate_js_1 = require("./consolidate.js");
 const schema_prototypes_js_1 = require("./schema-prototypes.js");
 const nofit_js_1 = require("./nofit.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 function readConfig(stateDir) {
     try {
         return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(stateDir, "config.json"), "utf-8"));

package/dist/context-cli.js

@@ -30,16 +30,13 @@ const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const node_child_process_1 = require("node:child_process");
 const context_store_js_1 = require("./context-store.js");
+const paths_js_1 = require("./paths.js");
 const DEFAULT_PORT = 8787;
 const REQUEST_TIMEOUT_MS = 5000;
 /** Thrown for any expected, user-facing failure. cli.ts prints .message + exits 1. */
 class ContextCliError extends Error {
 }
 exports.ContextCliError = ContextCliError;
-/** Home dir holding config.json. HICORTEX_HOME override is a headless/test seam. */
-function hicortexHome() {
-    return process.env.HICORTEX_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
-}
 /**
  * Resolve the server URL + token from a parsed config object. Pure + exported
  * so it is unit-testable without a live config. Follows lessons-context.ts.
@@ -54,7 +51,7 @@ function resolveContextTarget(config) {
 /** Read ~/.hicortex/config.json (or $HICORTEX_HOME/config.json). Missing → {}. */
 function loadConfig() {
     try {
-        return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(hicortexHome(), "config.json"), "utf-8"));
+        return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)((0, paths_js_1.hicortexHome)(), "config.json"), "utf-8"));
     }
     catch {
         return {};

package/dist/db.js

@@ -11,13 +11,14 @@ exports.resolveDbPath = resolveDbPath;
 exports.initDb = initDb;
 exports.getSchemaVersion = getSchemaVersion;
 exports.getStats = getStats;
+const paths_js_1 = require("./paths.js");
 const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const EMBEDDING_DIMENSIONS = 384;
 /** Canonical Hicortex home directory. */
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 /** Legacy OC plugin DB path (pre-v0.3 installations). */
 const LEGACY_OC_DB = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "data", "hicortex.db");
 /**

package/dist/features.js

@@ -21,11 +21,10 @@ exports.memoryCapReached = memoryCapReached;
 exports.lessonsLimit = lessonsLimit;
 exports.remoteIngestAllowed = remoteIngestAllowed;
 exports.getCurrentFeatures = getCurrentFeatures;
-const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
+const paths_js_1 = require("./paths.js");
 const license_js_1 = require("./license.js");
 const state_js_1 = require("./state.js");
-const DEFAULT_STATE_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const DEFAULT_STATE_DIR = (0, paths_js_1.hicortexHome)();
 // A single canonical "full" feature set — no tiers.
 const FULL_FEATURES = {
     reflection: true,

package/dist/index.js

@@ -19,6 +19,7 @@
  * canonical nightly-from-logs, same as CC JSONL and Hermes state.db.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+const paths_js_1 = require("./paths.js");
 const features_js_1 = require("./features.js");
 const extensions_js_1 = require("./extensions.js");
 const state_js_1 = require("./state.js");
@@ -30,7 +31,7 @@ const node_os_1 = require("node:os");
 // ---------------------------------------------------------------------------
 const DEFAULT_SERVER_URL = "http://127.0.0.1:8787";
 const LESSONS_TIMEOUT_MS = 3000;
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 // ---------------------------------------------------------------------------
 // Module state — initialized in registerService.start()
 // ---------------------------------------------------------------------------

package/dist/init.d.ts

@@ -61,6 +61,15 @@ export declare const GENERIC_DEFAULT_DOMAINS: DomainDef[];
 export declare function scaffoldDefaultDomains(configPath: string): {
     scaffolded: boolean;
 };
+/**
+ * True if a resolved binary path lives in npm's ephemeral npx cache
+ * (`~/.npm/_npx/<hash>/node_modules/.bin/…`). When `hicortex init` is itself
+ * run via `npx -y @gamaze/hicortex init`, npx prepends that cache dir to PATH,
+ * so `which hicortex` resolves there. npm garbage-collects `_npx`, so any
+ * SessionStart hook or nightly timer wired to such a path breaks silently
+ * later — the "looks configured but isn't" trap (#176). Never persist it.
+ */
+export declare function isEphemeralNpxPath(binPath: string): boolean;
 /**
  * Install (or verify) the CC SessionStart hook that runs `hicortex lessons-context`.
  * The hook fetches lessons from the configured server at session start and injects

package/dist/init.js

@@ -22,9 +22,11 @@ exports.parseEnvFile = parseEnvFile;
 exports.generateAuthToken = generateAuthToken;
 exports.persistAuthToken = persistAuthToken;
 exports.scaffoldDefaultDomains = scaffoldDefaultDomains;
+exports.isEphemeralNpxPath = isEphemeralNpxPath;
 exports.installSessionStartHook = installSessionStartHook;
 exports.runInit = runInit;
 exports.resolveNightlyHour = resolveNightlyHour;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
@@ -32,7 +34,7 @@ const node_child_process_1 = require("node:child_process");
 const node_readline_1 = require("node:readline");
 const node_crypto_1 = require("node:crypto");
 const claude_md_js_1 = require("./claude-md.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
 const CC_COMMANDS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "commands");
 const OC_CONFIG = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "openclaw.json");
@@ -789,16 +791,31 @@ function findNpxPath() {
         return "/usr/local/bin/npx";
     }
 }
+/**
+ * True if a resolved binary path lives in npm's ephemeral npx cache
+ * (`~/.npm/_npx/<hash>/node_modules/.bin/…`). When `hicortex init` is itself
+ * run via `npx -y @gamaze/hicortex init`, npx prepends that cache dir to PATH,
+ * so `which hicortex` resolves there. npm garbage-collects `_npx`, so any
+ * SessionStart hook or nightly timer wired to such a path breaks silently
+ * later — the "looks configured but isn't" trap (#176). Never persist it.
+ */
+function isEphemeralNpxPath(binPath) {
+    return binPath.includes("/_npx/");
+}
 /**
  * Resolve the absolute path of the hicortex binary.
  * For global npm installs (e.g. /usr/bin/hicortex) this is the binary itself.
  * For dev/npx installs, falls back to `npx <packageSpec> <command>` form.
  * Returns an array: [binaryPath] for global, or [npxPath, "-y", packageSpec] for npx.
+ *
+ * A `which hicortex` hit inside the npx cache (#176) is REJECTED — it is
+ * ephemeral, so we emit the durable `npx -y <spec>` form instead. This is the
+ * standard client path (`npx … init`), where the fix matters most.
  */
 function resolveBinaryArgs() {
     try {
         const bin = (0, node_child_process_1.execSync)("which hicortex", { encoding: "utf-8" }).trim();
-        if (bin)
+        if (bin && !isEphemeralNpxPath(bin))
             return [bin];
     }
     catch { /* not in PATH as a global binary */ }

package/dist/lessons-context.js

@@ -26,27 +26,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchLessonsContext = fetchLessonsContext;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 const features_js_1 = require("./features.js");
 const extensions_js_1 = require("./extensions.js");
 const state_js_1 = require("./state.js");
+const paths_js_1 = require("./paths.js");
 const DEFAULT_PORT = 8787;
 /** Harness name this hook injects for — used to self-gate on GET /context `clients`. */
 const THIS_HARNESS = "cc";
-/**
- * Resolve the Hicortex home. Honors HICORTEX_HOME (matches the HICORTEX_DB_PATH
- * env convention in db.ts) so headless/scratch installs can point elsewhere;
- * defaults to ~/.hicortex. Resolved per-call so tests and env changes apply.
- */
-function hicortexHome() {
-    return process.env.HICORTEX_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
-}
 /**
  * Read ~/.hicortex/config.json and resolve the server URL + auth token, or
  * null when there is no usable config (server not set up yet — fail soft).
  */
 function resolveConfig() {
-    const home = hicortexHome();
+    const home = (0, paths_js_1.hicortexHome)();
     let config;
     try {
         config = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(home, "config.json"), "utf-8"));

package/dist/mcp-server.js

@@ -122,7 +122,7 @@ function createMcpServer() {
         if (!db)
             return { content: [{ type: "text", text: "Hicortex not initialized" }], isError: true };
         try {
-            const results = retrieval.searchContext(db, { project, limit });
+            const results = retrieval.searchRecent(db, { project, limit });
             return { content: [{ type: "text", text: formatResults(results) }] };
         }
         catch (err) {
@@ -593,7 +593,7 @@ async function startServer(options = {}) {
             ? req.query.privacy.split(",").map((s) => s.trim()).filter(Boolean)
             : undefined;
         try {
-            const results = retrieval.searchContext(db, { project, limit, privacy });
+            const results = retrieval.searchRecent(db, { project, limit, privacy });
             res.json({ results });
         }
         catch (err) {

package/dist/nightly-status.js

@@ -11,13 +11,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showNightlyStatus = showNightlyStatus;
+const paths_js_1 = require("./paths.js");
 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 state_js_1 = require("./state.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CONFIG_PATH = (0, node_path_1.join)(HICORTEX_HOME, "config.json");
 async function showNightlyStatus() {
     console.log("Hicortex Nightly Pipeline Status");

package/dist/nightly.js

@@ -46,9 +46,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runNightly = runNightly;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 let VERSION = "0.0.0";
 try {
     VERSION = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "..", "package.json"), "utf-8")).version;
@@ -69,7 +69,7 @@ const oc_transcript_reader_js_1 = require("./oc-transcript-reader.js");
 const features_js_1 = require("./features.js");
 const state_js_1 = require("./state.js");
 const telemetry_js_1 = require("./telemetry.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 function readNightlyConfig(stateDir) {
     try {
         const configPath = (0, node_path_1.join)(stateDir, "config.json");

package/dist/paths.d.ts

@@ -0,0 +1 @@
+export declare function hicortexHome(): string;

package/dist/paths.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hicortexHome = hicortexHome;
+/**
+ * Canonical Hicortex home resolution — the single source of truth (#174).
+ *
+ * Honors the HICORTEX_HOME env override (a headless/test seam, mirroring the
+ * HICORTEX_DB_PATH convention in db.ts); otherwise defaults to ~/.hicortex.
+ * Every module that needs the home dir routes through here, so the override
+ * behaves consistently across all commands instead of being honored by some
+ * (context-cli, lessons-context) and hardcoded away by others.
+ */
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+function hicortexHome() {
+    return process.env.HICORTEX_HOME ?? (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+}

package/dist/relink.js

@@ -74,14 +74,14 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getStoredEmbedding = getStoredEmbedding;
 exports.runRelink = runRelink;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
-const node_os_1 = require("node:os");
 const db_js_1 = require("./db.js");
 const storage = __importStar(require("./storage.js"));
 const consolidate_js_1 = require("./consolidate.js");
 const state_js_1 = require("./state.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 function readConfig(stateDir) {
     try {
         return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(stateDir, "config.json"), "utf-8"));

package/dist/retrieval.d.ts

@@ -55,7 +55,7 @@ export declare function retrieve(db: Database.Database, embedFn: EmbedFn, query:
 /**
  * Get recent context, optionally filtered by project and privacy.
  */
-export declare function searchContext(db: Database.Database, options?: {
+export declare function searchRecent(db: Database.Database, options?: {
     project?: string | null;
     limit?: number;
     privacy?: string[];

package/dist/retrieval.js

@@ -52,7 +52,7 @@ exports.l2ToCosine = l2ToCosine;
 exports.effectiveStrength = effectiveStrength;
 exports.computeScore = computeScore;
 exports.retrieve = retrieve;
-exports.searchContext = searchContext;
+exports.searchRecent = searchRecent;
 const storage = __importStar(require("./storage.js"));
 const BASE_DECAY = 0.0005;
 /**
@@ -315,7 +315,7 @@ async function retrieve(db, embedFn, query, options) {
 /**
  * Get recent context, optionally filtered by project and privacy.
  */
-function searchContext(db, options) {
+function searchRecent(db, options) {
     const limit = options?.limit ?? 10;
     const project = options?.project;
     const privacy = options?.privacy;

package/dist/state.js

@@ -23,10 +23,10 @@ exports.saveState = saveState;
 exports.updateState = updateState;
 exports.migrateLegacyState = migrateLegacyState;
 exports.describeLastNightly = describeLastNightly;
+const paths_js_1 = require("./paths.js");
 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 HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const STATE_FILE = "state.json";
 /**
  * Load the state file. Returns an empty state if the file is missing

package/dist/status.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runStatus = runStatus;
+const paths_js_1 = require("./paths.js");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
@@ -11,7 +12,7 @@ const node_child_process_1 = require("node:child_process");
 const db_js_1 = require("./db.js");
 const features_js_1 = require("./features.js");
 const state_js_1 = require("./state.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
 const OC_CONFIG = (0, node_path_1.join)((0, node_os_1.homedir)(), ".openclaw", "openclaw.json");
 async function runStatus() {

package/dist/uninstall.js

@@ -5,13 +5,14 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runUninstall = runUninstall;
+const paths_js_1 = require("./paths.js");
 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 node_readline_1 = require("node:readline");
 const claude_md_js_1 = require("./claude-md.js");
-const HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+const HICORTEX_HOME = (0, paths_js_1.hicortexHome)();
 const CC_SETTINGS = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "settings.json");
 const CC_COMMANDS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "commands");
 const CLAUDE_MD = (0, node_path_1.join)((0, node_os_1.homedir)(), ".claude", "CLAUDE.md");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.12.0",
-  "description": "Self-learning memory for AI agents — experience captured automatically, distilled into lessons overnight, shared across your whole fleet. Works with Hermes, OpenClaw, Claude Code, and Pi.",
+  "version": "0.12.1",
+  "description": "Self-learning memory for AI agents \u2014 experience captured automatically, distilled into lessons overnight, shared across your whole fleet. Works with Hermes, OpenClaw, Claude Code, and Pi.",
   "main": "dist/index.js",
   "bin": {
     "hicortex": "dist/cli.js"