@ncukondo/search-hub 0.17.0 → 0.19.0

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

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,WAAW,GACX,KAAK,CAAC;AAEV,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAWD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkBjE"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,GACT,WAAW,GACX,KAAK,CAAC;AAEV,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAWD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkBjE"}

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

@@ -1 +1 @@
-{"version":3,"file":"list.js","sources":["../../../../src/cli/commands/review/list.ts"],"sourcesContent":["/**\n * review list command - List articles with optional filtering\n */\n\nimport { join } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport { parse as parseYaml } from 'yaml';\nimport { classifyStatus, type ReviewFile, type ReviewStatus } from './types.js';\n\nexport type ListFilter =\n  | 'pending'\n  | 'incomplete'\n  | 'uncertain'\n  | 'agreed-include'\n  | 'agreed-exclude'\n  | 'conflicting'\n  | 'finalized'\n  | 'all';\n\nexport interface ReviewListOptions {\n  sessionId: string;\n  filter?: ListFilter;\n}\n\nexport interface ArticleListItem {\n  title: string;\n  pmid?: string;\n  doi?: string;\n  scopusId?: string;\n  arxivId?: string;\n  ericId?: string;\n  year?: string;\n  status: ReviewStatus;\n  reviewCount: number;\n  finalDecision?: 'include' | 'exclude';\n}\n\nexport interface ReviewListResult {\n  sessionId: string;\n  filter: ListFilter;\n  articles: ArticleListItem[];\n}\n\n/**\n * Load review file from session directory\n */\nasync function loadReviewFile(sessionDir: string): Promise<ReviewFile> {\n  const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  return parseYaml(content) as ReviewFile;\n}\n\n/**\n * Execute review list command\n */\nexport async function executeReviewList(\n  options: ReviewListOptions,\n  sessionsDir: string\n): Promise<ReviewListResult> {\n  const sessionDir = join(sessionsDir, options.sessionId);\n  const reviewFile = await loadReviewFile(sessionDir);\n  const filter = options.filter ?? 'all';\n\n  const articles: ArticleListItem[] = [];\n\n  const reviewers = reviewFile.reviewers;\n  for (const article of reviewFile.articles) {\n    const status = classifyStatus(article, reviewers);\n\n    // Apply filter\n    if (filter !== 'all' && status !== filter) {\n      continue;\n    }\n\n    const item: ArticleListItem = {\n      title: article.title,\n      status,\n      reviewCount: (article.reviews ?? []).length,\n    };\n\n    // Add optional identifiers\n    if (article.pmid) item.pmid = article.pmid;\n    if (article.doi) item.doi = article.doi;\n    if (article.scopusId) item.scopusId = article.scopusId;\n    if (article.arxivId) item.arxivId = article.arxivId;\n    if (article.ericId) item.ericId = article.ericId;\n    if (article.year) item.year = article.year;\n    if (article.finalDecision) item.finalDecision = article.finalDecision;\n\n    articles.push(item);\n  }\n\n  return {\n    sessionId: options.sessionId,\n    filter,\n    articles,\n  };\n}\n\n/**\n * Format list result as human-readable string\n */\nexport function formatListOutput(result: ReviewListResult): string {\n  if (result.articles.length === 0) {\n    return `No articles found matching filter: ${result.filter}`;\n  }\n\n  const lines: string[] = [];\n  lines.push(`${result.articles.length} articles (filter: ${result.filter})`);\n  lines.push('');\n\n  for (const article of result.articles) {\n    const id = article.pmid ?? article.doi ?? article.scopusId ?? article.arxivId ?? article.ericId ?? '-';\n    const year = article.year ?? '-';\n    const decision = article.finalDecision ? ` [${article.finalDecision}]` : '';\n    lines.push(`[${article.status}] ${article.title}`);\n    lines.push(`  ID: ${id} | Year: ${year} | Reviews: ${article.reviewCount}${decision}`);\n  }\n\n  return lines.join('\\n');\n}\n"],"names":["parseYaml"],"mappings":";;;;AA8CA,eAAe,eAAe,YAAyC;AACrE,QAAM,cAAc,KAAK,YAAY,aAAa,cAAc;AAChE,QAAM,UAAU,MAAM,SAAS,aAAa,OAAO;AACnD,SAAOA,MAAU,OAAO;AAC1B;AAKA,eAAsB,kBACpB,SACA,aAC2B;AAC3B,QAAM,aAAa,KAAK,aAAa,QAAQ,SAAS;AACtD,QAAM,aAAa,MAAM,eAAe,UAAU;AAClD,QAAM,SAAS,QAAQ,UAAU;AAEjC,QAAM,WAA8B,CAAA;AAEpC,QAAM,YAAY,WAAW;AAC7B,aAAW,WAAW,WAAW,UAAU;AACzC,UAAM,SAAS,eAAe,SAAS,SAAS;AAGhD,QAAI,WAAW,SAAS,WAAW,QAAQ;AACzC;AAAA,IACF;AAEA,UAAM,OAAwB;AAAA,MAC5B,OAAO,QAAQ;AAAA,MACf;AAAA,MACA,cAAc,QAAQ,WAAW,IAAI;AAAA,IAAA;AAIvC,QAAI,QAAQ,KAAM,MAAK,OAAO,QAAQ;AACtC,QAAI,QAAQ,IAAK,MAAK,MAAM,QAAQ;AACpC,QAAI,QAAQ,SAAU,MAAK,WAAW,QAAQ;AAC9C,QAAI,QAAQ,QAAS,MAAK,UAAU,QAAQ;AAC5C,QAAI,QAAQ,OAAQ,MAAK,SAAS,QAAQ;AAC1C,QAAI,QAAQ,KAAM,MAAK,OAAO,QAAQ;AACtC,QAAI,QAAQ,cAAe,MAAK,gBAAgB,QAAQ;AAExD,aAAS,KAAK,IAAI;AAAA,EACpB;AAEA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA;AAAA,EAAA;AAEJ;AAKO,SAAS,iBAAiB,QAAkC;AACjE,MAAI,OAAO,SAAS,WAAW,GAAG;AAChC,WAAO,sCAAsC,OAAO,MAAM;AAAA,EAC5D;AAEA,QAAM,QAAkB,CAAA;AACxB,QAAM,KAAK,GAAG,OAAO,SAAS,MAAM,sBAAsB,OAAO,MAAM,GAAG;AAC1E,QAAM,KAAK,EAAE;AAEb,aAAW,WAAW,OAAO,UAAU;AACrC,UAAM,KAAK,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,YAAY,QAAQ,WAAW,QAAQ,UAAU;AACnG,UAAM,OAAO,QAAQ,QAAQ;AAC7B,UAAM,WAAW,QAAQ,gBAAgB,KAAK,QAAQ,aAAa,MAAM;AACzE,UAAM,KAAK,IAAI,QAAQ,MAAM,KAAK,QAAQ,KAAK,EAAE;AACjD,UAAM,KAAK,SAAS,EAAE,YAAY,IAAI,eAAe,QAAQ,WAAW,GAAG,QAAQ,EAAE;AAAA,EACvF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;"}
+{"version":3,"file":"list.js","sources":["../../../../src/cli/commands/review/list.ts"],"sourcesContent":["/**\n * review list command - List articles with optional filtering\n */\n\nimport { join } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport { parse as parseYaml } from 'yaml';\nimport { classifyStatus, type ReviewFile, type ReviewStatus } from './types.js';\n\nexport type ListFilter =\n  | 'pending'\n  | 'incomplete'\n  | 'all-uncertain'\n  | 'agreed-include'\n  | 'agreed-exclude'\n  | 'divided'\n  | 'finalized'\n  | 'all';\n\nexport interface ReviewListOptions {\n  sessionId: string;\n  filter?: ListFilter;\n}\n\nexport interface ArticleListItem {\n  title: string;\n  pmid?: string;\n  doi?: string;\n  scopusId?: string;\n  arxivId?: string;\n  ericId?: string;\n  year?: string;\n  status: ReviewStatus;\n  reviewCount: number;\n  finalDecision?: 'include' | 'exclude';\n}\n\nexport interface ReviewListResult {\n  sessionId: string;\n  filter: ListFilter;\n  articles: ArticleListItem[];\n}\n\n/**\n * Load review file from session directory\n */\nasync function loadReviewFile(sessionDir: string): Promise<ReviewFile> {\n  const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  return parseYaml(content) as ReviewFile;\n}\n\n/**\n * Execute review list command\n */\nexport async function executeReviewList(\n  options: ReviewListOptions,\n  sessionsDir: string\n): Promise<ReviewListResult> {\n  const sessionDir = join(sessionsDir, options.sessionId);\n  const reviewFile = await loadReviewFile(sessionDir);\n  const filter = options.filter ?? 'all';\n\n  const articles: ArticleListItem[] = [];\n\n  const reviewers = reviewFile.reviewers;\n  for (const article of reviewFile.articles) {\n    const status = classifyStatus(article, reviewers);\n\n    // Apply filter\n    if (filter !== 'all' && status !== filter) {\n      continue;\n    }\n\n    const item: ArticleListItem = {\n      title: article.title,\n      status,\n      reviewCount: (article.reviews ?? []).length,\n    };\n\n    // Add optional identifiers\n    if (article.pmid) item.pmid = article.pmid;\n    if (article.doi) item.doi = article.doi;\n    if (article.scopusId) item.scopusId = article.scopusId;\n    if (article.arxivId) item.arxivId = article.arxivId;\n    if (article.ericId) item.ericId = article.ericId;\n    if (article.year) item.year = article.year;\n    if (article.finalDecision) item.finalDecision = article.finalDecision;\n\n    articles.push(item);\n  }\n\n  return {\n    sessionId: options.sessionId,\n    filter,\n    articles,\n  };\n}\n\n/**\n * Format list result as human-readable string\n */\nexport function formatListOutput(result: ReviewListResult): string {\n  if (result.articles.length === 0) {\n    return `No articles found matching filter: ${result.filter}`;\n  }\n\n  const lines: string[] = [];\n  lines.push(`${result.articles.length} articles (filter: ${result.filter})`);\n  lines.push('');\n\n  for (const article of result.articles) {\n    const id = article.pmid ?? article.doi ?? article.scopusId ?? article.arxivId ?? article.ericId ?? '-';\n    const year = article.year ?? '-';\n    const decision = article.finalDecision ? ` [${article.finalDecision}]` : '';\n    lines.push(`[${article.status}] ${article.title}`);\n    lines.push(`  ID: ${id} | Year: ${year} | Reviews: ${article.reviewCount}${decision}`);\n  }\n\n  return lines.join('\\n');\n}\n"],"names":["parseYaml"],"mappings":";;;;AA8CA,eAAe,eAAe,YAAyC;AACrE,QAAM,cAAc,KAAK,YAAY,aAAa,cAAc;AAChE,QAAM,UAAU,MAAM,SAAS,aAAa,OAAO;AACnD,SAAOA,MAAU,OAAO;AAC1B;AAKA,eAAsB,kBACpB,SACA,aAC2B;AAC3B,QAAM,aAAa,KAAK,aAAa,QAAQ,SAAS;AACtD,QAAM,aAAa,MAAM,eAAe,UAAU;AAClD,QAAM,SAAS,QAAQ,UAAU;AAEjC,QAAM,WAA8B,CAAA;AAEpC,QAAM,YAAY,WAAW;AAC7B,aAAW,WAAW,WAAW,UAAU;AACzC,UAAM,SAAS,eAAe,SAAS,SAAS;AAGhD,QAAI,WAAW,SAAS,WAAW,QAAQ;AACzC;AAAA,IACF;AAEA,UAAM,OAAwB;AAAA,MAC5B,OAAO,QAAQ;AAAA,MACf;AAAA,MACA,cAAc,QAAQ,WAAW,IAAI;AAAA,IAAA;AAIvC,QAAI,QAAQ,KAAM,MAAK,OAAO,QAAQ;AACtC,QAAI,QAAQ,IAAK,MAAK,MAAM,QAAQ;AACpC,QAAI,QAAQ,SAAU,MAAK,WAAW,QAAQ;AAC9C,QAAI,QAAQ,QAAS,MAAK,UAAU,QAAQ;AAC5C,QAAI,QAAQ,OAAQ,MAAK,SAAS,QAAQ;AAC1C,QAAI,QAAQ,KAAM,MAAK,OAAO,QAAQ;AACtC,QAAI,QAAQ,cAAe,MAAK,gBAAgB,QAAQ;AAExD,aAAS,KAAK,IAAI;AAAA,EACpB;AAEA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA;AAAA,EAAA;AAEJ;AAKO,SAAS,iBAAiB,QAAkC;AACjE,MAAI,OAAO,SAAS,WAAW,GAAG;AAChC,WAAO,sCAAsC,OAAO,MAAM;AAAA,EAC5D;AAEA,QAAM,QAAkB,CAAA;AACxB,QAAM,KAAK,GAAG,OAAO,SAAS,MAAM,sBAAsB,OAAO,MAAM,GAAG;AAC1E,QAAM,KAAK,EAAE;AAEb,aAAW,WAAW,OAAO,UAAU;AACrC,UAAM,KAAK,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,YAAY,QAAQ,WAAW,QAAQ,UAAU;AACnG,UAAM,OAAO,QAAQ,QAAQ;AAC7B,UAAM,WAAW,QAAQ,gBAAgB,KAAK,QAAQ,aAAa,MAAM;AACzE,UAAM,KAAK,IAAI,QAAQ,MAAM,KAAK,QAAQ,KAAK,EAAE;AACjD,UAAM,KAAK,SAAS,EAAE,YAAY,IAAI,eAAe,QAAQ,WAAW,GAAG,QAAQ,EAAE;AAAA,EACvF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;"}

package/dist/cli/commands/review/next-steps.d.ts

@@ -33,7 +33,7 @@ export declare function computeBatchContinuation(params: BatchContinuationParams
  * Evaluation order (top-to-bottom, first match wins for primary suggestion):
  * 1. pending > 0 → extract for title screening
  * 2. agreed > 0 → finalize consensus articles
- * 3. (conflicting + uncertain + incomplete) > 0 → extract for next basis level
+ * 3. (divided + allUncertain + incomplete) > 0 → extract for next basis level
  * 4. all finalized → register accepted articles
  *
  * Batch continuation is appended to seeAlso when applicable.

package/dist/cli/commands/review/next-steps.js

@@ -30,11 +30,11 @@ function generateReviewNextSteps(ctx) {
         command: `search-hub review finalize --session ${sessionId}`,
         description: `Finalize ${agreed} articles with consensus`
       });
-    } else if (rs.conflicting > 0 || rs.uncertain > 0 || rs.incomplete > 0) {
-      const unresolved = rs.conflicting + rs.uncertain + rs.incomplete;
+    } else if (rs.divided > 0 || rs.allUncertain > 0 || rs.incomplete > 0) {
+      const unresolved = rs.divided + rs.allUncertain + rs.incomplete;
       const nextBasis = detectNextBasis(rs.reviewers);
       result.next.push({
-        command: `search-hub review extract --session ${sessionId} --filter conflicting,uncertain,incomplete --basis ${nextBasis} --reviewer "<name>" --name ${nextBasis}-screening`,
+        command: `search-hub review extract --session ${sessionId} --filter divided,all-uncertain,incomplete --basis ${nextBasis} --reviewer "<name>" --name ${nextBasis}-screening`,
         description: `${unresolved} articles need ${nextBasis}-level review`
       });
     } else if (rs.finalized > 0 && rs.finalized === rs.total) {

package/dist/cli/commands/review/next-steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"next-steps.js","sources":["../../../../src/cli/commands/review/next-steps.ts"],"sourcesContent":["/**\n * Dynamic next steps generation for review workflow.\n * Generates context-aware suggestions based on current article status distribution.\n */\n\nimport type { ReviewStatusResult } from './status.js';\nimport type { ReviewBasis } from './types.js';\nimport type { Suggestion, SuggestionResult } from '../../suggestions/types.js';\n\nexport interface ReviewNextStepsContext {\n  sessionId: string;\n  statusResult: ReviewStatusResult;\n  /** Extract name for batch continuation */\n  extractName?: string;\n  /** Number of articles extracted in current batch */\n  extractedCount?: number;\n  /** Total articles matching the filter */\n  totalMatching?: number;\n  /** Limit used in extract */\n  limit?: number;\n  /** Offset used in extract */\n  offset?: number;\n}\n\nexport interface BatchContinuationParams {\n  sessionId: string;\n  extractName?: string | undefined;\n  extractedCount: number;\n  totalMatching: number;\n  limit: number;\n  offset?: number | undefined;\n}\n\n/**\n * Compute a batch continuation suggestion when --limit was used with remaining articles.\n * Returns null if no remaining articles.\n */\nexport function computeBatchContinuation(params: BatchContinuationParams): Suggestion | null {\n  const nextOffset = (params.offset ?? 0) + params.extractedCount;\n  const remaining = params.totalMatching - nextOffset;\n  if (remaining <= 0) return null;\n\n  const nextName = params.extractName ? `${params.extractName}-next` : 'next-batch';\n  return {\n    command: `search-hub review extract --session ${params.sessionId} --offset ${nextOffset} --limit ${params.limit} --name ${nextName}`,\n    description: `${remaining} articles remaining — extract next batch`,\n  };\n}\n\n/**\n * Detect the next review basis level from reviewer registry.\n * Progression: title → abstract → fulltext\n */\nfunction detectNextBasis(reviewers: ReviewStatusResult['reviewers']): ReviewBasis {\n  const bases = new Set(reviewers.map((r) => r.basis));\n  if (!bases.has('title')) return 'title';\n  if (!bases.has('abstract')) return 'abstract';\n  return 'fulltext';\n}\n\n/**\n * Generate dynamic next steps based on review status distribution.\n *\n * Evaluation order (top-to-bottom, first match wins for primary suggestion):\n * 1. pending > 0 → extract for title screening\n * 2. agreed > 0 → finalize consensus articles\n * 3. (conflicting + uncertain + incomplete) > 0 → extract for next basis level\n * 4. all finalized → register accepted articles\n *\n * Batch continuation is appended to seeAlso when applicable.\n */\nexport function generateReviewNextSteps(ctx: ReviewNextStepsContext): SuggestionResult | null {\n  const { sessionId, statusResult: rs } = ctx;\n\n  if (rs.total === 0) return null;\n\n  const result: SuggestionResult = { next: [], seeAlso: [] };\n\n  // 1. pending > 0: title screening incomplete\n  if (rs.pending > 0) {\n    result.next.push({\n      command: `search-hub review extract --session ${sessionId} --basis title --filter pending --reviewer \"<name>\" --name title-screening`,\n      description: `Extract ${rs.pending} pending articles for title screening`,\n    });\n  }\n  // 2. agreed > 0: suggest finalization\n  else {\n    const agreed = rs.agreedInclude + rs.agreedExclude;\n    if (agreed > 0) {\n      result.next.push({\n        command: `search-hub review finalize --session ${sessionId}`,\n        description: `Finalize ${agreed} articles with consensus`,\n      });\n    }\n    // 3. conflicting, uncertain, or incomplete > 0: suggest further review\n    else if (rs.conflicting > 0 || rs.uncertain > 0 || rs.incomplete > 0) {\n      const unresolved = rs.conflicting + rs.uncertain + rs.incomplete;\n      const nextBasis = detectNextBasis(rs.reviewers);\n      result.next.push({\n        command: `search-hub review extract --session ${sessionId} --filter conflicting,uncertain,incomplete --basis ${nextBasis} --reviewer \"<name>\" --name ${nextBasis}-screening`,\n        description: `${unresolved} articles need ${nextBasis}-level review`,\n      });\n    }\n    // 4. All finalized\n    else if (rs.finalized > 0 && rs.finalized === rs.total) {\n      result.next.push({\n        command: `search-hub register ${sessionId} --reviewed`,\n        description: 'Register accepted articles',\n      });\n    }\n    // No actionable state\n    else {\n      return null;\n    }\n  }\n\n  // 5. Batch continuation (appended to seeAlso when applicable)\n  if (\n    ctx.limit !== undefined &&\n    ctx.extractedCount !== undefined &&\n    ctx.totalMatching !== undefined\n  ) {\n    const batch = computeBatchContinuation({\n      sessionId,\n      extractName: ctx.extractName,\n      extractedCount: ctx.extractedCount,\n      totalMatching: ctx.totalMatching,\n      limit: ctx.limit,\n      offset: ctx.offset,\n    });\n    if (batch) result.seeAlso.push(batch);\n  }\n\n  return result;\n}\n"],"names":[],"mappings":"AAqCO,SAAS,yBAAyB,QAAoD;AAC3F,QAAM,cAAc,OAAO,UAAU,KAAK,OAAO;AACjD,QAAM,YAAY,OAAO,gBAAgB;AACzC,MAAI,aAAa,EAAG,QAAO;AAE3B,QAAM,WAAW,OAAO,cAAc,GAAG,OAAO,WAAW,UAAU;AACrE,SAAO;AAAA,IACL,SAAS,uCAAuC,OAAO,SAAS,aAAa,UAAU,YAAY,OAAO,KAAK,WAAW,QAAQ;AAAA,IAClI,aAAa,GAAG,SAAS;AAAA,EAAA;AAE7B;AAMA,SAAS,gBAAgB,WAAyD;AAChF,QAAM,QAAQ,IAAI,IAAI,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACnD,MAAI,CAAC,MAAM,IAAI,OAAO,EAAG,QAAO;AAChC,MAAI,CAAC,MAAM,IAAI,UAAU,EAAG,QAAO;AACnC,SAAO;AACT;AAaO,SAAS,wBAAwB,KAAsD;AAC5F,QAAM,EAAE,WAAW,cAAc,GAAA,IAAO;AAExC,MAAI,GAAG,UAAU,EAAG,QAAO;AAE3B,QAAM,SAA2B,EAAE,MAAM,CAAA,GAAI,SAAS,CAAA,EAAC;AAGvD,MAAI,GAAG,UAAU,GAAG;AAClB,WAAO,KAAK,KAAK;AAAA,MACf,SAAS,uCAAuC,SAAS;AAAA,MACzD,aAAa,WAAW,GAAG,OAAO;AAAA,IAAA,CACnC;AAAA,EACH,OAEK;AACH,UAAM,SAAS,GAAG,gBAAgB,GAAG;AACrC,QAAI,SAAS,GAAG;AACd,aAAO,KAAK,KAAK;AAAA,QACf,SAAS,wCAAwC,SAAS;AAAA,QAC1D,aAAa,YAAY,MAAM;AAAA,MAAA,CAChC;AAAA,IACH,WAES,GAAG,cAAc,KAAK,GAAG,YAAY,KAAK,GAAG,aAAa,GAAG;AACpE,YAAM,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG;AACtD,YAAM,YAAY,gBAAgB,GAAG,SAAS;AAC9C,aAAO,KAAK,KAAK;AAAA,QACf,SAAS,uCAAuC,SAAS,sDAAsD,SAAS,+BAA+B,SAAS;AAAA,QAChK,aAAa,GAAG,UAAU,kBAAkB,SAAS;AAAA,MAAA,CACtD;AAAA,IACH,WAES,GAAG,YAAY,KAAK,GAAG,cAAc,GAAG,OAAO;AACtD,aAAO,KAAK,KAAK;AAAA,QACf,SAAS,uBAAuB,SAAS;AAAA,QACzC,aAAa;AAAA,MAAA,CACd;AAAA,IACH,OAEK;AACH,aAAO;AAAA,IACT;AAAA,EACF;AAGA,MACE,IAAI,UAAU,UACd,IAAI,mBAAmB,UACvB,IAAI,kBAAkB,QACtB;AACA,UAAM,QAAQ,yBAAyB;AAAA,MACrC;AAAA,MACA,aAAa,IAAI;AAAA,MACjB,gBAAgB,IAAI;AAAA,MACpB,eAAe,IAAI;AAAA,MACnB,OAAO,IAAI;AAAA,MACX,QAAQ,IAAI;AAAA,IAAA,CACb;AACD,QAAI,MAAO,QAAO,QAAQ,KAAK,KAAK;AAAA,EACtC;AAEA,SAAO;AACT;"}
+{"version":3,"file":"next-steps.js","sources":["../../../../src/cli/commands/review/next-steps.ts"],"sourcesContent":["/**\n * Dynamic next steps generation for review workflow.\n * Generates context-aware suggestions based on current article status distribution.\n */\n\nimport type { ReviewStatusResult } from './status.js';\nimport type { ReviewBasis } from './types.js';\nimport type { Suggestion, SuggestionResult } from '../../suggestions/types.js';\n\nexport interface ReviewNextStepsContext {\n  sessionId: string;\n  statusResult: ReviewStatusResult;\n  /** Extract name for batch continuation */\n  extractName?: string;\n  /** Number of articles extracted in current batch */\n  extractedCount?: number;\n  /** Total articles matching the filter */\n  totalMatching?: number;\n  /** Limit used in extract */\n  limit?: number;\n  /** Offset used in extract */\n  offset?: number;\n}\n\nexport interface BatchContinuationParams {\n  sessionId: string;\n  extractName?: string | undefined;\n  extractedCount: number;\n  totalMatching: number;\n  limit: number;\n  offset?: number | undefined;\n}\n\n/**\n * Compute a batch continuation suggestion when --limit was used with remaining articles.\n * Returns null if no remaining articles.\n */\nexport function computeBatchContinuation(params: BatchContinuationParams): Suggestion | null {\n  const nextOffset = (params.offset ?? 0) + params.extractedCount;\n  const remaining = params.totalMatching - nextOffset;\n  if (remaining <= 0) return null;\n\n  const nextName = params.extractName ? `${params.extractName}-next` : 'next-batch';\n  return {\n    command: `search-hub review extract --session ${params.sessionId} --offset ${nextOffset} --limit ${params.limit} --name ${nextName}`,\n    description: `${remaining} articles remaining — extract next batch`,\n  };\n}\n\n/**\n * Detect the next review basis level from reviewer registry.\n * Progression: title → abstract → fulltext\n */\nfunction detectNextBasis(reviewers: ReviewStatusResult['reviewers']): ReviewBasis {\n  const bases = new Set(reviewers.map((r) => r.basis));\n  if (!bases.has('title')) return 'title';\n  if (!bases.has('abstract')) return 'abstract';\n  return 'fulltext';\n}\n\n/**\n * Generate dynamic next steps based on review status distribution.\n *\n * Evaluation order (top-to-bottom, first match wins for primary suggestion):\n * 1. pending > 0 → extract for title screening\n * 2. agreed > 0 → finalize consensus articles\n * 3. (divided + allUncertain + incomplete) > 0 → extract for next basis level\n * 4. all finalized → register accepted articles\n *\n * Batch continuation is appended to seeAlso when applicable.\n */\nexport function generateReviewNextSteps(ctx: ReviewNextStepsContext): SuggestionResult | null {\n  const { sessionId, statusResult: rs } = ctx;\n\n  if (rs.total === 0) return null;\n\n  const result: SuggestionResult = { next: [], seeAlso: [] };\n\n  // 1. pending > 0: title screening incomplete\n  if (rs.pending > 0) {\n    result.next.push({\n      command: `search-hub review extract --session ${sessionId} --basis title --filter pending --reviewer \"<name>\" --name title-screening`,\n      description: `Extract ${rs.pending} pending articles for title screening`,\n    });\n  }\n  // 2. agreed > 0: suggest finalization\n  else {\n    const agreed = rs.agreedInclude + rs.agreedExclude;\n    if (agreed > 0) {\n      result.next.push({\n        command: `search-hub review finalize --session ${sessionId}`,\n        description: `Finalize ${agreed} articles with consensus`,\n      });\n    }\n    // 3. divided, all-uncertain, or incomplete > 0: suggest further review\n    else if (rs.divided > 0 || rs.allUncertain > 0 || rs.incomplete > 0) {\n      const unresolved = rs.divided + rs.allUncertain + rs.incomplete;\n      const nextBasis = detectNextBasis(rs.reviewers);\n      result.next.push({\n        command: `search-hub review extract --session ${sessionId} --filter divided,all-uncertain,incomplete --basis ${nextBasis} --reviewer \"<name>\" --name ${nextBasis}-screening`,\n        description: `${unresolved} articles need ${nextBasis}-level review`,\n      });\n    }\n    // 4. All finalized\n    else if (rs.finalized > 0 && rs.finalized === rs.total) {\n      result.next.push({\n        command: `search-hub register ${sessionId} --reviewed`,\n        description: 'Register accepted articles',\n      });\n    }\n    // No actionable state\n    else {\n      return null;\n    }\n  }\n\n  // 5. Batch continuation (appended to seeAlso when applicable)\n  if (\n    ctx.limit !== undefined &&\n    ctx.extractedCount !== undefined &&\n    ctx.totalMatching !== undefined\n  ) {\n    const batch = computeBatchContinuation({\n      sessionId,\n      extractName: ctx.extractName,\n      extractedCount: ctx.extractedCount,\n      totalMatching: ctx.totalMatching,\n      limit: ctx.limit,\n      offset: ctx.offset,\n    });\n    if (batch) result.seeAlso.push(batch);\n  }\n\n  return result;\n}\n"],"names":[],"mappings":"AAqCO,SAAS,yBAAyB,QAAoD;AAC3F,QAAM,cAAc,OAAO,UAAU,KAAK,OAAO;AACjD,QAAM,YAAY,OAAO,gBAAgB;AACzC,MAAI,aAAa,EAAG,QAAO;AAE3B,QAAM,WAAW,OAAO,cAAc,GAAG,OAAO,WAAW,UAAU;AACrE,SAAO;AAAA,IACL,SAAS,uCAAuC,OAAO,SAAS,aAAa,UAAU,YAAY,OAAO,KAAK,WAAW,QAAQ;AAAA,IAClI,aAAa,GAAG,SAAS;AAAA,EAAA;AAE7B;AAMA,SAAS,gBAAgB,WAAyD;AAChF,QAAM,QAAQ,IAAI,IAAI,UAAU,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AACnD,MAAI,CAAC,MAAM,IAAI,OAAO,EAAG,QAAO;AAChC,MAAI,CAAC,MAAM,IAAI,UAAU,EAAG,QAAO;AACnC,SAAO;AACT;AAaO,SAAS,wBAAwB,KAAsD;AAC5F,QAAM,EAAE,WAAW,cAAc,GAAA,IAAO;AAExC,MAAI,GAAG,UAAU,EAAG,QAAO;AAE3B,QAAM,SAA2B,EAAE,MAAM,CAAA,GAAI,SAAS,CAAA,EAAC;AAGvD,MAAI,GAAG,UAAU,GAAG;AAClB,WAAO,KAAK,KAAK;AAAA,MACf,SAAS,uCAAuC,SAAS;AAAA,MACzD,aAAa,WAAW,GAAG,OAAO;AAAA,IAAA,CACnC;AAAA,EACH,OAEK;AACH,UAAM,SAAS,GAAG,gBAAgB,GAAG;AACrC,QAAI,SAAS,GAAG;AACd,aAAO,KAAK,KAAK;AAAA,QACf,SAAS,wCAAwC,SAAS;AAAA,QAC1D,aAAa,YAAY,MAAM;AAAA,MAAA,CAChC;AAAA,IACH,WAES,GAAG,UAAU,KAAK,GAAG,eAAe,KAAK,GAAG,aAAa,GAAG;AACnE,YAAM,aAAa,GAAG,UAAU,GAAG,eAAe,GAAG;AACrD,YAAM,YAAY,gBAAgB,GAAG,SAAS;AAC9C,aAAO,KAAK,KAAK;AAAA,QACf,SAAS,uCAAuC,SAAS,sDAAsD,SAAS,+BAA+B,SAAS;AAAA,QAChK,aAAa,GAAG,UAAU,kBAAkB,SAAS;AAAA,MAAA,CACtD;AAAA,IACH,WAES,GAAG,YAAY,KAAK,GAAG,cAAc,GAAG,OAAO;AACtD,aAAO,KAAK,KAAK;AAAA,QACf,SAAS,uBAAuB,SAAS;AAAA,QACzC,aAAa;AAAA,MAAA,CACd;AAAA,IACH,OAEK;AACH,aAAO;AAAA,IACT;AAAA,EACF;AAGA,MACE,IAAI,UAAU,UACd,IAAI,mBAAmB,UACvB,IAAI,kBAAkB,QACtB;AACA,UAAM,QAAQ,yBAAyB;AAAA,MACrC;AAAA,MACA,aAAa,IAAI;AAAA,MACjB,gBAAgB,IAAI;AAAA,MACpB,eAAe,IAAI;AAAA,MACnB,OAAO,IAAI;AAAA,MACX,QAAQ,IAAI;AAAA,IAAA,CACb;AACD,QAAI,MAAO,QAAO,QAAQ,KAAK,KAAK;AAAA,EACtC;AAEA,SAAO;AACT;"}

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

@@ -0,0 +1,199 @@
+/**
+ * Zod schemas for review workflow types.
+ *
+ * Single source of truth for:
+ * - TypeScript types (via z.infer<>)
+ * - JSON Schema for IDE autocompletion (via z.toJSONSchema())
+ *
+ * Follows the pattern established in src/query/json-schema.ts.
+ */
+import * as z from 'zod';
+export declare const reviewDecisionSchema: z.ZodEnum<{
+    exclude: "exclude";
+    include: "include";
+    uncertain: "uncertain";
+}>;
+export declare const reviewBasisSchema: z.ZodEnum<{
+    title: "title";
+    abstract: "abstract";
+    fulltext: "fulltext";
+}>;
+export declare const reviewSchema: z.ZodObject<{
+    reviewer: z.ZodString;
+    decision: z.ZodOptional<z.ZodEnum<{
+        exclude: "exclude";
+        include: "include";
+        uncertain: "uncertain";
+    }>>;
+    basis: z.ZodOptional<z.ZodEnum<{
+        title: "title";
+        abstract: "abstract";
+        fulltext: "fulltext";
+    }>>;
+    comment: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const mergedSourceSchema: z.ZodObject<{
+    source: z.ZodString;
+    pmid: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    scopusId: z.ZodOptional<z.ZodString>;
+    arxivId: z.ZodOptional<z.ZodString>;
+    ericId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const articleFulltextRefSchema: z.ZodObject<{
+    dirName: z.ZodString;
+    hasFiles: z.ZodObject<{
+        pdf: z.ZodBoolean;
+        xml: z.ZodBoolean;
+        html: z.ZodBoolean;
+        markdown: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const articleEntrySchema: z.ZodObject<{
+    doi: z.ZodOptional<z.ZodString>;
+    pmid: z.ZodOptional<z.ZodString>;
+    scopusId: z.ZodOptional<z.ZodString>;
+    arxivId: z.ZodOptional<z.ZodString>;
+    ericId: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    authors: z.ZodOptional<z.ZodString>;
+    year: z.ZodOptional<z.ZodString>;
+    abstract: z.ZodOptional<z.ZodString>;
+    mergedFrom: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        pmid: z.ZodOptional<z.ZodString>;
+        doi: z.ZodOptional<z.ZodString>;
+        scopusId: z.ZodOptional<z.ZodString>;
+        arxivId: z.ZodOptional<z.ZodString>;
+        ericId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    reviews: z.ZodArray<z.ZodObject<{
+        reviewer: z.ZodString;
+        decision: z.ZodOptional<z.ZodEnum<{
+            exclude: "exclude";
+            include: "include";
+            uncertain: "uncertain";
+        }>>;
+        basis: z.ZodOptional<z.ZodEnum<{
+            title: "title";
+            abstract: "abstract";
+            fulltext: "fulltext";
+        }>>;
+        comment: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    reviewHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        reviewer: z.ZodString;
+        decision: z.ZodOptional<z.ZodEnum<{
+            exclude: "exclude";
+            include: "include";
+            uncertain: "uncertain";
+        }>>;
+        basis: z.ZodOptional<z.ZodEnum<{
+            title: "title";
+            abstract: "abstract";
+            fulltext: "fulltext";
+        }>>;
+        comment: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    finalDecision: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"include">, z.ZodLiteral<"exclude">, z.ZodNull]>>;
+    fulltext: z.ZodOptional<z.ZodObject<{
+        dirName: z.ZodString;
+        hasFiles: z.ZodObject<{
+            pdf: z.ZodBoolean;
+            xml: z.ZodBoolean;
+            html: z.ZodBoolean;
+            markdown: z.ZodBoolean;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const reviewerRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    basis: z.ZodEnum<{
+        title: "title";
+        abstract: "abstract";
+        fulltext: "fulltext";
+    }>;
+}, z.core.$strict>;
+export declare const reviewFileSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    criteria: z.ZodOptional<z.ZodString>;
+    reviewer: z.ZodOptional<z.ZodString>;
+    basis: z.ZodOptional<z.ZodEnum<{
+        title: "title";
+        abstract: "abstract";
+        fulltext: "fulltext";
+    }>>;
+    articles: z.ZodArray<z.ZodObject<{
+        doi: z.ZodOptional<z.ZodString>;
+        pmid: z.ZodOptional<z.ZodString>;
+        scopusId: z.ZodOptional<z.ZodString>;
+        arxivId: z.ZodOptional<z.ZodString>;
+        ericId: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        authors: z.ZodOptional<z.ZodString>;
+        year: z.ZodOptional<z.ZodString>;
+        abstract: z.ZodOptional<z.ZodString>;
+        mergedFrom: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            pmid: z.ZodOptional<z.ZodString>;
+            doi: z.ZodOptional<z.ZodString>;
+            scopusId: z.ZodOptional<z.ZodString>;
+            arxivId: z.ZodOptional<z.ZodString>;
+            ericId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        reviews: z.ZodArray<z.ZodObject<{
+            reviewer: z.ZodString;
+            decision: z.ZodOptional<z.ZodEnum<{
+                exclude: "exclude";
+                include: "include";
+                uncertain: "uncertain";
+            }>>;
+            basis: z.ZodOptional<z.ZodEnum<{
+                title: "title";
+                abstract: "abstract";
+                fulltext: "fulltext";
+            }>>;
+            comment: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        reviewHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            reviewer: z.ZodString;
+            decision: z.ZodOptional<z.ZodEnum<{
+                exclude: "exclude";
+                include: "include";
+                uncertain: "uncertain";
+            }>>;
+            basis: z.ZodOptional<z.ZodEnum<{
+                title: "title";
+                abstract: "abstract";
+                fulltext: "fulltext";
+            }>>;
+            comment: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        finalDecision: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"include">, z.ZodLiteral<"exclude">, z.ZodNull]>>;
+        fulltext: z.ZodOptional<z.ZodObject<{
+            dirName: z.ZodString;
+            hasFiles: z.ZodObject<{
+                pdf: z.ZodBoolean;
+                xml: z.ZodBoolean;
+                html: z.ZodBoolean;
+                markdown: z.ZodBoolean;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    reviewers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        basis: z.ZodEnum<{
+            title: "title";
+            abstract: "abstract";
+            fulltext: "fulltext";
+        }>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/** Generate a JSON Schema from the review file Zod schema. */
+export declare function generateReviewJSONSchema(): Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,eAAO,MAAM,oBAAoB;;;;EAA8C,CAAC;AAEhF,eAAO,MAAM,iBAAiB;;;;EAA4C,CAAC;AAE3E,eAAO,MAAM,YAAY;;;;;;;;;;;;;;kBASyB,CAAC;AAEnD,eAAO,MAAM,kBAAkB;;;;;;;kBAUwB,CAAC;AAExD,eAAO,MAAM,wBAAwB;;;;;;;;kBAY1B,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0ByC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;;;;;;kBAM6C,CAAC;AAE/E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU6B,CAAC;AAE3D,8DAA8D;AAC9D,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIlE"}

package/dist/cli/commands/review/schema.js

@@ -0,0 +1,77 @@
+import * as z from "zod";
+const reviewDecisionSchema = z.enum(["include", "exclude", "uncertain"]);
+const reviewBasisSchema = z.enum(["title", "abstract", "fulltext"]);
+const reviewSchema = z.object({
+  reviewer: z.string().describe("Reviewer identifier (e.g., 'gpt-4o', 'claude-sonnet', 'human:tanaka')"),
+  decision: reviewDecisionSchema.describe("Assessment decision").optional(),
+  basis: reviewBasisSchema.describe("Basis of the decision (what information was used)").optional(),
+  comment: z.string().describe("Optional comment or reason").optional(),
+  timestamp: z.string().datetime().describe("ISO 8601 timestamp").optional()
+}).strict().describe("Individual assessment of an article");
+const mergedSourceSchema = z.object({
+  source: z.string().describe("Database source (e.g., 'pubmed', 'scopus')"),
+  pmid: z.string().optional(),
+  doi: z.string().optional(),
+  scopusId: z.string().optional(),
+  arxivId: z.string().optional(),
+  ericId: z.string().optional()
+}).strict().describe("Source information for merged duplicates");
+const articleFulltextRefSchema = z.object({
+  dirName: z.string(),
+  hasFiles: z.object({
+    pdf: z.boolean(),
+    xml: z.boolean(),
+    html: z.boolean(),
+    markdown: z.boolean()
+  }).strict()
+}).strict();
+const articleEntrySchema = z.object({
+  // Identifiers
+  doi: z.string().describe("Digital Object Identifier").optional(),
+  pmid: z.string().describe("PubMed ID").optional(),
+  scopusId: z.string().describe("Scopus ID").optional(),
+  arxivId: z.string().describe("arXiv ID").optional(),
+  ericId: z.string().describe("ERIC ID").optional(),
+  // Bibliographic info
+  title: z.string().describe("Article title"),
+  authors: z.string().describe("Authors (formatted string)").optional(),
+  year: z.string().describe("Publication year").optional(),
+  abstract: z.string().describe("Article abstract").optional(),
+  // Deduplication tracking
+  mergedFrom: z.array(mergedSourceSchema).describe("Sources this article was merged from during deduplication").optional(),
+  // Review data
+  reviews: z.array(reviewSchema).describe("List of assessments"),
+  reviewHistory: z.array(reviewSchema).describe("Historical reviews (only in extracted ReviewFiles, never in master file)").optional(),
+  finalDecision: z.union([z.literal("include"), z.literal("exclude"), z.null()]).describe("Final inclusion/exclusion decision (null in extracted files)").optional(),
+  // Fulltext reference
+  fulltext: articleFulltextRefSchema.optional()
+}).strict().describe("Article with identifiers, bibliographic info, and reviews");
+const reviewerRecordSchema = z.object({
+  name: z.string().describe("Reviewer identifier"),
+  basis: reviewBasisSchema.describe("Basis level at which the reviewer participated")
+}).strict().describe("Record of a reviewer's participation at a specific basis level");
+const reviewFileSchema = z.object({
+  sessionId: z.string().describe("Session identifier"),
+  criteria: z.string().describe("Path to inclusion criteria file").optional(),
+  reviewer: z.string().describe("Reviewer identifier (only in extracted ReviewFiles)").optional(),
+  basis: reviewBasisSchema.describe("Basis level for screening (only in extracted ReviewFiles)").optional(),
+  articles: z.array(articleEntrySchema).describe("List of articles with review data"),
+  reviewers: z.array(reviewerRecordSchema).describe("Registry of reviewers who participated at each basis level").optional()
+}).strict().describe("Schema for article review workflow tracking");
+function generateReviewJSONSchema() {
+  return z.toJSONSchema(reviewFileSchema, {
+    target: "draft-7"
+  });
+}
+export {
+  articleEntrySchema,
+  articleFulltextRefSchema,
+  generateReviewJSONSchema,
+  mergedSourceSchema,
+  reviewBasisSchema,
+  reviewDecisionSchema,
+  reviewFileSchema,
+  reviewSchema,
+  reviewerRecordSchema
+};
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../../../src/cli/commands/review/schema.ts"],"sourcesContent":["/**\n * Zod schemas for review workflow types.\n *\n * Single source of truth for:\n * - TypeScript types (via z.infer<>)\n * - JSON Schema for IDE autocompletion (via z.toJSONSchema())\n *\n * Follows the pattern established in src/query/json-schema.ts.\n */\nimport * as z from 'zod';\n\nexport const reviewDecisionSchema = z.enum(['include', 'exclude', 'uncertain']);\n\nexport const reviewBasisSchema = z.enum(['title', 'abstract', 'fulltext']);\n\nexport const reviewSchema = z\n  .object({\n    reviewer: z.string().describe(\"Reviewer identifier (e.g., 'gpt-4o', 'claude-sonnet', 'human:tanaka')\"),\n    decision: reviewDecisionSchema.describe('Assessment decision').optional(),\n    basis: reviewBasisSchema.describe('Basis of the decision (what information was used)').optional(),\n    comment: z.string().describe('Optional comment or reason').optional(),\n    timestamp: z.string().datetime().describe('ISO 8601 timestamp').optional(),\n  })\n  .strict()\n  .describe('Individual assessment of an article');\n\nexport const mergedSourceSchema = z\n  .object({\n    source: z.string().describe(\"Database source (e.g., 'pubmed', 'scopus')\"),\n    pmid: z.string().optional(),\n    doi: z.string().optional(),\n    scopusId: z.string().optional(),\n    arxivId: z.string().optional(),\n    ericId: z.string().optional(),\n  })\n  .strict()\n  .describe('Source information for merged duplicates');\n\nexport const articleFulltextRefSchema = z\n  .object({\n    dirName: z.string(),\n    hasFiles: z\n      .object({\n        pdf: z.boolean(),\n        xml: z.boolean(),\n        html: z.boolean(),\n        markdown: z.boolean(),\n      })\n      .strict(),\n  })\n  .strict();\n\nexport const articleEntrySchema = z\n  .object({\n    // Identifiers\n    doi: z.string().describe('Digital Object Identifier').optional(),\n    pmid: z.string().describe('PubMed ID').optional(),\n    scopusId: z.string().describe('Scopus ID').optional(),\n    arxivId: z.string().describe('arXiv ID').optional(),\n    ericId: z.string().describe('ERIC ID').optional(),\n    // Bibliographic info\n    title: z.string().describe('Article title'),\n    authors: z.string().describe('Authors (formatted string)').optional(),\n    year: z.string().describe('Publication year').optional(),\n    abstract: z.string().describe('Article abstract').optional(),\n    // Deduplication tracking\n    mergedFrom: z.array(mergedSourceSchema).describe('Sources this article was merged from during deduplication').optional(),\n    // Review data\n    reviews: z.array(reviewSchema).describe('List of assessments'),\n    reviewHistory: z.array(reviewSchema).describe('Historical reviews (only in extracted ReviewFiles, never in master file)').optional(),\n    finalDecision: z\n      .union([z.literal('include'), z.literal('exclude'), z.null()])\n      .describe('Final inclusion/exclusion decision (null in extracted files)')\n      .optional(),\n    // Fulltext reference\n    fulltext: articleFulltextRefSchema.optional(),\n  })\n  .strict()\n  .describe('Article with identifiers, bibliographic info, and reviews');\n\nexport const reviewerRecordSchema = z\n  .object({\n    name: z.string().describe('Reviewer identifier'),\n    basis: reviewBasisSchema.describe('Basis level at which the reviewer participated'),\n  })\n  .strict()\n  .describe('Record of a reviewer\\'s participation at a specific basis level');\n\nexport const reviewFileSchema = z\n  .object({\n    sessionId: z.string().describe('Session identifier'),\n    criteria: z.string().describe('Path to inclusion criteria file').optional(),\n    reviewer: z.string().describe('Reviewer identifier (only in extracted ReviewFiles)').optional(),\n    basis: reviewBasisSchema.describe('Basis level for screening (only in extracted ReviewFiles)').optional(),\n    articles: z.array(articleEntrySchema).describe('List of articles with review data'),\n    reviewers: z.array(reviewerRecordSchema).describe('Registry of reviewers who participated at each basis level').optional(),\n  })\n  .strict()\n  .describe('Schema for article review workflow tracking');\n\n/** Generate a JSON Schema from the review file Zod schema. */\nexport function generateReviewJSONSchema(): Record<string, unknown> {\n  return z.toJSONSchema(reviewFileSchema, {\n    target: 'draft-7',\n  });\n}\n"],"names":[],"mappings":"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"}

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

@@ -7,10 +7,10 @@ export interface ReviewStatusResult {
     total: number;
     pending: number;
     incomplete: number;
-    uncertain: number;
+    allUncertain: number;
     agreedInclude: number;
     agreedExclude: number;
-    conflicting: number;
+    divided: number;
     finalized: number;
     included: number;
     excluded: number;

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAmC,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAWD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAwD7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuBrE"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAmC,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAWD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAwD7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuBrE"}

package/dist/cli/commands/review/status.js

@@ -14,10 +14,10 @@ async function executeReviewStatus(options, sessionsDir) {
   const counts = {
     pending: 0,
     incomplete: 0,
-    uncertain: 0,
+    allUncertain: 0,
     agreedInclude: 0,
     agreedExclude: 0,
-    conflicting: 0,
+    divided: 0,
     finalized: 0,
     included: 0,
     excluded: 0
@@ -31,8 +31,8 @@ async function executeReviewStatus(options, sessionsDir) {
       case "incomplete":
         counts.incomplete++;
         break;
-      case "uncertain":
-        counts.uncertain++;
+      case "all-uncertain":
+        counts.allUncertain++;
         break;
       case "agreed-include":
         counts.agreedInclude++;
@@ -40,8 +40,8 @@ async function executeReviewStatus(options, sessionsDir) {
       case "agreed-exclude":
         counts.agreedExclude++;
         break;
-      case "conflicting":
-        counts.conflicting++;
+      case "divided":
+        counts.divided++;
         break;
       case "finalized":
         counts.finalized++;
@@ -65,13 +65,13 @@ function formatStatusOutput(result) {
   const agreed = result.agreedInclude + result.agreedExclude;
   const lines = [
     `Review Progress: ${id}`,
-    `  Total:         ${result.total}`,
-    `  Pending:       ${result.pending}`,
-    `  Incomplete:    ${result.incomplete}`,
-    `  Uncertain:     ${result.uncertain}`,
-    `  Agreed:        ${agreed}  (include: ${result.agreedInclude}, exclude: ${result.agreedExclude})`,
-    `  Conflicting:   ${result.conflicting}`,
-    `  Finalized:     ${result.finalized}  (include: ${result.included}, exclude: ${result.excluded})`
+    `  Total:           ${result.total}`,
+    `  Pending:         ${result.pending}`,
+    `  Incomplete:      ${result.incomplete}`,
+    `  All-uncertain:   ${result.allUncertain}`,
+    `  Agreed:          ${agreed}  (include: ${result.agreedInclude}, exclude: ${result.agreedExclude})`,
+    `  Divided:         ${result.divided}`,
+    `  Finalized:       ${result.finalized}  (include: ${result.included}, exclude: ${result.excluded})`
   ];
   if (result.reviewers.length > 0) {
     lines.push("");

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

@@ -1 +1 @@
-{"version":3,"file":"status.js","sources":["../../../../src/cli/commands/review/status.ts"],"sourcesContent":["/**\n * review status command - Show review progress summary\n */\n\nimport { join } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport { parse as parseYaml } from 'yaml';\nimport { classifyStatus, type ReviewFile, type ReviewerRecord } from './types.js';\n\nexport interface ReviewStatusOptions {\n  sessionId: string;\n}\n\nexport interface ReviewStatusResult {\n  sessionId: string;\n  total: number;\n  pending: number;\n  incomplete: number;\n  uncertain: number;\n  agreedInclude: number;\n  agreedExclude: number;\n  conflicting: number;\n  finalized: number;\n  included: number;\n  excluded: number;\n  /** Registered reviewers from the review file */\n  reviewers: ReviewerRecord[];\n}\n\n/**\n * Load review file from session directory\n */\nasync function loadReviewFile(sessionDir: string): Promise<ReviewFile> {\n  const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  return parseYaml(content) as ReviewFile;\n}\n\n/**\n * Execute review status command\n */\nexport async function executeReviewStatus(\n  options: ReviewStatusOptions,\n  sessionsDir: string\n): Promise<ReviewStatusResult> {\n  const sessionDir = join(sessionsDir, options.sessionId);\n  const reviewFile = await loadReviewFile(sessionDir);\n\n  const reviewers = reviewFile.reviewers ?? [];\n  const counts = {\n    pending: 0,\n    incomplete: 0,\n    uncertain: 0,\n    agreedInclude: 0,\n    agreedExclude: 0,\n    conflicting: 0,\n    finalized: 0,\n    included: 0,\n    excluded: 0,\n  };\n\n  for (const article of reviewFile.articles) {\n    const status = classifyStatus(article, reviewers);\n\n    switch (status) {\n      case 'pending':\n        counts.pending++;\n        break;\n      case 'incomplete':\n        counts.incomplete++;\n        break;\n      case 'uncertain':\n        counts.uncertain++;\n        break;\n      case 'agreed-include':\n        counts.agreedInclude++;\n        break;\n      case 'agreed-exclude':\n        counts.agreedExclude++;\n        break;\n      case 'conflicting':\n        counts.conflicting++;\n        break;\n      case 'finalized':\n        counts.finalized++;\n        if (article.finalDecision === 'include') {\n          counts.included++;\n        } else {\n          counts.excluded++;\n        }\n        break;\n    }\n  }\n\n  return {\n    sessionId: options.sessionId,\n    total: reviewFile.articles.length,\n    reviewers,\n    ...counts,\n  };\n}\n\n/**\n * Format status result as human-readable string\n */\nexport function formatStatusOutput(result: ReviewStatusResult): string {\n  const id = result.sessionId;\n  const agreed = result.agreedInclude + result.agreedExclude;\n  const lines = [\n    `Review Progress: ${id}`,\n    `  Total:         ${result.total}`,\n    `  Pending:       ${result.pending}`,\n    `  Incomplete:    ${result.incomplete}`,\n    `  Uncertain:     ${result.uncertain}`,\n    `  Agreed:        ${agreed}  (include: ${result.agreedInclude}, exclude: ${result.agreedExclude})`,\n    `  Conflicting:   ${result.conflicting}`,\n    `  Finalized:     ${result.finalized}  (include: ${result.included}, exclude: ${result.excluded})`,\n  ];\n\n  if (result.reviewers.length > 0) {\n    lines.push('');\n    lines.push('Reviewers:');\n    for (const r of result.reviewers) {\n      lines.push(`  ${r.name}  (${r.basis})`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"names":["parseYaml"],"mappings":";;;;AAgCA,eAAe,eAAe,YAAyC;AACrE,QAAM,cAAc,KAAK,YAAY,aAAa,cAAc;AAChE,QAAM,UAAU,MAAM,SAAS,aAAa,OAAO;AACnD,SAAOA,MAAU,OAAO;AAC1B;AAKA,eAAsB,oBACpB,SACA,aAC6B;AAC7B,QAAM,aAAa,KAAK,aAAa,QAAQ,SAAS;AACtD,QAAM,aAAa,MAAM,eAAe,UAAU;AAElD,QAAM,YAAY,WAAW,aAAa,CAAA;AAC1C,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,eAAe;AAAA,IACf,eAAe;AAAA,IACf,aAAa;AAAA,IACb,WAAW;AAAA,IACX,UAAU;AAAA,IACV,UAAU;AAAA,EAAA;AAGZ,aAAW,WAAW,WAAW,UAAU;AACzC,UAAM,SAAS,eAAe,SAAS,SAAS;AAEhD,YAAQ,QAAA;AAAA,MACN,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP,YAAI,QAAQ,kBAAkB,WAAW;AACvC,iBAAO;AAAA,QACT,OAAO;AACL,iBAAO;AAAA,QACT;AACA;AAAA,IAAA;AAAA,EAEN;AAEA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,OAAO,WAAW,SAAS;AAAA,IAC3B;AAAA,IACA,GAAG;AAAA,EAAA;AAEP;AAKO,SAAS,mBAAmB,QAAoC;AACrE,QAAM,KAAK,OAAO;AAClB,QAAM,SAAS,OAAO,gBAAgB,OAAO;AAC7C,QAAM,QAAQ;AAAA,IACZ,oBAAoB,EAAE;AAAA,IACtB,oBAAoB,OAAO,KAAK;AAAA,IAChC,oBAAoB,OAAO,OAAO;AAAA,IAClC,oBAAoB,OAAO,UAAU;AAAA,IACrC,oBAAoB,OAAO,SAAS;AAAA,IACpC,oBAAoB,MAAM,eAAe,OAAO,aAAa,cAAc,OAAO,aAAa;AAAA,IAC/F,oBAAoB,OAAO,WAAW;AAAA,IACtC,oBAAoB,OAAO,SAAS,eAAe,OAAO,QAAQ,cAAc,OAAO,QAAQ;AAAA,EAAA;AAGjG,MAAI,OAAO,UAAU,SAAS,GAAG;AAC/B,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,YAAY;AACvB,eAAW,KAAK,OAAO,WAAW;AAChC,YAAM,KAAK,KAAK,EAAE,IAAI,MAAM,EAAE,KAAK,GAAG;AAAA,IACxC;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;"}
+{"version":3,"file":"status.js","sources":["../../../../src/cli/commands/review/status.ts"],"sourcesContent":["/**\n * review status command - Show review progress summary\n */\n\nimport { join } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport { parse as parseYaml } from 'yaml';\nimport { classifyStatus, type ReviewFile, type ReviewerRecord } from './types.js';\n\nexport interface ReviewStatusOptions {\n  sessionId: string;\n}\n\nexport interface ReviewStatusResult {\n  sessionId: string;\n  total: number;\n  pending: number;\n  incomplete: number;\n  allUncertain: number;\n  agreedInclude: number;\n  agreedExclude: number;\n  divided: number;\n  finalized: number;\n  included: number;\n  excluded: number;\n  /** Registered reviewers from the review file */\n  reviewers: ReviewerRecord[];\n}\n\n/**\n * Load review file from session directory\n */\nasync function loadReviewFile(sessionDir: string): Promise<ReviewFile> {\n  const reviewsPath = join(sessionDir, '.internal', 'reviews.yaml');\n  const content = await readFile(reviewsPath, 'utf-8');\n  return parseYaml(content) as ReviewFile;\n}\n\n/**\n * Execute review status command\n */\nexport async function executeReviewStatus(\n  options: ReviewStatusOptions,\n  sessionsDir: string\n): Promise<ReviewStatusResult> {\n  const sessionDir = join(sessionsDir, options.sessionId);\n  const reviewFile = await loadReviewFile(sessionDir);\n\n  const reviewers = reviewFile.reviewers ?? [];\n  const counts = {\n    pending: 0,\n    incomplete: 0,\n    allUncertain: 0,\n    agreedInclude: 0,\n    agreedExclude: 0,\n    divided: 0,\n    finalized: 0,\n    included: 0,\n    excluded: 0,\n  };\n\n  for (const article of reviewFile.articles) {\n    const status = classifyStatus(article, reviewers);\n\n    switch (status) {\n      case 'pending':\n        counts.pending++;\n        break;\n      case 'incomplete':\n        counts.incomplete++;\n        break;\n      case 'all-uncertain':\n        counts.allUncertain++;\n        break;\n      case 'agreed-include':\n        counts.agreedInclude++;\n        break;\n      case 'agreed-exclude':\n        counts.agreedExclude++;\n        break;\n      case 'divided':\n        counts.divided++;\n        break;\n      case 'finalized':\n        counts.finalized++;\n        if (article.finalDecision === 'include') {\n          counts.included++;\n        } else {\n          counts.excluded++;\n        }\n        break;\n    }\n  }\n\n  return {\n    sessionId: options.sessionId,\n    total: reviewFile.articles.length,\n    reviewers,\n    ...counts,\n  };\n}\n\n/**\n * Format status result as human-readable string\n */\nexport function formatStatusOutput(result: ReviewStatusResult): string {\n  const id = result.sessionId;\n  const agreed = result.agreedInclude + result.agreedExclude;\n  const lines = [\n    `Review Progress: ${id}`,\n    `  Total:           ${result.total}`,\n    `  Pending:         ${result.pending}`,\n    `  Incomplete:      ${result.incomplete}`,\n    `  All-uncertain:   ${result.allUncertain}`,\n    `  Agreed:          ${agreed}  (include: ${result.agreedInclude}, exclude: ${result.agreedExclude})`,\n    `  Divided:         ${result.divided}`,\n    `  Finalized:       ${result.finalized}  (include: ${result.included}, exclude: ${result.excluded})`,\n  ];\n\n  if (result.reviewers.length > 0) {\n    lines.push('');\n    lines.push('Reviewers:');\n    for (const r of result.reviewers) {\n      lines.push(`  ${r.name}  (${r.basis})`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"names":["parseYaml"],"mappings":";;;;AAgCA,eAAe,eAAe,YAAyC;AACrE,QAAM,cAAc,KAAK,YAAY,aAAa,cAAc;AAChE,QAAM,UAAU,MAAM,SAAS,aAAa,OAAO;AACnD,SAAOA,MAAU,OAAO;AAC1B;AAKA,eAAsB,oBACpB,SACA,aAC6B;AAC7B,QAAM,aAAa,KAAK,aAAa,QAAQ,SAAS;AACtD,QAAM,aAAa,MAAM,eAAe,UAAU;AAElD,QAAM,YAAY,WAAW,aAAa,CAAA;AAC1C,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,eAAe;AAAA,IACf,eAAe;AAAA,IACf,SAAS;AAAA,IACT,WAAW;AAAA,IACX,UAAU;AAAA,IACV,UAAU;AAAA,EAAA;AAGZ,aAAW,WAAW,WAAW,UAAU;AACzC,UAAM,SAAS,eAAe,SAAS,SAAS;AAEhD,YAAQ,QAAA;AAAA,MACN,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP;AAAA,MACF,KAAK;AACH,eAAO;AACP,YAAI,QAAQ,kBAAkB,WAAW;AACvC,iBAAO;AAAA,QACT,OAAO;AACL,iBAAO;AAAA,QACT;AACA;AAAA,IAAA;AAAA,EAEN;AAEA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,OAAO,WAAW,SAAS;AAAA,IAC3B;AAAA,IACA,GAAG;AAAA,EAAA;AAEP;AAKO,SAAS,mBAAmB,QAAoC;AACrE,QAAM,KAAK,OAAO;AAClB,QAAM,SAAS,OAAO,gBAAgB,OAAO;AAC7C,QAAM,QAAQ;AAAA,IACZ,oBAAoB,EAAE;AAAA,IACtB,sBAAsB,OAAO,KAAK;AAAA,IAClC,sBAAsB,OAAO,OAAO;AAAA,IACpC,sBAAsB,OAAO,UAAU;AAAA,IACvC,sBAAsB,OAAO,YAAY;AAAA,IACzC,sBAAsB,MAAM,eAAe,OAAO,aAAa,cAAc,OAAO,aAAa;AAAA,IACjG,sBAAsB,OAAO,OAAO;AAAA,IACpC,sBAAsB,OAAO,SAAS,eAAe,OAAO,QAAQ,cAAc,OAAO,QAAQ;AAAA,EAAA;AAGnG,MAAI,OAAO,UAAU,SAAS,GAAG;AAC/B,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,YAAY;AACvB,eAAW,KAAK,OAAO,WAAW;AAChC,YAAM,KAAK,KAAK,EAAE,IAAI,MAAM,EAAE,KAAK,GAAG;AAAA,IACxC;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;"}

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

@@ -1,74 +1,19 @@
-import { ArticleFulltextRef } from '@ncukondo/academic-fulltext';
-export type ReviewDecision = 'include' | 'exclude' | 'uncertain';
+import { reviewDecisionSchema, reviewBasisSchema, reviewSchema, mergedSourceSchema, articleEntrySchema, reviewerRecordSchema, reviewFileSchema } from './schema.js';
 /**
- * Basis of the review decision (what information was used)
- */
-export type ReviewBasis = 'title' | 'abstract' | 'fulltext';
-/**
- * Individual assessment of an article by a reviewer
- */
-export interface Review {
-    /** Reviewer identifier: "human:name" or "ai:name" */
-    reviewer: string;
-    /** Assessment decision */
-    decision?: ReviewDecision;
-    /** Basis of the decision (what information was used) */
-    basis?: ReviewBasis;
-    /** Optional comment or reason */
-    comment?: string;
-    /** ISO 8601 timestamp (optional - auto-assigned on merge if not provided) */
-    timestamp?: string;
-}
-/**
- * Source information for merged duplicates
- */
-export interface MergedSource {
-    source: string;
-    pmid?: string;
-    doi?: string;
-    scopusId?: string;
-    arxivId?: string;
-    ericId?: string;
-}
-/**
- * Article entry with identifiers, bibliographic info, and reviews
- */
-export interface ArticleEntry {
-    doi?: string;
-    pmid?: string;
-    scopusId?: string;
-    arxivId?: string;
-    ericId?: string;
-    title: string;
-    authors?: string;
-    year?: string;
-    abstract?: string;
-    mergedFrom?: MergedSource[];
-    reviews: Review[];
-    /** Historical reviews (only in extracted ReviewFiles, never in master file) */
-    reviewHistory?: Review[];
-    finalDecision?: 'include' | 'exclude' | null;
-    fulltext?: ArticleFulltextRef;
-}
-/**
- * Top-level structure of the reviews.yaml file
- */
-export interface ReviewerRecord {
-    name: string;
-    basis: ReviewBasis;
-}
-export interface ReviewFile {
-    sessionId: string;
-    /** Path to inclusion criteria file */
-    criteria?: string;
-    /** Reviewer identifier (only in extracted ReviewFiles) */
-    reviewer?: string;
-    /** Basis level for screening (only in extracted ReviewFiles) */
-    basis?: ReviewBasis;
-    articles: ArticleEntry[];
-    /** Registry of reviewers who participated at each basis level */
-    reviewers?: ReviewerRecord[];
-}
+ * Review workflow types for article assessment tracking.
+ *
+ * Core data types (ReviewDecision, ReviewBasis, Review, MergedSource,
+ * ArticleEntry, ReviewerRecord, ReviewFile) are derived from Zod schemas
+ * in schema.ts — single source of truth for types and JSON Schema.
+ */
+import * as z from 'zod';
+export type ReviewDecision = z.infer<typeof reviewDecisionSchema>;
+export type ReviewBasis = z.infer<typeof reviewBasisSchema>;
+export type Review = z.infer<typeof reviewSchema>;
+export type MergedSource = z.infer<typeof mergedSourceSchema>;
+export type ArticleEntry = z.infer<typeof articleEntrySchema>;
+export type ReviewerRecord = z.infer<typeof reviewerRecordSchema>;
+export type ReviewFile = z.infer<typeof reviewFileSchema>;
 /**
  * Work file article entry for AI agent workflow
  */
@@ -96,7 +41,7 @@ export declare function basisRank(basis: ReviewBasis | undefined): number;
 /**
  * Review status classification (7-state model)
  */
-export type ReviewStatus = 'pending' | 'incomplete' | 'uncertain' | 'agreed-include' | 'agreed-exclude' | 'conflicting' | 'finalized';
+export type ReviewStatus = 'pending' | 'incomplete' | 'all-uncertain' | 'agreed-include' | 'agreed-exclude' | 'divided' | 'finalized';
 /**
  * Classify the review status of an article entry
  *
@@ -104,10 +49,10 @@ export type ReviewStatus = 'pending' | 'incomplete' | 'uncertain' | 'agreed-incl
  * 1. finalDecision set?           → finalized
  * 2. No reviews?                  → pending
  * 3. Registered reviewer missing? → incomplete
- * 4. include AND exclude present? → conflicting
- * 5. Any uncertain?               → uncertain
- * 6. All include?                 → agreed-include
- * 7. All exclude?                 → agreed-exclude
+ * 4. All uncertain?               → all-uncertain
+ * 5. All include?                 → agreed-include
+ * 6. All exclude?                 → agreed-exclude
+ * 7. Any mix of decisions?        → divided
  */
 export declare function classifyStatus(entry: ArticleEntry, registeredReviewers?: ReviewerRecord[]): ReviewStatus;
 //# sourceMappingURL=types.d.ts.map

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":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,mGAAmG;AACnG,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAWD,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAGhE;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,GACT,WAAW,CAAC;AAEhB;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,EACnB,mBAAmB,CAAC,EAAE,cAAc,EAAE,GACrC,YAAY,CAmHd"}