Generated: 2026-08-02T16:03:34.715Z Checklist: MXA-0335 (ISIS2-00533) Asset
Family: material-pbr-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Expose material-pbr-pack workflows in Isis web UI with ergonomic variant-specific controls and deterministic validation aligned to API and SDK typed contracts.
Workflow Coverage#
| Workflow ID | Covered |
|---|---|
material-pbr-pack-baseline |
yes |
material-pbr-pack-image-conditioned |
yes |
material-pbr-pack-control-conditioned |
yes |
material-pbr-pack-consistency-locked |
yes |
Ergonomic Controls#
Material Category (required): presentSurface Age Profile (required): presentAlbedo Palette Profile (required): presentRoughness Profile (required): presentMetallic Profile (required): presentNormal Intensity Profile (required): presentMicrodetail Profile (required): presentMacro Pattern Scale (required): presentTileability Mode (required): presentUV Repeat Target (required): presentDisplacement Intent (required): presentRender Lighting Context (required): presentPlatform Target (required): presentRender Intent (required): presentMaterial Subtype (required): presentCheckpoint ID (required): presentPrompt Template ID (required): presentStyle Profile ID (required): presentColor Script (required): presentLens Profile (required): presentSeed (required): presentWidth (required): presentHeight (required): presentSteps (required): presentCFG Scale (required): presentNegative Prompt: presentMaterial Finish Preset (required): presentStyle Reference Image (required): presentUse Composition Reference: presentComposition Reference Image: presentReference Strength: presentComposition Strength: presentMaterial Control Preset (required): presentUse Pose Control: presentPose Map: presentPose Strength: presentUse Depth Control: presentDepth Map: presentDepth Strength: presentUse Segmentation Control: presentSegmentation Map: presentSegmentation Strength: presentUse Normal Control: presentNormal Map: presentNormal Strength: presentUse Canny Control: presentCanny Map: presentCanny Strength: presentUse Lineart Control: presentLineart Map: presentLineart Strength: presentUse Mask Region Guide: presentMask Region Map: presentMask Guide Strength: presentControl Blend Precedence: presentControl Blend Conflict Policy: presentControl Blend ControlNet Scale: presentControl Blend IPAdapter Scale: presentControl Blend InstantID Scale: presentControl Blend ControlNet Schedule Start: presentControl Blend ControlNet Schedule End: presentControl Blend ControlNet Schedule Curve: presentControl Blend IPAdapter Schedule Start: presentControl Blend IPAdapter Schedule End: presentControl Blend IPAdapter Schedule Curve: presentControl Blend InstantID Schedule Start: presentControl Blend InstantID Schedule End: presentControl Blend InstantID Schedule Curve: presentContinuity Profile ID: presentContinuity Profile Revision: presentContinuity Locked Dimensions: presentMaterial Scene Profile ID (required): presentMaterial Anchor Reference Image (required): presentUse Material Anchor Reference: presentUse Roughness Reference: presentRoughness Reference Map: presentUse Normal Reference: presentNormal Reference Map: presentUse Lens Reference: presentLens Reference Frame: presentTexture Resolution Tier (required): presentChannel Pack Profile (required): presentSeam Suppression Profile (required): presentUse Style Lock: presentMaterial Anchor Lock Strength: presentRoughness Lock Strength: presentNormal Lock Strength: presentLens Lock Strength: presentStyle Lock Strength: present
Validation Rules#
- present: Material PBR pack workflows require generation type text-to-image.
- present: Material Category is required.
- present: Material Subtype is required.
- present: Surface Age Profile is required.
- present: Albedo Palette Profile is required.
- present: Roughness Profile is required.
- present: Metallic Profile is required.
- present: Normal Intensity Profile is required.
- present: Microdetail Profile is required.
- present: Macro Pattern Scale is required.
- present: Tileability Mode is required.
- present: UV Repeat Target is required.
- present: Displacement Intent is required.
- present: Render Lighting Context is required.
- present: Platform Target is required.
- present: Render Intent is required.
- present: Checkpoint ID is required.
- present: Prompt Template ID is required.
- present: Style Profile ID is required.
- present: Color Script is required.
- present: Lens Profile is required.
- present: Material Finish Preset is required.
- present: Style Reference Image is required.
- present: Composition Reference Image is required when composition reference is enabled.
- present: Material Control Preset is required.
- present: At least one control must be enabled for control-conditioned workflows.
- present: Pose Map is required when pose control is enabled.
- present: Depth Map is required when depth control is enabled.
- present: Segmentation Map is required when segmentation control is enabled.
- present: Normal Map is required when normal control is enabled.
- present: Canny Map is required when canny control is enabled.
- present: Lineart Map is required when lineart control is enabled.
- present: Mask Region Map is required when mask region guide is enabled.
- present: Control Blend Precedence entries must be unique.
- present: Control Blend ControlNet Scale must be between 0 and 2.
- present: Control Blend IPAdapter Scale must be between 0 and 2.
- present: Control Blend InstantID Scale must be between 0 and 2.
- present: Control Blend ControlNet schedule start must be less than or equal to end.
- present: Control Blend IPAdapter schedule start must be less than or equal to end.
- present: Control Blend InstantID schedule start must be less than or equal to end.
- present: Continuity Profile ID must be scene-continuity-profile.
- present: Continuity Locked Dimensions is required.
- present: Material Scene Profile ID is required.
- present: Material Anchor Reference Image is required.
- present: Texture Resolution Tier is required.
- present: Channel Pack Profile is required.
- present: Seam Suppression Profile is required.
- present: Roughness Reference Map is required when roughness reference is enabled.
- present: Normal Reference Map is required when normal reference is enabled.
- present: Lens Reference Frame is required when lens reference is enabled.
Verification Commands#
pnpm --filter @isis/web exec vitest run src/pages/material-pbr-pack-ui-utils.spec.tspnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "material pbr pack"pnpm --filter @isis/web exec vitest run src/pages/workflow-run-utils.spec.tspnpm --filter @isis/web exec playwright test e2e/material-pbr-pack-controls.spec.ts --project=chromium
Acceptance Criteria#
- Workflow details page renders ergonomic variant-specific material-pbr-pack controls for all four workflow IDs.
- Web UI validation enforces typed contract constraints (generation type lock, required fields, control toggles, and conditional map/reference requirements).
- Workflow run dispatch includes explicit generationType/type fields for typed API contract alignment.
- Web UI tests cover ergonomic form rendering, validation errors, and successful workflow run payload dispatch.
Traceability#
- Checklist item:
MXA-0335 - Ticket key:
ISIS2-00533 - Source references:
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.jsondocs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.jsondocs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_SDK_END_TO_END_EXAMPLES.jsonapps/isis/web/src/pages/WorkflowDetailsPage.tsxapps/isis/web/src/pages/WorkflowDetailsPage.spec.tsxapps/isis/web/src/pages/WorkflowControlBlendPanel.tsxapps/isis/web/src/pages/material-pbr-pack-ui-utils.tsapps/isis/web/src/pages/material-pbr-pack-ui-utils.spec.tsapps/isis/web/src/pages/workflow-control-blend-ui-utils.tsapps/isis/web/src/pages/workflow-run-utils.tsISIS_TODOS_2.md