astro-website/openspec/changes/archive/2026-02-10-better-cache/specs/wordpress-content-source/spec.md

MODIFIED Requirements

Requirement: Build-time caching

WordPress posts, pages, and categories MUST be written into the repo-local content cache used by the site build.

If the WordPress fetch fails, the system MUST NOT crash the entire build pipeline; it MUST either:

• keep the last-known-good cached WordPress content (if present), or
• store an empty WordPress dataset and allow the rest of the site to build.

When the cache layer is configured and reachable, the WordPress ingestion MUST cache wp-json responses (or normalized outputs) using a TTL so repeated ingestion runs avoid unnecessary network requests and parsing work.

Scenario: WordPress fetch fails

• WHEN a WordPress API request fails
• THEN the site build can still complete and the blog surface renders a graceful empty state

Scenario: Cache hit avoids wp-json refetch

• WHEN WordPress ingestion is executed within the configured cache TTL
• THEN it uses cached data instead of refetching from wp-json