rcf-lite 0.21.0 → 0.22.0

package/blueprints/application-forms-wizard/contributions/requirements/application-forms-wizard-req-004.json

@@ -0,0 +1,18 @@
+{
+  "reqId": "application-forms-wizard-REQ-004",
+  "prdId": "PRD-001",
+  "title": "Summary-review contract: a summary-list rendering per step with Change links returning to each step and retaining every other answer on save",
+  "description": "After every step is Completed (per REQ-001) the wizard renders a summary-review surface: one summary-list section per step, each row a definition-list entry naming the field label and the operator's answer, and a Change link per row that navigates to the step with the field focused. Editing on the target step and saving returns to the summary-review surface with every other answer retained; only the edited answer is updated. The summary-list shape follows the GOV.UK Design System summary-list pattern. Per WCAG 2.2 SC 3.3.4 Error Prevention (Legal, Financial, Data): the summary-review is the last checkpoint before submission and every answer is reversible up to submit.",
+  "category": "functional",
+  "domain": "application",
+  "priority": "must",
+  "rationale": "Per visual round 4 spec section 5.3, REQ 4.",
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "category:04-summary-review"
+  ],
+  "version": "1.0.0",
+  "status": "approved",
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/requirements/application-forms-wizard-req-005.json

@@ -0,0 +1,18 @@
+{
+  "reqId": "application-forms-wizard-REQ-005",
+  "prdId": "PRD-001",
+  "title": "Save-and-return contract: a server-side draft table or a client-side local buffer with a sync tick; refuses to ship if neither is wired",
+  "description": "The wizard commits partial answers between steps to a draft store so an operator can leave the surface and return without losing progress. Two transports ship: a server-side draft table (POST /drafts persists per-operator per-wizard rows, GET /drafts hydrates on return) and a client-side local buffer (localStorage keyed by operator identifier and wizard slug with a per-write sync tick). ADR-2502 commits to no recommendedDefault because the abandoned-draft loss class is genuinely per-project. A wizard that ships without either transport is refused at build gate: the draft-store TAC is a required companion. Per WCAG 2.2 SC 3.3.7 Redundant Entry: information the operator has already entered is preserved across sessions and not re-solicited.",
+  "category": "functional",
+  "domain": "application",
+  "priority": "must",
+  "rationale": "Per visual round 4 spec section 5.3, REQ 5.",
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "category:05-save-and-return"
+  ],
+  "version": "1.0.0",
+  "status": "approved",
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/tacs/tac-2501-application-forms-wizard-task-list.json

@@ -0,0 +1,46 @@
+{
+  "tacId": "TAC-2501-application-forms-wizard-task-list",
+  "prdId": "PRD-001",
+  "tadId": "TAD-001",
+  "version": "1.0.0",
+  "status": "approved",
+  "name": "Wizard task-list shell",
+  "purpose": "Owns the task-list surface of the wizard: the ordered enumeration of steps, the per-step completion-state slot from the closed GOV.UK vocabulary, the ARIA progressbar wrapper, and the linear-or-free navigation gate. Every AC on REQ-001 anchors on this TAC, and every AC that reads step order anchors here.",
+  "responsibilities": [
+    "Enumerate every step in a stable order derived from the elicited step manifest and render one [data-step-slug] row per step (AC-24101-1).",
+    "Render [data-step-state] on every row from the closed enum {Cannot start yet, Not started, In progress, Completed} (AC-24101-1).",
+    "Render an ARIA progressbar wrapper on the surface with aria-valuenow (completed count), aria-valuemax (total step count) and aria-valuetext naming the completion in words (AC-24101-1).",
+    "Honour the ADR-2501 linear-vs-free branch by rendering rows whose prerequisites are unfinished as non-anchor spans on linear and as anchors on free (AC-24106-1).",
+    "Delegate to TAC-2503 to hydrate step states from the draft store on entry and to persist step completion transitions on advance."
+  ],
+  "internalStructure": "One task-list module the shell mounts on the /task-list route. On mount it reads the step manifest, reads the draft store for the operator's per-step answers, computes the per-step completion state from the answers, renders the enumeration, and wires the row-click handler to the linear-vs-free branch. On step advance the module recomputes the state for the just-completed step and updates the progressbar aria-valuenow. Framework is not prescribed; the module's interfaces are what the project realises against React, Vue, Svelte or vanilla DOM.",
+  "interfaces": [
+    {
+      "name": "renderTaskList",
+      "kind": "factory",
+      "description": "renderTaskList({ manifest, answers, nav }) -> void. Renders the shell and wires the row handlers."
+    },
+    {
+      "name": "computeStepState",
+      "kind": "factory",
+      "description": "computeStepState({ step, answers }) -> stateString. Returns one of {Cannot start yet, Not started, In progress, Completed}."
+    },
+    {
+      "name": "statesEnum",
+      "kind": "shape",
+      "description": "The four state strings are the closed enum {\"Cannot start yet\", \"Not started\", \"In progress\", \"Completed\"}. A fifth state is a v1.1.0 minor bump."
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "Draft store",
+      "kind": "tac",
+      "tacId": "TAC-2503-application-forms-wizard-draft-store",
+      "description": "The task-list reads the draft store on entry and writes on advance."
+    }
+  ],
+  "tradeoffs": "One task-list module keeps the enumeration deterministic and lint-checkable but ties every step to a manifest entry the project supplies. A project rendering the wizard without a task-list (a single-flow submit surface with no completion overview) does not apply this TAC; the wizard-shell TACs still hold. Known mechanism-reach gap: the pack asserts row order and state strings but does not additionally probe that focus moves to the task-list on route entry; a v1.1.0 minor bump can drive the accessibility tree.",
+  "notes": "See README Known mechanism-reach gaps.",
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/tacs/tac-2502-application-forms-wizard-error-summary.json

@@ -0,0 +1,40 @@
+{
+  "tacId": "TAC-2502-application-forms-wizard-error-summary",
+  "prdId": "PRD-001",
+  "tadId": "TAD-001",
+  "version": "1.0.0",
+  "status": "approved",
+  "name": "Wizard error-summary contract",
+  "purpose": "Owns the top-of-page error-summary contract on submit refusal: the summary region, the skip-link binding per failed field, the aria-invalid and aria-describedby marking on the fields themselves, the focus move to the summary heading, and the validation-timing gate the SPA forms-engine drives per REQ-002. Every AC on REQ-002 and REQ-003 anchors on this TAC.",
+  "responsibilities": [
+    "Render [data-surface=\"error-summary\"] at the top of the step on submit refusal with a heading and one skip-link anchor per failed field (AC-24103-1).",
+    "Mark every failed field with aria-invalid=\"true\" and aria-describedby pointing at its per-field error message id (AC-24103-1).",
+    "Move focus to the summary heading on submit failure (AC-24103-1).",
+    "Delegate validation to the SPA forms-engine TAC-205 on the on-blur, on-change and on-submit triggers per REQ-002 (AC-24102-1); this TAC does not re-implement validation, it consumes the engine.",
+    "Clear aria-invalid on a field when its message clears and remove the anchor from the summary on the next successful submit."
+  ],
+  "internalStructure": "One error-summary module the shell mounts inside the step surface. On submit refusal the module reads the engine's error set, renders the anchor list, moves focus, and wires the anchor click to focus the corresponding field. On subsequent input events after the first failure the module re-runs the engine per-field and updates the message; on the next submit the module rebuilds the error set from scratch. Framework is not prescribed; the interfaces are what the project realises.",
+  "interfaces": [
+    {
+      "name": "renderSummary",
+      "kind": "factory",
+      "description": "renderSummary({ errors, headingId }) -> void. Renders the summary region and wires focus."
+    },
+    {
+      "name": "bindField",
+      "kind": "factory",
+      "description": "bindField({ field, message }) -> void. Sets aria-invalid and aria-describedby."
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "Applied SPA forms-engine",
+      "kind": "external",
+      "description": "The error-summary consumes the applied application-spa forms-engine (TAC-205 in that blueprint) to run per-field validation; this TAC does not ship its own engine. A project without application-spa applied wires an engine of its own choice against this TAC's interfaces (renderSummary and bindField)."
+    }
+  ],
+  "tradeoffs": "Consuming the SPA forms-engine keeps a project on the shelf free from a second overlapping engine but ties this TAC to the SPA blueprint's validation shape. Known mechanism-reach gap: the pack asserts the summary and the aria bindings but does not additionally probe the focus-order sweep across every field in the DOM after focus moves to the heading; a v1.1.0 minor bump can walk the tab order and diff.",
+  "notes": "See README Known mechanism-reach gaps.",
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/tacs/tac-2503-application-forms-wizard-draft-store.json

@@ -0,0 +1,40 @@
+{
+  "tacId": "TAC-2503-application-forms-wizard-draft-store",
+  "prdId": "PRD-001",
+  "tadId": "TAD-001",
+  "version": "1.0.0",
+  "status": "approved",
+  "name": "Wizard draft store",
+  "purpose": "Owns the save-and-return contract: the transport branch (server-side draft table or client-side local buffer), the sync tick on write, the hydrate-on-return path, and the in-progress list enumeration. Every AC on REQ-005 anchors on this TAC. Delegates the no-in-progress empty case to the application-empty-error-states empty-list state.",
+  "responsibilities": [
+    "On step advance persist the operator's partial answers per REQ-005 via the elicited transport (POST /drafts on server; localStorage write on local) (AC-24105-1).",
+    "On wizard entry hydrate the operator's answers from the draft store (GET /drafts on server; localStorage read on local) so the task-list computes the correct completion state (AC-24101-1, AC-24105-1).",
+    "Render a [data-sync-tick] element on the client-local branch carrying an ISO-8601 timestamp updated on every write (AC-24105-1).",
+    "Enumerate the operator's drafts on the /in-progress list surface (AC-24107-1) and delegate the zero-drafts case to the application-empty-error-states empty-list state (AC-24108-1).",
+    "Refuse to render the wizard when neither transport is wired (a project applying application-forms-wizard without a draft-store elicit answer fails at build gate per ADR-2502)."
+  ],
+  "internalStructure": "One draft-store module the shell mounts on wizard entry. On mount the module reads the ADR-2502 elicit answer, resolves the transport factory (server-draft-table or client-local-buffer), and exposes the four operations {read, write, list, remove} to the task-list and summary-review modules. The server branch POSTs and GETs against operator-configured /drafts endpoints; the local branch reads and writes window.localStorage under the namespaced key draft:<wizard-slug>:<step-slug>. Neither transport ships a sync engine; the flush semantics are those of the underlying transport (server persistence on POST, browser persistence on the local write).",
+  "interfaces": [
+    {
+      "name": "resolveTransport",
+      "kind": "factory",
+      "description": "resolveTransport({ elicit }) -> { read, write, list, remove }. Returns the transport bound to the elicited branch."
+    },
+    {
+      "name": "transportsEnum",
+      "kind": "shape",
+      "description": "The transport branches are the closed enum {server-draft-table, client-local-buffer}. A third branch is a v1.1.0 minor bump."
+    }
+  ],
+  "dependencies": [
+    {
+      "name": "Applied application-empty-error-states blueprint",
+      "kind": "external",
+      "description": "The zero-drafts case on /in-progress delegates to the empty-list state contributed by application-empty-error-states (TAC-2301 state machine, [data-surface=\"empty-list\"] wrapper with a [data-recovery=\"create\"] control). A project applying application-forms-wizard without application-empty-error-states also applied sees the /in-progress empty branch render a fallback empty message, which fails the sibling's runtime enforcement pack."
+    }
+  ],
+  "tradeoffs": "Two transports keep the shelf blueprint reachable by every project shape (a hobby SPA with no server can ship the local branch; an enterprise SPA with an audit trail ships the server branch) at the price of a per-project elicit at apply time. Known mechanism-reach gap: the pack asserts POST /drafts and GET /drafts round-trip on the server branch and the localStorage write on the local branch, but does not additionally probe cross-tab hydration on the local branch or server-side dedupe on the server branch; both are v1.1.0 minor-bump candidates.",
+  "notes": "See README Known mechanism-reach gaps.",
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24101.json

@@ -0,0 +1,28 @@
+{
+  "usId": "application-forms-wizard-US-24101",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-001",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "The task-list surface renders every step with one of the four GOV.UK completion states and an ARIA progressbar naming the completion count",
+  "asA": "operator working through a multi-step form",
+  "iWant": "a task-list surface that shows me every step in order, tells me for each step whether I Cannot start yet, have Not started, am In progress or have Completed it, and announces the total number completed",
+  "soThat": "I can see at a glance where I am, decide which step to pick up next, and know when I have nothing left to do before the summary review",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24101-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "Given the wizard task-list route, the rendered surface exposes [data-surface=\"task-list\"] carrying a [role=\"progressbar\"] with aria-valuenow, aria-valuemax and aria-valuetext, and one child element per step carrying [data-step-slug] and [data-step-state] whose value is one of the closed set {Cannot start yet, Not started, In progress, Completed}. The pack drives the real browser to /task-list and reads the state string per step, the progressbar values, and the enumerated step order."
+    }
+  ],
+  "tacIds": [
+    "TAC-2501-application-forms-wizard-task-list"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "contract:task-list"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24102.json

@@ -0,0 +1,29 @@
+{
+  "usId": "application-forms-wizard-US-24102",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-002",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Each step validates its own answers on blur before the first submit, then on change after the first failure, and rebuilds the error set from scratch on submit",
+  "asA": "operator filling in a step whose answers I have partially entered",
+  "iWant": "field-level messages to appear when I leave a field (not while I am mid-typing), then to update as I correct them after I have already tried to submit, and every message rebuilt from scratch on the next submit",
+  "soThat": "I am not scolded while typing, I see my corrections take effect immediately after a submit failure, and I trust that what shows on the page is what the engine last checked",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24102-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "On the wizard step route, focusing a field then blurring it without a valid entry renders a field-level error message referenced by aria-describedby without setting aria-invalid=\"true\" before the first submit (the pack asserts the message element is present and referenced). After a submit attempt fails on the field, subsequent input events on the same field update the message text on every change (the pack drives a first-submit-fail then a valid input and reads the message element's textContent transitioning to empty). On the next submit the engine rebuilds the error set from scratch (the pack asserts a previously failing field that has been corrected no longer appears in the summary)."
+    }
+  ],
+  "tacIds": [
+    "TAC-2501-application-forms-wizard-task-list",
+    "TAC-2502-application-forms-wizard-error-summary"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "contract:validation-timing"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24103.json

@@ -0,0 +1,28 @@
+{
+  "usId": "application-forms-wizard-US-24103",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-003",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "On submit refusal the step renders a top-of-page error summary with one skip link per failed field, aria-invalid on the field, and focus moved to the summary heading",
+  "asA": "operator who has submitted a step with an invalid entry",
+  "iWant": "a top-of-page summary of every failed field with a skip link that lands me on the field itself, the failed fields marked so a screen reader announces the error class, and focus placed on the summary heading so I hear the summary before anything else",
+  "soThat": "I can walk the failures in order, land directly on the field that needs fixing, and hear what went wrong before the rest of the page reads out",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24103-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "Given a submit refusal on the wizard step, the rendered surface exposes [data-surface=\"error-summary\"] with a heading (h2 or role=heading), one anchor element per failed field with href pointing at the field's id, and every failed field carries aria-invalid=\"true\" plus aria-describedby referencing its per-field error message. Focus after submit lands on the summary heading (document.activeElement matches the summary heading selector). The pack drives /step/2 with empty required inputs, submits and reads the summary heading, the anchor href list, the field aria-invalid attribute and the active-element selector."
+    }
+  ],
+  "tacIds": [
+    "TAC-2502-application-forms-wizard-error-summary"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "contract:error-summary"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24104.json

@@ -0,0 +1,29 @@
+{
+  "usId": "application-forms-wizard-US-24104",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-004",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "After every step is Completed the wizard renders a summary-review surface with one summary-list section per step and a Change link per row that retains every other answer on save",
+  "asA": "operator who has finished every step in the wizard",
+  "iWant": "a summary-review surface that lists every step's answers as a definition list, with a Change link per row that takes me back to the step with the field focused, and my other answers still present when I save",
+  "soThat": "I can review everything I entered before I submit, revise a single answer without losing the rest, and satisfy myself the submission is what I intended",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24104-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "Given every step is Completed, /summary renders [data-surface=\"summary-review\"] with one [data-summary-list-section] per step; each section holds a <dl> summary list carrying [data-summary-row] entries with a <dt> label and a <dd> value; every row carries a [data-recovery=\"change\"] link whose href routes back to the step. After clicking a Change link, editing that field and saving, the operator returns to /summary and every other row's value is preserved verbatim. The pack drives /summary, reads the row count and dl structure, follows one Change link, updates one field, saves, and diffs the summary rows before and after to prove only the edited row changed."
+    }
+  ],
+  "tacIds": [
+    "TAC-2501-application-forms-wizard-task-list",
+    "TAC-2503-application-forms-wizard-draft-store"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "contract:summary-review"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24105.json

@@ -0,0 +1,28 @@
+{
+  "usId": "application-forms-wizard-US-24105",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-005",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Save-and-return is wired via a server-side draft table or a client-side local buffer with a sync tick; the pack refuses to ship if neither is present",
+  "asA": "operator who has partially completed a wizard and will return later",
+  "iWant": "my partial answers persisted between steps and across sessions, either to a server-side draft table or to a local buffer that surfaces a sync tick when it writes",
+  "soThat": "closing the tab or losing the network mid-way does not force me to start again from the first step",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24105-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "On ?draft-store=server, entering an answer on step 1 and advancing issues a POST /drafts request whose body carries the operator identifier, the wizard slug, the step slug and the answer field; a subsequent GET /drafts on the same operator returns the persisted answer (the pack drives step 1, types into a field, advances, then re-issues a fresh GET /drafts and reads the JSON body). On ?draft-store=local, the same input path writes into window.localStorage under a namespaced key (draft:<wizard-slug>:<step-slug>) and renders a [data-sync-tick] element carrying an ISO-8601 timestamp updated on every write. When both transports are absent (?draft-store=none) the pack fails at severity block naming the missing transport."
+    }
+  ],
+  "tacIds": [
+    "TAC-2503-application-forms-wizard-draft-store"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "contract:save-and-return"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24106.json

@@ -0,0 +1,28 @@
+{
+  "usId": "application-forms-wizard-US-24106",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-001",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Linear-vs-free step navigation is a per-project elicit; the task-list respects it by disabling out-of-order entry on linear and permitting it on free",
+  "asA": "operator whose project has committed to a step order posture",
+  "iWant": "the task-list to disable step links whose prerequisites are unfinished when the project runs linear, or to permit any step at any time when the project runs free",
+  "soThat": "the surface matches the project's committed posture and does not let me enter a step whose prerequisites the domain forbids",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24106-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "On the ?nav=linear branch, task-list rows whose [data-step-state] is Cannot start yet render as non-anchor spans (no clickable href) and the pack asserts a click on the row does not change the URL. On the ?nav=free branch every row renders as an anchor and a click on any row navigates to that step's route. ADR-2501 records the elicit and the shipped default is linear."
+    }
+  ],
+  "tacIds": [
+    "TAC-2501-application-forms-wizard-task-list"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "case:linear-vs-free-navigation"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24107.json

@@ -0,0 +1,28 @@
+{
+  "usId": "application-forms-wizard-US-24107",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-005",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "The in-progress forms list surfaces every wizard the operator has started but not yet submitted with a resume link back to the task-list",
+  "asA": "operator returning to the application with more than one wizard on the go",
+  "iWant": "an index surface listing every wizard I have started but not submitted, each with the wizard title, the step I was on and a resume link",
+  "soThat": "I can walk back into the one I meant to finish without hunting through the navigation",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24107-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "Given at least one draft persisted per REQ-005, /in-progress renders [data-surface=\"in-progress-list\"] with one [data-wizard-row] per draft carrying the wizard title, the step slug the operator was on and a [data-recovery=\"resume\"] link whose href routes back to the wizard's task-list surface. The row count matches the number of drafts held in the draft store."
+    }
+  ],
+  "tacIds": [
+    "TAC-2503-application-forms-wizard-draft-store"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "case:in-progress-list"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/contributions/user-stories/application-forms-wizard-us-24108.json

@@ -0,0 +1,29 @@
+{
+  "usId": "application-forms-wizard-US-24108",
+  "prdId": "PRD-001",
+  "reqId": "application-forms-wizard-REQ-005",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "When no drafts are held the in-progress list surface delegates to the application-empty-error-states empty-list state and offers a create-affordance back to a fresh wizard",
+  "asA": "operator returning to the application with no wizards in flight",
+  "iWant": "the in-progress list to render the empty-list surface from the empty-and-error-states sibling with a control that starts a fresh wizard",
+  "soThat": "the empty case reads consistently with every other empty listing in the application and I have one obvious next action",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-24108-1",
+      "testable": true,
+      "scope": "runtime",
+      "description": "Given zero drafts in the draft store, /in-progress renders [data-surface=\"empty-list\"] (the empty-list wrapper contributed by application-empty-error-states) with a [data-recovery=\"create\"] control whose href routes to the first step of a fresh wizard. The pack asserts the wrapper and the control are present on the honest render and refuses when either is missing."
+    }
+  ],
+  "tacIds": [
+    "TAC-2503-application-forms-wizard-draft-store"
+  ],
+  "tags": [
+    "blueprint:application-forms-wizard",
+    "case:no-in-progress-forms-empty-state",
+    "consumes:application-empty-error-states"
+  ],
+  "createdAt": "2026-09-06T18:00:00Z",
+  "updatedAt": "2026-09-06T18:00:00Z"
+}

package/blueprints/application-forms-wizard/docs/topics.md

@@ -0,0 +1,49 @@
+# application-forms-wizard: coordination vocabulary
+
+## Global topics
+
+The blueprint claims no new global topics at v1.0.0. Every ADR (navigation posture, save-and-return transport, step-indicator shape) is non-global.
+
+## Deliberately unclaimed topics
+
+- `formsEngine` (the validation and field-component engine). Reserved for `application-spa` which owns the engine via TAC-205; this blueprint reads the engine through TAC-2502 and adds the wizard-shell contract on top.
+- `draftSyncEngine` (a shared sync engine across UI and persistence blueprints). Reserved for a future `application-draft-sync` v1.0.0 if three or more consumer blueprints start elicitizing the same cross-tab or server-side sync shape.
+- `emptyStateWrapper` (the DOM shape of the empty-list wrapper). Reserved for `application-empty-error-states` which owns it via TAC-2301; this blueprint delegates the no-in-progress empty case to the sibling and does not re-claim the wrapper.
+
+## Shelf id band and suffix block
+
+| Blueprint | US band | ADR/TAC suffix block | Status | Global topics |
+|---|---|---|---|---|
+| application-datatable | 17101-17899 | 18xx | shipped v1.0.0 | none |
+| application-charts | 18101-18899 | 19xx | shipped v1.0.0 | none |
+| application-dashboard | 19101-19899 | 20xx | shipped v1.0.0 | none |
+| application-notifications-in-app | 20101-20899 | 21xx | shipped v1.0.0 | none |
+| application-admin-console | 21101-21899 | 22xx | shipped v1.0.0 | none |
+| application-empty-error-states | 22101-22899 | 23xx | shipped v1.0.0 | none |
+| application-file-upload | 23101-23899 | 24xx | shipped v1.0.0 | none |
+| application-forms-wizard | 24101-24899 | 25xx | shipped v1.0.0 | none |
+| application-account-settings | 25101-25899 | 26xx | shipped v1.0.0 | none |
+| application-onboarding-tour | 26101-26899 | 27xx | shipped v1.0.0 | none |
+| persistence-data-postgres | 27101-27899 | 28xx | shipped v1.0.0 | `persistenceStore`, `migrationDiscipline` |
+| object-storage-s3 | 28101-28899 | 29xx | shipped v1.0.0 | `objectStorage` |
+
+The shelf-wide band registry lives in `packages/rcf-lite/docs/blueprint-authoring.md` section 5.
+
+## Composition with application-spa
+
+`application-spa` REQ-006 ships the forms-engine (TAC-205) and the field-component library. Applying this blueprint alongside `application-spa` composes cleanly: SPA holds the engine and the field components; this blueprint holds the wizard shell, the task-list, the error-summary contract, the summary review and the save-and-return draft store. No `scope: "global"` ADR conflict.
+
+## Composition with application-empty-error-states
+
+The `no-in-progress-forms` case on the /in-progress list surface delegates to the sibling's `empty-list` state (`[data-surface="empty-list"]` with a `[data-recovery="create"]` control). Per the sibling's `docs/topics.md`: SPA holds the tab-title convention, the component contracts and the state-visual tokens; this sibling holds the state list, the recovery-action router and the runtime enforcement pack. This blueprint's TAC-2503 reads that state on the zero-drafts branch and does not re-claim the wrapper.
+
+## Probe pack
+
+`probe-packs/application-forms-wizard.pack.mjs` ships four surface-observable checks anchored to blueprint AC ids, one per core contract:
+
+- `AC-24101-1` task-list (per-step state from {Cannot start yet, Not started, In progress, Completed}, ARIA progressbar wrapper, ordered step enumeration)
+- `AC-24103-1` error-summary (top-of-page summary, skip links per failed field, aria-invalid on the field, aria-describedby to the field-level error message, focus to summary heading)
+- `AC-24104-1` summary-review (summary-list rows per step, Change link per row, answer retention across an edit-and-save round-trip)
+- `AC-24105-1` save-and-return (server-draft-table transport POST/GET round-trip, client-local-buffer transport localStorage write with a sync tick)
+
+The pack applies to any FBS binding `TAC-2501-application-forms-wizard-task-list` or whose navModel routes name an operator-configured wizard-route path (matching `/(task-list|step|summary|in-progress|wizard)`). See `packages/rcf-lite/docs/blueprint-authoring.md` section 8c for the pack authoring rules.

package/blueprints/application-forms-wizard/guide/application-forms-wizard.md

@@ -0,0 +1,48 @@
+# application-forms-wizard: operator guide
+
+## When to reach for it
+
+Your project ships a workflow whose completion spans two or more surfaces the operator moves between with save points in between: a signup or onboarding flow, a checkout, an account setup, a compliance-heavy submission, an application review. You want the GOV.UK-vocabulary task-list up front (Cannot start yet, Not started, In progress, Completed) so the operator sees where they are at a glance, the per-step validation timing on-blur then on-change so the messages behave predictably, the top-of-page error summary with skip links so a screen-reader user hears the failures in order, the summary review with row-level change and answer retention so the operator can revise before submit, and the save-and-return draft store so a closed tab or a lost network does not force them to start again.
+
+## The four contracts
+
+- **Task-list contract (REQ-001).** Every step is enumerated with a state from the closed vocabulary. The ARIA progressbar wrapper carries the completion count.
+- **Validation timing (REQ-002).** On-blur before first submit, on-change after first failure, full pass on submit. Delegates to the SPA blueprint's forms-engine TAC-205.
+- **Error-summary contract (REQ-003).** Top-of-page summary, skip links per failed field, aria-invalid on the field, focus to summary heading on submit failure.
+- **Summary-review contract (REQ-004).** Summary-list rows per step, Change link per row, answer retention on save.
+- **Save-and-return contract (REQ-005).** Server-side draft table or client-side local buffer with a per-write sync tick. The pack refuses to ship if neither is wired.
+
+## When NOT to reach for it
+
+Your workflow is a single-page form the operator fills in one go with no cross-step dependencies. A wizard shell adds mechanism without payoff; a single-step submit with the same forms-engine and the same error-summary reads better.
+
+Your workflow is a linear questionnaire where every step is optional and the operator can jump anywhere at any time. Consider the free-navigation branch (ADR-2501) or an alternative surface that does not enumerate completion states.
+
+Your workflow ships without any draft store because every submission is single-session (a payment authorisation with a strict short expiry, say). The blueprint refuses to apply without a transport; either wire one or pick a different surface.
+
+## What stays your call
+
+- The step manifest (elicited at apply time). The blueprint ships an example three-step manifest on the fixture; your project supplies its own.
+- The step-indicator shape (task-list, ARIA progressbar-only, breadcrumb; ADR-2503).
+- The linear-vs-free navigation posture (ADR-2501). The default is linear.
+- The save-and-return transport (server-draft-table, client-local-buffer; ADR-2502). No default is committed.
+- The visual design of each surface. The blueprint contributes WHAT surfaces under WHAT condition; the palette, spacing and typography are your design system's call.
+- The per-field validation rules (which fields are required, format constraints). The blueprint contributes the timing rule and the summary shape; the field-level rules are your project's call, wired through the SPA forms-engine.
+
+## What a good outcome looks like
+
+The pack fires on every FBS whose surface renders a wizard task-list or a wizard step, and every check returns `pass` on the honest render and `fail` on the corresponding break switch. Your operator walks the task-list, sees the completion states in order, blur-triggers validation without being interrupted mid-typing, and on submit failure lands on the error summary with the failed fields in order. On summary review the operator revises one answer without losing the rest and submits with confidence. On network loss or a closed tab the draft persists and the operator picks up where they left off.
+
+## Mechanism-reach gaps
+
+The blueprint README lists the runtime-observable ACs the pack does NOT bind directly. Every gap is a candidate for a v1.1.0 minor bump extending the pack. Combine with `application-spa` to inherit the forms-engine and the field-component library, and with `application-empty-error-states` for the no-in-progress empty case.
+
+## Promotion signals
+
+- A wizard state past the four closed strings recurs across three or more consumer wizards (a Skipped or Locked state, say). Candidate: a v1.1.0 minor bump extending REQ-001's state enum.
+- The save-and-return contract wants a shared sync engine across a persistence blueprint and this UI blueprint. Candidate: a dedicated `application-draft-sync` blueprint absorbing the transport.
+- The step-indicator enum wants a per-step count element outside the task-list. Candidate: a v1.1.0 minor bump extending ADR-2503's shape enum.
+
+## Costs to be honest about
+
+A three-step wizard is a couple of days of project-side wiring per framework even after adopting the TACs. The pack is Playwright-first, so a project without a running dev server at gate time cannot fire it. The save-and-return contract's server branch needs a persistence adapter; the local branch needs a serialisation shape agreed with the forms-engine and a per-project namespacing rule for shared devices.