@grainulation/mill 1.0.0 → 1.0.1

package/lib/formats/html-report.js

@@ -3,13 +3,15 @@
  *
  * Self-contained HTML report with inline CSS (dark theme).
  * Claims grouped by type with colored badges, filterable via CSS class toggles.
+ * Accessible: semantic landmarks, ARIA roles, keyboard support, reduced-motion.
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'html-report';
-export const extension = '.html';
-export const mimeType = 'text/html; charset=utf-8';
-export const description = 'Self-contained dark-theme HTML report with type filters and claim cards';
+export const name = "html-report";
+export const extension = ".html";
+export const mimeType = "text/html; charset=utf-8";
+export const description =
+  "Self-contained dark-theme HTML report with type filters and claim cards";
 
 /**
  * Convert a compilation object to an HTML report.
@@ -22,76 +24,96 @@ export function convert(compilation) {
   const conflicts = compilation.conflicts || [];
   const certificate = compilation.certificate || {};
 
-  const title = meta.sprint || meta.question || 'Sprint Report';
+  const title = meta.sprint || meta.question || "Sprint Report";
   const compiled = certificate.compiled_at || new Date().toISOString();
 
   // Group claims by type (skip reverted)
   const byType = {};
   const typeCounts = {};
   for (const c of claims) {
-    if (c.status === 'reverted') continue;
-    const t = c.type || 'unknown';
+    if (c.status === "reverted") continue;
+    const t = c.type || "unknown";
     if (!byType[t]) byType[t] = [];
     byType[t].push(c);
     typeCounts[t] = (typeCounts[t] || 0) + 1;
   }
 
-  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);
   }
 
   const typeColors = {
-    constraint: '#e74c3c',
-    factual: '#3498db',
-    recommendation: '#2ecc71',
-    risk: '#f39c12',
-    estimate: '#9b59b6',
-    feedback: '#1abc9c',
-    unknown: '#95a5a6',
+    constraint: "#e74c3c",
+    factual: "#3498db",
+    recommendation: "#2ecc71",
+    risk: "#f39c12",
+    estimate: "#9b59b6",
+    feedback: "#1abc9c",
+    unknown: "#95a5a6",
   };
 
-  const active = claims.filter(c => c.status === 'active').length;
+  const active = claims.filter((c) => c.status === "active").length;
 
-  // Build filter buttons
-  const filterButtons = sortedTypes.map(t => {
-    const color = typeColors[t] || typeColors.unknown;
-    return `<button class="filter-btn active" data-type="${esc(t)}" style="--badge-color:${color}" onclick="toggleType('${esc(t)}')">${capitalize(t)} (${typeCounts[t]})</button>`;
-  }).join('\n      ');
+  // Build filter buttons with aria-pressed
+  const filterButtons = sortedTypes
+    .map((t) => {
+      const color = typeColors[t] || typeColors.unknown;
+      return `<button class="filter-btn active" data-type="${esc(t)}" style="--badge-color:${color}" aria-pressed="true" onclick="toggleType('${esc(t)}')">${capitalize(t)} (${typeCounts[t]})</button>`;
+    })
+    .join("\n      ");
 
   // Build type sections
-  const sections = sortedTypes.map(t => {
-    const group = byType[t];
-    const color = typeColors[t] || typeColors.unknown;
-    const cards = group.map(c => {
-      const body = esc(c.content || c.text || '');
-      const evidenceTier = typeof c.evidence === 'string' ? c.evidence : (c.evidence?.tier || c.evidence_tier || '');
-      const conf = c.confidence != null ? Math.round(c.confidence * 100) : null;
-      const tags = Array.isArray(c.tags) ? c.tags.map(t => `<span class="tag">${esc(t)}</span>`).join('') : '';
-      const confBar = conf != null
-        ? `<div class="conf-bar"><div class="conf-fill" style="width:${conf}%"></div><span class="conf-label">${conf}%</span></div>`
-        : '';
-      return `
-        <div class="claim-card">
+  const sections = sortedTypes
+    .map((t) => {
+      const group = byType[t];
+      const color = typeColors[t] || typeColors.unknown;
+      const cards = group
+        .map((c) => {
+          const body = esc(c.content || c.text || "");
+          const evidenceTier =
+            typeof c.evidence === "string"
+              ? c.evidence
+              : c.evidence?.tier || c.evidence_tier || "";
+          const conf =
+            c.confidence != null ? Math.round(c.confidence * 100) : null;
+          const tags = Array.isArray(c.tags)
+            ? c.tags.map((t) => `<span class="tag">${esc(t)}</span>`).join("")
+            : "";
+          const confBar =
+            conf != null
+              ? `<div class="conf-bar" role="progressbar" aria-valuenow="${conf}" aria-valuemin="0" aria-valuemax="100" aria-label="Confidence: ${conf}%"><div class="conf-fill" style="width:${conf}%"></div><span class="conf-label">${conf}%</span></div>`
+              : "";
+          return `
+        <article class="claim-card" aria-labelledby="claim-${esc(c.id)}">
           <div class="card-header">
-            <span class="claim-id">${esc(c.id)}</span>
-            ${evidenceTier ? `<span class="evidence-badge">${esc(evidenceTier)}</span>` : ''}
-            <span class="status-badge status-${esc(c.status || 'active')}">${esc(c.status || 'active')}</span>
+            <span class="claim-id" id="claim-${esc(c.id)}">${esc(c.id)}</span>
+            ${evidenceTier ? `<span class="evidence-badge">evidence: ${esc(evidenceTier)}</span>` : ""}
+            <span class="status-badge status-${esc(c.status || "active")}">status: ${esc(c.status || "active")}</span>
           </div>
           <p class="card-body">${body}</p>
-          ${tags ? `<div class="card-tags">${tags}</div>` : ''}
+          ${tags ? `<div class="card-tags" aria-label="Tags">${tags}</div>` : ""}
           ${confBar}
-        </div>`;
-    }).join('\n');
+        </article>`;
+        })
+        .join("\n");
 
-    return `
-    <section class="type-section" data-type="${esc(t)}">
+      return `
+    <section class="type-section" data-type="${esc(t)}" aria-label="${capitalize(t)} claims">
       <h2 style="border-left:4px solid ${color};padding-left:12px">${capitalize(t)}s (${group.length})</h2>
       <div class="cards">${cards}
       </div>
     </section>`;
-  }).join('\n');
+    })
+    .join("\n");
 
   return `<!DOCTYPE html>
 <html lang="en">
@@ -103,6 +125,8 @@ export function convert(compilation) {
   :root { --bg:#0a0e1a; --surface:#111827; --border:#1e293b; --text:#e2e8f0; --muted:#94a3b8; }
   * { margin:0; padding:0; box-sizing:border-box; }
   body { background:var(--bg); color:var(--text); font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif; line-height:1.6; padding:2rem; }
+  a.skip-link { 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; }
+  a.skip-link:focus { top:0; outline:2px solid #3b82f6; }
   header { margin-bottom:2rem; }
   header h1 { font-size:1.8rem; margin-bottom:0.5rem; }
   header p { color:var(--muted); font-size:0.9rem; }
@@ -112,10 +136,11 @@ export function convert(compilation) {
   .stat .label { font-size:0.75rem; color:var(--muted); text-transform:uppercase; }
   .filters { display:flex; gap:0.5rem; flex-wrap:wrap; margin-bottom:2rem; }
   .filter-btn { background:var(--surface); color:var(--text); border:1px solid var(--border); padding:0.4rem 0.8rem; border-radius:4px; cursor:pointer; font-size:0.85rem; transition:opacity 0.2s; }
+  .filter-btn:focus-visible { outline:2px solid #3b82f6; outline-offset:2px; }
   .filter-btn.active { border-color:var(--badge-color); box-shadow:0 0 0 1px var(--badge-color); }
   .filter-btn:not(.active) { opacity:0.4; }
   .type-section { margin-bottom:2rem; }
-  .type-section.hidden { display:none; }
+  .type-section[hidden] { display:none; }
   .type-section h2 { font-size:1.2rem; margin-bottom:1rem; }
   .cards { display:grid; gap:0.75rem; }
   .claim-card { background:var(--surface); border:1px solid var(--border); border-radius:8px; padding:1rem; }
@@ -132,48 +157,70 @@ export function convert(compilation) {
   .conf-fill { height:100%; background:#3b82f6; border-radius:3px; }
   .conf-label { position:absolute; right:0; top:-16px; font-size:0.7rem; color:var(--muted); }
   footer { margin-top:3rem; padding-top:1rem; border-top:1px solid var(--border); color:var(--muted); font-size:0.8rem; font-family:monospace; }
+  @media (prefers-reduced-motion:reduce) { .filter-btn { transition:none; } }
+  @media print { body { background:#fff; color:#000; } .skip-link { display:none; } .filter-btn { border-color:#ccc; } }
 </style>
 </head>
 <body>
-  <header>
+  <a class="skip-link" href="#main-content">Skip to content</a>
+  <header role="banner">
     <h1>${esc(title)}</h1>
-    ${meta.question ? `<p>${esc(meta.question)}</p>` : ''}
-    <p>Compiled: ${esc(compiled)}${meta.audience ? ` | Audience: ${esc(meta.audience)}` : ''}</p>
+    ${meta.question ? `<p>${esc(meta.question)}</p>` : ""}
+    <p>Compiled: <time datetime="${esc(compiled)}">${esc(compiled)}</time>${meta.audience ? ` | Audience: ${esc(meta.audience)}` : ""}</p>
   </header>
 
-  <div class="stats-bar">
-    <div class="stat"><div class="num">${claims.length}</div><div class="label">Total</div></div>
-    <div class="stat"><div class="num">${active}</div><div class="label">Active</div></div>
-    ${sortedTypes.map(t => `<div class="stat"><div class="num">${typeCounts[t]}</div><div class="label">${capitalize(t)}</div></div>`).join('\n    ')}
-    ${conflicts.length ? `<div class="stat"><div class="num">${conflicts.length}</div><div class="label">Conflicts</div></div>` : ''}
+  <main id="main-content" role="main">
+  <section aria-label="Summary statistics">
+  <h2 class="sr-only">Summary</h2>
+  <div class="stats-bar" role="list">
+    <div class="stat" role="listitem"><div class="num" aria-label="${claims.length} total claims">${claims.length}</div><div class="label">Total</div></div>
+    <div class="stat" role="listitem"><div class="num" aria-label="${active} active claims">${active}</div><div class="label">Active</div></div>
+    ${sortedTypes.map((t) => `<div class="stat" role="listitem"><div class="num" aria-label="${typeCounts[t]} ${t} claims">${typeCounts[t]}</div><div class="label">${capitalize(t)}</div></div>`).join("\n    ")}
+    ${conflicts.length ? `<div class="stat" role="listitem"><div class="num" aria-label="${conflicts.length} conflicts">${conflicts.length}</div><div class="label">Conflicts</div></div>` : ""}
   </div>
+  </section>
 
-  <div class="filters">
+  <nav class="filters" aria-label="Filter claims by type">
     ${filterButtons}
-  </div>
+  </nav>
 
   ${sections}
+  </main>
 
-  <footer>
-    Certificate: ${certificate.claim_count || claims.length} claims | sha256:${(certificate.sha256 || 'unknown').slice(0, 16)}
+  <footer role="contentinfo">
+    <p>Certificate: ${certificate.claim_count || claims.length} claims | sha256:${(certificate.sha256 || "unknown").slice(0, 16)}</p>
   </footer>
 
   <script>
     function toggleType(type) {
-      const btn = document.querySelector('.filter-btn[data-type="' + type + '"]');
-      const section = document.querySelector('.type-section[data-type="' + type + '"]');
+      var btn = document.querySelector('.filter-btn[data-type="' + type + '"]');
+      var section = document.querySelector('.type-section[data-type="' + type + '"]');
       if (!btn || !section) return;
-      btn.classList.toggle('active');
-      section.classList.toggle('hidden');
+      var isActive = btn.classList.toggle('active');
+      btn.setAttribute('aria-pressed', String(isActive));
+      if (isActive) { section.removeAttribute('hidden'); } else { section.setAttribute('hidden', ''); }
     }
+    // Keyboard support: Enter/Space toggles filter buttons
+    document.querySelectorAll('.filter-btn').forEach(function(btn) {
+      btn.addEventListener('keydown', function(e) {
+        if (e.key === 'Enter' || e.key === ' ') {
+          e.preventDefault();
+          btn.click();
+        }
+      });
+    });
   </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;');
+  if (str == null) return "";
+  return String(str)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
 }
 
 function capitalize(str) {

package/lib/formats/jira-csv.js

@@ -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

@@ -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

@@ -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

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