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, 24 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 |

License

MIT