vibe-code-explainer 0.1.1 → 0.1.3

package/dist/{chunk-DPYDNBM3.js → chunk-UJLSOUEZ.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  __require
+} from "./chunk-7OCVIDC7.js";
 
 // src/session/tracker.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, appendFileSync as appendFileSync2, unlinkSync as unlinkSync2, mkdirSync as mkdirSync2, readdirSync, statSync } from "fs";
@@ -187,7 +190,15 @@ function formatErrorNotice(problem, cause, fix) {
   return color(pc.yellow, `[code-explainer] ${problem}. ${cause}. Fix: ${fix}.`);
 }
 function printToStderr(text) {
-  process.stderr.write(text + "\n");
+  try {
+    const fs = __require("fs");
+    const ttyPath = process.platform === "win32" ? "\\\\.\\CONOUT$" : "/dev/tty";
+    const fd = fs.openSync(ttyPath, "w");
+    fs.writeSync(fd, text + "\n");
+    fs.closeSync(fd);
+  } catch {
+    process.stderr.write(text + "\n");
+  }
 }
 
 // src/session/tracker.ts
@@ -334,4 +345,4 @@ export {
   printSummary,
   endSession
 };
-//# sourceMappingURL=chunk-DPYDNBM3.js.map
+//# sourceMappingURL=chunk-UJLSOUEZ.js.map

package/dist/{chunk-DPYDNBM3.js.map → chunk-UJLSOUEZ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/session/tracker.ts","../src/cache/explanation-cache.ts","../src/format/box.ts"],"sourcesContent":["import { existsSync, readFileSync, appendFileSync, unlinkSync, mkdirSync, readdirSync, statSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { RiskLevel } from \"../config/schema.js\";\nimport { clearCache } from \"../cache/explanation-cache.js\";\nimport { formatDriftAlert, printToStderr } from \"../format/box.js\";\n\nconst TWO_HOURS_MS = 2 * 60 * 60 * 1000;\n\nexport interface SessionEntry {\n  file: string;\n  timestamp: number;\n  risk: RiskLevel;\n  summary: string;\n  unrelated?: boolean;\n}\n\nfunction getUserTmpDir(): string {\n  const dir = join(tmpdir(), `code-explainer-${process.getuid?.() ?? \"user\"}`);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true, mode: 0o700 });\n  }\n  return dir;\n}\n\nexport function getSessionFilePath(sessionId: string): string {\n  return join(getUserTmpDir(), `session-${sessionId}.jsonl`);\n}\n\nexport function recordEntry(sessionId: string, entry: SessionEntry): void {\n  const path = getSessionFilePath(sessionId);\n  try {\n    appendFileSync(path, JSON.stringify(entry) + \"\\n\", { mode: 0o600 });\n  } catch {\n    // Non-fatal\n  }\n}\n\nexport function readSession(sessionId: string): SessionEntry[] {\n  const path = getSessionFilePath(sessionId);\n  if (!existsSync(path)) return [];\n\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    return content\n      .split(\"\\n\")\n      .filter((l) => l.trim())\n      .map((line) => {\n        try {\n          return JSON.parse(line) as SessionEntry;\n        } catch {\n          return null;\n        }\n      })\n      .filter((e): e is SessionEntry => e !== null);\n  } catch {\n    return [];\n  }\n}\n\nexport function cleanStaleSessionFiles(): void {\n  try {\n    const dir = getUserTmpDir();\n    const now = Date.now();\n    const entries = readdirSync(dir);\n    for (const name of entries) {\n      if (!name.startsWith(\"session-\") && !name.startsWith(\"cache-\")) continue;\n      const filePath = join(dir, name);\n      try {\n        const stat = statSync(filePath);\n        if (now - stat.mtimeMs > TWO_HOURS_MS) {\n          unlinkSync(filePath);\n        }\n      } catch {\n        // ignore\n      }\n    }\n  } catch {\n    // ignore\n  }\n}\n\nfunction getSessionIdFromEnv(): string | undefined {\n  return process.env.CODE_EXPLAINER_SESSION_ID;\n}\n\nfunction findLatestSession(): string | undefined {\n  try {\n    const dir = getUserTmpDir();\n    const entries = readdirSync(dir)\n      .filter((n) => n.startsWith(\"session-\") && n.endsWith(\".jsonl\"))\n      .map((n) => ({\n        name: n,\n        id: n.slice(\"session-\".length, -\".jsonl\".length),\n        mtime: statSync(join(dir, n)).mtimeMs,\n      }))\n      .sort((a, b) => b.mtime - a.mtime);\n    return entries[0]?.id;\n  } catch {\n    return undefined;\n  }\n}\n\nexport async function printSummary(): Promise<void> {\n  const sessionId = getSessionIdFromEnv() ?? findLatestSession();\n  if (!sessionId) {\n    process.stderr.write(\"[code-explainer] No active session found. Session data is created when Claude Code makes changes.\\n\");\n    return;\n  }\n\n  const entries = readSession(sessionId);\n  if (entries.length === 0) {\n    process.stderr.write(`[code-explainer] Session '${sessionId}' has no recorded changes yet.\\n`);\n    return;\n  }\n\n  const related = entries.filter((e) => !e.unrelated);\n  const unrelated = entries.filter((e) => e.unrelated);\n  const uniqueFiles = Array.from(new Set(entries.map((e) => e.file)));\n  const unrelatedFiles = Array.from(new Set(unrelated.map((e) => e.file)));\n\n  const alert = formatDriftAlert(uniqueFiles.length, unrelatedFiles);\n  printToStderr(alert);\n\n  process.stderr.write(`\\nTotal changes: ${entries.length}\\n`);\n  process.stderr.write(`Files touched: ${uniqueFiles.length}\\n`);\n  process.stderr.write(`Related changes: ${related.length}\\n`);\n  process.stderr.write(`Unrelated/risky: ${unrelated.length}\\n`);\n\n  const risks: Record<RiskLevel, number> = { none: 0, low: 0, medium: 0, high: 0 };\n  for (const e of entries) risks[e.risk]++;\n  process.stderr.write(`\\nRisk breakdown:\\n`);\n  process.stderr.write(`  None:   ${risks.none}\\n`);\n  process.stderr.write(`  Low:    ${risks.low}\\n`);\n  process.stderr.write(`  Medium: ${risks.medium}\\n`);\n  process.stderr.write(`  High:   ${risks.high}\\n`);\n}\n\nexport async function endSession(): Promise<void> {\n  const sessionId = getSessionIdFromEnv() ?? findLatestSession();\n  if (!sessionId) {\n    process.stderr.write(\"[code-explainer] No active session to end.\\n\");\n    return;\n  }\n\n  const sessionPath = getSessionFilePath(sessionId);\n  if (existsSync(sessionPath)) {\n    try {\n      unlinkSync(sessionPath);\n    } catch {\n      // ignore\n    }\n  }\n  clearCache(sessionId);\n  process.stderr.write(`[code-explainer] Session '${sessionId}' ended. State cleared.\\n`);\n}\n","import { createHash } from \"node:crypto\";\nimport { existsSync, readFileSync, appendFileSync, unlinkSync, mkdirSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { ExplanationResult } from \"../config/schema.js\";\n\nfunction getUserTmpDir(): string {\n  const dir = join(tmpdir(), `code-explainer-${process.getuid?.() ?? \"user\"}`);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true, mode: 0o700 });\n  }\n  return dir;\n}\n\nexport function getCacheFilePath(sessionId: string): string {\n  return join(getUserTmpDir(), `cache-${sessionId}.jsonl`);\n}\n\nexport function hashDiff(diff: string): string {\n  return createHash(\"sha256\").update(diff, \"utf-8\").digest(\"hex\");\n}\n\ninterface CacheEntry {\n  hash: string;\n  result: ExplanationResult;\n}\n\nexport function getCached(sessionId: string, diff: string): ExplanationResult | undefined {\n  const path = getCacheFilePath(sessionId);\n  if (!existsSync(path)) return undefined;\n\n  const hash = hashDiff(diff);\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    const lines = content.split(\"\\n\").filter((l) => l.trim());\n\n    // Iterate in reverse so the most recent entry wins on duplicates.\n    for (let i = lines.length - 1; i >= 0; i--) {\n      try {\n        const entry = JSON.parse(lines[i]) as CacheEntry;\n        if (entry.hash === hash) {\n          return entry.result;\n        }\n      } catch {\n        // Skip malformed line\n      }\n    }\n  } catch {\n    return undefined;\n  }\n  return undefined;\n}\n\nexport function setCached(sessionId: string, diff: string, result: ExplanationResult): void {\n  const path = getCacheFilePath(sessionId);\n  const entry: CacheEntry = { hash: hashDiff(diff), result };\n  try {\n    appendFileSync(path, JSON.stringify(entry) + \"\\n\", { mode: 0o600 });\n  } catch {\n    // Cache write failures are non-fatal\n  }\n}\n\nexport function clearCache(sessionId: string): void {\n  const path = getCacheFilePath(sessionId);\n  if (existsSync(path)) {\n    try {\n      unlinkSync(path);\n    } catch {\n      // ignore\n    }\n  }\n}\n","import pc from \"picocolors\";\nimport type { RiskLevel } from \"../config/schema.js\";\n\nfunction isNoColor(): boolean {\n  return \"NO_COLOR\" in process.env || process.env.TERM === \"dumb\";\n}\n\nfunction color(fn: (s: string) => string, text: string): string {\n  return isNoColor() ? text : fn(text);\n}\n\nfunction getTerminalWidth(): number {\n  return process.stderr.columns || 80;\n}\n\nfunction wrapText(text: string, maxWidth: number): string[] {\n  const lines: string[] = [];\n  for (const raw of text.split(\"\\n\")) {\n    if (raw.length <= maxWidth) {\n      lines.push(raw);\n    } else {\n      let remaining = raw;\n      while (remaining.length > maxWidth) {\n        let breakAt = remaining.lastIndexOf(\" \", maxWidth);\n        if (breakAt <= 0) breakAt = maxWidth;\n        lines.push(remaining.slice(0, breakAt));\n        remaining = remaining.slice(breakAt).trimStart();\n      }\n      if (remaining) lines.push(remaining);\n    }\n  }\n  return lines;\n}\n\nfunction riskIcon(risk: RiskLevel): string {\n  if (isNoColor()) {\n    switch (risk) {\n      case \"none\": return \"[OK]\";\n      case \"low\": return \"[LOW]\";\n      case \"medium\": return \"[WARN]\";\n      case \"high\": return \"[DANGER]\";\n    }\n  }\n  switch (risk) {\n    case \"none\": return color(pc.green, \"\\u2705\");\n    case \"low\": return color(pc.yellow, \"\\u26A0\\uFE0F\");\n    case \"medium\": return color(pc.yellow, \"\\u26A0\\uFE0F\");\n    case \"high\": return color(pc.red, \"\\u{1F6A8}\");\n  }\n}\n\nfunction riskLabel(risk: RiskLevel): string {\n  switch (risk) {\n    case \"none\": return \"None\";\n    case \"low\": return \"Low\";\n    case \"medium\": return \"Medium\";\n    case \"high\": return \"High\";\n  }\n}\n\nexport function formatExplanationBox(\n  filePath: string,\n  summary: string,\n  risk: RiskLevel,\n  riskReason: string\n): string {\n  const width = Math.min(getTerminalWidth() - 4, 60);\n  const contentWidth = width - 4; // \"│  \" prefix + \" \" suffix\n\n  const isRisky = risk === \"medium\" || risk === \"high\";\n  const headerLabel = isRisky ? \"code-explainer \\u26A0\\uFE0F\" : \"code-explainer\";\n  const topBorder = `\\u250C\\u2500 ${headerLabel} ${ \"\\u2500\".repeat(Math.max(0, width - headerLabel.length - 4))}\\u2500`;\n  const bottomBorder = `\\u2514${ \"\\u2500\".repeat(width)}\\u2500`;\n\n  const lines: string[] = [];\n  lines.push(isRisky ? color(pc.yellow, topBorder) : color(pc.dim, topBorder));\n\n  // File path\n  const fileDisplay = isRisky ? `${riskIcon(risk)}  ${filePath}` : `  ${filePath}`;\n  lines.push(`${color(pc.dim, \"\\u2502\")}${fileDisplay}`);\n  lines.push(`${color(pc.dim, \"\\u2502\")}`);\n\n  // Summary\n  const summaryLines = wrapText(summary, contentWidth);\n  for (const line of summaryLines) {\n    lines.push(`${color(pc.dim, \"\\u2502\")}  ${line}`);\n  }\n\n  lines.push(`${color(pc.dim, \"\\u2502\")}`);\n\n  // Risk line\n  const riskText = `Risk: ${riskIcon(risk)} ${riskLabel(risk)}`;\n  lines.push(`${color(pc.dim, \"\\u2502\")}  ${riskText}`);\n\n  // Risk reason (if any)\n  if (riskReason) {\n    const reasonLines = wrapText(riskReason, contentWidth);\n    for (const line of reasonLines) {\n      lines.push(`${color(pc.dim, \"\\u2502\")}  ${color(pc.dim, line)}`);\n    }\n  }\n\n  lines.push(isRisky ? color(pc.yellow, bottomBorder) : color(pc.dim, bottomBorder));\n\n  return lines.join(\"\\n\");\n}\n\nexport function formatDriftAlert(\n  totalFiles: number,\n  unrelatedFiles: string[],\n  userRequest?: string\n): string {\n  const width = Math.min(getTerminalWidth() - 4, 60);\n  const contentWidth = width - 4;\n\n  const headerLabel = \"code-explainer \\u26A1 SESSION DRIFT\";\n  const topBorder = `\\u250C\\u2500 ${headerLabel} ${ \"\\u2500\".repeat(Math.max(0, width - headerLabel.length - 4))}\\u2500`;\n  const bottomBorder = `\\u2514${ \"\\u2500\".repeat(width)}\\u2500`;\n\n  const lines: string[] = [];\n  lines.push(color(pc.yellow, topBorder));\n\n  lines.push(`${color(pc.dim, \"\\u2502\")}  Claude has modified ${totalFiles} files this session.`);\n  lines.push(`${color(pc.dim, \"\\u2502\")}  ${unrelatedFiles.length} may be unrelated:`);\n\n  for (const file of unrelatedFiles) {\n    const truncated = file.length > contentWidth - 4 ? file.slice(0, contentWidth - 7) + \"...\" : file;\n    lines.push(`${color(pc.dim, \"\\u2502\")}    ${color(pc.yellow, \"\\u2022\")} ${truncated}`);\n  }\n\n  if (userRequest) {\n    lines.push(`${color(pc.dim, \"\\u2502\")}`);\n    const requestLines = wrapText(`Your request: \"${userRequest}\"`, contentWidth);\n    for (const line of requestLines) {\n      lines.push(`${color(pc.dim, \"\\u2502\")}  ${line}`);\n    }\n  }\n\n  lines.push(`${color(pc.dim, \"\\u2502\")}  ${color(pc.yellow, \"\\u26A0\\uFE0F  Consider reviewing these changes.\")}`);\n  lines.push(color(pc.yellow, bottomBorder));\n\n  return lines.join(\"\\n\");\n}\n\nexport function formatSkipNotice(reason: string): string {\n  return color(pc.dim, `[code-explainer] skipped: ${reason}`);\n}\n\nexport function formatErrorNotice(problem: string, cause: string, fix: string): string {\n  return color(pc.yellow, `[code-explainer] ${problem}. ${cause}. Fix: ${fix}.`);\n}\n\nexport function printToStderr(text: string): void {\n  process.stderr.write(text + \"\\n\");\n}\n"],"mappings":"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","names":["existsSync","readFileSync","appendFileSync","unlinkSync","mkdirSync","tmpdir","join","getUserTmpDir","join","tmpdir","existsSync","mkdirSync","appendFileSync","readFileSync","unlinkSync"]}
+{"version":3,"sources":["../src/session/tracker.ts","../src/cache/explanation-cache.ts","../src/format/box.ts"],"sourcesContent":["import { existsSync, readFileSync, appendFileSync, unlinkSync, mkdirSync, readdirSync, statSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { RiskLevel } from \"../config/schema.js\";\nimport { clearCache } from \"../cache/explanation-cache.js\";\nimport { formatDriftAlert, printToStderr } from \"../format/box.js\";\n\nconst TWO_HOURS_MS = 2 * 60 * 60 * 1000;\n\nexport interface SessionEntry {\n  file: string;\n  timestamp: number;\n  risk: RiskLevel;\n  summary: string;\n  unrelated?: boolean;\n}\n\nfunction getUserTmpDir(): string {\n  const dir = join(tmpdir(), `code-explainer-${process.getuid?.() ?? \"user\"}`);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true, mode: 0o700 });\n  }\n  return dir;\n}\n\nexport function getSessionFilePath(sessionId: string): string {\n  return join(getUserTmpDir(), `session-${sessionId}.jsonl`);\n}\n\nexport function recordEntry(sessionId: string, entry: SessionEntry): void {\n  const path = getSessionFilePath(sessionId);\n  try {\n    appendFileSync(path, JSON.stringify(entry) + \"\\n\", { mode: 0o600 });\n  } catch {\n    // Non-fatal\n  }\n}\n\nexport function readSession(sessionId: string): SessionEntry[] {\n  const path = getSessionFilePath(sessionId);\n  if (!existsSync(path)) return [];\n\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    return content\n      .split(\"\\n\")\n      .filter((l) => l.trim())\n      .map((line) => {\n        try {\n          return JSON.parse(line) as SessionEntry;\n        } catch {\n          return null;\n        }\n      })\n      .filter((e): e is SessionEntry => e !== null);\n  } catch {\n    return [];\n  }\n}\n\nexport function cleanStaleSessionFiles(): void {\n  try {\n    const dir = getUserTmpDir();\n    const now = Date.now();\n    const entries = readdirSync(dir);\n    for (const name of entries) {\n      if (!name.startsWith(\"session-\") && !name.startsWith(\"cache-\")) continue;\n      const filePath = join(dir, name);\n      try {\n        const stat = statSync(filePath);\n        if (now - stat.mtimeMs > TWO_HOURS_MS) {\n          unlinkSync(filePath);\n        }\n      } catch {\n        // ignore\n      }\n    }\n  } catch {\n    // ignore\n  }\n}\n\nfunction getSessionIdFromEnv(): string | undefined {\n  return process.env.CODE_EXPLAINER_SESSION_ID;\n}\n\nfunction findLatestSession(): string | undefined {\n  try {\n    const dir = getUserTmpDir();\n    const entries = readdirSync(dir)\n      .filter((n) => n.startsWith(\"session-\") && n.endsWith(\".jsonl\"))\n      .map((n) => ({\n        name: n,\n        id: n.slice(\"session-\".length, -\".jsonl\".length),\n        mtime: statSync(join(dir, n)).mtimeMs,\n      }))\n      .sort((a, b) => b.mtime - a.mtime);\n    return entries[0]?.id;\n  } catch {\n    return undefined;\n  }\n}\n\nexport async function printSummary(): Promise<void> {\n  const sessionId = getSessionIdFromEnv() ?? findLatestSession();\n  if (!sessionId) {\n    process.stderr.write(\"[code-explainer] No active session found. Session data is created when Claude Code makes changes.\\n\");\n    return;\n  }\n\n  const entries = readSession(sessionId);\n  if (entries.length === 0) {\n    process.stderr.write(`[code-explainer] Session '${sessionId}' has no recorded changes yet.\\n`);\n    return;\n  }\n\n  const related = entries.filter((e) => !e.unrelated);\n  const unrelated = entries.filter((e) => e.unrelated);\n  const uniqueFiles = Array.from(new Set(entries.map((e) => e.file)));\n  const unrelatedFiles = Array.from(new Set(unrelated.map((e) => e.file)));\n\n  const alert = formatDriftAlert(uniqueFiles.length, unrelatedFiles);\n  printToStderr(alert);\n\n  process.stderr.write(`\\nTotal changes: ${entries.length}\\n`);\n  process.stderr.write(`Files touched: ${uniqueFiles.length}\\n`);\n  process.stderr.write(`Related changes: ${related.length}\\n`);\n  process.stderr.write(`Unrelated/risky: ${unrelated.length}\\n`);\n\n  const risks: Record<RiskLevel, number> = { none: 0, low: 0, medium: 0, high: 0 };\n  for (const e of entries) risks[e.risk]++;\n  process.stderr.write(`\\nRisk breakdown:\\n`);\n  process.stderr.write(`  None:   ${risks.none}\\n`);\n  process.stderr.write(`  Low:    ${risks.low}\\n`);\n  process.stderr.write(`  Medium: ${risks.medium}\\n`);\n  process.stderr.write(`  High:   ${risks.high}\\n`);\n}\n\nexport async function endSession(): Promise<void> {\n  const sessionId = getSessionIdFromEnv() ?? findLatestSession();\n  if (!sessionId) {\n    process.stderr.write(\"[code-explainer] No active session to end.\\n\");\n    return;\n  }\n\n  const sessionPath = getSessionFilePath(sessionId);\n  if (existsSync(sessionPath)) {\n    try {\n      unlinkSync(sessionPath);\n    } catch {\n      // ignore\n    }\n  }\n  clearCache(sessionId);\n  process.stderr.write(`[code-explainer] Session '${sessionId}' ended. State cleared.\\n`);\n}\n","import { createHash } from \"node:crypto\";\nimport { existsSync, readFileSync, appendFileSync, unlinkSync, mkdirSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { ExplanationResult } from \"../config/schema.js\";\n\nfunction getUserTmpDir(): string {\n  const dir = join(tmpdir(), `code-explainer-${process.getuid?.() ?? \"user\"}`);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true, mode: 0o700 });\n  }\n  return dir;\n}\n\nexport function getCacheFilePath(sessionId: string): string {\n  return join(getUserTmpDir(), `cache-${sessionId}.jsonl`);\n}\n\nexport function hashDiff(diff: string): string {\n  return createHash(\"sha256\").update(diff, \"utf-8\").digest(\"hex\");\n}\n\ninterface CacheEntry {\n  hash: string;\n  result: ExplanationResult;\n}\n\nexport function getCached(sessionId: string, diff: string): ExplanationResult | undefined {\n  const path = getCacheFilePath(sessionId);\n  if (!existsSync(path)) return undefined;\n\n  const hash = hashDiff(diff);\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    const lines = content.split(\"\\n\").filter((l) => l.trim());\n\n    // Iterate in reverse so the most recent entry wins on duplicates.\n    for (let i = lines.length - 1; i >= 0; i--) {\n      try {\n        const entry = JSON.parse(lines[i]) as CacheEntry;\n        if (entry.hash === hash) {\n          return entry.result;\n        }\n      } catch {\n        // Skip malformed line\n      }\n    }\n  } catch {\n    return undefined;\n  }\n  return undefined;\n}\n\nexport function setCached(sessionId: string, diff: string, result: ExplanationResult): void {\n  const path = getCacheFilePath(sessionId);\n  const entry: CacheEntry = { hash: hashDiff(diff), result };\n  try {\n    appendFileSync(path, JSON.stringify(entry) + \"\\n\", { mode: 0o600 });\n  } catch {\n    // Cache write failures are non-fatal\n  }\n}\n\nexport function clearCache(sessionId: string): void {\n  const path = getCacheFilePath(sessionId);\n  if (existsSync(path)) {\n    try {\n      unlinkSync(path);\n    } catch {\n      // ignore\n    }\n  }\n}\n","import pc from \"picocolors\";\nimport type { RiskLevel } from \"../config/schema.js\";\n\nfunction isNoColor(): boolean {\n  return \"NO_COLOR\" in process.env || process.env.TERM === \"dumb\";\n}\n\nfunction color(fn: (s: string) => string, text: string): string {\n  return isNoColor() ? text : fn(text);\n}\n\nfunction getTerminalWidth(): number {\n  return process.stderr.columns || 80;\n}\n\nfunction wrapText(text: string, maxWidth: number): string[] {\n  const lines: string[] = [];\n  for (const raw of text.split(\"\\n\")) {\n    if (raw.length <= maxWidth) {\n      lines.push(raw);\n    } else {\n      let remaining = raw;\n      while (remaining.length > maxWidth) {\n        let breakAt = remaining.lastIndexOf(\" \", maxWidth);\n        if (breakAt <= 0) breakAt = maxWidth;\n        lines.push(remaining.slice(0, breakAt));\n        remaining = remaining.slice(breakAt).trimStart();\n      }\n      if (remaining) lines.push(remaining);\n    }\n  }\n  return lines;\n}\n\nfunction riskIcon(risk: RiskLevel): string {\n  if (isNoColor()) {\n    switch (risk) {\n      case \"none\": return \"[OK]\";\n      case \"low\": return \"[LOW]\";\n      case \"medium\": return \"[WARN]\";\n      case \"high\": return \"[DANGER]\";\n    }\n  }\n  switch (risk) {\n    case \"none\": return color(pc.green, \"\\u2705\");\n    case \"low\": return color(pc.yellow, \"\\u26A0\\uFE0F\");\n    case \"medium\": return color(pc.yellow, \"\\u26A0\\uFE0F\");\n    case \"high\": return color(pc.red, \"\\u{1F6A8}\");\n  }\n}\n\nfunction riskLabel(risk: RiskLevel): string {\n  switch (risk) {\n    case \"none\": return \"None\";\n    case \"low\": return \"Low\";\n    case \"medium\": return \"Medium\";\n    case \"high\": return \"High\";\n  }\n}\n\nexport function formatExplanationBox(\n  filePath: string,\n  summary: string,\n  risk: RiskLevel,\n  riskReason: string\n): string {\n  const width = Math.min(getTerminalWidth() - 4, 60);\n  const contentWidth = width - 4; // \"│  \" prefix + \" \" suffix\n\n  const isRisky = risk === \"medium\" || risk === \"high\";\n  const headerLabel = isRisky ? \"code-explainer \\u26A0\\uFE0F\" : \"code-explainer\";\n  const topBorder = `\\u250C\\u2500 ${headerLabel} ${ \"\\u2500\".repeat(Math.max(0, width - headerLabel.length - 4))}\\u2500`;\n  const bottomBorder = `\\u2514${ \"\\u2500\".repeat(width)}\\u2500`;\n\n  const lines: string[] = [];\n  lines.push(isRisky ? color(pc.yellow, topBorder) : color(pc.dim, topBorder));\n\n  // File path\n  const fileDisplay = isRisky ? `${riskIcon(risk)}  ${filePath}` : `  ${filePath}`;\n  lines.push(`${color(pc.dim, \"\\u2502\")}${fileDisplay}`);\n  lines.push(`${color(pc.dim, \"\\u2502\")}`);\n\n  // Summary\n  const summaryLines = wrapText(summary, contentWidth);\n  for (const line of summaryLines) {\n    lines.push(`${color(pc.dim, \"\\u2502\")}  ${line}`);\n  }\n\n  lines.push(`${color(pc.dim, \"\\u2502\")}`);\n\n  // Risk line\n  const riskText = `Risk: ${riskIcon(risk)} ${riskLabel(risk)}`;\n  lines.push(`${color(pc.dim, \"\\u2502\")}  ${riskText}`);\n\n  // Risk reason (if any)\n  if (riskReason) {\n    const reasonLines = wrapText(riskReason, contentWidth);\n    for (const line of reasonLines) {\n      lines.push(`${color(pc.dim, \"\\u2502\")}  ${color(pc.dim, line)}`);\n    }\n  }\n\n  lines.push(isRisky ? color(pc.yellow, bottomBorder) : color(pc.dim, bottomBorder));\n\n  return lines.join(\"\\n\");\n}\n\nexport function formatDriftAlert(\n  totalFiles: number,\n  unrelatedFiles: string[],\n  userRequest?: string\n): string {\n  const width = Math.min(getTerminalWidth() - 4, 60);\n  const contentWidth = width - 4;\n\n  const headerLabel = \"code-explainer \\u26A1 SESSION DRIFT\";\n  const topBorder = `\\u250C\\u2500 ${headerLabel} ${ \"\\u2500\".repeat(Math.max(0, width - headerLabel.length - 4))}\\u2500`;\n  const bottomBorder = `\\u2514${ \"\\u2500\".repeat(width)}\\u2500`;\n\n  const lines: string[] = [];\n  lines.push(color(pc.yellow, topBorder));\n\n  lines.push(`${color(pc.dim, \"\\u2502\")}  Claude has modified ${totalFiles} files this session.`);\n  lines.push(`${color(pc.dim, \"\\u2502\")}  ${unrelatedFiles.length} may be unrelated:`);\n\n  for (const file of unrelatedFiles) {\n    const truncated = file.length > contentWidth - 4 ? file.slice(0, contentWidth - 7) + \"...\" : file;\n    lines.push(`${color(pc.dim, \"\\u2502\")}    ${color(pc.yellow, \"\\u2022\")} ${truncated}`);\n  }\n\n  if (userRequest) {\n    lines.push(`${color(pc.dim, \"\\u2502\")}`);\n    const requestLines = wrapText(`Your request: \"${userRequest}\"`, contentWidth);\n    for (const line of requestLines) {\n      lines.push(`${color(pc.dim, \"\\u2502\")}  ${line}`);\n    }\n  }\n\n  lines.push(`${color(pc.dim, \"\\u2502\")}  ${color(pc.yellow, \"\\u26A0\\uFE0F  Consider reviewing these changes.\")}`);\n  lines.push(color(pc.yellow, bottomBorder));\n\n  return lines.join(\"\\n\");\n}\n\nexport function formatSkipNotice(reason: string): string {\n  return color(pc.dim, `[code-explainer] skipped: ${reason}`);\n}\n\nexport function formatErrorNotice(problem: string, cause: string, fix: string): string {\n  return color(pc.yellow, `[code-explainer] ${problem}. ${cause}. Fix: ${fix}.`);\n}\n\n/**\n * Write directly to the controlling terminal. Claude Code captures stdout\n * and stderr from hooks, so they never appear in the user's terminal unless\n * we bypass stdio and write to the tty device directly.\n *\n * Falls back to stderr if the tty cannot be opened (non-interactive runs,\n * CI, tests) so output is not silently swallowed.\n */\nexport function printToStderr(text: string): void {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const fs = require(\"node:fs\") as typeof import(\"node:fs\");\n    const ttyPath = process.platform === \"win32\" ? \"\\\\\\\\.\\\\CONOUT$\" : \"/dev/tty\";\n    const fd = fs.openSync(ttyPath, \"w\");\n    fs.writeSync(fd, text + \"\\n\");\n    fs.closeSync(fd);\n  } catch {\n    process.stderr.write(text + \"\\n\");\n  }\n}\n"],"mappings":"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","names":["existsSync","readFileSync","appendFileSync","unlinkSync","mkdirSync","tmpdir","join","getUserTmpDir","join","tmpdir","existsSync","mkdirSync","appendFileSync","readFileSync","unlinkSync"]}

package/dist/cli/index.js

@@ -6,7 +6,7 @@ var command = args[0];
 async function main() {
   switch (command) {
     case "init": {
-      const { runInit } = await import("../init-RE4ENXBR.js");
+      const { runInit } = await import("../init-ORTBGNSE.js");
       await runInit(args.slice(1));
       break;
     }
@@ -21,14 +21,14 @@ async function main() {
       break;
     }
     case "summary": {
-      const { printSummary } = await import("../tracker-E5FBZ64E.js");
+      const { printSummary } = await import("../tracker-ZE4B2IQS.js");
       await printSummary();
       break;
     }
     case "session": {
       const subcommand = args[1];
       if (subcommand === "end") {
-        const { endSession } = await import("../tracker-E5FBZ64E.js");
+        const { endSession } = await import("../tracker-ZE4B2IQS.js");
         await endSession();
       } else {
         console.error("[code-explainer] Unknown session command. Usage: code-explainer session end");

package/dist/hooks/post-tool.js

@@ -18,7 +18,7 @@ import {
   readSession,
   recordEntry,
   setCached
-} from "../chunk-DPYDNBM3.js";
+} from "../chunk-UJLSOUEZ.js";
 import "../chunk-7OCVIDC7.js";
 
 // src/hooks/post-tool.ts

package/dist/{init-RE4ENXBR.js → init-ORTBGNSE.js}

@@ -22,7 +22,7 @@ import { intro, outro, select, confirm, cancel, isCancel, spinner, note } from "
 import pc from "picocolors";
 import { execFileSync, spawn } from "child_process";
 import { existsSync, writeFileSync } from "fs";
-import { join, resolve } from "path";
+import { join, resolve, basename } from "path";
 import { fileURLToPath } from "url";
 
 // src/detect/platform.ts
@@ -58,10 +58,37 @@ function ollamaInstallCommand(p) {
 
 // src/cli/init.ts
 var CONFIG_FILE = "code-explainer.config.json";
-function resolveHookScriptPath() {
+function isInsideNpxCache(path) {
+  const norm = path.replace(/\\/g, "/").toLowerCase();
+  return norm.includes("/_npx/") || norm.includes("/.npm/_npx/");
+}
+async function ensureLocalInstall(projectRoot) {
   const thisFile = fileURLToPath(import.meta.url);
-  const distDir = resolve(thisFile, "..", "..");
-  return join(distDir, "hooks", "post-tool.js");
+  if (!isInsideNpxCache(thisFile)) {
+    const distDir = resolve(thisFile, "..");
+    return join(distDir, "hooks", "post-tool.js");
+  }
+  note(
+    "Installing vibe-code-explainer as a dev dependency so the hook path is stable...",
+    "Local install"
+  );
+  const pkgPath = join(projectRoot, "package.json");
+  if (!existsSync(pkgPath)) {
+    writeFileSync(pkgPath, JSON.stringify({ name: basename(projectRoot), private: true, version: "0.0.0" }, null, 2) + "\n");
+  }
+  await new Promise((resolvePromise, rejectPromise) => {
+    const child = spawn(
+      "npm",
+      ["install", "--save-dev", "vibe-code-explainer"],
+      { stdio: "inherit", cwd: projectRoot, shell: process.platform === "win32" }
+    );
+    child.on("error", rejectPromise);
+    child.on("close", (code) => {
+      if (code === 0) resolvePromise();
+      else rejectPromise(new Error(`npm install exited with code ${code}`));
+    });
+  });
+  return join(projectRoot, "node_modules", "vibe-code-explainer", "dist", "hooks", "post-tool.js");
 }
 async function checkOllama() {
   try {
@@ -237,7 +264,7 @@ Start it with: ${pc.cyan("ollama serve")} (in a separate terminal).`,
     }
   }
   writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
-  const hookScript = resolveHookScriptPath();
+  const hookScript = await ensureLocalInstall(projectRoot);
   const mergeResult = mergeHooksIntoSettings(projectRoot, hookScript);
   note(
     `${pc.green("\u2713")} Wrote ${pc.cyan(CONFIG_FILE)}
@@ -254,4 +281,4 @@ ${pc.green("\u2713")} ${mergeResult.created ? "Created" : "Updated"} ${pc.cyan(m
 export {
   runInit
 };
-//# sourceMappingURL=init-RE4ENXBR.js.map
+//# sourceMappingURL=init-ORTBGNSE.js.map

package/dist/init-ORTBGNSE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/init.ts","../src/detect/platform.ts"],"sourcesContent":["import { intro, outro, select, confirm, cancel, isCancel, spinner, note } from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { execFile, execFileSync, spawn } from \"node:child_process\";\nimport { existsSync, writeFileSync } from \"node:fs\";\nimport { join, resolve, basename } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { DEFAULT_CONFIG, type Config, type Engine, type DetailLevel } from \"../config/schema.js\";\nimport { detectPlatform, ollamaInstallCommand } from \"../detect/platform.js\";\nimport { detectNvidiaVram, pickModelForVram, MODEL_OPTIONS } from \"../detect/vram.js\";\nimport { mergeHooksIntoSettings } from \"../config/merge.js\";\nimport { callOllama } from \"../engines/ollama.js\";\n\nconst CONFIG_FILE = \"code-explainer.config.json\";\n\nfunction isInsideNpxCache(path: string): boolean {\n  const norm = path.replace(/\\\\/g, \"/\").toLowerCase();\n  return norm.includes(\"/_npx/\") || norm.includes(\"/.npm/_npx/\");\n}\n\nasync function ensureLocalInstall(projectRoot: string): Promise<string> {\n  // If we're running from the npx temp cache, that path disappears after the\n  // cache is cleaned. Install the package into the project so the hook path\n  // is stable across runs.\n  const thisFile = fileURLToPath(import.meta.url);\n\n  if (!isInsideNpxCache(thisFile)) {\n    // Running from an already-installed copy (local or global). Use it directly.\n    const distDir = resolve(thisFile, \"..\");\n    return join(distDir, \"hooks\", \"post-tool.js\");\n  }\n\n  note(\n    \"Installing vibe-code-explainer as a dev dependency so the hook path is stable...\",\n    \"Local install\"\n  );\n\n  // Make sure there's a package.json so npm install has something to attach to.\n  const pkgPath = join(projectRoot, \"package.json\");\n  if (!existsSync(pkgPath)) {\n    writeFileSync(pkgPath, JSON.stringify({ name: basename(projectRoot), private: true, version: \"0.0.0\" }, null, 2) + \"\\n\");\n  }\n\n  await new Promise<void>((resolvePromise, rejectPromise) => {\n    const child = spawn(\n      \"npm\",\n      [\"install\", \"--save-dev\", \"vibe-code-explainer\"],\n      { stdio: \"inherit\", cwd: projectRoot, shell: process.platform === \"win32\" }\n    );\n    child.on(\"error\", rejectPromise);\n    child.on(\"close\", (code) => {\n      if (code === 0) resolvePromise();\n      else rejectPromise(new Error(`npm install exited with code ${code}`));\n    });\n  });\n\n  return join(projectRoot, \"node_modules\", \"vibe-code-explainer\", \"dist\", \"hooks\", \"post-tool.js\");\n}\n\nasync function checkOllama(): Promise<\"running\" | \"installed-not-running\" | \"missing\"> {\n  // First, try the HTTP endpoint.\n  try {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), 1500);\n    const res = await fetch(\"http://localhost:11434/api/tags\", { signal: ctrl.signal });\n    clearTimeout(timer);\n    if (res.ok) return \"running\";\n  } catch {\n    // fall through\n  }\n\n  // Check if the binary exists.\n  try {\n    execFileSync(\"ollama\", [\"--version\"], { stdio: \"ignore\" });\n    return \"installed-not-running\";\n  } catch {\n    return \"missing\";\n  }\n}\n\nasync function pullModel(model: string): Promise<boolean> {\n  // Show note first so the user knows what's happening, then stream ollama's\n  // own progress bar straight to the terminal by inheriting stdio.\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\n  return new Promise((resolvePromise) => {\n    const child = spawn(\"ollama\", [\"pull\", model], { stdio: \"inherit\" });\n    child.on(\"error\", () => {\n      process.stderr.write(pc.red(\"\\nFailed to run `ollama pull`. Make sure Ollama is running.\\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\nasync function runWarmup(config: Config): Promise<void> {\n  const s = spinner();\n  s.start(`Warming up ${config.ollamaModel}`);\n\n  const outcome = await callOllama({\n    filePath: \"warmup.txt\",\n    diff: \"+ hello world\",\n    config: { ...config, skipIfSlowMs: 60000 },\n  });\n\n  if (outcome.kind === \"ok\") {\n    s.stop(\"Warmup complete. First real explanation will be fast.\");\n  } else if (outcome.kind === \"error\") {\n    s.stop(`Warmup failed: ${outcome.problem}`);\n  } else {\n    s.stop(`Warmup skipped: ${outcome.reason}`);\n  }\n}\n\nasync function pickModel(): Promise<string | symbol> {\n  const vram = detectNvidiaVram();\n  if (vram) {\n    const recommended = pickModelForVram(vram.totalMb);\n    note(\n      `Detected ${pc.green(vram.gpuName)} with ${pc.green(`${Math.round(vram.totalMb / 1024)} GB VRAM`)}.\\nRecommended model: ${pc.cyan(recommended)}`,\n      \"GPU detection\"\n    );\n    return recommended;\n  }\n\n  // No auto-detect → show chooser with VRAM hints.\n  note(\"No NVIDIA GPU detected (or nvidia-smi unavailable). Pick a model that fits your machine.\", \"GPU detection\");\n  const choice = await select({\n    message: \"Which model should code-explainer use?\",\n    options: MODEL_OPTIONS.map((m) => ({\n      label: m.label,\n      value: m.model,\n      hint: m.hint,\n    })),\n    initialValue: \"qwen3-coder:30b\",\n  });\n  return choice;\n}\n\nfunction handleCancel<T>(value: T | symbol): asserts value is T {\n  if (isCancel(value)) {\n    cancel(\"Setup cancelled.\");\n    process.exit(0);\n  }\n}\n\nexport async function runInit(args: string[]): Promise<void> {\n  const skipWarmup = args.includes(\"--skip-warmup\");\n\n  intro(pc.bold(\"code-explainer setup\"));\n\n  const engineChoice = await select<Engine>({\n    message: \"Which explanation engine do you want to use?\",\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: \"ollama\",\n  });\n  handleCancel(engineChoice);\n\n  const detailChoice = await select<DetailLevel>({\n    message: \"How detailed should explanations be?\",\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: \"standard\",\n  });\n  handleCancel(detailChoice);\n\n  let ollamaModel = DEFAULT_CONFIG.ollamaModel;\n\n  if (engineChoice === \"ollama\") {\n    const status = await checkOllama();\n\n    if (status === \"missing\") {\n      const platform = detectPlatform();\n      const installCmd = ollamaInstallCommand(platform);\n      note(\n        `Ollama is not installed.\\nInstall with: ${pc.cyan(installCmd)}\\nOr visit: ${pc.cyan(\"https://ollama.com/download\")}`,\n        \"Missing prerequisite\"\n      );\n      const proceed = await confirm({\n        message: \"Install Ollama manually and continue after it's ready?\",\n        initialValue: true,\n      });\n      handleCancel(proceed);\n      if (!proceed) {\n        cancel(\"Setup paused. Run 'npx vibe-code-explainer init' again after installing Ollama.\");\n        process.exit(0);\n      }\n    } else if (status === \"installed-not-running\") {\n      note(\n        `Ollama is installed but the service isn't running.\\nStart it with: ${pc.cyan(\"ollama serve\")} (in a separate terminal).`,\n        \"Ollama not running\"\n      );\n    }\n\n    const modelChoice = await pickModel();\n    handleCancel(modelChoice);\n    ollamaModel = modelChoice;\n\n    const pullOk = await pullModel(ollamaModel);\n    if (!pullOk) {\n      const skipPull = await confirm({\n        message: \"Continue without pulling the model? (You'll need to run 'ollama pull' manually.)\",\n        initialValue: false,\n      });\n      handleCancel(skipPull);\n      if (!skipPull) {\n        cancel(\"Setup aborted.\");\n        process.exit(1);\n      }\n    }\n  }\n\n  // Build config.\n  const config: Config = {\n    ...DEFAULT_CONFIG,\n    engine: engineChoice,\n    detailLevel: detailChoice,\n    ollamaModel,\n  };\n\n  const projectRoot = process.cwd();\n  const configPath = join(projectRoot, CONFIG_FILE);\n\n  if (existsSync(configPath)) {\n    const overwrite = await confirm({\n      message: `${CONFIG_FILE} already exists. Overwrite?`,\n      initialValue: false,\n    });\n    handleCancel(overwrite);\n    if (!overwrite) {\n      cancel(\"Setup aborted to avoid overwriting existing config.\");\n      process.exit(0);\n    }\n  }\n\n  writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\");\n\n  // Merge hooks into settings.local.json.\n  const hookScript = await ensureLocalInstall(projectRoot);\n  const mergeResult = mergeHooksIntoSettings(projectRoot, hookScript);\n\n  note(\n    `${pc.green(\"\\u2713\")} Wrote ${pc.cyan(CONFIG_FILE)}\\n${pc.green(\"\\u2713\")} ${mergeResult.created ? \"Created\" : \"Updated\"} ${pc.cyan(mergeResult.path)}`,\n    \"Configuration saved\"\n  );\n\n  // Warmup.\n  if (engineChoice === \"ollama\" && !skipWarmup) {\n    await runWarmup(config);\n  }\n\n  outro(\n    pc.bold(\"code-explainer is active.\") +\n      \"\\nClaude Code will now explain every Edit, Write, and destructive Bash command.\"\n  );\n}\n","import { platform } from \"node:os\";\n\nexport type Platform = \"windows\" | \"macos\" | \"linux\" | \"wsl\" | \"unknown\";\n\nexport function detectPlatform(): Platform {\n  const p = platform();\n  if (p === \"win32\") return \"windows\";\n  if (p === \"darwin\") return \"macos\";\n  if (p === \"linux\") {\n    // WSL detection: Microsoft string in /proc/version\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const fs = require(\"node:fs\") as typeof import(\"node:fs\");\n      const release = fs.readFileSync(\"/proc/version\", \"utf-8\").toLowerCase();\n      if (release.includes(\"microsoft\") || release.includes(\"wsl\")) return \"wsl\";\n    } catch {\n      // ignore\n    }\n    return \"linux\";\n  }\n  return \"unknown\";\n}\n\nexport function ollamaInstallCommand(p: Platform): string {\n  switch (p) {\n    case \"macos\":\n      return \"brew install ollama\";\n    case \"windows\":\n      return \"winget install Ollama.Ollama\";\n    case \"linux\":\n    case \"wsl\":\n      return \"curl -fsSL https://ollama.com/install.sh | sh\";\n    default:\n      return \"Visit https://ollama.com/download to install Ollama\";\n  }\n}\n"],"mappings":"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","names":["platform"]}

package/dist/{tracker-E5FBZ64E.js → tracker-ZE4B2IQS.js}

@@ -6,7 +6,7 @@ import {
   printSummary,
   readSession,
   recordEntry
-} from "./chunk-DPYDNBM3.js";
+} from "./chunk-UJLSOUEZ.js";
 import "./chunk-7OCVIDC7.js";
 export {
   cleanStaleSessionFiles,
@@ -16,4 +16,4 @@ export {
   readSession,
   recordEntry
 };
-//# sourceMappingURL=tracker-E5FBZ64E.js.map
+//# sourceMappingURL=tracker-ZE4B2IQS.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-code-explainer",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Real-time diff explanations for vibe coders using Claude Code",
   "type": "module",
   "bin": {

package/dist/init-RE4ENXBR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/init.ts","../src/detect/platform.ts"],"sourcesContent":["import { intro, outro, select, confirm, cancel, isCancel, spinner, note } from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { execFile, execFileSync, spawn } from \"node:child_process\";\nimport { existsSync, writeFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { DEFAULT_CONFIG, type Config, type Engine, type DetailLevel } from \"../config/schema.js\";\nimport { detectPlatform, ollamaInstallCommand } from \"../detect/platform.js\";\nimport { detectNvidiaVram, pickModelForVram, MODEL_OPTIONS } from \"../detect/vram.js\";\nimport { mergeHooksIntoSettings } from \"../config/merge.js\";\nimport { callOllama } from \"../engines/ollama.js\";\n\nconst CONFIG_FILE = \"code-explainer.config.json\";\n\nfunction resolveHookScriptPath(): string {\n  // The compiled dist/hooks/post-tool.js lives next to dist/cli/index.js.\n  const thisFile = fileURLToPath(import.meta.url);\n  const distDir = resolve(thisFile, \"..\", \"..\");\n  return join(distDir, \"hooks\", \"post-tool.js\");\n}\n\nasync function checkOllama(): Promise<\"running\" | \"installed-not-running\" | \"missing\"> {\n  // First, try the HTTP endpoint.\n  try {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), 1500);\n    const res = await fetch(\"http://localhost:11434/api/tags\", { signal: ctrl.signal });\n    clearTimeout(timer);\n    if (res.ok) return \"running\";\n  } catch {\n    // fall through\n  }\n\n  // Check if the binary exists.\n  try {\n    execFileSync(\"ollama\", [\"--version\"], { stdio: \"ignore\" });\n    return \"installed-not-running\";\n  } catch {\n    return \"missing\";\n  }\n}\n\nasync function pullModel(model: string): Promise<boolean> {\n  // Show note first so the user knows what's happening, then stream ollama's\n  // own progress bar straight to the terminal by inheriting stdio.\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\n  return new Promise((resolvePromise) => {\n    const child = spawn(\"ollama\", [\"pull\", model], { stdio: \"inherit\" });\n    child.on(\"error\", () => {\n      process.stderr.write(pc.red(\"\\nFailed to run `ollama pull`. Make sure Ollama is running.\\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\nasync function runWarmup(config: Config): Promise<void> {\n  const s = spinner();\n  s.start(`Warming up ${config.ollamaModel}`);\n\n  const outcome = await callOllama({\n    filePath: \"warmup.txt\",\n    diff: \"+ hello world\",\n    config: { ...config, skipIfSlowMs: 60000 },\n  });\n\n  if (outcome.kind === \"ok\") {\n    s.stop(\"Warmup complete. First real explanation will be fast.\");\n  } else if (outcome.kind === \"error\") {\n    s.stop(`Warmup failed: ${outcome.problem}`);\n  } else {\n    s.stop(`Warmup skipped: ${outcome.reason}`);\n  }\n}\n\nasync function pickModel(): Promise<string | symbol> {\n  const vram = detectNvidiaVram();\n  if (vram) {\n    const recommended = pickModelForVram(vram.totalMb);\n    note(\n      `Detected ${pc.green(vram.gpuName)} with ${pc.green(`${Math.round(vram.totalMb / 1024)} GB VRAM`)}.\\nRecommended model: ${pc.cyan(recommended)}`,\n      \"GPU detection\"\n    );\n    return recommended;\n  }\n\n  // No auto-detect → show chooser with VRAM hints.\n  note(\"No NVIDIA GPU detected (or nvidia-smi unavailable). Pick a model that fits your machine.\", \"GPU detection\");\n  const choice = await select({\n    message: \"Which model should code-explainer use?\",\n    options: MODEL_OPTIONS.map((m) => ({\n      label: m.label,\n      value: m.model,\n      hint: m.hint,\n    })),\n    initialValue: \"qwen3-coder:30b\",\n  });\n  return choice;\n}\n\nfunction handleCancel<T>(value: T | symbol): asserts value is T {\n  if (isCancel(value)) {\n    cancel(\"Setup cancelled.\");\n    process.exit(0);\n  }\n}\n\nexport async function runInit(args: string[]): Promise<void> {\n  const skipWarmup = args.includes(\"--skip-warmup\");\n\n  intro(pc.bold(\"code-explainer setup\"));\n\n  const engineChoice = await select<Engine>({\n    message: \"Which explanation engine do you want to use?\",\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: \"ollama\",\n  });\n  handleCancel(engineChoice);\n\n  const detailChoice = await select<DetailLevel>({\n    message: \"How detailed should explanations be?\",\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: \"standard\",\n  });\n  handleCancel(detailChoice);\n\n  let ollamaModel = DEFAULT_CONFIG.ollamaModel;\n\n  if (engineChoice === \"ollama\") {\n    const status = await checkOllama();\n\n    if (status === \"missing\") {\n      const platform = detectPlatform();\n      const installCmd = ollamaInstallCommand(platform);\n      note(\n        `Ollama is not installed.\\nInstall with: ${pc.cyan(installCmd)}\\nOr visit: ${pc.cyan(\"https://ollama.com/download\")}`,\n        \"Missing prerequisite\"\n      );\n      const proceed = await confirm({\n        message: \"Install Ollama manually and continue after it's ready?\",\n        initialValue: true,\n      });\n      handleCancel(proceed);\n      if (!proceed) {\n        cancel(\"Setup paused. Run 'npx vibe-code-explainer init' again after installing Ollama.\");\n        process.exit(0);\n      }\n    } else if (status === \"installed-not-running\") {\n      note(\n        `Ollama is installed but the service isn't running.\\nStart it with: ${pc.cyan(\"ollama serve\")} (in a separate terminal).`,\n        \"Ollama not running\"\n      );\n    }\n\n    const modelChoice = await pickModel();\n    handleCancel(modelChoice);\n    ollamaModel = modelChoice;\n\n    const pullOk = await pullModel(ollamaModel);\n    if (!pullOk) {\n      const skipPull = await confirm({\n        message: \"Continue without pulling the model? (You'll need to run 'ollama pull' manually.)\",\n        initialValue: false,\n      });\n      handleCancel(skipPull);\n      if (!skipPull) {\n        cancel(\"Setup aborted.\");\n        process.exit(1);\n      }\n    }\n  }\n\n  // Build config.\n  const config: Config = {\n    ...DEFAULT_CONFIG,\n    engine: engineChoice,\n    detailLevel: detailChoice,\n    ollamaModel,\n  };\n\n  const projectRoot = process.cwd();\n  const configPath = join(projectRoot, CONFIG_FILE);\n\n  if (existsSync(configPath)) {\n    const overwrite = await confirm({\n      message: `${CONFIG_FILE} already exists. Overwrite?`,\n      initialValue: false,\n    });\n    handleCancel(overwrite);\n    if (!overwrite) {\n      cancel(\"Setup aborted to avoid overwriting existing config.\");\n      process.exit(0);\n    }\n  }\n\n  writeFileSync(configPath, JSON.stringify(config, null, 2) + \"\\n\");\n\n  // Merge hooks into settings.local.json.\n  const hookScript = resolveHookScriptPath();\n  const mergeResult = mergeHooksIntoSettings(projectRoot, hookScript);\n\n  note(\n    `${pc.green(\"\\u2713\")} Wrote ${pc.cyan(CONFIG_FILE)}\\n${pc.green(\"\\u2713\")} ${mergeResult.created ? \"Created\" : \"Updated\"} ${pc.cyan(mergeResult.path)}`,\n    \"Configuration saved\"\n  );\n\n  // Warmup.\n  if (engineChoice === \"ollama\" && !skipWarmup) {\n    await runWarmup(config);\n  }\n\n  outro(\n    pc.bold(\"code-explainer is active.\") +\n      \"\\nClaude Code will now explain every Edit, Write, and destructive Bash command.\"\n  );\n}\n","import { platform } from \"node:os\";\n\nexport type Platform = \"windows\" | \"macos\" | \"linux\" | \"wsl\" | \"unknown\";\n\nexport function detectPlatform(): Platform {\n  const p = platform();\n  if (p === \"win32\") return \"windows\";\n  if (p === \"darwin\") return \"macos\";\n  if (p === \"linux\") {\n    // WSL detection: Microsoft string in /proc/version\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const fs = require(\"node:fs\") as typeof import(\"node:fs\");\n      const release = fs.readFileSync(\"/proc/version\", \"utf-8\").toLowerCase();\n      if (release.includes(\"microsoft\") || release.includes(\"wsl\")) return \"wsl\";\n    } catch {\n      // ignore\n    }\n    return \"linux\";\n  }\n  return \"unknown\";\n}\n\nexport function ollamaInstallCommand(p: Platform): string {\n  switch (p) {\n    case \"macos\":\n      return \"brew install ollama\";\n    case \"windows\":\n      return \"winget install Ollama.Ollama\";\n    case \"linux\":\n    case \"wsl\":\n      return \"curl -fsSL https://ollama.com/install.sh | sh\";\n    default:\n      return \"Visit https://ollama.com/download to install Ollama\";\n  }\n}\n"],"mappings":"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","names":["platform"]}