--- path: /studio/hathor/lore-validation-causality surface: studio domain: hathor auth: signed-in + studio entitlement source: apps/oshun/web/src/app/studio/hathor/lore-validation-causality/page.tsx status: walked last_walked: '2026-06-29 real-BFF route addendum — Playwright now covers the signed-in admin route, real catalog GET, seeded cycle-detection POST, opt-in orphan/dangling advisory POST, client-only validation errors, live BFF 400 detail, loading/error, pending submit disablement, non-admin fail-closed state, anonymous redirect, route map, quick actions, 44px automated touch checks, and the shared axe gate. Evidence: WALKTHROUGH/results/v1-real-infra-run-2026-06-22.md §225; apps/oshun/web/e2e/studio-hathor-lore-validation-causality.spec.ts. 2026-05-29 automated runtime walk evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md; body re-derived 2026-06-03 from current source (lane-console architecture)' --- # Studio Hathor · Lore Validation Causality ## Purpose Admin lane console for the `@hathor/validation` CausalityValidator. The single validate lane submits a set of events with causal links and checks the causal graph for integrity — broken references, causes dated after their effects, and cycles (A→B→A) — plus opt-in orphan-effect and dangling-cause advisories. Admin-scoped and fail-closed. ## Entry points - **Direct URL / bookmark** — `/studio/hathor/lore-validation-causality`; `alternates.canonical` is set. - **Quick-action from siblings** — this page links to the Lore Validation Timeline lane. - **Studio overview** — see [`../../studio-overview.md`](../../studio-overview.md). ## Layout regions `page.tsx` renders inside ``: - **Workspace** (`StudioHathorLoreValidationCausalityWorkspace`, `data-hathor-lore-validation-causality-workspace`): - `

` `WorkspaceHeading` — "Hathor Lore Validation Causality Workspace" - Summary `

` - The catalog state (`data-hathor-lvc-catalog`), then the events form (with advisory toggles), pending submit state, validation errors, and result. - **Route Map panel** (`

`, `

Route Map

`): 5 entries from `STUDIO_HATHOR_LORE_VALIDATION_CAUSALITY_ROUTE_MAP` (path + purpose). - **Quick-action lane** (`data-hathor-lvc-quick-actions`, `data-hathor-lvc-quick-action-count="2"`): Lore Validation Timeline (`data-hathor-lvc-quick-action="lore-validation-timeline"`) and Back to Studio workspace index (`data-hathor-lvc-quick-action="studio-index"`). ## States - [x] **Loading** — `

` "Loading causality validator…". - [x] **Unauthorized** — `data-hathor-lvc-unauthorized` on 401/403 (admin-scope). - [x] **Error** — `data-hathor-lvc-error` on a non-OK catalog response or network failure. - [x] **Ready (form)** — `data-hathor-lvc-validate-form` with `data-hathor-lvc-form-state="idle"`, the events textarea, and the three advisory checkboxes. - [x] **Pending submit** — `data-hathor-lvc-form-state="validating"` and `data-hathor-lvc-submit-state="validating"`; submit is disabled with `aria-disabled="true"` and `aria-busy="true"` until the BFF response returns. - [x] **Result** — `data-hathor-lvc-result` with `data-hathor-lvc-valid`, `data-hathor-lvc-counts` (links / errors / warnings / cycles / orphan / dangling), and `data-hathor-lvc-issues` rows (or `data-hathor-lvc-clean`). - [x] **Validation error** — `data-hathor-lvc-validate-error` for malformed JSON, an empty array, or a failed POST. ## Interactions - [x] **`data-hathor-lvc-events`** (textarea, `aria-label="events json"`) — edit the events JSON array (`{ id, name, year, causes?, effects?:[{ eventId, type?, strength? }] }`). - [x] **`data-hathor-lvc-detect-cycles`** (checkbox) — toggle cycle detection. - [x] **`data-hathor-lvc-warn-orphans`** (checkbox) — toggle orphan-effect advisory. - [x] **`data-hathor-lvc-warn-dangling`** (checkbox) — toggle dangling-cause advisory. - [x] **`data-hathor-lvc-validate-submit`** ("Validate causality") — parses the JSON and POSTs `{ events, detectCycles, warnOrphanEffects, warnDanglingCauses }`; on 200 with a valid `result` renders the verdict. - [x] **Route Map entries** — verify against `STUDIO_HATHOR_LORE_VALIDATION_CAUSALITY_ROUTE_MAP` (5 entries). - [x] **Quick-action links** — Lore Validation Timeline (`/studio/hathor/lore-validation-timeline`), Back to Studio (`/studio`). ## Data & contracts - **Reads**: `GET /v1/admin/hathor/lore-validation-causality` (catalog: `issueCodes`, `causalityTypes`, `strengths`), rendered as `data-hathor-lvc-catalog`. - **Writes**: `POST /v1/admin/hathor/lore-validation-causality/validate` with the events + advisory flags. The happy path returns `{ ok: true, result }`; invalid events return BFF 400 `reason` strings such as `invalid_event`, which the lane surfaces in `data-hathor-lvc-validate-error`. - **Realtime**: none. - **Caching**: client fetch on mount, `cache: 'no-store'`, `buildBffAuthHeaders()`, `AbortController` on unmount. - **Auth**: admin-scoped, fail-closed (401/403 → unauthorized); route is behind the signed-in + studio proxy gate. ## Cross-references - Parent: [`../../studio-overview.md`](../../studio-overview.md) - Component sources: - `apps/oshun/web/src/components/studio/StudioHathorLoreValidationCausalityWorkspace.tsx` - `apps/oshun/web/src/components/studio/StudioHathorLoreValidationCausalityRouteMap.ts` - Siblings: [`./studio-hathor-lore-validation-timeline.md`](./studio-hathor-lore-validation-timeline.md), [`./studio-hathor-lore-validation-contradictions.md`](./studio-hathor-lore-validation-contradictions.md), [`./studio-hathor-lore-validation-taxonomy.md`](./studio-hathor-lore-validation-taxonomy.md), [`./studio-hathor-unified-validation-dashboard.md`](./studio-hathor-unified-validation-dashboard.md) ## E2E coverage - [`apps/oshun/web/e2e/studio-hathor-lore-validation-causality.spec.ts`](../../../../apps/oshun/web/e2e/studio-hathor-lore-validation-causality.spec.ts) — signed-in admin route; real Hathor causality-validation BFF catalog and validate calls; seeded `CAUSALITY_CYCLE_DETECTED`; opt-in `CAUSALITY_ORPHAN_EFFECT` / `CAUSALITY_DANGLING_CAUSE`; malformed JSON and empty-array zero-POST branches; live BFF `invalid_event` 400 detail; catalog loading/error; pending submit lockout; non-admin fail-closed state; anonymous redirect; route-map and quick-action anchors; automated 44px checks for the main editable controls and quick actions; shared axe gate. - Supporting route contract coverage: `apps/oshun/bff/src/__tests__/admin-hathor-lore-validation-causality-route.test.ts` covers auth/scope, issue-code/type/strength catalog, chain break, temporal violation, cycle detection, clean chain advisories, and BFF 400 payload validation. ## Open questions / known gaps - [x] Hathor is confirmed in V1 per `WALKTHROUGH/matrix/routes.csv` and `WALKTHROUGH/matrix/coverage.md` (product-owner confirmation recorded 2026-05-29 for Bellona / Hathor / Neith). - [ ] Manual screen-reader pass remains for the live browser surface; automated axe and touch-target coverage now pass for the route-level controls.