@memoire-ai/collector 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @memoire-ai/collector@0.1.0 build /Users/dekai/Documents/esprit/Memoire/packages/collector
+> tsc
+

package/.turbo/turbo-test.log

@@ -0,0 +1,45 @@
+
+> @memoire/collector@0.1.0 test /Users/dekai/Documents/esprit/Memoire/packages/collector
+> node --test dist/*.test.js
+
+✔ ClientSummarizer parses Anthropic responses (32.023959ms)
+✔ ClientSummarizer parses native Claude JSON output (0.262209ms)
+✔ ClientSummarizer parses native Codex JSONL output (0.177791ms)
+✔ ClientSummarizer returns null on command failure (0.117208ms)
+✔ ClientSummarizer truncates summary to 180 chars (0.123583ms)
+✔ ClientSummarizer limits concepts to 12 (0.120959ms)
+✔ ClientSummarizer handles session_summary details (0.110875ms)
+✔ readMemoireConfig loads the shared config file (0.912834ms)
+✔ createCollectorFromConfig instantiates a collector from the shared config (1.790458ms)
+✔ createCollectorFromConfig enables client-side summarization from config (0.491209ms)
+✔ createCollectorFromConfig does not enable summarizer without anthropic key (6.794375ms)
+✔ createCollectorFromConfig uses native Claude mode when requested and CLI is available (0.768958ms)
+✔ createCollectorFromConfig uses native Codex mode when requested and CLI is available (0.618792ms)
+✔ buildCursorRulesContent compacts oversized resume content into the token budget (3.015416ms)
+✔ buildCursorRulesContent keeps structured cursor rules bounded too (0.223375ms)
+✔ ContentDedup allows first occurrence (0.450042ms)
+✔ ContentDedup blocks duplicate within window (0.075958ms)
+✔ ContentDedup allows different content (0.059166ms)
+✔ ContentDedup allows content after window expires (84.420875ms)
+✔ ContentDedup disabled when windowMs is 0 (0.141833ms)
+✔ ContentDedup distinguishes same content with different keys (0.0685ms)
+✔ ContentDedup.destroy cleans up (0.068042ms)
+✔ hooks send user prompts as prompt events with request framing (0.740208ms)
+✔ hooks classify decisions, attempts, conventions, and branch events (0.918125ms)
+✔ inferToolUseEventType respects hints and failure signals (0.165041ms)
+✔ stripPrivateTags removes single private block (4.070708ms)
+✔ stripPrivateTags removes multiple private blocks (0.078666ms)
+✔ stripPrivateTags handles multiline private content (0.046791ms)
+✔ stripPrivateTags is case-insensitive (0.04375ms)
+✔ stripPrivateTags returns content unchanged when no tags present (0.041875ms)
+✔ stripPrivateTags returns empty string for fully private content (0.221834ms)
+✔ stripPrivateFromOptions strips strings and string arrays (1.733667ms)
+✔ stripPrivateFromOptions returns undefined for undefined input (0.047375ms)
+ℹ tests 33
+ℹ suites 0
+ℹ pass 33
+ℹ fail 0
+ℹ cancelled 0
+ℹ skipped 0
+ℹ todo 0
+ℹ duration_ms 167.269875

package/cursor-hooks/README.md

@@ -0,0 +1,119 @@
+# Memoire Cursor Hooks
+
+Automatic context injection for [Cursor IDE](https://cursor.com) using Cursor's hooks system.
+
+This implements the **3-point injection** approach (inspired by claude-mem):
+
+| Hook | When | What it does |
+|------|------|-------------|
+| `beforeSubmitPrompt` | Before every prompt | Fetches latest project context from Memoire and writes `.cursor/rules/memoire-context.mdc` so Cursor auto-includes it |
+| `stop` | Session ends | Sends a session summary event to Memoire and refreshes the context file |
+| `afterMCPExecution` | After MCP tool calls | Records tool usage as observations in Memoire |
+
+## Quick Setup
+
+### Option A: Programmatic (recommended)
+
+```typescript
+import { installCursorHooks } from '@memoire/collector';
+
+installCursorHooks('/path/to/project', 'http://127.0.0.1:3100', 'your-api-key');
+```
+
+### Option B: Manual
+
+1. **Copy hooks config** to your project root:
+
+   ```sh
+   cp hooks.json <project-root>/.cursor/hooks.json
+   ```
+
+2. **Copy hook scripts** to your project:
+
+   ```sh
+   mkdir -p <project-root>/.cursor/hooks
+   cp context-inject.sh session-summary.sh save-observation.sh <project-root>/.cursor/hooks/
+   chmod +x <project-root>/.cursor/hooks/*.sh
+   ```
+
+3. **Configure credentials** — create `~/.memoire/config`:
+
+   ```sh
+   MEMOIRE_API_URL=http://127.0.0.1:3100
+   MEMOIRE_API_KEY=your-api-key
+   MEMOIRE_ORG_ID=your-org-id
+   MEMOIRE_PROJECT_ID=your-project-id
+   MEMOIRE_USER_ID=your-user-id
+   ```
+
+4. **Restart Cursor** to pick up the hooks.
+
+## Configuration
+
+Scripts read configuration from environment variables first, then fall back to `~/.memoire/config`.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MEMOIRE_API_URL` | Memoire API base URL | `http://127.0.0.1:3100` |
+| `MEMOIRE_API_KEY` | API key for authentication | — |
+| `MEMOIRE_ORG_ID` | Organization ID | — |
+| `MEMOIRE_PROJECT_ID` | Project ID | — |
+| `MEMOIRE_USER_ID` | User ID | — |
+| `MEMOIRE_SESSION_ID` | Session ID (auto-generated) | `cursor-<timestamp>-<pid>` |
+| `MEMOIRE_CLIENT` | Client identifier | `cursor` |
+| `MEMOIRE_CONFIG_FILE` | Path to config file | `~/.memoire/config` |
+
+## Config File Format
+
+The config file uses simple `KEY=VALUE` format (one per line):
+
+```
+# Memoire configuration
+MEMOIRE_API_URL=http://127.0.0.1:3100
+MEMOIRE_API_KEY=mem_abc123
+MEMOIRE_ORG_ID=550e8400-e29b-41d4-a716-446655440000
+MEMOIRE_PROJECT_ID=6ba7b810-9dad-11d1-80b4-00c04fd430c8
+MEMOIRE_USER_ID=7c9e6679-7425-40de-944b-e07fc1f90ae7
+```
+
+Values may optionally be quoted with single or double quotes. Comments start with `#`.
+
+## Design Principles
+
+- **Idempotent** — safe to run multiple times; uses atomic file writes
+- **Fail-silent** — all scripts exit 0 on any error; never blocks the IDE
+- **Fast** — 3-second timeout on all API calls
+- **POSIX sh** — no bash-isms; works on macOS, Linux, WSL
+- **No dependencies** — only uses `curl`, `sed`, `cat`, `mkdir`, `mv`
+
+## How It Works
+
+### beforeSubmitPrompt (context-inject.sh)
+
+1. Reads config from env / `~/.memoire/config`
+2. Calls `POST /v1/context/assemble` with profile + facts + recent activity
+3. Writes the assembled context to `.cursor/rules/memoire-context.mdc`
+4. Cursor's `alwaysApply: true` frontmatter auto-includes it in every prompt
+
+### stop (session-summary.sh)
+
+1. Sends a `session_summary` event to `POST /v1/events`
+2. Fetches the latest dashboard summary from `POST /v1/dashboard/summary`
+3. Updates `.cursor/rules/memoire-context.mdc` with the summary
+
+### afterMCPExecution (save-observation.sh)
+
+1. Receives tool name and status as arguments
+2. Classifies as `observation` (success) or `attempt` (error)
+3. Sends event to `POST /v1/events` with MCP tool metadata
+
+## .gitignore
+
+Add to your `.gitignore`:
+
+```
+# Memoire auto-generated context (per-user, not committed)
+.cursor/rules/memoire-context.mdc
+```
+
+The hook scripts themselves (`.cursor/hooks/`) _can_ be committed so the whole team benefits.

package/cursor-hooks/context-inject.sh

@@ -0,0 +1,118 @@
+#!/bin/sh
+# Memoire context injection hook for Cursor IDE
+# Called via beforeSubmitPrompt — fetches latest project context
+# and writes .cursor/rules/memoire-context.mdc so Cursor auto-includes it.
+#
+# Usage: sh context-inject.sh ["prompt text"]
+#
+# Environment:
+#   MEMOIRE_API_URL  - API base URL (default: http://127.0.0.1:3100)
+#   MEMOIRE_API_KEY  - API key for authentication
+#   MEMOIRE_ORG_ID   - Organization ID
+#   MEMOIRE_PROJECT_ID - Project ID
+#   MEMOIRE_USER_ID  - User ID
+#
+# Falls back to ~/.memoire/config for any unset values.
+# Fails silently — never blocks the IDE.
+
+set -e
+
+# ---------------------------------------------------------------------------
+# Config loading
+# ---------------------------------------------------------------------------
+
+CONFIG_FILE="${MEMOIRE_CONFIG_FILE:-$HOME/.memoire/config}"
+
+load_config() {
+  if [ -f "$CONFIG_FILE" ]; then
+    while IFS='=' read -r key value; do
+      # skip comments and blank lines
+      case "$key" in
+        ''|\#*) continue ;;
+      esac
+      # strip surrounding whitespace / quotes
+      value=$(printf '%s' "$value" | sed "s/^[[:space:]]*[\"']\\{0,1\\}//;s/[\"']\\{0,1\\}[[:space:]]*$//")
+      case "$key" in
+        MEMOIRE_API_URL)   [ -z "$MEMOIRE_API_URL" ]   && MEMOIRE_API_URL="$value" ;;
+        MEMOIRE_API_KEY)   [ -z "$MEMOIRE_API_KEY" ]   && MEMOIRE_API_KEY="$value" ;;
+        MEMOIRE_ORG_ID)    [ -z "$MEMOIRE_ORG_ID" ]    && MEMOIRE_ORG_ID="$value" ;;
+        MEMOIRE_PROJECT_ID) [ -z "$MEMOIRE_PROJECT_ID" ] && MEMOIRE_PROJECT_ID="$value" ;;
+        MEMOIRE_USER_ID)   [ -z "$MEMOIRE_USER_ID" ]   && MEMOIRE_USER_ID="$value" ;;
+      esac
+    done < "$CONFIG_FILE"
+  fi
+}
+
+load_config
+
+API_URL="${MEMOIRE_API_URL:-http://127.0.0.1:3100}"
+API_KEY="${MEMOIRE_API_KEY:-}"
+ORG_ID="${MEMOIRE_ORG_ID:-}"
+PROJECT_ID="${MEMOIRE_PROJECT_ID:-}"
+USER_ID="${MEMOIRE_USER_ID:-}"
+
+# Bail if required IDs are missing
+if [ -z "$ORG_ID" ] || [ -z "$PROJECT_ID" ] || [ -z "$USER_ID" ]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Fetch assembled context from Memoire API
+# ---------------------------------------------------------------------------
+
+AUTH_HEADER=""
+if [ -n "$API_KEY" ]; then
+  AUTH_HEADER="Authorization: Bearer ${API_KEY}"
+fi
+
+RESPONSE=$(curl -sf --max-time 3 \
+  -X POST \
+  -H "Content-Type: application/json" \
+  ${AUTH_HEADER:+-H "$AUTH_HEADER"} \
+  -d "{
+    \"org_id\": \"${ORG_ID}\",
+    \"project_id\": \"${PROJECT_ID}\",
+    \"viewer_user_id\": \"${USER_ID}\",
+    \"sections\": [\"profile\", \"facts\", \"recent_activity\"],
+    \"max_tokens\": 2000
+  }" \
+  "${API_URL}/v1/context/assemble" 2>/dev/null) || exit 0
+
+# Extract context_block from JSON response (lightweight — no jq dependency)
+# The assemble endpoint returns { context_block: "..." }
+CONTEXT_BLOCK=$(printf '%s' "$RESPONSE" | sed -n 's/.*"context_block"[[:space:]]*:[[:space:]]*"//p' | sed 's/".*//' | sed 's/\\n/\
+/g; s/\\t/\t/g; s/\\"/"/g; s/\\\\/\\/g')
+
+if [ -z "$CONTEXT_BLOCK" ]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Write .cursor/rules/memoire-context.mdc
+# ---------------------------------------------------------------------------
+
+RULES_DIR=".cursor/rules"
+RULES_FILE="${RULES_DIR}/memoire-context.mdc"
+TEMP_FILE="${RULES_FILE}.tmp"
+
+mkdir -p "$RULES_DIR"
+
+# Build the MDC file with frontmatter
+cat > "$TEMP_FILE" << 'FRONTMATTER'
+---
+alwaysApply: true
+description: "Memoire shared memory context (auto-updated by hook)"
+---
+FRONTMATTER
+
+printf '\n# Memoire Context\n\n' >> "$TEMP_FILE"
+printf '> Auto-injected by Memoire beforeSubmitPrompt hook.\n' >> "$TEMP_FILE"
+printf '> Use Memoire MCP tools for deeper queries.\n\n' >> "$TEMP_FILE"
+printf '%s\n' "$CONTEXT_BLOCK" >> "$TEMP_FILE"
+printf '\n---\n' >> "$TEMP_FILE"
+printf '*Use Memoire MCP tools (`search_context`, `project_profile`, `oracle_research`) for detailed queries.*\n' >> "$TEMP_FILE"
+
+# Atomic write
+mv "$TEMP_FILE" "$RULES_FILE"
+
+exit 0

package/cursor-hooks/hooks.json

@@ -0,0 +1,39 @@
+{
+  "hooks": {
+    "beforeSubmitPrompt": [
+      {
+        "command": "sh .cursor/hooks/context-inject.sh \"$PROMPT\"",
+        "description": "Inject Memoire project context into Cursor rules",
+        "blocking": true
+      }
+    ],
+    "stop": [
+      {
+        "command": "sh .cursor/hooks/session-summary.sh",
+        "description": "Generate Memoire session summary",
+        "blocking": false
+      }
+    ],
+    "afterMCPExecution": [
+      {
+        "command": "sh .cursor/hooks/save-observation.sh \"$TOOL_NAME\" \"$TOOL_STATUS\"",
+        "description": "Track MCP tool calls in Memoire",
+        "blocking": false
+      }
+    ],
+    "afterShellExecution": [
+      {
+        "command": "sh .cursor/hooks/save-shell-execution.sh \"$COMMAND\" \"$EXIT_CODE\"",
+        "description": "Track shell commands in Memoire",
+        "blocking": false
+      }
+    ],
+    "afterFileEdit": [
+      {
+        "command": "sh .cursor/hooks/save-file-edit.sh \"$FILE_PATH\"",
+        "description": "Track file edits in Memoire",
+        "blocking": false
+      }
+    ]
+  }
+}

package/cursor-hooks/save-file-edit.sh

@@ -0,0 +1,130 @@
+#!/bin/sh
+# Memoire file edit hook for Cursor IDE
+# Called via afterFileEdit — records file modifications as observation events
+# so Memoire can track which files the developer is working on.
+#
+# Usage: sh save-file-edit.sh ["file_path"]
+#
+# Arguments:
+#   $1 - Path of the file that was edited
+#
+# Environment:
+#   MEMOIRE_API_URL    - API base URL (default: http://127.0.0.1:3100)
+#   MEMOIRE_API_KEY    - API key for authentication
+#   MEMOIRE_ORG_ID     - Organization ID
+#   MEMOIRE_PROJECT_ID - Project ID
+#   MEMOIRE_USER_ID    - User ID
+#   MEMOIRE_SESSION_ID - Session ID (auto-generated if unset)
+#
+# Falls back to ~/.memoire/config for any unset values.
+# Fails silently — never blocks the IDE.
+
+set -e
+
+FILE_PATH="${1:-unknown}"
+
+# ---------------------------------------------------------------------------
+# Config loading
+# ---------------------------------------------------------------------------
+
+CONFIG_FILE="${MEMOIRE_CONFIG_FILE:-$HOME/.memoire/config}"
+
+load_config() {
+  if [ -f "$CONFIG_FILE" ]; then
+    while IFS='=' read -r key value; do
+      case "$key" in
+        ''|\#*) continue ;;
+      esac
+      value=$(printf '%s' "$value" | sed "s/^[[:space:]]*[\"']\\{0,1\\}//;s/[\"']\\{0,1\\}[[:space:]]*$//")
+      case "$key" in
+        MEMOIRE_API_URL)    [ -z "$MEMOIRE_API_URL" ]    && MEMOIRE_API_URL="$value" ;;
+        MEMOIRE_API_KEY)    [ -z "$MEMOIRE_API_KEY" ]    && MEMOIRE_API_KEY="$value" ;;
+        MEMOIRE_ORG_ID)     [ -z "$MEMOIRE_ORG_ID" ]     && MEMOIRE_ORG_ID="$value" ;;
+        MEMOIRE_PROJECT_ID) [ -z "$MEMOIRE_PROJECT_ID" ] && MEMOIRE_PROJECT_ID="$value" ;;
+        MEMOIRE_USER_ID)    [ -z "$MEMOIRE_USER_ID" ]    && MEMOIRE_USER_ID="$value" ;;
+        MEMOIRE_SESSION_ID) [ -z "$MEMOIRE_SESSION_ID" ] && MEMOIRE_SESSION_ID="$value" ;;
+        MEMOIRE_CLIENT)     [ -z "$MEMOIRE_CLIENT" ]     && MEMOIRE_CLIENT="$value" ;;
+      esac
+    done < "$CONFIG_FILE"
+  fi
+}
+
+load_config
+
+API_URL="${MEMOIRE_API_URL:-http://127.0.0.1:3100}"
+API_KEY="${MEMOIRE_API_KEY:-}"
+ORG_ID="${MEMOIRE_ORG_ID:-}"
+PROJECT_ID="${MEMOIRE_PROJECT_ID:-}"
+USER_ID="${MEMOIRE_USER_ID:-}"
+SESSION_ID="${MEMOIRE_SESSION_ID:-cursor-$(date +%s)-$$}"
+CLIENT="${MEMOIRE_CLIENT:-cursor}"
+
+if [ -z "$ORG_ID" ] || [ -z "$PROJECT_ID" ] || [ -z "$USER_ID" ]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Extract file metadata for richer concepts
+# ---------------------------------------------------------------------------
+
+FILE_EXT=$(printf '%s' "$FILE_PATH" | sed 's/.*\.//' | tr '[:upper:]' '[:lower:]')
+FILE_NAME=$(basename "$FILE_PATH")
+
+# Map extension to language concept
+LANG_CONCEPT="file"
+case "$FILE_EXT" in
+  ts|tsx)    LANG_CONCEPT="typescript" ;;
+  js|jsx)    LANG_CONCEPT="javascript" ;;
+  py)        LANG_CONCEPT="python" ;;
+  rs)        LANG_CONCEPT="rust" ;;
+  go)        LANG_CONCEPT="go" ;;
+  java)      LANG_CONCEPT="java" ;;
+  rb)        LANG_CONCEPT="ruby" ;;
+  css|scss)  LANG_CONCEPT="css" ;;
+  html)      LANG_CONCEPT="html" ;;
+  md)        LANG_CONCEPT="markdown" ;;
+  json)      LANG_CONCEPT="config" ;;
+  yaml|yml)  LANG_CONCEPT="config" ;;
+  toml)      LANG_CONCEPT="config" ;;
+esac
+
+CONTENT="File edited: ${FILE_PATH}"
+EVENT_TYPE="observation"
+
+# ---------------------------------------------------------------------------
+# Send event to Memoire API
+# ---------------------------------------------------------------------------
+
+AUTH_HEADER=""
+if [ -n "$API_KEY" ]; then
+  AUTH_HEADER="Authorization: Bearer ${API_KEY}"
+fi
+
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+IDEMPOTENCY_KEY="edit-${FILE_NAME}-${SESSION_ID}-$(date +%s)"
+
+SAFE_PATH=$(printf '%s' "$FILE_PATH" | sed 's/\\/\\\\/g; s/"/\\"/g')
+
+curl -sf --max-time 3 \
+  -X POST \
+  -H "Content-Type: application/json" \
+  ${AUTH_HEADER:+-H "$AUTH_HEADER"} \
+  -d "{
+    \"events\": [{
+      \"org_id\": \"${ORG_ID}\",
+      \"project_id\": \"${PROJECT_ID}\",
+      \"user_id\": \"${USER_ID}\",
+      \"session_id\": \"${SESSION_ID}\",
+      \"client\": \"${CLIENT}\",
+      \"event_type\": \"${EVENT_TYPE}\",
+      \"content\": \"${CONTENT}\",
+      \"files_modified\": [\"${SAFE_PATH}\"],
+      \"concepts\": [\"file_edit\", \"${LANG_CONCEPT}\"],
+      \"created_at\": \"${TIMESTAMP}\",
+      \"idempotency_key\": \"${IDEMPOTENCY_KEY}\",
+      \"private\": false
+    }]
+  }" \
+  "${API_URL}/v1/events" >/dev/null 2>&1 || true
+
+exit 0

package/cursor-hooks/save-observation.sh

@@ -0,0 +1,116 @@
+#!/bin/sh
+# Memoire MCP observation hook for Cursor IDE
+# Called via afterMCPExecution — records tool usage as an observation event
+# so Memoire can build a richer picture of the development session.
+#
+# Usage: sh save-observation.sh ["tool_name"] ["status"]
+#
+# Arguments:
+#   $1 - MCP tool name (e.g. "search_context", "read_file")
+#   $2 - Execution status ("success" or "error")
+#
+# Environment:
+#   MEMOIRE_API_URL    - API base URL (default: http://127.0.0.1:3100)
+#   MEMOIRE_API_KEY    - API key for authentication
+#   MEMOIRE_ORG_ID     - Organization ID
+#   MEMOIRE_PROJECT_ID - Project ID
+#   MEMOIRE_USER_ID    - User ID
+#   MEMOIRE_SESSION_ID - Session ID (auto-generated if unset)
+#
+# Falls back to ~/.memoire/config for any unset values.
+# Fails silently — never blocks the IDE.
+
+set -e
+
+TOOL_NAME="${1:-unknown}"
+TOOL_STATUS="${2:-success}"
+
+# ---------------------------------------------------------------------------
+# Config loading
+# ---------------------------------------------------------------------------
+
+CONFIG_FILE="${MEMOIRE_CONFIG_FILE:-$HOME/.memoire/config}"
+
+load_config() {
+  if [ -f "$CONFIG_FILE" ]; then
+    while IFS='=' read -r key value; do
+      case "$key" in
+        ''|\#*) continue ;;
+      esac
+      value=$(printf '%s' "$value" | sed "s/^[[:space:]]*[\"']\\{0,1\\}//;s/[\"']\\{0,1\\}[[:space:]]*$//")
+      case "$key" in
+        MEMOIRE_API_URL)    [ -z "$MEMOIRE_API_URL" ]    && MEMOIRE_API_URL="$value" ;;
+        MEMOIRE_API_KEY)    [ -z "$MEMOIRE_API_KEY" ]    && MEMOIRE_API_KEY="$value" ;;
+        MEMOIRE_ORG_ID)     [ -z "$MEMOIRE_ORG_ID" ]     && MEMOIRE_ORG_ID="$value" ;;
+        MEMOIRE_PROJECT_ID) [ -z "$MEMOIRE_PROJECT_ID" ] && MEMOIRE_PROJECT_ID="$value" ;;
+        MEMOIRE_USER_ID)    [ -z "$MEMOIRE_USER_ID" ]    && MEMOIRE_USER_ID="$value" ;;
+        MEMOIRE_SESSION_ID) [ -z "$MEMOIRE_SESSION_ID" ] && MEMOIRE_SESSION_ID="$value" ;;
+        MEMOIRE_CLIENT)     [ -z "$MEMOIRE_CLIENT" ]     && MEMOIRE_CLIENT="$value" ;;
+      esac
+    done < "$CONFIG_FILE"
+  fi
+}
+
+load_config
+
+API_URL="${MEMOIRE_API_URL:-http://127.0.0.1:3100}"
+API_KEY="${MEMOIRE_API_KEY:-}"
+ORG_ID="${MEMOIRE_ORG_ID:-}"
+PROJECT_ID="${MEMOIRE_PROJECT_ID:-}"
+USER_ID="${MEMOIRE_USER_ID:-}"
+SESSION_ID="${MEMOIRE_SESSION_ID:-cursor-$(date +%s)-$$}"
+CLIENT="${MEMOIRE_CLIENT:-cursor}"
+
+if [ -z "$ORG_ID" ] || [ -z "$PROJECT_ID" ] || [ -z "$USER_ID" ]; then
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Determine event type based on tool status
+# ---------------------------------------------------------------------------
+
+if [ "$TOOL_STATUS" = "error" ]; then
+  EVENT_TYPE="attempt"
+  CONTENT="MCP tool ${TOOL_NAME} failed"
+else
+  EVENT_TYPE="observation"
+  CONTENT="MCP tool ${TOOL_NAME} executed successfully"
+fi
+
+# ---------------------------------------------------------------------------
+# Send event to Memoire API
+# ---------------------------------------------------------------------------
+
+AUTH_HEADER=""
+if [ -n "$API_KEY" ]; then
+  AUTH_HEADER="Authorization: Bearer ${API_KEY}"
+fi
+
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+IDEMPOTENCY_KEY="mcp-${TOOL_NAME}-${SESSION_ID}-$(date +%s)"
+
+# Escape tool name for safe JSON embedding
+SAFE_TOOL_NAME=$(printf '%s' "$TOOL_NAME" | sed 's/\\/\\\\/g; s/"/\\"/g')
+
+curl -sf --max-time 3 \
+  -X POST \
+  -H "Content-Type: application/json" \
+  ${AUTH_HEADER:+-H "$AUTH_HEADER"} \
+  -d "{
+    \"events\": [{
+      \"org_id\": \"${ORG_ID}\",
+      \"project_id\": \"${PROJECT_ID}\",
+      \"user_id\": \"${USER_ID}\",
+      \"session_id\": \"${SESSION_ID}\",
+      \"client\": \"${CLIENT}\",
+      \"event_type\": \"${EVENT_TYPE}\",
+      \"content\": \"${CONTENT}\",
+      \"concepts\": [\"mcp\", \"${SAFE_TOOL_NAME}\"],
+      \"created_at\": \"${TIMESTAMP}\",
+      \"idempotency_key\": \"${IDEMPOTENCY_KEY}\",
+      \"private\": false
+    }]
+  }" \
+  "${API_URL}/v1/events" >/dev/null 2>&1 || true
+
+exit 0