# V9-004 V2 combat-training bridge

Date: 2026-07-27

## Outcome

The first concrete V2–V8 game-to-Metis bridge is implemented at
`apps/v2/metis-combat-training-bridge`. It closes V2's previously declarative
Combat Trials/Mission seam in `V2/V2_ARCHITECTURE.md` and
`V2/V2_DEPENDENCIES.md` with an executable, tested package that composes:

- `@shakti/fighting-ruleset-bridge` for the authored technique reference,
  ruleset profile, and deterministic frame-data reference;
- `@metis/assessment` for selection from the finite authored drill pool;
- `@metis/adaptive` for difficulty adjustment from admitted evidence; and
- `@metis/tutoring` for an authored three-level hint ladder with answer reveal
  disabled.

The result is a deterministic `v2.shakti-metis-combat-training-curriculum` cook
manifest for either `V2Mode_CombatTrials` or `V2Mode_Missions`. V2 remains the
sole owner of gameplay execution, scoring, and outcomes.

## Evidence boundary

The bridge is explicitly post-session and authoring-only:

- live combat-frame RPC and rollback-simulation access throw before adaptation;
- gameplay telemetry, frame samples, rollback state, and combat outcomes are
  rejected as learning-evidence fields;
- a game-only move cannot be represented as a Shakti learning source;
- no evidence yields `abstained`, retains the authored baseline drill IDs, and
  authorizes neither manifest publication nor mastery mutation;
- evidence must match the exact learner, ruleset, Shakti reference card, drill,
  and skill;
- each evidence and receipt identifier must be unique;
- each receipt must name a rubric and calibration, remain current at generation
  time, and bind a lowercase SHA-256 source digest; and
- one invalid item blocks the entire batch, so no valid-looking subset can
  silently influence learner adaptation.

The emitted manifest makes the ownership boundary machine-readable through
`offRollback: true`, `mayInfluenceRollback: false`,
`v2OwnsGameplayExecution: true`, and
`runtimeMayReportOutcomeAsLearningEvidence: false`.

## Automated verification

Focused verification passed:

- `pnpm --filter @v2/metis-combat-training-bridge typecheck`
- `pnpm --filter @v2/metis-combat-training-bridge test` — 1 file, 8 tests
- `pnpm --filter @v2/metis-combat-training-bridge lint`
- `pnpm --filter @v2/metis-combat-training-bridge bundle`

The tests prove byte-equivalent object output across repeated builds from the
same inputs, grounded Shakti/Metis composition, evidence-free abstention,
whole-batch blocking for duplicate/mismatched/uncalibrated evidence, rejection
of each forbidden live-runtime channel, and rejection of game-only educational
grounding.

## Scope boundary

This is repository and contract proof for V2, not proof that all seven products
V2–V8 are connected or that a cooked Unreal build consumes the manifest. It does
not claim that V2's full per-fighter trial catalog or Mission curriculum is
complete. The composite V9-004 launch checkbox remains open for V3–V8 bridges,
runtime/cooked-build consumption, embodiment, remaining localization/release
work, and creator payout paths.
