Authoring a recipe

type Recipe = {
  id: string;              // matches the catalog slug
  summary: string;         // one paragraph, shown on the component page
  databases: RecipeDb[];   // created first, base properties only
  views: ViewSpec[];       // created after the databases exist
  pages: RecipePage[];     // documentation, appended as block trees
  manual: RecipeManual[];  // the gaps, with reasons
};

type RecipeDb = {
  ref: string;             // local name other databases point at
  title: string;
  icon: string;            // single emoji
  isInline?: boolean;      // renders inline in its parent page
  properties: Record<string, PropertySchema>;
  seed?: Record<string, unknown>[];   // rows created after the schema settles
};

type RecipeManual = {
  title: string;
  reason: string;          // always a real API limitation, never a shortcut
  steps: string[];         // exact click path
};

{
  ref: "deals",
  title: "Deals",
  icon: "🤝",
  properties: {
    "Deal":      title(),
    "Amount":    num("dollar"),
    "Stage":     status([
      { name: "Qualified",     group: "In progress" },
      { name: "Proposal out",  group: "In progress" },
      { name: "Negotiation",   group: "In progress" },
      { name: "Won",           group: "Complete" },
      { name: "Lost",          group: "Complete" },
    ]),
    "Company":   relation("companies"),                       // ← by ref
    "Owner":     relation("people", {
      twoWay: true,
      syncedName: "Deals",                                    // ← name on the far side
    }),
    "Close date": date(),
    "Weighted":  formula(
      'prop("Amount") * if(prop("Stage") == "Qualified", 0.2, ' +
      'if(prop("Stage") == "Proposal out", 0.5, ' +
      'if(prop("Stage") == "Negotiation", 0.8, ' +
      'if(prop("Stage") == "Won", 1, 0))))'
    ),
    "Days open": rollup("Company", "Created", "earliest_date"),
  },
  seed: [
    { "Deal": "Northwind · Platform", "Amount": 48000, "Stage": "Proposal out" },
    { "Deal": "Aurelia Health",       "Amount": 180000, "Stage": "Negotiation" },
  ],
}

// board grouped by a status property
{ on: "deals", name: "Pipeline", type: "board",
  board: { group_by: "Stage" },
  sorts: [{ property: "Amount", direction: "descending" }] }

// calendar
{ on: "deals", name: "Close calendar", type: "calendar",
  calendar: { start_date_property: "Close date" } }

// form: Notion renders it as a public intake page
{ on: "intake", name: "New client intake", type: "form",
  form: { questions: [
    { property: "Company", required: true },
    { property: "What do you need?", required: true },
  ] } }

// chart
{ on: "logs", name: "Consistency", type: "chart",
  chart: { type: "bar", x_property: "Week", y_aggregate: "count" } }

// dashboard: layout is Notion's to compose
{ on: "habits", name: "Habit dashboard", type: "dashboard" }

{
  title: "How to run a sprint",
  icon: "🔁",
  blocks: [
    heading(2, "Monday: planning, 45 minutes"),
    numbered([t("Read the sprint goal out loud. If nobody can, rewrite it.")]),
    numbered([t("Pull from Backlog, not from Triage.")]),
    callout("Stop at capacity. Carry-over counts against capacity first.", "⚠️"),
    columns(
      [heading(3, "Daily"), bullet([t("15 minutes, standing up.")])],
      [heading(3, "Friday"), bullet([t("Demo, then retro.")])]
    ),
    simpleTable([
      ["Ritual", "When", "Owner"],
      ["Planning", "Monday 09:30", "PM"],
      ["Retro", "Friday 16:00", "Anyone"],
    ]),
  ],
}

curl -s -X POST localhost:3000/api/install \
  -H 'content-type: application/json' \
  -d '{"component":"crm-pipeline","mode":"plan"}' \
  | jq '.plan.calls[] | {method, path, note}'

# count the requests, check the order, read the warnings
curl -s -X POST localhost:3000/api/install \
  -H 'content-type: application/json' \
  -d '{"component":"crm-pipeline","mode":"plan"}' \
  | jq '{total: .plan.totalRequests, manual: .plan.manualSteps, warnings: .plan.warnings}'