codebase-wiki 0.1.0

package/dist/plugin/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "code-wiki": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/code-wiki-mcp.mjs"],
+      "env": {
+        "CODEWIKI_CWD": "${workspaceFolder}"
+      }
+    }
+  }
+}

package/dist/plugin/CLAUDE.md

@@ -0,0 +1,28 @@
+# Working with `.codewiki/`
+
+If you see a `.codewiki/` directory in this project, the `code-wiki` Claude Code
+plugin is enabled. **Prefer reading `.codewiki/` pages over reading source files
+directly.** The wiki pages are short, structured, and the model is auto-nudged
+toward them whenever you call `Read | Grep | Glob | cat | head | tail`.
+
+## Workflow
+
+1. On a new project or after a major refactor, suggest `/wiki-build` first.
+2. To find a symbol: `/wiki-search <query>` or the `wiki_search` MCP tool.
+3. To drill into a single symbol or file: `/wiki-symbol <path>:<name>` or `wiki_drill`.
+4. To understand callers/callees: `/wiki-graph <symbol>`.
+5. After making non-trivial edits, suggest `/wiki-refresh` (the PostToolUse hook
+   already marks changed files; refresh re-renders them).
+
+## Hard rules
+
+- **Never** write into `.codewiki/` directly. Always run `codewiki build` /
+  `codewiki refresh`. The plugin permissions deny those writes for a reason.
+- **Never** cat/head/tail a source file when its `.codewiki/files/...md` exists.
+- After a long session, the `PreCompact` hook may have marked `.codewiki/` as
+  possibly stale. Run `/wiki-refresh` proactively.
+
+## Disabling
+
+Set `nudge.enabled: false` in `.codewikirc` (or `package.json#code-wiki.nudge.enabled`)
+to silence auto-nudges. The wiki itself stays usable.

package/dist/plugin/commands/wiki-architecture.md

@@ -0,0 +1,10 @@
+---
+description: Show the project's architecture.md wiki page (system overview + Mermaid diagram).
+allowed-tools: Read
+---
+
+# /wiki-architecture
+
+Read `.codewiki/architecture.md` in `${workspaceFolder}` and summarise the
+project in 4-6 sentences. Include the Mermaid diagram verbatim (don't reformat it).
+Then list the modules in a compact table.

package/dist/plugin/commands/wiki-build.md

@@ -0,0 +1,23 @@
+---
+description: Build or rebuild the codewiki for this repo. Run once on first use, or after a major refactor.
+allowed-tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs build:*), Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs build), Read
+---
+
+# /wiki-build
+
+Run `node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs build` in `${workspaceFolder}`.
+
+The plugin ships the CLI binary at `${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs`, so
+no global npm install is required. If `.codewiki/` already exists, this runs
+a smart rebuild (only re-parses files changed in git diff). Pass `--full` to
+force a complete rebuild.
+
+After the build finishes, report:
+
+1. The number of modules, files, and symbols indexed (from the CLI output).
+2. The path `.codewiki/INDEX.md`.
+3. A one-line summary of the largest module.
+
+If `.codewiki/` already existed before this command, also note: "To refresh
+later, run `/wiki-refresh` or simply edit files — the PostToolUse hook
+invalidates changed files automatically."

package/dist/plugin/commands/wiki-enrich.md

@@ -0,0 +1,22 @@
+---
+description: Queue LLM enrichment of the wiki using Claude Haiku + Sonnet. Requires ANTHROPIC_API_KEY.
+allowed-tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs enrich:*), Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs enrich)
+---
+
+# /wiki-enrich
+
+Runs `node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs enrich`. Requires
+`ANTHROPIC_API_KEY` to be set in the environment.
+
+Behaviour:
+
+- File-level pages: Haiku generates "Notes" for files with cyclomatic > 15 OR
+  no docstring OR tokens > 800. Cached by content hash.
+- Module-level pages: Sonnet regenerates the public surface summary if any of
+  its files changed. Cached.
+
+This command runs in the background by default (the queue is concurrency-bounded
+to 4). Progress is in `.codewiki/.summary-cache/`.
+
+If `ANTHROPIC_API_KEY` is not set, the CLI prints a one-line warning and
+exits cleanly — nothing to do.

package/dist/plugin/commands/wiki-graph.md

@@ -0,0 +1,16 @@
+---
+description: Show callers and callees of a symbol.
+allowed-tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs show:*), Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs show), Read
+---
+
+# /wiki-graph <symbol>
+
+Arguments: $ARGUMENTS
+
+Look up the symbol in `.codewiki/.graph.json` (or call the `wiki_callers` and
+`wiki_callees` MCP tools with the symbol id). Print:
+
+- Incoming edges (callers), grouped by file.
+- Outgoing edges (callees), grouped by file.
+
+Limit to 20 edges each direction. If more exist, say so and offer to expand.

package/dist/plugin/commands/wiki-help.md

@@ -0,0 +1,49 @@
+---
+description: Show available wiki commands.
+allowed-tools:
+---
+
+# /wiki-help
+
+Print a one-screen summary:
+
+## Slash commands
+
+- `/wiki-build` — Build or rebuild the wiki
+- `/wiki-refresh` — Incremental refresh
+- `/wiki-search <query>` — Search symbols/files/modules
+- `/wiki-symbol <path>:<name>` — Read one symbol page
+- `/wiki-architecture` — System overview + diagram
+- `/wiki-graph <symbol>` — Callers and callees
+- `/wiki-enrich` — Optional LLM enrichment (API key required)
+- `/wiki-help` — This help
+
+## MCP tools (auto-discovered)
+
+- `wiki_search`, `wiki_drill`, `wiki_callers`, `wiki_callees`, `wiki_changed_since`
+
+## MCP resources
+
+- `wiki://tree` — Top-level module index
+- `wiki://architecture` — Architecture overview
+- `wiki://module/<id>` — A module page
+- `wiki://file/<path>` — A file page
+- `wiki://symbol/<id>` — A symbol page
+
+## Onboarding
+
+1. Run `/wiki-build` once.
+2. Edit files normally — the PostToolUse hook invalidates changed wiki pages.
+3. Run `/wiki-refresh` after significant edits, or just keep working — the watcher auto-rebuilds.
+
+## Note
+
+The CLI is bundled inside the plugin at
+`${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs`. No global `npm install` is
+required — the slash commands invoke it via `node` directly.
+
+## Auto-nudge
+
+After `/wiki-build`, every `Read | Grep | Glob | Bash cat/head/tail` call you
+make will receive a one-line reminder pointing at the matching `.codewiki/`
+page. This is the source of the token savings — lean into it.

package/dist/plugin/commands/wiki-refresh.md

@@ -0,0 +1,13 @@
+---
+description: Incrementally refresh the wiki based on git diff since the last index.
+allowed-tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs refresh:*), Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs refresh), Read
+---
+
+# /wiki-refresh
+
+Run `node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs refresh` in `${workspaceFolder}`.
+Report:
+
+1. Which files were re-indexed (git diff since last build, listed by the CLI).
+2. Which modules were marked stale.
+3. The new token totals if `.codewiki/.meta.json` changed.

package/dist/plugin/commands/wiki-search.md

@@ -0,0 +1,18 @@
+---
+description: Search the wiki for symbols, files, or modules matching a query.
+allowed-tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs search:*), Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs search)
+---
+
+# /wiki-search <query>
+
+Arguments: $ARGUMENTS
+
+Run `node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs search "$ARGUMENTS" --limit 20`
+in `${workspaceFolder}` and present the top results as a table with columns:
+Kind, Name, File, Module.
+
+After the table, suggest specific drill-in commands. For example, if a symbol
+hit appears:
+
+- `/wiki-symbol src/auth/login.ts:function.loginUser` to read the symbol page
+- or call the MCP tool `wiki_drill` with the symbol id

package/dist/plugin/commands/wiki-symbol.md

@@ -0,0 +1,21 @@
+---
+description: Show the wiki page for a specific symbol or file (function, class, etc.).
+allowed-tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs show:*), Bash(node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs show), Read
+---
+
+# /wiki-symbol <path>:<name>
+
+Arguments: $ARGUMENTS
+
+Examples:
+
+- `/wiki-symbol src/auth/login.ts:function.loginUser`
+- `/wiki-symbol src/auth/login.ts:class.AuthService`
+- `/wiki-symbol src/auth/login.ts` (the whole file page)
+
+Run `node ${CLAUDE_PLUGIN_ROOT}/dist/codewiki.mjs show "$ARGUMENTS"` and read
+the result. Summarize:
+
+1. The symbol's purpose (paraphrase the Description).
+2. Its signature.
+3. Its callers and callees (from `wiki_callers` and `wiki_callees` MCP tools).

package/dist/plugin/hooks/hooks.json

@@ -0,0 +1,74 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.mjs",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit.mjs",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Read|Grep|Glob|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/nudge.mjs",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/post-tool-use.mjs",
+            "timeout": 3000
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/post-read-reminder.mjs",
+            "timeout": 3000
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/pre-compact.mjs",
+            "timeout": 2000
+          }
+        ]
+      }
+    ]
+  }
+}

package/dist/plugin/hooks/nudge.mjs

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+// PreToolUse nudge hook for Read | Grep | Glob | Bash.
+//
+// Reads stdin JSON: { tool_name, tool_input, cwd }
+// Decides whether the call could be replaced (or preceded) with a wiki read.
+// Emits a permissionDecisionReason the model sees as a reminder.
+//
+// M5 additions:
+//   - Honors .codewikirc.json: nudge.minFileLines (skip tiny files),
+//     nudge.minLinesForGlob (skip tiny globs)
+//   - Adds freshness check: if file mtime > .codewiki/.meta.json updatedAt,
+//     the wiki page is stale and we tell the model to run /wiki-refresh
+//   - Adds `wiki_changed_since` MCP tool hint on Grep (lets the model
+//     catch "is this in the changed set" without paying a Bash cost)
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+const SOURCE_EXTS = new Set([
+  '.ts', '.tsx', '.mts', '.cts',
+  '.js', '.jsx', '.mjs', '.cjs',
+  '.py', '.pyi',
+  '.go', '.rs', '.java',
+  '.c', '.h', '.cpp', '.cc', '.cxx', '.hpp', '.hh',
+  '.rb',
+])
+
+const DEFAULT_MIN_FILE_LINES = 30
+
+async function readStdinJson() {
+  try {
+    const buf = await new Promise((res) => {
+      let chunks = ''
+      process.stdin.setEncoding('utf8')
+      process.stdin.on('data', (c) => (chunks += c))
+      process.stdin.on('end', () => res(chunks))
+    })
+    return JSON.parse(buf || '{}')
+  } catch {
+    return {}
+  }
+}
+
+async function loadConfig(cwd) {
+  // Tolerant config reader — keeps this script self-contained (no TS imports).
+  try {
+    const cfg = JSON.parse(await fs.readFile(path.join(cwd, '.codewikirc.json'), 'utf8'))
+    return cfg
+  } catch {
+    try {
+      const pkg = JSON.parse(await fs.readFile(path.join(cwd, 'package.json'), 'utf8'))
+      if (pkg && pkg['code-wiki'] && pkg['code-wiki'].nudge) {
+        return { nudge: pkg['code-wiki'].nudge }
+      }
+    } catch {
+      /* ignore */
+    }
+    return null
+  }
+}
+
+async function readMeta(cwd) {
+  try {
+    return JSON.parse(await fs.readFile(path.join(cwd, '.codewiki', '.meta.json'), 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+function repoRel(absOrRel, cwd) {
+  const abs = path.isAbsolute(absOrRel) ? absOrRel : path.join(cwd, absOrRel)
+  let rel = path.relative(cwd, abs)
+  rel = rel.split(path.sep).join('/')
+  if (rel.startsWith('./')) rel = rel.slice(2)
+  return rel
+}
+
+function isSourceFile(repoPath) {
+  const ext = path.extname(repoPath).toLowerCase()
+  return SOURCE_EXTS.has(ext)
+}
+
+function isReadOfWiki(repoPath) {
+  return repoPath.startsWith('.codewiki/') || repoPath.includes('/.codewiki/')
+}
+
+async function fileMTimeMs(absPath) {
+  try {
+    const s = await fs.stat(absPath)
+    return s.mtimeMs
+  } catch {
+    return 0
+  }
+}
+
+async function fileLineCount(absPath) {
+  try {
+    const buf = await fs.readFile(absPath, 'utf8')
+    return buf.split(/\r?\n/).length
+  } catch {
+    return 0
+  }
+}
+
+async function isStale(meta, absFilePath) {
+  if (!meta || !meta.updatedAt) return false
+  const mtime = await fileMTimeMs(absFilePath)
+  if (!mtime) return false
+  const metaMs = Date.parse(meta.updatedAt)
+  return Number.isFinite(metaMs) && mtime > metaMs
+}
+
+async function buildReadReason(repoPath, cwd, index, meta, cfg) {
+  if (isReadOfWiki(repoPath)) return null
+  if (!isSourceFile(repoPath)) return null
+
+  const filePage = `.codewiki/files/${repoPath}.md`
+  try {
+    await fs.stat(path.join(cwd, filePage))
+  } catch {
+    return null
+  }
+
+  const minLines = cfg?.nudge?.minFileLines ?? DEFAULT_MIN_FILE_LINES
+  const abs = path.join(cwd, repoPath)
+  const lines = await fileLineCount(abs)
+  if (lines < minLines) return null
+
+  const parts = [
+    `Tip: ${filePage} is a wiki summary for this file (~${budgetHint(index, repoPath)} tokens).`,
+  ]
+  if (await isStale(meta, abs)) {
+    parts.push('This file is newer than the wiki — run /wiki-refresh first.')
+  }
+  parts.push('Read the wiki page first; only Read the source if you need details beyond it.')
+  return parts.join(' ')
+}
+
+function budgetHint(index, repoPath) {
+  const f = index?.files?.find((x) => x.path === repoPath)
+  return f?.tokens ?? 600
+}
+
+async function main() {
+  const payload = await readStdinJson()
+  const cwd = payload.cwd || process.env.CODEWIKI_CWD || process.cwd()
+  const meta = await readMeta(cwd)
+  if (!meta) return // no wiki → no nudge
+
+  const cfg = await loadConfig(cwd)
+  if (cfg?.nudge?.enabled === false) return
+
+  // Soft-delete: respect TTL on identical nudges? M5 keeps it simple — no TTL.
+  // Future: timestamp in .codewiki/.state.json.
+
+  const tool = payload.tool_name
+  const ti = payload.tool_input || {}
+  let reason = null
+
+  if (tool === 'Read' && typeof ti.file_path === 'string') {
+    const repoPath = repoRel(ti.file_path, cwd)
+    const index = payload._index || null // hook can't reach the index from here
+    reason = await buildReadReason(repoPath, cwd, index, meta, cfg)
+  } else if (tool === 'Grep') {
+    const pattern = String(ti.pattern ?? '')
+    const pathHint = ti.path ? ` (under ${ti.path})` : ''
+    reason = pattern
+      ? `Tip: \`wiki_search\` MCP tool covers most symbol/file lookups across this repo. ` +
+        `Run \`use_mcp_tool('code-wiki', 'wiki_search', { query: "${pattern.replace(/"/g, '\\"')}" })\` ` +
+        `before Grep${pathHint}.`
+      : 'Tip: prefer the `wiki_search` MCP tool over Grep when looking for symbols or files.'
+  } else if (tool === 'Glob') {
+    reason =
+      `Tip: \`.codewiki/INDEX.md\` lists every module + file in the wiki. ` +
+      `Read it before globbing the source tree.`
+  } else if (
+    tool === 'Bash' &&
+    typeof ti.command === 'string' &&
+    /^(cat|head|tail|sed\s+-n|less|more|bat)\s/.test(ti.command.trim())
+  ) {
+    reason =
+      `Tip: prefer \`.codewiki/files/...md\` over cat/head/tail of source files.`
+  }
+
+  if (!reason) return
+
+  const out = {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'allow',
+      permissionDecisionReason: reason,
+    },
+  }
+  process.stdout.write(JSON.stringify(out))
+}
+
+main().catch(() => process.exit(0))

package/dist/plugin/hooks/post-read-reminder.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// PostToolUse hook on Read: emit a one-line note with the wiki page path so
+// the model remembers the wiki location and avoids re-reading the source next
+// time.
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+async function main() {
+  let payload
+  try {
+    const buf = await new Promise((res) => {
+      let chunks = ''
+      process.stdin.setEncoding('utf8')
+      process.stdin.on('data', (c) => (chunks += c))
+      process.stdin.on('end', () => res(chunks))
+    })
+    payload = JSON.parse(buf || '{}')
+  } catch {
+    payload = {}
+  }
+  const cwd = payload.cwd || process.env.CODEWIKI_CWD || process.cwd()
+  const ti = payload.tool_input || {}
+  const filePath = ti.file_path
+  if (!filePath) return
+
+  let rel = path.isAbsolute(filePath) ? path.relative(cwd, filePath) : filePath
+  rel = rel.split(path.sep).join('/')
+  if (rel.startsWith('./')) rel = rel.slice(2)
+  if (rel.startsWith('.codewiki/')) return
+
+  const wikiPage = `.codewiki/files/${rel}.md`
+  try {
+    await fs.stat(path.join(cwd, wikiPage))
+  } catch {
+    return
+  }
+
+  // M5 will pull symbol hints from .index.json. For now, just the file page.
+  let hint = ''
+  try {
+    const idx = JSON.parse(await fs.readFile(path.join(cwd, '.codewiki', '.index.json'), 'utf8'))
+    const fileEntry = idx.files?.find((x) => x.path === rel)
+    if (fileEntry?.tokens) {
+      hint = ` (~${fileEntry.tokens} tokens vs the source file's many more)`
+    }
+  } catch {
+    /* ignore */
+  }
+
+  process.stdout.write(
+    `<system-reminder>\nFor future reference, the wiki summary for \`${rel}\` is at \`${wikiPage}\`${hint}.\n</system-reminder>\n`,
+  )
+}
+
+main().catch(() => process.exit(0))

package/dist/plugin/hooks/post-tool-use.mjs

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+// PostToolUse hook on Write | Edit | MultiEdit:
+// Mark the affected file for incremental re-render.
+// Plus a small PostToolUse reminder: log the wiki page for the touched file
+// so the model sees an inline pointer in subsequent requests.
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+
+async function main() {
+  let payload
+  try {
+    const buf = await new Promise((res) => {
+      let chunks = ''
+      process.stdin.setEncoding('utf8')
+      process.stdin.on('data', (c) => (chunks += c))
+      process.stdin.on('end', () => res(chunks))
+    })
+    payload = JSON.parse(buf || '{}')
+  } catch {
+    payload = {}
+  }
+  const cwd = payload.cwd || process.env.CODEWIKI_CWD || process.cwd()
+
+  const ti = payload.tool_input || {}
+  const filePath = ti.file_path || ti.path
+  if (!filePath) return
+
+  let rel = path.isAbsolute(filePath) ? path.relative(cwd, filePath) : filePath
+  rel = rel.split(path.sep).join('/')
+  if (rel.startsWith('./')) rel = rel.slice(2)
+  if (!rel || rel.startsWith('.codewiki/')) return
+
+  // Mark in .state.json for incremental rebuild.
+  // Path: this script lives at hooks/post-tool-use.mjs inside the plugin root.
+  // The bundled CLI is at dist/codewiki.mjs.
+  const here = new URL(import.meta.url).pathname.replace(/^\//, '')
+  const hooksDir = path.dirname(here)
+  const pluginRoot = path.dirname(hooksDir)
+  spawnSync(
+    'node',
+    [path.join(pluginRoot, 'dist', 'codewiki.mjs'), 'invalidate', rel],
+    { cwd, stdio: 'ignore' },
+  )
+
+  // The inline reminder (Claude Code shows it inline after the tool result).
+  const wikiPage = `.codewiki/files/${rel}.md`
+  // Verify the wiki page actually exists; otherwise skip.
+  try {
+    await fs.stat(path.join(cwd, wikiPage))
+  } catch {
+    return
+  }
+  process.stdout.write(
+    `<system-reminder>\nFile \`${rel}\` was just edited. Its wiki page is at \`${wikiPage}\` and may now be stale. Run /wiki-refresh (or just continue — the next refresh will pick it up).\n</system-reminder>\n`,
+  )
+}
+
+main().catch(() => process.exit(0))

package/dist/plugin/hooks/pre-compact.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// PreCompact hook: write a marker file so SessionStart can detect that the
+// session was compacted and trigger a smart refresh in the background.
+
+import { promises as fs } from 'node:fs'
+import path from 'node:path'
+
+async function main() {
+  const cwd = process.env.CODEWIKI_CWD || process.cwd()
+  const marker = path.join(cwd, '.codewiki', '.last-compact')
+  try {
+    await fs.mkdir(path.dirname(marker), { recursive: true })
+    await fs.writeFile(
+      marker,
+      JSON.stringify({
+        at: new Date().toISOString(),
+        head: process.env.CODEWIKI_GIT_HEAD || 'uncommitted',
+      }),
+    )
+  } catch {
+    /* never block compact */
+  }
+}
+
+main().catch(() => process.exit(0))