`docs/source-runbooks/meridian-homes.md`

19 lines
# Source runbook — meridian-homes-fixtures

**What it is:** the reference FIXTURE adapter. Meridian Homes is a fictional builder;
its "site" is 5 local HTML files in `fixtures/raw-pages/meridian-homes/`. No live
fetching exists for this source.

- Registry key: `meridian-homes-fixtures` · method FIXTURE · media rights NONE
- Adapter: `collectors/meridian-homes` (extractor v1.0.0), contract-pinned by
  `fixtures/expected-records/meridian-homes.json` and `src/extract.test.ts`
- Run: `DATABASE_URL=… pnpm --filter @homesonspec/workers pipeline -- --adapter=meridian-homes-fixtures`
- Page order matters: the community page sorts first (01-…), so the publish stage
  creates the Community row before homes validate FK integrity.
- Known quirks encoded in fixtures: `03-home-124-silverleaf.html` has no price
  (proves null-never-guessed); `05-incentives.html` has one incentive without an
  expiration (proves the "expiration not provided" label path).

Use this runbook as the template for real builder runbooks: registry facts, adapter
path, run command, page-order requirements, and per-source quirks.