codealmanac 0.1.10 → 0.2.1

package/dist/chunk-447U3GQJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/hook.ts","../src/commands/hook/script.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\nimport {\n  copyToStableHooksDir,\n  resolveHookScriptPath,\n  resolveSettingsPath,\n  type ScriptResolution,\n} from \"./hook/script.js\";\n\n/**\n * `almanac hook install|uninstall|status` — wires the bundled\n * `hooks/almanac-capture.sh` into `~/.claude/settings.json` as a\n * `SessionEnd` hook.\n *\n * Design notes:\n *\n * - **Schema.** Claude Code validates `settings.json` against a strict\n *   schema: each entry in an event array (like `SessionEnd`) is a\n *   `{matcher, hooks: [...]}` container, and the actual command objects\n *   live in the nested `hooks` array. v0.1.0–v0.1.4 wrote command objects\n *   directly at the event-array level; newer Claude Code versions now\n *   reject that shape. We produce the wrapped form on install, and when\n *   encountering a legacy unwrapped entry that we recognize as ours (by\n *   `command` ending in `almanac-capture.sh`) we migrate it on next\n *   install. `SessionEnd` never uses the `matcher` field to discriminate\n *   anything — we always emit an empty `matcher: \"\"` (matches\n *   everything, which is what session-end lifecycle hooks want).\n *\n * - **Idempotent.** `install` twice leaves one entry, not two. We match by\n *   `command` string equality on the inner `hooks[]` entries. If the user\n *   replaces our absolute path with a symlink pointing at the same\n *   script, we'll treat it as foreign. That's acceptable; the `status`\n *   output shows the path we'd use, so the user can reconcile manually.\n *\n * - **Refuse foreign entries.** If `SessionEnd` is already populated with\n *   a command we don't recognize, we print the existing value and exit\n *   non-zero. Claude Code lets users wire their own hooks (notifications,\n *   git autocommit scripts, etc.) and silently replacing them would be\n *   rude. Foreign wrapped containers that don't reference our script are\n *   preserved byte-for-byte.\n *\n * - **Atomic write.** `settings.json` is small but heavily touched by\n *   Claude Code. Writing via tmp-file + rename avoids corrupting the file\n *   if we crash mid-write.\n *\n * - **Non-interactive.** No prompts, no confirmations. The caller is\n *   already making an intentional choice by running `almanac hook\n *   install`.\n */\n\nexport interface HookCommandOptions {\n  /** Which agent app to install hooks for. Default keeps legacy Claude behavior. */\n  source?: \"claude\" | \"codex\" | \"cursor\" | \"all\";\n  /**\n   * Override the hook script path. Production code leaves this undefined\n   * and we resolve the bundled `hooks/almanac-capture.sh`. Tests pass a\n   * fixture path to avoid depending on the runtime-install layout.\n   */\n  hookScriptPath?: string;\n  /**\n   * Override `~/.claude/settings.json`. Tests sandbox this to a tmpdir;\n   * production code leaves it undefined.\n   */\n  settingsPath?: string;\n  /**\n   * Override the stable hooks directory where we copy the script.\n   * Defaults to `~/.claude/hooks/`. Tests sandbox this to a tmpdir.\n   *\n   * Bug #1 fix: we always copy the bundled script to this stable path\n   * before writing it into settings.json. This way the settings entry\n   * points at a user-owned location that survives npm version bumps,\n   * npx cache evictions, and nvm version switches — instead of an\n   * ephemeral path inside ~/.npm/_npx/<sha>/... or the nvm-versioned\n   * node_modules/.\n   */\n  stableHooksDir?: string;\n}\n\nexport interface HookCommandResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\nconst HOOK_TIMEOUT_SECONDS = 10;\n\n/** A single command invocation inside a wrapper's `hooks[]` array. */\ninterface HookCommand {\n  type: \"command\";\n  command: string;\n  timeout?: number;\n}\n\n/** A wrapped SessionEnd entry per Claude Code's schema. */\ninterface WrappedEntry {\n  matcher: string;\n  hooks: HookCommand[];\n}\n\n/**\n * What we read from `settings.hooks.SessionEnd`. During a read we may\n * encounter the legacy unwrapped shape (`HookCommand` directly) written\n * by v0.1.0–v0.1.4 — we recognize and migrate it. Unknown entries we\n * can't classify are preserved as-is via `unknown`.\n */\ntype RawEntry = WrappedEntry | HookCommand | unknown;\n\n/**\n * Claude Code's `settings.json` is a free-form JSON object; we only care\n * about the `hooks.SessionEnd` array. Preserve everything else verbatim\n * so we don't drop user settings when we write the file back.\n */\ntype SettingsJson = Record<string, unknown> & {\n  hooks?: Record<string, RawEntry[] | undefined>;\n};\n\n/**\n * Heuristic: does this command path look like one we installed?\n *\n * We match on the filename `almanac-capture.sh` regardless of the parent\n * directory. This covers:\n *   - the stable path: `~/.claude/hooks/almanac-capture.sh`\n *   - legacy paths from v0.1.0–v0.1.5: inside the nvm node_modules or\n *     npx cache\n * The stable path is what new installs produce; legacy paths are what\n * we migrate when the user runs `almanac hook install` again.\n */\nfunction isOurCommandPath(command: string): boolean {\n  return command.endsWith(\"almanac-capture.sh\");\n}\n\n/**\n * Classify a raw SessionEnd entry. Wrapped entries are the canonical\n * shape; unwrapped-command entries are legacy output from v0.1.0–v0.1.4.\n * Anything else (random user JSON) is `unknown` and we leave it alone.\n */\ntype Classified =\n  | { kind: \"wrapped\"; entry: WrappedEntry }\n  | { kind: \"legacy\"; entry: HookCommand }\n  | { kind: \"unknown\"; entry: unknown };\n\nfunction classifyEntry(raw: RawEntry): Classified {\n  if (raw === null || typeof raw !== \"object\") {\n    return { kind: \"unknown\", entry: raw };\n  }\n  const obj = raw as Record<string, unknown>;\n  if (Array.isArray(obj.hooks)) {\n    // Wrapped shape. `matcher` may be absent in hand-edited files; treat\n    // absent as \"\" so we don't throw on slightly malformed input.\n    const matcher = typeof obj.matcher === \"string\" ? obj.matcher : \"\";\n    const hooks: HookCommand[] = [];\n    for (const h of obj.hooks as unknown[]) {\n      if (h !== null && typeof h === \"object\") {\n        const ho = h as Record<string, unknown>;\n        if (ho.type === \"command\" && typeof ho.command === \"string\") {\n          const cmd: HookCommand = {\n            type: \"command\",\n            command: ho.command,\n          };\n          if (typeof ho.timeout === \"number\") cmd.timeout = ho.timeout;\n          hooks.push(cmd);\n        }\n      }\n    }\n    return { kind: \"wrapped\", entry: { matcher, hooks } };\n  }\n  if (obj.type === \"command\" && typeof obj.command === \"string\") {\n    // Legacy unwrapped shape — v0.1.0–v0.1.4 wrote this form.\n    const cmd: HookCommand = {\n      type: \"command\",\n      command: obj.command as string,\n    };\n    if (typeof obj.timeout === \"number\") cmd.timeout = obj.timeout;\n    return { kind: \"legacy\", entry: cmd };\n  }\n  return { kind: \"unknown\", entry: raw };\n}\n\n/** True when the entry references our script and is safely ours to manage. */\nfunction isOurWrapped(entry: WrappedEntry): boolean {\n  return entry.hooks.some((h) => isOurCommandPath(h.command));\n}\n\nexport async function runHookInstall(\n  options: HookCommandOptions = {},\n): Promise<HookCommandResult> {\n  const bundled = resolveHookScriptPath(options);\n  if (!bundled.ok) {\n    return { stdout: \"\", stderr: `almanac: ${bundled.error}\\n`, exitCode: 1 };\n  }\n\n  // Copy the bundled hook script to a stable user-owned location before\n  // writing that path into settings.json. This is the Bug #1 fix:\n  //\n  //   OLD behavior: settings.json pointed at the bundled path (inside\n  //   ~/.nvm/versions/node/<ver>/lib/node_modules/codealmanac/hooks/... or\n  //   ~/.npm/_npx/<sha>/node_modules/codealmanac/hooks/...). When the user\n  //   switches Node versions or the npx cache is evicted, the path breaks\n  //   silently and captures stop firing.\n  //\n  //   NEW behavior: we copy almanac-capture.sh to ~/.claude/hooks/ (same\n  //   directory Claude Code uses for its own built-in hooks, always present)\n  //   and point settings.json there. The stable path is independent of\n  //   Node version and npm cache state. When the user upgrades codealmanac,\n  //   `almanac hook install` copies a fresh script and updates settings.json\n  //   if the path changed.\n  //\n  // When `hookScriptPath` is explicitly provided (test injection), the\n  // caller has already specified the destination path — skip the copy and\n  // use that path directly. The stable-copy concern only applies to the\n  // production flow where we resolved from the bundled package layout.\n  const script: ScriptResolution = options.hookScriptPath !== undefined\n    ? bundled // already the caller-provided path, no copy needed\n    : await copyToStableHooksDir(bundled.path, options);\n  if (!script.ok) {\n    return { stdout: \"\", stderr: `almanac: ${script.error}\\n`, exitCode: 1 };\n  }\n\n  const source = options.source ?? \"claude\";\n  if (source === \"all\") {\n    const results = [\n      await installClaudeHook(options, script.path),\n      await installGenericHook({\n        label: \"Codex Stop\",\n        settingsPath: path.join(homedir(), \".codex\", \"hooks.json\"),\n        eventName: \"Stop\",\n        shape: \"wrapped\",\n        scriptPath: script.path,\n      }),\n      await installGenericHook({\n        label: \"Cursor sessionEnd\",\n        settingsPath: path.join(homedir(), \".cursor\", \"hooks.json\"),\n        eventName: \"sessionEnd\",\n        shape: \"flat\",\n        scriptPath: script.path,\n      }),\n    ];\n    const failed = results.find((r) => r.exitCode !== 0);\n    if (failed !== undefined) return failed;\n    return {\n      stdout: results.map((r) => r.stdout.trimEnd()).join(\"\\n\") + \"\\n\",\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n  if (source === \"codex\") {\n    return await installGenericHook({\n      label: \"Codex Stop\",\n      settingsPath: path.join(homedir(), \".codex\", \"hooks.json\"),\n      eventName: \"Stop\",\n      shape: \"wrapped\",\n      scriptPath: script.path,\n    });\n  }\n  if (source === \"cursor\") {\n    return await installGenericHook({\n      label: \"Cursor sessionEnd\",\n      settingsPath: path.join(homedir(), \".cursor\", \"hooks.json\"),\n      eventName: \"sessionEnd\",\n      shape: \"flat\",\n      scriptPath: script.path,\n    });\n  }\n\n  return await installClaudeHook(options, script.path);\n}\n\nasync function installClaudeHook(\n  options: HookCommandOptions,\n  scriptPath: string,\n): Promise<HookCommandResult> {\n\n  const settingsPath = resolveSettingsPath(options);\n  const settings = await readSettings(settingsPath);\n  const existing = (settings.hooks?.SessionEnd ?? []).slice();\n\n  // Walk existing entries and split them into buckets:\n  //   - `preserved`  — foreign wrapped/unknown entries we leave alone.\n  //   - `oursAlready` — a wrapped entry that already points at OUR exact\n  //                     script path (makes install a no-op).\n  //   - `oursStale`   — a wrapped or legacy entry that references our\n  //                     capture script but at a different absolute path\n  //                     (old install, `npm i` moved us) or in the legacy\n  //                     unwrapped shape. We'll collapse these into a\n  //                     single fresh entry at the new path.\n  const preserved: RawEntry[] = [];\n  let oursAlready: WrappedEntry | null = null;\n  const staleCount = { n: 0 };\n\n  for (const raw of existing) {\n    const c = classifyEntry(raw);\n    if (c.kind === \"wrapped\") {\n      if (!isOurWrapped(c.entry)) {\n        preserved.push(raw);\n        continue;\n      }\n      // Entry belongs to us. Does it already point at the exact script\n      // path? If every command in its `hooks[]` that looks like ours is\n      // already at `script.path`, it's up to date.\n      const exactMatch = c.entry.hooks.some(\n        (h) => h.command === scriptPath,\n      );\n      if (exactMatch && oursAlready === null) {\n        oursAlready = c.entry;\n      } else {\n        staleCount.n += 1;\n      }\n    } else if (c.kind === \"legacy\") {\n      if (isOurCommandPath(c.entry.command)) {\n        // Legacy unwrapped entry of ours — always migrate to wrapped.\n        staleCount.n += 1;\n      } else {\n        // Foreign legacy entry (user had their own script before\n        // settings.json required wrapping). Leave it alone.\n        preserved.push(raw);\n      }\n    } else {\n      // Unknown shape — we can't classify it. Preserve verbatim.\n      preserved.push(raw);\n    }\n  }\n\n  // If every non-ours entry is a foreign unwrapped command (not a\n  // wrapped one) we refuse to touch the file — Claude Code's newer\n  // schema will already reject such files, but surfacing it here lets\n  // the user clean up before we stack our entry on top. Wrapped foreign\n  // entries are fine to leave alongside ours.\n  const foreignLegacy = preserved.filter((raw) => {\n    const c = classifyEntry(raw);\n    return c.kind === \"legacy\";\n  });\n  if (foreignLegacy.length > 0) {\n    const lines = foreignLegacy\n      .map((raw) => {\n        const c = classifyEntry(raw);\n        if (c.kind === \"legacy\") return `  - ${c.entry.command}`;\n        return \"  - <unrecognized>\";\n      })\n      .join(\"\\n\");\n    return {\n      stdout: \"\",\n      stderr:\n        `almanac: SessionEnd has a foreign legacy entry:\\n${lines}\\n` +\n        `Remove or rewrap it manually in ${settingsPath} before installing.\\n`,\n      exitCode: 1,\n    };\n  }\n\n  if (oursAlready !== null && staleCount.n === 0) {\n    return {\n      stdout: `almanac: SessionEnd hook already installed at ${scriptPath}\\n`,\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  // Build the fresh wrapped entry and append to preserved foreign\n  // entries. Stale entries of ours are dropped (we only ever want a\n  // single active entry; multiple copies of the capture hook would\n  // double-fire on session end).\n  const fresh: WrappedEntry = {\n    matcher: \"\",\n    hooks: [\n        {\n          type: \"command\",\n          command: scriptPath,\n          timeout: HOOK_TIMEOUT_SECONDS,\n        },\n    ],\n  };\n\n  const newEntries: RawEntry[] = [...preserved, fresh];\n\n  settings.hooks = { ...(settings.hooks ?? {}), SessionEnd: newEntries };\n  await writeSettings(settingsPath, settings);\n\n  return {\n    stdout:\n      `almanac: SessionEnd hook installed\\n` +\n      `  script: ${scriptPath}\\n` +\n      `  settings: ${settingsPath}\\n`,\n    stderr: \"\",\n    exitCode: 0,\n  };\n}\n\nasync function installGenericHook(args: {\n  label: string;\n  settingsPath: string;\n  eventName: string;\n  shape: \"flat\" | \"wrapped\";\n  scriptPath: string;\n}): Promise<HookCommandResult> {\n  const settings = await readSettings(args.settingsPath);\n  const hooksObj =\n    settings.hooks !== undefined &&\n    settings.hooks !== null &&\n    typeof settings.hooks === \"object\"\n      ? settings.hooks\n      : {};\n  const existing = Array.isArray(hooksObj[args.eventName])\n    ? (hooksObj[args.eventName] as RawEntry[])\n    : [];\n  const kept = existing.filter((entry) => !entryHasOurCommand(entry));\n  const already = existing.some((entry) =>\n    entryHasExactCommand(entry, args.scriptPath),\n  );\n  if (already && kept.length === existing.length - 1) {\n    return {\n      stdout: `almanac: ${args.label} hook already installed at ${args.scriptPath}\\n`,\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n  const fresh =\n    args.shape === \"wrapped\"\n      ? {\n          hooks: [\n            {\n              type: \"command\",\n              command: args.scriptPath,\n              timeout: HOOK_TIMEOUT_SECONDS,\n            },\n          ],\n        }\n      : {\n          command: args.scriptPath,\n          timeout: HOOK_TIMEOUT_SECONDS,\n        };\n  hooksObj[args.eventName] = [\n    ...kept,\n    fresh,\n  ];\n  settings.hooks = hooksObj;\n  await writeSettings(args.settingsPath, settings);\n  if (args.label.startsWith(\"Codex \")) {\n    await ensureCodexHooksFeature(path.join(homedir(), \".codex\", \"config.toml\"));\n  }\n  return {\n    stdout:\n      `almanac: ${args.label} hook installed\\n` +\n      `  script: ${args.scriptPath}\\n` +\n      `  settings: ${args.settingsPath}\\n`,\n    stderr: \"\",\n    exitCode: 0,\n  };\n}\n\nfunction entryHasOurCommand(entry: unknown): boolean {\n  return collectHookCommands(entry).some(isOurCommandPath);\n}\n\nfunction entryHasExactCommand(entry: unknown, command: string): boolean {\n  return collectHookCommands(entry).some((candidate) => candidate === command);\n}\n\nfunction collectHookCommands(entry: unknown): string[] {\n  if (entry === null || typeof entry !== \"object\") return [];\n  const obj = entry as Record<string, unknown>;\n  const direct = typeof obj.command === \"string\" ? [obj.command] : [];\n  const nested = Array.isArray(obj.hooks)\n    ? obj.hooks.flatMap((hook) => collectHookCommands(hook))\n    : [];\n  return [...direct, ...nested];\n}\n\nasync function ensureCodexHooksFeature(configPath: string): Promise<void> {\n  let body = \"\";\n  if (existsSync(configPath)) {\n    body = await readFile(configPath, \"utf8\");\n  }\n  if (/^\\s*codex_hooks\\s*=\\s*true\\s*$/m.test(body)) return;\n\n  const next = setTomlFeatureFlag(body, \"codex_hooks\", true);\n  await mkdir(path.dirname(configPath), { recursive: true });\n  const tmp = `${configPath}.almanac-tmp-${process.pid}`;\n  await writeFile(tmp, next.endsWith(\"\\n\") ? next : `${next}\\n`, \"utf8\");\n  await rename(tmp, configPath);\n}\n\nfunction setTomlFeatureFlag(\n  body: string,\n  key: string,\n  value: boolean,\n): string {\n  const desired = `${key} = ${value ? \"true\" : \"false\"}`;\n  const lines = body.split(/\\r?\\n/);\n  let featuresStart = -1;\n  let featuresEnd = lines.length;\n\n  for (let i = 0; i < lines.length; i++) {\n    if (/^\\s*\\[features\\]\\s*$/.test(lines[i] ?? \"\")) {\n      featuresStart = i;\n      continue;\n    }\n    if (featuresStart !== -1 && i > featuresStart && /^\\s*\\[.*\\]\\s*$/.test(lines[i] ?? \"\")) {\n      featuresEnd = i;\n      break;\n    }\n  }\n\n  if (featuresStart === -1) {\n    const prefix = body.trim().length === 0 ? \"\" : `${body.trimEnd()}\\n\\n`;\n    return `${prefix}[features]\\n${desired}\\n`;\n  }\n\n  const keyPattern = new RegExp(`^\\\\s*${escapeRegex(key)}\\\\s*=`);\n  for (let i = featuresStart + 1; i < featuresEnd; i++) {\n    if (keyPattern.test(lines[i] ?? \"\")) {\n      lines[i] = desired;\n      return lines.join(\"\\n\");\n    }\n  }\n\n  lines.splice(featuresStart + 1, 0, desired);\n  return lines.join(\"\\n\");\n}\n\nfunction escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nexport async function runHookUninstall(\n  options: HookCommandOptions = {},\n): Promise<HookCommandResult> {\n  const settingsPath = resolveSettingsPath(options);\n\n  if (!existsSync(settingsPath)) {\n    return {\n      stdout: `almanac: SessionEnd hook not installed (no settings file)\\n`,\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  const settings = await readSettings(settingsPath);\n  const existing = (settings.hooks?.SessionEnd ?? []).slice();\n\n  const kept: RawEntry[] = [];\n  let removed = 0;\n\n  for (const raw of existing) {\n    const c = classifyEntry(raw);\n    if (c.kind === \"wrapped\") {\n      // Filter out our command(s) from the inner hooks array. Keep\n      // anything else in the array intact — a foreign wrapper that\n      // happened to include our script alongside its own commands\n      // (unusual, but survivable) loses our entry and keeps theirs.\n      const innerKept = c.entry.hooks.filter(\n        (h) => !isOurCommandPath(h.command),\n      );\n      const innerRemoved = c.entry.hooks.length - innerKept.length;\n      removed += innerRemoved;\n      if (innerKept.length === 0) {\n        // Only drop the outer wrapper when it was entirely ours. A\n        // foreign wrapper that never contained our script stays verbatim\n        // below (handled by `innerRemoved === 0`, which leaves\n        // `innerKept.length === c.entry.hooks.length`, hence we fall\n        // through to the else-branch).\n        if (innerRemoved === 0) kept.push(raw);\n        // else: fully owned by us, drop the container.\n      } else if (innerRemoved === 0) {\n        // Untouched foreign wrapper — preserve the raw object to keep\n        // any fields (like matcher) byte-for-byte.\n        kept.push(raw);\n      } else {\n        // Partial: rebuild with just the kept inner entries, preserving\n        // the original matcher string.\n        kept.push({ matcher: c.entry.matcher, hooks: innerKept });\n      }\n    } else if (c.kind === \"legacy\") {\n      if (isOurCommandPath(c.entry.command)) {\n        removed += 1;\n      } else {\n        kept.push(raw);\n      }\n    } else {\n      kept.push(raw);\n    }\n  }\n\n  if (removed === 0) {\n    return {\n      stdout: `almanac: SessionEnd hook not installed\\n`,\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  if (settings.hooks !== undefined) {\n    if (kept.length === 0) {\n      // Empty SessionEnd array confuses some linters; drop the key when\n      // nothing's left.\n      const { SessionEnd: _dropped, ...rest } = settings.hooks;\n      void _dropped;\n      settings.hooks = rest;\n    } else {\n      settings.hooks = { ...settings.hooks, SessionEnd: kept };\n    }\n\n    // If `hooks` itself is now empty (user had only our SessionEnd entry\n    // and no other hook categories), drop the `hooks` key entirely so\n    // uninstall leaves the settings file in the same shape it would be\n    // in had we never run install. An empty `\"hooks\": {}` is an obvious\n    // breadcrumb in commit diffs.\n    if (Object.keys(settings.hooks).length === 0) {\n      delete settings.hooks;\n    }\n  }\n\n  await writeSettings(settingsPath, settings);\n\n  return {\n    stdout: `almanac: SessionEnd hook removed\\n`,\n    stderr: \"\",\n    exitCode: 0,\n  };\n}\n\nexport async function runHookStatus(\n  options: HookCommandOptions = {},\n): Promise<HookCommandResult> {\n  const script = resolveHookScriptPath(options);\n  const settingsPath = resolveSettingsPath(options);\n\n  if (!existsSync(settingsPath)) {\n    return {\n      stdout:\n        `SessionEnd hook: not installed\\n` +\n        `settings: ${settingsPath} (does not exist)\\n` +\n        (script.ok ? `script would be: ${script.path}\\n` : \"\"),\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  const settings = await readSettings(settingsPath);\n  const existing = settings.hooks?.SessionEnd ?? [];\n\n  // Walk the array looking for any entry (wrapped or legacy) that\n  // references our capture script. Gathering foreign entries separately\n  // lets us show them to the user if nothing of ours was found.\n  let ourCommand: string | null = null;\n  const foreignSummary: string[] = [];\n  for (const raw of existing) {\n    const c = classifyEntry(raw);\n    if (c.kind === \"wrapped\") {\n      for (const h of c.entry.hooks) {\n        if (isOurCommandPath(h.command)) {\n          ourCommand ??= h.command;\n        } else {\n          foreignSummary.push(h.command);\n        }\n      }\n    } else if (c.kind === \"legacy\") {\n      if (isOurCommandPath(c.entry.command)) {\n        ourCommand ??= c.entry.command;\n      } else {\n        foreignSummary.push(c.entry.command);\n      }\n    }\n  }\n\n  if (ourCommand === null) {\n    const foreignLines = foreignSummary\n      .map((c) => `  - ${c}`)\n      .join(\"\\n\");\n    return {\n      stdout:\n        `SessionEnd hook: not installed\\n` +\n        `settings: ${settingsPath}\\n` +\n        (foreignSummary.length > 0\n          ? `(${foreignSummary.length} foreign entr${foreignSummary.length === 1 ? \"y\" : \"ies\"} present:\\n${foreignLines})\\n`\n          : \"\") +\n        (script.ok ? `script would be: ${script.path}\\n` : \"\"),\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  return {\n    stdout:\n      `SessionEnd hook: installed\\n` +\n      `script: ${ourCommand}\\n` +\n      `settings: ${settingsPath}\\n`,\n    stderr: \"\",\n    exitCode: 0,\n  };\n}\n\n// ─── Settings JSON helpers ───────────────────────────────────────────\n\nasync function readSettings(settingsPath: string): Promise<SettingsJson> {\n  if (!existsSync(settingsPath)) return {};\n  try {\n    const raw = await readFile(settingsPath, \"utf8\");\n    if (raw.trim().length === 0) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (parsed === null || typeof parsed !== \"object\") return {};\n    return parsed as SettingsJson;\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`failed to read ${settingsPath}: ${msg}`);\n  }\n}\n\nasync function writeSettings(\n  settingsPath: string,\n  settings: SettingsJson,\n): Promise<void> {\n  const dir = path.dirname(settingsPath);\n  await mkdir(dir, { recursive: true });\n\n  // Atomic write: JSON.stringify → tmp file → rename. `rename` within the\n  // same filesystem is atomic on POSIX; Claude Code never sees a partial\n  // file. Formatted with 2-space indent to match the existing settings.\n  const tmp = `${settingsPath}.almanac-tmp-${process.pid}`;\n  const body = `${JSON.stringify(settings, null, 2)}\\n`;\n  await writeFile(tmp, body, \"utf8\");\n  await rename(tmp, settingsPath);\n}\n","import { existsSync } from \"node:fs\";\nimport { copyFile, mkdir, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport interface HookPathOptions {\n  hookScriptPath?: string;\n  settingsPath?: string;\n  stableHooksDir?: string;\n}\n\nexport type ScriptResolution =\n  | { ok: true; path: string }\n  | { ok: false; error: string };\n\nexport function resolveSettingsPath(options: HookPathOptions): string {\n  if (options.settingsPath !== undefined) return options.settingsPath;\n  return path.join(homedir(), \".claude\", \"settings.json\");\n}\n\n/**\n * Copy the bundled hook script to `~/.claude/hooks/almanac-capture.sh`.\n *\n * This stable, user-owned destination survives Node version switches and\n * npm/npx cache evictions. The copy is idempotent: if bytes already match\n * we skip writing so repeated setup runs do not bump mtimes.\n */\nexport async function copyToStableHooksDir(\n  bundledPath: string,\n  options: HookPathOptions,\n): Promise<ScriptResolution> {\n  const stableHooksDir =\n    options.stableHooksDir ?? path.join(homedir(), \".claude\", \"hooks\");\n  const dest = path.join(stableHooksDir, \"almanac-capture.sh\");\n\n  try {\n    await mkdir(stableHooksDir, { recursive: true });\n    const srcBytes = await readFile(bundledPath);\n    let needsCopy = true;\n    if (existsSync(dest)) {\n      try {\n        const destBytes = await readFile(dest);\n        if (srcBytes.equals(destBytes)) needsCopy = false;\n      } catch {\n        // Can't read dest — overwrite.\n      }\n    }\n    if (needsCopy) {\n      await copyFile(bundledPath, dest);\n    }\n    return { ok: true, path: dest };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      ok: false,\n      error: `could not copy hook script to ${dest}: ${msg}`,\n    };\n  }\n}\n\n/**\n * Locate the bundled `hooks/almanac-capture.sh`. Mirrors\n * `resolvePromptsDir` from `src/agent/prompts.ts`: two plausible layouts\n * (installed dist vs. source dev), probe each.\n */\nexport function resolveHookScriptPath(\n  options: HookPathOptions,\n): ScriptResolution {\n  if (options.hookScriptPath !== undefined) {\n    return { ok: true, path: options.hookScriptPath };\n  }\n\n  const here = path.dirname(fileURLToPath(import.meta.url));\n\n  const candidates = [\n    // Bundled: `.../codealmanac/dist/codealmanac.js` → `../hooks/…`\n    path.resolve(here, \"..\", \"hooks\", \"almanac-capture.sh\"),\n    // Source after ts-node-style module layout or nested dist helpers.\n    path.resolve(here, \"..\", \"..\", \"hooks\", \"almanac-capture.sh\"),\n    // Source: `.../codealmanac/src/commands/hook/script.ts` → `../../../hooks/…`\n    path.resolve(here, \"..\", \"..\", \"..\", \"hooks\", \"almanac-capture.sh\"),\n    // Defensive nested fallback.\n    path.resolve(here, \"..\", \"..\", \"..\", \"..\", \"hooks\", \"almanac-capture.sh\"),\n  ];\n\n  for (const candidate of candidates) {\n    if (existsSync(candidate)) {\n      return { ok: true, path: candidate };\n    }\n  }\n\n  return {\n    ok: false,\n    error:\n      `could not locate hooks/almanac-capture.sh. Tried:\\n` +\n      candidates.map((c) => `  - ${c}`).join(\"\\n\"),\n  };\n}\n"],"mappings":"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","names":["existsSync","mkdir","readFile","homedir","path","path","homedir","existsSync","readFile","mkdir"]}

package/dist/{chunk-QLHJP2XK.js → chunk-B2AGSRXL.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
+import {
+  readStateForDoctor
+} from "./chunk-V3QOQSXI.js";
 import {
   formatDuration
 } from "./chunk-4CODZRHH.js";
-import {
-  readStateForDoctor
-} from "./chunk-QHQ6YH7U.js";
 import {
   BLUE,
   BOLD,
@@ -14,13 +14,17 @@ import {
   RST
 } from "./chunk-FM3VRDK7.js";
 import {
-  IMPORT_LINE,
+  IMPORT_LINE
+} from "./chunk-ZDJSJIB6.js";
+import {
   checkClaudeAuth
-} from "./chunk-3LC55TG6.js";
+} from "./chunk-SSYMRT4I.js";
+import {
+  isNewer
+} from "./chunk-F53U6JQG.js";
 import {
-  isNewer,
   readConfig
-} from "./chunk-AXFPUHBN.js";
+} from "./chunk-WRUSDYYE.js";
 
 // src/commands/doctor-checks/format.ts
 function formatReport(report, options) {
@@ -420,7 +424,7 @@ async function runDoctor(options) {
 }
 async function safeGatherWikiChecks(options) {
   try {
-    const { gatherWikiChecks } = await import("./wiki-IPSRRGOT.js");
+    const { gatherWikiChecks } = await import("./wiki-IGNRNLUZ.js");
     return await gatherWikiChecks(options);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -438,4 +442,4 @@ async function safeGatherWikiChecks(options) {
 export {
   runDoctor
 };
-//# sourceMappingURL=chunk-QLHJP2XK.js.map
+//# sourceMappingURL=chunk-B2AGSRXL.js.map

package/dist/{chunk-QLHJP2XK.js.map → chunk-B2AGSRXL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/doctor-checks/format.ts","../src/commands/doctor-checks/install.ts","../src/commands/doctor-checks/probes.ts","../src/commands/doctor-checks/updates.ts","../src/commands/doctor.ts"],"sourcesContent":["import { BLUE, BOLD, DIM, GREEN, RED, RST } from \"../../ansi.js\";\nimport type { Check, CheckStatus, DoctorOptions, DoctorReport } from \"./types.js\";\n\nexport function formatReport(\n  report: DoctorReport,\n  options: DoctorOptions,\n): string {\n  const color = options.stdout === undefined && process.stdout.isTTY === true;\n  const lines: string[] = [];\n  lines.push(`codealmanac v${report.version}`);\n  lines.push(\"\");\n  if (report.install.length > 0) {\n    lines.push(color ? `${BOLD}## Install${RST}` : \"## Install\");\n    for (const c of report.install) {\n      lines.push(formatCheck(c, color));\n    }\n    lines.push(\"\");\n  }\n  if (report.updates.length > 0) {\n    lines.push(color ? `${BOLD}## Updates${RST}` : \"## Updates\");\n    for (const c of report.updates) {\n      lines.push(formatCheck(c, color));\n    }\n    lines.push(\"\");\n  }\n  if (report.wiki.length > 0) {\n    lines.push(color ? `${BOLD}## Current wiki${RST}` : \"## Current wiki\");\n    for (const c of report.wiki) {\n      lines.push(formatCheck(c, color));\n    }\n    lines.push(\"\");\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction formatCheck(c: Check, color: boolean): string {\n  const { icon, tint } = iconFor(c.status, color);\n  const head = `  ${tint}${icon}${color ? RST : \"\"} ${c.message}`;\n  if (c.fix === undefined) return head;\n  const fixLine = color\n    ? `    ${DIM}${c.fix}${RST}`\n    : `    ${c.fix}`;\n  return `${head}\\n${fixLine}`;\n}\n\nfunction iconFor(\n  status: CheckStatus,\n  color: boolean,\n): { icon: string; tint: string } {\n  switch (status) {\n    case \"ok\":\n      return { icon: \"\\u2713\", tint: color ? GREEN : \"\" };\n    case \"problem\":\n      return { icon: \"\\u2717\", tint: color ? RED : \"\" };\n    case \"info\":\n      return { icon: \"\\u25c7\", tint: color ? BLUE : \"\" };\n  }\n}\n","import { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\nimport type { ClaudeAuthStatus } from \"../../agent/auth.js\";\nimport { IMPORT_LINE } from \"../setup.js\";\nimport {\n  classifyInstallPath,\n  detectInstallPath,\n  probeBetterSqlite3,\n  safeCheckAuth,\n} from \"./probes.js\";\nimport type { Check, DoctorOptions } from \"./types.js\";\n\nexport async function gatherInstallChecks(\n  options: DoctorOptions,\n): Promise<Check[]> {\n  const checks: Check[] = [];\n\n  const rawPath = options.installPath ?? detectInstallPath();\n  const { installPath, isEphemeral } = classifyInstallPath(rawPath);\n  checks.push(describeInstallPath(installPath, isEphemeral));\n\n  const nodeVersion = options.nodeVersion ?? process.version;\n  const sqlite = options.sqliteProbe ?? probeBetterSqlite3();\n  checks.push({\n    status: sqlite.ok ? \"ok\" : \"problem\",\n    key: \"install.sqlite\",\n    message: sqlite.ok\n      ? `better-sqlite3 native binding OK (Node ${nodeVersion})`\n      : `better-sqlite3 native binding failed: ${sqlite.summary}`,\n    fix: sqlite.ok\n      ? undefined\n      : \"run: npm rebuild better-sqlite3 (in the install directory)\",\n  });\n\n  const auth = await safeCheckAuth(options.spawnCli);\n  checks.push(describeAuth(auth));\n\n  const settingsPath =\n    options.settingsPath ?? path.join(homedir(), \".claude\", \"settings.json\");\n  checks.push(await describeHook(settingsPath));\n\n  const claudeDir = options.claudeDir ?? path.join(homedir(), \".claude\");\n  checks.push(describeGuides(claudeDir));\n  checks.push(await describeImportLine(claudeDir));\n\n  return checks;\n}\n\nfunction describeInstallPath(\n  installPath: string | null,\n  isEphemeral: boolean,\n): Check {\n  if (installPath === null) {\n    return {\n      status: \"problem\",\n      key: \"install.path\",\n      message: \"could not detect codealmanac install path\",\n      fix: \"reinstall with: npm install -g codealmanac\",\n    };\n  }\n  return {\n    status: isEphemeral ? \"info\" : \"ok\",\n    key: \"install.path\",\n    message: isEphemeral\n      ? `codealmanac running from ephemeral npx location: ${installPath}`\n      : `codealmanac installed at ${installPath}`,\n    fix: isEphemeral\n      ? \"run: npm install -g codealmanac  (to make the install permanent)\"\n      : undefined,\n  };\n}\n\nfunction describeAuth(auth: ClaudeAuthStatus): Check {\n  if (auth.loggedIn) {\n    if (auth.authMethod === \"apiKey\") {\n      return {\n        status: \"ok\",\n        key: \"install.auth\",\n        message: \"claude auth: ANTHROPIC_API_KEY set\",\n      };\n    }\n    const who = auth.email ?? \"Claude account\";\n    const plan =\n      auth.subscriptionType !== undefined\n        ? ` (${auth.subscriptionType} subscription)`\n        : \"\";\n    return {\n      status: \"ok\",\n      key: \"install.auth\",\n      message: `claude auth: ${who}${plan}`,\n    };\n  }\n  if (\n    process.env.ANTHROPIC_API_KEY !== undefined &&\n    process.env.ANTHROPIC_API_KEY.length > 0\n  ) {\n    return {\n      status: \"ok\",\n      key: \"install.auth\",\n      message: \"claude auth: ANTHROPIC_API_KEY set\",\n    };\n  }\n  return {\n    status: \"problem\",\n    key: \"install.auth\",\n    message: \"claude auth: not signed in\",\n    fix: \"run: claude auth login --claudeai  (or export ANTHROPIC_API_KEY)\",\n  };\n}\n\nasync function describeHook(settingsPath: string): Promise<Check> {\n  if (!existsSync(settingsPath)) {\n    return {\n      status: \"problem\",\n      key: \"install.hook\",\n      message: \"SessionEnd hook not installed\",\n      fix: \"run: almanac setup --yes\",\n    };\n  }\n  try {\n    const raw = await readFile(settingsPath, \"utf8\");\n    const parsed = JSON.parse(raw) as {\n      hooks?: {\n        SessionEnd?: {\n          command?: string;\n          hooks?: { command?: string }[];\n        }[];\n      };\n    };\n    const entries = parsed.hooks?.SessionEnd ?? [];\n    const found = entries.some((e) => {\n      if (\n        typeof e?.command === \"string\" &&\n        e.command.endsWith(\"almanac-capture.sh\")\n      ) {\n        return true;\n      }\n      if (Array.isArray(e?.hooks)) {\n        return e.hooks.some(\n          (h) =>\n            typeof h?.command === \"string\" &&\n            h.command.endsWith(\"almanac-capture.sh\"),\n        );\n      }\n      return false;\n    });\n    if (!found) {\n      return {\n        status: \"problem\",\n        key: \"install.hook\",\n        message: \"SessionEnd hook not installed\",\n        fix: \"run: almanac setup --yes\",\n      };\n    }\n    return {\n      status: \"ok\",\n      key: \"install.hook\",\n      message: `SessionEnd hook installed at ${settingsPath}`,\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"problem\",\n      key: \"install.hook\",\n      message: `could not read ${settingsPath}: ${msg}`,\n      fix: \"check the file for malformed JSON\",\n    };\n  }\n}\n\nfunction describeGuides(claudeDir: string): Check {\n  const mini = path.join(claudeDir, \"codealmanac.md\");\n  const ref = path.join(claudeDir, \"codealmanac-reference.md\");\n  const haveMini = existsSync(mini);\n  const haveRef = existsSync(ref);\n  if (haveMini && haveRef) {\n    return {\n      status: \"ok\",\n      key: \"install.guides\",\n      message: `Agent guides installed (${path.basename(mini)}, ${path.basename(ref)})`,\n    };\n  }\n  const missing = [\n    haveMini ? null : \"codealmanac.md\",\n    haveRef ? null : \"codealmanac-reference.md\",\n  ].filter((s): s is string => s !== null);\n  return {\n    status: \"problem\",\n    key: \"install.guides\",\n    message: `Agent guides missing (${missing.join(\", \")})`,\n    fix: \"run: almanac setup --yes\",\n  };\n}\n\nasync function describeImportLine(claudeDir: string): Promise<Check> {\n  const claudeMd = path.join(claudeDir, \"CLAUDE.md\");\n  if (!existsSync(claudeMd)) {\n    return {\n      status: \"problem\",\n      key: \"install.import\",\n      message: \"CLAUDE.md import not present (no ~/.claude/CLAUDE.md)\",\n      fix: \"run: almanac setup --yes\",\n    };\n  }\n  try {\n    const contents = await readFile(claudeMd, \"utf8\");\n    const lines = contents.split(/\\r?\\n/).map((l) => l.trim());\n    const present = lines.some((line) => {\n      if (line === IMPORT_LINE) return true;\n      if (!line.startsWith(IMPORT_LINE)) return false;\n      const next = line[IMPORT_LINE.length];\n      return next === \" \" || next === \"\\t\";\n    });\n    if (present) {\n      return {\n        status: \"ok\",\n        key: \"install.import\",\n        message: \"CLAUDE.md import present\",\n      };\n    }\n    return {\n      status: \"problem\",\n      key: \"install.import\",\n      message: \"CLAUDE.md import line missing\",\n      fix: \"run: almanac setup --yes\",\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"problem\",\n      key: \"install.import\",\n      message: `could not read ${claudeMd}: ${msg}`,\n    };\n  }\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { checkClaudeAuth, type ClaudeAuthStatus, type SpawnCliFn } from \"../../agent/auth.js\";\nimport type { SqliteProbeResult } from \"./types.js\";\n\n// Single `createRequire` instance — used by package/binding probes.\nconst req = createRequire(import.meta.url);\n\n/**\n * Detect where codealmanac is installed by walking up from the running\n * module until we find a `package.json` whose `name` is `codealmanac`.\n */\nexport function detectInstallPath(): string | null {\n  try {\n    const here = fileURLToPath(import.meta.url);\n    let dir = path.dirname(here);\n    for (let i = 0; i < 6; i++) {\n      const pkgPath = path.join(dir, \"package.json\");\n      if (existsSync(pkgPath)) {\n        try {\n          const raw = readFileSync(pkgPath, \"utf-8\");\n          const pkg = JSON.parse(raw) as { name?: unknown };\n          if (pkg.name === \"codealmanac\") return dir;\n        } catch {\n          // ignore — keep walking\n        }\n      }\n      const parent = path.dirname(dir);\n      if (parent === dir) break;\n      dir = parent;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Classify the detected install path as permanent or ephemeral.\n * Ephemeral locations (npm npx cache, pnpm dlx cache, /tmp/) are valid\n * installs but will disappear when the cache is evicted or the machine\n * reboots. Doctor reports them as `info` rather than `ok`.\n */\nexport function classifyInstallPath(\n  raw: string | null,\n): { installPath: string | null; isEphemeral: boolean } {\n  if (raw === null) return { installPath: null, isEphemeral: false };\n  const home = homedir();\n  const ephemeralPrefixes = [\n    path.join(home, \".npm\", \"_npx\"),\n    path.join(home, \".local\", \"share\", \"pnpm\", \"dlx\"),\n    \"/tmp/\",\n    \"/var/folders/\",\n  ];\n  const isEphemeral = ephemeralPrefixes.some((p) => raw.startsWith(p));\n  return { installPath: raw, isEphemeral };\n}\n\n/**\n * Probe the better-sqlite3 native binding by opening an in-memory DB.\n */\nexport function probeBetterSqlite3(): SqliteProbeResult {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const Database = req(\"better-sqlite3\") as typeof import(\"better-sqlite3\");\n    const db = new Database(\":memory:\");\n    db.close();\n    return { ok: true, summary: \"native binding loads cleanly\" };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    const firstLine = msg.split(\"\\n\")[0] ?? msg;\n    return { ok: false, summary: firstLine };\n  }\n}\n\nexport async function safeCheckAuth(\n  spawnCli?: SpawnCliFn,\n): Promise<ClaudeAuthStatus> {\n  try {\n    return await checkClaudeAuth(spawnCli);\n  } catch {\n    return { loggedIn: false };\n  }\n}\n\nexport function readPackageVersion(): string | null {\n  const candidates = [\n    \"../../../package.json\",\n    \"../../package.json\",\n    \"../package.json\",\n  ];\n  for (const candidate of candidates) {\n    try {\n      const pkg = req(candidate) as { version?: unknown };\n      if (typeof pkg.version === \"string\" && pkg.version.length > 0) {\n        return pkg.version;\n      }\n    } catch {\n      // Fall through to the next runtime layout candidate.\n    }\n  }\n  return null;\n}\n","import { readConfig } from \"../../update/config.js\";\nimport { readStateForDoctor } from \"../../update/schedule.js\";\nimport { isNewer } from \"../../update/semver.js\";\nimport { formatDuration } from \"./duration.js\";\nimport type { Check, DoctorOptions } from \"./types.js\";\n\nexport async function gatherUpdateChecks(\n  options: DoctorOptions,\n  installedVersion: string,\n): Promise<Check[]> {\n  const checks: Check[] = [];\n  const state = readStateForDoctor(options.updateStatePath);\n  const config = await readConfig(options.updateConfigPath);\n\n  if (state === null || state.latest_version.length === 0) {\n    checks.push({\n      status: \"info\",\n      key: \"update.status\",\n      message: `on ${installedVersion}; no update check has run yet`,\n      fix: \"run: almanac update --check\",\n    });\n  } else if (isNewer(state.latest_version, installedVersion)) {\n    const dismissed = state.dismissed_versions.includes(state.latest_version)\n      ? \" (dismissed — run `almanac update` to install anyway)\"\n      : \"\";\n    checks.push({\n      status: \"problem\",\n      key: \"update.status\",\n      message:\n        `${state.latest_version} available (you're on ${installedVersion})${dismissed}`,\n      fix: \"run: almanac update\",\n    });\n  } else {\n    checks.push({\n      status: \"ok\",\n      key: \"update.status\",\n      message: `on latest (${installedVersion})`,\n    });\n  }\n\n  if (state !== null && state.last_check_at > 0) {\n    const now = (options.now?.() ?? new Date()).getTime();\n    const ageMs = now - state.last_check_at * 1000;\n    const failedSuffix =\n      state.last_fetch_failed_at !== undefined &&\n      state.last_fetch_failed_at === state.last_check_at\n        ? \" (last attempt failed — will retry next invocation)\"\n        : \"\";\n    checks.push({\n      status: \"info\",\n      key: \"update.last_check\",\n      message: `last checked: ${formatDuration(ageMs)} ago${failedSuffix}`,\n    });\n  } else {\n    checks.push({\n      status: \"info\",\n      key: \"update.last_check\",\n      message: \"last checked: never\",\n    });\n  }\n\n  checks.push({\n    status: \"info\",\n    key: \"update.notifier\",\n    message: `update notifier: ${config.update_notifier ? \"enabled\" : \"disabled\"}`,\n    fix: config.update_notifier\n      ? undefined\n      : \"run: almanac update --enable-notifier\",\n  });\n\n  if (state !== null && state.dismissed_versions.length > 0) {\n    checks.push({\n      status: \"info\",\n      key: \"update.dismissed\",\n      message: `dismissed versions: ${state.dismissed_versions.join(\", \")}`,\n    });\n  }\n\n  return checks;\n}\n","import { formatReport } from \"./doctor-checks/format.js\";\nimport { gatherInstallChecks } from \"./doctor-checks/install.js\";\nimport { readPackageVersion } from \"./doctor-checks/probes.js\";\nimport type {\n  Check,\n  CheckStatus,\n  DoctorOptions,\n  DoctorReport,\n  DoctorResult,\n  SqliteProbeResult,\n} from \"./doctor-checks/types.js\";\nimport { gatherUpdateChecks } from \"./doctor-checks/updates.js\";\n\nexport type {\n  Check,\n  CheckStatus,\n  DoctorOptions,\n  DoctorReport,\n  DoctorResult,\n  SqliteProbeResult,\n};\n\n/**\n * `almanac doctor` — install + wiki health report.\n *\n * Separate from `almanac health` (which checks graph integrity of a\n * specific wiki). `doctor` answers the \"is this install even set up\n * correctly?\" question that users hit when first trying the tool or when\n * sessions silently stop getting captured.\n *\n * This file is the command composition root. The section-specific probes\n * and formatting live in `doctor-checks/` so each durable fact has one\n * obvious owner.\n */\nexport async function runDoctor(\n  options: DoctorOptions,\n): Promise<DoctorResult> {\n  const version =\n    options.versionOverride ?? readPackageVersion() ?? \"unknown\";\n\n  const install: Check[] = options.wikiOnly === true\n    ? []\n    : await gatherInstallChecks(options);\n\n  const updates: Check[] = options.wikiOnly === true\n    ? []\n    : await gatherUpdateChecks(options, version);\n\n  const wiki: Check[] = options.installOnly === true\n    ? []\n    : await safeGatherWikiChecks(options);\n\n  const report: DoctorReport = { version, install, updates, wiki };\n\n  if (options.json === true) {\n    return {\n      stdout: `${JSON.stringify(report, null, 2)}\\n`,\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  return {\n    stdout: formatReport(report, options),\n    stderr: \"\",\n    exitCode: 0,\n  };\n}\n\nasync function safeGatherWikiChecks(\n  options: DoctorOptions,\n): Promise<Check[]> {\n  try {\n    const { gatherWikiChecks } = await import(\"./doctor-checks/wiki.js\");\n    return await gatherWikiChecks(options);\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return [\n      {\n        status: \"problem\",\n        key: \"wiki.checks\",\n        message: `could not run wiki checks: ${msg.split(\"\\n\")[0] ?? msg}`,\n        fix: \"run: npm rebuild better-sqlite3 (in the install directory)\",\n      },\n    ];\n  }\n}\n"],"mappings":"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","names":["existsSync","homedir","path","path","homedir","existsSync"]}
+{"version":3,"sources":["../src/commands/doctor-checks/format.ts","../src/commands/doctor-checks/install.ts","../src/commands/doctor-checks/probes.ts","../src/commands/doctor-checks/updates.ts","../src/commands/doctor.ts"],"sourcesContent":["import { BLUE, BOLD, DIM, GREEN, RED, RST } from \"../../ansi.js\";\nimport type { Check, CheckStatus, DoctorOptions, DoctorReport } from \"./types.js\";\n\nexport function formatReport(\n  report: DoctorReport,\n  options: DoctorOptions,\n): string {\n  const color = options.stdout === undefined && process.stdout.isTTY === true;\n  const lines: string[] = [];\n  lines.push(`codealmanac v${report.version}`);\n  lines.push(\"\");\n  if (report.install.length > 0) {\n    lines.push(color ? `${BOLD}## Install${RST}` : \"## Install\");\n    for (const c of report.install) {\n      lines.push(formatCheck(c, color));\n    }\n    lines.push(\"\");\n  }\n  if (report.updates.length > 0) {\n    lines.push(color ? `${BOLD}## Updates${RST}` : \"## Updates\");\n    for (const c of report.updates) {\n      lines.push(formatCheck(c, color));\n    }\n    lines.push(\"\");\n  }\n  if (report.wiki.length > 0) {\n    lines.push(color ? `${BOLD}## Current wiki${RST}` : \"## Current wiki\");\n    for (const c of report.wiki) {\n      lines.push(formatCheck(c, color));\n    }\n    lines.push(\"\");\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction formatCheck(c: Check, color: boolean): string {\n  const { icon, tint } = iconFor(c.status, color);\n  const head = `  ${tint}${icon}${color ? RST : \"\"} ${c.message}`;\n  if (c.fix === undefined) return head;\n  const fixLine = color\n    ? `    ${DIM}${c.fix}${RST}`\n    : `    ${c.fix}`;\n  return `${head}\\n${fixLine}`;\n}\n\nfunction iconFor(\n  status: CheckStatus,\n  color: boolean,\n): { icon: string; tint: string } {\n  switch (status) {\n    case \"ok\":\n      return { icon: \"\\u2713\", tint: color ? GREEN : \"\" };\n    case \"problem\":\n      return { icon: \"\\u2717\", tint: color ? RED : \"\" };\n    case \"info\":\n      return { icon: \"\\u25c7\", tint: color ? BLUE : \"\" };\n  }\n}\n","import { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\nimport type { ClaudeAuthStatus } from \"../../agent/auth.js\";\nimport { IMPORT_LINE } from \"../setup.js\";\nimport {\n  classifyInstallPath,\n  detectInstallPath,\n  probeBetterSqlite3,\n  safeCheckAuth,\n} from \"./probes.js\";\nimport type { Check, DoctorOptions } from \"./types.js\";\n\nexport async function gatherInstallChecks(\n  options: DoctorOptions,\n): Promise<Check[]> {\n  const checks: Check[] = [];\n\n  const rawPath = options.installPath ?? detectInstallPath();\n  const { installPath, isEphemeral } = classifyInstallPath(rawPath);\n  checks.push(describeInstallPath(installPath, isEphemeral));\n\n  const nodeVersion = options.nodeVersion ?? process.version;\n  const sqlite = options.sqliteProbe ?? probeBetterSqlite3();\n  checks.push({\n    status: sqlite.ok ? \"ok\" : \"problem\",\n    key: \"install.sqlite\",\n    message: sqlite.ok\n      ? `better-sqlite3 native binding OK (Node ${nodeVersion})`\n      : `better-sqlite3 native binding failed: ${sqlite.summary}`,\n    fix: sqlite.ok\n      ? undefined\n      : \"run: npm rebuild better-sqlite3 (in the install directory)\",\n  });\n\n  const auth = await safeCheckAuth(options.spawnCli);\n  checks.push(describeAuth(auth));\n\n  const settingsPath =\n    options.settingsPath ?? path.join(homedir(), \".claude\", \"settings.json\");\n  checks.push(await describeHook(settingsPath));\n\n  const claudeDir = options.claudeDir ?? path.join(homedir(), \".claude\");\n  checks.push(describeGuides(claudeDir));\n  checks.push(await describeImportLine(claudeDir));\n\n  return checks;\n}\n\nfunction describeInstallPath(\n  installPath: string | null,\n  isEphemeral: boolean,\n): Check {\n  if (installPath === null) {\n    return {\n      status: \"problem\",\n      key: \"install.path\",\n      message: \"could not detect codealmanac install path\",\n      fix: \"reinstall with: npm install -g codealmanac\",\n    };\n  }\n  return {\n    status: isEphemeral ? \"info\" : \"ok\",\n    key: \"install.path\",\n    message: isEphemeral\n      ? `codealmanac running from ephemeral npx location: ${installPath}`\n      : `codealmanac installed at ${installPath}`,\n    fix: isEphemeral\n      ? \"run: npm install -g codealmanac  (to make the install permanent)\"\n      : undefined,\n  };\n}\n\nfunction describeAuth(auth: ClaudeAuthStatus): Check {\n  if (auth.loggedIn) {\n    if (auth.authMethod === \"apiKey\") {\n      return {\n        status: \"ok\",\n        key: \"install.auth\",\n        message: \"claude auth: ANTHROPIC_API_KEY set\",\n      };\n    }\n    const who = auth.email ?? \"Claude account\";\n    const plan =\n      auth.subscriptionType !== undefined\n        ? ` (${auth.subscriptionType} subscription)`\n        : \"\";\n    return {\n      status: \"ok\",\n      key: \"install.auth\",\n      message: `claude auth: ${who}${plan}`,\n    };\n  }\n  if (\n    process.env.ANTHROPIC_API_KEY !== undefined &&\n    process.env.ANTHROPIC_API_KEY.length > 0\n  ) {\n    return {\n      status: \"ok\",\n      key: \"install.auth\",\n      message: \"claude auth: ANTHROPIC_API_KEY set\",\n    };\n  }\n  return {\n    status: \"problem\",\n    key: \"install.auth\",\n    message: \"claude auth: not signed in\",\n    fix: \"run: claude auth login --claudeai  (or export ANTHROPIC_API_KEY)\",\n  };\n}\n\nasync function describeHook(settingsPath: string): Promise<Check> {\n  if (!existsSync(settingsPath)) {\n    return {\n      status: \"problem\",\n      key: \"install.hook\",\n      message: \"SessionEnd hook not installed\",\n      fix: \"run: almanac setup --yes\",\n    };\n  }\n  try {\n    const raw = await readFile(settingsPath, \"utf8\");\n    const parsed = JSON.parse(raw) as {\n      hooks?: {\n        SessionEnd?: {\n          command?: string;\n          hooks?: { command?: string }[];\n        }[];\n      };\n    };\n    const entries = parsed.hooks?.SessionEnd ?? [];\n    const found = entries.some((e) => {\n      if (\n        typeof e?.command === \"string\" &&\n        e.command.endsWith(\"almanac-capture.sh\")\n      ) {\n        return true;\n      }\n      if (Array.isArray(e?.hooks)) {\n        return e.hooks.some(\n          (h) =>\n            typeof h?.command === \"string\" &&\n            h.command.endsWith(\"almanac-capture.sh\"),\n        );\n      }\n      return false;\n    });\n    if (!found) {\n      return {\n        status: \"problem\",\n        key: \"install.hook\",\n        message: \"SessionEnd hook not installed\",\n        fix: \"run: almanac setup --yes\",\n      };\n    }\n    return {\n      status: \"ok\",\n      key: \"install.hook\",\n      message: `SessionEnd hook installed at ${settingsPath}`,\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"problem\",\n      key: \"install.hook\",\n      message: `could not read ${settingsPath}: ${msg}`,\n      fix: \"check the file for malformed JSON\",\n    };\n  }\n}\n\nfunction describeGuides(claudeDir: string): Check {\n  const mini = path.join(claudeDir, \"codealmanac.md\");\n  const ref = path.join(claudeDir, \"codealmanac-reference.md\");\n  const haveMini = existsSync(mini);\n  const haveRef = existsSync(ref);\n  if (haveMini && haveRef) {\n    return {\n      status: \"ok\",\n      key: \"install.guides\",\n      message: `Agent guides installed (${path.basename(mini)}, ${path.basename(ref)})`,\n    };\n  }\n  const missing = [\n    haveMini ? null : \"codealmanac.md\",\n    haveRef ? null : \"codealmanac-reference.md\",\n  ].filter((s): s is string => s !== null);\n  return {\n    status: \"problem\",\n    key: \"install.guides\",\n    message: `Agent guides missing (${missing.join(\", \")})`,\n    fix: \"run: almanac setup --yes\",\n  };\n}\n\nasync function describeImportLine(claudeDir: string): Promise<Check> {\n  const claudeMd = path.join(claudeDir, \"CLAUDE.md\");\n  if (!existsSync(claudeMd)) {\n    return {\n      status: \"problem\",\n      key: \"install.import\",\n      message: \"CLAUDE.md import not present (no ~/.claude/CLAUDE.md)\",\n      fix: \"run: almanac setup --yes\",\n    };\n  }\n  try {\n    const contents = await readFile(claudeMd, \"utf8\");\n    const lines = contents.split(/\\r?\\n/).map((l) => l.trim());\n    const present = lines.some((line) => {\n      if (line === IMPORT_LINE) return true;\n      if (!line.startsWith(IMPORT_LINE)) return false;\n      const next = line[IMPORT_LINE.length];\n      return next === \" \" || next === \"\\t\";\n    });\n    if (present) {\n      return {\n        status: \"ok\",\n        key: \"install.import\",\n        message: \"CLAUDE.md import present\",\n      };\n    }\n    return {\n      status: \"problem\",\n      key: \"install.import\",\n      message: \"CLAUDE.md import line missing\",\n      fix: \"run: almanac setup --yes\",\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"problem\",\n      key: \"install.import\",\n      message: `could not read ${claudeMd}: ${msg}`,\n    };\n  }\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { checkClaudeAuth, type ClaudeAuthStatus, type SpawnCliFn } from \"../../agent/auth.js\";\nimport type { SqliteProbeResult } from \"./types.js\";\n\n// Single `createRequire` instance — used by package/binding probes.\nconst req = createRequire(import.meta.url);\n\n/**\n * Detect where codealmanac is installed by walking up from the running\n * module until we find a `package.json` whose `name` is `codealmanac`.\n */\nexport function detectInstallPath(): string | null {\n  try {\n    const here = fileURLToPath(import.meta.url);\n    let dir = path.dirname(here);\n    for (let i = 0; i < 6; i++) {\n      const pkgPath = path.join(dir, \"package.json\");\n      if (existsSync(pkgPath)) {\n        try {\n          const raw = readFileSync(pkgPath, \"utf-8\");\n          const pkg = JSON.parse(raw) as { name?: unknown };\n          if (pkg.name === \"codealmanac\") return dir;\n        } catch {\n          // ignore — keep walking\n        }\n      }\n      const parent = path.dirname(dir);\n      if (parent === dir) break;\n      dir = parent;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Classify the detected install path as permanent or ephemeral.\n * Ephemeral locations (npm npx cache, pnpm dlx cache, /tmp/) are valid\n * installs but will disappear when the cache is evicted or the machine\n * reboots. Doctor reports them as `info` rather than `ok`.\n */\nexport function classifyInstallPath(\n  raw: string | null,\n): { installPath: string | null; isEphemeral: boolean } {\n  if (raw === null) return { installPath: null, isEphemeral: false };\n  const home = homedir();\n  const ephemeralPrefixes = [\n    path.join(home, \".npm\", \"_npx\"),\n    path.join(home, \".local\", \"share\", \"pnpm\", \"dlx\"),\n    \"/tmp/\",\n    \"/var/folders/\",\n  ];\n  const isEphemeral = ephemeralPrefixes.some((p) => raw.startsWith(p));\n  return { installPath: raw, isEphemeral };\n}\n\n/**\n * Probe the better-sqlite3 native binding by opening an in-memory DB.\n */\nexport function probeBetterSqlite3(): SqliteProbeResult {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const Database = req(\"better-sqlite3\") as typeof import(\"better-sqlite3\");\n    const db = new Database(\":memory:\");\n    db.close();\n    return { ok: true, summary: \"native binding loads cleanly\" };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    const firstLine = msg.split(\"\\n\")[0] ?? msg;\n    return { ok: false, summary: firstLine };\n  }\n}\n\nexport async function safeCheckAuth(\n  spawnCli?: SpawnCliFn,\n): Promise<ClaudeAuthStatus> {\n  try {\n    return await checkClaudeAuth(spawnCli);\n  } catch {\n    return { loggedIn: false };\n  }\n}\n\nexport function readPackageVersion(): string | null {\n  const candidates = [\n    \"../../../package.json\",\n    \"../../package.json\",\n    \"../package.json\",\n  ];\n  for (const candidate of candidates) {\n    try {\n      const pkg = req(candidate) as { version?: unknown };\n      if (typeof pkg.version === \"string\" && pkg.version.length > 0) {\n        return pkg.version;\n      }\n    } catch {\n      // Fall through to the next runtime layout candidate.\n    }\n  }\n  return null;\n}\n","import { readConfig } from \"../../update/config.js\";\nimport { readStateForDoctor } from \"../../update/schedule.js\";\nimport { isNewer } from \"../../update/semver.js\";\nimport { formatDuration } from \"./duration.js\";\nimport type { Check, DoctorOptions } from \"./types.js\";\n\nexport async function gatherUpdateChecks(\n  options: DoctorOptions,\n  installedVersion: string,\n): Promise<Check[]> {\n  const checks: Check[] = [];\n  const state = readStateForDoctor(options.updateStatePath);\n  const config = await readConfig(options.updateConfigPath);\n\n  if (state === null || state.latest_version.length === 0) {\n    checks.push({\n      status: \"info\",\n      key: \"update.status\",\n      message: `on ${installedVersion}; no update check has run yet`,\n      fix: \"run: almanac update --check\",\n    });\n  } else if (isNewer(state.latest_version, installedVersion)) {\n    const dismissed = state.dismissed_versions.includes(state.latest_version)\n      ? \" (dismissed — run `almanac update` to install anyway)\"\n      : \"\";\n    checks.push({\n      status: \"problem\",\n      key: \"update.status\",\n      message:\n        `${state.latest_version} available (you're on ${installedVersion})${dismissed}`,\n      fix: \"run: almanac update\",\n    });\n  } else {\n    checks.push({\n      status: \"ok\",\n      key: \"update.status\",\n      message: `on latest (${installedVersion})`,\n    });\n  }\n\n  if (state !== null && state.last_check_at > 0) {\n    const now = (options.now?.() ?? new Date()).getTime();\n    const ageMs = now - state.last_check_at * 1000;\n    const failedSuffix =\n      state.last_fetch_failed_at !== undefined &&\n      state.last_fetch_failed_at === state.last_check_at\n        ? \" (last attempt failed — will retry next invocation)\"\n        : \"\";\n    checks.push({\n      status: \"info\",\n      key: \"update.last_check\",\n      message: `last checked: ${formatDuration(ageMs)} ago${failedSuffix}`,\n    });\n  } else {\n    checks.push({\n      status: \"info\",\n      key: \"update.last_check\",\n      message: \"last checked: never\",\n    });\n  }\n\n  checks.push({\n    status: \"info\",\n    key: \"update.notifier\",\n    message: `update notifier: ${config.update_notifier ? \"enabled\" : \"disabled\"}`,\n    fix: config.update_notifier\n      ? undefined\n      : \"run: almanac update --enable-notifier\",\n  });\n\n  if (state !== null && state.dismissed_versions.length > 0) {\n    checks.push({\n      status: \"info\",\n      key: \"update.dismissed\",\n      message: `dismissed versions: ${state.dismissed_versions.join(\", \")}`,\n    });\n  }\n\n  return checks;\n}\n","import { formatReport } from \"./doctor-checks/format.js\";\nimport { gatherInstallChecks } from \"./doctor-checks/install.js\";\nimport { readPackageVersion } from \"./doctor-checks/probes.js\";\nimport type {\n  Check,\n  CheckStatus,\n  DoctorOptions,\n  DoctorReport,\n  DoctorResult,\n  SqliteProbeResult,\n} from \"./doctor-checks/types.js\";\nimport { gatherUpdateChecks } from \"./doctor-checks/updates.js\";\n\nexport type {\n  Check,\n  CheckStatus,\n  DoctorOptions,\n  DoctorReport,\n  DoctorResult,\n  SqliteProbeResult,\n};\n\n/**\n * `almanac doctor` — install + wiki health report.\n *\n * Separate from `almanac health` (which checks graph integrity of a\n * specific wiki). `doctor` answers the \"is this install even set up\n * correctly?\" question that users hit when first trying the tool or when\n * sessions silently stop getting captured.\n *\n * This file is the command composition root. The section-specific probes\n * and formatting live in `doctor-checks/` so each durable fact has one\n * obvious owner.\n */\nexport async function runDoctor(\n  options: DoctorOptions,\n): Promise<DoctorResult> {\n  const version =\n    options.versionOverride ?? readPackageVersion() ?? \"unknown\";\n\n  const install: Check[] = options.wikiOnly === true\n    ? []\n    : await gatherInstallChecks(options);\n\n  const updates: Check[] = options.wikiOnly === true\n    ? []\n    : await gatherUpdateChecks(options, version);\n\n  const wiki: Check[] = options.installOnly === true\n    ? []\n    : await safeGatherWikiChecks(options);\n\n  const report: DoctorReport = { version, install, updates, wiki };\n\n  if (options.json === true) {\n    return {\n      stdout: `${JSON.stringify(report, null, 2)}\\n`,\n      stderr: \"\",\n      exitCode: 0,\n    };\n  }\n\n  return {\n    stdout: formatReport(report, options),\n    stderr: \"\",\n    exitCode: 0,\n  };\n}\n\nasync function safeGatherWikiChecks(\n  options: DoctorOptions,\n): Promise<Check[]> {\n  try {\n    const { gatherWikiChecks } = await import(\"./doctor-checks/wiki.js\");\n    return await gatherWikiChecks(options);\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return [\n      {\n        status: \"problem\",\n        key: \"wiki.checks\",\n        message: `could not run wiki checks: ${msg.split(\"\\n\")[0] ?? msg}`,\n        fix: \"run: npm rebuild better-sqlite3 (in the install directory)\",\n      },\n    ];\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGO,SAAS,aACd,QACA,SACQ;AACR,QAAM,QAAQ,QAAQ,WAAW,UAAa,QAAQ,OAAO,UAAU;AACvE,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,gBAAgB,OAAO,OAAO,EAAE;AAC3C,QAAM,KAAK,EAAE;AACb,MAAI,OAAO,QAAQ,SAAS,GAAG;AAC7B,UAAM,KAAK,QAAQ,GAAG,IAAI,aAAa,GAAG,KAAK,YAAY;AAC3D,eAAW,KAAK,OAAO,SAAS;AAC9B,YAAM,KAAK,YAAY,GAAG,KAAK,CAAC;AAAA,IAClC;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AACA,MAAI,OAAO,QAAQ,SAAS,GAAG;AAC7B,UAAM,KAAK,QAAQ,GAAG,IAAI,aAAa,GAAG,KAAK,YAAY;AAC3D,eAAW,KAAK,OAAO,SAAS;AAC9B,YAAM,KAAK,YAAY,GAAG,KAAK,CAAC;AAAA,IAClC;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AACA,MAAI,OAAO,KAAK,SAAS,GAAG;AAC1B,UAAM,KAAK,QAAQ,GAAG,IAAI,kBAAkB,GAAG,KAAK,iBAAiB;AACrE,eAAW,KAAK,OAAO,MAAM;AAC3B,YAAM,KAAK,YAAY,GAAG,KAAK,CAAC;AAAA,IAClC;AACA,UAAM,KAAK,EAAE;AAAA,EACf;AACA,SAAO,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA;AAC5B;AAEA,SAAS,YAAY,GAAU,OAAwB;AACrD,QAAM,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,QAAQ,KAAK;AAC9C,QAAM,OAAO,KAAK,IAAI,GAAG,IAAI,GAAG,QAAQ,MAAM,EAAE,IAAI,EAAE,OAAO;AAC7D,MAAI,EAAE,QAAQ,OAAW,QAAO;AAChC,QAAM,UAAU,QACZ,OAAO,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,KACxB,OAAO,EAAE,GAAG;AAChB,SAAO,GAAG,IAAI;AAAA,EAAK,OAAO;AAC5B;AAEA,SAAS,QACP,QACA,OACgC;AAChC,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,EAAE,MAAM,UAAU,MAAM,QAAQ,QAAQ,GAAG;AAAA,IACpD,KAAK;AACH,aAAO,EAAE,MAAM,UAAU,MAAM,QAAQ,MAAM,GAAG;AAAA,IAClD,KAAK;AACH,aAAO,EAAE,MAAM,UAAU,MAAM,QAAQ,OAAO,GAAG;AAAA,EACrD;AACF;;;ACzDA,SAAS,cAAAA,mBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,WAAAC,gBAAe;AACxB,OAAOC,WAAU;;;ACHjB,SAAS,YAAY,oBAAoB;AACzC,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AACxB,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAM9B,IAAM,MAAM,cAAc,YAAY,GAAG;AAMlC,SAAS,oBAAmC;AACjD,MAAI;AACF,UAAM,OAAO,cAAc,YAAY,GAAG;AAC1C,QAAI,MAAM,KAAK,QAAQ,IAAI;AAC3B,aAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,YAAM,UAAU,KAAK,KAAK,KAAK,cAAc;AAC7C,UAAI,WAAW,OAAO,GAAG;AACvB,YAAI;AACF,gBAAM,MAAM,aAAa,SAAS,OAAO;AACzC,gBAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,cAAI,IAAI,SAAS,cAAe,QAAO;AAAA,QACzC,QAAQ;AAAA,QAER;AAAA,MACF;AACA,YAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,UAAI,WAAW,IAAK;AACpB,YAAM;AAAA,IACR;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAQO,SAAS,oBACd,KACsD;AACtD,MAAI,QAAQ,KAAM,QAAO,EAAE,aAAa,MAAM,aAAa,MAAM;AACjE,QAAM,OAAO,QAAQ;AACrB,QAAM,oBAAoB;AAAA,IACxB,KAAK,KAAK,MAAM,QAAQ,MAAM;AAAA,IAC9B,KAAK,KAAK,MAAM,UAAU,SAAS,QAAQ,KAAK;AAAA,IAChD;AAAA,IACA;AAAA,EACF;AACA,QAAM,cAAc,kBAAkB,KAAK,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC;AACnE,SAAO,EAAE,aAAa,KAAK,YAAY;AACzC;AAKO,SAAS,qBAAwC;AACtD,MAAI;AAEF,UAAM,WAAW,IAAI,gBAAgB;AACrC,UAAM,KAAK,IAAI,SAAS,UAAU;AAClC,OAAG,MAAM;AACT,WAAO,EAAE,IAAI,MAAM,SAAS,+BAA+B;AAAA,EAC7D,SAAS,KAAc;AACrB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,UAAM,YAAY,IAAI,MAAM,IAAI,EAAE,CAAC,KAAK;AACxC,WAAO,EAAE,IAAI,OAAO,SAAS,UAAU;AAAA,EACzC;AACF;AAEA,eAAsB,cACpB,UAC2B;AAC3B,MAAI;AACF,WAAO,MAAM,gBAAgB,QAAQ;AAAA,EACvC,QAAQ;AACN,WAAO,EAAE,UAAU,MAAM;AAAA,EAC3B;AACF;AAEO,SAAS,qBAAoC;AAClD,QAAM,aAAa;AAAA,IACjB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,YAAM,MAAM,IAAI,SAAS;AACzB,UAAI,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,SAAS,GAAG;AAC7D,eAAO,IAAI;AAAA,MACb;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;;;AD3FA,eAAsB,oBACpB,SACkB;AAClB,QAAM,SAAkB,CAAC;AAEzB,QAAM,UAAU,QAAQ,eAAe,kBAAkB;AACzD,QAAM,EAAE,aAAa,YAAY,IAAI,oBAAoB,OAAO;AAChE,SAAO,KAAK,oBAAoB,aAAa,WAAW,CAAC;AAEzD,QAAM,cAAc,QAAQ,eAAe,QAAQ;AACnD,QAAM,SAAS,QAAQ,eAAe,mBAAmB;AACzD,SAAO,KAAK;AAAA,IACV,QAAQ,OAAO,KAAK,OAAO;AAAA,IAC3B,KAAK;AAAA,IACL,SAAS,OAAO,KACZ,0CAA0C,WAAW,MACrD,yCAAyC,OAAO,OAAO;AAAA,IAC3D,KAAK,OAAO,KACR,SACA;AAAA,EACN,CAAC;AAED,QAAM,OAAO,MAAM,cAAc,QAAQ,QAAQ;AACjD,SAAO,KAAK,aAAa,IAAI,CAAC;AAE9B,QAAM,eACJ,QAAQ,gBAAgBC,MAAK,KAAKC,SAAQ,GAAG,WAAW,eAAe;AACzE,SAAO,KAAK,MAAM,aAAa,YAAY,CAAC;AAE5C,QAAM,YAAY,QAAQ,aAAaD,MAAK,KAAKC,SAAQ,GAAG,SAAS;AACrE,SAAO,KAAK,eAAe,SAAS,CAAC;AACrC,SAAO,KAAK,MAAM,mBAAmB,SAAS,CAAC;AAE/C,SAAO;AACT;AAEA,SAAS,oBACP,aACA,aACO;AACP,MAAI,gBAAgB,MAAM;AACxB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS;AAAA,MACT,KAAK;AAAA,IACP;AAAA,EACF;AACA,SAAO;AAAA,IACL,QAAQ,cAAc,SAAS;AAAA,IAC/B,KAAK;AAAA,IACL,SAAS,cACL,oDAAoD,WAAW,KAC/D,4BAA4B,WAAW;AAAA,IAC3C,KAAK,cACD,qEACA;AAAA,EACN;AACF;AAEA,SAAS,aAAa,MAA+B;AACnD,MAAI,KAAK,UAAU;AACjB,QAAI,KAAK,eAAe,UAAU;AAChC,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,KAAK;AAAA,QACL,SAAS;AAAA,MACX;AAAA,IACF;AACA,UAAM,MAAM,KAAK,SAAS;AAC1B,UAAM,OACJ,KAAK,qBAAqB,SACtB,KAAK,KAAK,gBAAgB,mBAC1B;AACN,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,gBAAgB,GAAG,GAAG,IAAI;AAAA,IACrC;AAAA,EACF;AACA,MACE,QAAQ,IAAI,sBAAsB,UAClC,QAAQ,IAAI,kBAAkB,SAAS,GACvC;AACA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS;AAAA,IACX;AAAA,EACF;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,KAAK;AAAA,IACL,SAAS;AAAA,IACT,KAAK;AAAA,EACP;AACF;AAEA,eAAe,aAAa,cAAsC;AAChE,MAAI,CAACC,YAAW,YAAY,GAAG;AAC7B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS;AAAA,MACT,KAAK;AAAA,IACP;AAAA,EACF;AACA,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,cAAc,MAAM;AAC/C,UAAM,SAAS,KAAK,MAAM,GAAG;AAQ7B,UAAM,UAAU,OAAO,OAAO,cAAc,CAAC;AAC7C,UAAM,QAAQ,QAAQ,KAAK,CAAC,MAAM;AAChC,UACE,OAAO,GAAG,YAAY,YACtB,EAAE,QAAQ,SAAS,oBAAoB,GACvC;AACA,eAAO;AAAA,MACT;AACA,UAAI,MAAM,QAAQ,GAAG,KAAK,GAAG;AAC3B,eAAO,EAAE,MAAM;AAAA,UACb,CAAC,MACC,OAAO,GAAG,YAAY,YACtB,EAAE,QAAQ,SAAS,oBAAoB;AAAA,QAC3C;AAAA,MACF;AACA,aAAO;AAAA,IACT,CAAC;AACD,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,KAAK;AAAA,QACL,SAAS;AAAA,QACT,KAAK;AAAA,MACP;AAAA,IACF;AACA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,gCAAgC,YAAY;AAAA,IACvD;AAAA,EACF,SAAS,KAAc;AACrB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,kBAAkB,YAAY,KAAK,GAAG;AAAA,MAC/C,KAAK;AAAA,IACP;AAAA,EACF;AACF;AAEA,SAAS,eAAe,WAA0B;AAChD,QAAM,OAAOF,MAAK,KAAK,WAAW,gBAAgB;AAClD,QAAM,MAAMA,MAAK,KAAK,WAAW,0BAA0B;AAC3D,QAAM,WAAWE,YAAW,IAAI;AAChC,QAAM,UAAUA,YAAW,GAAG;AAC9B,MAAI,YAAY,SAAS;AACvB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,2BAA2BF,MAAK,SAAS,IAAI,CAAC,KAAKA,MAAK,SAAS,GAAG,CAAC;AAAA,IAChF;AAAA,EACF;AACA,QAAM,UAAU;AAAA,IACd,WAAW,OAAO;AAAA,IAClB,UAAU,OAAO;AAAA,EACnB,EAAE,OAAO,CAAC,MAAmB,MAAM,IAAI;AACvC,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,KAAK;AAAA,IACL,SAAS,yBAAyB,QAAQ,KAAK,IAAI,CAAC;AAAA,IACpD,KAAK;AAAA,EACP;AACF;AAEA,eAAe,mBAAmB,WAAmC;AACnE,QAAM,WAAWA,MAAK,KAAK,WAAW,WAAW;AACjD,MAAI,CAACE,YAAW,QAAQ,GAAG;AACzB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS;AAAA,MACT,KAAK;AAAA,IACP;AAAA,EACF;AACA,MAAI;AACF,UAAM,WAAW,MAAM,SAAS,UAAU,MAAM;AAChD,UAAM,QAAQ,SAAS,MAAM,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACzD,UAAM,UAAU,MAAM,KAAK,CAAC,SAAS;AACnC,UAAI,SAAS,YAAa,QAAO;AACjC,UAAI,CAAC,KAAK,WAAW,WAAW,EAAG,QAAO;AAC1C,YAAM,OAAO,KAAK,YAAY,MAAM;AACpC,aAAO,SAAS,OAAO,SAAS;AAAA,IAClC,CAAC;AACD,QAAI,SAAS;AACX,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,KAAK;AAAA,QACL,SAAS;AAAA,MACX;AAAA,IACF;AACA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS;AAAA,MACT,KAAK;AAAA,IACP;AAAA,EACF,SAAS,KAAc;AACrB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,kBAAkB,QAAQ,KAAK,GAAG;AAAA,IAC7C;AAAA,EACF;AACF;;;AEvOA,eAAsB,mBACpB,SACA,kBACkB;AAClB,QAAM,SAAkB,CAAC;AACzB,QAAM,QAAQ,mBAAmB,QAAQ,eAAe;AACxD,QAAM,SAAS,MAAM,WAAW,QAAQ,gBAAgB;AAExD,MAAI,UAAU,QAAQ,MAAM,eAAe,WAAW,GAAG;AACvD,WAAO,KAAK;AAAA,MACV,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,MAAM,gBAAgB;AAAA,MAC/B,KAAK;AAAA,IACP,CAAC;AAAA,EACH,WAAW,QAAQ,MAAM,gBAAgB,gBAAgB,GAAG;AAC1D,UAAM,YAAY,MAAM,mBAAmB,SAAS,MAAM,cAAc,IACpE,+DACA;AACJ,WAAO,KAAK;AAAA,MACV,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SACE,GAAG,MAAM,cAAc,yBAAyB,gBAAgB,IAAI,SAAS;AAAA,MAC/E,KAAK;AAAA,IACP,CAAC;AAAA,EACH,OAAO;AACL,WAAO,KAAK;AAAA,MACV,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,cAAc,gBAAgB;AAAA,IACzC,CAAC;AAAA,EACH;AAEA,MAAI,UAAU,QAAQ,MAAM,gBAAgB,GAAG;AAC7C,UAAM,OAAO,QAAQ,MAAM,KAAK,oBAAI,KAAK,GAAG,QAAQ;AACpD,UAAM,QAAQ,MAAM,MAAM,gBAAgB;AAC1C,UAAM,eACJ,MAAM,yBAAyB,UAC/B,MAAM,yBAAyB,MAAM,gBACjC,6DACA;AACN,WAAO,KAAK;AAAA,MACV,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,iBAAiB,eAAe,KAAK,CAAC,OAAO,YAAY;AAAA,IACpE,CAAC;AAAA,EACH,OAAO;AACL,WAAO,KAAK;AAAA,MACV,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,SAAO,KAAK;AAAA,IACV,QAAQ;AAAA,IACR,KAAK;AAAA,IACL,SAAS,oBAAoB,OAAO,kBAAkB,YAAY,UAAU;AAAA,IAC5E,KAAK,OAAO,kBACR,SACA;AAAA,EACN,CAAC;AAED,MAAI,UAAU,QAAQ,MAAM,mBAAmB,SAAS,GAAG;AACzD,WAAO,KAAK;AAAA,MACV,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,SAAS,uBAAuB,MAAM,mBAAmB,KAAK,IAAI,CAAC;AAAA,IACrE,CAAC;AAAA,EACH;AAEA,SAAO;AACT;;;AC7CA,eAAsB,UACpB,SACuB;AACvB,QAAM,UACJ,QAAQ,mBAAmB,mBAAmB,KAAK;AAErD,QAAM,UAAmB,QAAQ,aAAa,OAC1C,CAAC,IACD,MAAM,oBAAoB,OAAO;AAErC,QAAM,UAAmB,QAAQ,aAAa,OAC1C,CAAC,IACD,MAAM,mBAAmB,SAAS,OAAO;AAE7C,QAAM,OAAgB,QAAQ,gBAAgB,OAC1C,CAAC,IACD,MAAM,qBAAqB,OAAO;AAEtC,QAAM,SAAuB,EAAE,SAAS,SAAS,SAAS,KAAK;AAE/D,MAAI,QAAQ,SAAS,MAAM;AACzB,WAAO;AAAA,MACL,QAAQ,GAAG,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA;AAAA,MAC1C,QAAQ;AAAA,MACR,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ,aAAa,QAAQ,OAAO;AAAA,IACpC,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AACF;AAEA,eAAe,qBACb,SACkB;AAClB,MAAI;AACF,UAAM,EAAE,iBAAiB,IAAI,MAAM,OAAO,oBAAyB;AACnE,WAAO,MAAM,iBAAiB,OAAO;AAAA,EACvC,SAAS,KAAc;AACrB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,WAAO;AAAA,MACL;AAAA,QACE,QAAQ;AAAA,QACR,KAAK;AAAA,QACL,SAAS,8BAA8B,IAAI,MAAM,IAAI,EAAE,CAAC,KAAK,GAAG;AAAA,QAChE,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;","names":["existsSync","homedir","path","path","homedir","existsSync"]}

package/dist/{chunk-AXFPUHBN.js → chunk-F53U6JQG.js}

@@ -3,44 +3,6 @@ import {
   getGlobalAlmanacDir
 } from "./chunk-7JUX4ADQ.js";
 
-// src/update/config.ts
-import { mkdir, readFile, rename, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-function defaultConfig() {
-  return { update_notifier: true };
-}
-function getConfigPath() {
-  return join(getGlobalAlmanacDir(), "config.json");
-}
-async function readConfig(path) {
-  const file = path ?? getConfigPath();
-  let raw;
-  try {
-    raw = await readFile(file, "utf8");
-  } catch {
-    return defaultConfig();
-  }
-  const trimmed = raw.trim();
-  if (trimmed.length === 0) return defaultConfig();
-  try {
-    const parsed = JSON.parse(trimmed);
-    return {
-      update_notifier: typeof parsed.update_notifier === "boolean" ? parsed.update_notifier : true
-    };
-  } catch {
-    return defaultConfig();
-  }
-}
-async function writeConfig(config, path) {
-  const file = path ?? getConfigPath();
-  await mkdir(dirname(file), { recursive: true });
-  const body = `${JSON.stringify(config, null, 2)}
-`;
-  const tmp = `${file}.tmp`;
-  await writeFile(tmp, body, "utf8");
-  await rename(tmp, file);
-}
-
 // src/update/semver.ts
 function parse(v) {
   const trimmed = v.trim().replace(/^v/i, "");
@@ -73,8 +35,8 @@ function isNewer(latest, installed) {
 }
 
 // src/update/state.ts
-import { mkdir as mkdir2, readFile as readFile2, rename as rename2, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname2, join as join2 } from "path";
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { dirname, join } from "path";
 function emptyState() {
   return {
     last_check_at: 0,
@@ -84,13 +46,13 @@ function emptyState() {
   };
 }
 function getStatePath() {
-  return join2(getGlobalAlmanacDir(), "update-state.json");
+  return join(getGlobalAlmanacDir(), "update-state.json");
 }
 async function readState(path) {
   const file = path ?? getStatePath();
   let raw;
   try {
-    raw = await readFile2(file, "utf8");
+    raw = await readFile(file, "utf8");
   } catch {
     return emptyState();
   }
@@ -113,12 +75,12 @@ async function readState(path) {
 }
 async function writeState(state, path) {
   const file = path ?? getStatePath();
-  await mkdir2(dirname2(file), { recursive: true });
+  await mkdir(dirname(file), { recursive: true });
   const body = `${JSON.stringify(state, null, 2)}
 `;
   const tmp = `${file}.tmp`;
-  await writeFile2(tmp, body, "utf8");
-  await rename2(tmp, file);
+  await writeFile(tmp, body, "utf8");
+  await rename(tmp, file);
 }
 
 // src/update/check.ts
@@ -215,13 +177,10 @@ function readInstalledVersion() {
 }
 
 export {
-  getConfigPath,
-  readConfig,
-  writeConfig,
   isNewer,
   getStatePath,
   readState,
   writeState,
   checkForUpdate
 };
-//# sourceMappingURL=chunk-AXFPUHBN.js.map
+//# sourceMappingURL=chunk-F53U6JQG.js.map

package/dist/chunk-F53U6JQG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/update/semver.ts","../src/update/state.ts","../src/update/check.ts"],"sourcesContent":["/**\n * Tiny semver comparator for update-version checks. We do NOT take a\n * dependency on `semver` — we only need a subset (compare two\n * well-formed `x.y.z` strings, optionally with a pre-release tag), and\n * adding a 400KB install for six lines of logic isn't a good trade.\n *\n * What we handle:\n *   - Numeric `major.minor.patch` with or without a `-pre` tag.\n *   - Missing parts default to 0 (`1.2` → `1.2.0`).\n *   - Leading `v` is stripped.\n *\n * What we don't handle:\n *   - Build metadata (`+sha.abcd`) — ignored.\n *   - Pre-release precedence rules beyond \"tagged < untagged at same\n *     numeric triple\". Good enough for codealmanac's linear release\n *     cadence; if we ever publish `-rc.1` vs `-rc.2` and care which\n *     comes first, revisit.\n */\n\ninterface Parsed {\n  major: number;\n  minor: number;\n  patch: number;\n  /** Empty string = no pre-release (counts as \"higher\" than a pre-release at the same triple). */\n  pre: string;\n}\n\nfunction parse(v: string): Parsed | null {\n  const trimmed = v.trim().replace(/^v/i, \"\");\n  // Strip build metadata (everything from the first `+`).\n  const noBuild = trimmed.split(\"+\")[0] ?? \"\";\n  // Split off pre-release tag.\n  const dashAt = noBuild.indexOf(\"-\");\n  const core = dashAt === -1 ? noBuild : noBuild.slice(0, dashAt);\n  const pre = dashAt === -1 ? \"\" : noBuild.slice(dashAt + 1);\n\n  const parts = core.split(\".\").map((p) => Number.parseInt(p, 10));\n  if (parts.length === 0 || parts.some((n) => !Number.isFinite(n) || n < 0)) {\n    return null;\n  }\n  return {\n    major: parts[0] ?? 0,\n    minor: parts[1] ?? 0,\n    patch: parts[2] ?? 0,\n    pre,\n  };\n}\n\n/**\n * Return `true` iff `latest` > `installed`. Returns `false` on unparseable\n * input rather than throwing — a bad version string must not be able to\n * crash the CLI's every-command banner path.\n */\nexport function isNewer(latest: string, installed: string): boolean {\n  const a = parse(latest);\n  const b = parse(installed);\n  if (a === null || b === null) return false;\n\n  if (a.major !== b.major) return a.major > b.major;\n  if (a.minor !== b.minor) return a.minor > b.minor;\n  if (a.patch !== b.patch) return a.patch > b.patch;\n\n  // Same numeric triple. Empty pre-release beats a tagged pre-release\n  // (1.2.3 > 1.2.3-rc.1). Two tagged pre-releases compare lexically.\n  if (a.pre === b.pre) return false;\n  if (a.pre === \"\" && b.pre !== \"\") return true;\n  if (a.pre !== \"\" && b.pre === \"\") return false;\n  return a.pre > b.pre;\n}\n","import { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nimport { getGlobalAlmanacDir } from \"../paths.js\";\n\n/**\n * `~/.almanac/update-state.json` — the only piece of persistent state\n * the update system owns. Written by the background check worker (once\n * per 24h) and by `almanac update` / `almanac update --dismiss`; read\n * by the pre-command banner, `almanac doctor`, and the check path to\n * decide whether 24h have elapsed since the last check.\n *\n * Format is a single flat object with no schema version: fields are\n * only ever added (and read with defaults), never removed or reshaped.\n * If we ever need a breaking migration, the file is trivially\n * regenerable — the worst case is a single extra registry round-trip.\n *\n * Corruption handling: every read path tolerates missing or malformed\n * JSON as \"no state\" (empty defaults). We never propagate a parse\n * error up to the CLI banner, because a corrupt state file must not\n * be able to break every invocation.\n */\nexport interface UpdateState {\n  /** Unix epoch seconds of the last registry query. */\n  last_check_at: number;\n  /** The codealmanac version running when we last wrote state. */\n  installed_version: string;\n  /** The newest version the registry has published at last check. */\n  latest_version: string;\n  /** Versions the user dismissed via `almanac update --dismiss`. */\n  dismissed_versions: string[];\n  /**\n   * Epoch seconds of the last registry fetch attempt that FAILED. Used\n   * by the check scheduler to back off (one failure shouldn't hammer\n   * the registry on every command) — reads tolerate a missing field.\n   */\n  last_fetch_failed_at?: number;\n}\n\nexport function emptyState(): UpdateState {\n  return {\n    last_check_at: 0,\n    installed_version: \"\",\n    latest_version: \"\",\n    dismissed_versions: [],\n  };\n}\n\nexport function getStatePath(): string {\n  return join(getGlobalAlmanacDir(), \"update-state.json\");\n}\n\n/**\n * Read the state file. Missing, empty, or malformed → empty state.\n * We deliberately swallow all errors here: the update system is\n * best-effort, and a read failure must not break any command.\n */\nexport async function readState(path?: string): Promise<UpdateState> {\n  const file = path ?? getStatePath();\n  let raw: string;\n  try {\n    raw = await readFile(file, \"utf8\");\n  } catch {\n    return emptyState();\n  }\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) return emptyState();\n  try {\n    const parsed = JSON.parse(trimmed) as Partial<UpdateState>;\n    return {\n      last_check_at:\n        typeof parsed.last_check_at === \"number\" ? parsed.last_check_at : 0,\n      installed_version:\n        typeof parsed.installed_version === \"string\"\n          ? parsed.installed_version\n          : \"\",\n      latest_version:\n        typeof parsed.latest_version === \"string\" ? parsed.latest_version : \"\",\n      dismissed_versions: Array.isArray(parsed.dismissed_versions)\n        ? parsed.dismissed_versions.filter(\n            (v): v is string => typeof v === \"string\" && v.length > 0,\n          )\n        : [],\n      last_fetch_failed_at:\n        typeof parsed.last_fetch_failed_at === \"number\"\n          ? parsed.last_fetch_failed_at\n          : undefined,\n    };\n  } catch {\n    return emptyState();\n  }\n}\n\n/**\n * Write the state file atomically (tmp + rename). Makes the concurrent\n * \"two commands ran their update checks at once\" race safe — one rename\n * wins, the other is dropped. Creates `~/.almanac/` if missing.\n */\nexport async function writeState(\n  state: UpdateState,\n  path?: string,\n): Promise<void> {\n  const file = path ?? getStatePath();\n  await mkdir(dirname(file), { recursive: true });\n  const body = `${JSON.stringify(state, null, 2)}\\n`;\n  const tmp = `${file}.tmp`;\n  await writeFile(tmp, body, \"utf8\");\n  await rename(tmp, file);\n}\n","import { createRequire } from \"node:module\";\n\nimport { readState, writeState, type UpdateState } from \"./state.js\";\n\n/**\n * Background update check. Called by the detached worker (`--internal-\n * check-updates`) after any normal command exits; also reachable via\n * `almanac update --check` for a synchronous \"am I current?\" readout.\n *\n * Contract:\n *   - Reads `~/.almanac/update-state.json` if present.\n *   - If the last check is older than `cacheSeconds` (default 24h), queries\n *     the npm registry for `codealmanac`'s `dist-tags.latest` and writes a\n *     new state file.\n *   - Network timeout is 3s: registry flakes must not prevent a check\n *     cycle on the next invocation.\n *   - All errors are swallowed; the returned state is always a usable\n *     snapshot (possibly the old one when the fetch failed).\n *\n * The fetch function is injectable. Tests pass a stub; production uses\n * the native `globalThis.fetch`. No dependency on `node-fetch`.\n */\n\nexport interface CheckOptions {\n  /** Override the installed version (prod: read from package.json). */\n  installedVersion?: string;\n  /** Cache window; no registry call if last check is newer than this. */\n  cacheSeconds?: number;\n  /** Network timeout in ms (default 3000). */\n  timeoutMs?: number;\n  /** Clock. Tests inject to make \"24h ago\" deterministic. */\n  now?: () => number;\n  /** Fetch function (default `globalThis.fetch`). */\n  fetchFn?: typeof fetch;\n  /** Override the state file path (tests point it at a tmpdir). */\n  statePath?: string;\n  /** Force a registry call regardless of the cache. Used by `update --check`. */\n  force?: boolean;\n}\n\nexport interface CheckResult {\n  /** The state after the check (either refreshed or unchanged). */\n  state: UpdateState;\n  /** True when a registry call actually happened this run. */\n  fetched: boolean;\n  /** True when the registry call failed (network / timeout / parse). */\n  fetchFailed: boolean;\n}\n\nconst DEFAULT_CACHE_SECONDS = 24 * 60 * 60;\nconst DEFAULT_TIMEOUT_MS = 3000;\nconst REGISTRY_URL = \"https://registry.npmjs.org/codealmanac\";\n\nexport async function checkForUpdate(\n  opts: CheckOptions = {},\n): Promise<CheckResult> {\n  const now = opts.now ?? (() => Math.floor(Date.now() / 1000));\n  const cacheSeconds = opts.cacheSeconds ?? DEFAULT_CACHE_SECONDS;\n  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const fetchFn = opts.fetchFn ?? globalThis.fetch;\n  const installed = opts.installedVersion ?? readInstalledVersion();\n\n  const state = await readState(opts.statePath);\n\n  // Cache gate. Skip the registry call when the previous check is\n  // fresh enough, unless `force: true` (used by `update --check` so\n  // the user can see real-time status without waiting out the window).\n  if (\n    !opts.force &&\n    state.last_check_at > 0 &&\n    now() - state.last_check_at < cacheSeconds\n  ) {\n    return { state, fetched: false, fetchFailed: false };\n  }\n\n  // Query the registry with a hard timeout. `AbortController` is the\n  // idiomatic Node 20+ way to bound a fetch; `setTimeout` fires abort,\n  // `clearTimeout` cancels if fetch resolves first.\n  let latest: string | null = null;\n  let failed = false;\n  try {\n    const ac = new AbortController();\n    const timer = setTimeout(() => ac.abort(), timeoutMs);\n    try {\n      const res = await fetchFn(REGISTRY_URL, {\n        signal: ac.signal,\n        headers: { accept: \"application/json\" },\n      });\n      if (!res.ok) {\n        failed = true;\n      } else {\n        const body = (await res.json()) as {\n          [\"dist-tags\"]?: { latest?: unknown };\n        };\n        const tag = body[\"dist-tags\"]?.latest;\n        if (typeof tag === \"string\" && tag.length > 0) {\n          latest = tag;\n        } else {\n          failed = true;\n        }\n      }\n    } finally {\n      clearTimeout(timer);\n    }\n  } catch {\n    failed = true;\n  }\n\n  if (failed || latest === null) {\n    // Record the failure but DON'T clobber the previous latest_version —\n    // an offline check shouldn't make us forget that 0.1.6 is out.\n    const next: UpdateState = {\n      ...state,\n      // We still bump last_check_at on a failed attempt; without this,\n      // every subsequent command would re-try the registry. A one-shot\n      // retry on the next invocation is enough; sustained failure gets\n      // retried on the 24h cadence like a success.\n      last_check_at: now(),\n      installed_version: installed,\n      last_fetch_failed_at: now(),\n    };\n    try {\n      await writeState(next, opts.statePath);\n    } catch {\n      // Even the state write failed (permissions, disk full). Return\n      // whatever we have — the CLI doesn't care.\n    }\n    return { state: next, fetched: true, fetchFailed: true };\n  }\n\n  const next: UpdateState = {\n    last_check_at: now(),\n    installed_version: installed,\n    latest_version: latest,\n    dismissed_versions: state.dismissed_versions,\n    // Clear the failure marker on success.\n    last_fetch_failed_at: undefined,\n  };\n  try {\n    await writeState(next, opts.statePath);\n  } catch {\n    // Silent — same rationale as above.\n  }\n  return { state: next, fetched: true, fetchFailed: false };\n}\n\n/**\n * Read the `version` field from `package.json`. Matches the same\n * lookup strategy as `readPackageVersion` in `cli.ts` and `doctor.ts`;\n * duplicated here to keep the update module self-contained and to\n * avoid a circular import at CLI startup.\n */\nfunction readInstalledVersion(): string {\n  try {\n    const require = createRequire(import.meta.url);\n    const pkg = require(\"../../package.json\") as { version?: unknown };\n    if (typeof pkg.version === \"string\" && pkg.version.length > 0) {\n      return pkg.version;\n    }\n  } catch {\n    // Fall through.\n  }\n  try {\n    const require = createRequire(import.meta.url);\n    const pkg = require(\"../package.json\") as { version?: unknown };\n    if (typeof pkg.version === \"string\" && pkg.version.length > 0) {\n      return pkg.version;\n    }\n  } catch {\n    // Fall through.\n  }\n  return \"unknown\";\n}\n"],"mappings":"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","names":["next","require"]}

package/dist/{chunk-3C5SY5SE.js → chunk-KQUVMF27.js}

@@ -491,7 +491,10 @@ async function ensureFreshIndex(ctx) {
     db.close();
     return emptyResult();
   }
-  if (!existsSync4(dbPath) || pagesNewerThan(pagesDir, dbPath) || topicsYamlNewerThan(almanacDir, dbPath)) {
+  if (!existsSync4(dbPath) || // Keep read-side freshness even when CLI/agent write paths eagerly
+  // reindex: users can still change `.almanac/pages/` directly via
+  // manual edits, git pulls, merges, or branch switches.
+  pagesNewerThan(pagesDir, dbPath) || topicsYamlNewerThan(almanacDir, dbPath)) {
     return runIndexer(ctx);
   }
   return emptyResult();
@@ -1236,4 +1239,4 @@ export {
   parseDuration,
   runHealth
 };
-//# sourceMappingURL=chunk-3C5SY5SE.js.map
+//# sourceMappingURL=chunk-KQUVMF27.js.map