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:
PublicationPackageestablishes the exact course release, distribution, governance decision, source rights, provenance, grounding, and export authorization.LessonAssetBundlesupplies each exact released lesson and its learner disclosure, source/grounding references, delivery body, media, accessibility, and fallback status.AssessmentEvidencePacksupplies 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: unavailablenotePersistence.mayClaimPersisted: falsecanonical-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 typecheckpnpm --filter @v3/metis-lecture-hall-bridge test— 1 file, 10 testspnpm --filter @v3/metis-lecture-hall-bridge lintpnpm --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.