@ncukondo/search-hub 0.17.0 → 0.18.0

package/dist/cli/commands/query/assess.d.ts

@@ -0,0 +1,15 @@
+export interface AssessOptions {
+    verdict?: string | undefined;
+    precision?: string | undefined;
+    comment?: string | undefined;
+}
+export interface AssessResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Execute the query assess command.
+ * Validates inputs and appends an assessment entry to the log.
+ */
+export declare function executeQueryAssess(queryFile: string, options: AssessOptions): Promise<AssessResult>;
+//# sourceMappingURL=assess.d.ts.map

package/dist/cli/commands/query/assess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assess.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/assess.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAqCvB"}

package/dist/cli/commands/query/assess.js

@@ -0,0 +1,38 @@
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { formatTimestamp, appendLogEntry } from "./iteration-log.js";
+async function executeQueryAssess(queryFile, options) {
+  if (!options.verdict && !options.precision && !options.comment) {
+    return {
+      success: false,
+      error: "At least one of --verdict, --precision, or --comment is required"
+    };
+  }
+  try {
+    await access(queryFile, constants.R_OK);
+  } catch {
+    return {
+      success: false,
+      error: `Query file not found: ${queryFile}`
+    };
+  }
+  const entry = {
+    date: formatTimestamp(),
+    type: "assessment"
+  };
+  if (options.verdict !== void 0) {
+    entry.verdict = options.verdict;
+  }
+  if (options.precision !== void 0) {
+    entry.precision = options.precision;
+  }
+  if (options.comment !== void 0) {
+    entry.comment = options.comment;
+  }
+  await appendLogEntry(queryFile, entry);
+  return { success: true };
+}
+export {
+  executeQueryAssess
+};
+//# sourceMappingURL=assess.js.map

package/dist/cli/commands/query/assess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assess.js","sources":["../../../../src/cli/commands/query/assess.ts"],"sourcesContent":["/**\n * Query Assess Command\n *\n * Records a structured assessment of the current query iteration\n * to the search iteration log.\n */\nimport { access } from 'node:fs/promises';\nimport { constants } from 'node:fs';\nimport {\n  appendLogEntry,\n  formatTimestamp,\n  type AssessmentLogEntry,\n} from './iteration-log.js';\n\nexport interface AssessOptions {\n  verdict?: string | undefined;\n  precision?: string | undefined;\n  comment?: string | undefined;\n}\n\nexport interface AssessResult {\n  success: boolean;\n  error?: string;\n}\n\n/**\n * Execute the query assess command.\n * Validates inputs and appends an assessment entry to the log.\n */\nexport async function executeQueryAssess(\n  queryFile: string,\n  options: AssessOptions,\n): Promise<AssessResult> {\n  // Validate at least one option is provided\n  if (!options.verdict && !options.precision && !options.comment) {\n    return {\n      success: false,\n      error: 'At least one of --verdict, --precision, or --comment is required',\n    };\n  }\n\n  // Validate query file exists\n  try {\n    await access(queryFile, constants.R_OK);\n  } catch {\n    return {\n      success: false,\n      error: `Query file not found: ${queryFile}`,\n    };\n  }\n\n  const entry: AssessmentLogEntry = {\n    date: formatTimestamp(),\n    type: 'assessment',\n  };\n\n  if (options.verdict !== undefined) {\n    entry.verdict = options.verdict;\n  }\n  if (options.precision !== undefined) {\n    entry.precision = options.precision;\n  }\n  if (options.comment !== undefined) {\n    entry.comment = options.comment;\n  }\n\n  await appendLogEntry(queryFile, entry);\n\n  return { success: true };\n}\n"],"names":[],"mappings":";;;AA6BA,eAAsB,mBACpB,WACA,SACuB;AAEvB,MAAI,CAAC,QAAQ,WAAW,CAAC,QAAQ,aAAa,CAAC,QAAQ,SAAS;AAC9D,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,IAAA;AAAA,EAEX;AAGA,MAAI;AACF,UAAM,OAAO,WAAW,UAAU,IAAI;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,yBAAyB,SAAS;AAAA,IAAA;AAAA,EAE7C;AAEA,QAAM,QAA4B;AAAA,IAChC,MAAM,gBAAA;AAAA,IACN,MAAM;AAAA,EAAA;AAGR,MAAI,QAAQ,YAAY,QAAW;AACjC,UAAM,UAAU,QAAQ;AAAA,EAC1B;AACA,MAAI,QAAQ,cAAc,QAAW;AACnC,UAAM,YAAY,QAAQ;AAAA,EAC5B;AACA,MAAI,QAAQ,YAAY,QAAW;AACjC,UAAM,UAAU,QAAQ;AAAA,EAC1B;AAEA,QAAM,eAAe,WAAW,KAAK;AAErC,SAAO,EAAE,SAAS,KAAA;AACpB;"}

package/dist/cli/commands/query/iteration-log.d.ts

@@ -0,0 +1,58 @@
+import { CountResult, PreviewResult } from '../search.js';
+export interface CountLogEntry {
+    date: string;
+    type: 'count';
+    query_hash: string;
+    counts: Record<string, number>;
+    total: number;
+}
+export interface PreviewLogEntry {
+    date: string;
+    type: 'preview';
+    query_hash: string;
+    counts: Record<string, number>;
+    total: number;
+    titles: Record<string, string[]>;
+}
+export interface AssessmentLogEntry {
+    date: string;
+    type: 'assessment';
+    verdict?: string;
+    precision?: string;
+    comment?: string;
+}
+export type LogEntry = CountLogEntry | PreviewLogEntry | AssessmentLogEntry;
+/**
+ * Derive the log file path from a query file path.
+ * `{dir}/{basename}.yaml` → `{dir}/{basename}.search-log.yaml`
+ */
+export declare function getLogFilePath(queryFilePath: string): string;
+/**
+ * Generate a timestamp in "YYYY-MM-DD HH:mm" format.
+ */
+export declare function formatTimestamp(date?: Date): string;
+/**
+ * Compute a short hash of the query file content.
+ * Uses the same algorithm as session creation (SHA-256, first 8 hex chars).
+ */
+export declare function computeQueryHash(queryContent: string): string;
+/**
+ * Build a CountLogEntry from count-only results.
+ */
+export declare function buildCountLogEntry(queryHash: string, results: CountResult[]): CountLogEntry;
+/**
+ * Build a PreviewLogEntry from preview results.
+ * Stores at most `maxTitles` titles per provider to avoid log bloat.
+ */
+export declare function buildPreviewLogEntry(queryHash: string, results: PreviewResult[], maxTitles?: number): PreviewLogEntry;
+/**
+ * Read log entries from the iteration log file for a given query file.
+ * Returns an empty array when the log file does not exist or is empty.
+ */
+export declare function readLogEntries(queryFilePath: string): Promise<LogEntry[]>;
+/**
+ * Append a log entry to the iteration log file.
+ * Creates the file with a header comment if it does not exist.
+ */
+export declare function appendLogEntry(queryFilePath: string, entry: LogEntry): Promise<void>;
+//# sourceMappingURL=iteration-log.d.ts.map

package/dist/cli/commands/query/iteration-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-log.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/iteration-log.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI/D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAI5E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAO/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EAAE,GACrB,aAAa,CAgBf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,SAAI,GACZ,eAAe,CAqBjB;AAmBD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2B/E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/cli/commands/query/iteration-log.js

@@ -0,0 +1,115 @@
+import { writeFile, readFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import { basename, dirname, join } from "node:path";
+import { parse, stringify } from "yaml";
+function getLogFilePath(queryFilePath) {
+  const dir = dirname(queryFilePath);
+  const base = basename(queryFilePath).replace(/\.ya?ml$/, "");
+  const logName = `${base}.search-log.yaml`;
+  return dir === "." ? logName : join(dir, logName);
+}
+function formatTimestamp(date = /* @__PURE__ */ new Date()) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+function computeQueryHash(queryContent) {
+  return createHash("sha256").update(queryContent).digest("hex").slice(0, 8);
+}
+function buildCountLogEntry(queryHash, results) {
+  const counts = {};
+  let total = 0;
+  for (const r of results) {
+    if (!r.error) {
+      counts[r.provider] = r.count;
+      total += r.count;
+    }
+  }
+  return {
+    date: formatTimestamp(),
+    type: "count",
+    query_hash: queryHash,
+    counts,
+    total
+  };
+}
+function buildPreviewLogEntry(queryHash, results, maxTitles = 5) {
+  const counts = {};
+  const titles = {};
+  let total = 0;
+  for (const r of results) {
+    if (!r.error) {
+      counts[r.provider] = r.count;
+      total += r.count;
+      if (r.titles.length > 0) {
+        titles[r.provider] = r.titles.slice(0, maxTitles);
+      }
+    }
+  }
+  return {
+    date: formatTimestamp(),
+    type: "preview",
+    query_hash: queryHash,
+    counts,
+    total,
+    titles
+  };
+}
+async function readRawLog(logPath) {
+  try {
+    return await readFile(logPath, "utf-8");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+}
+async function readLogEntries(queryFilePath) {
+  const logPath = getLogFilePath(queryFilePath);
+  const content = await readRawLog(logPath);
+  if (content === null || !content.trim()) {
+    return [];
+  }
+  const parsed = parse(content);
+  if (parsed === null || parsed === void 0) {
+    return [];
+  }
+  if (!Array.isArray(parsed)) {
+    return [];
+  }
+  return parsed.filter(
+    (entry) => entry !== null && typeof entry === "object" && typeof entry.type === "string" && ["count", "preview", "assessment"].includes(entry.type)
+  );
+}
+async function appendLogEntry(queryFilePath, entry) {
+  const logPath = getLogFilePath(queryFilePath);
+  const queryBasename = basename(queryFilePath);
+  const existing = await readRawLog(logPath);
+  const entryYaml = stringify([entry], { lineWidth: 0 }).trimEnd();
+  let content;
+  if (existing === null) {
+    const header = `# Search iteration log for ${queryBasename}
+# Auto-generated by search-hub. You can also edit this file manually.
+
+`;
+    content = header + entryYaml + "\n";
+  } else {
+    const trimmed = existing.trimEnd();
+    content = trimmed + "\n\n" + entryYaml + "\n";
+  }
+  await writeFile(logPath, content, "utf-8");
+}
+export {
+  appendLogEntry,
+  buildCountLogEntry,
+  buildPreviewLogEntry,
+  computeQueryHash,
+  formatTimestamp,
+  getLogFilePath,
+  readLogEntries
+};
+//# sourceMappingURL=iteration-log.js.map

package/dist/cli/commands/query/iteration-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iteration-log.js","sources":["../../../../src/cli/commands/query/iteration-log.ts"],"sourcesContent":["/**\n * Query iteration log I/O.\n *\n * Reads and appends entries to a search iteration log file\n * that lives alongside the query YAML file.\n */\nimport { readFile, writeFile } from 'node:fs/promises';\nimport { createHash } from 'node:crypto';\nimport { basename, dirname, join } from 'node:path';\nimport { parse, stringify } from 'yaml';\nimport type { CountResult, PreviewResult } from '../search.js';\n\n// ── Types ───────────────────────────────────────────────────────────\n\nexport interface CountLogEntry {\n  date: string;\n  type: 'count';\n  query_hash: string;\n  counts: Record<string, number>;\n  total: number;\n}\n\nexport interface PreviewLogEntry {\n  date: string;\n  type: 'preview';\n  query_hash: string;\n  counts: Record<string, number>;\n  total: number;\n  titles: Record<string, string[]>;\n}\n\nexport interface AssessmentLogEntry {\n  date: string;\n  type: 'assessment';\n  verdict?: string;\n  precision?: string;\n  comment?: string;\n}\n\nexport type LogEntry = CountLogEntry | PreviewLogEntry | AssessmentLogEntry;\n\n// ── Helpers ─────────────────────────────────────────────────────────\n\n/**\n * Derive the log file path from a query file path.\n * `{dir}/{basename}.yaml` → `{dir}/{basename}.search-log.yaml`\n */\nexport function getLogFilePath(queryFilePath: string): string {\n  const dir = dirname(queryFilePath);\n  const base = basename(queryFilePath).replace(/\\.ya?ml$/, '');\n  const logName = `${base}.search-log.yaml`;\n  return dir === '.' ? logName : join(dir, logName);\n}\n\n/**\n * Generate a timestamp in \"YYYY-MM-DD HH:mm\" format.\n */\nexport function formatTimestamp(date: Date = new Date()): string {\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n  const hours = String(date.getHours()).padStart(2, '0');\n  const minutes = String(date.getMinutes()).padStart(2, '0');\n  return `${year}-${month}-${day} ${hours}:${minutes}`;\n}\n\n/**\n * Compute a short hash of the query file content.\n * Uses the same algorithm as session creation (SHA-256, first 8 hex chars).\n */\nexport function computeQueryHash(queryContent: string): string {\n  return createHash('sha256').update(queryContent).digest('hex').slice(0, 8);\n}\n\n/**\n * Build a CountLogEntry from count-only results.\n */\nexport function buildCountLogEntry(\n  queryHash: string,\n  results: CountResult[],\n): CountLogEntry {\n  const counts: Record<string, number> = {};\n  let total = 0;\n  for (const r of results) {\n    if (!r.error) {\n      counts[r.provider] = r.count;\n      total += r.count;\n    }\n  }\n  return {\n    date: formatTimestamp(),\n    type: 'count',\n    query_hash: queryHash,\n    counts,\n    total,\n  };\n}\n\n/**\n * Build a PreviewLogEntry from preview results.\n * Stores at most `maxTitles` titles per provider to avoid log bloat.\n */\nexport function buildPreviewLogEntry(\n  queryHash: string,\n  results: PreviewResult[],\n  maxTitles = 5,\n): PreviewLogEntry {\n  const counts: Record<string, number> = {};\n  const titles: Record<string, string[]> = {};\n  let total = 0;\n  for (const r of results) {\n    if (!r.error) {\n      counts[r.provider] = r.count;\n      total += r.count;\n      if (r.titles.length > 0) {\n        titles[r.provider] = r.titles.slice(0, maxTitles);\n      }\n    }\n  }\n  return {\n    date: formatTimestamp(),\n    type: 'preview',\n    query_hash: queryHash,\n    counts,\n    total,\n    titles,\n  };\n}\n\n// ── Read / Write ────────────────────────────────────────────────────\n\n/**\n * Read raw content of the log file, preserving comments.\n * Returns null when the file does not exist.\n */\nasync function readRawLog(logPath: string): Promise<string | null> {\n  try {\n    return await readFile(logPath, 'utf-8');\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n      return null;\n    }\n    throw error;\n  }\n}\n\n/**\n * Read log entries from the iteration log file for a given query file.\n * Returns an empty array when the log file does not exist or is empty.\n */\nexport async function readLogEntries(queryFilePath: string): Promise<LogEntry[]> {\n  const logPath = getLogFilePath(queryFilePath);\n  const content = await readRawLog(logPath);\n\n  if (content === null || !content.trim()) {\n    return [];\n  }\n\n  const parsed = parse(content);\n\n  // YAML with only comments parses to null\n  if (parsed === null || parsed === undefined) {\n    return [];\n  }\n\n  if (!Array.isArray(parsed)) {\n    return [];\n  }\n\n  // Filter out malformed entries that lack a valid type field\n  return parsed.filter(\n    (entry): entry is LogEntry =>\n      entry !== null &&\n      typeof entry === 'object' &&\n      typeof entry.type === 'string' &&\n      ['count', 'preview', 'assessment'].includes(entry.type),\n  );\n}\n\n/**\n * Append a log entry to the iteration log file.\n * Creates the file with a header comment if it does not exist.\n */\nexport async function appendLogEntry(\n  queryFilePath: string,\n  entry: LogEntry,\n): Promise<void> {\n  const logPath = getLogFilePath(queryFilePath);\n  const queryBasename = basename(queryFilePath);\n  const existing = await readRawLog(logPath);\n\n  // Stringify the single entry as a YAML sequence item\n  const entryYaml = stringify([entry], { lineWidth: 0 }).trimEnd();\n\n  let content: string;\n  if (existing === null) {\n    const header =\n      `# Search iteration log for ${queryBasename}\\n` +\n      `# Auto-generated by search-hub. You can also edit this file manually.\\n\\n`;\n    content = header + entryYaml + '\\n';\n  } else {\n    const trimmed = existing.trimEnd();\n    content = trimmed + '\\n\\n' + entryYaml + '\\n';\n  }\n\n  await writeFile(logPath, content, 'utf-8');\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/query/log.d.ts

@@ -0,0 +1,9 @@
+import { LogEntry } from './iteration-log.js';
+export interface LogOutputOptions {
+    json?: boolean | undefined;
+}
+/**
+ * Format log entries for display.
+ */
+export declare function formatLogOutput(entries: LogEntry[], options?: LogOutputOptions): string;
+//# sourceMappingURL=log.d.ts.map

package/dist/cli/commands/query/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/query/log.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,QAAQ,EAIT,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,QAAQ,EAAE,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CA2BR"}

package/dist/cli/commands/query/log.js

@@ -0,0 +1,64 @@
+function formatLogOutput(entries, options) {
+  if (options?.json) {
+    return JSON.stringify(entries, null, 2);
+  }
+  if (entries.length === 0) {
+    return "No iteration log entries.";
+  }
+  const lines = [];
+  for (const entry of entries) {
+    switch (entry.type) {
+      case "count":
+        lines.push(formatCountEntry(entry));
+        break;
+      case "preview":
+        lines.push(formatPreviewEntry(entry));
+        break;
+      case "assessment":
+        lines.push(formatAssessmentEntry(entry));
+        break;
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+function formatCountEntry(entry) {
+  const parts = [];
+  parts.push(`[${entry.date}] count (${entry.query_hash})`);
+  for (const [provider, count] of Object.entries(entry.counts)) {
+    parts.push(`  ${provider}: ${count}`);
+  }
+  parts.push(`  total: ${entry.total}`);
+  return parts.join("\n");
+}
+function formatPreviewEntry(entry) {
+  const parts = [];
+  parts.push(`[${entry.date}] preview (${entry.query_hash})`);
+  for (const [provider, count] of Object.entries(entry.counts)) {
+    parts.push(`  ${provider}: ${count}`);
+    const providerTitles = entry.titles[provider];
+    if (providerTitles) {
+      for (const title of providerTitles) {
+        parts.push(`    • ${title}`);
+      }
+    }
+  }
+  parts.push(`  total: ${entry.total}`);
+  return parts.join("\n");
+}
+function formatAssessmentEntry(entry) {
+  const parts = [];
+  const meta = [];
+  if (entry.verdict) meta.push(`verdict: ${entry.verdict}`);
+  if (entry.precision) meta.push(`precision: ${entry.precision}`);
+  const metaStr = meta.length > 0 ? ` ${meta.join(", ")}` : "";
+  parts.push(`[${entry.date}] assessment:${metaStr}`);
+  if (entry.comment) {
+    parts.push(`  ${entry.comment}`);
+  }
+  return parts.join("\n");
+}
+export {
+  formatLogOutput
+};
+//# sourceMappingURL=log.js.map

package/dist/cli/commands/query/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sources":["../../../../src/cli/commands/query/log.ts"],"sourcesContent":["/**\n * Query Log Command\n *\n * Formats and displays the query iteration log.\n */\nimport type {\n  LogEntry,\n  CountLogEntry,\n  PreviewLogEntry,\n  AssessmentLogEntry,\n} from './iteration-log.js';\n\nexport interface LogOutputOptions {\n  json?: boolean | undefined;\n}\n\n/**\n * Format log entries for display.\n */\nexport function formatLogOutput(\n  entries: LogEntry[],\n  options?: LogOutputOptions,\n): string {\n  if (options?.json) {\n    return JSON.stringify(entries, null, 2);\n  }\n\n  if (entries.length === 0) {\n    return 'No iteration log entries.';\n  }\n\n  const lines: string[] = [];\n\n  for (const entry of entries) {\n    switch (entry.type) {\n      case 'count':\n        lines.push(formatCountEntry(entry));\n        break;\n      case 'preview':\n        lines.push(formatPreviewEntry(entry));\n        break;\n      case 'assessment':\n        lines.push(formatAssessmentEntry(entry));\n        break;\n    }\n    lines.push('');\n  }\n\n  return lines.join('\\n').trimEnd();\n}\n\nfunction formatCountEntry(entry: CountLogEntry): string {\n  const parts: string[] = [];\n  parts.push(`[${entry.date}] count (${entry.query_hash})`);\n  for (const [provider, count] of Object.entries(entry.counts)) {\n    parts.push(`  ${provider}: ${count}`);\n  }\n  parts.push(`  total: ${entry.total}`);\n  return parts.join('\\n');\n}\n\nfunction formatPreviewEntry(entry: PreviewLogEntry): string {\n  const parts: string[] = [];\n  parts.push(`[${entry.date}] preview (${entry.query_hash})`);\n  for (const [provider, count] of Object.entries(entry.counts)) {\n    parts.push(`  ${provider}: ${count}`);\n    const providerTitles = entry.titles[provider];\n    if (providerTitles) {\n      for (const title of providerTitles) {\n        parts.push(`    • ${title}`);\n      }\n    }\n  }\n  parts.push(`  total: ${entry.total}`);\n  return parts.join('\\n');\n}\n\nfunction formatAssessmentEntry(entry: AssessmentLogEntry): string {\n  const parts: string[] = [];\n  const meta: string[] = [];\n  if (entry.verdict) meta.push(`verdict: ${entry.verdict}`);\n  if (entry.precision) meta.push(`precision: ${entry.precision}`);\n  const metaStr = meta.length > 0 ? ` ${meta.join(', ')}` : '';\n  parts.push(`[${entry.date}] assessment:${metaStr}`);\n  if (entry.comment) {\n    parts.push(`  ${entry.comment}`);\n  }\n  return parts.join('\\n');\n}\n"],"names":[],"mappings":"AAmBO,SAAS,gBACd,SACA,SACQ;AACR,MAAI,SAAS,MAAM;AACjB,WAAO,KAAK,UAAU,SAAS,MAAM,CAAC;AAAA,EACxC;AAEA,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,QAAM,QAAkB,CAAA;AAExB,aAAW,SAAS,SAAS;AAC3B,YAAQ,MAAM,MAAA;AAAA,MACZ,KAAK;AACH,cAAM,KAAK,iBAAiB,KAAK,CAAC;AAClC;AAAA,MACF,KAAK;AACH,cAAM,KAAK,mBAAmB,KAAK,CAAC;AACpC;AAAA,MACF,KAAK;AACH,cAAM,KAAK,sBAAsB,KAAK,CAAC;AACvC;AAAA,IAAA;AAEJ,UAAM,KAAK,EAAE;AAAA,EACf;AAEA,SAAO,MAAM,KAAK,IAAI,EAAE,QAAA;AAC1B;AAEA,SAAS,iBAAiB,OAA8B;AACtD,QAAM,QAAkB,CAAA;AACxB,QAAM,KAAK,IAAI,MAAM,IAAI,YAAY,MAAM,UAAU,GAAG;AACxD,aAAW,CAAC,UAAU,KAAK,KAAK,OAAO,QAAQ,MAAM,MAAM,GAAG;AAC5D,UAAM,KAAK,KAAK,QAAQ,KAAK,KAAK,EAAE;AAAA,EACtC;AACA,QAAM,KAAK,YAAY,MAAM,KAAK,EAAE;AACpC,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,mBAAmB,OAAgC;AAC1D,QAAM,QAAkB,CAAA;AACxB,QAAM,KAAK,IAAI,MAAM,IAAI,cAAc,MAAM,UAAU,GAAG;AAC1D,aAAW,CAAC,UAAU,KAAK,KAAK,OAAO,QAAQ,MAAM,MAAM,GAAG;AAC5D,UAAM,KAAK,KAAK,QAAQ,KAAK,KAAK,EAAE;AACpC,UAAM,iBAAiB,MAAM,OAAO,QAAQ;AAC5C,QAAI,gBAAgB;AAClB,iBAAW,SAAS,gBAAgB;AAClC,cAAM,KAAK,SAAS,KAAK,EAAE;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AACA,QAAM,KAAK,YAAY,MAAM,KAAK,EAAE;AACpC,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,sBAAsB,OAAmC;AAChE,QAAM,QAAkB,CAAA;AACxB,QAAM,OAAiB,CAAA;AACvB,MAAI,MAAM,QAAS,MAAK,KAAK,YAAY,MAAM,OAAO,EAAE;AACxD,MAAI,MAAM,UAAW,MAAK,KAAK,cAAc,MAAM,SAAS,EAAE;AAC9D,QAAM,UAAU,KAAK,SAAS,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;AAC1D,QAAM,KAAK,IAAI,MAAM,IAAI,gBAAgB,OAAO,EAAE;AAClD,MAAI,MAAM,SAAS;AACjB,UAAM,KAAK,KAAK,MAAM,OAAO,EAAE;AAAA,EACjC;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;"}

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA+ED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAmF3B"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/review/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAyDD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CA6E3B"}

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

@@ -1,9 +1,10 @@
-import { join, dirname } from "node:path";
-import { access, mkdir, writeFile, copyFile } from "node:fs/promises";
+import { join } from "node:path";
+import { access, mkdir, writeFile } from "node:fs/promises";
 import { stringify } from "yaml";
 import { loadSession } from "../../../session/manager.js";
 import { loadResults } from "../../../session/results-io.js";
 import { deduplicateForReview } from "./dedup.js";
+import { generateReviewJSONSchema } from "./schema.js";
 function formatAuthors(authors) {
   return authors.map((a) => {
     const parts = [];
@@ -38,20 +39,6 @@ function articleToEntry(article) {
   }
   return entry;
 }
-async function findSchemaSource() {
-  const possiblePaths = [
-    join(dirname(import.meta.url.replace("file://", "")), "../../../../schemas/review.schema.json"),
-    join(process.cwd(), "schemas/review.schema.json")
-  ];
-  for (const path of possiblePaths) {
-    try {
-      await access(path);
-      return path;
-    } catch {
-    }
-  }
-  throw new Error("Could not find review.schema.json");
-}
 async function executeReviewInit(options, sessionsDir) {
   const sessionDir = join(sessionsDir, options.sessionId);
   const session = await loadSession(options.sessionId, sessionsDir);
@@ -98,11 +85,8 @@ async function executeReviewInit(options, sessionsDir) {
   );
   await writeFile(reviewsPath, finalContent, "utf-8");
   const schemaDestPath = join(internalDir, "review.schema.json");
-  try {
-    const schemaSourcePath = await findSchemaSource();
-    await copyFile(schemaSourcePath, schemaDestPath);
-  } catch {
-  }
+  const jsonSchema = generateReviewJSONSchema();
+  await writeFile(schemaDestPath, JSON.stringify(jsonSchema, null, 2) + "\n", "utf-8");
   return {
     reviewsPath,
     articleCount: articleEntries.length,

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

@@ -1 +1 @@
-{"version":3,"file":"init.js","sources":["../../../../src/cli/commands/review/init.ts"],"sourcesContent":["/**\n * review init command - Generate reviews.yaml from session results\n */\n\nimport { join, dirname } from 'node:path';\nimport { writeFile, mkdir, access, copyFile } from 'node:fs/promises';\nimport { stringify as stringifyYaml } from 'yaml';\nimport type { Article, Author, ProviderName } from '../../../providers/base/types.js';\nimport { loadSession } from '../../../session/manager.js';\nimport { loadResults } from '../../../session/results-io.js';\nimport { deduplicateForReview } from './dedup.js';\nimport type { ArticleEntry, ReviewFile, MergedSource } from './types.js';\n\nexport interface ReviewInitOptions {\n  sessionId: string;\n  force?: boolean;\n}\n\nexport interface ReviewInitResult {\n  reviewsPath: string;\n  articleCount: number;\n  duplicatesRemoved: number;\n}\n\n/**\n * Format authors array to string\n */\nfunction formatAuthors(authors: Author[]): string {\n  return authors\n    .map((a) => {\n      const parts: string[] = [];\n      if (a.family) parts.push(a.family);\n      if (a.given) parts.push(a.given.charAt(0));\n      return parts.join(' ');\n    })\n    .join(', ');\n}\n\n/**\n * Extract year from publication date\n */\nfunction extractYear(publicationDate?: string): string | undefined {\n  if (!publicationDate) return undefined;\n  const year = publicationDate.substring(0, 4);\n  return /^\\d{4}$/.test(year) ? year : undefined;\n}\n\n/**\n * Convert Article to ArticleEntry for review file\n */\nfunction articleToEntry(article: Article & { mergedFrom?: MergedSource[] }): ArticleEntry {\n  const entry: ArticleEntry = {\n    title: article.title,\n    reviews: [],\n  };\n\n  // Add identifiers\n  if (article.doi) entry.doi = article.doi;\n  if (article.pmid) entry.pmid = article.pmid;\n  if (article.scopusId) entry.scopusId = article.scopusId;\n  if (article.arxivId) entry.arxivId = article.arxivId;\n  if (article.ericId) entry.ericId = article.ericId;\n\n  // Add bibliographic info\n  if (article.authors && article.authors.length > 0) {\n    entry.authors = formatAuthors(article.authors);\n  }\n  const year = extractYear(article.publicationDate);\n  if (year) entry.year = year;\n  if (article.abstract) entry.abstract = article.abstract;\n\n  // Add deduplication tracking\n  if (article.mergedFrom && article.mergedFrom.length > 0) {\n    entry.mergedFrom = article.mergedFrom;\n  }\n\n  return entry;\n}\n\n/**\n * Find the schema file location (in the package)\n */\nasync function findSchemaSource(): Promise<string> {\n  // Try relative to this file (src/cli/commands/review -> schemas)\n  const possiblePaths = [\n    join(dirname(import.meta.url.replace('file://', '')), '../../../../schemas/review.schema.json'),\n    join(process.cwd(), 'schemas/review.schema.json'),\n  ];\n\n  for (const path of possiblePaths) {\n    try {\n      await access(path);\n      return path;\n    } catch {\n      // Try next path\n    }\n  }\n\n  throw new Error('Could not find review.schema.json');\n}\n\n/**\n * Execute review init command\n */\nexport async function executeReviewInit(\n  options: ReviewInitOptions,\n  sessionsDir: string\n): Promise<ReviewInitResult> {\n  const sessionDir = join(sessionsDir, options.sessionId);\n\n  // Load session file\n  const session = await loadSession(options.sessionId, sessionsDir);\n\n  // Check if .internal/reviews.yaml already exists\n  const internalDir = join(sessionDir, '.internal');\n  const reviewsPath = join(internalDir, 'reviews.yaml');\n  try {\n    await access(reviewsPath);\n    if (!options.force) {\n      throw new Error(`reviews.yaml already exists. Use --force to overwrite.`);\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== 'ENOENT') {\n      throw err;\n    }\n  }\n\n  // Create .internal/ directory\n  await mkdir(internalDir, { recursive: true });\n\n  // Load all results from session\n  const allArticles: Article[] = [];\n  const providers = Object.keys(session.databases) as ProviderName[];\n\n  for (const provider of providers) {\n    const dbStatus = session.databases[provider];\n    if (!dbStatus) continue;\n    const articles = await loadResults(sessionDir, provider);\n    allArticles.push(...articles);\n  }\n\n  // Deduplicate with mergedFrom tracking\n  const { articles: dedupedArticles, duplicatesRemoved } = deduplicateForReview(allArticles);\n\n  // Convert to ArticleEntry format\n  const articleEntries = dedupedArticles.map(articleToEntry);\n\n  // Build review file\n  const reviewFile: ReviewFile = {\n    sessionId: options.sessionId,\n    articles: articleEntries,\n  };\n\n  // Generate YAML with schema reference comment\n  const yamlContent = stringifyYaml(reviewFile, {\n    lineWidth: 0, // Disable line wrapping\n  });\n\n  // Add schema reference comment at top (local copy alongside reviews.yaml)\n  const schemaComment = `# yaml-language-server: $schema=./review.schema.json\\n`;\n\n  // Replace empty reviews arrays with commented example\n  const reviewsExample = `reviews:\n        # - reviewer: human:your-name\n        #   decision: include  # include / exclude / uncertain\n        #   comment: reason`;\n  const finalContent = schemaComment + yamlContent.replace(\n    /reviews: \\[\\]/g,\n    reviewsExample\n  );\n\n  // Write reviews.yaml\n  await writeFile(reviewsPath, finalContent, 'utf-8');\n\n  // Copy schema file to .internal/ alongside reviews.yaml\n  const schemaDestPath = join(internalDir, 'review.schema.json');\n\n  try {\n    const schemaSourcePath = await findSchemaSource();\n    await copyFile(schemaSourcePath, schemaDestPath);\n  } catch {\n    // If we can't find the schema file, skip copying\n    // This might happen in test environments\n  }\n\n  return {\n    reviewsPath,\n    articleCount: articleEntries.length,\n    duplicatesRemoved,\n  };\n}\n"],"names":["stringifyYaml"],"mappings":"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"}
+{"version":3,"file":"init.js","sources":["../../../../src/cli/commands/review/init.ts"],"sourcesContent":["/**\n * review init command - Generate reviews.yaml from session results\n */\n\nimport { join } from 'node:path';\nimport { writeFile, mkdir, access } from 'node:fs/promises';\nimport { stringify as stringifyYaml } from 'yaml';\nimport type { Article, Author, ProviderName } from '../../../providers/base/types.js';\nimport { loadSession } from '../../../session/manager.js';\nimport { loadResults } from '../../../session/results-io.js';\nimport { deduplicateForReview } from './dedup.js';\nimport { generateReviewJSONSchema } from './schema.js';\nimport type { ArticleEntry, ReviewFile, MergedSource } from './types.js';\n\nexport interface ReviewInitOptions {\n  sessionId: string;\n  force?: boolean;\n}\n\nexport interface ReviewInitResult {\n  reviewsPath: string;\n  articleCount: number;\n  duplicatesRemoved: number;\n}\n\n/**\n * Format authors array to string\n */\nfunction formatAuthors(authors: Author[]): string {\n  return authors\n    .map((a) => {\n      const parts: string[] = [];\n      if (a.family) parts.push(a.family);\n      if (a.given) parts.push(a.given.charAt(0));\n      return parts.join(' ');\n    })\n    .join(', ');\n}\n\n/**\n * Extract year from publication date\n */\nfunction extractYear(publicationDate?: string): string | undefined {\n  if (!publicationDate) return undefined;\n  const year = publicationDate.substring(0, 4);\n  return /^\\d{4}$/.test(year) ? year : undefined;\n}\n\n/**\n * Convert Article to ArticleEntry for review file\n */\nfunction articleToEntry(article: Article & { mergedFrom?: MergedSource[] }): ArticleEntry {\n  const entry: ArticleEntry = {\n    title: article.title,\n    reviews: [],\n  };\n\n  // Add identifiers\n  if (article.doi) entry.doi = article.doi;\n  if (article.pmid) entry.pmid = article.pmid;\n  if (article.scopusId) entry.scopusId = article.scopusId;\n  if (article.arxivId) entry.arxivId = article.arxivId;\n  if (article.ericId) entry.ericId = article.ericId;\n\n  // Add bibliographic info\n  if (article.authors && article.authors.length > 0) {\n    entry.authors = formatAuthors(article.authors);\n  }\n  const year = extractYear(article.publicationDate);\n  if (year) entry.year = year;\n  if (article.abstract) entry.abstract = article.abstract;\n\n  // Add deduplication tracking\n  if (article.mergedFrom && article.mergedFrom.length > 0) {\n    entry.mergedFrom = article.mergedFrom;\n  }\n\n  return entry;\n}\n\n/**\n * Execute review init command\n */\nexport async function executeReviewInit(\n  options: ReviewInitOptions,\n  sessionsDir: string\n): Promise<ReviewInitResult> {\n  const sessionDir = join(sessionsDir, options.sessionId);\n\n  // Load session file\n  const session = await loadSession(options.sessionId, sessionsDir);\n\n  // Check if .internal/reviews.yaml already exists\n  const internalDir = join(sessionDir, '.internal');\n  const reviewsPath = join(internalDir, 'reviews.yaml');\n  try {\n    await access(reviewsPath);\n    if (!options.force) {\n      throw new Error(`reviews.yaml already exists. Use --force to overwrite.`);\n    }\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== 'ENOENT') {\n      throw err;\n    }\n  }\n\n  // Create .internal/ directory\n  await mkdir(internalDir, { recursive: true });\n\n  // Load all results from session\n  const allArticles: Article[] = [];\n  const providers = Object.keys(session.databases) as ProviderName[];\n\n  for (const provider of providers) {\n    const dbStatus = session.databases[provider];\n    if (!dbStatus) continue;\n    const articles = await loadResults(sessionDir, provider);\n    allArticles.push(...articles);\n  }\n\n  // Deduplicate with mergedFrom tracking\n  const { articles: dedupedArticles, duplicatesRemoved } = deduplicateForReview(allArticles);\n\n  // Convert to ArticleEntry format\n  const articleEntries = dedupedArticles.map(articleToEntry);\n\n  // Build review file\n  const reviewFile: ReviewFile = {\n    sessionId: options.sessionId,\n    articles: articleEntries,\n  };\n\n  // Generate YAML with schema reference comment\n  const yamlContent = stringifyYaml(reviewFile, {\n    lineWidth: 0, // Disable line wrapping\n  });\n\n  // Add schema reference comment at top (local copy alongside reviews.yaml)\n  const schemaComment = `# yaml-language-server: $schema=./review.schema.json\\n`;\n\n  // Replace empty reviews arrays with commented example\n  const reviewsExample = `reviews:\n        # - reviewer: human:your-name\n        #   decision: include  # include / exclude / uncertain\n        #   comment: reason`;\n  const finalContent = schemaComment + yamlContent.replace(\n    /reviews: \\[\\]/g,\n    reviewsExample\n  );\n\n  // Write reviews.yaml\n  await writeFile(reviewsPath, finalContent, 'utf-8');\n\n  // Generate and write schema file to .internal/ alongside reviews.yaml\n  const schemaDestPath = join(internalDir, 'review.schema.json');\n  const jsonSchema = generateReviewJSONSchema();\n  await writeFile(schemaDestPath, JSON.stringify(jsonSchema, null, 2) + '\\n', 'utf-8');\n\n  return {\n    reviewsPath,\n    articleCount: articleEntries.length,\n    duplicatesRemoved,\n  };\n}\n"],"names":["stringifyYaml"],"mappings":";;;;;;;AA4BA,SAAS,cAAc,SAA2B;AAChD,SAAO,QACJ,IAAI,CAAC,MAAM;AACV,UAAM,QAAkB,CAAA;AACxB,QAAI,EAAE,OAAQ,OAAM,KAAK,EAAE,MAAM;AACjC,QAAI,EAAE,MAAO,OAAM,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC;AACzC,WAAO,MAAM,KAAK,GAAG;AAAA,EACvB,CAAC,EACA,KAAK,IAAI;AACd;AAKA,SAAS,YAAY,iBAA8C;AACjE,MAAI,CAAC,gBAAiB,QAAO;AAC7B,QAAM,OAAO,gBAAgB,UAAU,GAAG,CAAC;AAC3C,SAAO,UAAU,KAAK,IAAI,IAAI,OAAO;AACvC;AAKA,SAAS,eAAe,SAAkE;AACxF,QAAM,QAAsB;AAAA,IAC1B,OAAO,QAAQ;AAAA,IACf,SAAS,CAAA;AAAA,EAAC;AAIZ,MAAI,QAAQ,IAAK,OAAM,MAAM,QAAQ;AACrC,MAAI,QAAQ,KAAM,OAAM,OAAO,QAAQ;AACvC,MAAI,QAAQ,SAAU,OAAM,WAAW,QAAQ;AAC/C,MAAI,QAAQ,QAAS,OAAM,UAAU,QAAQ;AAC7C,MAAI,QAAQ,OAAQ,OAAM,SAAS,QAAQ;AAG3C,MAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,GAAG;AACjD,UAAM,UAAU,cAAc,QAAQ,OAAO;AAAA,EAC/C;AACA,QAAM,OAAO,YAAY,QAAQ,eAAe;AAChD,MAAI,YAAY,OAAO;AACvB,MAAI,QAAQ,SAAU,OAAM,WAAW,QAAQ;AAG/C,MAAI,QAAQ,cAAc,QAAQ,WAAW,SAAS,GAAG;AACvD,UAAM,aAAa,QAAQ;AAAA,EAC7B;AAEA,SAAO;AACT;AAKA,eAAsB,kBACpB,SACA,aAC2B;AAC3B,QAAM,aAAa,KAAK,aAAa,QAAQ,SAAS;AAGtD,QAAM,UAAU,MAAM,YAAY,QAAQ,WAAW,WAAW;AAGhE,QAAM,cAAc,KAAK,YAAY,WAAW;AAChD,QAAM,cAAc,KAAK,aAAa,cAAc;AACpD,MAAI;AACF,UAAM,OAAO,WAAW;AACxB,QAAI,CAAC,QAAQ,OAAO;AAClB,YAAM,IAAI,MAAM,wDAAwD;AAAA,IAC1E;AAAA,EACF,SAAS,KAAK;AACZ,QAAK,IAA8B,SAAS,UAAU;AACpD,YAAM;AAAA,IACR;AAAA,EACF;AAGA,QAAM,MAAM,aAAa,EAAE,WAAW,MAAM;AAG5C,QAAM,cAAyB,CAAA;AAC/B,QAAM,YAAY,OAAO,KAAK,QAAQ,SAAS;AAE/C,aAAW,YAAY,WAAW;AAChC,UAAM,WAAW,QAAQ,UAAU,QAAQ;AAC3C,QAAI,CAAC,SAAU;AACf,UAAM,WAAW,MAAM,YAAY,YAAY,QAAQ;AACvD,gBAAY,KAAK,GAAG,QAAQ;AAAA,EAC9B;AAGA,QAAM,EAAE,UAAU,iBAAiB,kBAAA,IAAsB,qBAAqB,WAAW;AAGzF,QAAM,iBAAiB,gBAAgB,IAAI,cAAc;AAGzD,QAAM,aAAyB;AAAA,IAC7B,WAAW,QAAQ;AAAA,IACnB,UAAU;AAAA,EAAA;AAIZ,QAAM,cAAcA,UAAc,YAAY;AAAA,IAC5C,WAAW;AAAA;AAAA,EAAA,CACZ;AAGD,QAAM,gBAAgB;AAAA;AAGtB,QAAM,iBAAiB;AAAA;AAAA;AAAA;AAIvB,QAAM,eAAe,gBAAgB,YAAY;AAAA,IAC/C;AAAA,IACA;AAAA,EAAA;AAIF,QAAM,UAAU,aAAa,cAAc,OAAO;AAGlD,QAAM,iBAAiB,KAAK,aAAa,oBAAoB;AAC7D,QAAM,aAAa,yBAAA;AACnB,QAAM,UAAU,gBAAgB,KAAK,UAAU,YAAY,MAAM,CAAC,IAAI,MAAM,OAAO;AAEnF,SAAO;AAAA,IACL;AAAA,IACA,cAAc,eAAe;AAAA,IAC7B;AAAA,EAAA;AAEJ;"}

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"}