# ISIS v2 WS13-008: Region/Retention Compliance Profiles for Enterprise Tenants

## Scope

`WS13-008` implements enterprise region/retention compliance profiles across job
submission, output review, and parity validation surfaces.

The implementation introduces deterministic policy checks for storage region,
retention policy naming, retention duration thresholds, and required residency
tags, with strict/review/advisory enforcement, submit-time gating, and persisted
output compliance disposition metadata.

## Research and Existing Implementation Alignment

Before implementation, the following existing patterns were analyzed and reused:

- policy-engine and signal modeling patterns from:
  - `content-governance-policy-utils.ts`
  - `abuse-controls-utils.ts`
  - `model-provenance-licensing-utils.ts`
- output metadata merge/read patterns already used in `OutputsPage` for
  governance, provenance, and artifact-integrity controls,
- submit-time policy evaluation and review acknowledgement gating patterns in
  `JobSubmissionStudio`,
- parity action/coverage wiring patterns in `OutputsParityPage`.

This produced a utility-first implementation with normalized policy config,
deterministic report generation, consistent metadata persistence, and UI parity
across core operational surfaces.

## Deliverables

1. Added shared region/retention compliance policy utility:

- `apps/isis/web/src/security/region-retention-compliance-utils.ts`
  - strict/review/advisory policy defaults + normalization,
  - normalized list parsing and serialization helpers,
  - deterministic policy evaluation with structured compliance signals,
  - output metadata merge/read helpers for reviewed disposition records.

2. Added utility unit coverage:

- `apps/isis/web/src/security/region-retention-compliance-utils.spec.ts`
  - strict pass behavior for compliant region/retention inputs,
  - strict block behavior for disallowed region,
  - review-mode downgrade behavior,
  - list parsing normalization checks,
  - metadata merge/read roundtrip for blocked disposition.

3. Integrated submit-time enforcement in Job Submission Studio:

- `apps/isis/web/src/pages/JobSubmissionStudio.tsx`
  - added full region/retention compliance policy controls and findings UI,
  - enforced submit-time block/review acknowledgement behavior,
  - attached `regionRetentionCompliancePolicy`,
    `regionRetentionComplianceEvaluation`, and `regionRetentionComplianceInput`
    metadata to submitted requests.

4. Integrated output-level compliance evaluation and metadata persistence:

- `apps/isis/web/src/pages/OutputsPage.tsx`
  - added region/retention policy controls and findings UI for selected output,
  - added apply action to persist reviewed `regionRetentionCompliance` metadata
    disposition.

5. Added parity-console coverage:

- `apps/isis/web/src/pages/OutputsParityPage.tsx`
  - added `evaluateRegionRetentionCompliance` method coverage entry,
  - added parity action to evaluate selected output under default enterprise
    region/retention profile settings.

6. Expanded page-level tests (coverage authored, execution still
   baseline-blocked in this workspace):

- `apps/isis/web/src/pages/JobSubmissionStudio.spec.tsx`
- `apps/isis/web/src/pages/OutputsPage.spec.tsx`
- `apps/isis/web/src/pages/OutputsParityPage.spec.tsx`

## Verification Commands

```bash
pnpm --filter @isis/web exec vitest run src/security/region-retention-compliance-utils.spec.ts src/security/model-provenance-licensing-utils.spec.ts src/security/abuse-controls-utils.spec.ts src/security/content-governance-policy-utils.spec.ts src/security/artifact-integrity-utils.spec.ts --reporter=dot
pnpm --filter @isis/web exec vitest run src/pages/JobSubmissionStudio.spec.tsx src/pages/OutputsPage.spec.tsx src/pages/OutputsParityPage.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

- Shared security utility suites pass, including new
  `region-retention-compliance-utils.spec.ts`.
- Page-level suites remain blocked by the pre-existing workspace `@isis/client`
  package-entry resolution issue.
- Web typecheck remains red on known baseline issues unrelated to `WS13-008`
  (RunPod fleet nullability, workflow result typing, and cross-package `rootDir`
  scope).
