# Studio Commenting and Annotation System Validation Matrix

Status: Active  
Scope: Validation evidence for `OST-00175` (Commenting and annotation system).

## Coverage Summary

- Integration:
  - `apps/oshun/web/src/components/__tests__/StudioCommentingAnnotationSystemWorkspace.test.tsx`
- E2E (smoke spec):
  - `apps/oshun/web/e2e/studio-commenting-annotation-system-smoke.spec.ts`
- Accessibility checks:
  - keyboard-accessible native-button assertions
  - context-incomplete and policy-denied assertions
- Performance/SLO checks:
  - runs, success-rate, and p95 indicator assertions

## Required Scenarios

1. Route `/studio/commenting-annotation-system` renders all required governance
   flows.
2. Optimistic transition behavior is validated (`idle -> pending -> success`).
3. Failure + retry recovery is validated (`pending -> error -> success`).
4. Unauthorized moderation role execution is blocked with explicit denial
   reason.
5. Domain-visibility and production moderation policy enforcement is validated.
6. SLO indicators and audit entries update after flow execution.

## Execution Notes

- Unit/integration command:
  - `pnpm nx run @oshun/web:test`
- E2E command wiring for `@oshun/web:e2e` remains scaffolded in project
  configuration; smoke coverage is committed and ready once Playwright wiring is
  enabled.

## Acceptance Gate

`OST-00175` is complete when:

- integration tests cover optimistic/error/retry/deny behavior,
- e2e smoke coverage for `/studio/commenting-annotation-system` is committed,
- accessibility and SLO assertions are codified,
- validation matrix maps scenarios to concrete evidence paths.
