Mill

Turn sprint evidence into shareable artifacts.

26 export formats. PDF, CSV, Markdown, slides, JSON-LD, Jira, GitHub Issues, and more. Give mill your claims or HTML output and it produces whatever your team needs.

Install

npm install -g @grainulation/mill

Or use directly:

npx @grainulation/mill export --format csv claims.json

Quick start

# Claims to CSV
mill export --format csv claims.json

# HTML brief to PDF
mill export --format pdf output/brief.html

# HTML to clean Markdown
mill convert --from html --to markdown output/brief.html

# Claims to JSON-LD
mill export --format json-ld claims.json -o claims.jsonld

# Build a static site from sprint outputs
mill publish --target static output/

# Copy to clipboard
mill publish --target clipboard output/brief.html

Export formats

26 built-in formats:

Format	Input	Output
pdf	HTML, Markdown	PDF
csv	claims.json	CSV
markdown	HTML	Markdown
json-ld	claims.json	JSON-LD (schema.org)
html-report	claims.json	Interactive HTML report
slide-deck	claims.json	Scroll-snap HTML presentation
github-issues	claims.json	GitHub Issues JSON payloads
jira-csv	claims.json	Jira-compatible CSV import
yaml	claims.json	YAML
ndjson	claims.json	Newline-delimited JSON
dot	claims.json	Graphviz DOT
graphml	claims.json	GraphML
bibtex	claims.json	BibTeX citations
ris	claims.json	RIS citations
rss	claims.json	RSS feed
opml	claims.json	OPML outline
obsidian	claims.json	Obsidian vault
sql	claims.json	SQL INSERT statements
typescript-defs	claims.json	TypeScript type definitions
executive-summary	claims.json	Executive summary HTML
evidence-matrix	claims.json	Evidence tier matrix
changelog	claims.json	Sprint changelog
sankey	claims.json	Sankey diagram data
treemap	claims.json	Treemap data

Run mill formats to see the full list with descriptions.

Publish targets

Target	Output
static	Dark-themed static site in _site/
clipboard	System clipboard (pbcopy/xclip/clip)

CLI

mill export    --format <fmt> <file>              Export to target format
mill convert   --from <fmt> --to <fmt> <file>     Convert between formats
mill publish   --target <dest> <dir>              Publish sprint outputs
mill formats                                      List available formats
mill serve     [--port 9094] [--source <dir>]     Start the export workbench UI
mill serve-mcp                                    Start the MCP server on stdio

All commands accept -o <path> to set the output location.

Works standalone

Mill reads sprint output files directly. It does not require wheat -- give it HTML, Markdown, or claims JSON and it produces shareable formats.

Zero third-party dependencies

Depends only on @grainulation/barn (internal ecosystem utilities); no third-party runtime deps. Node built-ins otherwise. Heavy operations (PDF) run via npx on demand.

Part of the grainulation ecosystem

Tool	Role
wheat	Research engine -- grow structured evidence
farmer	Permission dashboard -- approve AI actions in real time
barn	Shared tools -- templates, validators, sprint detection
mill	Format conversion -- export to PDF, CSV, slides, 26 formats
silo	Knowledge storage -- reusable claim libraries and packs
harvest	Analytics -- cross-sprint patterns and prediction scoring
orchard	Orchestration -- multi-sprint coordination and dependencies
grainulation	Unified CLI -- single entry point to the ecosystem

Releases

See CHANGELOG.md for release history.

License

MIT