@ncukondo/search-hub 0.12.0 → 0.12.2

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

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sources":["../../../../src/cli/commands/fulltext/sync.ts"],"sourcesContent":["/**\n * fulltext sync command - Detect and register manually added files.\n */\n\nimport { join } from 'node:path';\nimport { readFile, writeFile, readdir, stat } from 'node:fs/promises';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\nimport type { ReviewFile } from '../review/types.js';\nimport type { FulltextMeta, FileInfo } from '../../../fulltext/types.js';\nimport { loadMeta, saveMeta, updateMetaFiles } from '../../../fulltext/meta.js';\nimport { getFulltextDir } from '../../../fulltext/paths.js';\n\n/** Known fulltext filenames and their type keys. */\nconst FULLTEXT_FILES: Record<string, 'pdf' | 'xml' | 'markdown'> = {\n  'fulltext.pdf': 'pdf',\n  'fulltext.xml': 'xml',\n  'fulltext.md': 'markdown',\n};\n\nexport interface FulltextSyncOptions {\n  sessionId: string;\n  sessionsDir: string;\n  dryRun?: boolean;\n}\n\nexport interface FulltextSyncEntry {\n  dirName: string;\n  files: string[];\n  sizes: number[];\n}\n\nexport interface FulltextSyncResult {\n  /** Total number of new files synced */\n  synced: number;\n  /** Number of articles updated */\n  articlesUpdated: number;\n  entries: FulltextSyncEntry[];\n  dryRun?: boolean;\n}\n\nexport async function executeFulltextSync(\n  options: FulltextSyncOptions,\n): Promise<FulltextSyncResult> {\n  const { sessionId, sessionsDir, dryRun } = options;\n  const sessionDir = join(sessionsDir, sessionId);\n  const fulltextDir = getFulltextDir(sessionDir);\n\n  // Scan all directories in fulltext/\n  let dirEntries: string[];\n  try {\n    const entries = await readdir(fulltextDir, { withFileTypes: true });\n    dirEntries = entries.filter(e => e.isDirectory()).map(e => e.name);\n  } catch {\n    return { synced: 0, articlesUpdated: 0, entries: [] };\n  }\n\n  const syncEntries: FulltextSyncEntry[] = [];\n  let totalSynced = 0;\n  const articlesWithChanges = new Set<string>();\n\n  // Track updates for meta and reviews\n  const hasFilesUpdates = new Map<string, { pdf: boolean; xml: boolean; markdown: boolean }>();\n  const metaUpdates = new Map<string, { meta: FulltextMeta; path: string }>();\n\n  for (const dirName of dirEntries) {\n    const articleDir = join(fulltextDir, dirName);\n    const metaPath = join(articleDir, 'meta.json');\n\n    // Load meta.json\n    let meta: FulltextMeta;\n    try {\n      meta = await loadMeta(metaPath);\n    } catch {\n      // Skip directories without meta.json\n      continue;\n    }\n\n    const newFiles: string[] = [];\n    const newSizes: number[] = [];\n    const fileInfoUpdates: { pdf?: FileInfo; xml?: FileInfo; markdown?: FileInfo } = {};\n\n    for (const [filename, typeKey] of Object.entries(FULLTEXT_FILES)) {\n      // Skip if already tracked in meta\n      if (meta.files[typeKey]) {\n        continue;\n      }\n\n      // Check if file exists\n      const filePath = join(articleDir, filename);\n      let fileStat;\n      try {\n        fileStat = await stat(filePath);\n      } catch {\n        continue; // File doesn't exist\n      }\n\n      if (!fileStat.isFile()) continue;\n\n      // New file found\n      const fileInfo: FileInfo = {\n        filename,\n        source: 'manual',\n        retrievedAt: new Date().toISOString(),\n        size: fileStat.size,\n      };\n\n      fileInfoUpdates[typeKey] = fileInfo;\n      newFiles.push(filename);\n      newSizes.push(fileStat.size);\n    }\n\n    if (newFiles.length > 0) {\n      totalSynced += newFiles.length;\n      articlesWithChanges.add(dirName);\n\n      syncEntries.push({\n        dirName,\n        files: newFiles,\n        sizes: newSizes,\n      });\n\n      if (!dryRun) {\n        // Update meta.json\n        const updatedMeta = updateMetaFiles(meta, fileInfoUpdates);\n        metaUpdates.set(dirName, { meta: updatedMeta, path: metaPath });\n\n        // Compute updated hasFiles for reviews\n        const hasFiles = {\n          pdf: !!(updatedMeta.files.pdf),\n          xml: !!(updatedMeta.files.xml),\n          markdown: !!(updatedMeta.files.markdown),\n        };\n        hasFilesUpdates.set(dirName, hasFiles);\n      }\n    }\n  }\n\n  if (!dryRun && metaUpdates.size > 0) {\n    // Save all meta.json updates\n    for (const [, { meta, path }] of metaUpdates) {\n      await saveMeta(path, meta);\n    }\n\n    // Update reviews.yaml if it exists\n    const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n    try {\n      const reviewContent = await readFile(reviewsPath, 'utf-8');\n      const reviewFile = parseYaml(reviewContent) as ReviewFile;\n      let reviewsChanged = false;\n\n      for (const article of reviewFile.articles) {\n        if (article.fulltext?.dirName && hasFilesUpdates.has(article.fulltext.dirName)) {\n          const hasFiles = hasFilesUpdates.get(article.fulltext.dirName);\n          if (hasFiles) {\n            article.fulltext.hasFiles = hasFiles;\n            reviewsChanged = true;\n          }\n        }\n      }\n\n      if (reviewsChanged) {\n        await writeFile(reviewsPath, stringifyYaml(reviewFile), 'utf-8');\n      }\n    } catch {\n      // No reviews.yaml - that's fine\n    }\n  }\n\n  return {\n    synced: totalSynced,\n    articlesUpdated: articlesWithChanges.size,\n    entries: syncEntries,\n    ...(dryRun && { dryRun: true }),\n  };\n}\n"],"names":["parseYaml","stringifyYaml"],"mappings":"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"}
+{"version":3,"file":"sync.js","sources":["../../../../src/cli/commands/fulltext/sync.ts"],"sourcesContent":["/**\n * fulltext sync command - Detect and register manually added files.\n */\n\nimport { join } from 'node:path';\nimport { readFile, writeFile, readdir, stat } from 'node:fs/promises';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\nimport type { ReviewFile } from '../review/types.js';\nimport { loadMeta, saveMeta, updateMetaFiles, getFulltextDir, type FulltextMeta, type FileInfo } from '@ncukondo/academic-fulltext';\n\n/** Known fulltext filenames and their type keys. */\nconst FULLTEXT_FILES: Record<string, 'pdf' | 'xml' | 'html' | 'markdown'> = {\n  'fulltext.pdf': 'pdf',\n  'fulltext.xml': 'xml',\n  'fulltext.html': 'html',\n  'fulltext.md': 'markdown',\n};\n\nexport interface FulltextSyncOptions {\n  sessionId: string;\n  sessionsDir: string;\n  dryRun?: boolean;\n}\n\nexport interface FulltextSyncEntry {\n  dirName: string;\n  files: string[];\n  sizes: number[];\n}\n\nexport interface FulltextSyncResult {\n  /** Total number of new files synced */\n  synced: number;\n  /** Number of articles updated */\n  articlesUpdated: number;\n  entries: FulltextSyncEntry[];\n  dryRun?: boolean;\n}\n\nexport async function executeFulltextSync(\n  options: FulltextSyncOptions,\n): Promise<FulltextSyncResult> {\n  const { sessionId, sessionsDir, dryRun } = options;\n  const sessionDir = join(sessionsDir, sessionId);\n  const fulltextDir = getFulltextDir(sessionDir);\n\n  // Scan all directories in fulltext/\n  let dirEntries: string[];\n  try {\n    const entries = await readdir(fulltextDir, { withFileTypes: true });\n    dirEntries = entries.filter(e => e.isDirectory()).map(e => e.name);\n  } catch {\n    return { synced: 0, articlesUpdated: 0, entries: [] };\n  }\n\n  const syncEntries: FulltextSyncEntry[] = [];\n  let totalSynced = 0;\n  const articlesWithChanges = new Set<string>();\n\n  // Track updates for meta and reviews\n  const hasFilesUpdates = new Map<string, { pdf: boolean; xml: boolean; html: boolean; markdown: boolean }>();\n  const metaUpdates = new Map<string, { meta: FulltextMeta; path: string }>();\n\n  for (const dirName of dirEntries) {\n    const articleDir = join(fulltextDir, dirName);\n    const metaPath = join(articleDir, 'meta.json');\n\n    // Load meta.json\n    let meta: FulltextMeta;\n    try {\n      meta = await loadMeta(metaPath);\n    } catch {\n      // Skip directories without meta.json\n      continue;\n    }\n\n    const newFiles: string[] = [];\n    const newSizes: number[] = [];\n    const fileInfoUpdates: { pdf?: FileInfo; xml?: FileInfo; html?: FileInfo; markdown?: FileInfo } = {};\n\n    for (const [filename, typeKey] of Object.entries(FULLTEXT_FILES)) {\n      // Skip if already tracked in meta\n      if (meta.files[typeKey]) {\n        continue;\n      }\n\n      // Check if file exists\n      const filePath = join(articleDir, filename);\n      let fileStat;\n      try {\n        fileStat = await stat(filePath);\n      } catch {\n        continue; // File doesn't exist\n      }\n\n      if (!fileStat.isFile()) continue;\n\n      // New file found\n      const fileInfo: FileInfo = {\n        filename,\n        source: 'manual',\n        retrievedAt: new Date().toISOString(),\n        size: fileStat.size,\n      };\n\n      fileInfoUpdates[typeKey] = fileInfo;\n      newFiles.push(filename);\n      newSizes.push(fileStat.size);\n    }\n\n    if (newFiles.length > 0) {\n      totalSynced += newFiles.length;\n      articlesWithChanges.add(dirName);\n\n      syncEntries.push({\n        dirName,\n        files: newFiles,\n        sizes: newSizes,\n      });\n\n      if (!dryRun) {\n        // Update meta.json\n        const updatedMeta = updateMetaFiles(meta, fileInfoUpdates);\n        metaUpdates.set(dirName, { meta: updatedMeta, path: metaPath });\n\n        // Compute updated hasFiles for reviews\n        const hasFiles = {\n          pdf: !!(updatedMeta.files.pdf),\n          xml: !!(updatedMeta.files.xml),\n          html: !!(updatedMeta.files.html),\n          markdown: !!(updatedMeta.files.markdown),\n        };\n        hasFilesUpdates.set(dirName, hasFiles);\n      }\n    }\n  }\n\n  if (!dryRun && metaUpdates.size > 0) {\n    // Save all meta.json updates\n    for (const [, { meta, path }] of metaUpdates) {\n      await saveMeta(path, meta);\n    }\n\n    // Update reviews.yaml if it exists\n    const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n    try {\n      const reviewContent = await readFile(reviewsPath, 'utf-8');\n      const reviewFile = parseYaml(reviewContent) as ReviewFile;\n      let reviewsChanged = false;\n\n      for (const article of reviewFile.articles) {\n        if (article.fulltext?.dirName && hasFilesUpdates.has(article.fulltext.dirName)) {\n          const hasFiles = hasFilesUpdates.get(article.fulltext.dirName);\n          if (hasFiles) {\n            article.fulltext.hasFiles = hasFiles;\n            reviewsChanged = true;\n          }\n        }\n      }\n\n      if (reviewsChanged) {\n        await writeFile(reviewsPath, stringifyYaml(reviewFile), 'utf-8');\n      }\n    } catch {\n      // No reviews.yaml - that's fine\n    }\n  }\n\n  return {\n    synced: totalSynced,\n    articlesUpdated: articlesWithChanges.size,\n    entries: syncEntries,\n    ...(dryRun && { dryRun: true }),\n  };\n}\n"],"names":["parseYaml","stringifyYaml"],"mappings":"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"}

package/dist/cli/commands/review/types.d.ts

@@ -1,4 +1,4 @@
-import { ArticleFulltextRef } from '../../../fulltext/types.js';
+import { ArticleFulltextRef } from '@ncukondo/academic-fulltext';
 export type ReviewDecision = 'include' | 'exclude' | 'uncertain';
 /**
  * Basis of the review decision (what information was used)

package/dist/cli/commands/review/types.d.ts.map

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

package/dist/cli/commands/review/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../../src/cli/commands/review/types.ts"],"sourcesContent":["/**\n * Review workflow types for article assessment tracking\n */\n\nimport type { ArticleFulltextRef } from '../../../fulltext/types.js';\n\nexport type ReviewDecision = 'include' | 'exclude' | 'uncertain';\n\n/**\n * Basis of the review decision (what information was used)\n */\nexport type ReviewBasis = 'title' | 'abstract' | 'fulltext';\n\n/**\n * Individual assessment of an article by a reviewer\n */\nexport interface Review {\n  /** Reviewer identifier: \"human:name\" or \"ai:name\" */\n  reviewer: string;\n  /** Assessment decision */\n  decision?: ReviewDecision;\n  /** Basis of the decision (what information was used) */\n  basis?: ReviewBasis;\n  /** Optional comment or reason */\n  comment?: string;\n  /** ISO 8601 timestamp (optional - auto-assigned on merge if not provided) */\n  timestamp?: string;\n}\n\n/**\n * Source information for merged duplicates\n */\nexport interface MergedSource {\n  source: string;\n  pmid?: string;\n  doi?: string;\n  scopusId?: string;\n  arxivId?: string;\n  ericId?: string;\n}\n\n/**\n * Article entry with identifiers, bibliographic info, and reviews\n */\nexport interface ArticleEntry {\n  // Identifiers (at least one required for matching)\n  doi?: string;\n  pmid?: string;\n  scopusId?: string;\n  arxivId?: string;\n  ericId?: string;\n\n  // Bibliographic info (for reviewer reference)\n  title: string;\n  authors?: string;\n  year?: string;\n  abstract?: string;\n\n  // Deduplication tracking\n  mergedFrom?: MergedSource[];\n\n  // Review data\n  reviews: Review[];\n  /** Historical reviews (only in extracted ReviewFiles, never in master file) */\n  reviewHistory?: Review[];\n  finalDecision?: 'include' | 'exclude' | null;\n\n  // Fulltext reference (set by fulltext init/sync)\n  fulltext?: ArticleFulltextRef;\n}\n\n/**\n * Top-level structure of the reviews.yaml file\n */\nexport interface ReviewerRecord {\n  name: string;\n  basis: ReviewBasis;\n}\n\nexport interface ReviewFile {\n  sessionId: string;\n  /** Path to inclusion criteria file */\n  criteria?: string;\n  /** Reviewer identifier (only in extracted ReviewFiles) */\n  reviewer?: string;\n  /** Basis level for screening (only in extracted ReviewFiles) */\n  basis?: ReviewBasis;\n  articles: ArticleEntry[];\n  /** Registry of reviewers who participated at each basis level */\n  reviewers?: ReviewerRecord[];\n}\n\n/**\n * Work file article entry for AI agent workflow\n */\n/** @deprecated Use ReviewFile format with reviews[] instead. Kept for backward compatibility. */\nexport interface WorkFileArticle {\n  id: string;\n  title: string;\n  abstract?: string;\n  /** Fulltext directory name (only for fulltext basis) */\n  fulltext?: string;\n  decision: ReviewDecision | null;\n  comment: string;\n}\n\n/**\n * Work file structure for AI agent workflow\n */\n/** @deprecated Use ReviewFile format with basis field instead. Kept for backward compatibility. */\nexport interface WorkFile {\n  sessionId: string;\n  basis: ReviewBasis;\n  reviewer: string;\n  articles: WorkFileArticle[];\n}\n\n/**\n * Basis priority rank: fulltext > abstract > title > undefined\n */\nconst BASIS_RANK: Record<string, number> = {\n  title: 1,\n  abstract: 2,\n  fulltext: 3,\n};\n\nexport function basisRank(basis: ReviewBasis | undefined): number {\n  if (basis === undefined) return 0;\n  return BASIS_RANK[basis] ?? 0;\n}\n\n/**\n * Review status classification (7-state model)\n */\nexport type ReviewStatus =\n  | 'pending'\n  | 'incomplete'\n  | 'uncertain'\n  | 'agreed-include'\n  | 'agreed-exclude'\n  | 'conflicting'\n  | 'finalized';\n\n/**\n * Classify the review status of an article entry\n *\n * Classification logic (in order):\n * 1. finalDecision set?           → finalized\n * 2. No reviews?                  → pending\n * 3. Registered reviewer missing? → incomplete\n * 4. include AND exclude present? → conflicting\n * 5. Any uncertain?               → uncertain\n * 6. All include?                 → agreed-include\n * 7. All exclude?                 → agreed-exclude\n */\nexport function classifyStatus(\n  entry: ArticleEntry,\n  registeredReviewers?: ReviewerRecord[]\n): ReviewStatus {\n  // 1. Finalized takes precedence\n  if (entry.finalDecision !== undefined && entry.finalDecision !== null) {\n    return 'finalized';\n  }\n\n  // No reviews = pending (reviews can be null from YAML parsing with only comments)\n  const reviews = entry.reviews ?? [];\n  if (reviews.length === 0) {\n    return 'pending';\n  }\n\n  // 3. Check for incomplete (registered reviewer missing)\n  // Only check reviewers whose registered basis ≤ article's highest reviewed basis\n  if (registeredReviewers && registeredReviewers.length > 0) {\n    const reviewerNames = new Set(reviews.map((r) => r.reviewer));\n    let highestReviewedRank = 0;\n    for (const r of reviews) {\n      highestReviewedRank = Math.max(highestReviewedRank, basisRank(r.basis));\n    }\n    // When reviews have no basis (legacy), check all registered reviewers\n    const applicableReviewers = highestReviewedRank === 0\n      ? registeredReviewers\n      : registeredReviewers.filter(\n          (reg) => basisRank(reg.basis) <= highestReviewedRank\n        );\n    const hasAllReviewers = applicableReviewers.every((reg) =>\n      reviewerNames.has(reg.name)\n    );\n    if (applicableReviewers.length > 0 && !hasAllReviewers) {\n      return 'incomplete';\n    }\n  }\n\n  // Get reviews that have decisions\n  const reviewsWithDecisions = reviews.filter((r) => r.decision !== undefined);\n\n  if (reviewsWithDecisions.length === 0) {\n    // All reviews lack a decision — treat as pending\n    return 'pending';\n  }\n\n  // Basis-priority resolution:\n  // \"uncertain\" at a lower basis means \"need more info\" (escalate).\n  // A definitive decision at a higher basis resolves that uncertainty.\n  //\n  // Algorithm:\n  // 1. Find the highest basis rank among all definitive (include/exclude) reviews\n  // 2. For each reviewer, compute their effective decision:\n  //    - Take their highest-basis definitive decision if they have one\n  //    - Otherwise, keep uncertain only if their uncertain rank >= highest definitive rank\n  //      (i.e., no higher-basis definitive exists globally to resolve it)\n  // 3. Reviewers whose only reviews are uncertain at a lower basis than the\n  //    highest global definitive are excluded from consensus (their uncertainty was resolved)\n\n  // Find highest definitive basis rank across ALL reviews\n  let highestDefinitiveRank = 0;\n  for (const r of reviewsWithDecisions) {\n    if (r.decision !== 'uncertain') {\n      highestDefinitiveRank = Math.max(highestDefinitiveRank, basisRank(r.basis));\n    }\n  }\n\n  // For each reviewer, compute effective decision\n  const reviewerMap = new Map<string, { decision: ReviewDecision; rank: number }>();\n  for (const r of reviewsWithDecisions) {\n    const rank = basisRank(r.basis);\n    const existing = reviewerMap.get(r.reviewer);\n    if (!existing) {\n      reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n    } else {\n      // Prefer definitive over uncertain\n      if (r.decision !== 'uncertain' && existing.decision === 'uncertain') {\n        reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n      } else if (r.decision !== 'uncertain' && existing.decision !== 'uncertain' && rank > existing.rank) {\n        // Higher-basis definitive overrides lower-basis definitive\n        reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n      } else if (r.decision === 'uncertain' && existing.decision === 'uncertain' && rank > existing.rank) {\n        reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n      }\n    }\n  }\n\n  // Collect effective decisions, excluding reviewers whose effective decision\n  // is at a lower basis than the highest global definitive\n  const effectiveDecisions: ReviewDecision[] = [];\n  for (const { decision, rank } of reviewerMap.values()) {\n    if (rank < highestDefinitiveRank) {\n      // This reviewer's decision is at a lower basis than the highest definitive — skip\n      continue;\n    }\n    effectiveDecisions.push(decision);\n  }\n\n  if (effectiveDecisions.length === 0) {\n    return 'pending';\n  }\n\n  // 4. Check for conflicts: both include and exclude present among effective decisions\n  const hasInclude = effectiveDecisions.includes('include');\n  const hasExclude = effectiveDecisions.includes('exclude');\n  if (hasInclude && hasExclude) {\n    return 'conflicting';\n  }\n\n  // 5. Any effective uncertain?\n  const hasUncertain = effectiveDecisions.includes('uncertain');\n  if (hasUncertain) {\n    return 'uncertain';\n  }\n\n  // 6. All include?\n  if (effectiveDecisions.every((d) => d === 'include')) {\n    return 'agreed-include';\n  }\n\n  // 7. All exclude (only remaining possibility after ruling out conflicts and uncertain)\n  return 'agreed-exclude';\n}\n"],"names":[],"mappings":"AAwHA,MAAM,aAAqC;AAAA,EACzC,OAAO;AAAA,EACP,UAAU;AAAA,EACV,UAAU;AACZ;AAEO,SAAS,UAAU,OAAwC;AAChE,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,WAAW,KAAK,KAAK;AAC9B;AA0BO,SAAS,eACd,OACA,qBACc;AAEd,MAAI,MAAM,kBAAkB,UAAa,MAAM,kBAAkB,MAAM;AACrE,WAAO;AAAA,EACT;AAGA,QAAM,UAAU,MAAM,WAAW,CAAA;AACjC,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAIA,MAAI,uBAAuB,oBAAoB,SAAS,GAAG;AACzD,UAAM,gBAAgB,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;AAC5D,QAAI,sBAAsB;AAC1B,eAAW,KAAK,SAAS;AACvB,4BAAsB,KAAK,IAAI,qBAAqB,UAAU,EAAE,KAAK,CAAC;AAAA,IACxE;AAEA,UAAM,sBAAsB,wBAAwB,IAChD,sBACA,oBAAoB;AAAA,MAClB,CAAC,QAAQ,UAAU,IAAI,KAAK,KAAK;AAAA,IAAA;AAEvC,UAAM,kBAAkB,oBAAoB;AAAA,MAAM,CAAC,QACjD,cAAc,IAAI,IAAI,IAAI;AAAA,IAAA;AAE5B,QAAI,oBAAoB,SAAS,KAAK,CAAC,iBAAiB;AACtD,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,uBAAuB,QAAQ,OAAO,CAAC,MAAM,EAAE,aAAa,MAAS;AAE3E,MAAI,qBAAqB,WAAW,GAAG;AAErC,WAAO;AAAA,EACT;AAgBA,MAAI,wBAAwB;AAC5B,aAAW,KAAK,sBAAsB;AACpC,QAAI,EAAE,aAAa,aAAa;AAC9B,8BAAwB,KAAK,IAAI,uBAAuB,UAAU,EAAE,KAAK,CAAC;AAAA,IAC5E;AAAA,EACF;AAGA,QAAM,kCAAkB,IAAA;AACxB,aAAW,KAAK,sBAAsB;AACpC,UAAM,OAAO,UAAU,EAAE,KAAK;AAC9B,UAAM,WAAW,YAAY,IAAI,EAAE,QAAQ;AAC3C,QAAI,CAAC,UAAU;AACb,kBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,IAC7D,OAAO;AAEL,UAAI,EAAE,aAAa,eAAe,SAAS,aAAa,aAAa;AACnE,oBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,MAC7D,WAAW,EAAE,aAAa,eAAe,SAAS,aAAa,eAAe,OAAO,SAAS,MAAM;AAElG,oBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,MAC7D,WAAW,EAAE,aAAa,eAAe,SAAS,aAAa,eAAe,OAAO,SAAS,MAAM;AAClG,oBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAIA,QAAM,qBAAuC,CAAA;AAC7C,aAAW,EAAE,UAAU,KAAA,KAAU,YAAY,UAAU;AACrD,QAAI,OAAO,uBAAuB;AAEhC;AAAA,IACF;AACA,uBAAmB,KAAK,QAAQ;AAAA,EAClC;AAEA,MAAI,mBAAmB,WAAW,GAAG;AACnC,WAAO;AAAA,EACT;AAGA,QAAM,aAAa,mBAAmB,SAAS,SAAS;AACxD,QAAM,aAAa,mBAAmB,SAAS,SAAS;AACxD,MAAI,cAAc,YAAY;AAC5B,WAAO;AAAA,EACT;AAGA,QAAM,eAAe,mBAAmB,SAAS,WAAW;AAC5D,MAAI,cAAc;AAChB,WAAO;AAAA,EACT;AAGA,MAAI,mBAAmB,MAAM,CAAC,MAAM,MAAM,SAAS,GAAG;AACpD,WAAO;AAAA,EACT;AAGA,SAAO;AACT;"}
+{"version":3,"file":"types.js","sources":["../../../../src/cli/commands/review/types.ts"],"sourcesContent":["/**\n * Review workflow types for article assessment tracking\n */\n\nimport type { ArticleFulltextRef } from '@ncukondo/academic-fulltext';\n\nexport type ReviewDecision = 'include' | 'exclude' | 'uncertain';\n\n/**\n * Basis of the review decision (what information was used)\n */\nexport type ReviewBasis = 'title' | 'abstract' | 'fulltext';\n\n/**\n * Individual assessment of an article by a reviewer\n */\nexport interface Review {\n  /** Reviewer identifier: \"human:name\" or \"ai:name\" */\n  reviewer: string;\n  /** Assessment decision */\n  decision?: ReviewDecision;\n  /** Basis of the decision (what information was used) */\n  basis?: ReviewBasis;\n  /** Optional comment or reason */\n  comment?: string;\n  /** ISO 8601 timestamp (optional - auto-assigned on merge if not provided) */\n  timestamp?: string;\n}\n\n/**\n * Source information for merged duplicates\n */\nexport interface MergedSource {\n  source: string;\n  pmid?: string;\n  doi?: string;\n  scopusId?: string;\n  arxivId?: string;\n  ericId?: string;\n}\n\n/**\n * Article entry with identifiers, bibliographic info, and reviews\n */\nexport interface ArticleEntry {\n  // Identifiers (at least one required for matching)\n  doi?: string;\n  pmid?: string;\n  scopusId?: string;\n  arxivId?: string;\n  ericId?: string;\n\n  // Bibliographic info (for reviewer reference)\n  title: string;\n  authors?: string;\n  year?: string;\n  abstract?: string;\n\n  // Deduplication tracking\n  mergedFrom?: MergedSource[];\n\n  // Review data\n  reviews: Review[];\n  /** Historical reviews (only in extracted ReviewFiles, never in master file) */\n  reviewHistory?: Review[];\n  finalDecision?: 'include' | 'exclude' | null;\n\n  // Fulltext reference (set by fulltext init/sync)\n  fulltext?: ArticleFulltextRef;\n}\n\n/**\n * Top-level structure of the reviews.yaml file\n */\nexport interface ReviewerRecord {\n  name: string;\n  basis: ReviewBasis;\n}\n\nexport interface ReviewFile {\n  sessionId: string;\n  /** Path to inclusion criteria file */\n  criteria?: string;\n  /** Reviewer identifier (only in extracted ReviewFiles) */\n  reviewer?: string;\n  /** Basis level for screening (only in extracted ReviewFiles) */\n  basis?: ReviewBasis;\n  articles: ArticleEntry[];\n  /** Registry of reviewers who participated at each basis level */\n  reviewers?: ReviewerRecord[];\n}\n\n/**\n * Work file article entry for AI agent workflow\n */\n/** @deprecated Use ReviewFile format with reviews[] instead. Kept for backward compatibility. */\nexport interface WorkFileArticle {\n  id: string;\n  title: string;\n  abstract?: string;\n  /** Fulltext directory name (only for fulltext basis) */\n  fulltext?: string;\n  decision: ReviewDecision | null;\n  comment: string;\n}\n\n/**\n * Work file structure for AI agent workflow\n */\n/** @deprecated Use ReviewFile format with basis field instead. Kept for backward compatibility. */\nexport interface WorkFile {\n  sessionId: string;\n  basis: ReviewBasis;\n  reviewer: string;\n  articles: WorkFileArticle[];\n}\n\n/**\n * Basis priority rank: fulltext > abstract > title > undefined\n */\nconst BASIS_RANK: Record<string, number> = {\n  title: 1,\n  abstract: 2,\n  fulltext: 3,\n};\n\nexport function basisRank(basis: ReviewBasis | undefined): number {\n  if (basis === undefined) return 0;\n  return BASIS_RANK[basis] ?? 0;\n}\n\n/**\n * Review status classification (7-state model)\n */\nexport type ReviewStatus =\n  | 'pending'\n  | 'incomplete'\n  | 'uncertain'\n  | 'agreed-include'\n  | 'agreed-exclude'\n  | 'conflicting'\n  | 'finalized';\n\n/**\n * Classify the review status of an article entry\n *\n * Classification logic (in order):\n * 1. finalDecision set?           → finalized\n * 2. No reviews?                  → pending\n * 3. Registered reviewer missing? → incomplete\n * 4. include AND exclude present? → conflicting\n * 5. Any uncertain?               → uncertain\n * 6. All include?                 → agreed-include\n * 7. All exclude?                 → agreed-exclude\n */\nexport function classifyStatus(\n  entry: ArticleEntry,\n  registeredReviewers?: ReviewerRecord[]\n): ReviewStatus {\n  // 1. Finalized takes precedence\n  if (entry.finalDecision !== undefined && entry.finalDecision !== null) {\n    return 'finalized';\n  }\n\n  // No reviews = pending (reviews can be null from YAML parsing with only comments)\n  const reviews = entry.reviews ?? [];\n  if (reviews.length === 0) {\n    return 'pending';\n  }\n\n  // 3. Check for incomplete (registered reviewer missing)\n  // Only check reviewers whose registered basis ≤ article's highest reviewed basis\n  if (registeredReviewers && registeredReviewers.length > 0) {\n    const reviewerNames = new Set(reviews.map((r) => r.reviewer));\n    let highestReviewedRank = 0;\n    for (const r of reviews) {\n      highestReviewedRank = Math.max(highestReviewedRank, basisRank(r.basis));\n    }\n    // When reviews have no basis (legacy), check all registered reviewers\n    const applicableReviewers = highestReviewedRank === 0\n      ? registeredReviewers\n      : registeredReviewers.filter(\n          (reg) => basisRank(reg.basis) <= highestReviewedRank\n        );\n    const hasAllReviewers = applicableReviewers.every((reg) =>\n      reviewerNames.has(reg.name)\n    );\n    if (applicableReviewers.length > 0 && !hasAllReviewers) {\n      return 'incomplete';\n    }\n  }\n\n  // Get reviews that have decisions\n  const reviewsWithDecisions = reviews.filter((r) => r.decision !== undefined);\n\n  if (reviewsWithDecisions.length === 0) {\n    // All reviews lack a decision — treat as pending\n    return 'pending';\n  }\n\n  // Basis-priority resolution:\n  // \"uncertain\" at a lower basis means \"need more info\" (escalate).\n  // A definitive decision at a higher basis resolves that uncertainty.\n  //\n  // Algorithm:\n  // 1. Find the highest basis rank among all definitive (include/exclude) reviews\n  // 2. For each reviewer, compute their effective decision:\n  //    - Take their highest-basis definitive decision if they have one\n  //    - Otherwise, keep uncertain only if their uncertain rank >= highest definitive rank\n  //      (i.e., no higher-basis definitive exists globally to resolve it)\n  // 3. Reviewers whose only reviews are uncertain at a lower basis than the\n  //    highest global definitive are excluded from consensus (their uncertainty was resolved)\n\n  // Find highest definitive basis rank across ALL reviews\n  let highestDefinitiveRank = 0;\n  for (const r of reviewsWithDecisions) {\n    if (r.decision !== 'uncertain') {\n      highestDefinitiveRank = Math.max(highestDefinitiveRank, basisRank(r.basis));\n    }\n  }\n\n  // For each reviewer, compute effective decision\n  const reviewerMap = new Map<string, { decision: ReviewDecision; rank: number }>();\n  for (const r of reviewsWithDecisions) {\n    const rank = basisRank(r.basis);\n    const existing = reviewerMap.get(r.reviewer);\n    if (!existing) {\n      reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n    } else {\n      // Prefer definitive over uncertain\n      if (r.decision !== 'uncertain' && existing.decision === 'uncertain') {\n        reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n      } else if (r.decision !== 'uncertain' && existing.decision !== 'uncertain' && rank > existing.rank) {\n        // Higher-basis definitive overrides lower-basis definitive\n        reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n      } else if (r.decision === 'uncertain' && existing.decision === 'uncertain' && rank > existing.rank) {\n        reviewerMap.set(r.reviewer, { decision: r.decision!, rank });\n      }\n    }\n  }\n\n  // Collect effective decisions, excluding reviewers whose effective decision\n  // is at a lower basis than the highest global definitive\n  const effectiveDecisions: ReviewDecision[] = [];\n  for (const { decision, rank } of reviewerMap.values()) {\n    if (rank < highestDefinitiveRank) {\n      // This reviewer's decision is at a lower basis than the highest definitive — skip\n      continue;\n    }\n    effectiveDecisions.push(decision);\n  }\n\n  if (effectiveDecisions.length === 0) {\n    return 'pending';\n  }\n\n  // 4. Check for conflicts: both include and exclude present among effective decisions\n  const hasInclude = effectiveDecisions.includes('include');\n  const hasExclude = effectiveDecisions.includes('exclude');\n  if (hasInclude && hasExclude) {\n    return 'conflicting';\n  }\n\n  // 5. Any effective uncertain?\n  const hasUncertain = effectiveDecisions.includes('uncertain');\n  if (hasUncertain) {\n    return 'uncertain';\n  }\n\n  // 6. All include?\n  if (effectiveDecisions.every((d) => d === 'include')) {\n    return 'agreed-include';\n  }\n\n  // 7. All exclude (only remaining possibility after ruling out conflicts and uncertain)\n  return 'agreed-exclude';\n}\n"],"names":[],"mappings":"AAwHA,MAAM,aAAqC;AAAA,EACzC,OAAO;AAAA,EACP,UAAU;AAAA,EACV,UAAU;AACZ;AAEO,SAAS,UAAU,OAAwC;AAChE,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,WAAW,KAAK,KAAK;AAC9B;AA0BO,SAAS,eACd,OACA,qBACc;AAEd,MAAI,MAAM,kBAAkB,UAAa,MAAM,kBAAkB,MAAM;AACrE,WAAO;AAAA,EACT;AAGA,QAAM,UAAU,MAAM,WAAW,CAAA;AACjC,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAIA,MAAI,uBAAuB,oBAAoB,SAAS,GAAG;AACzD,UAAM,gBAAgB,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;AAC5D,QAAI,sBAAsB;AAC1B,eAAW,KAAK,SAAS;AACvB,4BAAsB,KAAK,IAAI,qBAAqB,UAAU,EAAE,KAAK,CAAC;AAAA,IACxE;AAEA,UAAM,sBAAsB,wBAAwB,IAChD,sBACA,oBAAoB;AAAA,MAClB,CAAC,QAAQ,UAAU,IAAI,KAAK,KAAK;AAAA,IAAA;AAEvC,UAAM,kBAAkB,oBAAoB;AAAA,MAAM,CAAC,QACjD,cAAc,IAAI,IAAI,IAAI;AAAA,IAAA;AAE5B,QAAI,oBAAoB,SAAS,KAAK,CAAC,iBAAiB;AACtD,aAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,uBAAuB,QAAQ,OAAO,CAAC,MAAM,EAAE,aAAa,MAAS;AAE3E,MAAI,qBAAqB,WAAW,GAAG;AAErC,WAAO;AAAA,EACT;AAgBA,MAAI,wBAAwB;AAC5B,aAAW,KAAK,sBAAsB;AACpC,QAAI,EAAE,aAAa,aAAa;AAC9B,8BAAwB,KAAK,IAAI,uBAAuB,UAAU,EAAE,KAAK,CAAC;AAAA,IAC5E;AAAA,EACF;AAGA,QAAM,kCAAkB,IAAA;AACxB,aAAW,KAAK,sBAAsB;AACpC,UAAM,OAAO,UAAU,EAAE,KAAK;AAC9B,UAAM,WAAW,YAAY,IAAI,EAAE,QAAQ;AAC3C,QAAI,CAAC,UAAU;AACb,kBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,IAC7D,OAAO;AAEL,UAAI,EAAE,aAAa,eAAe,SAAS,aAAa,aAAa;AACnE,oBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,MAC7D,WAAW,EAAE,aAAa,eAAe,SAAS,aAAa,eAAe,OAAO,SAAS,MAAM;AAElG,oBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,MAC7D,WAAW,EAAE,aAAa,eAAe,SAAS,aAAa,eAAe,OAAO,SAAS,MAAM;AAClG,oBAAY,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAW,MAAM;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAIA,QAAM,qBAAuC,CAAA;AAC7C,aAAW,EAAE,UAAU,KAAA,KAAU,YAAY,UAAU;AACrD,QAAI,OAAO,uBAAuB;AAEhC;AAAA,IACF;AACA,uBAAmB,KAAK,QAAQ;AAAA,EAClC;AAEA,MAAI,mBAAmB,WAAW,GAAG;AACnC,WAAO;AAAA,EACT;AAGA,QAAM,aAAa,mBAAmB,SAAS,SAAS;AACxD,QAAM,aAAa,mBAAmB,SAAS,SAAS;AACxD,MAAI,cAAc,YAAY;AAC5B,WAAO;AAAA,EACT;AAGA,QAAM,eAAe,mBAAmB,SAAS,WAAW;AAC5D,MAAI,cAAc;AAChB,WAAO;AAAA,EACT;AAGA,MAAI,mBAAmB,MAAM,CAAC,MAAM,MAAM,SAAS,GAAG;AACpD,WAAO;AAAA,EACT;AAGA,SAAO;AACT;"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqKpC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAktEvC;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqKpC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CA0tEvC;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C"}

package/dist/cli/index.js

@@ -1647,6 +1647,13 @@ Examples:
         process.exitCode = EXIT_CODES.SESSION_ERROR;
         return;
       }
+      if (!await sessionExists(sessionId, sessionsDir)) {
+        if (!globalOpts.quiet) {
+          console.error(`Error: session '${sessionId}' not found`);
+        }
+        process.exitCode = EXIT_CODES.SESSION_ERROR;
+        return;
+      }
       const sessionDir = join(sessionsDir, sessionId);
       const notes = await loadNotes(sessionDir);
       if (!globalOpts.quiet) {