codealmanac 0.1.6 → 0.1.8

package/dist/chunk-4CODZRHH.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+// src/commands/doctor-checks/duration.ts
+function formatDuration(ms) {
+  if (ms < 0) return "just now";
+  const seconds = Math.floor(ms / 1e3);
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 48) return `${hours}h`;
+  const days = Math.floor(hours / 24);
+  return `${days}d`;
+}
+
+export {
+  formatDuration
+};
+//# sourceMappingURL=chunk-4CODZRHH.js.map

package/dist/chunk-4CODZRHH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/doctor-checks/duration.ts"],"sourcesContent":["export function formatDuration(ms: number): string {\n  if (ms < 0) return \"just now\";\n  const seconds = Math.floor(ms / 1000);\n  if (seconds < 60) return `${seconds}s`;\n  const minutes = Math.floor(seconds / 60);\n  if (minutes < 60) return `${minutes}m`;\n  const hours = Math.floor(minutes / 60);\n  if (hours < 48) return `${hours}h`;\n  const days = Math.floor(hours / 24);\n  return `${days}d`;\n}\n"],"mappings":";;;AAAO,SAAS,eAAe,IAAoB;AACjD,MAAI,KAAK,EAAG,QAAO;AACnB,QAAM,UAAU,KAAK,MAAM,KAAK,GAAI;AACpC,MAAI,UAAU,GAAI,QAAO,GAAG,OAAO;AACnC,QAAM,UAAU,KAAK,MAAM,UAAU,EAAE;AACvC,MAAI,UAAU,GAAI,QAAO,GAAG,OAAO;AACnC,QAAM,QAAQ,KAAK,MAAM,UAAU,EAAE;AACrC,MAAI,QAAQ,GAAI,QAAO,GAAG,KAAK;AAC/B,QAAM,OAAO,KAAK,MAAM,QAAQ,EAAE;AAClC,SAAO,GAAG,IAAI;AAChB;","names":[]}

package/dist/chunk-73A5TGBC.js

@@ -0,0 +1,441 @@
+#!/usr/bin/env node
+import {
+  formatDuration
+} from "./chunk-4CODZRHH.js";
+import {
+  readStateForDoctor
+} from "./chunk-QHQ6YH7U.js";
+import {
+  BLUE,
+  BOLD,
+  DIM,
+  GREEN,
+  RED,
+  RST
+} from "./chunk-FM3VRDK7.js";
+import {
+  IMPORT_LINE,
+  checkClaudeAuth
+} from "./chunk-3LC55TG6.js";
+import {
+  isNewer,
+  readConfig
+} from "./chunk-AXFPUHBN.js";
+
+// src/commands/doctor-checks/format.ts
+function formatReport(report, options) {
+  const color = options.stdout === void 0 && process.stdout.isTTY === true;
+  const lines = [];
+  lines.push(`codealmanac v${report.version}`);
+  lines.push("");
+  if (report.install.length > 0) {
+    lines.push(color ? `${BOLD}## Install${RST}` : "## Install");
+    for (const c of report.install) {
+      lines.push(formatCheck(c, color));
+    }
+    lines.push("");
+  }
+  if (report.updates.length > 0) {
+    lines.push(color ? `${BOLD}## Updates${RST}` : "## Updates");
+    for (const c of report.updates) {
+      lines.push(formatCheck(c, color));
+    }
+    lines.push("");
+  }
+  if (report.wiki.length > 0) {
+    lines.push(color ? `${BOLD}## Current wiki${RST}` : "## Current wiki");
+    for (const c of report.wiki) {
+      lines.push(formatCheck(c, color));
+    }
+    lines.push("");
+  }
+  return `${lines.join("\n")}
+`;
+}
+function formatCheck(c, color) {
+  const { icon, tint } = iconFor(c.status, color);
+  const head = `  ${tint}${icon}${color ? RST : ""} ${c.message}`;
+  if (c.fix === void 0) return head;
+  const fixLine = color ? `    ${DIM}${c.fix}${RST}` : `    ${c.fix}`;
+  return `${head}
+${fixLine}`;
+}
+function iconFor(status, color) {
+  switch (status) {
+    case "ok":
+      return { icon: "\u2713", tint: color ? GREEN : "" };
+    case "problem":
+      return { icon: "\u2717", tint: color ? RED : "" };
+    case "info":
+      return { icon: "\u25C7", tint: color ? BLUE : "" };
+  }
+}
+
+// src/commands/doctor-checks/install.ts
+import { existsSync as existsSync2 } from "fs";
+import { readFile } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import path2 from "path";
+
+// src/commands/doctor-checks/probes.ts
+import { existsSync, readFileSync } from "fs";
+import { createRequire } from "module";
+import { homedir } from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+var req = createRequire(import.meta.url);
+function detectInstallPath() {
+  try {
+    const here = fileURLToPath(import.meta.url);
+    let dir = path.dirname(here);
+    for (let i = 0; i < 6; i++) {
+      const pkgPath = path.join(dir, "package.json");
+      if (existsSync(pkgPath)) {
+        try {
+          const raw = readFileSync(pkgPath, "utf-8");
+          const pkg = JSON.parse(raw);
+          if (pkg.name === "codealmanac") return dir;
+        } catch {
+        }
+      }
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function classifyInstallPath(raw) {
+  if (raw === null) return { installPath: null, isEphemeral: false };
+  const home = homedir();
+  const ephemeralPrefixes = [
+    path.join(home, ".npm", "_npx"),
+    path.join(home, ".local", "share", "pnpm", "dlx"),
+    "/tmp/",
+    "/var/folders/"
+  ];
+  const isEphemeral = ephemeralPrefixes.some((p) => raw.startsWith(p));
+  return { installPath: raw, isEphemeral };
+}
+function probeBetterSqlite3() {
+  try {
+    const Database = req("better-sqlite3");
+    const db = new Database(":memory:");
+    db.close();
+    return { ok: true, summary: "native binding loads cleanly" };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const firstLine = msg.split("\n")[0] ?? msg;
+    return { ok: false, summary: firstLine };
+  }
+}
+async function safeCheckAuth(spawnCli) {
+  try {
+    return await checkClaudeAuth(spawnCli);
+  } catch {
+    return { loggedIn: false };
+  }
+}
+function readPackageVersion() {
+  const candidates = [
+    "../../../package.json",
+    "../../package.json",
+    "../package.json"
+  ];
+  for (const candidate of candidates) {
+    try {
+      const pkg = req(candidate);
+      if (typeof pkg.version === "string" && pkg.version.length > 0) {
+        return pkg.version;
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+
+// src/commands/doctor-checks/install.ts
+async function gatherInstallChecks(options) {
+  const checks = [];
+  const rawPath = options.installPath ?? detectInstallPath();
+  const { installPath, isEphemeral } = classifyInstallPath(rawPath);
+  checks.push(describeInstallPath(installPath, isEphemeral));
+  const nodeVersion = options.nodeVersion ?? process.version;
+  const sqlite = options.sqliteProbe ?? probeBetterSqlite3();
+  checks.push({
+    status: sqlite.ok ? "ok" : "problem",
+    key: "install.sqlite",
+    message: sqlite.ok ? `better-sqlite3 native binding OK (Node ${nodeVersion})` : `better-sqlite3 native binding failed: ${sqlite.summary}`,
+    fix: sqlite.ok ? void 0 : "run: npm rebuild better-sqlite3 (in the install directory)"
+  });
+  const auth = await safeCheckAuth(options.spawnCli);
+  checks.push(describeAuth(auth));
+  const settingsPath = options.settingsPath ?? path2.join(homedir2(), ".claude", "settings.json");
+  checks.push(await describeHook(settingsPath));
+  const claudeDir = options.claudeDir ?? path2.join(homedir2(), ".claude");
+  checks.push(describeGuides(claudeDir));
+  checks.push(await describeImportLine(claudeDir));
+  return checks;
+}
+function describeInstallPath(installPath, isEphemeral) {
+  if (installPath === null) {
+    return {
+      status: "problem",
+      key: "install.path",
+      message: "could not detect codealmanac install path",
+      fix: "reinstall with: npm install -g codealmanac"
+    };
+  }
+  return {
+    status: isEphemeral ? "info" : "ok",
+    key: "install.path",
+    message: isEphemeral ? `codealmanac running from ephemeral npx location: ${installPath}` : `codealmanac installed at ${installPath}`,
+    fix: isEphemeral ? "run: npm install -g codealmanac  (to make the install permanent)" : void 0
+  };
+}
+function describeAuth(auth) {
+  if (auth.loggedIn) {
+    if (auth.authMethod === "apiKey") {
+      return {
+        status: "ok",
+        key: "install.auth",
+        message: "claude auth: ANTHROPIC_API_KEY set"
+      };
+    }
+    const who = auth.email ?? "Claude account";
+    const plan = auth.subscriptionType !== void 0 ? ` (${auth.subscriptionType} subscription)` : "";
+    return {
+      status: "ok",
+      key: "install.auth",
+      message: `claude auth: ${who}${plan}`
+    };
+  }
+  if (process.env.ANTHROPIC_API_KEY !== void 0 && process.env.ANTHROPIC_API_KEY.length > 0) {
+    return {
+      status: "ok",
+      key: "install.auth",
+      message: "claude auth: ANTHROPIC_API_KEY set"
+    };
+  }
+  return {
+    status: "problem",
+    key: "install.auth",
+    message: "claude auth: not signed in",
+    fix: "run: claude auth login --claudeai  (or export ANTHROPIC_API_KEY)"
+  };
+}
+async function describeHook(settingsPath) {
+  if (!existsSync2(settingsPath)) {
+    return {
+      status: "problem",
+      key: "install.hook",
+      message: "SessionEnd hook not installed",
+      fix: "run: almanac setup --yes"
+    };
+  }
+  try {
+    const raw = await readFile(settingsPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const entries = parsed.hooks?.SessionEnd ?? [];
+    const found = entries.some((e) => {
+      if (typeof e?.command === "string" && e.command.endsWith("almanac-capture.sh")) {
+        return true;
+      }
+      if (Array.isArray(e?.hooks)) {
+        return e.hooks.some(
+          (h) => typeof h?.command === "string" && h.command.endsWith("almanac-capture.sh")
+        );
+      }
+      return false;
+    });
+    if (!found) {
+      return {
+        status: "problem",
+        key: "install.hook",
+        message: "SessionEnd hook not installed",
+        fix: "run: almanac setup --yes"
+      };
+    }
+    return {
+      status: "ok",
+      key: "install.hook",
+      message: `SessionEnd hook installed at ${settingsPath}`
+    };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+      status: "problem",
+      key: "install.hook",
+      message: `could not read ${settingsPath}: ${msg}`,
+      fix: "check the file for malformed JSON"
+    };
+  }
+}
+function describeGuides(claudeDir) {
+  const mini = path2.join(claudeDir, "codealmanac.md");
+  const ref = path2.join(claudeDir, "codealmanac-reference.md");
+  const haveMini = existsSync2(mini);
+  const haveRef = existsSync2(ref);
+  if (haveMini && haveRef) {
+    return {
+      status: "ok",
+      key: "install.guides",
+      message: `Agent guides installed (${path2.basename(mini)}, ${path2.basename(ref)})`
+    };
+  }
+  const missing = [
+    haveMini ? null : "codealmanac.md",
+    haveRef ? null : "codealmanac-reference.md"
+  ].filter((s) => s !== null);
+  return {
+    status: "problem",
+    key: "install.guides",
+    message: `Agent guides missing (${missing.join(", ")})`,
+    fix: "run: almanac setup --yes"
+  };
+}
+async function describeImportLine(claudeDir) {
+  const claudeMd = path2.join(claudeDir, "CLAUDE.md");
+  if (!existsSync2(claudeMd)) {
+    return {
+      status: "problem",
+      key: "install.import",
+      message: "CLAUDE.md import not present (no ~/.claude/CLAUDE.md)",
+      fix: "run: almanac setup --yes"
+    };
+  }
+  try {
+    const contents = await readFile(claudeMd, "utf8");
+    const lines = contents.split(/\r?\n/).map((l) => l.trim());
+    const present = lines.some((line) => {
+      if (line === IMPORT_LINE) return true;
+      if (!line.startsWith(IMPORT_LINE)) return false;
+      const next = line[IMPORT_LINE.length];
+      return next === " " || next === "	";
+    });
+    if (present) {
+      return {
+        status: "ok",
+        key: "install.import",
+        message: "CLAUDE.md import present"
+      };
+    }
+    return {
+      status: "problem",
+      key: "install.import",
+      message: "CLAUDE.md import line missing",
+      fix: "run: almanac setup --yes"
+    };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+      status: "problem",
+      key: "install.import",
+      message: `could not read ${claudeMd}: ${msg}`
+    };
+  }
+}
+
+// src/commands/doctor-checks/updates.ts
+async function gatherUpdateChecks(options, installedVersion) {
+  const checks = [];
+  const state = readStateForDoctor(options.updateStatePath);
+  const config = await readConfig(options.updateConfigPath);
+  if (state === null || state.latest_version.length === 0) {
+    checks.push({
+      status: "info",
+      key: "update.status",
+      message: `on ${installedVersion}; no update check has run yet`,
+      fix: "run: almanac update --check"
+    });
+  } else if (isNewer(state.latest_version, installedVersion)) {
+    const dismissed = state.dismissed_versions.includes(state.latest_version) ? " (dismissed \u2014 run `almanac update` to install anyway)" : "";
+    checks.push({
+      status: "problem",
+      key: "update.status",
+      message: `${state.latest_version} available (you're on ${installedVersion})${dismissed}`,
+      fix: "run: almanac update"
+    });
+  } else {
+    checks.push({
+      status: "ok",
+      key: "update.status",
+      message: `on latest (${installedVersion})`
+    });
+  }
+  if (state !== null && state.last_check_at > 0) {
+    const now = (options.now?.() ?? /* @__PURE__ */ new Date()).getTime();
+    const ageMs = now - state.last_check_at * 1e3;
+    const failedSuffix = state.last_fetch_failed_at !== void 0 && state.last_fetch_failed_at === state.last_check_at ? " (last attempt failed \u2014 will retry next invocation)" : "";
+    checks.push({
+      status: "info",
+      key: "update.last_check",
+      message: `last checked: ${formatDuration(ageMs)} ago${failedSuffix}`
+    });
+  } else {
+    checks.push({
+      status: "info",
+      key: "update.last_check",
+      message: "last checked: never"
+    });
+  }
+  checks.push({
+    status: "info",
+    key: "update.notifier",
+    message: `update notifier: ${config.update_notifier ? "enabled" : "disabled"}`,
+    fix: config.update_notifier ? void 0 : "run: almanac update --enable-notifier"
+  });
+  if (state !== null && state.dismissed_versions.length > 0) {
+    checks.push({
+      status: "info",
+      key: "update.dismissed",
+      message: `dismissed versions: ${state.dismissed_versions.join(", ")}`
+    });
+  }
+  return checks;
+}
+
+// src/commands/doctor.ts
+async function runDoctor(options) {
+  const version = options.versionOverride ?? readPackageVersion() ?? "unknown";
+  const install = options.wikiOnly === true ? [] : await gatherInstallChecks(options);
+  const updates = options.wikiOnly === true ? [] : await gatherUpdateChecks(options, version);
+  const wiki = options.installOnly === true ? [] : await safeGatherWikiChecks(options);
+  const report = { version, install, updates, wiki };
+  if (options.json === true) {
+    return {
+      stdout: `${JSON.stringify(report, null, 2)}
+`,
+      stderr: "",
+      exitCode: 0
+    };
+  }
+  return {
+    stdout: formatReport(report, options),
+    stderr: "",
+    exitCode: 0
+  };
+}
+async function safeGatherWikiChecks(options) {
+  try {
+    const { gatherWikiChecks } = await import("./wiki-EHZ7LG7R.js");
+    return await gatherWikiChecks(options);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return [
+      {
+        status: "problem",
+        key: "wiki.checks",
+        message: `could not run wiki checks: ${msg.split("\n")[0] ?? msg}`,
+        fix: "run: npm rebuild better-sqlite3 (in the install directory)"
+      }
+    ];
+  }
+}
+
+export {
+  runDoctor
+};
+//# sourceMappingURL=chunk-73A5TGBC.js.map

package/dist/chunk-73A5TGBC.js.map

@@ -0,0 +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"]}

package/dist/chunk-7JUX4ADQ.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+// src/paths.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { dirname, isAbsolute, join, resolve } from "path";
+function getGlobalAlmanacDir() {
+  return join(homedir(), ".almanac");
+}
+function getRegistryPath() {
+  return join(getGlobalAlmanacDir(), "registry.json");
+}
+function getRepoAlmanacDir(cwd) {
+  return join(cwd, ".almanac");
+}
+function findNearestAlmanacDir(startDir) {
+  const globalDir = getGlobalAlmanacDir();
+  let current = isAbsolute(startDir) ? startDir : resolve(startDir);
+  while (true) {
+    const candidate = join(current, ".almanac");
+    if (candidate !== globalDir && existsSync(candidate)) {
+      return current;
+    }
+    const parent = dirname(current);
+    if (parent === current) {
+      return null;
+    }
+    current = parent;
+  }
+}
+
+export {
+  getGlobalAlmanacDir,
+  getRegistryPath,
+  getRepoAlmanacDir,
+  findNearestAlmanacDir
+};
+//# sourceMappingURL=chunk-7JUX4ADQ.js.map

package/dist/chunk-7JUX4ADQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/paths.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, isAbsolute, join, resolve } from \"node:path\";\n\n/**\n * Absolute path to the user-level `~/.almanac/` directory.\n *\n * All global state (the registry, future global config) lives here, not in\n * the repo. We resolve this via `os.homedir()` rather than `$HOME` so the\n * CLI behaves the same on macOS, Linux, and Windows.\n */\nexport function getGlobalAlmanacDir(): string {\n  return join(homedir(), \".almanac\");\n}\n\n/**\n * Absolute path to the global registry file.\n *\n * The registry is the single source of truth for \"which wikis exist on this\n * machine.\" It is intentionally stored outside any repo so it survives\n * branch switches, clones, and repo deletions.\n */\nexport function getRegistryPath(): string {\n  return join(getGlobalAlmanacDir(), \"registry.json\");\n}\n\n/**\n * Repo-level `.almanac/` path for a given working directory (not resolved —\n * just `join(cwd, \".almanac\")`). Use `findNearestAlmanacDir` when you need\n * to walk upward like git does.\n */\nexport function getRepoAlmanacDir(cwd: string): string {\n  return join(cwd, \".almanac\");\n}\n\n/**\n * Walk upward from `startDir` looking for a directory that contains\n * `.almanac/`. Returns the absolute path to the repo root (the directory\n * containing `.almanac/`), or `null` if none is found before hitting the\n * filesystem root.\n *\n * Mirrors how `git` locates the enclosing repository. This lets `almanac`\n * work from any subdirectory inside a repo, not just the root.\n *\n * We explicitly skip the global `~/.almanac/` directory. It shares the\n * `.almanac` name with the per-repo wiki dir, but it's not a wiki — it\n * only holds the registry and global state. If the user runs `almanac\n * init` anywhere inside their home directory (outside a real wiki), we\n * must NOT treat `~` as an enclosing wiki root. Otherwise init would try\n * to register the home dir itself as a wiki.\n */\nexport function findNearestAlmanacDir(startDir: string): string | null {\n  const globalDir = getGlobalAlmanacDir();\n  let current = isAbsolute(startDir) ? startDir : resolve(startDir);\n\n  // Walk until we hit the filesystem root. `dirname(\"/\")` returns `\"/\"`,\n  // so the loop terminates when we stop ascending.\n  while (true) {\n    const candidate = join(current, \".almanac\");\n    if (candidate !== globalDir && existsSync(candidate)) {\n      return current;\n    }\n    const parent = dirname(current);\n    if (parent === current) {\n      return null;\n    }\n    current = parent;\n  }\n}\n"],"mappings":";;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AACxB,SAAS,SAAS,YAAY,MAAM,eAAe;AAS5C,SAAS,sBAA8B;AAC5C,SAAO,KAAK,QAAQ,GAAG,UAAU;AACnC;AASO,SAAS,kBAA0B;AACxC,SAAO,KAAK,oBAAoB,GAAG,eAAe;AACpD;AAOO,SAAS,kBAAkB,KAAqB;AACrD,SAAO,KAAK,KAAK,UAAU;AAC7B;AAkBO,SAAS,sBAAsB,UAAiC;AACrE,QAAM,YAAY,oBAAoB;AACtC,MAAI,UAAU,WAAW,QAAQ,IAAI,WAAW,QAAQ,QAAQ;AAIhE,SAAO,MAAM;AACX,UAAM,YAAY,KAAK,SAAS,UAAU;AAC1C,QAAI,cAAc,aAAa,WAAW,SAAS,GAAG;AACpD,aAAO;AAAA,IACT;AACA,UAAM,SAAS,QAAQ,OAAO;AAC9B,QAAI,WAAW,SAAS;AACtB,aAAO;AAAA,IACT;AACA,cAAU;AAAA,EACZ;AACF;","names":[]}