RosterFair v0.1.0

RosterFair v0.1.0

RosterFair turns a plain JSON roster into verifiable, reproducible group or seating assignments. It is designed for classrooms, workshops, weddings, volunteer shifts, and multi-round rotations.

Highlights

• Exact hard-constraint feasibility: together, apart, fixed placement, allowed groups, and attribute limits.
• Explainable soft optimization for balance, diversity, preferences, and avoided repeat pairings.
• Deterministic output from a seed, plus multi-round history support and infeasibility diagnostics.
• A zero-dependency Node.js CLI with JSON, CSV, and self-contained offline HTML reports.
• Five runnable examples, JSON Schema, troubleshooting guidance, and a cross-platform CI matrix.

Validate locally

npm ci
npm run verify
npm run release:check

Install

npm install -g rosterfair
rosterfair demo --format html --output rosterfair-demo.html

Release assets include SHA-256 checksums in SHA256SUMS.txt.