@ncukondo/reference-manager 0.23.3 → 0.24.1

package/dist/chunks/{index-CFwvg1Ju.js → index-JA964gjc.js}

@@ -1,13 +1,13 @@
 import { Command, Option } from "commander";
-import { i as isEqual, M as MANAGED_CUSTOM_FIELDS, w as writeFileAtomic, L as Library, h as CslItemSchema, p as pickDefined, a as sortOrderSchema, z as paginationOptionsSchema, F as FileWatcher, b as sortFieldSchema, y as searchSortFieldSchema } from "./file-watcher-Dyns9dxx.js";
+import { i as isEqual, M as MANAGED_CUSTOM_FIELDS, w as writeFileAtomic, L as Library, h as CslItemSchema, p as pickDefined, a as sortOrderSchema, z as paginationOptionsSchema, F as FileWatcher, b as sortFieldSchema, y as searchSortFieldSchema } from "./file-watcher-Dlx0PolG.js";
 import * as fs from "node:fs";
 import { promises, readFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 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-7R-uEYOu.js";
+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 { readFile, unlink, stat, readdir, rename } from "node:fs/promises";
-import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-DOYCI2xk.js";
+import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-CV71qNY2.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.23.3";
+const version$1 = "0.24.1";
 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-7R-uEYOu.js").then((n) => n.A);
+    const { searchReferences } = await import("./index-DWAtvFtp.js").then((n) => n.A);
     return searchReferences(this.library, options);
   }
   async list(options) {
-    const { listReferences } = await import("./index-7R-uEYOu.js").then((n) => n.z);
+    const { listReferences } = await import("./index-DWAtvFtp.js").then((n) => n.z);
     return listReferences(this.library, options ?? {});
   }
   async cite(options) {
-    const { citeReferences } = await import("./index-7R-uEYOu.js").then((n) => n.y);
+    const { citeReferences } = await import("./index-DWAtvFtp.js").then((n) => n.y);
     const defaultStyle = options.defaultStyle ?? this.citationConfig?.defaultStyle;
     const cslDirectory = options.cslDirectory ?? this.citationConfig?.cslDirectory;
     const mergedOptions = {
@@ -921,32 +921,32 @@ class OperationsLibrary {
     return citeReferences(this.library, mergedOptions);
   }
   async import(inputs, options) {
-    const { addReferences } = await import("./index-7R-uEYOu.js").then((n) => n.x);
+    const { addReferences } = await import("./index-DWAtvFtp.js").then((n) => n.x);
     return addReferences(inputs, this.library, options ?? {});
   }
   // Attachment operations
   async attachAdd(options) {
-    const { addAttachment: addAttachment2 } = await import("./index-Dotd2g8H.js");
+    const { addAttachment: addAttachment2 } = await import("./index-zafRwZEZ.js");
     return addAttachment2(this.library, options);
   }
   async attachList(options) {
-    const { listAttachments: listAttachments2 } = await import("./index-Dotd2g8H.js");
+    const { listAttachments: listAttachments2 } = await import("./index-zafRwZEZ.js");
     return listAttachments2(this.library, options);
   }
   async attachGet(options) {
-    const { getAttachment: getAttachment2 } = await import("./index-Dotd2g8H.js");
+    const { getAttachment: getAttachment2 } = await import("./index-zafRwZEZ.js");
     return getAttachment2(this.library, options);
   }
   async attachDetach(options) {
-    const { detachAttachment: detachAttachment2 } = await import("./index-Dotd2g8H.js");
+    const { detachAttachment: detachAttachment2 } = await import("./index-zafRwZEZ.js");
     return detachAttachment2(this.library, options);
   }
   async attachSync(options) {
-    const { syncAttachments: syncAttachments2 } = await import("./index-Dotd2g8H.js");
+    const { syncAttachments: syncAttachments2 } = await import("./index-zafRwZEZ.js");
     return syncAttachments2(this.library, options);
   }
   async attachOpen(options) {
-    const { openAttachment: openAttachment2 } = await import("./index-Dotd2g8H.js");
+    const { openAttachment: openAttachment2 } = await import("./index-zafRwZEZ.js");
     return openAttachment2(this.library, options);
   }
 }
@@ -1790,7 +1790,7 @@ function getAttachExitCode(result) {
 }
 async function executeInteractiveSelect$2(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-D_Clnq0X.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bbl-roAS.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -2338,10 +2338,10 @@ function getCiteExitCode(result) {
 }
 async function executeInteractiveCite(options, context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { runCiteFlow } = await import("./index-Dktc7Q6f.js");
-  const { buildStyleChoices, listCustomStyles } = await import("./style-select-VJryW_Ms.js");
-  const { search } = await import("./file-watcher-Dyns9dxx.js").then((n) => n.B);
-  const { tokenize } = await import("./file-watcher-Dyns9dxx.js").then((n) => n.A);
+  const { runCiteFlow } = await import("./index-C36Us_zC.js");
+  const { buildStyleChoices, listCustomStyles } = await import("./style-select-BeAktUts.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");
   checkTTY();
   const allReferences = await context.library.getAll();
@@ -6938,7 +6938,7 @@ function formatEditOutput(result) {
 }
 async function executeInteractiveEdit(options, context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-D_Clnq0X.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bbl-roAS.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: true }, config2.cli.tui)
@@ -10479,7 +10479,7 @@ function getFulltextExitCode(result) {
 }
 async function executeInteractiveSelect$1(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-D_Clnq0X.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bbl-roAS.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -10816,24 +10816,24 @@ const fulltext = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProp
   handleFulltextOpenAction
 }, Symbol.toStringTag, { value: "Module" }));
 function buildResourceIndicators(item) {
-  const icons = [];
+  const labels = [];
   const attachments = item.custom?.attachments;
   const fulltextFiles = findFulltextFiles(attachments);
   const hasFulltextPdf = fulltextFiles.some(
     (f) => extensionToFormat(getExtension(f.filename)) === "pdf"
   );
-  if (hasFulltextPdf) icons.push("📄");
+  if (hasFulltextPdf) labels.push("pdf");
   const hasFulltextMd = fulltextFiles.some(
     (f) => extensionToFormat(getExtension(f.filename)) === "markdown"
   );
-  if (hasFulltextMd) icons.push("📝");
+  if (hasFulltextMd) labels.push("md");
   const allFiles = attachments?.files ?? [];
   const hasOtherAttachments = allFiles.length > fulltextFiles.length;
-  if (hasOtherAttachments) icons.push("📎");
-  if (item.URL) icons.push("🔗");
+  if (hasOtherAttachments) labels.push("file");
+  if (item.URL) labels.push("url");
   const tags = item.custom?.tags;
-  if (Array.isArray(tags) && tags.length > 0) icons.push("🏷");
-  return icons.join("");
+  if (Array.isArray(tags) && tags.length > 0) labels.push("tag");
+  return labels.join(" ");
 }
 function formatAuthor(author) {
   const family = author.family || "";
@@ -31779,7 +31779,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-7R-uEYOu.js").then((n) => n.w);
+    const { removeReference } = await import("./index-DWAtvFtp.js").then((n) => n.w);
     return removeReference(context.library, {
       identifier,
       idType,
@@ -31834,7 +31834,7 @@ Continue?`;
 }
 async function executeInteractiveRemove(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferenceItemsOrExit } = await import("./reference-select-D_Clnq0X.js");
+  const { selectReferenceItemsOrExit } = await import("./reference-select-Bbl-roAS.js");
   const allReferences = await context.library.getAll();
   const selectedItems = await withAlternateScreen2(
     () => selectReferenceItemsOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -32059,9 +32059,9 @@ 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-Dktc7Q6f.js");
-  const { search } = await import("./file-watcher-Dyns9dxx.js").then((n) => n.B);
-  const { tokenize } = await import("./file-watcher-Dyns9dxx.js").then((n) => n.A);
+  const { runSearchFlow } = await import("./index-C36Us_zC.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();
   const allReferences = await context.library.getAll();
   const searchFn = (query) => {
@@ -32078,7 +32078,7 @@ async function executeInteractiveSearch(options, context, config2) {
     })
   );
   if (result.selectedItems && !result.cancelled) {
-    const { isSideEffectAction } = await import("./action-menu-D0d5ph_3.js");
+    const { isSideEffectAction } = await import("./action-menu-BCgv1m3v.js");
     if (isSideEffectAction(result.action)) {
       await executeSideEffectAction(result.action, result.selectedItems, context, config2);
       return { output: "", cancelled: false, action: result.action };
@@ -32094,7 +32094,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-DOYCI2xk.js").then((n) => n.j);
+      const { openWithSystemApp: openWithSystemApp2 } = await import("./loader-CV71qNY2.js").then((n) => n.j);
       const item = items2[0];
       if (!item) return;
       const url$1 = resolveDefaultUrl2(item);
@@ -32481,7 +32481,7 @@ function formatUpdateOutput(result, identifier) {
 }
 async function executeInteractiveUpdate(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-D_Clnq0X.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bbl-roAS.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -32776,7 +32776,7 @@ function getUrlExitCode(result) {
 }
 async function executeInteractiveSelect(context, config2) {
   const { withAlternateScreen: withAlternateScreen2 } = await Promise.resolve().then(() => alternateScreen);
-  const { selectReferencesOrExit } = await import("./reference-select-D_Clnq0X.js");
+  const { selectReferencesOrExit } = await import("./reference-select-Bbl-roAS.js");
   const allReferences = await context.library.getAll();
   const identifiers = await withAlternateScreen2(
     () => selectReferencesOrExit(allReferences, { multiSelect: false }, config2.cli.tui)
@@ -33102,6 +33102,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);
@@ -33219,7 +33246,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 +33308,7 @@ function shouldAutoFetch(cliFlag, configEnabled) {
   return configEnabled;
 }
 async function performAutoFetch(addedItems, context, config2) {
-  const { fulltextFetch: fulltextFetch2 } = await import("./index-7R-uEYOu.js").then((n) => n.v);
+  const { fulltextFetch: fulltextFetch2 } = await import("./index-DWAtvFtp.js").then((n) => n.v);
   const fetchResults = await autoFetchFulltext(addedItems, context, {
     fulltextConfig: config2.fulltext,
     fulltextDirectory: config2.attachments.directory,
@@ -33558,4 +33587,4 @@ export {
   restoreStdinAfterInk as r,
   syncAttachments as s
 };
-//# sourceMappingURL=index-CFwvg1Ju.js.map
+//# sourceMappingURL=index-JA964gjc.js.map