rcf-lite 0.11.0 → 0.13.0

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1112.json

@@ -0,0 +1,81 @@
+{
+  "usId": "application-spa-US-1112",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-006",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Feedback and status components: alerts, banners, empty, loading, error, skeleton",
+  "asA": "user needing to know what the application is doing and what needs attention",
+  "iWant": "status surfaces that inform without shouting or disappearing",
+  "soThat": "I trust the application to tell me the truth about its state",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1112-1",
+      "description": "Alerts render the four semantic intents (info, success, warning, danger) from the token layer with intent icons from the semantic alias registry, in both themes.",
+      "given": "an alert of each intent in each theme",
+      "when": "rendered",
+      "then": "intent styling and icon are correct and token-driven",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1112-2",
+      "description": "Alerts announcing dynamic outcomes use a live region appropriate to urgency; page-load-present alerts are static content.",
+      "given": "an alert raised by a user action",
+      "when": "it appears",
+      "then": "assistive technology announces it without focus theft",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1112-3",
+      "description": "Banners occupy the shell-owned banner slot, never overlap content, push layout rather than cover it, and are dismissible where the condition is not persistent.",
+      "given": "an active banner condition",
+      "when": "the banner renders",
+      "then": "content reflows below it and dismissal follows the declared rule",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1112-4",
+      "description": "The empty-state component renders an illustration or icon, a headline naming what would be here, and the primary action that fills it, per the empty-state wireframe.",
+      "given": "a collection with zero items",
+      "when": "the empty state renders",
+      "then": "all three elements are present and the action works",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1112-5",
+      "description": "Skeleton loaders mirror the shape of the incoming content, animate within motion-token constraints, respect reduced motion, and are marked busy for assistive technology.",
+      "given": "a loading collection with known shape",
+      "when": "the skeleton renders",
+      "then": "its silhouette matches the loaded layout and it exposes busy state",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1112-6",
+      "description": "The error-state component names what failed in user terms, offers a retry or an alternative path, and never renders a raw exception, stack trace, or internal id.",
+      "given": "a failed data load",
+      "when": "the error state renders",
+      "then": "the copy is actionable per application-spa-REQ-017 and a retry affordance is present",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1112-7",
+      "description": "Spinners appear only for genuinely indeterminate operations, always paired with an accessible label naming what is loading.",
+      "given": "an indeterminate operation",
+      "when": "its spinner renders",
+      "then": "the spinner has an accessible name and is not used where a skeleton was possible",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-203-application-spa-component-library"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1113.json

@@ -0,0 +1,82 @@
+{
+  "usId": "application-spa-US-1113",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-007",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Form validation timing, error summary, and accessible field binding",
+  "asA": "user filling in a form",
+  "iWant": "mistakes pointed out early, precisely, and politely",
+  "soThat": "I can fix problems where they are instead of hunting for them after a failed submit",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1113-1",
+      "description": "Fields validate on blur; a field that failed once re-validates on change so corrections clear errors immediately.",
+      "given": "a field with a validation rule",
+      "when": "the user blurs with invalid content, then corrects it",
+      "then": "the error appears on blur and clears as the correction is typed",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1113-2",
+      "description": "Submitting with failures renders a submit-level summary listing every failed field, each entry a link that moves focus to its field.",
+      "given": "a form with three invalid fields",
+      "when": "submit is pressed",
+      "then": "a summary lists all three and each link focuses its field",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1113-3",
+      "description": "Focus moves to the error summary on failed submit and the summary is announced assertively.",
+      "given": "a failed submit",
+      "when": "the summary renders",
+      "then": "focus lands on the summary and it is announced",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1113-4",
+      "description": "Every field error message is tied to its field via aria-describedby with aria-invalid set, and removed when resolved.",
+      "given": "a field in error",
+      "when": "the accessibility tree is inspected",
+      "then": "the message is associated and the state accurate through the fix",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1113-5",
+      "description": "Required fields are marked visibly in the label and programmatically via required semantics; optionality is derivable without colour alone.",
+      "given": "a form with required and optional fields",
+      "when": "labels are inspected",
+      "then": "required marking is visible and programmatic",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1113-6",
+      "description": "Personal-data fields carry correct autocomplete tokens (name, email, tel, and peers) and mobile-intent attributes (inputmode, type) matching the data.",
+      "given": "a form collecting personal data",
+      "when": "field attributes are inspected on mobile",
+      "then": "autofill offers correctly and the matching keyboard opens",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1113-7",
+      "description": "Entered values survive a failed submit and a theme or locale switch; the form never clears user input on error.",
+      "given": "a form with entered values and one invalid field",
+      "when": "submit fails",
+      "then": "every entered value is still present",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-205-application-spa-forms-engine",
+    "TAC-203-application-spa-component-library"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1114.json

@@ -0,0 +1,60 @@
+{
+  "usId": "application-spa-US-1114",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-008",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Every declared journey specified and rendering across its six states",
+  "asA": "user anywhere in a journey",
+  "iWant": "every step to look designed no matter what state I hit it in",
+  "soThat": "edge states feel as finished as the happy path",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1114-1",
+      "description": "The project maintains a journey inventory; every declared journey maps each step to a route and to specifications for arrival, loading, empty, error, success, and re-entry states.",
+      "given": "the journey inventory",
+      "when": "each journey is walked against the specifications",
+      "then": "all six states are specified for every step",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1114-2",
+      "description": "Arrival states render meaningful content or structure immediately; no journey step opens on an unexplained blank region.",
+      "given": "each journey entry point",
+      "when": "first render is observed",
+      "then": "designed arrival content is visible without user action",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1114-3",
+      "description": "Each journey's error state offers a way forward: retry, an alternative path, or clear guidance, per application-spa-REQ-017.",
+      "given": "each journey step forced into error",
+      "when": "the error state renders",
+      "then": "a forward path is present and operable",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1114-4",
+      "description": "Re-entry into a journey restores or gracefully resets context per the journey specification; expired-session re-entry routes through the application-spa-US-1116 flow back to the same step.",
+      "given": "a user mid-journey who leaves and returns",
+      "when": "re-entry occurs, including with an expired session",
+      "then": "the declared restore-or-reset behaviour happens and no entered data is silently lost",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1114-5",
+      "description": "Journey checkpoint telemetry per application-spa-REQ-016 fires at each declared checkpoint across all six states, so abandoned journeys are observable.",
+      "given": "a journey walked through each state",
+      "when": "telemetry is captured",
+      "then": "the declared checkpoint events fire with correct names",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1115.json

@@ -0,0 +1,73 @@
+{
+  "usId": "application-spa-US-1115",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-009",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Landing, sign-in, sign-out, and first-run onboarding surfaces",
+  "asA": "visitor arriving for the first time or returning to sign in",
+  "iWant": "arrival and authentication screens that are designed, fast, and self-explanatory",
+  "soThat": "my first minutes with the product feel intentional",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1115-1",
+      "description": "The unauthenticated landing surface renders per its wireframe: product identity, a statement of value, and the sign-in entry point, at every baseline breakpoint in both themes.",
+      "given": "an unauthenticated first visit",
+      "when": "the landing renders at each breakpoint",
+      "then": "the designed surface renders with no auth-gated blank regions",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1115-2",
+      "description": "The sign-in surface follows the sign-in wireframe and the application-spa-REQ-007 form contract, including a designed failure state that names the problem without revealing which credential element was wrong.",
+      "given": "the sign-in form",
+      "when": "valid and invalid submissions are made",
+      "then": "success routes onward and failure renders safe, actionable copy",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1115-3",
+      "description": "Sign-in shows a pending state during verification and prevents duplicate submission.",
+      "given": "a submitted sign-in form",
+      "when": "verification is in flight",
+      "then": "the submit control is busy per application-spa-US-1108 and repeat submits are ignored",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1115-4",
+      "description": "Sign-out is available from the shell on every authenticated route, completes to the designed signed-out confirmation surface, and clears client caches per ADR-205.",
+      "given": "a signed-in user on any route",
+      "when": "sign-out is invoked",
+      "then": "the confirmation surface renders and cached user data is gone",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1115-5",
+      "description": "First-run onboarding renders for a first-signed-in user per its specification, is skippable, and never renders again once completed or skipped.",
+      "given": "a first sign-in and a later sign-in",
+      "when": "both arrivals are observed",
+      "then": "onboarding shows once, is skippable, and does not recur",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1115-6",
+      "description": "All arrival and auth surfaces meet application-spa-REQ-019 and application-spa-REQ-004 on the same terms as authenticated routes.",
+      "given": "each arrival and auth surface",
+      "when": "accessibility and responsive checks run",
+      "then": "the same bars pass; these surfaces are not exempt",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-201-application-spa-app-shell",
+    "TAC-205-application-spa-forms-engine"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1116.json

@@ -0,0 +1,72 @@
+{
+  "usId": "application-spa-US-1116",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-009",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Session expiry, password recovery, and unauthenticated deep links",
+  "asA": "user whose session lapsed or who lost a password",
+  "iWant": "recovery paths that keep my place and my data",
+  "soThat": "an expired session or forgotten password is a detour, not a dead end",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1116-1",
+      "description": "When a request returns 401 mid-session, the session-expired surface renders per its wireframe, naming what happened; the user is not dumped onto the landing page without explanation.",
+      "given": "an authenticated user whose session expires",
+      "when": "the next request fails with 401",
+      "then": "the designed session-expired surface renders",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1116-2",
+      "description": "Re-authenticating from the session-expired surface returns the user to the route they were on, with unsaved form input preserved where the journey specification declares preservation.",
+      "given": "a user who expired mid-form",
+      "when": "they re-authenticate",
+      "then": "they land back on the same route with declared preservation honoured",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1116-3",
+      "description": "Forgot-password is linked from sign-in, confirms the request without disclosing whether the account exists, and states what happens next.",
+      "given": "the forgot-password flow",
+      "when": "a known and an unknown address are submitted",
+      "then": "both render the same designed confirmation",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1116-4",
+      "description": "The account-recovery surface validates the recovery token, renders a designed invalid-or-expired-token state with a restart path, and applies the application-spa-REQ-007 contract to the new-credential form.",
+      "given": "valid, invalid, and expired recovery links",
+      "when": "each is visited",
+      "then": "valid proceeds; invalid and expired render the designed state with a restart path",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1116-5",
+      "description": "Visiting a protected deep link while unauthenticated redirects to sign-in and, on success, forwards to the originally requested route.",
+      "given": "an unauthenticated visit to a protected route",
+      "when": "sign-in completes",
+      "then": "the originally requested route renders",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1116-6",
+      "description": "The deep-link return target is validated to be an in-application route; external or malformed targets fall back to the default authenticated route.",
+      "given": "a crafted redirect target pointing outside the application",
+      "when": "sign-in completes",
+      "then": "the user lands on the default route, never an external URL",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-204-application-spa-client-data-layer"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1117.json

@@ -0,0 +1,73 @@
+{
+  "usId": "application-spa-US-1117",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-010",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "The state quartet on every route and data-bearing component",
+  "asA": "user meeting real-world data conditions",
+  "iWant": "considered screens when things are empty, loading, or broken",
+  "soThat": "the application never looks abandoned at exactly the wrong moment",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1117-1",
+      "description": "Every data-bearing route renders designed loading, empty, error, and success states; a state matrix over the route inventory has no unspecified applicable cell.",
+      "given": "the route inventory",
+      "when": "each applicable state is induced per route",
+      "then": "every applicable cell renders a designed state",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1117-2",
+      "description": "Loading states use skeletons wherever the incoming content shape is known; spinners appear only for indeterminate operations per application-spa-US-1112.",
+      "given": "each loading state",
+      "when": "audited against content shape",
+      "then": "known shapes use skeletons; spinner use is justified",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1117-3",
+      "description": "Empty states are per-context, naming the specific absent content and its filling action; a single generic empty component text is not reused verbatim across unrelated routes.",
+      "given": "each empty state",
+      "when": "copy and action are compared across routes",
+      "then": "each names its own content and action",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1117-4",
+      "description": "Error states distinguish user-fixable failures from system failures and offer retry on transient failures (network, 5xx); not on user-fixable 4xx.",
+      "given": "a 4xx-class and a 5xx-class failure",
+      "when": "each error state renders",
+      "then": "copy and affordances differ appropriately",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1117-5",
+      "description": "Success states after mutations confirm the outcome visibly (toast or inline confirmation per the journey spec) and reflect the new data without manual refresh.",
+      "given": "a successful mutation",
+      "when": "the response lands",
+      "then": "confirmation renders and affected views show the new data",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1117-6",
+      "description": "State transitions never flash intermediate wrong states: loading does not flicker for cached data, and empty never renders while data is still loading.",
+      "given": "a route with cached data and a route loading slowly",
+      "when": "transitions are observed",
+      "then": "no wrong-state flash occurs in either",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-203-application-spa-component-library",
+    "TAC-204-application-spa-client-data-layer"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1118.json

@@ -0,0 +1,54 @@
+{
+  "usId": "application-spa-US-1118",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-011",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Single icon set behind semantic aliases",
+  "asA": "user scanning the interface",
+  "iWant": "icons that look like one family and mean one thing each",
+  "soThat": "iconography aids recognition instead of adding noise",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1118-1",
+      "description": "All icons come from the single set selected under ADR-206; no second set or bespoke one-off glyphs appear.",
+      "given": "the shipped asset output",
+      "when": "icon provenance is audited",
+      "then": "every icon traces to the one declared set",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1118-2",
+      "description": "Icons are referenced through the semantic alias registry; components never import glyph files directly.",
+      "given": "component source",
+      "when": "icon references are audited",
+      "then": "every reference goes through an alias",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1118-3",
+      "description": "The same alias renders the same glyph everywhere; the same meaning never has two competing glyphs.",
+      "given": "each alias used in more than one place",
+      "when": "renderings are compared",
+      "then": "glyph use is consistent per meaning",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1118-4",
+      "description": "Decorative icons are hidden from assistive technology; icons carrying meaning have accessible names; icon-only buttons are labelled.",
+      "given": "decorative and meaningful icons",
+      "when": "the accessibility tree is inspected",
+      "then": "decorative ones are hidden and meaningful ones named",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-203-application-spa-component-library"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1119.json

@@ -0,0 +1,63 @@
+{
+  "usId": "application-spa-US-1119",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-012",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Tokenised motion that respects reduced-motion preferences",
+  "asA": "user sensitive to motion",
+  "iWant": "animation that is subtle, consistent, and optional",
+  "soThat": "the interface feels alive without making anyone ill",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1119-1",
+      "description": "All transitions and animations use durations and easings from the motion tokens; unmanaged literal durations do not appear in component styles.",
+      "given": "the shipped stylesheet output",
+      "when": "animation declarations are audited",
+      "then": "every duration and easing resolves to a motion token",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1119-2",
+      "description": "Enter, exit, and state-change transitions sit within the 150-250ms token range with ease-out defaults per ADR-207.",
+      "given": "each animated component",
+      "when": "timings are measured",
+      "then": "they match the declared tokens",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1119-3",
+      "description": "With prefers-reduced-motion set, non-essential animation is disabled; content appears and disappears without translation or scaling effects.",
+      "given": "a reduced-motion user preference",
+      "when": "animated components render",
+      "then": "no non-essential motion plays and nothing breaks functionally",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1119-4",
+      "description": "No motion autoplays in critical flows: auth surfaces, forms mid-entry, and destructive confirmations are motion-quiet.",
+      "given": "each critical flow",
+      "when": "observed at rest",
+      "then": "nothing animates without user initiation",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1119-5",
+      "description": "Skeleton shimmer and progress animations also honour reduced motion, degrading to static placeholders.",
+      "given": "a reduced-motion preference with loading content",
+      "when": "skeletons render",
+      "then": "placeholders are static and still convey loading via their busy state",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-202-application-spa-theme-system"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}

package/blueprints/application-spa/contributions/user-stories/application-spa-us-1120.json

@@ -0,0 +1,72 @@
+{
+  "usId": "application-spa-US-1120",
+  "prdId": "PRD-001",
+  "reqId": "application-spa-REQ-013",
+  "version": "1.0.0",
+  "status": "approved",
+  "title": "Cache discipline: stale-while-revalidate reads and explicit write invalidation",
+  "asA": "user working against live data",
+  "iWant": "instant screens that quietly stay current",
+  "soThat": "I never stare at spinners for data the application already had, or act on data it should have refreshed",
+  "acceptanceCriteria": [
+    {
+      "id": "AC-1120-1",
+      "description": "Server state and UI state are held in separate mechanisms; view state (selection, panels, drafts) never enters the server-state cache.",
+      "given": "the client state architecture",
+      "when": "stores are audited",
+      "then": "the separation holds with no view state in the query cache",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1120-2",
+      "description": "A route with cached data renders the cached view immediately while revalidating in the background; a change from revalidation updates in place without a loading flash.",
+      "given": "a previously visited route with cached data",
+      "when": "the user returns",
+      "then": "content is instant, then silently refreshed",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1120-3",
+      "description": "Every mutation declares the cache entries it invalidates; affected views reflect the write without manual refresh.",
+      "given": "a mutation touching a cached collection",
+      "when": "it succeeds",
+      "then": "the collection view shows the change on next render",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1120-4",
+      "description": "Optimistic updates render immediately where declared, and on failure roll back visibly with an error state explaining the reversal.",
+      "given": "a declared-optimistic mutation forced to fail",
+      "when": "the failure lands",
+      "then": "the optimistic change reverts and the user is told why",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1120-5",
+      "description": "Concurrent identical reads deduplicate into one request.",
+      "given": "two components mounting with the same query key",
+      "when": "both request data",
+      "then": "one network request serves both",
+      "testable": true,
+      "scope": "runtime"
+    },
+    {
+      "id": "AC-1120-6",
+      "description": "Cache keys derive from canonical resource URLs so invalidation addresses resources exactly and misses nothing that displays the written resource.",
+      "given": "a resource displayed on two routes",
+      "when": "the resource is mutated from one",
+      "then": "both routes show the new value on next render",
+      "testable": true,
+      "scope": "runtime"
+    }
+  ],
+  "tacIds": [
+    "TAC-204-application-spa-client-data-layer"
+  ],
+  "createdAt": "2026-08-19T09:00:00Z",
+  "updatedAt": "2026-08-19T09:00:00Z"
+}