@grainulation/mill 1.0.0 → 1.0.2

package/lib/formats/{jira-csv.js → jira-csv.mjs}

@@ -6,18 +6,19 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'jira-csv';
-export const extension = '.csv';
-export const mimeType = 'text/csv; charset=utf-8';
-export const description = 'Claims as Jira-compatible CSV (Summary, Description, Issue Type, Priority, Labels, Status)';
+export const name = "jira-csv";
+export const extension = ".csv";
+export const mimeType = "text/csv; charset=utf-8";
+export const description =
+  "Claims as Jira-compatible CSV (Summary, Description, Issue Type, Priority, Labels, Status)";
 
 const COLUMNS = [
-  'Summary',
-  'Description',
-  'Issue Type',
-  'Priority',
-  'Labels',
-  'Status',
+  "Summary",
+  "Description",
+  "Issue Type",
+  "Priority",
+  "Labels",
+  "Status",
 ];
 
 /**
@@ -29,23 +30,23 @@ export function convert(compilation) {
   const claims = compilation.claims || [];
 
   if (claims.length === 0) {
-    return COLUMNS.join(',') + '\n';
+    return COLUMNS.join(",") + "\n";
   }
 
-  const header = COLUMNS.join(',');
+  const header = COLUMNS.join(",");
   const rows = claims.map(claimToRow);
 
-  return [header, ...rows].join('\n') + '\n';
+  return [header, ...rows].join("\n") + "\n";
 }
 
 function claimToRow(claim) {
-  const type = claim.type || '';
-  const content = claim.content || claim.text || '';
-  const summary = `${claim.id || ''}: ${truncate(content, 120)}`;
+  const type = claim.type || "";
+  const content = claim.content || claim.text || "";
+  const summary = `${claim.id || ""}: ${truncate(content, 120)}`;
   const description = content;
   const { issueType, priority } = mapTypeToJira(type);
-  const tags = Array.isArray(claim.tags) ? claim.tags.join(' ') : '';
-  const status = claim.status || '';
+  const tags = Array.isArray(claim.tags) ? claim.tags.join(" ") : "";
+  const status = claim.status || "";
 
   return [
     escapeField(summary),
@@ -54,35 +55,35 @@ function claimToRow(claim) {
     escapeField(priority),
     escapeField(tags),
     escapeField(status),
-  ].join(',');
+  ].join(",");
 }
 
 function mapTypeToJira(type) {
   switch (type) {
-    case 'risk':
-      return { issueType: 'Bug', priority: 'High' };
-    case 'recommendation':
-      return { issueType: 'Task', priority: 'Medium' };
-    case 'constraint':
-      return { issueType: 'Task', priority: 'High' };
+    case "risk":
+      return { issueType: "Bug", priority: "High" };
+    case "recommendation":
+      return { issueType: "Task", priority: "Medium" };
+    case "constraint":
+      return { issueType: "Task", priority: "High" };
     default:
-      return { issueType: 'Task', priority: 'Low' };
+      return { issueType: "Task", priority: "Low" };
   }
 }
 
 function truncate(str, max) {
   if (str.length <= max) return str;
-  return str.slice(0, max - 3) + '...';
+  return str.slice(0, max - 3) + "...";
 }
 
 function escapeField(value) {
-  if (value == null) return '';
+  if (value == null) return "";
   let str = String(value);
   // CWE-1236: Prevent CSV injection by prefixing formula-triggering characters
   if (/^[=+\-@\t\r]/.test(str)) {
     str = "'" + str;
   }
-  if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+  if (str.includes(",") || str.includes('"') || str.includes("\n")) {
     return `"${str.replace(/"/g, '""')}"`;
   }
   return str;

package/lib/formats/{json-ld.js → json-ld.mjs}

@@ -5,14 +5,14 @@
  * Zero dependencies — node built-in only.
  */
 
-import { createRequire } from 'node:module';
+import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
-const { buildReport } = require('../json-ld-common.js');
+const { buildReport } = require("../json-ld-common.js");
 
-export const name = 'json-ld';
-export const extension = '.jsonld';
-export const mimeType = 'application/ld+json; charset=utf-8';
-export const description = 'JSON-LD semantic export (schema.org/Report)';
+export const name = "json-ld";
+export const extension = ".jsonld";
+export const mimeType = "application/ld+json; charset=utf-8";
+export const description = "JSON-LD semantic export (schema.org/Report)";
 
 /**
  * Convert a compilation object to JSON-LD.

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

@@ -6,10 +6,10 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'markdown';
-export const extension = '.md';
-export const mimeType = 'text/markdown; charset=utf-8';
-export const description = 'Clean Markdown document from compilation data';
+export const name = "markdown";
+export const extension = ".md";
+export const mimeType = "text/markdown; charset=utf-8";
+export const description = "Clean Markdown document from compilation data";
 
 /**
  * Convert a compilation object to Markdown.
@@ -24,48 +24,55 @@ export function convert(compilation) {
   const certificate = compilation.certificate || {};
 
   // Title
-  const title = meta.sprint || meta.question || 'Sprint Export';
+  const title = meta.sprint || meta.question || "Sprint Export";
   lines.push(`# ${title}`);
-  lines.push('');
+  lines.push("");
 
   // Meta block
   if (meta.question) {
     lines.push(`> **Question:** ${meta.question}`);
-    lines.push('');
+    lines.push("");
   }
   if (meta.audience) {
     lines.push(`**Audience:** ${meta.audience}`);
-    lines.push('');
+    lines.push("");
   }
   if (certificate.compiled_at) {
     lines.push(`*Compiled: ${certificate.compiled_at}*`);
-    lines.push('');
+    lines.push("");
   }
 
   // Summary stats
-  const active = claims.filter(c => c.status === 'active').length;
-  const superseded = claims.filter(c => c.status === 'superseded').length;
-  const reverted = claims.filter(c => c.status === 'reverted').length;
-  lines.push('## Summary');
-  lines.push('');
+  const active = claims.filter((c) => c.status === "active").length;
+  const superseded = claims.filter((c) => c.status === "superseded").length;
+  const reverted = claims.filter((c) => c.status === "reverted").length;
+  lines.push("## Summary");
+  lines.push("");
   lines.push(`- **Total claims:** ${claims.length}`);
   lines.push(`- **Active:** ${active}`);
   if (superseded) lines.push(`- **Superseded:** ${superseded}`);
   if (reverted) lines.push(`- **Reverted:** ${reverted}`);
   if (conflicts.length) lines.push(`- **Conflicts:** ${conflicts.length}`);
-  lines.push('');
+  lines.push("");
 
   // Group claims by type
   const byType = {};
   for (const claim of claims) {
-    if (claim.status === 'reverted') continue;
-    const type = claim.type || 'unknown';
+    if (claim.status === "reverted") continue;
+    const type = claim.type || "unknown";
     if (!byType[type]) byType[type] = [];
     byType[type].push(claim);
   }
 
-  const typeOrder = ['constraint', 'factual', 'recommendation', 'risk', 'estimate', 'feedback'];
-  const sortedTypes = typeOrder.filter(t => byType[t]);
+  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);
   }
@@ -75,42 +82,52 @@ export function convert(compilation) {
     if (!group || group.length === 0) continue;
 
     lines.push(`## ${capitalize(type)}s (${group.length})`);
-    lines.push('');
+    lines.push("");
 
     for (const claim of group) {
-      const conf = claim.confidence != null ? ` [${Math.round(claim.confidence * 100)}%]` : '';
-      const evidenceStr = typeof claim.evidence === 'string' ? claim.evidence : claim.evidence?.tier;
-      const tier = evidenceStr ? ` (${evidenceStr})` : '';
-      const status = claim.status === 'superseded' ? ' ~~superseded~~' : '';
-      const body = claim.content || claim.text || '';
+      const conf =
+        claim.confidence != null
+          ? ` [${Math.round(claim.confidence * 100)}%]`
+          : "";
+      const evidenceStr =
+        typeof claim.evidence === "string"
+          ? claim.evidence
+          : claim.evidence?.tier;
+      const tier = evidenceStr ? ` (${evidenceStr})` : "";
+      const status = claim.status === "superseded" ? " ~~superseded~~" : "";
+      const body = claim.content || claim.text || "";
       lines.push(`- **${claim.id}**${conf}${tier}${status}: ${body}`);
     }
-    lines.push('');
+    lines.push("");
   }
 
   // Conflicts
   if (conflicts.length > 0) {
-    lines.push('## Conflicts');
-    lines.push('');
+    lines.push("## Conflicts");
+    lines.push("");
     for (const conflict of conflicts) {
-      const resolved = conflict.resolution ? ' (resolved)' : '';
-      lines.push(`- **${conflict.ids?.join(' vs ') || 'unknown'}**${resolved}: ${conflict.description || conflict.reason || 'No description'}`);
+      const resolved = conflict.resolution ? " (resolved)" : "";
+      lines.push(
+        `- **${conflict.ids?.join(" vs ") || "unknown"}**${resolved}: ${conflict.description || conflict.reason || "No description"}`,
+      );
       if (conflict.resolution) {
         lines.push(`  - *Resolution:* ${conflict.resolution}`);
       }
     }
-    lines.push('');
+    lines.push("");
   }
 
   // Certificate
   if (certificate.sha256 || certificate.claim_count) {
-    lines.push('---');
-    lines.push('');
-    lines.push(`*Certificate: ${certificate.claim_count || claims.length} claims, sha256:${(certificate.sha256 || 'unknown').slice(0, 12)}*`);
-    lines.push('');
+    lines.push("---");
+    lines.push("");
+    lines.push(
+      `*Certificate: ${certificate.claim_count || claims.length} claims, sha256:${(certificate.sha256 || "unknown").slice(0, 12)}*`,
+    );
+    lines.push("");
   }
 
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function capitalize(str) {

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

@@ -6,10 +6,10 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'ndjson';
-export const extension = '.ndjson';
-export const mimeType = 'application/x-ndjson';
-export const description = 'Newline-delimited JSON — one claim object per line';
+export const name = "ndjson";
+export const extension = ".ndjson";
+export const mimeType = "application/x-ndjson";
+export const description = "Newline-delimited JSON — one claim object per line";
 
 /**
  * Convert a compilation object to NDJSON.
@@ -19,7 +19,7 @@ export const description = 'Newline-delimited JSON — one claim object per line
 export function convert(compilation) {
   const claims = compilation.claims || [];
 
-  if (claims.length === 0) return '';
+  if (claims.length === 0) return "";
 
-  return claims.map(c => JSON.stringify(c)).join('\n') + '\n';
+  return claims.map((c) => JSON.stringify(c)).join("\n") + "\n";
 }

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

@@ -6,10 +6,11 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'obsidian';
-export const extension = '.md';
-export const mimeType = 'text/markdown; charset=utf-8';
-export const description = 'Claims as Obsidian vault page (YAML front matter, wikilinks, backlinks)';
+export const name = "obsidian";
+export const extension = ".md";
+export const mimeType = "text/markdown; charset=utf-8";
+export const description =
+  "Claims as Obsidian vault page (YAML front matter, wikilinks, backlinks)";
 
 /**
  * Convert a compilation object to Obsidian markdown.
@@ -19,37 +20,44 @@ export const description = 'Claims as Obsidian vault page (YAML front matter, wi
 export function convert(compilation) {
   const meta = compilation.meta || {};
   const claims = compilation.claims || [];
-  const sprint = meta.sprint || 'unknown';
-  const question = meta.question || '';
-  const audience = meta.audience || '';
+  const sprint = meta.sprint || "unknown";
+  const question = meta.question || "";
+  const audience = meta.audience || "";
 
   const grouped = groupByType(claims);
   const lines = [];
 
   // YAML front matter
-  lines.push('---');
+  lines.push("---");
   lines.push(`sprint: ${sprint}`);
   if (question) lines.push(`question: "${escapeFrontMatter(question)}"`);
   if (audience) lines.push(`audience: "${escapeFrontMatter(audience)}"`);
   lines.push(`claim_count: ${claims.length}`);
-  lines.push('tags: [wheat, sprint, export]');
-  lines.push('---');
-  lines.push('');
+  lines.push("tags: [wheat, sprint, export]");
+  lines.push("---");
+  lines.push("");
 
   // Title
   lines.push(`# Sprint: ${sprint}`);
-  lines.push('');
+  lines.push("");
 
   if (question) {
     lines.push(`> ${question}`);
-    lines.push('');
+    lines.push("");
   }
 
   // Claims grouped by type
-  lines.push('## Claims');
-  lines.push('');
-
-  const typeOrder = ['constraint', 'factual', 'estimate', 'risk', 'recommendation', 'feedback'];
+  lines.push("## Claims");
+  lines.push("");
+
+  const typeOrder = [
+    "constraint",
+    "factual",
+    "estimate",
+    "risk",
+    "recommendation",
+    "feedback",
+  ];
   const seen = new Set();
 
   for (const type of typeOrder) {
@@ -66,22 +74,22 @@ export function convert(compilation) {
   }
 
   // Connections section
-  lines.push('## Connections');
-  lines.push('');
-  lines.push('- Related: [[compilation]] [[claims]]');
+  lines.push("## Connections");
+  lines.push("");
+  lines.push("- Related: [[compilation]] [[claims]]");
 
   if (compilation.certificate) {
-    lines.push('- Certificate: [[certificate]]');
+    lines.push("- Certificate: [[certificate]]");
   }
 
-  lines.push('');
-  return lines.join('\n') + '\n';
+  lines.push("");
+  return lines.join("\n") + "\n";
 }
 
 function groupByType(claims) {
   const groups = {};
   for (const claim of claims) {
-    const type = claim.type || 'other';
+    const type = claim.type || "other";
     if (!groups[type]) groups[type] = [];
     groups[type].push(claim);
   }
@@ -89,14 +97,14 @@ function groupByType(claims) {
 }
 
 function renderGroup(type, claims) {
-  const label = capitalize(type) + 's';
+  const label = capitalize(type) + "s";
   const lines = [];
 
   lines.push(`### ${label}`);
 
   for (const claim of claims) {
-    const id = claim.id || '???';
-    const content = claim.content || claim.text || '';
+    const id = claim.id || "???";
+    const content = claim.content || claim.text || "";
     const summary = truncate(content, 120);
     const evidence = getEvidence(claim);
     const tags = formatTags(claim);
@@ -104,22 +112,22 @@ function renderGroup(type, claims) {
     lines.push(`- [[${id}]] ${summary} #${type} #${evidence}${tags}`);
   }
 
-  lines.push('');
+  lines.push("");
   return lines;
 }
 
 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 || 'stated';
+  if (typeof claim.evidence === "string") return claim.evidence;
+  if (typeof claim.evidence === "object" && claim.evidence !== null) {
+    return claim.evidence.tier || claim.evidence_tier || "stated";
   }
-  return claim.evidence_tier || 'stated';
+  return claim.evidence_tier || "stated";
 }
 
 function formatTags(claim) {
   const tags = Array.isArray(claim.tags) ? claim.tags : [];
-  if (tags.length === 0) return '';
-  return ' ' + tags.map(t => `#${t.replace(/\s+/g, '-')}`).join(' ');
+  if (tags.length === 0) return "";
+  return " " + tags.map((t) => `#${t.replace(/\s+/g, "-")}`).join(" ");
 }
 
 function capitalize(str) {
@@ -128,7 +136,7 @@ function capitalize(str) {
 
 function truncate(str, max) {
   if (str.length <= max) return str;
-  return str.slice(0, max - 3) + '...';
+  return str.slice(0, max - 3) + "...";
 }
 
 function escapeFrontMatter(str) {

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

@@ -6,10 +6,11 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'opml';
-export const extension = '.opml';
-export const mimeType = 'text/x-opml; charset=utf-8';
-export const description = 'Claims as OPML 2.0 outline grouped by type (for RSS readers and outliners)';
+export const name = "opml";
+export const extension = ".opml";
+export const mimeType = "text/x-opml; charset=utf-8";
+export const description =
+  "Claims as OPML 2.0 outline grouped by type (for RSS readers and outliners)";
 
 /**
  * Convert a compilation object to OPML XML.
@@ -19,7 +20,7 @@ export const description = 'Claims as OPML 2.0 outline grouped by type (for RSS
 export function convert(compilation) {
   const meta = compilation.meta || {};
   const claims = compilation.claims || [];
-  const sprint = meta.sprint || 'unknown';
+  const sprint = meta.sprint || "unknown";
 
   const grouped = groupByType(claims);
   const lines = [];
@@ -27,9 +28,16 @@ export function convert(compilation) {
   lines.push('<?xml version="1.0" encoding="utf-8"?>');
   lines.push('<opml version="2.0">');
   lines.push(`  <head><title>${esc(sprint)}</title></head>`);
-  lines.push('  <body>');
-
-  const typeOrder = ['constraint', 'factual', 'estimate', 'risk', 'recommendation', 'feedback'];
+  lines.push("  <body>");
+
+  const typeOrder = [
+    "constraint",
+    "factual",
+    "estimate",
+    "risk",
+    "recommendation",
+    "feedback",
+  ];
   const seen = new Set();
 
   for (const type of typeOrder) {
@@ -46,16 +54,16 @@ export function convert(compilation) {
     }
   }
 
-  lines.push('  </body>');
-  lines.push('</opml>');
+  lines.push("  </body>");
+  lines.push("</opml>");
 
-  return lines.join('\n') + '\n';
+  return lines.join("\n") + "\n";
 }
 
 function groupByType(claims) {
   const groups = {};
   for (const claim of claims) {
-    const type = claim.type || 'other';
+    const type = claim.type || "other";
     if (!groups[type]) groups[type] = [];
     groups[type].push(claim);
   }
@@ -63,29 +71,31 @@ function groupByType(claims) {
 }
 
 function renderGroup(type, claims) {
-  const label = capitalize(type) + 's';
+  const label = capitalize(type) + "s";
   const lines = [];
 
   lines.push(`    <outline text="${esc(label)} (${claims.length})">`);
 
   for (const claim of claims) {
-    const id = claim.id || '???';
-    const content = claim.content || claim.text || '';
+    const id = claim.id || "???";
+    const content = claim.content || claim.text || "";
     const summary = truncate(content, 100);
     const evidence = getEvidence(claim);
-    lines.push(`      <outline text="${esc(id)}: ${esc(summary)}" _note="evidence: ${esc(evidence)}"/>`);
+    lines.push(
+      `      <outline text="${esc(id)}: ${esc(summary)}" _note="evidence: ${esc(evidence)}"/>`,
+    );
   }
 
-  lines.push('    </outline>');
+  lines.push("    </outline>");
   return lines;
 }
 
 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 || 'stated';
+  if (typeof claim.evidence === "string") return claim.evidence;
+  if (typeof claim.evidence === "object" && claim.evidence !== null) {
+    return claim.evidence.tier || claim.evidence_tier || "stated";
   }
-  return claim.evidence_tier || 'stated';
+  return claim.evidence_tier || "stated";
 }
 
 function capitalize(str) {
@@ -94,15 +104,15 @@ function capitalize(str) {
 
 function truncate(str, max) {
   if (str.length <= max) return str;
-  return str.slice(0, max - 3) + '...';
+  return str.slice(0, max - 3) + "...";
 }
 
 function esc(str) {
-  if (str == null) return '';
+  if (str == null) return "";
   return String(str)
-    .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;");
 }