npm - @grainulation/mill - Versions diffs - 1.0.0 - Mend

@grainulation/mill 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (42) hide show

package/CHANGELOG.md +12 -0
package/LICENSE +21 -0
package/README.md +76 -0
package/bin/mill.js +320 -0
package/lib/exporters/csv.js +83 -0
package/lib/exporters/json-ld.js +44 -0
package/lib/exporters/markdown.js +116 -0
package/lib/exporters/pdf.js +104 -0
package/lib/formats/bibtex.js +76 -0
package/lib/formats/changelog.js +102 -0
package/lib/formats/csv.js +92 -0
package/lib/formats/dot.js +129 -0
package/lib/formats/evidence-matrix.js +87 -0
package/lib/formats/executive-summary.js +130 -0
package/lib/formats/github-issues.js +89 -0
package/lib/formats/graphml.js +118 -0
package/lib/formats/html-report.js +181 -0
package/lib/formats/jira-csv.js +89 -0
package/lib/formats/json-ld.js +28 -0
package/lib/formats/markdown.js +118 -0
package/lib/formats/ndjson.js +25 -0
package/lib/formats/obsidian.js +136 -0
package/lib/formats/opml.js +108 -0
package/lib/formats/ris.js +70 -0
package/lib/formats/rss.js +100 -0
package/lib/formats/sankey.js +72 -0
package/lib/formats/slide-deck.js +200 -0
package/lib/formats/sql.js +116 -0
package/lib/formats/static-site.js +169 -0
package/lib/formats/treemap.js +65 -0
package/lib/formats/typescript-defs.js +147 -0
package/lib/formats/yaml.js +144 -0
package/lib/formats.js +60 -0
package/lib/index.js +14 -0
package/lib/json-ld-common.js +72 -0
package/lib/publishers/clipboard.js +70 -0
package/lib/publishers/static.js +152 -0
package/lib/serve-mcp.js +340 -0
package/lib/server.js +535 -0
package/package.json +53 -0
package/public/grainulation-tokens.css +321 -0
package/public/index.html +891 -0

package/lib/formats/executive-summary.js ADDED Viewed

@@ -0,0 +1,130 @@
+/**
+ * mill format: executive-summary
+ *
+ * Single-page HTML showing only active risks, top recommendations,
+ * and confidence-weighted findings. Filters out resolved/low-confidence noise.
+ * Zero dependencies — node built-in only.
+ */
+export const name = 'executive-summary';
+export const extension = '.html';
+export const mimeType = 'text/html; charset=utf-8';
+export const description = 'Compact executive summary: active risks, recommendations, evidence coverage';
+/**
+ * Convert a compilation object to an executive summary 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 certificate = compilation.certificate || {};
+  const title = meta.sprint || meta.question || 'Executive Summary';
+  // Active risks sorted by confidence desc
+  const risks = claims
+    .filter(c => c.type === 'risk' && c.status === 'active')
+    .sort((a, b) => (b.confidence || 0) - (a.confidence || 0));
+  // Active recommendations sorted by confidence desc
+  const recs = claims
+    .filter(c => c.type === 'recommendation' && c.status === 'active')
+    .sort((a, b) => (b.confidence || 0) - (a.confidence || 0));
+  // Evidence coverage — count by tier
+  const tierOrder = ['production', 'tested', 'documented', 'web', 'stated'];
+  const tierCounts = {};
+  for (const c of claims) {
+    if (c.status === 'reverted') continue;
+    const tier = typeof c.evidence === 'string' ? c.evidence : (c.evidence?.tier || c.evidence_tier || 'unknown');
+    tierCounts[tier] = (tierCounts[tier] || 0) + 1;
+  }
+  const riskRows = risks.map(c => {
+    const conf = c.confidence != null ? Math.round(c.confidence * 100) + '%' : '--';
+    const tier = typeof c.evidence === 'string' ? c.evidence : (c.evidence?.tier || '');
+    return `<tr><td class="mono">${esc(c.id)}</td><td>${esc(c.content || c.text || '')}</td><td class="center">${esc(tier)}</td><td class="center">${conf}</td></tr>`;
+  }).join('\n');
+  const recRows = recs.map(c => {
+    const conf = c.confidence != null ? Math.round(c.confidence * 100) + '%' : '--';
+    const tier = typeof c.evidence === 'string' ? c.evidence : (c.evidence?.tier || '');
+    return `<tr><td class="mono">${esc(c.id)}</td><td>${esc(c.content || c.text || '')}</td><td class="center">${esc(tier)}</td><td class="center">${conf}</td></tr>`;
+  }).join('\n');
+  const evidenceRows = tierOrder
+    .filter(t => tierCounts[t])
+    .map(t => `<tr><td>${capitalize(t)}</td><td class="center">${tierCounts[t]}</td></tr>`)
+    .join('\n');
+  // Include unknown tiers
+  const extraTiers = Object.keys(tierCounts)
+    .filter(t => !tierOrder.includes(t))
+    .map(t => `<tr><td>${capitalize(t)}</td><td class="center">${tierCounts[t]}</td></tr>`)
+    .join('\n');
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(title)} — Executive Summary</title>
+<style>
+  :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; max-width:900px; margin:0 auto; }
+  h1 { font-size:1.6rem; margin-bottom:0.25rem; }
+  .subtitle { color:var(--muted); font-size:0.9rem; margin-bottom:2rem; }
+  h2 { font-size:1.1rem; margin:1.5rem 0 0.75rem; padding-bottom:0.4rem; border-bottom:1px solid var(--border); }
+  h2 .count { color:var(--muted); font-weight:400; }
+  table { width:100%; border-collapse:collapse; margin-bottom:1rem; }
+  th { text-align:left; font-size:0.75rem; text-transform:uppercase; color:var(--muted); padding:0.5rem; border-bottom:1px solid var(--border); }
+  td { padding:0.5rem; border-bottom:1px solid var(--border); font-size:0.88rem; vertical-align:top; }
+  .center { text-align:center; }
+  .mono { font-family:monospace; font-size:0.8rem; white-space:nowrap; }
+  .risk-table tr:hover { background:rgba(243,156,18,0.06); }
+  .rec-table tr:hover { background:rgba(46,204,113,0.06); }
+  .empty { color:var(--muted); font-style:italic; padding:1rem 0; }
+  footer { margin-top:2rem; padding-top:0.75rem; border-top:1px solid var(--border); color:var(--muted); font-size:0.75rem; font-family:monospace; }
+</style>
+</head>
+<body>
+  <h1>${esc(title)}</h1>
+  <p class="subtitle">${meta.question ? esc(meta.question) : ''}${meta.question && certificate.compiled_at ? ' | ' : ''}${certificate.compiled_at ? 'Compiled: ' + esc(certificate.compiled_at) : ''}</p>
+  <h2>Key Risks <span class="count">(${risks.length})</span></h2>
+  ${risks.length > 0 ? `
+  <table class="risk-table">
+    <thead><tr><th>ID</th><th>Description</th><th>Evidence</th><th>Confidence</th></tr></thead>
+    <tbody>${riskRows}</tbody>
+  </table>` : '<p class="empty">No active risks.</p>'}
+  <h2>Recommendations <span class="count">(${recs.length})</span></h2>
+  ${recs.length > 0 ? `
+  <table class="rec-table">
+    <thead><tr><th>ID</th><th>Description</th><th>Evidence</th><th>Confidence</th></tr></thead>
+    <tbody>${recRows}</tbody>
+  </table>` : '<p class="empty">No active recommendations.</p>'}
+  <h2>Evidence Coverage</h2>
+  <table>
+    <thead><tr><th>Tier</th><th>Claims</th></tr></thead>
+    <tbody>${evidenceRows}${extraTiers}</tbody>
+  </table>
+  <footer>
+    Certificate: ${certificate.claim_count || claims.length} claims | sha256:${(certificate.sha256 || 'unknown').slice(0, 16)}
+  </footer>
+</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/github-issues.js ADDED Viewed

@@ -0,0 +1,89 @@
+/**
+ * mill format: github-issues
+ *
+ * Converts compilation.json claims to a single markdown file
+ * with each claim formatted as a GitHub issue template.
+ * Zero dependencies — node built-in only.
+ */
+export const name = 'github-issues';
+export const extension = '.md';
+export const mimeType = 'text/markdown; charset=utf-8';
+export const description = 'Claims as GitHub issue templates (one markdown file, horizontal-rule separated)';
+/**
+ * Convert a compilation object to GitHub issue markdown.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} Markdown output
+ */
+export function convert(compilation) {
+  const meta = compilation.meta || {};
+  const claims = compilation.claims || [];
+  const sprint = meta.sprint || 'unknown';
+  const lines = [];
+  lines.push(`# GitHub Issues: ${sprint}`);
+  lines.push('');
+  lines.push('> Bulk-create with the `gh` CLI:');
+  lines.push('> ```');
+  lines.push('> # Split this file by "---" and create each section as an issue:');
+  lines.push(`> # gh issue create --title "TITLE" --body "BODY" --label "TYPE"`);
+  lines.push('> ```');
+  lines.push('');
+  if (claims.length === 0) {
+    lines.push('_No claims to export._');
+    return lines.join('\n') + '\n';
+  }
+  for (let i = 0; i < claims.length; i++) {
+    if (i > 0) {
+      lines.push('');
+    }
+    lines.push('---');
+    lines.push('');
+    lines.push(...formatClaim(claims[i]));
+  }
+  lines.push('');
+  return lines.join('\n') + '\n';
+}
+function formatClaim(claim) {
+  const id = claim.id || '???';
+  const content = claim.content || claim.text || '';
+  const type = claim.type || 'unknown';
+  const evidence = getEvidence(claim);
+  const status = claim.status || 'unknown';
+  const tags = Array.isArray(claim.tags) ? claim.tags : [];
+  const summary = truncate(content, 80);
+  const lines = [];
+  lines.push(`## ${id}: ${summary}`);
+  lines.push('');
+  lines.push(`**Type:** ${type} | **Evidence:** ${evidence} | **Status:** ${status}`);
+  lines.push('');
+  lines.push(content);
+  if (tags.length > 0) {
+    lines.push('');
+    lines.push(`**Tags:** ${tags.join(', ')}`);
+  }
+  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';
+  }
+  return claim.evidence_tier || 'stated';
+}
+function truncate(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 3) + '...';
+}

package/lib/formats/graphml.js ADDED Viewed

@@ -0,0 +1,118 @@
+/**
+ * mill format: graphml
+ *
+ * Converts compilation.json claims to GraphML XML.
+ * Claims become nodes, shared-tag relationships become edges.
+ * Zero dependencies — node built-in only.
+ */
+export const name = 'graphml';
+export const extension = '.graphml';
+export const mimeType = 'application/graphml+xml; charset=utf-8';
+export const description = 'Claims as GraphML graph (nodes per claim, edges for shared tags)';
+/**
+ * Convert a compilation object to GraphML XML.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} GraphML XML output
+ */
+export function convert(compilation) {
+  const claims = compilation.claims || [];
+  const lines = [];
+  lines.push('<?xml version="1.0" encoding="utf-8"?>');
+  lines.push('<graphml xmlns="http://graphml.graphstruct.org/graphml">');
+  lines.push('  <key id="type" for="node" attr.name="type" attr.type="string"/>');
+  lines.push('  <key id="evidence" for="node" attr.name="evidence" attr.type="string"/>');
+  lines.push('  <key id="content" for="node" attr.name="content" attr.type="string"/>');
+  lines.push('  <key id="status" for="node" attr.name="status" attr.type="string"/>');
+  lines.push('  <key id="confidence" for="node" attr.name="confidence" attr.type="double"/>');
+  lines.push('  <key id="tag" for="edge" attr.name="tag" attr.type="string"/>');
+  lines.push('  <graph id="G" edgedefault="undirected">');
+  // Nodes
+  for (const claim of claims) {
+    const id = esc(claim.id || '');
+    const type = esc(claim.type || '');
+    const evidence = esc(getEvidence(claim));
+    const content = esc(claim.content || claim.text || '');
+    const status = esc(claim.status || '');
+    const confidence = claim.confidence != null ? claim.confidence : '';
+    lines.push(`    <node id="${id}">`);
+    lines.push(`      <data key="type">${type}</data>`);
+    lines.push(`      <data key="evidence">${evidence}</data>`);
+    lines.push(`      <data key="content">${content}</data>`);
+    lines.push(`      <data key="status">${status}</data>`);
+    if (confidence !== '') {
+      lines.push(`      <data key="confidence">${confidence}</data>`);
+    }
+    lines.push('    </node>');
+  }
+  // Edges: connect claims that share at least one tag
+  const edges = buildTagEdges(claims);
+  let edgeId = 0;
+  for (const edge of edges) {
+    edgeId++;
+    lines.push(`    <edge id="e${edgeId}" source="${esc(edge.source)}" target="${esc(edge.target)}">`);
+    lines.push(`      <data key="tag">${esc(edge.tag)}</data>`);
+    lines.push('    </edge>');
+  }
+  lines.push('  </graph>');
+  lines.push('</graphml>');
+  return lines.join('\n') + '\n';
+}
+/**
+ * Build edges between claims that share tags.
+ * One edge per shared tag per pair (deduplicated by pair+tag).
+ */
+function buildTagEdges(claims) {
+  const tagMap = {};
+  for (const claim of claims) {
+    const tags = Array.isArray(claim.tags) ? claim.tags : [];
+    for (const tag of tags) {
+      if (!tagMap[tag]) tagMap[tag] = [];
+      tagMap[tag].push(claim.id || '');
+    }
+  }
+  const edges = [];
+  const seen = new Set();
+  for (const [tag, ids] of Object.entries(tagMap)) {
+    for (let i = 0; i < ids.length; i++) {
+      for (let j = i + 1; j < ids.length; j++) {
+        const key = `${ids[i]}--${ids[j]}--${tag}`;
+        if (!seen.has(key)) {
+          seen.add(key);
+          edges.push({ source: ids[i], target: ids[j], tag });
+        }
+      }
+    }
+  }
+  return edges;
+}
+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 || '';
+  }
+  return claim.evidence_tier || '';
+}
+function esc(str) {
+  if (str == null) return '';
+  return String(str)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;');
+}

package/lib/formats/html-report.js ADDED Viewed

@@ -0,0 +1,181 @@
+/**
+ * mill format: html-report
+ *
+ * Self-contained HTML report with inline CSS (dark theme).
+ * Claims grouped by type with colored badges, filterable via CSS class toggles.
+ * 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';
+/**
+ * Convert a compilation object to an HTML report.
+ * @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 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 (!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]);
+  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',
+  };
+  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 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">
+          <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>
+          </div>
+          <p class="card-body">${body}</p>
+          ${tags ? `<div class="card-tags">${tags}</div>` : ''}
+          ${confBar}
+        </div>`;
+    }).join('\n');
+    return `
+    <section class="type-section" data-type="${esc(t)}">
+      <h2 style="border-left:4px solid ${color};padding-left:12px">${capitalize(t)}s (${group.length})</h2>
+      <div class="cards">${cards}
+      </div>
+    </section>`;
+  }).join('\n');
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(title)}</title>
+<style>
+  :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; }
+  header { margin-bottom:2rem; }
+  header h1 { font-size:1.8rem; margin-bottom:0.5rem; }
+  header p { color:var(--muted); font-size:0.9rem; }
+  .stats-bar { display:flex; gap:1.5rem; padding:1rem; background:var(--surface); border-radius:8px; margin-bottom:1.5rem; flex-wrap:wrap; }
+  .stat { text-align:center; }
+  .stat .num { font-size:1.4rem; font-weight:700; }
+  .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.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 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; }
+  .card-header { display:flex; gap:0.5rem; align-items:center; margin-bottom:0.5rem; flex-wrap:wrap; }
+  .claim-id { font-weight:700; font-family:monospace; font-size:0.85rem; }
+  .evidence-badge { background:#1e3a5f; color:#60a5fa; padding:0.15rem 0.5rem; border-radius:3px; font-size:0.75rem; }
+  .status-badge { padding:0.15rem 0.5rem; border-radius:3px; font-size:0.7rem; text-transform:uppercase; }
+  .status-active { background:#064e3b; color:#34d399; }
+  .status-superseded { background:#4a3728; color:#fbbf24; }
+  .card-body { color:var(--text); font-size:0.9rem; }
+  .card-tags { display:flex; gap:0.3rem; flex-wrap:wrap; margin-top:0.5rem; }
+  .tag { background:var(--border); padding:0.1rem 0.4rem; border-radius:3px; font-size:0.7rem; color:var(--muted); }
+  .conf-bar { position:relative; height:6px; background:var(--border); border-radius:3px; margin-top:0.5rem; }
+  .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; }
+</style>
+</head>
+<body>
+  <header>
+    <h1>${esc(title)}</h1>
+    ${meta.question ? `<p>${esc(meta.question)}</p>` : ''}
+    <p>Compiled: ${esc(compiled)}${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>` : ''}
+  </div>
+  <div class="filters">
+    ${filterButtons}
+  </div>
+  ${sections}
+  <footer>
+    Certificate: ${certificate.claim_count || claims.length} claims | sha256:${(certificate.sha256 || 'unknown').slice(0, 16)}
+  </footer>
+  <script>
+    function toggleType(type) {
+      const btn = document.querySelector('.filter-btn[data-type="' + type + '"]');
+      const section = document.querySelector('.type-section[data-type="' + type + '"]');
+      if (!btn || !section) return;
+      btn.classList.toggle('active');
+      section.classList.toggle('hidden');
+    }
+  </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/jira-csv.js ADDED Viewed

@@ -0,0 +1,89 @@
+/**
+ * mill format: jira-csv
+ *
+ * Converts compilation.json claims to CSV with Jira field names.
+ * Columns: Summary, Description, Issue Type, Priority, Labels, Status
+ * 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)';
+const COLUMNS = [
+  'Summary',
+  'Description',
+  'Issue Type',
+  'Priority',
+  'Labels',
+  'Status',
+];
+/**
+ * Convert a compilation object to Jira-compatible CSV.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} CSV output
+ */
+export function convert(compilation) {
+  const claims = compilation.claims || [];
+  if (claims.length === 0) {
+    return COLUMNS.join(',') + '\n';
+  }
+  const header = COLUMNS.join(',');
+  const rows = claims.map(claimToRow);
+  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 description = content;
+  const { issueType, priority } = mapTypeToJira(type);
+  const tags = Array.isArray(claim.tags) ? claim.tags.join(' ') : '';
+  const status = claim.status || '';
+  return [
+    escapeField(summary),
+    escapeField(description),
+    escapeField(issueType),
+    escapeField(priority),
+    escapeField(tags),
+    escapeField(status),
+  ].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' };
+    default:
+      return { issueType: 'Task', priority: 'Low' };
+  }
+}
+function truncate(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 3) + '...';
+}
+function escapeField(value) {
+  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')) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+}

package/lib/formats/json-ld.js ADDED Viewed

@@ -0,0 +1,28 @@
+/**
+ * mill format: json-ld
+ *
+ * Wraps compilation.json in JSON-LD using schema.org/Report vocabulary.
+ * Zero dependencies — node built-in only.
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+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)';
+/**
+ * Convert a compilation object to JSON-LD.
+ * @param {object} compilation - The compilation.json content
+ * @returns {string} JSON-LD string
+ */
+export function convert(compilation) {
+  const meta = compilation.meta || {};
+  const claims = compilation.claims || [];
+  const certificate = compilation.certificate || {};
+  return JSON.stringify(buildReport(meta, claims, certificate), null, 2);
+}