Skip to content

SheetSpec v0.1.0

Choose a tag to compare

@helloo1568 helloo1568 released this 18 Jul 11:49

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 json

SheetSpec validates explicitly declared acceptance rules; it does not claim that a workbook is universally correct.