@ncukondo/reference-manager 0.3.0 → 0.4.0

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAgC3B,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MA+B3B,CAAC"}

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AA+ID;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwClE"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AA8ID;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwClE"}

package/dist/config/schema.d.ts

@@ -20,9 +20,10 @@ export declare const backupConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * File watching configuration schema
+ * Note: File watching is always enabled in server mode (HTTP/MCP).
+ * CLI mode does not use file watching.
  */
 export declare const watchConfigSchema: z.ZodObject<{
-    enabled: z.ZodBoolean;
     debounceMs: z.ZodNumber;
     pollIntervalMs: z.ZodNumber;
     retryIntervalMs: z.ZodNumber;
@@ -85,7 +86,6 @@ export declare const configSchema: z.ZodObject<{
         directory: z.ZodString;
     }, z.core.$strip>;
     watch: z.ZodObject<{
-        enabled: z.ZodBoolean;
         debounceMs: z.ZodNumber;
         pollIntervalMs: z.ZodNumber;
         retryIntervalMs: z.ZodNumber;
@@ -137,7 +137,6 @@ export declare const partialConfigSchema: z.ZodObject<{
         directory: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     watch: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodOptional<z.ZodBoolean>;
         debounceMs: z.ZodOptional<z.ZodNumber>;
         debounce_ms: z.ZodOptional<z.ZodNumber>;
         pollIntervalMs: z.ZodOptional<z.ZodNumber>;

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAAsC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;EAAkC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAK/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4DhB,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC,CAAC;AAyKF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAmEhF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;EAAsC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;EAAkC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAK/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASvB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2DhB,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC,CAAC;AAoKF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAmEhF"}

package/dist/core/csl-json/types.d.ts

@@ -8,6 +8,7 @@ declare const CslCustomSchema: z.ZodObject<{
         pdf: z.ZodOptional<z.ZodString>;
         markdown: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$loose>;
 export declare const CslItemSchema: z.ZodObject<{
     id: z.ZodString;
@@ -67,6 +68,7 @@ export declare const CslItemSchema: z.ZodObject<{
             pdf: z.ZodOptional<z.ZodString>;
             markdown: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
 export declare const CslLibrarySchema: z.ZodArray<z.ZodObject<{
@@ -127,6 +129,7 @@ export declare const CslLibrarySchema: z.ZodArray<z.ZodObject<{
             pdf: z.ZodOptional<z.ZodString>;
             markdown: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$loose>>;
 }, z.core.$loose>>;
 export type CslCustom = z.infer<typeof CslCustomSchema>;

package/dist/core/csl-json/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/csl-json/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,QAAA,MAAM,eAAe;;;;;;;;;iBAQL,CAAC;AAGjB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BV,CAAC;AAGjB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyB,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/csl-json/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,QAAA,MAAM,eAAe;;;;;;;;;;iBASL,CAAC;AAGjB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2BV,CAAC;AAGjB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyB,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/core/library-interface.d.ts

@@ -0,0 +1,100 @@
+/**
+ * ILibrary - Common interface for library implementations.
+ *
+ * Both Library (local file-based) and ServerClient (HTTP-based) implement this interface,
+ * allowing operations to work with either implementation interchangeably.
+ *
+ * Design notes:
+ * - All methods are async to support HTTP-based implementations (ServerClient)
+ * - Methods return CslItem directly (not Reference) for simplicity and HTTP compatibility
+ * - Library internally uses Reference for ID generation and indexing, but exposes CslItem via ILibrary
+ * - ServerClient naturally returns CslItem from HTTP responses
+ */
+import type { CslItem } from "./csl-json/types.js";
+/**
+ * Options for find operations.
+ */
+export interface FindOptions {
+    /** If true, treat the identifier as UUID; otherwise treat as citation ID (default: false) */
+    byUuid?: boolean;
+}
+/**
+ * Options for remove operations.
+ * Currently identical to FindOptions, but defined separately for clarity and future extensibility.
+ */
+export type RemoveOptions = FindOptions;
+/**
+ * Result of a remove operation.
+ */
+export interface RemoveResult {
+    /** Whether the removal was successful */
+    removed: boolean;
+    /** The removed item (only when removed=true, may be undefined if not available from server) */
+    removedItem?: CslItem;
+}
+export interface UpdateOptions {
+    /** How to handle ID collision: 'fail' (default) or 'suffix' */
+    onIdCollision?: "fail" | "suffix";
+    /** If true, treat the identifier as UUID; otherwise treat as citation ID (default: false) */
+    byUuid?: boolean;
+}
+/**
+ * Result of an update operation.
+ */
+export interface UpdateResult {
+    /** Whether the update was successful */
+    updated: boolean;
+    /** The updated item (only when updated=true) */
+    item?: CslItem;
+    /** True if ID collision occurred (only when updated=false and onIdCollision='fail') */
+    idCollision?: boolean;
+    /** True if the ID was changed due to collision resolution */
+    idChanged?: boolean;
+    /** The new ID after collision resolution (only when idChanged=true) */
+    newId?: string;
+}
+/**
+ * Common interface for library implementations.
+ */
+export interface ILibrary {
+    /**
+     * Find a reference by citation ID or UUID.
+     * @param identifier - The citation ID or UUID of the reference to find
+     * @param options - Find options (byUuid to use UUID lookup)
+     * @returns The CSL item if found, undefined otherwise
+     */
+    find(identifier: string, options?: FindOptions): Promise<CslItem | undefined>;
+    /**
+     * Get all references.
+     * @returns Array of all CSL items in the library
+     */
+    getAll(): Promise<CslItem[]>;
+    /**
+     * Add a new reference to the library.
+     * @param item - The CSL item to add
+     * @returns The added CSL item (with generated ID and UUID if not present)
+     */
+    add(item: CslItem): Promise<CslItem>;
+    /**
+     * Update a reference by citation ID or UUID.
+     * @param identifier - The citation ID or UUID of the reference to update
+     * @param updates - Partial CSL item with fields to update
+     * @param options - Update options (byUuid to use UUID lookup, onIdCollision for collision handling)
+     * @returns Update result indicating success/failure, updated item, and any ID changes
+     */
+    update(identifier: string, updates: Partial<CslItem>, options?: UpdateOptions): Promise<UpdateResult>;
+    /**
+     * Remove a reference by citation ID or UUID.
+     * @param identifier - The citation ID or UUID of the reference to remove
+     * @param options - Remove options (byUuid to use UUID lookup)
+     * @returns Remove result with removed status and optionally the removed item
+     */
+    remove(identifier: string, options?: RemoveOptions): Promise<RemoveResult>;
+    /**
+     * Save the library to persistent storage.
+     * For Library: writes to file
+     * For ServerClient: no-op (HTTP requests are already persisted)
+     */
+    save(): Promise<void>;
+}
+//# sourceMappingURL=library-interface.d.ts.map

package/dist/core/library-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-interface.d.ts","sourceRoot":"","sources":["../../src/core/library-interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClC,6FAA6F;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IAKvB;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAE9E;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAM7B;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAM3E;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/core/library.d.ts

@@ -1,29 +1,12 @@
 import type { CslItem } from "./csl-json/types";
+import type { FindOptions, ILibrary, RemoveOptions, RemoveResult, UpdateOptions, UpdateResult } from "./library-interface.js";
 import { Reference } from "./reference";
+export type { FindOptions, ILibrary, UpdateOptions, UpdateResult } from "./library-interface.js";
 /**
- * Options for update operations
+ * Library manager for CSL-JSON references.
+ * Implements ILibrary interface for use with operations layer.
  */
-export interface UpdateOptions {
-    /** How to handle ID collision: 'fail' (default) or 'suffix' */
-    onIdCollision?: "fail" | "suffix";
-}
-/**
- * Result of an update operation
- */
-export interface UpdateResult {
-    /** Whether the update was successful */
-    updated: boolean;
-    /** True if ID collision occurred (only when updated=false and onIdCollision='fail') */
-    idCollision?: boolean;
-    /** True if the ID was changed due to collision resolution */
-    idChanged?: boolean;
-    /** The new ID after collision resolution (only when idChanged=true) */
-    newId?: string;
-}
-/**
- * Library manager for CSL-JSON references
- */
-export declare class Library {
+export declare class Library implements ILibrary {
     private filePath;
     private references;
     private currentHash;
@@ -41,39 +24,39 @@ export declare class Library {
      */
     save(): Promise<void>;
     /**
-     * Add a reference to the library
+     * Reloads the library from file if it was modified externally.
+     * Self-writes (detected via hash comparison) are skipped.
+     * @returns true if reload occurred, false if skipped (self-write detected)
      */
-    add(item: CslItem): void;
+    reload(): Promise<boolean>;
     /**
-     * Remove a reference by UUID
-     */
-    removeByUuid(uuid: string): boolean;
-    /**
-     * Remove a reference by ID
+     * Add a reference to the library
+     * @param item - The CSL item to add
+     * @returns The added CSL item (with generated ID and UUID)
      */
-    removeById(id: string): boolean;
+    add(item: CslItem): Promise<CslItem>;
     /**
-     * Update a reference by UUID.
-     * @param uuid - The UUID of the reference to update
-     * @param updates - Partial updates to apply to the reference
-     * @returns true if the reference was found and updated, false otherwise
+     * Remove a reference by citation ID or UUID.
+     * @param identifier - The citation ID or UUID of the reference to remove
+     * @param options - Remove options (byUuid to use UUID lookup)
+     * @returns Remove result with removed status and the removed item
      */
-    updateByUuid(uuid: string, updates: Partial<CslItem>, options?: UpdateOptions): UpdateResult;
+    remove(identifier: string, options?: RemoveOptions): Promise<RemoveResult>;
     /**
-     * Update a reference by ID.
-     * @param id - The ID of the reference to update
+     * Update a reference by citation ID or UUID.
+     * @param identifier - The citation ID or UUID of the reference to update
      * @param updates - Partial updates to apply to the reference
-     * @returns true if the reference was found and updated, false otherwise
-     */
-    updateById(id: string, updates: Partial<CslItem>, options?: UpdateOptions): UpdateResult;
-    /**
-     * Find a reference by UUID
+     * @param options - Update options (byUuid to use UUID lookup, onIdCollision for collision handling)
+     * @returns Update result with updated item, success status, and any ID changes
      */
-    findByUuid(uuid: string): Reference | undefined;
+    update(identifier: string, updates: Partial<CslItem>, options?: UpdateOptions): Promise<UpdateResult>;
     /**
-     * Find a reference by ID
+     * Find a reference by citation ID or UUID.
+     * @param identifier - The citation ID or UUID of the reference to find
+     * @param options - Find options (byUuid to use UUID lookup)
+     * @returns The CSL item if found, undefined otherwise
      */
-    findById(id: string): Reference | undefined;
+    find(identifier: string, options?: FindOptions): Promise<CslItem | undefined>;
     /**
      * Find a reference by DOI
      */
@@ -85,7 +68,7 @@ export declare class Library {
     /**
      * Get all references
      */
-    getAll(): Reference[];
+    getAll(): Promise<CslItem[]>;
     /**
      * Get the file path
      */

package/dist/core/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/core/library.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAuB;IAG1C,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAAqC;IAEtD,OAAO;IAWP;;OAEG;WACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAYxB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASnC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY;IAShG;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY;IAS5F;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI/C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI/C;;OAEG;IACH,MAAM,IAAI,SAAS,EAAE;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/core/library.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEjG;;;GAGG;AACH,qBAAa,OAAQ,YAAW,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAuB;IAG1C,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAAqC;IAEtD,OAAO;IAWP;;OAEG;WACU,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IA8BhC;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAe1C;;;;;OAKG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAWpF;;;;;;OAMG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC;IAWxB;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAMvF;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI/C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwCvB;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}

package/dist/features/operations/add.d.ts

@@ -1,4 +1,4 @@
-import type { Library } from "../../core/library.js";
+import type { ILibrary } from "../../core/library-interface.js";
 import type { InputFormat } from "../import/detector.js";
 import type { PubmedConfig } from "../import/fetcher.js";
 /**
@@ -61,5 +61,5 @@ export interface AddReferencesResult {
  * @param options - Add options
  * @returns Result with added, failed, and skipped items
  */
-export declare function addReferences(inputs: string[], library: Library, options: AddReferencesOptions): Promise<AddReferencesResult>;
+export declare function addReferences(inputs: string[], library: ILibrary, options: AddReferencesOptions): Promise<AddReferencesResult>;
 //# sourceMappingURL=add.d.ts.map

package/dist/features/operations/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/features/operations/add.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/features/operations/add.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}

package/dist/features/operations/cite.d.ts

@@ -1,4 +1,4 @@
-import type { Library } from "../../core/library.js";
+import type { ILibrary } from "../../core/library-interface.js";
 /**
  * Options for citeReferences operation
  */
@@ -44,5 +44,5 @@ export interface CiteResult {
  * @param options - Citation options including identifiers and style settings
  * @returns Results array with citation or error for each identifier
  */
-export declare function citeReferences(library: Library, options: CiteOperationOptions): Promise<CiteResult>;
+export declare function citeReferences(library: ILibrary, options: CiteOperationOptions): Promise<CiteResult>;
 //# sourceMappingURL=cite.d.ts.map

package/dist/features/operations/cite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cite.d.ts","sourceRoot":"","sources":["../../../src/features/operations/cite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAQrD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAuED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAerB"}
+{"version":3,"file":"cite.d.ts","sourceRoot":"","sources":["../../../src/features/operations/cite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAQhE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAsED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAerB"}

package/dist/features/operations/fulltext/attach.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Fulltext attach operation
+ */
+import type { ILibrary } from "../../../core/library-interface.js";
+import { type FulltextType } from "../../fulltext/index.js";
+/**
+ * Options for fulltextAttach operation
+ */
+export interface FulltextAttachOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Path to the file to attach */
+    filePath?: string | undefined;
+    /** Explicit file type (pdf or markdown) */
+    type?: FulltextType | undefined;
+    /** Move file instead of copy */
+    move?: boolean | undefined;
+    /** Force overwrite existing file */
+    force?: boolean | undefined;
+    /** Use uuid instead of id for lookup */
+    byUuid?: boolean | undefined;
+    /** Directory for fulltext files */
+    fulltextDirectory: string;
+    /** Content from stdin */
+    stdinContent?: Buffer | undefined;
+}
+/**
+ * Result of fulltextAttach operation
+ */
+export interface FulltextAttachResult {
+    success: boolean;
+    filename?: string | undefined;
+    type?: FulltextType | undefined;
+    overwritten?: boolean | undefined;
+    existingFile?: string | undefined;
+    requiresConfirmation?: boolean | undefined;
+    error?: string | undefined;
+}
+/**
+ * Attach a fulltext file to a reference.
+ *
+ * @param library - The library containing the reference
+ * @param options - Attach options
+ * @returns Result of the attach operation
+ */
+export declare function fulltextAttach(library: ILibrary, options: FulltextAttachOptions): Promise<FulltextAttachResult>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/features/operations/fulltext/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/attach.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG9F;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAuHD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAqE/B"}

package/dist/features/operations/fulltext/detach.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Fulltext detach operation
+ */
+import type { ILibrary } from "../../../core/library-interface.js";
+import { type FulltextType } from "../../fulltext/index.js";
+/**
+ * Options for fulltextDetach operation
+ */
+export interface FulltextDetachOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Specific type to detach (pdf or markdown) */
+    type?: FulltextType | undefined;
+    /** Delete the file from disk */
+    delete?: boolean | undefined;
+    /** Use uuid instead of id for lookup */
+    byUuid?: boolean | undefined;
+    /** Directory for fulltext files */
+    fulltextDirectory: string;
+}
+/**
+ * Result of fulltextDetach operation
+ */
+export interface FulltextDetachResult {
+    success: boolean;
+    detached?: FulltextType[];
+    deleted?: FulltextType[];
+    error?: string;
+}
+/**
+ * Detach fulltext file(s) from a reference.
+ *
+ * @param library - The library containing the reference
+ * @param options - Detach options
+ * @returns Result of the detach operation
+ */
+export declare function fulltextDetach(library: ILibrary, options: FulltextDetachOptions): Promise<FulltextDetachResult>;
+//# sourceMappingURL=detach.d.ts.map

package/dist/features/operations/fulltext/detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/detach.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqDD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA0C/B"}

package/dist/features/operations/fulltext/get.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Fulltext get operation
+ */
+import type { ILibrary } from "../../../core/library-interface.js";
+import { type FulltextType } from "../../fulltext/index.js";
+/**
+ * Options for fulltextGet operation
+ */
+export interface FulltextGetOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Specific type to get (pdf or markdown) */
+    type?: FulltextType | undefined;
+    /** If true, return file content instead of path */
+    stdout?: boolean | undefined;
+    /** Use uuid instead of id for lookup */
+    byUuid?: boolean | undefined;
+    /** Directory for fulltext files */
+    fulltextDirectory: string;
+}
+/**
+ * Result of fulltextGet operation
+ */
+export interface FulltextGetResult {
+    success: boolean;
+    paths?: {
+        pdf?: string;
+        markdown?: string;
+    };
+    content?: Buffer;
+    error?: string;
+}
+/**
+ * Get fulltext file paths or content for a reference.
+ *
+ * @param library - The library containing the reference
+ * @param options - Get options
+ * @returns Result with file paths or content
+ */
+export declare function fulltextGet(library: ILibrary, options: FulltextGetOptions): Promise<FulltextGetResult>;
+//# sourceMappingURL=get.d.ts.map

package/dist/features/operations/fulltext/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/get.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmDD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAwB5B"}

package/dist/features/operations/fulltext/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fulltext operations module
+ *
+ * Provides operations for managing fulltext files attached to references.
+ */
+export { fulltextAttach, type FulltextAttachOptions, type FulltextAttachResult } from "./attach.js";
+export { fulltextGet, type FulltextGetOptions, type FulltextGetResult } from "./get.js";
+export { fulltextDetach, type FulltextDetachOptions, type FulltextDetachResult } from "./detach.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/operations/fulltext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/features/operations/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Operations module exports
+ *
+ * Re-exports ILibraryOperations interface and OperationsLibrary class
+ * for CLI unification pattern.
+ *
+ * See: spec/decisions/ADR-009-ilibrary-operations-pattern.md
+ */
+export type { ILibraryOperations, ImportOptions, ImportResult, } from "./library-operations.js";
+export { OperationsLibrary } from "./operations-library.js";
+export type { SearchOperationOptions, SearchResult } from "./search.js";
+export type { ListOptions, ListResult } from "./list.js";
+export type { CiteOperationOptions, CiteResult, CiteItemResult } from "./cite.js";
+export type { AddReferencesOptions, AddReferencesResult } from "./add.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/features/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,YAAY,GACb,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAClF,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/features/operations/library-operations.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ILibraryOperations interface
+ *
+ * Extends ILibrary with high-level operations for CLI unification.
+ * Both OperationsLibrary (local) and ServerClient (server) implement this interface,
+ * allowing CLI commands to use a single interface without branching.
+ *
+ * See: spec/decisions/ADR-009-ilibrary-operations-pattern.md
+ */
+import type { ILibrary } from "../../core/library-interface.js";
+import type { AddReferencesOptions, AddReferencesResult } from "./add.js";
+import type { CiteOperationOptions, CiteResult } from "./cite.js";
+import type { ListOptions, ListResult } from "./list.js";
+import type { SearchOperationOptions, SearchResult } from "./search.js";
+/**
+ * Options for import operation
+ *
+ * Extends AddReferencesOptions since import is the high-level version of add.
+ */
+export type ImportOptions = AddReferencesOptions;
+/**
+ * Result of import operation
+ */
+export type ImportResult = AddReferencesResult;
+/**
+ * High-level library operations interface
+ *
+ * Extends ILibrary with search, list, cite, and import methods.
+ * This interface is implemented by:
+ * - OperationsLibrary: Wraps Library and uses operation functions
+ * - ServerClient: Makes HTTP requests to server endpoints
+ */
+export interface ILibraryOperations extends ILibrary {
+    /**
+     * Search references by query
+     *
+     * @param options - Search options including query and format
+     * @returns Search results with formatted items
+     */
+    search(options: SearchOperationOptions): Promise<SearchResult>;
+    /**
+     * List all references
+     *
+     * @param options - List options including format
+     * @returns List results with formatted items
+     */
+    list(options?: ListOptions): Promise<ListResult>;
+    /**
+     * Generate citations for references
+     *
+     * @param options - Citation options including identifiers, style, and format
+     * @returns Citation results
+     */
+    cite(options: CiteOperationOptions): Promise<CiteResult>;
+    /**
+     * Import references from various sources
+     *
+     * @param inputs - Array of inputs (PMID, DOI, BibTeX, RIS, file paths)
+     * @param options - Import options
+     * @returns Import results with added, failed, and skipped items
+     */
+    import(inputs: string[], options?: ImportOptions): Promise<ImportResult>;
+}
+//# sourceMappingURL=library-operations.d.ts.map

package/dist/features/operations/library-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-operations.d.ts","sourceRoot":"","sources":["../../../src/features/operations/library-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/D;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1E"}

package/dist/features/operations/list.d.ts

@@ -1,4 +1,4 @@
-import type { Library } from "../../core/library.js";
+import type { ILibrary } from "../../core/library-interface.js";
 /**
  * Output format options for list operation
  */
@@ -24,5 +24,5 @@ export interface ListResult {
  * @param options - Formatting options
  * @returns Formatted strings for each reference
  */
-export declare function listReferences(library: Library, options: ListOptions): ListResult;
+export declare function listReferences(library: ILibrary, options: ListOptions): Promise<ListResult>;
 //# sourceMappingURL=list.d.ts.map

package/dist/features/operations/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/features/operations/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,UAAU,CA6BjF"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/features/operations/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAGhE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BjG"}