@ncukondo/reference-manager 0.24.0 → 0.25.0

package/dist/chunks/{index-DVsuPpMS.js → index-PQkbePWV.js}

@@ -1,5 +1,5 @@
-import { a } from "./index-DWAtvFtp.js";
-import { d, g, l, o, s } from "./index-ChvsE9WF.js";
+import { a } from "./index-D2HsxXnK.js";
+import { d, g, l, o, s } from "./index-QTYx5RaF.js";
 export {
   a as addAttachment,
   d as detachAttachment,
@@ -8,4 +8,4 @@ export {
   o as openAttachment,
   s as syncAttachments
 };
-//# sourceMappingURL=index-DVsuPpMS.js.map
+//# sourceMappingURL=index-PQkbePWV.js.map

package/dist/chunks/index-PQkbePWV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-PQkbePWV.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/chunks/{index-ChvsE9WF.js → index-QTYx5RaF.js}

@@ -5,9 +5,9 @@ import { promises, readFileSync, existsSync, mkdirSync, writeFileSync } from "no
 import * as os from "node:os";
 import * as path from "node:path";
 import path__default, { join, basename, dirname } from "node:path";
-import { n as normalizePathForOutput, d as deleteDirectoryIfEmpty, p as parseFilename, i as isReservedRole, e as ensureDirectory, a as addAttachment, R as RESERVED_ROLES, g as generateFilename, b as findFulltextFiles, c as findFulltextFile, h as extensionToFormat, j as fulltextAttach, k as fulltextGet, l as fulltextDiscover, m as fulltextFetch, o as fulltextConvert, q as getExtension, r as getDefaultExportFromCjs, B as BUILTIN_STYLES, s as getFulltextAttachmentTypes, t as startServerWithFileWatcher } from "./index-DWAtvFtp.js";
+import { n as normalizePathForOutput, d as deleteDirectoryIfEmpty, p as parseFilename, i as isReservedRole, e as ensureDirectory, a as addAttachment, R as RESERVED_ROLES, b as generateFilename, c as findFulltextFiles, h as findFulltextFile, j as extensionToFormat, k as fulltextAttach, l as fulltextGet, m as fulltextDiscover, o as fulltextFetch, q as fulltextConvert, r as getExtension, s as getDefaultExportFromCjs, B as BUILTIN_STYLES, t as getFulltextAttachmentTypes, u as startServerWithFileWatcher } from "./index-D2HsxXnK.js";
 import { readFile, unlink, stat, readdir, rename } from "node:fs/promises";
-import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-CV71qNY2.js";
+import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-B-fte1uv.js";
 import { spawn, spawnSync } from "node:child_process";
 import process$1, { stdin, stdout } from "node:process";
 import * as readline from "node:readline";
@@ -19,7 +19,7 @@ import "@citation-js/plugin-csl";
 import { ZodOptional as ZodOptional$2, z } from "zod";
 import { serve } from "@hono/node-server";
 const name = "@ncukondo/reference-manager";
-const version$1 = "0.24.0";
+const version$1 = "0.25.0";
 const description$1 = "A local reference management tool using CSL-JSON as the single source of truth";
 const packageJson = {
   name,
@@ -902,15 +902,15 @@ class OperationsLibrary {
   }
   // High-level operations
   async search(options) {
-    const { searchReferences } = await import("./index-DWAtvFtp.js").then((n) => n.A);
+    const { searchReferences } = await import("./index-D2HsxXnK.js").then((n) => n.E);
     return searchReferences(this.library, options);
   }
   async list(options) {
-    const { listReferences } = await import("./index-DWAtvFtp.js").then((n) => n.z);
+    const { listReferences } = await import("./index-D2HsxXnK.js").then((n) => n.D);
     return listReferences(this.library, options ?? {});
   }
   async cite(options) {
-    const { citeReferences } = await import("./index-DWAtvFtp.js").then((n) => n.y);
+    const { citeReferences } = await import("./index-D2HsxXnK.js").then((n) => n.C);
     const defaultStyle = options.defaultStyle ?? this.citationConfig?.defaultStyle;
     const cslDirectory = options.cslDirectory ?? this.citationConfig?.cslDirectory;
     const mergedOptions = {
@@ -921,32 +921,36 @@ class OperationsLibrary {
     return citeReferences(this.library, mergedOptions);
   }
   async import(inputs, options) {
-    const { addReferences } = await import("./index-DWAtvFtp.js").then((n) => n.x);
+    const { addReferences } = await import("./index-D2HsxXnK.js").then((n) => n.z);
     return addReferences(inputs, this.library, options ?? {});
   }
+  async check(options) {
+    const { checkReferences } = await import("./index-D2HsxXnK.js").then((n) => n.A);
+    return checkReferences(this.library, options);
+  }
   // Attachment operations
   async attachAdd(options) {
-    const { addAttachment: addAttachment2 } = await import("./index-DVsuPpMS.js");
+    const { addAttachment: addAttachment2 } = await import("./index-PQkbePWV.js");
     return addAttachment2(this.library, options);
   }
   async attachList(options) {
-    const { listAttachments: listAttachments2 } = await import("./index-DVsuPpMS.js");
+    const { listAttachments: listAttachments2 } = await import("./index-PQkbePWV.js");
     return listAttachments2(this.library, options);
   }
   async attachGet(options) {
-    const { getAttachment: getAttachment2 } = await import("./index-DVsuPpMS.js");
+    const { getAttachment: getAttachment2 } = await import("./index-PQkbePWV.js");
     return getAttachment2(this.library, options);
   }
   async attachDetach(options) {
-    const { detachAttachment: detachAttachment2 } = await import("./index-DVsuPpMS.js");
+    const { detachAttachment: detachAttachment2 } = await import("./index-PQkbePWV.js");
     return detachAttachment2(this.library, options);
   }
   async attachSync(options) {
-    const { syncAttachments: syncAttachments2 } = await import("./index-DVsuPpMS.js");
+    const { syncAttachments: syncAttachments2 } = await import("./index-PQkbePWV.js");
     return syncAttachments2(this.library, options);
   }
   async attachOpen(options) {
-    const { openAttachment: openAttachment2 } = await import("./index-DVsuPpMS.js");
+    const { openAttachment: openAttachment2 } = await import("./index-PQkbePWV.js");
     return openAttachment2(this.library, options);
   }
 }
@@ -1084,6 +1088,18 @@ class ServerClient {
     }
     return await response.json();
   }
+  async check(options) {
+    const url2 = `${this.baseUrl}/api/check`;
+    const response = await fetch(url2, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(options)
+    });
+    if (!response.ok) {
+      throw new Error(await response.text());
+    }
+    return await response.json();
+  }
   /**
    * Generate citations for references.
    * @param options - Cite options including identifiers and formatting
@@ -1790,7 +1806,7 @@ function getAttachExitCode(result) {
 }
 async function executeInteractiveSelect$2(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-CrOVXP7v.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Qpgt9cbN.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -2281,6 +2297,192 @@ const attach = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProper
   runInteractiveMode,
   syncNewFilesWithRolePrompt
 }, Symbol.toStringTag, { value: "Module" }));
+function buildCheckOptions(options, appConfig) {
+  const opOptions = {};
+  if (options.all) {
+    opOptions.all = true;
+  } else if (options.search) {
+    opOptions.searchQuery = options.search;
+  } else if (options.identifiers.length > 0) {
+    opOptions.identifiers = options.identifiers;
+  }
+  if (options.uuid) {
+    opOptions.idType = "uuid";
+  }
+  if (options.days !== void 0) {
+    opOptions.skipDays = options.days;
+  }
+  if (options.noSave) {
+    opOptions.save = false;
+  }
+  if (appConfig) {
+    const pubmed = {};
+    if (appConfig.pubmed.email) pubmed.email = appConfig.pubmed.email;
+    if (appConfig.pubmed.apiKey) pubmed.apiKey = appConfig.pubmed.apiKey;
+    opOptions.config = {
+      ...appConfig.email ? { email: appConfig.email } : {},
+      pubmed
+    };
+  }
+  return opOptions;
+}
+async function executeCheck(options, context, appConfig) {
+  return context.library.check(buildCheckOptions(options, appConfig));
+}
+function getStatusLabel(result) {
+  if (result.status === "skipped") return "[SKIPPED]";
+  if (result.status === "ok") return "[OK]";
+  const finding = result.findings[0];
+  if (!finding) return "[WARNING]";
+  switch (finding.type) {
+    case "retracted":
+      return "[RETRACTED]";
+    case "concern":
+      return "[CONCERN]";
+    case "version_changed":
+      return "[VERSION]";
+    case "metadata_changed":
+      return "[METADATA]";
+    default:
+      return "[WARNING]";
+  }
+}
+function formatFindingDetails(finding) {
+  const lines = [];
+  lines.push(`  ${finding.message}`);
+  if (finding.details?.retractionDoi) {
+    lines.push(`  Retraction notice: https://doi.org/${finding.details.retractionDoi}`);
+  }
+  if (finding.details?.newDoi) {
+    lines.push(`  New DOI: https://doi.org/${finding.details.newDoi}`);
+  }
+  return lines;
+}
+function formatCheckTextOutput(result) {
+  const lines = [];
+  for (const r of result.results) {
+    const label = getStatusLabel(r);
+    lines.push(`${label} ${r.id}`);
+    for (const finding of r.findings) {
+      lines.push(...formatFindingDetails(finding));
+    }
+    lines.push("");
+  }
+  const { summary } = result;
+  const parts = [`${summary.total} checked`];
+  if (summary.warnings > 0) parts.push(`${summary.warnings} warning(s)`);
+  if (summary.ok > 0) parts.push(`${summary.ok} ok`);
+  if (summary.skipped > 0) parts.push(`${summary.skipped} skipped`);
+  lines.push(`Summary: ${parts.join(", ")}`);
+  return lines.join("\n");
+}
+function formatCheckJsonOutput(result, options) {
+  if (!options?.full || !options.items) {
+    return result;
+  }
+  const results = result.results.map((r) => {
+    const item = options.items?.get(r.id);
+    return item ? { ...r, item } : r;
+  });
+  return { ...result, results };
+}
+async function handleCheckAction(identifiers, options, globalOpts) {
+  const outputFormat = options.output ?? "text";
+  if (options.fix && !isTTY()) {
+    outputCheckError(new Error("--fix requires an interactive terminal (TTY)"), outputFormat);
+    setExitCode(ExitCode.ERROR);
+    return;
+  }
+  try {
+    const config2 = await loadConfigWithOverrides({ ...globalOpts, ...options });
+    const context = await createExecutionContext(config2, Library.load);
+    const ids = await resolveIdentifiers$1(identifiers, options, context, config2);
+    if (ids === null) return;
+    const result = await executeCheck({ ...options, identifiers: ids }, context, config2);
+    const needAllRefs = options.full && outputFormat === "json" || options.fix;
+    const allRefs = needAllRefs ? await context.library.getAll() : void 0;
+    const jsonOptions = buildJsonOptionsFromRefs(options, outputFormat, result, allRefs);
+    outputCheckResult(result, outputFormat, jsonOptions);
+    if (options.fix && result.summary.warnings > 0 && allRefs) {
+      const { runFixInteraction } = await import("./fix-interaction-BpfMLRNY.js");
+      const findItem = (id2) => allRefs.find((item) => item.id === id2);
+      const fixResult = await runFixInteraction(result.results, context.library, findItem);
+      const removedSuffix = fixResult.removed.length > 0 ? `, ${fixResult.removed.length} removed` : "";
+      process.stderr.write(
+        `
+Fix summary: ${fixResult.applied} applied, ${fixResult.skipped} skipped${removedSuffix}
+`
+      );
+    }
+    setExitCode(ExitCode.SUCCESS);
+  } catch (error) {
+    outputCheckError(error, outputFormat);
+    setExitCode(ExitCode.ERROR);
+  }
+}
+function buildJsonOptionsFromRefs(options, outputFormat, result, allRefs) {
+  if (!options.full || outputFormat !== "json" || !allRefs) return void 0;
+  const items2 = /* @__PURE__ */ new Map();
+  for (const r of result.results) {
+    const item = allRefs.find((ref2) => ref2.id === r.id);
+    if (item) items2.set(r.id, item);
+  }
+  return { full: true, items: items2 };
+}
+async function resolveIdentifiers$1(identifiers, options, context, config2) {
+  if (identifiers.length > 0 || options.all || options.search) {
+    return identifiers;
+  }
+  if (isTTY()) {
+    const ids = await selectReferencesInteractively(context, config2);
+    if (ids.length === 0) {
+      setExitCode(ExitCode.SUCCESS);
+      return null;
+    }
+    return ids;
+  }
+  const stdinIds = await readIdentifiersFromStdin();
+  if (stdinIds.length === 0) {
+    process.stderr.write(
+      "Error: No identifiers provided. Provide IDs, use --all, --search, or run interactively.\n"
+    );
+    setExitCode(ExitCode.ERROR);
+    return null;
+  }
+  return stdinIds;
+}
+function outputCheckResult(result, format2, jsonOptions) {
+  if (format2 === "json") {
+    process.stdout.write(`${JSON.stringify(formatCheckJsonOutput(result, jsonOptions))}
+`);
+  } else {
+    process.stderr.write(`${formatCheckTextOutput(result)}
+`);
+  }
+}
+function outputCheckError(error, format2) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (format2 === "json") {
+    process.stdout.write(`${JSON.stringify({ error: message })}
+`);
+  } else {
+    process.stderr.write(`Error: ${message}
+`);
+  }
+}
+async function selectReferencesInteractively(context, config2) {
+  const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
+  const { selectReferenceItemsOrExit } = await import("./reference-select-Qpgt9cbN.js");
+  const allReferences = await context.library.getAll();
+  if (allReferences.length === 0) {
+    process.stderr.write("No references in library.\n");
+    return [];
+  }
+  const selectedItems = await withAlternateScreen2(
+    () => selectReferenceItemsOrExit(allReferences, { multiSelect: true }, config2.cli.tui)
+  );
+  return selectedItems.map((item) => item.id);
+}
 async function validateOptions$2(options) {
   if (options.output && !["text", "html", "rtf"].includes(options.output)) {
     throw new Error(`Invalid output format '${options.output}'. Must be one of: text, html, rtf`);
@@ -2338,8 +2540,8 @@ function getCiteExitCode(result) {
 }
 async function executeInteractiveCite(options, context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { runCiteFlow } = await import("./index-CKY11DzK.js");
-  const { buildStyleChoices, listCustomStyles } = await import("./style-select-BVP0KQz4.js");
+  const { runCiteFlow } = await import("./index-CYEise6v.js");
+  const { buildStyleChoices, listCustomStyles } = await import("./style-select-mEMoWbM2.js");
   const { search } = await import("./file-watcher-Dlx0PolG.js").then((n) => n.B);
   const { tokenize } = await import("./file-watcher-Dlx0PolG.js").then((n) => n.A);
   const { checkTTY } = await import("./tty-BMyaEOhX.js");
@@ -2419,6 +2621,7 @@ async function handleCiteAction(identifiers, options, globalOpts) {
 }
 const ENV_OVERRIDE_MAP = {
   REFERENCE_MANAGER_LIBRARY: "library",
+  EMAIL: "email",
   REFERENCE_MANAGER_ATTACHMENTS_DIR: "attachments.directory",
   REFERENCE_MANAGER_CLI_DEFAULT_LIMIT: "cli.default_limit",
   REFERENCE_MANAGER_MCP_DEFAULT_LIMIT: "mcp.default_limit",
@@ -2454,6 +2657,7 @@ const CONFIG_KEY_REGISTRY = [
     description: "Log level",
     enumValues: ["silent", "info", "debug"]
   },
+  { key: "email", type: "string", description: "Fallback email for API services", optional: true },
   // backup section
   { key: "backup.max_generations", type: "integer", description: "Maximum backup generations" },
   { key: "backup.max_age_days", type: "integer", description: "Maximum backup age in days" },
@@ -6938,7 +7142,7 @@ function formatEditOutput(result) {
 }
 async function executeInteractiveEdit(options, context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-CrOVXP7v.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Qpgt9cbN.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: true }, config2.cli.tui)
@@ -10479,7 +10683,7 @@ function getFulltextExitCode(result) {
 }
 async function executeInteractiveSelect$1(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-CrOVXP7v.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Qpgt9cbN.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -31328,6 +31532,53 @@ function registerAddTool(server, getLibraryOperations) {
     }
   );
 }
+function formatCheckResult(result) {
+  const lines = [];
+  for (const r of result.results) {
+    if (r.status === "ok") {
+      lines.push(`[OK] ${r.id}`);
+    } else if (r.status === "skipped") {
+      lines.push(`[SKIPPED] ${r.id}`);
+    } else {
+      for (const f of r.findings) {
+        lines.push(`[${f.type.toUpperCase()}] ${r.id}: ${f.message}`);
+      }
+    }
+  }
+  const { summary } = result;
+  lines.push(
+    `
+Summary: ${summary.total} checked, ${summary.ok} ok, ${summary.warnings} warnings, ${summary.skipped} skipped`
+  );
+  return lines.join("\n");
+}
+function registerCheckTool(server, getLibraryOperations) {
+  server.registerTool(
+    "check",
+    {
+      description: "Check references for retractions, expressions of concern, and version changes by querying Crossref and PubMed APIs.",
+      inputSchema: {
+        ids: z.array(z.string()).optional().describe("Array of reference IDs to check. Omit if using 'all'."),
+        all: z.boolean().optional().describe("Check all references in library"),
+        skipDays: z.number().optional().describe("Skip references checked within n days (default: 7)"),
+        save: z.boolean().optional().describe("Whether to save results to library (default: true)")
+      }
+    },
+    async (args) => {
+      const libraryOps = getLibraryOperations();
+      const options = {};
+      if (args.ids?.length) options.identifiers = args.ids;
+      if (args.all) options.all = true;
+      if (args.skipDays !== void 0) options.skipDays = args.skipDays;
+      if (args.save !== void 0) options.save = args.save;
+      const result = await libraryOps.check(options);
+      const text = formatCheckResult(result);
+      return {
+        content: [{ type: "text", text }]
+      };
+    }
+  );
+}
 function registerCiteTool(server, getLibraryOperations) {
   server.registerTool(
     "cite",
@@ -31718,6 +31969,7 @@ function registerAllTools(server, getLibraryOperations, getConfig) {
   registerSearchTool(server, getLibraryOperations, getConfig);
   registerListTool(server, getLibraryOperations, getConfig);
   registerCiteTool(server, getLibraryOperations);
+  registerCheckTool(server, getLibraryOperations);
   registerAddTool(server, getLibraryOperations);
   registerRemoveTool(server, getLibraryOperations);
   registerFulltextAttachTool(server, getLibraryOperations, getConfig);
@@ -31779,7 +32031,7 @@ async function mcpStart(options) {
 async function executeRemove(options, context) {
   const { identifier, idType = "id", fulltextDirectory, deleteFulltext = false } = options;
   if (context.mode === "local" && deleteFulltext && fulltextDirectory) {
-    const { removeReference } = await import("./index-DWAtvFtp.js").then((n) => n.w);
+    const { removeReference } = await import("./index-D2HsxXnK.js").then((n) => n.x);
     return removeReference(context.library, {
       identifier,
       idType,
@@ -31834,7 +32086,7 @@ Continue?`;
 }
 async function executeInteractiveRemove(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferenceItemsOrExit } = await import("./reference-select-CrOVXP7v.js");
+  const { selectReferenceItemsOrExit } = await import("./reference-select-Qpgt9cbN.js");
   const allReferences = await context.library.getAll();
   const selectedItems = await withAlternateScreen2(
     () => selectReferenceItemsOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -32059,7 +32311,7 @@ async function executeInteractiveSearch(options, context, config2) {
   validateInteractiveOptions(options);
   const { checkTTY } = await import("./tty-BMyaEOhX.js");
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { runSearchFlow } = await import("./index-CKY11DzK.js");
+  const { runSearchFlow } = await import("./index-CYEise6v.js");
   const { search } = await import("./file-watcher-Dlx0PolG.js").then((n) => n.B);
   const { tokenize } = await import("./file-watcher-Dlx0PolG.js").then((n) => n.A);
   checkTTY();
@@ -32078,7 +32330,7 @@ async function executeInteractiveSearch(options, context, config2) {
     })
   );
   if (result.selectedItems && !result.cancelled) {
-    const { isSideEffectAction } = await import("./action-menu-ByDpq-KF.js");
+    const { isSideEffectAction } = await import("./action-menu-DD0RtNVD.js");
     if (isSideEffectAction(result.action)) {
       await executeSideEffectAction(result.action, result.selectedItems, context, config2);
       return { output: "", cancelled: false, action: result.action };
@@ -32094,7 +32346,7 @@ async function executeSideEffectAction(action, items2, context, config2) {
   switch (action) {
     case "open-url": {
       const { resolveDefaultUrl: resolveDefaultUrl2 } = await Promise.resolve().then(() => url);
-      const { openWithSystemApp: openWithSystemApp2 } = await import("./loader-CV71qNY2.js").then((n) => n.j);
+      const { openWithSystemApp: openWithSystemApp2 } = await import("./loader-B-fte1uv.js").then((n) => n.j);
       const item = items2[0];
       if (!item) return;
       const url$1 = resolveDefaultUrl2(item);
@@ -32481,7 +32733,7 @@ function formatUpdateOutput(result, identifier) {
 }
 async function executeInteractiveUpdate(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-CrOVXP7v.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Qpgt9cbN.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -32776,7 +33028,7 @@ function getUrlExitCode(result) {
 }
 async function executeInteractiveSelect(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-CrOVXP7v.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Qpgt9cbN.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -33102,6 +33354,33 @@ function registerCompletionCommand(program) {
     }
   });
 }
+function buildSearchHelpText() {
+  return `
+QUERY SYNTAX
+  Free text      machine learning       Search all fields (AND logic)
+  Phrase         "machine learning"     Exact phrase match
+  Field          author:Smith           Search specific field
+  Field+Phrase   author:"John Smith"    Field with phrase
+
+FIELDS
+  author, title, year, doi, pmid, pmcid, isbn, url, keyword, tag, id
+
+CASE SENSITIVITY
+  Consecutive uppercase (2+ letters) is case-sensitive:
+    AI    → matches "AI therapy", not "ai therapy"
+    RNA   → matches "mRNA synthesis", not "mrna synthesis"
+  Other text is case-insensitive:
+    api   → matches "API", "api", "Api"
+
+EXAMPLES
+  $ ref search "machine learning"
+  $ ref search author:Smith year:2020
+  $ ref search author:"John Smith" title:introduction
+  $ ref search tag:review --sort published --order desc
+  $ ref search AI therapy                  # AI is case-sensitive
+  $ ref search id:smith2023 --output json
+  $ ref search --tui                       # Interactive mode`;
+}
 function createProgram() {
   const program = new Command();
   program.name("reference-manager").version(packageJson.version).description(packageJson.description);
@@ -33120,6 +33399,7 @@ function createProgram() {
   registerRemoveCommand(program);
   registerUpdateCommand(program);
   registerEditCommand(program);
+  registerCheckCommand(program);
   registerCiteCommand(program);
   registerServerCommand(program);
   registerFulltextCommand(program);
@@ -33219,7 +33499,9 @@ async function handleSearchAction(query, options, program) {
   }
 }
 function registerSearchCommand(program) {
-  program.command("search").description("Search references").argument("[query]", "Search query (required unless using --tui)").option("-t, --tui", "Enable TUI (interactive) search mode").option(
+  program.command("search").description(
+    "Search references in the library.\n\nSupports field-specific search with field:value syntax and phrase search\nwith quoted strings. Consecutive uppercase letters (AI, RNA) are matched\ncase-sensitively; other text is matched case-insensitively."
+  ).argument("[query]", "Search query (required unless using --tui)").addHelpText("after", buildSearchHelpText()).option("-t, --tui", "Enable TUI (interactive) search mode").option(
     "-o, --output <format>",
     "Output format: pretty|json|bibtex|ids|uuid|pandoc-key|latex-key"
   ).option("--json", "Alias for --output json").option("--bibtex", "Alias for --output bibtex").option("--ids-only", "Alias for --output ids").option("--uuid-only", "Alias for --output uuid").option("-k, --key", "Output citation keys (uses citation.default_key_format config)").option("--pandoc-key", "Alias for --output pandoc-key").option("--latex-key", "Alias for --output latex-key").option("--sort <field>", "Sort by field: created|updated|published|author|title|relevance").option("--order <order>", "Sort order: asc|desc").option("-n, --limit <n>", "Maximum number of results", Number.parseInt).option("--offset <n>", "Number of results to skip", Number.parseInt).action(async (query, options) => {
@@ -33279,7 +33561,7 @@ function shouldAutoFetch(cliFlag, configEnabled) {
   return configEnabled;
 }
 async function performAutoFetch(addedItems, context, config2) {
-  const { fulltextFetch: fulltextFetch2 } = await import("./index-DWAtvFtp.js").then((n) => n.v);
+  const { fulltextFetch: fulltextFetch2 } = await import("./index-D2HsxXnK.js").then((n) => n.w);
   const fetchResults = await autoFetchFulltext(addedItems, context, {
     fulltextConfig: config2.fulltext,
     fulltextDirectory: config2.attachments.directory,
@@ -33359,6 +33641,11 @@ function registerEditCommand(program) {
     await handleEditAction(identifiers, options, program.opts());
   });
 }
+function registerCheckCommand(program) {
+  program.command("check").description("Check references for retractions, expressions of concern, and version changes").argument("[ids...]", "Citation keys or UUIDs to check (interactive selection if omitted)").option("--all", "Check all references in library").option("--search <query>", "Check references matching search query").option("--uuid", "Interpret identifiers as UUIDs").option("-o, --output <format>", "Output format: text|json", "text").option("--full", "Include full details in JSON output").option("--no-save", "Report only, do not save results to library").option("--days <n>", "Skip references checked within n days (default: 7)", Number.parseInt).option("--fix", "Interactive repair for findings (TTY only)").action(async (ids, options) => {
+    await handleCheckAction(ids, options, program.opts());
+  });
+}
 function registerCiteCommand(program) {
   program.command("cite").description("Generate formatted citations for references").argument(
     "[id-or-uuid...]",
@@ -33558,4 +33845,4 @@ export {
   restoreStdinAfterInk as r,
   syncAttachments as s
 };
-//# sourceMappingURL=index-ChvsE9WF.js.map
+//# sourceMappingURL=index-QTYx5RaF.js.map