eminiar 0.10.0 → 0.10.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "eminiar",
   "displayName": "Eminiar",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Local-first context, memory and knowledge graph for Claude Code: sandboxed execution, FTS5 + vector search, session continuity, code graph.",
   "author": {
     "name": "Ryan Dick"

package/dist/cli.js

@@ -21270,6 +21270,14 @@ function findOnPath(bin) {
   }
   return void 0;
 }
+function requirePreamble(code) {
+  if (!/\brequire\s*\(/.test(code)) return void 0;
+  if (/\b(?:const|let|var|function)\s+require\b/.test(code) || /\bcreateRequire\b/.test(code)) {
+    return void 0;
+  }
+  return `${REQUIRE_PREAMBLE}
+`;
+}
 function preferredShell() {
   const sh = process.env.SHELL ?? "";
   if (/\/(zsh|bash)$/.test(sh) && existsSync5(sh)) return sh;
@@ -21290,13 +21298,14 @@ function availableLanguages() {
     return { id: l.id, bin };
   });
 }
-var require3, tsxPath, LANGUAGES;
+var require3, REQUIRE_PREAMBLE, tsxPath, LANGUAGES;
 var init_languages = __esm({
   "src/sandbox/languages.ts"() {
     "use strict";
     init_esm_shims();
     init_paths();
     require3 = createRequire2(import.meta.url);
+    REQUIRE_PREAMBLE = 'import { createRequire } from "node:module"; const require = createRequire(process.env.EMINIAR_PROJECT_ROOT ? process.env.EMINIAR_PROJECT_ROOT + "/package.json" : import.meta.url);';
     LANGUAGES = [
       {
         id: "shell",
@@ -21310,14 +21319,16 @@ var init_languages = __esm({
         aliases: ["js", "node", "mjs"],
         ext: ".mjs",
         detect: () => process.execPath,
-        argv: (bin, file3) => [bin, "--no-warnings", file3]
+        argv: (bin, file3) => [bin, "--no-warnings", file3],
+        preamble: requirePreamble
       },
       {
         id: "typescript",
         aliases: ["ts"],
         ext: ".ts",
         detect: () => process.execPath,
-        argv: (bin, file3) => [bin, "--no-warnings", tsxCli(), file3]
+        argv: (bin, file3) => [bin, "--no-warnings", tsxCli(), file3],
+        preamble: requirePreamble
       },
       {
         id: "python",
@@ -21524,6 +21535,10 @@ var init_terms = __esm({
 });
 
 // src/storage/sqlite/schema.ts
+function hasColumn(db, table, column) {
+  const cols = db.pragma(`table_info(${table})`);
+  return cols.some((c) => c.name === column);
+}
 function vecTableSql(dims) {
   return `CREATE VIRTUAL TABLE IF NOT EXISTS chunk_vec USING vec0(chunk_id INTEGER PRIMARY KEY, embedding float[${dims}])`;
 }
@@ -21866,7 +21881,6 @@ CREATE TABLE IF NOT EXISTS transcript_files (
   offset INTEGER NOT NULL DEFAULT 0,
   size INTEGER NOT NULL DEFAULT 0,
   mtime INTEGER NOT NULL DEFAULT 0,
-  head_hash TEXT,
   ingested_at INTEGER NOT NULL
 );
 
@@ -21894,6 +21908,16 @@ CREATE TABLE IF NOT EXISTS statusline_snapshots (
 CREATE INDEX IF NOT EXISTS statusline_snapshots_session_ts ON statusline_snapshots(session_id, ts);
 CREATE INDEX IF NOT EXISTS statusline_snapshots_ts ON statusline_snapshots(ts);
 `
+      },
+      {
+        // transcript_files.head_hash (fingerprint of the file head, so a rewrite with the same
+        // size is noticed) was first added to v5 after v5 had already run on real databases, so
+        // version-5 databases exist both with and without the column. Add it only when missing.
+        version: 6,
+        up(db) {
+          if (!hasColumn(db, "transcript_files", "head_hash"))
+            db.exec("ALTER TABLE transcript_files ADD COLUMN head_hash TEXT");
+        }
       }
     ];
   }
@@ -22013,7 +22037,8 @@ var init_adapter = __esm({
         if (pending2.length) {
           this.transaction(() => {
             for (const m of pending2) {
-              this.db.exec(m.sql);
+              if (m.sql) this.db.exec(m.sql);
+              m.up?.(this.db);
               this.metaSet("schema_version", String(m.version));
             }
           });
@@ -22232,18 +22257,42 @@ var init_adapter = __esm({
       }
       vecSearch(embedding, k, filters) {
         if (!this.vectors) return [];
-        const raw = this.db.prepare(
-          "SELECT chunk_id id, distance FROM chunk_vec WHERE embedding MATCH ? AND k = ? ORDER BY distance"
-        ).all(embedding, BigInt(filters ? k * 4 : k));
-        if (!filters || !raw.length) return raw.map((r) => ({ chunkId: r.id, distance: r.distance }));
         const { where, params } = filterSql(filters);
-        const allowed = new Set(
-          this.db.prepare(
-            `SELECT c.id FROM chunks c JOIN documents d ON d.id = c.document_id
-             WHERE c.id IN (${raw.map(() => "?").join(",")})${where}`
-          ).all(...raw.map((r) => r.id), ...params).map((r) => r.id)
-        );
-        return raw.filter((r) => allowed.has(r.id)).slice(0, k).map((r) => ({ chunkId: r.id, distance: r.distance }));
+        if (!where) return this.knn(embedding, k);
+        try {
+          return this.knn(
+            embedding,
+            k,
+            `AND chunk_id IN (SELECT c.id FROM chunks c JOIN documents d ON d.id = c.document_id WHERE 1=1${where})`,
+            params
+          );
+        } catch {
+          return this.vecSearchWidening(embedding, k, where, params);
+        }
+      }
+      knn(embedding, k, extra = "", params = []) {
+        return this.db.prepare(
+          `SELECT chunk_id id, distance FROM chunk_vec WHERE embedding MATCH ? AND k = ? ${extra} ORDER BY distance`
+        ).all(embedding, BigInt(k), ...params).map((r) => ({ chunkId: r.id, distance: r.distance }));
+      }
+      /** Fallback filtered KNN: fetch k*4, k*16, ... nearest until k pass the filter or all were seen. */
+      vecSearchWidening(embedding, k, where, params) {
+        const total = this.vecCount();
+        for (let fetch2 = k * 4; ; fetch2 *= 4) {
+          const raw = this.knn(embedding, Math.min(fetch2, total));
+          if (!raw.length) return [];
+          const allowed = /* @__PURE__ */ new Set();
+          for (let i = 0; i < raw.length; i += 400) {
+            const ids = raw.slice(i, i + 400).map((r) => r.chunkId);
+            for (const r of this.db.prepare(
+              `SELECT c.id FROM chunks c JOIN documents d ON d.id = c.document_id
+             WHERE c.id IN (${ids.map(() => "?").join(",")})${where}`
+            ).all(...ids, ...params))
+              allowed.add(r.id);
+          }
+          const hits = raw.filter((r) => allowed.has(r.chunkId)).slice(0, k);
+          if (hits.length >= k || fetch2 >= total) return hits;
+        }
       }
       unembeddedChunkIds(limit) {
         return this.db.prepare("SELECT id FROM chunks WHERE embedded = 0 ORDER BY id LIMIT ?").all(limit).map((r) => r.id);
@@ -22522,6 +22571,26 @@ var init_adapter = __esm({
         }
         return out;
       }
+      graphDependentFileCounts(paths2, kinds) {
+        const out = /* @__PURE__ */ new Map();
+        if (!paths2.length || !kinds.length) return out;
+        const kph = kinds.map(() => "?").join(",");
+        for (let i = 0; i < paths2.length; i += 400) {
+          const batch = paths2.slice(i, i + 400);
+          const pph = batch.map(() => "?").join(",");
+          for (const r of this.db.prepare(
+            `SELECT d.path p, COUNT(DISTINCT s.path) n
+             FROM graph_nodes d
+             JOIN graph_edges e ON e.dst = d.id AND e.kind IN (${kph})
+             JOIN graph_nodes s ON s.id = e.src
+            WHERE d.path IN (${pph}) AND s.path IS NOT NULL AND s.path <> d.path
+            GROUP BY d.path`
+          ).all(...kinds, ...batch)) {
+            out.set(r.p, r.n);
+          }
+        }
+        return out;
+      }
       edgesWhere(col, ids, kinds) {
         if (!ids.length) return [];
         const out = [];
@@ -30413,7 +30482,7 @@ function chunkMarkdown(text3, baseTitle, opts = DEFAULT_CHUNKER) {
     if (/^\s*(```|~~~)/.test(line)) inFence = !inFence;
     const m = !inFence && /^(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
     if (m) {
-      if (current.lines.length) sections.push(current);
+      sections.push(current);
       const level = m[1].length;
       while (stack.length && stack[stack.length - 1].level >= level) stack.pop();
       stack.push({ level, text: m[2] });
@@ -30422,14 +30491,23 @@ function chunkMarkdown(text3, baseTitle, opts = DEFAULT_CHUNKER) {
     }
     current.lines.push(line);
   });
-  if (current.lines.length) sections.push(current);
+  sections.push(current);
   const out = [];
-  for (const s of sections) {
+  sections.forEach((s, k) => {
     const title = s.path.length ? `${baseTitle} > ${s.path.join(" > ")}` : baseTitle;
     const body = s.lines.join("\n");
+    if (!body.trim()) {
+      const next = sections[k + 1];
+      const isParent = next !== void 0 && next.path.length > s.path.length && s.path.every((p, j) => next.path[j] === p);
+      if (s.path.length && !isParent) {
+        const heading = s.path[s.path.length - 1];
+        out.push({ title, body: heading, startLine: s.startLine, endLine: s.startLine });
+      }
+      return;
+    }
     if (body.length <= opts.maxChars) {
       out.push({ title, body, startLine: s.startLine, endLine: s.startLine + s.lines.length - 1 });
-      continue;
+      return;
     }
     let fence = false;
     const fenceState = s.lines.map((l) => {
@@ -30445,7 +30523,7 @@ function chunkMarkdown(text3, baseTitle, opts = DEFAULT_CHUNKER) {
         s.startLine - 1
       )
     );
-  }
+  });
   return out;
 }
 var init_markdown = __esm({
@@ -30557,7 +30635,20 @@ import { readFileSync as readFileSync10, statSync } from "fs";
 import { relative, resolve as resolve2 } from "path";
 function indexContent(db, input2) {
   const kind = input2.kind ?? (input2.contentType === "code" ? "code" : input2.contentType === "json" ? "json" : void 0);
-  const { chunks, kind: k } = input2.chunks ? { chunks: finalize2(input2.chunks, input2.contentType ?? "code"), kind: kind ?? "code" } : chunk(input2.content, input2.title, kind, input2.uri);
+  const cut = input2.chunks ? { chunks: finalize2(input2.chunks, input2.contentType ?? "code"), kind: kind ?? "code" } : chunk(input2.content, input2.title, kind, input2.uri);
+  const k = cut.kind;
+  const fallback = cut.chunks.length === 0 && input2.content.trim().length > 0;
+  const chunks = fallback ? finalize2(
+    [
+      {
+        title: input2.title,
+        body: input2.content,
+        startLine: 1,
+        endLine: input2.content.split("\n").length
+      }
+    ],
+    kindToContentType(k)
+  ) : cut.chunks;
   const contentHash = hashText(input2.content);
   const existing = input2.uri ? db.findDocumentByUri(input2.uri) : void 0;
   if (existing && existing.content_hash === contentHash) {
@@ -30567,7 +30658,8 @@ function indexContent(db, input2) {
         created: false,
         chunks: chunks.length,
         chars: input2.content.length,
-        kind: k
+        kind: k,
+        fallback
       };
     }
     db.deleteDocument(existing.id);
@@ -30584,11 +30676,25 @@ function indexContent(db, input2) {
     },
     chunks
   );
-  return { documentId: id, created, chunks: chunks.length, chars: input2.content.length, kind: k };
+  return {
+    documentId: id,
+    created,
+    chunks: chunks.length,
+    chars: input2.content.length,
+    kind: k,
+    fallback
+  };
 }
 function indexPath(db, root, target, opts = {}) {
   const abs = resolve2(root, target);
-  const summary = { files: 0, indexed: 0, unchanged: 0, skipped: [], chunks: 0 };
+  const summary = {
+    files: 0,
+    indexed: 0,
+    unchanged: 0,
+    skipped: [],
+    chunks: 0,
+    fallbacks: 0
+  };
   const st = statSync(abs);
   const files = st.isDirectory() ? import_fast_glob.default.sync(opts.globs ?? ["**/*.md"], {
     cwd: abs,
@@ -30623,6 +30729,7 @@ function indexPath(db, root, target, opts = {}) {
       if (r.created) summary.indexed++;
       else summary.unchanged++;
       summary.chunks += r.chunks;
+      if (r.fallback) summary.fallbacks++;
     } catch (err) {
       summary.skipped.push({ path: rel, reason: err.message });
     }
@@ -30698,7 +30805,7 @@ var init_em_index = __esm({
           });
           kickEmbedding(ctx, db);
           return text(
-            `${r.created ? "indexed" : "unchanged"} "${args.title}" as doc ${r.documentId}: ${r.chunks} chunks, ${r.chars} chars (${r.kind})`
+            `${r.created ? "indexed" : "unchanged"} "${args.title}" as doc ${r.documentId}: ${r.chunks} chunks, ${r.chars} chars (${r.kind})${r.fallback ? " (no sections found; indexed as one chunk)" : ""}`
           );
         }
         if (!args.path) return errorResult("provide `path` or `content`");
@@ -30708,7 +30815,7 @@ var init_em_index = __esm({
           recursive: args.recursive ?? true
         });
         const lines = [
-          `${args.path}: ${s.files} file(s), ${s.indexed} indexed, ${s.unchanged} unchanged, ${s.chunks} chunks`
+          `${args.path}: ${s.files} file(s), ${s.indexed} indexed, ${s.unchanged} unchanged, ${s.chunks} chunks${s.fallbacks ? ` (${s.fallbacks} with no sections found; indexed as one chunk)` : ""}`
         ];
         for (const sk of s.skipped.slice(0, 10)) lines.push(`  skipped ${sk.path}: ${sk.reason}`);
         if (s.skipped.length > 10) lines.push(`  \u2026 ${s.skipped.length - 10} more skipped`);
@@ -38324,6 +38431,9 @@ import { dirname as dirname9, join as join24 } from "path";
 function docsTag(name) {
   return `${DOCS_PREFIX}${name}`;
 }
+function nameFromTag(tag) {
+  return tag.startsWith(DOCS_PREFIX) ? tag.slice(DOCS_PREFIX.length) : void 0;
+}
 function isValidName2(name) {
   return NAME_RE2.test(name);
 }
@@ -40848,7 +40958,7 @@ function removeDocSource(ctx, db, name) {
   const removed = removeSource(ctx, name);
   const documents = db.deleteDocumentsBySource(docsTag(name));
   clearSyncState(db, name);
-  if (removed) syncDocsGraphQuietly(ctx, db);
+  if (removed || documents) syncDocsGraphQuietly(ctx, db);
   return { removed, documents };
 }
 function formatAdd(o) {
@@ -40903,7 +41013,8 @@ var init_add = __esm({
 var em_docs_exports = {};
 __export(em_docs_exports, {
   emDocs: () => emDocs,
-  formatDiscovery: () => formatDiscovery
+  formatDiscovery: () => formatDiscovery,
+  orphanedDocSources: () => orphanedDocSources
 });
 function toInput(a) {
   return {
@@ -40930,6 +41041,26 @@ function ago(ts) {
   if (s < 172800) return `${Math.round(s / 3600)}h ago`;
   return `${Math.round(s / 86400)}d ago`;
 }
+function orphanedDocSources(db, registered, stats = db.documentSourceStats(DOCS_PREFIX)) {
+  const known = new Set(registered);
+  const out = [];
+  for (const s of stats) {
+    const name = nameFromTag(s.source);
+    if (name === void 0 || known.has(name)) continue;
+    out.push({ name, documents: s.documents, chunks: s.chunks, latest: s.latest });
+  }
+  return out;
+}
+function formatOrphans(orphans2) {
+  const names = orphans2.map((o) => o.name);
+  return [
+    `# Orphaned in the index (${orphans2.length}; pages without a manifest entry)`,
+    ...orphans2.map(
+      (o) => `- ${o.name} \xB7 ${o.documents} doc(s) \xB7 ${o.chunks} chunks \xB7 indexed ${ago(o.latest)}`
+    ),
+    `em_docs {action:"remove", names:${JSON.stringify(names)}} drops them; {action:"add", pick:"recommended"} or {action:"add", name, url|path} re-registers.`
+  ];
+}
 function formatDiscovery(d, max = 40) {
   const lines = [];
   lines.push(
@@ -41112,19 +41243,30 @@ var init_em_docs = __esm({
             case "remove": {
               const names = [...args.name ? [args.name] : [], ...args.names ?? []];
               if (!names.length) return errorResult("remove needs `name` or `names`");
+              let unknown2 = 0;
               const lines = names.map((n) => {
                 const r = removeDocSource(ctx, db, n);
-                return r.removed ? `removed ${n} (${r.documents} document(s) dropped)` : `${n}: not registered${r.documents ? ` (${r.documents} orphan document(s) dropped)` : ""}`;
+                if (r.removed) return `removed ${n} (${r.documents} document(s) dropped)`;
+                if (r.documents) return `removed ${n} (orphaned; ${r.documents} document(s) dropped)`;
+                unknown2++;
+                return `${n}: not registered and not in the index; em_docs {action:"list"} shows both`;
               });
-              return done(lines.join("\n"));
+              const out = lines.join("\n");
+              return unknown2 === names.length ? errorResult(out) : done(out);
             }
             case "list": {
               const m = readManifest(ctx);
-              if (!m.sources.length)
-                return done(
-                  `no documentation sources registered (${manifestPath(ctx)}). em_docs {action:"discover"} finds local docs and the libraries, services and APIs this project uses.`
-                );
-              const stats = new Map(db.documentSourceStats(DOCS_PREFIX).map((s) => [s.source, s]));
+              const sourceStats = db.documentSourceStats(DOCS_PREFIX);
+              const orphans2 = orphanedDocSources(
+                db,
+                m.sources.map((s) => s.name),
+                sourceStats
+              );
+              if (!m.sources.length) {
+                const none = `no documentation sources registered (${manifestPath(ctx)}). em_docs {action:"discover"} finds local docs and the libraries, services and APIs this project uses.`;
+                return done(orphans2.length ? [none, "", ...formatOrphans(orphans2)].join("\n") : none);
+              }
+              const stats = new Map(sourceStats.map((s) => [s.source, s]));
               const catalog = mergedCatalog(ctx.config.docs.catalog);
               const categorised = m.sources.map((s) => ({
                 s,
@@ -41155,9 +41297,10 @@ var init_em_docs = __esm({
                   `- ${s.name} [${s.kind}]${s.provider ? ` \u2190 ${s.provider}` : ""}${s.tags?.length ? ` (${s.tags.join(", ")})` : ""} \xB7 ${st?.documents ?? 0} doc(s) \xB7 ${st?.chunks ?? 0} chunks \xB7 ${state} \xB7 ${where}`
                 );
               }
+              if (orphans2.length) lines.push("", ...formatOrphans(orphans2));
               lines.push(
                 "",
-                `${m.sources.length} source(s); em_docs {action:"lookup", query} searches them all, {action:"sync"} refreshes.`
+                `${m.sources.length} source(s)${orphans2.length ? ` + ${orphans2.length} orphaned` : ""}; em_docs {action:"lookup", query} searches them all, {action:"sync"} refreshes.`
               );
               return done(lines.join("\n"));
             }
@@ -41203,10 +41346,18 @@ ${r.urls.map((u) => `  ${u}`).join("\n")}
                 raw += r.hits.reduce((n, h) => n + h.chunk.body.length, 0);
                 responses.push(r);
               }
-              const out = formatResults(
-                responses,
-                args.max_tokens ?? ctx.config.search.defaultMaxTokens
+              let out = formatResults(responses, args.max_tokens ?? ctx.config.search.defaultMaxTokens);
+              const hitSources = new Set(
+                responses.flatMap((r) => r.hits.map((h) => h.chunk.document.source))
               );
+              const orphaned = orphanedDocSources(
+                db,
+                m.sources.map((s) => s.name)
+              ).filter((o) => hitSources.has(docsTag(o.name)));
+              if (orphaned.length)
+                out += `
+
+note: ${orphaned.map((o) => o.name).join(", ")} ${orphaned.length === 1 ? "is" : "are"} not in the manifest (orphaned pages); em_docs {action:"list"} explains`;
               recordStat(ctx, "em_docs", {
                 rawChars: raw,
                 returnedChars: out.length,
@@ -42467,6 +42618,9 @@ function memoriesForFile(db, rel, opts = {}) {
     trace
   };
 }
+function dependentFiles(db, paths2) {
+  return db.graphDependentFileCounts(paths2, DEPENDENCY_KINDS);
+}
 function riskLine(path3, f) {
   if (f.risk < RISKY && !f.bugOrigins) return void 0;
   const parts = [`${f.fixes}/${f.commits} commits were fixes`];
@@ -42494,10 +42648,10 @@ function fileContext(db, rel, opts = {}) {
   }
   const fanKey = `fanin:${rel}`;
   if (opts.edit && !seen.has(fanKey)) {
-    const fanIn = db.metricsGet([fileId(rel)])[0]?.fan_in ?? 0;
-    if (fanIn >= FAN_IN) {
+    const dependents = dependentFiles(db, [rel]).get(rel) ?? 0;
+    if (dependents >= FAN_IN) {
       lines.push(
-        `eminiar graph: ${rel} is imported by ${fanIn} files; em_graph_impact {node:"${fileId(rel)}"} lists them before you change an exported signature.`
+        `eminiar graph: ${rel} is imported by ${dependents} files; em_graph_impact {node:"${fileId(rel)}"} lists them before you change an exported signature.`
       );
       keys.push(fanKey);
     }
@@ -42554,6 +42708,7 @@ var init_recall = __esm({
     "use strict";
     init_esm_shims();
     init_ids();
+    init_metrics();
     init_model();
     init_pipeline();
     init_query();
@@ -44546,12 +44701,17 @@ function usageLine(ctx, sessionId) {
   if (!usageEnabled(ctx)) return void 0;
   try {
     const db = getStorage(ctx);
-    ingestSession(db, ctx.root, sessionId, void 0, { overrides: ctx.config.usage.pricing });
+    let failed;
+    try {
+      ingestSession(db, ctx.root, sessionId, void 0, { overrides: ctx.config.usage.pricing });
+    } catch (err) {
+      failed = `usage: ingest failed: ${err.message}`;
+    }
     const b = usageBrief(db, ctx, { sessionId });
-    if (!b.todayUsd && !b.sessionUsd) return void 0;
-    return `usage: today ${formatUsd(b.todayUsd)} \xB7 session ${formatUsd(b.sessionUsd)} \xB7 see em_usage`;
-  } catch {
-    return void 0;
+    const line = b.todayUsd || b.sessionUsd ? `usage: today ${formatUsd(b.todayUsd)} \xB7 session ${formatUsd(b.sessionUsd)} \xB7 see em_usage` : void 0;
+    return [line, failed].filter((s) => s).join("\n") || void 0;
+  } catch (err) {
+    return `usage: unavailable: ${err.message}`;
   }
 }
 function mergeByTool(rows) {
@@ -45825,7 +45985,10 @@ var init_em_search = __esm({
           }
         }
         const out = formatResults(responses, args.max_tokens ?? ctx.config.search.defaultMaxTokens);
-        const note = mode !== "lexical" && mode !== "regex" && !vectorSearch && ctx.config.embeddings.enabled ? "\n\n(embeddings: model still loading \u2014 lexical results only this time)" : "";
+        let note = mode !== "lexical" && mode !== "regex" && !vectorSearch && ctx.config.embeddings.enabled ? "\n\n(embeddings: model still loading \u2014 lexical results only this time)" : "";
+        const sources = Array.isArray(args.source) ? args.source : args.source ? [args.source] : [];
+        if (mode === "semantic" && !ctx.config.docs.embed && sources.some((s) => s.startsWith("docs:")) && responses.every((r) => r.hits.length === 0))
+          note += '\n\n(docs:* pages are indexed without vectors because docs.embed is off; use mode "hybrid" or "lexical", or set docs.embed: true in eminiar.config.json and em_docs {action:"sync", force:true})';
         recordStat(ctx, "em_search", {
           rawChars: responses.reduce(
             (a, r) => a + r.hits.reduce((b, h) => b + h.chunk.body.length, 0),
@@ -49037,7 +49200,8 @@ try {
 } catch (err) {
   console.error(`eminiar ${cmd} failed: ${err.message}`);
   if (process.env.EMINIAR_DEBUG) console.error(err.stack);
-  if (cmd !== "doctor") console.error(formatDoctor(runDoctor()));
+  if (cmd === "usage") console.error("run `eminiar doctor` to check the installation");
+  else if (cmd !== "doctor") console.error(formatDoctor(runDoctor()));
   process.exit(1);
 }
 /*! Bundled license information: