Isis Texture Enhancement

Purpose#

Admin lane console that evaluates a texture-enhancement batch against its quality gate. Each fixture gets a PSNR-like score; the batch passes only when the worst fixture clears the threshold, so a single bad texture fails the whole batch. The verdict, mean/min/max, and per-fixture scores come from the real quality engine. This surface records durable internal review-package diagnostics over operator-supplied fixture scores. It does not ingest texture assets, run an upstream scorer or provider, create an artifact, or authorize release.

Entry points#

• Sibling quick-action card from /studio/isis/auto-rigging
• Studio index (/studio)
• Direct URL / bookmark

Layout regions#

page.tsx mounts ShellLayout active="studio" and three panels (no breadcrumb panel).

• Workspace panel (data-isis-texture-enhancement-workspace):
  • <h1> "Isis Texture Enhancement Workspace" (WorkspaceHeading)
  • Summary paragraph (data-texture-summary)
  • Exact durable diagnostic disposition (data-texture-disposition)
  • The "Evaluate a batch" form (data-texture-form)
  • Evaluated-batch list (data-texture-batches, <h2>) of data-texture-batch cards carrying data-texture-passing / data-texture-verdict
• Route map panel (data-isis-texture-enhancement-route-map): <h2> "Route Map" enumerating STUDIO_ISIS_TEXTURE_ENHANCEMENT_ROUTE_MAP
• Quick-actions panel: quickAction links to /studio/isis/auto-rigging and "Back to Studio workspace index" → /studio

States#

• Loading — data-texture-loading "Loading texture batches…"
• Unauthorized — data-texture-unauthorized (admin-scope fail-closed on 401/403)
• Error — data-texture-error on non-OK / malformed response
• Storage unavailable — load fails closed; a failed write reports that nothing was recorded (503)
• Erased operator — new evidence is refused with explicit account-erased guidance (410)
• Ready (form) — evaluate form + batch list render; empty list shows data-texture-batches-empty
• Result — data-texture-result with data-texture-status (ok / error)

Interactions#

Evaluate a batch (data-texture-form)#

• Batch id — data-texture-batchid text input
• Threshold — data-texture-threshold number input (step 0.1)
• Fixtures (fixtureId:score, comma-separated) — data-texture-fixtures text input; parsed preview shown in data-texture-parsed
• Evaluate batch — data-texture-evaluate submit; POSTs to /v1/admin/isis/texture-quality, validates the complete acknowledgement against the submitted id/threshold/fixture set, then prepends the committed result without depending on a reload

Route map#

• Route-map articles — non-interactive path + purpose entries distinguish one mounted diagnostic route from four documented-contract shapes for asset ingestion, artifacts, revisions, and governance

Quick-actions#

• Open Isis Auto Rigging workspace → /studio/isis/auto-rigging
• Back to Studio workspace index → /studio

Data & contracts#

• Reads: GET /v1/admin/isis/texture-quality (TEXTURE_ENDPOINT) on mount — exact { disposition, generatedAt, defaultThreshold, batches }
• Writes: POST /v1/admin/isis/texture-quality — evaluate a batch — exact { ok, batch, disposition }
• Disposition: durable_internal_texture_quality_review_packages_recomputable_projection; PostgreSQL persistence; authenticated-subject attribution; stored inputs recomputed and drift-checked; durable batch-id idempotency; durable redaction with a resurrection fence; canonical review_package retention for 2,555 days; no texture-asset ingest, provider execution, artifact output, or release authority
• Persistence: normalized PostgreSQL batch + ordered fixture rows; reads recompute the versioned scorer projection and fail closed on drift
• Attribution: evaluator identity comes only from authenticated server context; caller-supplied authorship fields are rejected
• Privacy / retention: internal non-exportable review_package evidence; fixture ids must be opaque and must not contain customer ids, source assets, or personal information. Signed profile erasure pseudonymizes attribution; canonical seven-year retention later purges evidence unless held while the digest resurrection fence remains.
• Realtime: None
• Validation: the client requires exact disposition, batch, fixture, and report shapes; it rejects missing, extra, malformed, authority-inflated, incorrectly echoed, and arithmetically inconsistent successful responses
• Caching: client fetches with cache: 'no-store'; authenticated scoped BFF success and failure responses also emit cache-control: no-store
• 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/StudioIsisTextureEnhancementWorkspace.tsx
  • apps/oshun/web/src/components/studio/StudioIsisTextureEnhancementRouteMap.ts

Cross-references#

• Studio overview: ../../studio-overview.md
• Sibling routes:
  • studio-isis-auto-rigging.md
  • studio-isis-topaz-enhancement.md

Open questions / known gaps#

• Per-fixture scores are supplied as fixtureId:score text rather than computed from real texture assets here — confirm where the upstream PSNR scoring runs
• Texture-asset ingestion, provider/model execution, artifact creation, revision authority, governance approval, and release authority are not bound to this diagnostic-history surface