@gamaze/hicortex 0.11.1 → 0.12.0

package/dist/nightly.js

@@ -103,10 +103,29 @@ function writeLastRun(stateDir = HICORTEX_HOME) {
         return s;
     }, stateDir);
 }
+const NIGHTLY_LOG_MAX_BYTES = 1024 * 1024; // 1 MB — years of normal runs
+/**
+ * Keep ~/.hicortex/nightly.log bounded. The launchd plist and systemd unit
+ * both append to it forever with no rotation, and the typical volatile-journal
+ * target is a Raspberry Pi on a small SD card. Copy-then-truncate (not rename)
+ * because the process's own stdout may hold an O_APPEND fd on this very file —
+ * truncation keeps that fd valid and subsequent writes land at the new end.
+ */
+function rotateNightlyLog(stateDir = HICORTEX_HOME) {
+    const logPath = (0, node_path_1.join)(stateDir, "nightly.log");
+    try {
+        if ((0, node_fs_1.statSync)(logPath).size <= NIGHTLY_LOG_MAX_BYTES)
+            return;
+        (0, node_fs_1.copyFileSync)(logPath, `${logPath}.old`);
+        (0, node_fs_1.truncateSync)(logPath);
+    }
+    catch { /* no log file, or unreadable — nothing to rotate */ }
+}
 async function runNightly(options = {}) {
     const dryRun = options.dryRun ?? false;
     const captureOnly = options.captureOnly ?? false;
     const stateDir = options.stateDir ?? HICORTEX_HOME;
+    rotateNightlyLog(stateDir);
     // One-time migration of legacy state files (no-op if state.json exists)
     (0, state_js_1.migrateLegacyState)(stateDir);
     // Check mode: client or server

package/dist/uninstall.js

@@ -32,29 +32,45 @@ async function runUninstall() {
         return;
     }
     console.log();
-    // 1. Stop and remove daemon
+    // 1. Stop and remove daemon + nightly timer (both units, or the timer
+    //    keeps firing against a half-removed install)
     const os = (0, node_os_1.platform)();
     if (os === "darwin") {
-        const plistPath = (0, node_path_1.join)((0, node_os_1.homedir)(), "Library", "LaunchAgents", "com.gamaze.hicortex.plist");
-        if ((0, node_fs_1.existsSync)(plistPath)) {
-            try {
-                (0, node_child_process_1.execSync)(`launchctl unload ${plistPath} 2>/dev/null`);
+        for (const name of ["com.gamaze.hicortex.plist", "com.gamaze.hicortex-nightly.plist"]) {
+            const plistPath = (0, node_path_1.join)((0, node_os_1.homedir)(), "Library", "LaunchAgents", name);
+            if ((0, node_fs_1.existsSync)(plistPath)) {
+                try {
+                    (0, node_child_process_1.execSync)(`launchctl unload ${plistPath} 2>/dev/null`);
+                }
+                catch { /* not loaded */ }
+                (0, node_fs_1.unlinkSync)(plistPath);
+                console.log(`  ✓ Removed ${name}`);
             }
-            catch { /* not loaded */ }
-            (0, node_fs_1.unlinkSync)(plistPath);
-            console.log("  ✓ Removed launchd daemon");
         }
     }
     else if (os === "linux") {
         try {
             (0, node_child_process_1.execSync)("systemctl --user disable --now hicortex.service 2>/dev/null");
-            const servicePath = (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "systemd", "user", "hicortex.service");
-            if ((0, node_fs_1.existsSync)(servicePath))
-                (0, node_fs_1.unlinkSync)(servicePath);
-            (0, node_child_process_1.execSync)("systemctl --user daemon-reload 2>/dev/null");
-            console.log("  ✓ Removed systemd service");
         }
         catch { /* not installed */ }
+        try {
+            (0, node_child_process_1.execSync)("systemctl --user disable --now hicortex-nightly.timer 2>/dev/null");
+        }
+        catch { /* not installed */ }
+        const unitDir = (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "systemd", "user");
+        for (const name of ["hicortex.service", "hicortex-nightly.timer", "hicortex-nightly.service"]) {
+            const unitPath = (0, node_path_1.join)(unitDir, name);
+            try {
+                if ((0, node_fs_1.existsSync)(unitPath))
+                    (0, node_fs_1.unlinkSync)(unitPath);
+            }
+            catch { /* leave it */ }
+        }
+        try {
+            (0, node_child_process_1.execSync)("systemctl --user daemon-reload 2>/dev/null");
+        }
+        catch { /* fine */ }
+        console.log("  ✓ Removed systemd service + nightly timer");
     }
     // 2. Remove MCP from CC
     try {

package/dist/viz.d.ts

@@ -51,6 +51,21 @@ export declare function readVizHtml(): string;
  * when the asset cannot be read.
  */
 export declare function vizHandler(): express.RequestHandler;
+/**
+ * Resolve the on-disk path of the context-layer editor page. Throws (fail
+ * explicitly) when the asset is missing — same contract as resolveVizHtmlPath.
+ * assets/ sits next to both dist/ (dist/viz.js → ../assets/) and src/
+ * (src/viz.ts → ../assets/ under tsx), so one sibling candidate covers both.
+ */
+export declare function resolveContextHtmlPath(): string;
+/** Read the context editor page. Read at request time so a reinstall is live. */
+export declare function readContextHtml(): string;
+/**
+ * Express handler for GET /context/ui — the PRIMARY edit surface for the
+ * standing context layer. 503 with the usual {error} shape when the asset
+ * cannot be read, exactly like vizHandler.
+ */
+export declare function contextUiHandler(): express.RequestHandler;
 /**
  * Resolve the on-disk path of an allowlisted vendor bundle, or null when the
  * requested name is not on the allowlist. The filesystem path is built ONLY

package/dist/viz.js

@@ -31,6 +31,9 @@ exports.createAuthMiddleware = createAuthMiddleware;
 exports.resolveVizHtmlPath = resolveVizHtmlPath;
 exports.readVizHtml = readVizHtml;
 exports.vizHandler = vizHandler;
+exports.resolveContextHtmlPath = resolveContextHtmlPath;
+exports.readContextHtml = readContextHtml;
+exports.contextUiHandler = contextUiHandler;
 exports.resolveVizVendorPath = resolveVizVendorPath;
 exports.vizVendorHandler = vizVendorHandler;
 const node_fs_1 = require("node:fs");
@@ -70,6 +73,14 @@ function createAuthMiddleware(authToken) {
         // normal Authorization header on its data fetches.
         if (req.method === "GET" && req.path === "/viz")
             return next();
+        // The /context/ui page SHELL is public for the same reason as /viz: a
+        // self-contained static editor page, no data and no secrets (it ships
+        // verbatim in the npm tarball). The standing-context DATA it edits comes
+        // from GET/PUT /context, which stay bearer-only (localhost bypass) like
+        // every other data route; the page collects the token client-side and
+        // sends it as a normal Authorization header on its /context fetches.
+        if (req.method === "GET" && req.path === "/context/ui")
+            return next();
         // The pinned renderer bundles the /viz page loads (#139) are public for
         // the same reason as the shell: static third-party code shipped verbatim
         // in the npm tarball, zero data. Kept tight: GET only, and ONLY names on
@@ -136,6 +147,43 @@ function vizHandler() {
         }
     };
 }
+// ---------------------------------------------------------------------------
+// Context layer editor page (/context/ui, 0.12 — spec 2026-07-12 §5)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the on-disk path of the context-layer editor page. Throws (fail
+ * explicitly) when the asset is missing — same contract as resolveVizHtmlPath.
+ * assets/ sits next to both dist/ (dist/viz.js → ../assets/) and src/
+ * (src/viz.ts → ../assets/ under tsx), so one sibling candidate covers both.
+ */
+function resolveContextHtmlPath() {
+    const candidates = [(0, node_path_1.join)(__dirname, "..", "assets", "context.html")];
+    for (const candidate of candidates) {
+        if ((0, node_fs_1.existsSync)(candidate))
+            return candidate;
+    }
+    throw new Error(`context.html asset not found — looked in: ${candidates.join(", ")}. ` +
+        `The package install is incomplete (assets/ missing).`);
+}
+/** Read the context editor page. Read at request time so a reinstall is live. */
+function readContextHtml() {
+    return (0, node_fs_1.readFileSync)(resolveContextHtmlPath(), "utf-8");
+}
+/**
+ * Express handler for GET /context/ui — the PRIMARY edit surface for the
+ * standing context layer. 503 with the usual {error} shape when the asset
+ * cannot be read, exactly like vizHandler.
+ */
+function contextUiHandler() {
+    return (_req, res) => {
+        try {
+            res.type("html").send(readContextHtml());
+        }
+        catch (err) {
+            res.status(503).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    };
+}
 /**
  * Resolve the on-disk path of an allowlisted vendor bundle, or null when the
  * requested name is not on the allowlist. The filesystem path is built ONLY

package/hermes-plugin/hicortex/README.md

@@ -15,28 +15,27 @@ Gives [Hermes](https://github.com/nousresearch/hermes-agent) agents self-learnin
 | `prefetch(query)` | recall relevant memories before each turn | `GET /search` |
 | `queue_prefetch(query)` | background recall for the next turn | `GET /search` |
 | `system_prompt_block()` | inject distilled lessons + memory index | `GET /lessons` |
-| `get_tool_schemas()` | exposes the 8 unified tools + `hicortex_recall_recent` | see tool table below |
+| `get_tool_schemas()` | exposes the 8 unified tools | see tool table below |
 
 That's the whole surface. No `sync_turn`, no compaction/session-end capture — those are intentionally absent.
 
-### Tools (unified 8 + 1 Hermes-specific)
+### Tools (unified 8)
 
 | Tool | REST call | Description |
 |---|---|---|
 | `hicortex_search` | `GET /search` | Semantic search over long-term memory |
-| `hicortex_context` | `GET /context` | Recent context memories by project |
+| `hicortex_recent` | `GET /recent` | Recent memories by project (queryless recall; was `hicortex_context`/`hicortex_recall_recent` before 0.12) |
 | `hicortex_ingest` | `POST /ingest` | Store a new memory |
 | `hicortex_lessons` | `GET /lessons` | Get distilled lessons |
 | `hicortex_index` | `GET /index` | Knowledge domain index |
 | `hicortex_graph` | `GET /graph` | Graph queries (neighbors/hubs/path) |
 | `hicortex_update` | `POST /update` | Update a memory (re-embeds on content change) |
 | `hicortex_delete` | `POST /delete` | Permanently delete a memory and its links |
-| `hicortex_recall_recent` | `GET /context` | Hermes-specific alias for context recall |
 
 ## Prerequisites
 
 - A reachable Hicortex server (default `http://localhost:8787`). Stand one up with `npx @gamaze/hicortex init`.
-- The server needs the REST `/search`, `/context`, `/lessons` endpoints (Hicortex ≥ 0.7).
+- The server needs the REST `/search`, `/recent`, `/lessons` endpoints (Hicortex ≥ 0.12 — this plugin version does not talk to older servers; upgrade the server first).
 
 ## Install
 

package/hermes-plugin/hicortex/__init__.py

@@ -1,7 +1,7 @@
 """Hicortex memory provider plugin for Hermes — recall-only.
 
 Recall:   prefetch()          -> GET /search   (relevant memories before each turn)
-          tools               -> hicortex_search / hicortex_recall_recent
+          tools               -> hicortex_search / hicortex_recent
           system_prompt_block -> lessons injected into the system prompt
 
 Capture is NOT the plugin's job. A nightly reader on the Hicortex server

package/hermes-plugin/hicortex/client.py

@@ -83,14 +83,14 @@ class HicortexClient:
             {"query": query, "limit": limit, "project": project, "privacy": privacy},
         ).get("results", [])
 
-    def context(
+    def recent(
         self,
         project: Optional[str] = None,
         limit: int = 10,
         privacy: Optional[str] = None,
     ) -> list[dict]:
         return self._get(
-            "/context", {"project": project, "limit": limit, "privacy": privacy}
+            "/recent", {"project": project, "limit": limit, "privacy": privacy}
         ).get("results", [])
 
     def lessons(self) -> dict[str, Any]:

package/hermes-plugin/hicortex/plugin.yaml

@@ -1,6 +1,6 @@
 name: hicortex
-version: 0.4.0
-description: "Self-learning memory for Hermes agents — every session is distilled into lessons overnight, and your agent wakes up wiser. Injects fresh lessons each turn and exposes the full 8-tool memory surface (search, context, ingest, lessons, index, graph, update, delete) via a shared Hicortex server. Stdlib-only."
+version: 0.5.0
+description: "Self-learning memory for Hermes agents — every session is distilled into lessons overnight, and your agent wakes up wiser. Injects fresh lessons each turn and exposes the full 8-tool memory surface (search, recent, ingest, lessons, index, graph, update, delete) via a shared Hicortex server. Stdlib-only."
 pip_dependencies: []
 hooks: []
 requires_env:

package/hermes-plugin/hicortex/provider.py

@@ -2,7 +2,7 @@
 
 Recall:   prefetch()          -> GET /search   (relevant memories before each turn)
           queue_prefetch()    -> GET /search   (background recall for the next turn)
-          tools               -> hicortex_search / hicortex_recall_recent
+          tools               -> hicortex_search / hicortex_recent
           system_prompt_block -> lessons + memory index injected into the prompt
 
 Capture is NOT the plugin's job. A nightly reader on the Hicortex server
@@ -152,7 +152,7 @@ class HicortexProvider(MemoryProvider):
         lines = [
             "## Hicortex long-term memory",
             "You have shared long-term memory across sessions. Use `hicortex_search` "
-            "for specific recall and `hicortex_recall_recent` for recent context.",
+            "for specific recall and `hicortex_recent` for recent memories by project.",
         ]
         if lessons:
             lines.append("Lessons:")
@@ -188,24 +188,11 @@ class HicortexProvider(MemoryProvider):
                 },
             },
             {
-                "name": "hicortex_recall_recent",
-                "description": "Recall recent context memories, optionally filtered by project.",
-                "parameters": {
-                    "type": "object",
-                    "properties": {
-                        "project": {"type": "string"},
-                        "limit": {
-                            "type": "number",
-                            "description": "Max results (default 10)",
-                        },
-                    },
-                },
-            },
-            {
-                "name": "hicortex_context",
+                "name": "hicortex_recent",
                 "description": (
-                    "Get recent context memories, optionally filtered by project. "
-                    "Useful to recall what happened recently."
+                    "Get recent memories, optionally filtered by project. Queryless recall "
+                    "of the latest memories by project, ranked by importance. Useful to "
+                    "catch up on what happened recently."
                 ),
                 "parameters": {
                     "type": "object",
@@ -335,8 +322,8 @@ class HicortexProvider(MemoryProvider):
                 )
                 return json.dumps(hits)
 
-            elif tool_name in ("hicortex_recall_recent", "hicortex_context"):
-                hits = client.context(
+            elif tool_name == "hicortex_recent":
+                hits = client.recent(
                     project=args.get("project") or self._project,
                     limit=int(args.get("limit", 10)),
                 )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.11.1",
+  "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.",
   "main": "dist/index.js",
   "bin": {

package/skills/hicortex-memory/SKILL.md

@@ -16,7 +16,7 @@ You have access to a long-term memory system that stores knowledge from past ses
 - You're about to make a decision that might contradict past work
 - Starting work on a project you've worked on before
 
-## When to use hicortex_context
+## When to use hicortex_recent
 
 - At the start of a session to recall recent project state
 - When switching between projects to load relevant context