Eve library

V9-004 V2 combat-training bridge

Evidence

Revision 1

On this page

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.