@appinternalleads/ui 0.2.0

package/spec/QUESTION-SCHEMA.md

@@ -0,0 +1,395 @@
+# Question schema v1
+
+**Status** Draft for review.
+**Supersedes** the `Field` spec in `packages/connectors/src/api/connectors.ts:118`.
+**Date** 4 September 2026
+
+The JSON an agent is handed to render a question — one step of a flow that asks the user for
+input, on both React and React Native.
+
+---
+
+## 1. What changed from the shipped spec, and why
+
+`Field` v2 ships today and is posted back to `/shortcuts` by `createActionShortcut`. This
+schema replaces it, and **the backend migrates to match** — so there is one vocabulary rather
+than a translation layer that can silently drop a key.
+
+| v2 | v1 of this schema | Reason |
+|---|---|---|
+| `key` | `key` | Kept. `asks[].key` in `voice.ts` already joins on it |
+| `type` (11 values) | `type` (11 values) | **Kept verbatim.** The enum is right; it was never the problem |
+| — | `control` | **New.** Presentation, split out of `type` |
+| — | `constraints` | **New.** `min`/`max`/`maxLength`/`step`, nested and validated per type |
+| — | `default` | **New.** Genuinely absent today |
+| `example` | `example` | Kept — "a short specimen value, never prose" |
+| `hint` | `hint` | Kept |
+| `placeholder` | — | **Retired.** Already marked deprecated in v2; `example` is the live name |
+| `options`, `itemType`, `source`, `children` | unchanged | **Kept.** Dropping `source` costs a field its runtime option picker |
+| `required` | `required` | Kept |
+
+### 1.1 The split that motivated this
+
+v2 made `type` carry two unrelated jobs. A stepper is not a kind of text — it is a way of
+presenting a number. Conflating them makes `type: "text"` / `control: "stepper"` /
+`returns: "number"` expressible, which is a category error the schema should not be able to
+state.
+
+Three orthogonal axes now:
+
+```
+type         what the data IS         number
+control      how it is PRESENTED      stepper
+constraints  what values are LEGAL    { min: 0, max: 47, step: 1 }
+```
+
+**`returns` is gone.** It was derivable from `type` in every case (§4), and a derivable field
+is a field that drifts.
+
+### 1.2 Two renames
+
+`provenance` replaces the block-level `kind`, which collided with the field-level `kind`
+meaning something unrelated in the same document. `declared` is already the widget contract's
+provenance word, so this names it correctly rather than inventing a synonym.
+
+`slug` is the block id; `key` is the field id. Both kebab-case (§6).
+
+---
+
+## 2. The block
+
+```json
+{
+  "schema": "question/1",
+  "slug": "role-setup",
+  "provenance": "declared",
+  "blocking": true,
+  "step": { "index": 1, "label": "Setup" },
+  "question": "A couple of things before we start.",
+  "fields": [ ... ]
+}
+```
+
+| Key | Required | Notes |
+|---|---|---|
+| `schema` | yes | `question/1`. Version is in the payload, not in a filename |
+| `slug` | yes | Kebab. Unique per flow |
+| `provenance` | no | `declared` \| `inferred`. Default `declared` |
+| `blocking` | no | Default `true`. `false` means the run proceeds and collects later |
+| `step` | no | `{ index, label }`. **1-based**, matching the widget contract's collection steps |
+| `question` | yes | The prompt. A sentence, not a label |
+| `fields` | yes | ≥1 |
+
+**`blocking` is load-bearing.** `voice.ts` warns that under-promising asks is not a cosmetic
+miscount: *"I'll ask you for these when it runs" is the sentence that makes a plan with blanks
+read as finished rather than half-built.* A non-blocking question that the run later demands
+spends exactly that trust. The set of `blocking: true` fields must equal what `compileFlow`
+collects.
+
+---
+
+## 3. The field
+
+```json
+{
+  "key": "shortlist-size",
+  "type": "number",
+  "control": "stepper",
+  "label": "Shortlist size",
+  "required": false,
+  "default": 10,
+  "constraints": { "min": 0, "max": 47, "step": 1 },
+  "hint": "Top {default} of {constraints.max} will be shown for review."
+}
+```
+
+| Key | Applies to | Notes |
+|---|---|---|
+| `key` | all | Kebab, unique within the block |
+| `type` | all | §4 |
+| `control` | all | §5. Omit for the type's default |
+| `label` | all | The field's name |
+| `required` | all | Default `false` |
+| `default` | all | Type must match the type's value shape (§4) |
+| `example` | scalars | A specimen value. **Never prose** |
+| `hint` | all | Full description. Templatable (§7) |
+| `constraints` | per type | §5 |
+| `options` | `enum`, `list` | Static options |
+| `source` | `enum`, `list` | `{ tool, args, labelPath, valuePath }` — runtime options from a sibling `LIST_*` tool |
+| `itemType` | `list` | Element type |
+| `children` | `group`, `variant` | Nested fields |
+| `showIf` | all | `{ "<key>": <value> }` — conditional visibility |
+
+A field carrying a key its type does not permit is a **schema error**, not an ignored extra.
+
+---
+
+## 4. Types and their value shapes
+
+`returns` was removed because this table is total.
+
+| `type` | Value | Default `control` |
+|---|---|---|
+| `text` | string | `single` |
+| `email` | string | `single` |
+| `number` | number | `single` |
+| `toggle` | boolean | `switch` |
+| `date` | string, ISO date | `picker` |
+| `datetime` | string, ISO datetime | `picker` |
+| `enum` | string | `select` |
+| `list` | array | `tags` |
+| `group` | object | `section` |
+| `variant` | tagged object | `tabs` |
+| `json` | unknown | `code` |
+| `range` | `[number, number]` | `track` |
+| `counters` | `Record<string, number>` | `rows` |
+| `share` | string — the picked slice's key | `donut` |
+| `file` | `FileRef[]` | `dropzone` |
+| `media` | `FileRef` | `audio` |
+| `action` | nothing — the outcome IS the answer | `buttons` |
+
+**The last six were added for the input widgets** (decision Q1a). Nine of the 26 returned shapes
+this table had no words for, and they were added here rather than given a second schema: two
+vocabularies means every agent needs a rule for choosing between them, and that rule becomes the
+thing nobody can change. A wide union is a manageable cost; two schemas is a permanent tax.
+
+**Progress readouts (22–26) are deliberately absent, and so is 20 · Step Executor.** They return
+nothing. Putting them here would make `question/1` mean two verbs — asking and reporting — and the
+app already holds the run state those five draw from (decision Q5c). If an agent should ever drive
+progress, that is a `progress/1`, addable without touching any of this.
+
+**Email is a type, not a format.** v2 already made that call and the backend enum encodes it;
+a `format` modifier on `text` would be a second way to say the same thing.
+
+---
+
+## 5. Legal controls and constraints, per type
+
+| `type` | `control` | `constraints` |
+|---|---|---|
+| `text` | `single` · `multi` | `minLength` · `maxLength` · `pattern` |
+| `email` | `single` | `maxLength` |
+| `number` | `single` · `stepper` · `slider` | `min` · `max` · `step` · `precision` |
+| `toggle` | `switch` · `checkbox` | — |
+| `date` · `datetime` | `picker` | `min` · `max` (ISO) |
+| `enum` | `select` · `radio` · `segmented` · `chips` · `cards` · `arc` · `checkboxes` | — |
+| `list` | `tags` · `repeater` | `minItems` · `maxItems` |
+| `group` | `section` · `card` | — |
+| `variant` | `tabs` · `select` | — |
+| `json` | `code` | `maxBytes` |
+| `range` | `track` | `min` · `max` · `step` |
+| `counters` | `rows` | `min` · `max` (per row) |
+| `share` | `donut` | — |
+| `file` | `dropzone` | `maxItems` · `maxBytes` · `accept` |
+| `media` | `audio` | `maxSeconds` |
+| `action` | `buttons` | — |
+
+`date` and `datetime` also take `presets`, which stores the **rule** (`next-monday`) rather than a
+resolved date — a resolved date is how a run resumed on Thursday books last week.
+
+Enforced by `if`/`then` in the JSON Schema, so `maxLength` on a stepper is rejected at
+validation rather than ignored at render.
+
+---
+
+## 6. Naming
+
+**Kebab-case throughout**, block slugs and field keys alike: `role-setup`, `shortlist-size`,
+`title`, `recipient`, `note`. One rule, no exceptions, URL-safe.
+
+Pattern: `^[a-z0-9]+(-[a-z0-9]+)*$`
+
+Two consequences, both accepted:
+
+- The dotted namespace in `role.setup` is gone. A block is a flat id; hierarchy lives in the
+  flow, not in string punctuation.
+- Answers are addressed as `answers['shortlist-size']`, not `answers.shortlistSize`. Keys are
+  data, not identifiers.
+
+---
+
+## 7. Hint templating
+
+`hint` and `question` interpolate the field's own resolved values:
+
+```json
+"hint": "Top {default} of {constraints.max} will be shown for review."
+```
+
+This exists because the original copy read *"Top 10 of 47 will be shown for review"* with `10`
+and `47` written out — which is correct exactly until someone changes `max`, and then it is a
+lie that nothing detects. Only `{default}` and `{constraints.*}` resolve; an unresolvable
+reference fails validation.
+
+---
+
+## 8. Backend migration
+
+Chosen deliberately over an adapter, so no key can be lost in translation.
+
+1. `FieldType` enum is **unchanged** — no data migration for `type`.
+2. Add `control`, `constraints`, `default` to the `Field` zod schema, all optional.
+3. Retire `placeholder`; backfill any stored value into `example` where `example` is empty.
+4. Normalise stored `key` values to kebab. **This one rewrites rows** and needs a reversible
+   migration — old keys must keep resolving for one release, since `asks[].key` joins on them.
+5. `.catch('text')` on `FieldType` stays. An unknown type from a newer server rendering as text
+   is the right failure.
+
+Step 4 is the only lossy step and the only one that needs a rollback path.
+
+---
+
+## 9. Open
+
+1. **`showIf` expressiveness.** Equality against one key covers most forms. Anything richer is a
+   predicate language, and those grow without limit — worth resisting until a real form needs it.
+2. **`variant` rendering** is the one recursive case with no built precedent in the DS.
+3. **Non-blocking questions have no collection point yet.** `blocking: false` is expressible
+   before there is a place to ask it later.
+
+---
+
+## 10. Multi-select, and rich options
+
+**`enum` + `multiple: true` → the answer is `string[]`** (decision Q3a). It was the single most
+common missing case: `enum` was single-select, `list` is free entry, and *"tick any of these four
+channels"* had no representation at all. A flag on `enum` keeps one type for one idea — a closed
+set — where a separate `multi-enum` would have split it.
+
+The schema enforces the pairing: `checkboxes` requires `multiple`, and `multiple` refuses
+`select`, `radio` and `arc`, which are single-select drawings. A `multiple` field's `default` must
+be an array — getting that wrong silently seeds the wrong shape into the answer object.
+
+**An option may be a bare string or an object** (decision Q4a):
+
+```jsonc
+{ "value": "maya", "label": "Maya Idris", "rank": 1, "score": 94,
+  "note": "Shipped two fintech onboarding flows; writes her own copy.",
+  "escape": false }
+```
+
+Bare strings remain legal and remain the common case. The object exists because *score and reason
+must travel to every option shape* — a card face showing only a name has hidden the run's work.
+
+**⚠ The producer side is the real cost, not the schema.** `score` and `note` are run output
+leaking into an ask: whatever composes this JSON now needs access to *why the ranker ranked*. That
+coupling was accepted deliberately, and it is the larger half of the work.
+
+**`counter` is not `submit`.** A submit label is a verb the user presses; a counter line states
+what is currently true. Reusing one for the other produced *"Use 1 channels"* on the first
+spec-driven render. `counter` is legal on `enum` and `counters`; `submit` on the widgets that
+actually submit.
+
+**`escape: true` marks the way out** — *"I don't know"*, *"I can't tell"*, *"Not yet"*. It renders
+muted until picked, so it reads as an escape rather than a candidate. It is a flag rather than a
+recognised phrase because matching prose was wrong twice in one afternoon: it missed *"I can't
+tell — keep both"* and *"Not yet — leave them unfiled"*, which are escapes by any reading.
+
+---
+
+## 10b. What the card shows, and where
+
+**The header is a NAME. The question is a sentence, and it goes in the body.**
+
+| Slot | From |
+|---|---|
+| pill | the field's `type` — a category, never a topic |
+| title | the field's `label` |
+| body lead | the block's `question`, on a container or a composite |
+| in-body label | the field's `label`, unless the header already says it |
+| helper | the field's `hint`, templated |
+| prompt bubble | **the app**, from the transcript (decision Q12b) |
+
+Two renders settled this, and neither was predicted by a test:
+
+1. Driving the title from `label` and the in-body label from `label` printed the same word twice.
+2. Driving the title from `question` **clipped thirteen of the twenty headers** — the header is
+   one line by design, and that rule was written for `Card Picker`, not for *"Which pipeline
+   should the shortlist go into?"*.
+
+So the title names the ask and the question sits in the body, which is what widget 06 already
+did with its own. A multi-field card takes its name from `step.label`, or from its slug —
+`new-search` → `New search`.
+
+---
+
+## 11. `preferred` — the widget hint
+
+**A hint, honoured when legal and dropped when not** (decision Q2b).
+
+The agent states what the answer IS; the renderer picks how to draw it. `preferred` is the escape
+valve for when that derivation is wrong, and it is safe precisely because it cannot corrupt the
+contract: a stored `preferred` that a later change makes illegal degrades to the derived widget
+rather than failing a question that was valid when it was written. That is what keeps the
+change-every-ask-at-once property that naming widgets directly would destroy.
+
+A misspelt name is still a validation error — the enum is closed. Legality is about the field's
+type, not its spelling.
+
+---
+
+## 12. What comes back — `answer/1`
+
+**Always the envelope, never a bare value** (decision Q8b), and it travels **alone** (Q9a): the
+block is not echoed back, because whoever asked still has it.
+
+```jsonc
+{
+  "schema": "answer/1",
+  "slug": "shortlist-review",
+  "at": "2026-09-05T10:14:00Z",
+  "state": "answered",          // answered | skipped | superseded | failed
+  "answers": { "keep": ["maya", "tobias"] },
+  "outcome": "accept",          // accept | reject | cancel
+  "rejection": "re-plan",       // re-plan | widen | escalate | hard-stop
+  "overrode": { "chose": "tobias", "over": "maya", "score": 94 },
+  "degraded": false,
+  "superseded": false
+}
+```
+
+An agent that cannot tell *skipped* from *never answered* will re-ask, or proceed as though it had
+an answer. Making that distinction conditional on `blocking` would return the failure exactly
+where the stakes are lowest and the volume highest, so it is unconditional.
+
+### ⚠ `superseded` is the app's obligation, not the library's
+
+`resolution` is a schema property. **"Re-opening an answered ask marks the run for re-planning
+from that point" is not** — it is a statement about run control, and nothing in this library can
+enforce it.
+
+This is the one place in the contract where a component library describes something outside its
+own reach. It is named here so it is read as **an obligation on whoever receives the envelope**
+rather than as behaviour the library provides. Concretely, on `superseded: true` the host must:
+
+1. treat every downstream step derived from that answer as invalid;
+2. re-plan from the superseded ask rather than resuming after it;
+3. keep the previous answer, because *what changed* is often the useful part.
+
+A host that ignores `superseded` gets a run that carries on with an answer the user has withdrawn,
+and nothing in this library will detect it.
+
+---
+
+## 13. The quality linter
+
+The schema rejects what is **invalid**; `lintQuestion` warns about what is merely **poor**
+(decision Q10c). It never refuses — every finding is `warn` or `info`, and the renderer does not
+call it. Hosts run it in development.
+
+It warns rather than blocks because a blocking linter written before there is agent output to
+measure encodes guesses about quality, and the first month goes on suppressing rules rather than
+fixing asks. Two rules were already demoted or narrowed by running it against the twenty shipped
+fixtures — which is the intended failure mode working.
+
+| Rule | Level | Says |
+|---|---|---|
+| `too-many-fields` | warn | past six, an ask is usually two asks wearing one card |
+| `segmented-too-wide` | warn | past four the labels shrink below legible |
+| `radio-too-long` / `select-too-short` | warn / info | eight is the boundary between rows and a menu |
+| `no-escape-option` | warn | a required single-select with no escape **and no default** |
+| `notes-not-shown` | warn | options carry notes the chosen control cannot draw |
+| `share-does-not-sum` | warn | **the one rule JSON Schema cannot hold** — it cannot sum an array |
+| `slider-without-bounds` | warn | a track with no ends means nothing |
+| `preferred-dropped` | info | a hint that was not legal here, so the derived widget rendered |
+| `blocking-without-reason` | info | a derived halt with nothing said about what it found |

package/spec/component.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "component/1",
+  "title": "Component JSON — layer 2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "slug", "tree"],
+  "properties": {
+    "schema": { "const": "component/1" },
+    "slug": {
+      "description": "kebab-case, the same rule question/1 uses. The component's exported name is derived from it — status-chip becomes StatusChip — so there is one identifier, not a name and an id that can disagree.",
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+    },
+    "description": { "type": "string" },
+    "props": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/prop" }
+    },
+    "tree": { "$ref": "#/$defs/node" },
+    "variants": { "type": "array", "items": { "$ref": "#/$defs/variant" } },
+    "notes": { "type": "array", "items": { "type": "string" } }
+  },
+
+  "$defs": {
+    "prop": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type"],
+      "properties": {
+        "type": { "enum": ["string", "number", "boolean", "enum", "node"] },
+        "values": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "required": { "type": "boolean" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "enum" } }, "required": ["type"] },
+          "then": { "required": ["values"] }
+        }
+      ]
+    },
+
+    "node": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["primitive"],
+      "properties": {
+        "primitive": {
+          "description": "The closed primitive set. Anything else is rejected here rather than at emit.",
+          "enum": [
+            "Box", "Text", "Input", "Pressable", "Icon",
+            "Image", "Scroll", "Slider", "DatePicker", "Switch", "Sheet"
+          ]
+        },
+        "layout": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "direction": { "enum": ["row", "column"] },
+            "align": { "type": "string" },
+            "justify": { "type": "string" },
+            "wrap": { "type": "boolean" },
+            "gap": { "type": "number" },
+            "padding": { "type": "number" },
+            "paddingX": { "type": "number" },
+            "paddingY": { "type": "number" }
+          }
+        },
+        "style": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "background": { "type": "string" },
+            "color": { "type": "string" },
+            "borderRadius": { "type": "number" },
+            "fontSize": { "type": "number" },
+            "lineHeight": { "type": "number" },
+            "fontFamily": { "type": "string" },
+            "boxShadow": { "type": "string" }
+          }
+        },
+        "content": { "type": "string" },
+        "icon": { "type": "string" },
+        "children": { "type": "array", "items": { "$ref": "#/$defs/node" } }
+      }
+    },
+
+    "variant": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["when"],
+      "properties": {
+        "when": { "type": "object", "minProperties": 1, "maxProperties": 1 },
+        "at": {
+          "description": "Path to the node this variant overrides, as child indices from the root.",
+          "type": "array",
+          "items": { "type": "integer", "minimum": 0 }
+        },
+        "style": { "type": "object" }
+      }
+    }
+  }
+}

package/spec/components/status-chip.json

@@ -0,0 +1,36 @@
+{
+  "schema": "component/1",
+  "slug": "status-chip",
+  "description": "A status word on its ground. The dot beside it is redundant by design.",
+  "props": {
+    "status": {
+      "type": "enum",
+      "values": ["executed", "running", "queued", "error"],
+      "required": true
+    },
+    "label": { "type": "string", "required": true }
+  },
+  "tree": {
+    "primitive": "Box",
+    "layout": { "direction": "row", "align": "center", "gap": 4, "paddingX": 8, "paddingY": 4 },
+    "style": { "background": "#DEEFE2", "borderRadius": 8 },
+    "children": [
+      {
+        "primitive": "Text",
+        "style": { "color": "#2C7247", "fontSize": 13, "lineHeight": 18, "fontFamily": "Switzer" },
+        "content": "{label}"
+      }
+    ]
+  },
+  "variants": [
+    { "when": { "status": "running" }, "style": { "background": "#F8F3D8" } },
+    { "when": { "status": "running" }, "at": [0], "style": { "color": "#8A6D12" } },
+    { "when": { "status": "queued" }, "style": { "background": "#F3F0EA" } },
+    { "when": { "status": "queued" }, "at": [0], "style": { "color": "#6E6862" } },
+    { "when": { "status": "error" }, "style": { "background": "#F8E4E0" } },
+    { "when": { "status": "error" }, "at": [0], "style": { "color": "#A33224" } }
+  ],
+  "notes": [
+    "Contract §2.4. status.running #F8F3D8 and kind.action #FBF3D8 are one digit apart and are different tokens."
+  ]
+}

package/spec/examples/all-types.json

@@ -0,0 +1,43 @@
+{
+  "schema": "question/1",
+  "slug": "every-type",
+  "provenance": "declared",
+  "blocking": true,
+  "step": { "index": 2, "label": "Everything" },
+  "question": "One field of every type the schema defines.",
+  "fields": [
+    { "key": "title", "type": "text", "control": "single", "label": "Title",
+      "required": true, "example": "Senior Backend Engineer",
+      "constraints": { "maxLength": 80 } },
+    { "key": "note", "type": "text", "control": "multi", "label": "Note",
+      "constraints": { "maxLength": 600 } },
+    { "key": "recipient", "type": "email", "label": "Recipient", "required": true },
+    { "key": "shortlist-size", "type": "number", "control": "stepper", "label": "Shortlist size",
+      "default": 10, "constraints": { "min": 0, "max": 47, "step": 1 },
+      "hint": "Top {default} of {constraints.max} will be shown for review." },
+    { "key": "weight", "type": "number", "control": "slider", "label": "Weight",
+      "default": 30, "constraints": { "min": 0, "max": 100, "step": 5 } },
+    { "key": "notify", "type": "toggle", "control": "switch", "label": "Notify me" },
+    { "key": "starts", "type": "date", "label": "Starts",
+      "constraints": { "min": "2026-01-01", "max": "2026-12-31" } },
+    { "key": "at", "type": "datetime", "label": "At" },
+    { "key": "stage", "type": "enum", "control": "radio", "label": "Stage",
+      "options": ["Draft", "Review", "Shipped"] },
+    { "key": "channel", "type": "enum", "control": "select", "label": "Channel",
+      "source": { "tool": "SLACK_LIST_CHANNELS", "labelPath": "name", "valuePath": "id" } },
+    { "key": "tags", "type": "list", "control": "tags", "label": "Tags",
+      "itemType": "text", "constraints": { "maxItems": 5 } },
+    { "key": "payload", "type": "json", "control": "code", "label": "Payload",
+      "constraints": { "maxBytes": 4096 } },
+    { "key": "contact", "type": "group", "control": "card", "label": "Contact",
+      "children": [
+        { "key": "name", "type": "text", "label": "Name", "required": true },
+        { "key": "email", "type": "email", "label": "Email", "required": true }
+      ] },
+    { "key": "target", "type": "variant", "control": "tabs", "label": "Send to",
+      "children": [
+        { "key": "to-email", "type": "email", "label": "Email", "required": true },
+        { "key": "to-channel", "type": "text", "label": "Channel", "required": true }
+      ] }
+  ]
+}

package/spec/examples/components/checklist/assigned.json

@@ -0,0 +1,103 @@
+{
+  "schema": "checklist/1",
+  "checklist": {
+    "id": "cl-move",
+    "title": "Moving in",
+    "description": "Everything that has to happen before and after the keys change hands.",
+    "sections": [
+      {
+        "id": "s-before",
+        "title": "Before you move in",
+        "tasks": [
+          {
+            "id": "t-lease",
+            "title": "Sign the lease",
+            "done": true,
+            "assigneeId": "p-ana"
+          },
+          {
+            "id": "t-deposit",
+            "title": "Pay the deposit",
+            "done": true,
+            "description": "Two months, held by the scheme."
+          },
+          {
+            "id": "t-standing",
+            "title": "Set up the standing order",
+            "done": false,
+            "assigneeId": "p-ben"
+          },
+          {
+            "id": "t-van",
+            "title": "Book the van",
+            "done": false,
+            "required": false
+          },
+          {
+            "id": "t-meter",
+            "title": "Read the meters",
+            "done": false
+          }
+        ]
+      },
+      {
+        "id": "s-after",
+        "title": "After you move in",
+        "tasks": [
+          {
+            "id": "t-council",
+            "title": "Tell the council",
+            "done": false,
+            "assigneeId": "p-nobody"
+          },
+          {
+            "id": "t-broadband",
+            "title": "Move the broadband",
+            "done": false
+          },
+          {
+            "id": "t-post",
+            "title": "Redirect the post",
+            "done": false,
+            "required": false
+          }
+        ]
+      }
+    ]
+  },
+  "config": {
+    "showDescription": true,
+    "taskDescriptions": "shown",
+    "assignees": "editable",
+    "progress": "both",
+    "sections": "grouped",
+    "collapsibleSections": true,
+    "can": {
+      "editChecklist": true,
+      "complete": true,
+      "skip": false,
+      "addTask": true,
+      "editTask": true,
+      "deleteTask": true,
+      "addSection": true,
+      "editSection": true,
+      "deleteSection": true,
+      "reorder": true,
+      "assign": true
+    },
+    "sharing": {
+      "enabled": false
+    },
+    "notifications": {
+      "enabled": false,
+      "channels": []
+    },
+    "copy": {
+      "emptyLabel": "Nothing on this checklist yet",
+      "allDoneLabel": "All done",
+      "addTaskLabel": "Add task",
+      "addSectionLabel": "Add section"
+    }
+  },
+  "rules": []
+}