@engramprotocol/mcp-server 0.9.0 → 0.10.0

package/dist/tools/update.js

@@ -6,9 +6,9 @@ const _helpers_1 = require("./_helpers");
 function registerUpdateTool(server, http) {
     server.registerTool('eml_update', {
         title: 'Update Engram',
-        description: 'Patch einen Engram (status, significance, properties, content). ' +
-            'Typischer Use-Case: status="resolved" + outcome in properties bei Predictions, ' +
-            'oder status="superseded" wenn ein Engram nicht mehr gilt.',
+        description: 'Patch an engram (status, significance, properties, content). Typical: ' +
+            'status="resolved" when a task is done, or status="superseded" to retire ' +
+            'a stale decision when a new one replaces it.',
         inputSchema: {
             id: zod_1.z.string(),
             patch: zod_1.z.object({
@@ -18,8 +18,7 @@ function registerUpdateTool(server, http) {
                 subject: zod_1.z.string().optional(),
                 scope: zod_1.z.string().optional(),
                 properties: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
-            }).describe('Nur die Felder die geändert werden sollen.'),
-            caller: zod_1.z.string().optional(),
+            }).describe('Only the fields to be modified.'),
         },
     }, async (args) => (0, _helpers_1.callTool)(() => http.post('/update', args)));
 }

package/dist/tools/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/tools/update.ts"],"names":[],"mappings":";;AAKA,gDAwBC;AA7BD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,kBAAkB,CAAC,MAAiB,EAAE,IAAgB;IACpE,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,kEAAkE;YAClE,iFAAiF;YACjF,2DAA2D;QAC7D,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC;gBACd,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACpG,YAAY,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACjF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5B,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;aACzD,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACzD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC9B;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAC3D,CAAA;AACH,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/tools/update.ts"],"names":[],"mappings":";;AAKA,gDAuBC;AA5BD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,kBAAkB,CAAC,MAAiB,EAAE,IAAgB;IACpE,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,wEAAwE;YACxE,0EAA0E;YAC1E,8CAA8C;QAChD,WAAW,EAAE;YACX,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;YACd,KAAK,EAAE,OAAC,CAAC,MAAM,CAAC;gBACd,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACpG,YAAY,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACjF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5B,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;aACzD,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAC/C;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAC3D,CAAA;AACH,CAAC"}

package/package.json

@@ -1,20 +1,28 @@
 {
   "name": "@engramprotocol/mcp-server",
-  "version": "0.9.0",
-  "description": "MCP-Wrapper für die EML HTTP-API — exposes EML als MCP-Tools für Claude Code und andere MCP-Clients",
-  "license": "UNLICENSED",
+  "version": "0.10.0",
+  "description": "MCP wrapper for the EML HTTP API — exposes the Engram Protocol as MCP tools for Claude Code and other MCP clients. Includes setup-mode for one-shot install/update/uninstall.",
+  "license": "MIT",
   "main": "dist/server.js",
   "types": "dist/server.d.ts",
   "bin": {
-    "eml-mcp-server": "./dist/cli.js"
+    "eml-mcp-server": "./dist/cli.js",
+    "mcp-server": "./dist/cli.js"
   },
   "files": [
     "dist",
-    "README.md"
+    "templates",
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3"
@@ -23,11 +31,6 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@engramprotocol/core": "0.0.0"
-  },
-  "scripts": {
-    "build": "tsc -b",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest"
+    "@engramprotocol/core": "workspace:*"
   }
-}
+}

package/templates/hooks/session_start_boot.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# managed-by: engramprotocol-setup
+#
+# SessionStart-Hook: loads the EML brain into Claude Code's session context.
+# Output is invisible-in-chat but reaches the model's context (verified empirically
+# via spike 2026-05-15 — see brain decision dc5a9ad5).
+#
+# Layout: 7 sections — safety+constants, log+stdin, config check, sanity, /boot
+# call, update-banner check, emit markdown.
+
+set -eu
+
+# --- 1. Safety + Constants -------------------------------------------------
+CONFIG="$HOME/.eml/config"
+LOG_DIR="$HOME/.eml/logs"
+
+# --- 2. Log setup + stdin capture ------------------------------------------
+mkdir -p "$LOG_DIR"
+LOG_FILE="$LOG_DIR/session-start-$(date -u +%Y-%m-%d).log"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+STDIN=$(cat || true)
+echo "[$TS] fired (pid=$$) stdin=$STDIN" >> "$LOG_FILE"
+
+# --- 3. Config check + source ----------------------------------------------
+if [ ! -f "$CONFIG" ]; then
+  echo "⚠️ EML config missing at $CONFIG — run 'npx @engramprotocol/mcp-server setup'"
+  echo "[$TS] FAIL config missing" >> "$LOG_FILE"
+  exit 0
+fi
+. "$CONFIG"
+
+# --- 4. Sanity: required vars ----------------------------------------------
+if [ -z "${EML_URL:-}" ] || [ -z "${EML_API_TOKEN:-}" ]; then
+  echo "⚠️ EML config incomplete — EML_URL or EML_API_TOKEN missing in $CONFIG"
+  echo "[$TS] FAIL incomplete config" >> "$LOG_FILE"
+  exit 0
+fi
+
+# --- 5. Call /boot ---------------------------------------------------------
+RESPONSE=$(curl -fsS -m 8 \
+  -H "Authorization: Bearer $EML_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -X POST -d '{}' \
+  "$EML_URL/boot" 2>>"$LOG_FILE") || {
+  echo "⚠️ EML Boot failed — server unreachable or auth error. See $LOG_FILE"
+  echo "[$TS] FAIL curl non-zero" >> "$LOG_FILE"
+  exit 0
+}
+
+# --- 6. Update-banner check ------------------------------------------------
+SERVER_VER=$(echo "$RESPONSE" | jq -r '.version // empty')
+if [ -n "${EML_CLIENT_VERSION:-}" ] && [ -n "$SERVER_VER" ] && [ "$EML_CLIENT_VERSION" != "$SERVER_VER" ]; then
+  cat <<EOF
+## ⚠️ Update Available
+- @engramprotocol/mcp-server: $EML_CLIENT_VERSION → $SERVER_VER available
+- **Run** \`npx @engramprotocol/mcp-server setup update\`, **or ask me to update for you** — I'll run it on your behalf.
+
+EOF
+fi
+
+# --- 7. Emit boot markdown + log success -----------------------------------
+echo "$RESPONSE" | jq -r '.markdown'
+echo "[$TS] OK ver=$SERVER_VER bytes=$(echo "$RESPONSE" | wc -c)" >> "$LOG_FILE"

package/templates/hooks/user_prompt_submit_reminder.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# managed-by: engramprotocol-setup
+#
+# UserPromptSubmit-Hook: Mid-session reminder to keep the model anchored in EML
+# patterns. Claude Code fires this hook on every user message. The hook decides
+# whether to print the reminder (when a trigger condition matches) or stay silent.
+#
+# Triggers (any one suffices):
+#   - turn == 1     (initial reminder at session start; SessionStart-Hook already
+#                    loaded SYSTEM_RULES + brain state, so one reinforcement is enough)
+#   - turn % 5 == 0 (every 5th turn — anti-drift cadence)
+#   - counter file mtime > 1h ago (session resumed after pause)
+#
+# State files (per v0.10.0-PROPOSAL B.4.1):
+#   /tmp/eml-turns/<session_id>          turn counter
+#   ~/.eml/logs/user-prompt-submit-*.log debug log (self-rotating per day)
+#
+# Local-only, no HTTP. Reminder content lives inline as heredoc — single source of
+# truth, evolves with the npm-package via `setup update`.
+
+set -eu
+
+LOG_DIR="$HOME/.eml/logs"
+TURNS_DIR="/tmp/eml-turns"
+
+mkdir -p "$LOG_DIR" "$TURNS_DIR"
+LOG_FILE="$LOG_DIR/user-prompt-submit-$(date -u +%Y-%m-%d).log"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+# --- 1. Parse stdin for session_id -----------------------------------------
+STDIN=$(cat || true)
+SESSION_ID=$(echo "$STDIN" | jq -r '.session_id // empty' 2>/dev/null || true)
+
+if [ -z "$SESSION_ID" ]; then
+  echo "[$TS] no session_id in stdin, silent" >> "$LOG_FILE"
+  exit 0
+fi
+
+COUNTER_FILE="$TURNS_DIR/$SESSION_ID"
+
+# --- 2. Read counter + detect long pause -----------------------------------
+RESUMED_AFTER_PAUSE=0
+if [ -f "$COUNTER_FILE" ]; then
+  TURN=$(cat "$COUNTER_FILE" 2>/dev/null || echo 0)
+  # mtime — macOS uses `stat -f %m`, Linux uses `stat -c %Y`
+  MTIME=$(stat -f %m "$COUNTER_FILE" 2>/dev/null || stat -c %Y "$COUNTER_FILE" 2>/dev/null || echo 0)
+  NOW=$(date +%s)
+  ELAPSED=$((NOW - MTIME))
+  if [ "$ELAPSED" -gt 3600 ]; then RESUMED_AFTER_PAUSE=1; fi
+else
+  TURN=0
+fi
+
+TURN=$((TURN + 1))
+echo "$TURN" > "$COUNTER_FILE"
+
+# --- 3. Trigger decision ---------------------------------------------------
+SHOULD_REMIND=0
+if [ "$TURN" -eq 1 ]; then SHOULD_REMIND=1; fi
+if [ "$((TURN % 5))" -eq 0 ]; then SHOULD_REMIND=1; fi
+if [ "$RESUMED_AFTER_PAUSE" -eq 1 ]; then SHOULD_REMIND=1; fi
+
+if [ "$SHOULD_REMIND" -eq 0 ]; then
+  echo "[$TS] silent turn=$TURN sid=$SESSION_ID" >> "$LOG_FILE"
+  exit 0
+fi
+
+# --- 4. Emit reminder (invisible-in-chat, in-model-context per Spike-2) ----
+cat <<'EOF'
+[EML Reminder]
+- Store-worthy moments (decisions, status changes, tasks, events, feedback rules) → use the matching typed tool (eml_decide / eml_set_status / eml_track_task / eml_note).
+- Question about customer / project / topic? eml_recall or eml_show first — don't guess from conversation memory.
+- Before write: matching active engram exists? skip, or supersede via eml_update (don't duplicate).
+- Routine updates: act + inform in 1-2 lines, no permission-asking.
+- EML brain is the canonical knowledge base — check it before falling back to conversation memory.
+EOF
+
+echo "[$TS] OK turn=$TURN sid=$SESSION_ID reminded (pause=$RESUMED_AFTER_PAUSE)" >> "$LOG_FILE"