@mantra-ai/core 0.1.0

package/dist/works/id/resolveIds/versioning.d.ts

@@ -0,0 +1,27 @@
+export type VersionLabel = "published" | `v${number}`;
+export type VersionStage = "journal" | "preprint" | "unknown";
+export type VersionInference = {
+    label: VersionLabel;
+    stage: VersionStage;
+    confidence: number;
+    evidence: string[];
+};
+type MinimalIds = {
+    doi?: string | null;
+    arxivId?: string | null;
+    biorxivId?: string | null;
+    medrxivId?: string | null;
+    landingUrl?: string | null;
+    journal?: string | null;
+    openalexHostVenue?: string | null;
+};
+type ExternalHints = {
+    crossrefType?: string | null;
+    crossrefSubtype?: string | null;
+    openalexVenueName?: string | null;
+    openalexIsPreprintVenue?: boolean | null;
+    latestKnownPreprintVersion?: number | null;
+};
+export declare function inferVersionLabel(ids: MinimalIds, hints?: ExternalHints): Promise<VersionInference>;
+export {};
+//# sourceMappingURL=versioning.d.ts.map

package/dist/works/id/resolveIds/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../../../src/works/id/resolveIds/versioning.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,IAAI,MAAM,EAAE,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,aAAa,GAAG;IAEnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uBAAuB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C,CAAC;AAsDF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,UAAU,EACf,KAAK,GAAE,aAAkB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAwH3B"}

package/dist/works/id/resolveIds/versioning.js

@@ -0,0 +1,156 @@
+import { fetchLatestMedrxivVersionNumber } from "../../../sources/medrxiv/client";
+const PREPRINT_HOSTS = [
+    "arxiv.org",
+    "www.arxiv.org",
+    "biorxiv.org",
+    "www.biorxiv.org",
+    "medrxiv.org",
+    "www.medrxiv.org",
+    "osf.io",
+    "www.osf.io",
+    "preprints.org",
+    "www.preprints.org",
+];
+const PREPRINT_DOI_PREFIXES = [
+    /^10\.1101\//i, // bioRxiv / medRxiv
+    /^10\.48550\/(arxiv(\.|:)?)/i, // DataCite-minted arXiv DOI
+    /^10\.31219\/osf\.io\//i, // OSF preprints (SocArXiv, etc.)
+    /^10\.31234\/osf\.io\//i, // OSF PsyArXiv
+    /^10\.7287\/peerj\.preprints/i, // PeerJ Preprints (legacy)
+];
+function isPreprintDoi(doi) {
+    if (!doi)
+        return false;
+    return PREPRINT_DOI_PREFIXES.some((rx) => rx.test(doi));
+}
+function hostFromUrl(u) {
+    try {
+        if (!u)
+            return null;
+        return new URL(u).host.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+function parseExplicitPreprintV(ids) {
+    const rxV = /v(\d+)$/i;
+    for (const maybe of [ids.biorxivId, ids.medrxivId]) {
+        if (maybe) {
+            const m = maybe.match(rxV);
+            if (m)
+                return Number(m[1]);
+        }
+    }
+    return null;
+}
+function looksLikePreprintVenue(name) {
+    if (!name)
+        return false;
+    const n = name.toLowerCase();
+    return /(arxiv|biorxiv|medrxiv|preprint|osf)/i.test(n);
+}
+export async function inferVersionLabel(ids, hints = {}) {
+    // Augment hints with latest medRxiv version iff:
+    //  - a medrxivId is present, and
+    //  - no explicit vN is embedded in ids.{biorxivId|medrxivId}
+    const augmented = { ...hints };
+    const explicitV0 = parseExplicitPreprintV(ids);
+    if (ids.medrxivId && !explicitV0) {
+        try {
+            const idOrDoi = ids.doi && /^10\.1101\//i.test(ids.doi) ? ids.doi : ids.medrxivId;
+            const latest = await fetchLatestMedrxivVersionNumber(idOrDoi);
+            if (latest && latest > 0) {
+                augmented.latestKnownPreprintVersion = latest;
+            }
+        }
+        catch {
+            // ignore network errors; fall back to pure logic below
+        }
+    }
+    const evidence = [];
+    let preprintV = null;
+    let preprintSignal = false;
+    let publishedSignal = false;
+    // --- 1) Explicit preprint versions
+    preprintV = parseExplicitPreprintV(ids);
+    if (preprintV) {
+        preprintSignal = true;
+        evidence.push(`explicit preprint version v${preprintV} found in repository ID/DOI`);
+    }
+    // --- 2) DOI classification
+    if (ids.doi) {
+        if (isPreprintDoi(ids.doi)) {
+            preprintSignal = true;
+            evidence.push(`DOI classified as preprint: ${ids.doi}`);
+            if (!preprintV) {
+                const m = ids.doi.match(/v(\d+)$/i);
+                if (m) {
+                    preprintV = Number(m[1]);
+                    evidence.push(`extracted v${preprintV} from preprint DOI`);
+                }
+            }
+        }
+        else {
+            publishedSignal = true;
+            evidence.push(`non-preprint DOI present (journal candidate): ${ids.doi}`);
+        }
+    }
+    // --- 3) Landing URL host heuristics
+    const host = hostFromUrl(ids.landingUrl);
+    if (host && PREPRINT_HOSTS.includes(host)) {
+        preprintSignal = true;
+        evidence.push(`landing URL host is a known preprint host: ${host}`);
+    }
+    // --- 4) Venue/name/type hints
+    if (augmented.crossrefType === "posted-content" &&
+        augmented.crossrefSubtype === "preprint") {
+        preprintSignal = true;
+        evidence.push(`Crossref type=subtype indicates preprint (posted-content/preprint)`);
+    }
+    if (augmented.openalexIsPreprintVenue) {
+        preprintSignal = true;
+        evidence.push(`OpenAlex marks venue as preprint`);
+    }
+    else if (looksLikePreprintVenue(augmented.openalexVenueName ?? ids.openalexHostVenue)) {
+        preprintSignal = true;
+        evidence.push(`Venue name looks like preprint: ${augmented.openalexVenueName ?? ids.openalexHostVenue}`);
+    }
+    // --- 4b) use repository-provided latest version if no explicit v found
+    if (preprintSignal &&
+        !preprintV &&
+        augmented.latestKnownPreprintVersion &&
+        augmented.latestKnownPreprintVersion > 0) {
+        preprintV = augmented.latestKnownPreprintVersion;
+        evidence.push(`using repository latest version v${preprintV} from medRxiv API`);
+    }
+    // --- 5) Final precedence
+    let label;
+    let stage;
+    if (publishedSignal) {
+        label = "published";
+        stage = "journal";
+        evidence.push("published signal takes precedence over preprint");
+    }
+    else if (preprintSignal) {
+        const v = preprintV ?? 1;
+        label = `v${v}`;
+        stage = "preprint";
+    }
+    else {
+        label = "v1";
+        stage = "unknown";
+        evidence.push("no strong signals; defaulting to v1");
+    }
+    // --- 6) Confidence
+    let confidence = 0;
+    if (publishedSignal)
+        confidence += 0.4;
+    if (preprintSignal)
+        confidence += 0.4;
+    if (preprintV)
+        confidence += 0.2;
+    confidence = Math.min(1, Math.max(0.4, confidence));
+    return { label, stage, confidence, evidence };
+}
+//# sourceMappingURL=versioning.js.map

package/dist/works/id/resolveIds/versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../../../../src/works/id/resolveIds/versioning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AA+BlF,MAAM,cAAc,GAAG;IACrB,WAAW;IACX,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,aAAa;IACb,iBAAiB;IACjB,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,mBAAmB;CACpB,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,cAAc,EAAE,oBAAoB;IACpC,6BAA6B,EAAE,4BAA4B;IAC3D,wBAAwB,EAAE,iCAAiC;IAC3D,wBAAwB,EAAE,eAAe;IACzC,8BAA8B,EAAE,2BAA2B;CAC5D,CAAC;AAEF,SAAS,aAAa,CAAC,GAAmB;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,CAAiB;IACpC,IAAI,CAAC;QACH,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAe;IAC7C,MAAM,GAAG,GAAG,UAAU,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC;gBAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAoB;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,uCAAuC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAe,EACf,QAAuB,EAAE;IAEzB,iDAAiD;IACjD,iCAAiC;IACjC,6DAA6D;IAC7D,MAAM,SAAS,GAAkB,EAAE,GAAG,KAAK,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GACX,GAAG,CAAC,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,+BAA+B,CAAC,OAAO,CAAC,CAAC;YAC9D,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,SAAS,CAAC,0BAA0B,GAAG,MAAM,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,eAAe,GAAG,KAAK,CAAC;IAE5B,oCAAoC;IACpC,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,cAAc,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,8BAA8B,SAAS,6BAA6B,CACrE,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,cAAc,GAAG,IAAI,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,+BAA+B,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACpC,IAAI,CAAC,EAAE,CAAC;oBACN,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACzB,QAAQ,CAAC,IAAI,CAAC,cAAc,SAAS,oBAAoB,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,eAAe,GAAG,IAAI,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,iDAAiD,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,IAAI,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,cAAc,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,8CAA8C,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,+BAA+B;IAC/B,IACE,SAAS,CAAC,YAAY,KAAK,gBAAgB;QAC3C,SAAS,CAAC,eAAe,KAAK,UAAU,EACxC,CAAC;QACD,cAAc,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,oEAAoE,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,uBAAuB,EAAE,CAAC;QACtC,cAAc,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACpD,CAAC;SAAM,IACL,sBAAsB,CAAC,SAAS,CAAC,iBAAiB,IAAI,GAAG,CAAC,iBAAiB,CAAC,EAC5E,CAAC;QACD,cAAc,GAAG,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CACX,mCACE,SAAS,CAAC,iBAAiB,IAAI,GAAG,CAAC,iBACrC,EAAE,CACH,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,IACE,cAAc;QACd,CAAC,SAAS;QACV,SAAS,CAAC,0BAA0B;QACpC,SAAS,CAAC,0BAA0B,GAAG,CAAC,EACxC,CAAC;QACD,SAAS,GAAG,SAAS,CAAC,0BAA0B,CAAC;QACjD,QAAQ,CAAC,IAAI,CACX,oCAAoC,SAAS,mBAAmB,CACjE,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,IAAI,KAAmB,CAAC;IACxB,IAAI,KAAmB,CAAC;IACxB,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,GAAG,WAAW,CAAC;QACpB,KAAK,GAAG,SAAS,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IACnE,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC;QACzB,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;QAChB,KAAK,GAAG,UAAU,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,IAAI,CAAC;QACb,KAAK,GAAG,SAAS,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,oBAAoB;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,eAAe;QAAE,UAAU,IAAI,GAAG,CAAC;IACvC,IAAI,cAAc;QAAE,UAAU,IAAI,GAAG,CAAC;IACtC,IAAI,SAAS;QAAE,UAAU,IAAI,GAAG,CAAC;IACjC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAEpD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAChD,CAAC"}

package/dist/works/id/resolveIds/workWhere.d.ts

@@ -0,0 +1,3 @@
+import type { CompleteIds } from "../../types";
+export declare function buildWorkWhereOrConditions(ids: CompleteIds): Record<string, string>[];
+//# sourceMappingURL=workWhere.d.ts.map

package/dist/works/id/resolveIds/workWhere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workWhere.d.ts","sourceRoot":"","sources":["../../../../src/works/id/resolveIds/workWhere.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,4BAoB1D"}

package/dist/works/id/resolveIds/workWhere.js

@@ -0,0 +1,35 @@
+const stripVersionSuffix = (value) => {
+    if (typeof value !== "string")
+        return null;
+    const t = value.trim();
+    return t ? t.replace(/v\d+$/i, "") : null;
+};
+export function buildWorkWhereOrConditions(ids) {
+    const orConds = [];
+    if (ids.doi)
+        orConds.push({ doi: ids.doi });
+    if (ids.pmid)
+        orConds.push({ pmid: ids.pmid });
+    if (ids.pmcid)
+        orConds.push({ pmcid: ids.pmcid });
+    if (ids.arxivId)
+        orConds.push({ arxivId: ids.arxivId });
+    if (ids.biorxivId) {
+        const base = stripVersionSuffix(ids.biorxivId);
+        if (base)
+            orConds.push({ biorxivId: base });
+        if (base && base !== ids.biorxivId)
+            orConds.push({ biorxivId: ids.biorxivId });
+    }
+    if (ids.medrxivId) {
+        const base = stripVersionSuffix(ids.medrxivId);
+        if (base)
+            orConds.push({ medrxivId: base });
+        if (base && base !== ids.medrxivId)
+            orConds.push({ medrxivId: ids.medrxivId });
+    }
+    if (ids.openalexId)
+        orConds.push({ openalexId: ids.openalexId });
+    return orConds;
+}
+//# sourceMappingURL=workWhere.js.map

package/dist/works/id/resolveIds/workWhere.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workWhere.js","sourceRoot":"","sources":["../../../../src/works/id/resolveIds/workWhere.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,CAAC,KAAqB,EAAiB,EAAE;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,GAAgB;IACzD,MAAM,OAAO,GAAkC,EAAE,CAAC;IAClD,IAAI,GAAG,CAAC,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,SAAS;YAChC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,SAAS;YAChC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/works/id/types.d.ts

@@ -0,0 +1,6 @@
+export type IdentifierType = "doi" | "pmid" | "pmcid" | "arxiv" | "biorxiv" | "medrxiv";
+export type ResolvedIdentifier = {
+    type: IdentifierType;
+    value: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/works/id/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/works/id/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/works/id/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/works/id/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/works/id/types.ts"],"names":[],"mappings":""}

package/dist/works/pdf-fallback/candidates.d.ts

@@ -0,0 +1,12 @@
+import type { CompleteIds } from "../types";
+export interface PdfCandidate {
+    url: string;
+    sourceKind: "preprint" | "oa-publisher" | "resolved-metadata";
+    sourceName: string;
+}
+/**
+ * Build an ordered list of candidate PDF URLs from resolved identifiers.
+ * Order: preprint servers (known URL patterns) → bestPdfUrl from OpenAlex → DOI-derived.
+ */
+export declare function buildPdfCandidates(ids: CompleteIds): PdfCandidate[];
+//# sourceMappingURL=candidates.d.ts.map

package/dist/works/pdf-fallback/candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/works/pdf-fallback/candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,mBAAmB,CAAC;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,EAAE,CAkDnE"}

package/dist/works/pdf-fallback/candidates.js

@@ -0,0 +1,51 @@
+/**
+ * Build an ordered list of candidate PDF URLs from resolved identifiers.
+ * Order: preprint servers (known URL patterns) → bestPdfUrl from OpenAlex → DOI-derived.
+ */
+export function buildPdfCandidates(ids) {
+    const candidates = [];
+    // biorxiv: /content/{doi}v{N}.full.pdf
+    if (ids.biorxivId) {
+        const bare = ids.biorxivId.replace(/v\d+$/i, "");
+        const doi = bare.startsWith("10.1101/") ? bare : `10.1101/${bare}`;
+        const version = ids.version ?? "1";
+        candidates.push({
+            url: `https://www.biorxiv.org/content/${doi}v${version}.full.pdf`,
+            sourceKind: "preprint",
+            sourceName: "biorxiv",
+        });
+    }
+    // medrxiv: same pattern as biorxiv
+    if (ids.medrxivId) {
+        const bare = ids.medrxivId.replace(/v\d+$/i, "");
+        const doi = bare.startsWith("10.1101/") ? bare : `10.1101/${bare}`;
+        const version = ids.version ?? "1";
+        candidates.push({
+            url: `https://www.medrxiv.org/content/${doi}v${version}.full.pdf`,
+            sourceKind: "preprint",
+            sourceName: "medrxiv",
+        });
+    }
+    // arxiv: /pdf/{id}
+    if (ids.arxivId) {
+        const bare = ids.arxivId.replace(/^arxiv:/i, "");
+        candidates.push({
+            url: `https://arxiv.org/pdf/${bare}`,
+            sourceKind: "preprint",
+            sourceName: "arxiv",
+        });
+    }
+    // bestPdfUrl from OpenAlex / resolveIds
+    if (ids.bestPdfUrl) {
+        const alreadyAdded = candidates.some((c) => c.url === ids.bestPdfUrl);
+        if (!alreadyAdded) {
+            candidates.push({
+                url: ids.bestPdfUrl,
+                sourceKind: "oa-publisher",
+                sourceName: "openalex-best-pdf",
+            });
+        }
+    }
+    return candidates;
+}
+//# sourceMappingURL=candidates.js.map

package/dist/works/pdf-fallback/candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.js","sourceRoot":"","sources":["../../../src/works/pdf-fallback/candidates.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAgB;IACjD,MAAM,UAAU,GAAmB,EAAE,CAAC;IAEtC,uCAAuC;IACvC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QACnC,UAAU,CAAC,IAAI,CAAC;YACd,GAAG,EAAE,mCAAmC,GAAG,IAAI,OAAO,WAAW;YACjE,UAAU,EAAE,UAAU;YACtB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QACnC,UAAU,CAAC,IAAI,CAAC;YACd,GAAG,EAAE,mCAAmC,GAAG,IAAI,OAAO,WAAW;YACjE,UAAU,EAAE,UAAU;YACtB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACjD,UAAU,CAAC,IAAI,CAAC;YACd,GAAG,EAAE,yBAAyB,IAAI,EAAE;YACpC,UAAU,EAAE,UAAU;YACtB,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,UAAU,CAAC,CAAC;QACtE,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC;gBACd,GAAG,EAAE,GAAG,CAAC,UAAU;gBACnB,UAAU,EAAE,cAAc;gBAC1B,UAAU,EAAE,mBAAmB;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/works/pdf-fallback/fetch.d.ts

@@ -0,0 +1,21 @@
+import type { PdfCandidate } from "./candidates";
+import type { LoggerLike } from "../types";
+export interface PdfFetchSuccess {
+    ok: true;
+    buffer: Buffer;
+    candidate: PdfCandidate;
+    finalUrl: string;
+    contentType: string;
+}
+export interface PdfFetchFailure {
+    ok: false;
+    candidate: PdfCandidate;
+    reason: string;
+}
+export type PdfFetchResult = PdfFetchSuccess | PdfFetchFailure;
+/**
+ * Attempt to fetch a PDF from a candidate URL.
+ * Validates: HTTP status, content-type, magic bytes, size.
+ */
+export declare function fetchPdfCandidate(candidate: PdfCandidate, logger?: LoggerLike): Promise<PdfFetchResult>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/works/pdf-fallback/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/works/pdf-fallback/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,eAAe,CAAC;AAE/D;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,YAAY,EACvB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,cAAc,CAAC,CAgGzB"}

package/dist/works/pdf-fallback/fetch.js

@@ -0,0 +1,89 @@
+const PDF_MAGIC = Buffer.from("%PDF");
+const MAX_PDF_SIZE = 50 * 1024 * 1024; // 50 MB
+const FETCH_TIMEOUT_MS = 30_000;
+/**
+ * Attempt to fetch a PDF from a candidate URL.
+ * Validates: HTTP status, content-type, magic bytes, size.
+ */
+export async function fetchPdfCandidate(candidate, logger) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const response = await fetch(candidate.url, {
+            method: "GET",
+            signal: controller.signal,
+            redirect: "follow",
+            headers: {
+                Accept: "application/pdf",
+                "User-Agent": "DryLab-RevEng-API/1.0 (PDF-fallback)",
+            },
+        });
+        clearTimeout(timeout);
+        if (!response.ok) {
+            return {
+                ok: false,
+                candidate,
+                reason: `HTTP ${response.status} ${response.statusText}`,
+            };
+        }
+        const contentType = response.headers.get("content-type") ?? "";
+        const isPdfContentType = contentType.includes("application/pdf") ||
+            contentType.includes("application/x-pdf");
+        const arrayBuffer = await response.arrayBuffer();
+        const buffer = Buffer.from(arrayBuffer);
+        if (buffer.length > MAX_PDF_SIZE) {
+            return {
+                ok: false,
+                candidate,
+                reason: `PDF too large: ${buffer.length} bytes (max ${MAX_PDF_SIZE})`,
+            };
+        }
+        if (buffer.length < 4) {
+            return {
+                ok: false,
+                candidate,
+                reason: `Response too small: ${buffer.length} bytes`,
+            };
+        }
+        // Validate magic bytes
+        const hasMagic = buffer.subarray(0, 4).equals(PDF_MAGIC);
+        if (!hasMagic) {
+            if (!isPdfContentType) {
+                return {
+                    ok: false,
+                    candidate,
+                    reason: `Not a PDF: content-type=${contentType}, no PDF magic bytes`,
+                };
+            }
+            // Has PDF content-type but no magic bytes — might be HTML login page
+            const preview = buffer.subarray(0, 200).toString("utf8");
+            if (preview.includes("<html") || preview.includes("<!DOCTYPE")) {
+                return {
+                    ok: false,
+                    candidate,
+                    reason: "Response is HTML, not PDF (likely login/paywall page)",
+                };
+            }
+        }
+        const finalUrl = response.url || candidate.url;
+        logger?.info?.({
+            source: candidate.sourceName,
+            url: finalUrl,
+            size: buffer.length,
+        }, "pdf.fallback.fetch.success");
+        return {
+            ok: true,
+            buffer,
+            candidate,
+            finalUrl,
+            contentType,
+        };
+    }
+    catch (err) {
+        const reason = err?.name === "AbortError"
+            ? `Timeout after ${FETCH_TIMEOUT_MS}ms`
+            : err?.message || String(err);
+        return { ok: false, candidate, reason };
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/works/pdf-fallback/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../../src/works/pdf-fallback/fetch.ts"],"names":[],"mappings":"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"}

package/dist/works/pdf-fallback/index.d.ts

@@ -0,0 +1,28 @@
+import type { CompleteIds, LoggerLike } from "../types";
+import { type PdfCandidate } from "./candidates";
+export type { PdfCandidate } from "./candidates";
+export type { PdfFetchSuccess, PdfFetchFailure, PdfFetchResult } from "./fetch";
+export interface PdfFallbackAttempt {
+    candidate: PdfCandidate;
+    success: boolean;
+    reason?: string;
+}
+export interface PdfFallbackSuccess {
+    ok: true;
+    buffer: Buffer;
+    candidate: PdfCandidate;
+    finalUrl: string;
+    attempts: PdfFallbackAttempt[];
+}
+export interface PdfFallbackExhausted {
+    ok: false;
+    attempts: PdfFallbackAttempt[];
+}
+export type PdfFallbackResult = PdfFallbackSuccess | PdfFallbackExhausted;
+/**
+ * Try to fetch a PDF for the given identifiers by working through
+ * an ordered list of candidate URLs. Returns the first successful
+ * fetch or a structured failure with all attempts.
+ */
+export declare function resolvePdfFallback(ids: CompleteIds, logger?: LoggerLike): Promise<PdfFallbackResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/works/pdf-fallback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/works/pdf-fallback/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGrE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAE1E;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B"}

package/dist/works/pdf-fallback/index.js

@@ -0,0 +1,35 @@
+import { buildPdfCandidates } from "./candidates";
+import { fetchPdfCandidate } from "./fetch";
+/**
+ * Try to fetch a PDF for the given identifiers by working through
+ * an ordered list of candidate URLs. Returns the first successful
+ * fetch or a structured failure with all attempts.
+ */
+export async function resolvePdfFallback(ids, logger) {
+    const candidates = buildPdfCandidates(ids);
+    const attempts = [];
+    if (candidates.length === 0) {
+        return { ok: false, attempts };
+    }
+    for (const candidate of candidates) {
+        const result = await fetchPdfCandidate(candidate, logger);
+        if (result.ok) {
+            attempts.push({ candidate, success: true });
+            return {
+                ok: true,
+                buffer: result.buffer,
+                candidate: result.candidate,
+                finalUrl: result.finalUrl,
+                attempts,
+            };
+        }
+        attempts.push({ candidate, success: false, reason: result.reason });
+        logger?.warn?.({
+            source: candidate.sourceName,
+            url: candidate.url,
+            reason: result.reason,
+        }, "pdf.fallback.candidate.failed");
+    }
+    return { ok: false, attempts };
+}
+//# sourceMappingURL=index.js.map

package/dist/works/pdf-fallback/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/works/pdf-fallback/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAuB,MAAM,SAAS,CAAC;AA0BjE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAgB,EAChB,MAAmB;IAEnB,MAAM,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,MAAM,EAAE,IAAI,EAAE,CACZ;YACE,MAAM,EAAE,SAAS,CAAC,UAAU;YAC5B,GAAG,EAAE,SAAS,CAAC,GAAG;YAClB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,EACD,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC"}

package/dist/works/plan.d.ts

@@ -0,0 +1,8 @@
+import type { Step } from "./types";
+import type { Coordinator } from "./types";
+export type PlanOptions = {
+    /** When true, use PDF normalization instead of JATS fetch+normalize. */
+    hasPdf?: boolean;
+};
+export declare function planSteps(decision: Coordinator, chosenVersionLabel: string, cid?: string, opts?: PlanOptions): Step[];
+//# sourceMappingURL=plan.d.ts.map

package/dist/works/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/works/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAgB,SAAS,CACvB,QAAQ,EAAE,WAAW,EACrB,kBAAkB,EAAE,MAAM,EAC1B,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,WAAW,GACjB,IAAI,EAAE,CAmER"}

package/dist/works/plan.js

@@ -0,0 +1,62 @@
+export function planSteps(decision, chosenVersionLabel, cid, opts) {
+    // Conflict decisions must be handled before planning — return no steps
+    if (decision.conflict) {
+        return [];
+    }
+    if (decision.workExists &&
+        decision.versionExists &&
+        decision.matched.work_id &&
+        !opts?.hasPdf) {
+        return [
+            {
+                kind: "ReturnExisting",
+                work_id: decision.matched.work_id,
+                versionId: decision.matched.versionId ?? null,
+            },
+        ];
+    }
+    const steps = [];
+    if (opts?.hasPdf) {
+        // PDF upload path: skip FetchFullText, use NormalizePdf instead
+        if (!decision.actions.ensureWork && decision.workExists && decision.matched.work_id) {
+            steps.push({ kind: "LoadMatchedWork", work_id: decision.matched.work_id });
+        }
+        steps.push({ kind: "NormalizePdf", versionLabel: chosenVersionLabel });
+        if (decision.actions.ensureWork) {
+            steps.push({ kind: "EnsureWork" });
+        }
+        // PersistRawBundle will gracefully skip when rawXml is null (PDF has no XML)
+        steps.push({ kind: "PersistRawBundle", versionLabel: chosenVersionLabel });
+        steps.push({ kind: "EnsureVersion", versionLabel: chosenVersionLabel });
+        steps.push({ kind: "FinalizeFullText", versionLabel: chosenVersionLabel });
+    }
+    else if (decision.actions.fetchFullText) {
+        // Standard JATS path
+        if (!decision.actions.ensureWork && decision.workExists && decision.matched.work_id) {
+            steps.push({ kind: "LoadMatchedWork", work_id: decision.matched.work_id });
+        }
+        steps.push({ kind: "FetchFullText" });
+        steps.push({ kind: "NormalizeFullText", versionLabel: chosenVersionLabel });
+        if (decision.actions.ensureWork) {
+            steps.push({ kind: "EnsureWork" });
+        }
+        steps.push({ kind: "PersistRawBundle", versionLabel: chosenVersionLabel });
+        steps.push({ kind: "EnsureVersion", versionLabel: chosenVersionLabel });
+        steps.push({ kind: "FinalizeFullText", versionLabel: chosenVersionLabel });
+    }
+    else if (decision.actions.ensureWork) {
+        steps.push({ kind: "EnsureWork" });
+    }
+    else if (decision.workExists && decision.matched.work_id) {
+        // Existing work matched but no fetch/ensureWork needed (metadata-only re-ingest)
+        return [
+            {
+                kind: "ReturnExisting",
+                work_id: decision.matched.work_id,
+                versionId: decision.matched.versionId ?? null,
+            },
+        ];
+    }
+    return steps;
+}
+//# sourceMappingURL=plan.js.map

package/dist/works/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/works/plan.ts"],"names":[],"mappings":"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"}

package/dist/works/strategies/arxiv.d.ts

@@ -0,0 +1,3 @@
+import type { FullTextStrategy } from "../types";
+export declare const arxivStrategy: FullTextStrategy;
+//# sourceMappingURL=arxiv.d.ts.map

package/dist/works/strategies/arxiv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arxiv.d.ts","sourceRoot":"","sources":["../../../src/works/strategies/arxiv.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA+BjD,eAAO,MAAM,aAAa,EAAE,gBAqD3B,CAAC"}