Shared tools for the grainulation ecosystem.

Barn extracts the reusable utilities from wheat into a standalone package. Sprint detection, manifest generation, PDF builds, and 17 HTML templates for research artifacts.

Install

npm install @grainulation/barn

Or use directly:

npx @grainulation/barn detect-sprints --json

Tools

detect-sprints

Find sprint directories in a repo by scanning for claims.json files. Uses git history to determine which sprint is active.

barn detect-sprints # Human-readable output
barn detect-sprints --json # Machine-readable JSON
barn detect-sprints --active # Print only the active sprint path
barn detect-sprints --root /path # Scan a specific directory

generate-manifest

Build a wheat-manifest.json topic map from claims, files, and git history. Gives AI tools (and humans) a single file that describes the entire sprint state.

barn generate-manifest # Write wheat-manifest.json
barn generate-manifest --root /path # Target a specific repo
barn generate-manifest --out custom-name.json # Custom output path

build-pdf

Convert markdown to PDF via md-to-pdf (invoked through npx -- no local install needed).

barn build-pdf output/brief.md

Templates

17 self-contained HTML templates for sprint artifacts. Dark theme, inline CSS/JS, no external deps, mobile responsive.

Template	Purpose
adr.html	Architecture Decision Record
brief.html	Sprint brief / recommendation document
certificate.html	Compilation certificate
changelog.html	Sprint changelog
comparison.html	Side-by-side comparison dashboard
conflict-map.html	Claim conflict visualization
dashboard.html	Sprint status dashboard
email-digest.html	Email digest summary
evidence-matrix.html	Evidence tier matrix
explainer.html	Full-screen scroll-snap presentation
handoff.html	Knowledge transfer document
one-pager.html	Single-page executive summary
postmortem.html	Sprint postmortem
rfc.html	Request for Comments
risk-register.html	Risk tracking register
slide-deck.html	Slide deck presentation
wiki-page.html	Wiki-style documentation page

cp node_modules/@grainulation/barn/templates/explainer.html ./output/

Zero dependencies

Node built-in modules only. No npm install waterfall.

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