# V9-004 V4 Metis Training Range bridge

Date: 2026-07-27

## Outcome

V4 now has a governed Metis authoring/cook boundary at
`apps/v4/metis-training-bridge`. It consumes exact canonical
`PublicationPackage` and `LessonAssetBundle` records through the reusable
`@metis/game-bridge-contract` and emits a deterministic
`v4.metis-training-range-content-manifest`.

The bridge is bound to the authoritative checked-in
`DT_Training_TutorialCurriculum.json`. That asset contains five cells totaling
90 minutes:

- `Tutorial.TacticalFPS` → `TacticalFPS` (20 minutes)
- `Tutorial.RTS` → `RTS` (20 minutes)
- `Tutorial.Wukong` → `WukongARPG` (15 minutes)
- `Tutorial.RTST` → `RTSTStealth` (20 minutes)
- `Tutorial.ArcadeContra` → `ArcadeContra` (15 minutes)

This corrects the nearby prose claim of “six launch cells”; the canonical JSON
and V4 C++ surface both define five.

## Admission and ownership boundary

The shared contract fails closed unless the exact publication and lesson
versions are released for governed API export with:

- complete operator approval and no release blockers;
- approved, rights-cleared, provenance-verified sources;
- approved Sophia-source-of-record grounding and visible learner disclosure;
- accessible and fallback-ready delivery;
- approved generated media, HTTPS locators, checksums, labels, captions,
  transcripts, and interactive/code fallbacks where applicable; and
- no suppressed support warning.

V4 additionally requires a one-to-one mapping between the exact five curriculum
modules and exact released lesson bundles. It exports titles, tooltips,
objectives, assets, source and grounding identifiers, warnings, and disclosure
requirements for cook-time use.

The manifest records that V4 alone owns training execution and completion. Metis
cannot influence rollback, matchmaking, the AI Director, competitive ranking, or
mastery. Live training-frame calls, rollback calls, gameplay telemetry, match
signals, AI Director state, combat outcomes, MMR/ranking, and rollback state are
rejected before canonical reads.

## Automated verification

Focused verification passed:

- shared contract typecheck and 8 tests;
- V3 regression typecheck and 10 tests after adopting the shared contract;
- V4 typecheck and 13 tests;
- shared, V3, and V4 lint/build targets;
- the canonical Metis contract check;
- Nx project discovery and root module-boundary lint.

The V4 tests directly parse the checked-in Unreal curriculum JSON and assert
exact structural equality with the bridge contract. They also cover determinism,
five-cell order and duration, all authority flags, all forbidden runtime inputs
before I/O, curriculum drift, incomplete mappings, unreleased packages, and
cross-module lesson binding.

## Scope boundary

This closes the actionable V4 canonical-provider admission seam. It does not
claim a cooked Unreal consumer, recorded in-engine tooltip rendering, or runtime
network authentication. V5–V8 bridges and game-runtime consumption remain open,
so the composite V9-004 checkbox remains open.
