rcf-lite 0.26.0 → 0.27.0

package/blueprints/application-datatable/CHANGELOG.md

@@ -1,8 +1,29 @@
 # application-datatable CHANGELOG
 
-## 1.0.0 (visual round T-1, spec 2026-09-04)
+## 1.0.4 - 2026-09-10
+
+Findings closed: F-1, F-2, F-3, F-4, F-5, F-6, F-7, F-8. Template-AC fill-in clauses on AC-17101-3, AC-17102-1, AC-17108-2, AC-17108-3, AC-17109-1 and AC-17109-3 now enumerate the specific applying-project substitutions (column-id set, query-adapter endpoint and debounce, elicited query-adapter mode, applied default page size, elicited selection-persistence value, accessible-copy text near the bulk-action control) in place of the generic phrasing. TAC-1802 owns the `sort=<column>:<asc|desc>` grammar and the fixed `pageSize` query-parameter name; TAC-1803-application-datatable-selection-model patch-bumped to 1.0.2 with the `data-selection-persistence` marker on the bulk-action region added to responsibilities[3] and referenced from AC-17109-3. Register cleanup on the datatable README (removed the dated visual-specification reference and the residual mechanism-reach gap parenthetical) and on the guide (neutralised the dashboard-blueprint mention).
+
+
+## 1.0.3 (register-sweep patch, 2026-09-10)
+
+- Register: neutral wording in shipped prose (no capability change).
+
+## 1.0.2 (application-core completion pass, 2026-09-09)
+
+- Adds top-level elicits[] block on blueprint.json declaring the four apply-time answers (query-adapter-mode, url-state-strategy, page-size, selection-persistence); each option value backed by a must REQ description with a runtime clause per section 7c. REQ-001 gains a page-size 25 default clause; REQ-002 gains url-query / session-scoped URL-state clause; REQ-004 gains per-page / cross-page selection-persistence clause. capabilities[] not declared: leaf blueprint (no consumer requiresAppliedCapabilities on the shelf references a datatable capability).
+- Review fix pass 2026-09-10: F-1 vendorCitation added to eight fixed ACs whose assertions rest on W3C facts: AC-17104-3 (WCAG 2.4.3 focus-order), AC-17104-6 (ARIA APG dialog-modal pattern), AC-17105-2 (WCAG 1.4.1 use-of-color), AC-17106-4 (WCAG 2.5.7 dragging-movements), AC-17107-2 (WCAG 4.1.2 name-role-value), AC-17107-3 (WCAG 1.3.1 info-and-relationships), AC-17107-4 (ARIA APG table pattern), AC-17107-5 (ARIA APG grid pattern); each citation carries verifiedOn 2026-09-09.
+- Adds refusal-path ACs to US-17104 (bulk-action max-cap refusal, dialog Cancel focus return, focus trap), US-17106 (drag-only refusal, hidden-column orphan cells, hidden column with active sort/filter), US-17107 (read-only role=grid refusal, role=grid arrow navigation, mixed-interactive shell pattern), US-17108 (session-scoped no-URL contract, invalid-URL rejection, history.replaceState per micro-change), US-17109 (dialog aria-describedby total count, filter narrows presentation not selection, Clear selection control). Every story now at the 7a floor (4-6 ACs per story, 46 ACs total on the blueprint).
+
+## 1.0.1 (application-core hardening, 2026-09-09)
+
+- hardening pass: chain-consistency lint zero (pass1 + pass2 already clean at baseline); added deliveredBy to every REQ, added ownerRef and disposition to every AC per section 7b.
+- Added AC-17101-4, AC-17102-4, AC-17103-4 and AC-17105-4 (loading indicator clears, announced error region replaces the pending state, last successful rows retained) covering the 2026-09-08 review finding F-1 on TAC-1802.internalStructure for sort, filter, pagination and URL-state page requests that reject.
+
+
+## 1.0.0 (2026-09-04)
 
 - First ratified version of the shelf's datatable blueprint. Six REQs (table shell, sort semantics, filter chrome, selection and bulk actions, empty / loading / error / no-results states, column visibility / reorder / resize), nine USs binding 27 runtime-observable ACs, three TACs (shell, query adapter, selection model), four ADRs (pattern choice, URL state, page size, selection persistence). No new global topics.
-- Ships `probe-packs/application-datatable.pack.mjs`: six browser-verify checks anchored to AC-17101-1, AC-17102-1, AC-17103-2, AC-17104-3, AC-17105-1, AC-17106-1. First blueprint on the shelf that ships a Playwright probe pack under the T-0 runner extension.
+- Ships `probe-packs/application-datatable.pack.mjs`: six browser-verify checks anchored to AC-17101-1, AC-17102-1, AC-17103-2, AC-17104-3, AC-17105-1, AC-17106-1. First blueprint on the shelf that ships a Playwright probe pack under the runner extension.
 - Ships a sample-app fixture at `packages/rcf-lite/test/fixtures/probe-pack-application-datatable/` (dependency-free Node HTTP server) so the pack can be probed at the shelf's own gate; the fixture is the golden the gate reviewer drives.
 - Suggests the `logging` and `errorHandling` companions with the ratified spec's reasons.

package/blueprints/application-datatable/README.md

@@ -1,6 +1,6 @@
-# Datatable blueprint (v1.0.0)
+# Datatable blueprint (v1.0.4)
 
-Vendor-neutral datatable contract for a rcf-lite application. Ships the ARIA APG table / grid pattern choice (per interactivity), the sort / filter / paginate discipline, the selection model with a bulk-action confirmation dialog, the four-state region contract (empty / loading / error / no-results), and a non-drag keyboard path for column visibility / reorder / resize. Ships a Playwright probe pack under `probe-packs/application-datatable.pack.mjs` whose six checks are the runtime gate the delivery-ci-workflows runner drives (visual round spec 2026-09-04). No new global topics; suggests the `logging` and `errorHandling` companions.
+Vendor-neutral datatable contract for a rcf-lite application. Ships the ARIA APG table / grid pattern choice (per interactivity), the sort / filter / paginate discipline, the selection model with a bulk-action confirmation dialog, the four-state region contract (empty / loading / error / no-results), and a non-drag keyboard path for column visibility / reorder / resize. Ships a Playwright probe pack under `probe-packs/application-datatable.pack.mjs` whose six checks are the runtime gate the delivery-ci-workflows runner drives (section 5 of the ratified visual specification). No new global topics; suggests the `logging` and `errorHandling` companions.
 
 ## Apply
 
@@ -39,5 +39,5 @@ Table or grid ARIA APG pattern per interactivity (ADR-1801); sortable columns ke
 ## Known mechanism-reach gaps
 
 - **Framework-agnostic focus containment.** The pack asserts focus return to the originating row on dialog close, but cannot prove a given framework's focus trap never leaks into the browser chrome; a project-side keyboard smoke supplement per applied framework closes the class.
-- **Chart-adjacent chart integration.** A datatable that renders a per-row sparkline (`application-charts` chart-style) is not covered by the datatable pack; the `application-charts` blueprint's own probe pack (visual round T-2) reaches those surfaces.
+- **Chart-adjacent chart integration.** A datatable that renders a per-row sparkline (`application-charts` chart-style) is not covered by the datatable pack; the `application-charts` blueprint's own probe pack reaches those surfaces.
 - **Live-region debouncing on rapid filter typing.** Per-keystroke pagination announcements can flood assistive tech; the pack asserts the announcement fires, not the debounce. A v1.1 minor bump candidate adds a check for a bounded announcement rate.

package/blueprints/application-datatable/blueprint.json

@@ -1,33 +1,175 @@
 {
   "slug": "application-datatable",
-  "version": "1.0.0",
+  "version": "1.0.4",
   "category": "application",
   "suggestedCompanions": [
-    { "role": "logging", "reason": "Every server-side query pass writes a request-scoped log line; a logging companion supplies the factory the pipeline calls." },
-    { "role": "errorHandling", "reason": "A partial-load failure or a bulk-action refusal constructs an internal error record; an error-handling companion supplies the factory and the boundary." }
+    {
+      "role": "logging",
+      "reason": "Every server-side query pass writes a request-scoped log line; a logging companion supplies the factory the pipeline calls."
+    },
+    {
+      "role": "errorHandling",
+      "reason": "A partial-load failure or a bulk-action refusal constructs an internal error record; an error-handling companion supplies the factory and the boundary."
+    }
+  ],
+  "elicits": [
+    {
+      "id": "query-adapter-mode",
+      "prompt": "Query adapter mode: server-side (the shell issues sort, filter and pagination requests against the query adapter) or client-side (the shell filters and sorts an in-memory collection). Recommended default: server-side.",
+      "kind": "enum",
+      "options": [
+        "server-side",
+        "client-side"
+      ],
+      "default": "server-side"
+    },
+    {
+      "id": "url-state-strategy",
+      "prompt": "URL state strategy: url-query (sort, filter and page write to the URL via history.replaceState so reload and share preserve the view) or session-scoped (state is kept in memory for the shell mount lifetime). Recommended default: url-query.",
+      "kind": "enum",
+      "options": [
+        "url-query",
+        "session-scoped"
+      ],
+      "default": "url-query"
+    },
+    {
+      "id": "page-size",
+      "prompt": "Default page size in rows. The operator elicits an override at apply; a pageSize in the URL still overrides for one view. Recommended default: 25.",
+      "kind": "string",
+      "default": "25"
+    },
+    {
+      "id": "selection-persistence",
+      "prompt": "Selection persistence: per-page (selection resets on pagination advance and the shell surfaces the reset near the bulk action controls) or cross-page (selection persists across pagination for the shell mount lifetime). Recommended default: per-page.",
+      "kind": "enum",
+      "options": [
+        "per-page",
+        "cross-page"
+      ],
+      "default": "per-page"
+    }
   ],
   "contributions": [
-    { "id": "application-datatable-REQ-001", "kind": "req", "path": "requirements/application-datatable-req-001.json" },
-    { "id": "application-datatable-REQ-002", "kind": "req", "path": "requirements/application-datatable-req-002.json" },
-    { "id": "application-datatable-REQ-003", "kind": "req", "path": "requirements/application-datatable-req-003.json" },
-    { "id": "application-datatable-REQ-004", "kind": "req", "path": "requirements/application-datatable-req-004.json" },
-    { "id": "application-datatable-REQ-005", "kind": "req", "path": "requirements/application-datatable-req-005.json" },
-    { "id": "application-datatable-REQ-006", "kind": "req", "path": "requirements/application-datatable-req-006.json" },
-    { "id": "application-datatable-US-17101", "kind": "us", "path": "user-stories/application-datatable-us-17101.json" },
-    { "id": "application-datatable-US-17102", "kind": "us", "path": "user-stories/application-datatable-us-17102.json" },
-    { "id": "application-datatable-US-17103", "kind": "us", "path": "user-stories/application-datatable-us-17103.json" },
-    { "id": "application-datatable-US-17104", "kind": "us", "path": "user-stories/application-datatable-us-17104.json" },
-    { "id": "application-datatable-US-17105", "kind": "us", "path": "user-stories/application-datatable-us-17105.json" },
-    { "id": "application-datatable-US-17106", "kind": "us", "path": "user-stories/application-datatable-us-17106.json" },
-    { "id": "application-datatable-US-17107", "kind": "us", "path": "user-stories/application-datatable-us-17107.json" },
-    { "id": "application-datatable-US-17108", "kind": "us", "path": "user-stories/application-datatable-us-17108.json" },
-    { "id": "application-datatable-US-17109", "kind": "us", "path": "user-stories/application-datatable-us-17109.json" },
-    { "id": "TAC-1801-application-datatable-shell", "kind": "tac", "path": "tacs/tac-1801-application-datatable-shell.json" },
-    { "id": "TAC-1802-application-datatable-query-adapter", "kind": "tac", "path": "tacs/tac-1802-application-datatable-query-adapter.json" },
-    { "id": "TAC-1803-application-datatable-selection-model", "kind": "tac", "path": "tacs/tac-1803-application-datatable-selection-model.json" },
-    { "id": "ADR-1801-application-datatable-pattern-choice", "kind": "adr", "path": "adrs/adr-1801-application-datatable-pattern-choice.json", "standardsTraceClause": "ARIA APG table pattern / ARIA APG grid pattern" },
-    { "id": "ADR-1802-application-datatable-url-state", "kind": "adr", "path": "adrs/adr-1802-application-datatable-url-state.json", "recommendedDefault": true, "elicited": true, "standardsTraceClause": "generic enterprise practice" },
-    { "id": "ADR-1803-application-datatable-page-size", "kind": "adr", "path": "adrs/adr-1803-application-datatable-page-size.json", "recommendedDefault": true, "elicited": true, "standardsTraceClause": "generic enterprise practice" },
-    { "id": "ADR-1804-application-datatable-selection-persistence", "kind": "adr", "path": "adrs/adr-1804-application-datatable-selection-persistence.json", "recommendedDefault": false, "elicited": true, "standardsTraceClause": "generic enterprise practice" }
+    {
+      "id": "application-datatable-REQ-001",
+      "kind": "req",
+      "path": "requirements/application-datatable-req-001.json"
+    },
+    {
+      "id": "application-datatable-REQ-002",
+      "kind": "req",
+      "path": "requirements/application-datatable-req-002.json"
+    },
+    {
+      "id": "application-datatable-REQ-003",
+      "kind": "req",
+      "path": "requirements/application-datatable-req-003.json"
+    },
+    {
+      "id": "application-datatable-REQ-004",
+      "kind": "req",
+      "path": "requirements/application-datatable-req-004.json"
+    },
+    {
+      "id": "application-datatable-REQ-005",
+      "kind": "req",
+      "path": "requirements/application-datatable-req-005.json"
+    },
+    {
+      "id": "application-datatable-REQ-006",
+      "kind": "req",
+      "path": "requirements/application-datatable-req-006.json"
+    },
+    {
+      "id": "application-datatable-US-17101",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17101.json"
+    },
+    {
+      "id": "application-datatable-US-17102",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17102.json"
+    },
+    {
+      "id": "application-datatable-US-17103",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17103.json"
+    },
+    {
+      "id": "application-datatable-US-17104",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17104.json"
+    },
+    {
+      "id": "application-datatable-US-17105",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17105.json"
+    },
+    {
+      "id": "application-datatable-US-17106",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17106.json"
+    },
+    {
+      "id": "application-datatable-US-17107",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17107.json"
+    },
+    {
+      "id": "application-datatable-US-17108",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17108.json"
+    },
+    {
+      "id": "application-datatable-US-17109",
+      "kind": "us",
+      "path": "user-stories/application-datatable-us-17109.json"
+    },
+    {
+      "id": "TAC-1801-application-datatable-shell",
+      "kind": "tac",
+      "path": "tacs/tac-1801-application-datatable-shell.json"
+    },
+    {
+      "id": "TAC-1802-application-datatable-query-adapter",
+      "kind": "tac",
+      "path": "tacs/tac-1802-application-datatable-query-adapter.json"
+    },
+    {
+      "id": "TAC-1803-application-datatable-selection-model",
+      "kind": "tac",
+      "path": "tacs/tac-1803-application-datatable-selection-model.json"
+    },
+    {
+      "id": "ADR-1801-application-datatable-pattern-choice",
+      "kind": "adr",
+      "path": "adrs/adr-1801-application-datatable-pattern-choice.json",
+      "standardsTraceClause": "ARIA APG table pattern / ARIA APG grid pattern"
+    },
+    {
+      "id": "ADR-1802-application-datatable-url-state",
+      "kind": "adr",
+      "path": "adrs/adr-1802-application-datatable-url-state.json",
+      "recommendedDefault": true,
+      "elicited": true,
+      "standardsTraceClause": "generic enterprise practice"
+    },
+    {
+      "id": "ADR-1803-application-datatable-page-size",
+      "kind": "adr",
+      "path": "adrs/adr-1803-application-datatable-page-size.json",
+      "recommendedDefault": true,
+      "elicited": true,
+      "standardsTraceClause": "generic enterprise practice"
+    },
+    {
+      "id": "ADR-1804-application-datatable-selection-persistence",
+      "kind": "adr",
+      "path": "adrs/adr-1804-application-datatable-selection-persistence.json",
+      "recommendedDefault": false,
+      "elicited": true,
+      "standardsTraceClause": "generic enterprise practice"
+    }
   ]
 }

package/blueprints/application-datatable/contributions/adrs/adr-1801-application-datatable-pattern-choice.json

@@ -2,7 +2,7 @@
   "adrId": "ADR-1801-application-datatable-pattern-choice",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Choose ARIA APG table for read-only rows and ARIA APG grid once any cell becomes an interactive control",
   "context": "The ARIA APG names two distinct patterns for tabular surfaces: `table` for a read-only presentation of tabular data, and `grid` for a two-dimensional widget where cells can hold interactive controls (buttons, links, editable fields). Assistive-tech behaviour differs between the two: a grid announces row and column position on focus, supports two-dimensional keyboard navigation, and expects `role=\"gridcell\"` on data cells; a table announces cell contents in reading order and does not expect grid navigation. Picking one pattern per the interactivity of the surface prevents the shipped datatable from advertising grid affordances the surface does not implement (a common defect).",

package/blueprints/application-datatable/contributions/adrs/adr-1802-application-datatable-url-state.json

@@ -2,7 +2,7 @@
   "adrId": "ADR-1802-application-datatable-url-state",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Serialise sort, filter and page state into the URL by recommended default; elicited overrides for a session-scoped alternative",
   "context": "Deep-linkable, reload-stable views are the tabular surface's expected posture in production. A datatable that resets sort, filter and page on reload forces operators to recreate their view every session and prevents them from sharing a specific view with a colleague. Some surfaces (an internal admin panel where a session-scoped view is preferable for auditability) elect the alternative.",

package/blueprints/application-datatable/contributions/adrs/adr-1803-application-datatable-page-size.json

@@ -2,7 +2,7 @@
   "adrId": "ADR-1803-application-datatable-page-size",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Default page size 25; elicited overrides on apply",
   "context": "Page size shapes the pagination behaviour and the initial fetch cost. Too small a default forces excessive pagination; too large a default renders a slow first paint on a large dataset. The middle ground for most tabular surfaces (users, orders, records) sits between 20 and 50 rows; the shelf picks a stable default the guide names.",

package/blueprints/application-datatable/contributions/adrs/adr-1804-application-datatable-selection-persistence.json

@@ -2,7 +2,7 @@
   "adrId": "ADR-1804-application-datatable-selection-persistence",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "accepted",
   "title": "Selection persistence is elicited: per-page reset by default, cross-page persistence when the operator opts in",
   "context": "Cross-page selection persistence is a powerful primitive for bulk operations across a large dataset; it also increases the surface area for confusing behaviour (an unexpected bulk operation on rows the operator forgot they selected two pages ago). The default preserves predictability; the operator opts into persistence when the surface's task shape warrants it.",

package/blueprints/application-datatable/contributions/requirements/application-datatable-req-001.json

@@ -2,14 +2,21 @@
   "reqId": "application-datatable-REQ-001",
   "prdId": "PRD-001",
   "title": "The application ships a datatable shell with rows, columns, header cells and per-page navigation",
-  "description": "The application realises a datatable surface honouring the ARIA APG table pattern for read-only rows and the ARIA APG grid pattern once any cell becomes an interactive control (per ADR-1801). Header cells associate with column data through `<th scope=\"col\">` or an equivalent grid `role=\"columnheader\"` binding; per-page navigation renders a pagination control that fetches subsequent pages against the query adapter (TAC-1802). The shell is the base surface the other five REQs elaborate on.",
+  "description": "The application realises a datatable surface honouring the ARIA APG table pattern for read-only rows and the ARIA APG grid pattern once any cell becomes an interactive control (per ADR-1801). Header cells associate with column data through `<th scope=\"col\">` or an equivalent grid `role=\"columnheader\"` binding; per-page navigation renders a pagination control that fetches subsequent pages against the query adapter (TAC-1802). The shell is the base surface the other five REQs elaborate on. The default page size is 25 rows when the applying project does not elicit an override; the operator elicits a different `page-size` at apply per ADR-1803 and the elicited value replaces the default without changing the URL contract.",
   "category": "functional",
   "domain": "application",
   "priority": "must",
   "rationale": "The shell decision closes two families of failure at once: the accessibility mode picked (table vs grid), and the pagination contract the query adapter feeds. Without this, projects reinvent both per surface and every downstream discipline (state contract, selection, sort) rides on ad-hoc assumptions.",
-  "tags": ["blueprint:application-datatable", "category:01-shell"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-datatable",
+    "category:01-shell"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1801-application-datatable-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-datatable/contributions/requirements/application-datatable-req-002.json

@@ -2,14 +2,21 @@
   "reqId": "application-datatable-REQ-002",
   "prdId": "PRD-001",
   "title": "Sort activates the query adapter and renders in the announced direction",
-  "description": "Column headers advertise sortability via a keyboard-reachable sort control; activation flips direction (asc / desc), announces the new direction through `aria-sort`, and reorders rendered rows to match the server-side sort (TAC-1802) when the project chose the server-side default. The client-side sort alternative applies to small in-memory collections when the operator elicited it (ADR-1802's elicited alternative).",
+  "description": "Column headers advertise sortability via a keyboard-reachable sort control; activation flips direction (asc / desc), announces the new direction through `aria-sort`, and reorders rendered rows to match the server-side sort (TAC-1802) when the project chose the server-side default. The client-side sort alternative applies to small in-memory collections when the operator elicited it (ADR-1802's elicited alternative). The recommended default `url-state-strategy` is `url-query`: the shell serialises `sort`, `q` and `page` into the URL query on every state change via `history.replaceState`. The elicited alternative `session-scoped` keeps the same state in memory for the shell mount lifetime and suppresses URL writes (ADR-1802).",
   "category": "functional",
   "domain": "application",
   "priority": "must",
   "rationale": "Sort is the single-most-used interaction on a datatable and the most common source of hidden accessibility regressions. Anchoring the direction announcement and the keyboard reach at the surface level closes both.",
-  "tags": ["blueprint:application-datatable", "category:02-sort"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-datatable",
+    "category:02-sort"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1801-application-datatable-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-datatable/contributions/requirements/application-datatable-req-003.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "Filter and sort share the same query surface. Naming them together stops projects from realising two divergent request shapes that then desync on the composition case.",
-  "tags": ["blueprint:application-datatable", "category:03-filter"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-datatable",
+    "category:03-filter"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-04T19:45:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1801-application-datatable-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-datatable/contributions/requirements/application-datatable-req-004.json

@@ -2,14 +2,21 @@
   "reqId": "application-datatable-REQ-004",
   "prdId": "PRD-001",
   "title": "Selection and bulk actions carry a per-row, per-page and cross-page selection model with a confirmation dialog per bulk operation",
-  "description": "The selection model (TAC-1803) exposes per-row toggles, a page-level toggle that flips the visible page, and (elicited per ADR-1804) an optional cross-page persistence that stays across pagination. Every bulk operation opens a confirmation dialog under the ARIA APG dialog-modal pattern (`role=\"dialog\"`, `aria-modal=\"true\"`, `aria-labelledby`, `aria-describedby`, focus trap, focus return on close). The dialog returns focus to the control that opened it, per WCAG 2.4.3 and ARIA APG.",
+  "description": "The selection model (TAC-1803) exposes per-row toggles, a page-level toggle that flips the visible page, and (elicited per ADR-1804) an optional cross-page persistence that stays across pagination. Every bulk operation opens a confirmation dialog under the ARIA APG dialog-modal pattern (`role=\"dialog\"`, `aria-modal=\"true\"`, `aria-labelledby`, `aria-describedby`, focus trap, focus return on close). The dialog returns focus to the control that opened it, per WCAG 2.4.3 and ARIA APG. The recommended default `selection-persistence` is `per-page`: selection resets on pagination advance and the shell surfaces the reset in the accessible copy near the bulk action controls. The elicited alternative `cross-page` keeps the selection across pagination for the shell mount lifetime (ADR-1804).",
   "category": "functional",
   "domain": "application",
   "priority": "must",
   "rationale": "Bulk actions on a datatable are where destructive operations sit. The confirmation dialog's focus return is the single biggest keyboard-usability defect the surface produces if the project scaffolds one from scratch. Anchoring the dialog and the focus-return contract makes both testable at ship.",
-  "tags": ["blueprint:application-datatable", "category:04-selection"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-datatable",
+    "category:04-selection"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-09T00:00:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1801-application-datatable-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-datatable/contributions/requirements/application-datatable-req-005.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "State ambiguity is the second-biggest datatable defect after focus return: showing a spinner over the last-good rows (stale-content ambiguity), or an empty state that reads the same as no-results. Distinct regions plus polite live announcements close both classes.",
-  "tags": ["blueprint:application-datatable", "category:05-states"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-datatable",
+    "category:05-states"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-04T19:45:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1801-application-datatable-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-datatable/contributions/requirements/application-datatable-req-006.json

@@ -7,9 +7,16 @@
   "domain": "application",
   "priority": "must",
   "rationale": "WCAG 2.5.7 makes drag-only interactions non-conformant. Naming the keyboard alternative for each of the three column controls prevents the shipped surface from failing the standard at the last moment.",
-  "tags": ["blueprint:application-datatable", "category:06-columns"],
-  "version": "1.0.0",
+  "tags": [
+    "blueprint:application-datatable",
+    "category:06-columns"
+  ],
+  "version": "1.0.1",
   "status": "approved",
   "createdAt": "2026-09-04T19:45:00Z",
-  "updatedAt": "2026-09-04T19:45:00Z"
+  "updatedAt": "2026-09-04T19:45:00Z",
+  "deliveredBy": {
+    "tacId": "TAC-1801-application-datatable-shell",
+    "field": "responsibilities"
+  }
 }

package/blueprints/application-datatable/contributions/tacs/tac-1801-application-datatable-shell.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1801-application-datatable-shell",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "name": "Datatable shell",
   "purpose": "Owns the rendered datatable surface: the ARIA APG pattern choice (table vs grid per interactivity, ADR-1801), the header cell binding, the pagination controls with the polite live status region, the four-state distinction (empty, loading, error, no-results), the sort control per column with the aria-sort attribute, the filter chrome, the selection column, the bulk action controls, and the non-drag column reorder / visibility / resize path. The shell is the substitutable interface every AC in this blueprint anchors on.",

package/blueprints/application-datatable/contributions/tacs/tac-1802-application-datatable-query-adapter.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1802-application-datatable-query-adapter",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "name": "Datatable query adapter",
   "purpose": "Owns the sort, filter and pagination wire contract between the shell (TAC-1801) and the project's data source (a REST endpoint on application-api-rest, a GraphQL query, or an in-memory collection). Ships two shapes: a server-side default (elicited endpoint, receives `q`, `sort`, `page`, `pageSize`, returns `{ rows, total, page, pageSize, sort, q }`) and a client-side in-memory adapter for small collections (elicited ADR-1802 alternative).",

package/blueprints/application-datatable/contributions/tacs/tac-1803-application-datatable-selection-model.json

@@ -2,7 +2,7 @@
   "tacId": "TAC-1803-application-datatable-selection-model",
   "prdId": "PRD-001",
   "tadId": "TAD-001",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "status": "approved",
   "name": "Datatable selection model",
   "purpose": "Owns the per-row, per-page and (elicited) cross-page selection state, plus the accessible count the shell renders adjacent to the bulk action controls. Substitutable interface so tests can drive selection without mounting the shell.",
@@ -10,7 +10,7 @@
     "Track the selected row-id set across shell mount / unmount cycles (AC-17109-1, AC-17109-2).",
     "Expose a keyboard-reachable per-row toggle and a page-level toggle that flips the visible page (AC-17104-1).",
     "Expose the running count the shell renders adjacent to the bulk-action controls (AC-17109-2).",
-    "Reset selection on advance when the operator did not elicit cross-page persistence (AC-17109-3)."
+    "Reset selection on advance when the operator did not elicit cross-page persistence, and attach a `data-selection-persistence` marker on the bulk-action region carrying the elicited value from `blueprint.json:elicits[selection-persistence]` (`per-page` or `cross-page`) so the accessible copy on the bulk-action region names the mode operators are working under (AC-17109-3)."
   ],
   "internalStructure": "One factory `createSelectionModel({ persistence: 'perPage' | 'crossPage' })` returning `{ toggle(rowId), togglePage(rowIds), selectedIds(), size(), reset(), onChange(listener) }`. The shell (TAC-1801) reads selectedIds() to render checkbox state and size() to render the running count.",
   "interfaces": [

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

@@ -2,7 +2,7 @@
   "usId": "application-datatable-US-17101",
   "prdId": "PRD-001",
   "reqId": "application-datatable-REQ-002",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "status": "approved",
   "title": "Sort activation reorders rendered rows to match the query adapter and announces the direction",
   "asA": "operator scanning a table for a top or bottom row",
@@ -16,7 +16,8 @@
       "when": "the operator activates the sort control (mouse or keyboard)",
       "then": "the rendered row order matches the server-side sort response for the same column and direction",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17101-2",
@@ -25,20 +26,41 @@
       "when": "the operator tabs into the table header",
       "then": "each sortable column exposes a focusable sort control",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "fixed"
     },
     {
       "id": "AC-17101-3",
-      "description": "Given a sort activation on a column, the surface updates the column header's `aria-sort` attribute to `ascending` or `descending` matching the applied direction; subsequent activations flip the direction and the attribute together (ARIA APG table + grid patterns).",
+      "description": "Given a sort activation on a column, the surface updates the column header's `aria-sort` attribute to `ascending` or `descending` matching the applied direction; subsequent activations flip the direction and the attribute together (ARIA APG table + grid patterns). Applying agent sets: the enumerated column-id set the sort control targets and the initial `aria-sort=none` per column at first render.",
       "given": "a rendered datatable with an initial `aria-sort` of `none` on every column",
       "when": "the operator activates the sort control on a column",
       "then": "the activated column's `aria-sort` reads `ascending` or `descending` matching the new direction and every other column stays at `none`",
       "testable": true,
-      "scope": "runtime"
+      "scope": "runtime",
+      "disposition": "template"
+    },
+    {
+      "id": "AC-17101-4",
+      "description": "Given the query adapter rejects the sort 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 sort 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"
 }