@ncukondo/reference-manager 0.15.0 → 0.15.2

package/dist/chunks/{index-Bv5IgsL-.js → index-BIFsFHVj.js}

@@ -8,7 +8,7 @@ import * as path from "node:path";
 import path__default, { extname, join, basename, dirname } from "node:path";
 import fs__default, { stat, rename, copyFile, readFile, unlink, readdir, mkdir, rm } from "node:fs/promises";
 import { g as getExtension, i as isValidFulltextFiles, a as isReservedRole, F as FULLTEXT_ROLE, b as formatToExtension, c as findFulltextFiles, d as findFulltextFile, e as extensionToFormat, B as BUILTIN_STYLES, h as getFulltextAttachmentTypes, s as startServerWithFileWatcher } from "./index-DHgeuWGP.js";
-import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-4FFB4igw.js";
+import { o as openWithSystemApp, l as loadConfig, e as getDefaultCurrentDirConfigFilename, h as getDefaultUserConfigPath } from "./loader-DStZe-OB.js";
 import { spawn, spawnSync } from "node:child_process";
 import process$1, { stdin, stdout } from "node:process";
 import { parse as parse$2, stringify as stringify$2 } from "@iarna/toml";
@@ -17,7 +17,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.15.0";
+const version$1 = "0.15.2";
 const description$1 = "A local reference management tool using CSL-JSON as the single source of truth";
 const packageJson = {
   name,
@@ -903,27 +903,27 @@ class OperationsLibrary {
   }
   // Attachment operations
   async attachAdd(options) {
-    const { addAttachment: addAttachment2 } = await import("./index-B_WCu-ZQ.js");
+    const { addAttachment: addAttachment2 } = await import("./index-C30Ouuee.js");
     return addAttachment2(this.library, options);
   }
   async attachList(options) {
-    const { listAttachments: listAttachments2 } = await import("./index-B_WCu-ZQ.js");
+    const { listAttachments: listAttachments2 } = await import("./index-C30Ouuee.js");
     return listAttachments2(this.library, options);
   }
   async attachGet(options) {
-    const { getAttachment: getAttachment2 } = await import("./index-B_WCu-ZQ.js");
+    const { getAttachment: getAttachment2 } = await import("./index-C30Ouuee.js");
     return getAttachment2(this.library, options);
   }
   async attachDetach(options) {
-    const { detachAttachment: detachAttachment2 } = await import("./index-B_WCu-ZQ.js");
+    const { detachAttachment: detachAttachment2 } = await import("./index-C30Ouuee.js");
     return detachAttachment2(this.library, options);
   }
   async attachSync(options) {
-    const { syncAttachments: syncAttachments2 } = await import("./index-B_WCu-ZQ.js");
+    const { syncAttachments: syncAttachments2 } = await import("./index-C30Ouuee.js");
     return syncAttachments2(this.library, options);
   }
   async attachOpen(options) {
-    const { openAttachment: openAttachment2 } = await import("./index-B_WCu-ZQ.js");
+    const { openAttachment: openAttachment2 } = await import("./index-C30Ouuee.js");
     return openAttachment2(this.library, options);
   }
 }
@@ -1375,6 +1375,24 @@ async function readStdinBuffer() {
   }
   return Buffer.concat(chunks);
 }
+const ExitCode = {
+  /** Success */
+  SUCCESS: 0,
+  /** General error (e.g., not found, validation failed) */
+  ERROR: 1,
+  /** Internal/unexpected error */
+  INTERNAL_ERROR: 4,
+  /** Interrupted by SIGINT */
+  SIGINT: 130
+};
+function setExitCode(code2) {
+  process.exitCode = code2;
+}
+function exitWithError(message, code2 = ExitCode.ERROR) {
+  process.stderr.write(`Error: ${message}
+`);
+  setExitCode(code2);
+}
 async function executeAttachOpen(options, context) {
   const operationOptions = {
     identifier: options.identifier,
@@ -1545,12 +1563,16 @@ function formatAttachSyncOutput(result) {
   const lines = [];
   formatNewFilesSection(result, lines);
   formatMissingFilesSection(result, lines);
-  if (!result.applied) {
+  if (result.applied) {
+    lines.push("Changes applied.");
+  } else {
+    lines.push("");
+    lines.push("(dry-run: no changes made)");
     if (hasNewFiles) {
       lines.push("Run with --yes to add new files");
     }
     if (hasMissingFiles) {
-      lines.push("Run with --fix to remove missing files");
+      lines.push("Run with --fix to remove missing files from metadata");
     }
   }
   return lines.join("\n").trimEnd();
@@ -1580,7 +1602,8 @@ async function resolveIdentifier(identifierArg, context, config2) {
     process.stderr.write(
       "Error: No identifier provided. Provide an ID, pipe one via stdin, or run interactively in a TTY.\n"
     );
-    process.exit(1);
+    setExitCode(ExitCode.ERROR);
+    return "";
   }
   return stdinId;
 }
@@ -1604,6 +1627,9 @@ async function waitForEnter() {
     process.stderr.write("Press Enter when done editing...");
     process.stdin.setRawMode(true);
     process.stdin.resume();
+    if (typeof process.stdin.ref === "function") {
+      process.stdin.ref();
+    }
     process.stdin.once("data", () => {
       process.stdin.setRawMode(false);
       process.stdin.pause();
@@ -1677,12 +1703,13 @@ async function handleAttachOpenAction(identifierArg, filenameArg, options, globa
     if (!result.success) {
       process.stderr.write(`Error: ${result.error}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
+      return;
     }
     if (options.print) {
       process.stdout.write(`${result.path}
 `);
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     }
     if (shouldUseInteractive) {
       await runInteractiveMode(
@@ -1696,11 +1723,11 @@ async function handleAttachOpenAction(identifierArg, filenameArg, options, globa
       process.stderr.write(`${formatAttachOpenOutput(result)}
 `);
     }
-    process.exit(0);
+    setExitCode(ExitCode.SUCCESS);
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function handleAttachAddAction(identifierArg, filePathArg, options, globalOpts) {
@@ -1722,11 +1749,11 @@ async function handleAttachAddAction(identifierArg, filePathArg, options, global
     const output = formatAttachAddOutput(result);
     process.stderr.write(`${output}
 `);
-    process.exit(getAttachExitCode(result));
+    setExitCode(getAttachExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function handleAttachListAction(identifierArg, options, globalOpts) {
@@ -1744,11 +1771,11 @@ async function handleAttachListAction(identifierArg, options, globalOpts) {
     const output = formatAttachListOutput(result, identifier);
     process.stdout.write(`${output}
 `);
-    process.exit(getAttachExitCode(result));
+    setExitCode(getAttachExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function handleAttachGetAction(identifierArg, filenameArg, options, globalOpts) {
@@ -1774,11 +1801,11 @@ async function handleAttachGetAction(identifierArg, filenameArg, options, global
       process.stderr.write(`Error: ${result.error}
 `);
     }
-    process.exit(getAttachExitCode(result));
+    setExitCode(getAttachExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function handleAttachDetachAction(identifierArg, filenameArg, options, globalOpts) {
@@ -1799,34 +1826,75 @@ async function handleAttachDetachAction(identifierArg, filenameArg, options, glo
     const output = formatAttachDetachOutput(result);
     process.stderr.write(`${output}
 `);
-    process.exit(getAttachExitCode(result));
+    setExitCode(getAttachExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
+  }
+}
+async function runInteractiveSyncMode(identifier, attachmentsDirectory, idType, context) {
+  const dryRunOptions = {
+    identifier,
+    attachmentsDirectory,
+    ...idType && { idType }
+  };
+  const dryRunResult = await executeAttachSync(dryRunOptions, context);
+  const hasNewFiles = dryRunResult.newFiles.length > 0;
+  const hasMissingFiles = dryRunResult.missingFiles.length > 0;
+  if (!dryRunResult.success || !hasNewFiles && !hasMissingFiles) {
+    process.stderr.write(`${formatAttachSyncOutput(dryRunResult)}
+`);
+    return;
   }
+  process.stderr.write(`${formatAttachSyncOutput(dryRunResult)}
+
+`);
+  const shouldApplyNew = hasNewFiles && await readConfirmation("Add new files to metadata?");
+  const shouldApplyFix = hasMissingFiles && shouldApplyNew && await readConfirmation("Remove missing files?");
+  if (!shouldApplyNew && !shouldApplyFix) {
+    process.stderr.write("No changes applied.\n");
+    return;
+  }
+  const applyOptions = {
+    identifier,
+    attachmentsDirectory,
+    ...shouldApplyNew && { yes: true },
+    ...shouldApplyFix && { fix: true },
+    ...idType && { idType }
+  };
+  const result = await executeAttachSync(applyOptions, context);
+  process.stderr.write(`${formatAttachSyncOutput(result)}
+`);
 }
 async function handleAttachSyncAction(identifierArg, options, globalOpts) {
   try {
     const config2 = await loadConfigWithOverrides({ ...globalOpts, ...options });
     const context = await createExecutionContext(config2, Library.load);
     const identifier = await resolveIdentifier(identifierArg, context, config2);
+    const attachmentsDirectory = config2.attachments.directory;
+    const idType = options.uuid ? "uuid" : void 0;
+    const shouldUseInteractive = isTTY() && !options.yes && !options.fix;
+    if (shouldUseInteractive) {
+      await runInteractiveSyncMode(identifier, attachmentsDirectory, idType, context);
+      setExitCode(ExitCode.SUCCESS);
+      return;
+    }
     const syncOptions = {
       identifier,
-      attachmentsDirectory: config2.attachments.directory,
-      ...options.yes && { yes: options.yes },
-      ...options.fix && { fix: options.fix },
-      ...options.uuid && { idType: "uuid" }
+      attachmentsDirectory,
+      ...options.yes && { yes: true },
+      ...options.fix && { fix: true },
+      ...idType && { idType }
     };
     const result = await executeAttachSync(syncOptions, context);
-    const output = formatAttachSyncOutput(result);
-    process.stderr.write(`${output}
+    process.stderr.write(`${formatAttachSyncOutput(result)}
 `);
-    process.exit(getAttachExitCode(result));
+    setExitCode(getAttachExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function validateOptions$2(options) {
@@ -1900,7 +1968,8 @@ async function executeInteractiveCite(options, context, config2) {
       defaultStyle: config2.citation.defaultStyle
     });
     if (styleResult.cancelled) {
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
+      return { results: [] };
     }
     style = styleResult.style;
   }
@@ -1920,7 +1989,8 @@ async function handleCiteAction(identifiers, options, globalOpts) {
           process.stderr.write(
             "Error: No identifiers provided. Provide IDs, pipe them via stdin, or run interactively in a TTY.\n"
           );
-          process.exit(1);
+          setExitCode(ExitCode.ERROR);
+          return;
         }
         result = await executeCite({ ...options, identifiers: stdinIds }, context);
       }
@@ -1937,11 +2007,11 @@ async function handleCiteAction(identifiers, options, globalOpts) {
       process.stderr.write(`${errors2}
 `);
     }
-    process.exit(getCiteExitCode(result));
+    setExitCode(getCiteExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 const ENV_OVERRIDE_MAP = {
@@ -2652,11 +2722,11 @@ function registerConfigCommand(program) {
       });
       process.stdout.write(`${output}
 `);
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
   configCmd.command("get <key>").description("Get a specific configuration value").option("--config-only", "Return only the config file value (ignore env vars)").action(async (key, options) => {
@@ -2674,14 +2744,14 @@ function registerConfigCommand(program) {
         const { formatValue: formatValue2 } = await Promise.resolve().then(() => get);
         process.stdout.write(`${formatValue2(result.value)}
 `);
-        process.exit(0);
+        setExitCode(ExitCode.SUCCESS);
       } else {
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
       }
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
   configCmd.command("set <key> <value>").description("Set a configuration value").option("--local", "Write to current directory config (create if not exists)").option("--user", "Write to user config (ignore local config even if exists)").action(async (key, value, options) => {
@@ -2699,17 +2769,18 @@ function registerConfigCommand(program) {
       if (!result.success) {
         process.stderr.write(`Error: ${result.error}
 `);
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       if (result.warning) {
         process.stderr.write(`${result.warning}
 `);
       }
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
   configCmd.command("unset <key>").description("Remove a configuration value (revert to default)").option("--local", "Remove from current directory config").option("--user", "Remove from user config (ignore local config even if exists)").action(async (key, options) => {
@@ -2724,13 +2795,14 @@ function registerConfigCommand(program) {
       if (!result.success) {
         process.stderr.write(`Error: ${result.error}
 `);
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
   configCmd.command("keys").description("List all available configuration keys").option("--section <name>", "List keys only in a specific section").action(async (options) => {
@@ -2740,11 +2812,11 @@ function registerConfigCommand(program) {
         process.stdout.write(`${output}
 `);
       }
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
   configCmd.command("path").description("Show configuration file paths").option("--user", "Show only user config path").option("--local", "Show only local config path").action(async (options) => {
@@ -2752,18 +2824,19 @@ function registerConfigCommand(program) {
       const output = showConfigPaths({ user: options.user, local: options.local });
       process.stdout.write(`${output}
 `);
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
   configCmd.command("edit").description("Open configuration file in editor").option("--local", "Edit current directory config").action(async (options) => {
     try {
       if (!process.stdin.isTTY) {
         process.stderr.write("Error: config edit requires a terminal (TTY)\n");
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       const target = getConfigEditTarget({ local: options.local });
       if (!target.exists) {
@@ -2773,11 +2846,11 @@ function registerConfigCommand(program) {
       }
       const editor = resolveEditor();
       const exitCode = openEditor(editor, target.path);
-      process.exit(exitCode);
+      setExitCode(exitCode);
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
 }
@@ -5748,7 +5821,7 @@ async function handleEditAction(identifiers, options, globalOpts) {
       const output2 = formatEditOutput(result2);
       process.stderr.write(`${output2}
 `);
-      process.exit(result2.success ? 0 : 1);
+      setExitCode(result2.success ? ExitCode.SUCCESS : ExitCode.ERROR);
       return;
     } else {
       const stdinIds = await readIdentifiersFromStdin();
@@ -5756,13 +5829,15 @@ async function handleEditAction(identifiers, options, globalOpts) {
         process.stderr.write(
           "Error: No identifiers provided. Provide IDs, pipe them via stdin, or run interactively in a TTY.\n"
         );
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       resolvedIdentifiers = stdinIds;
     }
     if (!isTTY()) {
       process.stderr.write("Error: Edit command requires a TTY to open the editor.\n");
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
+      return;
     }
     const format2 = options.format ?? config2.cli.edit.defaultFormat;
     const result = await executeEditCommand(
@@ -5777,11 +5852,11 @@ async function handleEditAction(identifiers, options, globalOpts) {
     const output = formatEditOutput(result);
     process.stderr.write(`${output}
 `);
-    process.exit(result.success ? 0 : 1);
+    setExitCode(result.success ? ExitCode.SUCCESS : ExitCode.ERROR);
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 const ALIAS = Symbol.for("yaml.alias");
@@ -9401,7 +9476,8 @@ async function handleFulltextAttachAction(identifierArg, filePathArg, options, g
         process.stderr.write(
           "Error: No identifier provided. Provide an ID or run interactively in a TTY.\n"
         );
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       identifier = await executeInteractiveSelect(context, config2);
     }
@@ -9421,11 +9497,11 @@ async function handleFulltextAttachAction(identifierArg, filePathArg, options, g
     const output = formatFulltextAttachOutput(result);
     process.stderr.write(`${output}
 `);
-    process.exit(getFulltextExitCode(result));
+    setExitCode(getFulltextExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 function outputFulltextGetResult(result, useStdout) {
@@ -9457,7 +9533,8 @@ async function handleFulltextGetAction(identifierArg, options, globalOpts) {
         process.stderr.write(
           "Error: No identifier provided. Provide an ID, pipe one via stdin, or run interactively in a TTY.\n"
         );
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       identifier = stdinId;
     }
@@ -9471,11 +9548,11 @@ async function handleFulltextGetAction(identifierArg, options, globalOpts) {
     };
     const result = await executeFulltextGet(getOptions, context);
     outputFulltextGetResult(result, Boolean(options.stdout));
-    process.exit(getFulltextExitCode(result));
+    setExitCode(getFulltextExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function handleFulltextDetachAction(identifierArg, options, globalOpts) {
@@ -9493,7 +9570,8 @@ async function handleFulltextDetachAction(identifierArg, options, globalOpts) {
         process.stderr.write(
           "Error: No identifier provided. Provide an ID, pipe one via stdin, or run interactively in a TTY.\n"
         );
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       identifier = stdinId;
     }
@@ -9510,11 +9588,11 @@ async function handleFulltextDetachAction(identifierArg, options, globalOpts) {
     const output = formatFulltextDetachOutput(result);
     process.stderr.write(`${output}
 `);
-    process.exit(getFulltextExitCode(result));
+    setExitCode(getFulltextExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 async function handleFulltextOpenAction(identifierArg, options, globalOpts) {
@@ -9532,7 +9610,8 @@ async function handleFulltextOpenAction(identifierArg, options, globalOpts) {
         process.stderr.write(
           "Error: No identifier provided. Provide an ID, pipe one via stdin, or run interactively in a TTY.\n"
         );
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
+        return;
       }
       identifier = stdinId;
     }
@@ -9547,11 +9626,11 @@ async function handleFulltextOpenAction(identifierArg, options, globalOpts) {
     const output = formatFulltextOpenOutput(result);
     process.stderr.write(`${output}
 `);
-    process.exit(getFulltextExitCode(result));
+    setExitCode(getFulltextExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 function formatAuthor(author) {
@@ -30480,7 +30559,7 @@ function handleRemoveError(error, identifierArg, outputFormat) {
 `);
   }
   const isUserError = message.includes("not found") || message.includes("No identifier");
-  process.exit(isUserError ? 1 : 4);
+  setExitCode(isUserError ? ExitCode.ERROR : ExitCode.INTERNAL_ERROR);
 }
 async function handleRemoveAction(identifierArg, options, globalOpts) {
   const { formatRemoveJsonOutput: formatRemoveJsonOutput2 } = await Promise.resolve().then(() => jsonOutput);
@@ -30501,12 +30580,14 @@ async function handleRemoveAction(identifierArg, options, globalOpts) {
     if (hasFulltext && !isTTY() && !force) {
       process.stderr.write(`Error: ${formatFulltextWarning(fulltextTypes)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
+      return;
     }
     const confirmed = await confirmRemoveIfNeeded(refToRemove, hasFulltext, force);
     if (!confirmed) {
       process.stderr.write("Cancelled.\n");
-      process.exit(2);
+      setExitCode(2);
+      return;
     }
     const removeOptions = {
       identifier,
@@ -30516,7 +30597,7 @@ async function handleRemoveAction(identifierArg, options, globalOpts) {
     };
     const result = await executeRemove(removeOptions, context);
     outputResult(result, identifier, outputFormat, options.full, formatRemoveJsonOutput2);
-    process.exit(result.removed ? 0 : 1);
+    setExitCode(result.removed ? ExitCode.SUCCESS : ExitCode.ERROR);
   } catch (error) {
     handleRemoveError(error, identifierArg, outputFormat);
   }
@@ -30628,7 +30709,7 @@ async function executeInteractiveSearch(options, context, config2) {
   validateInteractiveOptions(options);
   const { checkTTY } = await import("./tty-BMyaEOhX.js");
   const { runSearchPrompt } = await import("./search-prompt-BrWpOcij.js");
-  const { runActionMenu } = await import("./action-menu-DvwR6nMj.js");
+  const { runActionMenu } = await import("./action-menu-CLBXtpmg.js");
   const { search } = await import("./file-watcher-B_WpVHSV.js").then((n) => n.y);
   const { tokenize } = await import("./file-watcher-B_WpVHSV.js").then((n) => n.x);
   checkTTY();
@@ -30706,7 +30787,7 @@ async function startServerForeground(options) {
     server.close();
     await dispose();
     await removePortfile(options.portfilePath);
-    process.exit(0);
+    setExitCode(ExitCode.SUCCESS);
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
@@ -30958,14 +31039,16 @@ async function resolveUpdateIdentifier(identifierArg, hasSetOptions, context, co
       process.stderr.write(
         "Error: No identifier provided. Provide an ID, pipe one via stdin, or run interactively in a TTY.\n"
       );
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
+      return "";
     }
     return stdinId;
   }
   process.stderr.write(
     "Error: No identifier provided. When using stdin for JSON input, identifier must be provided as argument.\n"
   );
-  process.exit(1);
+  setExitCode(ExitCode.ERROR);
+  return "";
 }
 function parseUpdateInput(setOptions, file) {
   if (setOptions && setOptions.length > 0 && file) {
@@ -30986,23 +31069,25 @@ function handleUpdateError(error) {
   if (message.includes("Parse error")) {
     process.stderr.write(`Error: ${message}
 `);
-    process.exit(3);
+    setExitCode(3);
   }
   if (message.includes("not found") || message.includes("validation")) {
     process.stderr.write(`Error: ${message}
 `);
-    process.exit(1);
+    setExitCode(ExitCode.ERROR);
   }
   process.stderr.write(`Error: ${message}
 `);
-  process.exit(4);
+  setExitCode(ExitCode.INTERNAL_ERROR);
 }
 function handleUpdateErrorWithFormat(error, identifier, outputFormat) {
   const message = error instanceof Error ? error.message : String(error);
   if (outputFormat === "json") {
     process.stdout.write(`${JSON.stringify({ success: false, id: identifier, error: message })}
 `);
-    process.exit(message.includes("not found") || message.includes("validation") ? 1 : 4);
+    setExitCode(
+      message.includes("not found") || message.includes("validation") ? ExitCode.ERROR : ExitCode.INTERNAL_ERROR
+    );
   }
   handleUpdateError(error);
 }
@@ -31036,7 +31121,7 @@ async function handleUpdateAction(identifierArg, file, options, globalOpts) {
       process.stderr.write(`${output}
 `);
     }
-    process.exit(result.updated ? 0 : 1);
+    setExitCode(result.updated ? ExitCode.SUCCESS : ExitCode.ERROR);
   } catch (error) {
     handleUpdateErrorWithFormat(error, identifierArg ?? "", outputFormat);
   }
@@ -31321,7 +31406,7 @@ function registerCompletionCommand(program) {
     } else {
       console.error(`Unknown action: ${action}`);
       console.error("Usage: ref completion [install|uninstall]");
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
 }
@@ -31356,11 +31441,9 @@ async function handleListAction(options, program) {
       process.stdout.write(`${output}
 `);
     }
-    process.exit(0);
+    setExitCode(ExitCode.SUCCESS);
   } catch (error) {
-    process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
-`);
-    process.exit(4);
+    exitWithError(error instanceof Error ? error.message : String(error), ExitCode.INTERNAL_ERROR);
   }
 }
 function registerListCommand(program) {
@@ -31385,11 +31468,11 @@ async function handleExportAction(ids, options, program) {
 `);
       }
     }
-    process.exit(getExportExitCode(result));
+    setExitCode(getExportExitCode(result));
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 function registerExportCommand(program) {
@@ -31408,7 +31491,7 @@ async function handleSearchAction(query, options, program) {
         process.stdout.write(`${result2.output}
 `);
       }
-      process.exit(result2.cancelled ? 0 : 0);
+      setExitCode(ExitCode.SUCCESS);
     }
     const result = await executeSearch({ ...options, query }, context);
     const output = formatSearchOutput(result, { ...options, query });
@@ -31416,18 +31499,19 @@ async function handleSearchAction(query, options, program) {
       process.stdout.write(`${output}
 `);
     }
-    process.exit(0);
+    setExitCode(ExitCode.SUCCESS);
   } catch (error) {
     process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-    process.exit(4);
+    setExitCode(ExitCode.INTERNAL_ERROR);
   }
 }
 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("-o, --output <format>", "Output format: pretty|json|bibtex|ids|uuid").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("--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) => {
     if (!options.tui && !query) {
       process.stderr.write("Error: Search query is required unless using --tui\n");
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
+      return;
     }
     await handleSearchAction(query ?? "", options, program);
   });
@@ -31492,7 +31576,7 @@ async function handleAddAction(inputs, options, program) {
       process.stderr.write(`${output}
 `);
     }
-    process.exit(getExitCode(result));
+    setExitCode(getExitCode(result));
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     if (outputFormat === "json") {
@@ -31502,7 +31586,7 @@ async function handleAddAction(inputs, options, program) {
       process.stderr.write(`Error: ${message}
 `);
     }
-    process.exit(1);
+    setExitCode(ExitCode.ERROR);
   }
 }
 function registerAddCommand(program) {
@@ -31552,18 +31636,18 @@ function registerServerCommand(program) {
       };
       await serverStart(startOptions);
       if (options.daemon) {
-        process.exit(0);
+        setExitCode(ExitCode.SUCCESS);
       }
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       if (message.includes("already running") || message.includes("conflict")) {
         process.stderr.write(`Error: ${message}
 `);
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
       }
       process.stderr.write(`Error: ${message}
 `);
-      process.exit(4);
+      setExitCode(ExitCode.INTERNAL_ERROR);
     }
   });
   serverCmd.command("stop").description("Stop running server").action(async () => {
@@ -31571,17 +31655,17 @@ function registerServerCommand(program) {
       const portfilePath = getPortfilePath();
       await serverStop(portfilePath);
       process.stderr.write("Server stopped.\n");
-      process.exit(0);
+      setExitCode(ExitCode.SUCCESS);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       if (message.includes("not running")) {
         process.stderr.write(`Error: ${message}
 `);
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
       }
       process.stderr.write(`Error: ${message}
 `);
-      process.exit(4);
+      setExitCode(ExitCode.INTERNAL_ERROR);
     }
   });
   serverCmd.command("status").description("Check server status").action(async () => {
@@ -31596,15 +31680,15 @@ PID: ${status.pid}
 Library: ${status.library}
 `
         );
-        process.exit(0);
+        setExitCode(ExitCode.SUCCESS);
       } else {
         process.stdout.write("Server not running\n");
-        process.exit(1);
+        setExitCode(ExitCode.ERROR);
       }
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(4);
+      setExitCode(ExitCode.INTERNAL_ERROR);
     }
   });
 }
@@ -31633,7 +31717,7 @@ function registerMcpCommand(program) {
     } catch (error) {
       process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
 `);
-      process.exit(1);
+      setExitCode(ExitCode.ERROR);
     }
   });
 }
@@ -31683,10 +31767,10 @@ async function main(argv) {
     return;
   }
   process.on("SIGINT", () => {
-    process.exit(130);
+    setExitCode(ExitCode.SIGINT);
   });
   process.on("SIGTERM", () => {
-    process.exit(0);
+    setExitCode(ExitCode.SUCCESS);
   });
   await program.parseAsync(argv);
 }
@@ -31701,4 +31785,4 @@ export {
   openAttachment as o,
   syncAttachments as s
 };
-//# sourceMappingURL=index-Bv5IgsL-.js.map
+//# sourceMappingURL=index-BIFsFHVj.js.map