@grainulation/mill 1.0.0 → 1.0.2

package/lib/formats/ris.mjs

@@ -0,0 +1,76 @@
+/**
+ * mill format: ris
+ *
+ * Converts compilation.json claims to RIS tagged citation format.
+ * Each claim becomes a TY-ER record block.
+ * Zero dependencies — node built-in only.
+ */
+
+export const name = "ris";
+export const extension = ".ris";
+export const mimeType = "application/x-research-info-systems; charset=utf-8";
+export const description =
+  "Claims as RIS citation records (one TY-ER block per claim)";
+
+/**
+ * Convert a compilation object to RIS.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} RIS output
+ */
+export function convert(compilation) {
+  const claims = compilation.claims || [];
+  const meta = compilation.meta || {};
+  const author = meta.sprint ? `wheat sprint: ${meta.sprint}` : "wheat sprint";
+  const year = new Date().getFullYear().toString();
+
+  if (claims.length === 0) {
+    return "";
+  }
+
+  const records = claims.map((claim) => claimToRecord(claim, author, year));
+  return records.join("\n") + "\n";
+}
+
+function claimToRecord(claim, author, year) {
+  const id = String(claim.id || "unknown");
+  const title = claim.content || claim.text || "";
+  const type = claim.type || "";
+  const evidence =
+    typeof claim.evidence === "string"
+      ? claim.evidence
+      : (claim.evidence?.tier ?? claim.evidence_tier ?? "");
+  const status = claim.status || "";
+  const tags = Array.isArray(claim.tags) ? claim.tags : [];
+  const confidence =
+    claim.confidence != null ? `, confidence: ${claim.confidence}` : "";
+
+  const noteParts =
+    [
+      type ? `type: ${type}` : "",
+      evidence ? `evidence: ${evidence}` : "",
+      status ? `status: ${status}` : "",
+    ]
+      .filter(Boolean)
+      .join(", ") + confidence;
+
+  const lines = [
+    `TY  - GEN`,
+    `ID  - ${id}`,
+    `TI  - ${title}`,
+    `AU  - ${author}`,
+    `PY  - ${year}`,
+  ];
+
+  for (const tag of tags) {
+    lines.push(`KW  - ${tag}`);
+  }
+
+  if (noteParts) {
+    lines.push(`N1  - ${noteParts}`);
+  }
+
+  lines.push(`ER  - `);
+  lines.push("");
+
+  return lines.join("\n");
+}

package/lib/formats/{rss.js → rss.mjs}

@@ -6,10 +6,10 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'rss';
-export const extension = '.xml';
-export const mimeType = 'application/atom+xml; charset=utf-8';
-export const description = 'Claims as Atom XML feed (one entry per claim)';
+export const name = "rss";
+export const extension = ".xml";
+export const mimeType = "application/atom+xml; charset=utf-8";
+export const description = "Claims as Atom XML feed (one entry per claim)";
 
 /**
  * Convert a compilation object to Atom XML.
@@ -19,8 +19,8 @@ export const description = 'Claims as Atom XML feed (one entry per claim)';
 export function convert(compilation) {
   const claims = compilation.claims || [];
   const meta = compilation.meta || {};
-  const sprintName = meta.sprint || 'unnamed';
-  const updated = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+  const sprintName = meta.sprint || "unnamed";
+  const updated = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
 
   const lines = [];
   lines.push(`<?xml version="1.0" encoding="utf-8"?>`);
@@ -38,27 +38,30 @@ export function convert(compilation) {
   }
 
   lines.push(`</feed>`);
-  lines.push('');
+  lines.push("");
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function claimToEntry(claim) {
-  const id = String(claim.id || 'unknown');
-  const text = claim.content || claim.text || '';
-  const type = claim.type || '';
-  const status = claim.status || '';
-  const evidence = typeof claim.evidence === 'string'
-    ? claim.evidence
-    : (claim.evidence?.tier ?? claim.evidence_tier ?? '');
+  const id = String(claim.id || "unknown");
+  const text = claim.content || claim.text || "";
+  const type = claim.type || "";
+  const status = claim.status || "";
+  const evidence =
+    typeof claim.evidence === "string"
+      ? claim.evidence
+      : (claim.evidence?.tier ?? claim.evidence_tier ?? "");
   const tags = Array.isArray(claim.tags) ? claim.tags : [];
-  const updated = new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+  const updated = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
 
   const summaryParts = [
-    type ? `type: ${type}` : '',
-    evidence ? `evidence: ${evidence}` : '',
-    status ? `status: ${status}` : '',
-  ].filter(Boolean).join(', ');
+    type ? `type: ${type}` : "",
+    evidence ? `evidence: ${evidence}` : "",
+    status ? `status: ${status}` : "",
+  ]
+    .filter(Boolean)
+    .join(", ");
 
   const lines = [];
   lines.push(`  <entry>`);
@@ -81,20 +84,20 @@ function claimToEntry(claim) {
 
   lines.push(`  </entry>`);
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function escapeXml(value) {
-  if (value == null) return '';
+  if (value == null) return "";
   return String(value)
-    .replace(/&/g, '&amp;')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&apos;');
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
 }
 
 function truncate(str, max) {
   if (str.length <= max) return str;
-  return str.slice(0, max - 3) + '...';
+  return str.slice(0, max - 3) + "...";
 }

package/lib/formats/{sankey.js → sankey.mjs}

@@ -6,10 +6,11 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'sankey';
-export const extension = '.json';
-export const mimeType = 'application/json; charset=utf-8';
-export const description = 'Claims as Sankey flow JSON (type -> evidence tier -> status)';
+export const name = "sankey";
+export const extension = ".json";
+export const mimeType = "application/json; charset=utf-8";
+export const description =
+  "Claims as Sankey flow JSON (type -> evidence tier -> status)";
 
 /**
  * Convert a compilation object to Sankey JSON.
@@ -25,9 +26,9 @@ export function convert(compilation) {
   const nodeSet = new Set();
 
   for (const claim of claims) {
-    const type = 'type:' + (claim.type || 'other');
-    const evidence = 'evidence:' + getEvidence(claim) || 'evidence:unknown';
-    const status = 'status:' + (claim.status || 'unknown');
+    const type = "type:" + (claim.type || "other");
+    const evidence = "evidence:" + getEvidence(claim) || "evidence:unknown";
+    const status = "status:" + (claim.status || "unknown");
 
     nodeSet.add(type);
     nodeSet.add(evidence);
@@ -44,29 +45,29 @@ export function convert(compilation) {
 
   const nodes = Array.from(nodeSet)
     .sort()
-    .map(id => ({ id }));
+    .map((id) => ({ id }));
 
   const links = [];
 
   for (const [key, value] of Object.entries(typeToEvidence)) {
-    const [source, target] = key.split('|||');
+    const [source, target] = key.split("|||");
     links.push({ source, target, value });
   }
 
   for (const [key, value] of Object.entries(evidenceToStatus)) {
-    const [source, target] = key.split('|||');
+    const [source, target] = key.split("|||");
     links.push({ source, target, value });
   }
 
   const result = { nodes, links };
 
-  return JSON.stringify(result, null, 2) + '\n';
+  return JSON.stringify(result, null, 2) + "\n";
 }
 
 function getEvidence(claim) {
-  if (typeof claim.evidence === 'string') return claim.evidence;
-  if (typeof claim.evidence === 'object' && claim.evidence !== null) {
-    return claim.evidence.tier || claim.evidence_tier || '';
+  if (typeof claim.evidence === "string") return claim.evidence;
+  if (typeof claim.evidence === "object" && claim.evidence !== null) {
+    return claim.evidence.tier || claim.evidence_tier || "";
   }
-  return claim.evidence_tier || '';
+  return claim.evidence_tier || "";
 }

package/lib/formats/slide-deck.mjs

@@ -0,0 +1,288 @@
+/**
+ * mill format: slide-deck
+ *
+ * Self-contained HTML with CSS scroll-snap. One slide per claim type group.
+ * Dark theme matching grainulation design tokens.
+ * Accessible: slide landmarks, aria-roledescription, live region, reduced-motion.
+ * Zero dependencies — node built-in only.
+ */
+
+export const name = "slide-deck";
+export const extension = ".html";
+export const mimeType = "text/html; charset=utf-8";
+export const description =
+  "Scroll-snap slide deck: one slide per type group with keyboard navigation";
+
+/**
+ * Convert a compilation object to a slide deck HTML page.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} HTML output
+ */
+export function convert(compilation) {
+  const meta = compilation.meta || {};
+  const claims = compilation.claims || [];
+  const conflicts = compilation.conflicts || [];
+  const certificate = compilation.certificate || {};
+
+  const title = meta.sprint || meta.question || "Sprint Deck";
+  const compiled = certificate.compiled_at || new Date().toISOString();
+  const active = claims.filter((c) => c.status === "active").length;
+
+  // Group by type (skip reverted)
+  const byType = {};
+  for (const c of claims) {
+    if (c.status === "reverted") continue;
+    const t = c.type || "unknown";
+    if (!byType[t]) byType[t] = [];
+    byType[t].push(c);
+  }
+
+  const typeOrder = [
+    "constraint",
+    "factual",
+    "recommendation",
+    "risk",
+    "estimate",
+    "feedback",
+  ];
+  const sortedTypes = typeOrder.filter((t) => byType[t]);
+  for (const t of Object.keys(byType)) {
+    if (!sortedTypes.includes(t)) sortedTypes.push(t);
+  }
+
+  const typeColors = {
+    constraint: "#e74c3c",
+    factual: "#3498db",
+    recommendation: "#2ecc71",
+    risk: "#f39c12",
+    estimate: "#9b59b6",
+    feedback: "#1abc9c",
+    unknown: "#95a5a6",
+  };
+
+  let slideNum = 0;
+  // Calculate total slides: title + summary + types + optional conflicts + certificate
+  const totalSlides =
+    2 + sortedTypes.length + (conflicts.length > 0 ? 1 : 0) + 1;
+
+  // Title slide
+  const slides = [];
+  slideNum++;
+  slides.push(`
+    <section class="slide" role="group" aria-roledescription="slide" aria-label="Slide ${slideNum} of ${totalSlides}: Title">
+      <div class="slide-content title-slide">
+        <h1>${esc(title)}</h1>
+        ${meta.question ? `<p class="question">${esc(meta.question)}</p>` : ""}
+        <p class="meta">${esc(compiled)} | ${claims.length} claims</p>
+      </div>
+    </section>`);
+
+  // Summary slide
+  slideNum++;
+  const typeStats = sortedTypes
+    .map((t) => {
+      const color = typeColors[t] || typeColors.unknown;
+      return `<div class="type-stat"><span class="dot" style="background:${color}" aria-hidden="true"></span>${capitalize(t)}: ${byType[t].length}</div>`;
+    })
+    .join("\n          ");
+
+  slides.push(`
+    <section class="slide" role="group" aria-roledescription="slide" aria-label="Slide ${slideNum} of ${totalSlides}: Summary">
+      <div class="slide-content">
+        <h2>Summary</h2>
+        <div class="summary-grid">
+          <div class="big-stat"><span class="num">${claims.length}</span><span class="label">Total</span></div>
+          <div class="big-stat"><span class="num">${active}</span><span class="label">Active</span></div>
+          ${conflicts.length ? `<div class="big-stat"><span class="num">${conflicts.length}</span><span class="label">Conflicts</span></div>` : ""}
+        </div>
+        <div class="type-stats">
+          ${typeStats}
+        </div>
+      </div>
+    </section>`);
+
+  // One slide per type group
+  for (const t of sortedTypes) {
+    slideNum++;
+    const group = byType[t];
+    const color = typeColors[t] || typeColors.unknown;
+    const items = group
+      .map((c) => {
+        const body = esc(c.content || c.text || "");
+        const conf =
+          c.confidence != null ? ` (${Math.round(c.confidence * 100)}%)` : "";
+        return `<li><strong>${esc(c.id)}</strong>${conf}: ${body}</li>`;
+      })
+      .join("\n            ");
+
+    slides.push(`
+    <section class="slide" role="group" aria-roledescription="slide" aria-label="Slide ${slideNum} of ${totalSlides}: ${capitalize(t)}s">
+      <div class="slide-content">
+        <h2 style="border-left:4px solid ${color};padding-left:12px">${capitalize(t)}s (${group.length})</h2>
+        <ul class="claim-list">
+            ${items}
+        </ul>
+      </div>
+    </section>`);
+  }
+
+  // Conflicts slide (if any)
+  if (conflicts.length > 0) {
+    slideNum++;
+    const conflictItems = conflicts
+      .map((c) => {
+        const ids = c.ids?.join(" vs ") || "unknown";
+        const resolved = c.resolution ? " [resolved]" : "";
+        return `<li><strong>${esc(ids)}</strong>${resolved}: ${esc(c.description || c.reason || "")}</li>`;
+      })
+      .join("\n            ");
+
+    slides.push(`
+    <section class="slide" role="group" aria-roledescription="slide" aria-label="Slide ${slideNum} of ${totalSlides}: Conflicts">
+      <div class="slide-content">
+        <h2 style="border-left:4px solid #e74c3c;padding-left:12px">Conflicts (${conflicts.length})</h2>
+        <ul class="claim-list">
+            ${conflictItems}
+        </ul>
+      </div>
+    </section>`);
+  }
+
+  // Certificate slide
+  slideNum++;
+  slides.push(`
+    <section class="slide" role="group" aria-roledescription="slide" aria-label="Slide ${slideNum} of ${totalSlides}: Certificate">
+      <div class="slide-content title-slide">
+        <h2>Certificate</h2>
+        <p class="mono">${certificate.claim_count || claims.length} claims</p>
+        <p class="mono">sha256:${esc((certificate.sha256 || "unknown").slice(0, 24))}</p>
+        <p class="meta">${esc(compiled)}</p>
+      </div>
+    </section>`);
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(title)} — Slide Deck</title>
+<style>
+  :root { --bg:#0a0e1a; --surface:#111827; --border:#1e293b; --text:#e2e8f0; --muted:#94a3b8; }
+  * { margin:0; padding:0; box-sizing:border-box; }
+  html { scroll-snap-type:y mandatory; overflow-y:scroll; }
+  body { background:var(--bg); color:var(--text); font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif; line-height:1.6; }
+  a.skip-nav { position:absolute; top:-40px; left:0; background:var(--surface); color:var(--text); padding:0.5rem 1rem; z-index:100; border-radius:0 0 4px 0; text-decoration:none; font-size:0.9rem; }
+  a.skip-nav:focus { top:0; outline:2px solid #3b82f6; }
+  .slide { scroll-snap-align:start; height:100vh; display:flex; align-items:center; justify-content:center; padding:2rem; }
+  .slide:focus { outline:2px solid #3b82f6; outline-offset:-2px; }
+  .slide-content { max-width:800px; width:100%; }
+  .title-slide { text-align:center; }
+  .title-slide h1 { font-size:2.4rem; margin-bottom:0.75rem; }
+  .title-slide h2 { font-size:1.8rem; margin-bottom:1rem; }
+  .question { font-size:1.1rem; color:var(--muted); margin-bottom:1rem; }
+  .meta { font-size:0.85rem; color:var(--muted); }
+  .mono { font-family:monospace; font-size:1rem; color:var(--muted); margin-bottom:0.5rem; }
+  h2 { font-size:1.5rem; margin-bottom:1.25rem; }
+  .summary-grid { display:flex; gap:2rem; justify-content:center; margin-bottom:2rem; }
+  .big-stat { display:flex; flex-direction:column; align-items:center; }
+  .big-stat .num { font-size:2.5rem; font-weight:700; }
+  .big-stat .label { font-size:0.8rem; color:var(--muted); text-transform:uppercase; }
+  .type-stats { display:flex; flex-wrap:wrap; gap:0.75rem; justify-content:center; }
+  .type-stat { display:flex; align-items:center; gap:0.4rem; font-size:0.9rem; }
+  .dot { width:10px; height:10px; border-radius:50%; display:inline-block; }
+  .claim-list { list-style:none; max-height:70vh; overflow-y:auto; }
+  .claim-list li { padding:0.6rem 0; border-bottom:1px solid var(--border); font-size:0.9rem; }
+  .claim-list li strong { font-family:monospace; font-size:0.8rem; }
+  .slide-counter { position:fixed; bottom:1rem; right:1rem; background:var(--surface); color:var(--muted); padding:0.25rem 0.6rem; border-radius:4px; font-size:0.75rem; font-family:monospace; z-index:10; }
+  .sr-only { position:absolute; width:1px; height:1px; padding:0; margin:-1px; overflow:hidden; clip:rect(0,0,0,0); white-space:nowrap; border:0; }
+  .nav-hint { position:fixed; bottom:1rem; left:1rem; background:var(--surface); color:var(--muted); padding:0.25rem 0.6rem; border-radius:4px; font-size:0.7rem; font-family:monospace; z-index:10; opacity:0.6; }
+  @media (prefers-reduced-motion:reduce) { html { scroll-snap-type:none; scroll-behavior:auto; } }
+  @media print { .skip-nav, .slide-counter, .nav-hint { display:none; } .slide { height:auto; page-break-after:always; } }
+</style>
+</head>
+<body>
+<a class="skip-nav" href="#slide-1">Skip to first slide</a>
+<main role="main" aria-label="Slide deck: ${esc(title)}">
+${slides.join("\n")}
+</main>
+<div class="slide-counter" aria-live="polite" aria-atomic="true"></div>
+<div class="nav-hint" aria-hidden="true">Arrow keys / PgUp / PgDn / Home / End to navigate</div>
+<script>
+  (function() {
+    var slides = document.querySelectorAll('.slide');
+    var counter = document.querySelector('.slide-counter');
+    var total = slides.length;
+    var prefersReduced = window.matchMedia('(prefers-reduced-motion:reduce)').matches;
+    var scrollBehavior = prefersReduced ? 'auto' : 'smooth';
+
+    // Give slides tabindex for focus management
+    slides.forEach(function(slide, i) {
+      slide.id = slide.id || 'slide-' + (i + 1);
+      slide.setAttribute('tabindex', '-1');
+    });
+
+    function currentSlideIndex() {
+      var vh = window.innerHeight;
+      return Math.round(window.scrollY / vh);
+    }
+
+    function goToSlide(index) {
+      var target = Math.max(0, Math.min(index, slides.length - 1));
+      slides[target].scrollIntoView({ behavior: scrollBehavior });
+      slides[target].focus({ preventScroll: true });
+    }
+
+    function updateCounter() {
+      var current = currentSlideIndex() + 1;
+      counter.textContent = current + ' / ' + total;
+    }
+    updateCounter();
+    window.addEventListener('scroll', updateCounter, { passive: true });
+
+    document.addEventListener('keydown', function(e) {
+      var current = currentSlideIndex();
+      switch (e.key) {
+        case 'ArrowDown':
+        case 'PageDown':
+        case 'ArrowRight':
+          e.preventDefault();
+          goToSlide(current + 1);
+          break;
+        case 'ArrowUp':
+        case 'PageUp':
+        case 'ArrowLeft':
+          e.preventDefault();
+          goToSlide(current - 1);
+          break;
+        case 'Home':
+          e.preventDefault();
+          goToSlide(0);
+          break;
+        case 'End':
+          e.preventDefault();
+          goToSlide(slides.length - 1);
+          break;
+        case 'Escape':
+          // Move focus to body (exit slide focus)
+          document.body.focus();
+          break;
+      }
+    });
+  })();
+</script>
+</body>
+</html>`;
+}
+
+function esc(str) {
+  if (str == null) return "";
+  return String(str)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/lib/formats/sql.mjs

@@ -0,0 +1,120 @@
+/**
+ * mill format: sql
+ *
+ * Converts compilation.json to SQL CREATE TABLE + INSERT statements.
+ * Compatible with SQLite and PostgreSQL.
+ * Zero dependencies — node built-in only.
+ */
+
+export const name = "sql";
+export const extension = ".sql";
+export const mimeType = "application/sql; charset=utf-8";
+export const description = "SQL schema and INSERT statements for claims data";
+
+/**
+ * Convert a compilation object to SQL statements.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} SQL output
+ */
+export function convert(compilation) {
+  const claims = compilation.claims || [];
+  const meta = compilation.meta || {};
+  const certificate = compilation.certificate || {};
+
+  const lines = [];
+
+  lines.push("-- Auto-generated by mill sql format");
+  if (meta.sprint) lines.push(`-- Sprint: ${meta.sprint}`);
+  if (certificate.compiled_at)
+    lines.push(`-- Compiled: ${certificate.compiled_at}`);
+  lines.push("");
+
+  // Claims table
+  lines.push("CREATE TABLE IF NOT EXISTS claims (");
+  lines.push("  id TEXT PRIMARY KEY,");
+  lines.push("  type TEXT,");
+  lines.push("  content TEXT,");
+  lines.push("  evidence_tier TEXT,");
+  lines.push("  status TEXT,");
+  lines.push("  confidence REAL,");
+  lines.push("  source TEXT,");
+  lines.push("  tags TEXT,");
+  lines.push("  created TEXT");
+  lines.push(");");
+  lines.push("");
+
+  // Conflicts table
+  lines.push("CREATE TABLE IF NOT EXISTS conflicts (");
+  lines.push("  id INTEGER PRIMARY KEY AUTOINCREMENT,");
+  lines.push("  claim_ids TEXT,");
+  lines.push("  description TEXT,");
+  lines.push("  resolution TEXT");
+  lines.push(");");
+  lines.push("");
+
+  // Insert claims
+  if (claims.length > 0) {
+    lines.push("-- Claims");
+    for (const claim of claims) {
+      const id = esc(claim.id || "");
+      const type = esc(claim.type || "");
+      const content = esc(claim.content || claim.text || "");
+      const evidenceTier = esc(extractTier(claim));
+      const status = esc(claim.status || "");
+      const confidence =
+        claim.confidence != null ? String(claim.confidence) : "NULL";
+      const source = esc(extractSource(claim));
+      const tags = esc(Array.isArray(claim.tags) ? claim.tags.join(",") : "");
+      const created = esc(claim.created || "");
+
+      lines.push(
+        `INSERT INTO claims VALUES ('${id}', '${type}', '${content}', '${evidenceTier}', '${status}', ${confidence}, '${source}', '${tags}', '${created}');`,
+      );
+    }
+    lines.push("");
+  }
+
+  // Insert conflicts
+  const conflicts = compilation.conflicts || [];
+  if (conflicts.length > 0) {
+    lines.push("-- Conflicts");
+    for (const conflict of conflicts) {
+      const claimIds = esc(
+        Array.isArray(conflict.ids) ? conflict.ids.join(",") : "",
+      );
+      const description = esc(conflict.description || conflict.reason || "");
+      const resolution = esc(conflict.resolution || "");
+
+      lines.push(
+        `INSERT INTO conflicts (claim_ids, description, resolution) VALUES ('${claimIds}', '${description}', '${resolution}');`,
+      );
+    }
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}
+
+function esc(value) {
+  if (value == null) return "";
+  return String(value).replace(/'/g, "''");
+}
+
+function extractTier(claim) {
+  if (typeof claim.evidence === "string") return claim.evidence;
+  if (typeof claim.evidence === "object" && claim.evidence !== null) {
+    return claim.evidence.tier || "";
+  }
+  return claim.evidence_tier || "";
+}
+
+function extractSource(claim) {
+  if (typeof claim.source === "string") return claim.source;
+  if (typeof claim.source === "object" && claim.source !== null) {
+    return claim.source.origin || claim.source.artifact || "";
+  }
+  if (typeof claim.evidence === "object" && claim.evidence?.source) {
+    return claim.evidence.source;
+  }
+  return "";
+}