# V9-004 V3 Metis Lecture Hall bridge

Date: 2026-07-27

## Outcome

V3 now has a governed Metis admission package at
`libs/v3/metis-lecture-hall-bridge`. It replaces inference from the Commons'
static `v1:metis:*` references with a typed, asynchronous boundary over the
canonical `@metis/api-client` resources:

- `PublicationPackage` establishes the exact course release, distribution,
  governance decision, source rights, provenance, grounding, and export
  authorization.
- `LessonAssetBundle` supplies each exact released lesson and its learner
  disclosure, source/grounding references, delivery body, media, accessibility,
  and fallback status.
- `AssessmentEvidencePack` supplies an exact learner-bound assessment summary
  for a private review cell.

The output is a deterministic `v3.metis-lecture-hall-session-manifest` for
`V3Mode_CommonsLectureHall`.

The release, lesson, rights, provenance, grounding, disclosure, accessibility,
fallback, and media checks now live in the reusable
`@metis/game-bridge-contract`. V3 retains only its product-specific private
assessment admission and redaction policy.

## Admission and privacy boundary

The bridge fails closed unless:

- the course and build are published, the package is `released`, all release
  blockers are absent, launch readiness is 100%, and the distribution explicitly
  allows governed API export at general availability or limited rollout;
- an approving operator and approval timestamp exist and learner disclosure and
  audit-trail requirements remain enabled;
- every release source is approved, rights-cleared, and provenance-verified and
  every grounding pack is approved;
- each requested lesson ID and version is admitted by that exact release;
- each lesson is published for export, has approved source grounding, preserves
  learner disclosure, and passes accessibility, fallback, asset-integrity, and
  generated-media approval checks;
- projected URLs use HTTPS, projected assets carry checksums, visual assets have
  accessibility labels, video has captions and a transcript, and
  interactive/code content has a text fallback; and
- the assessment pack belongs to the exact learner and an approved released
  assessment, has internally consistent counts and scores, and has neither
  high/critical integrity signals nor pending protected review.

Rich text has inline HTML escaped before projection. Support warnings cannot be
suppressed. Assessment output contains only score/max-score summary metrics and
is marked `private-cell-only`, with zero observers, no hall replication, and no
mastery mutation. Artifact URLs, excerpts, learner-response hashes, observation
notes, integrity descriptions, and metadata are deliberately absent.

Render-frame and rollback-simulation calls are rejected before any canonical
record request.

## Notebook honesty

`@metis/api-client` does not expose a notebook mutation resource. The bridge
therefore emits:

- `notePersistence.status: unavailable`
- `notePersistence.mayClaimPersisted: false`
- `canonical-metis-client-does-not-expose-notebook-mutation`

This prevents the existing V3 static note references from being mistaken for a
durable V1 write receipt.

## Automated verification

Focused verification passed:

- `pnpm --filter @v3/metis-lecture-hall-bridge typecheck`
- `pnpm --filter @v3/metis-lecture-hall-bridge test` — 1 file, 10 tests
- `pnpm --filter @v3/metis-lecture-hall-bridge lint`
- `pnpm --filter @v3/metis-lecture-hall-bridge build`
- shared contract typecheck, 8 tests, lint, and build
- `pnpm metis:contracts:check`
- Nx project discovery plus root module-boundary ESLint

The tests cover deterministic successful admission and exact resource selection;
private evidence redaction; unreleased packages; rights failure; inaccessible
and unlabeled media; cross-learner and pending-review evidence; render-frame and
rollback rejection before I/O; and canonical transport failure.

## Scope boundary

This is executable canonical-package admission and redaction proof. It is not a
cooked V3/Unreal consumer, live world-server authentication, a durable notebook
write, or end-to-end private-cell rendering result. Runtime consumption remains
open. The composite V9-004 launch checkbox therefore remains open.
