Generated: 2026-03-02T05:49:00.092Z Checklist: MXA-0389 (ISIS2-00587) Asset
Family: foliage-pack Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)
Objective#
Expose foliage-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 |
|---|---|
foliage-pack-baseline |
yes |
foliage-pack-image-conditioned |
yes |
foliage-pack-control-conditioned |
yes |
foliage-pack-consistency-locked |
yes |
Ergonomic Controls#
Foliage Theme (required): presentBiome Context (required): presentCanopy Structure Profile (required): presentSpecies Mix Profile (required): presentGround Cover Density Class (required): presentLeaf Cluster Scale Profile (required): presentStem Branch Complexity Profile (required): presentWind Response Profile (required): presentSeasonality Profile (required): presentTiling Mode (required): presentSeam Blend Strategy (required): presentFoliage Resolution Class (required): presentColor Palette Profile (required): presentSeed (required): presentWidth (required): presentHeight (required): presentSteps (required): presentCFG Scale (required): presentNegative Prompt: presentStyle Reference Image (required): presentUse Composition Reference: presentComposition Reference Image: presentReference Strength: presentComposition Strength: presentLeaf Specular Profile (required): presentBranch Bark Profile (required): presentPrompt Template ID (required): presentStyle Profile ID (required): presentColor Script (required): presentLens Profile (required): presentUse Depth Control: presentDepth Map: presentDepth Strength: presentUse Segmentation Control: presentSegmentation Map: presentSegmentation Strength: presentUse Normal Control: presentNormal Map: presentNormal Strength: presentUse Canny Control: presentEdge Map: presentCanny Strength: presentUse Lineart Control: presentLineart Map: presentLineart Strength: presentContinuity Profile ID: presentContinuity Profile Revision: presentContinuity Locked Dimensions: presentScene Profile ID (required): presentScene Anchor Reference Image (required): presentUse Scene Anchor Reference: presentUse Canopy Layout Reference: presentCanopy Layout Reference Map: presentUse Density Reference: presentDensity Reference Map: presentUse Lens Reference: presentLens Reference Frame: presentLOD Transition Profile (required): presentFocal Length mm (required): presentUse Style Lock: presentScene Anchor Lock Strength: presentCanopy Layout Lock Strength: presentDensity Lock Strength: presentLens Lock Strength: presentStyle Lock Strength: present
Validation Rules#
- present: Foliage pack workflows require generation type text-to-image.
- present: Foliage Theme is required.
- present: Biome Context is required.
- present: Canopy Structure Profile is required.
- present: Species Mix Profile is required.
- present: Ground Cover Density Class is required.
- present: Leaf Cluster Scale Profile is required.
- present: Stem Branch Complexity Profile is required.
- present: Wind Response Profile is required.
- present: Seasonality Profile is required.
- present: Tiling Mode is required.
- present: Seam Blend Strategy is required.
- present: Foliage Resolution Class is required.
- present: Color Palette Profile is required.
- present: Style Reference Image is required.
- present: Leaf Specular Profile is required.
- present: Branch Bark Profile 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: Composition Reference Image is required when composition reference is enabled.
- present: At least one control must be enabled for control-conditioned workflows.
- 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: Edge Map is required when canny control is enabled.
- present: Lineart Map is required when lineart control is enabled.
- present: Continuity Profile ID must be scene-continuity-profile.
- present: Continuity Locked Dimensions is required.
- present: Scene Profile ID is required.
- present: Scene Anchor Reference Image is required.
- present: LOD Transition Profile is required.
- present: Canopy Layout Reference Map is required when canopy layout reference is enabled.
- present: Density Reference Map is required when density 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/foliage-pack-ui-utils.spec.tspnpm --filter @isis/web exec vitest run src/pages/WorkflowDetailsPage.spec.tsx -t "foliage pack"pnpm --filter @isis/web exec vitest run src/pages/workflow-run-utils.spec.ts
Acceptance Criteria#
- Workflow details page renders ergonomic variant-specific foliage-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-0389 - Ticket key:
ISIS2-00587 - Source references:
docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.jsondocs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_REQUIREMENTS_BRIEF.jsondocs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_SDK_END_TO_END_EXAMPLES.jsonapps/isis/web/src/pages/WorkflowDetailsPage.tsxapps/isis/web/src/pages/WorkflowDetailsPage.spec.tsxapps/isis/web/src/pages/foliage-pack-ui-utils.tsapps/isis/web/src/pages/foliage-pack-ui-utils.spec.tsapps/isis/web/src/pages/workflow-run-utils.tsISIS_TODOS_2.md