V1 Web PWA · Surface walkthrough

Isis ComfyUI SDK

A per-surface walkthrough of the V1 Web PWA studio surface: layout, states, interactions, data, and cross-references.

walked
8sections3 minread
Markdown source
On this page

Context. surface studio · domain isis · route /studio/isis/comfyui-sdk · auth signed-in + studio entitlement (AAA-gated — segment comfyui-sdk in AAA_ONLY_STUDIO_ROUTES) · source apps/oshun/web/src/app/studio/isis/comfyui-sdk/page.tsx

Last walked. 2026-07-24 automated Chromium + Pixel 7 walk — production hard-block, localhost-only entry, real semver form, exact hybrid authority boundary, route status, touch targets, responsive containment, and applicable axe verified

Purpose#

Request-local, non-authoritative semantic-version evaluator with embedded lanes. It hosts one directly-owned wired lane — Node Versioning & Compatibility, via /v1/admin/isis/comfyui-sdk — plus five sibling lane workspaces (ComfyUI Nodes, ComfyUI Integration, Workflow Definitions, Client SDK, Generation API). Apart from the versioning lane it owns no /v1 fetch. It retains no package/release state and owns no distribution, diagnostic/evidence, parity, governance, approval, or release authority.

Entry points#

  • Breadcrumb in-page (data-isis-comfyui-sdk-breadcrumbs)
  • Sibling quick-actions: /studio/isis/client-sdk, /studio/isis/comfyui-integration, /studio/isis/comfyui-nodes
  • Studio index (/studio)
  • Direct URL / bookmark (AAA entitlement required)

Layout regions#

page.tsx mounts <ShellLayout active="studio"> plus a breadcrumb panel, the workspace, the Route Map, and sibling quick-actions.

  • Header: shell header
  • Breadcrumb panel (data-isis-comfyui-sdk-breadcrumbs)
  • Workspace panel (data-isis-comfyui-sdk-workspace):
    • <h1> (WorkspaceHeading) "Isis ComfyUI SDK Workspace"
    • Summary paragraph (data-isis-comfyui-sdk-summary)
    • Exact request_local_non_authoritative_semver_evaluation_with_embedded_lane_composition disposition and four-card Authority Boundary
    • Node Versioning & Compatibility lane (StudioIsisComfyuiSdkVersioningLane, <h2>Node Versioning &amp; Compatibility</h2>) — the directly-owned wired lane (GET /v1/admin/isis/comfyui-sdk, POST /v1/admin/isis/comfyui-sdk/evaluate)
    • ComfyUI Nodes Lane (data-isis-comfyui-sdk-comfyui-nodes-lane) → StudioIsisComfyuiNodesWorkspace
    • ComfyUI Integration Lane (data-isis-comfyui-sdk-comfyui-integration-lane) → StudioIsisComfyUIIntegrationWorkspace
    • Workflow Definitions Lane (data-isis-comfyui-sdk-workflow-definitions-lane) → StudioIsisWorkflowDefinitionsWorkspace
    • Client SDK Lane (data-isis-comfyui-sdk-client-sdk-lane) → StudioIsisClientSdkWorkspace
    • Generation API Lane (data-isis-comfyui-sdk-generation-api-lane) → StudioIsisGenerationApiWorkspace
  • Route Map panel (data-isis-comfyui-sdk-route-map): one mounted-hybrid-tool and five documented-contract entries
  • Sibling quick-actions panel: /studio/isis/client-sdk, /studio/isis/comfyui-integration, /studio/isis/comfyui-nodes, /studio

States#

Interactions#

Capability Summary#

  • Capability article ×4 — non-interactive

Node Versioning & Compatibility lane (owned, wired)#

  • Evaluates SDK version compatibility; POST /v1/admin/isis/comfyui-sdk/evaluate

Embedded sibling lanes#

  • ComfyUI Nodes Lane — walk in its own doc
  • ComfyUI Integration Lane — walk in its own doc
  • Workflow Definitions Lane — walk in its own doc
  • Client SDK Lane — walk in its own doc
  • Generation API Lane — walk in its own doc

Route Map#

  • Route-map articles ×6

Sibling quick-actions#

  • Open Isis Client SDK workspace → /studio/isis/client-sdk
  • Open Isis ComfyUI Integration workspace → /studio/isis/comfyui-integration
  • Open Isis ComfyUI Nodes workspace → /studio/isis/comfyui-nodes
  • Back to Studio workspace index → /studio

Data & contracts#

  • Reads: the owned versioning lane reads GET /v1/admin/isis/comfyui-sdk; sibling lanes read their own endpoints
  • Writes: the owned versioning lane writes POST /v1/admin/isis/comfyui-sdk/evaluate; sibling lanes write their own
  • Persistence: none for version inputs or results; evaluation is request-local and recomputable
  • Authority: no package publish, distribution, migration, diagnostic/ evidence record, parity certification, audit, governance, approval, or release action
  • Realtime: none
  • Caching: versioning lane client fetch on mount, cache: 'no-store', buildBffAuthHeaders()
  • Auth/role check: route AAA-gated (comfyui-sdk in AAA_ONLY_STUDIO_ROUTES); the versioning lane and each embedded lane are admin-scoped and fail closed
  • Component sources:
    • apps/oshun/web/src/components/studio/StudioIsisComfyuiSdkWorkspace.tsx
    • apps/oshun/web/src/components/studio/StudioIsisComfyuiSdkVersioningLane.tsx
    • apps/oshun/web/src/components/studio/StudioIsisComfyuiSdkRouteMap.ts

Cross-references#

Open questions / known gaps#

  • Apart from the owned versioning lane, the aggregator owns no backend call; sibling-lane coverage depends on each lane's own walkthrough
  • Package, release, diagnostics, parity, and governance paths are documented shapes only, with no pages or corresponding authority