Studio Hathor · Workbench Dashboard

Purpose#

Admin lane console that rolls the real @hathor/domain-models region scorers into an aggregate world overview. Describe a world's regions and read back per-region geography scores plus rolled-up world metrics — region count, mean composite danger, mean biodiversity, fully-explored count, the most dangerous region, and a dominant-terrain histogram. Admin-scoped and fail-closed.

Entry points#

• Quick-action link from /studio/hathor/lore-fact-checking (this page links out to lore-fact-checking)
• Aggregator embed: StudioHathorWorkbenchWorkspace mounts this workspace inline as its "Workbench Dashboard Lane"
• Direct URL / bookmark — yes; alternates.canonical set
• Studio overview — see ../../studio-overview.md

Layout regions#

page.tsx renders inside <ShellLayout active="studio">:

• Workspace <section data-hathor-workbench-dashboard-workspace>:
  • <h1> (WorkspaceHeading) "Hathor Workbench Dashboard Workspace"
  • Summary <p data-hathor-workbench-dashboard-summary>
  • The overview form lane: data-hathor-wd-form
• Route Map panel (data-hathor-workbench-dashboard-route-map): <h2> "Route Map" + 5 entries from STUDIO_HATHOR_WORKBENCH_DASHBOARD_ROUTE_MAP
• Quick-action lane: two Link.quickAction anchors — Lore Fact-Checking, Back to Studio workspace index

States#

• Loading — <p data-hathor-wd-loading>
• Unauthorized — data-hathor-wd-unauthorized on 401/403 (admin Hathor scope required); fail-closed
• Error — data-hathor-wd-error on non-OK GET / malformed catalog
• Ready (form) — data-hathor-wd-form once the catalog loads
• Result — data-hathor-wd-result after a 200 overview; data-hathor-wd-overview-error for invalid JSON / non-200

Interactions#

Workspace body (overview form lane)#

• Regions (JSON array) — <textarea data-hathor-wd-regions> (aria-label "regions json")
• Build world overview — <button data-hathor-wd-submit type="submit"> → POST /v1/admin/hathor/workbench-dashboard/overview
• Result — data-hathor-wd-region-count, data-hathor-wd-avg-danger, data-hathor-wd-avg-biodiversity, data-hathor-wd-explored, data-hathor-wd-most-dangerous, and a data-hathor-wd-region-list of data-hathor-wd-region rows

Route Map panel#

• 5 route entries — verify match with STUDIO_HATHOR_WORKBENCH_DASHBOARD_ROUTE_MAP

Quick-action lane#

• "Open Hathor Lore Fact-Checking workspace" (→ /studio/hathor/lore-fact-checking)
• "Back to Studio workspace index" (→ /studio)

Data & contracts#

• Reads: GET /v1/admin/hathor/workbench-dashboard on mount
• Writes: POST /v1/admin/hathor/workbench-dashboard/overview
• Realtime: none
• Caching: client fetch on mount, cache: 'no-store'; buildBffAuthHeaders
• Auth/role check: admin-scoped fail-closed (401/403); behind the signed-in
  • studio proxy gate

Cross-references#

• Parent: ../../studio-overview.md
• Shell: ../../../shell/04-auth-session.md
• Sibling routes: ./studio-hathor-workbench.md (aggregator that embeds this workspace), ./studio-hathor-geography-modeling.md (the per-region scorer this dashboard rolls up)
• Component sources:
  • apps/oshun/web/src/components/studio/StudioHathorWorkbenchDashboardWorkspace.tsx
  • apps/oshun/web/src/components/studio/StudioHathorWorkbenchDashboardRouteMap.ts

Open questions / known gaps#

• Hathor is unconfirmed-v1 per WALKTHROUGH/matrix/routes.csv. Confirm whether the dedicated /studio/hathor/* admin lane consoles ship in V1.
• The "dashboard" computes an overview from a pasted regions payload rather than from a persisted world; confirm whether it should read a stored world instead of taking the regions inline.
• Route Map advertises queues/, reviews/, alerts/, and governance/ sub-routes with no page.tsx yet.