# Isis Migration Completion Certificate Runbook

Last Updated: 2026-02-24  
Scope: WS17 migration completion certificate artifacts and release gating.

## Purpose

Define how to generate and validate WS17 migration completion certificates that
act as release prerequisites.

The certificate aggregates:

1. WS17 checklist completion (`WS17-001` through `WS17-010`)
2. Evidence ledger coverage for WS17 items
3. Required migration scripts/runbooks/generated artifacts presence
4. Compliance gate outcome
5. Optional runtime dry-run pipeline evidence for release eligibility

## Generator

Script:

- `scripts/isis/generate-v2-migration-completion-certificate.mjs`

Default outputs:

- `docs/domains/isis/remediation-v2/ISIS_V2_MIGRATION_COMPLETION_CERTIFICATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MIGRATION_COMPLETION_CERTIFICATE.md`

### Generate Static Certificate

```bash
node scripts/isis/generate-v2-migration-completion-certificate.mjs
```

### Generate Release-Time Certificate With Runtime Evidence

```bash
node scripts/isis/generate-v2-migration-completion-certificate.mjs \
  --dry-run-report=tmp/isis-migration/ws17-migration-dry-run-pipeline-<timestamp>.json \
  --release-id=ws17-prod-cutover-<date> \
  --environment=production
```

## Validator

Script:

- `scripts/isis/validate-v2-migration-completion-certificate.mjs`

### Validate Deterministic Artifact Synchronization

```bash
node scripts/isis/validate-v2-migration-completion-certificate.mjs
```

### Enforce Release Eligibility

```bash
node scripts/isis/validate-v2-migration-completion-certificate.mjs \
  --require-release-eligible=true
```

## Interpretation

- `release.staticPrerequisitesSatisfied=true`: repo-level migration
  prerequisites are complete.
- `release.releasePrerequisitesSatisfied=true`: static prerequisites pass and
  runtime dry-run evidence report is attached and passing.
- `status=READY_FOR_RELEASE`: release prerequisite certificate is fully
  satisfied.
- `status=BLOCKED_PENDING_PREREQUISITES`: at least one required prerequisite
  failed or runtime evidence is missing.
