Build Standards

interface ListingProvider {
  search(query: ListingQuery): Promise<Page<Listing>>;
  get(listingKey: string): Promise<Listing | null>;
  openHouses(range: DateRange, area?: AreaRef): Promise<OpenHouse[]>;
  areas(prefix: string): Promise<AreaRef[]>;       // towns, neighborhoods, ZIPs
  attribution(listing: Listing): Attribution;     // MLS + listing office text, logo rules
  freshness(): Promise<{ updatedAt: string }>;    // shown on every results view
}

type Listing = {
  listingKey: string; mlsNumber: string;
  status: 'Active' | 'ActiveUnderContract' | 'Pending' | 'Closed' | 'ComingSoon';
  listPrice: number; closePrice?: number;
  address: { street: string; unit?: string; city: string; state: 'MA'; postalCode: string };
  geo?: { lat: number; lng: number };
  propertyType: 'Residential' | 'MultiFamily' | 'Condo' | 'Land' | 'Commercial';
  bedrooms?: number; bathroomsTotal?: number; livingArea?: number; lotSizeAcres?: number;
  yearBuilt?: number; units?: number; taxAnnual?: { amount: number; year: number };
  media: { url: string; width: number; height: number; caption?: string }[];
  remarks?: string;
  listOffice: { name: string; id: string }; listAgent?: { name: string; id: string };
  isOwnListing: boolean;   // true when listOffice is REWAP or an affiliated team
  updatedAt: string;
};

• Answer-readyEach guide opens with a two-sentence answer, then the detail. Questions as headings where natural; FAQ blocks only where questions are real.
• SourcedEvery market figure carries its source and date in the caption. Generative engines cite pages that cite.
• Equal regionsCommunity coverage is planned by region, so no part of the state is thin.

• theme.jsonPalette, type scale, spacing and layout widths from tokens/theme.json (draft). Editors pick only from the palette.
• PatternsEach composition in 6.4 and component in chapter 7 becomes a locked block pattern: Index, Plate, Statement, Catalogue, Ledger, CTA.
• Content typesCustom post types for Person, Team, Community and Market Update; taxonomies for Region and Town. Listings stay in the IDX layer, cached, not as posts.
• IDXThe vendor plugin supplies data only; its widgets are not used. A small REWAP plugin implements the adapter (9.4) and renders with the theme’s blocks.
• HostingCloudways, with page caching for content and short-lived object caching for listing queries.