Eve library

V9-004 V3 Metis Lecture Hall bridge

Evidence

Revision 1

On this page

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.