codealmanac 0.1.5 → 0.1.7

package/dist/chunk-H6WU6PYH.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-2JJTTN7P.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-H6WU6PYH.js.map

package/dist/chunk-H6WU6PYH.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-P3LDTCLB.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+// src/cli/helpers.ts
+function emit(result) {
+  if (result.stderr.length > 0) process.stderr.write(result.stderr);
+  if (result.stdout.length > 0) process.stdout.write(result.stdout);
+  if (result.exitCode !== 0) process.exitCode = result.exitCode;
+}
+function collectOption(value, previous) {
+  return [...previous, value];
+}
+function parsePositiveInt(value) {
+  const n = Number.parseInt(value, 10);
+  if (!Number.isFinite(n) || n < 0) {
+    throw new Error(`invalid --limit "${value}" (expected a non-negative integer)`);
+  }
+  return n;
+}
+async function readStdin() {
+  if (process.stdin.isTTY === true) return "";
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+export {
+  emit,
+  collectOption,
+  parsePositiveInt,
+  readStdin
+};
+//# sourceMappingURL=chunk-P3LDTCLB.js.map

package/dist/chunk-P3LDTCLB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/helpers.ts"],"sourcesContent":["export interface CommandResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\nexport function emit(result: CommandResult): void {\n  if (result.stderr.length > 0) process.stderr.write(result.stderr);\n  if (result.stdout.length > 0) process.stdout.write(result.stdout);\n  if (result.exitCode !== 0) process.exitCode = result.exitCode;\n}\n\nexport function collectOption(value: string, previous: string[]): string[] {\n  return [...previous, value];\n}\n\nexport function parsePositiveInt(value: string): number {\n  const n = Number.parseInt(value, 10);\n  if (!Number.isFinite(n) || n < 0) {\n    throw new Error(`invalid --limit \"${value}\" (expected a non-negative integer)`);\n  }\n  return n;\n}\n\nexport async function readStdin(): Promise<string> {\n  if (process.stdin.isTTY === true) return \"\";\n  const chunks: Buffer[] = [];\n  for await (const chunk of process.stdin) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n  }\n  return Buffer.concat(chunks).toString(\"utf8\");\n}\n"],"mappings":";;;AAMO,SAAS,KAAK,QAA6B;AAChD,MAAI,OAAO,OAAO,SAAS,EAAG,SAAQ,OAAO,MAAM,OAAO,MAAM;AAChE,MAAI,OAAO,OAAO,SAAS,EAAG,SAAQ,OAAO,MAAM,OAAO,MAAM;AAChE,MAAI,OAAO,aAAa,EAAG,SAAQ,WAAW,OAAO;AACvD;AAEO,SAAS,cAAc,OAAe,UAA8B;AACzE,SAAO,CAAC,GAAG,UAAU,KAAK;AAC5B;AAEO,SAAS,iBAAiB,OAAuB;AACtD,QAAM,IAAI,OAAO,SAAS,OAAO,EAAE;AACnC,MAAI,CAAC,OAAO,SAAS,CAAC,KAAK,IAAI,GAAG;AAChC,UAAM,IAAI,MAAM,oBAAoB,KAAK,qCAAqC;AAAA,EAChF;AACA,SAAO;AACT;AAEA,eAAsB,YAA6B;AACjD,MAAI,QAAQ,MAAM,UAAU,KAAM,QAAO;AACzC,QAAM,SAAmB,CAAC;AAC1B,mBAAiB,SAAS,QAAQ,OAAO;AACvC,WAAO,KAAK,OAAO,SAAS,KAAK,IAAI,QAAQ,OAAO,KAAK,KAAK,CAAC;AAAA,EACjE;AACA,SAAO,OAAO,OAAO,MAAM,EAAE,SAAS,MAAM;AAC9C;","names":[]}

package/dist/chunk-QHQ6YH7U.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import {
+  checkForUpdate,
+  getConfigPath,
+  getStatePath
+} from "./chunk-AXFPUHBN.js";
+
+// src/update/schedule.ts
+import { spawn } from "child_process";
+import { readFileSync } from "fs";
+function scheduleBackgroundUpdateCheck(argv) {
+  if (!shouldSchedule(argv)) return;
+  const scriptPath = argv[1];
+  const nodeBin = process.execPath;
+  if (scriptPath === void 0 || scriptPath.length === 0) return;
+  try {
+    const child = spawn(
+      nodeBin,
+      [scriptPath, "--internal-check-updates"],
+      {
+        detached: true,
+        stdio: "ignore"
+        // Windows: with `detached: true` and no `stdio`, Node opens a
+        // console window — `"ignore"` prevents that.
+      }
+    );
+    child.unref();
+    child.on("error", () => {
+    });
+  } catch {
+  }
+}
+function shouldSchedule(argv) {
+  if (process.env.CODEALMANAC_SKIP_UPDATE_CHECK === "1") return false;
+  if (process.env.NODE_ENV === "test") return false;
+  if (process.env.VITEST !== void 0) return false;
+  if (argv.slice(2).includes("--internal-check-updates")) return false;
+  if (!notifierEnabled()) return false;
+  return true;
+}
+function notifierEnabled() {
+  try {
+    const raw = readFileSync(getConfigPath(), "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed.update_notifier === false) return false;
+    return true;
+  } catch {
+    return true;
+  }
+}
+async function runInternalUpdateCheck() {
+  try {
+    await checkForUpdate({});
+  } catch {
+  }
+}
+function readStateForDoctor(path) {
+  const file = path ?? getStatePath();
+  try {
+    const raw = readFileSync(file, "utf8");
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) return null;
+    const parsed = JSON.parse(trimmed);
+    return {
+      last_check_at: typeof parsed.last_check_at === "number" ? parsed.last_check_at : 0,
+      installed_version: typeof parsed.installed_version === "string" ? parsed.installed_version : "",
+      latest_version: typeof parsed.latest_version === "string" ? parsed.latest_version : "",
+      dismissed_versions: Array.isArray(parsed.dismissed_versions) ? parsed.dismissed_versions.filter((v) => typeof v === "string") : [],
+      last_fetch_failed_at: typeof parsed.last_fetch_failed_at === "number" ? parsed.last_fetch_failed_at : void 0
+    };
+  } catch {
+    return null;
+  }
+}
+
+export {
+  scheduleBackgroundUpdateCheck,
+  runInternalUpdateCheck,
+  readStateForDoctor
+};
+//# sourceMappingURL=chunk-QHQ6YH7U.js.map

package/dist/chunk-QHQ6YH7U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/update/schedule.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\n\nimport { checkForUpdate } from \"./check.js\";\nimport { getConfigPath } from \"./config.js\";\nimport { getStatePath, type UpdateState } from \"./state.js\";\n\n/**\n * Post-command scheduler for the background update check.\n *\n * After any normal `almanac <command>` exits, we want a fresh check to\n * have happened by the next invocation. We achieve that by spawning a\n * detached copy of ourselves with the hidden `--internal-check-updates`\n * flag; that child does nothing but hit the registry and write\n * `~/.almanac/update-state.json`, then exits.\n *\n * Why detach rather than check inline:\n *   - 3s network timeout in the foreground would feel sluggish on every\n *     command.\n *   - `npm test` and CI scripts shouldn't pay for a registry round-trip\n *     (gated below via env).\n *   - A detached child with `stdio: \"ignore\"` cannot leak output into\n *     the parent's stdout/stderr — critical for pipelines.\n *\n * Hazards we accept:\n *   - A Claude Code subprocess whose parent shell exits right after the\n *     `almanac` call may kill the child before it finishes. That's\n *     fine: a failed check just means we try again next invocation.\n *   - Detached child survival on Windows isn't as robust as on Unix.\n *     Same fallback: next invocation retries.\n */\n\nexport function scheduleBackgroundUpdateCheck(argv: string[]): void {\n  if (!shouldSchedule(argv)) return;\n\n  const scriptPath = argv[1];\n  const nodeBin = process.execPath;\n  if (scriptPath === undefined || scriptPath.length === 0) return;\n\n  // Spawn with the current Node and the same script path. `detached:\n  // true` + `stdio: \"ignore\"` + `unref()` detaches the child from our\n  // event loop so the parent can exit independently.\n  try {\n    const child = spawn(\n      nodeBin,\n      [scriptPath, \"--internal-check-updates\"],\n      {\n        detached: true,\n        stdio: \"ignore\",\n        // Windows: with `detached: true` and no `stdio`, Node opens a\n        // console window — `\"ignore\"` prevents that.\n      },\n    );\n    child.unref();\n    // Swallow any synchronous spawn errors (e.g. ENOENT in strange\n    // installs) — never propagate to the foreground command.\n    child.on(\"error\", () => {});\n  } catch {\n    // Last-resort swallow: background checks are best-effort.\n  }\n}\n\n/**\n * Should we spawn the worker at all?\n *\n *   - Respect the `update_notifier` config — no banner means no need\n *     for the data that feeds it.\n *   - Skip in test environments so `npm test` doesn't fork 300 copies\n *     of itself into the background and hammer the registry.\n *   - Skip on the worker invocation itself (prevents a fork bomb).\n *   - Skip when the user doesn't own the install path (permission\n *     weirdness) — detected by `~/.almanac` mkdir failing; simplest\n *     to just rely on the worker's own error handling, so we don't\n *     gate here.\n *   - Skip when the argv contains `--help`/`--version`/nothing — these\n *     commands are often run from scripts that care about clean exit;\n *     though the inline banner still shows, we don't kick off a check.\n */\nfunction shouldSchedule(argv: string[]): boolean {\n  if (process.env.CODEALMANAC_SKIP_UPDATE_CHECK === \"1\") return false;\n  if (process.env.NODE_ENV === \"test\") return false;\n  if (process.env.VITEST !== undefined) return false;\n\n  // Already the worker. argv[2..] contains the internal flag.\n  if (argv.slice(2).includes(\"--internal-check-updates\")) return false;\n\n  if (!notifierEnabled()) return false;\n\n  return true;\n}\n\nfunction notifierEnabled(): boolean {\n  try {\n    const raw = readFileSync(getConfigPath(), \"utf8\");\n    const parsed = JSON.parse(raw) as { update_notifier?: unknown };\n    if (parsed.update_notifier === false) return false;\n    return true;\n  } catch {\n    return true; // missing / malformed → default-on\n  }\n}\n\n/**\n * The worker body. Invoked when `--internal-check-updates` appears on\n * the argv. Must be fast and must never print: the parent spawned us\n * with `stdio: \"ignore\"` but a stray write could still surprise a\n * downstream debugger.\n *\n * We take a simple file lock at `~/.almanac/.update-check.lock` to\n * prevent two workers running at the same time (which could happen if\n * the user fires several commands in parallel). The lock is just the\n * existence of the file with our PID inside; if an existing lock is\n * stale (older than the 3s + cache-write budget), we steal it.\n */\nexport async function runInternalUpdateCheck(): Promise<void> {\n  // The worker is intentionally minimal. Any error (network, fs,\n  // JSON) is handled inside `checkForUpdate` and surfaces as a\n  // swallowed return; we just need to await it and exit.\n  try {\n    await checkForUpdate({});\n  } catch {\n    // Defense-in-depth: nothing must escape the worker.\n  }\n}\n\n/**\n * Read the current state snapshot for diagnostic surfaces (doctor, the\n * `update --check` command). Wraps the sync read so callers can grab\n * state without the `async readState` ceremony.\n */\nexport function readStateForDoctor(path?: string): UpdateState | null {\n  const file = path ?? getStatePath();\n  try {\n    const raw = readFileSync(file, \"utf8\");\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) return null;\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((v): v is string => typeof v === \"string\")\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 null;\n  }\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,aAAa;AACtB,SAAS,oBAAoB;AA+BtB,SAAS,8BAA8B,MAAsB;AAClE,MAAI,CAAC,eAAe,IAAI,EAAG;AAE3B,QAAM,aAAa,KAAK,CAAC;AACzB,QAAM,UAAU,QAAQ;AACxB,MAAI,eAAe,UAAa,WAAW,WAAW,EAAG;AAKzD,MAAI;AACF,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA,CAAC,YAAY,0BAA0B;AAAA,MACvC;AAAA,QACE,UAAU;AAAA,QACV,OAAO;AAAA;AAAA;AAAA,MAGT;AAAA,IACF;AACA,UAAM,MAAM;AAGZ,UAAM,GAAG,SAAS,MAAM;AAAA,IAAC,CAAC;AAAA,EAC5B,QAAQ;AAAA,EAER;AACF;AAkBA,SAAS,eAAe,MAAyB;AAC/C,MAAI,QAAQ,IAAI,kCAAkC,IAAK,QAAO;AAC9D,MAAI,QAAQ,IAAI,aAAa,OAAQ,QAAO;AAC5C,MAAI,QAAQ,IAAI,WAAW,OAAW,QAAO;AAG7C,MAAI,KAAK,MAAM,CAAC,EAAE,SAAS,0BAA0B,EAAG,QAAO;AAE/D,MAAI,CAAC,gBAAgB,EAAG,QAAO;AAE/B,SAAO;AACT;AAEA,SAAS,kBAA2B;AAClC,MAAI;AACF,UAAM,MAAM,aAAa,cAAc,GAAG,MAAM;AAChD,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QAAI,OAAO,oBAAoB,MAAO,QAAO;AAC7C,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAcA,eAAsB,yBAAwC;AAI5D,MAAI;AACF,UAAM,eAAe,CAAC,CAAC;AAAA,EACzB,QAAQ;AAAA,EAER;AACF;AAOO,SAAS,mBAAmB,MAAmC;AACpE,QAAM,OAAO,QAAQ,aAAa;AAClC,MAAI;AACF,UAAM,MAAM,aAAa,MAAM,MAAM;AACrC,UAAM,UAAU,IAAI,KAAK;AACzB,QAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,UAAM,SAAS,KAAK,MAAM,OAAO;AACjC,WAAO;AAAA,MACL,eACE,OAAO,OAAO,kBAAkB,WAAW,OAAO,gBAAgB;AAAA,MACpE,mBACE,OAAO,OAAO,sBAAsB,WAChC,OAAO,oBACP;AAAA,MACN,gBACE,OAAO,OAAO,mBAAmB,WAAW,OAAO,iBAAiB;AAAA,MACtE,oBAAoB,MAAM,QAAQ,OAAO,kBAAkB,IACvD,OAAO,mBAAmB,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IAC1E,CAAC;AAAA,MACL,sBACE,OAAO,OAAO,yBAAyB,WACnC,OAAO,uBACP;AAAA,IACR;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}