@gamaze/hicortex 0.11.1 → 0.12.1

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.d.ts

@@ -10,7 +10,7 @@
  *
  * Responsibilities (recall-only adapter, like the Hermes plugin):
  *   - before_agent_start  → GET /lessons (fail-soft, 3s timeout) → inject context
- *   - Tools               → HTTP proxies to /search, /context, /ingest, /lessons
+ *   - Tools               → HTTP proxies to /search, /recent, /ingest, /lessons
  *
  * CAPTURE IS NOT THIS PLUGIN'S JOB. OpenClaw persists sessions at
  * ~/.openclaw/agents/<agentId>/sessions/*.jsonl in the Pi v3 format; the

package/dist/index.js

@@ -11,7 +11,7 @@
  *
  * Responsibilities (recall-only adapter, like the Hermes plugin):
  *   - before_agent_start  → GET /lessons (fail-soft, 3s timeout) → inject context
- *   - Tools               → HTTP proxies to /search, /context, /ingest, /lessons
+ *   - Tools               → HTTP proxies to /search, /recent, /ingest, /lessons
  *
  * CAPTURE IS NOT THIS PLUGIN'S JOB. OpenClaw persists sessions at
  * ~/.openclaw/agents/<agentId>/sessions/*.jsonl in the Pi v3 format; the
@@ -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()
 // ---------------------------------------------------------------------------
@@ -50,13 +51,30 @@ async function serverGet(path, timeoutMs) {
             signal: AbortSignal.timeout(timeoutMs),
         });
         if (!resp.ok)
-            return null;
-        return await resp.json();
+            return { data: null, status: resp.status };
+        return { data: await resp.json(), status: resp.status };
     }
     catch {
-        return null;
+        return { data: null, status: null };
     }
 }
+/**
+ * Human-readable GET failure. Distinguishes a down server from an HTTP error —
+ * in particular a 404, so plugin/server version skew reads as a version
+ * problem, not a network one. The /context→/recent rename hint (0.12) is
+ * added only for /recent, where it is the overwhelmingly likely cause.
+ */
+function describeGetFailure(status, endpoint) {
+    if (status === null)
+        return "server unreachable";
+    if (status === 404) {
+        const renameHint = endpoint.startsWith("/recent")
+            ? " (0.12 renamed /context to /recent)"
+            : "";
+        return `HTTP 404 — ${endpoint} not found on the server; likely plugin/server version skew${renameHint}. Upgrade the server first.`;
+    }
+    return `server returned HTTP ${status}`;
+}
 async function serverPost(path, body, timeoutMs) {
     try {
         const resp = await fetch(`${serverUrl}${path}`, {
@@ -145,7 +163,7 @@ exports.default = {
         api.on("before_agent_start", async (_event, ctx) => {
             try {
                 // One fetch — build context and check cap from the same response.
-                const data = await serverGet("/lessons", LESSONS_TIMEOUT_MS);
+                const { data } = await serverGet("/lessons", LESSONS_TIMEOUT_MS);
                 if (!data || !data.lessons || data.lessons.length === 0)
                     return {};
                 const maxLessons = (0, features_js_1.lessonsLimit)();
@@ -199,9 +217,9 @@ exports.default = {
                         params.set("limit", String(args.limit));
                     if (args.project)
                         params.set("project", args.project);
-                    const data = await serverGet(`/search?${params}`, 10000);
+                    const { data, status } = await serverGet(`/search?${params}`, 10000);
                     if (!data)
-                        return { error: "Search failed: server unreachable" };
+                        return { error: `Search failed: ${describeGetFailure(status, "/search")}` };
                     return formatToolResults(data.results ?? []);
                 }
                 catch (err) {
@@ -210,8 +228,8 @@ exports.default = {
             },
         }), { name: "hicortex_search" });
         api.registerTool((_ctx) => ({
-            name: "hicortex_context",
-            description: "Get recent context memories, optionally filtered by project. Useful to recall what happened recently.",
+            name: "hicortex_recent",
+            description: "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",
                 properties: {
@@ -227,16 +245,16 @@ exports.default = {
                     if (args?.limit)
                         params.set("limit", String(args.limit));
                     const qs = params.toString();
-                    const data = await serverGet(`/context${qs ? `?${qs}` : ""}`, 10000);
+                    const { data, status } = await serverGet(`/recent${qs ? `?${qs}` : ""}`, 10000);
                     if (!data)
-                        return { error: "Context search failed: server unreachable" };
+                        return { error: `Recent recall failed: ${describeGetFailure(status, "/recent")}` };
                     return formatToolResults(data.results ?? []);
                 }
                 catch (err) {
-                    return { error: `Context search failed: ${err instanceof Error ? err.message : String(err)}` };
+                    return { error: `Recent recall failed: ${err instanceof Error ? err.message : String(err)}` };
                 }
             },
-        }), { name: "hicortex_context" });
+        }), { name: "hicortex_recent" });
         api.registerTool((_ctx) => ({
             name: "hicortex_ingest",
             description: "Store a new memory in long-term storage. Use for important facts, decisions, or lessons.",
@@ -284,9 +302,9 @@ exports.default = {
             },
             async execute(_callId, args, _ctx) {
                 try {
-                    const data = await serverGet("/lessons", LESSONS_TIMEOUT_MS);
+                    const { data, status } = await serverGet("/lessons", LESSONS_TIMEOUT_MS);
                     if (!data)
-                        return { error: "Lessons fetch failed: server unreachable" };
+                        return { error: `Lessons fetch failed: ${describeGetFailure(status, "/lessons")}` };
                     const lessons = data.lessons ?? [];
                     if (lessons.length === 0) {
                         return { content: [{ type: "text", text: "No lessons found." }] };
@@ -308,9 +326,9 @@ exports.default = {
             },
             async execute(_callId, _args, _ctx) {
                 try {
-                    const data = await serverGet("/index", 10000);
+                    const { data, status } = await serverGet("/index", 10000);
                     if (!data)
-                        return { error: "Index fetch failed: server unreachable" };
+                        return { error: `Index fetch failed: ${describeGetFailure(status, "/index")}` };
                     return { content: [{ type: "text", text: JSON.stringify(data) }] };
                 }
                 catch (err) {
@@ -350,9 +368,9 @@ exports.default = {
                         params.set("domain", args.domain);
                     if (args.relationship)
                         params.set("relationship", args.relationship);
-                    const data = await serverGet(`/graph?${params}`, 10000);
+                    const { data, status } = await serverGet(`/graph?${params}`, 10000);
                     if (!data)
-                        return { error: "Graph query failed: server unreachable" };
+                        return { error: `Graph query failed: ${describeGetFailure(status, "/graph")}` };
                     return { content: [{ type: "text", text: JSON.stringify(data) }] };
                 }
                 catch (err) {
@@ -432,7 +450,7 @@ exports.default = {
 // ---------------------------------------------------------------------------
 const HICORTEX_TOOLS = [
     "hicortex_search",
-    "hicortex_context",
+    "hicortex_recent",
     "hicortex_ingest",
     "hicortex_lessons",
     "hicortex_index",

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");
@@ -188,7 +190,7 @@ function installCcCommands() {
 name: learn
 description: Save an explicit learning/insight to Hicortex long-term memory. Immediate storage, no nightly wait. Use when you discover something worth remembering across sessions.
 argument-hint: <learning to save>
-allowed-tools: mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_context, mcp__hicortex__hicortex_lessons
+allowed-tools: mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_recent, mcp__hicortex__hicortex_lessons
 ---
 
 # Save Learning to Hicortex
@@ -234,7 +236,7 @@ Becomes a call to hicortex_ingest with:
 name: hicortex-activate
 description: Register a Hicortex commercial license key. Personal and noncommercial use is free; commercial use requires a per-seat license from hicortex.gamaze.com.
 argument-hint: <license-key>
-allowed-tools: Bash(mkdir:*), Bash(echo:*), Bash(launchctl:*), Bash(systemctl:*), Bash(curl:*), mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_context, mcp__hicortex__hicortex_lessons
+allowed-tools: Bash(mkdir:*), Bash(echo:*), Bash(launchctl:*), Bash(systemctl:*), Bash(curl:*), mcp__hicortex__hicortex_ingest, mcp__hicortex__hicortex_search, mcp__hicortex__hicortex_recent, mcp__hicortex__hicortex_lessons
 ---
 
 # Register Hicortex Commercial License
@@ -640,7 +642,7 @@ async function persistLlmConfig() {
     await options[selectedIdx].save();
     const selectedLabel = options[selectedIdx].label;
     if (selectedLabel.startsWith("Skip")) {
-        console.log("  No LLM configured — server will run recall-only (search/lessons/context work).\n" +
+        console.log("  No LLM configured — server will run recall-only (search/lessons/recent work).\n" +
             "  To enable capture and consolidation later, run: npx @gamaze/hicortex init");
     }
     else {
@@ -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 */ }
@@ -1282,10 +1299,12 @@ function installNightlyCron(hour) {
     const hh = String(hour).padStart(2, "0");
     // PATH must start with the binary's own directory (see installLaunchd for rationale).
     const binDir = (0, node_path_1.dirname)(binaryArgs[0]);
+    // One canonical nightly log path across platforms — status output, docs,
+    // and support instructions all reference this single location.
+    const logPath = (0, node_path_1.join)(HICORTEX_HOME, "nightly.log");
     if (os === "darwin") {
         const plistDir = (0, node_path_1.join)((0, node_os_1.homedir)(), "Library", "LaunchAgents");
         const plistPath = (0, node_path_1.join)(plistDir, "com.gamaze.hicortex-nightly.plist");
-        const logPath = (0, node_path_1.join)(HICORTEX_HOME, "nightly.log");
         // Never overwrite an existing schedule — users tune these (multi-slot
         // capture windows, quiet hours). Fresh installs only.
         if ((0, node_fs_1.existsSync)(plistPath)) {
@@ -1341,18 +1360,18 @@ ${programArgs}
         const configDir = (0, node_path_1.join)((0, node_os_1.homedir)(), ".config", "systemd", "user");
         const servicePath = (0, node_path_1.join)(configDir, "hicortex-nightly.service");
         const timerPath = (0, node_path_1.join)(configDir, "hicortex-nightly.timer");
-        // Never overwrite an existing schedule — users tune these. Fresh installs only.
-        if ((0, node_fs_1.existsSync)(timerPath)) {
-            console.log(`  ✓ Nightly timer already installed — leaving existing schedule as-is`);
-            return;
-        }
         const execStart = [...binaryArgs, "nightly"].join(" ");
+        // File logging, not journal: oneshot runs on machines with a volatile
+        // journal (e.g. Raspberry Pi defaults) otherwise fail without a trace.
+        // Same log path as the macOS plist. append: needs systemd ≥ 240 (2018).
         const service = `[Unit]
 Description=Hicortex Nightly (distill + POST)
 
 [Service]
 Type=oneshot
 ExecStart=${execStart}
+StandardOutput=append:${logPath}
+StandardError=append:${logPath}
 Environment=PATH=${binDir}:/usr/local/bin:/usr/bin:/bin
 Environment=HOME=${(0, node_os_1.homedir)()}
 WorkingDirectory=${(0, node_os_1.homedir)()}`;
@@ -1366,7 +1385,18 @@ Persistent=true
 [Install]
 WantedBy=timers.target`;
         (0, node_fs_1.mkdirSync)(configDir, { recursive: true });
+        // The .service file is ours — always refresh it so fixes (like file
+        // logging) reach existing installs. The .timer holds the user-tuned
+        // schedule and is never overwritten.
         (0, node_fs_1.writeFileSync)(servicePath, service);
+        if ((0, node_fs_1.existsSync)(timerPath)) {
+            try {
+                (0, node_child_process_1.execSync)("systemctl --user daemon-reload", { stdio: "pipe" });
+            }
+            catch { /* fine */ }
+            console.log(`  ✓ Nightly service refreshed — existing timer schedule kept as-is`);
+            return;
+        }
         (0, node_fs_1.writeFileSync)(timerPath, timer);
         try {
             (0, node_child_process_1.execSync)("systemctl --user daemon-reload", { stdio: "pipe" });

package/dist/lessons-context.d.ts

@@ -1,17 +1,30 @@
 /**
- * lessons-context — query-time lessons fetch for the CC SessionStart hook.
+ * lessons-context — query-time context injection for the CC SessionStart hook.
  *
  * Replaces file-based injection (injectLessons / injectLessonsFromServer).
- * Reads ~/.hicortex/config.json to find the server URL, GETs /lessons,
- * and prints a compact Markdown block to stdout so CC picks it up as
- * session context.
+ * Reads ~/.hicortex/config.json to find the server URL, then fetches TWO
+ * endpoints concurrently and prints a compact Markdown block to stdout so CC
+ * picks it up as session context:
+ *
+ *   GET /context  → the standing context layer (user info + rules; 0.12).
+ *                   Injected as a `## Context` block ONLY when this harness
+ *                   ("cc") is in the server-resolved `clients` list (self-gate).
+ *   GET /lessons  → episodic memory lessons + memory index, rendered as the
+ *                   existing `## Hicortex Memory` block.
+ *
+ * The two fetches run in Promise.all, each with its OWN 3 s timeout and
+ * INDEPENDENT fail-soft: a /context failure must never cost the lessons block,
+ * and vice versa. Sequential fetches would double worst-case SessionStart
+ * latency (~6 s) — see spec §7.
  *
  * Fail-soft by design: ANY failure (missing config, network error, non-2xx,
  * parse error) results in silent exit-0. A broken hook must never block a
- * CC session.
+ * CC session, and a broken /context fetch must never blank the whole output.
  */
 /**
- * Fetch lessons from the configured server and return a formatted Markdown
- * block, or null on any failure (caller should print nothing and exit 0).
+ * Fetch context + lessons concurrently and return the combined Markdown block,
+ * or null when neither yields anything (nothing to inject; caller prints
+ * nothing and exits 0). The `## Context` block is prepended before the existing
+ * `## Hicortex Memory` block.
  */
 export declare function fetchLessonsContext(): Promise<string | null>;

package/dist/lessons-context.js

@@ -1,59 +1,74 @@
 "use strict";
 /**
- * lessons-context — query-time lessons fetch for the CC SessionStart hook.
+ * lessons-context — query-time context injection for the CC SessionStart hook.
  *
  * Replaces file-based injection (injectLessons / injectLessonsFromServer).
- * Reads ~/.hicortex/config.json to find the server URL, GETs /lessons,
- * and prints a compact Markdown block to stdout so CC picks it up as
- * session context.
+ * Reads ~/.hicortex/config.json to find the server URL, then fetches TWO
+ * endpoints concurrently and prints a compact Markdown block to stdout so CC
+ * picks it up as session context:
+ *
+ *   GET /context  → the standing context layer (user info + rules; 0.12).
+ *                   Injected as a `## Context` block ONLY when this harness
+ *                   ("cc") is in the server-resolved `clients` list (self-gate).
+ *   GET /lessons  → episodic memory lessons + memory index, rendered as the
+ *                   existing `## Hicortex Memory` block.
+ *
+ * The two fetches run in Promise.all, each with its OWN 3 s timeout and
+ * INDEPENDENT fail-soft: a /context failure must never cost the lessons block,
+ * and vice versa. Sequential fetches would double worst-case SessionStart
+ * latency (~6 s) — see spec §7.
  *
  * Fail-soft by design: ANY failure (missing config, network error, non-2xx,
  * parse error) results in silent exit-0. A broken hook must never block a
- * CC session.
+ * CC session, and a broken /context fetch must never blank the whole output.
  */
 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 HICORTEX_HOME = (0, node_path_1.join)((0, node_os_1.homedir)(), ".hicortex");
+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";
 /**
- * Fetch lessons from the configured server and return a formatted Markdown
- * block, or null on any failure (caller should print nothing and exit 0).
+ * 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).
  */
-async function fetchLessonsContext() {
-    let config = {};
+function resolveConfig() {
+    const home = (0, paths_js_1.hicortexHome)();
+    let config;
     try {
-        config = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(HICORTEX_HOME, "config.json"), "utf-8"));
+        config = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(home, "config.json"), "utf-8"));
     }
     catch {
-        // No config file — server not set up yet. Fail soft.
         return null;
     }
-    // Determine server URL: client mode uses serverUrl; server mode uses localhost.
+    // Client mode uses serverUrl; server mode uses localhost.
     const serverUrl = config.mode === "client" && typeof config.serverUrl === "string"
         ? config.serverUrl.replace(/\/+$/, "")
         : `http://127.0.0.1:${config.port ?? DEFAULT_PORT}`;
-    const authToken = config.authToken;
-    let data;
-    try {
-        const resp = await fetch(`${serverUrl}/lessons`, {
-            headers: authToken ? { "Authorization": `Bearer ${authToken}` } : {},
-            signal: AbortSignal.timeout(3000),
-        });
-        if (!resp.ok)
-            return null;
-        data = await resp.json();
-    }
-    catch {
+    return { serverUrl, authToken: config.authToken, home };
+}
+function authHeaders(authToken) {
+    return authToken ? { "Authorization": `Bearer ${authToken}` } : {};
+}
+/**
+ * Fetch /lessons and build the `## Hicortex Memory` block, or null on any
+ * failure (missing/non-2xx/parse). Preserves the pre-0.12 behavior exactly.
+ */
+async function fetchLessonsBlock(cfg) {
+    const resp = await fetch(`${cfg.serverUrl}/lessons`, {
+        headers: authHeaders(cfg.authToken),
+        signal: AbortSignal.timeout(3000),
+    });
+    if (!resp.ok)
         return null;
-    }
+    const data = await resp.json();
     const maxLessons = (0, features_js_1.lessonsLimit)();
-    const moduleIndex = data.moduleIndex ?? (0, state_js_1.loadState)(HICORTEX_HOME).moduleIndex;
+    const moduleIndex = data.moduleIndex ?? (0, state_js_1.loadState)(cfg.home).moduleIndex;
     // The SessionStart hook runs in the session's working directory, whose last
     // path component matches the capture-side CC project name convention
     // (transcript-reader's decodeProjectDirName also takes the last component).
@@ -71,12 +86,11 @@ async function fetchLessonsContext() {
     const parts = ["## Hicortex Memory", ""];
     parts.push("You have access to shared long-term memory across all agents and sessions.");
     parts.push("BEFORE making decisions, search memory: `hicortex_search` for prior decisions on the same topic.");
-    parts.push("Use `hicortex_context` at session start for recent project state.");
+    parts.push("Use `hicortex_recent` at session start for recent project state.");
     if (lessonLines.length > 0) {
         parts.push("", "### Lessons (updated nightly)");
         parts.push(...lessonLines);
     }
-    // Memory index
     const { index } = data;
     if (moduleIndex && moduleIndex.domains.length > 0) {
         parts.push("", "### Memory Index");
@@ -95,3 +109,79 @@ async function fetchLessonsContext() {
     }
     return parts.join("\n");
 }
+/**
+ * Title-case a section name for its heading: split on `-`/`_`, capitalize each
+ * word ("user" → "User", "my_notes" → "My Notes").
+ */
+function titleCaseSection(name) {
+    return name
+        .split(/[-_]+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+}
+/**
+ * Stable section ordering: `user` first, then `rules` (the seeded primary
+ * sections, spec §8), then every other section alphabetically. Server-side
+ * enumeration order (readdirSync) is FS-dependent, so we sort here for a
+ * deterministic injection block.
+ */
+function orderSectionNames(names) {
+    const primaries = ["user", "rules"].filter((p) => names.includes(p));
+    const rest = names.filter((n) => n !== "user" && n !== "rules").sort();
+    return [...primaries, ...rest];
+}
+/**
+ * Fetch /context and build the `## Context` block, or null when nothing should
+ * be injected: non-2xx, this harness not in `clients`, no sections, or all
+ * sections empty. Throws propagate to the caller's fail-soft catch.
+ */
+async function fetchContextBlock(cfg) {
+    const resp = await fetch(`${cfg.serverUrl}/context`, {
+        headers: authHeaders(cfg.authToken),
+        signal: AbortSignal.timeout(3000),
+    });
+    if (!resp.ok)
+        return null;
+    const data = await resp.json();
+    // Self-gate: only inject when this harness is in the server-resolved list.
+    const clients = Array.isArray(data.clients) ? data.clients : [];
+    if (!clients.includes(THIS_HARNESS))
+        return null;
+    const sections = data.sections;
+    if (!sections || typeof sections !== "object" || Array.isArray(sections))
+        return null;
+    const names = orderSectionNames(Object.keys(sections));
+    const bodyParts = [];
+    for (const name of names) {
+        const body = sections[name];
+        if (typeof body !== "string" || body.trim() === "")
+            continue;
+        bodyParts.push(`### ${titleCaseSection(name)}`, "", body.trim());
+    }
+    if (bodyParts.length === 0)
+        return null;
+    return ["## Context", "", ...bodyParts].join("\n");
+}
+/**
+ * Fetch context + lessons concurrently and return the combined Markdown block,
+ * or null when neither yields anything (nothing to inject; caller prints
+ * nothing and exits 0). The `## Context` block is prepended before the existing
+ * `## Hicortex Memory` block.
+ */
+async function fetchLessonsContext() {
+    const cfg = resolveConfig();
+    if (!cfg)
+        return null;
+    // Independent fail-soft: each branch degrades to null without affecting the
+    // other. Promise.all runs them concurrently — each carries its own 3 s
+    // timeout, so worst-case latency stays ~3 s, not ~6 s (spec §7).
+    const [contextBlock, lessonsBlock] = await Promise.all([
+        fetchContextBlock(cfg).catch(() => null),
+        fetchLessonsBlock(cfg).catch(() => null),
+    ]);
+    const blocks = [contextBlock, lessonsBlock].filter((b) => b !== null && b !== "");
+    if (blocks.length === 0)
+        return null;
+    return blocks.join("\n\n");
+}