codealmanac 0.1.7 → 0.1.9

package/dist/{uninstall-NBEZNNKM.js → uninstall-HE2Z2LN2.js}

@@ -2,11 +2,11 @@
 import {
   removeImportLine,
   runUninstall
-} from "./chunk-A6PUCAVJ.js";
-import "./chunk-2JJTTN7P.js";
+} from "./chunk-BJVZLP6O.js";
+import "./chunk-3LC55TG6.js";
 import "./chunk-Z4MWLVS2.js";
 export {
   removeImportLine,
   runUninstall
 };
-//# sourceMappingURL=uninstall-NBEZNNKM.js.map
+//# sourceMappingURL=uninstall-HE2Z2LN2.js.map

package/dist/{wiki-EHZ7LG7R.js → wiki-IPSRRGOT.js}

@@ -140,23 +140,22 @@ function describeLastCapture(almanacDir, nowFn) {
       message: "last capture: never"
     };
   }
-  let entries;
-  try {
-    entries = readdirSync(almanacDir);
-  } catch {
-    return {
-      status: "info",
-      key: "wiki.capture",
-      message: "last capture: unknown"
-    };
-  }
-  const captures = entries.filter(
-    (e) => e.startsWith(".capture-") && (e.endsWith(".log") || e.endsWith(".jsonl"))
-  ).map((e) => {
+  const logDirs = [path.join(almanacDir, "logs"), almanacDir];
+  const captures = logDirs.flatMap((dir) => {
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return [];
+    }
+    return entries.filter(
+      (e) => e.startsWith(".capture-") && (e.endsWith(".log") || e.endsWith(".jsonl"))
+    ).map((e) => ({ dir, name: e }));
+  }).map((e) => {
     try {
       return {
-        name: e,
-        mtime: statSync(path.join(almanacDir, e)).mtimeMs
+        name: e.name,
+        mtime: statSync(path.join(e.dir, e.name)).mtimeMs
       };
     } catch {
       return null;
@@ -235,4 +234,4 @@ function countHealthProblems(jsonStdout) {
 export {
   gatherWikiChecks
 };
-//# sourceMappingURL=wiki-EHZ7LG7R.js.map
+//# sourceMappingURL=wiki-IPSRRGOT.js.map

package/dist/wiki-IPSRRGOT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/doctor-checks/wiki.ts"],"sourcesContent":["import { existsSync, readdirSync, statSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport type Database from \"better-sqlite3\";\n\nimport { ensureFreshIndex } from \"../../indexer/index.js\";\nimport { openIndex } from \"../../indexer/schema.js\";\nimport { findNearestAlmanacDir } from \"../../paths.js\";\nimport { findEntry } from \"../../registry/index.js\";\nimport { runHealth, type HealthReport } from \"../health.js\";\nimport { formatDuration } from \"./duration.js\";\nimport type { Check, DoctorOptions } from \"./types.js\";\n\nexport async function gatherWikiChecks(options: DoctorOptions): Promise<Check[]> {\n  const checks: Check[] = [];\n  const repoRoot = findNearestAlmanacDir(options.cwd);\n\n  if (repoRoot === null) {\n    checks.push({\n      status: \"info\",\n      key: \"wiki.none\",\n      message: \"No wiki in current directory\",\n      fix: \"run: almanac bootstrap  (to create one in this repo)\",\n    });\n    return checks;\n  }\n\n  checks.push({\n    status: \"info\",\n    key: \"wiki.repo\",\n    message: `repo: ${repoRoot}`,\n  });\n\n  try {\n    await ensureFreshIndex({ repoRoot });\n  } catch {\n    // non-fatal: counts below and the health probe report any real issue.\n  }\n\n  checks.push(await describeRegistry(repoRoot));\n\n  const almanacDir = path.join(repoRoot, \".almanac\");\n  const dbPath = path.join(almanacDir, \"index.db\");\n  checks.push(...describeCounts(dbPath));\n  checks.push(describeIndexFreshness(dbPath));\n  checks.push(describeLastCapture(almanacDir, options.now));\n  checks.push(await describeHealth(repoRoot, options));\n\n  return checks;\n}\n\nasync function describeRegistry(repoRoot: string): Promise<Check> {\n  try {\n    const entry = await findEntry({ path: repoRoot });\n    if (entry !== null) {\n      return {\n        status: \"ok\",\n        key: \"wiki.registered\",\n        message: `registered as '${entry.name}'`,\n      };\n    }\n    return {\n      status: \"info\",\n      key: \"wiki.registered\",\n      message: \"not yet registered (will register on first command)\",\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"problem\",\n      key: \"wiki.registered\",\n      message: `could not read registry: ${msg}`,\n      fix: \"inspect ~/.almanac/registry.json; remove or fix the malformed entry\",\n    };\n  }\n}\n\nfunction describeCounts(dbPath: string): Check[] {\n  const checks: Check[] = [];\n  let pageCount: number | null = null;\n  let topicCount: number | null = null;\n\n  if (existsSync(dbPath)) {\n    try {\n      const db = openIndex(dbPath);\n      try {\n        pageCount = countRows(db, \"pages\");\n        topicCount = countRows(db, \"topics\");\n      } finally {\n        db.close();\n      }\n    } catch {\n      pageCount = null;\n    }\n  }\n\n  if (pageCount !== null) {\n    checks.push({\n      status: \"info\",\n      key: \"wiki.pages\",\n      message: `pages: ${pageCount}`,\n    });\n  }\n  if (topicCount !== null) {\n    checks.push({\n      status: \"info\",\n      key: \"wiki.topics\",\n      message: `topics: ${topicCount}`,\n    });\n  }\n\n  return checks;\n}\n\nfunction countRows(db: Database.Database, table: string): number {\n  const row = db\n    .prepare<[], { n: number }>(`SELECT COUNT(*) AS n FROM ${table}`)\n    .get();\n  return row?.n ?? 0;\n}\n\nfunction describeIndexFreshness(dbPath: string): Check {\n  if (!existsSync(dbPath)) {\n    return {\n      status: \"info\",\n      key: \"wiki.index\",\n      message: \"index: not built yet (run any query command)\",\n    };\n  }\n  try {\n    const dbMtime = statSync(dbPath).mtimeMs;\n    const age = Date.now() - dbMtime;\n    return {\n      status: \"info\",\n      key: \"wiki.index\",\n      message: `index: rebuilt ${formatDuration(age)} ago`,\n    };\n  } catch {\n    return {\n      status: \"info\",\n      key: \"wiki.index\",\n      message: \"index: present\",\n    };\n  }\n}\n\nfunction describeLastCapture(\n  almanacDir: string,\n  nowFn?: () => Date,\n): Check {\n  if (!existsSync(almanacDir)) {\n    return {\n      status: \"info\",\n      key: \"wiki.capture\",\n      message: \"last capture: never\",\n    };\n  }\n  const logDirs = [path.join(almanacDir, \"logs\"), almanacDir];\n  const captures = logDirs\n    .flatMap((dir) => {\n      let entries: string[];\n      try {\n        entries = readdirSync(dir);\n      } catch {\n        return [];\n      }\n      return entries\n        .filter(\n          (e) =>\n            e.startsWith(\".capture-\") &&\n            (e.endsWith(\".log\") || e.endsWith(\".jsonl\")),\n        )\n        .map((e) => ({ dir, name: e }));\n    })\n    .map((e) => {\n      try {\n        return {\n          name: e.name,\n          mtime: statSync(path.join(e.dir, e.name)).mtimeMs,\n        };\n      } catch {\n        return null;\n      }\n    })\n    .filter((e): e is { name: string; mtime: number } => e !== null);\n  if (captures.length === 0) {\n    return {\n      status: \"info\",\n      key: \"wiki.capture\",\n      message: \"last capture: never\",\n    };\n  }\n  captures.sort((a, b) => b.mtime - a.mtime);\n  const latest = captures[0]!;\n  const now = (nowFn?.() ?? new Date()).getTime();\n  const age = now - latest.mtime;\n  return {\n    status: \"info\",\n    key: \"wiki.capture\",\n    message: `last capture: ${formatDuration(age)} ago (${latest.name})`,\n  };\n}\n\nasync function describeHealth(\n  repoRoot: string,\n  options: DoctorOptions,\n): Promise<Check> {\n  const healthFn = options.runHealthFn ?? runHealth;\n  try {\n    const healthRes = await healthFn({\n      cwd: repoRoot,\n      json: true,\n    });\n    const problems = countHealthProblems(healthRes.stdout);\n    if (problems === 0) {\n      return {\n        status: \"ok\",\n        key: \"wiki.health\",\n        message: \"almanac health reports 0 problems\",\n      };\n    }\n    return {\n      status: \"problem\",\n      key: \"wiki.health\",\n      message: `almanac health reports ${problems} problem${problems === 1 ? \"\" : \"s\"}`,\n      fix: \"run: almanac health\",\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"info\",\n      key: \"wiki.health\",\n      message: `could not run almanac health: ${msg}`,\n    };\n  }\n}\n\nconst HEALTH_PROBLEM_KEYS: (keyof HealthReport)[] = [\n  \"orphans\",\n  \"stale\",\n  \"dead_refs\",\n  \"broken_links\",\n  \"broken_xwiki\",\n  \"empty_topics\",\n  \"empty_pages\",\n  \"slug_collisions\",\n];\n\nfunction countHealthProblems(jsonStdout: string): number {\n  try {\n    const report = JSON.parse(jsonStdout) as Partial<HealthReport>;\n    let total = 0;\n    for (const key of HEALTH_PROBLEM_KEYS) {\n      const arr = report[key];\n      if (Array.isArray(arr)) total += arr.length;\n    }\n    return total;\n  } catch {\n    return 0;\n  }\n}\n"],"mappings":"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","names":[]}

package/guides/mini.md

@@ -210,9 +210,9 @@ Empty stdout plus `# 0 results` on stderr means the query ran and genuinely matc
 ```bash
 almanac doctor              # install.hook: ok/problem, wiki.capture: last capture age
 almanac hook status         # just the hook entry
-ls -lah .almanac/.capture-*.log
+ls -lah .almanac/logs/.capture-*.log
 ```
-No logs at all → the hook isn't installed, or bailed before backgrounding, or `cwd` was outside any wiki (silent correct no-op). Capture ran but wrote nothing → the reviewer rejected the draft for notability, or the session was pure-read. Check the `.capture-<id>.log` for the writer/reviewer transcript.
+No logs at all → the hook isn't installed, or bailed before backgrounding, or `cwd` was outside any wiki (silent correct no-op). Capture ran but wrote nothing → the reviewer rejected the draft for notability, or the session was pure-read. Check `.almanac/logs/.capture-<id>.log` for the writer/reviewer transcript.
 
 ---
 

package/guides/reference.md

@@ -117,7 +117,7 @@ All topic subcommands accept `--wiki <name>`. `list` / `show` accept `--json`.
 
 #### `almanac bootstrap`
 
-Spawns an agent to create initial wiki stubs. Requires `ANTHROPIC_API_KEY` or a logged-in Claude subscription. `--quiet` suppresses per-tool streaming. `--model <model>` overrides the model. `--force` overwrites an existing populated wiki. Writes `.almanac/.bootstrap-<timestamp>.log`.
+Spawns an agent to create initial wiki stubs. Requires `ANTHROPIC_API_KEY` or a logged-in Claude subscription. `--quiet` suppresses per-tool streaming. `--model <model>` overrides the model. `--force` overwrites an existing populated wiki. Writes `.almanac/logs/.bootstrap-<timestamp>.log`.
 
 Bootstrap is the scaffolding path — it creates `.almanac/pages/`, `.almanac/topics.yaml`, `.almanac/README.md`, and stub entity pages based on what the agent reads in the repo.
 
@@ -132,7 +132,7 @@ Run the writer/reviewer pipeline on a Claude Code session transcript. Usually au
 | `--quiet` | Suppress per-tool streaming; print only the final summary. |
 | `--model <model>` | Override the agent model. |
 
-Writes SDK transcript to `.almanac/.capture-<session-id>.jsonl` (one JSON message per line). When invoked manually without `--session`, falls back to `.capture-<timestamp>.jsonl` so repeated runs don't clobber each other. A writer subagent drafts pages; a reviewer subagent enforces notability + writing conventions (§9) before drafts land.
+Writes SDK transcript to `.almanac/logs/.capture-<session-id>.jsonl` (one JSON message per line). When invoked manually without `--session`, falls back to `.capture-<timestamp>.jsonl` so repeated runs don't clobber each other. A writer subagent drafts pages; a reviewer subagent enforces notability + writing conventions (§9) before drafts land.
 
 #### `almanac hook install | uninstall | status`
 
@@ -455,7 +455,7 @@ Claude Code invokes `SessionEnd` hooks after each session. Payload on stdin:
 
 1. Parse payload with `jq`. Missing `jq` → exit 0 silently.
 2. Walk upward from `cwd` for a `.almanac/`. Bounded at filesystem root.
-3. Background `almanac capture "$TRANSCRIPT" --session "$SESSION_ID" --quiet`, redirect to `.almanac/.capture-$SESSION_ID.log`, `disown`.
+3. Background `almanac capture "$TRANSCRIPT" --session "$SESSION_ID" --quiet`, redirect to `.almanac/logs/.capture-$SESSION_ID.log`, `disown`.
 4. Exit always `0`. Capture failures must never break Claude Code's session-end path.
 
 Falls back to `npx --no-install codealmanac` if `almanac` isn't on `PATH`.
@@ -482,7 +482,7 @@ Falls back to `npx --no-install codealmanac` if `almanac` isn't on `PATH`.
 ```bash
 almanac doctor              # catch-all — reports hook state + last capture age
 almanac hook status         # just the hook entry
-ls -lah .almanac/.capture-*.log
+ls -lah .almanac/logs/.capture-*.log
 ```
 
 Installed but no log: `SessionEnd` didn't fire (rare, hard crash), or script bailed before backgrounding (add `set -x` to trace), or no `.almanac/` upward from `cwd` (silent correct no-op).
@@ -490,7 +490,7 @@ Installed but no log: `SessionEnd` didn't fire (rare, hard crash), or script bai
 ### Diagnosing "capture ran but wrote nothing"
 
 ```bash
-tail -200 .almanac/.capture-<id>.log
+tail -200 .almanac/logs/.capture-<id>.log
 ```
 
 Common causes:
@@ -678,7 +678,7 @@ Missing `files:` frontmatter, OR path referenced only in inline prose (not via `
 almanac doctor              # reports hook state + last capture age + auth
 claude auth status          # OAuth token present?
 echo "${ANTHROPIC_API_KEY:0:10}"   # API key fallback?
-ls -lah .almanac/.capture-*.log
+ls -lah .almanac/logs/.capture-*.log
 ```
 
 No logs at all → script bailed pre-background. Add `set -x` to `hooks/almanac-capture.sh` to trace. If the hook itself isn't installed, `almanac doctor` reports `install.hook: problem` with `run: almanac setup --yes`.
@@ -693,9 +693,9 @@ Case sensitivity on Linux. Schema v2 stores `original_path` for case-preserving
 
 ### Forensics files
 
-- `.almanac/.capture-<session-id>.jsonl` — SDK message stream from `almanac capture` (one JSON object per line). Writer + reviewer interleaved.
-- `.almanac/.capture-<session-id>.log` — companion sidecar written by the SessionEnd hook: stdout+stderr of `almanac capture`, human-readable. Present only for hook-invoked captures; manual invocations emit only the `.jsonl`.
-- `.almanac/.bootstrap-<timestamp>.log` — one per bootstrap. Gitignored by default.
+- `.almanac/logs/.capture-<session-id>.jsonl` — SDK message stream from `almanac capture` (one JSON object per line). Writer + reviewer interleaved.
+- `.almanac/logs/.capture-<session-id>.log` — companion sidecar written by the SessionEnd hook: stdout+stderr of `almanac capture`, human-readable. Present only for hook-invoked captures; manual invocations emit only the `.jsonl`.
+- `.almanac/logs/.bootstrap-<timestamp>.log` — one per bootstrap. Gitignored by default.
 
 ---
 

package/hooks/almanac-capture.sh

@@ -13,6 +13,13 @@
 
 set -u
 
+# CodeAlmanac's own bootstrap/capture agents run Claude Code internally.
+# Their SessionEnd events must not trigger another capture, or one capture
+# can become an unbounded capture chain.
+if [ "${CODEALMANAC_INTERNAL_SESSION:-}" = "1" ]; then
+  exit 0
+fi
+
 # Be forgiving: if jq is missing, we can't parse the payload, so no-op.
 if ! command -v jq >/dev/null 2>&1; then
   exit 0
@@ -33,7 +40,8 @@ CWD=$(echo "$INPUT" | jq -r '.cwd // empty')
 DIR="$CWD"
 while [ "$DIR" != "/" ] && [ -n "$DIR" ]; do
   if [ -d "$DIR/.almanac" ]; then
-    LOG_DIR="$DIR/.almanac"
+    LOG_DIR="$DIR/.almanac/logs"
+    mkdir -p "$LOG_DIR" || exit 0
     # Prefer `almanac` on PATH; fall back to `npx codealmanac` if the
     # binary isn't linked (happens with non-global installs).
     if command -v almanac >/dev/null 2>&1; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codealmanac",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A living wiki for codebases, maintained by AI agents. Documents what the code can't say: decisions, flows, invariants, incidents, gotchas.",
   "keywords": [
     "wiki",
@@ -45,7 +45,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.2.110",
+    "@anthropic-ai/claude-agent-sdk": "^0.2.129",
     "better-sqlite3": "^12.9.0",
     "commander": "^12.1.0",
     "fast-glob": "^3.3.3",

package/dist/chunk-2JJTTN7P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/setup.ts","../src/agent/auth.ts","../src/commands/setup/install-path.ts","../src/commands/setup/next-steps.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport {\n  copyFile,\n  mkdir,\n  readFile,\n  writeFile,\n} from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  checkClaudeAuth,\n  type ClaudeAuthStatus,\n  type SpawnCliFn,\n  UNAUTHENTICATED_MESSAGE,\n} from \"../agent/auth.js\";\nimport { runHookInstall } from \"./hook.js\";\nimport {\n  detectCurrentInstallPath,\n  detectEphemeral,\n  spawnGlobalInstall,\n} from \"./setup/install-path.js\";\nimport {\n  countExistingPages,\n  printNextSteps,\n} from \"./setup/next-steps.js\";\n\n/**\n * `codealmanac setup` — the MCP-style branded TUI that runs when a user\n * invokes the bare `codealmanac` binary (or `almanac setup` / `codealmanac\n * setup` explicitly).\n *\n * Model: `mcp-ts/src/setup.ts` from openalmanac. Same ASCII banner + badge\n * + step-indicator style, same interactive + `--yes` + non-interactive\n * modes.\n *\n * Three things get installed:\n *\n *   1. The `SessionEnd` hook in `~/.claude/settings.json` (delegated to\n *      `runHookInstall` from `./hook.ts`).\n *   2. The short \"how to use codealmanac\" guide at\n *      `~/.claude/codealmanac.md`, sourced from `guides/mini.md` in the\n *      package.\n *   3. The full reference at `~/.claude/codealmanac-reference.md`,\n *      sourced from `guides/reference.md`.\n *   4. An `@~/.claude/codealmanac.md` import line in `~/.claude/CLAUDE.md`\n *      so Claude Code picks up the short guide globally.\n *\n * Everything is idempotent — running setup again is safe. `--skip-hook`\n * and `--skip-guides` opt out of the individual installs. `--yes` or a\n * non-TTY stdin skips all prompts and installs everything.\n */\n\nexport interface SetupOptions {\n  /** Install everything without prompting. */\n  yes?: boolean;\n  /** Don't install the SessionEnd hook. */\n  skipHook?: boolean;\n  /** Don't install the CLAUDE.md guides. */\n  skipGuides?: boolean;\n\n  // ─── Injection points (tests only) ────────────────────────────────\n  /** Override the subprocess spawner for `claude auth status`. */\n  spawnCli?: SpawnCliFn;\n  /** Override `~/.claude/settings.json` path. */\n  settingsPath?: string;\n  /** Override the bundled hook script path. */\n  hookScriptPath?: string;\n  /** Override the stable hooks directory for the hook script copy. */\n  stableHooksDir?: string;\n  /** Override `~/.claude/` dir for guide install. */\n  claudeDir?: string;\n  /** Override the directory containing `mini.md` / `reference.md`. */\n  guidesDir?: string;\n  /** Override interactivity; defaults to `process.stdin.isTTY`. */\n  isTTY?: boolean;\n  /** Stdout sink; defaults to `process.stdout`. */\n  stdout?: NodeJS.WritableStream;\n  /**\n   * Override the install-path probe result. When `null` the probe is\n   * bypassed (tests that don't care about the ephemeral-path step).\n   * When a string it's treated as the detected install path.\n   */\n  installPath?: string | null;\n  /**\n   * Override the npm global install spawner (tests inject a no-op to\n   * avoid actually spawning npm during CI).\n   */\n  spawnGlobalInstall?: () => Promise<void>;\n}\n\nexport interface SetupResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\n// ─── ANSI helpers ────────────────────────────────────────────────────\n\nconst RST = \"\\x1b[0m\";\nconst DIM = \"\\x1b[2m\";\nconst WHITE_BOLD = \"\\x1b[1;37m\";\nconst BLUE = \"\\x1b[38;5;75m\";\nconst ACCENT_BG = \"\\x1b[48;5;252m\\x1b[38;5;16m\";\n\nconst GRADIENT = [\n  \"\\x1b[38;5;255m\",\n  \"\\x1b[38;5;253m\",\n  \"\\x1b[38;5;251m\",\n  \"\\x1b[38;5;249m\",\n  \"\\x1b[38;5;246m\",\n  \"\\x1b[38;5;243m\",\n];\n\n// `codealmanac` 11-letter ASCII banner. Chosen for tasteful rendering —\n// same banner used in the MCP setup wizard design, retooled letters for\n// the word \"codealmanac\". Each glyph is 6 lines tall.\n//\n// If you tweak this, keep it to ≤80 visual columns wide so it fits in\n// narrow terminals (80 cols is the classic default).\nconst LOGO_LINES = [\n  \"  ___ ___  ___  ___   _   _    __  __   _   _  _   _   ___ \",\n  \" / __/ _ \\\\|   \\\\| __| /_\\\\ | |  |  \\\\/  | /_\\\\ | \\\\| | /_\\\\ / __|\",\n  \"| (_| (_) | |) | _| / _ \\\\| |__| |\\\\/| |/ _ \\\\| .` |/ _ \\\\ (__ \",\n  \" \\\\___\\\\___/|___/|___/_/ \\\\_\\\\____|_|  |_/_/ \\\\_\\\\_|\\\\_/_/ \\\\_\\\\___|\",\n  \"                                                           \",\n  \"        a living wiki for codebases, for your agent         \",\n];\n\nconst BAR = `  ${DIM}\\u2502${RST}`;\n\nfunction printBanner(out: NodeJS.WritableStream): void {\n  out.write(\"\\n\");\n  for (let i = 0; i < LOGO_LINES.length; i++) {\n    const color = GRADIENT[Math.min(i, GRADIENT.length - 1)] ?? \"\";\n    out.write(`${color}${LOGO_LINES[i]}${RST}\\n`);\n  }\n  out.write(`\\n${WHITE_BOLD}  Install the hook + agent guides${RST}\\n`);\n}\n\nfunction printBadge(out: NodeJS.WritableStream): void {\n  out.write(`\\n   ${ACCENT_BG} codealmanac ${RST}\\n\\n`);\n}\n\nfunction stepDone(out: NodeJS.WritableStream, msg: string): void {\n  out.write(`  ${BLUE}\\u25c7${RST}  ${msg}\\n`);\n}\n\nfunction stepActive(out: NodeJS.WritableStream, msg: string): void {\n  out.write(`  ${BLUE}\\u25c6${RST}  ${msg}\\n`);\n}\n\nfunction stepSkipped(out: NodeJS.WritableStream, msg: string): void {\n  out.write(`  ${DIM}\\u25cb  ${msg}${RST}\\n`);\n}\n\n// ─── Entry point ─────────────────────────────────────────────────────\n\nexport async function runSetup(\n  options: SetupOptions = {},\n): Promise<SetupResult> {\n  const out = options.stdout ?? process.stdout;\n  const isTTY =\n    options.isTTY ?? (process.stdin.isTTY === true);\n  const interactive = isTTY && options.yes !== true;\n\n  // No-op fast path. When the caller explicitly skipped every install\n  // step, rendering the full banner + step markers + \"Setup complete\"\n  // box is actively misleading — nothing was actually set up. Emit a\n  // single terse line and exit so the user gets honest feedback and\n  // piped callers (CI, scripts) don't parse through nine lines of ANSI\n  // to conclude nothing happened.\n  if (options.skipHook === true && options.skipGuides === true) {\n    out.write(\n      \"codealmanac: nothing to install — use --help to see what setup does\\n\",\n    );\n    return { stdout: \"\", stderr: \"\", exitCode: 0 };\n  }\n\n  printBanner(out);\n  printBadge(out);\n\n  // Step 1: auth status. We report what we find; we don't block. The user\n  // can still install the hook + guides without being logged in — they'll\n  // hit the auth wall on first `capture`, not on setup.\n  const auth = await safeCheckAuth(options.spawnCli);\n  reportAuth(out, auth);\n  out.write(BAR + \"\\n\");\n\n  // Step 1b: ephemeral install detection. When codealmanac was invoked via\n  // `npx codealmanac` (no prior `npm i -g`), the binary lives inside an\n  // npx cache directory or pnpm store that can be evicted at any time.\n  // `almanac` is also not on PATH, so the user can't use it after setup.\n  //\n  // When we detect an ephemeral location, we offer (or, on --yes, perform)\n  // a `npm install -g codealmanac` to make the install permanent.\n  //\n  // This is Bug #2 from codealmanac-known-bugs.md.\n  const ephem = options.installPath !== undefined\n    ? (options.installPath !== null\n        ? detectEphemeral(options.installPath)\n        : false)\n    : detectEphemeral(detectCurrentInstallPath());\n  if (ephem) {\n    let globalAction: InstallDecision = \"install\";\n    if (interactive) {\n      globalAction = await confirm(\n        out,\n        `Running from an ephemeral npx location. Install globally so 'almanac' stays on PATH?`,\n        true,\n      );\n    }\n    if (globalAction === \"install\") {\n      stepActive(out, \"Installing codealmanac globally…\");\n      try {\n        await (options.spawnGlobalInstall ?? spawnGlobalInstall)();\n        stepDone(out, \"codealmanac installed globally (almanac now on PATH)\");\n      } catch (err: unknown) {\n        const msg = err instanceof Error ? err.message : String(err);\n        stepActive(out, `Global install failed: ${msg}`);\n        out.write(\n          `  ${DIM}You can retry manually: npm install -g codealmanac${RST}\\n`,\n        );\n      }\n    } else {\n      stepSkipped(\n        out,\n        `Global install ${DIM}skipped — almanac will not be on PATH after this session${RST}`,\n      );\n    }\n    out.write(BAR + \"\\n\");\n  }\n\n  // Step 2: install the hook (default yes).\n  let hookAction: InstallDecision = \"install\";\n  if (options.skipHook === true) {\n    hookAction = \"skip\";\n  } else if (interactive) {\n    hookAction = await confirm(\n      out,\n      \"Install the SessionEnd hook so capture runs at the end of every Claude Code session?\",\n      true,\n    );\n  }\n\n  let hookResultLine = \"\";\n  if (hookAction === \"install\") {\n    const res = await runHookInstall({\n      settingsPath: options.settingsPath,\n      hookScriptPath: options.hookScriptPath,\n      stableHooksDir: options.stableHooksDir,\n    });\n    if (res.exitCode !== 0) {\n      stepActive(out, `SessionEnd hook: ${res.stderr.trim()}`);\n      return {\n        stdout: \"\",\n        stderr: res.stderr,\n        exitCode: res.exitCode,\n      };\n    }\n    hookResultLine = res.stdout.includes(\"already installed\")\n      ? `SessionEnd hook ${DIM}already installed${RST}`\n      : `SessionEnd hook installed`;\n    stepDone(out, hookResultLine);\n  } else {\n    stepSkipped(out, `SessionEnd hook ${DIM}skipped${RST}`);\n  }\n  out.write(BAR + \"\\n\");\n\n  // Step 3: install the guides.\n  let guidesAction: InstallDecision = \"install\";\n  if (options.skipGuides === true) {\n    guidesAction = \"skip\";\n  } else if (interactive) {\n    guidesAction = await confirm(\n      out,\n      \"Install the codealmanac usage guides into ~/.claude/ and import them from CLAUDE.md?\",\n      true,\n    );\n  }\n\n  let guidesSummary: string;\n  if (guidesAction === \"install\") {\n    try {\n      const summary = await installGuides({\n        claudeDir: options.claudeDir ?? path.join(homedir(), \".claude\"),\n        guidesDir: options.guidesDir ?? resolveGuidesDir(),\n      });\n      guidesSummary = summary.anyChanges\n        ? `Guides installed (${summary.filesWritten.join(\", \")})`\n        : `Guides ${DIM}already installed${RST}`;\n      stepDone(out, guidesSummary);\n    } catch (err: unknown) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return {\n        stdout: \"\",\n        stderr: `almanac: guide install failed: ${msg}\\n`,\n        exitCode: 1,\n      };\n    }\n  } else {\n    stepSkipped(out, `Guides ${DIM}skipped${RST}`);\n  }\n  out.write(BAR + \"\\n\");\n\n  stepDone(out, `${BLUE}Setup complete${RST}`);\n  out.write(\"\\n\");\n\n  // Detect whether the current working directory is inside a repo that\n  // already has a wiki with pages. This fixes Bug #6 from\n  // codealmanac-known-bugs.md: Engineer B clones a repo that already has\n  // `.almanac/pages/` (committed by Engineer A) and gets told to run\n  // `almanac bootstrap`, which is wrong — the wiki already exists.\n  const existingPageCount = countExistingPages(process.cwd());\n  printNextSteps(out, existingPageCount);\n\n  return { stdout: \"\", stderr: \"\", exitCode: 0 };\n}\n\n// ─── Auth reporting ──────────────────────────────────────────────────\n\nasync function safeCheckAuth(\n  spawnCli?: SpawnCliFn,\n): Promise<ClaudeAuthStatus> {\n  try {\n    return await checkClaudeAuth(spawnCli);\n  } catch {\n    return { loggedIn: false };\n  }\n}\n\nfunction reportAuth(\n  out: NodeJS.WritableStream,\n  auth: ClaudeAuthStatus,\n): void {\n  if (auth.loggedIn) {\n    const who = auth.email ?? \"Claude account\";\n    const plan =\n      auth.subscriptionType !== undefined\n        ? ` ${DIM}(${auth.subscriptionType})${RST}`\n        : \"\";\n    stepDone(out, `Claude auth: ${WHITE_BOLD}${who}${RST}${plan}`);\n    return;\n  }\n  if (\n    process.env.ANTHROPIC_API_KEY !== undefined &&\n    process.env.ANTHROPIC_API_KEY.length > 0\n  ) {\n    stepDone(out, `Claude auth: ${WHITE_BOLD}ANTHROPIC_API_KEY${RST} set`);\n    return;\n  }\n  // Not blocking — just report and show the two paths.\n  stepActive(out, `Claude auth: ${DIM}not signed in${RST}`);\n  for (const line of UNAUTHENTICATED_MESSAGE.split(\"\\n\")) {\n    out.write(`  ${DIM}\\u2502   ${line}${RST}\\n`);\n  }\n}\n\n// ─── Guide installation ──────────────────────────────────────────────\n\ninterface InstallGuidesOptions {\n  claudeDir: string;\n  guidesDir: string;\n}\n\ninterface InstallGuidesResult {\n  anyChanges: boolean;\n  filesWritten: string[];\n}\n\n/**\n * Copy the two guide files into `~/.claude/` and append an `@import`\n * line to `~/.claude/CLAUDE.md`. Every step is idempotent:\n *\n *   - Guide files are compared by bytes before we write. If the content\n *     matches the bundled version, we skip (so `setup` doesn't cause a\n *     spurious mtime bump on every invocation).\n *   - The import line is appended only if `CLAUDE.md` doesn't already\n *     contain the exact `@~/.claude/codealmanac.md` token on a line by\n *     itself. We don't try to parse the file — any mention of the token\n *     on a non-comment line is treated as \"already present\".\n *\n * Returns a summary the caller uses to decide whether to say \"installed\"\n * or \"already installed\" in the TUI.\n */\nasync function installGuides(\n  options: InstallGuidesOptions,\n): Promise<InstallGuidesResult> {\n  await mkdir(options.claudeDir, { recursive: true });\n\n  const srcMini = path.join(options.guidesDir, \"mini.md\");\n  const srcRef = path.join(options.guidesDir, \"reference.md\");\n  if (!existsSync(srcMini)) {\n    throw new Error(`missing bundled guide: ${srcMini}`);\n  }\n  if (!existsSync(srcRef)) {\n    throw new Error(`missing bundled guide: ${srcRef}`);\n  }\n\n  const destMini = path.join(options.claudeDir, \"codealmanac.md\");\n  const destRef = path.join(options.claudeDir, \"codealmanac-reference.md\");\n\n  const miniChanged = await copyIfChanged(srcMini, destMini);\n  const refChanged = await copyIfChanged(srcRef, destRef);\n\n  const claudeMd = path.join(options.claudeDir, \"CLAUDE.md\");\n  const importChanged = await ensureImport(claudeMd);\n\n  const filesWritten: string[] = [];\n  if (miniChanged) filesWritten.push(\"codealmanac.md\");\n  if (refChanged) filesWritten.push(\"codealmanac-reference.md\");\n  if (importChanged) filesWritten.push(\"CLAUDE.md\");\n\n  return { anyChanges: filesWritten.length > 0, filesWritten };\n}\n\nasync function copyIfChanged(src: string, dest: string): Promise<boolean> {\n  const srcBytes = await readFile(src);\n  if (existsSync(dest)) {\n    try {\n      const destBytes = await readFile(dest);\n      if (srcBytes.equals(destBytes)) return false;\n    } catch {\n      // Fall through to write.\n    }\n  }\n  await copyFile(src, dest);\n  return true;\n}\n\n/** The exact import line we manage. Changing this requires updating\n * uninstall too. */\nexport const IMPORT_LINE = \"@~/.claude/codealmanac.md\";\n\n/**\n * Append the import line to `~/.claude/CLAUDE.md` if it isn't already\n * present. Creates the file if absent. Returns true when we wrote, false\n * when the line was already there.\n *\n * We match on `@~/.claude/codealmanac.md` appearing on any non-empty\n * line (trimmed). This catches both the bare line we write and any\n * user-edited variant (comments, trailing whitespace). We deliberately\n * do NOT try to repair a user who deleted the newline — that's their\n * file to shape.\n */\nasync function ensureImport(claudeMdPath: string): Promise<boolean> {\n  let existing = \"\";\n  if (existsSync(claudeMdPath)) {\n    existing = await readFile(claudeMdPath, \"utf8\");\n  }\n  if (hasImportLine(existing)) return false;\n\n  const sep =\n    existing.length === 0 ? \"\" : existing.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n  const body = `${existing}${sep}${IMPORT_LINE}\\n`;\n  await writeFile(claudeMdPath, body, \"utf8\");\n  return true;\n}\n\nexport function hasImportLine(contents: string): boolean {\n  // Match line-starts-with-token rather than exact-line equality so a\n  // user who annotated the import line (`@~/.claude/codealmanac.md #\n  // codealmanac`) doesn't cause us to re-append a duplicate below.\n  // The trailing-character check rules out accidental matches on a\n  // longer line like `@~/.claude/codealmanac.md-extra`.\n  const lines = contents.split(/\\r?\\n/).map((l) => l.trim());\n  return 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}\n\n// ─── Interactive prompt ──────────────────────────────────────────────\n\ntype InstallDecision = \"install\" | \"skip\";\n\n/**\n * Minimal `[Y/n]` prompt. No raw mode, no cursor — just readline. The\n * MCP setup uses a fancy arrow-key TUI for multi-choice; we only have\n * binary decisions here, so a line-reader prompt is clearer and doesn't\n * fight with the step-indicator rendering above it.\n */\nfunction confirm(\n  out: NodeJS.WritableStream,\n  question: string,\n  defaultYes: boolean,\n): Promise<InstallDecision> {\n  return new Promise((resolve) => {\n    const hint = defaultYes ? \"[Y/n]\" : \"[y/N]\";\n    out.write(`  ${BLUE}\\u25c6${RST}  ${question} ${DIM}${hint}${RST} `);\n\n    let buf = \"\";\n    const onData = (chunk: Buffer): void => {\n      buf += chunk.toString(\"utf8\");\n      const nl = buf.indexOf(\"\\n\");\n      if (nl === -1) return;\n      process.stdin.removeListener(\"data\", onData);\n      process.stdin.pause();\n\n      const answer = buf.slice(0, nl).trim().toLowerCase();\n      const accepted =\n        answer.length === 0\n          ? defaultYes\n          : answer === \"y\" || answer === \"yes\";\n      resolve(accepted ? \"install\" : \"skip\");\n    };\n\n    process.stdin.resume();\n    process.stdin.on(\"data\", onData);\n  });\n}\n\n// ─── Guides path resolution ──────────────────────────────────────────\n\n/**\n * Locate `guides/` relative to the installed package. Mirrors\n * `resolvePromptsDir` from `src/agent/prompts.ts`.\n *\n * Two runtime layouts to handle:\n *\n *   1. **Bundled dist.** `dist/codealmanac.js` → walk one level up →\n *      `guides/`.\n *   2. **Source (tests / tsx).** `src/commands/setup.ts` → walk two\n *      levels up → `guides/`.\n *\n * We also try `createRequire` to resolve the package root from the\n * `codealmanac/package.json` manifest, as a belt-and-suspenders fallback\n * for unusual install layouts (monorepo hoisting, etc.). That path is\n * only exercised when the direct walk-up fails.\n */\nexport function resolveGuidesDir(): string {\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const candidates = [\n    path.resolve(here, \"..\", \"guides\"), // dist layout\n    path.resolve(here, \"..\", \"..\", \"guides\"), // src layout\n    path.resolve(here, \"..\", \"..\", \"..\", \"guides\"),\n  ];\n  for (const dir of candidates) {\n    if (looksLikeGuidesDir(dir)) return dir;\n  }\n  // Fallback: resolve via the package.json of the currently-running\n  // codealmanac. createRequire lets us ask Node's resolver rather than\n  // guessing at directory layouts.\n  try {\n    const require = createRequire(import.meta.url);\n    const pkgJson = require.resolve(\"codealmanac/package.json\");\n    const guides = path.join(path.dirname(pkgJson), \"guides\");\n    if (looksLikeGuidesDir(guides)) return guides;\n  } catch {\n    // Ignore — we'll throw with the candidate list below.\n  }\n  throw new Error(\n    \"could not locate bundled guides/ directory. Tried:\\n\" +\n      candidates.map((c) => `  - ${c}`).join(\"\\n\"),\n  );\n}\n\nfunction looksLikeGuidesDir(dir: string): boolean {\n  return existsSync(path.join(dir, \"mini.md\"));\n}\n","import { spawn, type ChildProcess } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\n\n/**\n * Claude auth gate — accepts either an active Claude subscription login\n * OR an `ANTHROPIC_API_KEY` environment variable.\n *\n * The Claude Agent SDK delegates authentication to its bundled `cli.js`,\n * which reads OAuth credentials from `~/.claude/credentials/` (the same\n * store Claude Code uses). Users who are logged in via `claude auth login\n * --claudeai` should be able to run bootstrap/capture without ever\n * exporting an API key. Conversely, users on pay-per-token API keys\n * shouldn't be required to go through the OAuth flow.\n *\n * We spawn the bundled SDK's `cli.js auth status --json` to answer \"are\n * we logged in?\" rather than poking at the credentials file directly —\n * that's the SDK's contract, and it handles all the edge cases (token\n * expiry, org switching, consoleloginpath, …) for us.\n *\n * The CLI path is resolved via `require.resolve(\"@anthropic-ai/claude-\n * agent-sdk/package.json\")` + the `cli.js` sibling. Going through\n * `createRequire` keeps this compatible with both ESM dev mode (tsx) and\n * the bundled dist (tsup externalizes the SDK, so Node's own resolver\n * does the lookup at runtime). If the SDK isn't installed at all we fall\n * back to treating the user as unauthenticated — the assert will then\n * surface the familiar two-path error so they can at least fix it via\n * `ANTHROPIC_API_KEY`.\n */\n\nexport interface ClaudeAuthStatus {\n  loggedIn: boolean;\n  email?: string;\n  subscriptionType?: string;\n  authMethod?: string;\n}\n\nexport interface SpawnedProcess {\n  stdout: { on: (event: \"data\", cb: (data: Buffer | string) => void) => void };\n  stderr: { on: (event: \"data\", cb: (data: Buffer | string) => void) => void };\n  on: (event: \"close\" | \"error\", cb: (arg: number | null | Error) => void) => void;\n  kill: (signal?: string) => void;\n}\n\n/**\n * The subprocess spawner is injectable so tests can replace it with a\n * fake that emits canned JSON without touching the filesystem. Production\n * code uses `defaultSpawnCli` which invokes the bundled SDK CLI.\n */\nexport type SpawnCliFn = (args: string[]) => SpawnedProcess;\n\nconst AUTH_TIMEOUT_MS = 10_000;\n\n/**\n * Resolve `cli.js` from the bundled `@anthropic-ai/claude-agent-sdk`\n * install. Uses `createRequire` so the lookup works regardless of\n * whether we're running from `dist/` (where tsup externalized the SDK)\n * or directly from source.\n *\n * Throws if the SDK can't be located — `checkClaudeAuth` catches this\n * and treats the user as not-logged-in, which lets the env-var path\n * still work for users with a borked install.\n */\nfunction resolveCliJsPath(): string {\n  // `import.meta.url` points at this module (dev or dist). `createRequire`\n  // from that URL can then resolve sibling packages the same way Node's\n  // own CJS resolver would.\n  //\n  // We resolve the main entry (not `./package.json`) because the SDK's\n  // `exports` field locks subpath access — `require.resolve(\".../package.json\")`\n  // fails with `ERR_PACKAGE_PATH_NOT_EXPORTED` on current SDK versions.\n  // The main entry resolves fine; `cli.js` is its sibling in the install\n  // layout the SDK has used since day one.\n  const require = createRequire(import.meta.url);\n  const entry = require.resolve(\"@anthropic-ai/claude-agent-sdk\");\n  return join(dirname(entry), \"cli.js\");\n}\n\n/**\n * Default subprocess spawner for production use — invokes the bundled\n * SDK's `cli.js` via the same Node runtime that's running codealmanac.\n * Tests inject a fake via the `spawnCli` parameter.\n */\nexport const defaultSpawnCli: SpawnCliFn = (args: string[]) => {\n  const cliPath = resolveCliJsPath();\n  // Use `process.execPath` so we inherit the Node runtime codealmanac\n  // itself is running under — avoids PATH weirdness on systems where\n  // `node` isn't on PATH but codealmanac was installed via npm.\n  const child = spawn(process.execPath, [cliPath, ...args], {\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n  return child as unknown as SpawnedProcess;\n};\n\n/**\n * Check whether the user is authenticated via Claude subscription OAuth.\n *\n * Spawns the bundled SDK CLI's `auth status --json`. On any failure\n * (spawn error, non-JSON stdout, non-zero exit, timeout) we return\n * `{ loggedIn: false }` rather than propagating the error — the caller\n * will fall back to the `ANTHROPIC_API_KEY` path and, if that's also\n * missing, produce a clean two-option error message.\n *\n * The 10s timeout guards against the CLI hanging on a broken network or\n * keychain prompt. In practice `auth status` is a cheap local read.\n */\nexport async function checkClaudeAuth(\n  spawnCli: SpawnCliFn = defaultSpawnCli,\n): Promise<ClaudeAuthStatus> {\n  let child: SpawnedProcess;\n  try {\n    child = spawnCli([\"auth\", \"status\", \"--json\"]);\n  } catch {\n    return { loggedIn: false };\n  }\n\n  return new Promise<ClaudeAuthStatus>((resolve) => {\n    let stdout = \"\";\n    let stderr = \"\";\n    let settled = false;\n\n    const settle = (value: ClaudeAuthStatus): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      resolve(value);\n    };\n\n    const timer = setTimeout(() => {\n      try {\n        child.kill(\"SIGTERM\");\n      } catch {\n        // Kill can fail if the process already exited; nothing we can do.\n      }\n      settle({ loggedIn: false });\n    }, AUTH_TIMEOUT_MS);\n\n    child.stdout.on(\"data\", (data) => {\n      stdout += data.toString();\n    });\n    child.stderr.on(\"data\", (data) => {\n      stderr += data.toString();\n    });\n\n    child.on(\"error\", () => {\n      settle({ loggedIn: false });\n    });\n\n    child.on(\"close\", (code) => {\n      // The SDK writes `{\"loggedIn\": false, ...}` to stdout with a zero\n      // exit code when the user isn't signed in, so we only reject on\n      // non-zero + empty stdout. An empty stdout with zero exit (shouldn't\n      // happen in practice) also fails safely to `loggedIn: false`.\n      if (code !== 0 && stdout.trim().length === 0) {\n        // `stderr` isn't surfaced to the user here — the caller's error\n        // message covers both auth paths — but it would be captured by\n        // `stderr` if we ever wanted to log it for debugging.\n        void stderr;\n        settle({ loggedIn: false });\n        return;\n      }\n      try {\n        const parsed = JSON.parse(stdout.trim()) as Record<string, unknown>;\n        const loggedIn = parsed.loggedIn === true;\n        const out: ClaudeAuthStatus = { loggedIn };\n        if (typeof parsed.email === \"string\") out.email = parsed.email;\n        if (typeof parsed.subscriptionType === \"string\") {\n          out.subscriptionType = parsed.subscriptionType;\n        }\n        if (typeof parsed.authMethod === \"string\") {\n          out.authMethod = parsed.authMethod;\n        }\n        settle(out);\n      } catch {\n        settle({ loggedIn: false });\n      }\n    });\n  });\n}\n\n/**\n * Human-readable error when neither auth path is available. The text is\n * deliberately verbose — users hitting this wall for the first time\n * deserve both options in front of them, not a terse hint.\n */\nexport const UNAUTHENTICATED_MESSAGE =\n  \"not authenticated to Claude.\\n\\n\" +\n  \"Option 1 — use your Claude subscription (Pro/Max):\\n\" +\n  \"  claude auth login --claudeai\\n\\n\" +\n  \"Option 2 — use a pay-per-token API key:\\n\" +\n  \"  Get one at https://console.anthropic.com\\n\" +\n  \"  export ANTHROPIC_API_KEY=sk-ant-...\\n\\n\" +\n  \"Verify with: claude auth status\";\n\n/**\n * Assert that at least one auth path is satisfied. Prefers subscription\n * auth (fewer surprises for Claude Pro/Max users) but accepts\n * `ANTHROPIC_API_KEY` as a fallback. On failure throws with\n * `code = \"CLAUDE_AUTH_MISSING\"` so callers can distinguish this from\n * other errors if they ever want to.\n *\n * Returns the resolved auth status so callers that want to display the\n * logged-in email in a preamble can do so without a second subprocess.\n */\nexport async function assertClaudeAuth(\n  spawnCli: SpawnCliFn = defaultSpawnCli,\n): Promise<ClaudeAuthStatus> {\n  const status = await checkClaudeAuth(spawnCli);\n  if (status.loggedIn) {\n    return status;\n  }\n  const apiKey = process.env.ANTHROPIC_API_KEY;\n  if (apiKey !== undefined && apiKey.length > 0) {\n    // Signal to callers that we're on the API-key path. Not \"loggedIn\"\n    // in the OAuth sense, but the SDK will pick up the env var and\n    // succeed — so we return a status that tells bootstrap/capture the\n    // gate is open.\n    return { loggedIn: true, authMethod: \"apiKey\" };\n  }\n  const err = new Error(UNAUTHENTICATED_MESSAGE);\n  (err as { code?: string }).code = \"CLAUDE_AUTH_MISSING\";\n  throw err;\n}\n\n// Internal re-export — helps keep the public type surface minimal while\n// still letting tests import the `ChildProcess` shape when needed.\nexport type { ChildProcess };\n","import { execFile } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/**\n * Return the directory of the currently-running codealmanac install by\n * walking up from this module's file to the nearest `package.json` whose\n * `name` is `codealmanac`. Returns the empty string when the walk fails.\n */\nexport function detectCurrentInstallPath(): string {\n  try {\n    const req = createRequire(import.meta.url);\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      try {\n        const raw = req(\"fs\").readFileSync(pkgPath, \"utf-8\") as string;\n        const pkg = JSON.parse(raw) as { name?: unknown };\n        if (pkg.name === \"codealmanac\") return dir;\n      } catch {\n        // keep walking\n      }\n      const parent = path.dirname(dir);\n      if (parent === dir) break;\n      dir = parent;\n    }\n  } catch {\n    // import.meta.url unavailable — not ephemeral for our purposes.\n  }\n  return \"\";\n}\n\n/**\n * Return true when the given install path looks ephemeral.\n *\n * Ephemeral locations we recognize:\n *   - `~/.npm/_npx/` — npm's npx cache (GC'd on version bumps or\n *     `npm cache clean`)\n *   - `~/.local/share/pnpm/dlx/` — pnpm's dlx (like npx) cache\n *   - `/tmp/` or `/var/folders/` — common CI / temp paths\n *\n * A global install (`~/.nvm/.../lib/node_modules/`, `/usr/local/lib/...`,\n * `~/.local/lib/node_modules/`) is NOT ephemeral.\n */\nexport function detectEphemeral(installPath: string): boolean {\n  if (installPath.length === 0) return false;\n  const home = homedir();\n  if (installPath.startsWith(path.join(home, \".npm\", \"_npx\"))) return true;\n  if (\n    installPath.startsWith(path.join(home, \".local\", \"share\", \"pnpm\", \"dlx\"))\n  ) return true;\n  if (installPath.startsWith(\"/tmp/\")) return true;\n  if (installPath.startsWith(\"/var/folders/\")) return true;\n  return false;\n}\n\n/**\n * Spawn `npm install -g codealmanac@latest` in a child process and wait\n * for it to finish. Rejects on non-zero exit or spawn error.\n */\nexport function spawnGlobalInstall(): Promise<void> {\n  return new Promise((resolve, reject) => {\n    execFile(\n      \"npm\",\n      [\"install\", \"-g\", \"codealmanac@latest\"],\n      { shell: false },\n      (err, _stdout, stderr) => {\n        if (err !== null) {\n          reject(\n            new Error(\n              stderr.length > 0\n                ? stderr.trim().split(\"\\n\")[0] ?? err.message\n                : err.message,\n            ),\n          );\n        } else {\n          resolve();\n        }\n      },\n    );\n  });\n}\n","import { existsSync, readdirSync } from \"node:fs\";\nimport path from \"node:path\";\n\nconst RST = \"\\x1b[0m\";\nconst BOLD = \"\\x1b[1m\";\nconst DIM = \"\\x1b[2m\";\nconst WHITE_BOLD = \"\\x1b[1;37m\";\nconst BLUE = \"\\x1b[38;5;75m\";\nconst BLUE_DIM = \"\\x1b[38;5;69m\";\n\n/**\n * Print the \"Next steps\" box. When `existingPageCount` is greater than 0,\n * the current working directory already has a wiki with committed pages.\n * In that case we skip the `almanac bootstrap` step and tell the user to\n * start querying.\n */\nexport function printNextSteps(\n  out: NodeJS.WritableStream,\n  existingPageCount: number,\n): void {\n  const innerW = 62;\n  const vis = (s: string): number =>\n    s.replace(/\\x1b\\[[0-9;]*m/g, \"\").length;\n  const row = (content: string): string => {\n    const padding = Math.max(0, innerW - vis(content));\n    return `  ${BLUE_DIM}\\u2502${RST}${content}${\" \".repeat(padding)}${BLUE_DIM}\\u2502${RST}\\n`;\n  };\n  const empty = row(\"\");\n\n  out.write(`  ${BLUE_DIM}\\u256d${\"─\".repeat(innerW)}\\u256e${RST}\\n`);\n  out.write(empty);\n  out.write(row(`  ${WHITE_BOLD}Next steps${RST}`));\n  out.write(empty);\n\n  if (existingPageCount > 0) {\n    out.write(\n      row(\n        `  ${BLUE}\\u25c7${RST}  This repo already has a wiki ${DIM}(${existingPageCount} page${existingPageCount === 1 ? \"\" : \"s\"})${RST}`,\n      ),\n    );\n    out.write(empty);\n    out.write(row(`  ${BLUE}1.${RST}  Start querying your wiki:`));\n    out.write(row(`       ${BOLD}almanac search --mentions <file>${RST}`));\n    out.write(\n      row(`  ${BLUE}2.${RST}  Work normally — capture runs on session end`),\n    );\n  } else {\n    out.write(\n      row(`  ${BLUE}1.${RST}  ${BOLD}cd${RST} into a repo you want to document`),\n    );\n    out.write(\n      row(\n        `  ${BLUE}2.${RST}  ${BOLD}almanac bootstrap${RST}  ${DIM}# scaffold the wiki${RST}`,\n      ),\n    );\n    out.write(\n      row(`  ${BLUE}3.${RST}  Work normally — capture runs on session end`),\n    );\n  }\n\n  out.write(empty);\n  out.write(`  ${BLUE_DIM}\\u2570${\"─\".repeat(innerW)}\\u256f${RST}\\n\\n`);\n}\n\n/**\n * Count `.md` files in `.almanac/pages/` under the current working\n * directory or any parent. Returns 0 when no wiki is found or the pages\n * directory is empty.\n */\nexport function countExistingPages(cwd: string): number {\n  try {\n    let dir = cwd;\n    for (let i = 0; i < 10; i++) {\n      const pagesDir = path.join(dir, \".almanac\", \"pages\");\n      if (existsSync(pagesDir)) {\n        try {\n          const entries = readdirSync(pagesDir);\n          return entries.filter((e) => e.endsWith(\".md\")).length;\n        } catch {\n          return 0;\n        }\n      }\n      const parent = path.dirname(dir);\n      if (parent === dir) break;\n      dir = parent;\n    }\n  } catch {\n    // Swallow — never crash setup because of this.\n  }\n  return 0;\n}\n"],"mappings":";;;;;;AAAA,SAAS,cAAAA,mBAAkB;AAC3B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAAC,sBAAqB;AAC9B,SAAS,WAAAC,gBAAe;AACxB,OAAOC,WAAU;AACjB,SAAS,iBAAAC,sBAAqB;;;ACV9B,SAAS,aAAgC;AACzC,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAiD9B,IAAM,kBAAkB;AAYxB,SAAS,mBAA2B;AAUlC,QAAMC,WAAU,cAAc,YAAY,GAAG;AAC7C,QAAM,QAAQA,SAAQ,QAAQ,gCAAgC;AAC9D,SAAO,KAAK,QAAQ,KAAK,GAAG,QAAQ;AACtC;AAOO,IAAM,kBAA8B,CAAC,SAAmB;AAC7D,QAAM,UAAU,iBAAiB;AAIjC,QAAM,QAAQ,MAAM,QAAQ,UAAU,CAAC,SAAS,GAAG,IAAI,GAAG;AAAA,IACxD,OAAO,CAAC,UAAU,QAAQ,MAAM;AAAA,EAClC,CAAC;AACD,SAAO;AACT;AAcA,eAAsB,gBACpB,WAAuB,iBACI;AAC3B,MAAI;AACJ,MAAI;AACF,YAAQ,SAAS,CAAC,QAAQ,UAAU,QAAQ,CAAC;AAAA,EAC/C,QAAQ;AACN,WAAO,EAAE,UAAU,MAAM;AAAA,EAC3B;AAEA,SAAO,IAAI,QAA0B,CAAC,YAAY;AAChD,QAAI,SAAS;AACb,QAAI,SAAS;AACb,QAAI,UAAU;AAEd,UAAM,SAAS,CAAC,UAAkC;AAChD,UAAI,QAAS;AACb,gBAAU;AACV,mBAAa,KAAK;AAClB,cAAQ,KAAK;AAAA,IACf;AAEA,UAAM,QAAQ,WAAW,MAAM;AAC7B,UAAI;AACF,cAAM,KAAK,SAAS;AAAA,MACtB,QAAQ;AAAA,MAER;AACA,aAAO,EAAE,UAAU,MAAM,CAAC;AAAA,IAC5B,GAAG,eAAe;AAElB,UAAM,OAAO,GAAG,QAAQ,CAAC,SAAS;AAChC,gBAAU,KAAK,SAAS;AAAA,IAC1B,CAAC;AACD,UAAM,OAAO,GAAG,QAAQ,CAAC,SAAS;AAChC,gBAAU,KAAK,SAAS;AAAA,IAC1B,CAAC;AAED,UAAM,GAAG,SAAS,MAAM;AACtB,aAAO,EAAE,UAAU,MAAM,CAAC;AAAA,IAC5B,CAAC;AAED,UAAM,GAAG,SAAS,CAAC,SAAS;AAK1B,UAAI,SAAS,KAAK,OAAO,KAAK,EAAE,WAAW,GAAG;AAI5C,aAAK;AACL,eAAO,EAAE,UAAU,MAAM,CAAC;AAC1B;AAAA,MACF;AACA,UAAI;AACF,cAAM,SAAS,KAAK,MAAM,OAAO,KAAK,CAAC;AACvC,cAAM,WAAW,OAAO,aAAa;AACrC,cAAM,MAAwB,EAAE,SAAS;AACzC,YAAI,OAAO,OAAO,UAAU,SAAU,KAAI,QAAQ,OAAO;AACzD,YAAI,OAAO,OAAO,qBAAqB,UAAU;AAC/C,cAAI,mBAAmB,OAAO;AAAA,QAChC;AACA,YAAI,OAAO,OAAO,eAAe,UAAU;AACzC,cAAI,aAAa,OAAO;AAAA,QAC1B;AACA,eAAO,GAAG;AAAA,MACZ,QAAQ;AACN,eAAO,EAAE,UAAU,MAAM,CAAC;AAAA,MAC5B;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;AAOO,IAAM,0BACX;AAkBF,eAAsB,iBACpB,WAAuB,iBACI;AAC3B,QAAM,SAAS,MAAM,gBAAgB,QAAQ;AAC7C,MAAI,OAAO,UAAU;AACnB,WAAO;AAAA,EACT;AACA,QAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,WAAW,UAAa,OAAO,SAAS,GAAG;AAK7C,WAAO,EAAE,UAAU,MAAM,YAAY,SAAS;AAAA,EAChD;AACA,QAAM,MAAM,IAAI,MAAM,uBAAuB;AAC7C,EAAC,IAA0B,OAAO;AAClC,QAAM;AACR;;;AC9NA,SAAS,gBAAgB;AACzB,SAAS,iBAAAC,sBAAqB;AAC9B,SAAS,eAAe;AACxB,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAOvB,SAAS,2BAAmC;AACjD,MAAI;AACF,UAAM,MAAMA,eAAc,YAAY,GAAG;AACzC,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;AACF,cAAM,MAAM,IAAI,IAAI,EAAE,aAAa,SAAS,OAAO;AACnD,cAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,YAAI,IAAI,SAAS,cAAe,QAAO;AAAA,MACzC,QAAQ;AAAA,MAER;AACA,YAAM,SAAS,KAAK,QAAQ,GAAG;AAC/B,UAAI,WAAW,IAAK;AACpB,YAAM;AAAA,IACR;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;AAcO,SAAS,gBAAgB,aAA8B;AAC5D,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,QAAM,OAAO,QAAQ;AACrB,MAAI,YAAY,WAAW,KAAK,KAAK,MAAM,QAAQ,MAAM,CAAC,EAAG,QAAO;AACpE,MACE,YAAY,WAAW,KAAK,KAAK,MAAM,UAAU,SAAS,QAAQ,KAAK,CAAC,EACxE,QAAO;AACT,MAAI,YAAY,WAAW,OAAO,EAAG,QAAO;AAC5C,MAAI,YAAY,WAAW,eAAe,EAAG,QAAO;AACpD,SAAO;AACT;AAMO,SAAS,qBAAoC;AAClD,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC;AAAA,MACE;AAAA,MACA,CAAC,WAAW,MAAM,oBAAoB;AAAA,MACtC,EAAE,OAAO,MAAM;AAAA,MACf,CAAC,KAAK,SAAS,WAAW;AACxB,YAAI,QAAQ,MAAM;AAChB;AAAA,YACE,IAAI;AAAA,cACF,OAAO,SAAS,IACZ,OAAO,KAAK,EAAE,MAAM,IAAI,EAAE,CAAC,KAAK,IAAI,UACpC,IAAI;AAAA,YACV;AAAA,UACF;AAAA,QACF,OAAO;AACL,kBAAQ;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AACH;;;ACpFA,SAAS,YAAY,mBAAmB;AACxC,OAAOC,WAAU;AAEjB,IAAM,MAAM;AACZ,IAAM,OAAO;AACb,IAAM,MAAM;AACZ,IAAM,aAAa;AACnB,IAAM,OAAO;AACb,IAAM,WAAW;AAQV,SAAS,eACd,KACA,mBACM;AACN,QAAM,SAAS;AACf,QAAM,MAAM,CAAC,MACX,EAAE,QAAQ,mBAAmB,EAAE,EAAE;AACnC,QAAM,MAAM,CAAC,YAA4B;AACvC,UAAM,UAAU,KAAK,IAAI,GAAG,SAAS,IAAI,OAAO,CAAC;AACjD,WAAO,KAAK,QAAQ,SAAS,GAAG,GAAG,OAAO,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,QAAQ,SAAS,GAAG;AAAA;AAAA,EACzF;AACA,QAAM,QAAQ,IAAI,EAAE;AAEpB,MAAI,MAAM,KAAK,QAAQ,SAAS,SAAI,OAAO,MAAM,CAAC,SAAS,GAAG;AAAA,CAAI;AAClE,MAAI,MAAM,KAAK;AACf,MAAI,MAAM,IAAI,KAAK,UAAU,aAAa,GAAG,EAAE,CAAC;AAChD,MAAI,MAAM,KAAK;AAEf,MAAI,oBAAoB,GAAG;AACzB,QAAI;AAAA,MACF;AAAA,QACE,KAAK,IAAI,SAAS,GAAG,kCAAkC,GAAG,IAAI,iBAAiB,QAAQ,sBAAsB,IAAI,KAAK,GAAG,IAAI,GAAG;AAAA,MAClI;AAAA,IACF;AACA,QAAI,MAAM,KAAK;AACf,QAAI,MAAM,IAAI,KAAK,IAAI,KAAK,GAAG,6BAA6B,CAAC;AAC7D,QAAI,MAAM,IAAI,UAAU,IAAI,mCAAmC,GAAG,EAAE,CAAC;AACrE,QAAI;AAAA,MACF,IAAI,KAAK,IAAI,KAAK,GAAG,oDAA+C;AAAA,IACtE;AAAA,EACF,OAAO;AACL,QAAI;AAAA,MACF,IAAI,KAAK,IAAI,KAAK,GAAG,KAAK,IAAI,KAAK,GAAG,mCAAmC;AAAA,IAC3E;AACA,QAAI;AAAA,MACF;AAAA,QACE,KAAK,IAAI,KAAK,GAAG,KAAK,IAAI,oBAAoB,GAAG,KAAK,GAAG,sBAAsB,GAAG;AAAA,MACpF;AAAA,IACF;AACA,QAAI;AAAA,MACF,IAAI,KAAK,IAAI,KAAK,GAAG,oDAA+C;AAAA,IACtE;AAAA,EACF;AAEA,MAAI,MAAM,KAAK;AACf,MAAI,MAAM,KAAK,QAAQ,SAAS,SAAI,OAAO,MAAM,CAAC,SAAS,GAAG;AAAA;AAAA,CAAM;AACtE;AAOO,SAAS,mBAAmB,KAAqB;AACtD,MAAI;AACF,QAAI,MAAM;AACV,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,YAAM,WAAWA,MAAK,KAAK,KAAK,YAAY,OAAO;AACnD,UAAI,WAAW,QAAQ,GAAG;AACxB,YAAI;AACF,gBAAM,UAAU,YAAY,QAAQ;AACpC,iBAAO,QAAQ,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC,EAAE;AAAA,QAClD,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AACA,YAAM,SAASA,MAAK,QAAQ,GAAG;AAC/B,UAAI,WAAW,IAAK;AACpB,YAAM;AAAA,IACR;AAAA,EACF,QAAQ;AAAA,EAER;AACA,SAAO;AACT;;;AHWA,IAAMC,OAAM;AACZ,IAAMC,OAAM;AACZ,IAAMC,cAAa;AACnB,IAAMC,QAAO;AACb,IAAM,YAAY;AAElB,IAAM,WAAW;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQA,IAAM,aAAa;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,MAAM,KAAKF,IAAG,SAASD,IAAG;AAEhC,SAAS,YAAY,KAAkC;AACrD,MAAI,MAAM,IAAI;AACd,WAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,UAAM,QAAQ,SAAS,KAAK,IAAI,GAAG,SAAS,SAAS,CAAC,CAAC,KAAK;AAC5D,QAAI,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC,CAAC,GAAGA,IAAG;AAAA,CAAI;AAAA,EAC9C;AACA,MAAI,MAAM;AAAA,EAAKE,WAAU,oCAAoCF,IAAG;AAAA,CAAI;AACtE;AAEA,SAAS,WAAW,KAAkC;AACpD,MAAI,MAAM;AAAA,KAAQ,SAAS,gBAAgBA,IAAG;AAAA;AAAA,CAAM;AACtD;AAEA,SAAS,SAAS,KAA4B,KAAmB;AAC/D,MAAI,MAAM,KAAKG,KAAI,SAASH,IAAG,KAAK,GAAG;AAAA,CAAI;AAC7C;AAEA,SAAS,WAAW,KAA4B,KAAmB;AACjE,MAAI,MAAM,KAAKG,KAAI,SAASH,IAAG,KAAK,GAAG;AAAA,CAAI;AAC7C;AAEA,SAAS,YAAY,KAA4B,KAAmB;AAClE,MAAI,MAAM,KAAKC,IAAG,WAAW,GAAG,GAAGD,IAAG;AAAA,CAAI;AAC5C;AAIA,eAAsB,SACpB,UAAwB,CAAC,GACH;AACtB,QAAM,MAAM,QAAQ,UAAU,QAAQ;AACtC,QAAM,QACJ,QAAQ,SAAU,QAAQ,MAAM,UAAU;AAC5C,QAAM,cAAc,SAAS,QAAQ,QAAQ;AAQ7C,MAAI,QAAQ,aAAa,QAAQ,QAAQ,eAAe,MAAM;AAC5D,QAAI;AAAA,MACF;AAAA,IACF;AACA,WAAO,EAAE,QAAQ,IAAI,QAAQ,IAAI,UAAU,EAAE;AAAA,EAC/C;AAEA,cAAY,GAAG;AACf,aAAW,GAAG;AAKd,QAAM,OAAO,MAAM,cAAc,QAAQ,QAAQ;AACjD,aAAW,KAAK,IAAI;AACpB,MAAI,MAAM,MAAM,IAAI;AAWpB,QAAM,QAAQ,QAAQ,gBAAgB,SACjC,QAAQ,gBAAgB,OACrB,gBAAgB,QAAQ,WAAW,IACnC,QACJ,gBAAgB,yBAAyB,CAAC;AAC9C,MAAI,OAAO;AACT,QAAI,eAAgC;AACpC,QAAI,aAAa;AACf,qBAAe,MAAM;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,QAAI,iBAAiB,WAAW;AAC9B,iBAAW,KAAK,uCAAkC;AAClD,UAAI;AACF,eAAO,QAAQ,sBAAsB,oBAAoB;AACzD,iBAAS,KAAK,sDAAsD;AAAA,MACtE,SAAS,KAAc;AACrB,cAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,mBAAW,KAAK,0BAA0B,GAAG,EAAE;AAC/C,YAAI;AAAA,UACF,KAAKC,IAAG,qDAAqDD,IAAG;AAAA;AAAA,QAClE;AAAA,MACF;AAAA,IACF,OAAO;AACL;AAAA,QACE;AAAA,QACA,kBAAkBC,IAAG,gEAA2DD,IAAG;AAAA,MACrF;AAAA,IACF;AACA,QAAI,MAAM,MAAM,IAAI;AAAA,EACtB;AAGA,MAAI,aAA8B;AAClC,MAAI,QAAQ,aAAa,MAAM;AAC7B,iBAAa;AAAA,EACf,WAAW,aAAa;AACtB,iBAAa,MAAM;AAAA,MACjB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,iBAAiB;AACrB,MAAI,eAAe,WAAW;AAC5B,UAAM,MAAM,MAAM,eAAe;AAAA,MAC/B,cAAc,QAAQ;AAAA,MACtB,gBAAgB,QAAQ;AAAA,MACxB,gBAAgB,QAAQ;AAAA,IAC1B,CAAC;AACD,QAAI,IAAI,aAAa,GAAG;AACtB,iBAAW,KAAK,oBAAoB,IAAI,OAAO,KAAK,CAAC,EAAE;AACvD,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ,IAAI;AAAA,QACZ,UAAU,IAAI;AAAA,MAChB;AAAA,IACF;AACA,qBAAiB,IAAI,OAAO,SAAS,mBAAmB,IACpD,mBAAmBC,IAAG,oBAAoBD,IAAG,KAC7C;AACJ,aAAS,KAAK,cAAc;AAAA,EAC9B,OAAO;AACL,gBAAY,KAAK,mBAAmBC,IAAG,UAAUD,IAAG,EAAE;AAAA,EACxD;AACA,MAAI,MAAM,MAAM,IAAI;AAGpB,MAAI,eAAgC;AACpC,MAAI,QAAQ,eAAe,MAAM;AAC/B,mBAAe;AAAA,EACjB,WAAW,aAAa;AACtB,mBAAe,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI;AACJ,MAAI,iBAAiB,WAAW;AAC9B,QAAI;AACF,YAAM,UAAU,MAAM,cAAc;AAAA,QAClC,WAAW,QAAQ,aAAaI,MAAK,KAAKC,SAAQ,GAAG,SAAS;AAAA,QAC9D,WAAW,QAAQ,aAAa,iBAAiB;AAAA,MACnD,CAAC;AACD,sBAAgB,QAAQ,aACpB,qBAAqB,QAAQ,aAAa,KAAK,IAAI,CAAC,MACpD,UAAUJ,IAAG,oBAAoBD,IAAG;AACxC,eAAS,KAAK,aAAa;AAAA,IAC7B,SAAS,KAAc;AACrB,YAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ,kCAAkC,GAAG;AAAA;AAAA,QAC7C,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,EACF,OAAO;AACL,gBAAY,KAAK,UAAUC,IAAG,UAAUD,IAAG,EAAE;AAAA,EAC/C;AACA,MAAI,MAAM,MAAM,IAAI;AAEpB,WAAS,KAAK,GAAGG,KAAI,iBAAiBH,IAAG,EAAE;AAC3C,MAAI,MAAM,IAAI;AAOd,QAAM,oBAAoB,mBAAmB,QAAQ,IAAI,CAAC;AAC1D,iBAAe,KAAK,iBAAiB;AAErC,SAAO,EAAE,QAAQ,IAAI,QAAQ,IAAI,UAAU,EAAE;AAC/C;AAIA,eAAe,cACb,UAC2B;AAC3B,MAAI;AACF,WAAO,MAAM,gBAAgB,QAAQ;AAAA,EACvC,QAAQ;AACN,WAAO,EAAE,UAAU,MAAM;AAAA,EAC3B;AACF;AAEA,SAAS,WACP,KACA,MACM;AACN,MAAI,KAAK,UAAU;AACjB,UAAM,MAAM,KAAK,SAAS;AAC1B,UAAM,OACJ,KAAK,qBAAqB,SACtB,IAAIC,IAAG,IAAI,KAAK,gBAAgB,IAAID,IAAG,KACvC;AACN,aAAS,KAAK,gBAAgBE,WAAU,GAAG,GAAG,GAAGF,IAAG,GAAG,IAAI,EAAE;AAC7D;AAAA,EACF;AACA,MACE,QAAQ,IAAI,sBAAsB,UAClC,QAAQ,IAAI,kBAAkB,SAAS,GACvC;AACA,aAAS,KAAK,gBAAgBE,WAAU,oBAAoBF,IAAG,MAAM;AACrE;AAAA,EACF;AAEA,aAAW,KAAK,gBAAgBC,IAAG,gBAAgBD,IAAG,EAAE;AACxD,aAAW,QAAQ,wBAAwB,MAAM,IAAI,GAAG;AACtD,QAAI,MAAM,KAAKC,IAAG,YAAY,IAAI,GAAGD,IAAG;AAAA,CAAI;AAAA,EAC9C;AACF;AA6BA,eAAe,cACb,SAC8B;AAC9B,QAAM,MAAM,QAAQ,WAAW,EAAE,WAAW,KAAK,CAAC;AAElD,QAAM,UAAUI,MAAK,KAAK,QAAQ,WAAW,SAAS;AACtD,QAAM,SAASA,MAAK,KAAK,QAAQ,WAAW,cAAc;AAC1D,MAAI,CAACE,YAAW,OAAO,GAAG;AACxB,UAAM,IAAI,MAAM,0BAA0B,OAAO,EAAE;AAAA,EACrD;AACA,MAAI,CAACA,YAAW,MAAM,GAAG;AACvB,UAAM,IAAI,MAAM,0BAA0B,MAAM,EAAE;AAAA,EACpD;AAEA,QAAM,WAAWF,MAAK,KAAK,QAAQ,WAAW,gBAAgB;AAC9D,QAAM,UAAUA,MAAK,KAAK,QAAQ,WAAW,0BAA0B;AAEvE,QAAM,cAAc,MAAM,cAAc,SAAS,QAAQ;AACzD,QAAM,aAAa,MAAM,cAAc,QAAQ,OAAO;AAEtD,QAAM,WAAWA,MAAK,KAAK,QAAQ,WAAW,WAAW;AACzD,QAAM,gBAAgB,MAAM,aAAa,QAAQ;AAEjD,QAAM,eAAyB,CAAC;AAChC,MAAI,YAAa,cAAa,KAAK,gBAAgB;AACnD,MAAI,WAAY,cAAa,KAAK,0BAA0B;AAC5D,MAAI,cAAe,cAAa,KAAK,WAAW;AAEhD,SAAO,EAAE,YAAY,aAAa,SAAS,GAAG,aAAa;AAC7D;AAEA,eAAe,cAAc,KAAa,MAAgC;AACxE,QAAM,WAAW,MAAM,SAAS,GAAG;AACnC,MAAIE,YAAW,IAAI,GAAG;AACpB,QAAI;AACF,YAAM,YAAY,MAAM,SAAS,IAAI;AACrC,UAAI,SAAS,OAAO,SAAS,EAAG,QAAO;AAAA,IACzC,QAAQ;AAAA,IAER;AAAA,EACF;AACA,QAAM,SAAS,KAAK,IAAI;AACxB,SAAO;AACT;AAIO,IAAM,cAAc;AAa3B,eAAe,aAAa,cAAwC;AAClE,MAAI,WAAW;AACf,MAAIA,YAAW,YAAY,GAAG;AAC5B,eAAW,MAAM,SAAS,cAAc,MAAM;AAAA,EAChD;AACA,MAAI,cAAc,QAAQ,EAAG,QAAO;AAEpC,QAAM,MACJ,SAAS,WAAW,IAAI,KAAK,SAAS,SAAS,IAAI,IAAI,OAAO;AAChE,QAAM,OAAO,GAAG,QAAQ,GAAG,GAAG,GAAG,WAAW;AAAA;AAC5C,QAAM,UAAU,cAAc,MAAM,MAAM;AAC1C,SAAO;AACT;AAEO,SAAS,cAAc,UAA2B;AAMvD,QAAM,QAAQ,SAAS,MAAM,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACzD,SAAO,MAAM,KAAK,CAAC,SAAS;AAC1B,QAAI,SAAS,YAAa,QAAO;AACjC,QAAI,CAAC,KAAK,WAAW,WAAW,EAAG,QAAO;AAC1C,UAAM,OAAO,KAAK,YAAY,MAAM;AACpC,WAAO,SAAS,OAAO,SAAS;AAAA,EAClC,CAAC;AACH;AAYA,SAAS,QACP,KACA,UACA,YAC0B;AAC1B,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,OAAO,aAAa,UAAU;AACpC,QAAI,MAAM,KAAKH,KAAI,SAASH,IAAG,KAAK,QAAQ,IAAIC,IAAG,GAAG,IAAI,GAAGD,IAAG,GAAG;AAEnE,QAAI,MAAM;AACV,UAAM,SAAS,CAAC,UAAwB;AACtC,aAAO,MAAM,SAAS,MAAM;AAC5B,YAAM,KAAK,IAAI,QAAQ,IAAI;AAC3B,UAAI,OAAO,GAAI;AACf,cAAQ,MAAM,eAAe,QAAQ,MAAM;AAC3C,cAAQ,MAAM,MAAM;AAEpB,YAAM,SAAS,IAAI,MAAM,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY;AACnD,YAAM,WACJ,OAAO,WAAW,IACd,aACA,WAAW,OAAO,WAAW;AACnC,cAAQ,WAAW,YAAY,MAAM;AAAA,IACvC;AAEA,YAAQ,MAAM,OAAO;AACrB,YAAQ,MAAM,GAAG,QAAQ,MAAM;AAAA,EACjC,CAAC;AACH;AAoBO,SAAS,mBAA2B;AACzC,QAAM,OAAOI,MAAK,QAAQG,eAAc,YAAY,GAAG,CAAC;AACxD,QAAM,aAAa;AAAA,IACjBH,MAAK,QAAQ,MAAM,MAAM,QAAQ;AAAA;AAAA,IACjCA,MAAK,QAAQ,MAAM,MAAM,MAAM,QAAQ;AAAA;AAAA,IACvCA,MAAK,QAAQ,MAAM,MAAM,MAAM,MAAM,QAAQ;AAAA,EAC/C;AACA,aAAW,OAAO,YAAY;AAC5B,QAAI,mBAAmB,GAAG,EAAG,QAAO;AAAA,EACtC;AAIA,MAAI;AACF,UAAMI,WAAUC,eAAc,YAAY,GAAG;AAC7C,UAAM,UAAUD,SAAQ,QAAQ,0BAA0B;AAC1D,UAAM,SAASJ,MAAK,KAAKA,MAAK,QAAQ,OAAO,GAAG,QAAQ;AACxD,QAAI,mBAAmB,MAAM,EAAG,QAAO;AAAA,EACzC,QAAQ;AAAA,EAER;AACA,QAAM,IAAI;AAAA,IACR,yDACE,WAAW,IAAI,CAAC,MAAM,OAAO,CAAC,EAAE,EAAE,KAAK,IAAI;AAAA,EAC/C;AACF;AAEA,SAAS,mBAAmB,KAAsB;AAChD,SAAOE,YAAWF,MAAK,KAAK,KAAK,SAAS,CAAC;AAC7C;","names":["existsSync","createRequire","homedir","path","fileURLToPath","require","createRequire","path","RST","DIM","WHITE_BOLD","BLUE","path","homedir","existsSync","fileURLToPath","require","createRequire"]}

package/dist/wiki-EHZ7LG7R.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/doctor-checks/wiki.ts"],"sourcesContent":["import { existsSync, readdirSync, statSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport type Database from \"better-sqlite3\";\n\nimport { ensureFreshIndex } from \"../../indexer/index.js\";\nimport { openIndex } from \"../../indexer/schema.js\";\nimport { findNearestAlmanacDir } from \"../../paths.js\";\nimport { findEntry } from \"../../registry/index.js\";\nimport { runHealth, type HealthReport } from \"../health.js\";\nimport { formatDuration } from \"./duration.js\";\nimport type { Check, DoctorOptions } from \"./types.js\";\n\nexport async function gatherWikiChecks(options: DoctorOptions): Promise<Check[]> {\n  const checks: Check[] = [];\n  const repoRoot = findNearestAlmanacDir(options.cwd);\n\n  if (repoRoot === null) {\n    checks.push({\n      status: \"info\",\n      key: \"wiki.none\",\n      message: \"No wiki in current directory\",\n      fix: \"run: almanac bootstrap  (to create one in this repo)\",\n    });\n    return checks;\n  }\n\n  checks.push({\n    status: \"info\",\n    key: \"wiki.repo\",\n    message: `repo: ${repoRoot}`,\n  });\n\n  try {\n    await ensureFreshIndex({ repoRoot });\n  } catch {\n    // non-fatal: counts below and the health probe report any real issue.\n  }\n\n  checks.push(await describeRegistry(repoRoot));\n\n  const almanacDir = path.join(repoRoot, \".almanac\");\n  const dbPath = path.join(almanacDir, \"index.db\");\n  checks.push(...describeCounts(dbPath));\n  checks.push(describeIndexFreshness(dbPath));\n  checks.push(describeLastCapture(almanacDir, options.now));\n  checks.push(await describeHealth(repoRoot, options));\n\n  return checks;\n}\n\nasync function describeRegistry(repoRoot: string): Promise<Check> {\n  try {\n    const entry = await findEntry({ path: repoRoot });\n    if (entry !== null) {\n      return {\n        status: \"ok\",\n        key: \"wiki.registered\",\n        message: `registered as '${entry.name}'`,\n      };\n    }\n    return {\n      status: \"info\",\n      key: \"wiki.registered\",\n      message: \"not yet registered (will register on first command)\",\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"problem\",\n      key: \"wiki.registered\",\n      message: `could not read registry: ${msg}`,\n      fix: \"inspect ~/.almanac/registry.json; remove or fix the malformed entry\",\n    };\n  }\n}\n\nfunction describeCounts(dbPath: string): Check[] {\n  const checks: Check[] = [];\n  let pageCount: number | null = null;\n  let topicCount: number | null = null;\n\n  if (existsSync(dbPath)) {\n    try {\n      const db = openIndex(dbPath);\n      try {\n        pageCount = countRows(db, \"pages\");\n        topicCount = countRows(db, \"topics\");\n      } finally {\n        db.close();\n      }\n    } catch {\n      pageCount = null;\n    }\n  }\n\n  if (pageCount !== null) {\n    checks.push({\n      status: \"info\",\n      key: \"wiki.pages\",\n      message: `pages: ${pageCount}`,\n    });\n  }\n  if (topicCount !== null) {\n    checks.push({\n      status: \"info\",\n      key: \"wiki.topics\",\n      message: `topics: ${topicCount}`,\n    });\n  }\n\n  return checks;\n}\n\nfunction countRows(db: Database.Database, table: string): number {\n  const row = db\n    .prepare<[], { n: number }>(`SELECT COUNT(*) AS n FROM ${table}`)\n    .get();\n  return row?.n ?? 0;\n}\n\nfunction describeIndexFreshness(dbPath: string): Check {\n  if (!existsSync(dbPath)) {\n    return {\n      status: \"info\",\n      key: \"wiki.index\",\n      message: \"index: not built yet (run any query command)\",\n    };\n  }\n  try {\n    const dbMtime = statSync(dbPath).mtimeMs;\n    const age = Date.now() - dbMtime;\n    return {\n      status: \"info\",\n      key: \"wiki.index\",\n      message: `index: rebuilt ${formatDuration(age)} ago`,\n    };\n  } catch {\n    return {\n      status: \"info\",\n      key: \"wiki.index\",\n      message: \"index: present\",\n    };\n  }\n}\n\nfunction describeLastCapture(\n  almanacDir: string,\n  nowFn?: () => Date,\n): Check {\n  if (!existsSync(almanacDir)) {\n    return {\n      status: \"info\",\n      key: \"wiki.capture\",\n      message: \"last capture: never\",\n    };\n  }\n  let entries: string[];\n  try {\n    entries = readdirSync(almanacDir);\n  } catch {\n    return {\n      status: \"info\",\n      key: \"wiki.capture\",\n      message: \"last capture: unknown\",\n    };\n  }\n  const captures = entries\n    .filter(\n      (e) =>\n        e.startsWith(\".capture-\") &&\n        (e.endsWith(\".log\") || e.endsWith(\".jsonl\")),\n    )\n    .map((e) => {\n      try {\n        return {\n          name: e,\n          mtime: statSync(path.join(almanacDir, e)).mtimeMs,\n        };\n      } catch {\n        return null;\n      }\n    })\n    .filter((e): e is { name: string; mtime: number } => e !== null);\n  if (captures.length === 0) {\n    return {\n      status: \"info\",\n      key: \"wiki.capture\",\n      message: \"last capture: never\",\n    };\n  }\n  captures.sort((a, b) => b.mtime - a.mtime);\n  const latest = captures[0]!;\n  const now = (nowFn?.() ?? new Date()).getTime();\n  const age = now - latest.mtime;\n  return {\n    status: \"info\",\n    key: \"wiki.capture\",\n    message: `last capture: ${formatDuration(age)} ago (${latest.name})`,\n  };\n}\n\nasync function describeHealth(\n  repoRoot: string,\n  options: DoctorOptions,\n): Promise<Check> {\n  const healthFn = options.runHealthFn ?? runHealth;\n  try {\n    const healthRes = await healthFn({\n      cwd: repoRoot,\n      json: true,\n    });\n    const problems = countHealthProblems(healthRes.stdout);\n    if (problems === 0) {\n      return {\n        status: \"ok\",\n        key: \"wiki.health\",\n        message: \"almanac health reports 0 problems\",\n      };\n    }\n    return {\n      status: \"problem\",\n      key: \"wiki.health\",\n      message: `almanac health reports ${problems} problem${problems === 1 ? \"\" : \"s\"}`,\n      fix: \"run: almanac health\",\n    };\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return {\n      status: \"info\",\n      key: \"wiki.health\",\n      message: `could not run almanac health: ${msg}`,\n    };\n  }\n}\n\nconst HEALTH_PROBLEM_KEYS: (keyof HealthReport)[] = [\n  \"orphans\",\n  \"stale\",\n  \"dead_refs\",\n  \"broken_links\",\n  \"broken_xwiki\",\n  \"empty_topics\",\n  \"empty_pages\",\n  \"slug_collisions\",\n];\n\nfunction countHealthProblems(jsonStdout: string): number {\n  try {\n    const report = JSON.parse(jsonStdout) as Partial<HealthReport>;\n    let total = 0;\n    for (const key of HEALTH_PROBLEM_KEYS) {\n      const arr = report[key];\n      if (Array.isArray(arr)) total += arr.length;\n    }\n    return total;\n  } catch {\n    return 0;\n  }\n}\n"],"mappings":"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","names":[]}