cognitive-enzyme-hook 0.1.0

package/README.md

@@ -0,0 +1,76 @@
+# cognitive-enzyme-hook
+
+A [Claude Code](https://claude.com/claude-code) `UserPromptSubmit` hook that turns
+[Cognitive Enzyme](../../README.md) into a **System 1 push layer**: before every
+prompt reaches the model, it calls the Cognitive Enzyme server's `/api/prime` and
+injects the activated reflexes as context.
+
+> MCP's `prime()` is a *pull* (the agent must decide to call it). This hook makes it a
+> *push*: the right intuitions appear automatically, every turn.
+
+**It never blocks your prompt.** If the server is down, unreachable, times out, or
+returns an error, the hook silently exits without injecting anything.
+
+## Install
+
+From a clone of this repository (the package is not published to the npm
+registry yet):
+
+```bash
+npm i -g ./hooks/npm
+```
+
+Once published: `npm i -g cognitive-enzyme-hook`.
+
+## Configure
+
+Add to `~/.claude/settings.json` (or a project `.claude/settings.json`):
+
+```json
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      { "hooks": [{ "type": "command", "command": "ce-prime-hook", "timeout": 10 }] }
+    ],
+    "SessionEnd": [
+      { "hooks": [{ "type": "command", "command": "ce-capture-hook", "timeout": 30 }] }
+    ],
+    "PreCompact": [
+      { "hooks": [{ "type": "command", "command": "ce-capture-hook", "timeout": 30 }] }
+    ]
+  },
+  "env": {
+    "CE_API_URL": "http://localhost:8420",
+    "CE_API_TOKEN": "<your machine token>"
+  }
+}
+```
+
+`ce-capture-hook` distills the finished session's transcript into reusable
+memories via the server's `/api/capture` (System 2 write path); it fires on
+`SessionEnd` and `PreCompact` and never blocks.
+
+Then open `/hooks` once (or restart Claude Code) to load it.
+
+> Zero-install alternative: use `"command": "npx", "args": ["-y", "cognitive-enzyme-hook"]`.
+> Convenient, but `npx` resolves the package on **every** prompt — adds noticeable latency
+> on the prompt critical path. Prefer the global install above.
+
+## Environment variables
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `CE_API_URL` | `http://localhost:8420` | Cognitive Enzyme REST base URL |
+| `CE_API_TOKEN` | — | Static machine token (required when the server has auth enabled) |
+| `CE_PRIME_TIMEOUT` | `3` | Request timeout, seconds (kept short — it's on the prompt path) |
+| `CE_PRIME_MAX` | `6` | Max reflexes injected per prompt (token control) |
+| `CE_PRIME_MIN_CONF` | `0.4` | Minimum enzyme confidence to inject |
+
+## Requirements
+
+- Node.js ≥ 18 (uses built-in `fetch`)
+- A running Cognitive Enzyme server (`python -m app`)
+
+## License
+
+MIT

package/capture.mjs

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * cognitive-enzyme-capture — Claude Code `SessionEnd` / `PreCompact` / `Stop` hook.
+ *
+ * System 2 写路径(与 index.mjs 读路径相对):会话结束或上下文压缩前,读取
+ * Claude Code 的 transcript,POST 到 CE 的 REST `/api/capture`。CE 端异步做
+ * 「提取候选 → 撞库 → 对账(ADD/UPDATE/REINFORCE/INVALIDATE)」,本 hook 立即返回。
+ *
+ * 设计原则:**绝不阻塞、绝不报错给用户**。CE 没起/超时/异常一律静默退出 0。
+ * 零依赖:仅用 Node 18+ 内置 fetch / AbortController / fs。
+ *
+ * 可配置 env:
+ *   CE_API_URL          REST 基址,默认 http://localhost:8420
+ *   CE_API_TOKEN        静态机器令牌(服务端开启鉴权时必填)
+ *   CE_CAPTURE_TIMEOUT  请求超时(秒),默认 5
+ *   CE_CAPTURE_MAX_CHARS transcript 摘要上限,默认 16000
+ *   CE_CAPTURE_TURNS    最近纳入多少轮,默认 40
+ */
+
+import { readFileSync } from "node:fs";
+
+const API_URL = (process.env.CE_API_URL || "http://localhost:8420").replace(/\/+$/, "");
+const API_TOKEN = (process.env.CE_API_TOKEN || "").trim();
+const TIMEOUT_MS = Math.round((Number(process.env.CE_CAPTURE_TIMEOUT) || 5) * 1000);
+const MAX_CHARS = Number(process.env.CE_CAPTURE_MAX_CHARS) || 16000;
+const MAX_TURNS = Number(process.env.CE_CAPTURE_TURNS) || 40;
+
+function bail() {
+  process.exit(0);
+}
+
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(chunk);
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+// prime 注入块(哨兵定界或旧格式)压缩为一行 ⟦CE:SEEN id,...⟧:
+// 省摘要预算,同时保住酶 id 供服务端做被动效果评估。
+const INJECT_RE = /⟦CE:BEGIN⟧[\s\S]*?⟦CE:END⟧/g;
+const LEGACY_RE = /\[认知酶 · System 1 直觉\][\s\S]*?(?:主动检索。|以强化\/纠正它。)/g;
+const ID_RE = /‹enzyme_id=([^›\s]+)›/g;
+
+function compressInjections(text) {
+  const repl = (m) => {
+    const ids = [...new Set([...m.matchAll(ID_RE)].map((x) => x[1]))];
+    return ids.length ? `⟦CE:SEEN ${ids.join(",")}⟧` : "";
+  };
+  return text.replace(INJECT_RE, repl).replace(LEGACY_RE, repl);
+}
+
+/** message.content 可能是字符串或 block 列表,统一抽成文本。 */
+function textFromContent(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content
+      .filter((b) => b && b.type === "text")
+      .map((b) => b.text || "")
+      .join("\n");
+  }
+  return "";
+}
+
+/** 读取 transcript JSONL,拼出最近若干轮 user/assistant 的纯文本。 */
+function readTranscript(path) {
+  let raw;
+  try {
+    raw = readFileSync(path, "utf8");
+  } catch {
+    return "";
+  }
+  const turns = [];
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    let obj;
+    try {
+      obj = JSON.parse(trimmed);
+    } catch {
+      continue;
+    }
+    const msg = obj.message || obj;
+    const role = msg.role || obj.type;
+    if (role !== "user" && role !== "assistant") continue;
+    const text = compressInjections(textFromContent(msg.content || "")).trim();
+    if (text) turns.push(`[${role}] ${text}`);
+  }
+  if (turns.length === 0) return "";
+  return turns.slice(-MAX_TURNS).join("\n\n").slice(-MAX_CHARS);
+}
+
+async function main() {
+  if (typeof fetch !== "function") bail(); // Node <18
+
+  let payload;
+  try {
+    payload = JSON.parse(await readStdin());
+  } catch {
+    bail();
+  }
+
+  const transcriptPath = payload.transcript_path || "";
+  if (!transcriptPath) bail();
+
+  const transcript = readTranscript(transcriptPath);
+  if (!transcript || transcript.length < 200) bail(); // 太短不值得跑 LLM
+
+  const headers = { "Content-Type": "application/json" };
+  if (API_TOKEN) headers.Authorization = `Bearer ${API_TOKEN}`;
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+  try {
+    await fetch(`${API_URL}/api/capture`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        transcript,
+        session_id: payload.session_id || "",
+        source: (payload.hook_event_name || "capture").toLowerCase(),
+        domain: "",
+      }),
+      signal: controller.signal,
+    });
+  } catch {
+    // 服务不可用 / 超时 → 静默放过
+  } finally {
+    clearTimeout(timer);
+  }
+  bail();
+}
+
+main().catch(() => process.exit(0));

package/index.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * cognitive-enzyme-hook — Claude Code `UserPromptSubmit` hook.
+ *
+ * 把 Cognitive Enzyme 的反射作为 System 1 直觉注入当前 prompt：读取 Claude Code
+ * 在 stdin 给的 hook 输入（含 prompt），调 CE 的 REST `/api/prime`，把命中的酶
+ * 格式化成一段上下文，通过 additionalContext 注回模型。
+ *
+ * 设计原则：**绝不阻塞 prompt**。CE 没起、超时、报错——一律静默退出 0、不注入。
+ * 零依赖：仅用 Node 18+ 内置 fetch / AbortController / process.stdin。
+ *
+ * 可配置 env：
+ *   CE_API_URL        REST 基址，默认 http://localhost:8420
+ *   CE_API_TOKEN      静态机器令牌（服务端开启鉴权时必填）
+ *   CE_PRIME_TIMEOUT  请求超时（秒），默认 3
+ *   CE_PRIME_MAX      注入条数上限，默认 6
+ *   CE_PRIME_MIN_CONF 置信度下限，默认 0.4
+ */
+
+const API_URL = (process.env.CE_API_URL || "http://localhost:8420").replace(/\/+$/, "");
+const API_TOKEN = (process.env.CE_API_TOKEN || "").trim();
+const TIMEOUT_MS = Math.round((Number(process.env.CE_PRIME_TIMEOUT) || 3) * 1000);
+const MAX_RESULTS = Number(process.env.CE_PRIME_MAX) || 6;
+const MIN_CONFIDENCE = Number(process.env.CE_PRIME_MIN_CONF) || 0.4;
+
+const SEV_ICON = { critical: "🔴", warning: "🟡", info: "🟢" };
+
+/** 输出 UserPromptSubmit 的 JSON 并退出；空串=不注入。永远 exit 0。 */
+function emit(additionalContext) {
+  if (additionalContext) {
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "UserPromptSubmit",
+          additionalContext,
+        },
+        suppressOutput: true,
+      }),
+    );
+  }
+  process.exit(0);
+}
+
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(chunk);
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+async function main() {
+  if (typeof fetch !== "function") emit(""); // Node <18：放弃注入，不报错
+
+  let payload;
+  try {
+    payload = JSON.parse(await readStdin());
+  } catch {
+    emit("");
+  }
+
+  const context = String(payload.prompt || "").trim();
+  if (!context) emit("");
+
+  const headers = { "Content-Type": "application/json" };
+  if (API_TOKEN) headers.Authorization = `Bearer ${API_TOKEN}`;
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+  let data;
+  try {
+    const res = await fetch(`${API_URL}/api/prime`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({ context, max_results: MAX_RESULTS }),
+      signal: controller.signal,
+    });
+    if (!res.ok) emit(""); // 401 / 5xx 等：静默放过
+    data = await res.json();
+  } catch {
+    emit(""); // 服务不可用 / 超时
+  } finally {
+    clearTimeout(timer);
+  }
+
+  const matches = (data.matches || []).filter(
+    (m) => (m.confidence || 0) >= MIN_CONFIDENCE,
+  );
+  if (matches.length === 0) emit("");
+
+  // ⟦CE:BEGIN⟧/⟦CE:END⟧ 哨兵供 capture 端识别注入块:剥离防回声 + 被动效果评估
+  const lines = [
+    "⟦CE:BEGIN⟧",
+    "[认知酶 · System 1 直觉] 以下反射被当前上下文激活，供参考（无关可忽略）：",
+  ];
+  for (const m of matches) {
+    const icon = SEV_ICON[m.severity] || "⚪";
+    const conf = Math.round((m.confidence || 0) * 100);
+    let line = `${icon} [${conf}%] ${m.suggestion || ""}`;
+    if (m.reason) line += `（因为：${m.reason}）`;
+    line += `  ‹enzyme_id=${m.id}›`;
+    lines.push(line);
+  }
+  lines.push(
+    "若已连接 cognitive-enzyme MCP：验证后请调 report(enzyme_ids=[上列 id 按序], success) " +
+      "反馈以强化/纠正；任务中途需要更多相关经验可调 search(query) 主动检索。",
+  );
+  lines.push("⟦CE:END⟧");
+  emit(lines.join("\n"));
+}
+
+main().catch(() => process.exit(0));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "cognitive-enzyme-hook",
+  "version": "0.1.0",
+  "description": "Claude Code hooks for Cognitive Enzyme: inject System-1 reflexes on prompt (prime) and distill memories on session end (capture).",
+  "type": "module",
+  "bin": {
+    "ce-prime-hook": "index.mjs",
+    "ce-capture-hook": "capture.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/7-e1even/Cognitive-Enzyme.git",
+    "directory": "hooks/npm"
+  },
+  "homepage": "https://github.com/7-e1even/Cognitive-Enzyme#readme",
+  "files": [
+    "index.mjs",
+    "capture.mjs",
+    "README.md"
+  ],
+  "keywords": [
+    "claude-code",
+    "claude",
+    "hook",
+    "cognitive-enzyme",
+    "mcp",
+    "ai-agent",
+    "system-1"
+  ],
+  "license": "MIT"
+}