@mxalbert/context-mode 2.0.0

package/hooks/codex/stop.mjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+import "./platform.mjs";
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * Codex CLI Stop hook — record turn-end state for continuity.
+ *
+ * Stop fires at the end of an assistant turn, not at true session shutdown.
+ * Store a turn_end marker so session_end remains reserved for actual terminal
+ * lifecycle events on platforms that expose one.
+ */
+
+import { readStdin, parseStdin, getSessionId, getSessionDBPath, getInputProjectDir, CODEX_OPTS } from "../session-helpers.mjs";
+import { createSessionLoaders, attributeAndInsertEvents } from "../session-loaders.mjs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadProjectAttribution } = createSessionLoaders(HOOK_DIR);
+const OPTS = CODEX_OPTS;
+
+/**
+ * Locate the codex rollout JSONL for this session. Codex persists turns at
+ * $CODEX_HOME/sessions/YYYY/MM/DD/rollout-<ts>-<session_id>.jsonl (default
+ * $CODEX_HOME = ~/.codex). The hook stdin does NOT carry the path, so we walk
+ * the sessions tree and match the filename suffix on the session id. Pure
+ * directory walk + string suffix test — NO regex. Best-effort: returns null on
+ * any failure so cost capture never blocks the turn.
+ */
+function findCodexRollout(sessionId) {
+  try {
+    if (typeof sessionId !== "string" || sessionId.length === 0) return null;
+    const home = process.env.CODEX_HOME || join(homedir(), ".codex");
+    const root = join(home, "sessions");
+    if (!existsSync(root)) return null;
+    const suffix = `${sessionId}.jsonl`;
+    const stack = [root];
+    while (stack.length > 0) {
+      const dir = stack.pop();
+      let entries;
+      try { entries = readdirSync(dir, { withFileTypes: true }); } catch { continue; }
+      for (const e of entries) {
+        const full = join(dir, e.name);
+        if (e.isDirectory()) { stack.push(full); continue; }
+        if (e.isFile() && e.name.startsWith("rollout-") && e.name.endsWith(suffix)) {
+          return full;
+        }
+      }
+    }
+  } catch {
+    // ignore — best-effort
+  }
+  return null;
+}
+
+/**
+ * Load the codex usage extractor (build/adapters/codex/usage.js), mirroring the
+ * loadModule build-path fallback in session-loaders. Returns null if the module
+ * is absent (e.g. pre-build dev tree) so the hook degrades gracefully.
+ */
+async function loadCodexUsage() {
+  try {
+    const pluginRoot = join(HOOK_DIR, "..", "..");
+    const candidates = [
+      join(pluginRoot, "build", "adapters", "codex", "usage.js"),
+    ];
+    for (const p of candidates) {
+      if (existsSync(p)) return await import(pathToFileURL(p).href);
+    }
+  } catch {
+    // ignore
+  }
+  return null;
+}
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const { SessionDB } = await loadSessionDB();
+  const dbPath = getSessionDBPath(OPTS, projectDir);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+
+  db.ensureSession(sessionId, projectDir);
+  const payload = {
+    stop_hook_active: input.stop_hook_active ?? false,
+    last_assistant_message: typeof input.last_assistant_message === "string"
+      ? input.last_assistant_message.slice(0, 2000)
+      : null,
+  };
+  db.insertEvent(sessionId, {
+    type: "turn_end",
+    category: "session",
+    data: JSON.stringify(payload),
+    priority: 1,
+  }, "Stop");
+
+  // ─── codex MAIN-turn cost capture (cursor-aware, no double-count) ─────────
+  // Codex carries no tokens on the hook payload (model only); per-turn usage is
+  // persisted to the session rollout JSONL as `event_msg`/`token_count`
+  // records. We tail that file, cursor-gated by rollout LINE INDEX, summing
+  // ONLY the completed turns NEW since the last Stop. Each step is best-effort
+  // — a hook must never block the session, so any read/extract failure here is
+  // swallowed without aborting the turn_end write above.
+  try {
+    const rolloutPath = findCodexRollout(sessionId);
+    if (rolloutPath) {
+      let rollout = null;
+      try { rollout = readFileSync(rolloutPath, "utf-8"); } catch { /* unreadable — skip */ }
+      if (rollout) {
+        const usageMod = await loadCodexUsage();
+        if (usageMod && typeof usageMod.extractCodexUsageSince === "function") {
+          const { resolveProjectAttributions } = await loadProjectAttribution();
+          const cursor = db.getUsageCursor(sessionId);
+          const { events, cursor: next } = usageMod.extractCodexUsageSince(rollout, cursor);
+          if (events.length > 0) {
+            // attributeAndInsertEvents both INSERTS locally and FORWARDS to the
+            // platform (gated on ~/.context-mode/platform.json).
+            attributeAndInsertEvents(db, sessionId, events, input, projectDir, "Stop", resolveProjectAttributions);
+          }
+          if (next) db.setUsageCursor(sessionId, next);
+        }
+      }
+    }
+  } catch {
+    // Best-effort cost capture — never block the session on failure.
+  }
+
+  db.close();
+} catch {
+  // Codex hooks must not block the session.
+}
+
+process.stdout.write("{}\n");

package/hooks/codex/userpromptsubmit.mjs

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import "./platform.mjs";
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * Codex CLI UserPromptSubmit hook — capture user prompts for continuity.
+ */
+
+import { readStdin, parseStdin, getSessionId, getSessionDBPath, getInputProjectDir, CODEX_OPTS } from "../session-helpers.mjs";
+import { createSessionLoaders, attributeAndInsertEvents } from "../session-loaders.mjs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadExtract, loadProjectAttribution } = createSessionLoaders(HOOK_DIR);
+const OPTS = CODEX_OPTS;
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const prompt = input.prompt ?? input.message ?? "";
+  const trimmed = (prompt || "").trim();
+
+  const isSystemMessage = trimmed.startsWith("<task-notification>")
+    || trimmed.startsWith("<system-reminder>")
+    || trimmed.startsWith("<context_guidance>")
+    || trimmed.startsWith("<tool-result>");
+
+  if (trimmed.length > 0 && !isSystemMessage) {
+    const { SessionDB } = await loadSessionDB();
+    const { extractUserEvents } = await loadExtract();
+    const { resolveProjectAttributions } = await loadProjectAttribution();
+    const dbPath = getSessionDBPath(OPTS, projectDir);
+    const db = new SessionDB({ dbPath });
+    const sessionId = getSessionId(input, OPTS);
+
+    db.ensureSession(sessionId, projectDir);
+
+    const promptEvent = {
+      type: "user_prompt",
+      category: "user-prompt",
+      data: prompt,
+      priority: 1,
+    };
+    const promptAttributions = attributeAndInsertEvents(
+      db, sessionId, [promptEvent], input, projectDir, "UserPromptSubmit", resolveProjectAttributions,
+    );
+
+    const userEvents = extractUserEvents(trimmed);
+    const savedLastKnown = promptAttributions[0]?.projectDir || null;
+    const sessionStats = db.getSessionStats(sessionId);
+    const lastKnownProjectDir = typeof db.getLatestAttributedProjectDir === "function"
+      ? db.getLatestAttributedProjectDir(sessionId)
+      : null;
+    const userAttributions = resolveProjectAttributions(userEvents, {
+      sessionOriginDir: sessionStats?.project_dir || projectDir,
+      inputProjectDir: projectDir,
+      workspaceRoots: Array.isArray(input.workspace_roots) ? input.workspace_roots : [],
+      lastKnownProjectDir: savedLastKnown || lastKnownProjectDir,
+    });
+    for (let i = 0; i < userEvents.length; i++) {
+      db.insertEvent(sessionId, userEvents[i], "UserPromptSubmit", userAttributions[i]);
+    }
+
+    db.close();
+  }
+} catch {
+  // Codex hooks must not block the session.
+}
+
+process.stdout.write(JSON.stringify({
+  hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: "" },
+}) + "\n");

package/hooks/copilot-cli/posttooluse.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+
+import { createSessionLoaders, attributeAndInsertEvents } from "../session-loaders.mjs";
+import {
+  readStdin,
+  parseStdin,
+  getSessionId,
+  getSessionDBPath,
+  getInputProjectDir,
+  COPILOT_OPTS,
+  resolveConfigDir,
+} from "../session-helpers.mjs";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadExtract, loadProjectAttribution } = createSessionLoaders(HOOK_DIR);
+const OPTS = COPILOT_OPTS;
+// Diagnostic log is opt-in via CONTEXT_MODE_DEBUG. PostToolUse fires on every
+// tool call, so an unconditional append-only log grows without bound under the
+// user's config dir. Gate it behind the env flag — same pattern as the kimi
+// hooks — so contributors can still capture it on demand. See #787 review.
+const DEBUG_LOG = process.env.CONTEXT_MODE_DEBUG
+  ? join(resolveConfigDir(OPTS), "context-mode", "posttooluse-debug.log")
+  : null;
+
+function logDebug(line) {
+  if (!DEBUG_LOG) return;
+  try {
+    mkdirSync(dirname(DEBUG_LOG), { recursive: true });
+    appendFileSync(DEBUG_LOG, line);
+  } catch {
+    /* silent */
+  }
+}
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+  const toolName = input.tool_name ?? input.toolName ?? "";
+  const toolInput = input.tool_input ?? input.toolArgs ?? {};
+  const toolResponse =
+    input.tool_result?.text_result_for_llm ??
+    input.toolResult?.textResultForLlm ??
+    input.tool_response ??
+    input.toolResult;
+
+  logDebug(`[${new Date().toISOString()}] CALL: ${toolName}\n`);
+
+  const { extractEvents } = await loadExtract();
+  const { resolveProjectAttributions } = await loadProjectAttribution();
+  const { SessionDB } = await loadSessionDB();
+
+  const dbPath = getSessionDBPath(OPTS, projectDir);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+
+  db.ensureSession(sessionId, projectDir);
+
+  const events = extractEvents({
+    tool_name: toolName,
+    tool_input: toolInput,
+    tool_response: typeof toolResponse === "string"
+      ? toolResponse
+      : JSON.stringify(toolResponse ?? ""),
+    tool_output: input.tool_output,
+  });
+
+  attributeAndInsertEvents(db, sessionId, events, input, projectDir, "PostToolUse", resolveProjectAttributions);
+
+  logDebug(`[${new Date().toISOString()}] OK: ${toolName} -> ${events.length} events\n`);
+  db.close();
+} catch (err) {
+  logDebug(`[${new Date().toISOString()}] ERR: ${err?.message || err}\n`);
+}

package/hooks/copilot-cli/precompact.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+
+import { createSessionLoaders } from "../session-loaders.mjs";
+import {
+  readStdin,
+  parseStdin,
+  getSessionId,
+  getSessionDBPath,
+  getInputProjectDir,
+  COPILOT_OPTS,
+  resolveConfigDir,
+} from "../session-helpers.mjs";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadSnapshot } = createSessionLoaders(HOOK_DIR);
+const OPTS = COPILOT_OPTS;
+// Diagnostic log is opt-in via CONTEXT_MODE_DEBUG (same pattern as the kimi
+// hooks): keep the error telemetry available to contributors without writing an
+// append-only file to every user's config dir on compaction. See #787 review.
+const DEBUG_LOG = process.env.CONTEXT_MODE_DEBUG
+  ? join(resolveConfigDir(OPTS), "context-mode", "precompact-debug.log")
+  : null;
+
+function logDebug(line) {
+  if (!DEBUG_LOG) return;
+  try {
+    mkdirSync(dirname(DEBUG_LOG), { recursive: true });
+    appendFileSync(DEBUG_LOG, line);
+  } catch {
+    /* silent */
+  }
+}
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const { buildResumeSnapshot } = await loadSnapshot();
+  const { SessionDB } = await loadSessionDB();
+
+  const dbPath = getSessionDBPath(OPTS, projectDir);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+
+  const events = db.getEvents(sessionId);
+
+  if (events.length > 0) {
+    const stats = db.getSessionStats(sessionId);
+    const snapshot = buildResumeSnapshot(events, {
+      compactCount: (stats?.compact_count ?? 0) + 1,
+    });
+
+    db.upsertResume(sessionId, snapshot, events.length);
+    db.incrementCompactCount(sessionId);
+  }
+
+  db.close();
+} catch (err) {
+  logDebug(`[${new Date().toISOString()}] ${err?.message || err}\n`);
+}

package/hooks/copilot-cli/pretooluse.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readStdin } from "../core/stdin.mjs";
+import { routePreToolUse, initSecurity } from "../core/routing.mjs";
+import { formatDecision } from "../core/formatters.mjs";
+import { parseStdin, getSessionId, getInputProjectDir, COPILOT_OPTS } from "../session-helpers.mjs";
+
+const __hookDir = dirname(fileURLToPath(import.meta.url));
+
+try {
+  await initSecurity(resolve(__hookDir, "..", "..", "build"));
+
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const tool = input.tool_name ?? input.toolName ?? "";
+  const toolInput = input.tool_input ?? input.toolArgs ?? {};
+  const projectDir = getInputProjectDir(input, COPILOT_OPTS);
+
+  const decision = routePreToolUse(
+    tool,
+    toolInput,
+    projectDir,
+    "copilot-cli",
+    getSessionId(input, COPILOT_OPTS),
+  );
+  const response = formatDecision("copilot-cli", decision);
+  if (response !== null) {
+    process.stdout.write(JSON.stringify(response) + "\n");
+  }
+} catch {
+  // Fail OPEN. A throw here (better-sqlite3 ABI skew, a routing exception, a
+  // malformed-stdin parse error) must NOT exit non-zero with empty stdout:
+  // GitHub Copilot CLI 1.0.59 treats a failed PreToolUse hook as "Denied by
+  // preToolUse hook (hook errored)" and blocks EVERY tool, bricking the agent.
+  // A legitimate veto is a normal stdout write + normal return (never a throw),
+  // so it is unaffected by this catch. Empty stdout + exit 0 => host ALLOWS the
+  // tool; context-mode routing is skipped for this one call, agent keeps working.
+}

package/hooks/copilot-cli/sessionstart.mjs

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+
+import { createSessionLoaders } from "../session-loaders.mjs";
+import { createRoutingBlock } from "../routing-block.mjs";
+import { createToolNamer } from "../core/tool-naming.mjs";
+import { writeSessionEventsFile, buildSessionDirective, getSessionEvents } from "../session-directive.mjs";
+import {
+  readStdin,
+  parseStdin,
+  getSessionId,
+  getSessionDBPath,
+  getSessionEventsPath,
+  getCleanupFlagPath,
+  getInputProjectDir,
+  COPILOT_OPTS,
+  resolveConfigDir,
+} from "../session-helpers.mjs";
+import { join } from "node:path";
+import { readFileSync, unlinkSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+const toolNamer = createToolNamer("copilot-cli");
+const ROUTING_BLOCK = createRoutingBlock(toolNamer);
+const HOOK_DIR = fileURLToPath(new URL(".", import.meta.url));
+const { loadSessionDB } = createSessionLoaders(HOOK_DIR);
+const OPTS = COPILOT_OPTS;
+
+let additionalContext = ROUTING_BLOCK;
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const source = input.source ?? "startup";
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  if (source === "compact") {
+    const { SessionDB } = await loadSessionDB();
+    const dbPath = getSessionDBPath(OPTS, projectDir);
+    const db = new SessionDB({ dbPath });
+    const sessionId = getSessionId(input, OPTS);
+    const resume = db.getResume(sessionId);
+
+    if (resume && !resume.consumed) {
+      db.markResumeConsumed(sessionId);
+    }
+
+    const events = getSessionEvents(db, sessionId);
+    if (events.length > 0) {
+      const eventMeta = writeSessionEventsFile(events, getSessionEventsPath(OPTS, projectDir));
+      additionalContext += buildSessionDirective("compact", eventMeta, toolNamer);
+    }
+
+    db.close();
+  } else if (source === "resume") {
+    try { unlinkSync(getCleanupFlagPath(OPTS, projectDir)); } catch { /* no flag */ }
+
+    const { SessionDB } = await loadSessionDB();
+    const dbPath = getSessionDBPath(OPTS, projectDir);
+    const db = new SessionDB({ dbPath });
+
+    const sessionId = getSessionId(input, OPTS);
+    const events = sessionId ? getSessionEvents(db, sessionId) : [];
+    if (events.length > 0) {
+      const eventMeta = writeSessionEventsFile(events, getSessionEventsPath(OPTS, projectDir));
+      additionalContext += buildSessionDirective("resume", eventMeta, toolNamer);
+    }
+
+    db.close();
+  } else if (source === "startup" || source === "new") {
+    const { SessionDB } = await loadSessionDB();
+    const dbPath = getSessionDBPath(OPTS, projectDir);
+    const db = new SessionDB({ dbPath });
+    try { unlinkSync(getSessionEventsPath(OPTS, projectDir)); } catch { /* no stale file */ }
+
+    db.cleanupOldSessions(7);
+    db.db.exec(`DELETE FROM session_events WHERE session_id NOT IN (SELECT session_id FROM session_meta)`);
+
+    const sessionId = getSessionId(input, OPTS);
+    db.ensureSession(sessionId, projectDir);
+
+    const ruleFilePaths = [
+      join(projectDir, ".github", "copilot-instructions.md"),
+      join(projectDir, "AGENTS.md"),
+    ];
+    for (const p of ruleFilePaths) {
+      try {
+        const content = readFileSync(p, "utf-8");
+        if (content.trim()) {
+          db.insertEvent(sessionId, { type: "rule", category: "rule", data: p, priority: 1 });
+          db.insertEvent(sessionId, { type: "rule_content", category: "rule", data: content, priority: 1 });
+        }
+      } catch {
+        /* file does not exist - skip */
+      }
+    }
+
+    db.close();
+  }
+} catch (err) {
+  // Error telemetry is opt-in via CONTEXT_MODE_DEBUG (same pattern as the kimi
+  // hooks) so we don't write an append-only log to every user's config dir on a
+  // transient SessionStart error. See #787 review.
+  if (process.env.CONTEXT_MODE_DEBUG) {
+    try {
+      const { appendFileSync, mkdirSync } = await import("node:fs");
+      const { join: pjoin, dirname: pdirname } = await import("node:path");
+      const logPath = pjoin(resolveConfigDir(OPTS), "context-mode", "sessionstart-debug.log");
+      mkdirSync(pdirname(logPath), { recursive: true });
+      appendFileSync(
+        logPath,
+        `[${new Date().toISOString()}] ${err?.message || err}\n${err?.stack || ""}\n`,
+      );
+    } catch {
+      /* ignore logging failure */
+    }
+  }
+}
+
+console.log(JSON.stringify({ additionalContext }));

package/hooks/copilot-cli/stop.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * GitHub Copilot CLI Stop hook — record session-end state for continuity.
+ * Capture-only (emits no output). Parsed via the shared session helpers with
+ * COPILOT_OPTS.
+ */
+
+import {
+  readStdin,
+  parseStdin,
+  getSessionId,
+  getSessionDBPath,
+  getInputProjectDir,
+  COPILOT_OPTS,
+} from "../session-helpers.mjs";
+import { createSessionLoaders } from "../session-loaders.mjs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB } = createSessionLoaders(HOOK_DIR);
+const OPTS = COPILOT_OPTS;
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const { SessionDB } = await loadSessionDB();
+  const dbPath = getSessionDBPath(OPTS, projectDir);
+  const db = new SessionDB({ dbPath });
+  const sessionId = getSessionId(input, OPTS);
+
+  db.ensureSession(sessionId, projectDir);
+  // insertEvent hashes event.data, so type/category/priority/data are all
+  // required — a session_end with only `type` throws on createHash(undefined)
+  // and is silently dropped (the latent codex/stop.mjs bug). Provide real
+  // fields so the session-end row actually persists.
+  const lastMessage =
+    typeof input.last_assistant_message === "string"
+      ? input.last_assistant_message.slice(0, 2000)
+      : "";
+  db.insertEvent(
+    sessionId,
+    {
+      type: "session_end",
+      category: "session",
+      priority: 1,
+      data: lastMessage || "session ended",
+    },
+    "Stop",
+  );
+
+  db.close();
+} catch {
+  /* a hook must never fail the host */
+}

package/hooks/copilot-cli/userpromptsubmit.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import "../suppress-stderr.mjs";
+import "../ensure-deps.mjs";
+/**
+ * GitHub Copilot CLI UserPromptSubmit hook — capture genuine user prompts for
+ * session continuity. Capture-only (emits no output; Copilot CLI ignores hook
+ * stdout in auto-run mode). Copilot fires this with a snake_case payload, parsed
+ * via the shared session helpers with COPILOT_OPTS.
+ */
+
+import {
+  readStdin,
+  parseStdin,
+  getSessionId,
+  getSessionDBPath,
+  getInputProjectDir,
+  COPILOT_OPTS,
+} from "../session-helpers.mjs";
+import { createSessionLoaders, attributeAndInsertEvents } from "../session-loaders.mjs";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const HOOK_DIR = dirname(fileURLToPath(import.meta.url));
+const { loadSessionDB, loadExtract, loadProjectAttribution } = createSessionLoaders(HOOK_DIR);
+const OPTS = COPILOT_OPTS;
+
+try {
+  const raw = await readStdin();
+  const input = parseStdin(raw);
+  const projectDir = getInputProjectDir(input, OPTS);
+
+  const prompt = input.prompt ?? input.user_prompt ?? input.message ?? "";
+  const trimmed = (typeof prompt === "string" ? prompt : "").trim();
+
+  // Skip host-injected system/tool envelopes — only capture genuine user input.
+  const isSystemMessage =
+    trimmed.startsWith("<task-notification>") ||
+    trimmed.startsWith("<system-reminder>") ||
+    trimmed.startsWith("<context_guidance>") ||
+    trimmed.startsWith("<tool-result>");
+
+  if (trimmed.length > 0 && !isSystemMessage) {
+    const { SessionDB } = await loadSessionDB();
+    const { extractUserEvents } = await loadExtract();
+    const { resolveProjectAttributions } = await loadProjectAttribution();
+    const dbPath = getSessionDBPath(OPTS, projectDir);
+    const db = new SessionDB({ dbPath });
+    const sessionId = getSessionId(input, OPTS);
+
+    db.ensureSession(sessionId, projectDir);
+
+    const promptEvent = { type: "user_prompt", category: "user-prompt", data: prompt, priority: 1 };
+    const promptAttributions = attributeAndInsertEvents(
+      db, sessionId, [promptEvent], input, projectDir, "UserPromptSubmit", resolveProjectAttributions,
+    );
+
+    const userEvents = extractUserEvents(trimmed);
+    const sessionStats = db.getSessionStats?.(sessionId);
+    const lastKnownProjectDir =
+      typeof db.getLatestAttributedProjectDir === "function"
+        ? db.getLatestAttributedProjectDir(sessionId)
+        : null;
+    const userAttributions = resolveProjectAttributions(userEvents, {
+      sessionOriginDir: sessionStats?.project_dir || projectDir,
+      inputProjectDir: projectDir,
+      workspaceRoots: Array.isArray(input.workspace_roots) ? input.workspace_roots : [],
+      lastKnownProjectDir: promptAttributions[0]?.projectDir || lastKnownProjectDir,
+    });
+    for (let i = 0; i < userEvents.length; i++) {
+      db.insertEvent(sessionId, userEvents[i], "UserPromptSubmit", userAttributions[i]);
+    }
+
+    db.close();
+  }
+} catch {
+  /* a hook must never fail the host */
+}