Isis Auto Rigging

Purpose#

Hybrid Isis auto-rigging surface. The load-bearing wired piece is the live humanoid rig validator lane, which checks a detected bone set against the Unity-Humanoid required minimum (plus common optional bones) and reports missing required bones, coverage, and retarget-readiness. Around it sits a retained expert shell driven by demo sessions and the shared motion catalog.

Entry points#

• Quick-action card from /studio/isis/topology-verification
• Studio index (/studio)
• Direct URL / bookmark (AAA-gated)

Layout regions#

page.tsx mounts ShellLayout active="studio" and three panels (no breadcrumb panel). The workspace renders the skeleton lane, then the expert client.

• Skeleton lane (data-hrl-lane, <h2> data-hrl-heading "Live Humanoid Rig Validator") — the wired, real-backed validator
• Workspace panel (data-isis-auto-rigging-workspace):
  • <h1> "Isis Auto-Rigging Workspace" (WorkspaceHeading) + summary (data-isis-auto-rigging-summary)
  • KPI band (data-isis-auto-rigging-kpis), session rail (data-isis-auto-rigging-session-rail, data-isis-auto-rigging-session-option), and active-session detail (data-isis-auto-rigging-active-session) — driven by demo sessions + the local motion catalog
• Route map panel (data-isis-auto-rigging-route-map): <h2> "Route Map" enumerating STUDIO_ISIS_AUTO_RIGGING_ROUTE_MAP
• Quick-actions panel: quickAction links to /studio/isis/topology-verification and "Back to Studio workspace index" → /studio

States#

Rig validator lane (wired)#

• Loading — data-hrl-loading "Loading rig validator…"
• Unauthorized — data-hrl-unauthorized (admin-scope fail-closed on 401/403, "Isis workspace scope required to validate rigs.")
• Error — data-hrl-error on the mount GET
• Ready (form) — data-hrl-form rig-bones JSON textarea + submit
• Result — data-hrl-result with data-hrl-headline (data-complete yes/no, data-hrl-coverage), data-hrl-missing of data-hrl-missing-row; or data-hrl-validate-error

Expert shell (legacy, demo-data)#

• Session rail / active session — render from createStudioIsisAutoRiggingDemoSessions() + the local motion catalog; no /v1 call

Interactions#

Validate rig (data-hrl-form)#

• Rig bones JSON — data-hrl-payload textarea (bones list)
• Validate rig — data-hrl-submit submit; POSTs to /v1/admin/isis/auto-rigging/validate-rig, returns coverage + missing required bones + retarget-readiness

Expert shell#

• Session options — data-isis-auto-rigging-session-option={id} switch the active demo session (client-only)

Route map#

• Route-map articles — non-interactive path + purpose entries

Quick-actions#

• Open Isis Topology Verification workspace → /studio/isis/topology-verification
• Back to Studio workspace index → /studio

Data & contracts#

• Reads: GET /v1/admin/isis/auto-rigging (HRL_ENDPOINT) on mount — gate check
• Writes: POST /v1/admin/isis/auto-rigging/validate-rig (HRL_VALIDATE_ENDPOINT) — validate a humanoid rig
• Realtime: None
• Caching: client fetch on mount, cache: 'no-store', buildBffAuthHeaders()
• Auth: admin-scoped fail-closed (401/403 → unauthorized state); AAA-gated studio route behind the signed-in + studio proxy gate
• Component sources:
  • apps/oshun/web/src/components/studio/StudioIsisAutoRiggingWorkspace.tsx
  • apps/oshun/web/src/components/studio/StudioIsisAutoRiggingSkeletonLane.tsx
  • apps/oshun/web/src/components/studio/StudioIsisAutoRiggingWorkspaceClient.tsx
  • apps/oshun/web/src/components/studio/StudioIsisAutoRiggingRouteMap.ts

Cross-references#

• Studio overview: ../../studio-overview.md
• Sibling routes:
  • studio-isis-topology-verification.md
  • studio-isis-texture-enhancement.md

Open questions / known gaps#

• The expert shell (session rail, KPIs, motion catalog) runs on createStudioIsisAutoRiggingDemoSessions() demo data — it is not wired to a persisted rigging-session store
• Only the rig validator lane is wired to a /v1 endpoint; motion application / skin-weight refinement stages are not yet persisted server-side