vibe-code-explainer 0.3.2 → 0.3.5

package/dist/config-YLMDBCIR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/config.ts"],"sourcesContent":["import { intro, outro, select, confirm, text, cancel, isCancel, note } from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { spawn } from \"node:child_process\";\nimport { existsSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport {\n  DEFAULT_CONFIG,\n  loadConfig,\n  LANGUAGE_NAMES,\n  LEARNER_LEVEL_NAMES,\n  CONFIG_FILENAME,\n  getGlobalConfigPath,\n  type Config,\n  type Engine,\n  type DetailLevel,\n  type Language,\n  type LearnerLevel,\n} from \"../config/schema.js\";\nimport { MODEL_OPTIONS } from \"../detect/vram.js\";\nimport { parseFlags, flagBool } from \"./flags.js\";\n\ninterface OllamaTagResponse {\n  models?: Array<{ name?: string; model?: string }>;\n}\n\nasync function listInstalledOllamaModels(url: string): Promise<string[] | null> {\n  try {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), 3000);\n    const res = await fetch(`${url}/api/tags`, { signal: ctrl.signal });\n    clearTimeout(timer);\n    if (!res.ok) return null;\n    const data = (await res.json()) as OllamaTagResponse;\n    if (!data.models) return [];\n    return data.models\n      .map((m) => m.name ?? m.model ?? \"\")\n      .filter((n) => n.length > 0);\n  } catch {\n    return null;\n  }\n}\n\nfunction normalizeModelName(name: string): string {\n  // Ollama sometimes returns tags as \"qwen3.5:9b\" and sometimes as\n  // \"qwen3.5:9b-q4_K_M\". Compare on the base \"<model>:<tag>\" prefix.\n  return name.toLowerCase().split(/[-_]/)[0];\n}\n\nfunction hasModel(installed: string[], wanted: string): boolean {\n  const wantedNorm = normalizeModelName(wanted);\n  const wantedLower = wanted.toLowerCase();\n  return installed.some((n) => {\n    const base = n.toLowerCase();\n    if (base === wantedLower) return true;\n    // Looser match for variant tags (e.g. \"qwen3.5:9b-q4_K_M\" matches \"qwen3.5\")\n    return normalizeModelName(base).startsWith(wantedNorm);\n  });\n}\n\nasync function pullOllamaModel(model: string): Promise<boolean> {\n  note(\n    `Pulling ${pc.cyan(model)}\\n${pc.dim(\"This can take a while on the first run (several GB download).\")}`,\n    \"Downloading model\"\n  );\n  return new Promise((resolvePromise) => {\n    const child = spawn(\"ollama\", [\"pull\", model], { stdio: \"inherit\" });\n    child.on(\"error\", () => {\n      process.stderr.write(\n        pc.red(\"\\nFailed to run `ollama pull`. Make sure Ollama is installed and running.\\n\")\n      );\n      resolvePromise(false);\n    });\n    child.on(\"close\", (code) => {\n      if (code === 0) {\n        process.stdout.write(pc.green(`\\n\\u2713 Pulled ${model}\\n`));\n        resolvePromise(true);\n      } else {\n        process.stderr.write(pc.red(`\\n\\u2717 ollama pull exited with code ${code}\\n`));\n        resolvePromise(false);\n      }\n    });\n  });\n}\n\n\nfunction handleCancel<T>(value: T | symbol): asserts value is T {\n  if (isCancel(value)) {\n    cancel(\"Exited without saving.\");\n    process.exit(0);\n  }\n}\n\nfunction renderCurrent(config: Config): string {\n  const hooks: string[] = [];\n  if (config.hooks.edit) hooks.push(\"Edit\");\n  if (config.hooks.write) hooks.push(\"Write\");\n  if (config.hooks.bash) hooks.push(\"Bash\");\n\n  const excluded = config.exclude.length > 0 ? config.exclude.join(\", \") : \"(none)\";\n  const timeoutLabel =\n    config.skipIfSlowMs === 0 ? \"Never skip\" : `${Math.round(config.skipIfSlowMs / 1000)}s`;\n\n  return [\n    `${pc.bold(\"Engine:       \")} ${config.engine === \"ollama\" ? \"Local LLM (Ollama)\" : \"Claude Code (native)\"}`,\n    `${pc.bold(\"Model:        \")} ${config.ollamaModel}`,\n    `${pc.bold(\"Ollama URL:   \")} ${config.ollamaUrl}`,\n    `${pc.bold(\"Detail level: \")} ${config.detailLevel}`,\n    `${pc.bold(\"Language:     \")} ${LANGUAGE_NAMES[config.language]}`,\n    `${pc.bold(\"Learner level:\")} ${LEARNER_LEVEL_NAMES[config.learnerLevel]}`,\n    `${pc.bold(\"Hooks:        \")} ${hooks.join(\" \\u2713  \") || \"(all disabled)\"}`,\n    `${pc.bold(\"Excluded:     \")} ${excluded}`,\n    `${pc.bold(\"Skip if slow: \")} ${timeoutLabel}`,\n  ].join(\"\\n\");\n}\n\ntype MenuChoice =\n  | \"engine\"\n  | \"model\"\n  | \"url\"\n  | \"detail\"\n  | \"language\"\n  | \"level\"\n  | \"hooks\"\n  | \"exclude\"\n  | \"timeout\"\n  | \"back\";\n\nasync function changeEngine(config: Config): Promise<Config> {\n  const value = await select<Engine>({\n    message: \"Explanation engine\",\n    options: [\n      { label: \"Local LLM (Ollama)\", value: \"ollama\", hint: \"free, private, works offline\" },\n      { label: \"Claude Code (native)\", value: \"claude\", hint: \"best quality, uses API tokens\" },\n    ],\n    initialValue: config.engine,\n  });\n  handleCancel(value);\n  return { ...config, engine: value };\n}\n\nasync function changeModel(config: Config): Promise<Config> {\n  const value = await select({\n    message: \"Ollama model\",\n    options: MODEL_OPTIONS.map((m) => ({\n      label: m.label,\n      value: m.model,\n      hint: m.hint,\n    })),\n    initialValue: config.ollamaModel,\n  });\n  handleCancel(value);\n\n  if (value === config.ollamaModel) {\n    // Nothing actually changed; skip the download check.\n    return config;\n  }\n\n  // Check whether Ollama already has the model pulled. If not, offer to pull it.\n  const installed = await listInstalledOllamaModels(config.ollamaUrl);\n  if (installed === null) {\n    note(\n      `Could not reach Ollama at ${pc.cyan(config.ollamaUrl)}. The model will be selected, but you'll need to pull it manually with ${pc.cyan(`ollama pull ${value}`)} before the first explanation.`,\n      \"Ollama unreachable\"\n    );\n    return { ...config, ollamaModel: value };\n  }\n\n  if (hasModel(installed, value)) {\n    note(`${pc.green(\"\\u2713\")} Model ${pc.cyan(value)} is already installed.`, \"Model ready\");\n    return { ...config, ollamaModel: value };\n  }\n\n  const shouldPull = await confirm({\n    message: `Model ${value} is not installed locally. Pull it now?`,\n    initialValue: true,\n  });\n  handleCancel(shouldPull);\n\n  if (!shouldPull) {\n    note(\n      `Saved the selection, but you must run ${pc.cyan(`ollama pull ${value}`)} before it works.`,\n      \"Model not pulled\"\n    );\n    return { ...config, ollamaModel: value };\n  }\n\n  const pullOk = await pullOllamaModel(value);\n  if (!pullOk) {\n    note(\n      `Pull failed. Saving the model selection anyway — run ${pc.cyan(`ollama pull ${value}`)} manually when Ollama is reachable.`,\n      \"Pull failed\"\n    );\n  }\n  return { ...config, ollamaModel: value };\n}\n\nasync function changeUrl(config: Config): Promise<Config> {\n  const value = await text({\n    message: \"Ollama endpoint URL\",\n    initialValue: config.ollamaUrl,\n    validate(v) {\n      try {\n        new URL(v);\n        return;\n      } catch {\n        return \"Must be a valid URL (e.g., http://localhost:11434)\";\n      }\n    },\n  });\n  handleCancel(value);\n  return { ...config, ollamaUrl: value };\n}\n\nasync function changeDetail(config: Config): Promise<Config> {\n  const value = await select<DetailLevel>({\n    message: \"Detail level\",\n    options: [\n      { label: \"Standard\", value: \"standard\", hint: \"1-2 sentence explanation per change (recommended)\" },\n      { label: \"Minimal\", value: \"minimal\", hint: \"one short sentence per change\" },\n      { label: \"Verbose\", value: \"verbose\", hint: \"detailed bullet-point breakdown\" },\n    ],\n    initialValue: config.detailLevel,\n  });\n  handleCancel(value);\n  return { ...config, detailLevel: value };\n}\n\nasync function changeLanguage(config: Config): Promise<Config> {\n  const value = await select<Language>({\n    message: \"Language for explanations\",\n    options: (Object.keys(LANGUAGE_NAMES) as Language[]).map((code) => ({\n      label: LANGUAGE_NAMES[code],\n      value: code,\n      hint: code === \"en\" ? \"default\" : undefined,\n    })),\n    initialValue: config.language,\n  });\n  handleCancel(value);\n  return { ...config, language: value };\n}\n\nasync function changeLevel(config: Config): Promise<Config> {\n  const value = await select<LearnerLevel>({\n    message: \"Programming knowledge level\",\n    options: (Object.keys(LEARNER_LEVEL_NAMES) as LearnerLevel[]).map((code) => ({\n      label: LEARNER_LEVEL_NAMES[code],\n      value: code,\n      hint: code === \"intermediate\" ? \"default\" : undefined,\n    })),\n    initialValue: config.learnerLevel,\n  });\n  handleCancel(value);\n  return { ...config, learnerLevel: value };\n}\n\nasync function changeHooks(config: Config): Promise<Config> {\n  const editOn = await confirm({ message: \"Explain file edits?\", initialValue: config.hooks.edit });\n  handleCancel(editOn);\n  const writeOn = await confirm({ message: \"Explain new files?\", initialValue: config.hooks.write });\n  handleCancel(writeOn);\n  const bashOn = await confirm({\n    message: \"Explain destructive Bash commands (rm, git reset, etc.)?\",\n    initialValue: config.hooks.bash,\n  });\n  handleCancel(bashOn);\n\n  return {\n    ...config,\n    hooks: { edit: editOn, write: writeOn, bash: bashOn },\n  };\n}\n\nasync function changeExclude(config: Config): Promise<Config> {\n  const action = await select({\n    message: `Current exclusions: ${config.exclude.join(\", \") || \"(none)\"}`,\n    options: [\n      { label: \"Add a pattern\", value: \"add\", hint: \"e.g., *.generated.*\" },\n      { label: \"Remove a pattern\", value: \"remove\" },\n      { label: \"Reset to defaults\", value: \"reset\", hint: DEFAULT_CONFIG.exclude.join(\", \") },\n      { label: \"Back\", value: \"back\" },\n    ],\n  });\n  handleCancel(action);\n\n  if (action === \"back\") return config;\n  if (action === \"reset\") return { ...config, exclude: [...DEFAULT_CONFIG.exclude] };\n\n  if (action === \"add\") {\n    const pattern = await text({ message: \"Glob pattern to exclude (e.g., *.generated.*)\" });\n    handleCancel(pattern);\n    if (!pattern.trim()) return config;\n    const exclude = Array.from(new Set([...config.exclude, pattern.trim()]));\n    return { ...config, exclude };\n  }\n\n  if (action === \"remove\") {\n    if (config.exclude.length === 0) {\n      note(\"No exclusions to remove.\", \"Exclusions\");\n      return config;\n    }\n    const target = await select({\n      message: \"Which pattern to remove?\",\n      options: config.exclude.map((p) => ({ label: p, value: p })),\n    });\n    handleCancel(target);\n    const exclude = config.exclude.filter((p) => p !== target);\n    return { ...config, exclude };\n  }\n\n  return config;\n}\n\nasync function changeTimeout(config: Config): Promise<Config> {\n  const value = await select<number>({\n    message: \"Skip explanation if it takes longer than...\",\n    options: [\n      { label: \"5 seconds\", value: 5000, hint: \"fast, may skip complex changes\" },\n      { label: \"8 seconds\", value: 8000, hint: \"balanced (recommended)\" },\n      { label: \"15 seconds\", value: 15000, hint: \"patient, rarely skips\" },\n      { label: \"Never skip\", value: 0, hint: \"always wait for the explanation\" },\n    ],\n    initialValue: config.skipIfSlowMs,\n  });\n  handleCancel(value);\n  return { ...config, skipIfSlowMs: value };\n}\n\nfunction resolveConfigPath(): { configPath: string; scope: \"project\" | \"global\" } | null {\n  const projectPath = join(process.cwd(), CONFIG_FILENAME);\n  const globalPath = getGlobalConfigPath();\n  if (existsSync(projectPath)) return { configPath: projectPath, scope: \"project\" };\n  if (existsSync(globalPath)) return { configPath: globalPath, scope: \"global\" };\n  return null;\n}\n\n/**\n * config show [--json]\n * Print the effective config. With --json, outputs machine-readable JSON so\n * agents can pipe to jq or parse directly.\n */\nfunction runConfigShow(args: string[]): void {\n  const { flags } = parseFlags(args);\n  const json = flagBool(flags, \"json\", \"j\");\n\n  const resolved = resolveConfigPath();\n  if (!resolved) {\n    process.stderr.write(\"[code-explainer] No config file found. Run 'vibe-code-explainer init' first.\\n\");\n    process.exit(1);\n  }\n  const config = loadConfig(resolved.configPath);\n  if (json) {\n    process.stdout.write(JSON.stringify(config, null, 2) + \"\\n\");\n  } else {\n    process.stderr.write(renderCurrent(config) + \"\\n\");\n  }\n}\n\n/**\n * config get <key>\n * Print a single config field as a plain string (for scripting).\n * Key may be dot-separated for nested fields (e.g. hooks.bash).\n */\nfunction runConfigGet(args: string[]): void {\n  const { positional } = parseFlags(args);\n  const key = positional[0];\n  if (!key) {\n    process.stderr.write(\"[code-explainer] Usage: vibe-code-explainer config get <key>\\n\");\n    process.exit(1);\n  }\n  const resolved = resolveConfigPath();\n  if (!resolved) {\n    process.stderr.write(\"[code-explainer] No config file found. Run 'vibe-code-explainer init' first.\\n\");\n    process.exit(1);\n  }\n  const config = loadConfig(resolved.configPath) as Record<string, unknown>;\n  const parts = key.split(\".\");\n  let cur: unknown = config;\n  for (const part of parts) {\n    if (typeof cur !== \"object\" || cur === null) {\n      process.stderr.write(`[code-explainer] Key '${key}' not found in config.\\n`);\n      process.exit(1);\n    }\n    cur = (cur as Record<string, unknown>)[part];\n  }\n  if (cur === undefined) {\n    process.stderr.write(`[code-explainer] Key '${key}' not found in config.\\n`);\n    process.exit(1);\n  }\n  // Output plain scalar or JSON for objects/arrays.\n  if (typeof cur === \"object\") {\n    process.stdout.write(JSON.stringify(cur) + \"\\n\");\n  } else {\n    process.stdout.write(String(cur) + \"\\n\");\n  }\n}\n\n/**\n * config set <key> <value>\n * Set a single config field. The value is parsed as JSON when it looks like\n * a JSON literal (number, boolean, array, object), otherwise treated as a\n * plain string.\n */\nfunction runConfigSet(args: string[]): void {\n  const { positional } = parseFlags(args);\n  const [key, rawValue] = positional;\n  if (!key || rawValue === undefined) {\n    process.stderr.write(\"[code-explainer] Usage: vibe-code-explainer config set <key> <value>\\n\");\n    process.exit(1);\n  }\n  const resolved = resolveConfigPath();\n  if (!resolved) {\n    process.stderr.write(\"[code-explainer] No config file found. Run 'vibe-code-explainer init' first.\\n\");\n    process.exit(1);\n  }\n\n  let value: unknown = rawValue;\n  try {\n    value = JSON.parse(rawValue);\n  } catch {\n    // Use as plain string\n  }\n\n  // Deep-set the key into the config object.\n  const config = loadConfig(resolved.configPath) as Record<string, unknown>;\n  const parts = key.split(\".\");\n  let cur: Record<string, unknown> = config;\n  for (let i = 0; i < parts.length - 1; i++) {\n    const part = parts[i];\n    if (typeof cur[part] !== \"object\" || cur[part] === null) {\n      cur[part] = {};\n    }\n    cur = cur[part] as Record<string, unknown>;\n  }\n  cur[parts[parts.length - 1]] = value;\n\n  writeFileSync(resolved.configPath, JSON.stringify(config, null, 2) + \"\\n\");\n  process.stderr.write(`[code-explainer] Set ${key} = ${JSON.stringify(value)} in ${resolved.configPath}\\n`);\n}\n\nexport async function runConfig(rawArgs: string[] = []): Promise<void> {\n  const { flags, positional } = parseFlags(rawArgs);\n  const subcommand = positional[0];\n  const subArgs = positional.slice(1);\n\n  // Non-interactive subcommands for agent-native access.\n  if (subcommand === \"show\") { runConfigShow([...subArgs, ...Object.entries(flags).flatMap(([k, v]) => v === true ? [`--${k}`] : [`--${k}=${v}`])]); return; }\n  if (subcommand === \"get\") { runConfigGet(subArgs); return; }\n  if (subcommand === \"set\") { runConfigSet(subArgs); return; }\n\n  // Interactive TUI mode.\n  const projectPath = join(process.cwd(), CONFIG_FILENAME);\n  const globalPath = getGlobalConfigPath();\n\n  let configPath: string;\n  let scope: \"project\" | \"global\";\n  if (existsSync(projectPath)) {\n    configPath = projectPath;\n    scope = \"project\";\n  } else if (existsSync(globalPath)) {\n    configPath = globalPath;\n    scope = \"global\";\n  } else {\n    intro(pc.bold(\"code-explainer config\"));\n    cancel(\n      `No config file found.\\nSearched: ${pc.cyan(projectPath)}\\n         ${pc.cyan(globalPath)}\\nRun ${pc.cyan(\"npx vibe-code-explainer init\")} first.`\n    );\n    process.exit(1);\n  }\n\n  intro(pc.bold(`code-explainer config (${scope})`));\n\n  // --yes: skip confirmation for non-interactive environments.\n  const skipConfirm = flagBool(flags, \"yes\", \"y\");\n\n  let config = loadConfig(configPath);\n\n  while (true) {\n    note(renderCurrent(config), \"Current settings\");\n\n    const choice = await select<MenuChoice>({\n      message: \"What would you like to change?\",\n      options: [\n        { label: \"Engine\", value: \"engine\" },\n        { label: \"Model\", value: \"model\" },\n        { label: \"Ollama URL\", value: \"url\" },\n        { label: \"Detail level\", value: \"detail\" },\n        { label: \"Language\", value: \"language\" },\n        { label: \"Learner level\", value: \"level\" },\n        { label: \"Enable/disable hooks\", value: \"hooks\" },\n        { label: \"File exclusions\", value: \"exclude\" },\n        { label: \"Latency timeout\", value: \"timeout\" },\n        { label: \"Back (save and exit)\", value: \"back\" },\n      ],\n    });\n    handleCancel(choice);\n\n    if (choice === \"back\") break;\n    if (choice === \"engine\") config = await changeEngine(config);\n    if (choice === \"model\") config = await changeModel(config);\n    if (choice === \"url\") config = await changeUrl(config);\n    if (choice === \"detail\") config = await changeDetail(config);\n    if (choice === \"language\") config = await changeLanguage(config);\n    if (choice === \"level\") config = await changeLevel(config);\n    if (choice === \"hooks\") config = await changeHooks(config);\n    if (choice === \"exclude\") config = await changeExclude(config);\n    if (choice === \"timeout\") config = await changeTimeout(config);\n\n    writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\");\n  }\n\n  if (!skipConfirm) {\n    outro(pc.green(\"Settings saved.\"));\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/post-tool.js

@@ -1,12 +1,14 @@
 #!/usr/bin/env node
 import {
   buildClaudePrompt,
-  callOllama
-} from "../chunk-2IARGRDK.js";
+  callOllama,
+  parseResponse,
+  truncateText
+} from "../chunk-ZZY3IDL2.js";
 import {
   DEFAULT_CONFIG,
   loadConfig
-} from "../chunk-RK7ZFN4W.js";
+} from "../chunk-GU4Y5ZWY.js";
 import {
   cleanStaleSessionFiles,
   formatDriftAlert,
@@ -15,10 +17,11 @@ import {
   formatSkipNotice,
   getCached,
   getRecentSummaries,
+  isSafeSessionId,
   readSession,
   recordEntry,
   setCached
-} from "../chunk-Y55I7ZS5.js";
+} from "../chunk-VJN7Y4SI.js";
 import "../chunk-7OCVIDC7.js";
 
 // src/hooks/post-tool.ts
@@ -26,57 +29,6 @@ import { join } from "path";
 
 // src/engines/claude.ts
 import { execFile } from "child_process";
-function extractJson(text) {
-  const trimmed = text.trim();
-  if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
-    return trimmed;
-  }
-  const fenceMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
-  if (fenceMatch) {
-    return fenceMatch[1].trim();
-  }
-  const start = trimmed.indexOf("{");
-  const end = trimmed.lastIndexOf("}");
-  if (start !== -1 && end !== -1 && end > start) {
-    return trimmed.slice(start, end + 1);
-  }
-  return null;
-}
-function coerceString(v) {
-  return typeof v === "string" ? v : "";
-}
-function coerceDeepDive(v) {
-  if (!Array.isArray(v)) return [];
-  return v.filter((it) => typeof it === "object" && it !== null).map((it) => ({
-    term: coerceString(it.term),
-    explanation: coerceString(it.explanation)
-  })).filter((it) => it.term.length > 0);
-}
-function parseResponse(rawText) {
-  const json = extractJson(rawText);
-  if (!json) return null;
-  try {
-    const parsed = JSON.parse(json);
-    const risk = coerceString(parsed.risk);
-    if (!["none", "low", "medium", "high"].includes(risk)) return null;
-    return {
-      impact: coerceString(parsed.impact),
-      howItWorks: coerceString(parsed.howItWorks),
-      why: coerceString(parsed.why),
-      deepDive: coerceDeepDive(parsed.deepDive),
-      isSamePattern: parsed.isSamePattern === true,
-      samePatternNote: coerceString(parsed.samePatternNote),
-      risk,
-      riskReason: coerceString(parsed.riskReason)
-    };
-  } catch {
-    return null;
-  }
-}
-function truncateText(text, max) {
-  if (text.length <= max) return text;
-  return text.slice(0, max) + "...";
-}
 function runClaude(prompt, timeoutMs) {
   return new Promise((resolve, reject) => {
     const child = execFile(
@@ -111,14 +63,23 @@ function runClaude(prompt, timeoutMs) {
   });
 }
 async function callClaude(inputs) {
-  const prompt = buildClaudePrompt(inputs.config.detailLevel, {
-    filePath: inputs.filePath,
-    diff: inputs.diff,
-    userPrompt: inputs.userPrompt,
-    language: inputs.config.language,
-    learnerLevel: inputs.config.learnerLevel,
-    recentSummaries: inputs.recentSummaries
-  });
+  let prompt;
+  try {
+    prompt = buildClaudePrompt(inputs.config.detailLevel, {
+      filePath: inputs.filePath,
+      diff: inputs.diff,
+      language: inputs.config.language,
+      learnerLevel: inputs.config.learnerLevel,
+      recentSummaries: inputs.recentSummaries
+    });
+  } catch (err) {
+    return {
+      kind: "error",
+      problem: "Failed to build Claude prompt",
+      cause: err.message || String(err),
+      fix: "Check detailLevel/learnerLevel/language values via 'npx vibe-code-explainer config'"
+    };
+  }
   try {
     const result = await runClaude(prompt, inputs.config.skipIfSlowMs);
     if (result.code !== 0) {
@@ -287,6 +248,20 @@ function extractNewFileDiff(filePath, cwd) {
   }
   return { kind: "empty" };
 }
+function looksBinary(buf) {
+  const sample = buf.length > 8192 ? buf.subarray(0, 8192) : buf;
+  if (sample.length === 0) return false;
+  if (sample.indexOf(0) !== -1) return true;
+  let nonPrint = 0;
+  for (let i = 0; i < sample.length; i++) {
+    const b = sample[i];
+    if (b === 9 || b === 10 || b === 13 || b >= 32 && b <= 126 || b >= 128) {
+      continue;
+    }
+    nonPrint++;
+  }
+  return nonPrint / sample.length > 0.3;
+}
 function readFileAsNewDiff(filePath) {
   if (!existsSync(filePath)) {
     return { kind: "skip", reason: `file not found: ${filePath}` };
@@ -296,13 +271,17 @@ function readFileAsNewDiff(filePath) {
     if (stat.size > 2 * 1024 * 1024) {
       return { kind: "skip", reason: `file too large (${Math.round(stat.size / 1024)}KB)` };
     }
-    const raw = readFileSync(filePath, "utf-8");
-    if (!raw.trim()) {
+    const buf = readFileSync(filePath);
+    if (buf.length === 0) {
       return { kind: "empty" };
     }
-    if (raw.includes("\0")) {
+    if (looksBinary(buf)) {
       return { kind: "binary", message: `Binary file created: ${filePath}` };
     }
+    const raw = buf.toString("utf-8");
+    if (!raw.trim()) {
+      return { kind: "empty" };
+    }
     const withMarkers = raw.split("\n").map((l) => `+ ${l}`).join("\n");
     const diff = `--- /dev/null
 +++ b/${filePath}
@@ -359,7 +338,32 @@ var MUTATING_COMMANDS = /* @__PURE__ */ new Set([
   "chown",
   "ln",
   "touch",
-  "dd"
+  "dd",
+  "tee",
+  "install",
+  "truncate",
+  "shred",
+  "rsync",
+  "scp",
+  "sftp",
+  "mount",
+  "umount",
+  "kill",
+  "killall",
+  "pkill",
+  "crontab",
+  "useradd",
+  "userdel",
+  "usermod",
+  "groupadd",
+  "groupdel",
+  "passwd",
+  "chpasswd",
+  "visudo",
+  "systemctl",
+  "service",
+  "launchctl"
+  // Note: brew is in CONTEXTUAL_COMMANDS (finer-grained control); do not add here.
 ]);
 var CONTEXTUAL_COMMANDS = {
   npm: /\b(install|add|remove|uninstall|update|ci|link|unlink|init|publish)\b/,
@@ -446,9 +450,12 @@ function subCommandShouldCapture(subCmd) {
     const rest = tokens.slice(idx + 1).join(" ");
     return contextPattern.test(rest);
   }
-  return false;
+  return true;
 }
-function shouldCaptureBash(command) {
+function shouldCaptureBash(command, capturePatterns = []) {
+  if (capturePatterns.length > 0 && capturePatterns.some((p) => command.includes(p))) {
+    return true;
+  }
   const parts = splitCommandChain(command);
   return parts.some((p) => subCommandShouldCapture(p));
 }
@@ -502,12 +509,11 @@ function shouldAlertDrift(entries) {
   const unrelatedFiles = Array.from(
     new Set(entries.filter((e) => e.unrelated).map((e) => e.file))
   );
-  const shouldAlert = unrelatedFiles.length > 0 && unrelatedFiles.length % DRIFT_ALERT_THRESHOLD === 0 && entries.filter((e) => e.unrelated).length === entries.filter((e) => e.unrelated).length;
   const lastEntry = entries[entries.length - 1];
   const lastWasUnrelated = lastEntry?.unrelated ?? false;
-  const crossedThreshold = lastWasUnrelated && unrelatedFiles.length % DRIFT_ALERT_THRESHOLD === 0;
+  const shouldAlert = lastWasUnrelated && unrelatedFiles.length === DRIFT_ALERT_THRESHOLD;
   return {
-    shouldAlert: crossedThreshold && shouldAlert,
+    shouldAlert,
     totalFiles: uniqueFiles.length,
     unrelatedFiles
   };
@@ -519,11 +525,14 @@ function addOutput(text) {
   output.push(text);
 }
 function safeExit() {
-  if (output.length > 0) {
-    const systemMessage = "\n" + output.join("\n");
-    process.stdout.write(JSON.stringify({ systemMessage }) + "\n");
-  }
-  process.exit(0);
+  if (output.length === 0) {
+    process.exit(0);
+  }
+  const systemMessage = "\n" + output.join("\n");
+  const payload = JSON.stringify({ systemMessage }) + "\n";
+  process.stdout.write(payload, () => process.exit(0));
+  setTimeout(() => process.exit(0), 500);
+  throw new Error("unreachable");
 }
 async function readStdin() {
   return new Promise((resolve) => {
@@ -540,10 +549,11 @@ async function readStdin() {
 function parsePayload(raw) {
   try {
     const parsed = JSON.parse(raw);
-    if (typeof parsed.session_id === "string" && typeof parsed.tool_name === "string") {
-      return parsed;
-    }
-    return null;
+    if (typeof parsed !== "object" || parsed === null) return null;
+    if (!isSafeSessionId(parsed.session_id)) return null;
+    if (typeof parsed.tool_name !== "string") return null;
+    if (typeof parsed.tool_input !== "object" || parsed.tool_input === null) return null;
+    return parsed;
   } catch {
     return null;
   }
@@ -562,14 +572,48 @@ function isHookEnabled(toolName, config) {
   if (lower === "bash") return config.hooks.bash;
   return false;
 }
-async function runEngine(filePath, diff, config, userPrompt, recentSummaries, signal) {
+async function runEngine(filePath, diff, config, recentSummaries, signal) {
   if (signal.aborted) {
     return { kind: "skip", reason: "interrupted by user" };
   }
   if (config.engine === "ollama") {
     return callOllama({ filePath, diff, config, recentSummaries });
   }
-  return callClaude({ filePath, diff, config, userPrompt, recentSummaries });
+  return callClaude({ filePath, diff, config, recentSummaries });
+}
+function buildEditWriteDiff(payload, config, cwd) {
+  const lowerTool = payload.tool_name.toLowerCase();
+  const input = payload.tool_input;
+  const target = input.file_path ?? input.filePath;
+  if (!target) {
+    safeExit();
+  }
+  const filePath = target;
+  if (isExcluded(filePath, config.exclude)) {
+    safeExit();
+  }
+  let result;
+  if (lowerTool === "edit") {
+    const oldStr = input.old_string ?? input.oldString ?? "";
+    const newStr = input.new_string ?? input.newString ?? "";
+    result = oldStr || newStr ? buildDiffFromEdit(filePath, oldStr, newStr) : extractEditDiff(filePath, cwd);
+  } else if (lowerTool === "multiedit") {
+    result = input.edits && input.edits.length > 0 ? buildDiffFromMultiEdit(filePath, input.edits) : extractEditDiff(filePath, cwd);
+  } else {
+    result = extractNewFileDiff(filePath, cwd);
+  }
+  if (result.kind === "empty") {
+    safeExit();
+  }
+  if (result.kind === "skip") {
+    addOutput(formatSkipNotice(result.reason));
+    safeExit();
+  }
+  if (result.kind === "binary") {
+    addOutput(formatSkipNotice(result.message));
+    safeExit();
+  }
+  return { filePath, diff: result.content };
 }
 async function main() {
   const controller = new AbortController();
@@ -591,48 +635,20 @@ async function main() {
   let diff;
   const lowerTool = payload.tool_name.toLowerCase();
   if (lowerTool === "edit" || lowerTool === "multiedit" || lowerTool === "write") {
-    const input = payload.tool_input;
-    const target = input.file_path ?? input.filePath;
+    const target = buildEditWriteDiff(payload, config, cwd);
     if (!target) safeExit();
-    filePath = target;
-    if (isExcluded(filePath, config.exclude)) safeExit();
-    let result2;
-    if (lowerTool === "edit") {
-      const oldStr = input.old_string ?? input.oldString ?? "";
-      const newStr = input.new_string ?? input.newString ?? "";
-      if (oldStr || newStr) {
-        result2 = buildDiffFromEdit(filePath, oldStr, newStr);
-      } else {
-        result2 = extractEditDiff(filePath, cwd);
-      }
-    } else if (lowerTool === "multiedit") {
-      if (input.edits && input.edits.length > 0) {
-        result2 = buildDiffFromMultiEdit(filePath, input.edits);
-      } else {
-        result2 = extractEditDiff(filePath, cwd);
-      }
-    } else {
-      result2 = extractNewFileDiff(filePath, cwd);
-    }
-    if (result2.kind === "empty") safeExit();
-    if (result2.kind === "skip") {
-      addOutput(formatSkipNotice(result2.reason));
-      safeExit();
-    }
-    if (result2.kind === "binary") {
-      addOutput(formatSkipNotice(result2.message));
-      safeExit();
-    }
-    diff = result2.content;
+    ({ filePath, diff } = target);
   } else if (lowerTool === "bash") {
     const input = payload.tool_input;
     const command = input.command ?? "";
-    if (!command || !shouldCaptureBash(command)) safeExit();
+    if (!command || !shouldCaptureBash(command, config.bashFilter.capturePatterns)) safeExit();
     filePath = "<bash command>";
     diff = command;
   } else {
     safeExit();
   }
+  const isBash = filePath === "<bash command>";
+  const priorEntries = isBash ? [] : readSession(payload.session_id);
   const cacheKey = `${filePath}
 ${diff}`;
   const cached = getCached(payload.session_id, cacheKey);
@@ -640,15 +656,8 @@ ${diff}`;
   if (cached) {
     result = cached;
   } else {
-    const recentSummaries = getRecentSummaries(payload.session_id, 3);
-    const outcome = await runEngine(
-      filePath,
-      diff,
-      config,
-      void 0,
-      recentSummaries,
-      controller.signal
-    );
+    const recentSummaries = getRecentSummaries(payload.session_id, 3, priorEntries);
+    const outcome = await runEngine(filePath, diff, config, recentSummaries, controller.signal);
     if (outcome.kind === "skip") {
       addOutput(formatSkipNotice(outcome.reason));
       safeExit();
@@ -661,8 +670,7 @@ ${diff}`;
     setCached(payload.session_id, cacheKey, result);
   }
   let driftReason;
-  if (filePath !== "<bash command>") {
-    const priorEntries = readSession(payload.session_id);
+  if (!isBash) {
     const analysis = analyzeDrift(filePath, priorEntries);
     if (analysis.isUnrelated) {
       driftReason = analysis.reason;
@@ -684,8 +692,15 @@ ${diff}`;
     summary: summaryForTracking,
     unrelated: !!driftReason
   });
-  const updated = readSession(payload.session_id);
-  const driftCheck = shouldAlertDrift(updated);
+  const entryJustRecorded = {
+    file: filePath,
+    timestamp: Date.now(),
+    risk: result.risk,
+    summary: summaryForTracking,
+    unrelated: !!driftReason
+  };
+  const updatedEntries = [...priorEntries, entryJustRecorded];
+  const driftCheck = shouldAlertDrift(updatedEntries);
   if (driftCheck.shouldAlert) {
     addOutput(formatDriftAlert(driftCheck.totalFiles, driftCheck.unrelatedFiles, void 0, config.language));
   }