@ncukondo/reference-manager 0.7.0 → 0.8.0

package/README.md

@@ -442,7 +442,7 @@ reference-manager extends CSL-JSON with a `custom` object for additional metadat
 
 **Alpha** — This project is under active development. APIs and commands may change between versions.
 
-See [ROADMAP.md](./ROADMAP.md) for development progress and planned features.
+See [spec/tasks/ROADMAP.md](./spec/tasks/ROADMAP.md) for development progress and planned features.
 
 ## Development
 

package/dist/chunks/{loader-BItrdVWG.js → loader-CLCZRS4m.js}

@@ -1,9 +1,44 @@
+import { spawn } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
 import { parse } from "@iarna/toml";
 import { z } from "zod";
 import { q as sortOrderSchema, u as sortFieldSchema } from "./file-watcher-D7oyc-9z.js";
+function getOpenerCommand(platform) {
+  switch (platform) {
+    case "darwin":
+      return ["open"];
+    case "linux":
+      return ["xdg-open"];
+    case "win32":
+      return ["cmd", "/c", "start", ""];
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+}
+async function openWithSystemApp(filePath, platform = process.platform) {
+  const commandParts = getOpenerCommand(platform);
+  const [command, ...baseArgs] = commandParts;
+  const args = [...baseArgs, filePath];
+  return new Promise((resolve, reject) => {
+    const proc = spawn(command, args, {
+      detached: true,
+      stdio: "ignore"
+    });
+    proc.on("error", () => {
+      reject(new Error(`Failed to open file: ${filePath}`));
+    });
+    proc.on("close", (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Failed to open file: ${filePath}`));
+      }
+    });
+    proc.unref();
+  });
+}
 const logLevelSchema = z.enum(["silent", "info", "debug"]);
 const interactiveConfigSchema = z.object({
   limit: z.number().int().nonnegative(),
@@ -501,17 +536,19 @@ function loadConfig(options = {}) {
   }
 }
 export {
-  getDefaultCurrentDirConfigFilename as a,
+  getDefaultBackupDirectory as a,
   backupConfigSchema as b,
   configSchema as c,
   defaultConfig as d,
-  getDefaultLibraryPath as e,
-  getDefaultUserConfigPath as f,
-  getDefaultBackupDirectory as g,
-  logLevelSchema as h,
+  getDefaultCurrentDirConfigFilename as e,
+  getDefaultLibraryPath as f,
+  getOpenerCommand as g,
+  getDefaultUserConfigPath as h,
+  logLevelSchema as i,
   loadConfig as l,
   normalizePartialConfig as n,
+  openWithSystemApp as o,
   partialConfigSchema as p,
   watchConfigSchema as w
 };
-//# sourceMappingURL=loader-BItrdVWG.js.map
+//# sourceMappingURL=loader-CLCZRS4m.js.map

package/dist/chunks/loader-CLCZRS4m.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-CLCZRS4m.js","sources":["../../src/utils/opener.ts","../../src/config/schema.ts","../../src/config/defaults.ts","../../src/config/loader.ts"],"sourcesContent":["import { type ChildProcess, spawn } from \"node:child_process\";\n\n/**\n * Get the system opener command for the specified platform.\n * @param platform - The platform (darwin, linux, win32)\n * @returns The command array to execute\n */\nexport function getOpenerCommand(platform: string): string[] {\n  switch (platform) {\n    case \"darwin\":\n      return [\"open\"];\n    case \"linux\":\n      return [\"xdg-open\"];\n    case \"win32\":\n      return [\"cmd\", \"/c\", \"start\", \"\"];\n    default:\n      throw new Error(`Unsupported platform: ${platform}`);\n  }\n}\n\n/**\n * Open a file with the system's default application.\n * @param filePath - The path to the file to open\n * @param platform - The platform (defaults to process.platform)\n */\nexport async function openWithSystemApp(\n  filePath: string,\n  platform: string = process.platform\n): Promise<void> {\n  const commandParts = getOpenerCommand(platform);\n  const [command, ...baseArgs] = commandParts;\n  const args = [...baseArgs, filePath];\n\n  return new Promise((resolve, reject) => {\n    const proc: ChildProcess = spawn(command as string, args, {\n      detached: true,\n      stdio: \"ignore\",\n    });\n\n    proc.on(\"error\", () => {\n      reject(new Error(`Failed to open file: ${filePath}`));\n    });\n\n    proc.on(\"close\", (code: number | null) => {\n      if (code === 0) {\n        resolve();\n      } else {\n        reject(new Error(`Failed to open file: ${filePath}`));\n      }\n    });\n\n    proc.unref();\n  });\n}\n","/**\n * Configuration schema using Zod\n */\n\nimport { z } from \"zod\";\nimport { sortFieldSchema, sortOrderSchema } from \"../features/pagination/types.js\";\n\n/**\n * Log level schema\n */\nexport const logLevelSchema = z.enum([\"silent\", \"info\", \"debug\"]);\n\n/**\n * Interactive search configuration schema\n */\nexport const interactiveConfigSchema = z.object({\n  limit: z.number().int().nonnegative(),\n  debounceMs: z.number().int().nonnegative(),\n});\n\n/**\n * CLI configuration schema\n */\nexport const cliConfigSchema = z.object({\n  defaultLimit: z.number().int().nonnegative(),\n  defaultSort: sortFieldSchema,\n  defaultOrder: sortOrderSchema,\n  interactive: interactiveConfigSchema,\n});\n\n/**\n * MCP configuration schema\n */\nexport const mcpConfigSchema = z.object({\n  defaultLimit: z.number().int().nonnegative(),\n});\n\n/**\n * Backup configuration schema\n */\nexport const backupConfigSchema = z.object({\n  maxGenerations: z.number().int().positive(),\n  maxAgeDays: z.number().int().positive(),\n  directory: z.string().min(1),\n});\n\n/**\n * File watching configuration schema\n * Note: File watching is always enabled in server mode (HTTP/MCP).\n * CLI mode does not use file watching.\n */\nexport const watchConfigSchema = z.object({\n  debounceMs: z.number().int().nonnegative(),\n  pollIntervalMs: z.number().int().positive(),\n  retryIntervalMs: z.number().int().positive(),\n  maxRetries: z.number().int().nonnegative(),\n});\n\n/**\n * Server configuration schema\n */\nexport const serverConfigSchema = z.object({\n  autoStart: z.boolean(),\n  autoStopMinutes: z.number().int().nonnegative(),\n});\n\n/**\n * Citation format schema\n */\nexport const citationFormatSchema = z.enum([\"text\", \"html\", \"rtf\"]);\n\n/**\n * Citation configuration schema\n */\nexport const citationConfigSchema = z.object({\n  defaultStyle: z.string(),\n  cslDirectory: z.array(z.string()),\n  defaultLocale: z.string(),\n  defaultFormat: citationFormatSchema,\n});\n\n/**\n * PubMed API configuration schema\n */\nexport const pubmedConfigSchema = z.object({\n  email: z.string().optional(),\n  apiKey: z.string().optional(),\n});\n\n/**\n * Fulltext storage configuration schema\n */\nexport const fulltextConfigSchema = z.object({\n  directory: z.string().min(1),\n});\n\n/**\n * Complete configuration schema\n */\nexport const configSchema = z.object({\n  library: z.string().min(1),\n  logLevel: logLevelSchema,\n  backup: backupConfigSchema,\n  watch: watchConfigSchema,\n  server: serverConfigSchema,\n  citation: citationConfigSchema,\n  pubmed: pubmedConfigSchema,\n  fulltext: fulltextConfigSchema,\n  cli: cliConfigSchema,\n  mcp: mcpConfigSchema,\n});\n\n/**\n * Partial configuration schema (for TOML files)\n * Supports both camelCase and snake_case field names\n */\nexport const partialConfigSchema = z\n  .object({\n    library: z.string().min(1).optional(),\n    logLevel: logLevelSchema.optional(),\n    log_level: logLevelSchema.optional(), // snake_case support\n    backup: z\n      .object({\n        maxGenerations: z.number().int().positive().optional(),\n        max_generations: z.number().int().positive().optional(),\n        maxAgeDays: z.number().int().positive().optional(),\n        max_age_days: z.number().int().positive().optional(),\n        directory: z.string().min(1).optional(),\n      })\n      .optional(),\n    watch: z\n      .object({\n        debounceMs: z.number().int().nonnegative().optional(),\n        debounce_ms: z.number().int().nonnegative().optional(),\n        pollIntervalMs: z.number().int().positive().optional(),\n        poll_interval_ms: z.number().int().positive().optional(),\n        retryIntervalMs: z.number().int().positive().optional(),\n        retry_interval_ms: z.number().int().positive().optional(),\n        maxRetries: z.number().int().nonnegative().optional(),\n        max_retries: z.number().int().nonnegative().optional(),\n      })\n      .optional(),\n    server: z\n      .object({\n        autoStart: z.boolean().optional(),\n        auto_start: z.boolean().optional(),\n        autoStopMinutes: z.number().int().nonnegative().optional(),\n        auto_stop_minutes: z.number().int().nonnegative().optional(),\n      })\n      .optional(),\n    citation: z\n      .object({\n        defaultStyle: z.string().optional(),\n        default_style: z.string().optional(),\n        cslDirectory: z.union([z.string(), z.array(z.string())]).optional(),\n        csl_directory: z.union([z.string(), z.array(z.string())]).optional(),\n        defaultLocale: z.string().optional(),\n        default_locale: z.string().optional(),\n        defaultFormat: citationFormatSchema.optional(),\n        default_format: citationFormatSchema.optional(),\n      })\n      .optional(),\n    pubmed: z\n      .object({\n        email: z.string().optional(),\n        apiKey: z.string().optional(),\n        api_key: z.string().optional(),\n      })\n      .optional(),\n    fulltext: z\n      .object({\n        directory: z.string().min(1).optional(),\n      })\n      .optional(),\n    cli: z\n      .object({\n        defaultLimit: z.number().int().nonnegative().optional(),\n        default_limit: z.number().int().nonnegative().optional(),\n        defaultSort: sortFieldSchema.optional(),\n        default_sort: sortFieldSchema.optional(),\n        defaultOrder: sortOrderSchema.optional(),\n        default_order: sortOrderSchema.optional(),\n        interactive: z\n          .object({\n            limit: z.number().int().nonnegative().optional(),\n            debounceMs: z.number().int().nonnegative().optional(),\n            debounce_ms: z.number().int().nonnegative().optional(),\n          })\n          .optional(),\n      })\n      .optional(),\n    mcp: z\n      .object({\n        defaultLimit: z.number().int().nonnegative().optional(),\n        default_limit: z.number().int().nonnegative().optional(),\n      })\n      .optional(),\n  })\n  .passthrough(); // Allow unknown fields in TOML files\n\n/**\n * Inferred types from schemas\n */\nexport type LogLevel = z.infer<typeof logLevelSchema>;\nexport type BackupConfig = z.infer<typeof backupConfigSchema>;\nexport type WatchConfig = z.infer<typeof watchConfigSchema>;\nexport type ServerConfig = z.infer<typeof serverConfigSchema>;\nexport type CitationFormat = z.infer<typeof citationFormatSchema>;\nexport type CitationConfig = z.infer<typeof citationConfigSchema>;\nexport type PubmedConfig = z.infer<typeof pubmedConfigSchema>;\nexport type FulltextConfig = z.infer<typeof fulltextConfigSchema>;\nexport type InteractiveConfig = z.infer<typeof interactiveConfigSchema>;\nexport type CliConfig = z.infer<typeof cliConfigSchema>;\nexport type McpConfig = z.infer<typeof mcpConfigSchema>;\nexport type Config = z.infer<typeof configSchema>;\nexport type PartialConfig = z.infer<typeof partialConfigSchema>;\n\n/**\n * Deep partial type for Config\n */\nexport type DeepPartialConfig = {\n  library?: string;\n  logLevel?: LogLevel;\n  backup?: Partial<BackupConfig>;\n  watch?: Partial<WatchConfig>;\n  server?: Partial<ServerConfig>;\n  citation?: Partial<CitationConfig>;\n  pubmed?: Partial<PubmedConfig>;\n  fulltext?: Partial<FulltextConfig>;\n  cli?: Partial<Omit<CliConfig, \"interactive\">> & {\n    interactive?: Partial<InteractiveConfig>;\n  };\n  mcp?: Partial<McpConfig>;\n};\n\n/**\n * Normalize backup configuration from snake_case to camelCase\n */\nfunction normalizeBackupConfig(\n  backup: Partial<{\n    maxGenerations?: number;\n    max_generations?: number;\n    maxAgeDays?: number;\n    max_age_days?: number;\n    directory?: string;\n  }>\n): Partial<BackupConfig> | undefined {\n  const normalized: Partial<BackupConfig> = {};\n\n  const maxGenerations = backup.maxGenerations ?? backup.max_generations;\n  if (maxGenerations !== undefined) {\n    normalized.maxGenerations = maxGenerations;\n  }\n\n  const maxAgeDays = backup.maxAgeDays ?? backup.max_age_days;\n  if (maxAgeDays !== undefined) {\n    normalized.maxAgeDays = maxAgeDays;\n  }\n\n  if (backup.directory !== undefined) {\n    normalized.directory = backup.directory;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize watch configuration from snake_case to camelCase\n */\nfunction normalizeWatchConfig(\n  watch: Partial<{\n    debounceMs?: number;\n    debounce_ms?: number;\n    pollIntervalMs?: number;\n    poll_interval_ms?: number;\n    retryIntervalMs?: number;\n    retry_interval_ms?: number;\n    maxRetries?: number;\n    max_retries?: number;\n  }>\n): Partial<WatchConfig> | undefined {\n  const normalized: Partial<WatchConfig> = {};\n\n  const debounceMs = watch.debounceMs ?? watch.debounce_ms;\n  if (debounceMs !== undefined) {\n    normalized.debounceMs = debounceMs;\n  }\n\n  const pollIntervalMs = watch.pollIntervalMs ?? watch.poll_interval_ms;\n  if (pollIntervalMs !== undefined) {\n    normalized.pollIntervalMs = pollIntervalMs;\n  }\n\n  const retryIntervalMs = watch.retryIntervalMs ?? watch.retry_interval_ms;\n  if (retryIntervalMs !== undefined) {\n    normalized.retryIntervalMs = retryIntervalMs;\n  }\n\n  const maxRetries = watch.maxRetries ?? watch.max_retries;\n  if (maxRetries !== undefined) {\n    normalized.maxRetries = maxRetries;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize server configuration from snake_case to camelCase\n */\nfunction normalizeServerConfig(\n  server: Partial<{\n    autoStart?: boolean;\n    auto_start?: boolean;\n    autoStopMinutes?: number;\n    auto_stop_minutes?: number;\n  }>\n): Partial<ServerConfig> | undefined {\n  const normalized: Partial<ServerConfig> = {};\n\n  const autoStart = server.autoStart ?? server.auto_start;\n  if (autoStart !== undefined) {\n    normalized.autoStart = autoStart;\n  }\n\n  const autoStopMinutes = server.autoStopMinutes ?? server.auto_stop_minutes;\n  if (autoStopMinutes !== undefined) {\n    normalized.autoStopMinutes = autoStopMinutes;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize citation configuration from snake_case to camelCase\n */\nfunction normalizeCitationConfig(\n  citation: Partial<{\n    defaultStyle?: string;\n    default_style?: string;\n    cslDirectory?: string | string[];\n    csl_directory?: string | string[];\n    defaultLocale?: string;\n    default_locale?: string;\n    defaultFormat?: CitationFormat;\n    default_format?: CitationFormat;\n  }>\n): Partial<CitationConfig> | undefined {\n  const normalized: Partial<CitationConfig> = {};\n\n  const defaultStyle = citation.defaultStyle ?? citation.default_style;\n  if (defaultStyle !== undefined) {\n    normalized.defaultStyle = defaultStyle;\n  }\n\n  const cslDirectory = citation.cslDirectory ?? citation.csl_directory;\n  if (cslDirectory !== undefined) {\n    // Normalize to array: string -> [string]\n    normalized.cslDirectory = Array.isArray(cslDirectory) ? cslDirectory : [cslDirectory];\n  }\n\n  const defaultLocale = citation.defaultLocale ?? citation.default_locale;\n  if (defaultLocale !== undefined) {\n    normalized.defaultLocale = defaultLocale;\n  }\n\n  const defaultFormat = citation.defaultFormat ?? citation.default_format;\n  if (defaultFormat !== undefined) {\n    normalized.defaultFormat = defaultFormat;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize pubmed configuration from snake_case to camelCase\n */\nfunction normalizePubmedConfig(\n  pubmed: Partial<{\n    email?: string;\n    apiKey?: string;\n    api_key?: string;\n  }>\n): Partial<PubmedConfig> | undefined {\n  const normalized: Partial<PubmedConfig> = {};\n\n  if (pubmed.email !== undefined) {\n    normalized.email = pubmed.email;\n  }\n\n  const apiKey = pubmed.apiKey ?? pubmed.api_key;\n  if (apiKey !== undefined) {\n    normalized.apiKey = apiKey;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Section normalizers mapping\n */\nconst sectionNormalizers = {\n  backup: normalizeBackupConfig,\n  watch: normalizeWatchConfig,\n  server: normalizeServerConfig,\n  citation: normalizeCitationConfig,\n  pubmed: normalizePubmedConfig,\n  fulltext: normalizeFulltextConfig,\n  cli: normalizeCliConfig,\n  mcp: normalizeMcpConfig,\n} as const;\n\ntype SectionKey = keyof typeof sectionNormalizers;\n\n/**\n * Helper to apply a normalizer function to a config section\n */\nfunction applyNormalizer<K extends SectionKey>(\n  normalized: DeepPartialConfig,\n  partial: PartialConfig,\n  key: K,\n  normalizer: (typeof sectionNormalizers)[K]\n): void {\n  const value = partial[key];\n  if (value !== undefined) {\n    const result = (normalizer as (input: unknown) => DeepPartialConfig[K] | undefined)(value);\n    if (result) {\n      normalized[key] = result;\n    }\n  }\n}\n\n/**\n * Normalize snake_case fields to camelCase\n */\nexport function normalizePartialConfig(partial: PartialConfig): DeepPartialConfig {\n  const normalized: DeepPartialConfig = {};\n\n  // Simple fields\n  if (partial.library !== undefined) {\n    normalized.library = partial.library;\n  }\n  const logLevel = partial.logLevel ?? partial.log_level;\n  if (logLevel !== undefined) {\n    normalized.logLevel = logLevel;\n  }\n\n  // Section fields\n  for (const key of Object.keys(sectionNormalizers) as SectionKey[]) {\n    applyNormalizer(normalized, partial, key, sectionNormalizers[key]);\n  }\n\n  return normalized;\n}\n\n/**\n * Normalize fulltext configuration\n */\nfunction normalizeFulltextConfig(fulltext: {\n  directory?: string | undefined;\n}): Partial<FulltextConfig> | undefined {\n  const normalized: Partial<FulltextConfig> = {};\n\n  if (fulltext.directory !== undefined) {\n    normalized.directory = fulltext.directory;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize CLI configuration from snake_case to camelCase\n */\nfunction normalizeCliConfig(\n  cli: Partial<{\n    defaultLimit?: number;\n    default_limit?: number;\n    defaultSort?: CliConfig[\"defaultSort\"];\n    default_sort?: CliConfig[\"defaultSort\"];\n    defaultOrder?: CliConfig[\"defaultOrder\"];\n    default_order?: CliConfig[\"defaultOrder\"];\n    interactive?: Partial<{\n      limit?: number;\n      debounceMs?: number;\n      debounce_ms?: number;\n    }>;\n  }>\n): Partial<CliConfig> | undefined {\n  const normalized: Partial<CliConfig> = {};\n\n  const defaultLimit = cli.defaultLimit ?? cli.default_limit;\n  if (defaultLimit !== undefined) {\n    normalized.defaultLimit = defaultLimit;\n  }\n\n  const defaultSort = cli.defaultSort ?? cli.default_sort;\n  if (defaultSort !== undefined) {\n    normalized.defaultSort = defaultSort;\n  }\n\n  const defaultOrder = cli.defaultOrder ?? cli.default_order;\n  if (defaultOrder !== undefined) {\n    normalized.defaultOrder = defaultOrder;\n  }\n\n  if (cli.interactive !== undefined) {\n    const interactive: Partial<InteractiveConfig> = {};\n    if (cli.interactive.limit !== undefined) {\n      interactive.limit = cli.interactive.limit;\n    }\n    const debounceMs = cli.interactive.debounceMs ?? cli.interactive.debounce_ms;\n    if (debounceMs !== undefined) {\n      interactive.debounceMs = debounceMs;\n    }\n    if (Object.keys(interactive).length > 0) {\n      normalized.interactive = interactive as InteractiveConfig;\n    }\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n\n/**\n * Normalize MCP configuration from snake_case to camelCase\n */\nfunction normalizeMcpConfig(\n  mcp: Partial<{\n    defaultLimit?: number;\n    default_limit?: number;\n  }>\n): Partial<McpConfig> | undefined {\n  const normalized: Partial<McpConfig> = {};\n\n  const defaultLimit = mcp.defaultLimit ?? mcp.default_limit;\n  if (defaultLimit !== undefined) {\n    normalized.defaultLimit = defaultLimit;\n  }\n\n  return Object.keys(normalized).length > 0 ? normalized : undefined;\n}\n","/**\n * Default configuration values\n */\n\nimport { tmpdir } from \"node:os\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { Config } from \"./schema.js\";\n\n/**\n * Get the default backup directory\n * Uses $TMPDIR/reference-manager/backups/\n */\nexport function getDefaultBackupDirectory(): string {\n  return join(tmpdir(), \"reference-manager\", \"backups\");\n}\n\n/**\n * Get the default library path\n * Uses ~/.reference-manager/csl.library.json\n */\nexport function getDefaultLibraryPath(): string {\n  return join(homedir(), \".reference-manager\", \"csl.library.json\");\n}\n\n/**\n * Get the default user config path\n * Uses ~/.reference-manager/config.toml\n */\nexport function getDefaultUserConfigPath(): string {\n  return join(homedir(), \".reference-manager\", \"config.toml\");\n}\n\n/**\n * Get the default current directory config filename\n * Uses .reference-manager.config.toml\n */\nexport function getDefaultCurrentDirConfigFilename(): string {\n  return \".reference-manager.config.toml\";\n}\n\n/**\n * Get the default CSL directory\n * Uses ~/.reference-manager/csl/\n */\nexport function getDefaultCslDirectory(): string {\n  return join(homedir(), \".reference-manager\", \"csl\");\n}\n\n/**\n * Get the default fulltext directory\n * Uses ~/.reference-manager/fulltext/\n */\nexport function getDefaultFulltextDirectory(): string {\n  return join(homedir(), \".reference-manager\", \"fulltext\");\n}\n\n/**\n * Default configuration\n */\nexport const defaultConfig: Config = {\n  library: getDefaultLibraryPath(),\n  logLevel: \"info\",\n  backup: {\n    maxGenerations: 50,\n    maxAgeDays: 365,\n    directory: getDefaultBackupDirectory(),\n  },\n  watch: {\n    debounceMs: 500,\n    pollIntervalMs: 5000,\n    retryIntervalMs: 200,\n    maxRetries: 10,\n  },\n  server: {\n    autoStart: false,\n    autoStopMinutes: 0,\n  },\n  citation: {\n    defaultStyle: \"apa\",\n    cslDirectory: [getDefaultCslDirectory()],\n    defaultLocale: \"en-US\",\n    defaultFormat: \"text\",\n  },\n  pubmed: {\n    email: undefined,\n    apiKey: undefined,\n  },\n  fulltext: {\n    directory: getDefaultFulltextDirectory(),\n  },\n  cli: {\n    defaultLimit: 0,\n    defaultSort: \"updated\",\n    defaultOrder: \"desc\",\n    interactive: {\n      limit: 20,\n      debounceMs: 200,\n    },\n  },\n  mcp: {\n    defaultLimit: 20,\n  },\n};\n","/**\n * Configuration loader\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { parse as parseTOML } from \"@iarna/toml\";\nimport {\n  defaultConfig,\n  getDefaultCurrentDirConfigFilename,\n  getDefaultUserConfigPath,\n} from \"./defaults.js\";\nimport {\n  type Config,\n  type DeepPartialConfig,\n  type PartialConfig,\n  configSchema,\n  normalizePartialConfig,\n  partialConfigSchema,\n} from \"./schema.js\";\n\n/**\n * Options for loading configuration\n */\nexport interface LoadConfigOptions {\n  /** Current working directory (default: process.cwd()) */\n  cwd?: string;\n  /** User config path (default: ~/.reference-manager/config.toml) */\n  userConfigPath?: string;\n  /** CLI argument overrides */\n  overrides?: Partial<Config>;\n}\n\n/**\n * Load and parse a TOML config file\n */\nfunction loadTOMLFile(path: string): PartialConfig | null {\n  if (!existsSync(path)) {\n    return null;\n  }\n\n  try {\n    const content = readFileSync(path, \"utf-8\");\n    const parsed = parseTOML(content);\n\n    // Validate with partial schema\n    const validated = partialConfigSchema.parse(parsed);\n    return validated;\n  } catch (error) {\n    throw new Error(\n      `Failed to load config from ${path}: ${error instanceof Error ? error.message : String(error)}`\n    );\n  }\n}\n\n/**\n * Merge CLI config with nested interactive section\n */\nfunction mergeCliConfig(\n  base: DeepPartialConfig[\"cli\"],\n  override: NonNullable<DeepPartialConfig[\"cli\"]>\n): NonNullable<DeepPartialConfig[\"cli\"]> {\n  const { interactive: overrideInteractive, ...overrideCliRest } = override;\n  const { interactive: baseInteractive, ...baseCliRest } = base ?? {};\n  const mergedInteractive =\n    overrideInteractive !== undefined\n      ? { ...baseInteractive, ...overrideInteractive }\n      : baseInteractive;\n  return {\n    ...baseCliRest,\n    ...overrideCliRest,\n    ...(mergedInteractive !== undefined ? { interactive: mergedInteractive } : {}),\n  };\n}\n\n/**\n * Merge partial configurations\n * Later configs override earlier ones\n */\nfunction mergeConfigs(\n  base: DeepPartialConfig,\n  ...overrides: (DeepPartialConfig | null | undefined)[]\n): DeepPartialConfig {\n  const result: DeepPartialConfig = { ...base };\n\n  const sectionKeys = [\n    \"backup\",\n    \"watch\",\n    \"server\",\n    \"citation\",\n    \"pubmed\",\n    \"fulltext\",\n    \"mcp\",\n  ] as const;\n\n  for (const override of overrides) {\n    if (!override) continue;\n\n    // Merge top-level primitive fields\n    if (override.library !== undefined) {\n      result.library = override.library;\n    }\n    if (override.logLevel !== undefined) {\n      result.logLevel = override.logLevel;\n    }\n\n    // Merge section configs\n    for (const key of sectionKeys) {\n      if (override[key] !== undefined) {\n        result[key] = {\n          ...result[key],\n          ...override[key],\n        };\n      }\n    }\n\n    // Merge cli config with nested interactive\n    if (override.cli !== undefined) {\n      result.cli = mergeCliConfig(result.cli, override.cli);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Fill missing fields with defaults\n */\nfunction fillDefaults(partial: DeepPartialConfig): Config {\n  return {\n    library: partial.library ?? defaultConfig.library,\n    logLevel: partial.logLevel ?? defaultConfig.logLevel,\n    backup: {\n      maxGenerations: partial.backup?.maxGenerations ?? defaultConfig.backup.maxGenerations,\n      maxAgeDays: partial.backup?.maxAgeDays ?? defaultConfig.backup.maxAgeDays,\n      directory: partial.backup?.directory ?? defaultConfig.backup.directory,\n    },\n    watch: {\n      debounceMs: partial.watch?.debounceMs ?? defaultConfig.watch.debounceMs,\n      pollIntervalMs: partial.watch?.pollIntervalMs ?? defaultConfig.watch.pollIntervalMs,\n      retryIntervalMs: partial.watch?.retryIntervalMs ?? defaultConfig.watch.retryIntervalMs,\n      maxRetries: partial.watch?.maxRetries ?? defaultConfig.watch.maxRetries,\n    },\n    server: {\n      autoStart: partial.server?.autoStart ?? defaultConfig.server.autoStart,\n      autoStopMinutes: partial.server?.autoStopMinutes ?? defaultConfig.server.autoStopMinutes,\n    },\n    citation: fillCitationDefaults(partial.citation),\n    pubmed: fillPubmedDefaults(partial.pubmed),\n    fulltext: fillFulltextDefaults(partial.fulltext),\n    cli: fillCliDefaults(partial.cli),\n    mcp: fillMcpDefaults(partial.mcp),\n  };\n}\n\n/**\n * Fill citation config with defaults\n */\nfunction fillCitationDefaults(partial: DeepPartialConfig[\"citation\"]): Config[\"citation\"] {\n  return {\n    defaultStyle: partial?.defaultStyle ?? defaultConfig.citation.defaultStyle,\n    cslDirectory: partial?.cslDirectory ?? defaultConfig.citation.cslDirectory,\n    defaultLocale: partial?.defaultLocale ?? defaultConfig.citation.defaultLocale,\n    defaultFormat: partial?.defaultFormat ?? defaultConfig.citation.defaultFormat,\n  };\n}\n\n/**\n * Fill pubmed config with defaults\n * Environment variables take priority over config file values\n */\nfunction fillPubmedDefaults(partial: DeepPartialConfig[\"pubmed\"]): Config[\"pubmed\"] {\n  // Environment variables take priority\n  const email = process.env.PUBMED_EMAIL ?? partial?.email ?? defaultConfig.pubmed.email;\n  const apiKey = process.env.PUBMED_API_KEY ?? partial?.apiKey ?? defaultConfig.pubmed.apiKey;\n\n  return {\n    email,\n    apiKey,\n  };\n}\n\n/**\n * Expand ~ to home directory\n */\nfunction expandTilde(path: string): string {\n  if (path.startsWith(\"~/\")) {\n    return join(homedir(), path.slice(2));\n  }\n  return path;\n}\n\n/**\n * Fill fulltext config with defaults\n *\n * Priority:\n * 1. Environment variable REFERENCE_MANAGER_FULLTEXT_DIR\n * 2. Config file setting\n * 3. Default value\n */\nfunction fillFulltextDefaults(partial: DeepPartialConfig[\"fulltext\"]): Config[\"fulltext\"] {\n  const envDir = process.env.REFERENCE_MANAGER_FULLTEXT_DIR;\n  const directory = envDir ?? partial?.directory ?? defaultConfig.fulltext.directory;\n  return {\n    directory: expandTilde(directory),\n  };\n}\n\n/**\n * Fill CLI config with defaults\n *\n * Priority:\n * 1. Environment variable REFERENCE_MANAGER_CLI_DEFAULT_LIMIT\n * 2. Config file setting\n * 3. Default value\n */\nfunction fillCliDefaults(partial: DeepPartialConfig[\"cli\"]): Config[\"cli\"] {\n  const envLimit = process.env.REFERENCE_MANAGER_CLI_DEFAULT_LIMIT;\n  const defaultLimit =\n    envLimit !== undefined\n      ? Number(envLimit)\n      : (partial?.defaultLimit ?? defaultConfig.cli.defaultLimit);\n  return {\n    defaultLimit,\n    defaultSort: partial?.defaultSort ?? defaultConfig.cli.defaultSort,\n    defaultOrder: partial?.defaultOrder ?? defaultConfig.cli.defaultOrder,\n    interactive: {\n      limit: partial?.interactive?.limit ?? defaultConfig.cli.interactive.limit,\n      debounceMs: partial?.interactive?.debounceMs ?? defaultConfig.cli.interactive.debounceMs,\n    },\n  };\n}\n\n/**\n * Fill MCP config with defaults\n *\n * Priority:\n * 1. Environment variable REFERENCE_MANAGER_MCP_DEFAULT_LIMIT\n * 2. Config file setting\n * 3. Default value\n */\nfunction fillMcpDefaults(partial: DeepPartialConfig[\"mcp\"]): Config[\"mcp\"] {\n  const envLimit = process.env.REFERENCE_MANAGER_MCP_DEFAULT_LIMIT;\n  const defaultLimit =\n    envLimit !== undefined\n      ? Number(envLimit)\n      : (partial?.defaultLimit ?? defaultConfig.mcp.defaultLimit);\n  return {\n    defaultLimit,\n  };\n}\n\n/**\n * Load configuration from multiple sources\n *\n * Priority (highest to lowest):\n * 1. CLI argument overrides\n * 2. Current directory config (.reference-manager.config.toml)\n * 3. Environment variable (REFERENCE_MANAGER_CONFIG)\n * 4. User config (~/.reference-manager/config.toml)\n * 5. Default values\n */\nexport function loadConfig(options: LoadConfigOptions = {}): Config {\n  const cwd = options.cwd ?? process.cwd();\n  const userConfigPath = options.userConfigPath ?? getDefaultUserConfigPath();\n\n  // 1. Load user config (lowest priority)\n  const userConfig = loadTOMLFile(userConfigPath);\n\n  // 2. Load environment variable config\n  const envConfigPath = process.env.REFERENCE_MANAGER_CONFIG;\n  const envConfig = envConfigPath ? loadTOMLFile(envConfigPath) : null;\n\n  // 3. Load current directory config (highest priority)\n  const currentConfigPath = join(cwd, getDefaultCurrentDirConfigFilename());\n  const currentConfig = loadTOMLFile(currentConfigPath);\n\n  // Normalize snake_case to camelCase\n  const normalizedUser = userConfig ? normalizePartialConfig(userConfig) : null;\n  const normalizedEnv = envConfig ? normalizePartialConfig(envConfig) : null;\n  const normalizedCurrent = currentConfig ? normalizePartialConfig(currentConfig) : null;\n\n  // Merge configs (priority: current > env > user > defaults)\n  const merged = mergeConfigs(\n    {},\n    normalizedUser,\n    normalizedEnv,\n    normalizedCurrent,\n    options.overrides\n  );\n\n  // Fill missing fields with defaults\n  const config = fillDefaults(merged);\n\n  // Validate final config\n  try {\n    return configSchema.parse(config);\n  } catch (error) {\n    throw new Error(\n      `Invalid configuration: ${error instanceof Error ? error.message : String(error)}`\n    );\n  }\n}\n"],"names":["parseTOML"],"mappings":";;;;;;;AAOO,SAAS,iBAAiB,UAA4B;AAC3D,UAAQ,UAAA;AAAA,IACN,KAAK;AACH,aAAO,CAAC,MAAM;AAAA,IAChB,KAAK;AACH,aAAO,CAAC,UAAU;AAAA,IACpB,KAAK;AACH,aAAO,CAAC,OAAO,MAAM,SAAS,EAAE;AAAA,IAClC;AACE,YAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AAAA,EAAA;AAEzD;AAOA,eAAsB,kBACpB,UACA,WAAmB,QAAQ,UACZ;AACf,QAAM,eAAe,iBAAiB,QAAQ;AAC9C,QAAM,CAAC,SAAS,GAAG,QAAQ,IAAI;AAC/B,QAAM,OAAO,CAAC,GAAG,UAAU,QAAQ;AAEnC,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,OAAqB,MAAM,SAAmB,MAAM;AAAA,MACxD,UAAU;AAAA,MACV,OAAO;AAAA,IAAA,CACR;AAED,SAAK,GAAG,SAAS,MAAM;AACrB,aAAO,IAAI,MAAM,wBAAwB,QAAQ,EAAE,CAAC;AAAA,IACtD,CAAC;AAED,SAAK,GAAG,SAAS,CAAC,SAAwB;AACxC,UAAI,SAAS,GAAG;AACd,gBAAA;AAAA,MACF,OAAO;AACL,eAAO,IAAI,MAAM,wBAAwB,QAAQ,EAAE,CAAC;AAAA,MACtD;AAAA,IACF,CAAC;AAED,SAAK,MAAA;AAAA,EACP,CAAC;AACH;AC3CO,MAAM,iBAAiB,EAAE,KAAK,CAAC,UAAU,QAAQ,OAAO,CAAC;AAKzD,MAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,YAAA;AAAA,EACxB,YAAY,EAAE,SAAS,IAAA,EAAM,YAAA;AAC/B,CAAC;AAKM,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,cAAc,EAAE,OAAA,EAAS,IAAA,EAAM,YAAA;AAAA,EAC/B,aAAa;AAAA,EACb,cAAc;AAAA,EACd,aAAa;AACf,CAAC;AAKM,MAAM,kBAAkB,EAAE,OAAO;AAAA,EACtC,cAAc,EAAE,SAAS,IAAA,EAAM,YAAA;AACjC,CAAC;AAKM,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,gBAAgB,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EACjC,YAAY,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EAC7B,WAAW,EAAE,OAAA,EAAS,IAAI,CAAC;AAC7B,CAAC;AAOM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,YAAY,EAAE,OAAA,EAAS,IAAA,EAAM,YAAA;AAAA,EAC7B,gBAAgB,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EACjC,iBAAiB,EAAE,OAAA,EAAS,IAAA,EAAM,SAAA;AAAA,EAClC,YAAY,EAAE,SAAS,IAAA,EAAM,YAAA;AAC/B,CAAC;AAKM,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,WAAW,EAAE,QAAA;AAAA,EACb,iBAAiB,EAAE,SAAS,IAAA,EAAM,YAAA;AACpC,CAAC;AAKM,MAAM,uBAAuB,EAAE,KAAK,CAAC,QAAQ,QAAQ,KAAK,CAAC;AAK3D,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,cAAc,EAAE,OAAA;AAAA,EAChB,cAAc,EAAE,MAAM,EAAE,QAAQ;AAAA,EAChC,eAAe,EAAE,OAAA;AAAA,EACjB,eAAe;AACjB,CAAC;AAKM,MAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,OAAO,EAAE,OAAA,EAAS,SAAA;AAAA,EAClB,QAAQ,EAAE,OAAA,EAAS,SAAA;AACrB,CAAC;AAKM,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,WAAW,EAAE,OAAA,EAAS,IAAI,CAAC;AAC7B,CAAC;AAKM,MAAM,eAAe,EAAE,OAAO;AAAA,EACnC,SAAS,EAAE,SAAS,IAAI,CAAC;AAAA,EACzB,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,KAAK;AAAA,EACL,KAAK;AACP,CAAC;AAMM,MAAM,sBAAsB,EAChC,OAAO;AAAA,EACN,SAAS,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,SAAA;AAAA,EAC3B,UAAU,eAAe,SAAA;AAAA,EACzB,WAAW,eAAe,SAAA;AAAA;AAAA,EAC1B,QAAQ,EACL,OAAO;AAAA,IACN,gBAAgB,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC5C,iBAAiB,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC7C,YAAY,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IACxC,cAAc,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC1C,WAAW,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,SAAA;AAAA,EAAS,CACvC,EACA,SAAA;AAAA,EACH,OAAO,EACJ,OAAO;AAAA,IACN,YAAY,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAC3C,aAAa,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAC5C,gBAAgB,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC5C,kBAAkB,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC9C,iBAAiB,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC7C,mBAAmB,EAAE,OAAA,EAAS,MAAM,SAAA,EAAW,SAAA;AAAA,IAC/C,YAAY,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAC3C,aAAa,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,EAAS,CACtD,EACA,SAAA;AAAA,EACH,QAAQ,EACL,OAAO;AAAA,IACN,WAAW,EAAE,QAAA,EAAU,SAAA;AAAA,IACvB,YAAY,EAAE,QAAA,EAAU,SAAA;AAAA,IACxB,iBAAiB,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAChD,mBAAmB,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,EAAS,CAC5D,EACA,SAAA;AAAA,EACH,UAAU,EACP,OAAO;AAAA,IACN,cAAc,EAAE,OAAA,EAAS,SAAA;AAAA,IACzB,eAAe,EAAE,OAAA,EAAS,SAAA;AAAA,IAC1B,cAAc,EAAE,MAAM,CAAC,EAAE,OAAA,GAAU,EAAE,MAAM,EAAE,OAAA,CAAQ,CAAC,CAAC,EAAE,SAAA;AAAA,IACzD,eAAe,EAAE,MAAM,CAAC,EAAE,OAAA,GAAU,EAAE,MAAM,EAAE,OAAA,CAAQ,CAAC,CAAC,EAAE,SAAA;AAAA,IAC1D,eAAe,EAAE,OAAA,EAAS,SAAA;AAAA,IAC1B,gBAAgB,EAAE,OAAA,EAAS,SAAA;AAAA,IAC3B,eAAe,qBAAqB,SAAA;AAAA,IACpC,gBAAgB,qBAAqB,SAAA;AAAA,EAAS,CAC/C,EACA,SAAA;AAAA,EACH,QAAQ,EACL,OAAO;AAAA,IACN,OAAO,EAAE,OAAA,EAAS,SAAA;AAAA,IAClB,QAAQ,EAAE,OAAA,EAAS,SAAA;AAAA,IACnB,SAAS,EAAE,OAAA,EAAS,SAAA;AAAA,EAAS,CAC9B,EACA,SAAA;AAAA,EACH,UAAU,EACP,OAAO;AAAA,IACN,WAAW,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,SAAA;AAAA,EAAS,CACvC,EACA,SAAA;AAAA,EACH,KAAK,EACF,OAAO;AAAA,IACN,cAAc,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAC7C,eAAe,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAC9C,aAAa,gBAAgB,SAAA;AAAA,IAC7B,cAAc,gBAAgB,SAAA;AAAA,IAC9B,cAAc,gBAAgB,SAAA;AAAA,IAC9B,eAAe,gBAAgB,SAAA;AAAA,IAC/B,aAAa,EACV,OAAO;AAAA,MACN,OAAO,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,MACtC,YAAY,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,MAC3C,aAAa,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAAS,CACtD,EACA,SAAA;AAAA,EAAS,CACb,EACA,SAAA;AAAA,EACH,KAAK,EACF,OAAO;AAAA,IACN,cAAc,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,IAC7C,eAAe,EAAE,OAAA,EAAS,MAAM,YAAA,EAAc,SAAA;AAAA,EAAS,CACxD,EACA,SAAA;AACL,CAAC,EACA,YAAA;AAwCH,SAAS,sBACP,QAOmC;AACnC,QAAM,aAAoC,CAAA;AAE1C,QAAM,iBAAiB,OAAO,kBAAkB,OAAO;AACvD,MAAI,mBAAmB,QAAW;AAChC,eAAW,iBAAiB;AAAA,EAC9B;AAEA,QAAM,aAAa,OAAO,cAAc,OAAO;AAC/C,MAAI,eAAe,QAAW;AAC5B,eAAW,aAAa;AAAA,EAC1B;AAEA,MAAI,OAAO,cAAc,QAAW;AAClC,eAAW,YAAY,OAAO;AAAA,EAChC;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,SAAS,qBACP,OAUkC;AAClC,QAAM,aAAmC,CAAA;AAEzC,QAAM,aAAa,MAAM,cAAc,MAAM;AAC7C,MAAI,eAAe,QAAW;AAC5B,eAAW,aAAa;AAAA,EAC1B;AAEA,QAAM,iBAAiB,MAAM,kBAAkB,MAAM;AACrD,MAAI,mBAAmB,QAAW;AAChC,eAAW,iBAAiB;AAAA,EAC9B;AAEA,QAAM,kBAAkB,MAAM,mBAAmB,MAAM;AACvD,MAAI,oBAAoB,QAAW;AACjC,eAAW,kBAAkB;AAAA,EAC/B;AAEA,QAAM,aAAa,MAAM,cAAc,MAAM;AAC7C,MAAI,eAAe,QAAW;AAC5B,eAAW,aAAa;AAAA,EAC1B;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,SAAS,sBACP,QAMmC;AACnC,QAAM,aAAoC,CAAA;AAE1C,QAAM,YAAY,OAAO,aAAa,OAAO;AAC7C,MAAI,cAAc,QAAW;AAC3B,eAAW,YAAY;AAAA,EACzB;AAEA,QAAM,kBAAkB,OAAO,mBAAmB,OAAO;AACzD,MAAI,oBAAoB,QAAW;AACjC,eAAW,kBAAkB;AAAA,EAC/B;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,SAAS,wBACP,UAUqC;AACrC,QAAM,aAAsC,CAAA;AAE5C,QAAM,eAAe,SAAS,gBAAgB,SAAS;AACvD,MAAI,iBAAiB,QAAW;AAC9B,eAAW,eAAe;AAAA,EAC5B;AAEA,QAAM,eAAe,SAAS,gBAAgB,SAAS;AACvD,MAAI,iBAAiB,QAAW;AAE9B,eAAW,eAAe,MAAM,QAAQ,YAAY,IAAI,eAAe,CAAC,YAAY;AAAA,EACtF;AAEA,QAAM,gBAAgB,SAAS,iBAAiB,SAAS;AACzD,MAAI,kBAAkB,QAAW;AAC/B,eAAW,gBAAgB;AAAA,EAC7B;AAEA,QAAM,gBAAgB,SAAS,iBAAiB,SAAS;AACzD,MAAI,kBAAkB,QAAW;AAC/B,eAAW,gBAAgB;AAAA,EAC7B;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,SAAS,sBACP,QAKmC;AACnC,QAAM,aAAoC,CAAA;AAE1C,MAAI,OAAO,UAAU,QAAW;AAC9B,eAAW,QAAQ,OAAO;AAAA,EAC5B;AAEA,QAAM,SAAS,OAAO,UAAU,OAAO;AACvC,MAAI,WAAW,QAAW;AACxB,eAAW,SAAS;AAAA,EACtB;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,MAAM,qBAAqB;AAAA,EACzB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,KAAK;AAAA,EACL,KAAK;AACP;AAOA,SAAS,gBACP,YACA,SACA,KACA,YACM;AACN,QAAM,QAAQ,QAAQ,GAAG;AACzB,MAAI,UAAU,QAAW;AACvB,UAAM,SAAU,WAAoE,KAAK;AACzF,QAAI,QAAQ;AACV,iBAAW,GAAG,IAAI;AAAA,IACpB;AAAA,EACF;AACF;AAKO,SAAS,uBAAuB,SAA2C;AAChF,QAAM,aAAgC,CAAA;AAGtC,MAAI,QAAQ,YAAY,QAAW;AACjC,eAAW,UAAU,QAAQ;AAAA,EAC/B;AACA,QAAM,WAAW,QAAQ,YAAY,QAAQ;AAC7C,MAAI,aAAa,QAAW;AAC1B,eAAW,WAAW;AAAA,EACxB;AAGA,aAAW,OAAO,OAAO,KAAK,kBAAkB,GAAmB;AACjE,oBAAgB,YAAY,SAAS,KAAK,mBAAmB,GAAG,CAAC;AAAA,EACnE;AAEA,SAAO;AACT;AAKA,SAAS,wBAAwB,UAEO;AACtC,QAAM,aAAsC,CAAA;AAE5C,MAAI,SAAS,cAAc,QAAW;AACpC,eAAW,YAAY,SAAS;AAAA,EAClC;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,SAAS,mBACP,KAagC;AAChC,QAAM,aAAiC,CAAA;AAEvC,QAAM,eAAe,IAAI,gBAAgB,IAAI;AAC7C,MAAI,iBAAiB,QAAW;AAC9B,eAAW,eAAe;AAAA,EAC5B;AAEA,QAAM,cAAc,IAAI,eAAe,IAAI;AAC3C,MAAI,gBAAgB,QAAW;AAC7B,eAAW,cAAc;AAAA,EAC3B;AAEA,QAAM,eAAe,IAAI,gBAAgB,IAAI;AAC7C,MAAI,iBAAiB,QAAW;AAC9B,eAAW,eAAe;AAAA,EAC5B;AAEA,MAAI,IAAI,gBAAgB,QAAW;AACjC,UAAM,cAA0C,CAAA;AAChD,QAAI,IAAI,YAAY,UAAU,QAAW;AACvC,kBAAY,QAAQ,IAAI,YAAY;AAAA,IACtC;AACA,UAAM,aAAa,IAAI,YAAY,cAAc,IAAI,YAAY;AACjE,QAAI,eAAe,QAAW;AAC5B,kBAAY,aAAa;AAAA,IAC3B;AACA,QAAI,OAAO,KAAK,WAAW,EAAE,SAAS,GAAG;AACvC,iBAAW,cAAc;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AAKA,SAAS,mBACP,KAIgC;AAChC,QAAM,aAAiC,CAAA;AAEvC,QAAM,eAAe,IAAI,gBAAgB,IAAI;AAC7C,MAAI,iBAAiB,QAAW;AAC9B,eAAW,eAAe;AAAA,EAC5B;AAEA,SAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,aAAa;AAC3D;AC7gBO,SAAS,4BAAoC;AAClD,SAAO,KAAK,UAAU,qBAAqB,SAAS;AACtD;AAMO,SAAS,wBAAgC;AAC9C,SAAO,KAAK,WAAW,sBAAsB,kBAAkB;AACjE;AAMO,SAAS,2BAAmC;AACjD,SAAO,KAAK,WAAW,sBAAsB,aAAa;AAC5D;AAMO,SAAS,qCAA6C;AAC3D,SAAO;AACT;AAMO,SAAS,yBAAiC;AAC/C,SAAO,KAAK,WAAW,sBAAsB,KAAK;AACpD;AAMO,SAAS,8BAAsC;AACpD,SAAO,KAAK,WAAW,sBAAsB,UAAU;AACzD;AAKO,MAAM,gBAAwB;AAAA,EACnC,SAAS,sBAAA;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AAAA,IACN,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,WAAW,0BAAA;AAAA,EAA0B;AAAA,EAEvC,OAAO;AAAA,IACL,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,YAAY;AAAA,EAAA;AAAA,EAEd,QAAQ;AAAA,IACN,WAAW;AAAA,IACX,iBAAiB;AAAA,EAAA;AAAA,EAEnB,UAAU;AAAA,IACR,cAAc;AAAA,IACd,cAAc,CAAC,wBAAwB;AAAA,IACvC,eAAe;AAAA,IACf,eAAe;AAAA,EAAA;AAAA,EAEjB,QAAQ;AAAA,IACN,OAAO;AAAA,IACP,QAAQ;AAAA,EAAA;AAAA,EAEV,UAAU;AAAA,IACR,WAAW,4BAAA;AAAA,EAA4B;AAAA,EAEzC,KAAK;AAAA,IACH,cAAc;AAAA,IACd,aAAa;AAAA,IACb,cAAc;AAAA,IACd,aAAa;AAAA,MACX,OAAO;AAAA,MACP,YAAY;AAAA,IAAA;AAAA,EACd;AAAA,EAEF,KAAK;AAAA,IACH,cAAc;AAAA,EAAA;AAElB;AClEA,SAAS,aAAa,MAAoC;AACxD,MAAI,CAAC,WAAW,IAAI,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,UAAU,aAAa,MAAM,OAAO;AAC1C,UAAM,SAASA,MAAU,OAAO;AAGhC,UAAM,YAAY,oBAAoB,MAAM,MAAM;AAClD,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,8BAA8B,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IAAA;AAAA,EAEjG;AACF;AAKA,SAAS,eACP,MACA,UACuC;AACvC,QAAM,EAAE,aAAa,qBAAqB,GAAG,oBAAoB;AACjE,QAAM,EAAE,aAAa,iBAAiB,GAAG,YAAA,IAAgB,QAAQ,CAAA;AACjE,QAAM,oBACJ,wBAAwB,SACpB,EAAE,GAAG,iBAAiB,GAAG,wBACzB;AACN,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAI,sBAAsB,SAAY,EAAE,aAAa,kBAAA,IAAsB,CAAA;AAAA,EAAC;AAEhF;AAMA,SAAS,aACP,SACG,WACgB;AACnB,QAAM,SAA4B,EAAE,GAAG,KAAA;AAEvC,QAAM,cAAc;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAGF,aAAW,YAAY,WAAW;AAChC,QAAI,CAAC,SAAU;AAGf,QAAI,SAAS,YAAY,QAAW;AAClC,aAAO,UAAU,SAAS;AAAA,IAC5B;AACA,QAAI,SAAS,aAAa,QAAW;AACnC,aAAO,WAAW,SAAS;AAAA,IAC7B;AAGA,eAAW,OAAO,aAAa;AAC7B,UAAI,SAAS,GAAG,MAAM,QAAW;AAC/B,eAAO,GAAG,IAAI;AAAA,UACZ,GAAG,OAAO,GAAG;AAAA,UACb,GAAG,SAAS,GAAG;AAAA,QAAA;AAAA,MAEnB;AAAA,IACF;AAGA,QAAI,SAAS,QAAQ,QAAW;AAC9B,aAAO,MAAM,eAAe,OAAO,KAAK,SAAS,GAAG;AAAA,IACtD;AAAA,EACF;AAEA,SAAO;AACT;AAKA,SAAS,aAAa,SAAoC;AACxD,SAAO;AAAA,IACL,SAAS,QAAQ,WAAW,cAAc;AAAA,IAC1C,UAAU,QAAQ,YAAY,cAAc;AAAA,IAC5C,QAAQ;AAAA,MACN,gBAAgB,QAAQ,QAAQ,kBAAkB,cAAc,OAAO;AAAA,MACvE,YAAY,QAAQ,QAAQ,cAAc,cAAc,OAAO;AAAA,MAC/D,WAAW,QAAQ,QAAQ,aAAa,cAAc,OAAO;AAAA,IAAA;AAAA,IAE/D,OAAO;AAAA,MACL,YAAY,QAAQ,OAAO,cAAc,cAAc,MAAM;AAAA,MAC7D,gBAAgB,QAAQ,OAAO,kBAAkB,cAAc,MAAM;AAAA,MACrE,iBAAiB,QAAQ,OAAO,mBAAmB,cAAc,MAAM;AAAA,MACvE,YAAY,QAAQ,OAAO,cAAc,cAAc,MAAM;AAAA,IAAA;AAAA,IAE/D,QAAQ;AAAA,MACN,WAAW,QAAQ,QAAQ,aAAa,cAAc,OAAO;AAAA,MAC7D,iBAAiB,QAAQ,QAAQ,mBAAmB,cAAc,OAAO;AAAA,IAAA;AAAA,IAE3E,UAAU,qBAAqB,QAAQ,QAAQ;AAAA,IAC/C,QAAQ,mBAAmB,QAAQ,MAAM;AAAA,IACzC,UAAU,qBAAqB,QAAQ,QAAQ;AAAA,IAC/C,KAAK,gBAAgB,QAAQ,GAAG;AAAA,IAChC,KAAK,gBAAgB,QAAQ,GAAG;AAAA,EAAA;AAEpC;AAKA,SAAS,qBAAqB,SAA4D;AACxF,SAAO;AAAA,IACL,cAAc,SAAS,gBAAgB,cAAc,SAAS;AAAA,IAC9D,cAAc,SAAS,gBAAgB,cAAc,SAAS;AAAA,IAC9D,eAAe,SAAS,iBAAiB,cAAc,SAAS;AAAA,IAChE,eAAe,SAAS,iBAAiB,cAAc,SAAS;AAAA,EAAA;AAEpE;AAMA,SAAS,mBAAmB,SAAwD;AAElF,QAAM,QAAQ,QAAQ,IAAI,gBAAgB,SAAS,SAAS,cAAc,OAAO;AACjF,QAAM,SAAS,QAAQ,IAAI,kBAAkB,SAAS,UAAU,cAAc,OAAO;AAErF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;AAKA,SAAS,YAAY,MAAsB;AACzC,MAAI,KAAK,WAAW,IAAI,GAAG;AACzB,WAAO,KAAK,QAAA,GAAW,KAAK,MAAM,CAAC,CAAC;AAAA,EACtC;AACA,SAAO;AACT;AAUA,SAAS,qBAAqB,SAA4D;AACxF,QAAM,SAAS,QAAQ,IAAI;AAC3B,QAAM,YAAY,UAAU,SAAS,aAAa,cAAc,SAAS;AACzE,SAAO;AAAA,IACL,WAAW,YAAY,SAAS;AAAA,EAAA;AAEpC;AAUA,SAAS,gBAAgB,SAAkD;AACzE,QAAM,WAAW,QAAQ,IAAI;AAC7B,QAAM,eACJ,aAAa,SACT,OAAO,QAAQ,IACd,SAAS,gBAAgB,cAAc,IAAI;AAClD,SAAO;AAAA,IACL;AAAA,IACA,aAAa,SAAS,eAAe,cAAc,IAAI;AAAA,IACvD,cAAc,SAAS,gBAAgB,cAAc,IAAI;AAAA,IACzD,aAAa;AAAA,MACX,OAAO,SAAS,aAAa,SAAS,cAAc,IAAI,YAAY;AAAA,MACpE,YAAY,SAAS,aAAa,cAAc,cAAc,IAAI,YAAY;AAAA,IAAA;AAAA,EAChF;AAEJ;AAUA,SAAS,gBAAgB,SAAkD;AACzE,QAAM,WAAW,QAAQ,IAAI;AAC7B,QAAM,eACJ,aAAa,SACT,OAAO,QAAQ,IACd,SAAS,gBAAgB,cAAc,IAAI;AAClD,SAAO;AAAA,IACL;AAAA,EAAA;AAEJ;AAYO,SAAS,WAAW,UAA6B,IAAY;AAClE,QAAM,MAAM,QAAQ,OAAO,QAAQ,IAAA;AACnC,QAAM,iBAAiB,QAAQ,kBAAkB,yBAAA;AAGjD,QAAM,aAAa,aAAa,cAAc;AAG9C,QAAM,gBAAgB,QAAQ,IAAI;AAClC,QAAM,YAAY,gBAAgB,aAAa,aAAa,IAAI;AAGhE,QAAM,oBAAoB,KAAK,KAAK,mCAAA,CAAoC;AACxE,QAAM,gBAAgB,aAAa,iBAAiB;AAGpD,QAAM,iBAAiB,aAAa,uBAAuB,UAAU,IAAI;AACzE,QAAM,gBAAgB,YAAY,uBAAuB,SAAS,IAAI;AACtE,QAAM,oBAAoB,gBAAgB,uBAAuB,aAAa,IAAI;AAGlF,QAAM,SAAS;AAAA,IACb,CAAA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,EAAA;AAIV,QAAM,SAAS,aAAa,MAAM;AAGlC,MAAI;AACF,WAAO,aAAa,MAAM,MAAM;AAAA,EAClC,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR,0BAA0B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,IAAA;AAAA,EAEpF;AACF;"}

package/dist/chunks/{search-prompt-D67WyKrY.js → search-prompt-RtHDJFgL.js}

@@ -94,8 +94,7 @@ function createChoices(results, terminalWidth) {
         index,
         item: result.reference
       }),
-      message: formattedText,
-      value: result.reference.id
+      message: formattedText
     };
   });
 }
@@ -115,6 +114,30 @@ function parseSelectedValues(values) {
 function getTerminalWidth() {
   return process.stdout.columns ?? 80;
 }
+function collectEnabledIds(choices) {
+  const enabledIds = /* @__PURE__ */ new Set();
+  for (const choice of choices) {
+    if (choice.enabled) {
+      try {
+        const data = JSON.parse(choice.name);
+        enabledIds.add(data.item.id);
+      } catch {
+      }
+    }
+  }
+  return enabledIds;
+}
+function restoreEnabledState(choices, enabledIds) {
+  for (const choice of choices) {
+    try {
+      const data = JSON.parse(choice.name);
+      if (enabledIds.has(data.item.id)) {
+        choice.enabled = true;
+      }
+    } catch {
+    }
+  }
+}
 async function runSearchPrompt(allReferences, searchFn, config, initialQuery = "") {
   const enquirer = await import("enquirer");
   const AutoComplete = enquirer.default.AutoComplete;
@@ -139,23 +162,29 @@ async function runSearchPrompt(allReferences, searchFn, config, initialQuery = "
         return choices;
       }
       lastQuery = input;
-      if (!input.trim()) {
-        const defaultResults = allReferences.slice(0, config.limit).map((ref) => ({
+      const enabledIds = collectEnabledIds(choices);
+      const newChoices = input.trim() ? createChoices(searchFn(input).slice(0, config.limit), terminalWidth) : createChoices(
+        allReferences.slice(0, config.limit).map((ref) => ({
           reference: ref,
           overallStrength: "exact",
           tokenMatches: [],
           score: 0
-        }));
-        return createChoices(defaultResults, terminalWidth);
-      }
-      const results = searchFn(input).slice(0, config.limit);
-      return createChoices(results, terminalWidth);
+        })),
+        terminalWidth
+      );
+      restoreEnabledState(newChoices, enabledIds);
+      return newChoices;
     }
   };
   try {
     const prompt = new AutoComplete(promptOptions);
     const result = await prompt.run();
-    const selected = parseSelectedValues(result);
+    const promptAny = prompt;
+    let valuesToParse = result;
+    if (Array.isArray(result) && result.length === 0 && promptAny.focused?.enabled && promptAny.focused?.name) {
+      valuesToParse = [promptAny.focused.name];
+    }
+    const selected = parseSelectedValues(valuesToParse);
     return {
       selected,
       cancelled: false
@@ -176,4 +205,4 @@ export {
   parseSelectedValues,
   runSearchPrompt
 };
-//# sourceMappingURL=search-prompt-D67WyKrY.js.map
+//# sourceMappingURL=search-prompt-RtHDJFgL.js.map

package/dist/chunks/search-prompt-RtHDJFgL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-prompt-RtHDJFgL.js","sources":["../../src/features/interactive/format.ts","../../src/features/interactive/search-prompt.ts"],"sourcesContent":["/**\n * Display format functions for interactive search\n */\n\nimport type { CslItem } from \"../../core/csl-json/types.js\";\n\n/**\n * CSL name type (author structure)\n */\ntype CslName = NonNullable<CslItem[\"author\"]>[number];\n\n/**\n * Format a single author name\n * - Personal: \"Smith, J.\" (family + initial of given)\n * - Institutional: \"World Health Organization\" (literal)\n */\nfunction formatSingleAuthor(author: CslName): string {\n  if (author.literal) {\n    return author.literal;\n  }\n  if (author.family) {\n    if (author.given) {\n      const initial = author.given.charAt(0).toUpperCase();\n      return `${author.family}, ${initial}.`;\n    }\n    return author.family;\n  }\n  return \"\";\n}\n\n/**\n * Format author list for display\n * - Single author: \"Smith, J.\"\n * - Two authors: \"Smith, J., & Doe, A.\"\n * - Three authors: \"Smith, J., Doe, A., & Johnson, B.\"\n * - More than three: \"Smith, J., et al.\"\n *\n * @param authors - Array of CSL author objects\n * @returns Formatted author string\n */\nexport function formatAuthors(authors: CslName[] | undefined): string {\n  if (!authors || authors.length === 0) {\n    return \"\";\n  }\n\n  if (authors.length > 3) {\n    const first = authors[0];\n    if (!first) {\n      return \"\";\n    }\n    return `${formatSingleAuthor(first)}, et al.`;\n  }\n\n  const formatted = authors.map(formatSingleAuthor);\n  if (formatted.length === 1) {\n    return formatted[0] ?? \"\";\n  }\n\n  // Join all but last with \", \" and append \"& \" + last\n  const allButLast = formatted.slice(0, -1).join(\", \");\n  const last = formatted[formatted.length - 1] ?? \"\";\n  return `${allButLast}, & ${last}`;\n}\n\n/**\n * Truncate title to fit terminal width\n *\n * @param title - Title string\n * @param maxWidth - Maximum display width\n * @returns Truncated title with ellipsis if needed\n */\nexport function formatTitle(title: string | undefined, maxWidth: number): string {\n  if (!title) {\n    return \"\";\n  }\n\n  if (title.length <= maxWidth) {\n    return title;\n  }\n\n  // Truncate and add ellipsis, keeping total length at maxWidth\n  return `${title.slice(0, maxWidth - 3)}...`;\n}\n\n/**\n * Format identifiers (DOI, PMID, PMCID, ISBN) for display\n *\n * @param item - CSL item\n * @returns Formatted identifier string (e.g., \"DOI: 10.1000/example | PMID: 12345678\")\n */\nexport function formatIdentifiers(item: CslItem): string {\n  const identifiers: string[] = [];\n\n  if (item.DOI) {\n    identifiers.push(`DOI: ${item.DOI}`);\n  }\n  if (item.PMID) {\n    identifiers.push(`PMID: ${item.PMID}`);\n  }\n  if (item.PMCID) {\n    identifiers.push(`PMCID: ${item.PMCID}`);\n  }\n  if (item.ISBN) {\n    identifiers.push(`ISBN: ${item.ISBN}`);\n  }\n\n  return identifiers.join(\" | \");\n}\n\n/**\n * Extract year from CSL item\n */\nfunction extractYear(item: CslItem): number | undefined {\n  const dateParts = item.issued?.[\"date-parts\"];\n  if (!dateParts || dateParts.length === 0) {\n    return undefined;\n  }\n  const firstDatePart = dateParts[0];\n  if (!firstDatePart || firstDatePart.length === 0) {\n    return undefined;\n  }\n  return firstDatePart[0];\n}\n\n/**\n * Compose a complete search result line\n *\n * Format:\n * ```\n * [1] Smith, J., & Doe, A. (2020)\n *     Machine learning in medicine: A comprehensive review\n *     DOI: 10.1000/example | PMID: 12345678\n * ```\n *\n * @param item - CSL item\n * @param index - Display index (1-based)\n * @param terminalWidth - Terminal width for title truncation\n * @returns Multi-line formatted string\n */\nexport function formatSearchResult(item: CslItem, index: number, terminalWidth: number): string {\n  const lines: string[] = [];\n\n  // Line 1: [index] Authors (year)\n  const authors = formatAuthors(item.author);\n  const year = extractYear(item);\n  const yearPart = year !== undefined ? ` (${year})` : \"\";\n  const line1 = `[${index}] ${authors}${yearPart}`;\n  lines.push(line1);\n\n  // Line 2: Title (indented, truncated)\n  const indent = \"    \";\n  const titleMaxWidth = terminalWidth - indent.length;\n  const title = formatTitle(item.title, titleMaxWidth);\n  if (title) {\n    lines.push(`${indent}${title}`);\n  }\n\n  // Line 3: Identifiers (indented)\n  const identifiers = formatIdentifiers(item);\n  if (identifiers) {\n    lines.push(`${indent}${identifiers}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n","/**\n * Interactive search prompt using Enquirer's AutoComplete\n *\n * Provides real-time incremental search with multiple selection support.\n */\n\nimport type { CslItem } from \"../../core/csl-json/types.js\";\nimport type { SearchResult } from \"../search/types.js\";\nimport type { AutoCompleteChoice } from \"./enquirer.js\";\nimport { formatSearchResult } from \"./format.js\";\n\n/**\n * Configuration for the search prompt\n */\nexport interface SearchPromptConfig {\n  /** Maximum number of results to display */\n  limit: number;\n  /** Debounce delay in milliseconds */\n  debounceMs: number;\n}\n\n/**\n * Search function type for filtering references\n */\nexport type SearchFunction = (query: string) => SearchResult[];\n\n/**\n * Result from the search prompt\n */\nexport interface SearchPromptResult {\n  /** Selected references */\n  selected: CslItem[];\n  /** Whether the prompt was cancelled */\n  cancelled: boolean;\n}\n\n/**\n * Maps internal choice value to CslItem\n */\ninterface ChoiceData {\n  index: number;\n  item: CslItem;\n}\n\n/**\n * Creates choices from search results\n */\nexport function createChoices(\n  results: SearchResult[],\n  terminalWidth: number\n): AutoCompleteChoice[] {\n  return results.map((result, index) => {\n    const displayIndex = index + 1;\n    const formattedText = formatSearchResult(result.reference, displayIndex, terminalWidth);\n\n    // Enquirer returns the 'name' property on selection when 'value' is not defined\n    // So we store the JSON data in 'name' and use 'message' for display\n    return {\n      name: JSON.stringify({\n        index,\n        item: result.reference,\n      } satisfies ChoiceData),\n      message: formattedText,\n    };\n  });\n}\n\n/**\n * Parses selected values back to CslItems\n */\nexport function parseSelectedValues(values: string | string[]): CslItem[] {\n  const valueArray = Array.isArray(values) ? values : [values];\n  const items: CslItem[] = [];\n\n  for (const value of valueArray) {\n    if (!value) continue;\n    try {\n      const data = JSON.parse(value) as ChoiceData;\n      items.push(data.item);\n    } catch {\n      // If parsing fails, the value might be just the id (name)\n      // In this case, we can't recover the full item\n      // This shouldn't happen in normal operation\n    }\n  }\n\n  return items;\n}\n\n/**\n * Gets terminal width, falling back to 80 if not available\n */\nexport function getTerminalWidth(): number {\n  return process.stdout.columns ?? 80;\n}\n\n/**\n * Collects enabled (selected) item IDs from choices\n */\nfunction collectEnabledIds(choices: AutoCompleteChoice[]): Set<string> {\n  const enabledIds = new Set<string>();\n  for (const choice of choices) {\n    if ((choice as { enabled?: boolean }).enabled) {\n      try {\n        const data = JSON.parse(choice.name) as ChoiceData;\n        enabledIds.add(data.item.id);\n      } catch {\n        // Ignore parse errors\n      }\n    }\n  }\n  return enabledIds;\n}\n\n/**\n * Restores enabled state for choices matching the given IDs\n */\nfunction restoreEnabledState(choices: AutoCompleteChoice[], enabledIds: Set<string>): void {\n  for (const choice of choices) {\n    try {\n      const data = JSON.parse(choice.name) as ChoiceData;\n      if (enabledIds.has(data.item.id)) {\n        (choice as { enabled?: boolean }).enabled = true;\n      }\n    } catch {\n      // Ignore parse errors\n    }\n  }\n}\n\n/**\n * Creates and runs an interactive search prompt\n */\nexport async function runSearchPrompt(\n  allReferences: CslItem[],\n  searchFn: SearchFunction,\n  config: SearchPromptConfig,\n  initialQuery = \"\"\n): Promise<SearchPromptResult> {\n  // Dynamic import to allow mocking in tests\n  // enquirer is a CommonJS module, so we must use default import\n  const enquirer = await import(\"enquirer\");\n  const AutoComplete = (enquirer.default as unknown as Record<string, unknown>)\n    .AutoComplete as new (\n    options: Record<string, unknown>\n  ) => {\n    run(): Promise<string | string[]>;\n  };\n\n  const terminalWidth = getTerminalWidth();\n\n  // Create initial choices from all references (limited)\n  const initialResults: SearchResult[] = initialQuery\n    ? searchFn(initialQuery).slice(0, config.limit)\n    : allReferences.slice(0, config.limit).map((ref) => ({\n        reference: ref,\n        overallStrength: \"exact\" as const,\n        tokenMatches: [],\n        score: 0,\n      }));\n\n  const initialChoices = createChoices(initialResults, terminalWidth);\n\n  // Track last search query to avoid redundant searches\n  let lastQuery = initialQuery;\n\n  const promptOptions = {\n    name: \"references\",\n    message: \"Search references\",\n    initial: initialQuery,\n    choices: initialChoices,\n    multiple: true,\n    limit: config.limit,\n    suggest: (input: string, choices: AutoCompleteChoice[]) => {\n      // If input hasn't changed, return current choices\n      if (input === lastQuery) {\n        return choices;\n      }\n      lastQuery = input;\n\n      // Collect enabled (selected) item IDs from current choices\n      const enabledIds = collectEnabledIds(choices);\n\n      // Create new choices based on input\n      const newChoices = input.trim()\n        ? createChoices(searchFn(input).slice(0, config.limit), terminalWidth)\n        : createChoices(\n            allReferences.slice(0, config.limit).map((ref) => ({\n              reference: ref,\n              overallStrength: \"exact\" as const,\n              tokenMatches: [],\n              score: 0,\n            })),\n            terminalWidth\n          );\n\n      // Restore enabled state for matching items\n      restoreEnabledState(newChoices, enabledIds);\n\n      return newChoices;\n    },\n  };\n\n  try {\n    const prompt = new AutoComplete(promptOptions);\n    const result = await prompt.run();\n\n    // Workaround for Enquirer bug: focused item with enabled=true may not be in result\n    const promptAny = prompt as unknown as {\n      focused?: { name: string; enabled?: boolean };\n      selected?: Array<{ name: string }>;\n    };\n\n    let valuesToParse: string | string[] = result;\n\n    // If result is empty but focused item is enabled, use focused item\n    if (\n      Array.isArray(result) &&\n      result.length === 0 &&\n      promptAny.focused?.enabled &&\n      promptAny.focused?.name\n    ) {\n      valuesToParse = [promptAny.focused.name];\n    }\n\n    // Handle result\n    const selected = parseSelectedValues(valuesToParse);\n\n    return {\n      selected,\n      cancelled: false,\n    };\n  } catch (error) {\n    // Enquirer throws an empty string when cancelled\n    if (error === \"\" || (error instanceof Error && error.message === \"\")) {\n      return {\n        selected: [],\n        cancelled: true,\n      };\n    }\n    throw error;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/fulltext.d.ts

@@ -5,7 +5,7 @@
  */
 import type { IdentifierType } from "../../core/library-interface.js";
 import type { FulltextType } from "../../features/fulltext/index.js";
-import { type FulltextAttachResult, type FulltextDetachResult, type FulltextGetResult } from "../../features/operations/fulltext/index.js";
+import { type FulltextAttachResult, type FulltextDetachResult, type FulltextGetResult, type FulltextOpenResult } from "../../features/operations/fulltext/index.js";
 import type { ExecutionContext } from "../execution-context.js";
 /**
  * Options for fulltext attach command
@@ -41,7 +41,16 @@ export interface FulltextDetachOptions {
     idType?: IdentifierType;
     fulltextDirectory: string;
 }
-export type { FulltextAttachResult, FulltextGetResult, FulltextDetachResult };
+/**
+ * Options for fulltext open command
+ */
+export interface FulltextOpenOptions {
+    identifier: string;
+    type?: FulltextType;
+    idType?: IdentifierType;
+    fulltextDirectory: string;
+}
+export type { FulltextAttachResult, FulltextGetResult, FulltextDetachResult, FulltextOpenResult };
 /**
  * Execute fulltext attach command
  */
@@ -54,6 +63,10 @@ export declare function executeFulltextGet(options: FulltextGetOptions, context:
  * Execute fulltext detach command
  */
 export declare function executeFulltextDetach(options: FulltextDetachOptions, context: ExecutionContext): Promise<FulltextDetachResult>;
+/**
+ * Execute fulltext open command
+ */
+export declare function executeFulltextOpen(options: FulltextOpenOptions, context: ExecutionContext): Promise<FulltextOpenResult>;
 /**
  * Format fulltext attach output
  */
@@ -66,8 +79,12 @@ export declare function formatFulltextGetOutput(result: FulltextGetResult): stri
  * Format fulltext detach output
  */
 export declare function formatFulltextDetachOutput(result: FulltextDetachResult): string;
+/**
+ * Format fulltext open output
+ */
+export declare function formatFulltextOpenOutput(result: FulltextOpenResult): string;
 /**
  * Get exit code for fulltext command result
  */
-export declare function getFulltextExitCode(result: FulltextAttachResult | FulltextGetResult | FulltextDetachResult): number;
+export declare function getFulltextExitCode(result: FulltextAttachResult | FulltextGetResult | FulltextDetachResult | FulltextOpenResult): number;
 //# sourceMappingURL=fulltext.d.ts.map

package/dist/cli/commands/fulltext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fulltext.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fulltext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAOvB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAGD,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;AAE9E;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAa/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAU/B;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAiB/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAkBzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAe/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,oBAAoB,GACtE,MAAM,CAER"}
+{"version":3,"file":"fulltext.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fulltext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EASxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAGD,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;AAElG;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAa/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAU5B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAU/B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAiB/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAkBzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAe/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,kBAAkB,GAC3F,MAAM,CAER"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA+BvC;AAgyBD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6DpC;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA+BvC;AAm2BD;;GAEG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxD"}

package/dist/cli.js

@@ -8,12 +8,12 @@ import * as path from "node:path";
 import { join, extname } from "node:path";
 import { mkdir, unlink, rename, copyFile, rm, readFile } from "node:fs/promises";
 import { u as updateReference, B as BUILTIN_STYLES, s as startServerWithFileWatcher } from "./chunks/index-_7NEUoS7.js";
+import { o as openWithSystemApp, l as loadConfig } from "./chunks/loader-CLCZRS4m.js";
 import process$1, { stdin, stdout } from "node:process";
-import { l as loadConfig } from "./chunks/loader-BItrdVWG.js";
 import { spawn } from "node:child_process";
 import { serve } from "@hono/node-server";
 const name = "@ncukondo/reference-manager";
-const version$1 = "0.7.0";
+const version$1 = "0.8.0";
 const description$1 = "A local reference management tool using CSL-JSON as the single source of truth";
 const packageJson = {
   name,
@@ -607,6 +607,54 @@ async function fulltextDetach(library, options) {
     return handleDetachError(error);
   }
 }
+function getFulltextPath(item, type2, fulltextDirectory) {
+  const fulltext = item.custom?.fulltext;
+  if (!fulltext) return void 0;
+  const filename = type2 === "pdf" ? fulltext.pdf : fulltext.markdown;
+  if (!filename) return void 0;
+  return join(fulltextDirectory, filename);
+}
+function determineTypeToOpen(item) {
+  const fulltext = item.custom?.fulltext;
+  if (!fulltext) return void 0;
+  if (fulltext.pdf) return "pdf";
+  if (fulltext.markdown) return "markdown";
+  return void 0;
+}
+async function fulltextOpen(library, options) {
+  const { identifier, type: type2, idType = "id", fulltextDirectory } = options;
+  const item = await library.find(identifier, { idType });
+  if (!item) {
+    return { success: false, error: `Reference not found: ${identifier}` };
+  }
+  const typeToOpen = type2 ?? determineTypeToOpen(item);
+  if (!typeToOpen) {
+    return { success: false, error: `No fulltext attached to reference: ${identifier}` };
+  }
+  const filePath = getFulltextPath(item, typeToOpen, fulltextDirectory);
+  if (!filePath) {
+    return { success: false, error: `No ${typeToOpen} attached to reference: ${identifier}` };
+  }
+  if (!existsSync(filePath)) {
+    return {
+      success: false,
+      error: `Fulltext file not found: ${filePath} (metadata exists but file is missing)`
+    };
+  }
+  try {
+    await openWithSystemApp(filePath);
+    return {
+      success: true,
+      openedType: typeToOpen,
+      openedPath: filePath
+    };
+  } catch (_error) {
+    return {
+      success: false,
+      error: `Failed to open file: ${filePath}`
+    };
+  }
+}
 async function executeFulltextAttach(options, context) {
   const operationOptions = {
     identifier: options.identifier,
@@ -640,6 +688,15 @@ async function executeFulltextDetach(options, context) {
   };
   return fulltextDetach(context.library, operationOptions);
 }
+async function executeFulltextOpen(options, context) {
+  const operationOptions = {
+    identifier: options.identifier,
+    type: options.type,
+    idType: options.idType,
+    fulltextDirectory: options.fulltextDirectory
+  };
+  return fulltextOpen(context.library, operationOptions);
+}
 function formatFulltextAttachOutput(result) {
   if (result.requiresConfirmation) {
     return `File already attached: ${result.existingFile}
@@ -686,6 +743,12 @@ function formatFulltextDetachOutput(result) {
   }
   return lines.join("\n");
 }
+function formatFulltextOpenOutput(result) {
+  if (!result.success) {
+    return `Error: ${result.error}`;
+  }
+  return `Opened ${result.openedType}: ${result.openedPath}`;
+}
 function getFulltextExitCode(result) {
   return result.success ? 0 : 1;
 }
@@ -21627,7 +21690,7 @@ function validateInteractiveOptions(options) {
 async function executeInteractiveSearch(options, context, config2) {
   validateInteractiveOptions(options);
   const { checkTTY } = await import("./chunks/tty-CDBIQraQ.js");
-  const { runSearchPrompt } = await import("./chunks/search-prompt-D67WyKrY.js");
+  const { runSearchPrompt } = await import("./chunks/search-prompt-RtHDJFgL.js");
   const { runActionMenu } = await import("./chunks/action-menu-CTtINmWd.js");
   const { search } = await import("./chunks/file-watcher-D7oyc-9z.js").then((n) => n.y);
   const { tokenize } = await import("./chunks/file-watcher-D7oyc-9z.js").then((n) => n.x);
@@ -22005,7 +22068,7 @@ const OPTION_VALUES = {
   "--log-level": LOG_LEVELS
 };
 const ID_COMPLETION_COMMANDS = /* @__PURE__ */ new Set(["cite", "remove", "update"]);
-const ID_COMPLETION_FULLTEXT_SUBCOMMANDS = /* @__PURE__ */ new Set(["attach", "get", "detach"]);
+const ID_COMPLETION_FULLTEXT_SUBCOMMANDS = /* @__PURE__ */ new Set(["attach", "get", "detach", "open"]);
 function toCompletionItems(values) {
   return values.map((name2) => ({ name: name2 }));
 }
@@ -22787,6 +22850,48 @@ async function handleFulltextDetachAction(identifier, options, program) {
     process.exit(4);
   }
 }
+async function handleFulltextOpenAction(identifierArg, options, program) {
+  try {
+    const config2 = await loadConfigWithOverrides(program.opts());
+    let identifier;
+    if (identifierArg) {
+      identifier = identifierArg;
+    } else {
+      if (isTTY()) {
+        process.stderr.write("Error: Identifier is required when running interactively.\n");
+        process.exit(1);
+      }
+      const stdinId = (await readStdinContent()).split("\n")[0]?.trim() ?? "";
+      if (!stdinId) {
+        process.stderr.write("Error: No identifier provided from stdin.\n");
+        process.exit(1);
+      }
+      identifier = stdinId;
+    }
+    const context = await createExecutionContext(config2, Library.load);
+    const openOptions = {
+      identifier,
+      fulltextDirectory: config2.fulltext.directory,
+      ...options.pdf && { type: "pdf" },
+      ...options.markdown && { type: "markdown" },
+      ...options.uuid && { idType: "uuid" }
+    };
+    const result = await executeFulltextOpen(openOptions, context);
+    const output = formatFulltextOpenOutput(result);
+    if (result.success) {
+      process.stderr.write(`${output}
+`);
+    } else {
+      process.stderr.write(`${output}
+`);
+    }
+    process.exit(getFulltextExitCode(result));
+  } catch (error) {
+    process.stderr.write(`Error: ${error instanceof Error ? error.message : String(error)}
+`);
+    process.exit(4);
+  }
+}
 function registerFulltextCommand(program) {
   const fulltextCmd = program.command("fulltext").description("Manage full-text files attached to references");
   fulltextCmd.command("attach").description("Attach a full-text file to a reference").argument("<identifier>", "Citation key or UUID").argument("[file-path]", "Path to the file to attach").option("--pdf [path]", "Attach as PDF (path optional if provided as argument)").option("--markdown [path]", "Attach as Markdown (path optional if provided as argument)").option("--move", "Move file instead of copy").option("-f, --force", "Overwrite existing attachment").option("--uuid", "Interpret identifier as UUID").action(async (identifier, filePath, options) => {
@@ -22798,6 +22903,9 @@ function registerFulltextCommand(program) {
   fulltextCmd.command("detach").description("Detach full-text file from a reference").argument("<identifier>", "Citation key or UUID").option("--pdf", "Detach PDF only").option("--markdown", "Detach Markdown only").option("--delete", "Also delete the file from disk").option("-f, --force", "Skip confirmation for delete").option("--uuid", "Interpret identifier as UUID").action(async (identifier, options) => {
     await handleFulltextDetachAction(identifier, options, program);
   });
+  fulltextCmd.command("open").description("Open full-text file with system default application").argument("[identifier]", "Citation key or UUID (reads from stdin if not provided)").option("--pdf", "Open PDF file").option("--markdown", "Open Markdown file").option("--uuid", "Interpret identifier as UUID").action(async (identifier, options) => {
+    await handleFulltextOpenAction(identifier, options, program);
+  });
 }
 async function main(argv) {
   const program = createProgram();