@ncukondo/search-hub 0.23.1 → 0.24.0

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

@@ -7,6 +7,10 @@ export interface FulltextCheckOptions {
 export interface FulltextCheckArticleResult {
     doi?: string;
     pmid?: string;
+    /** PMCID discovered during OA check and verified against the article */
+    pmcid?: string;
+    /** PMCID discovered during OA check but rejected because its metadata did not match */
+    rejectedPmcid?: string;
     title: string;
     oaStatus: OAStatus;
     locationCount: number;

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

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fulltext/check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAkC,KAAK,eAAe,EAAyB,KAAK,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAMzI,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAoHD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAiC9B"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fulltext/check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAkC,KAAK,eAAe,EAAyB,KAAK,QAAQ,EAAmB,MAAM,6BAA6B,CAAC;AAO1J,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAiLD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAiC9B"}

package/dist/cli/commands/fulltext/check.js

@@ -5,6 +5,7 @@ import { discoverOA } from "../../../node_modules/@ncukondo/academic-fulltext/di
 import { loadMeta, saveMeta } from "../../../node_modules/@ncukondo/academic-fulltext/dist/meta.js";
 import "../../../node_modules/@ncukondo/academic-fulltext/dist/convert/jats-parser.js";
 import "node:crypto";
+import { verifyPmcid } from "./verify-pmcid.js";
 const DEFAULT_CONCURRENCY = 3;
 async function loadIncludedArticles(sessionDir) {
   const reviewsPath = join(sessionDir, ".internal", "reviews.yaml");
@@ -37,26 +38,62 @@ async function findArticleDir(sessionDir, article) {
   }
   return null;
 }
+async function validateDiscoveredPmcid(article, config, discoveredPmcid, oaStatus, locations) {
+  const hasPmcLocations = locations.some((loc) => loc.source === "pmc");
+  if (!discoveredPmcid || !hasPmcLocations) {
+    return { oaStatus, locations };
+  }
+  const verifyArticle = {
+    title: article.title
+  };
+  if (article.doi) verifyArticle.doi = article.doi;
+  if (article.pmid) verifyArticle.pmid = article.pmid;
+  const verifyOptions = {};
+  if (config.ncbiEmail) verifyOptions.ncbiEmail = config.ncbiEmail;
+  if (config.ncbiTool) verifyOptions.ncbiTool = config.ncbiTool;
+  const verification = await verifyPmcid(discoveredPmcid, verifyArticle, verifyOptions);
+  if (verification === "match") {
+    return { oaStatus, locations, verifiedPmcid: discoveredPmcid };
+  }
+  if (verification === "mismatch") {
+    const filtered = locations.filter((loc) => loc.source !== "pmc");
+    const status = filtered.length === 0 && oaStatus === "open" ? "unknown" : oaStatus;
+    return { oaStatus: status, locations: filtered, rejectedPmcid: discoveredPmcid };
+  }
+  return { oaStatus, locations };
+}
 async function processArticle(article, sessionDir, config) {
   const discoveryArticle = {};
   if (article.doi) discoveryArticle.doi = article.doi;
   if (article.pmid) discoveryArticle.pmid = article.pmid;
   if (article.arxivId) discoveryArticle.arxivId = article.arxivId;
   const discoveryResult = await discoverOA(discoveryArticle, config);
+  const validated = await validateDiscoveredPmcid(
+    article,
+    config,
+    discoveryResult.discoveredIds.pmcid,
+    discoveryResult.oaStatus,
+    discoveryResult.locations
+  );
   const articleResult = {
     title: article.title,
-    oaStatus: discoveryResult.oaStatus,
-    locationCount: discoveryResult.locations.length
+    oaStatus: validated.oaStatus,
+    locationCount: validated.locations.length
   };
   if (article.doi) articleResult.doi = article.doi;
   if (article.pmid) articleResult.pmid = article.pmid;
+  if (validated.verifiedPmcid) articleResult.pmcid = validated.verifiedPmcid;
+  if (validated.rejectedPmcid) articleResult.rejectedPmcid = validated.rejectedPmcid;
   const dirName = await findArticleDir(sessionDir, article);
   if (dirName) {
     try {
       const metaPath = join(sessionDir, "fulltext", dirName, "meta.json");
       const meta = await loadMeta(metaPath);
-      meta.oaStatus = discoveryResult.oaStatus;
-      meta.oaLocations = discoveryResult.locations;
+      meta.oaStatus = validated.oaStatus;
+      meta.oaLocations = validated.locations;
+      if (validated.verifiedPmcid && !meta.pmcid) {
+        meta.pmcid = validated.verifiedPmcid;
+      }
       meta.checkedAt = (/* @__PURE__ */ new Date()).toISOString();
       await saveMeta(metaPath, meta);
     } catch {

package/dist/cli/commands/fulltext/check.js.map

@@ -1 +1 @@
-{"version":3,"file":"check.js","sources":["../../../../src/cli/commands/fulltext/check.ts"],"sourcesContent":["/**\n * Fulltext check command.\n * Checks OA availability for included articles in a session.\n */\n\nimport { readFile, readdir, access } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport { discoverOA, loadMeta, saveMeta, type DiscoveryConfig, type DiscoveryArticle, type OAStatus } from '@ncukondo/academic-fulltext';\nimport type { ReviewFile, ArticleEntry } from '../review/types';\n\n/** Default concurrency for parallel article processing */\nconst DEFAULT_CONCURRENCY = 3;\n\nexport interface FulltextCheckOptions {\n  sessionDir: string;\n  config: DiscoveryConfig;\n  concurrency?: number;\n}\n\nexport interface FulltextCheckArticleResult {\n  doi?: string;\n  pmid?: string;\n  title: string;\n  oaStatus: OAStatus;\n  locationCount: number;\n}\n\nexport interface FulltextCheckResult {\n  summary: {\n    total: number;\n    open: number;\n    closed: number;\n    unknown: number;\n  };\n  articles: FulltextCheckArticleResult[];\n}\n\n/**\n * Load included articles from reviews.yaml\n */\nasync function loadIncludedArticles(sessionDir: string): Promise<ArticleEntry[]> {\n  const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  const reviewFile = parseYaml(content) as ReviewFile;\n  return reviewFile.articles.filter((a) => a.finalDecision === 'include');\n}\n\n/**\n * Try to find a meta.json matching an article in the fulltext directory.\n * Returns the dirName if found, null otherwise.\n */\nasync function findArticleDir(\n  sessionDir: string,\n  article: ArticleEntry\n): Promise<string | null> {\n  const fulltextDir = join(sessionDir, 'fulltext');\n  try {\n    await access(fulltextDir);\n  } catch {\n    return null;\n  }\n\n  let entries: string[];\n  try {\n    const dirEntries = await readdir(fulltextDir);\n    entries = dirEntries.map(String);\n  } catch {\n    return null;\n  }\n\n  for (const entry of entries) {\n    try {\n      const metaPath = join(fulltextDir, entry, 'meta.json');\n      const meta = await loadMeta(metaPath);\n      // Match by DOI or PMID\n      if (article.doi && meta.doi === article.doi) return entry;\n      if (article.pmid && meta.pmid === article.pmid) return entry;\n    } catch {\n      // Skip entries without valid meta.json\n    }\n  }\n  return null;\n}\n\n/**\n * Process a single article: run OA discovery and optionally update meta.json.\n */\nasync function processArticle(\n  article: ArticleEntry,\n  sessionDir: string,\n  config: DiscoveryConfig\n): Promise<FulltextCheckArticleResult> {\n  const discoveryArticle: DiscoveryArticle = {};\n  if (article.doi) discoveryArticle.doi = article.doi;\n  if (article.pmid) discoveryArticle.pmid = article.pmid;\n  if (article.arxivId) discoveryArticle.arxivId = article.arxivId;\n  const discoveryResult = await discoverOA(discoveryArticle, config);\n\n  const articleResult: FulltextCheckArticleResult = {\n    title: article.title,\n    oaStatus: discoveryResult.oaStatus,\n    locationCount: discoveryResult.locations.length,\n  };\n  if (article.doi) articleResult.doi = article.doi;\n  if (article.pmid) articleResult.pmid = article.pmid;\n\n  // Try to update meta.json if a fulltext directory exists for this article\n  const dirName = await findArticleDir(sessionDir, article);\n  if (dirName) {\n    try {\n      const metaPath = join(sessionDir, 'fulltext', dirName, 'meta.json');\n      const meta = await loadMeta(metaPath);\n      meta.oaStatus = discoveryResult.oaStatus;\n      meta.oaLocations = discoveryResult.locations;\n      meta.checkedAt = new Date().toISOString();\n      await saveMeta(metaPath, meta);\n    } catch {\n      // Meta update is best-effort\n    }\n  }\n\n  return articleResult;\n}\n\n/**\n * Run async tasks with a concurrency limit.\n */\nasync function runWithConcurrency<T>(\n  tasks: Array<() => Promise<T>>,\n  concurrency: number\n): Promise<PromiseSettledResult<T>[]> {\n  const results: PromiseSettledResult<T>[] = new Array(tasks.length);\n  let nextIndex = 0;\n\n  async function worker(): Promise<void> {\n    while (nextIndex < tasks.length) {\n      const index = nextIndex++;\n      try {\n        const value = await tasks[index]!();\n        results[index] = { status: 'fulfilled', value };\n      } catch (reason) {\n        results[index] = { status: 'rejected', reason };\n      }\n    }\n  }\n\n  const workers = Array.from({ length: Math.min(concurrency, tasks.length) }, () => worker());\n  await Promise.all(workers);\n  return results;\n}\n\n/**\n * Execute the fulltext check command.\n * Checks OA availability for all included articles in a session,\n * processing articles in parallel with a concurrency limit.\n */\nexport async function executeFulltextCheck(\n  options: FulltextCheckOptions\n): Promise<FulltextCheckResult> {\n  const { sessionDir, config, concurrency = DEFAULT_CONCURRENCY } = options;\n\n  // Load included articles\n  const articles = await loadIncludedArticles(sessionDir);\n\n  const summary = { total: articles.length, open: 0, closed: 0, unknown: 0 };\n\n  const tasks = articles.map(\n    (article) => () => processArticle(article, sessionDir, config)\n  );\n\n  const settled = await runWithConcurrency(tasks, concurrency);\n\n  const results: FulltextCheckArticleResult[] = [];\n  for (const result of settled) {\n    if (result.status === 'fulfilled') {\n      results.push(result.value);\n      switch (result.value.oaStatus) {\n        case 'open':\n          summary.open++;\n          break;\n        case 'closed':\n          summary.closed++;\n          break;\n        case 'unknown':\n          summary.unknown++;\n          break;\n      }\n    }\n  }\n\n  return { summary, articles: results };\n}\n"],"names":["parseYaml"],"mappings":"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"}
+{"version":3,"file":"check.js","sources":["../../../../src/cli/commands/fulltext/check.ts"],"sourcesContent":["/**\n * Fulltext check command.\n * Checks OA availability for included articles in a session.\n */\n\nimport { readFile, readdir, access } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport { discoverOA, loadMeta, saveMeta, type DiscoveryConfig, type DiscoveryArticle, type OAStatus, type OALocation } from '@ncukondo/academic-fulltext';\nimport type { ReviewFile, ArticleEntry } from '../review/types';\nimport { verifyPmcid } from './verify-pmcid';\n\n/** Default concurrency for parallel article processing */\nconst DEFAULT_CONCURRENCY = 3;\n\nexport interface FulltextCheckOptions {\n  sessionDir: string;\n  config: DiscoveryConfig;\n  concurrency?: number;\n}\n\nexport interface FulltextCheckArticleResult {\n  doi?: string;\n  pmid?: string;\n  /** PMCID discovered during OA check and verified against the article */\n  pmcid?: string;\n  /** PMCID discovered during OA check but rejected because its metadata did not match */\n  rejectedPmcid?: string;\n  title: string;\n  oaStatus: OAStatus;\n  locationCount: number;\n}\n\nexport interface FulltextCheckResult {\n  summary: {\n    total: number;\n    open: number;\n    closed: number;\n    unknown: number;\n  };\n  articles: FulltextCheckArticleResult[];\n}\n\n/**\n * Load included articles from reviews.yaml\n */\nasync function loadIncludedArticles(sessionDir: string): Promise<ArticleEntry[]> {\n  const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  const reviewFile = parseYaml(content) as ReviewFile;\n  return reviewFile.articles.filter((a) => a.finalDecision === 'include');\n}\n\n/**\n * Try to find a meta.json matching an article in the fulltext directory.\n * Returns the dirName if found, null otherwise.\n */\nasync function findArticleDir(\n  sessionDir: string,\n  article: ArticleEntry\n): Promise<string | null> {\n  const fulltextDir = join(sessionDir, 'fulltext');\n  try {\n    await access(fulltextDir);\n  } catch {\n    return null;\n  }\n\n  let entries: string[];\n  try {\n    const dirEntries = await readdir(fulltextDir);\n    entries = dirEntries.map(String);\n  } catch {\n    return null;\n  }\n\n  for (const entry of entries) {\n    try {\n      const metaPath = join(fulltextDir, entry, 'meta.json');\n      const meta = await loadMeta(metaPath);\n      // Match by DOI or PMID\n      if (article.doi && meta.doi === article.doi) return entry;\n      if (article.pmid && meta.pmid === article.pmid) return entry;\n    } catch {\n      // Skip entries without valid meta.json\n    }\n  }\n  return null;\n}\n\n/** Outcome of validating a discovered PMCID against the article. */\ninterface ValidatedDiscovery {\n  oaStatus: OAStatus;\n  locations: OALocation[];\n  verifiedPmcid?: string;\n  rejectedPmcid?: string;\n}\n\n/**\n * Validate a PMCID discovered during OA discovery against the article's\n * own metadata. On mismatch, drop all PMC locations so an unrelated\n * paper's fulltext is never fetched (issue #146).\n */\nasync function validateDiscoveredPmcid(\n  article: ArticleEntry,\n  config: DiscoveryConfig,\n  discoveredPmcid: string | undefined,\n  oaStatus: OAStatus,\n  locations: OALocation[]\n): Promise<ValidatedDiscovery> {\n  const hasPmcLocations = locations.some((loc) => loc.source === 'pmc');\n  if (!discoveredPmcid || !hasPmcLocations) {\n    return { oaStatus, locations };\n  }\n\n  const verifyArticle: { doi?: string; pmid?: string; title?: string } = {\n    title: article.title,\n  };\n  if (article.doi) verifyArticle.doi = article.doi;\n  if (article.pmid) verifyArticle.pmid = article.pmid;\n  const verifyOptions: { ncbiEmail?: string; ncbiTool?: string } = {};\n  if (config.ncbiEmail) verifyOptions.ncbiEmail = config.ncbiEmail;\n  if (config.ncbiTool) verifyOptions.ncbiTool = config.ncbiTool;\n\n  const verification = await verifyPmcid(discoveredPmcid, verifyArticle, verifyOptions);\n\n  if (verification === 'match') {\n    return { oaStatus, locations, verifiedPmcid: discoveredPmcid };\n  }\n  if (verification === 'mismatch') {\n    const filtered = locations.filter((loc) => loc.source !== 'pmc');\n    const status = filtered.length === 0 && oaStatus === 'open' ? 'unknown' : oaStatus;\n    return { oaStatus: status, locations: filtered, rejectedPmcid: discoveredPmcid };\n  }\n  // Unverified: keep locations but do not vouch for the PMCID\n  return { oaStatus, locations };\n}\n\n/**\n * Process a single article: run OA discovery and optionally update meta.json.\n */\nasync function processArticle(\n  article: ArticleEntry,\n  sessionDir: string,\n  config: DiscoveryConfig\n): Promise<FulltextCheckArticleResult> {\n  const discoveryArticle: DiscoveryArticle = {};\n  if (article.doi) discoveryArticle.doi = article.doi;\n  if (article.pmid) discoveryArticle.pmid = article.pmid;\n  if (article.arxivId) discoveryArticle.arxivId = article.arxivId;\n  const discoveryResult = await discoverOA(discoveryArticle, config);\n\n  const validated = await validateDiscoveredPmcid(\n    article,\n    config,\n    discoveryResult.discoveredIds.pmcid,\n    discoveryResult.oaStatus,\n    discoveryResult.locations\n  );\n\n  const articleResult: FulltextCheckArticleResult = {\n    title: article.title,\n    oaStatus: validated.oaStatus,\n    locationCount: validated.locations.length,\n  };\n  if (article.doi) articleResult.doi = article.doi;\n  if (article.pmid) articleResult.pmid = article.pmid;\n  if (validated.verifiedPmcid) articleResult.pmcid = validated.verifiedPmcid;\n  if (validated.rejectedPmcid) articleResult.rejectedPmcid = validated.rejectedPmcid;\n\n  // Try to update meta.json if a fulltext directory exists for this article\n  const dirName = await findArticleDir(sessionDir, article);\n  if (dirName) {\n    try {\n      const metaPath = join(sessionDir, 'fulltext', dirName, 'meta.json');\n      const meta = await loadMeta(metaPath);\n      meta.oaStatus = validated.oaStatus;\n      meta.oaLocations = validated.locations;\n      if (validated.verifiedPmcid && !meta.pmcid) {\n        meta.pmcid = validated.verifiedPmcid;\n      }\n      meta.checkedAt = new Date().toISOString();\n      await saveMeta(metaPath, meta);\n    } catch {\n      // Meta update is best-effort\n    }\n  }\n\n  return articleResult;\n}\n\n/**\n * Run async tasks with a concurrency limit.\n */\nasync function runWithConcurrency<T>(\n  tasks: Array<() => Promise<T>>,\n  concurrency: number\n): Promise<PromiseSettledResult<T>[]> {\n  const results: PromiseSettledResult<T>[] = new Array(tasks.length);\n  let nextIndex = 0;\n\n  async function worker(): Promise<void> {\n    while (nextIndex < tasks.length) {\n      const index = nextIndex++;\n      try {\n        const value = await tasks[index]!();\n        results[index] = { status: 'fulfilled', value };\n      } catch (reason) {\n        results[index] = { status: 'rejected', reason };\n      }\n    }\n  }\n\n  const workers = Array.from({ length: Math.min(concurrency, tasks.length) }, () => worker());\n  await Promise.all(workers);\n  return results;\n}\n\n/**\n * Execute the fulltext check command.\n * Checks OA availability for all included articles in a session,\n * processing articles in parallel with a concurrency limit.\n */\nexport async function executeFulltextCheck(\n  options: FulltextCheckOptions\n): Promise<FulltextCheckResult> {\n  const { sessionDir, config, concurrency = DEFAULT_CONCURRENCY } = options;\n\n  // Load included articles\n  const articles = await loadIncludedArticles(sessionDir);\n\n  const summary = { total: articles.length, open: 0, closed: 0, unknown: 0 };\n\n  const tasks = articles.map(\n    (article) => () => processArticle(article, sessionDir, config)\n  );\n\n  const settled = await runWithConcurrency(tasks, concurrency);\n\n  const results: FulltextCheckArticleResult[] = [];\n  for (const result of settled) {\n    if (result.status === 'fulfilled') {\n      results.push(result.value);\n      switch (result.value.oaStatus) {\n        case 'open':\n          summary.open++;\n          break;\n        case 'closed':\n          summary.closed++;\n          break;\n        case 'unknown':\n          summary.unknown++;\n          break;\n      }\n    }\n  }\n\n  return { summary, articles: results };\n}\n"],"names":["parseYaml"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fulltext/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,GACvD,IAAI,CAkVN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fulltext/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,GACvD,IAAI,CA2VN"}

package/dist/cli/commands/fulltext/index.js

@@ -183,6 +183,16 @@ OA Status Summary:`);
         console.log(`  Closed Access:  ${result.summary.closed}`);
         console.log(`  Unknown:        ${result.summary.unknown}`);
         console.log(`  Total:          ${result.summary.total}`);
+        const rejected = result.articles.filter((a) => a.rejectedPmcid);
+        if (rejected.length > 0) {
+          console.log(`
+Warnings:`);
+          for (const article of rejected) {
+            console.log(
+              `  Discovered ${article.rejectedPmcid} does not match "${article.title}" — PMC locations dropped.`
+            );
+          }
+        }
         if (result.summary.open > 0) {
           console.log(`
 Run \`fulltext fetch\` to download available OA articles.`);

package/dist/cli/commands/fulltext/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/cli/commands/fulltext/index.ts"],"sourcesContent":["/**\n * Fulltext command group registration.\n */\n\nimport type { Command } from 'commander';\nimport { executeFulltextInit } from './init.js';\nimport { executeFulltextSync } from './sync.js';\nimport { executeFulltextConvert } from './convert.js';\nimport { executeFulltextCheck } from './check.js';\nimport { executeFulltextFetch } from './fetch.js';\nimport { executeFulltextAttach } from './attach.js';\nimport { executeFulltextStatus, type FulltextStatusResult } from './status.js';\nimport { executeFulltextPending, type PendingArticle } from './pending.js';\nimport { formatInitOutput, formatSyncOutput } from './format.js';\nimport type { GlobalOptions } from '../../index.js';\nimport { EXIT_CODES } from '../../exit-codes.js';\nimport { sessionExists } from '../../../session/manager.js';\nimport { loadConfig } from '../../../config/index.js';\nimport { join } from 'node:path';\n\nexport function registerFulltextCommands(\n  program: Command,\n  getSessionsDir: (opts: GlobalOptions) => Promise<string>,\n): void {\n  const fulltextCommand = program\n    .command('fulltext')\n    .description('Fulltext management: retrieval, conversion, attachment')\n    .addHelpText('after', `\nExamples:\n  $ search-hub fulltext init SESSION_ID               # Create directories for included articles\n  $ search-hub fulltext init SESSION_ID --dry-run     # Preview what would be created\n  $ search-hub fulltext sync SESSION_ID               # Detect and register added files\n  $ search-hub fulltext sync SESSION_ID --dry-run     # Preview what would be synced\n  $ search-hub fulltext convert SESSION_ID            # Convert PMC XML to Markdown\n  $ search-hub fulltext check --session SESSION_ID   # Check OA availability\n  $ search-hub fulltext fetch SESSION_ID              # Download available OA articles\n  $ search-hub fulltext fetch SESSION_ID --dry-run    # Preview what would be downloaded\n  $ search-hub fulltext fetch SESSION_ID --source pmc # Download from specific sources\n  $ search-hub fulltext attach SESSION_ID             # Attach fulltexts to ref entries\n  $ search-hub fulltext attach SESSION_ID --dry-run   # Preview what would be attached\n  $ search-hub fulltext status SESSION_ID            # Show fulltext retrieval status\n  $ search-hub fulltext pending SESSION_ID           # List articles needing download`);\n\n  fulltextCommand\n    .command('init')\n    .description('Create directories for included articles with meta.json and README')\n    .argument('<session-id>', 'session ID')\n    .option('--dry-run', 'show what would be created without creating', false)\n    .action(async (sessionId: string, options: { dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        const result = await executeFulltextInit({\n          sessionId,\n          sessionsDir,\n          dryRun: options.dryRun,\n        });\n\n        if (!globalOpts.quiet) {\n          console.log(formatInitOutput(result));\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error(\n            'Error:',\n            error instanceof Error ? error.message : error,\n          );\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('sync')\n    .description('Detect and register manually added fulltext files')\n    .argument('<session-id>', 'session ID')\n    .option('--dry-run', 'show what would be synced without modifying', false)\n    .action(async (sessionId: string, options: { dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        const result = await executeFulltextSync({\n          sessionId,\n          sessionsDir,\n          dryRun: options.dryRun,\n        });\n\n        if (!globalOpts.quiet) {\n          console.log(formatSyncOutput(result));\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error(\n            'Error:',\n            error instanceof Error ? error.message : error,\n          );\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('convert')\n    .description('Convert PMC XML files to Markdown')\n    .argument('<session-id>', 'session ID')\n    .option('--article <dir>', 'convert specific article directory')\n    .action(async (sessionId: string, options?: { article?: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        if (!(await sessionExists(sessionId, sessionsDir))) {\n          if (!globalOpts.quiet) {\n            console.error(`Error: session '${sessionId}' not found`);\n          }\n          process.exitCode = EXIT_CODES.SESSION_ERROR;\n          return;\n        }\n\n        const convertOpts: Parameters<typeof executeFulltextConvert>[0] = { sessionId };\n        if (options?.article) convertOpts.article = options.article;\n        const result = await executeFulltextConvert(convertOpts, sessionsDir);\n\n        if (!globalOpts.quiet) {\n          console.log(`Converted: ${result.converted}  Skipped: ${result.skipped}  Failed: ${result.failed}`);\n          for (const article of result.articles) {\n            const icon = article.status === 'converted' ? '+' : article.status === 'skipped' ? '-' : '!';\n            console.log(`  [${icon}] ${article.dirName}: ${article.title}`);\n          }\n        }\n\n        process.exitCode = result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SESSION_ERROR;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('attach')\n    .description('Attach fulltext files to reference-manager entries')\n    .argument('<session-id>', 'session ID')\n    .option('--dry-run', 'show what would be attached without attaching', false)\n    .action(async (sessionId: string, options: { dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        if (!(await sessionExists(sessionId, sessionsDir))) {\n          if (!globalOpts.quiet) {\n            console.error(`Error: session '${sessionId}' not found`);\n          }\n          process.exitCode = EXIT_CODES.SESSION_ERROR;\n          return;\n        }\n\n        const sessionDir = join(sessionsDir, sessionId);\n\n        const result = await executeFulltextAttach({\n          sessionDir,\n          dryRun: options.dryRun,\n        });\n\n        if (!globalOpts.quiet) {\n          const prefix = options.dryRun ? 'Would attach' : 'Attached';\n          console.log(`\\nFulltext ${prefix.toLowerCase()}:`);\n          if (result.summary.attached > 0) {\n            const totalFiles = result.attached.reduce((sum, a) => sum + a.files.length, 0);\n            console.log(`  ✓ ${result.summary.attached} articles (${totalFiles} files)`);\n            for (const item of result.attached) {\n              console.log(`    ${item.refId}: ${item.files.join(', ')}`);\n            }\n          }\n          if (result.summary.skipped > 0) {\n            console.log(`  ⚠ ${result.summary.skipped} skipped`);\n          }\n          if (result.summary.failed > 0) {\n            console.log(`  ✗ ${result.summary.failed} failed`);\n            for (const item of result.failed) {\n              console.log(`    ${item.dirName}: ${item.reason}`);\n            }\n          }\n          if (result.summary.total === 0) {\n            console.log('  No fulltext directories found.');\n          }\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error(\n            'Error:',\n            error instanceof Error ? error.message : error,\n          );\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('check')\n    .description('Check Open Access availability for included articles')\n    .requiredOption('--session <id>', 'session ID')\n    .option('--format <format>', 'output format (table or json)', 'table')\n    .action(async (options: { session: string; format: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n        const sessionDir = join(sessionsDir, options.session);\n        const config = await loadConfig(\n          globalOpts.config ? { globalConfigPath: globalOpts.config } : {}\n        );\n        const result = await executeFulltextCheck({\n          sessionDir,\n          config: {\n            unpaywallEmail: config.fulltext?.sources?.unpaywall_email ?? '',\n            coreApiKey: config.fulltext?.sources?.core_api_key ?? '',\n            ncbiEmail: config.fulltext?.sources?.ncbi_email ?? '',\n            ncbiTool: config.fulltext?.sources?.ncbi_tool ?? 'search-hub',\n            preferSources: config.fulltext?.sources?.prefer_sources ?? ['pmc', 'arxiv', 'unpaywall', 'core'],\n          },\n        });\n\n        if (options.format === 'json') {\n          console.log(JSON.stringify(result, null, 2));\n        } else if (!globalOpts.quiet) {\n          console.log(`\\nOA Status Summary:`);\n          console.log(`  Open Access:    ${result.summary.open}`);\n          console.log(`  Closed Access:  ${result.summary.closed}`);\n          console.log(`  Unknown:        ${result.summary.unknown}`);\n          console.log(`  Total:          ${result.summary.total}`);\n          if (result.summary.open > 0) {\n            console.log(`\\nRun \\`fulltext fetch\\` to download available OA articles.`);\n          }\n        }\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('fetch')\n    .description('Download available OA fulltexts')\n    .argument('<session-id>', 'session ID')\n    .option('--source <sources>', 'filter by source (comma-separated: pmc,arxiv,unpaywall,core)')\n    .option('--no-convert-markdown', 'skip auto-conversion of PMC XML to Markdown')\n    .option('--dry-run', 'show what would be downloaded without downloading', false)\n    .action(async (sessionId: string, options: { source?: string; convertMarkdown: boolean; dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        const fetchOpts: Parameters<typeof executeFulltextFetch>[0] = {\n          sessionId,\n          sessionsDir,\n          convertMarkdown: options.convertMarkdown,\n          dryRun: options.dryRun,\n        };\n        if (options.source) fetchOpts.source = options.source.split(',');\n        const result = await executeFulltextFetch(fetchOpts);\n\n        if (!globalOpts.quiet) {\n          if (result.dryRun) {\n            console.log(`\\nDry run: would fetch ${result.articles.length} articles`);\n            for (const article of result.articles) {\n              console.log(`  ${article.dirName}: ${article.title} (${article.locationCount} sources)`);\n            }\n          } else {\n            console.log(`\\nFulltext Fetch Summary:`);\n            console.log(`  Downloaded: ${result.summary.downloaded}`);\n            console.log(`  Failed:     ${result.summary.failed}`);\n            console.log(`  Skipped:    ${result.summary.skipped}`);\n            console.log(`  Total:      ${result.summary.total}`);\n          }\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('status')\n    .description('Show overall fulltext retrieval status')\n    .argument('<session-id>', 'session ID')\n    .option('--format <format>', 'output format (table or json)', 'table')\n    .action(async (sessionId: string, options: { format: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n        const sessionDir = join(sessionsDir, sessionId);\n        const result = await executeFulltextStatus({\n          sessionDir,\n          format: options.format as 'table' | 'json',\n        });\n\n        if (options.format === 'json') {\n          console.log(JSON.stringify(result, null, 2));\n        } else if (!globalOpts.quiet) {\n          console.log(formatStatusOutput(result, sessionId));\n        }\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('pending')\n    .description('List articles needing manual fulltext download')\n    .argument('<session-id>', 'session ID')\n    .option('--format <format>', 'output format (table or json)', 'table')\n    .option('--export <file>', 'export URLs to file for batch download')\n    .action(async (sessionId: string, options: { format: string; export?: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n        const sessionDir = join(sessionsDir, sessionId);\n        const result = await executeFulltextPending({\n          sessionDir,\n          format: options.format as 'table' | 'json',\n          exportPath: options.export,\n        });\n\n        if (options.format === 'json') {\n          console.log(JSON.stringify(result, null, 2));\n        } else if (!globalOpts.quiet) {\n          console.log(formatPendingOutput(result.articles, result.totalPending));\n          if (options.export) {\n            console.log(`\\nExported URLs to ${options.export}`);\n          } else if (result.totalPending > 0) {\n            console.log(`\\nExport URLs: fulltext pending ${sessionId} --export urls.txt`);\n          }\n        }\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n}\n\nfunction formatStatusOutput(result: FulltextStatusResult, sessionId: string): string {\n  const lines = [\n    `Fulltext Status: ${sessionId}`,\n    '',\n    `  Included articles: ${result.totalIncluded}`,\n    `  With fulltext:     ${result.withFulltext}`,\n    `    - PDF only:      ${result.pdfOnly}`,\n    `    - Markdown only: ${result.markdownOnly}`,\n    `    - Both:          ${result.both}`,\n    `  Pending:           ${result.pending}  (directories created, no files)`,\n    `  Not initialized:   ${result.notInitialized}  (no directory)`,\n  ];\n  return lines.join('\\n');\n}\n\nfunction formatPendingOutput(articles: PendingArticle[], total: number): string {\n  if (total === 0) {\n    return 'All included articles have fulltext.';\n  }\n\n  const lines: string[] = [`${total} articles need fulltext:`, ''];\n\n  for (const [i, article] of articles.entries()) {\n    const num = i + 1;\n    const identifier = article.dirName ?? '(not initialized)';\n    lines.push(`${num}. ${identifier} - \"${article.title}\"`);\n    if (article.doi) {\n      lines.push(`   DOI: ${article.doi}`);\n    }\n    if (article.publisherUrl) {\n      lines.push(`   Publisher: ${article.publisherUrl}`);\n    }\n    if (article.oaLocations) {\n      for (const loc of article.oaLocations) {\n        lines.push(`   ${loc.source}: ${loc.url}`);\n      }\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../src/cli/commands/fulltext/index.ts"],"sourcesContent":["/**\n * Fulltext command group registration.\n */\n\nimport type { Command } from 'commander';\nimport { executeFulltextInit } from './init.js';\nimport { executeFulltextSync } from './sync.js';\nimport { executeFulltextConvert } from './convert.js';\nimport { executeFulltextCheck } from './check.js';\nimport { executeFulltextFetch } from './fetch.js';\nimport { executeFulltextAttach } from './attach.js';\nimport { executeFulltextStatus, type FulltextStatusResult } from './status.js';\nimport { executeFulltextPending, type PendingArticle } from './pending.js';\nimport { formatInitOutput, formatSyncOutput } from './format.js';\nimport type { GlobalOptions } from '../../index.js';\nimport { EXIT_CODES } from '../../exit-codes.js';\nimport { sessionExists } from '../../../session/manager.js';\nimport { loadConfig } from '../../../config/index.js';\nimport { join } from 'node:path';\n\nexport function registerFulltextCommands(\n  program: Command,\n  getSessionsDir: (opts: GlobalOptions) => Promise<string>,\n): void {\n  const fulltextCommand = program\n    .command('fulltext')\n    .description('Fulltext management: retrieval, conversion, attachment')\n    .addHelpText('after', `\nExamples:\n  $ search-hub fulltext init SESSION_ID               # Create directories for included articles\n  $ search-hub fulltext init SESSION_ID --dry-run     # Preview what would be created\n  $ search-hub fulltext sync SESSION_ID               # Detect and register added files\n  $ search-hub fulltext sync SESSION_ID --dry-run     # Preview what would be synced\n  $ search-hub fulltext convert SESSION_ID            # Convert PMC XML to Markdown\n  $ search-hub fulltext check --session SESSION_ID   # Check OA availability\n  $ search-hub fulltext fetch SESSION_ID              # Download available OA articles\n  $ search-hub fulltext fetch SESSION_ID --dry-run    # Preview what would be downloaded\n  $ search-hub fulltext fetch SESSION_ID --source pmc # Download from specific sources\n  $ search-hub fulltext attach SESSION_ID             # Attach fulltexts to ref entries\n  $ search-hub fulltext attach SESSION_ID --dry-run   # Preview what would be attached\n  $ search-hub fulltext status SESSION_ID            # Show fulltext retrieval status\n  $ search-hub fulltext pending SESSION_ID           # List articles needing download`);\n\n  fulltextCommand\n    .command('init')\n    .description('Create directories for included articles with meta.json and README')\n    .argument('<session-id>', 'session ID')\n    .option('--dry-run', 'show what would be created without creating', false)\n    .action(async (sessionId: string, options: { dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        const result = await executeFulltextInit({\n          sessionId,\n          sessionsDir,\n          dryRun: options.dryRun,\n        });\n\n        if (!globalOpts.quiet) {\n          console.log(formatInitOutput(result));\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error(\n            'Error:',\n            error instanceof Error ? error.message : error,\n          );\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('sync')\n    .description('Detect and register manually added fulltext files')\n    .argument('<session-id>', 'session ID')\n    .option('--dry-run', 'show what would be synced without modifying', false)\n    .action(async (sessionId: string, options: { dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        const result = await executeFulltextSync({\n          sessionId,\n          sessionsDir,\n          dryRun: options.dryRun,\n        });\n\n        if (!globalOpts.quiet) {\n          console.log(formatSyncOutput(result));\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error(\n            'Error:',\n            error instanceof Error ? error.message : error,\n          );\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('convert')\n    .description('Convert PMC XML files to Markdown')\n    .argument('<session-id>', 'session ID')\n    .option('--article <dir>', 'convert specific article directory')\n    .action(async (sessionId: string, options?: { article?: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        if (!(await sessionExists(sessionId, sessionsDir))) {\n          if (!globalOpts.quiet) {\n            console.error(`Error: session '${sessionId}' not found`);\n          }\n          process.exitCode = EXIT_CODES.SESSION_ERROR;\n          return;\n        }\n\n        const convertOpts: Parameters<typeof executeFulltextConvert>[0] = { sessionId };\n        if (options?.article) convertOpts.article = options.article;\n        const result = await executeFulltextConvert(convertOpts, sessionsDir);\n\n        if (!globalOpts.quiet) {\n          console.log(`Converted: ${result.converted}  Skipped: ${result.skipped}  Failed: ${result.failed}`);\n          for (const article of result.articles) {\n            const icon = article.status === 'converted' ? '+' : article.status === 'skipped' ? '-' : '!';\n            console.log(`  [${icon}] ${article.dirName}: ${article.title}`);\n          }\n        }\n\n        process.exitCode = result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.SESSION_ERROR;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('attach')\n    .description('Attach fulltext files to reference-manager entries')\n    .argument('<session-id>', 'session ID')\n    .option('--dry-run', 'show what would be attached without attaching', false)\n    .action(async (sessionId: string, options: { dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        if (!(await sessionExists(sessionId, sessionsDir))) {\n          if (!globalOpts.quiet) {\n            console.error(`Error: session '${sessionId}' not found`);\n          }\n          process.exitCode = EXIT_CODES.SESSION_ERROR;\n          return;\n        }\n\n        const sessionDir = join(sessionsDir, sessionId);\n\n        const result = await executeFulltextAttach({\n          sessionDir,\n          dryRun: options.dryRun,\n        });\n\n        if (!globalOpts.quiet) {\n          const prefix = options.dryRun ? 'Would attach' : 'Attached';\n          console.log(`\\nFulltext ${prefix.toLowerCase()}:`);\n          if (result.summary.attached > 0) {\n            const totalFiles = result.attached.reduce((sum, a) => sum + a.files.length, 0);\n            console.log(`  ✓ ${result.summary.attached} articles (${totalFiles} files)`);\n            for (const item of result.attached) {\n              console.log(`    ${item.refId}: ${item.files.join(', ')}`);\n            }\n          }\n          if (result.summary.skipped > 0) {\n            console.log(`  ⚠ ${result.summary.skipped} skipped`);\n          }\n          if (result.summary.failed > 0) {\n            console.log(`  ✗ ${result.summary.failed} failed`);\n            for (const item of result.failed) {\n              console.log(`    ${item.dirName}: ${item.reason}`);\n            }\n          }\n          if (result.summary.total === 0) {\n            console.log('  No fulltext directories found.');\n          }\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error(\n            'Error:',\n            error instanceof Error ? error.message : error,\n          );\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('check')\n    .description('Check Open Access availability for included articles')\n    .requiredOption('--session <id>', 'session ID')\n    .option('--format <format>', 'output format (table or json)', 'table')\n    .action(async (options: { session: string; format: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n        const sessionDir = join(sessionsDir, options.session);\n        const config = await loadConfig(\n          globalOpts.config ? { globalConfigPath: globalOpts.config } : {}\n        );\n        const result = await executeFulltextCheck({\n          sessionDir,\n          config: {\n            unpaywallEmail: config.fulltext?.sources?.unpaywall_email ?? '',\n            coreApiKey: config.fulltext?.sources?.core_api_key ?? '',\n            ncbiEmail: config.fulltext?.sources?.ncbi_email ?? '',\n            ncbiTool: config.fulltext?.sources?.ncbi_tool ?? 'search-hub',\n            preferSources: config.fulltext?.sources?.prefer_sources ?? ['pmc', 'arxiv', 'unpaywall', 'core'],\n          },\n        });\n\n        if (options.format === 'json') {\n          console.log(JSON.stringify(result, null, 2));\n        } else if (!globalOpts.quiet) {\n          console.log(`\\nOA Status Summary:`);\n          console.log(`  Open Access:    ${result.summary.open}`);\n          console.log(`  Closed Access:  ${result.summary.closed}`);\n          console.log(`  Unknown:        ${result.summary.unknown}`);\n          console.log(`  Total:          ${result.summary.total}`);\n          const rejected = result.articles.filter((a) => a.rejectedPmcid);\n          if (rejected.length > 0) {\n            console.log(`\\nWarnings:`);\n            for (const article of rejected) {\n              console.log(\n                `  Discovered ${article.rejectedPmcid} does not match \"${article.title}\" — PMC locations dropped.`\n              );\n            }\n          }\n          if (result.summary.open > 0) {\n            console.log(`\\nRun \\`fulltext fetch\\` to download available OA articles.`);\n          }\n        }\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('fetch')\n    .description('Download available OA fulltexts')\n    .argument('<session-id>', 'session ID')\n    .option('--source <sources>', 'filter by source (comma-separated: pmc,arxiv,unpaywall,core)')\n    .option('--no-convert-markdown', 'skip auto-conversion of PMC XML to Markdown')\n    .option('--dry-run', 'show what would be downloaded without downloading', false)\n    .action(async (sessionId: string, options: { source?: string; convertMarkdown: boolean; dryRun: boolean }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n\n        const fetchOpts: Parameters<typeof executeFulltextFetch>[0] = {\n          sessionId,\n          sessionsDir,\n          convertMarkdown: options.convertMarkdown,\n          dryRun: options.dryRun,\n        };\n        if (options.source) fetchOpts.source = options.source.split(',');\n        const result = await executeFulltextFetch(fetchOpts);\n\n        if (!globalOpts.quiet) {\n          if (result.dryRun) {\n            console.log(`\\nDry run: would fetch ${result.articles.length} articles`);\n            for (const article of result.articles) {\n              console.log(`  ${article.dirName}: ${article.title} (${article.locationCount} sources)`);\n            }\n          } else {\n            console.log(`\\nFulltext Fetch Summary:`);\n            console.log(`  Downloaded: ${result.summary.downloaded}`);\n            console.log(`  Failed:     ${result.summary.failed}`);\n            console.log(`  Skipped:    ${result.summary.skipped}`);\n            console.log(`  Total:      ${result.summary.total}`);\n          }\n        }\n\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('status')\n    .description('Show overall fulltext retrieval status')\n    .argument('<session-id>', 'session ID')\n    .option('--format <format>', 'output format (table or json)', 'table')\n    .action(async (sessionId: string, options: { format: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n        const sessionDir = join(sessionsDir, sessionId);\n        const result = await executeFulltextStatus({\n          sessionDir,\n          format: options.format as 'table' | 'json',\n        });\n\n        if (options.format === 'json') {\n          console.log(JSON.stringify(result, null, 2));\n        } else if (!globalOpts.quiet) {\n          console.log(formatStatusOutput(result, sessionId));\n        }\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n\n  fulltextCommand\n    .command('pending')\n    .description('List articles needing manual fulltext download')\n    .argument('<session-id>', 'session ID')\n    .option('--format <format>', 'output format (table or json)', 'table')\n    .option('--export <file>', 'export URLs to file for batch download')\n    .action(async (sessionId: string, options: { format: string; export?: string }) => {\n      const globalOpts = program.opts() as GlobalOptions;\n      try {\n        const sessionsDir = await getSessionsDir(globalOpts);\n        const sessionDir = join(sessionsDir, sessionId);\n        const result = await executeFulltextPending({\n          sessionDir,\n          format: options.format as 'table' | 'json',\n          exportPath: options.export,\n        });\n\n        if (options.format === 'json') {\n          console.log(JSON.stringify(result, null, 2));\n        } else if (!globalOpts.quiet) {\n          console.log(formatPendingOutput(result.articles, result.totalPending));\n          if (options.export) {\n            console.log(`\\nExported URLs to ${options.export}`);\n          } else if (result.totalPending > 0) {\n            console.log(`\\nExport URLs: fulltext pending ${sessionId} --export urls.txt`);\n          }\n        }\n        process.exitCode = EXIT_CODES.SUCCESS;\n      } catch (error) {\n        if (!globalOpts.quiet) {\n          console.error('Error:', error instanceof Error ? error.message : error);\n        }\n        process.exitCode = EXIT_CODES.SESSION_ERROR;\n      }\n    });\n}\n\nfunction formatStatusOutput(result: FulltextStatusResult, sessionId: string): string {\n  const lines = [\n    `Fulltext Status: ${sessionId}`,\n    '',\n    `  Included articles: ${result.totalIncluded}`,\n    `  With fulltext:     ${result.withFulltext}`,\n    `    - PDF only:      ${result.pdfOnly}`,\n    `    - Markdown only: ${result.markdownOnly}`,\n    `    - Both:          ${result.both}`,\n    `  Pending:           ${result.pending}  (directories created, no files)`,\n    `  Not initialized:   ${result.notInitialized}  (no directory)`,\n  ];\n  return lines.join('\\n');\n}\n\nfunction formatPendingOutput(articles: PendingArticle[], total: number): string {\n  if (total === 0) {\n    return 'All included articles have fulltext.';\n  }\n\n  const lines: string[] = [`${total} articles need fulltext:`, ''];\n\n  for (const [i, article] of articles.entries()) {\n    const num = i + 1;\n    const identifier = article.dirName ?? '(not initialized)';\n    lines.push(`${num}. ${identifier} - \"${article.title}\"`);\n    if (article.doi) {\n      lines.push(`   DOI: ${article.doi}`);\n    }\n    if (article.publisherUrl) {\n      lines.push(`   Publisher: ${article.publisherUrl}`);\n    }\n    if (article.oaLocations) {\n      for (const loc of article.oaLocations) {\n        lines.push(`   ${loc.source}: ${loc.url}`);\n      }\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/fulltext/verify-pmcid.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PMCID verification against source article metadata.
+ *
+ * OA discovery can resolve a PMCID that belongs to a different paper
+ * (e.g. a citing article returned by elink). Before attaching PMC
+ * locations to an article, cross-check the PMC record's DOI/PMID/title
+ * against the source article via NCBI esummary (issue #146).
+ */
+export interface PmcidVerifyArticle {
+    doi?: string;
+    pmid?: string;
+    title?: string;
+}
+export type PmcidVerification = 'match' | 'mismatch' | 'unverified';
+export interface VerifyPmcidOptions {
+    ncbiEmail?: string;
+    ncbiTool?: string;
+    /** Injectable fetch for testing */
+    fetchFn?: typeof fetch;
+}
+/**
+ * Verify that a PMCID actually refers to the given article.
+ * Compares by DOI first, then PMID, then normalized title.
+ * Returns 'unverified' when the PMC record cannot be fetched or
+ * shares no comparable field with the article.
+ */
+export declare function verifyPmcid(pmcid: string, article: PmcidVerifyArticle, options?: VerifyPmcidOptions): Promise<PmcidVerification>;
+//# sourceMappingURL=verify-pmcid.d.ts.map

package/dist/cli/commands/fulltext/verify-pmcid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-pmcid.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/fulltext/verify-pmcid.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAuDD;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAuB5B"}

package/dist/cli/commands/fulltext/verify-pmcid.js

@@ -0,0 +1,51 @@
+const ESUMMARY_URL = "https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esummary.fcgi";
+function normalizeDoi(doi) {
+  return doi.trim().toLowerCase().replace(/^https?:\/\/(dx\.)?doi\.org\//, "").replace(/^doi:/, "");
+}
+function normalizeTitle(title) {
+  return title.toLowerCase().replace(/[^a-z0-9]+/g, "");
+}
+async function fetchPmcRecord(pmcid, options) {
+  const numericId = pmcid.replace(/^PMC/i, "");
+  const params = new URLSearchParams({ db: "pmc", id: numericId, retmode: "json" });
+  if (options.ncbiTool) params.set("tool", options.ncbiTool);
+  if (options.ncbiEmail) params.set("email", options.ncbiEmail);
+  const fetchFn = options.fetchFn ?? fetch;
+  try {
+    const response = await fetchFn(`${ESUMMARY_URL}?${params.toString()}`);
+    if (!response.ok) return null;
+    const data = await response.json();
+    const record = data.result?.[numericId];
+    if (!record || typeof record !== "object") return null;
+    return record;
+  } catch {
+    return null;
+  }
+}
+function findArticleId(record, idtype) {
+  return record.articleids?.find((id) => id.idtype === idtype)?.value;
+}
+async function verifyPmcid(pmcid, article, options = {}) {
+  const record = await fetchPmcRecord(pmcid, options);
+  if (!record) return "unverified";
+  const recordDoi = findArticleId(record, "doi");
+  if (article.doi && recordDoi) {
+    return normalizeDoi(article.doi) === normalizeDoi(recordDoi) ? "match" : "mismatch";
+  }
+  const recordPmid = findArticleId(record, "pmid");
+  if (article.pmid && recordPmid) {
+    return article.pmid.trim() === recordPmid.trim() ? "match" : "mismatch";
+  }
+  if (article.title && record.title) {
+    const articleTitle = normalizeTitle(article.title);
+    const recordTitle = normalizeTitle(record.title);
+    if (articleTitle && recordTitle) {
+      return articleTitle === recordTitle ? "match" : "mismatch";
+    }
+  }
+  return "unverified";
+}
+export {
+  verifyPmcid
+};
+//# sourceMappingURL=verify-pmcid.js.map

package/dist/cli/commands/fulltext/verify-pmcid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-pmcid.js","sources":["../../../../src/cli/commands/fulltext/verify-pmcid.ts"],"sourcesContent":["/**\n * PMCID verification against source article metadata.\n *\n * OA discovery can resolve a PMCID that belongs to a different paper\n * (e.g. a citing article returned by elink). Before attaching PMC\n * locations to an article, cross-check the PMC record's DOI/PMID/title\n * against the source article via NCBI esummary (issue #146).\n */\n\nconst ESUMMARY_URL = 'https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esummary.fcgi';\n\nexport interface PmcidVerifyArticle {\n  doi?: string;\n  pmid?: string;\n  title?: string;\n}\n\nexport type PmcidVerification = 'match' | 'mismatch' | 'unverified';\n\nexport interface VerifyPmcidOptions {\n  ncbiEmail?: string;\n  ncbiTool?: string;\n  /** Injectable fetch for testing */\n  fetchFn?: typeof fetch;\n}\n\ninterface EsummaryArticleId {\n  idtype?: string;\n  value?: string;\n}\n\ninterface EsummaryRecord {\n  title?: string;\n  articleids?: EsummaryArticleId[];\n}\n\n/** Lowercase a DOI and strip url/prefix decorations for comparison. */\nfunction normalizeDoi(doi: string): string {\n  return doi\n    .trim()\n    .toLowerCase()\n    .replace(/^https?:\\/\\/(dx\\.)?doi\\.org\\//, '')\n    .replace(/^doi:/, '');\n}\n\n/** Reduce a title to lowercase alphanumerics for tolerant comparison. */\nfunction normalizeTitle(title: string): string {\n  return title.toLowerCase().replace(/[^a-z0-9]+/g, '');\n}\n\n/** Fetch the esummary record for a PMC ID. Returns null on any failure. */\nasync function fetchPmcRecord(\n  pmcid: string,\n  options: VerifyPmcidOptions\n): Promise<EsummaryRecord | null> {\n  const numericId = pmcid.replace(/^PMC/i, '');\n  const params = new URLSearchParams({ db: 'pmc', id: numericId, retmode: 'json' });\n  if (options.ncbiTool) params.set('tool', options.ncbiTool);\n  if (options.ncbiEmail) params.set('email', options.ncbiEmail);\n\n  const fetchFn = options.fetchFn ?? fetch;\n  try {\n    const response = await fetchFn(`${ESUMMARY_URL}?${params.toString()}`);\n    if (!response.ok) return null;\n    const data = (await response.json()) as {\n      result?: Record<string, unknown>;\n    };\n    const record = data.result?.[numericId];\n    if (!record || typeof record !== 'object') return null;\n    return record as EsummaryRecord;\n  } catch {\n    return null;\n  }\n}\n\nfunction findArticleId(record: EsummaryRecord, idtype: string): string | undefined {\n  return record.articleids?.find((id) => id.idtype === idtype)?.value;\n}\n\n/**\n * Verify that a PMCID actually refers to the given article.\n * Compares by DOI first, then PMID, then normalized title.\n * Returns 'unverified' when the PMC record cannot be fetched or\n * shares no comparable field with the article.\n */\nexport async function verifyPmcid(\n  pmcid: string,\n  article: PmcidVerifyArticle,\n  options: VerifyPmcidOptions = {}\n): Promise<PmcidVerification> {\n  const record = await fetchPmcRecord(pmcid, options);\n  if (!record) return 'unverified';\n\n  const recordDoi = findArticleId(record, 'doi');\n  if (article.doi && recordDoi) {\n    return normalizeDoi(article.doi) === normalizeDoi(recordDoi) ? 'match' : 'mismatch';\n  }\n\n  const recordPmid = findArticleId(record, 'pmid');\n  if (article.pmid && recordPmid) {\n    return article.pmid.trim() === recordPmid.trim() ? 'match' : 'mismatch';\n  }\n\n  if (article.title && record.title) {\n    const articleTitle = normalizeTitle(article.title);\n    const recordTitle = normalizeTitle(record.title);\n    if (articleTitle && recordTitle) {\n      return articleTitle === recordTitle ? 'match' : 'mismatch';\n    }\n  }\n\n  return 'unverified';\n}\n"],"names":[],"mappings":"AASA,MAAM,eAAe;AA4BrB,SAAS,aAAa,KAAqB;AACzC,SAAO,IACJ,OACA,cACA,QAAQ,iCAAiC,EAAE,EAC3C,QAAQ,SAAS,EAAE;AACxB;AAGA,SAAS,eAAe,OAAuB;AAC7C,SAAO,MAAM,YAAA,EAAc,QAAQ,eAAe,EAAE;AACtD;AAGA,eAAe,eACb,OACA,SACgC;AAChC,QAAM,YAAY,MAAM,QAAQ,SAAS,EAAE;AAC3C,QAAM,SAAS,IAAI,gBAAgB,EAAE,IAAI,OAAO,IAAI,WAAW,SAAS,QAAQ;AAChF,MAAI,QAAQ,SAAU,QAAO,IAAI,QAAQ,QAAQ,QAAQ;AACzD,MAAI,QAAQ,UAAW,QAAO,IAAI,SAAS,QAAQ,SAAS;AAE5D,QAAM,UAAU,QAAQ,WAAW;AACnC,MAAI;AACF,UAAM,WAAW,MAAM,QAAQ,GAAG,YAAY,IAAI,OAAO,SAAA,CAAU,EAAE;AACrE,QAAI,CAAC,SAAS,GAAI,QAAO;AACzB,UAAM,OAAQ,MAAM,SAAS,KAAA;AAG7B,UAAM,SAAS,KAAK,SAAS,SAAS;AACtC,QAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,cAAc,QAAwB,QAAoC;AACjF,SAAO,OAAO,YAAY,KAAK,CAAC,OAAO,GAAG,WAAW,MAAM,GAAG;AAChE;AAQA,eAAsB,YACpB,OACA,SACA,UAA8B,CAAA,GACF;AAC5B,QAAM,SAAS,MAAM,eAAe,OAAO,OAAO;AAClD,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,YAAY,cAAc,QAAQ,KAAK;AAC7C,MAAI,QAAQ,OAAO,WAAW;AAC5B,WAAO,aAAa,QAAQ,GAAG,MAAM,aAAa,SAAS,IAAI,UAAU;AAAA,EAC3E;AAEA,QAAM,aAAa,cAAc,QAAQ,MAAM;AAC/C,MAAI,QAAQ,QAAQ,YAAY;AAC9B,WAAO,QAAQ,KAAK,KAAA,MAAW,WAAW,KAAA,IAAS,UAAU;AAAA,EAC/D;AAEA,MAAI,QAAQ,SAAS,OAAO,OAAO;AACjC,UAAM,eAAe,eAAe,QAAQ,KAAK;AACjD,UAAM,cAAc,eAAe,OAAO,KAAK;AAC/C,QAAI,gBAAgB,aAAa;AAC/B,aAAO,iBAAiB,cAAc,UAAU;AAAA,IAClD;AAAA,EACF;AAEA,SAAO;AACT;"}

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

@@ -74,6 +74,10 @@ export declare function getReviewSummary(sessionId: string, sessionsDir: string)
  * Get articles with finalDecision='include' from review file.
  * Converts from ArticleEntry format to Article format.
  *
+ * Authors are taken from the session's structured search results when the
+ * article can be matched by identifier; the authors string in reviews.yaml
+ * is only used as a fallback.
+ *
  * @throws Error if mergedFrom is missing or empty (indicates legacy review file)
  */
 export declare function getIncludedArticles(sessionId: string, sessionsDir: string): Promise<Article[]>;

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

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/register.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/register.js

@@ -3,6 +3,7 @@ import { access, readFile } from "node:fs/promises";
 import { constants } from "node:fs";
 import { createInterface } from "node:readline";
 import { parse } from "yaml";
+import { loadResults } from "../../session/results-io.js";
 import { parseProviderNames } from "../utils/validation.js";
 import { classifyStatus } from "./review/types.js";
 function parseRegisterOptions(sessionId, options) {
@@ -50,6 +51,15 @@ function getRegistrationId(article) {
   if (article.doi) {
     return article.doi;
   }
+  if (article.arxivId) {
+    return `arxiv:${article.arxivId}`;
+  }
+  if (article.ericId) {
+    return `eric:${article.ericId}`;
+  }
+  if (article.scopusId) {
+    return `scopus:${article.scopusId}`;
+  }
   return null;
 }
 function formatDryRunOutput(articles) {
@@ -74,15 +84,13 @@ function formatDryRunOutput(articles) {
   if (withoutId.length > 0) {
     lines.push("");
     lines.push(
-      `${withoutId.length} article${withoutId.length !== 1 ? "s" : ""} will be skipped (no DOI or PMID):`
+      `${withoutId.length} article${withoutId.length !== 1 ? "s" : ""} will be skipped (no identifier):`
     );
     const maxDisplay = 10;
     const displayed = withoutId.slice(0, maxDisplay);
     for (const article of displayed) {
       const truncatedTitle = article.title.length > 50 ? article.title.substring(0, 50) + "..." : article.title;
-      const altIds = getAlternativeIds(article);
-      const hasAltIds = altIds.length > 0 ? `, has: ${altIds.join(", ")}` : "";
-      lines.push(`  - "${truncatedTitle}" (source: ${article.source}${hasAltIds})`);
+      lines.push(`  - "${truncatedTitle}" (source: ${article.source})`);
     }
     if (withoutId.length > maxDisplay) {
       lines.push(`  ... and ${withoutId.length - maxDisplay} more`);
@@ -90,13 +98,6 @@ function formatDryRunOutput(articles) {
   }
   return lines.join("\n");
 }
-function getAlternativeIds(article) {
-  const ids = [];
-  if (article.arxivId) ids.push(`arxiv:${article.arxivId}`);
-  if (article.ericId) ids.push(`eric:${article.ericId}`);
-  if (article.scopusId) ids.push(`scopus:${article.scopusId}`);
-  return ids;
-}
 async function hasReviewFile(sessionId, sessionsDir) {
   const reviewsPath = join(sessionsDir, sessionId, ".internal", "reviews.yaml");
   try {
@@ -139,14 +140,62 @@ function parseAuthorName(name) {
   if (parts.length === 1) {
     return { family: parts[0] ?? "" };
   }
+  const last = parts[parts.length - 1];
+  if (/^[A-Z]{1,3}$/.test(last)) {
+    parts.pop();
+    return { family: parts.join(" "), given: last };
+  }
   const family = parts.pop() ?? "";
   const given = parts.join(" ");
   return { family, given };
 }
+function authorLookupKeys(ref) {
+  const keys = [];
+  if (ref.pmid) keys.push(`pmid:${ref.pmid}`);
+  if (ref.doi) keys.push(`doi:${ref.doi.toLowerCase()}`);
+  if (ref.arxivId) keys.push(`arxiv:${ref.arxivId}`);
+  if (ref.scopusId) keys.push(`scopus:${ref.scopusId}`);
+  if (ref.ericId) keys.push(`eric:${ref.ericId}`);
+  return keys;
+}
+async function buildAuthorLookup(sessionDir, providers) {
+  const lookup = /* @__PURE__ */ new Map();
+  for (const provider of providers) {
+    const articles = await loadResults(sessionDir, provider);
+    for (const article of articles) {
+      if (!article.authors || article.authors.length === 0) continue;
+      for (const key of authorLookupKeys(article)) {
+        if (!lookup.has(key)) {
+          lookup.set(key, article.authors);
+        }
+      }
+    }
+  }
+  return lookup;
+}
+function resolveAuthors(entry, lookup) {
+  const keys = [
+    ...authorLookupKeys(entry),
+    ...(entry.mergedFrom ?? []).flatMap((source) => authorLookupKeys(source))
+  ];
+  for (const key of keys) {
+    const authors = lookup.get(key);
+    if (authors) return authors;
+  }
+  return entry.authors ? entry.authors.split(/,\s*/).map(parseAuthorName) : [];
+}
 async function getIncludedArticles(sessionId, sessionsDir) {
   const reviewFile = await loadReviewFile(sessionId, sessionsDir);
   const articles = reviewFile.articles ?? [];
-  return articles.filter((entry) => entry.finalDecision === "include").map((entry) => {
+  const included = articles.filter((entry) => entry.finalDecision === "include");
+  const providers = /* @__PURE__ */ new Set();
+  for (const entry of included) {
+    for (const source of entry.mergedFrom ?? []) {
+      providers.add(source.source);
+    }
+  }
+  const authorLookup = await buildAuthorLookup(join(sessionsDir, sessionId), providers);
+  return included.map((entry) => {
     if (!entry.mergedFrom) {
       throw new Error(
         `Article "${entry.title}" has mergedFrom missing. This may be a legacy review file created before source tracking was fixed. Please re-run 'review init' to regenerate the review file with source tracking.`
@@ -157,7 +206,7 @@ async function getIncludedArticles(sessionId, sessionsDir) {
         `Article "${entry.title}" has empty mergedFrom array. This is an invalid state - please re-run 'review init' to regenerate.`
       );
     }
-    const authors = entry.authors ? entry.authors.split(/,\s*/).map(parseAuthorName) : [];
+    const authors = resolveAuthors(entry, authorLookup);
     const source = entry.mergedFrom[0].source;
     const article = {
       title: entry.title,