Report schema

Every report the engine ships validates against this schema (packages/schema/json/report.schema.json, generated from Zod and checked for drift in CI). Numbers in text are {{N…}} placeholders that resolve to facts; every fact carries its computation (SQL with parameters, or a function and its inputs) and citations; every claim carries citations and a causal grade.

Field	Required	Type	Notes
schema	yes	string
job_id	yes	string
generated_at	yes	string
engine	yes	object
period	yes	object
objective	yes	object
sources	yes	array
metrics	yes	array
assumptions	yes	array
data_quality	yes	array
summary	yes	object
findings	yes	array
recommendations	yes	array
open_questions	yes	array
facts	yes	array
verification	yes	object
evidence	no	array
roles	no	array
table_kinds	no	array
business_model	no	object

The complete schema: report.schema.json. The fixture packages/schema/test/fixtures/report.coffee-roaster.json is a full example.