@ncukondo/reference-manager 0.14.1 → 0.15.0

package/dist/features/attachments/filename.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Filename utilities for attachments
+ *
+ * File format: {role}[-{label-slug}].{ext}
+ * Examples:
+ *   - fulltext.pdf
+ *   - supplement-table-s1.xlsx
+ *   - notes-reading-analysis.md
+ */
+interface ParsedFilename {
+    role: string;
+    ext: string;
+    label?: string;
+}
+/**
+ * Convert a human-readable label to a filesystem-safe slug
+ */
+export declare function slugifyLabel(label: string): string;
+/**
+ * Generate filename from role, extension, and optional label
+ */
+export declare function generateFilename(role: string, ext: string, label?: string): string;
+/**
+ * Parse filename to extract role, extension, and label
+ *
+ * Returns null for empty filenames
+ */
+export declare function parseFilename(filename: string): ParsedFilename | null;
+export {};
+//# sourceMappingURL=filename.d.ts.map

package/dist/features/attachments/filename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.d.ts","sourceRoot":"","sources":["../../../src/features/attachments/filename.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmCrE"}

package/dist/features/attachments/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Attachment file metadata stored in reference's custom field
+ */
+export interface AttachmentFile {
+    /** Filename without path (e.g., "fulltext.pdf") */
+    filename: string;
+    /** Role identifier (e.g., "fulltext", "supplement", "notes") */
+    role: string;
+    /** Human-readable label (optional) */
+    label?: string;
+}
+/**
+ * Attachments container stored in reference's custom.attachments field
+ */
+export interface Attachments {
+    /** Directory name relative to attachments base (e.g., "Smith-2024-PMID12345678-123e4567") */
+    directory: string;
+    /** List of attached files */
+    files: AttachmentFile[];
+}
+/**
+ * Reserved role identifiers with special constraints
+ */
+export declare const RESERVED_ROLES: readonly ["fulltext", "supplement", "notes", "draft"];
+export type ReservedRole = (typeof RESERVED_ROLES)[number];
+/**
+ * Check if a role is a reserved role
+ */
+export declare function isReservedRole(role: string): role is ReservedRole;
+/**
+ * Get file extension from filename (without leading dot)
+ */
+export declare function getExtension(filename: string): string;
+/**
+ * Check if fulltext files satisfy the constraint: max 2 files (1 PDF + 1 Markdown)
+ */
+export declare function isValidFulltextFiles(files: AttachmentFile[]): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/attachments/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/attachments/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,uDAAwD,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAiBrE"}

package/dist/features/fulltext/manager.d.ts

@@ -45,7 +45,7 @@ export interface AttachResult {
  */
 export interface DetachOptions {
     /** Delete file from disk (default: false, metadata-only detach) */
-    delete?: boolean;
+    removeFiles?: boolean;
 }
 /**
  * Result of detachFile operation

package/dist/features/fulltext/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/features/fulltext/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,YAAY;gBADlB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY;CAKrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,MAAM;IAEtD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAyCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;YACW,qBAAqB;IAkBnC;;OAEG;YACW,cAAc;IAgB5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAQ7D;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAuBxB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE;IAc/C;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO;IAO1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAO5B"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/features/fulltext/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,CAAC,EAAE,KAAK;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aAE/B,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,YAAY;gBADlB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY;CAKrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,MAAM;IAEtD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAyCxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;;OAGG;YACW,qBAAqB;IAkBnC;;OAEG;YACW,cAAc;IAgB5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAQ7D;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,YAAY,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAuBxB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE;IAc/C;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO;IAO1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/features/interactive/tty.d.ts

@@ -1,5 +1,5 @@
 /**
- * TTY detection for interactive mode
+ * TTY detection for TUI mode
  */
 /**
  * Error thrown when TTY is required but not available
@@ -12,7 +12,7 @@ export declare class TTYError extends Error {
  * Check if the current environment is a TTY
  *
  * Throws TTYError if stdin or stdout is not a TTY,
- * which means interactive mode cannot be used.
+ * which means TUI mode cannot be used.
  *
  * @throws {TTYError} If not running in a TTY
  */

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

@@ -0,0 +1,42 @@
+/**
+ * Attachment add operation
+ */
+import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
+/**
+ * Options for addAttachment operation
+ */
+export interface AddAttachmentOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Path to the file to attach */
+    filePath: string;
+    /** Role for the attachment */
+    role: string;
+    /** Human-readable label (optional) */
+    label?: string;
+    /** Move file instead of copy */
+    move?: boolean;
+    /** Force overwrite existing file */
+    force?: boolean;
+    /** Identifier type */
+    idType?: IdentifierType;
+    /** Base directory for attachments */
+    attachmentsDirectory: string;
+}
+/**
+ * Result of addAttachment operation
+ */
+export interface AddAttachmentResult {
+    success: boolean;
+    filename?: string;
+    directory?: string;
+    overwritten?: boolean;
+    existingFile?: string;
+    requiresConfirmation?: boolean;
+    error?: string;
+}
+/**
+ * Add an attachment to a reference
+ */
+export declare function addAttachment(library: ILibrary, options: AddAttachmentOptions): Promise<AddAttachmentResult>;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/add.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWnF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkHD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA+F9B"}

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

@@ -0,0 +1,38 @@
+/**
+ * Attachment detach operation
+ */
+import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
+/**
+ * Options for detachAttachment operation
+ */
+export interface DetachAttachmentOptions {
+    /** Reference identifier */
+    identifier: string;
+    /** Filename to detach */
+    filename?: string;
+    /** Detach by role instead of filename */
+    role?: string;
+    /** Detach all files of the role */
+    all?: boolean;
+    /** Delete file from disk */
+    removeFiles?: boolean;
+    /** Identifier type */
+    idType?: IdentifierType;
+    /** Base directory for attachments */
+    attachmentsDirectory: string;
+}
+/**
+ * Result of detachAttachment operation
+ */
+export interface DetachAttachmentResult {
+    success: boolean;
+    detached: string[];
+    deleted: string[];
+    directoryDeleted?: boolean;
+    error?: string;
+}
+/**
+ * Detach an attachment from a reference
+ */
+export declare function detachAttachment(library: ILibrary, options: DetachAttachmentOptions): Promise<DetachAttachmentResult>;
+//# sourceMappingURL=detach.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/detach.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAInF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwFD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA2DjC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Attachment get operation
+ */
+import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
+/**
+ * Options for getAttachment operation
+ */
+export interface GetAttachmentOptions {
+    /** Reference identifier */
+    identifier: string;
+    /** Filename to get */
+    filename?: string;
+    /** Get by role instead of filename */
+    role?: string;
+    /** Identifier type */
+    idType?: IdentifierType;
+    /** Output content to stdout */
+    stdout?: boolean;
+    /** Base directory for attachments */
+    attachmentsDirectory: string;
+}
+/**
+ * Result of getAttachment operation
+ */
+export interface GetAttachmentResult {
+    success: boolean;
+    path?: string;
+    content?: Buffer;
+    error?: string;
+}
+/**
+ * Get an attachment file path or content
+ */
+export declare function getAttachment(library: ILibrary, options: GetAttachmentOptions): Promise<GetAttachmentResult>;
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/get.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAInF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAqD9B"}

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

@@ -0,0 +1,16 @@
+/**
+ * Attachment operations - unified exports
+ */
+export { addAttachment } from "./add.js";
+export type { AddAttachmentOptions, AddAttachmentResult } from "./add.js";
+export { listAttachments } from "./list.js";
+export type { ListAttachmentsOptions, ListAttachmentsResult } from "./list.js";
+export { getAttachment } from "./get.js";
+export type { GetAttachmentOptions, GetAttachmentResult } from "./get.js";
+export { detachAttachment } from "./detach.js";
+export type { DetachAttachmentOptions, DetachAttachmentResult } from "./detach.js";
+export { syncAttachments } from "./sync.js";
+export type { SyncAttachmentOptions, SyncAttachmentResult, InferredFile } from "./sync.js";
+export { openAttachment } from "./open.js";
+export type { OpenAttachmentOptions, OpenAttachmentResult } from "./open.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Attachment list operation
+ */
+import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
+import type { AttachmentFile } from "../../attachments/types.js";
+/**
+ * Options for listAttachments operation
+ */
+export interface ListAttachmentsOptions {
+    /** Reference identifier */
+    identifier: string;
+    /** Identifier type */
+    idType?: IdentifierType;
+    /** Filter by role */
+    role?: string;
+    /** Base directory for attachments */
+    attachmentsDirectory: string;
+}
+/**
+ * Result of listAttachments operation
+ */
+export interface ListAttachmentsResult {
+    success: boolean;
+    directory?: string;
+    files: AttachmentFile[];
+    error?: string;
+}
+/**
+ * List attachments for a reference
+ */
+export declare function listAttachments(library: ILibrary, options: ListAttachmentsOptions): Promise<ListAttachmentsResult>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,4BAA4B,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAiChC"}

package/dist/features/operations/attachments/open.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Attachment open operation
+ *
+ * Opens attachments directory or specific file with system application.
+ */
+import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
+/**
+ * Options for openAttachment operation
+ */
+export interface OpenAttachmentOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Specific filename to open */
+    filename?: string;
+    /** Role to open (opens first matching file) */
+    role?: string;
+    /** Print path instead of opening */
+    print?: boolean;
+    /** Identifier type */
+    idType?: IdentifierType;
+    /** Base directory for attachments */
+    attachmentsDirectory: string;
+}
+/**
+ * Result of openAttachment operation
+ */
+export interface OpenAttachmentResult {
+    success: boolean;
+    /** Path that was opened or would be opened */
+    path?: string;
+    /** Whether the directory was created */
+    directoryCreated?: boolean;
+    error?: string;
+}
+/**
+ * Open attachment directory or file
+ */
+export declare function openAttachment(library: ILibrary, options: OpenAttachmentOptions): Promise<OpenAttachmentResult>;
+//# sourceMappingURL=open.d.ts.map

package/dist/features/operations/attachments/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/open.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMnF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+HD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoD/B"}

package/dist/features/operations/attachments/sync.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Attachment sync operation
+ *
+ * Synchronizes metadata with files on disk:
+ * - Detects new files not in metadata
+ * - Detects missing files (in metadata but not on disk)
+ * - Infers role/label from filename pattern
+ */
+import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
+/**
+ * Options for syncAttachments operation
+ */
+export interface SyncAttachmentOptions {
+    /** Reference identifier (id or uuid) */
+    identifier: string;
+    /** Apply changes (add new files to metadata) */
+    yes?: boolean;
+    /** Remove missing files from metadata */
+    fix?: boolean;
+    /** Identifier type */
+    idType?: IdentifierType;
+    /** Base directory for attachments */
+    attachmentsDirectory: string;
+}
+/**
+ * Inferred file from disk
+ */
+export interface InferredFile {
+    filename: string;
+    role: string;
+    label?: string;
+}
+/**
+ * Result of syncAttachments operation
+ */
+export interface SyncAttachmentResult {
+    success: boolean;
+    /** Files on disk but not in metadata */
+    newFiles: InferredFile[];
+    /** Files in metadata but not on disk */
+    missingFiles: string[];
+    /** Whether changes were applied */
+    applied: boolean;
+    error?: string;
+}
+/**
+ * Synchronize attachments metadata with files on disk
+ */
+export declare function syncAttachments(library: ILibrary, options: SyncAttachmentOptions): Promise<SyncAttachmentResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/features/operations/attachments/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/attachments/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKnF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yCAAyC;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qCAAqC;IACrC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyID;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAiD/B"}

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

@@ -1,8 +1,14 @@
 /**
  * Fulltext attach operation
+ *
+ * Uses attachments system internally with role='fulltext'.
  */
 import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
-import { type FulltextType } from "../../fulltext/index.js";
+import { type FulltextFormat } from "../fulltext-adapter/index.js";
+/**
+ * Fulltext type (matches existing FulltextType for backward compatibility)
+ */
+export type FulltextType = FulltextFormat;
 /**
  * Options for fulltextAttach operation
  */
@@ -19,7 +25,7 @@ export interface FulltextAttachOptions {
     force?: boolean | undefined;
     /** Identifier type: 'id' (default), 'uuid', 'doi', 'pmid', or 'isbn' */
     idType?: IdentifierType | undefined;
-    /** Directory for fulltext files */
+    /** Directory for attachments (replaces fulltextDirectory) */
     fulltextDirectory: string;
     /** Content from stdin */
     stdinContent?: Buffer | undefined;

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

@@ -1 +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,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACnF,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,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,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"}
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/attach.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C;;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,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,6DAA6D;IAC7D,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;AAiHD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAuD/B"}

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

@@ -1,8 +1,14 @@
 /**
  * Fulltext detach operation
+ *
+ * Uses attachments system internally with role='fulltext'.
  */
 import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
-import { type FulltextType } from "../../fulltext/index.js";
+import { type FulltextFormat } from "../fulltext-adapter/index.js";
+/**
+ * Fulltext type (matches existing FulltextType for backward compatibility)
+ */
+export type FulltextType = FulltextFormat;
 /**
  * Options for fulltextDetach operation
  */
@@ -12,10 +18,10 @@ export interface FulltextDetachOptions {
     /** Specific type to detach (pdf or markdown) */
     type?: FulltextType | undefined;
     /** Delete the file from disk */
-    delete?: boolean | undefined;
+    removeFiles?: boolean | undefined;
     /** Identifier type: 'id' (default), 'uuid', 'doi', 'pmid', or 'isbn' */
     idType?: IdentifierType | undefined;
-    /** Directory for fulltext files */
+    /** Directory for attachments (replaces fulltextDirectory) */
     fulltextDirectory: string;
 }
 /**

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

@@ -1 +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,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACnF,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,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,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"}
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/detach.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGnF,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C;;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,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,6DAA6D;IAC7D,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;AAyED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAoC/B"}

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

@@ -1,8 +1,14 @@
 /**
  * Fulltext get operation
+ *
+ * Uses attachments system internally with role='fulltext'.
  */
 import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
-import { type FulltextType } from "../../fulltext/index.js";
+import { type FulltextFormat } from "../fulltext-adapter/index.js";
+/**
+ * Fulltext type (matches existing FulltextType for backward compatibility)
+ */
+export type FulltextType = FulltextFormat;
 /**
  * Options for fulltextGet operation
  */
@@ -15,7 +21,7 @@ export interface FulltextGetOptions {
     stdout?: boolean | undefined;
     /** Identifier type: 'id' (default), 'uuid', 'doi', 'pmid', or 'isbn' */
     idType?: IdentifierType | undefined;
-    /** Directory for fulltext files */
+    /** Directory for attachments (replaces fulltextDirectory) */
     fulltextDirectory: string;
 }
 /**

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

@@ -1 +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,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACnF,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,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,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"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGnF,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C;;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,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,6DAA6D;IAC7D,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;AAmFD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAkC5B"}

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

@@ -1,8 +1,14 @@
 /**
  * Fulltext open operation
+ *
+ * Uses attachments system internally with role='fulltext'.
  */
 import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
-import type { FulltextType } from "../../fulltext/index.js";
+import { type FulltextFormat } from "../fulltext-adapter/index.js";
+/**
+ * Fulltext type (matches existing FulltextType for backward compatibility)
+ */
+export type FulltextType = FulltextFormat;
 /**
  * Options for fulltextOpen operation
  */
@@ -13,7 +19,7 @@ export interface FulltextOpenOptions {
     type?: FulltextType | undefined;
     /** Identifier type: 'id' (default), 'uuid', 'doi', 'pmid', or 'isbn' */
     idType?: IdentifierType | undefined;
-    /** Directory for fulltext files */
+    /** Directory for attachments (replaces fulltextDirectory) */
     fulltextDirectory: string;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/open.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgCD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA8C7B"}
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext/open.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGnF,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,wEAAwE;IACxE,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAoD7B"}

package/dist/features/operations/fulltext-adapter/fulltext-adapter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Fulltext-to-attachments adapter utilities
+ *
+ * Maps fulltext command options and data to the new attachments system.
+ * This adapter enables the fulltext command to use attachments backend
+ * while maintaining backward-compatible interface.
+ */
+import type { AttachmentFile, Attachments } from "../../attachments/types.js";
+/**
+ * The role used for fulltext files in the attachments system
+ */
+export declare const FULLTEXT_ROLE: "fulltext";
+/**
+ * Fulltext format type (matching existing FulltextType)
+ */
+export type FulltextFormat = "pdf" | "markdown";
+/**
+ * Convert fulltext format to file extension
+ */
+export declare function formatToExtension(format: FulltextFormat): string;
+/**
+ * Convert file extension to fulltext format
+ * Returns undefined if extension is not a valid fulltext format
+ */
+export declare function extensionToFormat(ext: string): FulltextFormat | undefined;
+/**
+ * Get the standard filename for a fulltext file
+ * Following the naming convention: fulltext.{ext}
+ */
+export declare function getFulltextFilename(format: FulltextFormat): string;
+/**
+ * Find a fulltext file of specific format in attachments
+ */
+export declare function findFulltextFile(attachments: Attachments | undefined, format: FulltextFormat): AttachmentFile | undefined;
+/**
+ * Find all fulltext files in attachments
+ */
+export declare function findFulltextFiles(attachments: Attachments | undefined): AttachmentFile[];
+//# sourceMappingURL=fulltext-adapter.d.ts.map

package/dist/features/operations/fulltext-adapter/fulltext-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulltext-adapter.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext-adapter/fulltext-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9E;;GAEG;AACH,eAAO,MAAM,aAAa,EAAG,UAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,UAAU,CAAC;AAEhD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAKzE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,MAAM,EAAE,cAAc,GACrB,cAAc,GAAG,SAAS,CAc5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc,EAAE,CAMxF"}

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

@@ -0,0 +1,7 @@
+/**
+ * Fulltext-to-attachments adapter module
+ *
+ * Provides utilities for mapping fulltext operations to attachments backend.
+ */
+export { FULLTEXT_ROLE, type FulltextFormat, formatToExtension, extensionToFormat, getFulltextFilename, findFulltextFile, findFulltextFiles, } from "./fulltext-adapter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/operations/fulltext-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}

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

@@ -12,6 +12,7 @@ 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";
+export type { AddAttachmentOptions, AddAttachmentResult, ListAttachmentsOptions, ListAttachmentsResult, GetAttachmentOptions, GetAttachmentResult, DetachAttachmentOptions, DetachAttachmentResult, SyncAttachmentOptions, SyncAttachmentResult, OpenAttachmentOptions, OpenAttachmentResult, } from "./attachments/index.js";
 export type { AddJsonOutput, RemoveJsonOutput, UpdateJsonOutput, } from "./json-output.js";
 export { formatAddJsonOutput, formatRemoveJsonOutput, formatUpdateJsonOutput, } from "./json-output.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AAG1E,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}
+{"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;AAG1E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}