--- path: /studio/aja/motion-enhancement surface: studio domain: aja auth: signed-in + studio entitlement source: apps/oshun/web/src/app/studio/aja/motion-enhancement/page.tsx status: walked + e2e-covered last_walked: '2026-05-29 automated runtime walk (Playwright headless) — render, /v1 data (2xx), console/page-errors, expected content, screenshot verified; live screen-reader, touch, offline, and telemetry-delivery checks pending a manual AT pass. Evidence: WALKTHROUGH/results/runtime-sweep-2026-05-29.md; body re-derived 2026-06-03 from current source (lane-console architecture); 2026-07-02 studio-aja-motion-lane-consoles Playwright pass covers live BFF catalog/assess, auth/schema gates, error states, quick actions, route map, capability cards, and mobile no-overflow.' --- # Studio Aja · Motion Enhancement ## Purpose Admin lane console for the real `@aja/motion-validation` `calculateTemporalMetrics` dynamics scorer. The operator submits an enhanced/smoothed motion and a reference motion (each a `{ joints, frames }` JSON of ≥4 frames); the lane compares the finite-difference velocity and acceleration of the two, plus jerk (third derivative) on both and a smoothness ratio capped at 1, and reads back the per-joint velocity/acceleration error, jerk, and smoothness. ## Entry points - **Direct URL / bookmark** — `/studio/aja/motion-enhancement`; metadata canonical to this path - **Studio nav** — Domain-bridge studios section of `/studio` - **Sibling quick-actions on this page**: Annotation and Collaboration, Back to Studio (no breadcrumb panel on this route) - **Operator surfacing** — see [`../../studio-overview.md`](../../studio-overview.md) ## Layout regions `page.tsx` renders inside ``: - **Workspace** (``, archetype: LEAF with a capability summary): - `

` (`WorkspaceHeading`) "Aja Motion Enhancement Workspace" - Summary `

` — operations lane scores an enhanced motion's dynamics (velocity, acceleration, jerk, smoothness) against a reference - **Capability Summary** panel (`data-aja-motion-enhancement-capability-summary`, `

Capability Summary

`) — 4 `data-aja-motion-enhancement-capability` cards: `enhancement-control-plane`, `diagnostics-and-trace-observability`, `security-permission-audit-controls`, `api-parity-and-contract-assurance` - **Operations lane** (`data-aja-motion-enhancement-operations-lane`, `

Motion Enhancement Operations Lane

`) — the live assess form - **Route Map panel** (`data-aja-motion-enhancement-route-map`): `

Route Map

` listing 5 entries from `STUDIO_AJA_MOTION_ENHANCEMENT_ROUTE_MAP` (primary, scenes, exports, revisions, governance) - **Quick-action panel**: two `Link.quickAction` anchors — Annotation and Collaboration, Back to Studio workspace index ## States - [x] **Loading** — operations lane GETs the dynamics catalog on mount; renders `

` "Loading dynamics metric…" - [x] **Unauthorized** — 401/403 renders `data-aja-me-unauthorized` ("Access restricted." + admin-scope message, default "Aja workspace scope required to score motion dynamics.") - [x] **Error** — non-OK / malformed / unreachable renders `data-aja-me-error` ("Could not load the dynamics metric." + reason) - [x] **Ready (form)** — success renders `data-aja-me-metric-summary` and the `data-aja-me-form` - [x] **Result** — a successful POST renders `data-aja-me-result` with `data-aja-me-smoothness` (smoothness · jerk ratio), `data-aja-me-velocity`, `data-aja-me-acceleration`, and a `data-aja-me-per-joint` list of `data-aja-me-joint-row` - [x] **Validation / assess error** — client guards (processed + reference valid JSON) and POST failures render `data-aja-me-assess-error` - [x] **Empty / Standalone PWA / offline** — N/A beyond the above; shell SSR, lane is a client fetch on mount ## Interactions ### Operations lane (`data-aja-me-form`) - [x] **Processed motion** (`data-aja-me-processed`, textarea, aria-label "processed motion json", JSON `{ joints, frames }`, ≥4 frames) - [x] **Reference motion** (`data-aja-me-reference`, textarea, aria-label "reference motion json", JSON `{ joints, frames }`, ≥4 frames) - [x] **"Compare dynamics"** (`data-aja-me-submit`, submit) — fires `POST /v1/admin/aja/motion-enhancement/assess` with `{ processed, reference }` ### Capability Summary - [x] **Capability cards** (4 × `

`) — non-interactive descriptive copy ### Route Map panel - [x] **Route entries** (5 × `
`) — non-interactive path+purpose ### Quick-action panel - [x] **"Open Aja Annotation and Collaboration workspace"** → `/studio/aja/annotation-and-collaboration` - [x] **"Back to Studio workspace index"** → `/studio` ## E2E coverage **Coverage depth**: deep. - `studio-aja-motion-lane-consoles.spec.ts` drives `/studio/aja/motion-enhancement` through the live temporal-dynamics catalog, malformed-JSON client guard with no POST, real BFF 400 short-motion validation detail, exact velocity / acceleration / jerk / smoothness result for an accelerating motion against a linear reference, 4 capability cards, 5 route-map entries, exact quick-action hrefs, loading / unauthorized / malformed-catalog fail-closed states, mobile no-overflow, 44 px submit target, and direct BFF 401 / 403 / 400 gates. ## Data & contracts - **Reads**: `GET /v1/admin/aja/motion-enhancement` on mount — catalog `{ metric, summary, measures: string[] }` - **Writes**: `POST /v1/admin/aja/motion-enhancement/assess` — `{ processed, reference }` → `{ result }` (velocityError, accelerationError, jerk, smoothness) - **Realtime**: none - **Caching**: client `fetch` on mount with `cache: 'no-store'` and `buildBffAuthHeaders()`; SSR shell only - **Auth/role check**: BFF endpoints admin-scoped + fail-closed (401/403 → unauthorized render); route behind the signed-in + studio proxy gate ## Cross-references - Parent: [`../../studio-overview.md`](../../studio-overview.md) - Shell: [`../../../shell/04-auth-session.md`](../../../shell/04-auth-session.md) - Sibling routes: [`./studio-aja-annotation-and-collaboration.md`](./studio-aja-annotation-and-collaboration.md) - Component sources: - `apps/oshun/web/src/components/studio/StudioAjaMotionEnhancementWorkspace.tsx` - `apps/oshun/web/src/components/studio/StudioAjaMotionEnhancementRouteMap.ts` ## Known downstream boundaries - Route-map sub-routes are advertised but have no `page.tsx` in V1; the browser spec asserts the current 5-entry descriptive route map only.