# ISIS v2 WS12-004: Reference Asset Boards for Character/Style/Environment Anchors

## Scope

`WS12-004` implements dedicated reference asset board workflows for
character/style/environment anchor curation in Job Submission Studio, enabling
ordered asset-board management instead of manual comma-separated editing only.

## Research and Existing Implementation Alignment

Implementation extended existing continuity controls already present in:

- `apps/isis/web/src/pages/JobSubmissionStudio.tsx`
- `apps/isis/web/src/pages/job-submission-utils.ts`

The new board workflows were designed to remain schema-compatible by
synchronizing board operations directly into existing continuity
`referenceAssetIds` form fields.

## Deliverables

1. Added reference asset board utility module:

- `apps/isis/web/src/pages/reference-asset-board-utils.ts`
- capabilities:
  - parse/canonicalize comma-separated asset id fields,
  - serialize normalized board order back into form field format,
  - add/remove/reorder operations with validation and duplicate prevention.

2. Added utility test coverage:

- `apps/isis/web/src/pages/reference-asset-board-utils.spec.ts`
- validates parsing, serialization, mutations, ordering bounds, and validation
  errors.

3. Implemented board UIs in Job Submission Studio continuity controls:

- `apps/isis/web/src/pages/JobSubmissionStudio.tsx`
- added:
  - `Character Anchor Reference Board`
  - `Style Anchor Reference Board`
  - `Environment Anchor Reference Board`
- each board supports:
  - add by asset id,
  - remove,
  - move up/down ordering,
  - empty-state guidance,
  - synchronized updates to existing continuity reference asset fields.
- added unified board-level validation error surfacing.

4. Extended Job Submission Studio test intent:

- `apps/isis/web/src/pages/JobSubmissionStudio.spec.tsx`
- includes scenario for board add/remove synchronization across
  character/style/environment continuity fields.

## Verification Commands

```bash
pnpm --filter @isis/web exec vitest run src/pages/reference-asset-board-utils.spec.ts src/pages/job-submission-utils.spec.ts --reporter=dot
pnpm --filter @isis/web exec vitest run src/pages/JobSubmissionStudio.spec.tsx --reporter=dot
pnpm --filter @isis/web run typecheck
node scripts/isis/generate-remediation-backlog-v2.mjs
node scripts/isis/validate-v2-compliance-gate.mjs
```

## Verification Notes

- `reference-asset-board-utils.spec.ts` and `job-submission-utils.spec.ts` pass.
- `JobSubmissionStudio.spec.tsx` remains blocked by the pre-existing
  `@isis/client` package-entry resolution issue in this workspace baseline.
- workspace typecheck remains red due pre-existing unrelated baseline issues.
