@gamaze/hicortex 0.13.2 → 0.13.3

package/dist/consolidate.d.ts

@@ -12,7 +12,7 @@ import { type DomainDef } from "./domain-classify.js";
  * Minimum COSINE similarity for a link candidate.
  *
  * Calibration (2026-07): measured top-10 neighbor cosine histogram on the
- * 2945-memory production corpus (bedrock). Typical top-1 neighbor cosine:
+ * ~3000-memory production corpus. Typical top-1 neighbor cosine:
  * median 0.823, p10 0.743, p90 0.902. Threshold 0.75 combined with the
  * top-3 cap yields ≈ 2.2 candidate links/memory. The previous value (0.55)
  * lived on an accidental 1−L2 scale where it required cosine > 0.90 — a

package/dist/consolidate.js

@@ -65,7 +65,7 @@ const CONSOLIDATE_PRUNE_MIN_AGE_DAYS = 90;
  * Minimum COSINE similarity for a link candidate.
  *
  * Calibration (2026-07): measured top-10 neighbor cosine histogram on the
- * 2945-memory production corpus (bedrock). Typical top-1 neighbor cosine:
+ * ~3000-memory production corpus. Typical top-1 neighbor cosine:
  * median 0.823, p10 0.743, p90 0.902. Threshold 0.75 combined with the
  * top-3 cap yields ≈ 2.2 candidate links/memory. The previous value (0.55)
  * lived on an accidental 1−L2 scale where it required cosine > 0.90 — a

package/dist/context-cli.js

@@ -261,7 +261,7 @@ function extractAgentFlag(args) {
             // A missing value (end of args) or the next token being another flag is a
             // typo — never let it silently fall through to the global scope.
             if (val === undefined || val.startsWith("-")) {
-                throw new ContextCliError("--agent requires a value, e.g. --agent lenny");
+                throw new ContextCliError("--agent requires a value, e.g. --agent alice");
             }
             agent = val;
             i++;

package/dist/domain-classify.d.ts

@@ -5,13 +5,13 @@
  * ---------------
  * The nightly's legacy `stageDomainCuration` groups PROJECTS into domains and
  * assigns every memory its project's domain. For an owner whose "projects" are
- * often AGENT names (lenny, nano, ...), one agent produces memories spanning
+ * often AGENT names (alice, bob, ...), one agent produces memories spanning
  * many life areas, so life-memories get smeared under the agent. This module
  * classifies a single memory into life-spheres by its CONTENT, drawn from a
  * user-curated vocabulary in ~/.hicortex/config.json (`domains`).
  *
  * GRADED SCHEMA TAGS (spec 2026-07-07, supersedes the LLM-picked primary from
- * PR #152/#153): a memory genuinely spans spheres — "set up bedrock for the
+ * PR #152/#153): a memory genuinely spans spheres — "set up the server for the
  * agent fleet" is both Hardware AND Ventures. The classifier now returns ONLY
  * the discrete part:
  *   - `tags`: 0..N vocabulary names that genuinely apply, MOST-RELEVANT FIRST
@@ -31,7 +31,7 @@
  *
  * The `project` name is passed to the classifier as a HINT (content wins;
  * project only breaks ties). This rescues terse technical memories from
- * projects like raider/hiops/catalyst whose content alone reads as ambiguous.
+ * projects whose content alone reads as ambiguous.
  *
  * The classifier makes ONE constrained LLM call per memory (via the classify
  * tier — classifyModel/classifyBaseUrl when configured, else the reflect

package/dist/domain-classify.js

@@ -6,13 +6,13 @@
  * ---------------
  * The nightly's legacy `stageDomainCuration` groups PROJECTS into domains and
  * assigns every memory its project's domain. For an owner whose "projects" are
- * often AGENT names (lenny, nano, ...), one agent produces memories spanning
+ * often AGENT names (alice, bob, ...), one agent produces memories spanning
  * many life areas, so life-memories get smeared under the agent. This module
  * classifies a single memory into life-spheres by its CONTENT, drawn from a
  * user-curated vocabulary in ~/.hicortex/config.json (`domains`).
  *
  * GRADED SCHEMA TAGS (spec 2026-07-07, supersedes the LLM-picked primary from
- * PR #152/#153): a memory genuinely spans spheres — "set up bedrock for the
+ * PR #152/#153): a memory genuinely spans spheres — "set up the server for the
  * agent fleet" is both Hardware AND Ventures. The classifier now returns ONLY
  * the discrete part:
  *   - `tags`: 0..N vocabulary names that genuinely apply, MOST-RELEVANT FIRST
@@ -32,7 +32,7 @@
  *
  * The `project` name is passed to the classifier as a HINT (content wins;
  * project only breaks ties). This rescues terse technical memories from
- * projects like raider/hiops/catalyst whose content alone reads as ambiguous.
+ * projects whose content alone reads as ambiguous.
  *
  * The classifier makes ONE constrained LLM call per memory (via the classify
  * tier — classifyModel/classifyBaseUrl when configured, else the reflect

package/dist/hermes-transcript-reader.d.ts

@@ -2,7 +2,7 @@
  * Hermes transcript reader — the nightly capture path for Nous Research Hermes.
  *
  * Hermes stores conversation in a SQLite state DB, one per profile:
- *   ~/.hermes/profiles/<profile>/state.db   (per-profile agents: lenny, raider, nano)
+ *   ~/.hermes/profiles/<profile>/state.db   (per-profile agents: alice, bob, carol)
  *   ~/.hermes/state.db                       (global, non-profile setups)
  *
  * Schema (relevant columns):

package/dist/hermes-transcript-reader.js

@@ -3,7 +3,7 @@
  * Hermes transcript reader — the nightly capture path for Nous Research Hermes.
  *
  * Hermes stores conversation in a SQLite state DB, one per profile:
- *   ~/.hermes/profiles/<profile>/state.db   (per-profile agents: lenny, raider, nano)
+ *   ~/.hermes/profiles/<profile>/state.db   (per-profile agents: alice, bob, carol)
  *   ~/.hermes/state.db                       (global, non-profile setups)
  *
  * Schema (relevant columns):

package/dist/lessons-context.d.ts

@@ -69,7 +69,7 @@ export declare function renderContextBlock(sections: Record<string, string>): st
  *     into every persona; on a bare fetch (no id) the guard is off (amendment
  *     A2).
  *   - CC passes `false` ALWAYS and deliberately (see the call site): a thin CC
- *     client auto-upgrades via npx BEFORE bedrock does, so during the upgrade
+ *     client auto-upgrades via npx BEFORE the server does, so during the upgrade
  *     window it talks to a 0.12 server that cannot hold ANY per-agent config —
  *     global IS the operator's intended state there, and a guard would instead
  *     blank ALL context for every CC session in that window.

package/dist/lessons-context.js

@@ -180,7 +180,7 @@ function renderContextBlock(sections) {
  *     into every persona; on a bare fetch (no id) the guard is off (amendment
  *     A2).
  *   - CC passes `false` ALWAYS and deliberately (see the call site): a thin CC
- *     client auto-upgrades via npx BEFORE bedrock does, so during the upgrade
+ *     client auto-upgrades via npx BEFORE the server does, so during the upgrade
  *     window it talks to a 0.12 server that cannot hold ANY per-agent config —
  *     global IS the operator's intended state there, and a guard would instead
  *     blank ALL context for every CC session in that window.
@@ -216,7 +216,7 @@ async function fetchContextBlock(cfg) {
         return null;
     const data = await resp.json();
     // CC deliberately passes requireAgentEcho: false (NOT the OC/Hermes old-server
-    // guard). A thin CC client auto-upgrades via npx BEFORE bedrock does, so
+    // guard). A thin CC client auto-upgrades via npx BEFORE the server does, so
     // mid-upgrade it may hit a 0.12 server that returns global context with no
     // `agent` echo — and a 0.12 server cannot hold per-agent config, so global is
     // the intended state. Guarding here would blank ALL CC context in that window.

package/dist/pi-transcript-reader.d.ts

@@ -16,14 +16,14 @@
  *
  * Directory layout:
  *   ~/.pi/agent/sessions/
- *     --home-agents-Agents-raider--/
+ *     --home-alice-projects-myagent--/
  *       2026-04-10T18-37-44-615Z_<uuid>.jsonl
  *       2026-04-11T07-51-28-282Z_<uuid>.jsonl
  *     --home-agents-Development-MAIC--/
  *       ...
  *
- * The encoded-cwd uses double-dash separators: /home/agents/Agents/raider
- * becomes --home-agents-Agents-raider--. The session header's `cwd` field
+ * The encoded-cwd uses double-dash separators: /home/alice/projects/myagent
+ * becomes --home-alice-projects-myagent--. The session header's `cwd` field
  * is the canonical path; the directory name is a filesystem-safe encoding.
  */
 import type { TranscriptBatch, CursorMap } from "./transcript-reader.js";

package/dist/pi-transcript-reader.js

@@ -17,14 +17,14 @@
  *
  * Directory layout:
  *   ~/.pi/agent/sessions/
- *     --home-agents-Agents-raider--/
+ *     --home-alice-projects-myagent--/
  *       2026-04-10T18-37-44-615Z_<uuid>.jsonl
  *       2026-04-11T07-51-28-282Z_<uuid>.jsonl
  *     --home-agents-Development-MAIC--/
  *       ...
  *
- * The encoded-cwd uses double-dash separators: /home/agents/Agents/raider
- * becomes --home-agents-Agents-raider--. The session header's `cwd` field
+ * The encoded-cwd uses double-dash separators: /home/alice/projects/myagent
+ * becomes --home-alice-projects-myagent--. The session header's `cwd` field
  * is the canonical path; the directory name is a filesystem-safe encoding.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -157,7 +157,7 @@ function readPiTranscripts(since, sessionsDir = DEFAULT_PI_SESSIONS_DIR, cursors
 }
 /**
  * Extract the last path segment from a cwd as the project name.
- * /home/agents/Agents/raider → "raider"
+ * /home/alice/projects/myagent → "myagent"
  * Falls back to decoding the directory name if cwd is empty.
  */
 function deriveProjectName(cwd, encodedDir) {
@@ -165,7 +165,7 @@ function deriveProjectName(cwd, encodedDir) {
         const segments = cwd.split("/").filter(Boolean);
         return segments[segments.length - 1] ?? "unknown";
     }
-    // Decode the Pi directory encoding: --home-agents-Agents-raider-- → raider
+    // Decode the Pi directory encoding: --home-alice-projects-myagent-- → myagent
     const decoded = encodedDir.replace(/^--/, "").replace(/--$/, "").split("-");
     return decoded[decoded.length - 1] ?? "unknown";
 }

package/dist/transcript-reader.d.ts

@@ -15,7 +15,7 @@ export interface TranscriptBatch {
     date: string;
     entries: unknown[];
     /**
-     * Optional source-agent label (e.g. "hermes/lenny"). When set, the nightly
+     * Optional source-agent label (e.g. "hermes/alice"). When set, the nightly
      * pipeline uses it verbatim for provenance instead of the default
      * `claude-code/<project>`. Lets per-harness readers stamp their own origin.
      */

package/dist/transcript-reader.js

@@ -159,12 +159,12 @@ function parseTranscriptFile(filePath, projectName, cursorKey, startCursor, gene
 }
 /**
  * Decode CC project directory name to a human-readable project name.
- * CC uses path-based hashing: "-Users-mattias-Development-Tools-hicortex"
+ * CC uses path-based hashing: "-Users-alice-Development-Tools-hicortex"
  * becomes "hicortex" (last path component).
  */
 function decodeProjectDirName(dirName) {
     // CC encodes paths by replacing / with -
-    // e.g. "-Users-mattias-Development-Tools-hicortex"
+    // e.g. "-Users-alice-Development-Tools-hicortex"
     const parts = dirName.split("-").filter(Boolean);
     if (parts.length === 0)
         return dirName;

package/domains.example.json

@@ -9,11 +9,26 @@
     "Backfill an existing corpus with: hicortex classify-domains"
   ],
   "domains": [
-    { "name": "Work", "description": "Your job and professional life — employer, clients, workstreams" },
-    { "name": "Personal", "description": "Private life — home, hobbies, everyday matters" },
-    { "name": "People", "description": "Relationships — family, friends, social life, network" },
-    { "name": "Health", "description": "Fitness, wellbeing, medical" },
-    { "name": "Finance", "description": "Money — budgeting, spending, investing" }
+    {
+      "name": "Work",
+      "description": "Your job and professional life — employer, clients, workstreams"
+    },
+    {
+      "name": "Personal",
+      "description": "Private life — home, hobbies, everyday matters"
+    },
+    {
+      "name": "People",
+      "description": "Relationships — family, friends, social life, network"
+    },
+    {
+      "name": "Health",
+      "description": "Fitness, wellbeing, medical"
+    },
+    {
+      "name": "Finance",
+      "description": "Money — budgeting, spending, investing"
+    }
   ],
   "_powerUserExample": {
     "_readme": [
@@ -22,14 +37,39 @@
       "`weakPrimaryFloor` (default 0.45) is the minimum embedding similarity for a no-fit memory to earn a weak primary; tune it from your corpus."
     ],
     "domains": [
-      { "name": "Work", "description": "Employer, day job, client projects, workstreams", "compartment": true },
-      { "name": "Personal", "description": "Private life — home, hobbies, everyday matters" },
-      { "name": "People", "description": "Relationships — family, friends, social life, network" },
-      { "name": "Health", "description": "Fitness, wellbeing, medical" },
-      { "name": "Finance", "description": "Money — budgeting, spending, investing" },
-      { "name": "Boating", "description": "Boats — maintenance, gear, trips, harbour life" },
-      { "name": "Property", "description": "House and land — renovation, upkeep, garden" },
-      { "name": "Vehicles", "description": "Cars and other vehicles — service, repairs, purchases" }
+      {
+        "name": "Work",
+        "description": "Employer, day job, client projects, workstreams",
+        "compartment": true
+      },
+      {
+        "name": "Personal",
+        "description": "Private life — home, hobbies, everyday matters"
+      },
+      {
+        "name": "People",
+        "description": "Relationships — family, friends, social life, network"
+      },
+      {
+        "name": "Health",
+        "description": "Fitness, wellbeing, medical"
+      },
+      {
+        "name": "Finance",
+        "description": "Money — budgeting, spending, investing"
+      },
+      {
+        "name": "Photography",
+        "description": "Camera gear, shoots, editing workflow, photo projects"
+      },
+      {
+        "name": "Home",
+        "description": "House, renovation projects, maintenance, garden"
+      },
+      {
+        "name": "Travel",
+        "description": "Trips, destinations, bookings, travel plans"
+      }
     ],
     "weakPrimaryFloor": 0.5
   }

package/hermes-plugin/hicortex/provider.py

@@ -33,8 +33,8 @@ _INJECT_CONTENT_CAP = 500
 
 # Agent ids are joined into a filesystem path server-side, so they share the
 # section-name allowlist. \Z (NOT $) anchors the END OF STRING: Python's $ also
-# matches just before a trailing "\n", so "nano\n" would pass and go out as
-# agent=nano%0A → a 400 the fail-soft path silently swallows.
+# matches just before a trailing "\n", so "alice\n" would pass and go out as
+# agent=alice%0A → a 400 the fail-soft path silently swallows.
 _AGENT_ID_RE = re.compile(r"^[a-z0-9][a-z0-9_-]*\Z")
 
 
@@ -48,7 +48,7 @@ def _sanitize_agent_id(raw: Optional[str]) -> Optional[str]:
     EXACTLY so a profile resolves to the SAME id on both harnesses (a mismatch
     would make one honor the persona firewall and the other leak global context
     into an ``off``/``override`` persona): lowercase → collapse invalid runs to
-    "-" → strip leading -/_ → truncate 64 → validate. "Lenny" → "lenny";
+    "-" → strip leading -/_ → truncate 64 → validate. "Alice" → "alice";
     "MacBook-Pro.local" → "macbook-pro-local"; all-symbols → None."""
     if not isinstance(raw, str):
         return None
@@ -73,7 +73,7 @@ def _resolve_agent_name(cfg: Dict[str, Any]) -> Optional[str]:
       2. ``HERMES_PROFILE`` env;
       3. parse ``HERMES_HOME`` when it ends ``profiles/<name>``;
       4. None → bare fetch → the global set.
-    Each source is stripped then SANITIZED (not rejected) so "Lenny" → "lenny"
+    Each source is stripped then SANITIZED (not rejected) so "Alice" → "alice"
     matches the TS contract; a source that sanitizes to None yields None (bare
     fetch), never a fall-through to another identity."""
     configured = (cfg.get("agent_name") or "").strip()

package/openclaw.plugin.json

@@ -11,7 +11,7 @@
       "serverUrl": {
         "type": "string",
         "default": "http://127.0.0.1:8787",
-        "description": "Hicortex server URL. Defaults to localhost (co-located server). For multi-machine setups, point this at the remote server (e.g. http://bedrock:8787 or a Tailscale HTTPS URL)."
+        "description": "Hicortex server URL. Defaults to localhost (co-located server). For multi-machine setups, point this at the remote server (e.g. http://your-server:8787 or an HTTPS URL)."
       },
       "authToken": {
         "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamaze/hicortex",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "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": {