IMPORTANT: Developer documentation for the current development branch. This content is unreleased, may change without notice, and must not be treated as Buildish release documentation.
Pipeline model schema reference
This reference is generated from the Site Pipeline Pydantic models and checked-in reference metadata. Do not edit it by hand; regenerate it with
make schemas.This reference describes the current public contracts exposed by the Site Pipeline model layer. It covers authored inputs, provider inputs, pipeline-emitted outputs, shared scalars, enums, and the detailed field rules for each typed contract.
How to read this reference
- file-contract pages identify the stable on-disk file for each root contract, if applicable
- field names are shown in their wire-format aliases
- type, enum, and scalar names link to their definitions on the detailed pages
- schema files link to the published JSON Schema contract for the matching root type
Reference pages
- File contract index — authored, provider, and emitted file/root contract tables.
- Shared types reference — shared scalar aliases and enums.
- Authored input types — Consumer-owned and component-owned authored contract models.
- Provider input types — Normalized provider snapshot contracts consumed by the pipeline.
- Planning and stage-contract types — Pipeline-emitted planning, diagnostics, and stage-manifest contracts.
- Staged front matter types — Front matter and page-level metadata emitted into staged content.
- Staged aggregate metadata types — Public aggregate JSON contracts emitted under
data/. - Incremental bookkeeping types — Pipeline-internal emitted bookkeeping contracts stored under
data/_pipeline/.
Coverage notes
- generated schema files:
25 - stable contract pages are split by contract family to keep navigation and review manageable.