# ISIS v2 WS13-005: Signed Artifact Manifesting and Tamper-Evident Output Metadata

## Scope

`WS13-005` adds deterministic artifact-manifest integrity controls by:

- signing output packaging manifests with HMAC-SHA256,
- persisting integrity records in output metadata, and
- verifying signatures to detect metadata/manifest tampering.

## Research and Existing Implementation Alignment

Before implementation, existing integrity/signature and manifest patterns were
reviewed:

- Output packaging contract and manifest flows:
  - `apps/isis/web/src/pages/output-export-center-utils.ts`
  - `apps/isis/web/src/pages/OutputsPage.tsx`
- Existing signing semantics:
  - `apps/isis/generation-api/src/services/webhook-callback-security.service.ts`
    - versioned signatures and HMAC-SHA256 verification pattern.
- Existing parity operational model:
  - `apps/isis/web/src/pages/OutputsParityPage.tsx`

The implementation follows these patterns while using Web Crypto in the web
layer for deterministic browser-safe signing and verification.

## Deliverables

1. Added shared artifact-integrity utility module:

- `apps/isis/web/src/security/artifact-integrity-utils.ts`
  - canonical JSON serialization (`json-c14n-v1`) for stable signing payloads,
  - SHA-256 manifest hashing,
  - HMAC-SHA256 signature generation with versioned signatures (`v1=<hex>`),
  - verification engine with explicit mismatch diagnostics,
  - tamper-evidence record update helper,
  - metadata merge/read helpers for `artifactIntegrity`.

2. Added unit tests for signing and tamper detection:

- `apps/isis/web/src/security/artifact-integrity-utils.spec.ts`
  - sign + verify happy path,
  - tamper detection when manifest changes post-signing,
  - merge/read metadata record roundtrip.

3. Integrated signed-manifest controls into Outputs page:

- `apps/isis/web/src/pages/OutputsPage.tsx`
  - added signing controls (key ID + secrets),
  - added action to sign export manifest and persist tamper-evident metadata,
  - added action to verify manifest integrity and persist verification status,
  - added integrity status UI with verification result telemetry.
- `apps/isis/web/src/pages/OutputsPage.spec.tsx`
  - added flow test to sign and verify artifact integrity metadata persistence.

4. Integrated parity action for artifact integrity verification:

- `apps/isis/web/src/pages/OutputsParityPage.tsx`
  - method coverage expanded with `verifyArtifactManifestIntegrity`,
  - parity action verifies signed manifest metadata with caller-provided secret.
- `apps/isis/web/src/pages/OutputsParityPage.spec.tsx`
  - verifies parity execution path for artifact integrity verification.

## Verification Commands

```bash
pnpm --filter @isis/web exec vitest run src/security/artifact-integrity-utils.spec.ts src/security/content-governance-policy-utils.spec.ts --reporter=dot
pnpm --filter @isis/web exec vitest run src/security/artifact-integrity-utils.spec.ts 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

- `src/security/artifact-integrity-utils.spec.ts` passes.
- Page-level suites (`OutputsPage.spec.tsx`, `OutputsParityPage.spec.tsx`)
  remain blocked by the pre-existing `@isis/client` package-entry resolution
  baseline issue in this workspace.
- Web workspace typecheck remains red due pre-existing unrelated baseline issues
  (RunPod fleet nullability, workflow result typing, and cross-package `rootDir`
  compilation scope).
