@koda-sl/baker-cli 0.138.0-dev.29e3414e1 → 0.139.0-dev.da48e17cb

package/README.md

@@ -4620,6 +4620,21 @@ baker creatives publish ./canvas/<run_id>/<final>.png --title "Spring Offer 4x5"
 
 Without `--slug` the command behaves as before (one creative record per published image). With `--slug` it upserts the repo-convention row — the same one the dashboard's Creatives tab and the `src/creatives/{slug}/` folder describe — so publish, repo sync, and run history all land on a single record regardless of order.
 
+## Landing Quality (`baker landing`)
+
+Deterministic design-quality critic for landing pages — an offline, no-LLM detector for the well-known "AI slop" tells (gradient text, overused fonts like Inter, side-tab colored borders, cream/parchment grounds, purple-on-heading palettes, buzzword copy, broken images, and more). It scores a landing's `.astro` source and returns findings tiered **block / warn / advisory**.
+
+```bash
+baker landing critique spring-offer      # score src/pages/spring-offer/
+baker landing critique spring-offer --full   # also print advisory-tier findings
+```
+
+- **Advisory by design — always exits 0.** A finding is guidance, not a gate; the command never blocks a build or publish.
+- **BRAND.md is the allowlist.** A font, hue, or ground that the client's `src/brand/BRAND.md` (mirrored into `src/styles/global.css` `@theme`) commits is a decision, not a tell — matched values downgrade to advisory `brandDrift` so the critic never fights a real brand.
+- **Records a freshness snapshot** to `.cache/landing-critique/<slug>.json` (the source hash it scored). The publish quality gate reads it to enforce that every changed landing was critiqued and ships no block-tier tell. Re-run after edits so the snapshot stays fresh.
+
+Output is a JSON envelope: `{ ok, advisory, slug, overall, counts, dimensions, findings, hint }`. `dimensions` scores seven design families (typography, color, borders_depth, motion, spacing, copy, integrity) 0–1 (higher is better); `counts` is the block/warn/advisory tally.
+
 ## Help & Discovery
 
 Every command supports `--help` for usage info: