@grainulation/mill 1.0.0 → 1.0.1

package/lib/formats/yaml.js

@@ -7,10 +7,10 @@
  * Zero dependencies — node built-in only.
  */
 
-export const name = 'yaml';
-export const extension = '.yaml';
-export const mimeType = 'text/yaml; charset=utf-8';
-export const description = 'YAML serialization of compilation data';
+export const name = "yaml";
+export const extension = ".yaml";
+export const mimeType = "text/yaml; charset=utf-8";
+export const description = "YAML serialization of compilation data";
 
 /**
  * Convert a compilation object to YAML.
@@ -19,29 +19,29 @@ export const description = 'YAML serialization of compilation data';
  */
 export function convert(compilation) {
   const lines = [];
-  lines.push('# Auto-generated by mill yaml format');
-  lines.push('');
+  lines.push("# Auto-generated by mill yaml format");
+  lines.push("");
   lines.push(toYaml(compilation, 0));
-  return lines.join('\n');
+  return lines.join("\n");
 }
 
 function toYaml(value, indent) {
   if (value === null || value === undefined) {
-    return 'null';
+    return "null";
   }
-  if (typeof value === 'boolean') {
-    return value ? 'true' : 'false';
+  if (typeof value === "boolean") {
+    return value ? "true" : "false";
   }
-  if (typeof value === 'number') {
+  if (typeof value === "number") {
     return String(value);
   }
-  if (typeof value === 'string') {
+  if (typeof value === "string") {
     return yamlString(value, indent);
   }
   if (Array.isArray(value)) {
     return yamlArray(value, indent);
   }
-  if (typeof value === 'object') {
+  if (typeof value === "object") {
     return yamlObject(value, indent);
   }
   return String(value);
@@ -49,10 +49,13 @@ function toYaml(value, indent) {
 
 function yamlString(str, indent) {
   // Use block scalar for multi-line strings
-  if (str.includes('\n')) {
-    const pad = ' '.repeat(indent + 2);
-    const indented = str.split('\n').map(line => pad + line).join('\n');
-    return '|\n' + indented;
+  if (str.includes("\n")) {
+    const pad = " ".repeat(indent + 2);
+    const indented = str
+      .split("\n")
+      .map((line) => pad + line)
+      .join("\n");
+    return "|\n" + indented;
   }
   // Quote if the string contains special YAML characters or could be misinterpreted
   if (needsQuoting(str)) {
@@ -62,39 +65,46 @@ function yamlString(str, indent) {
 }
 
 function needsQuoting(str) {
-  if (str === '') return true;
-  if (str === 'true' || str === 'false' || str === 'null' || str === 'yes' || str === 'no') return true;
+  if (str === "") return true;
+  if (
+    str === "true" ||
+    str === "false" ||
+    str === "null" ||
+    str === "yes" ||
+    str === "no"
+  )
+    return true;
   if (/^[0-9]/.test(str) && !isNaN(Number(str))) return true;
   if (/[:{}\[\],&*?|>!%#@`"']/.test(str)) return true;
   if (/^\s|\s$/.test(str)) return true;
-  if (str.startsWith('- ') || str.startsWith('? ')) return true;
+  if (str.startsWith("- ") || str.startsWith("? ")) return true;
   return false;
 }
 
 function yamlArray(arr, indent) {
-  if (arr.length === 0) return '[]';
-  const pad = ' '.repeat(indent);
+  if (arr.length === 0) return "[]";
+  const pad = " ".repeat(indent);
   const items = [];
   for (const item of arr) {
-    if (item !== null && typeof item === 'object' && !Array.isArray(item)) {
+    if (item !== null && typeof item === "object" && !Array.isArray(item)) {
       // Object items: first key on same line as -, rest indented
       const keys = Object.keys(item);
       if (keys.length === 0) {
-        items.push(pad + '- {}');
+        items.push(pad + "- {}");
       } else {
         const firstKey = keys[0];
         const firstVal = toYaml(item[firstKey], indent + 4);
         const firstLine = isScalar(item[firstKey])
           ? `${pad}- ${firstKey}: ${firstVal}`
           : `${pad}- ${firstKey}:\n${indentBlock(firstVal, indent + 4)}`;
-        const rest = keys.slice(1).map(key => {
+        const rest = keys.slice(1).map((key) => {
           const val = toYaml(item[key], indent + 4);
           if (isScalar(item[key])) {
             return `${pad}  ${key}: ${val}`;
           }
           return `${pad}  ${key}:\n${indentBlock(val, indent + 4)}`;
         });
-        items.push([firstLine, ...rest].join('\n'));
+        items.push([firstLine, ...rest].join("\n"));
       }
     } else if (Array.isArray(item)) {
       const nested = toYaml(item, indent + 2);
@@ -103,13 +113,13 @@ function yamlArray(arr, indent) {
       items.push(`${pad}- ${toYaml(item, indent + 2)}`);
     }
   }
-  return '\n' + items.join('\n');
+  return "\n" + items.join("\n");
 }
 
 function yamlObject(obj, indent) {
   const keys = Object.keys(obj);
-  if (keys.length === 0) return '{}';
-  const pad = ' '.repeat(indent);
+  if (keys.length === 0) return "{}";
+  const pad = " ".repeat(indent);
   const entries = [];
   for (const key of keys) {
     const val = obj[key];
@@ -118,27 +128,35 @@ function yamlObject(obj, indent) {
       entries.push(`${pad}${yamlKey}: ${toYaml(val, indent + 2)}`);
     } else {
       const nested = toYaml(val, indent + 2);
-      if (nested.startsWith('\n')) {
+      if (nested.startsWith("\n")) {
         entries.push(`${pad}${yamlKey}:${nested}`);
       } else {
         entries.push(`${pad}${yamlKey}:\n${indentBlock(nested, indent + 2)}`);
       }
     }
   }
-  return '\n' + entries.join('\n');
+  return "\n" + entries.join("\n");
 }
 
 function isScalar(value) {
-  return value === null || value === undefined ||
-    typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+  return (
+    value === null ||
+    value === undefined ||
+    typeof value === "string" ||
+    typeof value === "number" ||
+    typeof value === "boolean"
+  );
 }
 
 function indentBlock(text, indent) {
-  const pad = ' '.repeat(indent);
-  return text.split('\n').map(line => {
-    if (line.trim() === '') return '';
-    // Only add padding if the line doesn't already have it
-    if (line.startsWith(pad)) return line;
-    return pad + line;
-  }).join('\n');
+  const pad = " ".repeat(indent);
+  return text
+    .split("\n")
+    .map((line) => {
+      if (line.trim() === "") return "";
+      // Only add padding if the line doesn't already have it
+      if (line.startsWith(pad)) return line;
+      return pad + line;
+    })
+    .join("\n");
 }

package/lib/formats.js

@@ -1,17 +1,17 @@
-'use strict';
+"use strict";
 
-const pdf = require('./exporters/pdf.js');
-const csv = require('./exporters/csv.js');
-const markdown = require('./exporters/markdown.js');
-const jsonLd = require('./exporters/json-ld.js');
-const static_ = require('./publishers/static.js');
-const clipboard = require('./publishers/clipboard.js');
+const pdf = require("./exporters/pdf.js");
+const csv = require("./exporters/csv.js");
+const markdown = require("./exporters/markdown.js");
+const jsonLd = require("./exporters/json-ld.js");
+const static_ = require("./publishers/static.js");
+const clipboard = require("./publishers/clipboard.js");
 
 const EXPORTERS = {
   pdf,
   csv,
   markdown,
-  'json-ld': jsonLd,
+  "json-ld": jsonLd,
 };
 
 const PUBLISHERS = {
@@ -23,16 +23,16 @@ const PUBLISHERS = {
  * Detect the likely format of an input file by extension.
  */
 function detectFormat(filePath) {
-  const ext = filePath.split('.').pop().toLowerCase();
+  const ext = filePath.split(".").pop().toLowerCase();
   const map = {
-    html: 'html',
-    htm: 'html',
-    md: 'markdown',
-    json: 'json',
-    csv: 'csv',
-    jsonld: 'json-ld',
+    html: "html",
+    htm: "html",
+    md: "markdown",
+    json: "json",
+    csv: "csv",
+    jsonld: "json-ld",
   };
-  return map[ext] || 'unknown';
+  return map[ext] || "unknown";
 }
 
 function getExporter(name) {

package/lib/index.js

@@ -1,10 +1,10 @@
-'use strict';
+"use strict";
 
-const formats = require('./formats.js');
+const formats = require("./formats.js");
 
-const name = 'mill';
-const version = require('../package.json').version;
-const description = 'Turn wheat sprint artifacts into shareable formats';
+const name = "mill";
+const version = require("../package.json").version;
+const description = "Turn wheat sprint artifacts into shareable formats";
 
 module.exports = {
   name,

package/lib/json-ld-common.js

@@ -1,4 +1,4 @@
-'use strict';
+"use strict";
 
 /**
  * json-ld-common.js — Shared JSON-LD vocabulary for mill
@@ -11,24 +11,25 @@
  */
 
 const CONTEXT = {
-  '@vocab': 'https://schema.org/',
-  wheat: 'https://grainulation.com/ns/wheat#',
-  claim: 'wheat:Claim',
-  confidence: 'wheat:confidence',
-  evidenceTier: 'wheat:evidenceTier',
-  claimType: 'wheat:claimType',
-  sprintId: 'wheat:sprintId',
+  "@vocab": "https://schema.org/",
+  wheat: "https://grainulation.com/ns/wheat#",
+  claim: "wheat:Claim",
+  confidence: "wheat:confidence",
+  evidenceTier: "wheat:evidenceTier",
+  claimType: "wheat:claimType",
+  sprintId: "wheat:sprintId",
 };
 
 function claimToJsonLd(claim) {
-  const body = claim.content || claim.text || '';
-  const evidenceTier = typeof claim.evidence === 'string'
-    ? claim.evidence
-    : (claim.evidence?.tier ?? claim.evidence_tier ?? null);
+  const body = claim.content || claim.text || "";
+  const evidenceTier =
+    typeof claim.evidence === "string"
+      ? claim.evidence
+      : (claim.evidence?.tier ?? claim.evidence_tier ?? null);
 
   return {
-    '@type': 'claim',
-    '@id': `wheat:claim/${claim.id}`,
+    "@type": "claim",
+    "@id": `wheat:claim/${claim.id}`,
     identifier: claim.id,
     claimType: claim.type,
     text: body,
@@ -36,36 +37,41 @@ function claimToJsonLd(claim) {
     confidence: claim.confidence ?? null,
     evidenceTier,
     dateCreated: claim.created || claim.timestamp || null,
-    ...(claim.tags?.length ? { keywords: claim.tags.join(', ') } : {}),
+    ...(claim.tags?.length ? { keywords: claim.tags.join(", ") } : {}),
     ...(claim.status ? { status: claim.status } : {}),
   };
 }
 
 function buildReport(meta, claims, certificate) {
   return {
-    '@context': CONTEXT,
-    '@type': 'Report',
-    '@id': `wheat:sprint/${meta.sprint || 'unknown'}`,
-    name: meta.sprint || meta.question || 'Wheat Sprint Report',
-    description: meta.question || '',
-    dateCreated: (certificate && certificate.compiled_at) || new Date().toISOString(),
-    ...(meta.audience ? { audience: { '@type': 'Audience', name: meta.audience } } : {}),
+    "@context": CONTEXT,
+    "@type": "Report",
+    "@id": `wheat:sprint/${meta.sprint || "unknown"}`,
+    name: meta.sprint || meta.question || "Wheat Sprint Report",
+    description: meta.question || "",
+    dateCreated:
+      (certificate && certificate.compiled_at) || new Date().toISOString(),
+    ...(meta.audience
+      ? { audience: { "@type": "Audience", name: meta.audience } }
+      : {}),
     hasPart: {
-      '@type': 'ItemList',
+      "@type": "ItemList",
       numberOfItems: claims.length,
       itemListElement: claims.map((claim, i) => ({
-        '@type': 'ListItem',
+        "@type": "ListItem",
         position: i + 1,
         item: claimToJsonLd(claim),
       })),
     },
-    ...((certificate && certificate.sha256) ? {
-      identifier: {
-        '@type': 'PropertyValue',
-        name: 'certificate-sha256',
-        value: certificate.sha256,
-      },
-    } : {}),
+    ...(certificate && certificate.sha256
+      ? {
+          identifier: {
+            "@type": "PropertyValue",
+            name: "certificate-sha256",
+            value: certificate.sha256,
+          },
+        }
+      : {}),
   };
 }
 

package/lib/publishers/clipboard.js

@@ -1,8 +1,8 @@
-'use strict';
+"use strict";
 
-const fs = require('node:fs');
-const path = require('node:path');
-const { execFile } = require('node:child_process');
+const fs = require("node:fs");
+const path = require("node:path");
+const { execFile } = require("node:child_process");
 
 /**
  * Copy formatted output to system clipboard.
@@ -11,12 +11,12 @@ const { execFile } = require('node:child_process');
 
 function getClipboardCommand() {
   switch (process.platform) {
-    case 'darwin':
-      return { cmd: 'pbcopy', args: [] };
-    case 'linux':
-      return { cmd: 'xclip', args: ['-selection', 'clipboard'] };
-    case 'win32':
-      return { cmd: 'clip', args: [] };
+    case "darwin":
+      return { cmd: "pbcopy", args: [] };
+    case "linux":
+      return { cmd: "xclip", args: ["-selection", "clipboard"] };
+    case "win32":
+      return { cmd: "clip", args: [] };
     default:
       return null;
   }
@@ -46,25 +46,27 @@ async function publishClipboard(inputPath) {
   let content;
   if (stat.isDirectory()) {
     // If directory, list the files
-    const files = fs.readdirSync(inputPath).filter((f) => !f.startsWith('.'));
-    content = files.map((f) => {
-      const full = path.join(inputPath, f);
-      return fs.readFileSync(full, 'utf-8');
-    }).join('\n\n---\n\n');
+    const files = fs.readdirSync(inputPath).filter((f) => !f.startsWith("."));
+    content = files
+      .map((f) => {
+        const full = path.join(inputPath, f);
+        return fs.readFileSync(full, "utf-8");
+      })
+      .join("\n\n---\n\n");
   } else {
-    content = fs.readFileSync(inputPath, 'utf-8');
+    content = fs.readFileSync(inputPath, "utf-8");
   }
 
   await copyToClipboard(content);
 
-  const size = Buffer.byteLength(content, 'utf-8');
+  const size = Buffer.byteLength(content, "utf-8");
   return {
     message: `Copied to clipboard (${size} bytes)`,
   };
 }
 
 module.exports = {
-  name: 'clipboard',
-  description: 'Copy formatted output to system clipboard',
+  name: "clipboard",
+  description: "Copy formatted output to system clipboard",
   publish: publishClipboard,
 };

package/lib/publishers/static.js

@@ -1,9 +1,16 @@
-'use strict';
+"use strict";
 
-const fs = require('node:fs');
-const path = require('node:path');
+const fs = require("node:fs");
+const path = require("node:path");
 
-function esc(s) { return String(s || '').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;').replace(/'/g,'&#39;'); }
+function esc(s) {
+  return String(s || "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}
 
 /**
  * Generate a static site from sprint output directory.
@@ -93,7 +100,7 @@ function scanDir(dir, base) {
     const stat = fs.statSync(full);
     const real = fs.realpathSync(full);
     if (!real.startsWith(fs.realpathSync(base))) continue;
-    if (stat.isFile() && !name.startsWith('.')) {
+    if (stat.isFile() && !name.startsWith(".")) {
       const rel = path.relative(base, full);
       entries.push({
         name,
@@ -102,7 +109,11 @@ function scanDir(dir, base) {
         ext: path.extname(name).slice(1).toLowerCase(),
         modified: stat.mtime,
       });
-    } else if (stat.isDirectory() && !name.startsWith('.') && name !== '_site') {
+    } else if (
+      stat.isDirectory() &&
+      !name.startsWith(".") &&
+      name !== "_site"
+    ) {
       entries.push(...scanDir(full, base));
     }
   }
@@ -110,7 +121,7 @@ function scanDir(dir, base) {
 }
 
 async function publishStatic(inputDir, outputDir) {
-  const outDir = outputDir || path.join(inputDir, '_site');
+  const outDir = outputDir || path.join(inputDir, "_site");
   if (!fs.existsSync(outDir)) {
     fs.mkdirSync(outDir, { recursive: true });
   }
@@ -130,14 +141,18 @@ async function publishStatic(inputDir, outputDir) {
 
   // Build index
   const sprintName = path.basename(path.resolve(inputDir));
-  const cards = entries.map((e) => `
+  const cards = entries
+    .map(
+      (e) => `
     <div class="card">
       <a href="${esc(e.path)}">${esc(e.name)}</a>
       <div class="meta">${e.ext.toUpperCase()} &middot; ${formatBytes(e.size)}</div>
-    </div>`).join('\n');
+    </div>`,
+    )
+    .join("\n");
 
   const html = TEMPLATE(`Sprint: ${sprintName}`, cards);
-  fs.writeFileSync(path.join(outDir, 'index.html'), html, 'utf-8');
+  fs.writeFileSync(path.join(outDir, "index.html"), html, "utf-8");
 
   return {
     outputPath: outDir,
@@ -146,7 +161,7 @@ async function publishStatic(inputDir, outputDir) {
 }
 
 module.exports = {
-  name: 'static',
-  description: 'Generate a static site from sprint outputs',
+  name: "static",
+  description: "Generate a static site from sprint outputs",
   publish: publishStatic,
 };