[Madraka]

Stage 3 of #71, after RFC-0040 (collections) and RFC-0041 (typed fields). Status: Draft; nothing is implemented.

Key decisions

• Contract: three new optional collection settings, listFields (≤ 4 keys), expiry ({field, action: unlist|hide, afterMinutes?}) and structuredData ({type, properties}). contentList sections gain where (≤ 4 conditions) and orderBy. Which properties each type accepts, and with which field types, is a closed table in code. No schemaVersion bump.
• JSON-LD presets: Event, JobPosting, Product and Recipe.
  • FAQPage is out: Google deprecated FAQ rich results.
  • Organization and LocalBusiness belong in site settings later.
  • No rating or review properties, because self-serving review markup breaks Google's policy.
  • An entry missing a required value emits no preset.
  • A new withStructuredData() replaces the generic BlogPosting. entryHead is unchanged, so old themes keep today's output.
  • Output is escaped by jsonLdText, capped at 32 KB.
• Expiry is a render-time gate, not an automation. It reuses RFC-0008's time gates: min(availability.until, field date + grace).
  • unlist (default): the page stays live but leaves listings, feeds, the sitemap and search.
  • hide: 404.
  • No scheduler runs and nothing is rewritten, so nothing acts without a person. Moving a live gate earlier is treated like schedule_unpublish.
• Listings by field: a closed set of operators per type; sorting by number and dates only; now is the only relative value. One evaluator is shared by themes, ContentList, the API, MCP and Studio. No indexes in stage 3 (nodes is shared across sites); a side table follows only if a 10,000-entry benchmark needs it. Studio list columns come from listFields.
• Index pages: a "Create listing page" action creates an ordinary page with a contentList.
• Per-collection feeds: <prefix>/rss.xml through a middleware, only where the theme answers 404.
• References and repeaters: stage 4, with their own RFC.
• Rollout: six PRs.

Schema check: pnpm gen (TS + Rust), the core-contracts tests (492) and cargo test -p cloudhal-schema pass. cargo-typify merged two inline property enums into one type, so they moved into named $defs; the RFC records this.

The 11 open questions, with recommended defaults, are at the end of the RFC.

🤖 Generated with Claude Code