docs(recipes): update shape comments for sectioned RecipeContent

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: ALai57

plans/2026-07-10-recipes-feature/PLAN.md

@@ -1,5 +1,9 @@
 # Recipes Feature — Scrape, Edit, Search, Share
 
+> **Superseded in part:** `RecipeContent` was reshaped to paired sections with
+> steps-as-data (no `instructions-html`) before first release — see
+> `plans/2026-07-11-recipe-sections/DESIGN.md`. Shape details below are historical.
+
 > **Implementation status (2026-07-11)** — built on branch `plans/recipes-feature` in both repos.
 > **Backend (kaleidoscope), done + tested:** migration (5 tables, one-per-group + composite-tenant constraints), `api/access` shared visibility, `api/recipes` (CRUD, labels/groups, one-per-group validation, ingredient search, audiences), `api/recipe_scraper` (SSRF-guarded fetch, JSON-LD, LLM fallback), `http_api/recipes` routes + ACL. Full suite green (196 tests). Phases 1, 3, 4, 5 complete.
 > **Frontend (kaleidoscope-ui), done + tested:** `types/recipe`, `api/recipes` (+13 tests), `LabelPicker` (+7 tests), `RecipesPage`/`RecipePage`/`RecipeEditorPage` (+ list-filter and scrape→save tests), routes/nav/manager card. Typecheck + lint clean; 24 recipe tests green. Phase 2 complete.

resources/migrations/20260711000001-add-recipes.up.sql

@@ -1,14 +1,15 @@
 -- Recipes: scrape/edit/search/share domain. See plans/2026-07-10-recipes-feature/PLAN.md.
 --
 -- Identity is a single opaque UUID; recipe_url is the address (slug), not a
--- second identity. Recipe content (title, ingredients, instructions, servings,
--- times) is one JSONB value shape; `content` is the current recipe and
--- `original_content` is the immutable scrape — same shape, cannot drift.
+-- second identity. Recipe content is one JSONB value shape: {title, sections
+-- [{name?, ingredients [string], steps [string]}], servings?, times?} (see
+-- plans/2026-07-11-recipe-sections/DESIGN.md); `content` is the current recipe
+-- and `original_content` is the immutable scrape — same shape, cannot drift.
 CREATE TABLE recipes (
   id                UUID DEFAULT gen_random_uuid() PRIMARY KEY,
   recipe_url        VARCHAR NOT NULL,          -- address (slug)
   hostname          VARCHAR NOT NULL,          -- tenant
-  content           JSONB NOT NULL,            -- {title, ingredients[], instructions_html, servings?, prep_time_minutes?, cook_time_minutes?}
+  content           JSONB NOT NULL,            -- {title, sections[{name?, ingredients[], steps[]}], servings?, prep_time_minutes?, cook_time_minutes?}
   original_content  JSONB,                     -- immutable scrape; same shape as `content`
   source_url        VARCHAR,
   author            VARCHAR,