@gamaze/hicortex 0.14.0 → 0.14.2

package/README.md

@@ -227,7 +227,7 @@ Full docs: [hicortex.gamaze.com/docs/configuration.html](https://hicortex.gamaze
 | `/distill` | POST | Yes | Canonical capture endpoint (0.9.0+). Accepts denoised session text (`text` string or `messages` array), distills server-side, stores. Used by both server-mode and client-mode nightly jobs. |
 | `/search` | GET | Yes | Semantic memory search |
 | `/recall-index` | POST | Yes | Pushed recall index (0.14): `{session_id, prompt}` → compact one-line-per-memory block (or `null`); `{session_id, reset: true}` clears the session's dedup state. Appearing in the index marks memories *shown*, never *used* |
-| `/memory` | GET | Yes | Fetch one memory by `?id=` (0.14). Marks it as used (strengthens) — the lazy-load counterpart of `/recall-index` |
+| `/memory` | GET | Yes | Fetch one memory by `?id=` (0.14). Marks it as used (strengthens) — the lazy-load counterpart of `/recall-index`. Response includes a server-rendered `citation` (id, date, origin agent) — agents are instructed to cite memories that shape their answers, so memory influence is always visible to the user (0.14.1) |
 | `/recent` | GET | Yes | Recent memories, queryless recall (renamed from `/context` in 0.12) |
 | `/context` | GET / PUT | Yes | Standing [context layer](#context-layer): read all sections / partial-upsert named sections. `?agent=<id>` selects a [per-agent scope](#per-agent-context-013) (server resolves override/global/off + merge); invalid id → 400. Recall-style query params on GET → 400 (use `/recent`) |
 | `/context/ui` | GET | No* | Web editor for the context layer (shell served without auth, like `/viz`; data via `/context`) |

package/dist/mcp-server.js

@@ -124,7 +124,7 @@ function createMcpServer() {
         }
     });
     // -- hicortex_get --
-    server.tool("hicortex_get", "Fetch ONE memory's full content by id — use this to lazy-load entries from the '## Memory recall (auto)' 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.", {
+    server.tool("hicortex_get", "Fetch ONE memory's full content by id — use this to lazy-load entries from the '## Memory recall (auto)' 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 to the user (id + date + origin agent).", {
         id: zod_1.z.string().describe("Memory id (as shown in recall index/search results)"),
     }, async ({ id }) => {
         if (!db)
@@ -135,7 +135,12 @@ function createMcpServer() {
                 return { content: [{ type: "text", text: `No memory with id ${id}` }], isError: true };
             // Real use → full strengthen (access_count + hardening + prune shield).
             storage.strengthenMemory(db, id, new Date().toISOString());
-            const header = `[${mem.memory_type ?? "episode"}] ${mem.project ?? ""} ${mem.created_at ?? ""}`.trim();
+            // Provenance header (built-in citing norm, 0.14.1): id, type, project,
+            // ORIGIN AGENT (shared brain — the memory may come from another
+            // agent's session), and date, plus the explicit citation instruction.
+            const date = (mem.created_at ?? "").slice(0, 10);
+            const header = `[memory ${mem.id} | ${mem.memory_type ?? "episode"} | ${mem.project ?? "-"} | from ${mem.source_agent ?? "unknown"} | ${date}]\n` +
+                `Cite as (memory ${String(mem.id).slice(0, 8)}, ${date}) where this shapes your answer; it may be stale — newer memories supersede older.`;
             return { content: [{ type: "text", text: `${header}\n\n${mem.content ?? ""}` }] };
         }
         catch (err) {
@@ -673,7 +678,13 @@ async function startServer(options = {}) {
                 return;
             }
             storage.strengthenMemory(db, id, new Date().toISOString());
-            res.json({ memory: mem });
+            // `citation` is server-rendered so every plugin surfaces the same
+            // built-in provenance norm (owner directive 27.07) — see #193.
+            const date = (mem.created_at ?? "").slice(0, 10);
+            res.json({
+                memory: mem,
+                citation: `(memory ${String(mem.id).slice(0, 8)}, ${date}, from ${mem.source_agent ?? "unknown"})`,
+            });
         }
         catch (err) {
             res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
@@ -1260,7 +1271,10 @@ function fixDaemonVersionPin() {
 function formatResults(results) {
     if (results.length === 0)
         return "No memories found.";
+    // The id makes every recall surface feed the rest of the toolset: cite-on-use
+    // (id + date), hicortex_get lazy-load of truncated content, hicortex_graph
+    // entry points, and hicortex_update/delete self-correction (#192).
     return results
-        .map((r) => `[${r.memory_type}] (score: ${r.score.toFixed(3)}, strength: ${r.effective_strength.toFixed(3)}) ${r.content.slice(0, 500)}`)
+        .map((r) => `[${r.id}] [${r.memory_type}] (${(r.created_at ?? "").slice(0, 10)}, score: ${r.score.toFixed(3)}, strength: ${r.effective_strength.toFixed(3)}) ${r.content.slice(0, 500)}`)
         .join("\n\n");
 }

package/dist/recall-index.js

@@ -144,7 +144,13 @@ async function handleRecallIndex(deps, body) {
     const lines = picked.map((r) => formatIndexLine(r));
     const block = [
         "## Memory recall (auto)",
-        "Possibly relevant long-term memories. Fetch full content with `hicortex_get(id)` ONLY for entries relevant to the current task:",
+        // Provenance is BUILT IN, split by function (owner decision 27.07,
+        // option D): this header carries only the SELECTION-time rules —
+        // supersession (the one moment competing dates are visible side by side)
+        // and cite-what-you-rely-on (covers snippet-only use, the common case per
+        // the 0.14.0 field test). The full citation format + origin agent ride on
+        // the hicortex_get response / GET /memory `citation` field (use-time).
+        "Possibly relevant memories — dates matter, newer supersedes older. Fetch full content with `hicortex_get(id)` only when relevant; cite any memory you rely on (id, date):",
         ...lines,
     ].join("\n");
     return { status: 200, body: { block, shown: ids, turn } };

package/package.json

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