@gamaze/hicortex 0.15.2 → 0.16.0

package/dist/types.d.ts

@@ -40,6 +40,10 @@ export interface MemorySearchResult {
     access_count: number;
     memory_type: string;
     project: string | null;
+    /** Origin agent (e.g. "hermes/atlas", "cc/mbp5") — surfaced in the recall
+     *  one-liner so agents can calibrate trust (#202 provenance). Optional on the
+     *  result type (matches how `domain` is threaded) to avoid breaking fixtures. */
+    source_agent?: string | null;
     created_at: string;
     connections: number;
     /** True cosine similarity to the query for vector-matched candidates; null

package/dist/uninstall.js

@@ -101,14 +101,28 @@ async function runUninstall() {
         }
         catch { /* no settings */ }
     }
-    // 3. Remove CC custom commands
+    // 3. Remove CC custom commands — only files we actually wrote. `learn.md` is
+    // a generic name a user may own; guard on the "hicortex" marker the installer
+    // always embedded, so uninstall never deletes an unrelated user command.
+    let removedCmds = 0;
     for (const cmd of ["learn.md", "hicortex-activate.md"]) {
         const cmdPath = (0, node_path_1.join)(CC_COMMANDS_DIR, cmd);
-        if ((0, node_fs_1.existsSync)(cmdPath)) {
-            (0, node_fs_1.unlinkSync)(cmdPath);
+        if (!(0, node_fs_1.existsSync)(cmdPath))
+            continue;
+        try {
+            if (!(0, node_fs_1.readFileSync)(cmdPath, "utf-8").toLowerCase().includes("hicortex")) {
+                console.log(`  ⚠ Skipping ${cmd} — not a Hicortex file, left untouched`);
+                continue;
+            }
+        }
+        catch {
+            continue;
         }
+        (0, node_fs_1.unlinkSync)(cmdPath);
+        removedCmds++;
     }
-    console.log("  ✓ Removed /learn and /hicortex-activate commands");
+    if (removedCmds > 0)
+        console.log(`  ✓ Removed ${removedCmds} legacy CC command${removedCmds > 1 ? "s" : ""} (/learn, /hicortex-activate)`);
     // 4. Remove SessionStart hook (JSON merge — filter out entries containing "lessons-context")
     try {
         const raw = (0, node_fs_1.readFileSync)(CC_SETTINGS, "utf-8");

package/hermes-plugin/hicortex/client.py

@@ -218,13 +218,15 @@ class HicortexClient:
         reset: bool = False,
         project: Optional[str] = None,
         privacy: Optional[str] = None,
+        mission_domains: Optional[list[str]] = None,
     ) -> tuple[int, dict[str, Any]]:
         """Pushed recall index (0.14). ``prompt`` → ``{block, shown, turn}``
         where ``block`` is None when nothing is new/relevant; ``reset=True``
-        clears the session's server-side dedup (context rebuilt). ``project``
-        and ``privacy`` (CSV accepted server-side) scope the recall exactly
-        like the legacy /search prefetch did. Returns the status so the caller
-        can old-server-guard on 404 (pre-0.14)."""
+        clears the session's server-side dedup (context rebuilt). ``project``,
+        ``privacy`` (CSV accepted server-side), and ``mission_domains`` (list)
+        scope the recall — all SOFT on a 0.16+ server (affinity boosts, never
+        hard filters); ``project``/``privacy`` stay hard on older servers.
+        Returns the status so the caller can old-server-guard on 404."""
         body: dict[str, Any] = {"session_id": session_id}
         if reset:
             body["reset"] = True
@@ -234,6 +236,8 @@ class HicortexClient:
                 body["project"] = project
             if privacy:
                 body["privacy"] = privacy
+            if mission_domains:
+                body["mission_domains"] = mission_domains
         return self._post("/recall-index", body, timeout=self.RECALL_TIMEOUT)
 
     def get_memory(

package/hermes-plugin/hicortex/config.py

@@ -71,6 +71,17 @@ CONFIG_SCHEMA: list[dict[str, Any]] = [
         ),
         "required": False,
     },
+    {
+        "key": "mission_domains",
+        "label": "Mission domains",
+        "description": (
+            "Comma-separated knowledge domains this agent works in (e.g. Health, "
+            "or Finance,Work). Recall boosts memories tagged into these domains "
+            "(soft — never excludes others). Pick from the domains in your "
+            "Hicortex config; leave blank for a general-purpose agent."
+        ),
+        "required": False,
+    },
     # NOTE: recall-only plugin — no capture config. Capture is handled by the
     # nightly server-side reader of each agent's session store.
 ]

package/hermes-plugin/hicortex/provider.py

@@ -152,6 +152,7 @@ class HicortexProvider(MemoryProvider):
         self._project: Optional[str] = None
         self._recall_limit: int = 5
         self._privacy: Optional[str] = "WORK,PERSONAL"
+        self._mission_domains: List[str] = []  # #203 scope (set from config in initialize)
         self._agent_name: Optional[str] = None
         self._prefetch_cache: Dict[str, str] = {}
         self._bg_threads: List[threading.Thread] = []
@@ -208,6 +209,10 @@ class HicortexProvider(MemoryProvider):
         except (TypeError, ValueError):
             self._recall_limit = 5
         self._privacy = cfg.get("privacy_filter", "WORK,PERSONAL")
+        # #203 scope: declared knowledge domains for this role-bound agent
+        # (e.g. Lenny → Health). Soft affinity boost on recall; never excludes.
+        _md_raw = cfg.get("mission_domains") or ""
+        self._mission_domains = [d.strip() for d in _md_raw.split(",") if d.strip()]
         self._agent_name = _resolve_agent_name(cfg)
         try:
             self._client = self._build_client()
@@ -290,6 +295,7 @@ class HicortexProvider(MemoryProvider):
                     prompt=query,
                     project=self._project,
                     privacy=self._privacy,
+                    mission_domains=self._mission_domains,
                 )
                 if status == 404:
                     # Old-server guard: pre-0.14 has no /recall-index. Latch
@@ -475,8 +481,11 @@ class HicortexProvider(MemoryProvider):
                     "Fetch ONE memory's full content by id — use this to lazy-load "
                     "entries from the recall index or from search results whose "
                     "snippet was not enough. Fetching a memory marks it as used "
-                    "(strengthens it), so only fetch what you actually need. When "
-                    "the memory shapes your answer, cite it as given in the response."
+                    "(strengthens it), so fetch entries that could change your "
+                    "action — not every shown one. When the memory shapes your "
+                    "answer, cite it as given in the response — mark a fetched "
+                    "memory FETCHED and a one-line entry cited unread SNIPPET; "
+                    "don't pass SNIPPET off as established."
                 ),
                 "parameters": {
                     "type": "object",

package/openclaw.plugin.json

@@ -4,7 +4,7 @@
   "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.10.0",
   "kind": "lifecycle",
-  "skills": ["./skills/hicortex-memory", "./skills/hicortex-learn", "./skills/hicortex-activate"],
+  "skills": ["./skills/hicortex-memory"],
   "configSchema": {
     "type": "object",
     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.15.2",
+  "version": "0.16.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": {
@@ -38,6 +38,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "eval": "node dist/eval/run-eval.js",
+    "eval:recall-sweep": "node dist/eval/recall-sweep.js",
     "prepack": "npm run build && rm -rf ./hermes-plugin && mkdir -p ./hermes-plugin && cp -r ../../hermes-plugin/hicortex ./hermes-plugin/ && find ./hermes-plugin -name __pycache__ -type d -exec rm -rf {} + 2>/dev/null || true",
     "prepublishOnly": "npm run build && rm -rf ./hermes-plugin && mkdir -p ./hermes-plugin && cp -r ../../hermes-plugin/hicortex ./hermes-plugin/ && find ./hermes-plugin -name __pycache__ -type d -exec rm -rf {} + 2>/dev/null || true"
   },

package/skills/hicortex-activate/SKILL.md

@@ -1,53 +0,0 @@
----
-name: hicortex-activate
-description: Activate a Hicortex license key. Use when the user says they purchased Hicortex, has a license key, or wants to upgrade from the free tier.
-version: 0.2.0
-user-invocable: true
-disable-model-invocation: false
----
-
-# Activate Hicortex License
-
-When the user wants to activate their license key, guide them through it.
-
-## If they provide the key (e.g. `/hicortex-activate hctx-abc123`)
-
-Run this command to apply the key:
-
-```bash
-openclaw config set plugins.entries.hicortex.config.licenseKey "THE_KEY_HERE"
-```
-
-Then restart the gateway:
-
-```bash
-openclaw gateway restart
-```
-
-Tell the user: "License activated! Hicortex now has unlimited memory. Your agent will keep learning and improving from every session."
-
-## If they don't have a key yet
-
-Tell them:
-
-"You can get a license key at https://hicortex.gamaze.com/ — after purchase, you'll receive your key by email. Then come back and tell me the key, and I'll activate it for you."
-
-## If activation fails
-
-If the `openclaw config set` command fails, fall back to telling the user to manually add it:
-
-"Open ~/.openclaw/openclaw.json, find the hicortex plugin entry, and add your key:
-
-```json
-"config": {
-  "licenseKey": "hctx-your-key-here"
-}
-```
-
-Then restart: `openclaw gateway restart`"
-
-## Rules
-
-- Never ask the user to open a terminal or edit files unless the automatic method fails
-- Always confirm the key was applied by checking the gateway log after restart
-- Be encouraging — they just bought the product

package/skills/hicortex-learn/SKILL.md

@@ -1,40 +0,0 @@
----
-name: hicortex-learn
-description: Save an explicit learning or insight to Hicortex long-term memory. Use when you discover something worth remembering across sessions — a lesson, a correction, a pattern, a decision.
-version: 0.2.0
-user-invocable: true
-disable-model-invocation: false
----
-
-# Save Learning to Hicortex
-
-When invoked with `/learn <text>`, store the learning in long-term memory via hicortex_ingest.
-
-## Steps
-
-1. Parse the text after `/learn`
-2. Clean it up into a clear, self-contained statement that will make sense months from now
-3. Add today's date
-4. Call the `hicortex_ingest` tool with:
-   - `content`: The learning text
-   - `project`: "global" (unless clearly project-specific)
-   - `memory_type`: "lesson"
-
-## Example
-
-```
-/learn always check provider docs before assuming an API uses the same auth scheme as OpenAI
-```
-
-Becomes:
-```
-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
-
-- Keep it concise — one clear statement
-- Include the "why" when relevant
-- Include the date for temporal context
-- Prefix with "LEARNING:" so it's identifiable in search
-- Confirm to the user what was saved (title + confirmation)