shieldcortex 2.4.5 → 2.4.7

package/README.md

@@ -209,14 +209,47 @@ curl -X POST http://localhost:3001/api/v1/quarantine/1/reject
 
 ## OpenClaw Integration
 
+**One command. Persistent memory for every OpenClaw session.**
+
+```bash
+sudo npx shieldcortex openclaw install
+```
+
+This installs the **cortex-memory** hook directly into OpenClaw's bundled hooks directory. No configuration needed.
+
+### What It Does
+
+```
+Session Start                During Session              Session End (/new)
+     │                            │                            │
+     ▼                            ▼                            ▼
+┌─────────────┐           ┌─────────────┐           ┌─────────────┐
+│ Inject past │           │ "remember   │           │ Auto-extract│
+│ context     │           │  this: ..." │           │ decisions,  │
+│ into agent  │           │  → save     │           │ fixes, etc. │
+└─────────────┘           └─────────────┘           └─────────────┘
+```
+
+| Feature | What Happens |
+|---------|--------------|
+| **Context Injection** | On session start, relevant past memories are injected into the agent's bootstrap context |
+| **Keyword Triggers** | Say "remember this:" or "don't forget:" followed by content to save it with critical importance |
+| **Auto-Extraction** | On `/new`, the hook extracts architecture decisions, bug fixes, and learnings from the ending session |
+| **Security** | All content passes through the 5-layer defence pipeline before storage |
+
+### Shared Memory
+
+The database (`~/.shieldcortex/memories.db`) is shared with Claude Code. Memories created in OpenClaw appear instantly in Claude Code sessions, and vice versa.
+
+### Commands
+
 ```bash
-npx shieldcortex openclaw install
+sudo npx shieldcortex openclaw install    # Install hook
+sudo npx shieldcortex openclaw uninstall  # Remove hook
+npx shieldcortex openclaw status          # Check status
 ```
 
-The **cortex-memory** hook provides:
-- Auto-save on `/new` command
-- Context injection on bootstrap
-- Keyword triggers ("remember this...")
+[Full documentation](docs/openclaw-integration.md)
 
 ---
 

package/hooks/openclaw/cortex-memory/HOOK.md

@@ -7,7 +7,7 @@ metadata:
     "openclaw":
       {
         "emoji": "🧠",
-        "events": ["command:new", "agent:bootstrap", "command"],
+        "events": ["command:new", "command:stop", "agent:bootstrap", "command"],
         "requires": { "anyBins": ["npx"] },
         "install": [{ "id": "community", "kind": "community", "label": "ShieldCortex" }],
       },
@@ -25,6 +25,12 @@ Integrates [ShieldCortex](https://github.com/Drakon-Systems-Ltd/ShieldCortex) pe
 2. Pattern-matches for decisions, bug fixes, learnings, architecture changes, and preferences
 3. Saves up to 5 high-salience memories to ShieldCortex via mcporter
 
+### On `/stop`, `/clear`, `/exit` (Session End)
+1. Captures the current session transcript before it ends
+2. Pattern-matches for important content (same patterns as `/new`)
+3. Saves memories with a `session-stop` tag for tracking
+4. **Ensures work is saved** even when explicitly ending a session
+
 ### On Session Start (Agent Bootstrap)
 1. Calls Cortex `get_context` to retrieve relevant memories
 2. Injects them into the agent's bootstrap context

package/hooks/openclaw/cortex-memory/handler.js

@@ -187,6 +187,49 @@ async function onSessionEnd(event) {
   console.log(`[cortex-memory] Saved ${saved}/${memories.length} memories from session`);
 }
 
+/**
+ * Handle command:stop — extract memories before session ends
+ * This fires when user explicitly calls /stop
+ */
+async function onSessionStop(event) {
+  const context = event.context || {};
+  const sessionEntry = context.sessionEntry || {};
+  const sessionFile = sessionEntry.sessionFile;
+
+  if (!sessionFile) {
+    console.log("[cortex-memory] No session file found for stop, skipping extraction");
+    return;
+  }
+
+  const messages = await getRecentMessages(sessionFile);
+  if (messages.length === 0) {
+    console.log("[cortex-memory] No messages to extract on stop");
+    return;
+  }
+
+  const memories = extractMemories(messages);
+  if (memories.length === 0) {
+    console.log("[cortex-memory] No high-salience content found on stop");
+    return;
+  }
+
+  let saved = 0;
+  for (const mem of memories) {
+    const result = await callCortex("remember", {
+      title: mem.title,
+      content: mem.content,
+      category: mem.category,
+      project: "openclaw",
+      scope: "global",
+      importance: "high",
+      tags: "auto-extracted,openclaw-hook,session-stop",
+    });
+    if (result) saved++;
+  }
+
+  console.log(`[cortex-memory] Saved ${saved}/${memories.length} memories on session stop`);
+}
+
 /**
  * Handle agent:bootstrap — inject past context into agent
  */
@@ -216,7 +259,7 @@ async function onBootstrap(event) {
  * Handle command events — check for keyword triggers
  */
 async function onKeywordTrigger(event) {
-  if (event.action === "new" || event.action === "stop") return;
+  if (event.action === "new" || event.action === "stop" || event.action === "clear" || event.action === "exit") return;
 
   const context = event.context || {};
   const sessionEntry = context.sessionEntry || {};
@@ -263,6 +306,11 @@ const cortexMemoryHandler = async (event) => {
   try {
     if (event.type === "command" && event.action === "new") {
       await onSessionEnd(event);
+    } else if (event.type === "command" && event.action === "stop") {
+      await onSessionStop(event);
+    } else if (event.type === "command" && (event.action === "clear" || event.action === "exit")) {
+      // Also save on clear/exit - these also end the session context
+      await onSessionStop(event);
     } else if (event.type === "agent" && event.action === "bootstrap") {
       await onBootstrap(event);
     } else if (event.type === "command") {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "shieldcortex",
-  "version": "2.4.5",
-  "description": "Complete memory system + security layer for AI agents. Persistent storage, semantic search, prompt injection firewall, credential protection, and audit trail. One package, full solution.",
+  "version": "2.4.7",
+  "description": "Complete memory system + security layer for AI agents. Native OpenClaw integration. Persistent storage, semantic search, prompt injection firewall, credential protection, and audit trail. One package, full solution.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -57,7 +57,11 @@
     "ai-memory",
     "credential-protection",
     "audit-trail",
-    "trust-scoring"
+    "trust-scoring",
+    "openclaw",
+    "moltbot",
+    "clawdbot",
+    "coding-assistant"
   ],
   "author": "Michael Kyriacou",
   "license": "MIT",