SheetSpec v0.1.0
SheetSpec v0.1.0
SheetSpec is a contract testing and quality gate for spreadsheets created by AI agents.
Highlights
- YAML workbook acceptance contracts with SHA-256 locks
- 11 validation rule types, including formula consistency and baseline protection
- CLI, JSON, HTML reports, and local STDIO MCP server
- Structured machine-readable issues for Agent repair loops
- Workbook diff support and a complete broken/fixed annual sales report demo
- Python 3.11?3.13 CI matrix
Quick start
uv sync
uv run sheetspec inspect examples/sales-report-fixed.xlsx
uv run sheetspec check examples/sales-report-fixed.xlsx \
--spec examples/sales-report.spec.yaml \
--format jsonSheetSpec validates explicitly declared acceptance rules; it does not claim that a workbook is universally correct.