rcf-lite 0.26.0 → 0.27.0

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17102.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17102",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-003",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "title": "Filter chrome text search issues a q request and narrows rendered rows to the response",
   "asA": "operator looking for a subset of rows by keyword",
@@ -11,12 +11,13 @@
   "acceptanceCriteria": [
     {
       "id": "AC-17102-1",
-      "description": "Given a rendered datatable route with a text filter input, when the operator types a value, the client issues a request to the query adapter carrying `q=<value>`; the server (server-side default) or the in-memory adapter (elicited client-side alternative) reads `q` and returns rows matching the filter; the rendered rows equal the returned rows. The check types into the filter, awaits the fetch, reads the rendered names, and compares against a direct `/api/rows?q=<value>` fetch. Probed by pack check AC-17102-1.",
+      "description": "Given a rendered datatable route with a text filter input, when the operator types a value, the client issues a request to the query adapter carrying `q=<value>`; the server (server-side default) or the in-memory adapter (elicited client-side alternative) reads `q` and returns rows matching the filter; the rendered rows equal the returned rows. The check types into the filter, awaits the fetch, reads the rendered names, and compares against a direct `/api/rows?q=<value>` fetch. Probed by pack check AC-17102-1. Applying agent sets: the query-adapter endpoint path (default `/api/rows` or the applied `application-api-rest` list endpoint), the filter-input debounce interval, and the expected row-name field the rendered rows are compared on.",
       "given": "a rendered datatable route with a filter input",
       "when": "the operator types a value into the filter",
       "then": "the query adapter receives a `q` value equal to the typed string and the rendered rows equal the returned rows",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "template"
     },
     {
       "id": "AC-17102-2",
@@ -25,7 +26,8 @@
       "when": "the operator types a filter value",
       "then": "the pagination status region reads `Page 1 of M` for the filtered result set",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17102-3",
@@ -34,11 +36,31 @@
       "when": "the operator selects a value and (independently) types a `q`",
       "then": "the query adapter receives both filters and the rendered rows are the intersection",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-17102-4",
+      "description": "Given the query adapter rejects the filter request (an HTTP 4xx/5xx, a network error, or a client-cancelled fetch), when the response settles, then the loading indicator clears and the announced error region replaces the pending state naming the failed operation; the rendered rows retain the last successful state until the operator retries.",
+      "given": "a pending filter request whose fetch rejects",
+      "when": "the query adapter's response settles as a failure",
+      "then": "the loading indicator clears, an announced error region reports the failed operation, and the last successful rows remain",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1802-application-datatable-query-adapter",
+        "field": "interfaces[0].name"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell", "TAC-1802-application-datatable-query-adapter"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell",
+    "TAC-1802-application-datatable-query-adapter"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
   "updatedAt": "2026-09-04T19:45:00Z"
 }

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17103.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17103",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "title": "Pagination advances the page and announces the current position through an aria-live region",
   "asA": "operator paging through a long result set",
@@ -16,7 +16,8 @@
       "when": "the operator activates the next-page control",
       "then": "the query adapter receives `page` and `pageSize` and the rendered rows equal the returned rows",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17103-2",
@@ -25,7 +26,8 @@
       "when": "the operator activates the pagination control",
       "then": "the aria-live region text updates from `Page N of M` to `Page N+1 of M`",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17103-3",
@@ -34,11 +36,31 @@
       "when": "the operator tabs into the pagination region",
       "then": "each pagination control receives focus and activates on `Enter` or `Space`",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-17103-4",
+      "description": "Given the query adapter rejects the pagination request (an HTTP 4xx/5xx, a network error, or a client-cancelled fetch), when the response settles, then the loading indicator clears and the announced error region replaces the pending state naming the failed operation; the rendered rows retain the last successful state until the operator retries.",
+      "given": "a pending pagination request whose fetch rejects",
+      "when": "the query adapter's response settles as a failure",
+      "then": "the loading indicator clears, an announced error region reports the failed operation, and the last successful rows remain",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1802-application-datatable-query-adapter",
+        "field": "interfaces[0].name"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell", "TAC-1802-application-datatable-query-adapter"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell",
+    "TAC-1802-application-datatable-query-adapter"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
   "updatedAt": "2026-09-04T19:45:00Z"
 }

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17104.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17104",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-004",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Bulk actions on selected rows open a confirmation dialog and return focus to the originating row on close",
   "asA": "operator applying an action to multiple rows",
@@ -16,7 +16,8 @@
       "when": "the operator toggles a row checkbox",
       "then": "the accessible selection count updates by one",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17104-2",
@@ -25,7 +26,8 @@
       "when": "the operator activates the bulk action",
       "then": "the dialog opens with `role=\"dialog\"`, `aria-modal=\"true\"`, `aria-labelledby` and `aria-describedby` set, and the confirm control receives initial focus",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17104-3",
@@ -34,11 +36,67 @@
       "when": "the operator closes the dialog (confirm or cancel)",
       "then": "focus returns to the originating row's control (the row-scoped focus target), not to the document body or an unrelated element",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed",
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-17104-4",
+      "description": "Given the selection model's operator-configured maximum selection cap (an integer set on the shell factory), when the operator attempts to toggle a row that would exceed the cap, the shell refuses the toggle and announces the refusal through an aria-live polite region naming the cap value; the selection model records no change. Applying agent sets: the cap value on the shell factory input.",
+      "given": "an operator toggling a row that would push the selection past the configured maximum cap",
+      "when": "the shell handles the toggle",
+      "then": "the toggle is refused, the selection model records no change, and an aria-live polite region announces the refusal naming the cap value",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "template",
+      "ownerRef": {
+        "tacId": "TAC-1803-application-datatable-selection-model",
+        "field": "purpose"
+      }
+    },
+    {
+      "id": "AC-17104-5",
+      "description": "Given an open bulk-action confirmation dialog and the operator activates the Cancel control (or presses Escape), when the dialog closes, focus returns to the same row-scoped focus target the dialog opened FROM (the row's selection checkbox or the equivalent row-level focus target), not to the bulk-action control that opened it; a dialog that returns focus to the wrong target fails the pack check.",
+      "given": "an open bulk-action confirmation dialog closed with Cancel or Escape",
+      "when": "the dialog closes",
+      "then": "focus returns to the row-scoped focus target the dialog opened from, not to the bulk-action control",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1803-application-datatable-selection-model",
+        "field": "purpose"
+      }
+    },
+    {
+      "id": "AC-17104-6",
+      "description": "Given an open bulk-action confirmation dialog, when the operator presses Tab through the dialog controls, focus is trapped inside the dialog (Tab cycles between the dialog's focusable elements; it does not reach elements outside the dialog); a dialog whose Tab escapes to elements outside fails the pack check per ARIA APG dialog-modal.",
+      "given": "an open bulk-action confirmation dialog and the operator pressing Tab",
+      "when": "the pack captures focus movement",
+      "then": "focus is trapped inside the dialog; Tab does not reach elements outside; escape fails the check",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1801-application-datatable-shell",
+        "field": "purpose"
+      },
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/",
+        "verifiedOn": "2026-09-09"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell", "TAC-1803-application-datatable-selection-model"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell",
+    "TAC-1803-application-datatable-selection-model"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17105.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17105",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-005",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "title": "Empty, loading, error and no-results states each render a distinct region with a polite live announcement",
   "asA": "screen-reader user or keyboard-only user navigating a datatable that has no rows to show",
@@ -16,7 +16,8 @@
       "when": "the state region renders",
       "then": "each state carries a `role=\"region\"` element with `aria-live=\"polite\"` and a distinct heading",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17105-2",
@@ -25,7 +26,12 @@
       "when": "the state region renders",
       "then": "each state region includes text content that names the state without relying on colour",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed",
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html",
+        "verifiedOn": "2026-09-09"
+      }
     },
     {
       "id": "AC-17105-3",
@@ -34,11 +40,30 @@
       "when": "the fetch resolves and rows arrive",
       "then": "the loading region is removed and the populated data region renders without the loading region present",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-17105-4",
+      "description": "Given the query adapter rejects the URL-state page request (an HTTP 4xx/5xx, a network error, or a client-cancelled fetch), when the response settles, then the loading indicator clears and the announced error region replaces the pending state naming the failed operation; the rendered rows retain the last successful state until the operator retries.",
+      "given": "a pending URL-state page request whose fetch rejects",
+      "when": "the query adapter's response settles as a failure",
+      "then": "the loading indicator clears, an announced error region reports the failed operation, and the last successful rows remain",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1802-application-datatable-query-adapter",
+        "field": "interfaces[0].name"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17106.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17106",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-006",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "Column visibility, reorder and resize each expose a keyboard-reachable alternative to any drag pointer path",
   "asA": "operator who cannot drag with a pointer",
@@ -16,7 +16,8 @@
       "when": "the operator activates a keyboard-reachable move control on a column",
       "then": "the header order changes to reflect the move",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17106-2",
@@ -25,7 +26,8 @@
       "when": "the operator activates a column visibility control",
       "then": "the target column's header and body cells hide or show accordingly",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17106-3",
@@ -34,11 +36,62 @@
       "when": "the operator activates the keyboard resize path on a column",
       "then": "the column width changes by the declared increment without a pointer drag",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
+    },
+    {
+      "id": "AC-17106-4",
+      "description": "Given a drag-only reorder or resize control (no keyboard alternative surface), the pack fails the check per REQ-006 and WCAG 2.5.7 Dragging Movements; a passing surface exposes a paired button pair (move-left / move-right, resize-up / resize-down) or a menu ordering per column reachable by Tab.",
+      "given": "a datatable whose reorder or resize is pointer-drag-only",
+      "when": "the pack inspects the keyboard-alternative surface",
+      "then": "the check fails; a passing surface exposes a paired button or menu ordering reachable by Tab",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1801-application-datatable-shell",
+        "field": "purpose"
+      },
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/dragging-movements.html",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-17106-5",
+      "description": "Given the column visibility toggle activated to hide a column, when the pack re-renders the table, the hidden column is removed from the DOM AND from the paired header/data cell binding (no orphan `<td>` rows narrower than the visible column count); a shell that leaves orphan cells fails the pack check.",
+      "given": "a column visibility toggle activated to hide a column",
+      "when": "the pack inspects the rendered rows",
+      "then": "the column is removed from the DOM and each row's cell count matches the visible column count; orphan cells fail",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1801-application-datatable-shell",
+        "field": "purpose"
+      }
+    },
+    {
+      "id": "AC-17106-6",
+      "description": "Given a hidden column with an active sort or filter, when the operator hides the column, the sort or filter remains applied to the underlying query (the operator did not de-select the sort; hiding is presentation only) and the accessible copy near the chrome names the retained sort or filter so the operator can see why the visible rows narrowed.",
+      "given": "a hidden column that carries an active sort or filter",
+      "when": "the pack inspects the shell after hiding",
+      "then": "the sort or filter remains applied to the query and the accessible chrome names the retained state",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1802-application-datatable-query-adapter",
+        "field": "purpose"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17107.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17107",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-001",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "status": "approved",
   "title": "The rendered table shell uses the ARIA APG pattern that matches the surface's interactivity",
   "asA": "assistive-tech user reading the datatable",
@@ -16,7 +16,8 @@
       "when": "the shell renders",
       "then": "the rendered table has `role=\"grid\"` and header cells scoped to `col`",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17107-2",
@@ -25,7 +26,12 @@
       "when": "assistive tech reads the action controls",
       "then": "each action's accessible name identifies the acted-on row",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed",
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html",
+        "verifiedOn": "2026-09-09"
+      }
     },
     {
       "id": "AC-17107-3",
@@ -34,11 +40,70 @@
       "when": "assistive tech traverses a data cell",
       "then": "the announced context includes the column header the cell resolves to",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed",
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-17107-4",
+      "description": "Given a datatable shell whose rows carry NO interactive controls (a read-only presentation), the rendered element is a `<table>` without `role=\"grid\"` (or with an explicit `role=\"table\"` per ARIA APG); a read-only surface that advertises `role=\"grid\"` fails the pack check per ADR-1801 because it advertises two-dimensional keyboard navigation the surface does not implement.",
+      "given": "a read-only datatable shell (no interactive per-row controls)",
+      "when": "the pack inspects the shell's role attribute",
+      "then": "the shell is `<table>` (or role=table); role=grid on a read-only surface fails per ADR-1801",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1801-application-datatable-pattern-choice",
+        "field": "decision"
+      },
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/ARIA/apg/patterns/table/",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-17107-5",
+      "description": "Given a `role=\"grid\"` shell, when the operator uses the arrow keys, keyboard focus moves cell-by-cell (Right, Left, Up, Down) per the ARIA APG grid pattern; a `role=\"grid\"` shell whose arrow keys do not move cell focus fails the pack check because the pattern advertises a navigation the surface does not implement.",
+      "given": "a role=grid datatable shell",
+      "when": "the operator presses arrow keys",
+      "then": "focus moves cell-by-cell per ARIA APG grid; arrow keys with no cell focus movement fail",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1801-application-datatable-pattern-choice",
+        "field": "decision"
+      },
+      "vendorCitation": {
+        "url": "https://www.w3.org/WAI/ARIA/apg/patterns/grid/",
+        "verifiedOn": "2026-09-09"
+      }
+    },
+    {
+      "id": "AC-17107-6",
+      "description": "Given a datatable that carries a mix of read-only rows and rows with per-row inline controls (some rows have an Edit button, others do not), the shell picks the grid pattern for the whole shell (ADR-1801: `grid` once ANY cell becomes an interactive control); the pack fails a shell that renders `<table>` on such a surface.",
+      "given": "a datatable with mixed read-only and interactive rows",
+      "when": "the pack inspects the shell's role",
+      "then": "the shell is role=grid (per ADR-1801, grid once any cell becomes interactive); a role=table on such a surface fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1801-application-datatable-pattern-choice",
+        "field": "decision"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-10T07:07:28Z"
 }

package/blueprints/application-datatable/contributions/user-stories/application-datatable-us-17108.json

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17108",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-002",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "status": "approved",
   "title": "URL state serialisation preserves sort, filter and page across reload and share",
   "asA": "operator sharing a specific datatable view with a colleague",
@@ -16,29 +16,79 @@
       "when": "the operator reloads the URL",
       "then": "the reloaded surface renders the same sort, filter and page",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17108-2",
-      "description": "Given the elicited client-side sort alternative (ADR-1802 elicited variant) applied to a small in-memory collection, the sort direction still writes to the URL so reload stability is preserved; the client-side branch never invents a URL state divergent from the server-side default.",
+      "description": "Given the elicited client-side query adapter mode (`query-adapter-mode=client-side` per `blueprint.json:elicits[query-adapter-mode]`) applied to a small in-memory collection, the sort direction still writes to the URL so reload stability is preserved; the client-side branch never invents a URL state divergent from the server-side default. Applying agent sets: the elicited value on `blueprint.json:elicits[query-adapter-mode]` (`server-side` or `client-side`). The URL `sort=<column>:<asc|desc>` grammar is fixed on TAC-1802-application-datatable-query-adapter.responsibilities[0].",
       "given": "a rendered datatable applying the client-side sort alternative",
       "when": "the operator activates a sort control",
       "then": "the URL query parameters update with `sort=<column>:<direction>` in the same shape as the server-side default",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "template"
     },
     {
       "id": "AC-17108-3",
-      "description": "Given a rendered datatable, the default page size on the recommended default (ADR-1803) applies when no `pageSize` is present in the URL; the operator's elicited page-size override at apply time changes the default without changing the URL contract.",
+      "description": "Given a rendered datatable, the default page size on the recommended default (ADR-1803) applies when no `pageSize` is present in the URL; the operator's elicited page-size override at apply time changes the default without changing the URL contract. Applying agent sets: the applied default page size from ADR-1803-application-datatable-page-size (25 unless the operator elicits an override on `blueprint.json:elicits[page-size]`). The query parameter name `pageSize` is fixed on TAC-1802-application-datatable-query-adapter.responsibilities[0].",
       "given": "a rendered datatable landed at the shell route without a `pageSize` query parameter",
       "when": "the initial render fetches the first page",
       "then": "the fetch carries `pageSize=<applied-default>` and the URL is left untouched",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "template"
+    },
+    {
+      "id": "AC-17108-4",
+      "description": "Given the elicited session-scoped alternative (`url-state-strategy=session-scoped` per ADR-1802), when the operator applies a sort, filter and page advance, the URL does NOT change (no query parameters appear) and the state is retained in memory for the shell mount lifetime; a reload of the URL lands on the default state (no state restoration) and the shell announces the session-scoped mode in the accessible copy on first mount.",
+      "given": "an operator applying sort, filter and page under url-state-strategy=session-scoped",
+      "when": "the pack inspects URL and state after operator actions",
+      "then": "the URL carries no query parameters, the state is retained in memory for the mount lifetime, and reload lands on the default state",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1802-application-datatable-url-state",
+        "field": "decision"
+      }
+    },
+    {
+      "id": "AC-17108-5",
+      "description": "Given a URL carrying an INVALID state (a `sort=notacolumn` referencing a column that does not exist on the schema, a `page=999` past the last page, a `q=<value>` longer than the input's maxlength), when the shell loads, the shell rejects the invalid parts of the URL state, falls back to the default for each rejected part, and announces the fallback through the aria-live polite region; a shell that hard-fails on invalid URL state fails the pack check.",
+      "given": "a URL with invalid sort, page or q parameters",
+      "when": "the shell mounts and reads the URL state",
+      "then": "the shell rejects invalid parts, falls back to defaults per part, and announces the fallback; a hard failure on invalid URL state fails",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "tacId": "TAC-1802-application-datatable-query-adapter",
+        "field": "purpose"
+      }
+    },
+    {
+      "id": "AC-17108-6",
+      "description": "Given a rendered datatable, when the operator applies a new sort mid-view, the URL is updated with `history.replaceState` (not `pushState`); the browser history does NOT gain a new entry per micro-change so the operator's back button returns them to the page BEFORE the datatable, not to the previous sort state. A shell using `pushState` per micro-change fails the pack check per ADR-1802.",
+      "given": "a rendered datatable and an operator applying a new sort",
+      "when": "the pack inspects browser history after the sort",
+      "then": "the URL updated via history.replaceState and no new history entry was added; pushState per micro-change fails per ADR-1802",
+      "testable": true,
+      "scope": "runtime",
+      "disposition": "fixed",
+      "ownerRef": {
+        "adrId": "ADR-1802-application-datatable-url-state",
+        "field": "decision"
+      }
     }
   ],
-  "tacIds": ["TAC-1801-application-datatable-shell", "TAC-1802-application-datatable-query-adapter"],
-  "tags": ["blueprint:application-datatable"],
+  "tacIds": [
+    "TAC-1801-application-datatable-shell",
+    "TAC-1802-application-datatable-query-adapter"
+  ],
+  "tags": [
+    "blueprint:application-datatable"
+  ],
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z"
 }